Prep Your Toolkit

The Development Board (shown below) can be powered by USB or 2 AA batteries. USB supplies the power when both are present.

Developer Board

Connect your micro USB data cable to the Development Board and to your PC. The Development Board's serial debug port will now be accessible. It will typically present as a device file /dev/ttyUSB0 and this is assumed in the following instructions.

You should update the system image first before updating any applications. You only need to program the system image once for each SDK release. Under the SDK root directory, you can download the system image with:

./get_system_image.sh

You will be prompted for your Device Manager username and password to complete the download. Your username is your email address.

Once complete, the Myriota license agreement notification will be displayed and you can then proceed to program the Development Board using the updater.py tool with:

updater.py -f system.img -p /dev/ttyUSB0

You can now test your Development Board by building an example blinky application. Note: You may be prompted to press the RESET button on the Development Board

cd examples/blinky; make

This should report no errors and have created a firmware image called blinky.bin. This image can now be written to the Myriota Module using the updater.py tool.

To program the blinky.bin image issue the command:

updater.py -u blinky.bin -p /dev/ttyUSB0 -s

When programming completes the LED on the Development Board will blink on and off repeatedly. You can view output from the Myriota Module with:

(stty sane 115200; cat) < /dev/ttyUSB0

You should see the text Led On, Led Off printed repeatedly.

You are all set up.

The blinky example uses a sandbox mode that is useful for development, but is not suitable for deployment.

For deployable examples see the Schedule Messages section and the examples directory.

You may also view the user API, the hardware API, and the Myriota Module pin definitions.

Logging

The firmware logs system events and status onto the flash. You can add your own user log entries using the LogAdd API call.

Logging stops when the log partition in the flash is full. You can use log-util.py tool to download, parse, and purge the log. For example:

log-util.py -p /dev/ttyUSB0

downloads, parses, and prints the log.

Next Step: Schedule Messages