Icarus

Overview

The Icarus is a cost-effective cellular IoT board in Adafruit’s Feather/FeatherWing form factor. It is built around Nordic Semi’s nRF9160 modem and combines LTE-M, NB-IoT, GPS, accelerometer, USB, LiPo charger 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):

  • ADC

  • CLOCK

  • FLASH

  • GPIO

  • I2C

  • MPU

  • NVIC

  • PWM

  • RTC

  • Segger RTT (RTT Console)

  • SPI

  • UARTE

  • WDT

  • IDAU

Hardware

The detailed information about the on-board hardware can be found at the Icarus Product Website [2].

Icarus IoT Dev Board w/ Pinouts

Icarus IoT Dev Board w/ Pinouts

Pin description

External Pins available to user:

Icarus pin

Function

Description

Device-tree node

RST

Reset

Active low reset with internal pullup

3.3V

Power output

Main 3.3 V supply

NC

Not connected

GND

Power output

Ground

14 / A1

GPIO / Analog in

nRF9160 P0.14 / AIN1

gpio0 / adc_1

15 / A2

GPIO / Analog in

nRF9160 P0.15 / AIN2

gpio0 / adc_2

16 / A3

GPIO / Analog in

nRF9160 P0.16 / AIN3

gpio0 / adc_3

17 / A4

GPIO / Analog in

nRF9160 P0.17 / AIN4

gpio0 / adc_4

18 / A5

GPIO / Analog in

nRF9160 P0.18 / AIN5

gpio0 / adc_5

19 / A6

GPIO / Analog in

nRF9160 P0.19 / AIN6

gpio0 / adc_6

20 / SCK

GPIO / SPI pin

nRF9160 P0.20 / SPI SCK pin

gpio0 / spi3

21 / MOSI

GPIO / SPI pin

nRF9160 P0.21 / SPI MOSI pin

gpio0 / spi3

22 / MISO

GPIO / SPI pin

nRF9160 P0.22 / SPI MISO pin

gpio0 / spi3

23 / RX

GPIO / UART pin

nRF9160 P0.23 / UART RX pin

gpio0 / uart1

24 / TX

GPIO / UART pin

nRF9160 P0.24 / UART TX pin

gpio0 / uart1

VIN

Power input

Voltage input (maximum 10.2 V)

VBAT

Power input

Battery voltage input

EN

Power enable

Power enable pin (pull low to disable power)

USB

Power input

USB voltage input

gpio0

4

GPIO

nRF9160 P0.04

gpio0

3

GPIO

nRF9160 P0.03

gpio0

2

GPIO

nRF9160 P0.02

gpio0

1

GPIO

nRF9160 P0.01

gpio0

0

GPIO

nRF9160 P0.00

gpio0

30

GPIO

nRF9160 P0.30

gpio0

31

GPIO

nRF9160 P0.31

gpio0

SCL

GPIO / I2C pin

nRF9160 P0.26 / I2C SCL pin

gpio0 / i2c2

SDA

GPIO / I2C pin

nRF9160 P0.27 / I2C SDA pin

gpio0 / i2c2

nRF9160 pins connected internally:

nRF9160 pin

Function

Device-tree node

P0.05

User button

button0

P0.10

Red LED

led0 / pwm-led0

P0.11

Green LED

led1 / pwm-led1

P0.12

Blue LED

led2 / pwm-led2

P0.28

Accelerometer Interrupt 1

lis2dh12-accel

P0.29

Accelerometer Interrupt 2

lis2dh12-accel

P0.08

SIM select pin

gpio0

P0.13 / AIN0

Battery voltage measurement

adc_0

P0.06

USB - FTDI serial RX

uart0

P0.09

USB - FTDI serial TX

uart0

P0.07

USB - FTDI serial RTS Charger enable pin (Icarus v2.0)

uart0 gpio0 (Icarus v2.0)

P0.25

USB - FTDI serial CTS FLASH memory SPI CS pin (Icarus v2.0)

uart0 gpio0 (Icarus v2.0)

Supported Features

The actinius_icarus board supports the hardware features listed below.

on-chip / on-board
Feature integrated in the SoC / present on the board.
2 / 2
Number of instances that are enabled / disabled.
Click on the label to see the first instance of this feature in the board/SoC DTS files.
vnd,foo
Compatible string for the Devicetree binding matching the feature.
Click on the link to view the binding documentation.

actinius_icarus@1.4.0/nrf9160 target

Type

Location

Description

Compatible

CPU

on-chip

ARM Cortex-M33F CPU1

arm,cortex-m33f

ADC

on-chip

Nordic Semiconductor nRF family SAADC node1

nordic,nrf-saadc

ARM architecture

on-chip

Nordic EGU (Event Generator Unit)6

nordic,nrf-egu

on-chip

Nordic KMU (Key Management Unit)1

nordic,nrf-kmu

on-chip

Nordic nRF family CTRL-AP (Control Access Port)1

nordic,nrf-ctrlapperi

on-chip

Nordic SPU (System Protection Unit)1

nordic,nrf-spu

on-chip

Nordic UICR (User Information Configuration Registers)1

nordic,nrf-uicr

Audio

on-chip

Nordic PDM (Pulse Density Modulation interface)1

nordic,nrf-pdm

Clock control

on-chip

Nordic nRF clock control node1

nordic,nrf-clock

Counter

on-chip

Nordic nRF timer node3

nordic,nrf-timer

Cryptographic accelerator

on-chip

ARM TrustZone CryptoCell 3101

arm,cryptocell-310

Flash controller

on-chip

Nordic NVMC (Non-Volatile Memory Controller)1

nordic,nrf91-flash-controller

GPIO & Headers

on-chip

NRF5 GPIO1

nordic,nrf-gpio

on-chip

NRF5 GPIOTE11

nordic,nrf-gpiote

on-board

GPIO pins exposed on Adafruit Feather headers1

adafruit-feather-header

I2C

on-chip

Nordic nRF family TWIM (TWI master with EasyDMA)13

nordic,nrf-twim

I2S

on-chip

Nordic I2S (Inter-IC sound interface)1

nordic,nrf-i2s

IIO

on-board

Voltage Divider1

voltage-divider

Input

on-board

Group of GPIO-bound input keys1

gpio-keys

Interrupt controller

on-chip

ARMv8-M NVIC (Nested Vectored Interrupt Controller)1

arm,v8m-nvic

IPC

on-chip

Nordic nRF family IPC (Interprocessor Communication)1

nordic,nrf-ipc

LED

on-board

Group of GPIO-controlled LEDs1

gpio-leds

on-board

Group of PWM-controlled LEDs1

pwm-leds

Miscellaneous

on-chip

Nordic DPPIC (Distributed Programmable Peripheral Interconnect Controller)1

nordic,nrf-dppic

on-chip

Nordic FICR (Factory Information Configuration Registers)1

nordic,nrf-ficr

on-board

The Icarus boards provide the user with 2 options regarding SIM usage for LTE-M/NB-IoT communication1

actinius-sim-select

MMU / MPU

on-chip

ARMv8-M MPU (Memory Protection Unit)1

arm,armv8m-mpu

MTD

on-chip

Flash node1

soc-nv-flash

on-chip

Fixed partitions of a flash (or other non-volatile storage) memory1

fixed-partitions

on-chip

Fixed subpartitions of a flash (or other nonvolatile storage) memory2

fixed-subpartitions

Pin control

on-chip

Nordic nRF family Pin Controller1

nordic,nrf-pinctrl

Power management

on-chip

Nordic VMC (Volatile Memory Controller)1

nordic,nrf-vmc

on-chip

Nordic nRF power control node1

nordic,nrf-power

PWM

on-chip

nRF PWM13

nordic,nrf-pwm

on-chip

nRFx S/W PWM1

nordic,nrf-sw-pwm

Regulator

on-chip

Nordic REGULATORS (voltage regulators control module) on nRF91X1

nordic,nrf91x-regulators

Retained memory

on-chip

Nordic GPREGRET (General Purpose Register Retention) device2

nordic,nrf-gpregret

RTC

on-chip

Nordic nRF RTC (Real-Time Counter)2

nordic,nrf-rtc

Sensors

on-board

STMicroelectronics LIS2DH12 3-axis accelerometer1

st,lis2dh12

Serial controller

on-chip

Nordic nRF family UARTE (UART with EasyDMA)22

nordic,nrf-uarte

SPI

on-chip

Nordic nRF family SPIM (SPI master with EasyDMA)13

nordic,nrf-spim

SRAM

on-chip

Generic on-chip SRAM1

mmio-sram

Timer

on-chip

ARMv8-M System Tick1

arm,armv8m-systick

Watchdog

on-chip

Nordic nRF family WDT (Watchdog Timer)1

nordic,nrf-wdt

actinius_icarus@1.4.0/nrf9160/ns target

Type

Location

Description

Compatible

CPU

on-chip

ARM Cortex-M33F CPU1

arm,cortex-m33f

ADC

on-chip

Nordic Semiconductor nRF family SAADC node1

nordic,nrf-saadc

ARM architecture

on-chip

Nordic EGU (Event Generator Unit)6

nordic,nrf-egu

on-chip

Nordic KMU (Key Management Unit)1

nordic,nrf-kmu

Audio

on-chip

Nordic PDM (Pulse Density Modulation interface)1

nordic,nrf-pdm

Clock control

on-chip

Nordic nRF clock control node1

nordic,nrf-clock

Counter

on-chip

Nordic nRF timer node3

nordic,nrf-timer

Flash controller

on-chip

Nordic NVMC (Non-Volatile Memory Controller)1

nordic,nrf91-flash-controller

GPIO & Headers

on-chip

NRF5 GPIO1

nordic,nrf-gpio

on-chip

NRF5 GPIOTE1

nordic,nrf-gpiote

on-board

GPIO pins exposed on Adafruit Feather headers1

adafruit-feather-header

I2C

on-chip

Nordic nRF family TWIM (TWI master with EasyDMA)13

nordic,nrf-twim

I2S

on-chip

Nordic I2S (Inter-IC sound interface)1

nordic,nrf-i2s

IIO

on-board

Voltage Divider1

voltage-divider

Input

on-board

Group of GPIO-bound input keys1

gpio-keys

Interrupt controller

on-chip

ARMv8-M NVIC (Nested Vectored Interrupt Controller)1

arm,v8m-nvic

IPC

on-chip

Nordic nRF family IPC (Interprocessor Communication)1

nordic,nrf-ipc

LED

on-board

Group of GPIO-controlled LEDs1

gpio-leds

on-board

Group of PWM-controlled LEDs1

pwm-leds

Miscellaneous

on-chip

Nordic DPPIC (Distributed Programmable Peripheral Interconnect Controller)1

nordic,nrf-dppic

on-board

The Icarus boards provide the user with 2 options regarding SIM usage for LTE-M/NB-IoT communication1

actinius-sim-select

MMU / MPU

on-chip

ARMv8-M MPU (Memory Protection Unit)1

arm,armv8m-mpu

MTD

on-chip

Flash node1

soc-nv-flash

on-chip

Fixed partitions of a flash (or other non-volatile storage) memory1

fixed-partitions

on-chip

Fixed subpartitions of a flash (or other nonvolatile storage) memory2

fixed-subpartitions

Pin control

on-chip

Nordic nRF family Pin Controller1

nordic,nrf-pinctrl

Power management

on-chip

Nordic VMC (Volatile Memory Controller)1

nordic,nrf-vmc

on-chip

Nordic nRF power control node1

nordic,nrf-power

PWM

on-chip

nRF PWM13

nordic,nrf-pwm

on-chip

nRFx S/W PWM1

nordic,nrf-sw-pwm

Regulator

on-chip

Nordic REGULATORS (voltage regulators control module) on nRF91X1

nordic,nrf91x-regulators

Retained memory

on-chip

Nordic GPREGRET (General Purpose Register Retention) device2

nordic,nrf-gpregret

RTC

on-chip

Nordic nRF RTC (Real-Time Counter)2

nordic,nrf-rtc

Sensors

on-board

STMicroelectronics LIS2DH12 3-axis accelerometer1

st,lis2dh12

Serial controller

on-chip

Nordic nRF family UARTE (UART with EasyDMA)22

nordic,nrf-uarte

SPI

on-chip

Nordic nRF family SPIM (SPI master with EasyDMA)13

nordic,nrf-spim

SRAM

on-chip

Generic on-chip SRAM1

mmio-sram

Timer

on-chip

ARMv8-M System Tick1

arm,armv8m-systick

Watchdog

on-chip

Nordic nRF family WDT (Watchdog Timer)1

nordic,nrf-wdt

actinius_icarus@2.0.0/nrf9160 target

Type

Location

Description

Compatible

CPU

on-chip

ARM Cortex-M33F CPU1

arm,cortex-m33f

ADC

on-chip

Nordic Semiconductor nRF family SAADC node1

nordic,nrf-saadc

ARM architecture

on-chip

Nordic EGU (Event Generator Unit)6

nordic,nrf-egu

on-chip

Nordic KMU (Key Management Unit)1

nordic,nrf-kmu

on-chip

Nordic nRF family CTRL-AP (Control Access Port)1

nordic,nrf-ctrlapperi

on-chip

Nordic SPU (System Protection Unit)1

nordic,nrf-spu

on-chip

Nordic UICR (User Information Configuration Registers)1

nordic,nrf-uicr

Audio

on-chip

Nordic PDM (Pulse Density Modulation interface)1

nordic,nrf-pdm

Clock control

on-chip

Nordic nRF clock control node1

nordic,nrf-clock

Counter

on-chip

Nordic nRF timer node3

nordic,nrf-timer

Cryptographic accelerator

on-chip

ARM TrustZone CryptoCell 3101

arm,cryptocell-310

Flash controller

on-chip

Nordic NVMC (Non-Volatile Memory Controller)1

nordic,nrf91-flash-controller

GPIO & Headers

on-chip

NRF5 GPIO1

nordic,nrf-gpio

on-chip

NRF5 GPIOTE11

nordic,nrf-gpiote

on-board

GPIO pins exposed on Adafruit Feather headers1

adafruit-feather-header

I2C

on-chip

Nordic nRF family TWIM (TWI master with EasyDMA)13

nordic,nrf-twim

I2S

on-chip

Nordic I2S (Inter-IC sound interface)1

nordic,nrf-i2s

IIO

on-board

Voltage Divider1

voltage-divider

Input

on-board

Group of GPIO-bound input keys1

gpio-keys

Interrupt controller

on-chip

ARMv8-M NVIC (Nested Vectored Interrupt Controller)1

arm,v8m-nvic

IPC

on-chip

Nordic nRF family IPC (Interprocessor Communication)1

nordic,nrf-ipc

LED

on-board

Group of GPIO-controlled LEDs1

gpio-leds

on-board

Group of PWM-controlled LEDs1

pwm-leds

Miscellaneous

on-chip

Nordic DPPIC (Distributed Programmable Peripheral Interconnect Controller)1

nordic,nrf-dppic

on-chip

Nordic FICR (Factory Information Configuration Registers)1

nordic,nrf-ficr

on-board

The Icarus boards provide the user with 2 options regarding SIM usage for LTE-M/NB-IoT communication1

actinius-sim-select

on-board

The Icarus IoT Board v2 provides the user with an option to disable the charger or to leave it on auto1

actinius-charger-enable

MMU / MPU

on-chip

ARMv8-M MPU (Memory Protection Unit)1

arm,armv8m-mpu

MTD

on-chip

Flash node1

soc-nv-flash

on-chip

Fixed partitions of a flash (or other non-volatile storage) memory1

fixed-partitions

on-chip

Fixed subpartitions of a flash (or other nonvolatile storage) memory2

fixed-subpartitions

on-board

Properties supporting Zephyr spi-nor flash driver (over the Zephyr SPI API) control of serial flash memories using the standard M25P80-based command set1

jedec,spi-nor

Pin control

on-chip

Nordic nRF family Pin Controller1

nordic,nrf-pinctrl

Power management

on-chip

Nordic VMC (Volatile Memory Controller)1

nordic,nrf-vmc

on-chip

Nordic nRF power control node1

nordic,nrf-power

PWM

on-chip

nRF PWM13

nordic,nrf-pwm

on-chip

nRFx S/W PWM1

nordic,nrf-sw-pwm

Regulator

on-chip

Nordic REGULATORS (voltage regulators control module) on nRF91X1

nordic,nrf91x-regulators

Retained memory

on-chip

Nordic GPREGRET (General Purpose Register Retention) device2

nordic,nrf-gpregret

RTC

on-chip

Nordic nRF RTC (Real-Time Counter)2

nordic,nrf-rtc

Sensors

on-board

STMicroelectronics LIS2DH12 3-axis accelerometer1

st,lis2dh12

Serial controller

on-chip

Nordic nRF family UARTE (UART with EasyDMA)22

nordic,nrf-uarte

SPI

on-chip

Nordic nRF family SPIM (SPI master with EasyDMA)13

nordic,nrf-spim

SRAM

on-chip

Generic on-chip SRAM1

mmio-sram

Timer

on-chip

ARMv8-M System Tick1

arm,armv8m-systick

Watchdog

on-chip

Nordic nRF family WDT (Watchdog Timer)1

nordic,nrf-wdt

actinius_icarus@2.0.0/nrf9160/ns target

Type

Location

Description

Compatible

CPU

on-chip

ARM Cortex-M33F CPU1

arm,cortex-m33f

ADC

on-chip

Nordic Semiconductor nRF family SAADC node1

nordic,nrf-saadc

ARM architecture

on-chip

Nordic EGU (Event Generator Unit)6

nordic,nrf-egu

on-chip

Nordic KMU (Key Management Unit)1

nordic,nrf-kmu

Audio

on-chip

Nordic PDM (Pulse Density Modulation interface)1

nordic,nrf-pdm

Clock control

on-chip

Nordic nRF clock control node1

nordic,nrf-clock

Counter

on-chip

Nordic nRF timer node3

nordic,nrf-timer

Flash controller

on-chip

Nordic NVMC (Non-Volatile Memory Controller)1

nordic,nrf91-flash-controller

GPIO & Headers

on-chip

NRF5 GPIO1

nordic,nrf-gpio

on-chip

NRF5 GPIOTE1

nordic,nrf-gpiote

on-board

GPIO pins exposed on Adafruit Feather headers1

adafruit-feather-header

I2C

on-chip

Nordic nRF family TWIM (TWI master with EasyDMA)13

nordic,nrf-twim

I2S

on-chip

Nordic I2S (Inter-IC sound interface)1

nordic,nrf-i2s

IIO

on-board

Voltage Divider1

voltage-divider

Input

on-board

Group of GPIO-bound input keys1

gpio-keys

Interrupt controller

on-chip

ARMv8-M NVIC (Nested Vectored Interrupt Controller)1

arm,v8m-nvic

IPC

on-chip

Nordic nRF family IPC (Interprocessor Communication)1

nordic,nrf-ipc

LED

on-board

Group of GPIO-controlled LEDs1

gpio-leds

on-board

Group of PWM-controlled LEDs1

pwm-leds

Miscellaneous

on-chip

Nordic DPPIC (Distributed Programmable Peripheral Interconnect Controller)1

nordic,nrf-dppic

on-board

The Icarus boards provide the user with 2 options regarding SIM usage for LTE-M/NB-IoT communication1

actinius-sim-select

on-board

The Icarus IoT Board v2 provides the user with an option to disable the charger or to leave it on auto1

actinius-charger-enable

MMU / MPU

on-chip

ARMv8-M MPU (Memory Protection Unit)1

arm,armv8m-mpu

MTD

on-chip

Flash node1

soc-nv-flash

on-chip

Fixed partitions of a flash (or other non-volatile storage) memory1

fixed-partitions

on-chip

Fixed subpartitions of a flash (or other nonvolatile storage) memory2

fixed-subpartitions

on-board

Properties supporting Zephyr spi-nor flash driver (over the Zephyr SPI API) control of serial flash memories using the standard M25P80-based command set1

jedec,spi-nor

Pin control

on-chip

Nordic nRF family Pin Controller1

nordic,nrf-pinctrl

Power management

on-chip

Nordic VMC (Volatile Memory Controller)1

nordic,nrf-vmc

on-chip

Nordic nRF power control node1

nordic,nrf-power

PWM

on-chip

nRF PWM13

nordic,nrf-pwm

on-chip

nRFx S/W PWM1

nordic,nrf-sw-pwm

Regulator

on-chip

Nordic REGULATORS (voltage regulators control module) on nRF91X1

nordic,nrf91x-regulators

Retained memory

on-chip

Nordic GPREGRET (General Purpose Register Retention) device2

nordic,nrf-gpregret

RTC

on-chip

Nordic nRF RTC (Real-Time Counter)2

nordic,nrf-rtc

Sensors

on-board

STMicroelectronics LIS2DH12 3-axis accelerometer1

st,lis2dh12

Serial controller

on-chip

Nordic nRF family UARTE (UART with EasyDMA)22

nordic,nrf-uarte

SPI

on-chip

Nordic nRF family SPIM (SPI master with EasyDMA)13

nordic,nrf-spim

SRAM

on-chip

Generic on-chip SRAM1

mmio-sram

Timer

on-chip

ARMv8-M System Tick1

arm,armv8m-systick

Watchdog

on-chip

Nordic nRF family WDT (Watchdog Timer)1

nordic,nrf-wdt

SIM Selection

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

Charger Enable/Disable

Since hardware version 2.0 the charger can be disabled by adjusting the charger property of the charger_enable device tree node.

Security components

  • Implementation Defined Attribution Unit (IDAU [1]). 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 and CONFIG_TRUSTED_EXECUTION_SECURE=y in the application project configuration file.

  2. Build the Non-Secure Zephyr application using -DBOARD=actinius_icarus/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 “Get Started” Guide [3] or the Actinius Documentation Portal [4].

References