blinky.minimal

The preceding example (which you should have already run successfully) was mainly about getting set up with RIOT OS. This example is all about getting started with the fargin firmware framework:

• building "out of tree" - i.e. outside of the cloned RIOT OS repository folders

• running a minimal Lua program

Whereas the preceding example runs on any RIOT OS board, this example needs a board with an mcu which has more flash and ram, since the Lua interpreter and compiler would now be part of the build. For a point of reference, this example has been run on an Adafruit Trinket M0 which has an Atmel ATSAMD21 with 256K of flash and 32K of ram.

To run this example...

• clone the fargin firmware repository to a folder separate from the RIOT OS folder tree

• navigate to fargin-firmware/mcu-apps/blinky.minimal

• build the example

$make BOARD=xxxxx

• flash it (flashing varies depending on your board)

$make BOARD=xxxxx  flash

This app merely blinks an LED (LED0). Pressing a button (BTN0, if present) doubles the blink rate. (Most RIOT OS boards define at least LED0. Many also define BTN0).

Try modifying main.lua to change the blink rate, button function, etc.

This example is a partial (minimal) fargin firmware implementation. It introduces the concept of service request/response buffers for interfacing between the Lua interpreter and the underlying services, but it does not include important features such as service-via-serial, file system, etc.