Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. On the development host, make sure that your serial terminal utility (such as picocom) is not connected to the board serial console (/dev/ttyUSB1 in this example).

  2. Run the following command on the Linux development host:

    Code Block
    [sasha_d@workbench stm32h7-som]$ ./u-boot-upstream/board/emcraft/
    stm32h7-som/stm32h7-som-prog.kermit /dev/ttyUSB1 u-boot-upstream/\
    u-boot.img STM32CubeH7/Release/freertos_stm32h750.img
    Reset the board to start programming "u-boot-upstream/u-boot.img" 
    via "/dev/ttyUSB1"
  3. Reset the SOM by pressing the S3 button on the carrier board.

  4. Wait for the C-Kermit utility to load the U-Boot and FreeRTOS images (observe the progress indicators).

  5. The script will exit successfully at the end of the installation procedure:

    Code Block
    ...
    Successfully programmed STM32CubeH7/Release/freertos_stm32h750.img 
    to the rtos1 UBI volume
    setenv boot1_valid 1
    STM32H7-SOM U-Boot > setenv boot2_active 0
    STM32H7-SOM U-Boot > setenv upgrade_available 0
    STM32H7-SOM U-Boot > setenv bootcount 0
    STM32H7-SOM U-Boot > saveenv
    Saving Environment to UBI... ubi0: detaching mtd2
    ...
    Writing to UBI... done
    OK
    STM32H7-SOM U-Boot > 
    [sasha_d@workbench stm32h7-som]$
  6. Verify that the U-Boot "proper" and FreeRTOS have been successfully installed. Reset the SOM by pressing the S3 button on the carrier board and confirm that the following output appears on the serial UART console:

    Code Block
    U-Boot SPL 2019.04-emcraft-h7-2.0.0-g5445b38714 (Apr 19 2023 - 14:03:32 +0400)
    Hit 's' key to enter spl shell:
    Trying to boot from SPI
    
    
    U-Boot 2019.04-emcraft-h7-2.0.0-g5445b38714 (Apr 19 2023 - 14:03:32 +0400)
    
    Model: STMicroelectronics STM32H7 SOM
    DRAM:  32 MiB
    SF: Detected n25q512ax3 with page size 256 Bytes, erase size 4 KiB, 
    total 64 MiB
    Flash: 128 KiB
    MMC:   STM32 SDMMC2: 0
    Loading Environment from UBI... ubi0: default fastmap pool size: 190
    ...
    In:    serial
    Out:   serial
    Err:   serial
    No size specified -> Using max size (2099072)
    Read 2099072 bytes from volume splash to d0400000
    Net:   Net Initialization Skipped
    No ethernet found.
    Hit any key to stop autoboot:  0
    Booting Image #1
    No size specified -> Using max size (4198144)
    Read 4198144 bytes from volume rtos1 to d0400000
    ## Loading kernel from FIT Image at d0400000 ...
    ...
    Starting kernel ...
    
    STM32H7 SOM FreeRTOS CLI, www.emcraft.com
    Type help to view a list of available commands.
    CLI>

...

If your starter kit includes the LCD, it can be enabled in software by installing the U-Boot splash screen image to the QSPI Flash. It is done simultaneously with installing U-Boot "Proper" and FreeRTOS, as described above. Use the following command on the Linux development host to install the stm32h7-splash-24bpp.bmp picture as the splash screen:

...