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.

Is used when radio provides OT_RADIO_CAPS_TRANSMIT_SEC capability.

otPlatRadioSetMacFrameCounter#

void otPlatRadioSetMacFrameCounter (otInstance *aInstance, uint32_t aMacFrameCounter)

Sets the current MAC frame counter value.

Is used when radio provides OT_RADIO_CAPS_TRANSMIT_SEC capability.

otPlatRadioSetMacFrameCounterIfLarger#

void otPlatRadioSetMacFrameCounterIfLarger (otInstance *aInstance, uint32_t aMacFrameCounter)

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

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.