Debian Codegraph @

ports/stm32/boards/ARDUINO_PORTENTA_H7/mpconfigboard.h

raw
1 /*
2 * This file is part of the MicroPython project, http://micropython.org/
3 * The MIT License (MIT)
4 * Copyright (c) 2022 Arduino SA
5 */
6
7 #define MICROPY_HW_BOARD_NAME "Arduino Portenta H7"
8 #define MICROPY_HW_MCU_NAME "STM32H747"
9 #define MICROPY_HW_FLASH_FS_LABEL "Portenta H7"
10
11 // Network config
12 #define MICROPY_PY_NETWORK_HOSTNAME_DEFAULT "mpy-portenta-h7"
13
14 #define MICROPY_OBJ_REPR (MICROPY_OBJ_REPR_C)
15 typedef int mp_int_t; // must be pointer size
16 typedef unsigned int mp_uint_t; // must be pointer size
17
18 #define MICROPY_FATFS_EXFAT (1)
19 #define MICROPY_HW_ENABLE_RTC (1)
20 #define MICROPY_HW_ENABLE_RNG (1)
21 #define MICROPY_HW_ENABLE_ADC (1)
22 #define MICROPY_HW_ENABLE_DAC (1)
23 #define MICROPY_HW_ENABLE_USB (1)
24 #define MICROPY_HW_HAS_SWITCH (0)
25 #define MICROPY_HW_HAS_FLASH (1)
26 #define MICROPY_HW_ENABLE_SERVO (1)
27 #define MICROPY_HW_ENABLE_TIMER (1)
28 #define MICROPY_HW_ENABLE_SDCARD (1)
29 #define MICROPY_HW_ENABLE_MMCARD (0)
30 #define MICROPY_HW_ENTER_BOOTLOADER_VIA_RESET (0)
31
32 // ROMFS config
33 #define MICROPY_HW_ROMFS_ENABLE_EXTERNAL_QSPI (1)
34 #define MICROPY_HW_ROMFS_QSPI_SPIFLASH_OBJ (&spi_bdev.spiflash)
35 #define MICROPY_HW_ROMFS_ENABLE_PART0 (1)
36
37 // Flash storage config
38 #define MICROPY_HW_SPIFLASH_ENABLE_CACHE (1)
39 #define MICROPY_HW_SPIFLASH_SOFT_RESET (1)
40 #define MICROPY_HW_ENABLE_INTERNAL_FLASH_STORAGE (0)
41
42 #define MICROPY_BOARD_STARTUP PORTENTA_board_startup
43 void PORTENTA_board_startup(void);
44
45 #define MICROPY_BOARD_EARLY_INIT PORTENTA_board_early_init
46 void PORTENTA_board_early_init(void);
47
48 #define MICROPY_BOARD_ENTER_BOOTLOADER(nargs, args) PORTENTA_board_enter_bootloader()
49 void PORTENTA_board_enter_bootloader(void);
50
51 void PORTENTA_board_low_power(int mode);
52 #define MICROPY_BOARD_LEAVE_STOP PORTENTA_board_low_power(0);
53 #define MICROPY_BOARD_ENTER_STOP PORTENTA_board_low_power(1);
54 #define MICROPY_BOARD_ENTER_STANDBY PORTENTA_board_low_power(2);
55
56 void PORTENTA_board_osc_enable(int enable);
57 #define MICROPY_BOARD_PRE_STOP PORTENTA_board_osc_enable(0);
58 #define MICROPY_BOARD_POST_STOP PORTENTA_board_osc_enable(1);
59
60 // PLL1 400MHz/50MHz for SDMMC and FDCAN
61 // USB and RNG are clocked from the HSI48
62 #define MICROPY_HW_CLK_PLLM (5)
63 #define MICROPY_HW_CLK_PLLN (160)
64 #define MICROPY_HW_CLK_PLLP (2)
65 #define MICROPY_HW_CLK_PLLQ (16)
66 #define MICROPY_HW_CLK_PLLR (2)
67 #define MICROPY_HW_CLK_PLLVCI (RCC_PLL1VCIRANGE_2)
68 #define MICROPY_HW_CLK_PLLVCO (RCC_PLL1VCOWIDE)
69 #define MICROPY_HW_CLK_PLLFRAC (0)
70
71 // PLL2 200MHz for FMC and QSPI.
72 #define MICROPY_HW_CLK_PLL2M (5)
73 #define MICROPY_HW_CLK_PLL2N (80)
74 #define MICROPY_HW_CLK_PLL2P (2)
75 #define MICROPY_HW_CLK_PLL2Q (2)
76 #define MICROPY_HW_CLK_PLL2R (2)
77 #define MICROPY_HW_CLK_PLL2VCI (RCC_PLL2VCIRANGE_2)
78 #define MICROPY_HW_CLK_PLL2VCO (RCC_PLL2VCOWIDE)
79 #define MICROPY_HW_CLK_PLL2FRAC (0)
80
81 // PLL3 160MHz for ADC and SPI123
82 #define MICROPY_HW_CLK_PLL3M (5)
83 #define MICROPY_HW_CLK_PLL3N (160)
84 #define MICROPY_HW_CLK_PLL3P (2)
85 #define MICROPY_HW_CLK_PLL3Q (5)
86 #define MICROPY_HW_CLK_PLL3R (2)
87 #define MICROPY_HW_CLK_PLL3VCI (RCC_PLL3VCIRANGE_2)
88 #define MICROPY_HW_CLK_PLL3VCO (RCC_PLL3VCOWIDE)
89 #define MICROPY_HW_CLK_PLL3FRAC (0)
90
91 // HSE in BYPASS mode.
92 #define MICROPY_HW_CLK_USE_BYPASS (1)
93
94 // Bus clock divider values
95 #define MICROPY_HW_CLK_AHB_DIV (RCC_HCLK_DIV2)
96 #define MICROPY_HW_CLK_APB1_DIV (RCC_APB1_DIV2)
97 #define MICROPY_HW_CLK_APB2_DIV (RCC_APB2_DIV2)
98 #define MICROPY_HW_CLK_APB3_DIV (RCC_APB3_DIV2)
99 #define MICROPY_HW_CLK_APB4_DIV (RCC_APB4_DIV2)
100
101 // Peripheral clock sources
102 #define MICROPY_HW_RCC_HSI48_STATE (RCC_HSI48_ON)
103 #define MICROPY_HW_RCC_USB_CLKSOURCE (RCC_USBCLKSOURCE_HSI48)
104 #define MICROPY_HW_RCC_RTC_CLKSOURCE (RCC_RTCCLKSOURCE_LSI)
105 #define MICROPY_HW_RCC_FMC_CLKSOURCE (RCC_FMCCLKSOURCE_PLL2)
106 #define MICROPY_HW_RCC_RNG_CLKSOURCE (RCC_RNGCLKSOURCE_HSI48)
107 #define MICROPY_HW_RCC_ADC_CLKSOURCE (RCC_ADCCLKSOURCE_PLL3)
108 #define MICROPY_HW_RCC_SDMMC_CLKSOURCE (RCC_SDMMCCLKSOURCE_PLL)
109 #define MICROPY_HW_RCC_FDCAN_CLKSOURCE (RCC_FDCANCLKSOURCE_PLL)
110 #define MICROPY_HW_RCC_SPI123_CLKSOURCE (RCC_SPI123CLKSOURCE_PLL3)
111 #define MICROPY_HW_RCC_I2C123_CLKSOURCE (RCC_I2C123CLKSOURCE_D2PCLK1)
112 #define MICROPY_HW_RCC_QSPI_CLKSOURCE (RCC_QSPICLKSOURCE_PLL2)
113
114 // SMPS configuration
115 #define MICROPY_HW_PWR_SMPS_CONFIG (PWR_SMPS_1V8_SUPPLIES_LDO)
116
117 // Configure the analog switches for dual-pad pins.
118 #define MICROPY_HW_ANALOG_SWITCH_PA0 (SYSCFG_SWITCH_PA0_OPEN)
119 #define MICROPY_HW_ANALOG_SWITCH_PA1 (SYSCFG_SWITCH_PA1_OPEN)
120 #define MICROPY_HW_ANALOG_SWITCH_PC2 (SYSCFG_SWITCH_PC2_OPEN)
121 #define MICROPY_HW_ANALOG_SWITCH_PC3 (SYSCFG_SWITCH_PC3_OPEN)
122
123 // There is an external 32kHz oscillator
124 #define RTC_ASYNCH_PREDIV (0)
125 #define RTC_SYNCH_PREDIV (0x7fff)
126 #define MICROPY_HW_RTC_USE_BYPASS (1)
127 #define MICROPY_HW_RTC_USE_US (1)
128 #define MICROPY_HW_RTC_USE_CALOUT (1)
129
130 #if (MICROPY_HW_ENABLE_INTERNAL_FLASH_STORAGE == 0)
131 // QSPI flash #1 for storage
132 #define MICROPY_HW_QSPI_PRESCALER (2) // 100MHz
133 #define MICROPY_HW_QSPIFLASH_SIZE_BITS_LOG2 (27)
134 // Reserve 4MiB for romfs and 1MiB for WiFi/BT firmware.
135 #define MICROPY_HW_SPIFLASH_SIZE_BITS (88 * 1024 * 1024)
136 #define MICROPY_HW_QSPIFLASH_CS (pyb_pin_QSPI2_CS)
137 #define MICROPY_HW_QSPIFLASH_SCK (pyb_pin_QSPI2_CLK)
138 #define MICROPY_HW_QSPIFLASH_IO0 (pyb_pin_QSPI2_D0)
139 #define MICROPY_HW_QSPIFLASH_IO1 (pyb_pin_QSPI2_D1)
140 #define MICROPY_HW_QSPIFLASH_IO2 (pyb_pin_QSPI2_D2)
141 #define MICROPY_HW_QSPIFLASH_IO3 (pyb_pin_QSPI2_D3)
142
143 // SPI flash #1, block device config
144 extern const struct _mp_spiflash_config_t spiflash_config;
145 extern struct _spi_bdev_t spi_bdev;
146 #define MICROPY_HW_BDEV_SPIFLASH (&spi_bdev)
147 #define MICROPY_HW_BDEV_SPIFLASH_CONFIG (&spiflash_config)
148 #define MICROPY_HW_BDEV_SPIFLASH_SIZE_BYTES (MICROPY_HW_SPIFLASH_SIZE_BITS / 8)
149 #define MICROPY_HW_BDEV_SPIFLASH_EXTENDED (&spi_bdev)
150 #endif
151
152 // 4 wait states
153 #define MICROPY_HW_FLASH_LATENCY FLASH_LATENCY_2
154
155 // UART config
156 #define MICROPY_HW_UART1_TX (pin_A9)
157 #define MICROPY_HW_UART1_RX (pin_A10)
158 #define MICROPY_HW_UART_REPL PYB_UART_1
159 #define MICROPY_HW_UART_REPL_BAUD 115200
160
161 // UART config
162 #define MICROPY_HW_UART8_TX (pin_J8)
163 #define MICROPY_HW_UART8_RX (pin_J9)
164
165 // UART7 config
166 #define MICROPY_HW_UART7_TX (pyb_pin_BT_TXD)
167 #define MICROPY_HW_UART7_RX (pyb_pin_BT_RXD)
168 #define MICROPY_HW_UART7_RTS (pyb_pin_BT_RTS)
169 #define MICROPY_HW_UART7_CTS (pyb_pin_BT_CTS)
170
171 // I2C buses
172 #define MICROPY_HW_I2C1_SCL (pin_B6)
173 #define MICROPY_HW_I2C1_SDA (pin_B7)
174
175 #define MICROPY_HW_I2C3_SCL (pin_H7)
176 #define MICROPY_HW_I2C3_SDA (pin_H8)
177
178 // SPI buses
179 #define MICROPY_HW_SPI1_NSS (pin_C13)
180 #define MICROPY_HW_SPI1_SCK (pin_B3)
181 #define MICROPY_HW_SPI1_MISO (pin_B4)
182 #define MICROPY_HW_SPI1_MOSI (pin_D7)
183
184 #define MICROPY_HW_SPI2_NSS (pin_I0)
185 #define MICROPY_HW_SPI2_SCK (pin_I1)
186 #define MICROPY_HW_SPI2_MISO (pin_C2)
187 #define MICROPY_HW_SPI2_MOSI (pin_C3)
188
189 // USRSW is pulled low. Pressing the button makes the input go high.
190 #define MICROPY_HW_USRSW_PIN (pin_A0)
191 #define MICROPY_HW_USRSW_PULL (GPIO_NOPULL)
192 #define MICROPY_HW_USRSW_EXTI_MODE (GPIO_MODE_IT_RISING)
193 #define MICROPY_HW_USRSW_PRESSED (1)
194
195 // LEDs
196 #define MICROPY_HW_LED1 (pyb_pin_LED_RED) // red
197 #define MICROPY_HW_LED2 (pyb_pin_LED_GREEN) // green
198 #define MICROPY_HW_LED3 (pyb_pin_LED_BLUE) // yellow
199 #define MICROPY_HW_LED_ON(pin) (mp_hal_pin_low(pin))
200 #define MICROPY_HW_LED_OFF(pin) (mp_hal_pin_high(pin))
201
202 // WiFi SDMMC
203 #define MICROPY_HW_SDIO_SDMMC (1)
204 #define MICROPY_HW_SDIO_CK (pin_C12)
205 #define MICROPY_HW_SDIO_CMD (pin_D2)
206 #define MICROPY_HW_SDIO_D0 (pin_C8)
207 #define MICROPY_HW_SDIO_D1 (pin_C9)
208 #define MICROPY_HW_SDIO_D2 (pin_C10)
209 #define MICROPY_HW_SDIO_D3 (pin_C11)
210
211 // SD Card SDMMC
212 #define MICROPY_HW_SDCARD_SDMMC (2)
213 #define MICROPY_HW_SDCARD_CK (pin_D6)
214 #define MICROPY_HW_SDCARD_CMD (pin_D7)
215 #define MICROPY_HW_SDCARD_D0 (pin_B14)
216 #define MICROPY_HW_SDCARD_D1 (pin_B15)
217 #define MICROPY_HW_SDCARD_D2 (pin_B3)
218 #define MICROPY_HW_SDCARD_D3 (pin_B4)
219 #define MICROPY_HW_SDCARD_MOUNT_AT_BOOT (0)
220
221 // FDCAN bus
222 #define MICROPY_HW_CAN1_NAME "FDCAN1"
223 #define MICROPY_HW_CAN1_TX (pin_H13)
224 #define MICROPY_HW_CAN1_RX (pin_B8)
225
226 // USB config
227 #define MICROPY_HW_USB_HS (1)
228 #define MICROPY_HW_USB_HS_ULPI_NXT (pin_H4)
229 #define MICROPY_HW_USB_HS_ULPI_STP (pin_C0)
230 #define MICROPY_HW_USB_HS_ULPI_DIR (pin_I11)
231 #define MICROPY_HW_USB_HS_ULPI3320 (1)
232
233 #define MICROPY_HW_USB_CDC_RX_DATA_SIZE (1024)
234 #define MICROPY_HW_USB_CDC_TX_DATA_SIZE (1024)
235 #define MICROPY_HW_USB_CDC_1200BPS_TOUCH (1)
236 #define GPIO_AF10_OTG_HS (GPIO_AF10_OTG2_HS)
237
238 // Bluetooth config
239 #define MICROPY_HW_BLE_UART_ID (PYB_UART_7)
240 #define MICROPY_HW_BLE_UART_BAUDRATE (115200)
241 #define MICROPY_HW_BLE_UART_BAUDRATE_SECONDARY (3000000)
242 #define MICROPY_HW_BLE_UART_BAUDRATE_DOWNLOAD_FIRMWARE (3000000)
243
244 // SDRAM
245 #define MICROPY_HW_SDRAM_SIZE (64 / 8 * 1024 * 1024) // 64 Mbit
246 #define MICROPY_HW_SDRAM_STARTUP_TEST (1)
247 #define MICROPY_HW_SDRAM_TEST_FAIL_ON_ERROR (true)
248 #define MICROPY_HW_FMC_SWAP_BANKS (1)
249
250 // Timing configuration for 200MHz/2=100MHz (10ns)
251 #define MICROPY_HW_SDRAM_CLOCK_PERIOD 2
252 #define MICROPY_HW_SDRAM_CAS_LATENCY 2
253 #define MICROPY_HW_SDRAM_FREQUENCY_KHZ (100000) // 100 MHz
254 #define MICROPY_HW_SDRAM_TIMING_TMRD (2)
255 #define MICROPY_HW_SDRAM_TIMING_TXSR (7)
256 #define MICROPY_HW_SDRAM_TIMING_TRAS (5)
257 #define MICROPY_HW_SDRAM_TIMING_TRC (7)
258 #define MICROPY_HW_SDRAM_TIMING_TWR (2)
259 #define MICROPY_HW_SDRAM_TIMING_TRP (3)
260 #define MICROPY_HW_SDRAM_TIMING_TRCD (3)
261
262 #define MICROPY_HW_SDRAM_ROW_BITS_NUM 12
263 #define MICROPY_HW_SDRAM_MEM_BUS_WIDTH 16
264 #define MICROPY_HW_SDRAM_REFRESH_CYCLES 4096
265
266 #define MICROPY_HW_SDRAM_COLUMN_BITS_NUM 8
267 #define MICROPY_HW_SDRAM_INTERN_BANKS_NUM 4
268 #define MICROPY_HW_SDRAM_RPIPE_DELAY 0
269 #define MICROPY_HW_SDRAM_RBURST (1)
270 #define MICROPY_HW_SDRAM_WRITE_PROTECTION (0)
271
272 #define MICROPY_HW_SDRAM_AUTOREFRESH_NUM (8)
273 #define MICROPY_HW_SDRAM_BURST_LENGTH 1
274 #define MICROPY_HW_SDRAM_REFRESH_RATE (64) // ms
275
276 // SDRAM configuration
277 #define MICROPY_HW_FMC_SDCKE0 (pin_H2)
278 #define MICROPY_HW_FMC_SDNE0 (pin_H3)
279 #define MICROPY_HW_FMC_SDNBL0 (pin_E0)
280 #define MICROPY_HW_FMC_SDNBL1 (pin_E1)
281 #define MICROPY_HW_FMC_SDCLK (pin_G8)
282 #define MICROPY_HW_FMC_SDNCAS (pin_G15)
283 #define MICROPY_HW_FMC_SDNRAS (pin_F11)
284 #define MICROPY_HW_FMC_SDNWE (pin_H5)
285 #define MICROPY_HW_FMC_BA0 (pin_G4)
286 #define MICROPY_HW_FMC_BA1 (pin_G5)
287 #define MICROPY_HW_FMC_NBL0 (pin_E0)
288 #define MICROPY_HW_FMC_NBL1 (pin_E1)
289 #define MICROPY_HW_FMC_A0 (pin_F0)
290 #define MICROPY_HW_FMC_A1 (pin_F1)
291 #define MICROPY_HW_FMC_A2 (pin_F2)
292 #define MICROPY_HW_FMC_A3 (pin_F3)
293 #define MICROPY_HW_FMC_A4 (pin_F4)
294 #define MICROPY_HW_FMC_A5 (pin_F5)
295 #define MICROPY_HW_FMC_A6 (pin_F12)
296 #define MICROPY_HW_FMC_A7 (pin_F13)
297 #define MICROPY_HW_FMC_A8 (pin_F14)
298 #define MICROPY_HW_FMC_A9 (pin_F15)
299 #define MICROPY_HW_FMC_A10 (pin_G0)
300 #define MICROPY_HW_FMC_A11 (pin_G1)
301 #define MICROPY_HW_FMC_A12 (pin_G2)
302 #define MICROPY_HW_FMC_D0 (pin_D14)
303 #define MICROPY_HW_FMC_D1 (pin_D15)
304 #define MICROPY_HW_FMC_D2 (pin_D0)
305 #define MICROPY_HW_FMC_D3 (pin_D1)
306 #define MICROPY_HW_FMC_D4 (pin_E7)
307 #define MICROPY_HW_FMC_D5 (pin_E8)
308 #define MICROPY_HW_FMC_D6 (pin_E9)
309 #define MICROPY_HW_FMC_D7 (pin_E10)
310 #define MICROPY_HW_FMC_D8 (pin_E11)
311 #define MICROPY_HW_FMC_D9 (pin_E12)
312 #define MICROPY_HW_FMC_D10 (pin_E13)
313 #define MICROPY_HW_FMC_D11 (pin_E14)
314 #define MICROPY_HW_FMC_D12 (pin_E15)
315 #define MICROPY_HW_FMC_D13 (pin_D8)
316 #define MICROPY_HW_FMC_D14 (pin_D9)
317 #define MICROPY_HW_FMC_D15 (pin_D10)
318
319 // Ethernet via RMII
320 #define MICROPY_HW_ETH_MDC (pin_C1)
321 #define MICROPY_HW_ETH_MDIO (pin_A2)
322 #define MICROPY_HW_ETH_RMII_REF_CLK (pin_A1)
323 #define MICROPY_HW_ETH_RMII_CRS_DV (pin_A7)
324 #define MICROPY_HW_ETH_RMII_RXD0 (pin_C4)
325 #define MICROPY_HW_ETH_RMII_RXD1 (pin_C5)
326 #define MICROPY_HW_ETH_RMII_TX_EN (pin_G11)
327 #define MICROPY_HW_ETH_RMII_TXD0 (pin_G13)
328 #define MICROPY_HW_ETH_RMII_TXD1 (pin_G12)
329
330 #define MICROPY_HW_USB_VID 0x2341
331 #define MICROPY_HW_USB_PID 0x055B
332 #define MICROPY_HW_USB_PID_CDC_MSC (MICROPY_HW_USB_PID)
333 #define MICROPY_HW_USB_PID_CDC_HID (MICROPY_HW_USB_PID)
334 #define MICROPY_HW_USB_PID_CDC (MICROPY_HW_USB_PID)
335 #define MICROPY_HW_USB_PID_MSC (MICROPY_HW_USB_PID)
336 #define MICROPY_HW_USB_PID_CDC2_MSC (MICROPY_HW_USB_PID)
337 #define MICROPY_HW_USB_PID_CDC2 (MICROPY_HW_USB_PID)
338 #define MICROPY_HW_USB_PID_CDC3 (MICROPY_HW_USB_PID)
339 #define MICROPY_HW_USB_PID_CDC3_MSC (MICROPY_HW_USB_PID)
340 #define MICROPY_HW_USB_PID_CDC_MSC_HID (MICROPY_HW_USB_PID)
341 #define MICROPY_HW_USB_PID_CDC2_MSC_HID (MICROPY_HW_USB_PID)
342 #define MICROPY_HW_USB_PID_CDC3_MSC_HID (MICROPY_HW_USB_PID)
343 #define MICROPY_HW_USB_LANGID_STRING 0x409
344 #define MICROPY_HW_USB_MANUFACTURER_STRING "Arduino"
345 #define MICROPY_HW_USB_PRODUCT_FS_STRING "Portenta Virtual Comm Port in FS Mode"
346 #define MICROPY_HW_USB_PRODUCT_HS_STRING "Portenta Virtual Comm Port in HS Mode"
347 #define MICROPY_HW_USB_INTERFACE_FS_STRING "Portenta Interface"
348 #define MICROPY_HW_USB_INTERFACE_HS_STRING "Portenta Interface"
349 #define MICROPY_HW_USB_CONFIGURATION_FS_STRING "Portenta Config"
350 #define MICROPY_HW_USB_CONFIGURATION_HS_STRING "Portenta Config"