circuitpython/ports/stm
Jeff Epler 8cfc50bd13
Merge remote-tracking branch 'origin/8.2.x' into merge-828
2023-11-16 08:55:40 -06:00
..
boards Merge remote-tracking branch 'origin/8.2.x' into merge-828 2023-11-16 08:55:40 -06:00
common-hal Switch all ports to auto-growing split heap 2023-11-01 15:24:16 -07:00
hal_conf style(swan_r5): pre-commit whitespace style changes 2021-09-28 18:52:03 -07:00
packages feat: add Blues Swan R5 support 2021-09-28 18:52:02 -07:00
peripherals Switch to using MP_ERROR_TEXT instead of translate, globally 2023-10-30 09:49:06 +01:00
st_driver add adafruit/stm32f4xx_hal_driver submodule 2022-02-03 14:01:11 -05:00
supervisor Switch all ports to auto-growing split heap 2023-11-01 15:24:16 -07:00
tools run updated pre-commit 2023-02-01 13:38:41 +05:30
.gitignore remove redundant port/*/.gitignore; cleanup others 2022-10-01 11:52:36 -04:00
Makefile Switch to gcc 12.3 for arm32 2023-10-17 11:43:38 -07:00
README.md Fix docs build by splitting out support matrix 2023-10-24 16:20:51 -07:00
background.c Fix ticks 2023-04-07 09:49:51 -07:00
background.h
mpconfigport.h MP_REGISTER_ROOT_POINTER for port-specific root pointers 2023-09-29 15:46:42 -04:00
mpconfigport.mk Split displayio hardware support from core 2023-10-24 15:43:34 -07:00
mpconfigport_nanbox.h Merge MicroPython 1.13 into CircuitPython 2021-05-04 18:06:33 -07:00
mphalport.c Remove redundant header files. 2022-10-10 20:37:31 +02:00
mphalport.h run code formatting script 2021-03-15 19:27:36 +05:30
qstrdefsport.h

README.md

ST Microelectronics STM32

This port brings the ST Microelectronics STM32 series of MCUs to Circuitpython. STM32 chips have a wide range of capability, from <$1 low power STM32F0s to dual-core STM32H7s running at 400+ MHz. Currently, only the F4, F7, and H7 families are supported, powered by the ARM Cortex M4 and M7 processors.

Refer to the ST Microelectronics website for more information on features sorted by family and individual chip lines: st.com/en/microcontrollers-microprocessors/stm32-high-performance-mcus.html

STM32 SoCs vary product-by-product in clock speed, peripheral capability, pin assignments, and their support within this port. Refer to mpconfigport.mk for a full list of enabled modules sorted by family.

How this port is organized:

  • boards/ contains the configuration files for each development board and breakout available on the port, as well as system files and both shared and SoC-specific linker files. Board configuration includes a pin mapping of the board, oscillator information, board-specific build flags, and setup for OLED or TFT screens where applicable.
  • common-hal/ contains the port-specific module implementations, used by shared-module and shared-bindings.
  • packages/ contains package-specific pin bindings (LQFP100, BGA216, etc)
  • peripherals/ contains peripheral setup files and peripheral mapping information, sorted by family and sub-variant. Most files in this directory can be generated with the python scripts in tools/.
  • st-driver/ submodule for ST HAL and LL files generated via CubeMX. Shared with TinyUSB.
  • supervisor/ contains port-specific implementations of internal flash, serial and USB, as well as the port.c file, which initializes the port at startup.
  • tools/ python scripts for generating peripheral and pin mapping files in peripherals/ and board/.

At the root level, refer to mpconfigboard.h and mpconfigport.mk for port specific settings and a list of enabled modules.

Build instructions

Ensure your clone of Circuitpython is ready to build by following the guide on the Adafruit Website. This includes installing the toolchain, synchronizing submodules, and running mpy-cross.

Once the one-time build tasks are complete, you can build at any time by navigating to the port directory:

$ cd ports/stm

To build for a specific circuitpython board, run:

$ make BOARD=feather_stm32f405_express

You may also build with certain flags available in the makefile, depending on your board and development goals. The following flags would enable debug information and correct flash locations for a pre-flashed UF2 bootloader:

$ make BOARD=feather_stm32f405_express DEBUG=1 UF2_BOOTLOADER=1

USB connection

Connect your development board of choice to the host PC via the USB cable. Note that for most ST development boards such as the Nucleo and Discovery series, you must use a secondary OTG USB connector to access circuitpython, as the primary USB connector will be connected to a built-in ST-Link debugger rather than the chip itself.

In many cases, this ST-Link USB connector will still need to be connected to power for the chip to turn on - refer to your specific product manual for details.

Flash the bootloader

Most ST development boards come with a built-in STLink programming and debugging probe accessible via USB. This programmer may show up as an MBED drive on the host PC, enabling simple drag and drop programming with a .bin file, or they may require a tool like OpenOCD or StLink-org/stlink to run flashing and debugging commands.

Many hobbyist and 3rd party development boards also expose SWD pins. These can be used with a cheap stlink debugger or other common programmers.

For non-ST products or users without a debugger, all STM32 boards in the high performance families (F4, F7 and H7) include a built-in DFU bootloader stored in ROM. This bootloader is accessed by ensuring the BOOT0 pin is held to a logic 1 and the BOOT1 pin is held to a logic 0 when the chip is reset (ST Appnote AN2606). Most chips hold BOOT low by default, so this can usually be achieved by running a jumper wire from 3.3V power to the BOOT0 pin, if it is exposed, or by flipping the appropriate switch or button as the chip is reset. Once the chip is started in DFU mode, BOOT0 no longer needs to be held high and can be released. An example is available in the Feather STM32F405 guide.

Windows users will need to install stm32cubeprog, while Mac and Linux users will need to install dfu-util with brew install dfu-util or sudo apt-get install dfu-util. More details are available in the Feather F405 guide.

Flashing the circuitpython image with DFU-Util

Ensure the board is in dfu mode by following the steps in the previous section. Then run:

$ make BOARD=feather_stm32F405_express flash

Alternatively, you can navigate to the build directory and run the raw dfu-util command:

dfu-util -a 0 --dfuse-address 0x08000000 -D firmware.bin

Accessing the board

Connecting the board to the PC via the USB cable will allow code to be uploaded to the CIRCUITPY volume.

Circuitpython exposes a CDC virtual serial connection for REPL access and debugging. Connecting to it from OSX will look something like this:

screen /dev/tty.usbmodem14111201 115200

You may also use a program like mu to assist with REPL access.