stm32/boards/ARDUINO_PORTENTA_H7: Add support for Arduino Portenta H7.

ports/stm32/boards/ARDUINO_PORTENTA_H7/bdev.c

@@ -0,0 +1,45 @@
+/*
+ * This file is part of the MicroPython project, http://micropython.org/
+ *
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2022 Arduino SA
+ *
+ * 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.
+ */
+
+#include "storage.h"
+#include "qspi.h"
+
+#if MICROPY_HW_SPIFLASH_ENABLE_CACHE
+// Shared cache for first and second SPI block devices
+STATIC mp_spiflash_cache_t spi_bdev_cache;
+#endif
+
+// First external SPI flash uses hardware QSPI interface
+const mp_spiflash_config_t spiflash_config = {
+    .bus_kind = MP_SPIFLASH_BUS_QSPI,
+    .bus.u_qspi.data = NULL,
+    .bus.u_qspi.proto = &qspi_proto,
+    #if MICROPY_HW_SPIFLASH_ENABLE_CACHE
+    .cache = &spi_bdev_cache,
+    #endif
+};
+
+spi_bdev_t spi_bdev;

ports/stm32/boards/ARDUINO_PORTENTA_H7/board.json

@@ -0,0 +1,24 @@
+{
+    "deploy": [
+        "./deploy.md"
+    ],
+    "docs": "",
+    "features": [
+        "8MB SDRAM",
+        "16MB Flash",
+        "Dual-core processor",
+        "USB High Speed Phy",
+        "10/100 Ethernet Phy",
+        "CYW43 WiFi/BT Module",
+        "DisplayPort over USB-C",
+        "2x80 pin HD connectors"
+    ],
+    "images": [
+        "ABX00042_01.iso_1000x750.jpg"
+    ],
+    "mcu": "STM32H747",
+    "product": "Arduino Portenta H7",
+    "thumbnail": "",
+    "url": "https://store.arduino.cc/products/portenta-h7",
+    "vendor": "Arduino"
+}

ports/stm32/boards/ARDUINO_PORTENTA_H7/board_init.c

@@ -0,0 +1,180 @@
+/*
+ * This file is part of the MicroPython project, http://micropython.org/
+ *
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2022 Arduino SA
+ *
+ * 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.
+ */
+
+#include <string.h>
+#include "py/mphal.h"
+#include "storage.h"
+#include "sdram.h"
+#include "eth.h"
+#if MICROPY_HW_USB_HS_ULPI3320
+#include "ulpi.h"
+#endif
+
+#define PORTENTA_PMIC_ERRATA    (1)
+
+void PORTENTA_board_startup(void) {
+}
+
+void PORTENTA_board_early_init(void) {
+    HAL_InitTick(0);
+
+    // Enable oscillator pin
+    // This is enabled in the bootloader anyway.
+    PORTENTA_board_osc_enable(true);
+
+    #if MICROPY_HW_ENABLE_INTERNAL_FLASH_STORAGE
+    // The Arduino/mbed bootloader uses the MPU to protect sector 1
+    // which is used for the flash filesystem. The following code
+    // resets and disables all MPU regions configured in the bootloader.
+    HAL_MPU_Disable();
+    MPU_Region_InitTypeDef MPU_InitStruct;
+    MPU_InitStruct.AccessPermission = MPU_REGION_FULL_ACCESS;
+    MPU_InitStruct.IsBufferable = MPU_ACCESS_NOT_BUFFERABLE;
+    MPU_InitStruct.IsCacheable = MPU_ACCESS_NOT_CACHEABLE;
+    MPU_InitStruct.IsShareable = MPU_ACCESS_NOT_SHAREABLE;
+    MPU_InitStruct.TypeExtField = MPU_TEX_LEVEL1;
+    MPU_InitStruct.SubRegionDisable = 0x00;
+    MPU_InitStruct.DisableExec = MPU_INSTRUCTION_ACCESS_ENABLE;
+
+    for (int i = MPU_REGION_NUMBER0; i < MPU_REGION_NUMBER15; i++) {
+        MPU_InitStruct.Number = i;
+        MPU_InitStruct.Enable = MPU_REGION_DISABLE;
+        HAL_MPU_ConfigRegion(&MPU_InitStruct);
+    }
+    #endif
+
+    #if PORTENTA_PMIC_ERRATA
+    // PMIC SW1 current limit fix
+    // Configure PMIC I2C GPIOs
+    mp_hal_pin_config(pyb_pin_I2C1_SCL, MP_HAL_PIN_MODE_ALT_OPEN_DRAIN, MP_HAL_PIN_PULL_NONE, GPIO_AF4_I2C1);
+    mp_hal_pin_config_speed(pyb_pin_I2C1_SCL, MP_HAL_PIN_SPEED_LOW);
+
+    mp_hal_pin_config(pyb_pin_I2C1_SDA, MP_HAL_PIN_MODE_ALT_OPEN_DRAIN, MP_HAL_PIN_PULL_NONE, GPIO_AF4_I2C1);
+    mp_hal_pin_config_speed(pyb_pin_I2C1_SDA, MP_HAL_PIN_SPEED_LOW);
+
+    // Configure PMIC I2C
+    I2C_HandleTypeDef i2c;
+    i2c.Instance = I2C1;
+    i2c.Init.AddressingMode = I2C_ADDRESSINGMODE_7BIT;
+    i2c.Init.Timing = 0x20D09DE7;
+    i2c.Init.DualAddressMode = I2C_DUALADDRESS_DISABLED;
+    i2c.Init.GeneralCallMode = I2C_GENERALCALL_DISABLED;
+    i2c.Init.NoStretchMode = I2C_NOSTRETCH_DISABLED;
+    i2c.Init.OwnAddress1 = 0xFE;
+    i2c.Init.OwnAddress2 = 0xFE;
+    i2c.Init.OwnAddress2Masks = 0;
+
+    __HAL_RCC_I2C1_CLK_ENABLE();
+    __HAL_RCC_I2C1_FORCE_RESET();
+    __HAL_RCC_I2C1_RELEASE_RESET();
+    HAL_I2C_Init(&i2c);
+
+    // Set SW1 current limit to 1.5A
+    // Fixes power glitches with Eth and SDRAM.
+    uint8_t buf[] = {0x36, 0x02};
+    HAL_I2C_Master_Transmit(&i2c, 0x08 << 1, buf, 2, 1000);
+
+    HAL_I2C_DeInit(&i2c);
+    __HAL_RCC_I2C1_FORCE_RESET();
+    __HAL_RCC_I2C1_RELEASE_RESET();
+    __HAL_RCC_I2C1_CLK_DISABLE();
+
+    HAL_GPIO_DeInit(GPIOB, GPIO_PIN_6);
+    HAL_GPIO_DeInit(GPIOB, GPIO_PIN_7);
+    __HAL_RCC_GPIOB_CLK_DISABLE();
+    #endif // PORTENTA_PMIC_ERRATA
+
+    // Reset ETH Phy
+    mp_hal_pin_config(pyb_pin_ETH_RST, MP_HAL_PIN_MODE_OUTPUT, MP_HAL_PIN_PULL_UP, 0);
+    mp_hal_pin_config_speed(pyb_pin_ETH_RST, MP_HAL_PIN_SPEED_LOW);
+    mp_hal_pin_write(pyb_pin_ETH_RST, 0);
+    HAL_Delay(100);
+    mp_hal_pin_write(pyb_pin_ETH_RST, 1);
+
+    // Put Eth in low-power mode
+    eth_init(&eth_instance, MP_HAL_MAC_ETH0);
+    eth_low_power_mode(&eth_instance, true);
+
+    #if MICROPY_HW_USB_HS_ULPI3320
+    // Make sure UPLI is Not in low-power mode.
+    ulpi_leave_low_power();
+    #endif
+}
+
+void PORTENTA_board_enter_bootloader(void) {
+    RTC_HandleTypeDef RTCHandle;
+    RTCHandle.Instance = RTC;
+    HAL_RTCEx_BKUPWrite(&RTCHandle, RTC_BKP_DR0, 0xDF59);
+    NVIC_SystemReset();
+}
+
+void PORTENTA_board_osc_enable(int enable) {
+    mp_hal_pin_config(pyb_pin_OSCEN, MP_HAL_PIN_MODE_OUTPUT, MP_HAL_PIN_PULL_UP, 0);
+    mp_hal_pin_config_speed(pyb_pin_OSCEN, MP_HAL_PIN_SPEED_LOW);
+    mp_hal_pin_write(pyb_pin_OSCEN, enable);
+}
+
+void PORTENTA_board_low_power(int mode) {
+    switch (mode) {
+        case 0:     // Leave stop mode.
+            #if MICROPY_HW_USB_HS_ULPI3320
+            ulpi_leave_low_power();
+            #endif
+            eth_low_power_mode(NULL, false);
+            sdram_leave_low_power();
+            break;
+        case 1:     // Enter stop mode.
+            #if MICROPY_HW_USB_HS_ULPI3320
+            ulpi_enter_low_power();
+            #endif
+            eth_low_power_mode(NULL, true);
+            sdram_enter_low_power();
+            break;
+        case 2:     // Enter standby mode.
+            #if MICROPY_HW_USB_HS_ULPI3320
+            ulpi_enter_low_power();
+            #endif
+            eth_low_power_mode(NULL, true);
+            sdram_enter_power_down();
+            break;
+    }
+
+    #if MICROPY_HW_ENABLE_INTERNAL_FLASH_STORAGE
+    // Enable QSPI deepsleep for modes 1 and 2
+    mp_spiflash_deepsleep(&spi_bdev.spiflash, (mode != 0));
+    #endif
+
+    #if defined(M4_APP_ADDR)
+    // Signal Cortex-M4 to go to Standby mode.
+    if (mode == 2) {
+        __HAL_RCC_HSEM_CLK_ENABLE();
+        HAL_HSEM_FastTake(0);
+        HAL_HSEM_Release(0, 0);
+        __HAL_RCC_HSEM_CLK_DISABLE();
+        HAL_Delay(100);
+    }
+    #endif
+}

ports/stm32/boards/ARDUINO_PORTENTA_H7/deploy.md

@@ -0,0 +1,14 @@
+### Via dfu-util
+
+This board can programmed via DFU bootloader, using e.g. [dfu-util](http://dfu-util.sourceforge.net/).
+To enter the DFU bootloader, double tap the reset (blue) button, or you can use `machine.bootloader()` from the MicroPython REPL.
+
+```bash
+dfu-util -w -d 2341:035b -a 0 -d 0x8040000 -D firmware.dfu
+```
+
+Or from MicroPython source repository:
+
+```bash
+make BOARD=ARDUINO_PORTENTA_H7 deploy
+```

ports/stm32/boards/ARDUINO_PORTENTA_H7/manifest.py

@@ -0,0 +1,9 @@
+include("$(PORT_DIR)/boards/manifest.py")
+include("$(MPY_DIR)/extmod/webrepl/manifest.py")
+include(
+    "$(MPY_LIB_DIR)/micropython/bluetooth/aioble/manifest.py",
+    client=True,
+    central=True,
+    l2cap=True,
+    security=True,
+)