add a yaml file for gitea, not confusing the github behaviour TODO: implementation of test runs on gitea

2026-10-18 12:12:43 +02:00
Commit 157c87fe89
@@ -0,0 +1,268 @@
+name: Automated CI Build of FoxMesh
+
+on:
+  push:
+    branches:
+    - main
+  workflow_dispatch:
+    inputs:
+      target_branch:
+        description: 'Which branch do you want to build and test?'
+        required: true
+        default: 'main'
+
+jobs:
+  build-and-test:
+    runs-on: host
+
+    permissions:
+      contents: write # We want also create official Releases
+
+    steps:
+     - run: echo "🎉 The job was automatically triggered by a ${{ gitea.event_name }} event."
+     - run: echo "🐧 This job is now running on a ${{ runner.os }} server hosted by Gitea!"
+     - run: echo "🔎 The name of your branch is ${{ gitea.ref }} and your repository is ${{ gitea.repository }}."
+    # 1. Checkout the target branch
+    - name: Checkout Target branch
+      uses: actions/checkout@v7
+      with:
+        ref: ${{ github.event.inputs.target_branch || github.ref }}
+
+    # 2. Extract Git and Date Metadata for the dynamic artifact filename
+    - name: Generate Dynamic Artifact Metadata
+      id: meta
+      run: |
+        # Get current date in YYYYMMDD format
+        echo "CURRENT_DATE=$(date +'%Y%m%d')" >> $GITHUB_ENV
+
+        # Get short 7-character git commit hash
+        echo "GIT_HASH=$(git rev-parse --short HEAD)" >> $GITHUB_ENV
+
+        # Extract and sanitize branch name (replace slashes and special characters with dashes)
+        RAW_BRANCH=${{ github.event.inputs.target_branch || github.ref_name }}
+        CLEAN_BRANCH=$(echo "$RAW_BRANCH" | sed 's/[^a-zA-Z0-9.\-]/_§/g' | sed 's|§|-|g' | sed 's|_||g')
+        echo "GIT_BRANCH=$CLEAN_BRANCH" >> $GITHUB_ENV
+
+    # 3. Set up Python environment
+    - name: Set up Python 3.x
+      uses: actions/setup-python@v7
+      with:
+        python-version: '3.x'
+
+    # 4. Cache global PlatformIO directories, uses a dynamic key based on platformio.ini
+    - name: Cache PlatformIO
+      uses: actions/cache@v6
+      with:
+        path: |
+          ~/.cache/pio
+          ~/.platformio
+          .pio
+        key: ${{ runner.os }}-pio-${{ hashFiles('**/platformio.ini') }}
+        restore-keys: |
+          ${{ runner.os }}-pio-
+
+    # 5. Install PlatformIO Core and the required intelhex extension in a single, quiet command
+    - name: Install PlatformIO Core
+      run: python -m pip install --quiet --upgrade pip platformio intelhex
+
+    # 6. Install ESP32 Platform SDK
+    - name: Install ESP32 platform
+      run: pio pkg install --silent --global --platform espressif32
+
+    # 7. Compile the Project
+    - name: Compile the Project
+      run: pio run
+
+    # 8. Dynamically create the smart flashing scripts next to the T-Beam binary
+    # with optional bootloader detection and group check
+    # the table of flash addresses usually found at /partitions-4MB-safeboot.csv
+    - name: Create Desktop Flashing Scripts
+      run: |
+        # ----------------------------------------------------------------------
+        # 0. Flash Address Configuration  ← edit here to change the layout
+        # ----------------------------------------------------------------------
+        FLASH_BOOTLOADER_ADDR="0x1000"
+        FLASH_PARTITIONS_ADDR="0x8000"
+        FLASH_OTADATA_ADDR="0xE000"
+        FLASH_SAFEBOOT_ADDR="0x10000"
+        FLASH_FIRMWARE_ADDR="0x10000"
+
+        # ----------------------------------------------------------------------
+        # 1. Universal Linux Shell Script
+        # ----------------------------------------------------------------------
+        cat << 'EOF' > flash_esp32_board.sh
+        #!/usr/bin/env bash
+        GREEN='\033[0;32m'
+        RED='\033[0;31m'
+        YELLOW='\033[1;33m'
+        NC='\033[0m'
+
+        echo -e "${YELLOW}=== FoxMesh Universal ESP32 Flashing Script ===${NC}"
+
+        if ! command -v esptool &> /dev/null; then
+            echo -e "${RED}Error: esptool is not installed.${NC}"
+            echo "Please install it via your package manager or pip: 'pip install esptool'"
+            echo "Option Linux Arch: 'sudo pacman -Sy && sudo pacman -S extra-testing/esptool'"
+            exit 1
+        fi
+
+        FIRMWARE="firmware.bin"
+
+
+        # Firmware File
+        if [ ! -f "$FIRMWARE" ]; then
+            echo -e "${RED}Error: No matching firmware binary found in this folder!${NC}"
+            exit 1
+        fi
+
+        echo -e "${GREEN}Selected Firmware:${NC} $FIRMWARE ($BOARD_NAME)"
+        PORT=$(ls /dev/ttyUSB* /dev/ttyACM* 2>/dev/null | head -n 1)
+        if [ -z "$PORT" ]; then
+            echo -e "${RED}Error: No connected ESP32 Board (ttyUSB/ttyACM) found!${NC}"
+            exit 1
+        fi
+        echo -e "${GREEN}Detected Board on port:${NC} $PORT"
+
+        # Dynamic Permission Check: Determine required group for the specific TTY device
+        REQUIRED_GROUP=$(stat -c '%G' "$PORT")
+        if [ "$REQUIRED_GROUP" != "root" ]; then
+            if ! groups "$USER" | grep -q "\b${REQUIRED_GROUP}\b"; then
+                echo -e "${RED}Error: You do not have permissions to access $PORT.${NC}"
+                echo -e "The device belongs to the group: ${YELLOW}$REQUIRED_GROUP${NC}"
+                echo -e "Please add your user to this group by running:"
+                echo -e "  ${GREEN}sudo usermod -aG $REQUIRED_GROUP \$USER${NC}"
+                echo -e "After running the command, please log out and log back in for the changes to take effect."
+                exit 1
+            fi
+        fi
+
+        # Build flash arguments from the address table (only include files that exist)
+        FLASH_ARGS=""
+        if [ -f "bootloader.bin" ]; then
+          FLASH_ARGS="$FLASH_ARGS __BOOTLOADER_ADDR__ bootloader.bin"
+        fi
+        if [ -f "partitions.bin" ]; then
+          FLASH_ARGS="$FLASH_ARGS __PARTITIONS_ADDR__ partitions.bin"
+        fi
+        if [ -f "otadata.bin" ]; then
+          FLASH_ARGS="$FLASH_ARGS __OTADATA_ADDR__ otadata.bin"
+        fi
+        if [ -f "safeboot.bin" ]; then
+          FLASH_ARGS="$FLASH_ARGS __SAFEBOOT_ADDR__ safeboot.bin"
+        fi
+        FLASH_ARGS="$FLASH_ARGS __FIRMWARE_ADDR__ $FIRMWARE"
+
+        echo -e "${GREEN}Flashing:${NC}$FLASH_ARGS"
+        esptool --chip esp32 --port "$PORT" --baud 921600 write-flash -z $FLASH_ARGS
+
+        if [ $? -eq 0 ]; then
+            echo -e "${GREEN}=== Success! $BOARD_NAME successfully updated ===${NC}"
+        else
+            echo -e "${RED}=== Flash failed! ===${NC}"
+            exit 1
+        fi
+        EOF
+
+        # Substitute address placeholders with configured hex values
+        sed -i \
+          -e "s|__BOOTLOADER_ADDR__|${FLASH_BOOTLOADER_ADDR}|g" \
+          -e "s|__PARTITIONS_ADDR__|${FLASH_PARTITIONS_ADDR}|g" \
+          -e "s|__OTADATA_ADDR__|${FLASH_OTADATA_ADDR}|g" \
+          -e "s|__SAFEBOOT_ADDR__|${FLASH_SAFEBOOT_ADDR}|g" \
+          -e "s|__FIRMWARE_ADDR__|${FLASH_FIRMWARE_ADDR}|g" \
+          flash_esp32_board.sh
+        chmod +x flash_esp32_board.sh
+
+        # ----------------------------------------------------
+        # 2. Universal Windows Batch Script
+        # ----------------------------------------------------
+        cat << 'EOF' > flash_esp32_board.bat
+        @echo off
+        setlocal enabledelayedexpansion
+        echo ===================================================
+        echo === FoxMesh Universal ESP32 Windows Flashing ======
+        echo ===================================================
+
+        set "FIRMWARE=firmware.bin"
+
+        if not exist "!FIRMWARE!" (
+            echo [ERROR] No matching firmware binary found in this folder!
+            pause
+            exit /b 1
+        )
+
+        echo [INFO] Selected Firmware: %FIRMWARE% (%BOARD_NAME%)
+
+        set "COMPORT="
+        for /f "tokens=2 delims=()" %%A in ('wmic path Win32_PnPEntity get Name ^| findstr /i "COM" ^| findstr /i "Silicon CP210 CH340 CH9102 USB-to-UART"') do set "COMPORT=%%A"
+        if "%COMPORT%"=="" (
+          for /f "tokens=2 delims=()" %%A in ('wmic path Win32_PnPEntity get Name ^| findstr /i "(COM"') do set "COMPORT=%%A"
+        )
+        if "%COMPORT%"=="" (
+          echo [ERROR] No ESP32 Board or USB-UART bridge detected!
+          pause
+          exit /b 1
+        )
+        echo [INFO] Detected Board on port: %COMPORT%
+
+        set "FLASH_ARGS="
+        if exist "bootloader.bin" (
+          set "FLASH_ARGS=!FLASH_ARGS! __BOOTLOADER_ADDR__ bootloader.bin"
+        )
+        if exist "partitions.bin" (
+          set "FLASH_ARGS=!FLASH_ARGS! __PARTITIONS_ADDR__ partitions.bin"
+        )
+        if exist "otadata.bin" (
+          set "FLASH_ARGS=!FLASH_ARGS! __OTADATA_ADDR__ otadata.bin"
+        )
+        if exist "safeboot.bin" (
+          set "FLASH_ARGS=!FLASH_ARGS! __SAFEBOOT_ADDR__ safeboot.bin"
+        )
+        set "FLASH_ARGS=!FLASH_ARGS! __FIRMWARE_ADDR__ %FIRMWARE%"
+
+        echo [INFO] Flashing: !FLASH_ARGS!
+        esptool --chip esp32 --port %COMPORT% --baud 921600 write-flash -z !FLASH_ARGS!
+
+        if %ERRORLEVEL% EQU 0 (
+          echo === SUCCESS! Flash operation successfully completed ===
+        ) else (
+          echo [ERROR] Flash failed!
+          pause
+          exit /b 1
+        )
+        pause
+        EOF
+
+        # Substitute address placeholders with configured hex values
+        sed -i \
+          -e "s|__BOOTLOADER_ADDR__|${FLASH_BOOTLOADER_ADDR}|g" \
+          -e "s|__PARTITIONS_ADDR__|${FLASH_PARTITIONS_ADDR}|g" \
+          -e "s|__OTADATA_ADDR__|${FLASH_OTADATA_ADDR}|g" \
+          -e "s|__SAFEBOOT_ADDR__|${FLASH_SAFEBOOT_ADDR}|g" \
+          -e "s|__FIRMWARE_ADDR__|${FLASH_FIRMWARE_ADDR}|g" \
+          flash_esp32_board.bat
+
+        # -----------------------------------------------------------------------------
+        # 3. Gather binaries and scripts into target directory for structural packaging
+        # -----------------------------------------------------------------------------
+        mkdir -p deploy_package
+        BUILD_OUTPUT=".pio/build/ttgo-lora32-v21"
+
+        # Copy binaries only if they exist
+        [ -f "$BUILD_OUTPUT/firmware.bin" ] && cp "$BUILD_OUTPUT/firmware.bin" ./deploy_package/
+        [ -f "$BUILD_OUTPUT/bootloader.bin" ] && cp "$BUILD_OUTPUT/bootloader.bin" ./deploy_package/
+        [ -f "$BUILD_OUTPUT/partitions.bin" ] && cp "$BUILD_OUTPUT/partitions.bin" ./deploy_package/
+        [ -f "$BUILD_OUTPUT/otadata.bin" ] && cp "$BUILD_OUTPUT/otadata.bin" ./deploy_package/
+        [ -f "$BUILD_OUTPUT/safeboot.bin" ] && cp "$BUILD_OUTPUT/safeboot.bin" ./deploy_package/
+
+        # Move flash scripts into the deployment directory
+        mv flash_esp32_board.sh ./deploy_package/
+        mv flash_esp32_board.bat ./deploy_package/
+
+    # 9. Dynamic Artifact Upload: FoxMesh-branch-date-hash.zip
+    - name: Upload Compiled Firmware Package
+      uses: actions/upload-artifact@v7
+      with:
+        name: FoxMesh-${{ env.GIT_BRANCH }}-${{ env.CURRENT_DATE }}-${{ env.GIT_HASH }}
+        path: deploy_package/
+        retention-days: 10 # Artifacts will be automatically deleted after 10 days
@@ -21,6 +21,10 @@ jobs:
      contents: write # We want also create official Releases

    steps:
+    - run: echo "🎉 The job was automatically triggered by a ${{ github.event_name }} event."
+    - run: echo "🐧 This job is now running on a ${{ runner.os }} server hosted by Gitea!"
+    - run: echo "🔎 The name of your branch is ${{ github.ref }} and your repository is ${{ github.repository }}."
+
    # 1. Checkout the target branch
    - name: Checkout Target branch
      uses: actions/checkout@v7