Radio Configuration#

otPlatRadioGetCaps#

otRadioCaps otPlatRadioGetCaps (otInstance * aInstance)

Get the radio capabilities.

Returns

• The radio capability bit vector (see OT_RADIO_CAP_* definitions).

otPlatRadioGetVersionString#

const char * otPlatRadioGetVersionString (otInstance * aInstance)

Get the radio version string.

This is an optional radio driver platform function. If not provided by platform radio driver, OpenThread uses the OpenThread version instead (See Also

• otGetVersionString()).

Returns

• A pointer to the OpenThread radio version.

otPlatRadioGetReceiveSensitivity#

int8_t otPlatRadioGetReceiveSensitivity (otInstance * aInstance)

Get the radio receive sensitivity value.

Returns

• The radio receive sensitivity value in dBm.

otPlatRadioGetIeeeEui64#

void otPlatRadioGetIeeeEui64 (otInstance * aInstance, uint8_t * aIeeeEui64)

Gets the factory-assigned IEEE EUI-64 for this interface.

otPlatRadioSetPanId#

void otPlatRadioSetPanId (otInstance * aInstance, otPanId aPanId)

Set the PAN ID for address filtering.

otPlatRadioSetExtendedAddress#

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

Set the Extended Address for address filtering.

otPlatRadioSetShortAddress#

void otPlatRadioSetShortAddress (otInstance * aInstance, otShortAddress aShortAddress)

Set the Short Address for address filtering.

otPlatRadioGetTransmitPower#

otError otPlatRadioGetTransmitPower (otInstance * aInstance, int8_t * aPower)

Get the radio's transmit power in dBm.

Note

• The transmit power returned will be no larger than the power specified in the max power table for the current channel.

otPlatRadioSetTransmitPower#

otError otPlatRadioSetTransmitPower (otInstance * aInstance, int8_t aPower)

Set the radio's transmit power in dBm.

Note

• The real transmit power will be no larger than the power specified in the max power table for the current channel.

otPlatRadioGetCcaEnergyDetectThreshold#

otError otPlatRadioGetCcaEnergyDetectThreshold (otInstance * aInstance, int8_t * aThreshold)

Get the radio's CCA ED threshold in dBm measured at antenna connector per IEEE 802.15.4 - 2015 section 10.1.4.

otPlatRadioSetCcaEnergyDetectThreshold#

otError otPlatRadioSetCcaEnergyDetectThreshold (otInstance * aInstance, int8_t aThreshold)

Set the radio's CCA ED threshold in dBm measured at antenna connector per IEEE 802.15.4 - 2015 section 10.1.4.

otPlatRadioGetFemLnaGain#

otError otPlatRadioGetFemLnaGain (otInstance * aInstance, int8_t * aGain)

Gets the external FEM's Rx LNA gain in dBm.

otPlatRadioSetFemLnaGain#

otError otPlatRadioSetFemLnaGain (otInstance * aInstance, int8_t aGain)

Sets the external FEM's Rx LNA gain in dBm.

otPlatRadioGetPromiscuous#

bool otPlatRadioGetPromiscuous (otInstance * aInstance)

Get the status of promiscuous mode.

otPlatRadioSetPromiscuous#

void otPlatRadioSetPromiscuous (otInstance * aInstance, bool aEnable)

Enable or disable promiscuous mode.

otPlatRadioSetMacKey#

void otPlatRadioSetMacKey (otInstance * aInstance, uint8_t aKeyIdMode, uint8_t aKeyId, const otMacKeyMaterial * aPrevKey, const otMacKeyMaterial * aCurrKey, const otMacKeyMaterial * aNextKey, otRadioKeyType aKeyType)

Update MAC keys and key index.

This function is used when radio provides OT_RADIO_CAPS_TRANSMIT_SEC capability.

otPlatRadioSetMacFrameCounter#

void otPlatRadioSetMacFrameCounter (otInstance * aInstance, uint32_t aMacFrameCounter)

This method sets the current MAC frame counter value.

This function is used when radio provides OT_RADIO_CAPS_TRANSMIT_SEC capability.

otPlatRadioSetMacFrameCounterIfLarger#

void otPlatRadioSetMacFrameCounterIfLarger (otInstance * aInstance, uint32_t aMacFrameCounter)

This method sets the current MAC frame counter value only if the new given value is larger than the current value.

This function is used when radio provides OT_RADIO_CAPS_TRANSMIT_SEC capability.

otPlatRadioGetNow#

uint64_t otPlatRadioGetNow (otInstance * aInstance)

Get the current estimated time (in microseconds) of the radio chip.

This microsecond timer must be a free-running timer. The timer must continue to advance with microsecond precision even when the radio is in the sleep state.

Returns

• The current time in microseconds. UINT64_MAX when platform does not support or radio time is not ready.

otPlatRadioGetBusSpeed#

uint32_t otPlatRadioGetBusSpeed (otInstance * aInstance)

Get the bus speed in bits/second between the host and the radio chip.

Returns

• The bus speed in bits/second between the host and the radio chip. Return 0 when the MAC and above layer and Radio layer resides on the same chip.