Struct UlcpSyncRecord 

pub struct UlcpSyncRecord {

    pub capability_count: u32,
    pub has_host_filtering: bool,
    pub supports_offline_queue: bool,
    pub supports_delegated_ack: bool,
    pub supports_device_name: bool,
    pub device_name: Option<String>,
    pub supports_lora: bool,
    pub supports_duty_cycle_limit: bool,
    pub supports_battery: bool,
    pub battery: Option<UlcpBatteryRecord>,
    pub supports_repeater: bool,
    pub supports_ident: bool,
    pub supports_device_identity: bool,
    pub supports_time: bool,
    pub supports_gnss: bool,
    pub supports_advert: bool,
    pub supports_admin: bool,
    pub supports_alert: bool,
    pub supports_reboot: bool,
    pub alert: Option<UlcpAlertState>,
    pub phy_enabled: bool,
    pub frequency_khz: u32,
    pub transmit_power_dbm: i8,
    pub bandwidth_hz: Option<u32>,
    pub spreading_factor: Option<u8>,
    pub coding_rate_denom: Option<u8>,
    pub duty_cycle_now: Option<u16>,
    pub duty_cycle_limit: Option<u16>,
    pub saved: Option<SavedSnapshotRecord>,
    pub queued_frames: Option<u16>,
    pub dropped_frames: Option<u32>,
    pub filter_count: Option<u32>,
    pub host_channel_count: Option<u32>,
    pub host_peer_count: Option<u32>,
    pub auto_ack: Option<bool>,
    pub repeater: Option<UlcpRepeaterSettingsRecord>,
    pub dev_peer_keys: Option<Vec<Vec<u8>>>,
    pub dev_admin_keys: Option<Vec<Vec<u8>>>,
    pub dev_channel_ids: Option<Vec<Vec<u8>>>,
    pub ident_role: Option<u8>,
    pub ident_mobile: Option<bool>,
    pub ident_position: Option<UlcpIdentPositionRecord>,
    pub dev_discoverable: Option<bool>,
    pub tz_offset_min: Option<i16>,
    pub gnss: Option<UlcpGnssSettingsRecord>,
    pub advert: Option<UlcpAdvertSettingsRecord>,
    pub unreadable_properties: Vec<u32>,
}

Read-only, capability-gated device state gathered after host ownership has been resolved. Counts describe digest forms and contain no key material.

Fields

capability_count: u32

has_host_filtering: bool

supports_offline_queue: bool

supports_delegated_ack: bool

supports_device_name: bool

device_name: Option<String>

PROP_DEV_NAME, when the device has one and reported it. Empty is a device with no name rather than a device named “”.

supports_lora: bool

supports_duty_cycle_limit: bool

supports_battery: bool

The device measures its own power state (CAP_BATTERY). A device without it never reports a battery, so callers have nothing to show.

battery: Option<UlcpBatteryRecord>

PROP_BATTERY, when the device measures one and has reported it.

A reading rather than a setting, and absent for a reason that is never a fault: on the local link a device announces this on its own schedule, so a session that has only just attached has not heard one yet. Deliberately not counted among unreadable_properties — there is no setting here to be written over.

supports_repeater: bool

The device can forward for the mesh on its own (CAP_REPEATER).

supports_ident: bool

The device serves and configures its own advertised node identity (CAP_IDENT).

supports_device_identity: bool

The device has an identity domain of its own (CAP_DEV_IDENTITY), including the PROP_DEV_PEERS list.

supports_time: bool

The device keeps a wall clock (CAP_TIME). It says nothing about where the time comes from, or whether the device currently knows it — an unset clock is a device with CAP_TIME and no epoch.

supports_gnss: bool

A GNSS receiver is fitted (CAP_GNSS), so the positioning properties exist and the device can locate itself.

supports_advert: bool

The device announces itself on a schedule of its own (CAP_ADVERT).

supports_admin: bool

The device answers Node Management Requests from the administrators it lists (CAP_ADMIN). A device without it can only ever be configured by whoever is holding it.

supports_alert: bool

The device can make itself conspicuous on request (CAP_ALERT).

supports_reboot: bool

The device can restart its hardware on request (CAP_REBOOT).

alert: Option<UlcpAlertState>

PROP_ALERT: what the device is doing to make itself findable, when it has said. Live state like battery, and absent on the same terms.

phy_enabled: bool

frequency_khz: u32

transmit_power_dbm: i8

bandwidth_hz: Option<u32>

spreading_factor: Option<u8>

coding_rate_denom: Option<u8>

duty_cycle_now: Option<u16>

duty_cycle_limit: Option<u16>

saved: Option<SavedSnapshotRecord>

queued_frames: Option<u16>

dropped_frames: Option<u32>

filter_count: Option<u32>

host_channel_count: Option<u32>

host_peer_count: Option<u32>

auto_ack: Option<bool>

repeater: Option<UlcpRepeaterSettingsRecord>

Present when supports_repeater and the device reported the whole policy.

dev_peer_keys: Option<Vec<Vec<u8>>>

PROP_DEV_PEERS: the peer public keys stored on the device identity, read back losslessly. Present when supports_device_identity and the device reported the list.

dev_admin_keys: Option<Vec<Vec<u8>>>

PROP_DEV_ADMINS: the node public keys allowed to manage this device over the mesh, read back losslessly. Present when supports_admin and the device reported the list; an empty list is a device that nobody may manage remotely.

dev_channel_ids: Option<Vec<Vec<u8>>>

PROP_DEV_CHANNEL_KEYS: the two-octet identifiers of the channels the device identity has joined. Key material is never read back, so a caller names these by deriving identifiers from the keys it holds; one that matches nothing locally is a channel the device knows and this phone does not.

ident_role: Option<u8>

PROP_IDENT_ROLE. None covers “the device derives its role from what it is actually doing”, “no CAP_IDENT”, and “the device would not report it” — supports_ident and unreadable_properties distinguish them.

ident_mobile: Option<bool>

PROP_IDENT_MOBILE. Present when supports_ident and the device reported it.

ident_position: Option<UlcpIdentPositionRecord>

Where the device says it is. Present when supports_ident and the device reported its position; a device that advertises none reports an empty cell rather than nothing.

dev_discoverable: Option<bool>

PROP_DEV_DISCOVERABLE: whether the device identity answers Identity Requests. Present when supports_device_identity and the device reported it.

tz_offset_min: Option<i16>

PROP_TZ_OFFSET in minutes east of UTC. Present when supports_time and the device reported it.

The zone is configuration and the epoch is not: where a device is meant to be is known even when what time it is is not, which is why this is here and the clock reading is on the session snapshot.

gnss: Option<UlcpGnssSettingsRecord>

The positioning policy. Present when supports_gnss and the device reported the whole of it.

advert: Option<UlcpAdvertSettingsRecord>

The advertisement policy. Present when supports_advert and the device reported the whole of it.

unreadable_properties: Vec<u32>

Capability-gated properties the device advertised but would not report, in ascending order.

A device that refuses a property — old firmware behind a newer capability, a property it never implemented — is a device with an unknown setting, not one this phone cannot administer. Their values are absent above, they are left out of configuration writes, and nothing about them can be verified after a save.

Trait Implementations

impl Clone for UlcpSyncRecord

fn clone(&self) -> UlcpSyncRecord

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<UT> ConvertError<UT> for UlcpSyncRecord

fn try_convert_unexpected_callback_error( e: UnexpectedUniFFICallbackError, ) -> Result<Self>

impl Debug for UlcpSyncRecord

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

Formats the value using the given formatter.

impl<UT> FfiConverter<UT> for UlcpSyncRecord

const TYPE_ID_META: MetadataBuffer

Type ID metadata, serialized into a MetadataBuffer.

type FfiType = RustBuffer

The low-level type used for passing values of this type over the FFI.

fn lower(v: Self) -> RustBuffer

Lower a rust value of the target type, into an FFI value of type Self::FfiType.

fn try_lift(buf: RustBuffer) -> Result<Self>

Lift a rust value of the target type, from an FFI value of type Self::FfiType.

fn write(obj: Self, buf: &mut Vec<u8>)

Write a rust value into a buffer, to send over the FFI in serialized form.

fn try_read(buf: &mut &[u8]) -> Result<Self>

Read a rust value from a buffer, received over the FFI in serialized form.

impl<UT> Lift<UT> for UlcpSyncRecord

type FfiType = <UlcpSyncRecord as FfiConverter<UT>>::FfiType

fn try_lift(v: Self::FfiType) -> Result<Self>

fn try_read(buf: &mut &[u8]) -> Result<Self>

fn try_lift_from_rust_buffer(v: RustBuffer) -> Result<Self, Error>

Convenience method

impl<UT> LiftRef<UT> for UlcpSyncRecord

type LiftType = UlcpSyncRecord

impl<UT> LiftReturn<UT> for UlcpSyncRecord

type ReturnType = <UlcpSyncRecord as Lift<UT>>::FfiType

FFI return type for trait interfaces

fn try_lift_successful_return(v: Self::ReturnType) -> Result<Self>

Lift a successfully returned value from a trait interface

fn lift_foreign_return( ffi_return: Self::ReturnType, call_status: RustCallStatus, ) -> Self

Lift a foreign returned value from a trait interface

fn lift_error(_buf: RustBuffer) -> Self

Lift a Rust value for a callback interface method error result

fn handle_callback_unexpected_error(e: UnexpectedUniFFICallbackError) -> Self

Lift a Rust value for an unexpected callback interface error

impl<UT> Lower<UT> for UlcpSyncRecord

type FfiType = <UlcpSyncRecord as FfiConverter<UT>>::FfiType

fn lower(obj: Self) -> Self::FfiType

fn write(obj: Self, buf: &mut Vec<u8>)

fn lower_into_rust_buffer(obj: Self) -> RustBuffer

Convenience method

impl<UT> LowerError<UT> for UlcpSyncRecord

fn lower_error(obj: Self) -> RustBuffer

Lower this value for scaffolding function return

impl<UT> LowerReturn<UT> for UlcpSyncRecord

type ReturnType = <UlcpSyncRecord as Lower<UT>>::FfiType

The type that should be returned by scaffolding functions for this type.

fn lower_return(v: Self) -> Result<Self::ReturnType, RustCallError>

Lower the return value from an scaffolding call

fn handle_failed_lift( error: LiftArgsError, ) -> Result<Self::ReturnType, RustCallError>

Lower the return value for failed argument lifts

impl PartialEq for UlcpSyncRecord

fn eq(&self, other: &UlcpSyncRecord) -> 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<UT> TypeId<UT> for UlcpSyncRecord

const TYPE_ID_META: MetadataBuffer

impl StructuralPartialEq for UlcpSyncRecord