120 lines
3.0 KiB
Plaintext
120 lines
3.0 KiB
Plaintext
README
|
|
======
|
|
|
|
This is the README file for a port of NuttX to the ST Micro Nucleo G474RE
|
|
board with STM32G474RE MCU. For more information about this board, see:
|
|
|
|
https://www.st.com/en/evaluation-tools/nucleo-g474re.html
|
|
|
|
Contents
|
|
========
|
|
|
|
- Status
|
|
- Development Environment
|
|
- Toolchains
|
|
- Debugging
|
|
- Hardware
|
|
- MCU Clocking
|
|
- GPIOs
|
|
- Buttons
|
|
- LEDs
|
|
- Serial Consoles
|
|
- FLASH Bootloader Support
|
|
- Configurations
|
|
|
|
Status
|
|
======
|
|
|
|
This port boots NuttX through to a functional NSH prompt.
|
|
|
|
Development Environment
|
|
=======================
|
|
|
|
Toolchains
|
|
----------
|
|
An appropriate ARM toolchain is needed, such as the one built with the
|
|
customized NuttX buildroot or the ready-made GNU Tools for Arm Embedded
|
|
Processors.
|
|
|
|
Debugging
|
|
---------
|
|
The board incorporates a STLINK-V3E programmer/debugger accessible via the
|
|
Micro-USB Type B connector.
|
|
|
|
To debug with OpenOCD and arm-nuttx-eabi-gdb:
|
|
|
|
* Use 'make menuconfig' to set CONFIG_DEBUG_SYMBOLS and CONFIG_DEBUG_NOOPT.
|
|
To see debug output, e.g., the "ABCDE" printed in __start(), also set
|
|
CONFIG_DEBUG_FEATURES.
|
|
|
|
* Build NuttX.
|
|
|
|
* Flash the code using:
|
|
$ openocd -f interface/stlink.cfg -f target/stm32g4x.cfg -c init \
|
|
-c "reset halt" -c "flash write_image erase nuttx.bin 0x08000000"
|
|
|
|
* Start GDB with:
|
|
$ arm-nuttx-eabi-gdb -tui nuttx
|
|
|
|
* In GDB:
|
|
(gdb) target remote localhost:3333
|
|
(gdb) monitor reset halt
|
|
(gdb) load
|
|
|
|
Hardware
|
|
========
|
|
|
|
MCU Clocking
|
|
------------
|
|
By default, the MCU on this board is clocked from the MCU's internal HSI
|
|
clock, and only this option is supported by software at this time.
|
|
|
|
If software support is added for it, the MCU could be clocked from the
|
|
following other sources: a 24 MHz oscillator on X2, MCO from STLINK-V3E, or
|
|
external clock from connector CN9, pin 26.
|
|
|
|
GPIOs
|
|
-----
|
|
|
|
Buttons
|
|
-------
|
|
The board has 1 user button.
|
|
|
|
LEDs
|
|
----
|
|
The board has 1 user LED.
|
|
|
|
Serial Consoles
|
|
===============
|
|
|
|
The MCU's USART3 is exposed to the pin 1 and 2 of the "Morpho connector" CN7
|
|
on the board.
|
|
|
|
FLASH Bootloader Support
|
|
========================
|
|
|
|
If implementing a FLASH bootloader, turn on Kconfig option CONFIG_STM32_DFU.
|
|
This option activates an alternate linker script, scripts/ld.script.dfu,
|
|
which causes NuttX to leave a gap at the start of FLASH, leaving that space
|
|
for the FLASH bootloader. See scripts/ld.script.dfu for details. It also
|
|
causes NuttX to relocate its vector table and possibly make other
|
|
adjustments.
|
|
|
|
One possible bootloader is STmicro's OpenBootloader "middleware" supplied
|
|
with STM32CubeG4 version 1.3.0. On the host (PC), it should be possible to
|
|
use STmicro's STM32CubeProgrammer or the stm32loader.py script from
|
|
https://github.com/jsnyder/stm32loader. That script can be invoked with
|
|
parameters such as:
|
|
|
|
stm32loader.py -p /dev/ttyACM0 -a 0x08006000 -e -w -v -g 0x08006000 nuttx.bin
|
|
|
|
where the given address (0x08006000 in this case) must match the starting
|
|
address in scripts/ld.script.dfu.
|
|
|
|
Configurations
|
|
==============
|
|
|
|
nsh
|
|
---
|
|
|