hartmannathan commented on code in PR #17015: URL: https://github.com/apache/nuttx/pull/17015#discussion_r2347352423
########## Documentation/platforms/arm/stm32h7/boards/weact-stm32h750/index.rst: ########## @@ -0,0 +1,275 @@ +=============== +weact-stm32h750 +=============== + +.. tags:: chip:stm32, chip:stm32h7, chip:stm32h750 + +This page discusses issues unique to NuttX configurations for the +WeAct STM32H750 board. + +Board information +================= + +This board was release by WeAct Studio in 2020 and developed based on +STM32H750VB microcontroller. The STM32H750VB is a Cortex-M7 core with 128KBytes +Flash memory and 1MByte SRAM. + +The board features: + - USB-C power supply + - SWD connector + - Crystal for HS 25MHz + - Crystal for RTC 32.768KHz + - 1 user LED + - 1 MicroSD connector supporting 1 or 4-bit bus + - 1 USB 2.0 Host/Device + - 2 SPI Flash + - 1 OLED display + - 1 Camera + +Board documentation: https://github.com/WeActStudio/MiniSTM32H7xx + +BOARD-LED +========= + +The WeAct STM32H750 has 1 software controllable LED. + + ==== ===== + LED PINS + ==== ===== + E3 PE3 + ==== ===== + +UART/USART +========== + +The WeAct STM32H750 used the USART1 for serial debug messages. Review Comment: ```suggestion The WeAct STM32H750 uses the USART1 for serial debug messages. ``` ########## Documentation/platforms/arm/stm32h7/boards/weact-stm32h750/index.rst: ########## @@ -0,0 +1,275 @@ +=============== +weact-stm32h750 +=============== + +.. tags:: chip:stm32, chip:stm32h7, chip:stm32h750 + +This page discusses issues unique to NuttX configurations for the +WeAct STM32H750 board. + +Board information +================= + +This board was release by WeAct Studio in 2020 and developed based on +STM32H750VB microcontroller. The STM32H750VB is a Cortex-M7 core with 128KBytes +Flash memory and 1MByte SRAM. + +The board features: + - USB-C power supply + - SWD connector + - Crystal for HS 25MHz + - Crystal for RTC 32.768KHz + - 1 user LED + - 1 MicroSD connector supporting 1 or 4-bit bus + - 1 USB 2.0 Host/Device + - 2 SPI Flash + - 1 OLED display + - 1 Camera + +Board documentation: https://github.com/WeActStudio/MiniSTM32H7xx + +BOARD-LED +========= + +The WeAct STM32H750 has 1 software controllable LED. + + ==== ===== + LED PINS + ==== ===== + E3 PE3 + ==== ===== + +UART/USART +========== + +The WeAct STM32H750 used the USART1 for serial debug messages. + +USART1 +------ + + ====== ===== + USART1 PINS + ====== ===== + TX PB14 + RX PB15 + ====== ===== + + +SDMMC +====== + +The WeAct STM32H750 has one SDCard slot connected as below: + + ========== ===== + SDMMC1 PINS + ========== ===== + SDMMC_D0 PC8 + SDMMC_D1 PC9 + SDMMC_D2 PC10 + SDMMC_D3 PC11 + SDMMC_DK PC12 + ========== ===== + + =============== ===== + GPIO PINS + =============== ===== + SDCARD_DETECTED PD4 + =============== ===== + +============== + +Each weact-stm32h750 configuration is maintained in a sub-directory and +can be selected as follow:: + + ./tools/configure.sh weact-stm32h750:<subdir> + +Where <subdir> is one of the following: + +Flashing +======== + +This board can be flashed/programmed via DFU or SWD. The DFU is an alternative +when you don't have a SWD programmer, but SWD offer more than flashing: you can +use it for code debugging with GDB. So it is recommended that you have a SWD +tool on your workbench. + +DFU +--- + +First put the board in DFU mode: press and hold Boot0 (B0) button and click and release the reset (NR) button with the board powered over USB cable. Other alternative is just removing the USB cable, then press and hold the B0 button and connect the USB while still holding that button. + +You can confirm the board is in DFU mode using dmesg:: + + $ sudo dmesg + [ 1219.182108] usb 3-5: New USB device found, idVendor=0483, idProduct=df11, bcdDevice= 2.00 + [ 1219.182120] usb 3-5: New USB device strings: Mfr=1, Product=2, SerialNumber=3 + [ 1219.182122] usb 3-5: Product: DFU in FS Mode + [ 1219.182124] usb 3-5: Manufacturer: STMicroelectronics + [ 1219.182125] usb 3-5: SerialNumber: 200000500000 + +You need to have dfu-util installed in your computer:: + + $ sudo apt install dfu-util + +Now list the DFU unities:: + + $ sudo dfu-util -l + dfu-util 0.11 + Copyright 2005-2009 Weston Schmidt, Harald Welte and OpenMoko Inc. + Copyright 2010-2021 Tormod Volden and Stefan Schmidt + This program is Free Software and has ABSOLUTELY NO WARRANTY + Please report bugs to http://sourceforge.net/p/dfu-util/tickets/ + Found DFU: [0483:df11] ver=0200, devnum=5, cfg=1, intf=0, path="3-5", alt=1, name="@Option Bytes /0x5200201C/01*128 e", serial="200000500000" + Found DFU: [0483:df11] ver=0200, devnum=5, cfg=1, intf=0, path="3-5", alt=0, name="@Internal Flash /0x08000000/16*128Kg", serial="200000500000" + +Finally flash the compiled nuttx.bin:: + + $ sudo dfu-util -d 0483:df11 -a 0 -s 0x08000000:leave -D nuttx.bin + dfu-util: Warning: Invalid DFU suffix signature + dfu-util: A valid DFU suffix will be required in a future dfu-util release + Opening DFU capable USB device... + Device ID 0483:df11 + Device DFU version 011a + Claiming USB DFU Interface... + Setting Alternate Interface #0 ... + Determining device status... + DFU state(2) = dfuIDLE, status(0) = No error condition is present + DFU mode device DFU version 011a + Device returned transfer size 1024 + DfuSe interface name: "Internal Flash " + Downloading element to address = 0x08000000, size = 141324 + Erase [=========================] 100% 141324 bytes + Erase done. + Download [=========================] 100% 141324 bytes + Download done. + File downloaded successfully + Submitting leave request... + dfu-util: Error during download get_status + +You can ignore that get_status error and restart the board to get nsh> working over serial or USB (depending on selected config: nsh or usbnsh). + +SWD +--- + +Another option to flash/program your board is via SWD interface. In this case you will need a SWD programmer compatible with OpenOCD like STLink-V2 or other. + +Install openocd on your computer:: + + $ sudo apt install openocd + +Connect the SWD wires from STLink-V2 (or other programmer) this way: + +============== =============== +SWD Programmer Weact-STM32H750 +============== =============== +SWDIO DIO +GND GND +SWCLK CLK +============== =============== + +Then run this command in the same directory where your nuttx.bin is located:: + + $ openocd -f interface/stlink.cfg -f target/stm32h7x.cfg -c "init" -c "reset halt" -c "flash write_image erase nuttx.bin 0x08000000" -c "reset run" + Open On-Chip Debugger 0.11.0+dev-gcf314db1f-dirty (2025-05-17-16:09) + Licensed under GNU GPL v2 + Info : 49 4 adapter.c:111 adapter_init(): clock speed 1800 kHz + Info : 67 7 stlink_usb.c:1438 stlink_usb_version(): STLINK V2J17S4 (API v2) VID:PID 0483:3748 + Info : 69 8 stlink_usb.c:1474 stlink_usb_check_voltage(): Target voltage: 3.268800 + Info : 82 112 cortex_m.c:2325 cortex_m_examine(): [stm32h7x.cpu0] Cortex-M7 r1p1 processor detected + Info : 127 120 cortex_m.c:2440 cortex_m_examine(): [stm32h7x.cpu0] target has 8 breakpoints, 4 watchpoints + User : 128 120 target.c:777 target_examine_one(): [stm32h7x.cpu0] Target successfully examined. + Info : 193 165 gdb_server.c:4825 gdb_target_start(): starting gdb server for stm32h7x.cpu0 on 3333 + Info : 194 165 server.c:359 add_service(): Listening on port 3333 for gdb connections + The core #0 listens on 3333. + ICEman is ready to use. + User : 259 196 armv7m.c:740 armv7m_arch_state(): target halted due to debug-request, current mode: Thread + xPSR: 0x01000000 pc: 0x080013bc msp: 0x24001e28 + Info : 266 197 stm32h7x.c:791 stm32x_probe(): Device: STM32H74x/75x + Info : 270 197 stm32h7x.c:819 stm32x_probe(): flash size probed value 2048k + Info : 271 197 stm32h7x.c:849 stm32x_probe(): STM32H7 flash has dual banks + Info : 272 197 stm32h7x.c:869 stm32x_probe(): Bank (0) size is 1024 kb, base address is 0x08000000 + Info : 273 197 core.c:876 flash_write_unlock_verify(): Padding image section 0 at 0x0802280c with 20 bytes (bank write end alignment) + Warn : 275 198 core.c:552 flash_iterate_address_range_inner(): Adding extra erase range, 0x08022820 .. 0x0803ffff + User : 2674 4879 options.c:63 configuration_output_handler(): auto erase enabled + wrote 141344 bytes from file nuttx.bin in 4.682974s (29.475 KiB/s) + User : 2675 4879 options.c:63 configuration_output_handler(): + Info : 2714 4889 server.c:359 add_service(): Listening on port 6666 for tcl connections + Info : 2715 4889 server.c:359 add_service(): Listening on port 4444 for telnet connections + +After you got the message "wrote xxxxxx bytes from file nuttx.bin" you can press Ctrl+C (``^C``) to finish the application. Now you can reset the board and get access to the NSH terminal. Review Comment: ```suggestion After you get the message "wrote xxxxxx bytes from file nuttx.bin" you can press Ctrl+C (``^C``) to finish the application. Now you can reset the board and get access to the NSH terminal. ``` ########## Documentation/platforms/arm/stm32h7/boards/weact-stm32h750/index.rst: ########## @@ -0,0 +1,275 @@ +=============== +weact-stm32h750 +=============== + +.. tags:: chip:stm32, chip:stm32h7, chip:stm32h750 + +This page discusses issues unique to NuttX configurations for the +WeAct STM32H750 board. + +Board information +================= + +This board was release by WeAct Studio in 2020 and developed based on +STM32H750VB microcontroller. The STM32H750VB is a Cortex-M7 core with 128KBytes +Flash memory and 1MByte SRAM. + +The board features: + - USB-C power supply + - SWD connector + - Crystal for HS 25MHz + - Crystal for RTC 32.768KHz + - 1 user LED + - 1 MicroSD connector supporting 1 or 4-bit bus + - 1 USB 2.0 Host/Device + - 2 SPI Flash + - 1 OLED display + - 1 Camera + +Board documentation: https://github.com/WeActStudio/MiniSTM32H7xx + +BOARD-LED +========= + +The WeAct STM32H750 has 1 software controllable LED. + + ==== ===== + LED PINS + ==== ===== + E3 PE3 + ==== ===== + +UART/USART +========== + +The WeAct STM32H750 used the USART1 for serial debug messages. + +USART1 +------ + + ====== ===== + USART1 PINS + ====== ===== + TX PB14 + RX PB15 + ====== ===== + + +SDMMC +====== + +The WeAct STM32H750 has one SDCard slot connected as below: + + ========== ===== + SDMMC1 PINS + ========== ===== + SDMMC_D0 PC8 + SDMMC_D1 PC9 + SDMMC_D2 PC10 + SDMMC_D3 PC11 + SDMMC_DK PC12 + ========== ===== + + =============== ===== + GPIO PINS + =============== ===== + SDCARD_DETECTED PD4 + =============== ===== + +============== + +Each weact-stm32h750 configuration is maintained in a sub-directory and +can be selected as follow:: Review Comment: ```suggestion can be selected as follows:: ``` ########## Documentation/platforms/arm/stm32h7/boards/weact-stm32h750/index.rst: ########## @@ -0,0 +1,275 @@ +=============== +weact-stm32h750 +=============== + +.. tags:: chip:stm32, chip:stm32h7, chip:stm32h750 + +This page discusses issues unique to NuttX configurations for the +WeAct STM32H750 board. + +Board information +================= + +This board was release by WeAct Studio in 2020 and developed based on +STM32H750VB microcontroller. The STM32H750VB is a Cortex-M7 core with 128KBytes +Flash memory and 1MByte SRAM. + +The board features: + - USB-C power supply + - SWD connector + - Crystal for HS 25MHz + - Crystal for RTC 32.768KHz + - 1 user LED + - 1 MicroSD connector supporting 1 or 4-bit bus + - 1 USB 2.0 Host/Device + - 2 SPI Flash + - 1 OLED display + - 1 Camera + +Board documentation: https://github.com/WeActStudio/MiniSTM32H7xx + +BOARD-LED +========= + +The WeAct STM32H750 has 1 software controllable LED. + + ==== ===== + LED PINS + ==== ===== + E3 PE3 + ==== ===== + +UART/USART +========== + +The WeAct STM32H750 used the USART1 for serial debug messages. + +USART1 +------ + + ====== ===== + USART1 PINS + ====== ===== + TX PB14 + RX PB15 + ====== ===== + + +SDMMC +====== + +The WeAct STM32H750 has one SDCard slot connected as below: + + ========== ===== + SDMMC1 PINS + ========== ===== + SDMMC_D0 PC8 + SDMMC_D1 PC9 + SDMMC_D2 PC10 + SDMMC_D3 PC11 + SDMMC_DK PC12 + ========== ===== + + =============== ===== + GPIO PINS + =============== ===== + SDCARD_DETECTED PD4 + =============== ===== + +============== + +Each weact-stm32h750 configuration is maintained in a sub-directory and +can be selected as follow:: + + ./tools/configure.sh weact-stm32h750:<subdir> + +Where <subdir> is one of the following: + +Flashing +======== + +This board can be flashed/programmed via DFU or SWD. The DFU is an alternative +when you don't have a SWD programmer, but SWD offer more than flashing: you can Review Comment: ```suggestion when you don't have a SWD programmer, but SWD offers more than flashing: you can ``` ########## Documentation/platforms/arm/stm32h7/boards/weact-stm32h750/index.rst: ########## @@ -0,0 +1,275 @@ +=============== +weact-stm32h750 +=============== + +.. tags:: chip:stm32, chip:stm32h7, chip:stm32h750 + +This page discusses issues unique to NuttX configurations for the +WeAct STM32H750 board. + +Board information +================= + +This board was release by WeAct Studio in 2020 and developed based on +STM32H750VB microcontroller. The STM32H750VB is a Cortex-M7 core with 128KBytes +Flash memory and 1MByte SRAM. + +The board features: + - USB-C power supply + - SWD connector + - Crystal for HS 25MHz + - Crystal for RTC 32.768KHz + - 1 user LED + - 1 MicroSD connector supporting 1 or 4-bit bus + - 1 USB 2.0 Host/Device + - 2 SPI Flash + - 1 OLED display + - 1 Camera + +Board documentation: https://github.com/WeActStudio/MiniSTM32H7xx + +BOARD-LED +========= + +The WeAct STM32H750 has 1 software controllable LED. + + ==== ===== + LED PINS + ==== ===== + E3 PE3 + ==== ===== + +UART/USART +========== + +The WeAct STM32H750 used the USART1 for serial debug messages. + +USART1 +------ + + ====== ===== + USART1 PINS + ====== ===== + TX PB14 + RX PB15 + ====== ===== + + +SDMMC +====== + +The WeAct STM32H750 has one SDCard slot connected as below: + + ========== ===== + SDMMC1 PINS + ========== ===== + SDMMC_D0 PC8 + SDMMC_D1 PC9 + SDMMC_D2 PC10 + SDMMC_D3 PC11 + SDMMC_DK PC12 + ========== ===== + + =============== ===== + GPIO PINS + =============== ===== + SDCARD_DETECTED PD4 + =============== ===== + +============== + +Each weact-stm32h750 configuration is maintained in a sub-directory and +can be selected as follow:: + + ./tools/configure.sh weact-stm32h750:<subdir> + +Where <subdir> is one of the following: + +Flashing +======== + +This board can be flashed/programmed via DFU or SWD. The DFU is an alternative +when you don't have a SWD programmer, but SWD offer more than flashing: you can +use it for code debugging with GDB. So it is recommended that you have a SWD +tool on your workbench. + +DFU +--- + +First put the board in DFU mode: press and hold Boot0 (B0) button and click and release the reset (NR) button with the board powered over USB cable. Other alternative is just removing the USB cable, then press and hold the B0 button and connect the USB while still holding that button. + +You can confirm the board is in DFU mode using dmesg:: + + $ sudo dmesg + [ 1219.182108] usb 3-5: New USB device found, idVendor=0483, idProduct=df11, bcdDevice= 2.00 + [ 1219.182120] usb 3-5: New USB device strings: Mfr=1, Product=2, SerialNumber=3 + [ 1219.182122] usb 3-5: Product: DFU in FS Mode + [ 1219.182124] usb 3-5: Manufacturer: STMicroelectronics + [ 1219.182125] usb 3-5: SerialNumber: 200000500000 + +You need to have dfu-util installed in your computer:: + + $ sudo apt install dfu-util + +Now list the DFU unities:: + + $ sudo dfu-util -l + dfu-util 0.11 + Copyright 2005-2009 Weston Schmidt, Harald Welte and OpenMoko Inc. + Copyright 2010-2021 Tormod Volden and Stefan Schmidt + This program is Free Software and has ABSOLUTELY NO WARRANTY + Please report bugs to http://sourceforge.net/p/dfu-util/tickets/ + Found DFU: [0483:df11] ver=0200, devnum=5, cfg=1, intf=0, path="3-5", alt=1, name="@Option Bytes /0x5200201C/01*128 e", serial="200000500000" + Found DFU: [0483:df11] ver=0200, devnum=5, cfg=1, intf=0, path="3-5", alt=0, name="@Internal Flash /0x08000000/16*128Kg", serial="200000500000" + +Finally flash the compiled nuttx.bin:: + + $ sudo dfu-util -d 0483:df11 -a 0 -s 0x08000000:leave -D nuttx.bin + dfu-util: Warning: Invalid DFU suffix signature + dfu-util: A valid DFU suffix will be required in a future dfu-util release + Opening DFU capable USB device... + Device ID 0483:df11 + Device DFU version 011a + Claiming USB DFU Interface... + Setting Alternate Interface #0 ... + Determining device status... + DFU state(2) = dfuIDLE, status(0) = No error condition is present + DFU mode device DFU version 011a + Device returned transfer size 1024 + DfuSe interface name: "Internal Flash " + Downloading element to address = 0x08000000, size = 141324 + Erase [=========================] 100% 141324 bytes + Erase done. + Download [=========================] 100% 141324 bytes + Download done. + File downloaded successfully + Submitting leave request... + dfu-util: Error during download get_status + +You can ignore that get_status error and restart the board to get nsh> working over serial or USB (depending on selected config: nsh or usbnsh). + +SWD +--- + +Another option to flash/program your board is via SWD interface. In this case you will need a SWD programmer compatible with OpenOCD like STLink-V2 or other. + +Install openocd on your computer:: + + $ sudo apt install openocd + +Connect the SWD wires from STLink-V2 (or other programmer) this way: + +============== =============== +SWD Programmer Weact-STM32H750 +============== =============== +SWDIO DIO +GND GND +SWCLK CLK +============== =============== + +Then run this command in the same directory where your nuttx.bin is located:: + + $ openocd -f interface/stlink.cfg -f target/stm32h7x.cfg -c "init" -c "reset halt" -c "flash write_image erase nuttx.bin 0x08000000" -c "reset run" + Open On-Chip Debugger 0.11.0+dev-gcf314db1f-dirty (2025-05-17-16:09) + Licensed under GNU GPL v2 + Info : 49 4 adapter.c:111 adapter_init(): clock speed 1800 kHz + Info : 67 7 stlink_usb.c:1438 stlink_usb_version(): STLINK V2J17S4 (API v2) VID:PID 0483:3748 + Info : 69 8 stlink_usb.c:1474 stlink_usb_check_voltage(): Target voltage: 3.268800 + Info : 82 112 cortex_m.c:2325 cortex_m_examine(): [stm32h7x.cpu0] Cortex-M7 r1p1 processor detected + Info : 127 120 cortex_m.c:2440 cortex_m_examine(): [stm32h7x.cpu0] target has 8 breakpoints, 4 watchpoints + User : 128 120 target.c:777 target_examine_one(): [stm32h7x.cpu0] Target successfully examined. + Info : 193 165 gdb_server.c:4825 gdb_target_start(): starting gdb server for stm32h7x.cpu0 on 3333 + Info : 194 165 server.c:359 add_service(): Listening on port 3333 for gdb connections + The core #0 listens on 3333. + ICEman is ready to use. + User : 259 196 armv7m.c:740 armv7m_arch_state(): target halted due to debug-request, current mode: Thread + xPSR: 0x01000000 pc: 0x080013bc msp: 0x24001e28 + Info : 266 197 stm32h7x.c:791 stm32x_probe(): Device: STM32H74x/75x + Info : 270 197 stm32h7x.c:819 stm32x_probe(): flash size probed value 2048k + Info : 271 197 stm32h7x.c:849 stm32x_probe(): STM32H7 flash has dual banks + Info : 272 197 stm32h7x.c:869 stm32x_probe(): Bank (0) size is 1024 kb, base address is 0x08000000 + Info : 273 197 core.c:876 flash_write_unlock_verify(): Padding image section 0 at 0x0802280c with 20 bytes (bank write end alignment) + Warn : 275 198 core.c:552 flash_iterate_address_range_inner(): Adding extra erase range, 0x08022820 .. 0x0803ffff + User : 2674 4879 options.c:63 configuration_output_handler(): auto erase enabled + wrote 141344 bytes from file nuttx.bin in 4.682974s (29.475 KiB/s) + User : 2675 4879 options.c:63 configuration_output_handler(): + Info : 2714 4889 server.c:359 add_service(): Listening on port 6666 for tcl connections + Info : 2715 4889 server.c:359 add_service(): Listening on port 4444 for telnet connections + +After you got the message "wrote xxxxxx bytes from file nuttx.bin" you can press Ctrl+C (``^C``) to finish the application. Now you can reset the board and get access to the NSH terminal. + +============== + +Configuration Directories +------------------------- + +nsh +--- + +Configures the NuttShell (nsh) located at apps/examples/nsh. This +configuration enables a serial console on UART1. + +usbnsh +------ + +Configures the NuttShell (nsh) located at apps/examples/nsh. This +configuration enables a serial console over USB. + +After flashing and reboot your board you should see in your dmesg logs:: + + [ 2638.948089] usb 1-1.4: new full-speed USB device number 16 using xhci_hcd + [ 2639.054432] usb 1-1.4: New USB device found, idVendor=0525, idProduct=a4a7, bcdDevice= 1.01 + [ 2639.054437] usb 1-1.4: New USB device strings: Mfr=1, Product=2, SerialNumber=3 + [ 2639.054438] usb 1-1.4: Product: CDC/ACM Serial + [ 2639.054440] usb 1-1.4: Manufacturer: NuttX + [ 2639.054441] usb 1-1.4: SerialNumber: 0 + [ 2639.074861] cdc_acm 1-1.4:1.0: ttyACM0: USB ACM device + [ 2639.074886] usbcore: registered new interface driver cdc_acm + [ 2639.074887] cdc_acm: USB Abstract Control Model driver for USB modems and ISDN adapters + +You may need to press **ENTER** 3 times before the NSH show up. Review Comment: ```suggestion You may need to press **ENTER** 3 times before the NSH shows up. ``` -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: commits-unsubscr...@nuttx.apache.org For queries about this service, please contact Infrastructure at: us...@infra.apache.org
