- innesco-protocol: ECS wire protocol client (port of ecs/protocol.py) - innesco-decoding: 13-byte frame decoder (port of csrc/decoding.c), golden tests mirror tests/test_decode_golden.py (14/14 green) - innesco-cli: ping / decode subcommands - scripts/build-arm64.sh: rootless cross build for AMD Kria K26 (aarch64 via cargo-zigbuild + zig, musl static default) - zero external dependencies (std only)
2.8 KiB
innesco-rs
Rust clone of innesco (the IGNITE64 control/DAQ software, timespot/innesco
on baltig). This repo is a separate clean-room-style port: the original
Python/C repository is untouched, and its license/authorship is respected.
Deployment target: AMD Kria K26 SOM (Zynq UltraScale+ MPSoC, quad Cortex-A53, aarch64, Ubuntu 22.04) — the board buffering/timestamping the IGNITE64 detector data.
Layout
| crate | ported from | status |
|---|---|---|
innesco-protocol |
innesco/ecs/protocol.py |
ECS wire protocol (Read/Write/Ping, >BI headers) + TCP client |
innesco-decoding |
innesco/decoding/csrc/decoding.c |
13-byte frame decoder, DCO calibration, position map; golden tests |
innesco-cli |
— | ping, decode subcommands (zero-dependency) |
Zero external dependencies (pure std): cross-compiling for arm64 needs no
cross-linked C libraries, and release binaries are small (panic = "abort", LTO).
Build (x86_64 host)
cargo test --workspace # golden tests
cargo build --release # host binary
export CARGO_TARGET_DIR=/tmp/innesco-rs-target # keep artifacts off NFS
Build for arm64 (Kria K26)
scripts/build-arm64.sh --run-tests # static musl binary (recommended)
scripts/build-arm64.sh --gnu # dynamic, glibc (Ubuntu 22.04 on board)
The script bootstraps everything without root: rustup target add,
a ziglang pip venv as cross linker (via cargo-zigbuild), then
cargo zigbuild --release --target aarch64-unknown-linux-musl.
Artifacts land in dist/aarch64-<musl|gnu>/innesco-cli.
Deploy to the Kria: scp dist/aarch64-musl/innesco-cli <board>:~/ && ssh <board> ./innesco-cli ping localhost 8888.
Porting notes
See docs/porting-notes.md for the Python/C → Rust mapping and the
(deliberate) divergences from the C extension (64-bit arithmetic where the C
overflows 32-bit, strict socket reads where Python truncated silently,
skip-and-count instead of abort on malformed packets).
Open Points
(user-editable — tell me here what to focus on)
- Storage layer: parquet/arrow output (polars-rust or arrow2) to replace
ParquetStorage— not ported yet,decodeprints TSV instead. - REST API: axum port of
rest_api.py(/ping,/state,/tag, …) — planned; needs an HTTP crate dependency decision. - Board/slow-control model:
Board.py/quadrant.py/mattonella.pyregister model (supermattonelle 4-7 broadcast-only, FastIN registers) — domain logic ready to port on request. - Real-board validation: run
innesco-cli ping+ a decode against the actual data_server on a Kria board (needs network access to the setup). - CI runner:
.gitea/workflows/ci.ymlis in place, but this Gitea may have no Actions runner configured — currently CI runs locally.