Configuration
Platform Abstraction > Radio

This module includes the platform abstraction for radio configuration.

Functions

otRadioCaps otPlatRadioGetCaps (otInstance *aInstance)
 Get the radio capabilities.
 
const char * otPlatRadioGetVersionString (otInstance *aInstance)
 Get the radio version string.
 
int8_t otPlatRadioGetReceiveSensitivity (otInstance *aInstance)
 Get the radio receive sensitivity value.
 
void otPlatRadioGetIeeeEui64 (otInstance *aInstance, uint8_t *aIeeeEui64)
 Get the factory-assigned IEEE EUI-64 for this interface.
 
void otPlatRadioSetPanId (otInstance *aInstance, otPanId aPanId)
 Set the PAN ID for address filtering.
 
void otPlatRadioSetExtendedAddress (otInstance *aInstance, const otExtAddress *aExtAddress)
 Set the Extended Address for address filtering.
 
void otPlatRadioSetShortAddress (otInstance *aInstance, otShortAddress aShortAddress)
 Set the Short Address for address filtering.
 
otError otPlatRadioGetTransmitPower (otInstance *aInstance, int8_t *aPower)
 Get the radio's transmit power in dBm.
 
otError otPlatRadioSetTransmitPower (otInstance *aInstance, int8_t aPower)
 Set the radio's transmit power in dBm.
 
otError otPlatRadioGetCcaEnergyDetectThreshold (otInstance *aInstance, int8_t *aThreshold)
 Get the radio's CCA ED threshold in dBm.
 
otError otPlatRadioSetCcaEnergyDetectThreshold (otInstance *aInstance, int8_t aThreshold)
 Set the radio's CCA ED threshold in dBm.
 
bool otPlatRadioGetPromiscuous (otInstance *aInstance)
 Get the status of promiscuous mode.
 
void otPlatRadioSetPromiscuous (otInstance *aInstance, bool aEnable)
 Enable or disable promiscuous mode.

Detailed Description

This module includes the platform abstraction for radio configuration.

Function Documentation

◆ otPlatRadioGetCaps()

otRadioCaps otPlatRadioGetCaps ( otInstance *  aInstance)

Get the radio capabilities.

Parameters
[in]aInstanceThe OpenThread instance structure.
Returns
The radio capability bit vector (see OT_RADIO_CAP_* definitions).

◆ otPlatRadioGetCcaEnergyDetectThreshold()

otError otPlatRadioGetCcaEnergyDetectThreshold ( otInstance *  aInstance,
int8_t *  aThreshold 
)

Get the radio's CCA ED threshold in dBm.

Parameters
[in]aInstanceThe OpenThread instance structure.
[out]aThresholdThe CCA ED threshold in dBm.
Return values
OT_ERROR_NONESuccessfully retrieved the CCA ED threshold.
OT_ERROR_INVALID_ARGSaThreshold was NULL.
OT_ERROR_NOT_IMPLEMENTEDCCA ED threshold configuration via dBm is not implemented.

◆ otPlatRadioGetIeeeEui64()

void otPlatRadioGetIeeeEui64 ( otInstance *  aInstance,
uint8_t *  aIeeeEui64 
)

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

Parameters
[in]aInstanceThe OpenThread instance structure.
[out]aIeeeEui64A pointer to the factory-assigned IEEE EUI-64.

◆ otPlatRadioGetPromiscuous()

bool otPlatRadioGetPromiscuous ( otInstance *  aInstance)

Get the status of promiscuous mode.

Parameters
[in]aInstanceThe OpenThread instance structure.
Return values
TRUEPromiscuous mode is enabled.
FALSEPromiscuous mode is disabled.

◆ otPlatRadioGetReceiveSensitivity()

int8_t otPlatRadioGetReceiveSensitivity ( otInstance *  aInstance)

Get the radio receive sensitivity value.

Parameters
[in]aInstanceThe OpenThread instance structure.
Returns
The radio receive sensitivity value in dBm.

◆ otPlatRadioGetTransmitPower()

otError otPlatRadioGetTransmitPower ( otInstance *  aInstance,
int8_t *  aPower 
)

Get the radio's transmit power in dBm.

Parameters
[in]aInstanceThe OpenThread instance structure.
[out]aPowerThe transmit power in dBm.
Return values
OT_ERROR_NONESuccessfully retrieved the transmit power.
OT_ERROR_INVALID_ARGSaPower was NULL.
OT_ERROR_NOT_IMPLEMENTEDTransmit power configuration via dBm is not implemented.

◆ 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()).
Parameters
[in]aInstanceThe OpenThread instance structure.
Returns
A pointer to the OpenThread radio version.

◆ otPlatRadioSetCcaEnergyDetectThreshold()

otError otPlatRadioSetCcaEnergyDetectThreshold ( otInstance *  aInstance,
int8_t  aThreshold 
)

Set the radio's CCA ED threshold in dBm.

Parameters
[in]aInstanceThe OpenThread instance structure.
[in]aThresholdThe CCA ED threshold in dBm.
Return values
OT_ERROR_NONESuccessfully set the transmit power.
OT_ERROR_INVALID_ARGSGiven threshold is out of range.
OT_ERROR_NOT_IMPLEMENTEDCCA ED threshold configuration via dBm is not implemented.

◆ otPlatRadioSetExtendedAddress()

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

Set the Extended Address for address filtering.

Parameters
[in]aInstanceThe OpenThread instance structure.
[in]aExtAddressA pointer to the IEEE 802.15.4 Extended Address stored in little-endian byte order.

◆ otPlatRadioSetPanId()

void otPlatRadioSetPanId ( otInstance *  aInstance,
otPanId  aPanId 
)

Set the PAN ID for address filtering.

Parameters
[in]aInstanceThe OpenThread instance structure.
[in]aPanIdThe IEEE 802.15.4 PAN ID.

◆ otPlatRadioSetPromiscuous()

void otPlatRadioSetPromiscuous ( otInstance *  aInstance,
bool  aEnable 
)

Enable or disable promiscuous mode.

Parameters
[in]aInstanceThe OpenThread instance structure.
[in]aEnableTRUE to enable or FALSE to disable promiscuous mode.

◆ otPlatRadioSetShortAddress()

void otPlatRadioSetShortAddress ( otInstance *  aInstance,
otShortAddress  aShortAddress 
)

Set the Short Address for address filtering.

Parameters
[in]aInstanceThe OpenThread instance structure.
[in]aShortAddressThe IEEE 802.15.4 Short Address.

◆ otPlatRadioSetTransmitPower()

otError otPlatRadioSetTransmitPower ( otInstance *  aInstance,
int8_t  aPower 
)

Set the radio's transmit power in dBm.

Parameters
[in]aInstanceThe OpenThread instance structure.
[in]aPowerThe transmit power in dBm.
Return values
OT_ERROR_NONESuccessfully set the transmit power.
OT_ERROR_NOT_IMPLEMENTEDTransmit power configuration via dBm is not implemented.