Z-Wave Transport API#

Z-Wave Transport Application layer interface.

The Z Wave transport layer controls transfer of data between Z Wave nodes including retransmission, frame check and acknowledgement. The Z Wave transport interface includes functions for transfer of data to other Z Wave nodes. Application data received from other nodes is handed over to the application via the ApplicationCommandHandler function. The ZW_MAX_NODES define defines the maximum of nodes possible in a Z Wave network.

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

Transmit Options

Receive Status

Transmit complete codes

Typedefs#

typedef uint32_t

The universal TX-Option flag count.

typedef struct _TRANSMIT_OPTIONS_TYPE

Transmit options for ZW_SendDataEx.

Transmit options for ZW_SendDataMultiEx.

Macros#

#define
#define

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

max. number of parameters

#define

Number of bytes in a homeID.

#define

Predefined Node ID's.

#define

Max hops in route.

#define

TX_STATUS_TYPE Last Used Route array size definitions.

#define
LAST_USED_ROUTE_SIZE (MAX_REPEATERS + LAST_USED_ROUTE_CONF_SIZE)
#define

This flag will activate frame delivery.

#define

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

#define

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.


Definition at line 40 of file /mnt/raid/workspaces/ws.6QOxxjIBR/overlay/gsdk/protocol/z-wave/ZWave/API/ZW_transport_api.h

S_ROUTE_LINK_T#

typedef struct _S_ROUTE_LINK_T_ S_ROUTE_LINK_T

Definition at line 136 of file /mnt/raid/workspaces/ws.6QOxxjIBR/overlay/gsdk/protocol/z-wave/ZWave/API/ZW_transport_api.h

TX_STATUS_TYPE#

typedef struct _TX_STATUS_TYPE_ TX_STATUS_TYPE

Definition at line 157 of file /mnt/raid/workspaces/ws.6QOxxjIBR/overlay/gsdk/protocol/z-wave/ZWave/API/ZW_transport_api.h

RECEIVE_OPTIONS_TYPE#

typedef struct _RECEIVE_OPTIONS_TYPE RECEIVE_OPTIONS_TYPE

Definition at line 185 of file /mnt/raid/workspaces/ws.6QOxxjIBR/overlay/gsdk/protocol/z-wave/ZWave/API/ZW_transport_api.h

TRANSMIT_OPTIONS_TYPE#

typedef struct _TRANSMIT_OPTIONS_TYPE TRANSMIT_OPTIONS_TYPE

Transmit options for ZW_SendDataEx.


Definition at line 228 of file /mnt/raid/workspaces/ws.6QOxxjIBR/overlay/gsdk/protocol/z-wave/ZWave/API/ZW_transport_api.h

TRANSMIT_MULTI_OPTIONS_TYPE#

typedef struct _TRANSMIT_MULTI_OPTIONS_TYPE TRANSMIT_MULTI_OPTIONS_TYPE

Transmit options for ZW_SendDataMultiEx.


Definition at line 242 of file /mnt/raid/workspaces/ws.6QOxxjIBR/overlay/gsdk/protocol/z-wave/ZWave/API/ZW_transport_api.h

Macro Definition Documentation#

ZW_MAX_NODES#

#define ZW_MAX_NODES
Value:
232

Definition at line 27 of file /mnt/raid/workspaces/ws.6QOxxjIBR/overlay/gsdk/protocol/z-wave/ZWave/API/ZW_transport_api.h

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.


Definition at line 31 of file /mnt/raid/workspaces/ws.6QOxxjIBR/overlay/gsdk/protocol/z-wave/ZWave/API/ZW_transport_api.h

LOWEST_LONG_RANGE_NODE_ID#

#define LOWEST_LONG_RANGE_NODE_ID
Value:
(0x0100)

Definition at line 33 of file /mnt/raid/workspaces/ws.6QOxxjIBR/overlay/gsdk/protocol/z-wave/ZWave/API/ZW_transport_api.h

HIGHEST_LONG_RANGE_NODE_ID#

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

Definition at line 35 of file /mnt/raid/workspaces/ws.6QOxxjIBR/overlay/gsdk/protocol/z-wave/ZWave/API/ZW_transport_api.h

NODEPARM_MAX#

#define NODEPARM_MAX
Value:
35

max. number of parameters


Definition at line 37 of file /mnt/raid/workspaces/ws.6QOxxjIBR/overlay/gsdk/protocol/z-wave/ZWave/API/ZW_transport_api.h

HOMEID_LENGTH#

#define HOMEID_LENGTH
Value:
4

Number of bytes in a homeID.


Definition at line 38 of file /mnt/raid/workspaces/ws.6QOxxjIBR/overlay/gsdk/protocol/z-wave/ZWave/API/ZW_transport_api.h

NODE_BROADCAST#

#define NODE_BROADCAST
Value:
0xFF

Predefined Node ID's.

broadcast


Definition at line 96 of file /mnt/raid/workspaces/ws.6QOxxjIBR/overlay/gsdk/protocol/z-wave/ZWave/API/ZW_transport_api.h

ZW_TEST_NOT_A_NODEID#

#define ZW_TEST_NOT_A_NODEID
Value:
0x00

Definition at line 97 of file /mnt/raid/workspaces/ws.6QOxxjIBR/overlay/gsdk/protocol/z-wave/ZWave/API/ZW_transport_api.h

ZW_MAX_CACHED_RETURN_ROUTE_DESTINATIONS#

#define ZW_MAX_CACHED_RETURN_ROUTE_DESTINATIONS
Value:
5

Definition at line 116 of file /mnt/raid/workspaces/ws.6QOxxjIBR/overlay/gsdk/protocol/z-wave/ZWave/API/ZW_transport_api.h

MAX_REPEATERS#

#define MAX_REPEATERS
Value:
4

Max hops in route.


Definition at line 119 of file /mnt/raid/workspaces/ws.6QOxxjIBR/overlay/gsdk/protocol/z-wave/ZWave/API/ZW_transport_api.h

LAST_USED_ROUTE_CONF_SIZE#

#define LAST_USED_ROUTE_CONF_SIZE
Value:
1

TX_STATUS_TYPE Last Used Route array size definitions.


Definition at line 122 of file /mnt/raid/workspaces/ws.6QOxxjIBR/overlay/gsdk/protocol/z-wave/ZWave/API/ZW_transport_api.h

LAST_USED_ROUTE_SIZE#

#define LAST_USED_ROUTE_SIZE
Value:
(MAX_REPEATERS + LAST_USED_ROUTE_CONF_SIZE)

Definition at line 123 of file /mnt/raid/workspaces/ws.6QOxxjIBR/overlay/gsdk/protocol/z-wave/ZWave/API/ZW_transport_api.h

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


Definition at line 199 of file /mnt/raid/workspaces/ws.6QOxxjIBR/overlay/gsdk/protocol/z-wave/ZWave/API/ZW_transport_api.h

S2_TXOPTION_SINGLECAST_FOLLOWUP#

#define S2_TXOPTION_SINGLECAST_FOLLOWUP
Value:
2

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


Definition at line 204 of file /mnt/raid/workspaces/ws.6QOxxjIBR/overlay/gsdk/protocol/z-wave/ZWave/API/ZW_transport_api.h

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.


Definition at line 210 of file /mnt/raid/workspaces/ws.6QOxxjIBR/overlay/gsdk/protocol/z-wave/ZWave/API/ZW_transport_api.h