187 lines
6.6 KiB
ReStructuredText
187 lines
6.6 KiB
ReStructuredText
.. _arduino_giga_r1_board:
|
|
|
|
Arduino GIGA R1 WiFi
|
|
####################
|
|
|
|
Overview
|
|
********
|
|
|
|
Arduino GIGA R1 WiFi is a development board by Arduino based on the
|
|
STM32H747XI, a dual core ARM Cortex-M7 + Cortex-M4 MCU, with 2MBytes of Flash
|
|
memory and 1MB SRAM.
|
|
|
|
The board features:
|
|
|
|
- RGB LED
|
|
- Reset and Boot buttons
|
|
- USB-C device
|
|
- USB Host
|
|
- 16MB external QSPI flash
|
|
- 8MB external SDRAM
|
|
- Murata Type 1DX Bluetooth + WiFi module (CYW4343W based)
|
|
- Audio jack
|
|
- ATECC608A secure element
|
|
|
|
.. image:: img/arduino_giga_r1.jpg
|
|
:align: center
|
|
:alt: Arduino GIGA R1 WiFi
|
|
|
|
More information about the board, including the datasheet, pinout and
|
|
schematics, can be found at the `Arduino GIGA website`_.
|
|
|
|
More information about STM32H747XIH6 can be found here:
|
|
|
|
- `STM32H747XI on www.st.com`_
|
|
- `STM32H747xx reference manual`_
|
|
- `STM32H747xx datasheet`_
|
|
|
|
Supported Features
|
|
==================
|
|
|
|
The current Zephyr ``arduino_giga_r1_m7`` board configuration supports the
|
|
following hardware features:
|
|
|
|
+-----------+------------+-------------------------------------+
|
|
| Interface | Controller | Driver/Component |
|
|
+===========+============+=====================================+
|
|
| NVIC | on-chip | nested vector interrupt controller |
|
|
+-----------+------------+-------------------------------------+
|
|
| UART | on-chip | serial port-polling; |
|
|
| | | serial port-interrupt |
|
|
+-----------+------------+-------------------------------------+
|
|
| PINMUX | on-chip | pinmux |
|
|
+-----------+------------+-------------------------------------+
|
|
| GPIO | on-chip | gpio |
|
|
+-----------+------------+-------------------------------------+
|
|
| FLASH | on-chip | flash memory |
|
|
+-----------+------------+-------------------------------------+
|
|
| RNG | on-chip | True Random number generator |
|
|
+-----------+------------+-------------------------------------+
|
|
| I2C | on-chip | i2c |
|
|
+-----------+------------+-------------------------------------+
|
|
| SPI | on-chip | spi |
|
|
+-----------+------------+-------------------------------------+
|
|
| IPM | on-chip | virtual mailbox based on HSEM |
|
|
+-----------+------------+-------------------------------------+
|
|
| FMC | on-chip | memc (SDRAM) |
|
|
+-----------+------------+-------------------------------------+
|
|
| QSPI | on-chip | QSPI flash |
|
|
+-----------+------------+-------------------------------------+
|
|
| RADIO | Murata 1DX | WiFi and Bluetooth module |
|
|
+-----------+------------+-------------------------------------+
|
|
|
|
Other hardware features are not yet supported on Zephyr port.
|
|
|
|
Fetch Binary Blobs
|
|
******************
|
|
|
|
The board Bluetooth/WiFi module requires fetching some binary blob files, to do
|
|
that run the command:
|
|
|
|
.. code-block:: console
|
|
|
|
west blobs fetch hal_infineon
|
|
|
|
.. note:: Only Bluetooth functionality is currently supported.
|
|
|
|
Resources sharing
|
|
=================
|
|
|
|
The dual core nature of STM32H747 SoC requires sharing HW resources between the
|
|
two cores. This is done in 3 ways:
|
|
|
|
- **Compilation**: Clock configuration is only accessible to M7 core. M4 core only
|
|
has access to bus clock activation and deactivation.
|
|
- **Static pre-compilation assignment**: Peripherals such as a UART are assigned in
|
|
devicetree before compilation. The user must ensure peripherals are not assigned
|
|
to both cores at the same time.
|
|
- **Run time protection**: Interrupt-controller and GPIO configurations could be
|
|
accessed by both cores at run time. Accesses are protected by a hardware semaphore
|
|
to avoid potential concurrent access issues.
|
|
|
|
Programming and Debugging
|
|
*************************
|
|
|
|
Applications for the ``arduino_giga_r1`` board should be built per core target,
|
|
using either ``arduino_giga_r1/stm32h747xx/m7`` or ``arduino_giga_r1/stm32h747xx/m4`` as the target.
|
|
|
|
See :ref:`build_an_application` for more information about application builds.
|
|
|
|
Flashing
|
|
========
|
|
|
|
This board can be flashed either using dfu-util, or with an external debugging
|
|
probe, such as a J-Link or Black Magic Probe, connected to the on board MIPI-10
|
|
SWD port marked as "JTAG".
|
|
|
|
.. note::
|
|
|
|
The board ships with a custom Arduino bootloader programmed in the first
|
|
flash page that can be triggered by double clicking the ``RST`` button. This
|
|
bootloader is USB-DFU compatible and supports programming both the internal
|
|
and external flash and is the one used by ``west flash`` by default. The
|
|
internal STM32 ROM bootloader can also be used by pressing ``RST`` while
|
|
holding the ``BOOT0`` button, this also supports USB-DFU but can only
|
|
program the internal flash and can overwrite the Arduino bootloader. More
|
|
details can be found in the "Boot0" section of the `Arduino GIGA Cheat
|
|
Sheet`_.
|
|
|
|
First, connect the Arduino GIGA R1 board to your host computer using the USB
|
|
port to prepare it for flashing. Double click the ``RST`` button to put the
|
|
board into the Arduino Bootloader mode. Then build and flash your application.
|
|
|
|
Here is an example for the :zephyr:code-sample:`hello_world` application.
|
|
|
|
.. zephyr-app-commands::
|
|
:zephyr-app: samples/hello_world
|
|
:board: arduino_giga_r1/stm32h747xx/m7
|
|
:goals: build flash
|
|
|
|
Run a serial host program to connect with your board:
|
|
|
|
.. code-block:: console
|
|
|
|
$ minicom -D /dev/ttyACM0
|
|
|
|
You should see the following message on the console:
|
|
|
|
.. code-block:: console
|
|
|
|
Hello World! arduino_giga_r1
|
|
|
|
Similarly, you can build and flash samples on the M4 target.
|
|
|
|
Here is an example for the :zephyr:code-sample:`blinky` application on M4 core.
|
|
|
|
.. zephyr-app-commands::
|
|
:zephyr-app: samples/basic/blinky
|
|
:board: arduino_giga_r1/stm32h747xx/m4
|
|
:goals: build flash
|
|
|
|
Debugging
|
|
=========
|
|
|
|
Debugging is supported by using ``west debug`` with an external probe such as a
|
|
J-Link or Black Magic Probe, connected to the on board MIPI-10 SWD port marked
|
|
as "JTAG". For example::
|
|
|
|
west debug -r jlink
|
|
|
|
.. _Arduino GIGA website:
|
|
https://docs.arduino.cc/hardware/giga-r1-wifi
|
|
|
|
.. _Arduino GIGA Cheat Sheet:
|
|
https://docs.arduino.cc/tutorials/giga-r1-wifi/cheat-sheet
|
|
|
|
.. _STM32H747XI on www.st.com:
|
|
https://www.st.com/content/st_com/en/products/microcontrollers-microprocessors/stm32-32-bit-arm-cortex-mcus/stm32-high-performance-mcus/stm32h7-series/stm32h747-757/stm32h747xi.html
|
|
|
|
.. _STM32H747xx reference manual:
|
|
https://www.st.com/resource/en/reference_manual/dm00176879.pdf
|
|
|
|
.. _STM32H747xx datasheet:
|
|
https://www.st.com/resource/en/datasheet/stm32h747xi.pdf
|
|
|
|
.. _dfu-util:
|
|
http://dfu-util.sourceforge.net/build.html
|