KW2x radio-driver

Device driver for the NXP CR20A and KW2xD radios. More...

Detailed Description

Device driver for the NXP CR20A and KW2xD radios.

Modules
	CR20A and KW2xD radio driver compile configuration

Files
file	kw2xrf.h
	Interface definition for the kw2xrf driver.
file	kw2xrf_getset.h
	get/set interfaces for kw2xrf driver
file	kw2xrf_intern.h
	Internal function interfaces for kw2xrf driver.
file	kw2xrf_netdev.h
	Netdev interface for kw2xrf driver.
file	kw2xrf_params.h
	Default configuration for the KW2XRF driver.
file	kw2xrf_reg.h
	Register and command definitions for the MKW2XD Modem.
file	kw2xrf_spi.h
	Definition of KW2XRF SPI functions.
file	kw2xrf_tm.h
	Testing interfaces for kw2xrf driver.

Data Structures
struct	kw2xrf_params
	Struct holding all params needed for device initialization. More...
struct	kw2xrf_t
	Device descriptor for KW2XRF radio devices. More...

Macros
#define	KW2XRF_MAX_PKT_LENGTH   (IEEE802154_FRAME_LEN_MAX)
	Maximum packet length.
#define	KW2XRF_DEFAULT_TX_POWER   (CONFIG_IEEE802154_DEFAULT_TXPOWER)
	Default TX_POWER in dbm used after initialization.
#define	KW2XDRF_OUTPUT_POWER_MAX   (8)
	Maximum output power of the kw2x device in dBm.
#define	KW2XDRF_OUTPUT_POWER_MIN   (-35)
	Minimum output power of the kw2x device in dBm.

Typedefs
typedef struct kw2xrf_params	kw2xrf_params_t
	Struct holding all params needed for device initialization.

Functions
void	kw2xrf_setup (kw2xrf_t *dev, const kw2xrf_params_t *params)
	Setup an KW2XRF based device state. More...
int	kw2xrf_init (kw2xrf_t *dev, gpio_cb_t cb)
	Initialize the given KW2XRF device. More...
void	kw2xrf_reset_phy (kw2xrf_t *dev)
	Configure radio with default values. More...

Allowed range of channels
#define	KW2XRF_MIN_CHANNEL   (11U)
#define	KW2XRF_MAX_CHANNEL   (26U)
#define	KW2XRF_OPT_SRC_ADDR_LONG   (NETDEV_IEEE802154_SRC_MODE_LONG)
	Internal device option flags. More...
#define	KW2XRF_OPT_RAWDUMP   (NETDEV_IEEE802154_RAW)
	legacy define
#define	KW2XRF_OPT_ACK_REQ   (NETDEV_IEEE802154_ACK_REQ)
	legacy define
#define	KW2XRF_OPT_AUTOCCA   (0x0100)
	CCA before TX active.
#define	KW2XRF_OPT_PROMISCUOUS   (0x0200)
	promiscuous mode active
#define	KW2XRF_OPT_PRELOADING   (0x0400)
	preloading enabled
#define	KW2XRF_OPT_TELL_TX_START   (0x0800)
	notify MAC layer on TX start
#define	KW2XRF_OPT_TELL_TX_END   (0x1000)
	notify MAC layer on TX finished
#define	KW2XRF_OPT_TELL_RX_START   (0x2000)
	notify MAC layer on RX start
#define	KW2XRF_OPT_TELL_RX_END   (0x4000)
	notify MAC layer on RX finished
#define	KW2XRF_OPT_AUTOACK   (0x8000)
	enable automatically ACK for incommint packet

Macro Definition Documentation

KW2XRF_OPT_SRC_ADDR_LONG

#define KW2XRF_OPT_SRC_ADDR_LONG   (NETDEV_IEEE802154_SRC_MODE_LONG)

Internal device option flags.

0x00ff is reserved for general IEEE 802.15.4 flags (see netdev_ieee802154_t) legacy define

Definition at line 90 of file kw2xrf.h.

Function Documentation

kw2xrf_init()

int kw2xrf_init	(	kw2xrf_t *	dev,
		gpio_cb_t	cb
	)

Initialize the given KW2XRF device.

Parameters

[out]	dev	device descriptor
[in]	cb	irq callback

Returns

0 on success

<0 on error

kw2xrf_reset_phy()

void kw2xrf_reset_phy

(

kw2xrf_t *

dev

)

Configure radio with default values.

Parameters

[in]

dev

device to reset

kw2xrf_setup()

void kw2xrf_setup	(	kw2xrf_t *	dev,
		const kw2xrf_params_t *	params
	)

Setup an KW2XRF based device state.

Parameters

[out]	dev	device descriptor
[in]	params	parameters for device initialization