1.. zephyr:board:: octopus_som
2
3Overview
4********
5
6Octopus SoM is a System on Module (SoM) built around the nRF9160 SiP
7offering NB-IoT and LTE-M connectivity, GPS and accelerometer.
8It supports on board eSIM and external nano SIM connector. It's purpose
9is to provide flexible hardware platform for IoT applications.
10
11nRF9160 SiP contains ARM Cortex-M33 application processor and the
12following devices:
13
14* :abbr:`ADC (Analog to Digital Converter)`
15* CLOCK
16* FLASH
17* :abbr:`GPIO (General Purpose Input Output)`
18* :abbr:`I2C (Inter-Integrated Circuit)`
19* :abbr:`MPU (Memory Protection Unit)`
20* :abbr:`NVIC (Nested Vectored Interrupt Controller)`
21* :abbr:`PWM (Pulse Width Modulation)`
22* :abbr:`RTC (nRF RTC System Clock)`
23* Segger RTT (RTT Console)
24* :abbr:`SPI (Serial Peripheral Interface)`
25* :abbr:`UARTE (Universal asynchronous receiver-transmitter with EasyDMA)`
26* :abbr:`WDT (Watchdog Timer)`
27* :abbr:`IDAU (Implementation Defined Attribution Unit)`
28
29More information about the board can be found at the `Octopus SoM Product Page`_ and
30in the `Octopus SoM Documentation`_.
31
32Hardware
33********
34
35The ``octopus_som/nrf9160`` and ``octopus_som/nrf9160/ns`` board targets support the
36following hardware features:
37
38+-----------+------------+----------------------+
39| Interface | Controller | Driver/Component     |
40+===========+============+======================+
41| ADC       | on-chip    | adc                  |
42+-----------+------------+----------------------+
43| CLOCK     | on-chip    | clock_control        |
44+-----------+------------+----------------------+
45| FLASH     | on-chip    | flash                |
46+-----------+------------+----------------------+
47| GPIO      | on-chip    | gpio                 |
48+-----------+------------+----------------------+
49| I2C(M)    | on-chip    | i2c                  |
50+-----------+------------+----------------------+
51| MPU       | on-chip    | arch/arm             |
52+-----------+------------+----------------------+
53| NVIC      | on-chip    | arch/arm             |
54+-----------+------------+----------------------+
55| PWM       | on-chip    | pwm                  |
56+-----------+------------+----------------------+
57| RTC       | on-chip    | system clock         |
58+-----------+------------+----------------------+
59| RTT       | Segger     | console              |
60+-----------+------------+----------------------+
61| SPI(M/S)  | on-chip    | spi                  |
62+-----------+------------+----------------------+
63| SPU       | on-chip    | system protection    |
64+-----------+------------+----------------------+
65| UARTE     | on-chip    | serial               |
66+-----------+------------+----------------------+
67| WDT       | on-chip    | watchdog             |
68+-----------+------------+----------------------+
69| ACCEL     | Analog     | adxl362              |
70+-----------+------------+----------------------+
71
72Connections and IOs
73===================
74
75Accelerometer
76-------------
77* MISO = P0.05
78* MOSI = P0.09
79* SCK = P0.10
80* CS = P0.05
81* INT1 = P0.12
82
83LED
84---
85* LED1 (green) = P0.07
86
87SIM select switch
88-----------------
89* Select = P0.25
90
91Programming and Debugging
92*************************
93
94Norik Octopus SoM can be programmed and debugged using the exposed SWD pins.
95
96Building an application
97=======================
98
99In most case you'll need to use ``octopus_som/nrf9160/ns`` board target for building examples.
100Some examples don't require non secure mode and can be built with ``octopus_som/nrf9160`` board target.
101
102Flashing
103========
104Refer to the instruction in the :ref:`nordic_segger` page to install and
105configure all the necessary software.
106
107Use the :zephyr:code-sample:`blinky` sample to test if Zephyr is running correctly on your board.
108
109.. zephyr-app-commands::
110   :zephyr-app: samples/basic/blinky
111   :board: octopus_som/nrf9160
112   :goals: build flash
113
114Debugging
115=========
116Refer to the instruction in the :ref:`nordic_segger` page for information on
117debugging.
118
119References
120**********
121
122.. target-notes::
123
124.. _Octopus SoM Product Page: https://www.norik.com/octopus-som/
125.. _Octopus SoM Documentation: https://www.norik.com/wp-content/uploads/2024/09/Octopus_SoM_Datasheet.pdf
126