Module prop 

Property identifiers.

Constants

ADVERT_INTERVAL

Seconds between unsolicited advertisements (PROP_ADVERT_INTERVAL) — UINT32, 0 to send none. An advertisement carries the signed node identity and goes out with no flood hops and no source route, so it reaches the neighbours that can hear the device directly and stops there. The accepted range is [MIN_AUTO_ANNOUNCE_INTERVAL_S] to [MAX_AUTO_ANNOUNCE_INTERVAL_S], and the value is a floor rather than a period: the device scatters each send later by up to a quarter of it. Requires CAP_ADVERT.

ALERT

Locate-alert state (PROP_ALERT) — what the device is currently doing to draw attention to where it physically is. Volatile: never saved, unaffected by CMD_RST, ALERT_NONE after every reset. Requires CAP_ALERT.

BATTERY

Battery status snapshot (PROP_BATTERY).

BEACON_INTERVAL

Seconds between unsolicited beacons (PROP_BEACON_INTERVAL) — UINT32, 0 to send none. A beacon carries no payload and goes out with a flood budget and the trace-route and trace-signal options, so what it announces is the path back to the device rather than who the device is. Same range and same scatter as ADVERT_INTERVAL. Requires CAP_ADVERT.

BLE_PAIRING_PIN

Persisted, write-only BLE pairing passkey (PROP_BLE_PAIRING_PIN).

CAPS

Supported capability list (PROP_CAPS).

DEV_CHANNEL_KEYS

Device identity channel keys (PROP_DEV_CHANNEL_KEYS).

DEV_DISCOVERABLE

Whether the device identity answers Identity Requests (PROP_DEV_DISCOVERABLE) — BOOL, default 1. Requires CAP_DEV_IDENTITY.

DEV_KEY

Device identity public key (PROP_DEV_KEY).

DEV_NAME

Human-readable device name (PROP_DEV_NAME).

DEV_PEERS

Device identity peer list (PROP_DEV_PEERS).

DEV_PRIVATE_KEY

Device identity private key, write-only (PROP_DEV_PRIVATE_KEY).

DEV_VERSION

device firmware version string (PROP_DEV_VERSION).

GNSS_ALTITUDE

Altitude of the last fix (PROP_GNSS_ALTITUDE) — INT32_LE meters above the WGS-84 ellipsoid, matching the units of node identity option 2. Empty when there is no fix. Requires CAP_GNSS.

GNSS_ENABLED

Whether the GNSS receiver is powered (PROP_GNSS_ENABLED) — BOOL, default 0. Off means the lowest power state the receiver reaches; a board whose receiver RTC is the board’s only clock keeps that domain alive regardless. Requires CAP_GNSS.

GNSS_FIX

Fix quality (PROP_GNSS_FIX) — UINT8, 0 none, 1 two-dimensional, 2 three-dimensional. Reads 0 while the receiver is disabled. Requires CAP_GNSS.

GNSS_IDENT_PRECISION

Precision the advertised location is clamped to (PROP_GNSS_IDENT_PRECISION) — UINT8 1–7, default 5. Requires CAP_GNSS.

GNSS_IDENT_UPDATE

Whether position fixes update the advertised node identity (PROP_GNSS_IDENT_UPDATE) — BOOL, default 0. Requires CAP_GNSS.

GNSS_LOCATION

Last position fix (PROP_GNSS_LOCATION) — 0–7 octets in the variable-precision interleaved format. Empty means no fix has been obtained this power cycle. Requires CAP_GNSS.

GNSS_PRECISION

Estimated horizontal accuracy of the last fix (PROP_GNSS_PRECISION) — UINT16_LE decimeters. An estimate derived from the receiver’s dilution of precision, not a measured error bound. Empty when there is no fix. Requires CAP_GNSS.

GNSS_SATELLITES

Satellite counts (PROP_GNSS_SATELLITES) — UINT8 satellites used in the solution, optionally followed by UINT8 satellites in view. Reads 0 while the receiver is disabled. Requires CAP_GNSS.

GNSS_TIME_TRUST

Whether receiver-derived time may set the wall clock (PROP_GNSS_TIME_TRUST) — BOOL, default 1. Cleared, neither a fix nor a receiver-RTC read touches PROP_TIME, which leaves a manually-set clock proof against a jammed or spoofed sky. Position reporting is unaffected. Requires CAP_GNSS.

HOST_AUTO_ACK

Acknowledgement-delegation enable (PROP_HOST_AUTO_ACK).

HOST_CHANNEL_KEYS

Host channel keys (PROP_HOST_CHANNEL_KEYS).

HOST_KEY

Tethered host identity public key (PROP_HOST_KEY).

HOST_PEER_KEYS

Host pairwise peer keys (PROP_HOST_PEER_KEYS).

HOST_RX_FILTERS

Host receive filter table (PROP_HOST_RX_FILTERS).

HOST_RX_QUEUE_CAPACITY

Inbound queue capacity in frames (PROP_HOST_RX_QUEUE_CAPACITY).

HOST_RX_QUEUE_COUNT

Frames currently queued (PROP_HOST_RX_QUEUE_COUNT).

HOST_RX_QUEUE_DROPPED

Cumulative frames dropped from the queue (PROP_HOST_RX_QUEUE_DROPPED).

IDENT

The device identity’s complete signed node-identity blob (PROP_IDENT), served through a deferred signing effect.

IDENT_MOBILE

Whether the device identity advertises the MOB capability bit (PROP_IDENT_MOBILE) — mobile versus fixed, which is orthogonal to tethered versus standalone.

IDENT_ROLE

Advertised ROLE byte of the device identity (PROP_IDENT_ROLE). Empty means “derive it from what the device is actually doing”.

ILLUMINANCE

Ambient illuminance (PROP_ILLUMINANCE) — UINT32_LE millilux. Millilux rather than lux because the interesting region for an indicator that should not be intrusive at night is below one lux. Sampled when read; empty when the sensor could not be read. A board reports its clamped maximum above the sensor’s saturation point rather than extrapolating past it. Requires CAP_ILLUMINANCE.

INTERFACE_TYPE

Interface type discriminator (PROP_INTERFACE_TYPE).

LAST_STATUS

Status of the last operation (PROP_LAST_STATUS).

MAC_PROMISCUOUS

Deliver all received frames, bypassing host receive filtering; the only session-scoped property (PROP_MAC_PROMISCUOUS).

MAC_REPEATER_DEFAULT_REGION

Region code inserted into untagged flood packets (PROP_MAC_REPEATER_DEFAULT_REGION) — one 2-octet code, or empty to never tag.

MAC_REPEATER_ENABLED

Autonomous MAC-layer repeater/forwarding enable (PROP_MAC_REPEATER_ENABLED).

MAC_REPEATER_MIN_RSSI

Minimum received RSSI in dBm for flood forwarding (PROP_MAC_REPEATER_MIN_RSSI) — INT16, or empty for no threshold.

MAC_REPEATER_MIN_SNR

Minimum received SNR in whole dB for flood forwarding (PROP_MAC_REPEATER_MIN_SNR) — INT8, or empty for no threshold.

MAC_REPEATER_REGIONS

Region codes the device identity flood-forwards for (PROP_MAC_REPEATER_REGIONS) — concatenated 2-octet codes, empty for “forward regardless of region code”.

PHY_DUTY_LIMIT

Duty-cycle limit (PROP_PHY_DUTY_LIMIT).

PHY_DUTY_NOW

Transmit duty usage over the past hour (PROP_PHY_DUTY_NOW).

PHY_ENABLED

PHY enabled flag (PROP_PHY_ENABLED).

PHY_FREQ

Frequency in kHz (PROP_PHY_FREQ).

PHY_LORA_BW

LoRa bandwidth in Hz (PROP_PHY_LORA_BW).

PHY_LORA_CR

LoRa coding rate (PROP_PHY_LORA_CR).

PHY_LORA_SF

LoRa spreading factor (PROP_PHY_LORA_SF).

PHY_LORA_SW

LoRa sync word, SX126x-style 16-bit (PROP_PHY_LORA_SW).

PHY_MTU

Maximum STR_PHY_RAW data size in octets (PROP_PHY_MTU).

PHY_RSSI

Current RSSI in dBm (PROP_PHY_RSSI).

PHY_TX_POWER

TX power in dBm (PROP_PHY_TX_POWER).

PROTOCOL_VERSION

Protocol major/minor version (PROP_PROTOCOL_VERSION).

SAVED

Whether a saved snapshot exists (PROP_SAVED).

STARTUP_BEACON

Whether the device emits one beacon once it comes up (PROP_STARTUP_BEACON) — BOOL, default 1. Requires CAP_ADVERT.

TIME

Wall-clock time (PROP_TIME) — UINT32_LE seconds since the Unix epoch, or empty when the device does not know what time it is. Unsigned, so the encoding is wrap-free into 2106. Requires CAP_TIME.

TZ_OFFSET

Local time-zone offset from UTC (PROP_TZ_OFFSET) — INT16_LE minutes, default 0. Unlike PROP_TIME this always has a value: where the device is configured to be is known even when what time it is is not. Requires CAP_TIME.