• 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
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
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
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
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.

Macro Definition Documentation#

ZW_MAX_NODES#

#define ZW_MAX_NODES
Value:
232

ZW_MAX_NODES_LR#

#define ZW_MAX_NODES_LR
Value:
1024

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


LOWEST_LONG_RANGE_NODE_ID#

#define LOWEST_LONG_RANGE_NODE_ID
Value:
(0x0100)

HIGHEST_LONG_RANGE_NODE_ID#

#define HIGHEST_LONG_RANGE_NODE_ID
Value:
(LOWEST_LONG_RANGE_NODE_ID + ZW_MAX_NODES_LR - 1)

NODEPARM_MAX#

#define NODEPARM_MAX
Value:
35

max. number of parameters


HOMEID_LENGTH#

#define HOMEID_LENGTH
Value:
4

Number of bytes in a homeID.


GET_NLS_NODES_LIST_LENGTH_MAX#

#define GET_NLS_NODES_LIST_LENGTH_MAX
Value:
(128)

Frames should not exceed 128 bytes long.


TRANSMIT_OPTION_ACK#

#define TRANSMIT_OPTION_ACK
Value:
0x01

Request acknowledge from destination node.


TRANSMIT_OPTION_LOW_POWER#

#define TRANSMIT_OPTION_LOW_POWER
Value:
0x02

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


TRANSMIT_OPTION_MULTICAST_AS_BROADCAST#

#define TRANSMIT_OPTION_MULTICAST_AS_BROADCAST
Value:
0x02

The multicast frame should be send as a broadcast.


TRANSMIT_OPTION_AUTO_ROUTE#

#define TRANSMIT_OPTION_AUTO_ROUTE
Value:
0x04

Request retransmission via repeater nodes.


TRANSMIT_OPTION_NO_ROUTE#

#define TRANSMIT_OPTION_NO_ROUTE
Value:
0x10

Do not use response route - Even if available.


TRANSMIT_OPTION_EXPLORE#

#define TRANSMIT_OPTION_EXPLORE
Value:
0x20

Use explore frame if needed.


RECEIVE_STATUS_ROUTED_BUSY#

#define RECEIVE_STATUS_ROUTED_BUSY
Value:
0x01

< A response route is locked by the application


RECEIVE_STATUS_LOW_POWER#

#define RECEIVE_STATUS_LOW_POWER
Value:
0x02

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


RECEIVE_STATUS_TYPE_MASK#

#define RECEIVE_STATUS_TYPE_MASK
Value:
0x0C

Mask for masking out the received frametype bits.


RECEIVE_STATUS_TYPE_SINGLE#

#define RECEIVE_STATUS_TYPE_SINGLE
Value:
0x00

Received frame is singlecast frame (rxOptions == xxxx00xx)


RECEIVE_STATUS_TYPE_BROAD#

#define RECEIVE_STATUS_TYPE_BROAD
Value:
0x04

Received frame is broadcast frame (rxOptions == xxxx01xx)


RECEIVE_STATUS_TYPE_MULTI#

#define RECEIVE_STATUS_TYPE_MULTI
Value:
0x08

Received frame is multicast frame (rxOptions == xxxx10xx)


RECEIVE_STATUS_TYPE_EXPLORE#

#define RECEIVE_STATUS_TYPE_EXPLORE
Value:
0x10

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


RECEIVE_STATUS_FOREIGN_FRAME#

#define RECEIVE_STATUS_FOREIGN_FRAME
Value:
0x40

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

  • useful only in promiscuous mode


NODE_BROADCAST#

#define NODE_BROADCAST
Value:
0xFF

Predefined Node ID's.

broadcast


ZW_TEST_NOT_A_NODEID#

#define ZW_TEST_NOT_A_NODEID
Value:
0x00

TRANSMIT_COMPLETE_OK#

#define TRANSMIT_COMPLETE_OK
Value:
0x00

Transmit OK.


TRANSMIT_COMPLETE_NO_ACK#

#define TRANSMIT_COMPLETE_NO_ACK
Value:
0x01

Retransmission error.


TRANSMIT_COMPLETE_FAIL#

#define TRANSMIT_COMPLETE_FAIL
Value:
0x02

Transmit error.


TRANSMIT_ROUTING_NOT_IDLE#

#define TRANSMIT_ROUTING_NOT_IDLE
Value:
0x03

Transmit error.


TRANSMIT_COMPLETE_VERIFIED#

#define TRANSMIT_COMPLETE_VERIFIED
Value:
0x05

Security S2. Receiving node has decrypted the frame.


ZW_MAX_CACHED_RETURN_ROUTE_DESTINATIONS#

#define ZW_MAX_CACHED_RETURN_ROUTE_DESTINATIONS
Value:
5

MAX_REPEATERS#

#define MAX_REPEATERS
Value:
4

Max hops in route.


LAST_USED_ROUTE_CONF_SIZE#

#define LAST_USED_ROUTE_CONF_SIZE
Value:
1

TX_STATUS_TYPE Last Used Route array size definitions.


LAST_USED_ROUTE_SIZE#

#define LAST_USED_ROUTE_SIZE
Value:
(MAX_REPEATERS + LAST_USED_ROUTE_CONF_SIZE)

S2_TXOPTION_VERIFY_DELIVERY#

#define S2_TXOPTION_VERIFY_DELIVERY
Value:
1

This flag will activate frame delivery.

In this transmission mode the S2_send_data will try to verify that the receiver understood the sent message. This is done by waiting a little to see if the node will respond nonce report to the encrypted message. If the node does respond with a nonce report then the S2_send_data call will automatically cause the system to re-sync the node, and deliver the message


S2_TXOPTION_SINGLECAST_FOLLOWUP#

#define S2_TXOPTION_SINGLECAST_FOLLOWUP
Value:
2

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


S2_TXOPTION_FIRST_SINGLECAST_FOLLOWUP#

#define S2_TXOPTION_FIRST_SINGLECAST_FOLLOWUP
Value:
4

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


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.