From 6a594a01a4e04a84e90af43f420c79d221367823 Mon Sep 17 00:00:00 2001 From: "Zachary J. Fields" Date: Tue, 9 Dec 2025 13:38:53 -0600 Subject: [PATCH] feat: Blues Heron (STM32U575CIT6) --- README.md | 1 + boards.txt | 67 ++-- cmake/boards_db.cmake | 85 +++++ tools/platformio/boards_remap.json | 1 + .../CMakeLists.txt | 2 + .../PeripheralPins_HERON.c | 347 ++++++++++++++++++ .../variant_HERON.cpp | 213 +++++++++++ .../variant_HERON.h | 246 +++++++++++++ 8 files changed, 937 insertions(+), 25 deletions(-) create mode 100644 variants/STM32U5xx/U575C(G-I)(T-U)_U585CI(T-U)/PeripheralPins_HERON.c create mode 100644 variants/STM32U5xx/U575C(G-I)(T-U)_U585CI(T-U)/variant_HERON.cpp create mode 100644 variants/STM32U5xx/U575C(G-I)(T-U)_U585CI(T-U)/variant_HERON.h diff --git a/README.md b/README.md index 8b27bc2d26..40461b3eb3 100644 --- a/README.md +++ b/README.md @@ -874,6 +874,7 @@ User can add a STM32 based board following this [wiki](https://github.com/stm32d | :----: | :-------: | ---- | :-----: | :---- | | :green_heart: | STM32L4R5ZIYx | [Swan R5](https://blues.com/products/swan) | *2.1.0* | | | :green_heart: | STM32L433CC | [Cygnet](https://blues.com/products) | *2.8.0* | | +| :yellow_heart: | STM32U575CITx | [Heron](https://blues.com/products) | *2.12.0* | | ### [Elecgator](https://www.elecgator.com/) boards diff --git a/boards.txt b/boards.txt index 312cceb255..5fa7e1f060 100644 --- a/boards.txt +++ b/boards.txt @@ -14254,41 +14254,58 @@ Blues.menu.pnum.CYGNET.pid.0=0x0003 Blues.menu.pnum.CYGNET.openocd.target=stm32l4x Blues.menu.pnum.CYGNET.debug.svd_file={runtime.tools.STM32_SVD.path}/svd/STM32L4xx/STM32L433.svd +# Heron board +Blues.menu.pnum.HERON=Heron +Blues.menu.pnum.HERON.upload.maximum_size=2097152 +Blues.menu.pnum.HERON.upload.maximum_data_size=786432 +Blues.menu.pnum.HERON.build.mcu=cortex-m33 +Blues.menu.pnum.HERON.build.fpu=-mfpu=fpv5-sp-d16 +Blues.menu.pnum.HERON.build.float-abi=-mfloat-abi=hard +Blues.menu.pnum.HERON.build.board=HERON +Blues.menu.pnum.HERON.build.series=STM32U5xx +Blues.menu.pnum.HERON.build.product_line=STM32U575xx +Blues.menu.pnum.HERON.build.variant=STM32U5xx/U575C(G-I)(T-U)_U585CI(T-U) +Blues.menu.pnum.HERON.build.peripheral_pins=-DCUSTOM_PERIPHERAL_PINS +Blues.menu.pnum.HERON.vid.0=0x30A4 +Blues.menu.pnum.HERON.pid.0=0x0004 +Blues.menu.pnum.HERON.openocd.target=stm32u5x +Blues.menu.pnum.HERON.debug.svd_file={runtime.tools.STM32_SVD.path}/svd/STM32U5xx/STM32U575.svd + # Upload menu +Blues.menu.upload_method.OpenOCDSTLink=OpenOCD STLink (SWD) +Blues.menu.upload_method.OpenOCDSTLink.upload.protocol=stlink +Blues.menu.upload_method.OpenOCDSTLink.upload.tool=openocd_upload + +Blues.menu.upload_method.OpenOCDDapLink=OpenOCD DapLink (SWD) +Blues.menu.upload_method.OpenOCDDapLink.upload.protocol=cmsis-dap +Blues.menu.upload_method.OpenOCDDapLink.upload.tool=openocd_upload +Blues.menu.upload_method.OpenOCDDapLink.debug.server.openocd.scripts.0=interface/cmsis-dap.cfg +Blues.menu.upload_method.OpenOCDDapLink.debug.server.openocd.scripts.1={runtime.platform.path}/debugger/select_swd.cfg + Blues.menu.upload_method.swdMethod=STM32CubeProgrammer (SWD) Blues.menu.upload_method.swdMethod.upload.protocol=swd Blues.menu.upload_method.swdMethod.upload.options=-a {upload.address} -m {upload.mode} -s {upload.start} Blues.menu.upload_method.swdMethod.upload.tool=stm32CubeProg -Blues.menu.upload_method.jlinkMethod=STM32CubeProgrammer (J-Link) -Blues.menu.upload_method.jlinkMethod.upload.protocol=jlink -Blues.menu.upload_method.jlinkMethod.upload.options=-a {upload.address} -s {upload.start} -Blues.menu.upload_method.jlinkMethod.upload.tool=stm32CubeProg +Blues.menu.upload_method.dfuMethod=STM32CubeProgrammer (DFU) +Blues.menu.upload_method.dfuMethod.upload.protocol=dfu +Blues.menu.upload_method.dfuMethod.upload.options=-v {upload.vid} -p {upload.pid} -a {upload.address} -s {upload.start} +Blues.menu.upload_method.dfuMethod.upload.tool=stm32CubeProg Blues.menu.upload_method.serialMethod=STM32CubeProgrammer (Serial) Blues.menu.upload_method.serialMethod.upload.protocol=serial Blues.menu.upload_method.serialMethod.upload.options=-c {serial.port.file} -a {upload.address} -s {upload.start} --parity {upload.parity} Blues.menu.upload_method.serialMethod.upload.tool=stm32CubeProg -Blues.menu.upload_method.dfuMethod=STM32CubeProgrammer (DFU) -Blues.menu.upload_method.dfuMethod.upload.protocol=dfu -Blues.menu.upload_method.dfuMethod.upload.options=-v {upload.vid} -p {upload.pid} -a {upload.address} -s {upload.start} -Blues.menu.upload_method.dfuMethod.upload.tool=stm32CubeProg +Blues.menu.upload_method.jlinkMethod=STM32CubeProgrammer (J-Link) +Blues.menu.upload_method.jlinkMethod.upload.protocol=jlink +Blues.menu.upload_method.jlinkMethod.upload.options=-a {upload.address} -s {upload.start} +Blues.menu.upload_method.jlinkMethod.upload.tool=stm32CubeProg Blues.menu.upload_method.bmpMethod=BMP (Black Magic Probe) Blues.menu.upload_method.bmpMethod.upload.protocol=gdb_bmp Blues.menu.upload_method.bmpMethod.upload.tool=bmp_upload -Blues.menu.upload_method.OpenOCDSTLink=OpenOCD STLink (SWD) -Blues.menu.upload_method.OpenOCDSTLink.upload.protocol=stlink -Blues.menu.upload_method.OpenOCDSTLink.upload.tool=openocd_upload - -Blues.menu.upload_method.OpenOCDDapLink=OpenOCD DapLink (SWD) -Blues.menu.upload_method.OpenOCDDapLink.upload.protocol=cmsis-dap -Blues.menu.upload_method.OpenOCDDapLink.upload.tool=openocd_upload -Blues.menu.upload_method.OpenOCDDapLink.debug.server.openocd.scripts.0=interface/cmsis-dap.cfg -Blues.menu.upload_method.OpenOCDDapLink.debug.server.openocd.scripts.1={runtime.platform.path}/debugger/select_swd.cfg - ################################################################################ # Elecgator boards @@ -16365,9 +16382,13 @@ GenWL.menu.opt.o0std.build.flags.optimize=-O0 3dprinter.menu.opt.o0std=No Optimization (-O0) 3dprinter.menu.opt.o0std.build.flags.optimize=-O0 +Blues.menu.opt.ogstd=Debug (-Og) +Blues.menu.opt.ogstd.build.flags.optimize=-Og Blues.menu.opt.osstd=Smallest (-Os default) Blues.menu.opt.oslto=Smallest (-Os) with LTO Blues.menu.opt.oslto.build.flags.optimize=-Os -flto +Blues.menu.opt.o0std=No Optimization (-O0) +Blues.menu.opt.o0std.build.flags.optimize=-O0 Blues.menu.opt.o1std=Fast (-O1) Blues.menu.opt.o1std.build.flags.optimize=-O1 Blues.menu.opt.o1lto=Fast (-O1) with LTO @@ -16380,10 +16401,6 @@ Blues.menu.opt.o3std=Fastest (-O3) Blues.menu.opt.o3std.build.flags.optimize=-O3 Blues.menu.opt.o3lto=Fastest (-O3) with LTO Blues.menu.opt.o3lto.build.flags.optimize=-O3 -flto -Blues.menu.opt.ogstd=Debug (-Og) -Blues.menu.opt.ogstd.build.flags.optimize=-Og -Blues.menu.opt.o0std=No Optimization (-O0) -Blues.menu.opt.o0std.build.flags.optimize=-O0 Elecgator.menu.opt.osstd=Smallest (-Os default) Elecgator.menu.opt.oslto=Smallest (-Os) with LTO @@ -16822,13 +16839,13 @@ GenWL.menu.dbg.enable_all.build.flags.debug=-g 3dprinter.menu.dbg.enable_all=Core Logs and Symbols Enabled (-g) 3dprinter.menu.dbg.enable_all.build.flags.debug=-g -Blues.menu.dbg.none=None +Blues.menu.dbg.enable_all=Core Logs and Symbols Enabled (-g) +Blues.menu.dbg.enable_all.build.flags.debug=-g Blues.menu.dbg.enable_sym=Symbols Enabled (-g) Blues.menu.dbg.enable_sym.build.flags.debug=-g -DNDEBUG Blues.menu.dbg.enable_log=Core logs Enabled Blues.menu.dbg.enable_log.build.flags.debug= -Blues.menu.dbg.enable_all=Core Logs and Symbols Enabled (-g) -Blues.menu.dbg.enable_all.build.flags.debug=-g +Blues.menu.dbg.none=None Elecgator.menu.dbg.none=None Elecgator.menu.dbg.enable_sym=Symbols Enabled (-g) diff --git a/cmake/boards_db.cmake b/cmake/boards_db.cmake index 36baf1a8c7..f900ebeff8 100644 --- a/cmake/boards_db.cmake +++ b/cmake/boards_db.cmake @@ -109054,6 +109054,91 @@ target_compile_options(GENERIC_WLE5JCIX_serial_none INTERFACE "SHELL:-DHAL_UART_MODULE_ENABLED -DHWSERIAL_NONE" ) +# HERON +# ----------------------------------------------------------------------------- + +set(HERON_VARIANT_PATH "${CMAKE_CURRENT_LIST_DIR}/../variants/STM32U5xx/U575C(G-I)(T-U)_U585CI(T-U)") +set(HERON_MAXSIZE 2097152) +set(HERON_MAXDATASIZE 786432) +set(HERON_MCU cortex-m33) +set(HERON_FPU_CONF "fpv5-sp-d16") +set(HERON_FPU_ABI "hard") +set(HERON_FPCONF "${HERON_FPU_CONF}-${HERON_FPU_ABI}") +set(HERON_PID 0x0004) +add_library(HERON INTERFACE) +target_compile_options(HERON INTERFACE + "SHELL:-DSTM32U575xx" + "SHELL:-DCUSTOM_PERIPHERAL_PINS" + "SHELL:" + "SHELL:-mfpu=${HERON_FPU_CONF} -mfloat-abi=${HERON_FPU_ABI}" + -mcpu=${HERON_MCU} +) +target_compile_definitions(HERON INTERFACE + "STM32U5xx" + "ARDUINO_HERON" + "BOARD_NAME=\"HERON\"" + "BOARD_ID=HERON" + "VARIANT_H=\"variant_HERON.h\"" +) +target_include_directories(HERON INTERFACE + ${CMAKE_CURRENT_LIST_DIR}/../system/STM32U5xx + ${CMAKE_CURRENT_LIST_DIR}/../system/Drivers/STM32U5xx_HAL_Driver/Inc + ${CMAKE_CURRENT_LIST_DIR}/../system/Drivers/STM32U5xx_HAL_Driver/Src + ${CMAKE_CURRENT_LIST_DIR}/../system/Drivers/CMSIS/Device/ST/STM32U5xx/Include/ + ${CMAKE_CURRENT_LIST_DIR}/../system/Drivers/CMSIS/Device/ST/STM32U5xx/Source/Templates/gcc/ + ${HERON_VARIANT_PATH} +) + +target_link_options(HERON INTERFACE + "LINKER:--default-script=${HERON_VARIANT_PATH}/ldscript.ld" + "LINKER:--defsym=LD_FLASH_OFFSET=0x0" + "LINKER:--defsym=LD_MAX_SIZE=${HERON_MAXSIZE}" + "LINKER:--defsym=LD_MAX_DATA_SIZE=${HERON_MAXDATASIZE}" + "SHELL:-mfpu=${HERON_FPU_CONF} -mfloat-abi=${HERON_FPU_ABI}" + -mcpu=${HERON_MCU} +) + +add_library(HERON_serial_disabled INTERFACE) +target_compile_options(HERON_serial_disabled INTERFACE + "SHELL:" +) +add_library(HERON_serial_generic INTERFACE) +target_compile_options(HERON_serial_generic INTERFACE + "SHELL:-DHAL_UART_MODULE_ENABLED" +) +add_library(HERON_serial_none INTERFACE) +target_compile_options(HERON_serial_none INTERFACE + "SHELL:-DHAL_UART_MODULE_ENABLED -DHWSERIAL_NONE" +) +add_library(HERON_usb_CDC INTERFACE) +target_compile_options(HERON_usb_CDC INTERFACE + "SHELL:-DUSBCON -DUSBD_VID=0x30A4 -DUSBD_PID=${HERON_PID} -DHAL_PCD_MODULE_ENABLED -DUSBD_USE_CDC -DDISABLE_GENERIC_SERIALUSB" +) +add_library(HERON_usb_CDCgen INTERFACE) +target_compile_options(HERON_usb_CDCgen INTERFACE + "SHELL:-DUSBCON -DUSBD_VID=0x30A4 -DUSBD_PID=${HERON_PID} -DHAL_PCD_MODULE_ENABLED -DUSBD_USE_CDC" +) +add_library(HERON_usb_HID INTERFACE) +target_compile_options(HERON_usb_HID INTERFACE + "SHELL:-DUSBCON -DUSBD_VID=0x30A4 -DUSBD_PID=${HERON_PID} -DHAL_PCD_MODULE_ENABLED -DUSBD_USE_HID_COMPOSITE" +) +add_library(HERON_usb_none INTERFACE) +target_compile_options(HERON_usb_none INTERFACE + "SHELL:" +) +add_library(HERON_xusb_FS INTERFACE) +target_compile_options(HERON_xusb_FS INTERFACE + "SHELL:" +) +add_library(HERON_xusb_HS INTERFACE) +target_compile_options(HERON_xusb_HS INTERFACE + "SHELL:-DUSE_USB_HS" +) +add_library(HERON_xusb_HSFS INTERFACE) +target_compile_options(HERON_xusb_HSFS INTERFACE + "SHELL:-DUSE_USB_HS -DUSE_USB_HS_IN_FS" +) + # HY_TINYSTM103TB # ----------------------------------------------------------------------------- diff --git a/tools/platformio/boards_remap.json b/tools/platformio/boards_remap.json index c3a8aa22b8..02b71b7545 100644 --- a/tools/platformio/boards_remap.json +++ b/tools/platformio/boards_remap.json @@ -33,6 +33,7 @@ "bw_swan_r5": "SWAN_R5", "blues_swan_r5": "SWAN_R5", "blues_cygnet": "CYGNET", + "blues_heron": "HERON", "disco_b_g431b_esc1": "B_G431B_ESC1", "disco_b_u585i_iot02a": "B_U585I_IOT02A", "nucleo_wl55jc": "NUCLEO_WL55JC1" diff --git a/variants/STM32U5xx/U575C(G-I)(T-U)_U585CI(T-U)/CMakeLists.txt b/variants/STM32U5xx/U575C(G-I)(T-U)_U585CI(T-U)/CMakeLists.txt index 4b0ade045e..61f4cbaf61 100644 --- a/variants/STM32U5xx/U575C(G-I)(T-U)_U585CI(T-U)/CMakeLists.txt +++ b/variants/STM32U5xx/U575C(G-I)(T-U)_U585CI(T-U)/CMakeLists.txt @@ -22,8 +22,10 @@ add_library(variant_bin STATIC EXCLUDE_FROM_ALL generic_clock.c PeripheralPins.c PeripheralPins_DEVKIT_IOT_CONTINUUM.c + PeripheralPins_HERON.c variant_DEVKIT_IOT_CONTINUUM.cpp variant_generic.cpp + variant_HERON.cpp ) target_link_libraries(variant_bin PUBLIC variant_usage) diff --git a/variants/STM32U5xx/U575C(G-I)(T-U)_U585CI(T-U)/PeripheralPins_HERON.c b/variants/STM32U5xx/U575C(G-I)(T-U)_U585CI(T-U)/PeripheralPins_HERON.c new file mode 100644 index 0000000000..735f5b3e24 --- /dev/null +++ b/variants/STM32U5xx/U575C(G-I)(T-U)_U585CI(T-U)/PeripheralPins_HERON.c @@ -0,0 +1,347 @@ +/* + ******************************************************************************* + * Copyright (c) 2020, STMicroelectronics + * All rights reserved. + * + * This software component is licensed by ST under BSD 3-Clause license, + * the "License"; You may not use this file except in compliance with the + * License. You may obtain a copy of the License at: + * opensource.org/licenses/BSD-3-Clause + * + ******************************************************************************* + */ +/* + * Manually generated by Blues with knowledge of the HERON schematic + */ +#if defined(ARDUINO_HERON) +#include "Arduino.h" +#include "PeripheralPins.h" + +/* ===== + * Notes: + * - The pins mentioned Px_y_ALTz are alternative possibilities which use other + * HW peripheral instances. You can use them the same way as any other "normal" + * pin (i.e. analogWrite(PA7_ALT1, 128);). + * + * - Commented lines are alternative possibilities which are not used per default. + * If you change them, you will have to know what you do + * ===== + */ + +//*** ADC *** + +#ifdef HAL_ADC_MODULE_ENABLED +WEAK const PinMap PinMap_ADC[] = { + {PA_0, ADC1, STM_PIN_DATA_EXT(STM_MODE_ANALOG, GPIO_NOPULL, 0, 5, 0)}, // ADC1_IN5 - A0/D0 + {PA_1, ADC1, STM_PIN_DATA_EXT(STM_MODE_ANALOG, GPIO_NOPULL, 0, 6, 0)}, // ADC1_IN6 - A1/D1 + {PA_2, ADC1, STM_PIN_DATA_EXT(STM_MODE_ANALOG, GPIO_NOPULL, 0, 7, 0)}, // ADC1_IN7 - A2/D2 + {PA_3, ADC1, STM_PIN_DATA_EXT(STM_MODE_ANALOG, GPIO_NOPULL, 0, 8, 0)}, // ADC1_IN8 - A3/D3 + {PA_4, ADC1, STM_PIN_DATA_EXT(STM_MODE_ANALOG, GPIO_NOPULL, 0, 9, 0)}, // ADC1_IN9 - A8/BATTERY_VOLTAGE (STAT) + {PA_4_ALT1, ADC4, STM_PIN_DATA_EXT(STM_MODE_ANALOG, GPIO_NOPULL, 0, 9, 0)}, // ADC4_IN9 - A8/BATTERY_VOLTAGE (STAT) + // {PA_5, ADC1, STM_PIN_DATA_EXT(STM_MODE_ANALOG, GPIO_NOPULL, 0, 10, 0)}, // ADC1_IN10 - USART3_VCP_RX + // {PA_5_ALT1, ADC4, STM_PIN_DATA_EXT(STM_MODE_ANALOG, GPIO_NOPULL, 0, 10, 0)}, // ADC4_IN10 - USART3_VCP_RX + {PA_6, ADC1, STM_PIN_DATA_EXT(STM_MODE_ANALOG, GPIO_NOPULL, 0, 11, 0)}, // ADC1_IN11 - A6/MI + {PA_6_ALT1, ADC4, STM_PIN_DATA_EXT(STM_MODE_ANALOG, GPIO_NOPULL, 0, 11, 0)}, // ADC4_IN11 - A6/MI + {PA_7, ADC1, STM_PIN_DATA_EXT(STM_MODE_ANALOG, GPIO_NOPULL, 0, 12, 0)}, // ADC1_IN12 - A5 + {PA_7_ALT1, ADC4, STM_PIN_DATA_EXT(STM_MODE_ANALOG, GPIO_NOPULL, 0, 20, 0)}, // ADC4_IN20 - A5 + {PB_0, ADC1, STM_PIN_DATA_EXT(STM_MODE_ANALOG, GPIO_NOPULL, 0, 15, 0)}, // ADC1_IN15 - A7/D11 + {PB_0_ALT1, ADC4, STM_PIN_DATA_EXT(STM_MODE_ANALOG, GPIO_NOPULL, 0, 18, 0)}, // ADC4_IN18 - A7/D11 + {PB_1, ADC1, STM_PIN_DATA_EXT(STM_MODE_ANALOG, GPIO_NOPULL, 0, 16, 0)}, // ADC1_IN16 - A4/D4 + {PB_1_ALT1, ADC4, STM_PIN_DATA_EXT(STM_MODE_ANALOG, GPIO_NOPULL, 0, 19, 0)}, // ADC4_IN19 - A4/D4 + {PB_2, ADC1, STM_PIN_DATA_EXT(STM_MODE_ANALOG, GPIO_NOPULL, 0, 17, 0)}, // ADC1_IN17 - USB_DETECT + {NC, NP, 0} +}; +#endif + +//*** DAC *** + +#ifdef HAL_DAC_MODULE_ENABLED +WEAK const PinMap PinMap_DAC[] = { + // {PA_4, DAC1, STM_PIN_DATA_EXT(STM_MODE_ANALOG, GPIO_NOPULL, 0, 1, 0)}, // DAC1_OUT1 - A8/BATTERY_VOLTAGE (STAT) + {PA_5, DAC1, STM_PIN_DATA_EXT(STM_MODE_ANALOG, GPIO_NOPULL, 0, 2, 0)}, // DAC1_OUT2 - USART3_VCP_RX + {NC, NP, 0} +}; +#endif + +//*** I2C *** + +#ifdef HAL_I2C_MODULE_ENABLED +WEAK const PinMap PinMap_I2C_SDA[] = { + {PB_3, I2C1, STM_PIN_DATA(STM_MODE_AF_OD, GPIO_NOPULL, GPIO_AF4_I2C1)}, // - CK + {PB_4, I2C3, STM_PIN_DATA(STM_MODE_AF_OD, GPIO_NOPULL, GPIO_AF4_I2C3)}, // - D13 + {PB_7, I2C1, STM_PIN_DATA(STM_MODE_AF_OD, GPIO_NOPULL, GPIO_AF4_I2C1)}, // - SDA + {PB_7_ALT1, I2C4, STM_PIN_DATA(STM_MODE_AF_OD, GPIO_NOPULL, GPIO_AF5_I2C4)}, // - SDA + {PB_9, I2C1, STM_PIN_DATA(STM_MODE_AF_OD, GPIO_NOPULL, GPIO_AF4_I2C1)}, // - D6 + {PB_14, I2C2, STM_PIN_DATA(STM_MODE_AF_OD, GPIO_NOPULL, GPIO_AF4_I2C2)}, // - D9 + {NC, NP, 0} +}; +#endif + +#ifdef HAL_I2C_MODULE_ENABLED +WEAK const PinMap PinMap_I2C_SCL[] = { + {PA_7, I2C3, STM_PIN_DATA(STM_MODE_AF_OD, GPIO_NOPULL, GPIO_AF4_I2C3)}, // - A5 + {PB_6, I2C1, STM_PIN_DATA(STM_MODE_AF_OD, GPIO_NOPULL, GPIO_AF4_I2C1)}, // - SCL + {PB_6_ALT1, I2C4, STM_PIN_DATA(STM_MODE_AF_OD, GPIO_NOPULL, GPIO_AF5_I2C4)}, // - SCL + {PB_8, I2C1, STM_PIN_DATA(STM_MODE_AF_OD, GPIO_NOPULL, GPIO_AF4_I2C1)}, // - D5 + // {PB_10, I2C2, STM_PIN_DATA(STM_MODE_AF_OD, GPIO_NOPULL, GPIO_AF4_I2C2)}, // - USART3_VCP_TX + // {PB_10_ALT1, I2C4, STM_PIN_DATA(STM_MODE_AF_OD, GPIO_NOPULL, GPIO_AF3_I2C4)}, // - USART3_VCP_TX + {PB_13, I2C2, STM_PIN_DATA(STM_MODE_AF_OD, GPIO_NOPULL, GPIO_AF4_I2C2)}, // - D10 + {NC, NP, 0} +}; +#endif + +//*** No I3C *** + +//*** TIM *** + +#ifdef HAL_TIM_MODULE_ENABLED +WEAK const PinMap PinMap_TIM[] = { + {PA_0, TIM2, STM_PIN_DATA_EXT(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF1_TIM2, 1, 0)}, // TIM2_CH1 - A0/D0 + {PA_0_ALT1, TIM5, STM_PIN_DATA_EXT(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF2_TIM5, 1, 0)}, // TIM5_CH1 - A0/D0 + {PA_1, TIM2, STM_PIN_DATA_EXT(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF1_TIM2, 2, 0)}, // TIM2_CH2 - A1/D1 + {PA_1_ALT1, TIM5, STM_PIN_DATA_EXT(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF2_TIM5, 2, 0)}, // TIM5_CH2 - A1/D1 + {PA_1_ALT2, TIM15, STM_PIN_DATA_EXT(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF14_TIM15, 1, 1)}, // TIM15_CH1N - A1/D1 + {PA_2, TIM2, STM_PIN_DATA_EXT(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF1_TIM2, 3, 0)}, // TIM2_CH3 - A2/D2 + {PA_2_ALT1, TIM5, STM_PIN_DATA_EXT(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF2_TIM5, 3, 0)}, // TIM5_CH3 - A2/D2 + {PA_2_ALT2, TIM15, STM_PIN_DATA_EXT(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF14_TIM15, 1, 0)}, // TIM15_CH1 - A2/D2 + {PA_3, TIM2, STM_PIN_DATA_EXT(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF1_TIM2, 4, 0)}, // TIM2_CH4 - A3/D3 + {PA_3_ALT1, TIM5, STM_PIN_DATA_EXT(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF2_TIM5, 4, 0)}, // TIM5_CH4 - A3/D3 + {PA_3_ALT2, TIM15, STM_PIN_DATA_EXT(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF14_TIM15, 2, 0)}, // TIM15_CH2 - A3/D3 + // {PA_5, TIM2, STM_PIN_DATA_EXT(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF1_TIM2, 1, 0)}, // TIM2_CH1 - USART3_VCP_RX + // {PA_5_ALT1, TIM8, STM_PIN_DATA_EXT(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF3_TIM8, 1, 1)}, // TIM8_CH1N - USART3_VCP_RX + {PA_6, TIM3, STM_PIN_DATA_EXT(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF2_TIM3, 1, 0)}, // TIM3_CH1 - A6/MI + {PA_6_ALT1, TIM16, STM_PIN_DATA_EXT(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF14_TIM16, 1, 0)}, // TIM16_CH1 - A6/MI + {PA_7, TIM1, STM_PIN_DATA_EXT(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF1_TIM1, 1, 1)}, // TIM1_CH1N - A5 + {PA_7_ALT1, TIM3, STM_PIN_DATA_EXT(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF2_TIM3, 2, 0)}, // TIM3_CH2 - A5 + {PA_7_ALT2, TIM8, STM_PIN_DATA_EXT(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF3_TIM8, 1, 1)}, // TIM8_CH1N - A5 + {PA_7_ALT3, TIM17, STM_PIN_DATA_EXT(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF14_TIM17, 1, 0)}, // TIM17_CH1 - A5 + // {PA_8, TIM1, STM_PIN_DATA_EXT(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF1_TIM1, 1, 0)}, // TIM1_CH1 - LED_BUILTIN + {PA_9, TIM1, STM_PIN_DATA_EXT(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF1_TIM1, 2, 0)}, // TIM1_CH2 - TX + {PA_10, TIM1, STM_PIN_DATA_EXT(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF1_TIM1, 3, 0)}, // TIM1_CH3 - RX + // {PA_11, TIM1, STM_PIN_DATA_EXT(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF1_TIM1, 4, 0)}, // TIM1_CH4 - USB_D_N + // {PA_15, TIM2, STM_PIN_DATA_EXT(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF1_TIM2, 1, 0)}, // TIM2_CH1 - CHARGE_DETECT + // {PB_0, TIM1, STM_PIN_DATA_EXT(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF1_TIM1, 2, 1)}, // TIM1_CH2N - A7/D11 + {PB_0_ALT1, TIM3, STM_PIN_DATA_EXT(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF2_TIM3, 3, 0)}, // TIM3_CH3 - A7/D11 + {PB_0_ALT2, TIM8, STM_PIN_DATA_EXT(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF3_TIM8, 2, 1)}, // TIM8_CH2N - A7/D11 + {PB_1, TIM1, STM_PIN_DATA_EXT(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF1_TIM1, 3, 1)}, // TIM1_CH3N - A4/D4 + {PB_1_ALT1, TIM3, STM_PIN_DATA_EXT(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF2_TIM3, 4, 0)}, // TIM3_CH4 - A4/D4 + {PB_1_ALT2, TIM8, STM_PIN_DATA_EXT(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF3_TIM8, 3, 1)}, // TIM8_CH3N - A4/D4 + // {PB_2, TIM8, STM_PIN_DATA_EXT(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF3_TIM8, 4, 1)}, // TIM8_CH4N - USB_DETECT + {PB_3, TIM2, STM_PIN_DATA_EXT(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF1_TIM2, 2, 0)}, // TIM2_CH2 - CK + {PB_4, TIM3, STM_PIN_DATA_EXT(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF2_TIM3, 1, 0)}, // TIM3_CH1 - D13 + {PB_5, TIM3, STM_PIN_DATA_EXT(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF2_TIM3, 2, 0)}, // TIM3_CH2 - MO + {PB_6, TIM4, STM_PIN_DATA_EXT(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF2_TIM4, 1, 0)}, // TIM4_CH1 - SCL + {PB_6_ALT1, TIM16, STM_PIN_DATA_EXT(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF14_TIM16, 1, 1)}, // TIM16_CH1N - SCL + {PB_7, TIM4, STM_PIN_DATA_EXT(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF2_TIM4, 2, 0)}, // TIM4_CH2 - SDA + {PB_7_ALT1, TIM17, STM_PIN_DATA_EXT(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF14_TIM17, 1, 1)}, // TIM17_CH1N - SDA + {PB_8, TIM4, STM_PIN_DATA_EXT(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF2_TIM4, 3, 0)}, // TIM4_CH3 - D5 + {PB_8_ALT1, TIM16, STM_PIN_DATA_EXT(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF14_TIM16, 1, 0)}, // TIM16_CH1 - D5 + {PB_9, TIM4, STM_PIN_DATA_EXT(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF2_TIM4, 4, 0)}, // TIM4_CH4 - D6 + {PB_9_ALT1, TIM17, STM_PIN_DATA_EXT(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF14_TIM17, 1, 0)}, // TIM17_CH1 - D6 + // {PB_10, TIM2, STM_PIN_DATA_EXT(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF1_TIM2, 3, 0)}, // TIM2_CH3 - USART3_VCP_TX + // {PB_13, TIM1, STM_PIN_DATA_EXT(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF1_TIM1, 1, 1)}, // TIM1_CH1N - D10 + {PB_13_ALT1, TIM15, STM_PIN_DATA_EXT(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF14_TIM15, 1, 1)}, // TIM15_CH1N - D10 + {PB_14, TIM1, STM_PIN_DATA_EXT(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF1_TIM1, 2, 1)}, // TIM1_CH2N - D9 + {PB_14_ALT1, TIM8, STM_PIN_DATA_EXT(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF3_TIM8, 2, 1)}, // TIM8_CH2N - D9 + {PB_14_ALT2, TIM15, STM_PIN_DATA_EXT(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF14_TIM15, 1, 0)}, // TIM15_CH1 - D9 + // {PB_15, TIM1, STM_PIN_DATA_EXT(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF1_TIM1, 3, 1)}, // TIM1_CH3N - D12 + {PB_15_ALT1, TIM8, STM_PIN_DATA_EXT(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF3_TIM8, 3, 1)}, // TIM8_CH3N - D12 + {PB_15_ALT2, TIM15, STM_PIN_DATA_EXT(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF14_TIM15, 2, 0)}, // TIM15_CH2 - D12 + {NC, NP, 0} +}; +#endif + +//*** UART *** + +#ifdef HAL_UART_MODULE_ENABLED +WEAK const PinMap PinMap_UART_TX[] = { + {PA_0, UART4, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF8_UART4)}, // - A0/D0 + {PA_2, LPUART1, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF8_LPUART1)}, // - A2/D2 + {PA_2_ALT1, USART2, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF7_USART2)}, // - A2/D2 + {PA_7, USART3, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF7_USART3)}, // - A5 + {PA_9, USART1, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF7_USART1)}, // - TX + {PB_6, USART1, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF7_USART1)}, // - SCL + {PB_10, USART3, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF7_USART3)}, // - USART3_VCP_TX + {NC, NP, 0} +}; +#endif + +#ifdef HAL_UART_MODULE_ENABLED +WEAK const PinMap PinMap_UART_RX[] = { + {PA_1, UART4, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF8_UART4)}, // - A1/D1 + {PA_3, LPUART1, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF8_LPUART1)}, // - A3/D3 + {PA_3_ALT1, USART2, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF7_USART2)}, // - A3/D3 + {PA_5, USART3, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF7_USART3)}, // - USART3_VCP_RX + {PA_10, USART1, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF7_USART1)}, // - RX + // {PA_15, USART2, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF3_USART2)}, // - CHARGE_DETECT + // {PB_7, USART1, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF7_USART1)}, // - SDA + {PB_10, LPUART1, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF8_LPUART1)}, // - USART3_VCP_TX + {NC, NP, 0} +}; +#endif + +#ifdef HAL_UART_MODULE_ENABLED +WEAK const PinMap PinMap_UART_RTS[] = { + {PA_1, USART2, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF7_USART2)}, // - A1/D1 + // {PA_12, USART1, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF7_USART1)}, // - USB_D_P + // {PA_15, UART4, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF8_UART4)}, // - CHARGE_DETECT + // {PA_15_ALT1, USART3, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF7_USART3)}, // - CHARGE_DETECT + {PB_1, LPUART1, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF8_LPUART1)}, // - A4/D4 + {PB_1_ALT1, USART3, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF7_USART3)}, // - A4/D4 + {PB_3, USART1, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF7_USART1)}, // - CK + // {PB_12, LPUART1, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF8_LPUART1)}, // - NC + {PB_14, USART3, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF7_USART3)}, // - D9 + {NC, NP, 0} +}; +#endif + +#ifdef HAL_UART_MODULE_ENABLED +WEAK const PinMap PinMap_UART_CTS[] = { + {PA_0, USART2, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF7_USART2)}, // - A0/D0 + {PA_6, LPUART1, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF8_LPUART1)}, // - A6/MI + {PA_6_ALT1, USART3, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF7_USART3)}, // - A6/MI + // {PA_11, USART1, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF7_USART1)}, // - USB_D_N + {PB_4, USART1, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF7_USART1)}, // - D13 + {PB_7, UART4, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF8_UART4)}, // - SDA + {PB_13, LPUART1, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF8_LPUART1)}, // - D10 + {PB_13_ALT1, USART3, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF7_USART3)}, // - D10 + {NC, NP, 0} +}; +#endif + +//*** SPI *** + +#ifdef HAL_SPI_MODULE_ENABLED +WEAK const PinMap PinMap_SPI_MOSI[] = { + // {PA_7, SPI1, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF5_SPI1)}, // - A5 + // {PA_12, SPI1, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF5_SPI1)}, // - USB_D_P + {PB_5, SPI1, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF5_SPI1)}, // - MO + {PB_5_ALT1, SPI3, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF6_SPI3)}, // - MO + {PB_15, SPI2, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF5_SPI2)}, // - D12 + {NC, NP, 0} +}; +#endif + +#ifdef HAL_SPI_MODULE_ENABLED +WEAK const PinMap PinMap_SPI_MISO[] = { + {PA_6, SPI1, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF5_SPI1)}, // - A6/MI + // {PA_11, SPI1, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF5_SPI1)}, // - USB_D_N + // {PB_4, SPI1, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF5_SPI1)}, // - D13 + {PB_4_ALT1, SPI3, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF6_SPI3)}, // - D13 + {PB_14, SPI2, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF5_SPI2)}, // - D9 + {NC, NP, 0} +}; +#endif + +#ifdef HAL_SPI_MODULE_ENABLED +WEAK const PinMap PinMap_SPI_SCLK[] = { + // {PA_1, SPI1, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF5_SPI1)}, // - A1/D1 + // {PA_5, SPI1, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF5_SPI1)}, // - USART3_VCP_RX + {PA_9, SPI2, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF3_SPI2)}, // - TX + {PB_3, SPI1, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF5_SPI1)}, // - CK + {PB_3_ALT1, SPI3, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF6_SPI3)}, // - CK + // {PB_10, SPI2, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF5_SPI2)}, // - USART3_VCP_TX + {PB_13, SPI2, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF5_SPI2)}, // - D10 + {NC, NP, 0} +}; +#endif + +#ifdef HAL_SPI_MODULE_ENABLED +WEAK const PinMap PinMap_SPI_SSEL[] = { + // {PA_4, SPI1, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF5_SPI1)}, // - A8/BATTERY_VOLTAGE (STAT) + // {PA_4_ALT1, SPI3, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF6_SPI3)}, // - A8/BATTERY_VOLTAGE (STAT) + // {PA_15, SPI1, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF5_SPI1)}, // - CHARGE_DETECT + // {PA_15_ALT1, SPI3, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF6_SPI3)}, // - CHARGE_DETECT + {PB_0, SPI1, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF5_SPI1)}, // - A7/D11 + {PB_9, SPI2, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF5_SPI2)}, // - D6 + // {PB_12, SPI2, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF5_SPI2)}, // - NC + {NC, NP, 0} +}; +#endif + +//*** FDCAN *** + +#ifdef HAL_FDCAN_MODULE_ENABLED +WEAK const PinMap PinMap_CAN_RD[] = { + // {PA_11, FDCAN1, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_NOPULL, GPIO_AF9_FDCAN1)}, // - USB_D_N + {PB_8, FDCAN1, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_NOPULL, GPIO_AF9_FDCAN1)}, // - D5 + {NC, NP, 0} +}; +#endif + +#ifdef HAL_FDCAN_MODULE_ENABLED +WEAK const PinMap PinMap_CAN_TD[] = { + // {PA_12, FDCAN1, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_NOPULL, GPIO_AF9_FDCAN1)}, // - USB_D_P + {PB_9, FDCAN1, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_NOPULL, GPIO_AF9_FDCAN1)}, // - D6 + {NC, NP, 0} +}; +#endif + +//*** No ETHERNET *** + +//*** OCTOSPI *** + +#ifdef HAL_OSPI_MODULE_ENABLED +WEAK const PinMap PinMap_OCTOSPI_DATA0[] = { + {PB_1, OCTOSPI1, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF10_OCTOSPI1)}, // OCTOSPIM_P1_IO0 - A4/D4 + {NC, NP, 0} +}; +#endif + +#ifdef HAL_OSPI_MODULE_ENABLED +WEAK const PinMap PinMap_OCTOSPI_DATA1[] = { + {PB_0, OCTOSPI1, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF10_OCTOSPI1)}, // OCTOSPIM_P1_IO1 - A7/D11 + {NC, NP, 0} +}; +#endif + +#ifdef HAL_OSPI_MODULE_ENABLED +WEAK const PinMap PinMap_OCTOSPI_DATA2[] = { + {PA_7, OCTOSPI1, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF10_OCTOSPI1)}, // OCTOSPIM_P1_IO2 - A5 + {NC, NP, 0} +}; +#endif + +#ifdef HAL_OSPI_MODULE_ENABLED +WEAK const PinMap PinMap_OCTOSPI_DATA3[] = { + {PA_6, OCTOSPI1, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF10_OCTOSPI1)}, // OCTOSPIM_P1_IO3 - A6/MI + {NC, NP, 0} +}; +#endif + +#ifdef HAL_OSPI_MODULE_ENABLED +WEAK const PinMap PinMap_OCTOSPI_SCLK[] = { + {PA_3, OCTOSPI1, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF10_OCTOSPI1)}, // OCTOSPIM_P1_CLK - A3/D3 + // {PB_10, OCTOSPI1, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF10_OCTOSPI1)}, // OCTOSPIM_P1_CLK - USART3_VCP_TX + {NC, NP, 0} +}; +#endif + +#ifdef HAL_OSPI_MODULE_ENABLED +WEAK const PinMap PinMap_OCTOSPI_SSEL[] = { + {PA_0, OCTOSPI2, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF10_OCTOSPI2)}, // OCTOSPIM_P2_NCS - A0/D0 + {PA_2, OCTOSPI1, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF10_OCTOSPI1)}, // OCTOSPIM_P1_NCS - A2/D2 + // {PA_4, OCTOSPI1, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF3_OCTOSPI1)}, // OCTOSPIM_P1_NCS - A8/BATTERY_VOLTAGE (STAT) + // {PA_12, OCTOSPI2, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF6_OCTOSPI2)}, // OCTOSPIM_P2_NCS = USB_D_P + {NC, NP, 0} +}; +#endif + +//*** USB *** + +#if defined(HAL_PCD_MODULE_ENABLED) || defined(HAL_HCD_MODULE_ENABLED) +WEAK const PinMap PinMap_USB_OTG_FS[] = { + // {PA_8, USB_OTG_FS, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF10_USB)}, // USB_OTG_FS_SOF - LED_BUILTIN + // {PA_9, USB_OTG_FS, STM_PIN_DATA(STM_MODE_INPUT, GPIO_NOPULL, GPIO_AF_NONE)}, // USB_OTG_FS_VBUS - TX + // {PA_10, USB_OTG_FS, STM_PIN_DATA(STM_MODE_AF_OD, GPIO_PULLUP, GPIO_AF10_USB)}, // USB_OTG_FS_ID - RX + {PA_11, USB_OTG_FS, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF10_USB)}, // USB_OTG_FS_DM - USB_D_N + {PA_12, USB_OTG_FS, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF10_USB)}, // USB_OTG_FS_DP - USB_D_P + // {PA_13, USB_OTG_FS, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF10_USB)}, // USB_OTG_FS_NOE - SWDIO + // {PA_14, USB_OTG_FS, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF10_USB)}, // USB_OTG_FS_SOF - SWCLK + {NC, NP, 0} +}; +#endif + +//*** No SD *** + +#endif /* ARDUINO_HERON */ diff --git a/variants/STM32U5xx/U575C(G-I)(T-U)_U585CI(T-U)/variant_HERON.cpp b/variants/STM32U5xx/U575C(G-I)(T-U)_U585CI(T-U)/variant_HERON.cpp new file mode 100644 index 0000000000..c30bec2bcc --- /dev/null +++ b/variants/STM32U5xx/U575C(G-I)(T-U)_U585CI(T-U)/variant_HERON.cpp @@ -0,0 +1,213 @@ +/* + ******************************************************************************* + * Copyright (c) 2020, STMicroelectronics + * All rights reserved. + * + * This software component is licensed by ST under BSD 3-Clause license, + * the "License"; You may not use this file except in compliance with the + * License. You may obtain a copy of the License at: + * opensource.org/licenses/BSD-3-Clause + * + ******************************************************************************* + */ +#if defined(ARDUINO_HERON) +#include "pins_arduino.h" + +// Digital PinName array +const PinName digitalPin[] = { + PA_0, // 0 - A0/D0 + PA_1, // 1 - A1/D1 + PA_2, // 2 - A2/D2 + PA_3, // 3 - A3/D3 + PB_1, // 4 - A4/D4 + PB_8, // 5 - D5 + PB_9, // 6 - D6 + PA_8, // 7 - LED_BUILTIN + PC_13, // 8 - USER_BTN + PB_14, // 9 - D9 + PB_13, // 10 - D10 + PB_0, // 11 - A7/D11 + PB_15, // 12 - D12 + PB_4, // 13 - D13 + PA_7, // 14 - A5 + PB_3, // 15 - CK + PB_5, // 16 - MO + PA_6, // 17 - A6/MI + PA_10, // 18 - RX + PA_9, // 19 - TX + PH_3, // 20 - B + PB_6, // 21 - SCL + PB_7, // 22 - SDA + PA_13, // 23 - SWDIO + PA_14, // 24 - SWCLK + PA_5, // 25 - USART3_VCP_RX + PB_10, // 26 - USART3_VCP_TX + PH_0, // 27 - ENABLE_3V3 + PH_1, // 28 - DISCHARGE_3V3 + PA_15, // 29 - CHARGE_DETECT + PA_4, // 30 - A8/BATTERY_VOLTAGE (STAT) + PB_2, // 31 - USB_DETECT + PA_11, // 32 - USB_D_N + PA_12, // 33 - USB_D_P + PC_14, // 34 - OSC32_IN (LSE) + PC_15 // 35 - OSC32_OUT (LSE) +}; + +// Analog (Ax) pin number array +const uint32_t analogInputPin[] = { + 0, // PA0 - A0 + 1, // PA1 - A1 + 2, // PA2 - A2 + 3, // PA3 - A3 + 4, // PB1 - A4 + 14, // PA7 - A5 + 17, // PA6 - A6/MI + 11, // PB0 - A7/D11 + 30 // PA4 - A8/BATTERY_VOLTAGE (STAT) + // 15 // PB2 - USB_DETECT + // 25 // PA5 - A10/USART3_VCP_RX +}; + +// ---------------------------------------------------------------------------- + +#ifdef __cplusplus +extern "C" { +#endif + +WEAK void initVariant(void) +{ + /* Set all pins to FLOAT initially */ + /* DS13737 Rev 10, Section 3.9.4 - Reset Mode: */ + /* In order to improve the consumption under reset, the I/O state under and after reset is + * “analog state” (the I/O Schmitt trigger is disabled). In addition, the internal reset pull-up is + * deactivated when the reset source is internal. + */ + + /* Turn on the 3V3 regulator */ + __HAL_RCC_GPIOH_CLK_ENABLE(); + GPIO_InitTypeDef GPIO_InitStruct; + GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP; + GPIO_InitStruct.Speed = GPIO_SPEED_LOW; + GPIO_InitStruct.Pin = GPIO_PIN_0 | GPIO_PIN_1; + HAL_GPIO_Init(GPIOH, &GPIO_InitStruct); /* PH0 is ENABLE_3V3, PH1 is DISCHARGE_3V3 */ + HAL_GPIO_WritePin(GPIOH, GPIO_InitStruct.Pin, GPIO_PIN_SET); /* Enable 3V3 regulator and disable discharging */ +} + +/** + * @brief System Clock Configuration – Low-power optimized STM32U575 with native USB CDC + * + * Key features: + * • SYSCLK = 48 MHz derived from MSI (Range 11) → lowest active-mode current + * • USB OTG_FS uses HSI48 as CLK48 source via the official U5 method (RCC_PERIPHCLK_CLK48 + IclkClockSelection) + * • LSE enabled for RTC / ultra-low-power timing + * • No PLL → minimal power and EMI + * • CRS enabled → automatic HSI48 trimming from USB SOF packets (±250 ppm accuracy) + * + * References: + * • RM0456 Rev 7 – §6.3.2 (CLK48 selection), §6.5 (CRS), §40.4.3 (USB OTG_FS PHY) + * • STM32CubeU5 v1.4.0 / v1.7.0 – CDC_Standalone examples for NUCLEO-U575ZI-Q + * • ST migration note: SYSCFG clock must now be enabled by user in HAL_PCD_MspInit() + */ +WEAK void SystemClock_Config(void) +{ + RCC_OscInitTypeDef RCC_OscInitStruct = {}; + RCC_ClkInitTypeDef RCC_ClkInitStruct = {}; + RCC_PeriphCLKInitTypeDef PeriphClkInit = {}; + RCC_CRSInitTypeDef CRS_InitStruct = {}; + + /* ------------------------------------------------------------------------- + * 1. Voltage scaling – Scale 1 is required for MSI Range 11 (48 MHz) + * ------------------------------------------------------------------------- */ + if (HAL_PWREx_ControlVoltageScaling(PWR_REGULATOR_VOLTAGE_SCALE1) != HAL_OK) { + Error_Handler(); + } + + /* ------------------------------------------------------------------------- + * 2. LSE drive strength (optimize for low-power) + * ------------------------------------------------------------------------- */ + HAL_PWR_EnableBkUpAccess(); + __HAL_RCC_LSEDRIVE_CONFIG(RCC_LSEDRIVE_LOW); + + /* ------------------------------------------------------------------------- + * 3. Oscillator configuration + * • MSI = ON (initially Range 0 = 100 kHz – lowest power at boot) + * • HSI48 = ON (required for USB CLK48 source) + * • HSI = ON (used for ADCs, DAC, etc.) + * • LSE = ON (RTC / ultra-low-power timing) + * • PLL = OFF (no PLL → lowest power) + * ------------------------------------------------------------------------- */ + RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_MSI + | RCC_OSCILLATORTYPE_HSI48 + | RCC_OSCILLATORTYPE_HSI + | RCC_OSCILLATORTYPE_LSE; + RCC_OscInitStruct.MSIState = RCC_MSI_ON; + RCC_OscInitStruct.MSIClockRange = RCC_MSIRANGE_0; // 100 kHz initially (will be overridden later) + RCC_OscInitStruct.MSICalibrationValue = RCC_MSICALIBRATION_DEFAULT; + RCC_OscInitStruct.HSI48State = RCC_HSI48_ON; // Critical for USB + RCC_OscInitStruct.HSIState = RCC_HSI_ON; + RCC_OscInitStruct.HSICalibrationValue = RCC_HSICALIBRATION_DEFAULT; + RCC_OscInitStruct.LSEState = RCC_LSE_ON; + RCC_OscInitStruct.PLL.PLLState = RCC_PLL_NONE; // No PLL → lowest power + if (HAL_RCC_OscConfig(&RCC_OscInitStruct) != HAL_OK) { + Error_Handler(); + } + + /* ------------------------------------------------------------------------- + * 4. Select MSI as system clock source (will run at 48 MHz after PeriphClk config) + * ------------------------------------------------------------------------- */ + RCC_ClkInitStruct.ClockType = RCC_CLOCKTYPE_HCLK | RCC_CLOCKTYPE_PCLK1 + | RCC_CLOCKTYPE_PCLK2 | RCC_CLOCKTYPE_PCLK3 + | RCC_CLOCKTYPE_SYSCLK; + RCC_ClkInitStruct.AHBCLKDivider = RCC_SYSCLK_DIV1; + RCC_ClkInitStruct.APB1CLKDivider = RCC_HCLK_DIV1; + RCC_ClkInitStruct.APB2CLKDivider = RCC_HCLK_DIV1; + RCC_ClkInitStruct.APB3CLKDivider = RCC_HCLK_DIV1; + RCC_ClkInitStruct.SYSCLKSource = RCC_SYSCLKSOURCE_MSI; + if (HAL_RCC_ClockConfig(&RCC_ClkInitStruct, FLASH_LATENCY_2) != HAL_OK) { + Error_Handler(); + } + + /* ------------------------------------------------------------------------- + * 5. Peripheral clock configuration – THIS IS THE OFFICIAL U5 WAY TO SELECT CLK48 + * • RCC_PERIPHCLK_CLK48 + IclkClockSelection = RCC_CLK48CLKSOURCE_HSI48 + * → writes RCC->CCIPR1.ICLKSEL = 00 (RM0456 §6.3.2, Fig. 36) + * • MSI is switched to Range 11 (48 MHz) automatically by the HAL when + * any peripheral requests it (here ADCDAC, DAC1, LPUART1, etc.) + * ------------------------------------------------------------------------- */ + PeriphClkInit.PeriphClockSelection = RCC_PERIPHCLK_ADCDAC + | RCC_PERIPHCLK_CLK48 // USB CLK48 domain + | RCC_PERIPHCLK_DAC1 + | RCC_PERIPHCLK_LPUART1; + PeriphClkInit.AdcDacClockSelection = RCC_ADCDACCLKSOURCE_HSI; + PeriphClkInit.IclkClockSelection = RCC_CLK48CLKSOURCE_HSI48; // Selects HSI48 for USB OTG_FS + PeriphClkInit.Dac1ClockSelection = RCC_DAC1CLKSOURCE_LSE; + PeriphClkInit.Lpuart1ClockSelection = RCC_LPUART1CLKSOURCE_SYSCLK; + if (HAL_RCCEx_PeriphCLKConfig(&PeriphClkInit) != HAL_OK) { + Error_Handler(); + } + + /* ------------------------------------------------------------------------- + * 6. Low-power helpers + * ------------------------------------------------------------------------- */ + HAL_RCCEx_EnableMSIPLLMode(); // MSI PLL-mode for better stability in Stop + __HAL_RCC_WAKEUPSTOP_CLK_CONFIG(RCC_STOP_WAKEUPCLOCK_MSI); // Wake from Stop on MSI + + /* ------------------------------------------------------------------------- + * 7. Clock Recovery System – auto-trim HSI48 from USB SOF packets + * Required for reliable USB enumeration across temperature/cable length + * Power impact < 1 µA, enabled in all official ST U5 USB examples + * ------------------------------------------------------------------------- */ + __HAL_RCC_CRS_CLK_ENABLE(); + CRS_InitStruct.Prescaler = RCC_CRS_SYNC_DIV1; + CRS_InitStruct.Source = RCC_CRS_SYNC_SOURCE_USB; // Trim using USB SOF + CRS_InitStruct.ReloadValue = RCC_CRS_RELOADVALUE_DEFAULT; + CRS_InitStruct.ErrorLimitValue = RCC_CRS_ERRORLIMIT_DEFAULT; + CRS_InitStruct.HSI48CalibrationValue = 0x00; // Default trim (will be auto-adjusted) + HAL_RCCEx_CRSConfig(&CRS_InitStruct); +} + +#ifdef __cplusplus +} +#endif + +#endif /* ARDUINO_HERON */ diff --git a/variants/STM32U5xx/U575C(G-I)(T-U)_U585CI(T-U)/variant_HERON.h b/variants/STM32U5xx/U575C(G-I)(T-U)_U585CI(T-U)/variant_HERON.h new file mode 100644 index 0000000000..95ada428fe --- /dev/null +++ b/variants/STM32U5xx/U575C(G-I)(T-U)_U585CI(T-U)/variant_HERON.h @@ -0,0 +1,246 @@ +/* + ******************************************************************************* + * Copyright (c) 2020, STMicroelectronics + * All rights reserved. + * + * This software component is licensed by ST under BSD 3-Clause license, + * the "License"; You may not use this file except in compliance with the + * License. You may obtain a copy of the License at: + * opensource.org/licenses/BSD-3-Clause + * + ******************************************************************************* + */ +#pragma once + +/*---------------------------------------------------------------------------- + * STM32 pins number + *---------------------------------------------------------------------------- + * Arduino digital pin numbers on the right (indexes into the digitalPin[] array) + * and the STM32 pins they correspond to on the left. The only apparent + * function I can see is to reference a pin in a sketch in something + * like digitalWrite() and have it index into digitalPin[] to find the + * actual pin. On the other hand, PIN_A* are numbers offset by PNUM_ANALOG_BASE, + * which serves to say that this IS an analog pin and which tells analogWrite + * to index into the digitalPin[] array to find the actual pin. + *----------------------------------------------------------------------------*/ +#define PA0 PIN_A0 // A0/D0 +#define PA1 PIN_A1 // A1/D1 +#define PA2 PIN_A2 // A2/D2 +#define PA3 PIN_A3 // A3/D3 +#define PA4 PIN_A8 // A8/BATTERY_VOLTAGE (STAT) +#define PA5 25 // USART3_VCP_RX +#define PA6 PIN_A6 // A6/MI +#define PA7 PIN_A5 // A5 +#define PA8 7 // LED_BUILTIN +#define PA9 19 // TX +#define PA10 18 // RX +#define PA11 32 // USB_D_N +#define PA12 33 // USB_D_P +#define PA13 23 // SWDIO +#define PA14 24 // SWCLK +#define PA15 29 // CHARGE_DETECT +#define PB0 PIN_A7 // A7/D11 +#define PB1 PIN_A4 // A4/D4 +#define PB2 31 // USB_DETECT +#define PB3 15 // CK +#define PB4 13 // D13 +#define PB5 16 // MO +#define PB6 21 // SCL +#define PB7 22 // SDA +#define PB8 5 // D5 +#define PB9 6 // D6 +#define PB10 26 // USART3_VCP_TX +#define PB13 10 // D10 +#define PB14 9 // D9 +#define PB15 12 // D12 +#define PC13 8 // USER_BTN +#define PC14 34 // OSC32_IN (LSE) +#define PC15 35 // OSC32_OUT (LSE) +#define PH0 27 // ENABLE_3V3 +#define PH1 28 // DISCHARGE_3V3 +#define PH3 20 // B + +// Alternate pins number +#define PA0_ALT1 (PA0 | ALT1) +#define PA1_ALT1 (PA1 | ALT1) +#define PA1_ALT2 (PA1 | ALT2) +#define PA2_ALT1 (PA2 | ALT1) +#define PA2_ALT2 (PA2 | ALT2) +#define PA3_ALT1 (PA3 | ALT1) +#define PA3_ALT2 (PA3 | ALT2) +#define PA4_ALT1 (PA4 | ALT1) +#define PA5_ALT1 (PA5 | ALT1) +#define PA6_ALT1 (PA6 | ALT1) +#define PA7_ALT1 (PA7 | ALT1) +#define PA7_ALT2 (PA7 | ALT2) +#define PA7_ALT3 (PA7 | ALT3) +#define PA15_ALT1 (PA15 | ALT1) +#define PB0_ALT1 (PB0 | ALT1) +#define PB0_ALT2 (PB0 | ALT2) +#define PB1_ALT1 (PB1 | ALT1) +#define PB1_ALT2 (PB1 | ALT2) +#define PB3_ALT1 (PB3 | ALT1) +#define PB4_ALT1 (PB4 | ALT1) +#define PB5_ALT1 (PB5 | ALT1) +#define PB6_ALT1 (PB6 | ALT1) +#define PB7_ALT1 (PB7 | ALT1) +#define PB8_ALT1 (PB8 | ALT1) +#define PB9_ALT1 (PB9 | ALT1) +#define PB10_ALT1 (PB10 | ALT1) +#define PB13_ALT1 (PB13 | ALT1) +#define PB14_ALT1 (PB14 | ALT1) +#define PB14_ALT2 (PB14 | ALT2) +#define PB15_ALT1 (PB15 | ALT1) +#define PB15_ALT2 (PB15 | ALT2) + +#define NUM_DIGITAL_PINS 36 +#define NUM_ANALOG_INPUTS 9 + +// On-board LED pin number +#ifndef LED_BUILTIN + #define LED_BUILTIN PA8 +#endif + +// On-board user button +#ifndef USER_BTN + #define USER_BTN PC13 +#endif + +// Power switch ENABLE and DISCHARGE pins +#ifndef ENABLE_3V3 + #define ENABLE_3V3 PH0 +#endif +#ifndef DISCHARGE_3V3 + #define DISCHARGE_3V3 PH1 + #define DISABLE_DISCHARGING HIGH + #define ENABLE_DISCHARGING LOW +#endif +#ifndef BATTERY_VOLTAGE + #define BATTERY_VOLTAGE PA4 +#endif +#ifndef CHARGE_DETECT + #define CHARGE_DETECT PA15 +#endif +#ifndef USB_DETECT + #define USB_DETECT PB2 +#endif + +// SPI definitions +#ifndef PIN_SPI_SS + #define PIN_SPI_SS PB0 // Shared with D11 (no dedicated CS pin) +#endif +#ifndef PIN_SPI_SS1 + #define PIN_SPI_SS1 PNUM_NOT_DEFINED +#endif +#ifndef PIN_SPI_SS2 + #define PIN_SPI_SS2 PNUM_NOT_DEFINED +#endif +#ifndef PIN_SPI_SS3 + #define PIN_SPI_SS3 PNUM_NOT_DEFINED +#endif +#ifndef PIN_SPI_MOSI + #define PIN_SPI_MOSI PB5 +#endif +#ifndef PIN_SPI_MISO + #define PIN_SPI_MISO PA6 +#endif +#ifndef PIN_SPI_SCK + #define PIN_SPI_SCK PB3 +#endif + +// I2C definitions +#ifndef PIN_WIRE_SDA + #define PIN_WIRE_SDA PB7 +#endif +#ifndef PIN_WIRE_SCL + #define PIN_WIRE_SCL PB6 +#endif + +// Timer Definitions +// Use TIM6/TIM7 when possible as servo and tone don't need GPIO output pin +#ifndef TIMER_TONE + #define TIMER_TONE TIM6 +#endif +#ifndef TIMER_SERVO + #define TIMER_SERVO TIM7 +#endif + +// UART Definitions +#ifndef SERIAL_UART_INSTANCE + #define SERIAL_UART_INSTANCE 1 +#endif + +// Default pin used for generic 'Serial' instance +// Mandatory for Firmata +#ifndef PIN_SERIAL_RX + #define PIN_SERIAL_RX PA10 +#endif +#ifndef PIN_SERIAL_TX + #define PIN_SERIAL_TX PA9 +#endif + +// Default pin used for generic 'Serial3' instance +// Mandatory for Firmata +#ifndef PIN_SERIAL3_RX + #define PIN_SERIAL3_RX PA5 +#endif +#ifndef PIN_SERIAL3_TX + #define PIN_SERIAL3_TX PB10 +#endif + +// Virtual COM Port for Heron with a 14-pin STLink Connector mounted. +// To use the STLINK's Virtual COM port, add the following line to an Arduino project: +// HardwareSerial SerialVCP(PIN_VCP_RX, PIN_VCP_TX); +#ifndef PIN_VCP_RX + #define PIN_VCP_RX PIN_SERIAL3_RX +#endif +#ifndef PIN_VCP_TX + #define PIN_VCP_TX PIN_SERIAL3_TX +#endif + +// Extra HAL modules +#if !defined(HAL_DAC_MODULE_DISABLED) + #define HAL_DAC_MODULE_ENABLED +#endif +#if !defined(HAL_OSPI_MODULE_DISABLED) + #define HAL_OSPI_MODULE_ENABLED +#endif + +// Alternate SYS_WKUP definition +#define PWR_WAKEUP_PIN1_1 +#define PWR_WAKEUP_PIN2_1 +#define PWR_WAKEUP_PIN3_1 +#define PWR_WAKEUP_PIN4_1 +#define PWR_WAKEUP_PIN4_2 +#define PWR_WAKEUP_PIN5_1 +#define PWR_WAKEUP_PIN6_1 +#define PWR_WAKEUP_PIN7_1 +#define PWR_WAKEUP_PIN8_1 + +/*---------------------------------------------------------------------------- + * Arduino objects - C++ only + *----------------------------------------------------------------------------*/ + +#ifdef __cplusplus + // These serial port names are intended to allow libraries and architecture-neutral + // sketches to automatically default to the correct port name for a particular type + // of use. For example, a GPS module would normally connect to SERIAL_PORT_HARDWARE_OPEN, + // the first hardware serial port whose RX/TX pins are not dedicated to another use. + // + // SERIAL_PORT_MONITOR Port which normally prints to the Arduino Serial Monitor + // + // SERIAL_PORT_USBVIRTUAL Port which is USB virtual serial + // + // SERIAL_PORT_LINUXBRIDGE Port which connects to a Linux system via Bridge library + // + // SERIAL_PORT_HARDWARE Hardware serial port, physical RX & TX pins. + // + // SERIAL_PORT_HARDWARE_OPEN Hardware serial ports which are open for use. Their RX & TX + // pins are NOT connected to anything by default. + #ifndef SERIAL_PORT_MONITOR + #define SERIAL_PORT_MONITOR Serial + #endif + #ifndef SERIAL_PORT_HARDWARE + #define SERIAL_PORT_HARDWARE Serial + #endif +#endif