Device driver for the NXP KW41Z, KW21Z in-cpu transceiver. More...

Detailed Description

Device driver for the NXP KW41Z, KW21Z in-cpu transceiver.

Topics
	KW41Z, KW21Z in-cpu transceiver driver compile configuration

Files
file	kw41zrf.h
	Interface definition for the kw41zrf driver.

file	kw41zrf_getset.h
	get/set interfaces for kw41zrf driver

file	kw41zrf_intern.h
	Internal function interfaces for kw41zrf driver.

file	kw41zrf_netdev.h
	Netdev interface for kw41zrf driver.

Data Structures
struct	kw41zrf_t
	Device descriptor for KW41ZRF radio devices. More...

Macros
#define	KW41ZRF_MAX_PKT_LENGTH (IEEE802154_FRAME_LEN_MAX)
	Maximum packet length.

#define	KW41ZRF_DEFAULT_TX_POWER (CONFIG_IEEE802154_DEFAULT_TXPOWER)
	Default TX_POWER in dbm used after initialization.

#define	KW41ZRF_OUTPUT_POWER_MAX (4)
	Maximum output power of the kw41z device in dBm.

#define	KW41ZRF_OUTPUT_POWER_MIN (-19)
	Minimum output power of the kw41z device in dBm.

#define	KW41ZRF_CCATYPE_MODE1 (1U)
	CCA modes.

#define	KW41ZRF_CCATYPE_MODE2 (2U)
	CCA Mode 2 - Carrier Sense.

#define	KW41ZRF_CCATYPE_MODE3 (3U)
	CCA Mode 3 - Combined.

#define	KW41ZRF_MAX_BOOT_RETRIES (9)
	Maximum number of boot retries for the KW41Z radio.

Typedefs
typedef void(*	kw41zrf_cb_t) (void *arg)
	ISR callback function type.

Functions
void	kw41zrf_hal_setup (ieee802154_dev_t *hal)
	Setup KW41Z in order to be used with the IEEE 802.15.4 Radio HAL.

int	kw41zrf_init (void)
	Initialize the given KW41ZRF device.

int	kw41zrf_reset_hardware (kw41zrf_t *dev)
	Reset radio hardware and restore default settings.

void	kw41zrf_print_irq_state (void)
	Print ZLL IRQSTS register state.

void	kw41zrf_print_phy_ctrl (void)
	Print ZLL PHY_CTRL register state.

void	kw41zrf_print_seq_ctrl_sts (void)
	Print ZLL SEQ_CTRL_STS register state.

#define	KW41ZRF_MIN_CHANNEL (11U)
	Allowed range of channels.

#define	KW41ZRF_MAX_CHANNEL (26U)

Macro Definition Documentation

◆ KW41ZRF_CCATYPE_MODE1

#define KW41ZRF_CCATYPE_MODE1 (1U)

CCA modes.

CCA Mode 1 - Energy

Definition at line 91 of file kw41zrf.h.

◆ KW41ZRF_CCATYPE_MODE2

#define KW41ZRF_CCATYPE_MODE2 (2U)

CCA Mode 2 - Carrier Sense.

Definition at line 92 of file kw41zrf.h.

◆ KW41ZRF_CCATYPE_MODE3

#define KW41ZRF_CCATYPE_MODE3 (3U)

CCA Mode 3 - Combined.

Definition at line 93 of file kw41zrf.h.

◆ KW41ZRF_DEFAULT_TX_POWER

#define KW41ZRF_DEFAULT_TX_POWER (CONFIG_IEEE802154_DEFAULT_TXPOWER)

Default TX_POWER in dbm used after initialization.

Definition at line 76 of file kw41zrf.h.

◆ KW41ZRF_MAX_BOOT_RETRIES

#define KW41ZRF_MAX_BOOT_RETRIES (9)

Maximum number of boot retries for the KW41Z radio.

Definition at line 98 of file kw41zrf.h.

◆ KW41ZRF_MAX_CHANNEL

#define KW41ZRF_MAX_CHANNEL (26U)

Definition at line 70 of file kw41zrf.h.

◆ KW41ZRF_MAX_PKT_LENGTH

#define KW41ZRF_MAX_PKT_LENGTH (IEEE802154_FRAME_LEN_MAX)

Maximum packet length.

Definition at line 35 of file kw41zrf.h.

◆ KW41ZRF_MIN_CHANNEL

#define KW41ZRF_MIN_CHANNEL (11U)

Allowed range of channels.

Definition at line 69 of file kw41zrf.h.

◆ KW41ZRF_OUTPUT_POWER_MAX

#define KW41ZRF_OUTPUT_POWER_MAX (4)

Maximum output power of the kw41z device in dBm.

Definition at line 81 of file kw41zrf.h.

◆ KW41ZRF_OUTPUT_POWER_MIN

#define KW41ZRF_OUTPUT_POWER_MIN (-19)

Minimum output power of the kw41z device in dBm.

Definition at line 86 of file kw41zrf.h.

Typedef Documentation

◆ kw41zrf_cb_t

typedef void(* kw41zrf_cb_t) (void *arg)

ISR callback function type.

Definition at line 103 of file kw41zrf.h.

Function Documentation

◆ kw41zrf_hal_setup()

void kw41zrf_hal_setup ( ieee802154_dev_t * hal )

Setup KW41Z in order to be used with the IEEE 802.15.4 Radio HAL.

Note: This functions MUST be called before kw41zrf_init.

Parameters

[in] hal pointer to the HAL descriptor associated to the device.

◆ kw41zrf_init()

int kw41zrf_init ( void )

Initialize the given KW41ZRF device.

Return values

0	on success
<0	on error

◆ kw41zrf_reset_hardware()

int kw41zrf_reset_hardware ( kw41zrf_t * dev )

Reset radio hardware and restore default settings.