mirror of
https://github.com/RIOT-OS/RIOT.git
synced 2024-12-29 04:50:03 +01:00
33 lines
1.0 KiB
Markdown
33 lines
1.0 KiB
Markdown
|
## Lua interactive interpreter
|
||
|
|
|
||
|
|
### About
|
||
|
|
|
||
|
|
This example shows how to run a [Lua](https://www.lua.org/) Read-Eval-Print loop.
|
||
|
|
It works in a similar way to the lua shell that comes with your operating
|
||
|
|
system's default lua installation.
|
||
|
|
|
||
|
|
|
||
|
|
### How to run
|
||
|
|
|
||
|
|
Type `make all flash` to program your board. The lua interpreter communicates
|
||
|
|
via UART (like the shell).
|
||
|
|
|
||
|
|
It is not recommended to use `make term` because the default RIOT terminal messes
|
||
|
|
up the input and output and the REPL needs multi-line input. Instead, use something
|
||
|
|
like `miniterm.py` from pyserial:
|
||
|
|
|
||
|
|
```
|
||
|
|
miniterm.py --eol LF --echo /dev/ttyACM0 115200
|
||
|
|
```
|
||
|
|
|
||
|
|
By default only some of the builtin modules are loaded, to preserve RAM. See
|
||
|
|
the definition of `BARE_MINIMUM_MODS` in main.c.
|
||
|
|
|
||
|
|
### Using the interpreter
|
||
|
|
|
||
|
|
See the [Lua manual](https://www.lua.org/manual/5.3/) for the syntax of the language.
|
||
|
|
|
||
|
|
Each piece of single or multi-line input is compiled as a chunk and run. For this
|
||
|
|
reason, issuing "local" definitions may not work as expected: the definitions
|
||
|
|
will be local to that chunk only.
|