Skip to content

Building & Deploying Firmware

The quick start guides below provide a high-level walkthrough of building and deploying the Hello World and the Line Echo demo applications. The purpose of these guides is to quickly demonstrate the overall process for building ROM files and uploading them to an xPico 600 device.

Quick Start: Hello World

The helloDemo module contains code that prints "Hello World" to the command line once every two seconds when the firmware is loaded onto the xPico 600.

Step 1: Build the project

To build the project in Linux:

  1. Go to the SDK installation directory. This is where you extracted the .tar file previously.
  2. Change to the helloDemo project directory within the installation directory. cd custom/project/helloDemo
  3. Type make to build the project.

Step 2: Sign the ROM

Share the firmware to Lantronix to get signed firmware.

Step 3: Upload the ROM

Upload the signed ROM file.

  1. Open Web Manager, go to the Device page, and click Firmware Upgrade.
  2. Click Choose File, browse to work/helloDemo, and select the signed ROM file.
  3. Click Upload and then click OK to confirm that you want to upload a new firmware image. The device erases the old image and receives and writes the new image. After the new firmware is written, the device reboots automatically. It may take a few minutes for this process to complete.

Step 4: Change Line 1 Protocol

Next, change Line 1 to the new Hello World protocol you just uploaded.

  1. In Web Manager, go to the Line page and click Configuration.
  2. From Protocol, select Hello World and then click Submit. The changes take effect immediately.
  3. Open a terminal emulator (e.g. Tera Term) and connect to the COM port the device is connected to. The xPico 600 prints "Hello World" to the terminal once every two seconds.
Hello world
Hello world
Hello world

Quick Start: Line Echo

The echoDemo module contains code that reads each character from the input buffer and prints it back to the line when the firmware is loaded onto the xPico 600 device.

Step 1: Build the project

To build the project in Linux:

  1. Go to the SDK installation directory. This is where you extracted the .tar file previously.
  2. Change to the echoDemo project directory. cd custom/project/echoDemo
  3. Type make to build the project.

Step 2: Sign the ROM

Share the firmware to Lantronix to get signed firmware.

Step 3: Upload the ROM

Upload the signed ROM file.

  1. Open Web Manager, go to the Device page, and click Firmware Upgrade.
  2. Click Choose File, browse to work/echoDemo, and select the signed ROM file.
  3. Click Upload and then click OK to confirm that you want to upload a new firmware image. The device erases the old image and receives and writes the new image. After the new firmware is written, the device reboots automatically. It may take a few minutes for this process to complete.

Step 4: Change Line 1 Protocol

Next, change Line 1 to the Echo protocol option you just uploaded.

  1. In Web Manager, go to the Line page and click Configuration.
  2. From Protocol, select Echo and then click Submit. The changes take effect immediately.
  3. Open a terminal emulator (e.g. Tera Term) and connect to the COM port the device is connected to. For each character received on the line, the xPico 600 prints the character back to the line. Note that the Line returns each character immediately when you press a key.