Add Red Vision changes

Author: sfe-SparkFro

.gitmodules

@@ -74,3 +74,6 @@
 [submodule "lib/alif-security-toolkit"]
 	path = lib/alif-security-toolkit
 	url = https://github.com/micropython/alif-security-toolkit.git
+[submodule "lib/red_vision"]
+	path = lib/red_vision
+	url = https://github.com/sparkfun/red_vision.git

lib/red_vision

@@ -1,6 +1,12 @@
 // Board and hardware specific configuration
+#ifndef MICROPY_HW_BOARD_NAME
 #define MICROPY_HW_BOARD_NAME                   "SparkFun IoT RedBoard RP2350"
+#endif
+
+#ifndef MICROPY_HW_FLASH_STORAGE_BYTES
 #define MICROPY_HW_FLASH_STORAGE_BYTES          (PICO_FLASH_SIZE_BYTES - 1536 * 1024)
+#endif
+
 
 // Enable networking.
 #define MICROPY_PY_NETWORK 1

ports/rp2/boards/SPARKFUN_IOTREDBOARD_RP2350/mpconfigboard.h

@@ -0,0 +1,7 @@
+list(APPEND MICROPY_DEF_BOARD
+    # Board name
+    "MICROPY_HW_BOARD_NAME=\"SparkFun IoT RedBoard RP2350 (Red Vision)\""
+    # 8MB (8 * 1024 * 1024)
+    "MICROPY_HW_FLASH_STORAGE_BYTES=8388608"
+    # Pin definitions
+)

ports/rp2/boards/SPARKFUN_IOTREDBOARD_RP2350/mpconfigvariant_RED_VISION.cmake

@@ -68,3 +68,15 @@ A2,GPIO42
 A3,GPIO43
 A4,GPIO44
 A5,GPIO45
+
+# Red Vision pins
+CAMERA_D0,GPIO28
+CAMERA_VSYNC,GPIO42
+CAMERA_HSYNC,GPIO41
+CAMERA_PCLK,GPIO40
+CAMERA_XCLK,GPIO44
+DISPLAY_CLK,GPIO22
+DISPLAY_TX,GPIO23
+DISPLAY_DC,GPIO20
+DISPLAY_CS,GPIO21
+SD_CS,GPIO9

ports/rp2/boards/SPARKFUN_IOTREDBOARD_RP2350/pins.csv

@@ -1,6 +1,11 @@
 // Board and hardware specific configuration
+#ifndef MICROPY_HW_BOARD_NAME
 #define MICROPY_HW_BOARD_NAME          "SparkFun XRP Controller"
+#endif
+
+#ifndef MICROPY_HW_FLASH_STORAGE_BYTES
 #define MICROPY_HW_FLASH_STORAGE_BYTES (PICO_FLASH_SIZE_BYTES - 1536 * 1024)
+#endif
 
 // Enable networking.
 #define MICROPY_PY_NETWORK 1

ports/rp2/boards/SPARKFUN_XRP_CONTROLLER/mpconfigboard.h

@@ -0,0 +1,6 @@
+list(APPEND MICROPY_DEF_BOARD
+    # Board name
+    "MICROPY_HW_BOARD_NAME=\"SparkFun XRP Controller (Red Vision)\""
+    # 8MB (8 * 1024 * 1024)
+    "MICROPY_HW_FLASH_STORAGE_BYTES=8388608"
+)

ports/rp2/boards/SPARKFUN_XRP_CONTROLLER/mpconfigvariant_RED_VISION.cmake

@@ -82,3 +82,15 @@ NEOPIXEL,GPIO37
 WL_GPIO0,EXT_GPIO0
 WL_GPIO1,EXT_GPIO1
 WL_GPIO2,EXT_GPIO2
+
+# Red Vision pins
+CAMERA_D0,GPIO12
+CAMERA_VSYNC,GPIO13
+CAMERA_HSYNC,GPIO14
+CAMERA_PCLK,GPIO15
+CAMERA_XCLK,GPIO3
+DISPLAY_CLK,GPIO18
+DISPLAY_TX,GPIO19
+DISPLAY_DC,GPIO16
+DISPLAY_CS,GPIO17
+SD_CS,GPIO7

ports/rp2/boards/SPARKFUN_XRP_CONTROLLER/pins.csv

@@ -84,6 +84,21 @@ function add_frozen_data_to_boot_for_port {
     cat ports/${TARGET_PORT_NAME}/modules/_boot.py
 }
 
+# Deletes all SparkFun build directories for the given port
+# Options:
+    # $1: Port name
+function delete_build_directories_for_port {
+    local TARGET_PORT_NAME=$1
+    echo "TARGET_PORT_NAME: ${TARGET_PORT_NAME}"
+
+    local SPARKFUN_BOARD_PREFIX="ports/${TARGET_PORT_NAME}/build-*"
+
+    for build_dir in $SPARKFUN_BOARD_PREFIX; do
+        echo "Deleting build directory: ${build_dir}"
+        rm -rf ${build_dir}
+    done
+}
+
 # Builds all SparkFun boards for the given port
 # Options:
     # -n: Port name
@@ -281,6 +296,36 @@ function add_qwiic_manifest {
     done
 }
 
+# Builds Red Vision firmware for RP2 boards
+function build_micropython_red_vision_rp2 {
+    # Set Pico SDK path to $GITHUB_WORKSPACE/micropython/lib/pico-sdk if $GITHUB_WORKSPACE is set, otherwise use the current directory
+    # https://stackoverflow.com/a/246128/4783963
+    SCRIPT_DIR=$( cd -- "$( dirname -- "${BASH_SOURCE[0]}" )" &> /dev/null && pwd )
+    if [ -n "$GITHUB_WORKSPACE" ]; then
+        export PICO_SDK_PATH="$GITHUB_WORKSPACE/lib/pico-sdk"
+    else
+        export PICO_SDK_PATH="$SCRIPT_DIR/lib/pico-sdk"
+    fi
+
+    # Clone the Red Vision submodule
+    # git submodule update --init --recursive lib/red_vision
+
+    # Build OpenCV
+    make -C lib/red_vision/micropython-opencv PLATFORM=rp2350 --no-print-directory ${MAKEOPTS}
+
+    # Archive the examples directory
+    python3 -m freezefs lib/red_vision/red_vision_examples lib/red_vision/extract_red_vision_examples.py  --on-import=extract --compress --overwrite always
+
+    # Set CMake arguments for Pico SDK to use MicroPython-OpenCV malloc wrappers
+    # and enable C++ exceptions
+    export CMAKE_ARGS="-DSKIP_PICO_MALLOC=1 -DPICO_CXX_ENABLE_EXCEPTIONS=1"
+
+    build_all_sparkfun_boards_rp2 -f "$SCRIPT_DIR/lib/red_vision/manifest.py" -v "RED_VISION" -m "$SCRIPT_DIR/lib/red_vision/micropython-opencv/micropython_opencv.cmake"
+
+    # Unset CMake arguments to avoid affecting other builds
+    unset CMAKE_ARGS
+}
+
 # Assumes that MAKEOPTS environment variable is set
 # This is designed to be the user-facing function that will build all SparkFun boards
 # Options: 
@@ -374,5 +419,16 @@ function build_sparkfun {
 
     # Copy all mimxrt teensy binary files to the output directory
     copy_all_for_prefix ${OUTPUT_DIRECTORY} "ports/mimxrt" "build-TEENSY" "firmware" "elf" "${OUTPUT_FILE_PREFIX}TEENSY_" true
+
+    Remove all builds to prepare for Red Vision build
+    delete_build_directories_for_port esp32
+    delete_build_directories_for_port rp2
+    delete_build_directories_for_port mimxrt
+
+    # Build Red Vision
+    build_micropython_red_vision_rp2
+
+    # Copy all rp2 binary files to the output directory
+    copy_all_for_prefix ${OUTPUT_DIRECTORY} "ports/rp2" "build-SPARKFUN_" "firmware" "uf2" "RED_VISION_${OUTPUT_FILE_PREFIX}"
 }