This is an automated email from the ASF dual-hosted git repository. simbit18 pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/nuttx.git
commit 865753fd805251999db825aaf0e9a16296728947 Author: Matteo Golin <[email protected]> AuthorDate: Thu Oct 23 10:21:38 2025 -0400 docs/platforms/risc-v/hpm6750/boards/hpm6750evk2: Migrate README.txt Migrate README.txt to RST format adhering to standard board documentation template. Signed-off-by: Matteo Golin <[email protected]> --- .../risc-v/hpm6750/boards/hpm6750evk2/README.txt | 42 -------- .../hpm6750/boards/hpm6750evk2/hpm6750evk2.png | Bin 0 -> 948352 bytes .../risc-v/hpm6750/boards/hpm6750evk2/index.rst | 106 ++++++++++++++++++++- 3 files changed, 103 insertions(+), 45 deletions(-) diff --git a/Documentation/platforms/risc-v/hpm6750/boards/hpm6750evk2/README.txt b/Documentation/platforms/risc-v/hpm6750/boards/hpm6750evk2/README.txt deleted file mode 100644 index 7ef9d1b9e8d..00000000000 --- a/Documentation/platforms/risc-v/hpm6750/boards/hpm6750evk2/README.txt +++ /dev/null @@ -1,42 +0,0 @@ -1. Download and install toolchain - - $ curl https://github.com/hpmicro/riscv-gnu-toolchain/releases/tag/2022.05.15 - -2. Download and install openocd - - Download hpmicro sdk_env, openocd in the path: sdk_env/tools/openocd - -3. Configure and build NuttX - - $ mkdir ./nuttxspace - $ cd ./nuttxspace - $ git clone https://github.com/apache/nuttx.git nuttx - $ git clone https://github.com/apache/nuttx-apps.git apps - $ cd nuttx - $ make distclean - $ ./tools/configure.sh hpm6750evk2:nsh - $ make menuconfig - $ make V=1 - - Note: make menuconfig to config toolchain - ================== - To switch GNU riscv64 toolchain to GNU riscv32 toolchain, the following option must be selected: - - System Type ---> - Toolchain Selection ---> - [ ] Generic GNU RV64 toolchain - [x] Generic GNU RV32 toolchain - - Make sure HPMicro GNU riscv32 toolchain have been installed and be found in PATH. - -4. Debug the nuttx with openocd and run - - $ picocom -b 115200 /dev/ttyACM0 - - When using fireDAP, command as follows. Those cfg files in the path: sdk_env/hpm_sdk/boards/openocd. - $ openocd -f probes/cmsis_dap.cfg -f soc/hpm6750-single-core.cfg -f boards/hpm6750evk2.cfg - - $ riscv32-unknown-elf-gdb ./nuttx - (gdb) target extended-remote [ip_addr]:3333 - (gdb) load - (gdb) c diff --git a/Documentation/platforms/risc-v/hpm6750/boards/hpm6750evk2/hpm6750evk2.png b/Documentation/platforms/risc-v/hpm6750/boards/hpm6750evk2/hpm6750evk2.png new file mode 100644 index 00000000000..9f2c3c7c2e4 Binary files /dev/null and b/Documentation/platforms/risc-v/hpm6750/boards/hpm6750evk2/hpm6750evk2.png differ diff --git a/Documentation/platforms/risc-v/hpm6750/boards/hpm6750evk2/index.rst b/Documentation/platforms/risc-v/hpm6750/boards/hpm6750evk2/index.rst index cc7e7bd14a9..ba01bf35dfd 100644 --- a/Documentation/platforms/risc-v/hpm6750/boards/hpm6750evk2/index.rst +++ b/Documentation/platforms/risc-v/hpm6750/boards/hpm6750evk2/index.rst @@ -1,6 +1,106 @@ =========== -hpm6750evk2 +HPM6750EVK2 =========== -.. include:: README.txt - :literal: +.. tags:: arch:riscv, vendor:hpmicro, experimental + +.. figure:: hpm6750evk2.png + :figwidth: 50% + :align: center + :alt: The HPM6750EVK2 development board. + + The HPM6750EVK2 development board. + +More documentation about this board from the vendor can be found `here +<https://hpm-sdk.readthedocs.io/en/latest/boards/hpm6750evk2/README_en.html>`_. + +Features +======== + +* Dual-core MCU 816MHz +* 2MB on-chip RAM +* 256Mb SDRAM +* 1000Mbit Ethernet PHY +* 128Mb QSPI NOR flash +* SD/eMMC interface +* LCD connector +* DVP camera connector +* Audio mic input +* 3x USBC 2.0 connectors +* Motor control expansion port + +Buttons and LEDs +================ + +S1 dip switch: + +* OFF, OFF: boot from QSPI flash +* OFF, ON: serial boot +* ON, OFF: ISP + +There are three buttons: + +* PBUTN (SW1): power button, TinyUF2 boot button, GPIO button +* WBUTN (SW2): wake-up button +* RESET (SW3): reset button + +There is also an RGB LED. + +Installation +============ + +Download and install the toolchain: + +.. code:: console + + $ curl https://github.com/hpmicro/riscv-gnu-toolchain/releases/tag/2022.05.15 + +You will also need OpenOCD. Install ``hpmicro sdk_env`` and ensure that OpenOCD +is in the path (``sdk_env/tools/openocd``). + +Building NuttX +============== + +.. note:: + + If you want to switch the GNU riscv64 toolchain to the GNU riscv32 toolchain, + you will need to select ``System type -> Toolchain Selection -> Generic GNU + GNU RV32 toolchain`` in the Kconfig menu (``make menuconfig``). Make sure + that the HPMicro GNU riscv32 toolchain is installed and in your ``PATH``. + +Flashing +======== + +Debug NuttX with OpenOCD and run: + +.. code:: console + + $ picocom -b 115200 /dev/ttyACM0 + +When using fireDAP, the command is as follows (ensure +``sdk_env/hpm_sdk/boards/openocd`` is in your PATH): + +.. code:: console + + $ openocd -f probes/cmsis_dap.cfg -f soc/hpm6750-single-core.cfg -f boards/hpm6750evk2.cfg + + $ riscv32-unknown-elf-gdb ./nuttx + (gdb) target extended-remote [ip_addr]:3333 + (gdb) load + (gdb) c + +Configurations +============== + +To configure NuttX, you can use the following command in the NuttX directory: + +.. code:: console + + $ ./tools/configure.sh hpm6750evk2:<config> + +Where ``<config>`` is one the configurations listed below. + +nsh +--- + +A simple configuration with the NSH shell.
