ieee802154_radio_openthread.h File Reference

This file extends interface of ieee802154_radio.h for OpenThread. More...

#include <zephyr/net/ieee802154_radio.h>

Go to the source code of this file.

Data Structures
struct	ieee802154_openthread_config
	OpenThread specific configuration data of ieee802154 driver. More...
struct	ieee802154_openthread_attr_value
	OpenThread specific attribute value data of ieee802154 driver. More...

Macros
#define	IEEE802154_OPENTHREAD_THREAD_IE_VENDOR_OUI   { 0x9b, 0xb8, 0xea }
	Thread vendor OUI for vendor specific header or nested information elements, see IEEE 802.15.4-2020, sections 7.4.2.2 and 7.4.4.30.
#define	IEEE802154_OPENTHREAD_VENDOR_OUI_LEN   3
	length of IEEE 802.15.4-2020 vendor OUIs

Enumerations
enum	ieee802154_openthread_hw_caps { IEEE802154_OPENTHREAD_HW_MULTIPLE_CCA = BIT(IEEE802154_HW_CAPS_BITS_PRIV_START) }
	OpenThread specific capabilities of ieee802154 driver. More...
enum	ieee802154_openthread_tx_mode { IEEE802154_OPENTHREAD_TX_MODE_TXTIME_MULTIPLE_CCA = IEEE802154_TX_MODE_PRIV_START }
	TX mode. More...
enum	ieee802154_openthread_config_type { IEEE802154_OPENTHREAD_CONFIG_MAX_EXTRA_CCA_ATTEMPTS = IEEE802154_CONFIG_PRIV_START }
	OpenThread specific configuration types of ieee802154 driver. More...
enum	ieee802154_openthread_attr { IEEE802154_OPENTHREAD_ATTR_T_RECCA = IEEE802154_ATTR_PRIV_START , IEEE802154_OPENTHREAD_ATTR_T_CCATX }
	OpenThread specific attributes of ieee802154 driver. More...

Detailed Description

This file extends interface of ieee802154_radio.h for OpenThread.

Macro Definition Documentation

IEEE802154_OPENTHREAD_THREAD_IE_VENDOR_OUI

#define IEEE802154_OPENTHREAD_THREAD_IE_VENDOR_OUI   { 0x9b, 0xb8, 0xea }

Thread vendor OUI for vendor specific header or nested information elements, see IEEE 802.15.4-2020, sections 7.4.2.2 and 7.4.4.30.

in little endian

IEEE802154_OPENTHREAD_VENDOR_OUI_LEN

#define IEEE802154_OPENTHREAD_VENDOR_OUI_LEN   3

length of IEEE 802.15.4-2020 vendor OUIs

Enumeration Type Documentation

ieee802154_openthread_attr

enum ieee802154_openthread_attr

OpenThread specific attributes of ieee802154 driver.

This type extends ieee802154_attr

Enumerator
IEEE802154_OPENTHREAD_ATTR_T_RECCA	Attribute: Maximum time between consecutive CCAs performed back-to-back. This is attribute for T_recca parameter mentioned for IEEE802154_OPENTHREAD_TX_MODE_TXTIME_MULTIPLE_CCA. Time is expressed in microseconds.
IEEE802154_OPENTHREAD_ATTR_T_CCATX	Attribute: Maximum time between detection of CCA idle channel and the moment of start of SHR at the local antenna. This is attribute for T_ccatx parameter mentioned for IEEE802154_OPENTHREAD_TX_MODE_TXTIME_MULTIPLE_CCA. Time is expressed in microseconds.

ieee802154_openthread_config_type

enum ieee802154_openthread_config_type

OpenThread specific configuration types of ieee802154 driver.

This type extends ieee802154_config_type.

Enumerator
IEEE802154_OPENTHREAD_CONFIG_MAX_EXTRA_CCA_ATTEMPTS	Allows to configure extra CCA for transmission requested with mode IEEE802154_OPENTHREAD_TX_MODE_TXTIME_MULTIPLE_CCA. Requires IEEE802154_OPENTHREAD_HW_MULTIPLE_CCA capability.

ieee802154_openthread_hw_caps

enum ieee802154_openthread_hw_caps

OpenThread specific capabilities of ieee802154 driver.

This type extends ieee802154_hw_caps.

Enumerator
IEEE802154_OPENTHREAD_HW_MULTIPLE_CCA	Capability to transmit with IEEE802154_OPENTHREAD_TX_MODE_TXTIME_MULTIPLE_CCA mode.

ieee802154_openthread_tx_mode

enum ieee802154_openthread_tx_mode

TX mode.

Enumerator

IEEE802154_OPENTHREAD_TX_MODE_TXTIME_MULTIPLE_CCA

The IEEE802154_OPENTHREAD_TX_MODE_TXTIME_MULTIPLE_CCA mode allows to send a scheduled packet if the channel is reported idle after at most 1 + max_extra_cca_attempts CCAs performed back-to-back. This mode is a non-standard experimental OpenThread feature. It allows transmission of a packet within a certain time window. The earliest transmission time is specified as in the other TXTIME modes: When the first CCA reports an idle channel then the first symbol of the packet's PHR SHALL be present at the local antenna at the time represented by the scheduled TX timestamp (referred to as T_tx below). If the first CCA reports a busy channel, then additional CCAs up to max_extra_cca_attempts will be done until one of them reports an idle channel and the packet is sent out or the max number of attempts is reached in which case the transmission fails. The timing of these additional CCAs depends on the capabilities of the driver which reports them in the T_recca and T_ccatx driver attributes (see IEEE802154_OPENTHREAD_ATTR_T_RECCA and IEEE802154_OPENTHREAD_ATTR_T_CCATX). Based on these attributes the upper layer can calculate the latest point in time (T_txmax) that the first symbol of the scheduled packet's PHR SHALL be present at the local antenna: T_maxtxdelay = max_extra_cca_attempts * (aCcaTime + T_recca) - T_recca + T_ccatx T_txmax = T_tx + T_maxtxdelay See IEEE 802.15.4-2020, section 11.3, table 11-1 for the definition of aCcaTime. Drivers implementing this TX mode SHOULD keep T_recca and T_ccatx as short as possible. T_ccatx SHALL be less than or equal aTurnaroundTime as defined in ibid., section 11.3, table 11-1. CCA SHALL be executed as defined by the phyCcaMode PHY PIB attribute (see ibid., section 11.3, table 11-2). Requires IEEE802154_OPENTHREAD_HW_MULTIPLE_CCA capability. Note Capability IEEE802154_HW_SELECTIVE_TXCHANNEL applies as for IEEE802154_TX_MODE_TXTIME_CCA.