Struct Advertiser 

pub struct Advertiser { /* private fields */ }

Peat Beacon Advertiser

Manages building and updating BLE advertisements containing Peat beacons.

Implementations

impl Advertiser

pub fn new(config: DiscoveryConfig, node_id: NodeId) -> Self

Create a new advertiser with the given configuration and node ID

pub fn peat_lite(config: DiscoveryConfig, node_id: NodeId) -> Self

Create an advertiser for a Peat-Lite node

pub fn set_time_ms(&mut self, time_ms: u64)

Set the current time (call periodically from platform)

pub fn with_tx_power(self, tx_power: i8) -> Self

Set TX power level

pub fn with_name(self, name: String) -> Self

Set device name

pub fn with_extended_advertising(self, enabled: bool) -> Self

Enable extended advertising

pub fn with_encryption( self, beacon_key: BeaconKey, mesh_id_bytes: [u8; 4], ) -> Self

Enable encrypted advertising mode

In encrypted mode:

• Beacon identity (mesh_id + node_id) is encrypted
• Device name becomes generic “PEAT”
• Only mesh members with the beacon key can identify the node

Arguments

• beacon_key - Encryption key derived from mesh genesis
• mesh_id_bytes - 4-byte mesh identifier for beacon identity

pub fn set_mode(&mut self, mode: AdvertisingMode)

Set advertising mode

pub fn mode(&self) -> AdvertisingMode

Get current advertising mode

pub fn set_beacon_key(&mut self, key: BeaconKey)

Update encryption key (for key rotation)

pub fn state(&self) -> AdvertiserState

Get current state

pub fn beacon(&self) -> &PeatBeacon

Get the current beacon

pub fn beacon_mut(&mut self) -> &mut PeatBeacon

Get mutable access to the beacon

pub fn set_hierarchy_level(&mut self, level: HierarchyLevel)

Update hierarchy level

pub fn set_capabilities(&mut self, caps: u16)

Update capabilities

pub fn set_battery(&mut self, percent: u8)

Update battery percentage

pub fn set_geohash(&mut self, geohash: u32)

Update geohash

pub fn start(&mut self)

Start advertising

pub fn pause(&mut self)

Pause advertising

pub fn resume(&mut self)

Resume advertising

pub fn stop(&mut self)

Stop advertising

pub fn advertising_duration_ms(&self) -> Option<u64>

Get duration of current advertising session in milliseconds

pub fn increment_sequence(&mut self)

Increment sequence number and invalidate cache

pub fn build_packet(&mut self) -> &AdvertisingPacket

Build the advertising packet

Uses cached packet if available and not dirty.

pub fn rebuild_packet(&mut self) -> &AdvertisingPacket

Force rebuild of advertising packet

pub fn advertising_data(&mut self) -> Vec<u8>

Get raw advertising data bytes

pub fn scan_response_data(&mut self) -> Option<Vec<u8>>

Get raw scan response bytes