Release v0.3.1 #2
Workflow file for this run
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: Release | |
| # Triggered when a version tag is pushed (e.g. `git tag v0.3.0 && git push --tags`). | |
| # Creates a GitHub release with precompiled x86_64 binaries. | |
| # | |
| # C-V2X (aarch64) binaries cannot be built in CI because they require the | |
| # proprietary Qualcomm Telux SDK sysroot (headers + .so files). Build them | |
| # locally with `cohda-toolchain/build-cv2x.sh --release` and attach them to | |
| # the release manually — see the job "attach-cv2x-instructions" output. | |
| on: | |
| push: | |
| tags: | |
| - "v*" | |
| permissions: | |
| contents: write # needed to create releases and upload assets | |
| env: | |
| CARGO_TERM_COLOR: always | |
| jobs: | |
| # ── Build x86_64 binaries (all non-cv2x examples) ──────────────────────── | |
| build-x86_64: | |
| name: Build x86_64 binaries | |
| runs-on: ubuntu-latest | |
| steps: | |
| - uses: actions/checkout@v4 | |
| - uses: dtolnay/rust-toolchain@stable | |
| with: | |
| targets: x86_64-unknown-linux-musl | |
| - uses: Swatinem/rust-cache@v2 | |
| - name: Install musl toolchain | |
| run: sudo apt-get update && sudo apt-get install -y musl-tools | |
| - name: Build all examples (release, musl static) | |
| run: cargo build --release --examples --target x86_64-unknown-linux-musl | |
| - name: Collect binaries | |
| run: | | |
| mkdir -p dist/x86_64 | |
| EXAMPLES=( | |
| v2x_cli | |
| denm_sender_receiver | |
| generate_certificate_chain | |
| ) | |
| for ex in "${EXAMPLES[@]}"; do | |
| cp "target/x86_64-unknown-linux-musl/release/examples/${ex}" "dist/x86_64/" | |
| done | |
| - name: Create x86_64 tarball | |
| run: | | |
| cd dist | |
| tar czf "rustflexstack-${GITHUB_REF_NAME}-x86_64-linux.tar.gz" x86_64/ | |
| - name: Upload artifact | |
| uses: actions/upload-artifact@v4 | |
| with: | |
| name: x86_64-binaries | |
| path: dist/rustflexstack-*-x86_64-linux.tar.gz | |
| # ── Build aarch64 binaries (non-cv2x only) ────────────────────────────── | |
| build-aarch64: | |
| name: Build aarch64 binaries (non-cv2x) | |
| runs-on: ubuntu-latest | |
| steps: | |
| - uses: actions/checkout@v4 | |
| - uses: dtolnay/rust-toolchain@stable | |
| with: | |
| targets: aarch64-unknown-linux-musl | |
| - uses: Swatinem/rust-cache@v2 | |
| - name: Install cross | |
| run: cargo install cross --git https://github.com/cross-rs/cross | |
| - name: Build all examples (release, musl static) | |
| run: cross build --release --examples --target aarch64-unknown-linux-musl | |
| - name: Collect binaries | |
| run: | | |
| mkdir -p dist/aarch64 | |
| EXAMPLES=( | |
| v2x_cli | |
| denm_sender_receiver | |
| generate_certificate_chain | |
| ) | |
| for ex in "${EXAMPLES[@]}"; do | |
| cp "target/aarch64-unknown-linux-musl/release/examples/${ex}" "dist/aarch64/" | |
| done | |
| - name: Create aarch64 tarball | |
| run: | | |
| cd dist | |
| tar czf "rustflexstack-${GITHUB_REF_NAME}-aarch64-linux.tar.gz" aarch64/ | |
| - name: Upload artifact | |
| uses: actions/upload-artifact@v4 | |
| with: | |
| name: aarch64-binaries | |
| path: dist/rustflexstack-*-aarch64-linux.tar.gz | |
| # ── Create GitHub release ──────────────────────────────────────────────── | |
| release: | |
| name: Create GitHub release | |
| needs: [build-x86_64, build-aarch64] | |
| runs-on: ubuntu-latest | |
| steps: | |
| - uses: actions/checkout@v4 | |
| - name: Download x86_64 artifacts | |
| uses: actions/download-artifact@v4 | |
| with: | |
| name: x86_64-binaries | |
| path: dist/ | |
| - name: Download aarch64 artifacts | |
| uses: actions/download-artifact@v4 | |
| with: | |
| name: aarch64-binaries | |
| path: dist/ | |
| - name: Create release | |
| uses: softprops/action-gh-release@v2 | |
| with: | |
| draft: false | |
| generate_release_notes: true | |
| files: | | |
| dist/rustflexstack-*-x86_64-linux.tar.gz | |
| dist/rustflexstack-*-aarch64-linux.tar.gz | |
| body: | | |
| ## Precompiled binaries | |
| | Archive | Architecture | Link layer | Contents | | |
| |---------|-------------|------------|----------| | |
| | `rustflexstack-v0.3.0-x86_64-linux.tar.gz` | x86_64 | Raw Ethernet | v2x_cli, denm_sender_receiver, generate_certificate_chain | | |
| | `rustflexstack-v0.3.0-aarch64-linux.tar.gz` | aarch64 | Raw Ethernet | Same as x86_64 (for ARM64 devices without C-V2X) | | |
| | `v2x_cli_cv2x` | aarch64 | C-V2X (PC5) | Comprehensive V2X CLI for Cohda MK6 devices | | |
| | `cv2x_denm_sender_receiver` | aarch64 | C-V2X (PC5) | DENM sender/receiver for Cohda MK6 devices | | |
| ### C-V2X binaries (Cohda MK6) | |
| The C-V2X binaries are precompiled and attached to this release. They target **Cohda MK6** on-board units (AArch64 / Qualcomm SA515M) and use the C-V2X PC5 radio interface for direct vehicle-to-vehicle communication. | |
| > **Licensing note:** The binaries themselves are provided under AGPL-3.0 and contain only RustFlexstack code. However, the cross-compilation toolchain used to build them depends on the proprietary Qualcomm Telux SDK (headers and shared libraries), which cannot be redistributed. The Telux shared libraries (`libtelux_cv2x.so`, `libtelux_common.so`, etc.) are **not** bundled — they are part of the Qualcomm firmware already present on MK6 devices. If you need to rebuild these binaries, you must obtain the Telux SDK separately from Qualcomm or Cohda Wireless. | |
| #### What do the C-V2X binaries do? | |
| - **`v2x_cli_cv2x`** — A full-featured V2X node that transmits and receives CAM, DENM, and VAM messages over the C-V2X PC5 sidelink radio. Supports ETSI security (IEEE 1609.2 signing and verification), live GPS via GPSD, and a Local Dynamic Map (LDM) for tracking nearby ITS stations. Run with `--help` for all options. | |
| - **`cv2x_denm_sender_receiver`** — A focused DENM (Decentralized Environmental Notification Message) example that sends and receives road hazard warnings over C-V2X. | |
| Both binaries require `cv2x-daemon` to be running on the MK6 device and the `rmnet_data16` network interface to be up. |