boards/raytac/mdbt50q_db_40/doc/index.rst
.. zephyr:board:: raytac_mdbt50q_db_40
Overview
The Raytac MDBT50Q-DB-40 hardware provides support for the Nordic Semiconductor nRF52840 ARM Cortex-M4F CPU and the following devices:
ADC (Analog to Digital Converter)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)SPI (Serial Peripheral Interface)UART (Universal asynchronous receiver-transmitter)USB (Universal Serial Bus)WDT (Watchdog Timer)More information about the board can be found at the MDBT50Q-DB-40 website.
The MDBT50Q-DB-40 Specification contains the demo board's datasheet.
The MDBT50Q-DB-40 Schematic_ contains the demo board's schematic.
Hardware
.. zephyr:board-supported-hw::
See MDBT50Q-DB-40 website_ and MDBT50Q-DB-40 Specification_
for a complete list of Raytac MDBT50Q-DB-40 board hardware features.
Programming and Debugging
.. zephyr:board-supported-runners::
Applications for the raytac_mdbt50q_db_40/nrf52840 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_mdbt50q_db_40/nrf52840 board requires an external J-Link programmer. The programmer is attached to the J1 or J9 SWD connector.
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).
Here is an example for the :zephyr:code-sample:hello_world application.
Use a USB to TTL converter to connect the computer and raytac_mdbt50q_db_40/nrf52840 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_mdbt50q_db_40/nrf52840 :goals: build flash
The raytac_mdbt50q_db_40/nrf52840 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.
Testing the LEDs and buttons in the MDBT50Q-DB-40
There are 2 samples that allow you to test that the buttons (switches) and LEDs on the board are working properly with Zephyr:
.. code-block:: console
samples/basic/blinky samples/basic/button
You can build and flash the examples to make sure Zephyr is running correctly on
your board. The button and LED definitions can be found in
:zephyr_file:boards/raytac/mdbt50q_db_40/raytac_mdbt50q_db_40_nrf52840.dts.
Pins can be configured in the board pinctrl file. To see the available mappings,
open the MDBT50Q-DB-40 Specification_, chapter 2.5 'Pin Assignment'.
Select the pins marked 'General-purpose I/O'. Note that pins marked as 'low-frequency I/O
only' can only be used in under-10KHz applications. They are not suitable for SPI, I2C,
UART, and PWM.
References
.. target-notes::
.. _MDBT50Q-DB-40 website: https://www.raytac.com/product/ins.php?index_id=81 .. _MDBT50Q-DB-40 Specification: https://www.raytac.com/download/index.php?index_id=43 .. _MDBT50Q-DB-40 Schematic: https://www.raytac.com/upload/catalog_b/134ade06b5db3dd5803d27c5b17f22f3.jpg .. _J-Link Software and documentation pack: https://www.segger.com/jlink-software.html