.. zephyr:board:: actinius_icarus_bee

Overview

The Icarus Bee is a cellular IoT board in Bee/xBee form factor. It is built around Nordic Semi's nRF9160 modem and combines LTE-M, NB-IoT, GPS, accelerometer, SPI Flash, RGB LED, Button, as well as an eSIM and a nano SIM connector.

The main uController is the Nordic Semiconductor nRF9160, with ARM Cortex-M33F CPU, ARMv8-M Security Extension and the following devices (provided directly by Nordic):

• :abbr:ADC (Analog to Digital Converter)
• CLOCK
• FLASH
• :abbr:GPIO (General Purpose Input Output)
• :abbr:I2C (Inter-Integrated Circuit)
• :abbr:MPU (Memory Protection Unit)
• :abbr:NVIC (Nested Vectored Interrupt Controller)
• :abbr:PWM (Pulse Width Modulation)
• :abbr:RTC (nRF RTC System Clock)
• Segger RTT (RTT Console)
• :abbr:SPI (Serial Peripheral Interface)
• :abbr:UARTE (Universal asynchronous receiver-transmitter with EasyDMA)
• :abbr:WDT (Watchdog Timer)
• :abbr:IDAU (Implementation Defined Attribution Unit)

.. figure:: img/icarus-bee-external-pins.jpg :align: center :alt: Icarus Bee w/ Pinouts

 Icarus Bee w/ Pinouts

.. figure:: img/icarus-bee-peripherals-pins.jpg :align: center :alt: Icarus Bee

 Internal Pinouts

Hardware

The detailed information about the on-board hardware can be found at the Icarus Bee Product Website_.

Supported Features

.. zephyr:board-supported-hw::

SIM selection

The sim choice (eSIM or nano-SIM) can be configured in Devicetree by adjusting the sim property in the sim_select node.

Security components

• Implementation Defined Attribution Unit (IDAU_). The IDAU is implemented with the System Protection Unit and is used to define secure and non-secure memory maps. By default, all of the memory space (Flash, SRAM, and peripheral address space) is defined to be secure accessible only.
• Secure boot.

Building Secure/Non-Secure Zephyr applications

The process requires the following steps:

1. Build the Secure Zephyr application using -DBOARD=actinius_icarus_bee.
2. Build the Non-Secure Zephyr application using -DBOARD=actinius_icarus_bee/ns.
3. Merge the two binaries together.

If you are using Segger Embedded Studio v4.18 or later, the two binaries are built, merged, and burned automatically, unless you have disabled the feature.

When building a Secure/Non-Secure application, the Secure application will have to set the IDAU (SPU) configuration to allow Non-Secure access to all CPU resources utilized by the Non-Secure application firmware. SPU configuration shall take place before jumping to the Non-Secure application.

More information can be found in the Icarus Bee Product Website_ or the Actinius Documentation Portal_.

References

.. target-notes::

.. _IDAU: https://developer.arm.com/docs/100690/latest/attribution-units-sau-and-idau

.. _Icarus Bee Product Website: https://www.actinius.com/icarus-bee

.. _Actinius Documentation Portal: https://docs.actinius.com