For more details on Nitrogen 96 board, refer https://www.96boards.org/documentation/iot/nitrogen/.
Flashing Zephyr onto 96Boards Nitrogen
**************************************
Installing pyOCD
****************
The 96Boards Nitrogen board can be flashed via the `CMSIS DAP interface <https://os.mbed.com/handbook/CMSIS-DAP>`_, which is provided by the micro USB interface to the LPC11U35 chip.
pyOCD is an open source Python package for programming and debugging Arm Cortex-M microcontrollers using multiple supported types of USB debug probes. It is fully cross-platform, with support for Linux, macOS, and Windows.
Using the CMSIS-DAP interface, the board can be flashed via the USB storage interface (drag-and-drop) and also via `pyOCD <https://github.com/pyocd/pyOCD>`_.
The latest stable version of pyOCD can be installed via `pip <https://pip.pypa.io/en/stable/>`_ as follows:
Installing pyOCD
================
.. code-block:: console
pip install --pre -U pyocd
The latest stable version of pyOCD can be installed via pip as follows:
TTo install the latest prerelease version from the HEAD of the master branch, you can do the following:
You can then verify that your board is detected by pyOCD by running:
...
...
@@ -94,71 +39,110 @@ You can then verify that your board is detected by pyOCD by running:
pyocd-flashtool -l
Common Errors
*************
No connected boards
===================
Common errors in pyOCD
======================
If you don’t use sudo when invoking pyocd-flashtool, you might get any of the following errors:
* If you do not use sudo when invoking pyocd-flashtool, you might get any of the following errors:
.. code-block:: console
No available boards are connected
No connected boards
Error: There is no board connected.
Error: There is no board connected
* Lack of permission gets reported as ValueError (The device has no langid), perform the instructions as suggested in
https://github.com/pyocd/pyOCD/tree/master/udev.
To fix the permission issue, simply add the following udev rule for the NXP LPC1768 interface:
Flashing an Application to 96Boards Nitrogen
********************************************
.. code-block:: console
The 96Boards Nitrogen board can be flashed via the CMSIS DAP interface. CMSIS-DAP provides a standardized way to access the Coresight Debug Access Port (DAP) of an ARM Cortex microcontroller via USB.
Using the CMSIS-DAP interface, the board can be flashed via the USB storage interface (drag-and-drop) and also via pyOCD.
Finally, unplug and plug the board again.
For flashing an application to board **pyocd** must be installed in your system. You can flash Zephyr samples to 96b-nitrogen boards.
ValueError: The device has no langid
====================================
To flash the example you built with command e.g.
As described by `pyOCD issue 259 <https://github.com/pyocd/pyOCD/issues/259>`_, you might get the **ValueError: The device has no langid** error when not running pyOCD as root (e.g. sudo).
.. code-block:: console
96b-nitrogen bitbake zephyr-philosophers
Call similar command with explicit flash usb command:
.. code-block:: console
To fix the above error, add the udev rule shown in the previous section and install a more recent version of pyOCD.
Here is an example for the `Hello World application <https://docs.zephyrproject.org/latest/samples/hello_world/README.html#hello-world>`_.
This requires installing the `pyOCD Debug Host Tools <https://docs.zephyrproject.org/latest/guides/flash_debug/host-tools.html#pyocd-debug-host-tools>`_.
OpenHarmony can be hosted on top of variety of kernels. Currently supported kernels (a.k.a. OHOS flavours) are Linux, Zephyr and FreeRTOS (experimental).
Run your favorite terminal program to listen for output.
MACHINE variable can be set up in conf/local.conf file under build directory or via command line, e.g.:
.. code-block:: console
minicom -D <tty_device> -b 115200
$ MACHINE=<target_machine> bitbake <image-name>
OHOS Zephyr flavour is based on zephyr distribution and supports following images/machines:
Replace **<tty_device>** with the port where the board 96Boards Nitrogen can be found. For example, under Linux, **/dev/ttyACM0**. The **-b** option sets baud rate ignoring the value from config.
* Supported images:
* zephyr-philosophers
Press the Reset button and you should see the the following message in your terminal:
