5cb2ade65b
Updates the zephyr port build instructions and CI to use the latest zephyr release tag. Signed-off-by: Maureen Helm <maureen.helm@nxp.com>
162 lines
5.3 KiB
Markdown
162 lines
5.3 KiB
Markdown
MicroPython port to Zephyr RTOS
|
|
===============================
|
|
|
|
This is a work-in-progress port of MicroPython to Zephyr RTOS
|
|
(http://zephyrproject.org).
|
|
|
|
This port requires Zephyr version v2.6.0, and may also work on higher
|
|
versions. All boards supported
|
|
by Zephyr (with standard level of features support, like UART console)
|
|
should work with MicroPython (but not all were tested).
|
|
|
|
Features supported at this time:
|
|
|
|
* REPL (interactive prompt) over Zephyr UART console.
|
|
* `utime` module for time measurements and delays.
|
|
* `machine.Pin` class for GPIO control, with IRQ support.
|
|
* `machine.I2C` class for I2C control.
|
|
* `usocket` module for networking (IPv4/IPv6).
|
|
* "Frozen modules" support to allow to bundle Python modules together
|
|
with firmware. Including complete applications, including with
|
|
run-on-boot capability.
|
|
* virtual filesystem with FAT and littlefs formats, backed by either
|
|
DiskAccess or FlashArea (flash map).
|
|
|
|
Over time, bindings for various Zephyr subsystems may be added.
|
|
|
|
|
|
Building
|
|
--------
|
|
|
|
Follow to Zephyr web site for Getting Started instruction of installing
|
|
Zephyr SDK, getting Zephyr source code, and setting up development
|
|
environment. (Direct link:
|
|
https://docs.zephyrproject.org/latest/getting_started/index.html).
|
|
You may want to build Zephyr's own sample applications to make sure your
|
|
setup is correct.
|
|
|
|
If you already have Zephyr installed but are having issues building the
|
|
MicroPython port then try installing the correct version of Zephyr via:
|
|
|
|
$ west init zephyrproject -m https://github.com/zephyrproject-rtos/zephyr --mr v2.6.0
|
|
|
|
Alternatively, you don't have to redo the Zephyr installation to just
|
|
switch from master to a tagged release, you can instead do:
|
|
|
|
$ cd zephyrproject/zephyr
|
|
$ git checkout v2.6.0
|
|
$ west update
|
|
|
|
With Zephyr installed you may then need to configure your environment,
|
|
for example by sourcing `zephyrproject/zephyr/zephyr-env.sh`.
|
|
|
|
Once Zephyr is ready to use you can build the MicroPython port just like any
|
|
other Zephyr application. You can do this anywhere in your file system, it does
|
|
not have to be in the `ports/zephyr` directory. Assuming you have cloned the
|
|
MicroPython repository into your home directory, you can build the Zephyr port
|
|
for a frdm_k64f board like this:
|
|
|
|
$ west build -b frdm_k64f ~/micropython/ports/zephyr
|
|
|
|
To build for QEMU instead:
|
|
|
|
$ west build -b qemu_x86 ~/micropython/ports/zephyr
|
|
|
|
Consult the Zephyr documentation above for the list of
|
|
supported boards. Board configuration files appearing in `ports/zephyr/boards/`
|
|
correspond to boards that have been tested with MicroPython and may have
|
|
additional options enabled, like filesystem support.
|
|
|
|
Running
|
|
-------
|
|
|
|
To flash the resulting firmware to your board:
|
|
|
|
$ west flash
|
|
|
|
Or, to flash it to your board and start a gdb debug session:
|
|
|
|
$ west debug
|
|
|
|
To run the resulting firmware in QEMU (for BOARDs like qemu_x86,
|
|
qemu_cortex_m3):
|
|
|
|
$ west build -t run
|
|
|
|
Networking is enabled with the default configuration, so you need to follow
|
|
instructions in
|
|
https://docs.zephyrproject.org/latest/guides/networking/qemu_setup.html#networking-with-qemu
|
|
to setup the host side of TAP/SLIP networking. If you get an error like:
|
|
|
|
could not connect serial device to character backend 'unix:/tmp/slip.sock'
|
|
|
|
it's a sign that you didn't follow the instructions above. If you would like
|
|
to just run it quickly without extra setup, see "minimal" build below.
|
|
|
|
Quick example
|
|
-------------
|
|
|
|
To blink an LED:
|
|
|
|
import time
|
|
from machine import Pin
|
|
|
|
LED = Pin(("GPIO_1", 21), Pin.OUT)
|
|
while True:
|
|
LED.value(1)
|
|
time.sleep(0.5)
|
|
LED.value(0)
|
|
time.sleep(0.5)
|
|
|
|
The above code uses an LED location for a FRDM-K64F board (port B, pin 21;
|
|
following Zephyr conventions port are identified by "GPIO_x", where *x*
|
|
starts from 0). You will need to adjust it for another board (using board's
|
|
reference materials). To execute the above sample, copy it to clipboard, in
|
|
MicroPython REPL enter "paste mode" using Ctrl+E, paste clipboard, press
|
|
Ctrl+D to finish paste mode and start execution.
|
|
|
|
To respond to Pin change IRQs, on a FRDM-K64F board run:
|
|
|
|
from machine import Pin
|
|
|
|
SW2 = Pin(("GPIO_2", 6), Pin.IN)
|
|
SW3 = Pin(("GPIO_0", 4), Pin.IN)
|
|
|
|
SW2.irq(lambda t: print("SW2 changed"))
|
|
SW3.irq(lambda t: print("SW3 changed"))
|
|
|
|
while True:
|
|
pass
|
|
|
|
Example of using I2C to scan for I2C slaves:
|
|
|
|
from machine import I2C
|
|
|
|
i2c = I2C("I2C_0")
|
|
i2c.scan()
|
|
|
|
|
|
Minimal build
|
|
-------------
|
|
|
|
MicroPython is committed to maintain minimal binary size for Zephyr port
|
|
below 128KB, as long as Zephyr project is committed to maintain stable
|
|
minimal size of their kernel (which they appear to be). Note that at such
|
|
size, there is no support for any Zephyr features beyond REPL over UART,
|
|
and only very minimal set of builtin Python modules is available. Thus,
|
|
this build is more suitable for code size control and quick demonstrations
|
|
on smaller systems. It's also suitable for careful enabling of features
|
|
one by one to achieve needed functionality and code size. This is in the
|
|
contrast to the "default" build, which may get more and more features
|
|
enabled over time.
|
|
|
|
To make a minimal build:
|
|
|
|
$ west build -b qemu_x86 ~/micropython/ports/zephyr -- -DCONF_FILE=prj_minimal.conf
|
|
|
|
To run a minimal build in QEMU without requiring TAP networking setup
|
|
run the following after you built an image with the previous command:
|
|
|
|
$ west build -t run
|
|
|