• 2019 Silicon Laboratories Inc.

Modules#

s_rssi_val

_S_ROUTE_LINK_T_

_TX_STATUS_TYPE_

_RECEIVE_OPTIONS_TYPE

_TRANSMIT_OPTIONS_TYPE

_TRANSMIT_MULTI_OPTIONS_TYPE

_RECEIVE_OPTIONS_TYPE.homeId

Macros#

#define
ZW_MAX_NODES 232
#define
ZW_MAX_NODES_LR 1024

Max number of Long Range nodes in a Z-wave system Must not be higher than 4000 according to specs.

#define
LOWEST_LONG_RANGE_NODE_ID (0x0100)
#define
HIGHEST_LONG_RANGE_NODE_ID (LOWEST_LONG_RANGE_NODE_ID + ZW_MAX_NODES_LR - 1)
#define
NODEPARM_MAX 35

max. number of parameters

#define
HOMEID_LENGTH 4

Number of bytes in a homeID.

#define
GET_NLS_NODES_LIST_LENGTH_MAX (128)

Frames should not exceed 128 bytes long.

#define
TRANSMIT_OPTION_ACK 0x01

Request acknowledge from destination node.

#define
TRANSMIT_OPTION_LOW_POWER 0x02

Rransmit at low output power level (1/3 of normal RF range)

#define
TRANSMIT_OPTION_MULTICAST_AS_BROADCAST 0x02

The multicast frame should be send as a broadcast.

#define
TRANSMIT_OPTION_AUTO_ROUTE 0x04

Request retransmission via repeater nodes.

#define
TRANSMIT_OPTION_NO_ROUTE 0x10

Do not use response route - Even if available.

#define
TRANSMIT_OPTION_EXPLORE 0x20

Use explore frame if needed.

#define
TRANSMIT_OPTION_URGENT 0x08

Urgent frame - go to the front of the queue.

#define
RECEIVE_STATUS_ROUTED_BUSY 0x01

< A response route is locked by the application

#define
RECEIVE_STATUS_LOW_POWER 0x02

Received at low output power level, this must have the same value as TRANSMIT_OPTION_LOW_POWER.

#define
RECEIVE_STATUS_TYPE_MASK 0x0C

Mask for masking out the received frametype bits.

#define
RECEIVE_STATUS_TYPE_SINGLE 0x00

Received frame is singlecast frame (rxOptions == xxxx00xx)

#define
RECEIVE_STATUS_TYPE_BROAD 0x04

Received frame is broadcast frame (rxOptions == xxxx01xx)

#define
RECEIVE_STATUS_TYPE_MULTI 0x08

Received frame is multicast frame (rxOptions == xxxx10xx)

#define
RECEIVE_STATUS_TYPE_EXPLORE 0x10

Received frame is an explore frame (rxOptions == xxx1xxxx) Only TYPE_BROAD can be active at the same time as TYPE_EXPLORE.

#define
RECEIVE_STATUS_FOREIGN_FRAME 0x40

Received frame is not send to me (rxOptions == x1xxxxxx)

#define
NODE_BROADCAST 0xFF

Predefined Node ID's.

#define
ZW_TEST_NOT_A_NODEID 0x00
#define
TRANSMIT_COMPLETE_OK 0x00

Transmit OK.

#define
TRANSMIT_COMPLETE_NO_ACK 0x01

Retransmission error.

#define
TRANSMIT_COMPLETE_FAIL 0x02

Transmit error.

#define
TRANSMIT_ROUTING_NOT_IDLE 0x03

Transmit error.

#define
TRANSMIT_COMPLETE_VERIFIED 0x05

Security S2. Receiving node has decrypted the frame.

#define
ZW_MAX_CACHED_RETURN_ROUTE_DESTINATIONS 5
#define
MAX_REPEATERS 4

Max hops in route.

#define
LAST_USED_ROUTE_CONF_SIZE 1

TX_STATUS_TYPE Last Used Route array size definitions.

#define
LAST_USED_ROUTE_SIZE (MAX_REPEATERS + LAST_USED_ROUTE_CONF_SIZE)
#define
S2_TXOPTION_VERIFY_DELIVERY 1

This flag will activate frame delivery.

#define
S2_TXOPTION_SINGLECAST_FOLLOWUP 2

This flag must be present on all single cast followup messages.

#define
S2_TXOPTION_FIRST_SINGLECAST_FOLLOWUP 4

This flag must be present on the first, and only the first single cast followup message in a S2 multicast transmission.

Typedefs#

typedef uint32_t
TxOptions_t

The universal TX-Option flag count.

typedef struct _TRANSMIT_OPTIONS_TYPE
TRANSMIT_OPTIONS_TYPE

Transmit options for ZW_SendDataEx.

typedef struct _TRANSMIT_MULTI_OPTIONS_TYPE
TRANSMIT_MULTI_OPTIONS_TYPE

Transmit options for ZW_SendDataMultiEx.

Functions#

void
ZW_TxStatusReportInit(TX_STATUS_TYPE *pTxStatusReport, uint8_t app_session_id)

Initialize a TX status report with default values and the given session id.

 

Typedef Documentation#

TxOptions_t#

typedef uint32_t TxOptions_t

The universal TX-Option flag count.


S_ROUTE_LINK_T#

typedef struct _S_ROUTE_LINK_T_ S_ROUTE_LINK_T

TX_STATUS_TYPE#

typedef struct _TX_STATUS_TYPE_ TX_STATUS_TYPE

RECEIVE_OPTIONS_TYPE#

typedef struct _RECEIVE_OPTIONS_TYPE RECEIVE_OPTIONS_TYPE

TRANSMIT_OPTIONS_TYPE#

typedef struct _TRANSMIT_OPTIONS_TYPE TRANSMIT_OPTIONS_TYPE

Transmit options for ZW_SendDataEx.


TRANSMIT_MULTI_OPTIONS_TYPE#

typedef struct _TRANSMIT_MULTI_OPTIONS_TYPE TRANSMIT_MULTI_OPTIONS_TYPE

Transmit options for ZW_SendDataMultiEx.


Function Documentation#

ZW_TxStatusReportInit#

void ZW_TxStatusReportInit (TX_STATUS_TYPE * pTxStatusReport, uint8_t app_session_id)

Initialize a TX status report with default values and the given session id.

Parameters
TypeDirectionArgument NameDescription
TX_STATUS_TYPE *N/ApTxStatusReport
uint8_tN/Aapp_session_id