Build ESP-Hosted Firmware #6
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| name: Build ESP-Hosted Firmware | |
| on: | |
| push: | |
| branches: [main] | |
| tags: ['v*'] | |
| pull_request: | |
| workflow_dispatch: | |
| inputs: | |
| version: | |
| description: 'ESP-Hosted-MCU version to build' | |
| type: string | |
| default: '2.7.3' | |
| release: | |
| description: 'Create a release' | |
| type: boolean | |
| default: true | |
| env: | |
| ESP_IDF_VERSION: v5.5.1 | |
| ESP_HOSTED_VERSION: ${{ inputs.version || '2.7.3' }} | |
| jobs: | |
| build: | |
| runs-on: ubuntu-latest | |
| container: | |
| image: espressif/idf:v5.5.1 | |
| strategy: | |
| fail-fast: false | |
| matrix: | |
| target: | |
| - esp32 | |
| # - esp32s2 | |
| - esp32s3 | |
| - esp32c2 | |
| - esp32c3 | |
| - esp32c5 | |
| - esp32c6 | |
| - esp32c61 | |
| steps: | |
| - name: Checkout | |
| uses: actions/checkout@v4 | |
| - name: Create project from esp_hosted slave example | |
| run: | | |
| . $IDF_PATH/export.sh | |
| idf.py create-project-from-example "espressif/esp_hosted==${{ env.ESP_HOSTED_VERSION }}:slave" | |
| - name: Build firmware | |
| working-directory: slave | |
| run: | | |
| . $IDF_PATH/export.sh | |
| idf.py set-target ${{ matrix.target }} | |
| idf.py build | |
| - name: Prepare artifacts | |
| run: | | |
| mkdir -p artifacts | |
| cp slave/build/network_adapter.bin artifacts/network_adapter_${{ matrix.target }}.bin | |
| sha256sum artifacts/network_adapter_${{ matrix.target }}.bin > artifacts/network_adapter_${{ matrix.target }}.bin.sha256 | |
| - name: Upload artifacts | |
| uses: actions/upload-artifact@v4 | |
| with: | |
| name: firmware-${{ matrix.target }} | |
| path: artifacts/ | |
| release: | |
| needs: build | |
| runs-on: ubuntu-latest | |
| if: startsWith(github.ref, 'refs/tags/v') || inputs.release | |
| permissions: | |
| contents: write | |
| steps: | |
| - name: Download all artifacts | |
| uses: actions/download-artifact@v4 | |
| with: | |
| path: firmware | |
| merge-multiple: true | |
| - name: Create Release | |
| uses: softprops/action-gh-release@v2 | |
| with: | |
| tag_name: v${{ env.ESP_HOSTED_VERSION }} | |
| files: firmware/* | |
| generate_release_notes: true | |
| manifest: | |
| needs: release | |
| runs-on: ubuntu-latest | |
| permissions: | |
| contents: write | |
| strategy: | |
| fail-fast: false | |
| matrix: | |
| target: | |
| - esp32 | |
| # - esp32s2 | |
| - esp32s3 | |
| - esp32c2 | |
| - esp32c3 | |
| - esp32c5 | |
| - esp32c6 | |
| - esp32c61 | |
| steps: | |
| - name: Generate manifest | |
| env: | |
| GH_TOKEN: ${{ github.token }} | |
| run: | | |
| TARGET="${{ matrix.target }}" | |
| REPO="${{ github.repository }}" | |
| # Get all release tags | |
| TAGS=$(gh release list --repo "$REPO" --json tagName -q '.[].tagName') | |
| # Build manifest using jq | |
| echo '{"versions":[]}' > manifest.json | |
| for TAG in $TAGS; do | |
| # Skip manifest tag | |
| if [ "$TAG" = "manifest" ]; then | |
| continue | |
| fi | |
| VERSION="${TAG#v}" | |
| SHA256_FILE="network_adapter_${TARGET}.bin.sha256" | |
| # Download SHA256 file using gh CLI (handles auth properly) | |
| if gh release download "$TAG" --repo "$REPO" --pattern "$SHA256_FILE" --clobber 2>/dev/null; then | |
| SHA256=$(awk '{print $1}' "$SHA256_FILE") | |
| rm -f "$SHA256_FILE" | |
| if [ -n "$SHA256" ] && [ ${#SHA256} -eq 64 ]; then | |
| BIN_URL="https://github.com/${REPO}/releases/download/${TAG}/network_adapter_${TARGET}.bin" | |
| # Add to manifest using jq | |
| jq --arg ver "$VERSION" --arg url "$BIN_URL" --arg sha "$SHA256" \ | |
| '.versions += [{"version": $ver, "url": $url, "sha256": $sha}]' \ | |
| manifest.json > tmp.json && mv tmp.json manifest.json | |
| fi | |
| fi | |
| done | |
| # Sort versions descending (newest first) | |
| jq '.versions |= sort_by(.version | split(".") | map(tonumber)) | .versions |= reverse' \ | |
| manifest.json > ${TARGET}.json | |
| - name: Upload manifest to release | |
| env: | |
| GH_TOKEN: ${{ github.token }} | |
| run: | | |
| # Create manifest release if it doesn't exist | |
| gh release view manifest --repo "${{ github.repository }}" >/dev/null 2>&1 || \ | |
| gh release create manifest --repo "${{ github.repository }}" --title "Firmware Manifests" --notes "JSON manifests listing all firmware versions for each target." | |
| gh release upload manifest \ | |
| --repo "${{ github.repository }}" \ | |
| --clobber \ | |
| ${{ matrix.target }}.json | |
| deploy-pages: | |
| needs: release | |
| runs-on: ubuntu-latest | |
| permissions: | |
| contents: write | |
| pages: write | |
| id-token: write | |
| environment: | |
| name: github-pages | |
| url: ${{ steps.deployment.outputs.page_url }} | |
| steps: | |
| - name: Get latest release | |
| id: get_release | |
| env: | |
| GH_TOKEN: ${{ github.token }} | |
| run: | | |
| LATEST_TAG=$(gh release list --repo "${{ github.repository }}" --json tagName,isLatest -q '.[] | select(.isLatest == true) | .tagName') | |
| echo "latest_tag=$LATEST_TAG" >> $GITHUB_OUTPUT | |
| - name: Download all bin files from latest release | |
| env: | |
| GH_TOKEN: ${{ github.token }} | |
| run: | | |
| mkdir -p public | |
| gh release download "${{ steps.get_release.outputs.latest_tag }}" \ | |
| --repo "${{ github.repository }}" \ | |
| --pattern "*.bin" \ | |
| --dir public | |
| - name: Create index.html | |
| run: | | |
| REPO_OWNER=$(echo "${{ github.repository }}" | cut -d'/' -f1) | |
| REPO_NAME=$(echo "${{ github.repository }}" | cut -d'/' -f2) | |
| BASE_URL="https://${REPO_OWNER}.github.io/${REPO_NAME}" | |
| cat > public/index.html << EOF | |
| <!DOCTYPE html> | |
| <html> | |
| <head> | |
| <title>ESP-Hosted MCU Firmware</title> | |
| <style> | |
| body { font-family: Arial, sans-serif; margin: 40px; } | |
| h1 { color: #333; } | |
| ul { list-style-type: none; padding: 0; } | |
| li { margin: 10px 0; } | |
| a { color: #0366d6; text-decoration: none; } | |
| a:hover { text-decoration: underline; } | |
| .url { font-family: monospace; background: #f6f8fa; padding: 2px 6px; border-radius: 3px; } | |
| </style> | |
| </head> | |
| <body> | |
| <h1>ESP-Hosted MCU Firmware - Latest Release</h1> | |
| <p>Release: ${{ steps.get_release.outputs.latest_tag }}</p> | |
| <h2>Available Firmware Files:</h2> | |
| <ul> | |
| EOF | |
| for file in public/*.bin; do | |
| filename=$(basename "$file") | |
| echo " <li><a href=\"$filename\">$filename</a> - <span class=\"url\">${BASE_URL}/${filename}</span></li>" >> public/index.html | |
| done | |
| cat >> public/index.html << 'EOF' | |
| </ul> | |
| </body> | |
| </html> | |
| EOF | |
| - name: Setup Pages | |
| uses: actions/configure-pages@v4 | |
| - name: Upload artifact | |
| uses: actions/upload-pages-artifact@v3 | |
| with: | |
| path: public | |
| - name: Deploy to GitHub Pages | |
| id: deployment | |
| uses: actions/deploy-pages@v4 |