boards/ezurio/rm1xx_dvk/doc/index.rst
.. zephyr:board:: rm1xx_dvk
Overview
Ezurio's RM1xx is a module which integrates both LoRa and BLE communications, powered by a Nordic Semiconductor nRF51822 ARM Cortex-M0 CPU and on-board Semtech SX1272 LoRa RF chip. This board supports the RM1xx on the RM1xx development board - RM191 for the 915MHz version and RM186 for the 868MHz version.
This development kit has the following features:
ADC (Analog to Digital Converter)GPIO (General Purpose Input Output)I2C (Inter-Integrated Circuit)NVIC (Nested Vectored Interrupt Controller)PWM (Pulse Width Modulation)RTC (nRF RTC System Clock)SPI (Serial Peripheral Interface)UART (Universal asynchronous receiver-transmitter)WDT (Watchdog Timer).. figure:: img/RM186-SM.jpg :align: center :alt: RM1xx module
RM1xx module (Credit: Ezurio)
More information about the module can be found on the
RM1xx homepage_.
The Nordic Semiconductor Infocenter_
contains the processor's information and the datasheet.
Hardware
The RM1xx has two internal oscillators. The frequency of the slow clock is 32.768KHz. The frequency of the main clock is 16MHz.
.. zephyr:board-supported-hw::
See Nordic Semiconductor Infocenter_
for a complete list of hardware features.
The development board features a Microchip MCP23S08 SPI port expander - note that this is not currently supported in Zephyr.
Refer to the Microchip MCP23S08 datasheet_ for further details.
A 512KB (4Mb) Adesto AT25DF041B EEPROM is available via SPI for storage of infrequently updated data and small datasets and can be used with the spi-nor driver. Note that the EEPROM shares the same SPI bus as the SX1272 LoRa transceiver so priority access should be given to the LoRa radio.
Refer to the Adesto AT25DF041B datasheet_ for further details.
A Semtech SX1272 transceiver chip is present in the module which can be used in 915MHz LoRa frequency ranges if using an RM191 module or 868MHz LoRa frequency ranges if uses an RM186 module
Refer to the Semtech SX1272 datasheet_ for further details.
Programming and Debugging
.. zephyr:board-supported-runners::
Follow the instructions in the :ref:nordic_segger page to install
and configure all the necessary software. Further information can be
found in :ref:nordic_segger_flashing. Then build and flash
applications as usual (see :ref:build_an_application and
:ref:application_run for more details).
Here is an example for the :zephyr:code-sample:hello_world application.
First, run your favorite terminal program to listen for output.
.. code-block:: console
$ minicom -D <tty_device> -b 115200
Replace :code:<tty_device> with the port where the board nRF51 DK
can be found. For example, under Linux, :code:/dev/ttyACM0.
Then build and flash the application in the usual way.
.. zephyr-app-commands:: :zephyr-app: samples/hello_world :board: rm1xx_dvk :goals: build flash
Refer to the :ref:nordic_segger page to learn about debugging boards
with a Segger IC.
References
.. target-notes::
.. _RM1xx homepage: https://www.ezurio.com/wireless-modules/lorawan-solutions/sentrius-rm1xx-lora-ble-module .. _Nordic Semiconductor Infocenter: https://infocenter.nordicsemi.com .. _Adesto AT25DF041B datasheet: https://www.dialog-semiconductor.com/sites/default/files/ds-at25df041b_040.pdf .. _Semtech SX1272 datasheet: https://semtech.my.salesforce.com/sfc/p/#E0000000JelG/a/440000001NCE/v_VBhk1IolDgxwwnOpcS_vTFxPfSEPQbuneK3mWsXlU .. _Microchip MCP23S08 datasheet: https://ww1.microchip.com/downloads/en/DeviceDoc/MCP23008-MCP23S08-Data-Sheet-20001919F.pdf