Raw Link#

otLinkRawReceiveDone#

typedef void(* otLinkRawReceiveDone) (otInstance *aInstance, otRadioFrame *aFrame, otError aError) )(otInstance *aInstance, otRadioFrame *aFrame, otError aError)

Pointer on receipt of a IEEE 802.15.4 frame.

otLinkRawTransmitDone#

typedef void(* otLinkRawTransmitDone) (otInstance *aInstance, otRadioFrame *aFrame, otRadioFrame *aAckFrame, otError aError) )(otInstance *aInstance, otRadioFrame *aFrame, otRadioFrame *aAckFrame, otError aError)

Pointer on receipt of a IEEE 802.15.4 frame.

otLinkRawEnergyScanDone#

typedef void(* otLinkRawEnergyScanDone) (otInstance *aInstance, int8_t aEnergyScanMaxRssi) )(otInstance *aInstance, int8_t aEnergyScanMaxRssi)

Pointer on receipt of a IEEE 802.15.4 frame.

otLinkRawSetReceiveDone#

otError otLinkRawSetReceiveDone (otInstance * aInstance, otLinkRawReceiveDone aCallback)

Enables/disables the raw link-layer.

otLinkRawIsEnabled#

bool otLinkRawIsEnabled (otInstance * aInstance)

Indicates whether or not the raw link-layer is enabled.

otLinkRawGetPromiscuous#

bool otLinkRawGetPromiscuous (otInstance * aInstance)

Gets the status of promiscuous mode.

otLinkRawSetPromiscuous#

otError otLinkRawSetPromiscuous (otInstance * aInstance, bool aEnable)

Enables or disables promiscuous mode.

otLinkRawSetShortAddress#

otError otLinkRawSetShortAddress (otInstance * aInstance, uint16_t aShortAddress)

Set the Short Address for address filtering.

otLinkRawSetAlternateShortAddress#

otError otLinkRawSetAlternateShortAddress (otInstance * aInstance, otShortAddress aShortAddress)

Set the alternate short address.

This is an optional API. Support for this is indicated by including the capability OT_RADIO_CAPS_ALT_SHORT_ADDR in otLinkRawGetCaps().

When supported, the radio will accept received frames destined to the specified alternate short address in addition to the short address provided in otLinkRawSetShortAddress().

The aShortAddress can be set to OT_RADIO_INVALID_SHORT_ADDR (0xfffe) to clear any previously set alternate short address.

otLinkRawSleep#

otError otLinkRawSleep (otInstance * aInstance)

Transition the radio from Receive to Sleep.

Turn off the radio.

otLinkRawReceive#

otError otLinkRawReceive (otInstance * aInstance)

Transitioning the radio from Sleep to Receive.

Turn on the radio.

otLinkRawGetTransmitBuffer#

otRadioFrame * otLinkRawGetTransmitBuffer (otInstance * aInstance)

The radio transitions from Transmit to Receive.

Returns a pointer to the transmit buffer.

The caller forms the IEEE 802.15.4 frame in this buffer then calls otLinkRawTransmit() to request transmission.

Returns

• A pointer to the transmit buffer or NULL if the raw link-layer isn't enabled.

otLinkRawTransmit#

otError otLinkRawTransmit (otInstance * aInstance, otLinkRawTransmitDone aCallback)

Begins the transmit sequence on the radio.

The caller must form the IEEE 802.15.4 frame in the buffer provided by otLinkRawGetTransmitBuffer() before requesting transmission. The channel and transmit power are also included in the otRadioFrame structure.

The transmit sequence consists of:

1. Transitioning the radio to Transmit from Receive.

2. Transmits the PSDU on the given channel and at the given transmit power.

otLinkRawGetRssi#

int8_t otLinkRawGetRssi (otInstance * aInstance)

Get the most recent RSSI measurement.

Returns

• The RSSI in dBm when it is valid. 127 when RSSI is invalid.

otLinkRawGetCaps#

otRadioCaps otLinkRawGetCaps (otInstance * aInstance)

Get the radio capabilities.

Returns

• The radio capability bit vector. The stack enables or disables some functions based on this value.

otLinkRawEnergyScan#

otError otLinkRawEnergyScan (otInstance * aInstance, uint8_t aScanChannel, uint16_t aScanDuration, otLinkRawEnergyScanDone aCallback)

Begins the energy scan sequence on the radio.

otLinkRawSrcMatchEnable#

otError otLinkRawSrcMatchEnable (otInstance * aInstance, bool aEnable)

Enable/Disable source match for frame pending.

otLinkRawSrcMatchAddShortEntry#

otError otLinkRawSrcMatchAddShortEntry (otInstance * aInstance, uint16_t aShortAddress)

Adding short address to the source match table.

otLinkRawSrcMatchAddExtEntry#

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

Adding extended address to the source match table.

otLinkRawSrcMatchClearShortEntry#

otError otLinkRawSrcMatchClearShortEntry (otInstance * aInstance, uint16_t aShortAddress)

Removing short address to the source match table.

otLinkRawSrcMatchClearExtEntry#

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

Removing extended address to the source match table of the radio.

otLinkRawSrcMatchClearShortEntries#

otError otLinkRawSrcMatchClearShortEntries (otInstance * aInstance)

Removing all the short addresses from the source match table.

otLinkRawSrcMatchClearExtEntries#

otError otLinkRawSrcMatchClearExtEntries (otInstance * aInstance)

Removing all the extended addresses from the source match table.

otLinkRawSetMacKey#

otError otLinkRawSetMacKey (otInstance * aInstance, uint8_t aKeyIdMode, uint8_t aKeyId, const otMacKey * aPrevKey, const otMacKey * aCurrKey, const otMacKey * aNextKey)

Update MAC keys and key index.

otLinkRawSetMacFrameCounter#

otError otLinkRawSetMacFrameCounter (otInstance * aInstance, uint32_t aMacFrameCounter)

Sets the current MAC frame counter value.

Always sets the MAC counter to the new given value aMacFrameCounter independent of the current value.

otLinkRawSetMacFrameCounterIfLarger#

otError otLinkRawSetMacFrameCounterIfLarger (otInstance * aInstance, uint32_t aMacFrameCounter)

Sets the current MAC frame counter value only if the new value is larger than the current one.

otLinkRawGetRadioTime#

uint64_t otLinkRawGetRadioTime (otInstance * aInstance)

Get current platform time (64bits width) of the radio chip.

Returns

• The current radio time in microseconds.