0 Fork 0

Files

T

chore: repoint remaining links at git.swaits.com

Rewrites lingering github.com / *.sr.ht references to this Gitea instance,
translating GitHub and Sourcehut URL shapes to Gitea's (/blob/<ref>/ and
sr.ht /tree/<ref>/item/ -> /src/branch/<ref>/, /tree/<tag> -> /src/tag/<tag>,
/actions/workflows/X -> /actions?workflow=X, /edit/ -> /_edit/).

Left pointing at the old hosts on purpose: pull-request links (PRs were not
migrated), forks that were never migrated, and GitHub-only surfaces Gitea
lacks. OpenPGP identity proofs are untouched by design.

2026-08-31 18:32:09 -06:00

2.3 KiB

Raw Permalink Blame History

Contributing to DongLoRa

Adding Board Support

DongLoRa is designed to make adding new boards easy:

Create firmware/src/board/your_board.rs implementing the init() function
Add a Cargo feature in firmware/Cargo.toml with the board's dependencies
Add the board's feature/target/chip to the justfile boards list
firmware/build.rs auto-discovers the new file and generates the module selector

See existing board files (heltec_v3.rs, rak_wisblock_4631.rs) as templates. Each board file owns all hardware init and returns peripheral bundles that the common tasks consume. No shared board code — each board is self-contained.

Code Style

Clippy-clean. just clippy <board> must pass with no warnings.
No panics in tasks. Use match/if let/warn! — never .unwrap() in async task code. Board init (runs once at startup) may use .expect("reason").
Display rendering uses .ok(). Drawing is best-effort; display errors are not recoverable.
Every let _ = gets an inline comment explaining why the result is discarded.

Client Libraries

Client libraries exist in Python and Rust. To add a library in another language:

Create a directory with the language's standard project layout
Implement the wire protocol from firmware/PROTOCOL.md
Include device discovery (USB VID 1209, PID 5741)
Include COBS framing, command encoding, and response decoding
Add a mux client (connect to the mux daemon's Unix socket or TCP)

The protocol is intentionally simple — 8 commands, 7 responses, fixed-size LE. A minimal client library should be implementable in a weekend.

Building and Testing

cd firmware
just check-all      # Compile-check all boards
just build-all      # Build release firmware for all boards
just clippy <board> # Lint a specific board
just test           # Host-side protocol unit tests

Tool versions are pinned in each project's mise.toml. Tools are installed automatically on first run.

Commits

Conventional Commits format
Logically grouped (one concern per commit)
We use jj for version control

2.3 KiB Raw Permalink Blame History