Packet.Ax25.Sdl
0.13.0
dotnet add package Packet.Ax25.Sdl --version 0.13.0
NuGet\Install-Package Packet.Ax25.Sdl -Version 0.13.0
<PackageReference Include="Packet.Ax25.Sdl" Version="0.13.0" />
<PackageVersion Include="Packet.Ax25.Sdl" Version="0.13.0" />
<PackageReference Include="Packet.Ax25.Sdl" />
paket add Packet.Ax25.Sdl --version 0.13.0
#r "nuget: Packet.Ax25.Sdl, 0.13.0"
#:package Packet.Ax25.Sdl@0.13.0
#addin nuget:?package=Packet.Ax25.Sdl&version=0.13.0
#tool nuget:?package=Packet.Ax25.Sdl&version=0.13.0
ax25sdl
Tooling + distribution for the AX.25 SDL state tables: a codegen pipeline that turns the normative SDL transcriptions into ready-to-consume libraries in seven languages. The figc4.x state-machine figures are encoded once, with discipline, in packethacking/ax25spec — the community home of everything normative about AX.25, prose and figures — and this repo emits that single source of truth as native idiomatic code for C#, Go, TypeScript, JSON, Rust, C, and Python. Downstream runtimes walk the generated tables — they don't have an opinion of their own about what AX.25 says.
Where changes go: figure/spec changes (graphml, yaml transcriptions, citations, catalogues) are PRs against
packethacking/ax25spec; a pin-bump PR here then regenerates the language backends. Only tooling (walker/emitters/lint), generated backends and packaging change in this repo.
Inputs
The SDL sources live in the packethacking/ax25spec git submodule at ax25spec/, pinned to a specific commit (the same pin-bump cadence packet.net uses towards this repo). A spec-sdl -> ax25spec/spec-sdl symlink keeps every historical path working. Clone with git clone --recurse-submodules (or run git submodule update --init after a plain clone).
| Path | What |
|---|---|
spec-sdl/v2.2-errata/data-link/ |
The figc4.1 – figc4.7 data-link state machine (v2.2 + errata), split by artefact kind: sdl/ holds the canonical *.graphml yEd sources, yaml/ holds the *.sdl.yaml transcriptions (derived) plus the *.citations.yaml human-curated sidecars, mmd/ holds the *.g.mmd Mermaid renderings (derived). |
spec-sdl/v2.2/ |
Clean published v2.2 (black-only, no errata). Currently empty — backfill pending. |
spec-sdl/schema/ |
JSON Schema for *.sdl.yaml |
spec-sdl/actions.yaml |
Action-verb normalisation table (figure spellings → canonical verbs) |
spec-sdl/events.yaml |
Canonical event catalog |
| Upstream | The AX.25 v2.2 specification figures themselves — the source of truth for every transcription |
Outputs
| Artefact | Where | Name | In-repo source |
|---|---|---|---|
| C# library | NuGet | Packet.Ax25.Sdl |
spec/csharp/ |
| TypeScript library | npm | ax25sdl |
spec/ts/ |
| Go module | git | github.com/m0lte/ax25sdl/spec/go |
spec/go/ |
| Rust crate | crates.io (publishable; not yet published) | ax25sdl (no_std-capable) |
spec/rust/ |
| C / Python / JSON | not externally packaged | codegen output for in-tree consumers | per-backend dirs |
Saves
Each state also carries the inputs it saves (the figures' Save symbol, "Requeue"; save: in the yaml): C# DataLink_AwaitingConnection.Saves (IReadOnlyList<Ax25Event>), Go StatePage.Saves, TypeScript StatePage.saves, Rust StatePage::saves, C StatePage.saves / saves_len, Python StatePage.saves, JSON "saves". A saved input has no transition in that state. A runtime must not treat it as unhandled: hold it in arrival order, and each time the machine enters a state (the same state included) consume the first held input that state does not save. An explicit save beats the page's "all other" column. Today four exist: DL-DISCONNECT Request in Awaiting Connection and Awaiting V2.2 Connection, and MDL-NEGOTIATE Request and XID Command in Management Data Link Negotiating. The full semantics are in docs/golden-traces.md.
Tagging v* on main fires .github/workflows/publish.yml — NuGet + npm publish from the same tag, version taken from the tag stripped of its leading v.
Discipline
The transcription rules and how to add a new figure live in:
docs/sdl-primer.md— SDL shape referencedocs/sdl-transcription-runbook.md— end-to-end per-figure workflowdocs/sdl-verb-catalogue.md— action-verb normalisationdocs/lint-totality.md- the totality / determinism lint: every (state, event) arm and subroutine must decide every feasible guard-atom valuation exactly once, and the allow-list contract for known figure findingsdocs/adr/0001-sdl-dsl.md— why YAML + codegen rather than hand-written tables
Semantic validation — golden traces
Transcription fidelity (graphml → YAML → generated tables) is proved by the
drift jobs; behavioural fidelity is proved by the golden-trace suite. A
reference interpreter (codegen/src/Packet.Sdl.Interpreter/)
executes the emitted JSON tables directly — events in, abstract effects
(frames, DL primitives, internal-queue posts) out — and each scenario in
traces/ replays a protocol exchange against it with
expectations derived from the AX.25 v2.2 prose, cited section by section.
dotnet test codegen/tests/Packet.Sdl.Interpreter.Tests
Where a trace fails because the figure itself is defective, it is not bent
to match: it carries expected_failure: <upstream-issue-url> and runs as a
strict xfail (it must keep failing until the upstream fix lands, then the
suite demands the marker's removal). How to add a trace, the file format,
and the interpreter's execution policies are documented in
docs/golden-traces.md.
Beyond single-machine traces, the two-station explorer (codegen/src/Packet.Sdl.Explorer) composes two interpreter instances over a modelled lossy channel and searches every interleaving for cross-station invariant violations (delivery safety, reject coherence, acknowledgement coherence, quiescence). Its calibration suite must rediscover the catalogued figure defects on pre-fix table fixtures before any novel finding is believed; see docs/explorer.md.
The SREJ sender-side scenarios (traces/srej-*.trace.yaml) were authored clean-room from the prose and direwolf alone and committed before they were ever executed, as an independence control on the SREJ table fix; the protocol and its outcome are recorded in packet-net/ax25sdl#76.
Provenance
Extracted from packet.net (then m0lte/packet.net) on 2026-05-17 — the transcriptions and codegen previously lived alongside the .NET runtime in that monorepo. The SDL transcriptions moved on again to packethacking/ax25spec in 2026-07, making that repo the single normative home (prose + figures) and this one tooling + distribution. History preserved via git filter-repo at both steps.
Sibling repos
| Repo | Relationship |
|---|---|
packethacking/ax25spec |
upstream — normative SDL sources, consumed here as a pinned submodule |
packet-net/packet.net |
consumes Packet.Ax25.Sdl (NuGet) |
packet-net/ax25-ts |
consumes ax25sdl (npm) |
packet-net/packet-term-tui |
transitive: Packet.Ax25 → Packet.Ax25.Sdl |
packet-net/packet-term-web |
transitive: @packet-net/ax25 → ax25sdl |
License
MIT. Spec text and figures derive from the AX.25 v2.2 specification; the transcription discipline that turns figures into machine-checkable YAML is documented in docs/sdl-transcription-runbook.md.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- No dependencies.
NuGet packages (9)
Showing the top 5 NuGet packages that depend on Packet.Ax25.Sdl:
| Package | Downloads |
|---|---|
|
Packet.Ax25
AX.25 v2.2 protocol library: frame codec for U/S/I frames with mod-8 sequence numbers, SDL-driven connected-mode session machine, Ax25Listener for inbound session acceptance with per-peer caching, AcceptIncoming toggle, and frame-traced event hooks. Walks the AX.25 SDL transitions from Packet.Ax25.Sdl. Source: github.com/packet-net/packet.net. |
|
|
Packet.Kiss
KISS (Keep It Simple, Stupid) framing encoder/decoder, ACKMODE handling, multi-drop port support, and TCP transport. Decodes KISS-Data payloads into typed Ax25Frame events. Pair with Packet.Ax25 for connected-mode sessions. Source: github.com/packet-net/packet.net. |
|
|
Packet.Kiss.Serial
Generic serial-port KISS modem implementing IAx25Transport for the Packet.NET stack. Opens a USB-CDC or hardware serial port, speaks KISS framing in both directions, and surfaces inbound frames as an async stream. Pair with Packet.Kiss.NinoTnc for NinoTNC-specific extensions (ACKMODE, SetMode, frame classification). Source: github.com/packet-net/packet.net. |
|
|
Packet.Kiss.NinoTnc
NinoTNC-specific KISS extensions for the Packet.NET stack — ACKMODE TX-completion correlation, SETHW mode switching, TX-Test frame classification, USB port discovery. Built on Packet.Kiss.Serial for generic serial-port plumbing. Source: github.com/packet-net/packet.net. |
|
|
Packet.Axudp
AXUDP transport for the Packet.NET stack: AxudpSocket, a bidirectional AX.25-over-IP (RFC 1226) endpoint that UDP-encapsulates AX.25 frames. It unconditionally appends + validates the 2-octet AX.25 FCS (CRC-16-CCITT) exactly as every real AXIP/AXUDP peer does (ax25ipd, LinBPQ BPQAXIP, XRouter), with a raw escape hatch for replaying captures. Source: github.com/packet-net/packet.net. |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 0.13.0 | 65 | 11/12/2026 |
| 0.12.0 | 327 | 9/10/2026 |
| 0.11.0 | 3,761 | 9/10/2026 |
| 0.10.2 | 3,042 | 7/18/2026 |
| 0.10.1 | 127 | 7/18/2026 |
| 0.10.0 | 1,555 | 6/3/2026 |
| 0.9.0 | 143 | 6/2/2026 |
| 0.8.0 | 140 | 6/2/2026 |
| 0.7.1 | 391 | 5/28/2026 |
| 0.7.0 | 189 | 5/28/2026 |
| 0.6.0 | 207 | 5/27/2026 |
| 0.5.3 | 150 | 5/21/2026 |
| 0.5.2 | 139 | 5/21/2026 |
| 0.5.1 | 133 | 5/20/2026 |
| 0.5.0 | 127 | 5/20/2026 |
| 0.4.0 | 135 | 5/19/2026 |
| 0.3.0 | 156 | 5/17/2026 |