a43a8ac89e
Prior to this commit a port would need to manually configure the `MICROPY_EMIT_THUMB_ARMV7M` and `MICROPY_EMIT_INLINE_THUMB_FLOAT` options, based on whether the CPU is Thumb2 and whether it has hardware floating point support (eg Cortex-M0+ vs Cortex-M3 vs Cortex-M4). This is error prone, for example on stm32: - `NUCLEO_G0B1RE` (a Cortex-M0+ MCU) had both enabled even though neither options work on that target. - `NUCLEO_L152RE` (a Cortex-M3 MCU) had both enabled but this target does not support hardware floating point. The change here automatically enables the two options based on built-in compiler macros. This change is tested on the following boards: - alif ALIF_ENSEMBLE: both enabled - rp2 RPI_PICO: both disabled - rp2 RPI_PICO2: both enabled - samd SAMD21_XPLAINED_PRO: both disabled - samd SAMD_GENERIC_D51X20: both enabled - stm32 NUCLEO_G0B1RE: both disabled - stm32 NUCLEO_L152RE: only MICROPY_EMIT_THUMB_ARMV7M enabled - stm32 PYBD_SF6: both enabled - stm32 PYBV10: both enabled Signed-off-by: Damien George <damien@micropython.org> |
||
|---|---|---|
| .. | ||
| boards | ||
| lwip_inc | ||
| mbedtls | ||
| mcu | ||
| modules | ||
| tinyusb_port | ||
| alif_flash.c | ||
| alif.mk | ||
| cyw43_configport.h | ||
| cyw43_port_spi.c | ||
| fatfs_port.c | ||
| irq.h | ||
| machine_adc.c | ||
| machine_i2c_target.c | ||
| machine_i2c.c | ||
| machine_pin.c | ||
| machine_pwm.c | ||
| machine_rtc.c | ||
| machine_spi.c | ||
| machine_uart.c | ||
| main.c | ||
| Makefile | ||
| modalif.c | ||
| modalif.h | ||
| modmachine.c | ||
| modmachine.h | ||
| modtime.c | ||
| mpbthciport.c | ||
| mpbthciport.h | ||
| mpconfigport.h | ||
| mpconfigport.mk | ||
| mphalport.c | ||
| mphalport.h | ||
| mpmetalport.c | ||
| mpmetalport.h | ||
| mpnetworkport.c | ||
| mpnimbleport.c | ||
| mpnimbleport.h | ||
| mpremoteprocport.c | ||
| mpu.c | ||
| mpu.h | ||
| mpuart.c | ||
| mpuart.h | ||
| msc_disk.c | ||
| nosys_stubs.c | ||
| ospi_ext.c | ||
| ospi_ext.h | ||
| ospi_flash_settings.h | ||
| ospi_flash.c | ||
| ospi_flash.h | ||
| pendsv.c | ||
| pendsv.h | ||
| qstrdefsport.h | ||
| README.md | ||
| se_services.c | ||
| se_services.h | ||
| system_tick.c | ||
| system_tick.h | ||
| usbd.c | ||
| vfs_rom_ioctl.c | ||
MicroPython port to Alif Ensemble MCUs
This is a port of MicroPython to the Alif Ensemble series of microcontrollers.
Initial development of this Alif port was sponsored by OpenMV LLC.
Features currently supported:
- UART REPL.
- TinyUSB with CDC and MSC device support.
- Octal SPI flash with XIP mode.
- machine.Pin support with named pins.
- machine.UART, machine.SPI, machine.I2C, machine.RTC peripherals.
- WiFi and Bluetooth using cyw43.
- Dual core support of the HE and HP cores using Open-AMP.
- Low power modes.
The following more advanced features will follow later:
- Ethernet support.
- SDRAM support.
- Other machine modules.
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/alif/ directory.
An ARM compiler is required for the build, along with the associated binary
utilities. The recommended toolchain version to use with this port is
Arm GNU toolchain version 13.3.Rel1. The compiler can be changed using the
CROSS_COMPILE variable when invoking make.
Next, the board to build must be selected. The default board is ALIF_ENSEMBLE
but any of the names of the subdirectories in the boards/ directory is valid.
The board name must be passed as the argument to BOARD= when invoking make.
All boards require certain submodules to be obtained before they can be built.
The correct set of submodules can be initialised using (with ALIF_ENSEMBLE
as an example of the selected board):
make BOARD=ALIF_ENSEMBLE submodules
Then to build the board's firmware run:
make BOARD=ALIF_ENSEMBLE
The above command should produce binary images in the build-ALIF_ENSEMBLE/
subdirectory (or the equivalent directory for the board specified).
Update the SE Firmware
The SE firmware must be updated before flashing the main firmware to match the version used by MicroPython. This step only needs to be performed once. Connect the board to your PC via the SE UART USB port (on the Ensemble kit, this is labeled PRG USB), then run:
make update-system-package
Note: The board must be power-cycled after this step.
Deploy MicroPython
To flash the firmware, run:
make BOARD=ALIF_ENSEMBLE deploy