You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
Jim Mussared 994c1dd57a stm32/Makefile: Add missing ordering dependency on generated headers. 5 years ago
..
boards stm32/boards: Disable pend_throw, uheapq, utimeq on small-flash boards. 5 years ago
lwip_inc stm32/lwip_inc: Enable LWIP_NETIF_EXT_STATUS_CALLBACK for mDNS. 5 years ago
mbedtls stm32/mbedtls: Resize mbedtls output buffer from 16 down to 4 kiB. 5 years ago
mboot stm32/mboot: Remove unnecessary test for led being 1 in led_state. 5 years ago
usbdev stm32/usbdev: Fix compile error if MICROPY_HW_USB_CDC_NUM is set to 2. 5 years ago
usbhost stm32: Remove unneeded HTML release notes from usbdev and usbhost dirs. 7 years ago
Makefile stm32/Makefile: Add missing ordering dependency on generated headers. 5 years ago
README.md ports: Add new make target "submodules" which inits required modules. 5 years ago
accel.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
accel.h stm32: Change header include guards from STMHAL to STM32 to match dir. 7 years ago
adc.c all: Remove spaces inside and around parenthesis. 5 years ago
adc.h stm32: Change header include guards from STMHAL to STM32 to match dir. 7 years ago
autoflash ports: Make new ports/ sub-directory and move all ports there. 7 years ago
btstack.c stm32: Refactor Bluetooth HCI RX to be independent of transport layer. 5 years ago
bufhelper.c ports: Convert legacy uppercase macro names to lowercase. 6 years ago
bufhelper.h stm32: Change header include guards from STMHAL to STM32 to match dir. 7 years ago
can.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
can.h stm32/can: Guard header file by MICROPY_HW_ENABLE_CAN. 5 years ago
dac.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
dac.h stm32/dac: Rework DAC driver to use direct register access. 6 years ago
dma.c all: Remove spaces between nested paren and inside function arg paren. 5 years ago
dma.h stm32: Add initial support for STM32WBxx MCUs. 5 years ago
eth.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
eth.h stm32/eth: Add low-level Ethernet MAC driver. 6 years ago
extint.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
extint.h stm32: Add initial support for STM32WBxx MCUs. 5 years ago
factoryreset.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
factoryreset.h stm32: Generalise flash mounting code so it supports arbitrary FS. 5 years ago
fatfs_port.c stm32/fatfs_port: Fix bug when MICROPY_HW_ENABLE_RTC not enabled. 6 years ago
fdcan.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
flash.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
flash.h stm32/flash: Remove unused src parameter from flash_erase(). 7 years ago
flashbdev.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
font_petme128_8x8.h all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
gccollect.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
gccollect.h stm32: In link script, define start of stack separately from heap end. 5 years ago
help.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
i2c.c stm32/i2c: Fix generation of restart condition for hw I2C on F0/F7. 5 years ago
i2c.h stm32/i2c: Make timeout for hardware I2C configurable. 6 years ago
i2cslave.c stm32/i2cslave: Add support for H7 MCUs. 6 years ago
i2cslave.h stm32/i2cslave: Add support for H7 MCUs. 6 years ago
irq.c stm32/irq: Fix IRQ_ENABLE_STATS stats config to work on all MCUs. 6 years ago
irq.h stm32/powerctrlboot: Fix config of systick IRQ priority on F0/L0/WB MCU. 5 years ago
lcd.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
lcd.h stm32: Change header include guards from STMHAL to STM32 to match dir. 7 years ago
led.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
led.h stm32: Change header include guards from STMHAL to STM32 to match dir. 7 years ago
machine_adc.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
machine_i2c.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
machine_spi.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
machine_timer.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
machine_uart.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
main.c stm32/main: Fix bug mounting 3rd SD partition. 5 years ago
make-stmconst.py all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
modbluetooth_hci.c stm32: Refactor Bluetooth HCI RX to be independent of transport layer. 5 years ago
modmachine.c all: Remove spaces inside and around parenthesis. 5 years ago
modmachine.h stm32: Add machine.Timer with soft timer implementation. 5 years ago
modnetwork.c stm32/modnetwork: Remove redundant call to nimble_poll in lwip poll. 5 years ago
modnetwork.h stm32/modnetwork: Replace generic netif NIC polling with specific code. 6 years ago
modnwcc3k.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
modnwwiznet5k.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
modpyb.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
modstm.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
moduos.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
modusocket.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
modutime.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
mpconfigboard_common.h all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
mpconfigport.h stm32/mpconfigport.h: Make most extended modules configurable by board. 5 years ago
mpconfigport.mk extmod: Consolidate FAT FS config to MICROPY_VFS_FAT across all ports. 5 years ago
mpconfigport_nanbox.h stm32: Add configuration to build in nanbox mode. 5 years ago
mphalport.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
mphalport.h all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
mpthreadport.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
mpthreadport.h py/mpthread.h: Use strong type for mp_thread_set_state() argument. 5 years ago
mpu.h all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
network_lan.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
network_wiznet5k.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
nimble.c stm32: Refactor Bluetooth HCI RX to be independent of transport layer. 5 years ago
pendsv.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
pendsv.h stm32: Refactor bluetooth stack/hci/driver bindings. 5 years ago
pin.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
pin.h all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
pin_defs_stm32.c all: Update Makefiles and others to build with new ports/ dir layout. 7 years ago
pin_defs_stm32.h all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
pin_named_pins.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
pin_static_af.h all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
portmodules.h stm32: Change header include guards from STMHAL to STM32 to match dir. 7 years ago
powerctrl.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
powerctrl.h stm32/powerctrl: Move L0's SystemClock_Config to powerctrlboot.c file. 5 years ago
powerctrlboot.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
pyb_can.c all: Remove spaces inside and around parenthesis. 5 years ago
pyb_i2c.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
pyb_spi.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
pybcdc.inf_template ports: Make new ports/ sub-directory and move all ports there. 7 years ago
pybthread.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
pybthread.h all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
qspi.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
qspi.h stm32/qspi: Add hardware QSPI driver, with memory-map capability. 7 years ago
qstrdefsport.h all: Add *FORMAT-OFF* in various places. 5 years ago
resethandler.s stm32/main: Rename main to stm32_main and pass through first argument. 7 years ago
resethandler_m0.s stm32: Add support for Cortex-M0 CPUs. 7 years ago
rfcore.c stm32: Refactor Bluetooth HCI RX to be independent of transport layer. 5 years ago
rfcore.h stm32: Refactor Bluetooth HCI RX to be independent of transport layer. 5 years ago
rng.c stm32/rng: Use Yasmarang for rng_get() if MCU doesn't have HW RNG. 7 years ago
rng.h stm32: Change header include guards from STMHAL to STM32 to match dir. 7 years ago
rtc.c all: Remove spaces inside and around parenthesis. 5 years ago
rtc.h stm32: Implement machine.lightsleep(). 6 years ago
sdcard.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
sdcard.h stm32: Add support for MMC driver, exposed via pyb.MMCard class. 6 years ago
sdio.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
sdio.h stm32: Add low-level SDIO interface for cyw43 driver. 6 years ago
sdram.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
sdram.h stm32/sdram: Integrate SDRAM driver into rest of code. 6 years ago
servo.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
servo.h stm32: Change header include guards from STMHAL to STM32 to match dir. 7 years ago
softtimer.c stm32/softtimer: Initialise pairing-heap node before pushing to heap. 5 years ago
softtimer.h stm32/softtimer: Change linear linked list to a pairing heap. 5 years ago
spi.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
spi.h stm32/spi: Add implementation of low-level SPI protocol. 6 years ago
spibdev.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
stm32_it.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
stm32_it.h stm32: Change header include guards from STMHAL to STM32 to match dir. 7 years ago
storage.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
storage.h stm32/storage: Change storage_read/write_blocks to return int type. 5 years ago
system_stm32.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
systick.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
systick.h stm32: Refactor bluetooth stack/hci/driver bindings. 5 years ago
timer.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
timer.h stm32: Change header include guards from STMHAL to STM32 to match dir. 7 years ago
uart.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
uart.h stm32: Update components to work with new H7xx HAL. 5 years ago
usb.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
usb.h all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
usbd_cdc_interface.c all: Remove spaces inside and around parenthesis. 5 years ago
usbd_cdc_interface.h stm32/usbd_cdc_interface: Add CTS flow control option for USB VCP. 5 years ago
usbd_conf.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
usbd_conf.h stm32/usb: Add support for VCP+MSC+HID mode, incl 2xVCP and 3xVCP. 5 years ago
usbd_desc.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
usbd_desc.h stm32: Change header include guards from STMHAL to STM32 to match dir. 7 years ago
usbd_hid_interface.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
usbd_hid_interface.h stm32/usbd_hid_interface: Rewrite USB HID interface code. 5 years ago
usbd_msc_interface.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
usbd_msc_interface.h stm32/usb: Add "msc" kw-arg to pyb.usb_mode to select MSC logical units. 5 years ago
usrsw.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
usrsw.h stm32: Change header include guards from STMHAL to STM32 to match dir. 7 years ago
wdt.c all: Reformat C and Python source code with tools/codeformat.py. 5 years ago
wdt.h stm32: Change header include guards from STMHAL to STM32 to match dir. 7 years ago

README.md

MicroPython port to STM32 MCUs

This directory contains the port of MicroPython to ST's line of STM32 microcontrollers. Supported MCU series are: STM32F0, STM32F4, STM32F7 and STM32L4. Parts of the code here utilise the STM32Cube HAL library.

The officially supported boards are the line of pyboards: PYBv1.0 and PYBv1.1 (both with STM32F405), and PYBLITEv1.0 (with STM32F411). See micropython.org/pyboard for further details.

Other boards that are supported include ST Discovery and Nucleo boards. See the boards/ subdirectory, which contains the configuration files used to build each individual board.

The STM32H7 series has preliminary support: there is a working REPL via USB and UART, as well as very basic peripheral support, but some things do not work and none of the advanced features of the STM32H7 are yet supported, such as the clock tree. At this point the STM32H7 should be considered as a fast version of the STM32F7.

Build instructions

Before building the firmware for a given board the MicroPython cross-compiler must be built; it will be used to pre-compile some of the built-in scripts to bytecode. The cross-compiler is built and run on the host machine, using:

$ make -C mpy-cross

This command should be executed from the root directory of this repository. All other commands below should be executed from the ports/stm32/ directory.

An ARM compiler is required for the build, along with the associated binary utilities. The default compiler is arm-none-eabi-gcc, which is available for Arch Linux via the package arm-none-eabi-gcc, for Ubuntu via instructions here, or see here for the main GCC ARM Embedded page. The compiler can be changed using the CROSS_COMPILE variable when invoking make.

First the submodules must be obtained using:

$ make submodules

Then to build for a given board, run:

$ make BOARD=PYBV11

The default board is PYBV10 but any of the names of the subdirectories in the boards/ directory can be passed as the argument to BOARD=. The above command should produce binary images in the build-PYBV11/ subdirectory (or the equivalent directory for the board specified).

You must then get your board/microcontroller into DFU mode. On the pyboard connect the 3V3 pin to the P1/DFU pin with a wire (they are next to each other on the bottom left of the board, second row from the bottom) and then reset (by pressing the RST button) or power on the board. Then flash the firmware using the command:

$ make BOARD=PYBV11 deploy

This will use the included tools/pydfu.py script. You can use instead the dfu-util program (available here) by passing USE_PYDFU=0:

$ make BOARD=PYBV11 USE_PYDFU=0 deploy

If flashing the firmware does not work it may be because you don't have the correct permissions. Try then:

$ sudo make BOARD=PYBV11 deploy

Or using dfu-util directly:

$ sudo dfu-util -a 0 -d 0483:df11 -D build-PYBV11/firmware.dfu

ST Discovery or Nucleo boards have a builtin programmer called ST-LINK. With these boards and using Linux or OS X, you have the option to upload the stm32 firmware using the st-flash utility from the stlink project. To do so, connect the board with a mini USB cable to its ST-LINK USB port and then use the make target deploy-stlink. For example, if you have the STM32F4DISCOVERY board, you can run:

$ make BOARD=STM32F4DISC deploy-stlink

The st-flash program should detect the USB connection to the board automatically. If not, run lsusb to determine its USB bus and device number and set the STLINK_DEVICE environment variable accordingly, using the format <USB_BUS>:<USB_ADDR>. Example:

$ lsusb
[...]
Bus 002 Device 035: ID 0483:3748 STMicroelectronics ST-LINK/V2
$ export STLINK_DEVICE="002:0035"
$ make BOARD=STM32F4DISC deploy-stlink

Flashing the Firmware with OpenOCD

Another option to deploy the firmware on ST Discovery or Nucleo boards with a ST-LINK interface uses OpenOCD. Connect the board with a mini USB cable to its ST-LINK USB port and then use the make target deploy-openocd. For example, if you have the STM32F4DISCOVERY board:

$ make BOARD=STM32F4DISC deploy-openocd

The openocd program, which writes the firmware to the target board's flash, is configured via the file ports/stm32/boards/openocd_stm32f4.cfg. This configuration should work for all boards based on a STM32F4xx MCU with a ST-LINKv2 interface. You can override the path to this configuration by setting OPENOCD_CONFIG in your Makefile or on the command line.

Accessing the board

Once built and deployed, access the MicroPython REPL (the Python prompt) via USB serial or UART, depending on the board. For the pyboard you can try:

$ picocom /dev/ttyACM0