ports: analog: Add peripherals for MAX32650 & MAX32666

Signed-off-by: Brandon <[email protected]>

Author: Brandon-Hurst

ports/analog/peripherals/max32650/gpios.c

@@ -0,0 +1,10 @@
+// This file is part of the CircuitPython project: https://circuitpython.org
+//
+// SPDX-FileCopyrightText: Copyright (c) 2025 Brandon Hurst, Analog Devices, Inc.
+//
+// SPDX-License-Identifier: MIT
+
+#include "gpios.h"
+
+volatile mxc_gpio_regs_t *gpio_ports[NUM_GPIO_PORTS] =
+{MXC_GPIO0, MXC_GPIO1, MXC_GPIO2, MXC_GPIO3};

ports/analog/peripherals/max32650/gpios.h

@@ -0,0 +1,15 @@
+// This file is part of the CircuitPython project: https://circuitpython.org
+//
+// SPDX-FileCopyrightText: Copyright (c) 2025 Brandon Hurst, Analog Devices, Inc.
+//
+// SPDX-License-Identifier: MIT
+
+#pragma once
+
+#include "py/obj.h"
+#include "py/mphal.h"
+
+// MSDK HAL includes
+#include "gpio.h"
+#include "gpio_regs.h"
+#include "max32650.h"

ports/analog/peripherals/max32650/max32_i2c.c

@@ -0,0 +1,35 @@
+// This file is part of the CircuitPython project: https://circuitpython.org
+//
+// SPDX-FileCopyrightText: Copyright (c) 2024 Brandon Hurst, Analog Devices, Inc.
+//
+// SPDX-License-Identifier: MIT
+
+#include "peripherals/pins.h"
+
+#include "common-hal/busio/I2C.h"
+#include "max32_i2c.h"
+#include "max32650.h"
+
+#include "py/runtime.h"
+#include "py/mperrno.h"
+
+const mxc_gpio_cfg_t i2c_maps[NUM_I2C] = {
+    // I2C0
+    { MXC_GPIO2, (MXC_GPIO_PIN_7 | MXC_GPIO_PIN_8), MXC_GPIO_FUNC_ALT1,
+      MXC_GPIO_PAD_NONE, MXC_GPIO_VSSEL_VDDIO, MXC_GPIO_DRVSTR_0 },
+    // I2C1
+    { MXC_GPIO2, (MXC_GPIO_PIN_17 | MXC_GPIO_PIN_18), MXC_GPIO_FUNC_ALT1,
+      MXC_GPIO_PAD_NONE, MXC_GPIO_VSSEL_VDDIO, MXC_GPIO_DRVSTR_0 },
+};
+
+int pinsToI2c(const mcu_pin_obj_t *sda, const mcu_pin_obj_t *scl) {
+    for (int i = 0; i < NUM_I2C; i++) {
+        if ((i2c_maps[i].port == (MXC_GPIO_GET_GPIO(sda->port)))
+            && (i2c_maps[i].mask == ((sda->mask) | (scl->mask)))) {
+            return i;
+        }
+    }
+
+    mp_raise_ValueError_varg(MP_ERROR_TEXT("Invalid %q"), MP_QSTR_pins);
+    return -1;
+}

ports/analog/peripherals/max32650/max32_i2c.h

@@ -0,0 +1,16 @@
+// This file is part of the CircuitPython project: https://circuitpython.org
+//
+// SPDX-FileCopyrightText: Copyright (c) 2024 Brandon Hurst, Analog Devices, Inc.
+//
+// SPDX-License-Identifier: MIT
+
+#pragma once
+
+#include "i2c_regs.h"
+#include "mxc_sys.h"
+#include "i2c.h"
+#include "peripherals/pins.h"
+
+#define NUM_I2C 2
+
+int pinsToI2c(const mcu_pin_obj_t *sda, const mcu_pin_obj_t *scl);

ports/analog/peripherals/max32650/max32_spi.c

@@ -0,0 +1,44 @@
+// This file is part of the CircuitPython project: https://circuitpython.org
+//
+// SPDX-FileCopyrightText: Copyright (c) 2024 Brandon Hurst, Analog Devices, Inc.
+//
+// SPDX-License-Identifier: MIT
+
+#include "peripherals/pins.h"
+
+#include "common-hal/busio/SPI.h"
+#include "max32_spi.h"
+#include "max32650.h"
+
+#include "py/runtime.h"
+#include "py/mperrno.h"
+
+const mxc_gpio_cfg_t spi_maps[NUM_SPI] = {
+    // SPI0
+    { MXC_GPIO2, (MXC_GPIO_PIN_27 | MXC_GPIO_PIN_28 | MXC_GPIO_PIN_29),
+      MXC_GPIO_FUNC_ALT2, MXC_GPIO_PAD_NONE, MXC_GPIO_VSSEL_VDDIO, MXC_GPIO_DRVSTR_0 },
+    // SPI1
+    { MXC_GPIO1, (MXC_GPIO_PIN_26 | MXC_GPIO_PIN_28 | MXC_GPIO_PIN_29),
+      MXC_GPIO_FUNC_ALT1, MXC_GPIO_PAD_NONE, MXC_GPIO_VSSEL_VDDIO, MXC_GPIO_DRVSTR_0 },
+    // SPI2
+    { MXC_GPIO2, (MXC_GPIO_PIN_2 | MXC_GPIO_PIN_3 | MXC_GPIO_PIN_4),
+      MXC_GPIO_FUNC_ALT1, MXC_GPIO_PAD_NONE, MXC_GPIO_VSSEL_VDDIO, MXC_GPIO_DRVSTR_0 },
+    // SPI3
+    { MXC_GPIO0, (MXC_GPIO_PIN_16 | MXC_GPIO_PIN_20 | MXC_GPIO_PIN_21),
+      MXC_GPIO_FUNC_ALT1, MXC_GPIO_PAD_NONE, MXC_GPIO_VSSEL_VDDIO, MXC_GPIO_DRVSTR_0 },
+    // SPI4
+    { MXC_GPIO1, (MXC_GPIO_PIN_1 | MXC_GPIO_PIN_2 | MXC_GPIO_PIN_3),
+      MXC_GPIO_FUNC_ALT1, MXC_GPIO_PAD_NONE, MXC_GPIO_VSSEL_VDDIO, MXC_GPIO_DRVSTR_0 },
+};
+
+int pinsToSpi(const mcu_pin_obj_t *mosi, const mcu_pin_obj_t *miso,
+    const mcu_pin_obj_t *sck) {
+    for (int i = 0; i < NUM_SPI; i++) {
+        if ((spi_maps[i].port == (MXC_GPIO_GET_GPIO(mosi->port)))
+            && (spi_maps[i].mask == ((mosi->mask) | (miso->mask) | (sck->mask)))) {
+            return i;
+        }
+    }
+    mp_raise_ValueError_varg(MP_ERROR_TEXT("Invalid %q"), MP_QSTR_pins);
+    return -1;
+}

ports/analog/peripherals/max32650/max32_spi.h

@@ -0,0 +1,18 @@
+// This file is part of the CircuitPython project: https://circuitpython.org
+//
+// SPDX-FileCopyrightText: Copyright (c) 2024 Brandon Hurst, Analog Devices, Inc.
+//
+// SPDX-License-Identifier: MIT
+
+#pragma once
+
+#include "spi_regs.h"
+#include "mxc_sys.h"
+#include "spi.h"
+#include "peripherals/pins.h"
+
+// 3 APB SPI + 1 AHB QSPI
+#define NUM_SPI 4
+
+int pinsToSpi(const mcu_pin_obj_t *mosi, const mcu_pin_obj_t *miso,
+    const mcu_pin_obj_t *sck);

ports/analog/peripherals/max32650/max32_uart.c

@@ -0,0 +1,34 @@
+// This file is part of the CircuitPython project: https://circuitpython.org
+//
+// SPDX-FileCopyrightText: Copyright (c) 2024 Brandon Hurst, Analog Devices, Inc.
+//
+// SPDX-License-Identifier: MIT
+
+#include "peripherals/pins.h"
+
+#include "common-hal/busio/UART.h"
+#include "max32_uart.h"
+#include "max32650.h"
+
+#include "py/runtime.h"
+#include "py/mperrno.h"
+
+const mxc_gpio_cfg_t uart_maps[NUM_UARTS] = {
+    { MXC_GPIO2, (MXC_GPIO_PIN_11 | MXC_GPIO_PIN_12), MXC_GPIO_FUNC_ALT1,
+      MXC_GPIO_PAD_WEAK_PULL_UP, MXC_GPIO_VSSEL_VDDIO, MXC_GPIO_DRVSTR_0 },
+    { MXC_GPIO2, (MXC_GPIO_PIN_14 | MXC_GPIO_PIN_16), MXC_GPIO_FUNC_ALT1,
+      MXC_GPIO_PAD_WEAK_PULL_UP, MXC_GPIO_VSSEL_VDDIO, MXC_GPIO_DRVSTR_0 },
+    { MXC_GPIO1, (MXC_GPIO_PIN_9 | MXC_GPIO_PIN_10), MXC_GPIO_FUNC_ALT1,
+      MXC_GPIO_PAD_WEAK_PULL_UP, MXC_GPIO_VSSEL_VDDIO, MXC_GPIO_DRVSTR_0 },
+};
+
+int pinsToUart(const mcu_pin_obj_t *rx, const mcu_pin_obj_t *tx) {
+    for (int i = 0; i < NUM_UARTS; i++) {
+        if ((uart_maps[i].port == (MXC_GPIO_GET_GPIO(tx->port)))
+            && (uart_maps[i].mask == ((tx->mask) | (rx->mask)))) {
+            return i;
+        }
+    }
+    mp_raise_ValueError_varg(MP_ERROR_TEXT("Invalid %q"), MP_QSTR_pins);
+    return -1;
+}

ports/analog/peripherals/max32650/max32_uart.h

@@ -0,0 +1,16 @@
+// This file is part of the CircuitPython project: https://circuitpython.org
+//
+// SPDX-FileCopyrightText: Copyright (c) 2024 Brandon Hurst, Analog Devices, Inc.
+//
+// SPDX-License-Identifier: MIT
+
+#pragma once
+
+#include "uart_regs.h"
+#include "mxc_sys.h"
+#include "uart.h"
+#include "peripherals/pins.h"
+
+#define NUM_UARTS 3
+
+int pinsToUart(const mcu_pin_obj_t *rx, const mcu_pin_obj_t *tx);

ports/analog/peripherals/max32650/pins.c

@@ -0,0 +1,120 @@
+// This file is part of the CircuitPython project: https://circuitpython.org
+//
+// SPDX-FileCopyrightText: Copyright (c) 2024 Brandon Hurst, Analog Devices, Inc.
+//
+// SPDX-License-Identifier: MIT
+
+#include "py/obj.h"
+#include "py/mphal.h"
+#include "peripherals/pins.h"
+#include "max32650.h"
+
+const mcu_pin_obj_t pin_P0_00 = PIN(0, 0);
+const mcu_pin_obj_t pin_P0_01 = PIN(0, 1);
+const mcu_pin_obj_t pin_P0_02 = PIN(0, 2);
+const mcu_pin_obj_t pin_P0_03 = PIN(0, 3);
+const mcu_pin_obj_t pin_P0_04 = PIN(0, 4);
+const mcu_pin_obj_t pin_P0_05 = PIN(0, 5);
+const mcu_pin_obj_t pin_P0_06 = PIN(0, 6);
+const mcu_pin_obj_t pin_P0_07 = PIN(0, 7);
+const mcu_pin_obj_t pin_P0_08 = PIN(0, 8);
+const mcu_pin_obj_t pin_P0_09 = PIN(0, 9);
+const mcu_pin_obj_t pin_P0_10 = PIN(0, 10);
+const mcu_pin_obj_t pin_P0_11 = PIN(0, 11);
+const mcu_pin_obj_t pin_P0_12 = PIN(0, 12);
+const mcu_pin_obj_t pin_P0_13 = PIN(0, 13);
+const mcu_pin_obj_t pin_P0_14 = PIN(0, 14);
+const mcu_pin_obj_t pin_P0_15 = PIN(0, 15);
+const mcu_pin_obj_t pin_P0_16 = PIN(0, 16);
+const mcu_pin_obj_t pin_P0_17 = PIN(0, 17);
+const mcu_pin_obj_t pin_P0_18 = PIN(0, 18);
+const mcu_pin_obj_t pin_P0_19 = PIN(0, 19);
+const mcu_pin_obj_t pin_P0_20 = PIN(0, 20);
+const mcu_pin_obj_t pin_P0_21 = PIN(0, 21);
+const mcu_pin_obj_t pin_P0_22 = PIN(0, 22);
+const mcu_pin_obj_t pin_P0_23 = PIN(0, 23);
+const mcu_pin_obj_t pin_P0_24 = PIN(0, 24);
+const mcu_pin_obj_t pin_P0_25 = PIN(0, 25);
+const mcu_pin_obj_t pin_P0_26 = PIN(0, 26);
+const mcu_pin_obj_t pin_P0_27 = PIN(0, 27);
+const mcu_pin_obj_t pin_P0_28 = PIN(0, 28);
+const mcu_pin_obj_t pin_P0_29 = PIN(0, 29);
+const mcu_pin_obj_t pin_P0_30 = PIN(0, 30);
+const mcu_pin_obj_t pin_P0_31 = PIN(0, 31);
+
+const mcu_pin_obj_t pin_P1_00 = PIN(1, 0);
+const mcu_pin_obj_t pin_P1_01 = PIN(1, 1);
+const mcu_pin_obj_t pin_P1_02 = PIN(1, 2);
+const mcu_pin_obj_t pin_P1_03 = PIN(1, 3);
+const mcu_pin_obj_t pin_P1_04 = PIN(1, 4);
+const mcu_pin_obj_t pin_P1_05 = PIN(1, 5);
+const mcu_pin_obj_t pin_P1_06 = PIN(1, 6);
+const mcu_pin_obj_t pin_P1_07 = PIN(1, 7);
+const mcu_pin_obj_t pin_P1_08 = PIN(1, 8);
+const mcu_pin_obj_t pin_P1_09 = PIN(1, 9);
+const mcu_pin_obj_t pin_P1_10 = PIN(1, 10);
+const mcu_pin_obj_t pin_P1_11 = PIN(1, 11);
+const mcu_pin_obj_t pin_P1_12 = PIN(1, 12);
+const mcu_pin_obj_t pin_P1_13 = PIN(1, 13);
+const mcu_pin_obj_t pin_P1_14 = PIN(1, 14);
+const mcu_pin_obj_t pin_P1_15 = PIN(1, 15);
+const mcu_pin_obj_t pin_P1_16 = PIN(1, 16);
+const mcu_pin_obj_t pin_P1_17 = PIN(1, 17);
+const mcu_pin_obj_t pin_P1_18 = PIN(1, 18);
+const mcu_pin_obj_t pin_P1_19 = PIN(1, 19);
+const mcu_pin_obj_t pin_P1_20 = PIN(1, 20);
+const mcu_pin_obj_t pin_P1_21 = PIN(1, 21);
+const mcu_pin_obj_t pin_P1_22 = PIN(1, 22);
+const mcu_pin_obj_t pin_P1_23 = PIN(1, 23);
+const mcu_pin_obj_t pin_P1_24 = PIN(1, 24);
+const mcu_pin_obj_t pin_P1_25 = PIN(1, 25);
+const mcu_pin_obj_t pin_P1_26 = PIN(1, 26);
+const mcu_pin_obj_t pin_P1_27 = PIN(1, 27);
+const mcu_pin_obj_t pin_P1_28 = PIN(1, 28);
+const mcu_pin_obj_t pin_P1_29 = PIN(1, 29);
+const mcu_pin_obj_t pin_P1_30 = PIN(1, 30);
+const mcu_pin_obj_t pin_P1_31 = PIN(1, 31);
+
+const mcu_pin_obj_t pin_P2_00 = PIN(2, 0);
+const mcu_pin_obj_t pin_P2_01 = PIN(2, 1);
+const mcu_pin_obj_t pin_P2_02 = PIN(2, 2);
+const mcu_pin_obj_t pin_P2_03 = PIN(2, 3);
+const mcu_pin_obj_t pin_P2_04 = PIN(2, 4);
+const mcu_pin_obj_t pin_P2_05 = PIN(2, 5);
+const mcu_pin_obj_t pin_P2_06 = PIN(2, 6);
+const mcu_pin_obj_t pin_P2_07 = PIN(2, 7);
+const mcu_pin_obj_t pin_P2_08 = PIN(2, 8);
+const mcu_pin_obj_t pin_P2_09 = PIN(2, 9);
+const mcu_pin_obj_t pin_P2_10 = PIN(2, 10);
+const mcu_pin_obj_t pin_P2_11 = PIN(2, 11);
+const mcu_pin_obj_t pin_P2_12 = PIN(2, 12);
+const mcu_pin_obj_t pin_P2_13 = PIN(2, 13);
+const mcu_pin_obj_t pin_P2_14 = PIN(2, 14);
+const mcu_pin_obj_t pin_P2_15 = PIN(2, 15);
+const mcu_pin_obj_t pin_P2_16 = PIN(2, 16);
+const mcu_pin_obj_t pin_P2_17 = PIN(2, 17);
+const mcu_pin_obj_t pin_P2_18 = PIN(2, 18);
+const mcu_pin_obj_t pin_P2_19 = PIN(2, 19);
+const mcu_pin_obj_t pin_P2_20 = PIN(2, 20);
+const mcu_pin_obj_t pin_P2_21 = PIN(2, 21);
+const mcu_pin_obj_t pin_P2_22 = PIN(2, 22);
+const mcu_pin_obj_t pin_P2_23 = PIN(2, 23);
+const mcu_pin_obj_t pin_P2_24 = PIN(2, 24);
+const mcu_pin_obj_t pin_P2_25 = PIN(2, 25);
+const mcu_pin_obj_t pin_P2_26 = PIN(2, 26);
+const mcu_pin_obj_t pin_P2_27 = PIN(2, 27);
+const mcu_pin_obj_t pin_P2_28 = PIN(2, 28);
+const mcu_pin_obj_t pin_P2_29 = PIN(2, 29);
+const mcu_pin_obj_t pin_P2_30 = PIN(2, 30);
+const mcu_pin_obj_t pin_P2_31 = PIN(2, 31);
+
+const mcu_pin_obj_t pin_P3_00 = PIN(3, 0);
+const mcu_pin_obj_t pin_P3_01 = PIN(3, 1);
+const mcu_pin_obj_t pin_P3_02 = PIN(3, 2);
+const mcu_pin_obj_t pin_P3_03 = PIN(3, 3);
+const mcu_pin_obj_t pin_P3_04 = PIN(3, 4);
+const mcu_pin_obj_t pin_P3_05 = PIN(3, 5);
+const mcu_pin_obj_t pin_P3_06 = PIN(3, 6);
+const mcu_pin_obj_t pin_P3_07 = PIN(3, 7);
+const mcu_pin_obj_t pin_P3_08 = PIN(3, 8);
+const mcu_pin_obj_t pin_P3_09 = PIN(3, 9);