boards/actinius/icarus/doc/index.html · boards/actinius/icarus/doc/index.rst 공식 원문 ↗

Zephyr 3.7.0 · Actinius · nRF9160 Feather

Actinius Icarus

Feather form factor 하나에 LTE-M·NB-IoT·GPS·가속도계·eSIM을 담은 nRF9160 board의 실제 연결과 보안 설정을 설명합니다.

Official pathboards/actinius/icarus/doc/index.html
Source fileboards/actinius/icarus/doc/index.rst
Source versionZephyr 3.7.0
TranslationFull · reviewed

본문 기준: Zephyr 3.7.0 LTS3 · 이후 유지보수 패치는 별도입니다.

Part 1

요약·해설

Icarus는 Adafruit Feather/FeatherWing form factor의 cellular IoT board입니다. nRF9160 modem과 Cortex-M33F를 중심으로 LTE-M, NB-IoT, GPS, accelerometer, USB, LiPo charger, eSIM과 nano-SIM을 결합합니다.

Actinius Icarus board
Actinius Icarus nRF9160 Feather. 이미지 출처: Actinius, Zephyr 3.7.0.
Cellular

LTE-M, NB-IoT, GPS, eSIM + nano-SIM

Form factor

Adafruit Feather/FeatherWing compatible

Security

Armv8-M, IDAU/SPU, Secure boot, /ns target

Part 2

접을 수 있는 영어 원문 전체

영어 원문 전체 펼치기
원문 SHA-256 BDBE9D2BCE3FC20E71CF0A1842E0A28A6B46A6630CF864A7E17FDC1889B55022
.. _actinius_icarus:

Actinius Icarus
###############

Overview
********

.. figure:: ../../../../../../../boards/actinius/icarus/doc/img/Icarus_front.jpg
     :align: center
     :alt: Icarus IoT Dev Board

     Icarus IoT Dev Board (nRF9160 Feather)

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):

* :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)`

Hardware
********

The detailed information about the on-board hardware can be found at the `Icarus Product Website`_.

.. figure:: ../../../../../../../boards/actinius/icarus/doc/img/Icarus_pinouts.jpg
     :align: center
     :alt: 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                 | uart0                |
|              | Charger enable pin (Icarus v2.0)      | gpio0 (Icarus v2.0)  |
+--------------+---------------------------------------+----------------------+
| P0.25        | USB - FTDI serial CTS                 | uart0                |
|              | FLASH memory SPI CS pin (Icarus v2.0) | gpio0 (Icarus v2.0)  |
+--------------+---------------------------------------+----------------------+

Supported Features
==================

The actinius_icarus board configuration supports the following
hardware features:

+-----------+------------+----------------------+
| Interface | Controller | Driver/Component     |
+===========+============+======================+
| ADC       | on-chip    | adc                  |
+-----------+------------+----------------------+
| CLOCK     | on-chip    | clock_control        |
+-----------+------------+----------------------+
| FLASH     | on-chip    | flash                |
+-----------+------------+----------------------+
| GPIO      | on-chip    | gpio                 |
+-----------+------------+----------------------+
| I2C(M)    | on-chip    | i2c                  |
+-----------+------------+----------------------+
| MPU       | on-chip    | arch/arm             |
+-----------+------------+----------------------+
| NVIC      | on-chip    | arch/arm             |
+-----------+------------+----------------------+
| PWM       | on-chip    | pwm                  |
+-----------+------------+----------------------+
| SPI(M/S)  | on-chip    | spi                  |
+-----------+------------+----------------------+
| SPU       | on-chip    | system protection    |
+-----------+------------+----------------------+
| UARTE     | on-chip    | serial               |
+-----------+------------+----------------------+
| ACCEL     | st         | lis2dh               |
+-----------+------------+----------------------+

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`_).  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`_ or the
`Actinius Documentation Portal`_.

References
**********

.. target-notes::

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

.. _Icarus Product Website:
   https://www.actinius.com/icarus

.. _Icarus "Get Started" Guide:
   https://www.actinius.com/get-started

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

Part 3

한국어 전문 번역

개요

Icarus IoT development board
Icarus IoT development board(nRF9160 Feather).

Icarus는 Adafruit Feather/FeatherWing form factor를 사용하는 경제적인 cellular IoT board입니다. Nordic Semiconductor nRF9160 modem을 중심으로 LTE-M, NB-IoT, GPS, accelerometer, USB, LiPo charger, eSIM과 nano-SIM connector를 결합합니다.

main microcontroller는 Arm Cortex-M33F CPU와 Armv8-M Security Extension을 갖춘 Nordic Semiconductor nRF9160이며, Nordic가 직접 제공하는 장치는 다음과 같습니다.

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

하드웨어

on-board hardware의 자세한 정보는 Icarus product website에서 확인할 수 있습니다.

Icarus pinout
Icarus IoT development board pinout.

사용자가 사용할 수 있는 외부 pin

Icarus pinFunctionDescriptionDevice-tree node
RSTResetinternal pull-up을 갖춘 active-low reset-
3.3VPower outputmain 3.3 V supply-
NC-연결되지 않음-
GNDPower outputGround-
14 / A1GPIO / Analog innRF9160 P0.14 / AIN1gpio0 / adc_1
15 / A2GPIO / Analog innRF9160 P0.15 / AIN2gpio0 / adc_2
16 / A3GPIO / Analog innRF9160 P0.16 / AIN3gpio0 / adc_3
17 / A4GPIO / Analog innRF9160 P0.17 / AIN4gpio0 / adc_4
18 / A5GPIO / Analog innRF9160 P0.18 / AIN5gpio0 / adc_5
19 / A6GPIO / Analog innRF9160 P0.19 / AIN6gpio0 / adc_6
20 / SCKGPIO / SPI pinnRF9160 P0.20 / SPI SCK pingpio0 / spi3
21 / MOSIGPIO / SPI pinnRF9160 P0.21 / SPI MOSI pingpio0 / spi3
22 / MISOGPIO / SPI pinnRF9160 P0.22 / SPI MISO pingpio0 / spi3
23 / RXGPIO / UART pinnRF9160 P0.23 / UART RX pingpio0 / uart1
24 / TXGPIO / UART pinnRF9160 P0.24 / UART TX pingpio0 / uart1
VINPower inputvoltage input, maximum 10.2 V-
VBATPower inputbattery voltage input-
ENPower enablepower enable, low로 내리면 power disable-
USBPower inputUSB voltage inputgpio0
4GPIOnRF9160 P0.04gpio0
3GPIOnRF9160 P0.03gpio0
2GPIOnRF9160 P0.02gpio0
1GPIOnRF9160 P0.01gpio0
0GPIOnRF9160 P0.00gpio0
30GPIOnRF9160 P0.30gpio0
31GPIOnRF9160 P0.31gpio0
SCLGPIO / I2C pinnRF9160 P0.26 / I2C SCL pingpio0 / i2c2
SDAGPIO / I2C pinnRF9160 P0.27 / I2C SDA pingpio0 / i2c2

내부에 연결된 nRF9160 pin

nRF9160 pinFunctionDevice-tree node
P0.05User buttonbutton0
P0.10Red LEDled0 / pwm-led0
P0.11Green LEDled1 / pwm-led1
P0.12Blue LEDled2 / pwm-led2
P0.28Accelerometer Interrupt 1lis2dh12-accel
P0.29Accelerometer Interrupt 2lis2dh12-accel
P0.08SIM select pingpio0
P0.13 / AIN0Battery voltage measurementadc_0
P0.06USB - FTDI serial RXuart0
P0.09USB - FTDI serial TXuart0
P0.07USB - FTDI serial RTS
Charger enable pin(Icarus v2.0)
uart0
gpio0(Icarus v2.0)
P0.25USB - FTDI serial CTS
FLASH memory SPI CS pin(Icarus v2.0)
uart0
gpio0(Icarus v2.0)

지원 기능

actinius_icarus board configuration은 다음 hardware 기능을 지원합니다.

InterfaceControllerDriver/Component
ADCon-chipadc
CLOCKon-chipclock_control
FLASHon-chipflash
GPIOon-chipgpio
I2C(M)on-chipi2c
MPUon-chiparch/arm
NVICon-chiparch/arm
PWMon-chippwm
SPI(M/S)on-chipspi
SPUon-chipsystem protection
UARTEon-chipserial
ACCELstlis2dh

SIM 선택

eSIM 또는 nano-SIM 선택은 Devicetree의 sim_select node에 있는 sim property를 조정해 설정할 수 있습니다.

Charger 활성화/비활성화

hardware version 2.0부터는 charger_enable Devicetree node의 charger property를 조정해 charger를 비활성화할 수 있습니다.

보안 구성요소

  • IDAU(Implementation Defined Attribution Unit): System Protection Unit(SPU)로 구현되며 secure와 non-secure memory map을 정의합니다. 기본값에서는 flash, SRAM, peripheral address space를 포함한 전체 memory space에 secure access만 허용됩니다.
  • Secure boot.

Secure/Non-Secure Zephyr application build

다음 순서가 필요합니다.

  1. Secure Zephyr application을 -DBOARD=actinius_icarus와 application project 설정의 CONFIG_TRUSTED_EXECUTION_SECURE=y로 build합니다.
  2. Non-Secure Zephyr application을 -DBOARD=actinius_icarus/ns로 build합니다.
  3. 두 binary를 하나로 합칩니다.

Segger Embedded Studio v4.18 이상에서는 이 기능을 비활성화하지 않은 한 두 binary의 build, merge, burn이 자동으로 수행됩니다.

Secure/Non-Secure application을 만들 때 Secure application은 Non-Secure firmware가 사용하는 모든 CPU resource에 Non-Secure access를 허용하도록 IDAU(SPU)를 설정해야 합니다. SPU 설정은 Non-Secure application으로 jump하기 전에 끝나야 합니다.

자세한 정보는 Icarus Get Started guide 또는 Actinius documentation portal에서 확인할 수 있습니다.

참고 자료

Source

출처

영어 원문에는 문단, 문서 지시문, 표, 코드, 코드 심벌, 경로를 그대로 보존했습니다.