diff --git a/documentation/source/quick-start/Avenger-96-Board.rst b/documentation/source/quick-start/Avenger-96-Board.rst index 40f80843ffb1ce2b9cec6dad02b4552a26db0718..7e360ba1edaa6049e0bc29c0f8251121a37c06b8 100644 --- a/documentation/source/quick-start/Avenger-96-Board.rst +++ b/documentation/source/quick-start/Avenger-96-Board.rst @@ -1,113 +1,25 @@ -Nitrogen 96 ARM Board -##################### +Supported ARM Boards +#################### -Nitrogen is a 96Boards compliant IoT Edition board which aims to provide economic and compact BLE solutions for a variety of IoT projects. This board features the nRF52832 microcontroller by Nordic, 64kb of RAM and 512kb of onboard flash storage. An easily accessible 40 pin low-speed expansion connector and onboard antenna offer a wide variety of IO on the much desired 96Boards IoT form factor. +Nitrogen 96 Board +***************** -Build for nitrogen -****************** -You can build Zephyr samples. There are several sample recipes. -For example, to build the Zephyr "philosophers" sample: - - $ MACHINE=qemu-x86 bitbake zephyr-philosophers - -You can then run the created "philosophers" image in qemu: +Nitrogen is a 96Boards compliant IoT Edition board which aims to provide economic and compact BLE solutions for a variety of IoT projects. This board features the nRF52832 microcontroller by Nordic, 64kb of RAM and 512kb of onboard flash storage. An easily accessible 40 pin low-speed expansion connector and onboard antenna offer a wide variety of IO on the much desired 96Boards IoT form factor. The 96Boards Nitrogen hardware provides support for the Nordic Semiconductor nRF52832 ARM Cortex-M4F CPU. - $ runqemu qemu-x86 - -The same sample, for ARM image: +.. figure:: images/nitrogen_board.jpg - $ MACHINE=qemu-cortex-m3 bitbake zephyr-philosophers - $ runqemu qemu-cortex-m3 - -The same sample, for Nios2 image: + Figure 1 Nitrogen 96 Board - $ MACHINE=qemu-nios2 bitbake zephyr-philosophers - $ runqemu qemu-nios2 +For complete details on building and flashing applications to the Nitrogen, refer https://www.96boards.org/documentation/iot/nitrogen/. -Flashing -******** -You can flash Zephyr samples to boards. Currently, the following MACHINEs -are supported: - * DFU: - - arduino-101-sss - - arduino-101 - - arduino-101-ble - * pyocd: - - 96b-nitrogen - -To flash the example you built with command e.g. - - $ MACHINE=96b-nitrogen bitbake zephyr-philosophers - - - -call similar command with explicit flash_usb command: - - $ MACHINE=96b-nitrogen bitbake zephyr-philosophers -c flash_usb - -dfu-util and/or pyocd need to be installed in your system. If you observe -permission errors or the flashing process seem to hang, follow those instructions: -https://github.com/pyocd/pyOCD/tree/master/udev - - -Flashing Zephyr onto 96Boards Nitrogen -************************************** -The 96Boards Nitrogen board can be flashed via the CMSIS DAP interface, which is provided by the micro USB interface to the LPC11U35 chip. - -Using the CMSIS-DAP interface, the board can be flashed via the USB storage interface (drag-and-drop) and also via pyOCD. - -Installing pyOCD +Avenger 96 Board **************** -The latest stable version of pyOCD can be installed via pip as follows: - - **pip install --pre -U pyocd** - -To install the latest development version (master branch), do the following: - - **pip install --pre -U git https://github.com/mbedmicro/pyOCD.git#egg=pyOCD** - -You can then verify that your board is detected by pyOCD by running: - - **pyocd-flashtool -l** - -Building and Running Zephyr Tests -********************************* -Presently only toolchains for ARM, x86, IAMCU and Nios2 are supported. -(For ARM we use CortexM3 toolchain) - -To run Zephyr Test using Yocto Image Tests, ensure following in local.conf: - - INHERIT += "testimage" - -You can build and test an individual existing Zephyr test. -This is done by appending the actual test name to the "zephyr-kernel-test", -for example: - - $ MACHINE=qemu-x86 bitbake zephyr-kernel-test-sleep - $ MACHINE=qemu-x86 bitbake zephyr-kernel-test-sleep -c testimage - -You can also build and run all Zephyr existing tests (as listed in the file -zephyr-kernel-test.inc). For example: - - $ MACHINE=qemu-x86 bitbake zephyr-kernel-test-all - $ MACHINE=qemu-x86 bitbake zephyr-kernel-test-all -c testimage -or - $ MACHINE=qemu-cortex-m3 bitbake zephyr-kernel-test-all - $ MACHINE=qemu-cortex-m3 bitbake zephyr-kernel-test-all -c testimage -or - $ MACHINE=qemu-nios2 bitbake zephyr-kernel-test-all - $ MACHINE=qemu-nios2 bitbake zephyr-kernel-test-all -c testimage - - -Reference -******** -`<https://docs.zephyrproject.org/latest/boards/arm/96b_nitrogen/doc/index.html>`_ - -`<https://wiki.seeedstudio.com/BLE_Nitrogen/>`_ -`<http://deletionpedia.org/en/96Boards>`_ +The STM32MP157 is a highly integrated multi-market system-on-chip designed to enable secure and space constraint applications within the Internet of Things. Avenger96 board features dual Arm Cortex-A7 cores and an Arm Cortex-M4 core. In addition, an extensive set of interfaces and connectivity peripherals are included to interface to cameras, touch-screen displays an MMC/SD cards. It also fully supports wireless communication, including WLAN and BLE. +.. figure:: images/avenger96.png + Figure 1 Avenger 96 Board - +For complete details on building and flashing applications to the Nitrogen, refer https://www.96boards.org/product/avenger96/.