Browse Source
Quail (https://www.mikroe.com/quail, PID: MIKROE-1793) is based on an STM32F427VI CPU, featuring 2048 kB of Flash memory and 192 kB of RAM. An on-board Cypress S25FL164K adds 8 MB of SPI Flash. Quail has 4 mikroBUS(TM) sockets for Mikroe click(TM) board connectivity, along with 24 screw terminals for connecting additional electronics and two USB ports (one for programming, the other for external mass storage). 4 UARTs, 2 SPIs and 1 I2C bus are available for communication. Signed-off-by: Lorenzo Cappelletti <lorenzo.cappelletti@gmail.com>pull/7934/head
Lorenzo Cappelletti
3 years ago
committed by
Damien George
Damien George
9 changed files with 345 additions and 1 deletions
@ -0,0 +1,28 @@ |
|||
#include "py/obj.h" |
|||
#include "storage.h" |
|||
#include "spi.h" |
|||
|
|||
#if !MICROPY_HW_ENABLE_INTERNAL_FLASH_STORAGE |
|||
|
|||
STATIC const spi_proto_cfg_t spi_bus = { |
|||
.spi = &spi_obj[2], // SPI3 hardware peripheral
|
|||
.baudrate = 25000000, |
|||
.polarity = 0, |
|||
.phase = 0, |
|||
.bits = 8, |
|||
.firstbit = SPI_FIRSTBIT_MSB, |
|||
}; |
|||
|
|||
STATIC mp_spiflash_cache_t spi_bdev_cache; |
|||
|
|||
const mp_spiflash_config_t spiflash_config = { |
|||
.bus_kind = MP_SPIFLASH_BUS_SPI, |
|||
.bus.u_spi.cs = MICROPY_HW_SPIFLASH_CS, |
|||
.bus.u_spi.data = (void *)&spi_bus, |
|||
.bus.u_spi.proto = &spi_proto, |
|||
.cache = &spi_bdev_cache, |
|||
}; |
|||
|
|||
spi_bdev_t spi_bdev; |
|||
|
|||
#endif |
|||
@ -0,0 +1,18 @@ |
|||
{ |
|||
"deploy": [ |
|||
"../MIKROE_QUAIL/deploy.md" |
|||
], |
|||
"docs": "", |
|||
"features": [ |
|||
"mikroBUS" |
|||
], |
|||
"id": "MIKROE-QUAIL", |
|||
"images": [ |
|||
"quail_top.jpg" |
|||
], |
|||
"mcu": "stm32f4", |
|||
"product": "MikroE Quail", |
|||
"thumbnail": "", |
|||
"url": "https://www.mikroe.com/quail", |
|||
"vendor": "MikroElektronika" |
|||
} |
|||
@ -0,0 +1,13 @@ |
|||
### Quail via DFU |
|||
|
|||
Quail can be programmed via USB with the ST DFU bootloader, using |
|||
e.g. [dfu-util](http://dfu-util.sourceforge.net/) or |
|||
[pydfu.py](https://github.com/micropython/micropython/blob/master/tools/pydfu.py). |
|||
|
|||
To enter the bootloader press and release the Reset button while holding the |
|||
Boot button. Alternatively, you can use `machine.bootloader()` from the |
|||
MicroPython REPL. |
|||
|
|||
```bash |
|||
dfu-util --alt 0 -D firmware.dfu |
|||
``` |
|||
@ -0,0 +1,109 @@ |
|||
#define MICROPY_HW_BOARD_NAME "MikroE Quail" |
|||
#define MICROPY_HW_MCU_NAME "STM32F427VI" |
|||
|
|||
// 1 = use STM32 internal flash (1 MByte)
|
|||
// 0 = use onboard external SPI flash (8 MByte)
|
|||
#define MICROPY_HW_ENABLE_INTERNAL_FLASH_STORAGE (0) |
|||
|
|||
#define MICROPY_HW_ENABLE_RNG (1) |
|||
#define MICROPY_HW_ENABLE_RTC (1) |
|||
#define MICROPY_HW_ENABLE_USB (1) |
|||
#define MICROPY_HW_HAS_FLASH (1) |
|||
|
|||
// HSE is 12MHz
|
|||
#define MICROPY_HW_CLK_PLLM (6) |
|||
#define MICROPY_HW_CLK_PLLN (336) |
|||
#define MICROPY_HW_CLK_PLLP (RCC_PLLP_DIV4) |
|||
#define MICROPY_HW_CLK_PLLQ (14) |
|||
#define MICROPY_HW_CLK_LAST_FREQ (1) |
|||
|
|||
// The board has no crystal for the RTC
|
|||
#define MICROPY_HW_RTC_USE_LSE (0) |
|||
#define MICROPY_HW_RTC_USE_US (0) |
|||
#define MICROPY_HW_RTC_USE_CALOUT (0) // turn on/off PC13 512Hz output
|
|||
|
|||
// UART config
|
|||
// mikroBUS slot 1
|
|||
#define MICROPY_HW_UART3_NAME "SLOT1" |
|||
#define MICROPY_HW_UART3_TX (pin_D8) |
|||
#define MICROPY_HW_UART3_RX (pin_D9) |
|||
// mikroBUS slot 2
|
|||
#define MICROPY_HW_UART2_NAME "SLOT2" |
|||
#define MICROPY_HW_UART2_TX (pin_D5) |
|||
#define MICROPY_HW_UART2_RX (pin_D6) |
|||
// mikroBUS slot 3
|
|||
#define MICROPY_HW_UART6_NAME "SLOT3" |
|||
#define MICROPY_HW_UART6_TX (pin_C6) |
|||
#define MICROPY_HW_UART6_RX (pin_C7) |
|||
// mikroBUS slot 4
|
|||
#define MICROPY_HW_UART1_NAME "SLOT4" |
|||
#define MICROPY_HW_UART1_TX (pin_A9) |
|||
#define MICROPY_HW_UART1_RX (pin_A10) |
|||
|
|||
// I2C buses
|
|||
// mikroBUS slot 1, 2, 3, 4, and header
|
|||
#define MICROPY_HW_I2C1_NAME "SLOT1234H" |
|||
#define MICROPY_HW_I2C1_SCL (pin_B6) |
|||
#define MICROPY_HW_I2C1_SDA (pin_B7) |
|||
|
|||
// SPI buses
|
|||
// mikroBUS slot 1, 2, and header
|
|||
#define MICROPY_HW_SPI1_NAME "SLOT12H" |
|||
#define MICROPY_HW_SPI1_SCK (pin_B3) |
|||
#define MICROPY_HW_SPI1_MISO (pin_B4) |
|||
#define MICROPY_HW_SPI1_MOSI (pin_B5) |
|||
// mikroBUS slot 3, 4, and FLASH
|
|||
#define MICROPY_HW_SPI3_NAME "SLOT34F" |
|||
#define MICROPY_HW_SPI3_SCK (pin_C10) |
|||
#define MICROPY_HW_SPI3_MISO (pin_C11) |
|||
#define MICROPY_HW_SPI3_MOSI (pin_C12) |
|||
|
|||
// LEDs
|
|||
#define MICROPY_HW_LED1 (pin_E15) // orange
|
|||
#define MICROPY_HW_LED2 (pin_E10) // green
|
|||
#define MICROPY_HW_LED3 (pin_C3) // red
|
|||
#define MICROPY_HW_LED_ON(pin) (mp_hal_pin_high(pin)) |
|||
#define MICROPY_HW_LED_OFF(pin) (mp_hal_pin_low(pin)) |
|||
|
|||
// USB config
|
|||
#define MICROPY_HW_USB_FS (1) |
|||
|
|||
// External SPI Flash config (Cypress S25FL164K)
|
|||
#if !MICROPY_HW_ENABLE_INTERNAL_FLASH_STORAGE |
|||
|
|||
#define MICROPY_HW_SPIFLASH_SIZE_BITS (64 * 1024 * 1024) // 64 Mbit (8 MByte)
|
|||
|
|||
#define MICROPY_HW_SPIFLASH_CS (pin_A13) |
|||
#define MICROPY_HW_SPIFLASH_SCK (MICROPY_HW_SPI3_SCK) |
|||
#define MICROPY_HW_SPIFLASH_MISO (MICROPY_HW_SPI3_MISO) |
|||
#define MICROPY_HW_SPIFLASH_MOSI (MICROPY_HW_SPI3_MOSI) |
|||
|
|||
extern const struct _mp_spiflash_config_t spiflash_config; |
|||
extern struct _spi_bdev_t spi_bdev; |
|||
#define MICROPY_HW_SPIFLASH_ENABLE_CACHE (1) |
|||
#define MICROPY_HW_BDEV_IOCTL(op, arg) ( \ |
|||
(op) == BDEV_IOCTL_NUM_BLOCKS ? (MICROPY_HW_SPIFLASH_SIZE_BITS / 8 / FLASH_BLOCK_SIZE) : \ |
|||
(op) == BDEV_IOCTL_INIT ? spi_bdev_ioctl(&spi_bdev, (op), (uint32_t)&spiflash_config) : \ |
|||
spi_bdev_ioctl(&spi_bdev, (op), (arg)) \ |
|||
) |
|||
#define MICROPY_HW_BDEV_READBLOCKS(dest, bl, n) spi_bdev_readblocks(&spi_bdev, (dest), (bl), (n)) |
|||
#define MICROPY_HW_BDEV_WRITEBLOCKS(src, bl, n) spi_bdev_writeblocks(&spi_bdev, (src), (bl), (n)) |
|||
#define MICROPY_HW_BDEV_SPIFLASH_EXTENDED (&spi_bdev) // for extended block protocol
|
|||
|
|||
#endif // !MICROPY_HW_ENABLE_INTERNAL_FLASH_STORAGE
|
|||
|
|||
// Bootloader configuration (only needed if Mboot is used)
|
|||
#define MBOOT_I2C_PERIPH_ID 1 |
|||
#define MBOOT_I2C_SCL (pin_B6) |
|||
#define MBOOT_I2C_SDA (pin_B7) |
|||
#define MBOOT_I2C_ALTFUNC (4) |
|||
#define MBOOT_FSLOAD (1) |
|||
#define MBOOT_VFS_FAT (1) |
|||
|
|||
#define MBOOT_SPIFLASH_ADDR (0x80000000) |
|||
#define MBOOT_SPIFLASH_BYTE_SIZE (8 * 1024 * 1024) |
|||
#define MBOOT_SPIFLASH_LAYOUT "/0x80000000/512*8Kg" |
|||
#define MBOOT_SPIFLASH_ERASE_BLOCKS_PER_PAGE \ |
|||
(8 / 4) // 8k page, 4k erase block
|
|||
#define MBOOT_SPIFLASH_CONFIG (&spiflash_config) |
|||
#define MBOOT_SPIFLASH_SPIFLASH (&spi_bdev.spiflash) |
|||
@ -0,0 +1,10 @@ |
|||
MCU_SERIES = f4 |
|||
CMSIS_MCU = STM32F427xx |
|||
LD_FILES = boards/stm32f427xi.ld boards/common_ifs.ld |
|||
TEXT0_ADDR = 0x08000000 |
|||
TEXT1_ADDR = 0x08020000 |
|||
|
|||
# According to the datasheet, page 75, table 12, the alternate functions
|
|||
# of STM32F427xx and STM32F429xx are exactly the same.
|
|||
# See https://www.st.com/resource/en/datasheet/stm32f427vi.pdf.
|
|||
AF_FILE = boards/stm32f429_af.csv |
|||
|
Can't render this file because it has a wrong number of fields in line 3.
|
@ -0,0 +1,18 @@ |
|||
/* This file is part of the MicroPython project, http://micropython.org/
|
|||
* The MIT License (MIT) |
|||
* Copyright (c) 2021 Lorenzo Cappelletti |
|||
*/ |
|||
#ifndef MICROPY_INCLUDED_STM32F4XX_HAL_CONF_H |
|||
#define MICROPY_INCLUDED_STM32F4XX_HAL_CONF_H |
|||
|
|||
#include "boards/stm32f4xx_hal_conf_base.h" |
|||
|
|||
// Oscillator values in Hz
|
|||
#define HSE_VALUE (12000000) |
|||
#define EXTERNAL_CLOCK_VALUE (12288000) |
|||
|
|||
// Oscillator timeouts in ms
|
|||
#define HSE_STARTUP_TIMEOUT (100) |
|||
#define LSE_STARTUP_TIMEOUT (0) |
|||
|
|||
#endif // MICROPY_INCLUDED_STM32F4XX_HAL_CONF_H
|
|||
@ -0,0 +1,28 @@ |
|||
/* |
|||
GNU linker script for STM32F427xI |
|||
*/ |
|||
|
|||
/* Specify the memory areas */ |
|||
MEMORY |
|||
{ |
|||
FLASH (rx) : ORIGIN = 0x08000000, LENGTH = 2048K /* entire flash */ |
|||
FLASH_ISR (rx) : ORIGIN = 0x08000000, LENGTH = 16K /* sector 0, 16 KiB */ |
|||
FLASH_FS (rx) : ORIGIN = 0x08004000, LENGTH = 112K /* sectors 1-4: 3*16K+64K */ |
|||
FLASH_TEXT (rx) : ORIGIN = 0x08020000, LENGTH = 896K /* sectors 5-11 are 128K */ |
|||
RAM (xrw) : ORIGIN = 0x20000000, LENGTH = 192K |
|||
} |
|||
|
|||
/* produce a link error if there is not this amount of RAM for these sections */ |
|||
_minimum_stack_size = 2K; |
|||
_minimum_heap_size = 16K; |
|||
|
|||
/* Define the stack. The stack is full descending so begins just above last byte |
|||
of RAM. Note that EABI requires the stack to be 8-byte aligned for a call. */ |
|||
_estack = ORIGIN(RAM) + LENGTH(RAM) - _estack_reserve; |
|||
_sstack = _estack - 16K; /* tunable */ |
|||
|
|||
/* RAM extents for the garbage collector */ |
|||
_ram_start = ORIGIN(RAM); |
|||
_ram_end = ORIGIN(RAM) + LENGTH(RAM); |
|||
_heap_start = _ebss; /* heap starts just after statically allocated memory */ |
|||
_heap_end = _sstack; |
|||
Loading…
Reference in new issue