Crate libaprs_engine

Expand description

Protocol-first APRS engine core primitives.

The codec boundary accepts untrusted bytes, preserves them exactly, and fails closed when the packet shape is malformed.

Structs§

Capability: APRS station capabilities packet bytes.
CompressedPosition: Compressed APRS position fields.
Coordinates: Decimal coordinates in signed degrees.
Counters: Runtime counters.
Engine: Parser and policy orchestration engine.
Item: APRS item report fields.
LineTransport: Line-oriented packet source for file/stdin style transports.
Maidenhead: APRS Maidenhead locator packet bytes.
Message: APRS message fields.
MicE: APRS Mic-E packet bytes.
MicESpeedCourse: Mic-E speed/course extension.
Nmea: APRS NMEA packet bytes.
NmeaChecksum: NMEA checksum validation details.
Object: APRS object report fields.
PacketSummary: Structured packet diagnostic summary.
ParseOptions: Codec configuration for consumers that need a different envelope limit.
ParsedPacket: Structured packet view backed by the preserved raw packet bytes.
Policy: Policy options applied after parsing.
Position: Uncompressed APRS position fields.
Query: APRS query packet bytes.
RawPacket: Original packet bytes retained without normalization or lossy conversion.
Telemetry: APRS telemetry report fields.
TelemetryMetadata: APRS telemetry metadata packet carried in an APRS message.
ThirdParty: APRS third-party traffic packet bytes.
TimestampedPosition: Timestamped uncompressed APRS position fields.
UserDefined: APRS user-defined packet fields.
Weather: APRS weather report bytes.
WeatherFields: Extracted numeric weather fields.

AprsData: Semantic APRS information-field data.
DataTypeIdentifier: APRS data type identifier from the first payload byte.
EngineResult: Engine processing result.
MessageKind: APRS message subtype.
MicEMessageCode: Mic-E destination-derived message code.
MicEStandardMessage: Standard Mic-E message code.
MicEStatus: Mic-E destination-derived status bits.
ParseError: Fail-closed packet parse errors.
PolicyDecision: Policy decision.
PolicyRejection: Policy rejection reason.
TelemetryMetadataKind: APRS telemetry metadata subtype.
TransportErrorCode: Stable transport diagnostic categories for logs and external systems.

DEFAULT_PARSE_OPTIONS: Default parse options used by parse_packet.
DEFAULT_TRANSPORT_READ_LIMIT: Default maximum byte batch accepted by transport helper readers.
MAX_PACKET_LEN: Conservative upper bound for an APRS packet handled by this skeleton.

oversized_input_error: Creates the standard oversized-input transport error.
parse_packet: Parses an APRS packet from untrusted bytes.
parse_packet_with_options: Parses an APRS packet from untrusted bytes with explicit codec options.
read_all_with_limit: Reads all available bytes from a reader while enforcing a hard limit.