1.. zephyr:board:: raytac_mdbt50q_db_33 2 3Overview 4******** 5 6The Raytac MDBT50Q-DB-33 hardware provides support for the 7Nordic Semiconductor nRF52833 ARM Cortex-M4F CPU and the following devices: 8 9* :abbr:`ADC (Analog to Digital Converter)` 10* CLOCK 11* FLASH 12* :abbr:`GPIO (General Purpose Input Output)` 13* :abbr:`I2C (Inter-Integrated Circuit)` 14* :abbr:`MPU (Memory Protection Unit)` 15* :abbr:`NVIC (Nested Vectored Interrupt Controller)` 16* :abbr:`PWM (Pulse Width Modulation)` 17* RADIO (Bluetooth Low Energy and 802.15.4) 18* :abbr:`RTC (nRF RTC System Clock)` 19* Segger RTT (RTT Console) 20* :abbr:`SPI (Serial Peripheral Interface)` 21* :abbr:`UART (Universal asynchronous receiver-transmitter)` 22* :abbr:`USB (Universal Serial Bus)` 23* :abbr:`WDT (Watchdog Timer)` 24 25More information about the board can be found at the `MDBT50Q-DB-33 website`_. 26The `MDBT50Q-DB-33 Specification`_ contains the demo board's datasheet. 27The `MDBT50Q-DB-33 Schematic`_ contains the demo board's schematic. 28 29Hardware 30******** 31- Module Demo Board build by MDBT50Q-512K 32- Nordic nRF52833 SoC Solution 33- A recommended 3rd-party module by Nordic Semiconductor. 34- BT5.2&BT5.1&BT5 Bluetooth Specification Cerified 35- Supports BT5 Long Range Features 36- Cerifications: FCC, IC, CE, Telec(MIC), KC, SRRC, NCC, RCM, WPC 37- 32-bit ARM® Cortex™ M4F CPU 38- 512kB Flash Memory/128kB RAM 39- RoHs & Reach Compiant. 40- 42 GPIO 41- Chip Antenna 42- Interfaces: SPI, UART, I2C, I2S, PWM, ADC, NFC, and USB 43- Highly flexible multiprotocol SoC ideally suited for Bluetooth® Low Energy, ANT+, Zigbee, Thread (802.15.4) ultra low-power wireless applications. 44- 3 User LEDs 45- 4 User buttons 46- 1 Mini USB connector for power supply and USB communication 47- SWD connector for FW programming 48- J-Link interface for FW programming 49- UART interface for UART communication 50 51Supported Features 52================== 53 54.. zephyr:board-supported-hw:: 55 56See `MDBT50Q-DB-33 website`_ and `MDBT50Q-DB-33 Specification`_ 57for a complete list of Raytac MDBT50Q-DB-33 board hardware features. 58 59Connections and IOs 60=================== 61 62LED 63--- 64 65* LED1 (green) = P0.13 66* LED2 (red) = P0.14 67* LED3 (blue) = P0.15 68 69Push buttons 70------------ 71 72* BUTTON1 = SW1 = P0.11 73* BUTTON2 = SW2 = P0.12 74* BUTTON3 = SW3 = P0.24 75* BUTTON4 = SW4 = P0.25 76 77UART 78---- 79* RXD = P0.08 80* TXD = P0.06 81* RTS = P0.05 82* CTS = P0.07 83 84Programming and Debugging 85************************* 86 87Applications for the ``raytac_mdbt50q_db_33/nrf52833`` board configuration can be 88built, flashed, and debugged in the usual way. See :ref:`build_an_application` and 89:ref:`application_run` for more details on building and running. 90 91.. note:: 92 Flashing and Debugging Zephyr onto the raytac_mdbt50q_db_33/nrf52833 board 93 requires an external J-Link programmer. The programmer is attached to the J1 94 or J9 SWD connector. 95 96Flashing 97======== 98 99Follow the instructions in the :ref:`nordic_segger` page to install 100and configure all the necessary software. Further information can be 101found in :ref:`nordic_segger_flashing`. Then build and flash 102applications as usual (see :ref:`build_an_application` and 103:ref:`application_run` for more details). 104 105Here is an example for the :zephyr:code-sample:`hello_world` application. 106 107Use a USB to TTL converter to connect the computer and raytac_mdbt50q_db_33/nrf52833 108J10 connector. Then run your favorite terminal program to listen for output. 109 110.. code-block:: console 111 112 $ minicom -D <tty_device> -b 115200 113 114Replace :code:`<tty_device>` with the port where the USB to TTL converter 115can be found. For example, under Linux, :code:`/dev/ttyUSB0`. 116 117Then build and flash the application in the usual way. 118 119.. zephyr-app-commands:: 120 :zephyr-app: samples/hello_world 121 :board: raytac_mdbt50q_db_33/nrf52833 122 :goals: build flash 123 124Debugging 125========= 126 127The ``raytac_mdbt50q_db_33/nrf52833`` board does not have an on-board-J-Link debug IC, 128however, instructions from the :ref:`nordic_segger` page also apply to this board. 129Use the Debug out connector of nRF52x DK to connect to the J1 connector, and use SEGGER 130J-Link OB IF to debug. 131 132Testing the LEDs and buttons in the Raytac MDBT50Q-DB-33 133******************************************************** 134 135There are 2 samples that allow you to test that the buttons (switches) and LEDs on 136the board are working properly with Zephyr: 137 138.. code-block:: console 139 140 samples/basic/blinky 141 samples/basic/button 142 143You can build and flash the examples to make sure Zephyr is running correctly on 144your board. The button and LED definitions can be found in 145:zephyr_file:`boards/raytac/mdbt50q_db_33/raytac_mdbt50q_db_33_nrf52833.dts`. 146 147Selecting the pins 148================== 149 150Pins can be configured in the board pinctrl file. To see the available mappings, 151open the `MDBT50Q-DB-33 Specification`_, chapter 2.5 'Pin Assignment'. 152Select the pins marked 'General-purpose I/O'. Note that pins marked as 'low-frequency I/O 153only' can only be used in under-10KHz applications. They are not suitable for SPI, I2C, 154UART, and PWM. 155 156References 157********** 158 159.. target-notes:: 160 161.. _MDBT50Q-DB-33 website: 162 https://www.raytac.com/product/ins.php?index_id=97 163.. _MDBT50Q-DB-33 Specification: 164 https://www.raytac.com/download/index.php?index_id=46 165.. _MDBT50Q-DB-33 Schematic: 166 https://www.raytac.com/upload/catalog_b/407c1150fa33511a47e8a2f85d106ff3.jpg 167.. _J-Link Software and documentation pack: 168 https://www.segger.com/jlink-software.html 169
