Crate oa_gateway_agra

A-GRA offboard payload envelopes.

External MA interfaces (MA-C2, MA-MA) wrap inner UCI messages as hexBinary inside MA_RxDataPayload (offboard → MA) or MA_TxDataPayloadCommand (MA → offboard). Platform interfaces (MA-VI, MA-MS) use native MTs and do not go through this codec.

The engine stays wrapper-agnostic: this crate turns envelopes inside out.

Structs

• Unwrapped
  Result of peeling an Rx/Tx wrapper.
• WrapRequest
  Inputs for building an Rx or Tx wrapper around an inner UCI payload.
• WrapShell
  Classification / header shell supplied by the caller — we do not invent markings.
• WrapperMeta
  Metadata lifted off the wrapper (not the inner UCI message).

Enums

• AgraError
• WrapperKind

Constants

• HDR_COMMAND_ID 🔒
• HDR_DEST_ROUTING 🔒
• HDR_INNER_CT 🔒
• HDR_MESSAGE_TYPE 🔒
• HDR_ORIGINATOR 🔒
• HDR_RX_ID 🔒
• HDR_WRAPPER 🔒
• MAX_DECODED_PAYLOAD
  Largest payload an EncodedPayload element may decode to.
• MAX_WRAPPER_DEPTH 🔒
  Deepest element nesting a wrapper document is allowed before parsing is refused outright.
• RX_ELEMENT
• TX_ELEMENT
• TX_STATUS_ELEMENT

Functions

• decode_hex 🔒
  Decode xs:hexBinary, tolerating the whitespace the type permits.
• element_to_enum
  Convert a global element name (PositionReport) to MessageTypeEnum (POSITION_REPORT).
• inner_envelope 🔒
• json_str 🔒
• local_text 🔒
  Text of the first descendant element named local, ignoring whatever namespace prefix it carries.
• minimal_wrapper_json 🔒
• nested_uuid 🔒
  Text of the UUID child nested inside the first descendant element named parent_local.
• nesting_exceeds 🔒
  Whether xml nests elements deeper than limit, checked on the text rather than a parsed tree.
• parse_checked 🔒
  Parses xml into a tree, refusing anything nested deep enough to be a stack-overflow attempt before roxmltree — which has no depth limit of its own — ever recurses into it.
• scan_start_tag 🔒
  Bytes consumed by a start tag, and whether it closed itself.
• skip_past 🔒
  Bytes consumed if rest opens with open, through the matching close.
• sniff_content_type 🔒
• type_hint_from_inner 🔒
• unwrap
  Unwrap OMS JSON or XML Rx/Tx envelopes into wrapper + inner envelopes.
• unwrap_json 🔒
• unwrap_xml 🔒
• unwrapped_from_parts
  Builds wrapper and inner envelopes from structured Rx/Tx fields.
• wrap
  Wrap an inner UCI payload (XML or OMS JSON bytes) as hexBinary inside Rx/Tx OMS JSON.
• wrapper_kind
  Detect whether OMS JSON (or XML document element) is an Rx/Tx wrapper.
• xml_root_local_name
  Local name of an XML document element, or None if there is no element.