d1f120b142
It's enabled by default to retain the existing behaviour. A board can disable this option if it manages mounting the filesystem itself, for example in frozen code. Signed-off-by: Damien George <damien@micropython.org>
370 lines
12 KiB
C
370 lines
12 KiB
C
/*
|
|
* This file is part of the MicroPython project, http://micropython.org/
|
|
*
|
|
* The MIT License (MIT)
|
|
*
|
|
* Copyright (c) 2018 Damien P. George
|
|
*
|
|
* Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
* of this software and associated documentation files (the "Software"), to deal
|
|
* in the Software without restriction, including without limitation the rights
|
|
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
* copies of the Software, and to permit persons to whom the Software is
|
|
* furnished to do so, subject to the following conditions:
|
|
*
|
|
* The above copyright notice and this permission notice shall be included in
|
|
* all copies or substantial portions of the Software.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
|
* THE SOFTWARE.
|
|
*/
|
|
|
|
// Common settings and defaults for board configuration.
|
|
// The defaults here should be overridden in mpconfigboard.h.
|
|
|
|
#include STM32_HAL_H
|
|
|
|
/*****************************************************************************/
|
|
// Feature settings with defaults
|
|
|
|
// Whether to include the stm module, with peripheral register constants
|
|
#ifndef MICROPY_PY_STM
|
|
#define MICROPY_PY_STM (1)
|
|
#endif
|
|
|
|
// Whether to include legacy functions and classes in the pyb module
|
|
#ifndef MICROPY_PY_PYB_LEGACY
|
|
#define MICROPY_PY_PYB_LEGACY (1)
|
|
#endif
|
|
|
|
// Whether to enable storage on the internal flash of the MCU
|
|
#ifndef MICROPY_HW_ENABLE_INTERNAL_FLASH_STORAGE
|
|
#define MICROPY_HW_ENABLE_INTERNAL_FLASH_STORAGE (1)
|
|
#endif
|
|
|
|
// Whether to enable the RTC, exposed as pyb.RTC
|
|
#ifndef MICROPY_HW_ENABLE_RTC
|
|
#define MICROPY_HW_ENABLE_RTC (0)
|
|
#endif
|
|
|
|
// Whether to enable the hardware RNG peripheral, exposed as pyb.rng()
|
|
#ifndef MICROPY_HW_ENABLE_RNG
|
|
#define MICROPY_HW_ENABLE_RNG (0)
|
|
#endif
|
|
|
|
// Whether to enable the ADC peripheral, exposed as pyb.ADC and pyb.ADCAll
|
|
#ifndef MICROPY_HW_ENABLE_ADC
|
|
#define MICROPY_HW_ENABLE_ADC (1)
|
|
#endif
|
|
|
|
// Whether to enable the DAC peripheral, exposed as pyb.DAC
|
|
#ifndef MICROPY_HW_ENABLE_DAC
|
|
#define MICROPY_HW_ENABLE_DAC (0)
|
|
#endif
|
|
|
|
// Whether to enable the DCMI peripheral
|
|
#ifndef MICROPY_HW_ENABLE_DCMI
|
|
#define MICROPY_HW_ENABLE_DCMI (0)
|
|
#endif
|
|
|
|
// Whether to enable USB support
|
|
#ifndef MICROPY_HW_ENABLE_USB
|
|
#define MICROPY_HW_ENABLE_USB (0)
|
|
#endif
|
|
|
|
// Whether to enable the PA0-PA3 servo driver, exposed as pyb.Servo
|
|
#ifndef MICROPY_HW_ENABLE_SERVO
|
|
#define MICROPY_HW_ENABLE_SERVO (0)
|
|
#endif
|
|
|
|
// Whether to enable a USR switch, exposed as pyb.Switch
|
|
#ifndef MICROPY_HW_HAS_SWITCH
|
|
#define MICROPY_HW_HAS_SWITCH (0)
|
|
#endif
|
|
|
|
// Whether to expose internal flash storage as pyb.Flash
|
|
#ifndef MICROPY_HW_HAS_FLASH
|
|
#define MICROPY_HW_HAS_FLASH (0)
|
|
#endif
|
|
|
|
// Whether to enable the SD card interface, exposed as pyb.SDCard
|
|
#ifndef MICROPY_HW_ENABLE_SDCARD
|
|
#define MICROPY_HW_ENABLE_SDCARD (0)
|
|
#endif
|
|
|
|
// Whether to enable the MMC interface, exposed as pyb.MMCard
|
|
#ifndef MICROPY_HW_ENABLE_MMCARD
|
|
#define MICROPY_HW_ENABLE_MMCARD (0)
|
|
#endif
|
|
|
|
// SD/MMC interface bus width (defaults to 4 bits)
|
|
#ifndef MICROPY_HW_SDMMC_BUS_WIDTH
|
|
#define MICROPY_HW_SDMMC_BUS_WIDTH (4)
|
|
#endif
|
|
|
|
// Whether to automatically mount (and boot from) the SD card if it's present
|
|
#ifndef MICROPY_HW_SDCARD_MOUNT_AT_BOOT
|
|
#define MICROPY_HW_SDCARD_MOUNT_AT_BOOT (MICROPY_HW_ENABLE_SDCARD)
|
|
#endif
|
|
|
|
// Whether to enable the MMA7660 driver, exposed as pyb.Accel
|
|
#ifndef MICROPY_HW_HAS_MMA7660
|
|
#define MICROPY_HW_HAS_MMA7660 (0)
|
|
#endif
|
|
|
|
// Whether to enable the LCD32MK driver, exposed as pyb.LCD
|
|
#ifndef MICROPY_HW_HAS_LCD
|
|
#define MICROPY_HW_HAS_LCD (0)
|
|
#endif
|
|
|
|
// Whether to automatically mount (and boot from) the flash filesystem
|
|
#ifndef MICROPY_HW_FLASH_MOUNT_AT_BOOT
|
|
#define MICROPY_HW_FLASH_MOUNT_AT_BOOT (MICROPY_HW_ENABLE_STORAGE)
|
|
#endif
|
|
|
|
// The volume label used when creating the flash filesystem
|
|
#ifndef MICROPY_HW_FLASH_FS_LABEL
|
|
#define MICROPY_HW_FLASH_FS_LABEL "pybflash"
|
|
#endif
|
|
|
|
// Function to determine if the given can_id is reserved for system use or not.
|
|
#ifndef MICROPY_HW_CAN_IS_RESERVED
|
|
#define MICROPY_HW_CAN_IS_RESERVED(can_id) (false)
|
|
#endif
|
|
|
|
// Function to determine if the given i2c_id is reserved for system use or not.
|
|
#ifndef MICROPY_HW_I2C_IS_RESERVED
|
|
#define MICROPY_HW_I2C_IS_RESERVED(i2c_id) (false)
|
|
#endif
|
|
|
|
// Function to determine if the given spi_id is reserved for system use or not.
|
|
#ifndef MICROPY_HW_SPI_IS_RESERVED
|
|
#define MICROPY_HW_SPI_IS_RESERVED(spi_id) (false)
|
|
#endif
|
|
|
|
// Function to determine if the given tim_id is reserved for system use or not.
|
|
#ifndef MICROPY_HW_TIM_IS_RESERVED
|
|
#define MICROPY_HW_TIM_IS_RESERVED(tim_id) (false)
|
|
#endif
|
|
|
|
// Function to determine if the given uart_id is reserved for system use or not.
|
|
#ifndef MICROPY_HW_UART_IS_RESERVED
|
|
#define MICROPY_HW_UART_IS_RESERVED(uart_id) (false)
|
|
#endif
|
|
|
|
/*****************************************************************************/
|
|
// General configuration
|
|
|
|
// Heap start / end definitions
|
|
#ifndef MICROPY_HEAP_START
|
|
#define MICROPY_HEAP_START &_heap_start
|
|
#endif
|
|
#ifndef MICROPY_HEAP_END
|
|
#define MICROPY_HEAP_END &_heap_end
|
|
#endif
|
|
|
|
// Configuration for STM32F0 series
|
|
#if defined(STM32F0)
|
|
|
|
#define MP_HAL_UNIQUE_ID_ADDRESS (0x1ffff7ac)
|
|
#define PYB_EXTI_NUM_VECTORS (23)
|
|
#define MICROPY_HW_MAX_I2C (2)
|
|
#define MICROPY_HW_MAX_TIMER (17)
|
|
#define MICROPY_HW_MAX_UART (8)
|
|
|
|
// Configuration for STM32F4 series
|
|
#elif defined(STM32F4)
|
|
|
|
#define MP_HAL_UNIQUE_ID_ADDRESS (0x1fff7a10)
|
|
#define PYB_EXTI_NUM_VECTORS (23)
|
|
#define MICROPY_HW_MAX_I2C (3)
|
|
#define MICROPY_HW_MAX_TIMER (14)
|
|
#if defined(UART10)
|
|
#define MICROPY_HW_MAX_UART (10)
|
|
#elif defined(UART9)
|
|
#define MICROPY_HW_MAX_UART (9)
|
|
#elif defined(UART8)
|
|
#define MICROPY_HW_MAX_UART (8)
|
|
#elif defined(UART7)
|
|
#define MICROPY_HW_MAX_UART (7)
|
|
#else
|
|
#define MICROPY_HW_MAX_UART (6)
|
|
#endif
|
|
|
|
// Configuration for STM32F7 series
|
|
#elif defined(STM32F7)
|
|
|
|
#if defined(STM32F722xx) || defined(STM32F723xx) || defined(STM32F732xx) || defined(STM32F733xx)
|
|
#define MP_HAL_UNIQUE_ID_ADDRESS (0x1ff07a10)
|
|
#else
|
|
#define MP_HAL_UNIQUE_ID_ADDRESS (0x1ff0f420)
|
|
#endif
|
|
|
|
#define PYB_EXTI_NUM_VECTORS (24)
|
|
#define MICROPY_HW_MAX_I2C (4)
|
|
#define MICROPY_HW_MAX_TIMER (17)
|
|
#define MICROPY_HW_MAX_UART (8)
|
|
|
|
// Configuration for STM32H7 series
|
|
#elif defined(STM32H7)
|
|
|
|
#define MP_HAL_UNIQUE_ID_ADDRESS (0x1ff1e800)
|
|
#define PYB_EXTI_NUM_VECTORS (24)
|
|
#define MICROPY_HW_MAX_I2C (4)
|
|
#define MICROPY_HW_MAX_TIMER (17)
|
|
#define MICROPY_HW_MAX_UART (8)
|
|
|
|
// Configuration for STM32L0 series
|
|
#elif defined(STM32L0)
|
|
|
|
#define MP_HAL_UNIQUE_ID_ADDRESS (0x1FF80050)
|
|
#define PYB_EXTI_NUM_VECTORS (30) // TODO (22 configurable, 7 direct)
|
|
#define MICROPY_HW_MAX_I2C (3)
|
|
#define MICROPY_HW_MAX_TIMER (22)
|
|
#define MICROPY_HW_MAX_UART (5)
|
|
|
|
// Configuration for STM32L4 series
|
|
#elif defined(STM32L4)
|
|
|
|
#define MP_HAL_UNIQUE_ID_ADDRESS (0x1fff7590)
|
|
#define PYB_EXTI_NUM_VECTORS (23)
|
|
#define MICROPY_HW_MAX_I2C (4)
|
|
#define MICROPY_HW_MAX_TIMER (17)
|
|
#define MICROPY_HW_MAX_UART (6)
|
|
|
|
// Configuration for STM32WB series
|
|
#elif defined(STM32WB)
|
|
|
|
#define MP_HAL_UNIQUE_ID_ADDRESS (UID_BASE)
|
|
#define PYB_EXTI_NUM_VECTORS (20)
|
|
#define MICROPY_HW_MAX_I2C (3)
|
|
#define MICROPY_HW_MAX_TIMER (17)
|
|
#define MICROPY_HW_MAX_UART (1)
|
|
|
|
#ifndef MICROPY_HW_STM32WB_FLASH_SYNCRONISATION
|
|
#define MICROPY_HW_STM32WB_FLASH_SYNCRONISATION (1)
|
|
#endif
|
|
|
|
#else
|
|
#error Unsupported MCU series
|
|
#endif
|
|
|
|
#if MICROPY_HW_CLK_USE_HSI
|
|
// Use HSI as clock source
|
|
#define MICROPY_HW_CLK_VALUE (HSI_VALUE)
|
|
#define MICROPY_HW_RCC_OSCILLATOR_TYPE (RCC_OSCILLATORTYPE_HSI)
|
|
#define MICROPY_HW_RCC_PLL_SRC (RCC_PLLSOURCE_HSI)
|
|
#define MICROPY_HW_RCC_CR_HSxON (RCC_CR_HSION)
|
|
#define MICROPY_HW_RCC_HSI_STATE (RCC_HSI_ON)
|
|
#define MICROPY_HW_RCC_FLAG_HSxRDY (RCC_FLAG_HSIRDY)
|
|
#define MICROPY_HW_RCC_HSE_STATE (RCC_HSE_OFF)
|
|
#else
|
|
// Use HSE as a clock source (bypass or oscillator)
|
|
#define MICROPY_HW_CLK_VALUE (HSE_VALUE)
|
|
#define MICROPY_HW_RCC_OSCILLATOR_TYPE (RCC_OSCILLATORTYPE_HSE)
|
|
#define MICROPY_HW_RCC_PLL_SRC (RCC_PLLSOURCE_HSE)
|
|
#define MICROPY_HW_RCC_CR_HSxON (RCC_CR_HSEON)
|
|
#define MICROPY_HW_RCC_HSI_STATE (RCC_HSI_OFF)
|
|
#define MICROPY_HW_RCC_FLAG_HSxRDY (RCC_FLAG_HSERDY)
|
|
#if MICROPY_HW_CLK_USE_BYPASS
|
|
#define MICROPY_HW_RCC_HSE_STATE (RCC_HSE_BYPASS)
|
|
#else
|
|
#define MICROPY_HW_RCC_HSE_STATE (RCC_HSE_ON)
|
|
#endif
|
|
#endif
|
|
|
|
// If disabled then try normal (non-bypass) LSE first, with fallback to LSI.
|
|
// If enabled first try LSE in bypass mode. If that fails to start, try non-bypass mode, with fallback to LSI.
|
|
#ifndef MICROPY_HW_RTC_USE_BYPASS
|
|
#define MICROPY_HW_RTC_USE_BYPASS (0)
|
|
#endif
|
|
|
|
#if MICROPY_HW_ENABLE_INTERNAL_FLASH_STORAGE
|
|
// Provide block device macros if internal flash storage is enabled
|
|
#define MICROPY_HW_BDEV_IOCTL flash_bdev_ioctl
|
|
#define MICROPY_HW_BDEV_READBLOCK flash_bdev_readblock
|
|
#define MICROPY_HW_BDEV_WRITEBLOCK flash_bdev_writeblock
|
|
#endif
|
|
|
|
// Whether to enable caching for external SPI flash, to allow block writes that are
|
|
// smaller than the native page-erase size of the SPI flash, eg when FAT FS is used.
|
|
// Enabling this enables spi_bdev_readblocks() and spi_bdev_writeblocks() functions,
|
|
// and requires a valid mp_spiflash_config_t.cache pointer.
|
|
#ifndef MICROPY_HW_SPIFLASH_ENABLE_CACHE
|
|
#define MICROPY_HW_SPIFLASH_ENABLE_CACHE (0)
|
|
#endif
|
|
|
|
// Enable the storage sub-system if a block device is defined
|
|
#if defined(MICROPY_HW_BDEV_IOCTL)
|
|
#define MICROPY_HW_ENABLE_STORAGE (1)
|
|
#else
|
|
#define MICROPY_HW_ENABLE_STORAGE (0)
|
|
#endif
|
|
|
|
// Enable hardware I2C if there are any peripherals defined
|
|
#if defined(MICROPY_HW_I2C1_SCL) || defined(MICROPY_HW_I2C2_SCL) \
|
|
|| defined(MICROPY_HW_I2C3_SCL) || defined(MICROPY_HW_I2C4_SCL)
|
|
#define MICROPY_HW_ENABLE_HW_I2C (1)
|
|
#else
|
|
#define MICROPY_HW_ENABLE_HW_I2C (0)
|
|
#endif
|
|
|
|
// Enable CAN if there are any peripherals defined
|
|
#if defined(MICROPY_HW_CAN1_TX) || defined(MICROPY_HW_CAN2_TX) || defined(MICROPY_HW_CAN3_TX)
|
|
#define MICROPY_HW_ENABLE_CAN (1)
|
|
#if defined(STM32H7)
|
|
#define MICROPY_HW_ENABLE_FDCAN (1) // define for MCUs with FDCAN
|
|
#endif
|
|
#else
|
|
#define MICROPY_HW_ENABLE_CAN (0)
|
|
#define MICROPY_HW_MAX_CAN (0)
|
|
#endif
|
|
#if defined(MICROPY_HW_CAN3_TX)
|
|
#define MICROPY_HW_MAX_CAN (3)
|
|
#elif defined(MICROPY_HW_CAN2_TX)
|
|
#define MICROPY_HW_MAX_CAN (2)
|
|
#elif defined(MICROPY_HW_CAN1_TX)
|
|
#define MICROPY_HW_MAX_CAN (1)
|
|
#endif
|
|
|
|
// Whether the USB peripheral is device-only, or multiple OTG
|
|
#if defined(STM32L0) || defined(STM32L432xx) || defined(STM32WB)
|
|
#define MICROPY_HW_USB_IS_MULTI_OTG (0)
|
|
#else
|
|
#define MICROPY_HW_USB_IS_MULTI_OTG (1)
|
|
#endif
|
|
|
|
// Configure maximum number of CDC VCP interfaces, and whether MSC/HID are supported
|
|
#ifndef MICROPY_HW_USB_CDC_NUM
|
|
#define MICROPY_HW_USB_CDC_NUM (1)
|
|
#endif
|
|
#ifndef MICROPY_HW_USB_MSC
|
|
#define MICROPY_HW_USB_MSC (MICROPY_HW_ENABLE_USB)
|
|
#endif
|
|
#ifndef MICROPY_HW_USB_HID
|
|
#define MICROPY_HW_USB_HID (MICROPY_HW_ENABLE_USB)
|
|
#endif
|
|
|
|
// Pin definition header file
|
|
#define MICROPY_PIN_DEFS_PORT_H "pin_defs_stm32.h"
|
|
|
|
// D-cache clean/invalidate helpers
|
|
#if __DCACHE_PRESENT == 1
|
|
#define MP_HAL_CLEANINVALIDATE_DCACHE(addr, size) \
|
|
(SCB_CleanInvalidateDCache_by_Addr((uint32_t *)((uint32_t)addr & ~0x1f), \
|
|
((uint32_t)((uint8_t *)addr + size + 0x1f) & ~0x1f) - ((uint32_t)addr & ~0x1f)))
|
|
#define MP_HAL_CLEAN_DCACHE(addr, size) \
|
|
(SCB_CleanDCache_by_Addr((uint32_t *)((uint32_t)addr & ~0x1f), \
|
|
((uint32_t)((uint8_t *)addr + size + 0x1f) & ~0x1f) - ((uint32_t)addr & ~0x1f)))
|
|
#else
|
|
#define MP_HAL_CLEANINVALIDATE_DCACHE(addr, size)
|
|
#define MP_HAL_CLEAN_DCACHE(addr, size)
|
|
#endif
|
|
|
|
#define MICROPY_HW_USES_BOOTLOADER (MICROPY_HW_VTOR != 0x08000000)
|