https://github.com/meshtastic/gh-action-firmware
Build Meshtastic firmware in an Action-container
https://github.com/meshtastic/gh-action-firmware
Last synced: 8 months ago
JSON representation
Build Meshtastic firmware in an Action-container
- Host: GitHub
- URL: https://github.com/meshtastic/gh-action-firmware
- Owner: meshtastic
- License: gpl-3.0
- Created: 2025-07-06T04:22:27.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-09-26T11:23:10.000Z (9 months ago)
- Last Synced: 2025-10-01T18:34:17.568Z (9 months ago)
- Language: Shell
- Size: 31.3 KB
- Stars: 1
- Watchers: 0
- Forks: 4
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# gh-action-firmware
Build Meshtastic firmware in an Action-container
## Usage
This action is meant to be used with [meshtastic/firmware](https://github.com/meshtastic/firmware) or forks.
### Example workflow
```yaml
jobs:
build-nrf52:
runs-on: ubuntu-24.04
steps:
- uses: actions/checkout@v4
with:
repository: meshtastic/firmware
ref: master
- name: Get release version string
shell: bash
run: echo "long=$(./bin/buildinfo.py long)" >> $GITHUB_OUTPUT
id: version
- name: Build T-Echo
id: build
uses: meshtastic/gh-action-firmware@main
with:
pio_platform: nrf52
pio_env: t-echo
pio_target: build
- name: Store binaries as an artifact
uses: actions/upload-artifact@v4
with:
name: firmware-nrf52840-${{ inputs.board }}-${{ steps.version.outputs.long }}.zip
overwrite: true
path: |
release/*.uf2
release/*.elf
```
### Parameters
|Parameter|Description|Required|Default|
|---------|-----------|--------|-------|
|`pio_platform`|PlatformIO Platform|Yes||
|`pio_env`|PlatformIO "environment" (board)|Yes||
|`pio_target`|PlatformIO target operation|No|`build`|
|`ota_firmware_source`|OTA Binary to use (ESP32-only)|No||
|`ota_firmware_target`|OTA Binary destination (ESP32-Only)|No||