ContextQMD
Back to Zephyr

Overview

boards/raytac/mdbt53_db_40/doc/index.rst

4.4.06.7 KB
Original Source

.. 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 recommended 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 Compliant.
  • 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 programming
  • J-Link interface for FW programming
  • UART interface for UART communication

Supported Features

.. zephyr:board-supported-hw::

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

.. zephyr:board-supported-runners::

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