Firmware Development

Ruuvitracker uses eLua scriptable platform as a base for firmware. Drivers missing from eLua are developed in our own forked source tree at GitHub/ruuvitracker_fw.

NOTE: If you want to only customize device usage by rewriting Lua scripts, you do not need any special tools. Proceed to Develop scripts.

Requirements

 * Unix or Linux computer.
 * others may work but instructions are provided for only Debian/Ubuntu and Mac OS X
 * ARM gcc compiler
 * See installation from Develop for Cortex-M4
 * DFU-util 0.7 for flashing the device.
 * See DFU Flashing
 * GIT version control system.

Building Firmware

 * 1) install required tools
 * 2) clone git repository and compile. See ELua.
 * 3) Flash. See DFU Flashing or use provided script

Debug firmware
See connections and tools from Debugging ruuvitracker.
 * 1) connect SWD debugger.
 * 2) Start
 * 3) Profit?

Develop scripts
Ruuvitracker's internal working is defined with bunch of Lua scripts residing either in the device's flash area or in the sdcard. Current firmware uses statically build scripts from flash but sdcard support is coming.


 * See eLua API from eLua 0.8 Reference Manual
 * Use the force.