Struct TraceSignalEntry 

pub struct TraceSignalEntry(/* private fields */);

One trace-signal entry: negative RSSI in dBm, then SNR in centibels (packet-options.md § Trace Signal).

Every hop that prepends a router hint to a trace route prepends one of these to the trace signal, so entry N is the quality at which the hop named by hint N heard the packet. That pairing is the option’s whole value, which is why the encoding lives here rather than in whichever forwarder happens to need it: a repeater and a bridge that disagree about a byte produce a list nothing downstream can read.

Both fields saturate rather than wrap, so a reading past the end of the range reports the nearest representable value instead of a plausible-looking wrong one.

Implementations

impl TraceSignalEntry

pub const UNMEASURED: Self

What a hop writes when its radio reported no measurement at all.

An RSSI byte of zero is 0 dBm at the receiver, which no link this protocol runs over produces, so it cannot be mistaken for a reading. Writing it keeps the entry-for-entry pairing with the trace route intact, which a hop that measures nothing is still obliged to maintain.

pub const fn new(rssi_dbm: i16, snr_centibels: i16) -> Self

The entry for a hop that measured both fields.

pub const fn from_measurements( rssi_dbm: Option<i16>, snr_centibels: Option<i16>, ) -> Self

The entry for a hop whose radio may not report either field.

The two measurements are independent, so a radio that reports one and not the other still contributes the one it has.

pub const fn as_bytes(self) -> [u8; 2]

The two bytes, ready to prepend to a trace-signal option value.

Trait Implementations

impl Clone for TraceSignalEntry

fn clone(&self) -> TraceSignalEntry

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TraceSignalEntry

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for TraceSignalEntry

fn default() -> TraceSignalEntry

Returns the “default value” for a type.

impl PartialEq for TraceSignalEntry

fn eq(&self, other: &TraceSignalEntry) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for TraceSignalEntry

impl Eq for TraceSignalEntry

impl StructuralPartialEq for TraceSignalEntry