Struct HiveBeacon 

pub struct HiveBeacon {
    pub version: u8,
    pub capabilities: u16,
    pub node_id: NodeId,
    pub hierarchy_level: HierarchyLevel,
    pub geohash: u32,
    pub battery_percent: u8,
    pub seq_num: u16,
}

HIVE Beacon data structure

Contains all information broadcast in a HIVE BLE advertisement.

Fields

version: u8

Protocol version (0-15)

capabilities: u16

Node capabilities flags

node_id: NodeId

Node identifier

hierarchy_level: HierarchyLevel

Hierarchy level in the mesh

geohash: u32

Geohash for location (24-bit, ~600m precision)

battery_percent: u8

Battery percentage (0-100, 255 = unknown)

seq_num: u16

Sequence number for deduplication

Implementations

impl HiveBeacon

pub fn new(node_id: NodeId) -> Self

Create a new beacon with the given node ID

pub fn hive_lite(node_id: NodeId) -> Self

Create a beacon for a HIVE-Lite node

pub fn with_capabilities(self, capabilities: u16) -> Self

Set capabilities

pub fn with_hierarchy_level(self, level: HierarchyLevel) -> Self

Set hierarchy level

pub fn with_geohash(self, geohash: u32) -> Self

Set geohash

pub fn with_battery(self, percent: u8) -> Self

Set battery percentage

pub fn increment_seq(&mut self)

Increment sequence number

pub fn encode(&self) -> [u8; 16]

Encode beacon to bytes (full 16-byte format)

pub fn encode_compact(&self) -> [u8; 10]

Encode beacon to compact format (10 bytes for legacy advertising)

Compact format omits geohash and reserved bytes:

• Byte 0: Version | Capabilities high
• Byte 1: Capabilities low
• Bytes 2-5: Node ID
• Byte 6: Hierarchy level
• Byte 7: Battery percent
• Bytes 8-9: Sequence number

pub fn decode(data: &[u8]) -> Option<Self>

Decode beacon from bytes (full 16-byte format)

pub fn decode_compact(data: &[u8]) -> Option<Self>

Decode beacon from compact format (10 bytes)

pub fn is_lite_node(&self) -> bool

Check if this is a HIVE-Lite node

pub fn can_relay(&self) -> bool

Check if this node can relay messages

pub fn supports_coded_phy(&self) -> bool

Check if this node supports Coded PHY

Trait Implementations

impl Clone for HiveBeacon

fn clone(&self) -> HiveBeacon

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HiveBeacon

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

Formats the value using the given formatter.

impl Default for HiveBeacon

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for HiveBeacon

fn eq(&self, other: &HiveBeacon) -> 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 Eq for HiveBeacon

impl StructuralPartialEq for HiveBeacon