boards: arm: Add Dragino NBSN95 NB-IoT node
add board support for Dragino NBSN95 NB-IoT sensor node. Initial support only includes UART (with followup patches on BC95 and other peripherals) Signed-off-by: Parthiban Nallathambi <parthiban@linumiz.com>
This commit is contained in:
parent
36db386c33
commit
c235144dc2
9 changed files with 346 additions and 0 deletions
8
boards/arm/dragino_nbsn95/Kconfig.board
Normal file
8
boards/arm/dragino_nbsn95/Kconfig.board
Normal file
|
@ -0,0 +1,8 @@
|
||||||
|
# Dragino NBSN95 NB-IoT Sensor Node board configuration
|
||||||
|
|
||||||
|
# Copyright (c) 2021 Next Big Thing AG
|
||||||
|
# SPDX-License-Identifier: Apache-2.0
|
||||||
|
|
||||||
|
config BOARD_DRAGINO_NBSN95
|
||||||
|
bool "Dragino NBSN95 Sensor Node"
|
||||||
|
depends on SOC_STM32L072XX
|
11
boards/arm/dragino_nbsn95/Kconfig.defconfig
Normal file
11
boards/arm/dragino_nbsn95/Kconfig.defconfig
Normal file
|
@ -0,0 +1,11 @@
|
||||||
|
# Dragino NBSN95 NB-IoT Sensor Node board configuration
|
||||||
|
|
||||||
|
# Copyright (c) 2021 Next Big Thing AG
|
||||||
|
# SPDX-License-Identifier: Apache-2.0
|
||||||
|
|
||||||
|
if BOARD_DRAGINO_NBSN95
|
||||||
|
|
||||||
|
config BOARD
|
||||||
|
default "dragino_nbsn95"
|
||||||
|
|
||||||
|
endif # BOARD_DRAGINO_NBSN95
|
6
boards/arm/dragino_nbsn95/board.cmake
Normal file
6
boards/arm/dragino_nbsn95/board.cmake
Normal file
|
@ -0,0 +1,6 @@
|
||||||
|
# SPDX-License-Identifier: Apache-2.0
|
||||||
|
|
||||||
|
board_runner_args(jlink "--device=STM32L072CZ" "--speed=4000")
|
||||||
|
|
||||||
|
include(${ZEPHYR_BASE}/boards/common/openocd.board.cmake)
|
||||||
|
include(${ZEPHYR_BASE}/boards/common/jlink.board.cmake)
|
BIN
boards/arm/dragino_nbsn95/doc/img/dragino_nbsn95.png
Normal file
BIN
boards/arm/dragino_nbsn95/doc/img/dragino_nbsn95.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 513 KiB |
195
boards/arm/dragino_nbsn95/doc/index.rst
Normal file
195
boards/arm/dragino_nbsn95/doc/index.rst
Normal file
|
@ -0,0 +1,195 @@
|
||||||
|
.. _dragino_nbsn95_board:
|
||||||
|
|
||||||
|
Dragino NBSN95 NB-IoT Sensor Node
|
||||||
|
#################################
|
||||||
|
|
||||||
|
Overview
|
||||||
|
********
|
||||||
|
|
||||||
|
The Dragino NBSN95 NB-IoT Sensor Node for IoT allows users to develop
|
||||||
|
applications with NB-IoT connectivity via the Quectel BC95-G.
|
||||||
|
Dragino NBSN95 enables a wide diversity of applications by exploiting
|
||||||
|
low-power communication, ARM |reg| Cortex |reg|-M0 core-based
|
||||||
|
STM32L0 Series features.
|
||||||
|
|
||||||
|
This kit provides:
|
||||||
|
|
||||||
|
- STM32L072CZ MCU
|
||||||
|
- Quectel BC95-G NB-IoT
|
||||||
|
- Expansion connectors:
|
||||||
|
- PMOD
|
||||||
|
- Li/SOCI2 Unchargable Battery
|
||||||
|
- GPIOs exposed via screw terminals on the carrier board
|
||||||
|
- Housing
|
||||||
|
|
||||||
|
.. image:: img/dragino_nbsn95.png
|
||||||
|
:width: 531px
|
||||||
|
:align: center
|
||||||
|
:height: 354px
|
||||||
|
:alt: Dragino NBSN95
|
||||||
|
|
||||||
|
More information about the board can be found at the `Dragino NBSN95 website`_.
|
||||||
|
|
||||||
|
Hardware
|
||||||
|
********
|
||||||
|
|
||||||
|
The STM32L072CZ SoC provides the following hardware IPs:
|
||||||
|
|
||||||
|
- Ultra-low-power (down to 0.29 µA Standby mode and 93 uA/MHz run mode)
|
||||||
|
- Core: ARM |reg| 32-bit Cortex |reg|-M0+ CPU, frequency up to 32 MHz
|
||||||
|
- Clock Sources:
|
||||||
|
|
||||||
|
- 1 to 32 MHz crystal oscillator
|
||||||
|
- 32 kHz crystal oscillator for RTC (LSE)
|
||||||
|
- Internal 16 MHz factory-trimmed RC ( |plusminus| 1%)
|
||||||
|
- Internal low-power 37 kHz RC ( |plusminus| 5%)
|
||||||
|
- Internal multispeed low-power 65 kHz to 4.2 MHz RC
|
||||||
|
- RTC with HW calendar, alarms and calibration
|
||||||
|
- Up to 24 capacitive sensing channels: support touchkey, linear and rotary touch sensors
|
||||||
|
- 11x timers:
|
||||||
|
|
||||||
|
- 2x 16-bit with up to 4 channels
|
||||||
|
- 2x 16-bit with up to 2 channels
|
||||||
|
- 1x 16-bit ultra-low-power timer
|
||||||
|
- 1x SysTick
|
||||||
|
- 1x RTC
|
||||||
|
- 2x 16-bit basic for DAC
|
||||||
|
- 2x watchdogs (independent/window)
|
||||||
|
- Up to 84 fast I/Os, most 5 V-tolerant.
|
||||||
|
- Memories
|
||||||
|
|
||||||
|
- Up to 192 KB Flash, 2 banks read-while-write, proprietary code readout protection
|
||||||
|
- Up to 20 KB of SRAM
|
||||||
|
- External memory interface for static memories supporting SRAM, PSRAM, NOR and NAND memories
|
||||||
|
- Rich analog peripherals (independent supply)
|
||||||
|
|
||||||
|
- 1x 12-bit ADC 1.14 MSPS
|
||||||
|
- 2x 12-bit DAC
|
||||||
|
- 2x ultra-low-power comparators
|
||||||
|
- 11x communication interfaces
|
||||||
|
|
||||||
|
- USB OTG 2.0 full-speed, LPM and BCD
|
||||||
|
- 3x I2C FM+(1 Mbit/s), SMBus/PMBus
|
||||||
|
- 4x USARTs (ISO 7816, LIN, IrDA, modem)
|
||||||
|
- 6x SPIs (4x SPIs with the Quad SPI)
|
||||||
|
- 7-channel DMA controller
|
||||||
|
- True random number generator
|
||||||
|
- CRC calculation unit, 96-bit unique ID
|
||||||
|
- Development support: serial wire debug (SWD), JTAG, Embedded Trace Macrocell |trade|
|
||||||
|
|
||||||
|
|
||||||
|
More information about STM32L072CZ can be found here:
|
||||||
|
|
||||||
|
- `STM32L072CZ on www.st.com`_
|
||||||
|
- `STM32L0x2 reference manual`_
|
||||||
|
|
||||||
|
Supported Features
|
||||||
|
==================
|
||||||
|
|
||||||
|
The Zephyr Dragino NBSN95 Board board configuration supports the following hardware features:
|
||||||
|
|
||||||
|
+-----------+------------+-------------------------------------+
|
||||||
|
| Interface | Controller | Driver/Component |
|
||||||
|
+===========+============+=====================================+
|
||||||
|
| UART | on-chip | serial port-polling; |
|
||||||
|
| | | serial port-interrupt |
|
||||||
|
+-----------+------------+-------------------------------------+
|
||||||
|
| PINMUX | on-chip | pinmux |
|
||||||
|
+-----------+------------+-------------------------------------+
|
||||||
|
| GPIO | on-chip | gpio |
|
||||||
|
+-----------+------------+-------------------------------------+
|
||||||
|
|
||||||
|
Other hardware features are not yet supported on this Zephyr port.
|
||||||
|
|
||||||
|
The default configuration can be found in the defconfig file:
|
||||||
|
|
||||||
|
``boards/arm/dragino_nbsn95/dragino_nbsn95_defconfig``
|
||||||
|
|
||||||
|
|
||||||
|
Connections and IOs
|
||||||
|
===================
|
||||||
|
|
||||||
|
Dragino NBSN95 Board has GPIO controllers. These controllers are responsible for pin muxing,
|
||||||
|
input/output, pull-up, etc.
|
||||||
|
|
||||||
|
Available pins:
|
||||||
|
---------------
|
||||||
|
|
||||||
|
For detailed information about available pins please refer to `Dragino NBSN95 website`_.
|
||||||
|
|
||||||
|
Default Zephyr Peripheral Mapping:
|
||||||
|
----------------------------------
|
||||||
|
|
||||||
|
- UART_1_TX : PB6
|
||||||
|
- UART_1_RX : PB7
|
||||||
|
- UART_2_TX : PA2
|
||||||
|
- UART_2_RX : PA3
|
||||||
|
|
||||||
|
System Clock
|
||||||
|
------------
|
||||||
|
|
||||||
|
Dragino NBSN95 System Clock is at 32MHz,
|
||||||
|
|
||||||
|
Serial Port
|
||||||
|
-----------
|
||||||
|
|
||||||
|
Dragino NBSN95 board has 2 U(S)ARTs. The Zephyr console output is assigned to UART1.
|
||||||
|
Default settings are 115200 8N1.
|
||||||
|
|
||||||
|
Programming and Debugging
|
||||||
|
*************************
|
||||||
|
|
||||||
|
Applications for the ``dragino_nbsn95`` board configuration can be built and
|
||||||
|
flashed in the usual way (see :ref:`build_an_application` and
|
||||||
|
:ref:`application_run` for more details).
|
||||||
|
|
||||||
|
Flashing
|
||||||
|
========
|
||||||
|
|
||||||
|
Dragino NBSN95 board requires an external debugger.
|
||||||
|
|
||||||
|
Flashing an application to Dragino NBSN95
|
||||||
|
-----------------------------------------
|
||||||
|
|
||||||
|
Here is an example for the :ref:`hello_world` application.
|
||||||
|
|
||||||
|
Connect the Dragino NBSN95 to a STLinkV2 to your host computer using the USB port, then
|
||||||
|
run a serial host program to connect with your board. For example:
|
||||||
|
|
||||||
|
.. code-block:: console
|
||||||
|
|
||||||
|
$ minicom -D /dev/ttyACM0
|
||||||
|
|
||||||
|
Then build and flash the application:
|
||||||
|
|
||||||
|
.. zephyr-app-commands::
|
||||||
|
:zephyr-app: samples/hello_world
|
||||||
|
:board: dragino_nbsn95
|
||||||
|
:goals: build flash
|
||||||
|
|
||||||
|
You should see the following message on the console:
|
||||||
|
|
||||||
|
.. code-block:: console
|
||||||
|
|
||||||
|
$ Hello World! dragino_nbsn95
|
||||||
|
|
||||||
|
Debugging
|
||||||
|
=========
|
||||||
|
|
||||||
|
You can debug an application in the usual way. Here is an example for the
|
||||||
|
:ref:`hello_world` application.
|
||||||
|
|
||||||
|
.. zephyr-app-commands::
|
||||||
|
:zephyr-app: samples/hello_world
|
||||||
|
:board: dragino_nbsn95
|
||||||
|
:maybe-skip-config:
|
||||||
|
:goals: debug
|
||||||
|
|
||||||
|
.. _Dragino NBSN95 website:
|
||||||
|
https://www.dragino.com/products/nb-iot/item/163-nbsn95.html
|
||||||
|
|
||||||
|
.. _STM32L072CZ on www.st.com:
|
||||||
|
http://www.st.com/en/microcontrollers/stm32l072cz.html
|
||||||
|
|
||||||
|
.. _STM32L0x2 reference manual:
|
||||||
|
http://www.st.com/resource/en/reference_manual/DM00108281.pdf
|
64
boards/arm/dragino_nbsn95/dragino_nbsn95.dts
Normal file
64
boards/arm/dragino_nbsn95/dragino_nbsn95.dts
Normal file
|
@ -0,0 +1,64 @@
|
||||||
|
/*
|
||||||
|
* Copyright (c) 2021 Next Big Thing AG
|
||||||
|
*
|
||||||
|
* SPDX-License-Identifier: Apache-2.0
|
||||||
|
*/
|
||||||
|
|
||||||
|
/dts-v1/;
|
||||||
|
#include <st/l0/stm32l072Xz.dtsi>
|
||||||
|
#include <st/l0/stm32l072c(b-z)tx-pinctrl.dtsi>
|
||||||
|
|
||||||
|
/ {
|
||||||
|
model = "Dragino NBSN95 NB-IoT Sensor Node";
|
||||||
|
compatible = "vendor,dragino";
|
||||||
|
|
||||||
|
chosen {
|
||||||
|
zephyr,console = &usart2;
|
||||||
|
zephyr,shell-uart = &usart2;
|
||||||
|
zephyr,sram = &sram0;
|
||||||
|
zephyr,flash = &flash0;
|
||||||
|
};
|
||||||
|
|
||||||
|
leds {
|
||||||
|
compatible = "gpio-leds";
|
||||||
|
green_led: led {
|
||||||
|
gpios = <&gpioa 8 GPIO_ACTIVE_HIGH>;
|
||||||
|
label = "User LD1";
|
||||||
|
};
|
||||||
|
};
|
||||||
|
|
||||||
|
aliases {
|
||||||
|
led0 = &green_led;
|
||||||
|
};
|
||||||
|
};
|
||||||
|
|
||||||
|
&clk_hsi {
|
||||||
|
status = "okay";
|
||||||
|
};
|
||||||
|
|
||||||
|
&pll {
|
||||||
|
div = <2>;
|
||||||
|
mul = <4>;
|
||||||
|
clocks = <&clk_hsi>;
|
||||||
|
status = "okay";
|
||||||
|
};
|
||||||
|
|
||||||
|
&rcc {
|
||||||
|
clocks = <&pll>;
|
||||||
|
clock-frequency = <DT_FREQ_M(32)>;
|
||||||
|
ahb-prescaler = <1>;
|
||||||
|
apb1-prescaler = <1>;
|
||||||
|
apb2-prescaler = <1>;
|
||||||
|
};
|
||||||
|
|
||||||
|
&usart1 {
|
||||||
|
pinctrl-0 = <&usart1_tx_pb6 &usart1_rx_pb7>;
|
||||||
|
current-speed = <115200>;
|
||||||
|
status = "okay";
|
||||||
|
};
|
||||||
|
|
||||||
|
&usart2 {
|
||||||
|
pinctrl-0 = <&usart2_tx_pa2 &usart2_rx_pa3>;
|
||||||
|
current-speed = <115200>;
|
||||||
|
status = "okay";
|
||||||
|
};
|
13
boards/arm/dragino_nbsn95/dragino_nbsn95.yaml
Normal file
13
boards/arm/dragino_nbsn95/dragino_nbsn95.yaml
Normal file
|
@ -0,0 +1,13 @@
|
||||||
|
identifier: dragino_nbsn95
|
||||||
|
name: Dragino NBSN95 NB-IoT Sensor Node
|
||||||
|
type: mcu
|
||||||
|
arch: arm
|
||||||
|
toolchain:
|
||||||
|
- zephyr
|
||||||
|
- gnuarmemb
|
||||||
|
- xtools
|
||||||
|
ram: 20
|
||||||
|
flash: 192
|
||||||
|
testing:
|
||||||
|
ignore_tags:
|
||||||
|
- net
|
24
boards/arm/dragino_nbsn95/dragino_nbsn95_defconfig
Normal file
24
boards/arm/dragino_nbsn95/dragino_nbsn95_defconfig
Normal file
|
@ -0,0 +1,24 @@
|
||||||
|
# SPDX-License-Identifier: Apache-2.0
|
||||||
|
|
||||||
|
# Zephyr Kernel Configuration
|
||||||
|
CONFIG_SOC_SERIES_STM32L0X=y
|
||||||
|
|
||||||
|
# Platform Configuration
|
||||||
|
CONFIG_SOC_STM32L072XX=y
|
||||||
|
CONFIG_BOARD_DRAGINO_NBSN95=y
|
||||||
|
|
||||||
|
# Serial Drivers
|
||||||
|
CONFIG_SERIAL=y
|
||||||
|
CONFIG_UART_INTERRUPT_DRIVEN=y
|
||||||
|
# enable console
|
||||||
|
CONFIG_CONSOLE=y
|
||||||
|
CONFIG_UART_CONSOLE=y
|
||||||
|
|
||||||
|
# Pinmux Driver
|
||||||
|
CONFIG_PINMUX=y
|
||||||
|
|
||||||
|
# GPIO Controller
|
||||||
|
CONFIG_GPIO=y
|
||||||
|
|
||||||
|
# Enable Clocks
|
||||||
|
CONFIG_CLOCK_CONTROL=y
|
25
boards/arm/dragino_nbsn95/support/openocd.cfg
Normal file
25
boards/arm/dragino_nbsn95/support/openocd.cfg
Normal file
|
@ -0,0 +1,25 @@
|
||||||
|
# SPDX-License-Identifier: Apache-2.0
|
||||||
|
#
|
||||||
|
# Copyright (c) 2021 Next Big Thing AG
|
||||||
|
|
||||||
|
source [find interface/stlink.cfg]
|
||||||
|
|
||||||
|
transport select hla_swd
|
||||||
|
|
||||||
|
set WORKAREASIZE 0x2000
|
||||||
|
|
||||||
|
source [find target/stm32l0_dual_bank.cfg]
|
||||||
|
|
||||||
|
# There is only system reset line and JTAG/SWD command can be issued when SRST
|
||||||
|
reset_config srst_only
|
||||||
|
|
||||||
|
$_TARGETNAME configure -event gdb-attach {
|
||||||
|
echo "Debugger attaching: halting execution"
|
||||||
|
reset halt
|
||||||
|
gdb_breakpoint_override hard
|
||||||
|
}
|
||||||
|
|
||||||
|
$_TARGETNAME configure -event gdb-detach {
|
||||||
|
echo "Debugger detaching: resuming execution"
|
||||||
|
resume
|
||||||
|
}
|
Loading…
Add table
Add a link
Reference in a new issue