ZMRAA is an implementation of the MRAA API for Zephyr project.
- v1.0.0 - Initial release of ZMRAA targeting Zephyr 1.6 Includes preliminary support for AIO, GPIO, I2C, PWM, SPI, and UART
- Arduino 101
- Quark D2000 CRB
- GPIO
- I2C
- AIO
- PWM
- I2C
- SPI
In general almost every protocol mentioned above is present on each core. However, that stops being the case when you look at it from the POV of what's present on the Arduino headers. The following table lists the protocols that are present per core and exposed via the headers:
| Protocol | ARC | QUARK |
|---|---|---|
| AIO | Present | Not present |
| GPIO | Present | Present |
| PWM | Present | Present |
| I2C | Present | Not present |
| UART | Not present | Present |
| SPI | Present (Only internally) | Present |
On 101 there are at least 69 pins that can be configured. ZMRAA tries to provide access to as many as possible. Most of the pins exposed on the headers of the Arduino 101 can be accessed via both cores - Quark and ARC, but there are a few pins and protocols that can be accessed from only one of the cores. To see which protocol is available on which core please check the corresponding section.
A look at the pins accessible via the Quark core: GPIO - D2-D5, D7, D8, D10-D13 PWM - D3, D5, D6, D9 UART - D0(RX), D1(TX) SPI - D11(MOSI), D12(MISO), D13(SCK) | CS via GPIO
Pins accessible via the ARC core: GPIO - D14-D19 (These are analog pins A0-A5 numbered 14-19) ex: mraa_gpio_init(14); in this case pin A0 would be used as a digital pin
- mraa_gpio_init(15); in this case it's pin A1 and so on and so forth*
AIO - A0-A5, D10-D13 you can number the digital pins as they are: mraa_aio_init(10) This initializes pin D10
PWM - D3, D5, D6, D9 I2C - I2C pins on the board SPI - Not exposed externally, but has access to the internal BMI160
If a protocol and its corresponding pins have not been mentioned under a particular core then that protocol is not available on that core.
cd zephyr/ext/lib
git clone https://github.com/intel-iot-devkit/zmraa.git mraa
Then you need to apply zmraa.patch to add the configuration entries
cd $ZEPHYR_BASE
git am ext/lib/mraa/zmraa.patch
Add mraa and gpio driver to your Zephyr configuration and build sample.
Select Device Drivers -> GPIO Drivers -> QMSI GPIO driver and
MRAA -> Mraa GPIO function support
If you use a Quark D2K board then switch BOARD=arduino_101 for
BOARD=quark_d2000_crb
source $ZEPHYR_BASE/zephyr-env.sh
cd ext/lib/mraa/examples/shell
make BOARD=arduino_101 menuconfig
Now build the sample:
make BOARD=arduino_101
And upload it to the board by running:
dfu-util -R -a x86_app -D outdir/zephyr.bin