ECSS SpaceWire CCSDS Transfer — Error End of Packet (space-systems/ecss/e5053-error-end-of-packet)
Use when a SpaceWire transfer carrying a CCSDS packet ends with an error
terminator, per ECSS-E-ST-50-53C clause 5.5.4.4 — what the receiving entity
does with what already arrived, and what it owes the entity above it.
Domain quick reference
- A transfer arriving on a SpaceWire link ends one of three ways: a
normal terminator, an error terminator, or nothing at all. Only the
first says the octets in hand are the whole of what was sent.
- Clause 5.5.4.4 carries two obligations. The error-terminated transfer
is discarded whole. And the discard is reported.
- Discarding whole is not caution, it is the only defensible reading. An
error terminator says the transfer was cut short by something the link
layer detected; the octets already taken in are a prefix of unknown
length, and a CCSDS packet header at the front of a prefix parses
perfectly well while describing a packet that never arrived.
- Reporting is the obligation that is quietly dropped, because dropping
it costs nothing visible. A receive path that discards silently and a
receive path with no traffic on it present identically to the user:
packets stop appearing, and nothing says why.
- An unterminated transfer is the same case wearing different clothes.
Its extent is equally unknown, so it takes the same disposition, with
its own report so the two are distinguishable afterwards.
Workflow
- Take the disposition from the terminator, before the payload is
framed. Framing first produces a packet object that then has to be
thrown away, and sooner or later one of them escapes.
- Normalise the terminator to a known name and reject anything else.
An unrecognised terminator is a defect in the layer below, not a
protocol event to be graded here.
- On a normal termination, deliver the octets as they stand.
- On an error termination, deliver nothing, and record how many octets
were taken in and thrown away — the count is what makes the loss
quantifiable later.
- Emit the report with that count in it. One line per discarded
transfer, naming how it ended, is the minimum that lets an operator
distinguish loss from silence.
- Over a sequence, look at clustering as well as rate. Independent
upsets scatter; several error terminations in a row are a fault in
progress, and a majority discarded is a link that is up on paper and
down from above.
Pitfalls
- Delivering the prefix because its header parsed. The header describing
a packet is not evidence the packet arrived; it is evidence the first
six octets arrived.
- Counting discards without reporting them. The number exists, nobody
reads it, and the fault is found by whoever notices their telemetry
went quiet an hour ago.
- Treating an unterminated transfer as a lesser case. Nothing said it
ended, so nothing says it is complete, and delivering it is the same
mistake with a quieter cause.
- Grading a link on discard rate alone. The same rate spread evenly and
clustered into one burst are different faults, and only the clustered
one has a moment in time to correlate against.
- Retrying at this layer on an error terminator. The transfer is gone
and this entity has no copy to resend; a retry belongs to whoever
still holds the packet, which is above here.
Behavior contract (gate 3)
Terminator normalisation, the discard-whole disposition, the suppressed
partial payload, the per-discard report, and the sequence-level split
between sporadic upsets, a clustered burst and a link delivering nothing
are exercised by the gate 3 contract test:
scripts/test_e5053_error_end_of_packet.py against
scripts/e5053_error_end_of_packet_logic.py (stdlib unittest, offline).
Run:
python3 scripts/test_e5053_error_end_of_packet.py
Compliance
- ECSS standards are freely downloadable (ESA); cite the source and
paraphrase per standards-map.yaml.
- compliance: STANDARDS-REF, gated: false.
1---2name: e5053-error-end-of-packet3description: "Implement the error-termination rule on the receiving side of the SpaceWire CCSDS packet transfer protocol at ECSS-E-ST-50-53C clause 5.5.4.4: a transfer ended by an error terminator is discarded whole, so no part of the partial packet reaches the user, and the discard is reported rather than absorbed into a counter nobody reads. Evaluate a received sequence for clustered error terminations so a fault in progress is separated from independent upsets, and from a link that is carrying signal while delivering nothing. Use when building or debugging a SpaceWire receive path. Trigger: ecss, e-st-50-53c, spacewire-error-end-of-packet, spacewire-eep-discard, partial-packet-suppression, spacewire-receive-error-reporting, consecutive-eep-burst, ccsds-transfer-decoding."4license: Apache-2.05compliance: STANDARDS-REF6standards:7 - id: ecss8 reference-only: true9gated: false10domain: space-systems11pack: space-systems12compatibility: "agentskills.io SKILL.md; any SKILL.md host (Claude Code, Hermes, OpenClaw)"13metadata:14 source: https://skillmd.com/skills/ashfordeou/e5053-error-end-of-packet15 domain: space-systems16 subdomain: ecss17 tags: [ecss, e-st-50-53-ccsds-packet-transfer, e5053-error-end-of-packet, spacewire-error-end-of-packet, spacewire-eep-discard, partial-packet-suppression, spacewire-receive-error-reporting, consecutive-eep-burst]18 version: 0.1.019 author: Aero Agent Skills20---2122# ECSS SpaceWire CCSDS Transfer — Error End of Packet (space-systems/ecss/e5053-error-end-of-packet)2324Use when a SpaceWire transfer carrying a CCSDS packet ends with an error25terminator, per ECSS-E-ST-50-53C clause 5.5.4.4 — what the receiving entity26does with what already arrived, and what it owes the entity above it.2728## Domain quick reference2930- A transfer arriving on a SpaceWire link ends one of three ways: a31 normal terminator, an error terminator, or nothing at all. Only the32 first says the octets in hand are the whole of what was sent.33- Clause 5.5.4.4 carries two obligations. The error-terminated transfer34 is discarded whole. And the discard is reported.35- Discarding whole is not caution, it is the only defensible reading. An36 error terminator says the transfer was cut short by something the link37 layer detected; the octets already taken in are a prefix of unknown38 length, and a CCSDS packet header at the front of a prefix parses39 perfectly well while describing a packet that never arrived.40- Reporting is the obligation that is quietly dropped, because dropping41 it costs nothing visible. A receive path that discards silently and a42 receive path with no traffic on it present identically to the user:43 packets stop appearing, and nothing says why.44- An unterminated transfer is the same case wearing different clothes.45 Its extent is equally unknown, so it takes the same disposition, with46 its own report so the two are distinguishable afterwards.4748## Workflow49501. Take the disposition from the terminator, before the payload is51 framed. Framing first produces a packet object that then has to be52 thrown away, and sooner or later one of them escapes.532. Normalise the terminator to a known name and reject anything else.54 An unrecognised terminator is a defect in the layer below, not a55 protocol event to be graded here.563. On a normal termination, deliver the octets as they stand.574. On an error termination, deliver nothing, and record how many octets58 were taken in and thrown away — the count is what makes the loss59 quantifiable later.605. Emit the report with that count in it. One line per discarded61 transfer, naming how it ended, is the minimum that lets an operator62 distinguish loss from silence.636. Over a sequence, look at clustering as well as rate. Independent64 upsets scatter; several error terminations in a row are a fault in65 progress, and a majority discarded is a link that is up on paper and66 down from above.6768## Pitfalls6970- Delivering the prefix because its header parsed. The header describing71 a packet is not evidence the packet arrived; it is evidence the first72 six octets arrived.73- Counting discards without reporting them. The number exists, nobody74 reads it, and the fault is found by whoever notices their telemetry75 went quiet an hour ago.76- Treating an unterminated transfer as a lesser case. Nothing said it77 ended, so nothing says it is complete, and delivering it is the same78 mistake with a quieter cause.79- Grading a link on discard rate alone. The same rate spread evenly and80 clustered into one burst are different faults, and only the clustered81 one has a moment in time to correlate against.82- Retrying at this layer on an error terminator. The transfer is gone83 and this entity has no copy to resend; a retry belongs to whoever84 still holds the packet, which is above here.8586## Behavior contract (gate 3)8788Terminator normalisation, the discard-whole disposition, the suppressed89partial payload, the per-discard report, and the sequence-level split90between sporadic upsets, a clustered burst and a link delivering nothing91are exercised by the gate 3 contract test:92scripts/test_e5053_error_end_of_packet.py against93scripts/e5053_error_end_of_packet_logic.py (stdlib unittest, offline).94Run:95python3 scripts/test_e5053_error_end_of_packet.py9697## Compliance9899- ECSS standards are freely downloadable (ESA); cite the source and100 paraphrase per standards-map.yaml.101- compliance: STANDARDS-REF, gated: false.