boards: arm: bt510: add support for pyocd

Jamie McCrae · Jamie McCrae · commit 27bbb24cda4f · 2021-03-08T08:20:29.000Z
The programming hardware for this board is not JLINK based

Signed-off-by: Jamie McCrae &lt;jamie.mccrae@lairdconnect.com&gt;
diff --git a/boards/arm/bt510/board.cmake b/boards/arm/bt510/board.cmake
@@ -1,6 +1,8 @@
 # SPDX-License-Identifier: Apache-2.0
 
+board_runner_args(pyocd "--target=nrf52840" "--frequency=4000000")
 board_runner_args(nrfjprog "--softreset")
 board_runner_args(jlink "--device=nrf52" "--speed=4000")
+include(${ZEPHYR_BASE}/boards/common/pyocd.board.cmake)
 include(${ZEPHYR_BASE}/boards/common/nrfjprog.board.cmake)
 include(${ZEPHYR_BASE}/boards/common/jlink.board.cmake)
diff --git a/boards/arm/bt510/doc/bt510.rst b/boards/arm/bt510/doc/bt510.rst
@@ -164,32 +164,48 @@ A non-standard layout is used to include access to the sensor debug UART.
 Connectivity to the programmer/debugger must be modified to match
 the pinout shown above.
 
-Laird Connectivity provide the USB-SWD programming board that supports
+Laird Connectivity provide the USB-SWD programming board (750-03239) that supports
 this connector layout, refer to the `USB SWD Programmer product page`_
 .
 
 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).
+To connect the BT510 board for programming or debugging using the USB-SWD programming
+board, on the programming board set SW6 to the supply out position and SW5 to the 3V3
+position, ensure there is a jumper on J35 and that SW1 is in the debug position, then
+connect the BT510 to the board using the Tag-Connect cable via J3:
+
+.. figure:: img/bt510_prog.png
+     :width: 630px
+     :align: center
+     :alt: Sentrius BT510 Sensor connected to programming board
+
+     Sentrius BT510 Sensor connected to programming board
+
+Then build and flash applications as usual (see :ref:`build_an_application` and
+:ref:`application_run` for more details). For example, to flash:
+
+.. code-block:: console
+
+   $ ninja flash
 
 Here is an example for the :ref:`hello_world` application.
 
 First, run your favorite terminal program to listen for output.
 
 NOTE: On the BT510, the UART lines are at TTL levels and must be passed through
 an appropriate line driver circuit for translation to RS232 levels. Refer to the `MAX3232 datasheet`_
-for a suitable driver IC.
+for a suitable driver IC. The USB-SWD programming board has an in-built UART connected
+to the BT510 acting as a USB CDC port, on Linux and Windows 10 this driver should be
+installed automatically, for Windows 7, the MBED driver is required to use the serial
+port - see the `MBED Serial Driver`_ link for details and how to install the driver.
 
 .. code-block:: console
 
    $ minicom -D <tty_device> -b 115200
 
-Replace :code:`<tty_device>` with the port where the bt510 can be found. For example, under Linux, :code:`/dev/ttyUSB0`.
+Replace :code:`<tty_device>` with the port where the bt510 can be found. For example, under Linux, :code:`/dev/ttyACM0`.
 
 Then build and flash the application in the usual way.
 
@@ -206,7 +222,9 @@ Debugging
 The ``bt510`` board does not have an on-board J-Link debug IC
 as some nRF5x development boards, however, instructions from the
 :ref:`nordic_segger` page also apply to this board, with the additional step
-of connecting an external debugger.
+of connecting an external debugger. The USB-SWD programmer board has a CMSIS debugger
+compatible interface and debugging can be performed using pyocd, openocd or any other
+applications that support the CMSIS interface.
 
 Testing Bluetooth on the BT510
 ***********************************
@@ -244,3 +262,4 @@ References
 .. _Silabs 7055 datasheet: https://www.silabs.com/documents/public/data-sheets/Si7050-1-3-4-5-A20.pdf
 .. _ST Microelectronics LIS2DH datasheet: https://www.st.com/resource/en/datasheet/lis2dh.pdf
 .. _Honeywell SM351LT datasheet: https://sensing.honeywell.com/honeywell-sensing-nanopower-series-datasheet-50095501-c-en.pdf
+.. _MBED Serial Driver: https://os.mbed.com/docs/mbed-os/v6.8/program-setup/windows-serial-driver.html
diff --git a/boards/arm/bt510/doc/img/bt510_prog.png b/boards/arm/bt510/doc/img/bt510_prog.png
