boards/adi/max32655evkit/doc/index.rst
.. zephyr:board:: max32655evkit
Overview
The MAX32655 evaluation kit (EV kit) provides a platform for evaluation capabilities of the MAX32655 microcontroller, which is an advanced system-on-chip (SoC). It features an Arm® Cortex®-M4F CPU for efficient computation of complex functions and algorithms, integrated power management (SIMO), and the newest generation Bluetooth® 5.0 Low Energy (Bluetooth LE), long-range radio for wearable and hearable device applications.
The Zephyr port is running on the MAX32655 MCU.
.. image:: img/max32655evkit_img1.jpg :align: center :alt: MAX32655 EVKIT Front
.. image:: img/max32655evkit_img2.jpg :align: center :alt: MAX32655 Back
Hardware
MAX32655 MCU:
External devices connected to the MAX32655 EVKIT:
.. zephyr:board-supported-hw::
+-----------+---------------+-----------------------------------------------------------------------+ | Name | Signal | Usage | +===========+===============+=======================================================================+ | JP1 | VREGI | Connect/Disconnect VREGIO power | +-----------+---------------+-----------------------------------------------------------------------+ | JP2 | P0_24 | Enable/Disable LED1 | +-----------+---------------+-----------------------------------------------------------------------+ | JP3 | P0_25 | Enable/Disable LED2 | +-----------+---------------+-----------------------------------------------------------------------+ | JP4 | P2_6/ P2_7 | Connect/Disconnect the USB to serial UART to GPIO P2_6 (LPUART_RX) | +-----------+---------------+-----------------------------------------------------------------------+ | JP5 | P2_7/ P0_1 | Connect/Disconnect the USB to serial UART to GPIO P2_7 (LPUART_TX) | +-----------+---------------+-----------------------------------------------------------------------+ | JP6 | P0_2 | Connect/Disconnect the USB to serial UART to GPIO P0_2 (UART0_CTS) | +-----------+---------------+-----------------------------------------------------------------------+ | JP7 | P0_3 | Connect/Disconnect he USB to serial UART to GPIO P0_3 (UART0_RTS) | +-----------+---------------+-----------------------------------------------------------------------+ | JP8 | VREGI | Select VDDIO_EN power source (3V3 or coin cell) | +-----------+---------------+-----------------------------------------------------------------------+ | JP9 | VDDIOH_EN | Select VDDIOH_EN power source 3V3/VREGI | +-----------+---------------+-----------------------------------------------------------------------+ | JP10 | VDDIOH | Connect/Disconnect VDDIOH power | +-----------+---------------+-----------------------------------------------------------------------+ | JP11 | VDDIO_EN | Select VDDIO_EN power source 1V8/VREGO_A | +-----------+---------------+-----------------------------------------------------------------------+ | JP12 | VDDIO | Connect/Disconnect VDDIO power | +-----------+---------------+-----------------------------------------------------------------------+ | JP13 | VDDA_EN | Select VDDA_EN power source 1V8/VREGO_A | +-----------+---------------+-----------------------------------------------------------------------+ | JP14 | VDDA | Connect/Disconnect VDDA power | +-----------+---------------+-----------------------------------------------------------------------+ | JP15 | VCOREA_EN | Select VCOREA_EN power source 1V1/VREGO_C | +-----------+---------------+-----------------------------------------------------------------------+ | JP16 | VCOREA | Connect/Disconnect VCOREA power | +-----------+---------------+-----------------------------------------------------------------------+ | JP17 | VCOREB_EN | Select VCOREB_EN power source 1V1/VREGO_B | +-----------+---------------+-----------------------------------------------------------------------+ | JP18 | VCOREB | Connect/Disconnect VCOREB power | +-----------+---------------+-----------------------------------------------------------------------+ | JP19 | BLE_LDO | Connect/Disconnect BLE_LDO power | +-----------+---------------+-----------------------------------------------------------------------+ | JP20 | VREF | Select VREF power source VDDIO/VDDIOH | +-----------+---------------+-----------------------------------------------------------------------+ | JP21 | I2C0_PU | Select I2C0_PU power source VDDIO/VDDIOH | +-----------+---------------+-----------------------------------------------------------------------+ | JP22 | I2C1_PU | Select I2C1_PU power source VDDIO/VDDIOH | +-----------+---------------+-----------------------------------------------------------------------+ | JP23 | BOARD RESET | Connect/Disconnect RV JTAG NRESET from the BOARD RESET circuitry | +-----------+---------------+-----------------------------------------------------------------------+
Programming and Debugging
.. zephyr:board-supported-runners::
The MAX32655 MCU can be flashed by connecting an external debug probe to the SWD port. SWD debug can be accessed through the Cortex 10-pin connector, JH3. Logic levels are fixed to VDDIO (1.8V).
Once the debug probe is connected to your host computer, then you can simply run the
west flash command to write a firmware image into flash. To perform a full erase,
pass the --erase option when executing west flash.
.. note::
This board uses OpenOCD as the default debug interface. You can also use
a Segger J-Link with Segger's native tooling by overriding the runner,
appending --runner jlink to your west command(s). The J-Link should
be connected to the standard 2*5 pin debug connector (JW3) using an
appropriate adapter board and cable.
Please refer to the Flashing_ section and run the west debug command
instead of west flash.
Dual Core Support
An experimental board ID for the secondary RISC-V core is available with ID
max32655evkit/max32655/m4.
The primary Arm core uses Kconfig options,
:kconfig:option:CONFIG_MAX32_SECONDARY_RV32 to enable the secondary
RISC-V core. The devicetree chosen property zephyr,code-rv32-partition,
is used to determine the address for the RV32 core to start executing.
:zephyr:code-sample:sysbuild_hello_world supports building the Arm and RISC-V
images:
.. zephyr-app-commands:: :zephyr-app: samples/sysbuild/hello_world :board: max32655evkit/max32655/m4 :west-args: -T sample.sysbuild.hello_world :goals: build :compact:
Currently, flashing both images requires using the JLink runner with a connected JLink device:
.. zephyr-app-commands:: :zephyr-app: samples/sysbuild/hello_world :board: max32655evkit/max32655/m4 :flash-args: -r jlink :goals: flash :compact:
To view the console for the RV32 core using the USB connection on the kit, move jumpers JP4 and JP5 to their "LP" positions.
References
MAX32655EVKIT web page_
zero-riscy user manual_
.. _MAX32655EVKIT web page: https://www.analog.com/en/design-center/evaluation-hardware-and-software/evaluation-boards-kits/max32655evkit.html#eb-overview
.. _zero-riscy user manual: https://pulp-platform.org/docs/user_manual.pdf