Link#

otMacFilterAddressMode#

otMacFilterAddressMode

Defines address mode of the mac filter.

otThreadLinkInfo#

typedef struct otThreadLinkInfo otThreadLinkInfo

Represents link-specific information for messages received from the Thread radio.

otMacFilterIterator#

typedef uint8_t otMacFilterIterator

Used to iterate through mac filter entries.

otMacFilterAddressMode#

typedef enum otMacFilterAddressMode otMacFilterAddressMode

Defines address mode of the mac filter.

otMacFilterEntry#

typedef struct otMacFilterEntry otMacFilterEntry

Represents a Mac Filter entry.

otMacCounters#

typedef struct otMacCounters otMacCounters

Represents the MAC layer counters.

otActiveScanResult#

typedef struct otActiveScanResult otActiveScanResult

Represents a received IEEE 802.15.4 Beacon.

otEnergyScanResult#

typedef struct otEnergyScanResult otEnergyScanResult

Represents an energy scan result.

otHandleActiveScanResult#

typedef void(* otHandleActiveScanResult) (otActiveScanResult *aResult, void *aContext) )(otActiveScanResult *aResult, void *aContext)

Pointer is called during an IEEE 802.15.4 Active Scan when an IEEE 802.15.4 Beacon is received or the scan completes.

otHandleEnergyScanResult#

typedef void(* otHandleEnergyScanResult) (otEnergyScanResult *aResult, void *aContext) )(otEnergyScanResult *aResult, void *aContext)

Pointer is called during an IEEE 802.15.4 Energy Scan when the result for a channel is ready or the scan completes.

otLinkPcapCallback#

typedef void(* otLinkPcapCallback) (const otRadioFrame *aFrame, bool aIsTx, void *aContext) )(const otRadioFrame *aFrame, bool aIsTx, void *aContext)

Pointer is called when an IEEE 802.15.4 frame is received.

Note

• This callback is called after FCS processing and aFrame may not contain the actual FCS that was received.

• This callback is called before IEEE 802.15.4 security processing.

otLinkActiveScan#

otError otLinkActiveScan (otInstance *aInstance, uint32_t aScanChannels, uint16_t aScanDuration, otHandleActiveScanResult aCallback, void *aCallbackContext)

Starts an IEEE 802.15.4 Active Scan.

otLinkIsActiveScanInProgress#

bool otLinkIsActiveScanInProgress (otInstance *aInstance)

Indicates whether or not an IEEE 802.15.4 Active Scan is currently in progress.

Returns

• true if an IEEE 802.15.4 Active Scan is in progress, false otherwise.

otLinkEnergyScan#

otError otLinkEnergyScan (otInstance *aInstance, uint32_t aScanChannels, uint16_t aScanDuration, otHandleEnergyScanResult aCallback, void *aCallbackContext)

Starts an IEEE 802.15.4 Energy Scan.

otLinkIsEnergyScanInProgress#

bool otLinkIsEnergyScanInProgress (otInstance *aInstance)

Indicates whether or not an IEEE 802.15.4 Energy Scan is currently in progress.

Returns

• true if an IEEE 802.15.4 Energy Scan is in progress, false otherwise.

otLinkSendDataRequest#

otError otLinkSendDataRequest (otInstance *aInstance)

Enqueues an IEEE 802.15.4 Data Request message for transmission.

otLinkIsInTransmitState#

bool otLinkIsInTransmitState (otInstance *aInstance)

Indicates whether or not an IEEE 802.15.4 MAC is in the transmit state.

MAC module is in the transmit state during CSMA/CA procedure, CCA, Data, Beacon or Data Request frame transmission and receiving an ACK of a transmitted frame. MAC module is not in the transmit state during transmission of an ACK frame or a Beacon Request frame.

Returns

• true if an IEEE 802.15.4 MAC is in the transmit state, false otherwise.

otLinkGetChannel#

uint8_t otLinkGetChannel (otInstance *aInstance)

Get the IEEE 802.15.4 channel.

Returns

• The IEEE 802.15.4 channel.

See Also

• otLinkSetChannel

otLinkSetChannel#

otError otLinkSetChannel (otInstance *aInstance, uint8_t aChannel)

Set the IEEE 802.15.4 channel.

Succeeds only when Thread protocols are disabled. A successful call to this function invalidates the Active and Pending Operational Datasets in non-volatile memory.

See Also

• otLinkGetChannel

otLinkGetSupportedChannelMask#

uint32_t otLinkGetSupportedChannelMask (otInstance *aInstance)

Get the supported channel mask of MAC layer.

Returns

• The supported channel mask as uint32_t with bit 0 (lsb) mapping to channel 0, bit 1 to channel 1, so on.

otLinkSetSupportedChannelMask#

otError otLinkSetSupportedChannelMask (otInstance *aInstance, uint32_t aChannelMask)

Set the supported channel mask of MAC layer.

Succeeds only when Thread protocols are disabled.

otLinkGetExtendedAddress#

const otExtAddress * otLinkGetExtendedAddress (otInstance *aInstance)

Gets the IEEE 802.15.4 Extended Address.

Returns

• A pointer to the IEEE 802.15.4 Extended Address.

otLinkSetExtendedAddress#

otError otLinkSetExtendedAddress (otInstance *aInstance, const otExtAddress *aExtAddress)

Sets the IEEE 802.15.4 Extended Address.

Note

• Only succeeds when Thread protocols are disabled.

otLinkGetFactoryAssignedIeeeEui64#

void otLinkGetFactoryAssignedIeeeEui64 (otInstance *aInstance, otExtAddress *aEui64)

Get the factory-assigned IEEE EUI-64.

otLinkGetPanId#

otPanId otLinkGetPanId (otInstance *aInstance)

Get the IEEE 802.15.4 PAN ID.

Returns

• The IEEE 802.15.4 PAN ID.

See Also

• otLinkSetPanId

otLinkSetPanId#

otError otLinkSetPanId (otInstance *aInstance, otPanId aPanId)

Set the IEEE 802.15.4 PAN ID.

Succeeds only when Thread protocols are disabled. A successful call to this function also invalidates the Active and Pending Operational Datasets in non-volatile memory.

See Also

• otLinkGetPanId

otLinkGetPollPeriod#

uint32_t otLinkGetPollPeriod (otInstance *aInstance)

Get the data poll period of sleepy end device.

Returns

• The data poll period of sleepy end device in milliseconds.

See Also

• otLinkSetPollPeriod

otLinkSetPollPeriod#

otError otLinkSetPollPeriod (otInstance *aInstance, uint32_t aPollPeriod)

Set/clear user-specified/external data poll period for sleepy end device.

Note

• This function updates only poll period of sleepy end device. To update child timeout the function otThreadSetChildTimeout() shall be called.

• Minimal non-zero value should be OPENTHREAD_CONFIG_MAC_MINIMUM_POLL_PERIOD (10ms). Or zero to clear user-specified poll period.

• User-specified value should be no more than the maximal value 0x3FFFFFF ((1 << 26) - 1) allowed, otherwise it would be clipped by the maximal value.

See Also

• otLinkGetPollPeriod

otLinkGetShortAddress#

otShortAddress otLinkGetShortAddress (otInstance *aInstance)

Get the IEEE 802.15.4 Short Address.

Returns

• A pointer to the IEEE 802.15.4 Short Address.

otLinkGetMaxFrameRetriesDirect#

uint8_t otLinkGetMaxFrameRetriesDirect (otInstance *aInstance)

Returns the maximum number of frame retries during direct transmission.

Returns

• The maximum number of retries during direct transmission.

otLinkSetMaxFrameRetriesDirect#

void otLinkSetMaxFrameRetriesDirect (otInstance *aInstance, uint8_t aMaxFrameRetriesDirect)

Sets the maximum number of frame retries during direct transmission.

otLinkGetMaxFrameRetriesIndirect#

uint8_t otLinkGetMaxFrameRetriesIndirect (otInstance *aInstance)

Returns the maximum number of frame retries during indirect transmission.

Returns

• The maximum number of retries during indirect transmission.

otLinkSetMaxFrameRetriesIndirect#

void otLinkSetMaxFrameRetriesIndirect (otInstance *aInstance, uint8_t aMaxFrameRetriesIndirect)

Sets the maximum number of frame retries during indirect transmission.

otLinkFilterGetAddressMode#

otMacFilterAddressMode otLinkFilterGetAddressMode (otInstance *aInstance)

Gets the address mode of MAC filter.

Is available when OPENTHREAD_CONFIG_MAC_FILTER_ENABLE configuration is enabled.

Returns

• the address mode.

otLinkFilterSetAddressMode#

void otLinkFilterSetAddressMode (otInstance *aInstance, otMacFilterAddressMode aMode)

Sets the address mode of MAC filter.

Is available when OPENTHREAD_CONFIG_MAC_FILTER_ENABLE configuration is enabled.

otLinkFilterAddAddress#

otError otLinkFilterAddAddress (otInstance *aInstance, const otExtAddress *aExtAddress)

Adds an Extended Address to MAC filter.

Is available when OPENTHREAD_CONFIG_MAC_FILTER_ENABLE configuration is enabled.

otLinkFilterRemoveAddress#

void otLinkFilterRemoveAddress (otInstance *aInstance, const otExtAddress *aExtAddress)

Removes an Extended Address from MAC filter.

Is available when OPENTHREAD_CONFIG_MAC_FILTER_ENABLE configuration is enabled.

No action is performed if there is no existing entry in Filter matching the given Extended Address.

otLinkFilterClearAddresses#

void otLinkFilterClearAddresses (otInstance *aInstance)

Clears all the Extended Addresses from MAC filter.

Is available when OPENTHREAD_CONFIG_MAC_FILTER_ENABLE configuration is enabled.

otLinkFilterGetNextAddress#

otError otLinkFilterGetNextAddress (otInstance *aInstance, otMacFilterIterator *aIterator, otMacFilterEntry *aEntry)

Gets an in-use address filter entry.

Is available when OPENTHREAD_CONFIG_MAC_FILTER_ENABLE configuration is enabled.

otLinkFilterAddRssIn#

otError otLinkFilterAddRssIn (otInstance *aInstance, const otExtAddress *aExtAddress, int8_t aRss)

Adds the specified Extended Address to the RssIn list (or modifies an existing address in the RssIn list) and sets the received signal strength (in dBm) entry for messages from that address.

The Extended Address does not necessarily have to be in the address allowlist/denylist filter to set the rss. Note

• The RssIn list contains Extended Addresses whose rss or link quality indicator (lqi) values have been set to be different from the defaults.

Is available when OPENTHREAD_CONFIG_MAC_FILTER_ENABLE configuration is enabled.

otLinkFilterRemoveRssIn#

void otLinkFilterRemoveRssIn (otInstance *aInstance, const otExtAddress *aExtAddress)

Removes the specified Extended Address from the RssIn list.

Once removed from the RssIn list, this MAC address will instead use the default rss and lqi settings, assuming defaults have been set. (If no defaults have been set, the over-air signal is used.)

Is available when OPENTHREAD_CONFIG_MAC_FILTER_ENABLE configuration is enabled.

No action is performed if there is no existing entry in the RssIn list matching the specified Extended Address.

otLinkFilterSetDefaultRssIn#

void otLinkFilterSetDefaultRssIn (otInstance *aInstance, int8_t aRss)

Sets the default received signal strength (in dBm) on MAC Filter.

Is available when OPENTHREAD_CONFIG_MAC_FILTER_ENABLE configuration is enabled.

The default RSS value is used for all received frames from addresses for which there is no explicit RSS-IN entry in the Filter list (added using otLinkFilterAddRssIn()).

otLinkFilterClearDefaultRssIn#

void otLinkFilterClearDefaultRssIn (otInstance *aInstance)

Clears any previously set default received signal strength (in dBm) on MAC Filter.

Is available when OPENTHREAD_CONFIG_MAC_FILTER_ENABLE configuration is enabled.

otLinkFilterClearAllRssIn#

void otLinkFilterClearAllRssIn (otInstance *aInstance)

Clears all the received signal strength (rss) and link quality indicator (lqi) entries (including defaults) from the RssIn list.

Performing this action means that all Extended Addresses will use the on-air signal.

Is available when OPENTHREAD_CONFIG_MAC_FILTER_ENABLE configuration is enabled.

otLinkFilterGetNextRssIn#

otError otLinkFilterGetNextRssIn (otInstance *aInstance, otMacFilterIterator *aIterator, otMacFilterEntry *aEntry)

Gets an in-use RssIn filter entry.

Is available when OPENTHREAD_CONFIG_MAC_FILTER_ENABLE configuration is enabled.

otLinkSetRadioFilterEnabled#

void otLinkSetRadioFilterEnabled (otInstance *aInstance, bool aFilterEnabled)

Enables/disables IEEE 802.15.4 radio filter mode.

Is available when OPENTHREAD_CONFIG_MAC_FILTER_ENABLE configuration is enabled.

The radio filter is mainly intended for testing. It can be used to temporarily block all tx/rx on the 802.15.4 radio. When radio filter is enabled, radio is put to sleep instead of receive (to ensure device does not receive any frame and/or potentially send ack). Also the frame transmission requests return immediately without sending the frame over the air (return "no ack" error if ack is requested, otherwise return success).

otLinkIsRadioFilterEnabled#

bool otLinkIsRadioFilterEnabled (otInstance *aInstance)

Indicates whether the IEEE 802.15.4 radio filter is enabled or not.

Is available when OPENTHREAD_CONFIG_MAC_FILTER_ENABLE configuration is enabled.

otLinkConvertRssToLinkQuality#

uint8_t otLinkConvertRssToLinkQuality (otInstance *aInstance, int8_t aRss)

Converts received signal strength to link quality.

Returns

• Link quality value mapping to aRss.

otLinkConvertLinkQualityToRss#

int8_t otLinkConvertLinkQualityToRss (otInstance *aInstance, uint8_t aLinkQuality)

Converts link quality to typical received signal strength.

Returns

• Typical platform received signal strength mapping to aLinkQuality.

otLinkGetTxDirectRetrySuccessHistogram#

const uint32_t * otLinkGetTxDirectRetrySuccessHistogram (otInstance *aInstance, uint8_t *aNumberOfEntries)

Gets histogram of retries for a single direct packet until success.

Is valid when OPENTHREAD_CONFIG_MAC_RETRY_SUCCESS_HISTOGRAM_ENABLE configuration is enabled.

Returns

• A pointer to the histogram of retries (in a form of an array). The n-th element indicates that the packet has been sent with n-th retry.

otLinkGetTxIndirectRetrySuccessHistogram#

const uint32_t * otLinkGetTxIndirectRetrySuccessHistogram (otInstance *aInstance, uint8_t *aNumberOfEntries)

Gets histogram of retries for a single indirect packet until success.

Is valid when OPENTHREAD_CONFIG_MAC_RETRY_SUCCESS_HISTOGRAM_ENABLE configuration is enabled.

Returns

• A pointer to the histogram of retries (in a form of an array). The n-th element indicates that the packet has been sent with n-th retry.

otLinkResetTxRetrySuccessHistogram#

void otLinkResetTxRetrySuccessHistogram (otInstance *aInstance)

Clears histogram statistics for direct and indirect transmissions.

Is valid when OPENTHREAD_CONFIG_MAC_RETRY_SUCCESS_HISTOGRAM_ENABLE configuration is enabled.

otLinkGetCounters#

const otMacCounters * otLinkGetCounters (otInstance *aInstance)

Get the MAC layer counters.

Returns

• A pointer to the MAC layer counters.

otLinkResetCounters#

void otLinkResetCounters (otInstance *aInstance)

Resets the MAC layer counters.

otLinkSetPcapCallback#

void otLinkSetPcapCallback (otInstance *aInstance, otLinkPcapCallback aPcapCallback, void *aCallbackContext)

Registers a callback to provide received raw IEEE 802.15.4 frames.

otLinkIsPromiscuous#

bool otLinkIsPromiscuous (otInstance *aInstance)

Indicates whether or not promiscuous mode is enabled at the link layer.

otLinkSetPromiscuous#

otError otLinkSetPromiscuous (otInstance *aInstance, bool aPromiscuous)

Enables or disables the link layer promiscuous mode.

Note

• Promiscuous mode may only be enabled when the Thread interface is disabled.

otLinkGetCslChannel#

uint8_t otLinkGetCslChannel (otInstance *aInstance)

Gets the CSL channel.

Returns

• The CSL channel.

otLinkSetCslChannel#

otError otLinkSetCslChannel (otInstance *aInstance, uint8_t aChannel)

Sets the CSL channel.

otLinkGetCslPeriod#

uint32_t otLinkGetCslPeriod (otInstance *aInstance)

Gets the CSL period in microseconds.

Returns

• The CSL period in microseconds.

otLinkSetCslPeriod#

otError otLinkSetCslPeriod (otInstance *aInstance, uint32_t aPeriod)

Sets the CSL period in microseconds.

Disable CSL by setting this parameter to 0.

The CSL period MUST be a multiple of OT_LINK_CSL_PERIOD_TEN_SYMBOLS_UNIT_IN_USEC, otherwise OT_ERROR_INVALID_ARGS is returned.

otLinkGetCslTimeout#

uint32_t otLinkGetCslTimeout (otInstance *aInstance)

Gets the CSL timeout.

Returns

• The CSL timeout in seconds.

otLinkSetCslTimeout#

otError otLinkSetCslTimeout (otInstance *aInstance, uint32_t aTimeout)

Sets the CSL timeout in seconds.

otLinkGetCcaFailureRate#

uint16_t otLinkGetCcaFailureRate (otInstance *aInstance)

Returns the current CCA (Clear Channel Assessment) failure rate.

The rate is maintained over a window of (roughly) last OPENTHREAD_CONFIG_CCA_FAILURE_RATE_AVERAGING_WINDOW frame transmissions.

Returns

• The CCA failure rate with maximum value 0xffff corresponding to 100% failure rate.

otLinkSetEnabled#

otError otLinkSetEnabled (otInstance *aInstance, bool aEnable)

Enables or disables the link layer.

Note

• The link layer may only be enabled / disabled when the Thread Interface is disabled.

otLinkIsEnabled#

bool otLinkIsEnabled (otInstance *aInstance)

Indicates whether or not the link layer is enabled.

otLinkIsCslEnabled#

bool otLinkIsCslEnabled (otInstance *aInstance)

Indicates whether or not CSL is enabled.

otLinkIsCslSupported#

bool otLinkIsCslSupported (otInstance *aInstance)

Indicates whether the device is connected to a parent which supports CSL.

otLinkSendEmptyData#

otError otLinkSendEmptyData (otInstance *aInstance)

Instructs the device to send an empty IEEE 802.15.4 data frame.

Is only supported on an Rx-Off-When-Idle device to send an empty data frame to its parent. Note: available only when OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE is enabled.

otLinkSetRegion#

otError otLinkSetRegion (otInstance *aInstance, uint16_t aRegionCode)

Sets the region code.

The radio region format is the 2-bytes ascii representation of the ISO 3166 alpha-2 code.

otLinkGetRegion#

otError otLinkGetRegion (otInstance *aInstance, uint16_t *aRegionCode)

Get the region code.

The radio region format is the 2-bytes ascii representation of the ISO 3166 alpha-2 code.

OT_US_PER_TEN_SYMBOLS#

#define OT_US_PER_TEN_SYMBOLS

OT_RADIO_TEN_SYMBOLS_TIME

Time for 10 symbols in units of microseconds.

OT_MAC_FILTER_FIXED_RSS_DISABLED#

#define OT_MAC_FILTER_FIXED_RSS_DISABLED

127

Used to indicate no fixed received signal strength was set.

OT_MAC_FILTER_ITERATOR_INIT#

#define OT_MAC_FILTER_ITERATOR_INIT

0

Initializer for otMacFilterIterator.

OT_LINK_CSL_PERIOD_TEN_SYMBOLS_UNIT_IN_USEC#

#define OT_LINK_CSL_PERIOD_TEN_SYMBOLS_UNIT_IN_USEC

(160)

Represents CSL period ten symbols unit in microseconds.

The CSL period (in micro seconds) MUST be a multiple of this value.