264 lines
9.7 KiB
ReStructuredText
264 lines
9.7 KiB
ReStructuredText
.. zephyr:board:: raytac_mdbt53_db_40
|
|
|
|
Overview
|
|
********
|
|
|
|
Raytac MDBT53-DB-40 demo board is a development board based on the Raytac MDBT53-1M module,
|
|
using Nordic Semiconductor nRF5340 ARM Cortex-M33 SoC. Its design concept is to connect all
|
|
of the module's pins to 2.54mm pin headers. It is convenient for developers to verify whether
|
|
the modules are connected to other peripheral devices or sensors as a tool for software development.
|
|
|
|
The nRF5340 inside the MDBT53-1M module is a
|
|
dual-core SoC based on the Arm® Cortex®-M33 architecture, with:
|
|
|
|
* a full-featured Arm Cortex-M33F core with DSP instructions, FPU, and
|
|
Armv8-M Security Extension, running at up to 128 MHz, referred to as
|
|
the **application core**
|
|
* a secondary Arm Cortex-M33 core, with a reduced feature set, running
|
|
at a fixed 64 MHz, referred to as the **network core**.
|
|
|
|
The ``raytac_mdbt53_db_40/nrf5340/cpuapp`` build target provides support for the application
|
|
core on the nRF5340 SoC. The ``raytac_mdbt53_db_40/nrf5340/cpuapp`` build target provides
|
|
support for the network core on the nRF5340 SoC.
|
|
|
|
nRF5340 SoC provides support for the following devices:
|
|
|
|
* :abbr:`ADC (Analog to Digital Converter)`
|
|
* CLOCK
|
|
* FLASH
|
|
* :abbr:`GPIO (General Purpose Input Output)`
|
|
* :abbr:`IDAU (Implementation Defined Attribution Unit)`
|
|
* :abbr:`I2C (Inter-Integrated Circuit)`
|
|
* :abbr:`MPU (Memory Protection Unit)`
|
|
* :abbr:`NVIC (Nested Vectored Interrupt Controller)`
|
|
* :abbr:`PWM (Pulse Width Modulation)`
|
|
* :abbr:`QSPI (Quad Serial Peripheral Interface)`
|
|
* RADIO (Bluetooth Low Energy and 802.15.4)
|
|
* :abbr:`RTC (nRF RTC System Clock)`
|
|
* Segger RTT (RTT Console)
|
|
* :abbr:`SPI (Serial Peripheral Interface)`
|
|
* :abbr:`UARTE (Universal asynchronous receiver-transmitter)`
|
|
* :abbr:`WDT (Watchdog Timer)`
|
|
|
|
More information about the board can be found at the `MDBT53-DB-40 website`_.
|
|
The `MDBT53-DB-40 Specification`_ contains the demo board's datasheet.
|
|
The `MDBT53-DB-40 Schematic`_ contains the demo board's schematic.
|
|
|
|
Hardware
|
|
********
|
|
- Module Demo Board build by MDBT53-1M
|
|
- Nordic nRF5340 SoC Solution
|
|
- A recommnded 3rd-party module by Nordic Semiconductor.
|
|
- Dual-core Arm® Cortex® M33
|
|
- 1MB/256KB Flash Memory; 512kB/ 64kB RAM
|
|
- Supports BT5 Long Range Features
|
|
- Bluetooth specification v5.2
|
|
- Supports Bluetooth Direction Finding & Mesh
|
|
- Supports Bluetooth low energy audio
|
|
- Certifications: FCC, IC, CE, Telec (MIC), KC, SRRC, NCC, RCM, WPC
|
|
- RoHs & Reach Compiant.
|
|
- 48 GPIO
|
|
- Chip Antenna
|
|
- Interfaces: SPI, UART, I2C, I2S, PWM, ADC, NFC, and USB
|
|
- Highly flexible multiprotocol SoC ideally suited for Bluetooth® Low Energy, ANT+, Zigbee, Thread (802.15.4) ultra low-power wireless applications.
|
|
- 4 User LEDs
|
|
- 4 User buttons
|
|
- 1 Mini USB connector for power supply
|
|
- SWD connector for FW programing
|
|
- J-Link interface for FW programing
|
|
- UART interface for UART communication
|
|
|
|
Supported Features
|
|
==================
|
|
|
|
The ``raytac_mdbt53_db_40_nrf5340/cpuapp`` 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 |
|
|
+-----------+------------+----------------------+
|
|
| QSPI(M) | on-chip | nor |
|
|
+-----------+------------+----------------------+
|
|
| PWM | on-chip | pwm |
|
|
+-----------+------------+----------------------+
|
|
| RTC | on-chip | system clock |
|
|
+-----------+------------+----------------------+
|
|
| SPI(M/S) | on-chip | spi |
|
|
+-----------+------------+----------------------+
|
|
| SPU | on-chip | system protection |
|
|
+-----------+------------+----------------------+
|
|
| UARTE | on-chip | serial |
|
|
+-----------+------------+----------------------+
|
|
| WDT | on-chip | watchdog |
|
|
+-----------+------------+----------------------+
|
|
|
|
The ``raytac_mdbt53_db_40_nrf5340/cpunet`` board configuration supports the following
|
|
hardware features:
|
|
|
|
+-----------+------------+----------------------+
|
|
| Interface | Controller | Driver/Component |
|
|
+===========+============+======================+
|
|
| 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 |
|
|
+-----------+------------+----------------------+
|
|
| RADIO | on-chip | Bluetooth, |
|
|
| | | ieee802154 |
|
|
+-----------+------------+----------------------+
|
|
| RTC | on-chip | system clock |
|
|
+-----------+------------+----------------------+
|
|
| SPI(M/S) | on-chip | spi |
|
|
+-----------+------------+----------------------+
|
|
| UARTE | on-chip | serial |
|
|
+-----------+------------+----------------------+
|
|
| WDT | on-chip | watchdog |
|
|
+-----------+------------+----------------------+
|
|
|
|
Other hardware features have not been enabled yet for this board.
|
|
See `MDBT53-DB-40 website`_ and `MDBT53-DB-40 Specification`_
|
|
for a complete list of Raytac MDBT53-DB-40 board hardware features.
|
|
|
|
Connections and IOs
|
|
===================
|
|
|
|
LED
|
|
---
|
|
|
|
* LED1 (green) = P0.28
|
|
* LED2 (red) = P0.30
|
|
* LED3 = P0.31
|
|
* LED4 = P0.29
|
|
|
|
Push buttons
|
|
------------
|
|
|
|
* BUTTON1 = SW1 = P0.24
|
|
* BUTTON2 = SW2 = P0.08
|
|
* BUTTON3 = SW3 = P0.23
|
|
* BUTTON4 = SW4 = P0.09
|
|
|
|
UART
|
|
----
|
|
* RX = P0.22
|
|
* TX = P0.20
|
|
* RTS = P0.19
|
|
* CTS = P0.21
|
|
|
|
|
|
Security components
|
|
===================
|
|
|
|
- Implementation Defined Attribution Unit (`IDAU`_) on the application core.
|
|
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.
|
|
|
|
Programming and Debugging
|
|
*************************
|
|
|
|
nRF5340 application core supports the Armv8-M Security Extension.
|
|
Applications built for the ``raytac_mdbt53_db_40/nrf5340/cpuapp`` board by
|
|
default boot in the Secure state.
|
|
|
|
nRF5340 network core does not support the Armv8-M Security Extension.
|
|
nRF5340 IDAU may configure bus accesses by the nRF5340 network core
|
|
to have Secure attribute set; the latter allows to build and run
|
|
Secure only applications on the nRF5340 SoC.
|
|
|
|
Applications for the ``raytac_mdbt53_db_40_nrf5340`` board configuration can be
|
|
built, flashed, and debugged in the usual way. See :ref:`build_an_application` and
|
|
:ref:`application_run` for more details on building and running.
|
|
|
|
.. note::
|
|
Flashing and Debugging Zephyr onto the raytac_mdbt53_db_40_nrf5340 board
|
|
requires an external J-Link programmer. The programmer is attached to the J1
|
|
or J9 SWD connector.
|
|
|
|
|
|
Flashing
|
|
========
|
|
|
|
Follow the instructions in the :ref:`nordic_segger` page to install
|
|
and configure all the necessary software. Further information can be
|
|
found in :ref:`nordic_segger_flashing`. Then build and flash
|
|
applications as usual (see :ref:`build_an_application` and
|
|
:ref:`application_run` for more details).
|
|
|
|
.. warning::
|
|
|
|
The nRF5340 has a flash read-back protection feature. When flash read-back
|
|
protection is active, you will need to recover the chip before reflashing.
|
|
If you are flashing with :ref:`west <west-build-flash-debug>`, run
|
|
this command for more details on the related ``--recover`` option:
|
|
|
|
Here is an example for the :zephyr:code-sample:`hello_world` application.
|
|
|
|
Use a USB to TTL converter to connect the computer and raytac_mdbt53_db_40_nrf5340
|
|
J10 connector. Then run your favorite terminal program to listen for output.
|
|
|
|
.. code-block:: console
|
|
|
|
$ minicom -D <tty_device> -b 115200
|
|
|
|
Replace :code:`<tty_device>` with the port where the USB to TTL converter
|
|
can be found. For example, under Linux, :code:`/dev/ttyUSB0`.
|
|
|
|
Then build and flash the application in the usual way.
|
|
|
|
.. zephyr-app-commands::
|
|
:zephyr-app: samples/hello_world
|
|
:board: raytac_mdbt53_db_40_nrf5340
|
|
:goals: build flash
|
|
|
|
Debugging
|
|
=========
|
|
|
|
The ``raytac_mdbt53_db_40_nrf5340`` board does not have an on-board-J-Link debug IC,
|
|
however, instructions from the :ref:`nordic_segger` page also apply to this board.
|
|
Use the Debug out connector of nRF52x DK to connect to the J1 connector, and use SEGGER
|
|
J-Link OB IF to debug.
|
|
|
|
Refer to the :ref:`nordic_segger` page to learn about debugging Nordic
|
|
boards with a Segger IC.
|
|
|
|
|
|
References
|
|
**********
|
|
|
|
.. target-notes::
|
|
|
|
.. _IDAU:
|
|
https://developer.arm.com/docs/100690/latest/attribution-units-sau-and-idau
|
|
.. _MDBT53-DB-40 website:
|
|
https://www.raytac.com/product/ins.php?index_id=139
|
|
.. _MDBT53-DB-40 Specification:
|
|
https://www.raytac.com/download/index.php?index_id=60
|
|
.. _MDBT53-DB-40 Schematic:
|
|
https://www.raytac.com/upload/catalog_b/8b5e364600a9cc8c53a869733e97f07e.jpg
|
|
.. _J-Link Software and documentation pack:
|
|
https://www.segger.com/jlink-software.html
|