Update readme: Add RIOT examples tutorial

Author: LasseRosenow

README.md

@@ -1,4 +1,5 @@
 # reactor-uc
+
 `reactor-uc` is a task scheduling runtime implementing the reactor
 model-of-computation target at embedded and resource-constrained 32 bit systems.
 
@@ -8,21 +9,25 @@ NB: reactor-uc is still work-in-progress and many (most?) features are not suppo
 yet. This only documents how to run a few example programs.
 
 Setup the environment
+
 ```
 source env.bash
 ```
 
 Initialize submodules
+
 ```
 git submodule update --init
 ```
 
 Compile and run unit tests:
+
 ```
 make test
 ```
 
 Compile and run a simple timer test on Posix
+
 ```
 cd examples/posix
 cmake -Bbuild
@@ -39,10 +44,20 @@ cd examples/zephyr
 west build -b qemu_cortex_m3 -p always -t run
 ```
 
-For more information on running LF programs using the reactor-uc runtime on 
-Zephyr take a look at this template: https://github.com/lf-lang/lf-west-template/tree/reactor-uc
+Compile and run a simple blinky example on RIOT.
+This requires a correctly configured RIOT environment.
+Make sure that the environment variable `RIOTBASE` points to a `RIOT` codebase.
+
+```
+cd examples/riot/blinky
+make BOARD=native all term
+```
+
+For more information on running LF programs using the reactor-uc runtime on
+Zephyr take a look at this template: <https://github.com/lf-lang/lf-west-template/tree/reactor-uc>
 
 ## Lingua Franca
+
 We have copied a very limited version of the Lingua Franca Compiler (lfc) into
 `~/lfc` of this repo. In the future, the `reactor-uc` specific code-generation
 will be merged back upstream. By sourcing `env.bash` or `env.fish` the Lingua
@@ -63,6 +78,7 @@ bin/HelloUc
 ```
 
 ## Goals
+
 - Incorporate unit testing and test-driven development from the start
 - Optimized for single-core 32-bit systems
 - Backend for LF
@@ -74,13 +90,16 @@ which enable distributed embedded systems.
 - Avoid malloc as much as possible (or entirely?)
 
 ## References
+
 `reactor-uc` draws inspiration from the following existing open-source projects:
+
 - [reactor-cpp](https://github.com/lf-lang/reactor-cpp)
 - [reactor-c](https://github.com/lf-lang/reactor-c)
 - [qpc](https://github.com/QuantumLeaps/qpc)
 - [ssm-runtime](https://github.com/QuantumLeaps/qpc)
 
-## TODO for the MVP:
+## TODO for the MVP
+
 - [x] Timers
 - [x] Input/Output Ports
 - [x] Logical Actions
@@ -93,8 +112,8 @@ which enable distributed embedded systems.
 - [x] Posix Platform abstractions
 - [x] Basic code-generation
 
-
 ## More advanced topics
+
 - [x] More platform abstractions (Riot, Zephyr and FlexPRET/InterPRET)
 - [x] Reconsider where to buffer data (outputs vs inputs)
 - [x] Consider if we should have FIFOs of pending events, not just a single for a trigger.
@@ -105,15 +124,14 @@ which enable distributed embedded systems.
 - [ ] Multiports and banks
 - [ ] Modal reactors
 
-
 ## Troubleshooting
 
 If you get the following CMake error when calling `lfc/bin/lfc-dev`
+
 ```
 CMake Error at CMakeLists.txt:7 (message):
   Environment variable REACTOR_UC_PATH is not set.  Please source the
   env.bash in reactor-uc.
 ```
 
-Please source `env.bash` or `env.fish`. 
-
+Please source `env.bash` or `env.fish`.