Silicon Labs Z-Ware Library User guide

Type
User guide
Instruction
Z-Ware Library User Guide
Document No.: INS14129
Version: 2
Description:
Z-Ware Library & C API
Written By: DCHOW;SAMBAT;YANYAN
Date: 2017-12-26
Reviewed By: YANYAN;KSUNDARAM;CRASMUSSEN
Restrictions: Partners Only
Approved by:
Date CET Initials Name Justification
2018-05-02 15:24:27 NTJ Niels Thybo Johansen
This document is the property of Silicon Labs. The data contained herein, in whole or in
part, may not be duplicated, used or disclosed outside the recipient for any purpose. This
restriction does not limit the recipient's right to use information contained in the data if it
is obtained from another source without restriction.
INS14129-5 Z-Ware Library User Guide 2018-05-02
silabs.com | Building a more connected world.
Page ii of xxii
REVISION RECORD
Date
By
Pages affected
Brief description of changes
20171006
DCHOW
ALL
- Cloned from INS13172-9
- v8.03
-
Modified table ZW_SENSOR_TYPE_XXX, ZW_SENSOR_UNIT_XXX_YYY to fix
TO#07866
- Modified tables zwnet_notify_fn Parameters, zwnet_sts_t structure, zwnetd_t
structure, zwnet_init_t structure, zwconfig_t structure, ZW_THRMO_MD_XXX,
zwrep_thrmo_md_fn Parameters, zwif_thrmo_md_set Parameters,
ZW_THRMO_OP_STA_XXX,
Controlled Z Wave CCs, Node Update endpoint get/set CCs.
- Added tables zw_health_prg_t structure, zw_health_rpt_t structure,
zw_health_sts_t structure, pl_info_fn Parameters.
- Added sections Command Class Configuration, Smart Start, Network Health Check.
- Changed prekit whitelist APIs zwnet_wl_xxx to provisioning list APIs zwnet_pl_xxx
- Updated REFERENCES
- Support COMMAND_CLASS_CONFIGURATION version 2
- Support COMMAND_CLASS_THERMOSTAT_OPERATING_STATE version 2
- Support COMMAND_CLASS_THERMOSTAT_MODE version 3
- Support Smart Start and provisioning list management.
20171103
DCHOW
120-123
- v8.04
- Modified tables zwrep_prot_fn Parameters, zwif_prot_get Parameters,
zwrep_prot_ec_fn Parameters, zwif_prot_ec_get Parameters, zwrep_prot_tmout_fn
Parameters, zwif_prot_tmout_get Parameters
20180215
DCHOW
ALL
- v8.12
- Modified tables Controlled CCs, Multi-level Sensor Type: ZW_SENSOR_TYPE_XXX,
Multi-level Sensor Unit, ZW_SENSOR_UNIT_XXX_YYY, ZW_ERR_XXX, if_rec_config_t,
zwrep_csc_cfg_fn Parameters, pl_info_t, pl_uuid_t, Node Update endpoint get/set
CCs
- Added tables if_rec_cfg_set_t, if_rec_cfg_info_t, pl_nw_sts_t
- Modified section JSON File Format with configuration parameter information.
- Modified section Building of sample applications
to support building of applications
that link with shared libraries.
- Modified section Ubuntu Linux and added sections BBB and RPi3 to support
building of shared libraries.
- Added section Installation of sample applications, zwif_config_prm_reset,
zwif_config_info_get, zwif_config_info_free
- Added text in section zwnet_abort to e
xplain certain network operations cannot be
undone completely at certain stage
- Added figure in section S2 on interaction between Z-Ware library & client
- Support COMMAND_CLASS_NOTIFICATION version 8
- Modified tables "Z Wave Alarm//Notification Type","ZW_ALRM_XXX",
"ZW_ALRM_EVT_XXX", "ZW_ALRM_STS_XXX"
20180308
BBR
All
Added Silicon Labs template
20180418
SNA
105
Fixed zwif_battery_rpt_set doc
20180426
SNA
172
Updated platform memory requirements
INS14129-5 Z-Ware Library User Guide 2018-05-02
silabs.com | Building a more connected world.
Page iii of xxii
Table of Contents
1 INTRODUCTION ...................................................................................................................... 1
1.1 Purpose ............................................................................................................................................. 1
1.2 Audience and prerequisites ........................................................................................................... 1
2 FEATURES .............................................................................................................................. 2
2.1 Role ................................................................................................................................................... 2
2.2 Network Operations ........................................................................................................................ 3
2.3 Device Control .................................................................................................................................. 3
2.4 CC Support ....................................................................................................................................... 4
2.5 Network Initialization ....................................................................................................................... 6
2.6 Node Update .................................................................................................................................... 7
2.7 Network Update ............................................................................................................................... 8
2.8 Background Polling ......................................................................................................................... 8
2.9 Post-Set Polling ............................................................................................................................... 9
2.10 Command Class Configuration ..................................................................................................... 9
3 TYPICAL USAGE .................................................................................................................. 10
3.1 Network Initialization .....................................................................................................................10
3.2 Network creation and tear down .................................................................................................10
3.3 Portal Usage ...................................................................................................................................11
3.3.1 Portal Initialization ...............................................................................................................11
3.3.2 Portal Shutdown ..................................................................................................................11
3.3.3 Portal Client Profile Management .....................................................................................12
3.4 Interface monitor/control ...............................................................................................................12
3.5 Node identification .........................................................................................................................13
3.6 Grouping .........................................................................................................................................14
3.7 Sleeping nodes ..............................................................................................................................14
3.8 Firmware update ............................................................................................................................14
3.9 Polling facility ..................................................................................................................................15
3.10 Device specific configuration and information database .........................................................15
3.11 Network and client preference storage ......................................................................................15
3.12 Security 2 (S2) ...............................................................................................................................16
3.13 SmartStart .......................................................................................................................................17
3.14 Network Health Check ..................................................................................................................17
4 API .......................................................................................................................................... 19
4.1 Error Codes ....................................................................................................................................19
4.2 Portal API ........................................................................................................................................21
4.2.1 zwportal_init .........................................................................................................................21
4.2.2 zwportal_shutdown .............................................................................................................23
4.2.3 zwportal_exit ........................................................................................................................23
4.2.4 zwportal_clnt_conn_close ..................................................................................................23
4.2.5 zwportal_clnt_add ...............................................................................................................23
INS14129-5 Z-Ware Library User Guide 2018-05-02
silabs.com | Building a more connected world.
Page iv of xxii
4.2.6 zwportal_clnt_rm .................................................................................................................23
4.2.7 zwportal_clnt_find................................................................................................................24
4.2.8 zwportal_clnt_list_free ........................................................................................................24
4.2.9 zwportal_clnt_list_get .........................................................................................................24
4.3 Device Database API ....................................................................................................................25
4.3.1 zwdev_cfg_load ...................................................................................................................25
4.3.2 zwdev_cfg_free....................................................................................................................41
4.3.3 zwdev_global_sett_free ......................................................................................................41
4.3.4 zwdev_cfg_find ....................................................................................................................41
4.3.5 JSON File Format ................................................................................................................42
4.4 Network API ....................................................................................................................................49
4.4.1 zwnet_gw_discvr_start .......................................................................................................50
4.4.2 zwnet_gw_discvr_stop .......................................................................................................50
4.4.3 zwnet_ip_aton ......................................................................................................................51
4.4.4 zwnet_ip_ntoa ......................................................................................................................51
4.4.5 zwnet_local_addr_get .........................................................................................................51
4.4.6 zwnet_listen_port_get .........................................................................................................51
4.4.7 zwnet_init ..............................................................................................................................52
4.4.8 zwnet_exit .............................................................................................................................59
4.4.9 zwnet_get_desc ...................................................................................................................59
4.4.10 zwnet_add ............................................................................................................................60
4.4.11 zwnet_fail ..............................................................................................................................61
4.4.12 zwnet_migrate......................................................................................................................62
4.4.13 zwnet_initiate .......................................................................................................................62
4.4.14 zwnet_initiate_classic .........................................................................................................62
4.4.15 zwnet_update .......................................................................................................................63
4.4.16 zwnet_abort ..........................................................................................................................63
4.4.17 zwnet_reset ..........................................................................................................................63
4.4.18 zwnet_health_chk................................................................................................................63
4.4.19 zwnet_get_node ..................................................................................................................63
4.4.20 zwnet_get_node_ by_id .....................................................................................................64
4.4.21 zwnet_get_ep_ by_id ..........................................................................................................64
4.4.22 zwnet_get_if_ by_id ............................................................................................................64
4.4.23 zwnet_get_user ...................................................................................................................65
4.4.24 zwnet_send_nif ....................................................................................................................65
4.4.25 zwnet_all_node_sts_get .....................................................................................................65
4.4.26 zwnet_node_sts_get ...........................................................................................................65
4.4.27 zwnet_poll_rm ......................................................................................................................66
4.4.28 zwnet_poll_rm_mul .............................................................................................................66
4.4.29 zwnet_pref_set ....................................................................................................................66
4.4.30 zwnet_pref_get ....................................................................................................................66
4.4.31 zwnet_client_pref_set .........................................................................................................67
4.4.32 zwnet_client_pref_get .........................................................................................................67
4.4.33 zwnet_add_sec2_accept ....................................................................................................67
4.4.34 zwnet_add_sec2_grant_key ..............................................................................................67
INS14129-5 Z-Ware Library User Guide 2018-05-02
silabs.com | Building a more connected world.
Page v of xxii
4.4.35 zwnet_sec2_get_dsk ..........................................................................................................68
4.4.36 zwnet_pl_add .......................................................................................................................68
4.4.37 zwnet_pl_get ........................................................................................................................71
4.4.38 zwnet_pl_del ........................................................................................................................72
4.4.39 zwnet_pl_list_get .................................................................................................................72
4.4.40 zwnet_pl_list_del .................................................................................................................72
4.5 Node API .........................................................................................................................................73
4.5.1 zwnoded_t ............................................................................................................................73
4.5.2 zwnode_get_net ..................................................................................................................74
4.5.3 zwnode_get_next ................................................................................................................74
4.5.4 zwnode_get_ep ...................................................................................................................74
4.5.5 zwnode_update ...................................................................................................................75
4.5.6 zwnode_cmd_q_ena_set ...................................................................................................75
4.5.7 zwnode_cmd_q_ena_get ...................................................................................................75
4.5.8 zwnode_cmd_q_cancel ......................................................................................................75
4.5.9 zwnode_cmd_q_get ............................................................................................................75
4.5.10 zwnode_mul_cmd_ctl_set ..................................................................................................76
4.5.11 zwnode_mul_cmd_ctl_get .................................................................................................76
4.5.12 zwnode_get_ext_ver ...........................................................................................................76
4.6 Endpoint API ..................................................................................................................................77
4.6.1 zwepd_t .................................................................................................................................77
4.6.2 zwep_get_node ...................................................................................................................77
4.6.3 zwep_get_next .....................................................................................................................78
4.6.4 zwep_get_if ..........................................................................................................................78
4.6.5 zwep_nameloc_set .............................................................................................................78
4.7 Interface API ...................................................................................................................................78
4.7.1 zwifd_t ...................................................................................................................................79
4.7.2 zwif_get_ep ..........................................................................................................................79
4.7.3 zwif_get_next .......................................................................................................................80
4.7.4 zwif_exec ..............................................................................................................................80
4.7.5 zwif_xxx_poll ........................................................................................................................80
4.8 Basic Interface API ........................................................................................................................81
4.8.1 zwif_basic_rpt_set ...............................................................................................................81
4.8.2 zwif_basic_get .....................................................................................................................82
4.8.3 zwif_basic_set......................................................................................................................82
4.9 Group Interface API ......................................................................................................................82
4.9.1 zwif_group_sup_get ............................................................................................................82
4.9.2 zwif_group_actv_get ...........................................................................................................83
4.9.3 zwif_group_get ....................................................................................................................83
4.9.4 zwif_group_add ...................................................................................................................84
4.9.5 zwif_group_del .....................................................................................................................84
4.9.6 zwif_group_info_get ............................................................................................................84
4.9.7 zwif_group_info_free ..........................................................................................................85
4.10 Switch Interface API ......................................................................................................................85
4.10.1 zwif_switch_rpt_set .............................................................................................................85
INS14129-5 Z-Ware Library User Guide 2018-05-02
silabs.com | Building a more connected world.
Page vi of xxii
4.10.2 zwif_switch_get....................................................................................................................86
4.10.3 zwif_switch_set ....................................................................................................................87
4.11 Level Interface API ........................................................................................................................87
4.11.1 zwif_level_rpt_set ................................................................................................................87
4.11.2 zwif_level_sup_get ..............................................................................................................88
4.11.3 zwif_level_sup_cache_get .................................................................................................89
4.11.4 zwif_level_get ......................................................................................................................89
4.11.5 zwif_level_set .......................................................................................................................89
4.11.6 zwif_level_start ....................................................................................................................90
4.11.7 zwif_level_stop ....................................................................................................................90
4.12 Binary Sensor Interface API.........................................................................................................91
4.12.1 zwif_bsensor_rpt_set ..........................................................................................................91
4.12.2 zwif_bsensor_get ................................................................................................................91
4.12.3 zwif_bsensor_sup_get ........................................................................................................91
4.12.4 zwif_bsensor_sup_cache_get ...........................................................................................92
4.13 Sensor Interface API .....................................................................................................................92
4.13.1 zwif_sensor_rpt_set ............................................................................................................92
4.13.2 zwif_sensor_get ...................................................................................................................95
4.13.3 zwif_sensor_sup_get ..........................................................................................................96
4.13.4 zwif_sensor_unit_get ..........................................................................................................96
4.13.5 zwif_sensor_unit_cache_get .............................................................................................97
4.13.6 zwif_sensor_sup_cache_get .............................................................................................97
4.14 Group Command Interface API ...................................................................................................97
4.14.1 zwif_group_cmd_sup_get ..................................................................................................97
4.14.2 zwif_group_cmd_get ...........................................................................................................98
4.14.3 zwif_group_cmd_set ...........................................................................................................99
4.15 Wake Up Interface API .................................................................................................................99
4.15.1 zwif_wakeup_get .................................................................................................................99
4.15.2 zwif_wakeup_set ...............................................................................................................100
4.16 Configuration Interface API ........................................................................................................100
4.16.1 zwif_config_rpt_set ...........................................................................................................100
4.16.2 zwif_config_get ..................................................................................................................101
4.16.3 zwif_config_set ..................................................................................................................101
4.16.4 zwif_config_bulk_rpt_set ..................................................................................................101
4.16.5 zwif_config_bulk_get ........................................................................................................102
4.16.6 zwif_config_bulk_set .........................................................................................................102
4.16.7 zwif_config_prm_reset ......................................................................................................102
4.16.8 zwif_config_info_get .........................................................................................................103
4.16.9 zwif_config_info_free ........................................................................................................104
4.17 Pulse Meter Interface API ..........................................................................................................104
4.17.1 zwif_pulsemeter_rpt_set ..................................................................................................104
4.17.2 zwif_pulsemeter_get .........................................................................................................105
4.18 Battery Interface API ...................................................................................................................105
4.18.1 zwif_battery_rpt_set ..........................................................................................................105
4.18.2 zwif_battery_get ................................................................................................................105
INS14129-5 Z-Ware Library User Guide 2018-05-02
silabs.com | Building a more connected world.
Page vii of xxii
4.19 AV Interface API ..........................................................................................................................106
4.19.1 zwif_av_set .........................................................................................................................106
4.19.2 zwif_av_caps......................................................................................................................106
4.20 Meter Interface API .....................................................................................................................107
4.20.1 zwif_meter_rpt_set ............................................................................................................107
4.20.2 zwif_meter_get ..................................................................................................................108
4.20.3 zwif_meter_sup_get ..........................................................................................................108
4.20.4 zwif_meter_sup_cache_get .............................................................................................109
4.20.5 zwif_meter_reset ...............................................................................................................110
4.20.6 zwif_meter_set_admin ......................................................................................................110
4.20.7 zwif_meter_get_desc ........................................................................................................110
4.21 Door Lock Interface API .............................................................................................................111
4.21.1 zwif_dlck_op_rpt_set ........................................................................................................111
4.21.2 zwif_dlck_op_get ...............................................................................................................112
4.21.3 zwif_dlck_op_set ...............................................................................................................112
4.21.4 zwif_dlck_cfg_set ..............................................................................................................112
4.21.5 zwif_dlck_cfg_get ..............................................................................................................113
4.22 User Code Interface API ............................................................................................................113
4.22.1 zwif_usrcod_get .................................................................................................................114
4.22.2 zwif_usrcod_set .................................................................................................................114
4.22.3 zwif_usrcod_sup_get ........................................................................................................114
4.22.4 zwif_usrcod_sup_cache_get ...........................................................................................115
4.23 Alarm/Notification Interface API ................................................................................................115
4.23.1 zwif_alrm_rpt_set ..............................................................................................................115
4.23.2 zwif_alrm_get .....................................................................................................................124
4.23.3 zwif_alrm_set .....................................................................................................................124
4.23.4 zwif_alrm_sup_get ............................................................................................................124
4.23.5 zwif_alrm_sup_cache_get ...............................................................................................125
4.23.6 zwif_alrm_sup_evt_get .....................................................................................................125
4.23.7 zwif_alrm_sup_evt_cache_get ........................................................................................126
4.23.8 zwif_alrm_vtype_sup_get ................................................................................................126
4.24 Thermostat Fan Mode Interface API ........................................................................................126
4.24.1 zwif_thrmo_fan_md_rpt_set ............................................................................................126
4.24.2 zwif_thrmo_fan_md_get ...................................................................................................127
4.24.3 zwif_thrmo_fan_md_set ...................................................................................................128
4.24.4 zwif_thrmo_fan_md_sup_get ..........................................................................................128
4.24.5 zwif_thrmo_fan_md_sup_cache_get .............................................................................128
4.25 Thermostat Fan State Interface API .........................................................................................129
4.25.1 zwif_thrmo_fan_sta_rpt_set ............................................................................................129
4.25.2 zwif_thrmo_fan_sta_get ...................................................................................................130
4.26 Thermostat Mode Interface API ................................................................................................130
4.26.1 zwif_thrmo_md_rpt_set ....................................................................................................130
4.26.2 zwif_thrmo_md_get ...........................................................................................................131
4.26.3 zwif_thrmo_md_set ...........................................................................................................131
4.26.4 zwif_thrmo_md_sup_get ..................................................................................................132
INS14129-5 Z-Ware Library User Guide 2018-05-02
silabs.com | Building a more connected world.
Page viii of xxii
4.26.5 zwif_thrmo_md_sup_cache_get .....................................................................................132
4.27 Thermostat Operating State Interface API ..............................................................................132
4.27.1 zwif_thrmo_op_sta_rpt_set ..............................................................................................132
4.27.2 zwif_thrmo_op_sta_get ....................................................................................................133
4.27.3 zwif_thrmo_op_sta_log_sup_get ....................................................................................133
4.27.4 zwif_thrmo_op_sta_log_sup_cache_get .......................................................................134
4.27.5 zwif_thrmo_op_sta_log_rpt_set ......................................................................................134
4.27.6 zwif_thrmo_op_sta_log_get .............................................................................................135
4.28 Thermostat Setback Interface API ............................................................................................135
4.28.1 zwif_thrmo_setb_rpt_set ..................................................................................................135
4.28.2 zwif_thrmo_setb_get .........................................................................................................136
4.28.3 zwif_thrmo_setb_set .........................................................................................................136
4.29 Thermostat Setpoint Interface API ............................................................................................137
4.29.1 zwif_thrmo_setp_rpt_set ..................................................................................................137
4.29.2 zwif_thrmo_setp_get .........................................................................................................138
4.29.3 zwif_thrmo_setp_set .........................................................................................................138
4.29.4 zwif_thrmo_setp_sup_get ................................................................................................138
4.29.5 zwif_thrmo_setp_sup_cache_get ...................................................................................139
4.29.6 zwif_thrmo_setp_sup_range_get ....................................................................................139
4.29.7 zwif_thrmo_setp_sup_range_cache_get .......................................................................139
4.30 Clock Interface API ......................................................................................................................140
4.30.1 zwif_clock_rpt_set .............................................................................................................140
4.30.2 zwif_clock_get....................................................................................................................140
4.30.3 zwif_clock_set ....................................................................................................................141
4.31 Climate Control Schedule Interface API ..................................................................................141
4.31.1 zwif_clmt_ctl_schd_rpt_set ..............................................................................................141
4.31.2 zwif_clmt_ctl_schd_get ....................................................................................................142
4.31.3 zwif_clmt_ctl_schd_set .....................................................................................................142
4.31.4 zwif_clmt_ctl_schd_chg_rpt_set .....................................................................................142
4.31.5 zwif_clmt_ctl_schd_chg_get ............................................................................................143
4.31.6 zwif_clmt_ctl_schd_ovr_rpt_set ......................................................................................143
4.31.7 zwif_clmt_ctl_schd_ovr_get .............................................................................................143
4.31.8 zwif_clmt_ctl_schd_ovr_set .............................................................................................144
4.32 Protection Interface API ..............................................................................................................144
4.32.1 zwif_prot_rpt_set ...............................................................................................................144
4.32.2 zwif_prot_get ......................................................................................................................145
4.32.3 zwif_prot_set ......................................................................................................................145
4.32.4 zwif_prot_sup_get .............................................................................................................145
4.32.5 zwif_prot_sup_cache_get ................................................................................................146
4.32.6 zwif_prot_ec_rpt_set .........................................................................................................146
4.32.7 zwif_prot_ec_get ...............................................................................................................147
4.32.8 zwif_prot_ec_set................................................................................................................147
4.32.9 zwif_prot_tmout_rpt_set ...................................................................................................147
4.32.10 zwif_prot_tmout_get..........................................................................................................148
4.32.11 zwif_prot_tmout_set ..........................................................................................................148
INS14129-5 Z-Ware Library User Guide 2018-05-02
silabs.com | Building a more connected world.
Page ix of xxii
4.33 Status Interface API ....................................................................................................................148
4.33.1 zwif_appl_busy_rpt_set ....................................................................................................148
4.33.2 zwif_appl_reject_rpt_set ..................................................................................................149
4.34 Indicator Interface API ................................................................................................................149
4.34.1 zwif_ind_rpt_set .................................................................................................................149
4.34.2 zwif_ind_get .......................................................................................................................150
4.34.3 zwif_ind_set........................................................................................................................150
4.35 Firmware Update Interface API .................................................................................................150
4.35.1 zwif_fw_info_get ................................................................................................................150
4.35.2 zwif_fw_updt_req ..............................................................................................................151
4.36 ZIPGW Interface API ..................................................................................................................153
4.36.1 zwif_gw_mode_set............................................................................................................153
4.36.2 zwif_gw_mode_get ...........................................................................................................154
4.36.3 zwif_gw_cfg_lock ..............................................................................................................155
4.36.4 zwif_gw_unsolicit_set .......................................................................................................155
4.36.5 zwif_gw_unsolicit_get .......................................................................................................155
4.37 Z/IP Portal Interface API .............................................................................................................156
4.37.1 zwif_gw_cfg_set ................................................................................................................156
4.37.2 zwif_gw_cfg_get ................................................................................................................156
4.38 Power level Interface API ...........................................................................................................157
4.38.1 zwif_power_level_rpt_set .................................................................................................157
4.38.2 zwif_power_level_get .......................................................................................................157
4.38.3 zwif_power_level_set ........................................................................................................158
4.38.4 zwif_power_level_test_rpt_set ........................................................................................158
4.38.5 zwif_power_level_test_get ...............................................................................................158
4.38.6 zwif_power_level_test_set ...............................................................................................159
4.39 Central Scene Interface API ......................................................................................................159
4.39.1 zwif_csc_rpt_set ................................................................................................................159
4.39.2 zwif_csc_sup_get ..............................................................................................................160
4.39.3 zwif_csc_cfg_rpt_set ........................................................................................................162
4.39.4 zwif_csc_cfg_get ...............................................................................................................162
4.39.5 zwif_csc_cfg_set ...............................................................................................................162
4.40 Alarm Sensor Interface API .......................................................................................................163
4.40.1 zwif_alrm_snsr_rpt_set ....................................................................................................163
4.40.2 zwif_alrm_snsr_get ...........................................................................................................164
4.40.3 zwif_alrm_snsr_sup_get ..................................................................................................164
4.40.4 zwif_alrm_snsr_sup_cache_get ......................................................................................164
4.41 Barrier Operator Interface API ...................................................................................................165
4.41.1 zwif_barrier_rpt_set ..........................................................................................................165
4.41.2 zwif_barrier_get .................................................................................................................165
4.41.3 zwif_barrier_set .................................................................................................................166
4.41.4 zwif_barrier_notif_sup_get ...............................................................................................166
4.41.5 zwif_barrier_notif_sup_cache_get ..................................................................................167
4.41.6 zwif_barrier_notif_rpt_set .................................................................................................167
4.41.7 zwif_barrier_notif_cfg_get ................................................................................................167
INS14129-5 Z-Ware Library User Guide 2018-05-02
silabs.com | Building a more connected world.
Page x of xxii
4.41.8 zwif_barrier_notif_cfg_set ................................................................................................168
4.42 Color Switch Interface API .........................................................................................................168
4.42.1 zwif_color_sw_rpt_set ......................................................................................................168
4.42.2 zwif_color_sw_get .............................................................................................................169
4.42.3 zwif_color_sw_set .............................................................................................................169
4.42.4 zwif_color_sw_start ...........................................................................................................170
4.42.5 zwif_color_sw_stop ...........................................................................................................170
4.42.6 zwif_color_sw_sup_get ....................................................................................................170
4.42.7 zwif_color_sw_sup_cache_get .......................................................................................171
5 SYSTEM REQUIREMENTS ................................................................................................ 172
5.1 Target Platform ............................................................................................................................172
5.2 Build System ................................................................................................................................172
5.3 Build System Setup .....................................................................................................................173
5.3.1 Target Platform Ubuntu Linux .........................................................................................173
5.3.2 Target Platform BeagleBone Black and Raspberry Pi 3 .............................................173
6 BUILD & INSTALL............................................................................................................... 174
6.1 Ubuntu Linux ................................................................................................................................174
6.2 BeagleBone Black .......................................................................................................................175
6.3 Raspberry Pi 3 .............................................................................................................................175
7 SAMPLE APPLICATIONS (CE ONLY)............................................................................... 176
7.1 Getting Started .............................................................................................................................176
7.1.1 Prerequisites ......................................................................................................................176
7.1.2 Building of sample applications .......................................................................................176
7.1.3 Installation of sample applications ..................................................................................176
7.1.4 Configuration ......................................................................................................................177
7.2 Running Sample Applications ....................................................................................................177
7.2.1 ZIPGW Discovery ..............................................................................................................177
7.2.2 Reset Z/IP Network ...........................................................................................................178
7.2.3 Add Node into a Network .................................................................................................178
7.2.3.1 ZIPGW that supports Security 2 (S2) .....................................................................179
7.2.3.2 ZIPGW that does not support Security 2 (S2) .......................................................179
7.2.4 Remove Node from a Network ........................................................................................179
7.2.5 Binary Switch .....................................................................................................................180
7.2.6 Basic ....................................................................................................................................181
7.2.7 Binary Sensor ....................................................................................................................181
8 SOURCE CODE DOCUMENTATION ................................................................................. 183
8.1 Manual Generation of Documentation .....................................................................................183
8.2 Auto Generation of Documentation in Ubuntu Linux..............................................................183
REFERENCES ........................................................................................................................... 184
INS14129-5 Z-Ware Library User Guide 2018-05-02
silabs.com | Building a more connected world.
Page xi of xxii
Table of Tables
Table 1 – Z-Wave example Device and Descriptors ........................................................................... 2
Table 2 – ZIPGW Versions vs Features as used by Z-Ware ............................................................. 2
Table 3 – Controlled Z-Wave CCs ......................................................................................................... 3
Table 4: ZIPGW SDK 2.8x Supported Z-Wave CCs ........................................................................... 4
Table 5: ZIPGW SDK 2.1x Supported Z-Wave CCs ........................................................................... 5
Table 6: ZIPGW SDK 2.0x Supported Z-Wave CCs ........................................................................... 5
Table 7 – Node Update get/set CCs ...................................................................................................... 8
Table 8 – Node Update endpoint get/set CCs ..................................................................................... 8
Table 9 – Network scanning APIs ........................................................................................................ 10
Table 10 – Network initialization API ................................................................................................... 10
Table 11 – Network creation and tear down APIs ............................................................................. 11
Table 12 – Portal initialization API ....................................................................................................... 11
Table 13 – Portal shut down APIs ........................................................................................................ 11
Table 14 – Portal client profile management APIs ............................................................................ 12
Table 15 – Interface Control APIs ........................................................................................................ 12
Table 16 – Node identification APIs ..................................................................................................... 13
Table 17 – Grouping APIs ..................................................................................................................... 14
Table 18 – Command Queuing APIs ................................................................................................... 14
Table 19 – Firmware update APIs ........................................................................................................ 15
Table 20 – Polling facility APIs ............................................................................................................. 15
Table 21 – Device specific configuration and information database APIs ..................................... 15
Table 22 – Network and client preference storage APIs .................................................................. 15
Table 23 – Security 2 APIs .................................................................................................................... 16
Table 24 – Smart Start provisioning list management APIs ............................................................. 17
Table 25 – Network health check API ................................................................................................. 18
Table 26 – Error Codes, ZW_ERR_XXX ............................................................................................ 19
Table 27 – Low-level Library Error Codes .......................................................................................... 20
Table 28 – zwportal_init Parameters ................................................................................................... 21
Table 29 – zwportal_init_t structure ..................................................................................................... 22
Table 30 – clnt_prof_t structure ............................................................................................................ 22
Table 31 – zwportal_cb_t Parameters ................................................................................................. 22
Table 32 – zwportal_shutdown Parameters ....................................................................................... 23
Table 33 – zwportal_exit Parameters .................................................................................................. 23
Table 34 – zwportal_clnt_conn_close Parameters ............................................................................ 23
Table 35 – zwportal_clnt_add Parameters ......................................................................................... 23
Table 36 – zwportal_clnt_rm Parameters ........................................................................................... 23
Table 37 – zwportal_clnt_find Parameters ......................................................................................... 24
Table 38 – zwportal_clnt_list_free Parameters .................................................................................. 24
Table 39 – clnt_prof_lst structure ......................................................................................................... 24
Table 40 – zwportal_clnt_list_get Parameters ................................................................................... 24
Table 41 – zwdev_cfg_load Parameters ............................................................................................. 25
Table 42 – dev_rec_t structure ............................................................................................................. 25
Table 43 – DEV_XXX meaning & values ............................................................................................ 25
INS14129-5 Z-Ware Library User Guide 2018-05-02
silabs.com | Building a more connected world.
Page xii of xxii
Table 44 – ep_rec_t structure ............................................................................................................... 26
Table 45 – redir_rec_t structure ........................................................................................................... 26
Table 46 – if_rec_t structure ................................................................................................................. 26
Table 47 – Interface Types: IF_REC_TYPE_XXX ............................................................................ 27
Table 48 – rec union ............................................................................................................................... 27
Table 49 – if_rec_grp_t structure ......................................................................................................... 27
Table 50 – if_rec_config_t structure .................................................................................................... 27
Table 51 – if_rec_cfg_set_t structure .................................................................................................. 28
Table 52 – if_rec_cfg_info_t structure ................................................................................................. 28
Table 53 – if_rec_bsnsr_t structure ..................................................................................................... 28
Table 54 – if_rec_bsnsr_match_t structure ........................................................................................ 28
Table 55 – if_rec_thrmo_setp_t structure ........................................................................................... 29
Table 56 – zwsetp_temp_range_t structure ....................................................................................... 29
Table 57 – Binary Sensor Types: ZW_BSENSOR_TYPE_XXX ..................................................... 29
Table 58 – Multi-level Sensor Type: ZW_SENSOR_TYPE_XXX ................................................... 29
Table 59 – Multi-level Sensor Unit ....................................................................................................... 31
Table 60 – Meter Type ........................................................................................................................... 34
Table 61 – Meter Supported Unit Bit-mask......................................................................................... 34
Table 62 – Z-Wave Alarm//Notification Type ...................................................................................... 34
Table 63 – Z-Wave Alarm/Notification Event ..................................................................................... 35
Table 64 – Z-Wave Alarm/Notification Event Parameter Type ........................................................ 38
Table 65 – Alarm Sensor Type ............................................................................................................. 38
Table 66 – if_rec_snsr_t structure ........................................................................................................ 39
Table 67 – if_rec_meter_t structure ..................................................................................................... 39
Table 68 – if_rec_alarm_match_t structure ........................................................................................ 39
Table 69 – if_rec_alarm_result_t structure ......................................................................................... 39
Table 70 – if_rec_alarm_rev_match_t structure ................................................................................ 40
Table 71 – if_rec_basic_match_t structure ......................................................................................... 40
Table 72 – if_rec_alrm_snsr_match_t structure................................................................................. 40
Table 73 – dev_cfg_error_t structure .................................................................................................. 40
Table 74 – zwdev_cfg_free Parameters ............................................................................................. 41
Table 75 – zwdev_global_sett_free Parameters ............................................................................... 41
Table 76 – zwdev_cfg_find Parameters .............................................................................................. 41
Table 77 – dev_rec_srch_key_t structure ........................................................................................... 41
Table 78 – zwnet_gw_discvr_start Parameters ................................................................................. 50
Table 79 – zwnet_gw_discvr_cb_t Parameters ................................................................................. 50
Table 80 – zwnet_gw_discvr_stop Parameters ................................................................................. 50
Table 81 – zwnet_ip_aton Parameters ................................................................................................ 51
Table 82 – zwnet_ip_ntoa Parameters ................................................................................................ 51
Table 83 – zwnet_local_addr_get Parameters................................................................................... 51
Table 84 – zwnet_listen_port_get Parameters................................................................................... 52
Table 85 – zwnet_init Parameters ........................................................................................................ 52
Table 86 – zwnet_init_t structure ......................................................................................................... 52
Table 87 – dev_cfg_usr_t structure ..................................................................................................... 54
Table 88 – zwnet_dev_rec_find_fn Parameters ................................................................................ 54
INS14129-5 Z-Ware Library User Guide 2018-05-02
silabs.com | Building a more connected world.
Page xiii of xxii
Table 89 – dev_global_sett_t structure ............................................................................................... 54
Table 90 – zwnet_xxx generic Parameters......................................................................................... 54
Table 91 – zwnet_unhandled_cmd_fn Parameters ........................................................................... 54
Table 92 – sup_cmd_cls_t structure .................................................................................................... 55
Table 93 – zwnet_notify_fn Parameters .............................................................................................. 55
Table 94 – zwnet_sts_t structure ......................................................................................................... 56
Table 95 – zw_health_prg_t structure ................................................................................................. 57
Table 96 – zw_health_rpt_t structure .................................................................................................. 57
Table 97 – zw_health_sts_t structure .................................................................................................. 57
Table 98 – zwnet_node_fn Parameters .............................................................................................. 58
Table 99 – zwnet_appl_fn Parameters ................................................................................................ 58
Table 100 – pl_info_fn Parameters ...................................................................................................... 58
Table 101 – zwnet_net_err_fn Parameters ........................................................................................ 58
Table 102 – print_fn Parameter ............................................................................................................ 58
Table 103 – zwnet_dev_rec_find_fn Parameter ................................................................................ 58
Table 104 – zwnet_exit Parameters .................................................................................................... 59
Table 105 – zwnet_get_desc Parameters .......................................................................................... 59
Table 106 – zwnetd_t structure ............................................................................................................ 59
Table 107 – zwnet_add Parameters .................................................................................................... 60
Table 108 – sec2_add_prm_t structure............................................................................................... 60
Table 109 – add_node_sec2_fn Parameters ..................................................................................... 60
Table 110 – sec2_add_cb_prm_t structure ........................................................................................ 61
Table 111 – sec2_keys_req_cb_prm_t structure............................................................................... 61
Table 112 – sec2_dsk_cb_prm_t structure......................................................................................... 61
Table 113 – zwnet_fail Parameters ..................................................................................................... 61
Table 114 – zwnet_initiate Parameters ............................................................................................... 62
Table 115 – zwnet_initiate_classic Parameters ................................................................................. 63
Table 116 – zwnet_get_node Parameters .......................................................................................... 64
Table 117 – zwnet_get_node_by_id Parameters .............................................................................. 64
Table 118 – zwnet_get_ep_by_id Parameters................................................................................... 64
Table 119 – zwnet_get_if_by_id Parameters ..................................................................................... 64
Table 120 – zwnet_get_user Parameters ........................................................................................... 65
Table 121 – zwnet_send_nif Parameters ........................................................................................... 65
Table 122 – zwnet_all_node_sts_get Parameters ............................................................................ 65
Table 123 – zwnet_node_sts_get Parameters................................................................................... 65
Table 124 – zwnet_poll_rm Parameters ............................................................................................. 66
Table 125 – zwnet_poll_rm_mul Parameters ..................................................................................... 66
Table 126 – zwnet_pref_set Parameters ............................................................................................ 66
Table 127 – zwnet_pref_get Parameters ............................................................................................ 66
Table 128 – zwnet_client_pref_set Parameters................................................................................. 67
Table 129 – zwnet_client_pref_get Parameters ................................................................................ 67
Table 130 – zwnet_add_sec2_accept Parameters ........................................................................... 67
Table 131 – zwnet_add_sec2_grant_key Parameters ..................................................................... 67
Table 132 – zwnet_sec2_get_dsk Parameters .................................................................................. 68
Table 133 – get_dsk_fn Parameters .................................................................................................... 68
INS14129-5 Z-Ware Library User Guide 2018-05-02
silabs.com | Building a more connected world.
Page xiv of xxii
Table 134 – zwnet_pl_add Parameters............................................................................................... 68
Table 135 – pl_info_t structure ............................................................................................................. 68
Table 136 – pl_prod_type_t structure .................................................................................................. 70
Table 137 – pl_prod_id_t structure ...................................................................................................... 70
Table 138 – pl_uuid_t structure ............................................................................................................ 70
Table 139 – pl_nw_sts_t structure ....................................................................................................... 71
Table 140 – zwnet_pl_get Parameters ................................................................................................ 71
Table 141 – pl_info_fn Parameters ...................................................................................................... 71
Table 142 – pl_lst_ent_t structure ........................................................................................................ 71
Table 143 – zwnet_pl_del Parameters ................................................................................................ 72
Table 144 – zwnet_pl_list_get Parameters......................................................................................... 72
Table 145 – pl_list_fn Parameters ....................................................................................................... 72
Table 146 – zwnet_pl_list_del Parameters ......................................................................................... 73
Table 147 – zwnoded_t structure ......................................................................................................... 73
Table 148 – NODE_PROPTY_XXX .................................................................................................... 73
Table 149 – dev_id_t structure ............................................................................................................. 74
Table 150 – zwnode_get_net Parameters .......................................................................................... 74
Table 151 – zwnode_get_next Parameters ........................................................................................ 74
Table 152 – zwnode_get_ep Parameters ........................................................................................... 74
Table 153 – zwnode_update Parameters ........................................................................................... 75
Table 154 – zwnode_cmd_q_ena_set Parameters ........................................................................... 75
Table 155 – zwnode_cmd_q_ena_get Parameters........................................................................... 75
Table 156 – zwnode_cmd_q_ena_cancel Parameters ..................................................................... 75
Table 157 – zwnode_cmd_q_get Parameters ................................................................................... 76
Table 158 – zwnode_mul_cmd_ctl_set Parameters ......................................................................... 76
Table 159 – zwnode_mul_cmd_ctl_get Parameters ......................................................................... 76
Table 160 – zwnode_get_ext_ver Parameters .................................................................................. 76
Table 161 – ext_ver_t structure ............................................................................................................ 76
Table 162 – zwepd_t structure ............................................................................................................. 77
Table 163 – zwplus_info_t structure .................................................................................................... 77
Table 164 – zwep_get_node Parameters ........................................................................................... 77
Table 165 – zwep_get_next Parameters ............................................................................................ 78
Table 166 – zwep_get_if Parameters .................................................................................................. 78
Table 167 – zwep_nameloc_set Parameters ..................................................................................... 78
Table 168 – zw_nameloc_t structure ................................................................................................... 78
Table 169 – zwifd_t structure ................................................................................................................ 79
Table 170 – zwif_get_ep Parameters .................................................................................................. 79
Table 171 – zwif_get_next Parameters ............................................................................................... 80
Table 172 – zwif_exec Parameters ...................................................................................................... 80
Table 173 – zwif_xxx_poll Parameters ................................................................................................ 80
Table 174 – zwpoll_req_t structure ...................................................................................................... 80
Table 175 – zwpoll_cmplt_fn Parameters ........................................................................................... 81
Table 176 – zwif_basic_rpt_set Parameters ..................................................................................... 81
Table 177 – zwrep_basic_fn Parameters ........................................................................................... 81
Table 178 – zwbasic_t structure ........................................................................................................... 81
INS14129-5 Z-Ware Library User Guide 2018-05-02
silabs.com | Building a more connected world.
Page xv of xxii
Table 179 – zwif_basic_get Parameters ............................................................................................. 82
Table 180 – zwif_basic_set Parameters ............................................................................................. 82
Table 181 – zwif_group_sup_get Parameters ................................................................................... 82
Table 182 – zwrep_group_sup_fn Parameters .................................................................................. 83
Table 183 – zwif_group_actv_get Parameters................................................................................... 83
Table 184 – zwrep_group_actv_fn Parameters ................................................................................. 83
Table 185 – zwif_group_get Parameters ............................................................................................ 83
Table 186 – zwrep_group_fn Parameters .......................................................................................... 83
Table 187 – grp_member_t structure .................................................................................................. 84
Table 188 – zwif_group_add Parameters ........................................................................................... 84
Table 189 – zwif_group_del Parameters ............................................................................................ 84
Table 190 – zwif_group_info_get Parameters ................................................................................... 84
Table 191 – if_grp_info_dat_t structure .............................................................................................. 85
Table 192 – zw_grp_info_t structure ................................................................................................... 85
Table 193 – grp_cmd_ent_t structure .................................................................................................. 85
Table 194 – zwif_group_info_free Parameters .................................................................................. 85
Table 195 – zwif_switch_rpt_set Parameters..................................................................................... 86
Table 196 – zwrep_switch_fn Parameters .......................................................................................... 86
Table 197 – zwswitch_t structure ......................................................................................................... 86
Table 198 – zwif_switch_get Parameters ........................................................................................... 86
Table 199 – ZWIF_GET_BMSK_XXX ................................................................................................. 86
Table 200 – zwif_switch_set Parameters ........................................................................................... 87
Table 201 – zw_postset_fn Parameters .............................................................................................. 87
Table 202 – zwif_level_rpt_set Parameters ....................................................................................... 87
Table 203 – zwrep_level_fn Parameters ............................................................................................ 88
Table 204 – zwlevel_dat_t structure .................................................................................................... 88
Table 205 – zwif_level_sup_get Parameters ..................................................................................... 88
Table 206 – zwrep_lvl_sup_fn Parameters ........................................................................................ 88
Table 207 – zwif_level_sup_cache_get Parameters ......................................................................... 89
Table 208 – zwif_level_get Parameters .............................................................................................. 89
Table 209 – zwif_level_set Parameters .............................................................................................. 89
Table 210 – zwif_level_start Parameters ............................................................................................ 90
Table 211 – zwlevel_t structure ............................................................................................................ 90
Table 212 – zwif_level_stop Parameters ............................................................................................ 90
Table 213 – zwif_bsensor_rpt_set Parameters ................................................................................. 91
Table 214 – zwrep_bsensor_fn Parameters....................................................................................... 91
Table 215 – zwif_bsensor_get Parameters ........................................................................................ 91
Table 216 – zwif_bsensor_sup_get Parameters ............................................................................... 91
Table 217 – zwrep_bsensor_sup_fn Parameters .............................................................................. 92
Table 218 – zwif_bsensor_sup_cache_get Parameters ................................................................... 92
Table 219 – zwif_sensor_rpt_set Parameters .................................................................................... 92
Table 220 – zwrep_sensor_fn Parameters ......................................................................................... 92
Table 221 – zwsensor_t structure ........................................................................................................ 93
Table 222 – ZW_SENSOR_TYPE_XXX, ZW_SENSOR_UNIT_XXX_YYY ................................. 93
Table 223 – zwif_sensor_get Parameters .......................................................................................... 95
INS14129-5 Z-Ware Library User Guide 2018-05-02
silabs.com | Building a more connected world.
Page xvi of xxii
Table 224 – zwif_sensor_sup_get Parameters .................................................................................. 96
Table 225 – zwrep_sensor_sup_fn Parameters ................................................................................ 96
Table 226 – zwif_sensor_unit_get Parameters .................................................................................. 96
Table 227 – zwrep_sensor_unit_fn Parameters ................................................................................ 96
Table 228 – zwif_sensor_unit_cache_get Parameters ..................................................................... 97
Table 229 – zwif_sensor_sup_cache_get Parameters ..................................................................... 97
Table 230 – if_sensor_data_t structure ............................................................................................... 97
Table 231 – zwif_group_cmd_sup_get Parameters .......................................................................... 98
Table 232 – zwrep_grp_cmd_sup_fn Parameters............................................................................. 98
Table 233 – zwgrp_cmd_cap_t structure ............................................................................................ 98
Table 234 – zwif_group_cmd_get Parameters .................................................................................. 98
Table 235 – zwrep_grp_cmd_fn Parameters ..................................................................................... 98
Table 236 – zwif_group_cmd_set Parameters................................................................................... 99
Table 237 – zwif_wakeup_get Parameters ........................................................................................ 99
Table 238 – zwrep_wakeup_fn Parameters ....................................................................................... 99
Table 239 – zwif_wakeup_t structure .................................................................................................. 99
Table 240 – zwif_wakeup_set Parameters ....................................................................................... 100
Table 241 – zwif_config_rpt_set Parameters .................................................................................. 100
Table 242 – zwrep_config_fn Parameters ........................................................................................ 100
Table 243 – zwconfig_t structure ....................................................................................................... 100
Table 244 – zwif_config_get Parameters .......................................................................................... 101
Table 245 – zwif_config_set Parameters .......................................................................................... 101
Table 246 – zwif_config_bulk_rpt_set Parameters ........................................................................ 101
Table 247 – zwrep_cfg_bulk_fn Parameters .................................................................................... 101
Table 248 – zwcfg_bulk_t structure ................................................................................................... 101
Table 249 – zwif_config_bulk_get Parameters ................................................................................ 102
Table 250 – zwif_config_bulk_set Parameters ................................................................................ 102
Table 251 – zwif_config_prm_reset Parameters ............................................................................. 102
Table 252 – zwif_config_info_get Parameters ................................................................................. 103
Table 253 – zwcfg_info_cap_t structure ........................................................................................... 103
Table 254 – zwcfg_info_t structure .................................................................................................... 103
Table 255 – gen_dat_u union ............................................................................................................. 104
Table 256 – zwif_config_info_free Parameters ................................................................................ 104
Table 257 – zwif_pulsemeter_rpt_set Parameters ......................................................................... 104
Table 258 – zwrep_pulsemeter_fn Parameters .............................................................................. 105
Table 259 – zwif_pulsemeter_get Parameters................................................................................. 105
Table 260 – zwif_battery_rpt_set Parameters ................................................................................ 105
Table 261 – zwrep_ts_fn Parameters ................................................................................................ 105
Table 262 – zwif_battery_get Parameters ........................................................................................ 105
Table 263 – zwif_av_set Parameters ................................................................................................ 106
Table 264 – zwif_av_caps Parameters ............................................................................................. 106
Table 265 – zwrep_av_fn Parameters............................................................................................... 106
Table 266 – zwif_meter_rpt_set Parameters .................................................................................. 107
Table 267 – zwrep_meter_fn Parameters......................................................................................... 107
Table 268 – zwmeter_dat_t structure ................................................................................................ 107
INS14129-5 Z-Ware Library User Guide 2018-05-02
silabs.com | Building a more connected world.
Page xvii of xxii
Table 269 – ZW_METER_TYPE_XXX and ZW_METER_UNIT_XXX ......................................... 107
Table 270 – zwif_meter_get Parameters .......................................................................................... 108
Table 271 – zwif_meter_sup_get Parameters ................................................................................. 108
Table 272 – zwrep_meter_sup_fn Parameters ................................................................................ 108
Table 273 – zwmeter_cap_t structure ............................................................................................... 109
Table 274 – ZW_METER_SUP_UNIT_XXX .................................................................................... 109
Table 275 – zwif_meter_sup_cache_get Parameters ..................................................................... 109
Table 276 – zwif_meter_reset Parameters ....................................................................................... 110
Table 277 – zwif_meter_set_admin Parameters ............................................................................. 110
Table 278 – zwif_meter_get_desc Parameters ............................................................................... 110
Table 279 – zwrep_meterd_fn Parameters ...................................................................................... 110
Table 280 – zwmeter_t structure ........................................................................................................ 110
Table 281 – zwif_dlck_op_rpt_set Parameters ............................................................................... 111
Table 282 – zwrep_dlck_op_fn Parameters ..................................................................................... 111
Table 283 – zwdlck_op_t structure ................................................................................................... 111
Table 284 – ZW_DOOR_XXX ............................................................................................................ 111
Table 285 – ZW_COND_XXX_MASK ............................................................................................... 112
Table 286 – zwif_dlck_op_get Parameters ...................................................................................... 112
Table 287 – zwif_dlck_op_set Parameters ....................................................................................... 112
Table 288 – zwif_dlck_cfg_set Parameters ..................................................................................... 112
Table 289 – zwdlck_cfg_t structure .................................................................................................. 113
Table 290 – zwif_dlck_cfg_get Parameters ...................................................................................... 113
Table 291 – zwrep_dlck_cfg_fn Parameters ................................................................................... 113
Table 292 – zwif_usrcod_get Parameters ........................................................................................ 114
Table 293 – zwrep_usr_cod_fn Parameters .................................................................................... 114
Table 294 – zwusrcod_t structure ...................................................................................................... 114
Table 295 – zwif_usrcod_set Parameters ........................................................................................ 114
Table 296 – zwif_usrcod_sup_get Parameters ................................................................................ 114
Table 297 – zwrep_usr_sup_fn Parameters .................................................................................... 115
Table 298 – zwif_usrcod_sup_cache_get Parameters ................................................................... 115
Table 299 – zwif_alrm_rpt_set Parameters ..................................................................................... 115
Table 300 – zwrep_alrm_fn Parameters ........................................................................................... 115
Table 301 – zwalrm_t structure ......................................................................................................... 115
Table 302 – ZW_ALRM_STS_XXX ................................................................................................... 116
Table 303 – ZW_ALRM_XXX ............................................................................................................. 117
Table 304 – ZW_ALRM_EVT_XXX ................................................................................................... 117
Table 305 – zwif_alrm_get Parameters ............................................................................................ 124
Table 306 – zwif_alrm_set Parameters ............................................................................................. 124
Table 307 – zwif_alrm_sup_get Parameters ................................................................................... 124
Table 308 – zwrep_alrm_sup_fn Parameters ................................................................................. 125
Table 309 – zwif_alrm_sup_cache_get Parameters ....................................................................... 125
Table 310 – zwif_alrm_sup_evt_get Parameters ........................................................................... 125
Table 311 – zwrep_alrm_evt_fn Parameters .................................................................................. 126
Table 312 – zwif_alrm_sup_evt_cache_get Parameters ............................................................... 126
Table 313 – zwif_alrm_vtype_sup_get Parameters ....................................................................... 126
INS14129-5 Z-Ware Library User Guide 2018-05-02
silabs.com | Building a more connected world.
Page xviii of xxii
Table 314 – zwif_thrmo_fan_md_rpt_set Parameters .................................................................... 126
Table 315 – zwrep_thrmo_fan_md_fn Parameters ......................................................................... 127
Table 316 – ZW_THRMO_FAN_MD_XXX ....................................................................................... 127
Table 317 – zwif_thrmo_fan_md_get Parameters ........................................................................... 127
Table 318 – zwif_thrmo_fan_md_set Parameters ........................................................................... 128
Table 319 – zwif_thrmo_fan_md_sup_get Parameters .................................................................. 128
Table 320 – zwrep_thrmo_fan_md_sup_fn Parameters ................................................................ 128
Table 321 – zwif_thrmo_fan_md_sup_cache_get Parameters ..................................................... 129
Table 322 – zwif_thrmo_fan_sta_rpt_set Parameters .................................................................... 129
Table 323 – zwrep_thrmo_fan_sta_fn Parameters ......................................................................... 129
Table 324 – ZW_THRMO_FAN_STA_XXX ..................................................................................... 129
Table 325 – zwif_thrmo_fan_sta_get Parameters ........................................................................... 130
Table 326 – zwif_thrmo_md_rpt_set Parameters ............................................................................ 130
Table 327 – zwrep_thrmo_md_fn Parameters ................................................................................. 130
Table 328 – ZW_THRMO_MD_XXX ................................................................................................. 130
Table 329 – zwif_thrmo_md_get Parameters .................................................................................. 131
Table 330 – zwif_thrmo_md_set Parameters................................................................................... 131
Table 331 – zwif_thrmo_md_sup_get Parameters .......................................................................... 132
Table 332 – zwrep_thrmo_md_sup_fn Parameters ........................................................................ 132
Table 333 – zwif_thrmo_md_sup_cache_get Parameters ............................................................. 132
Table 334 – zwif_thrmo_op_sta_rpt_set Parameters ..................................................................... 132
Table 335 – zwrep_thrmo_op_sta_fn Parameters .......................................................................... 133
Table 336 – ZW_THRMO_OP_STA_XXX ........................................................................................ 133
Table 337 – zwif_thrmo_op_sta_get Parameters ............................................................................ 133
Table 338 – zwif_thrmo_op_sta_log_sup_get Parameters ............................................................ 133
Table 339 – zwrep_thrmo_op_sta_log_sup_fn Parameters .......................................................... 134
Table 340 – zwif_thrmo_op_sta_log_sup_cache_get Parameters ............................................... 134
Table 341 – zwif_thrmo_op_sta_log_rpt_set Parameters .............................................................. 134
Table 342 – zwrep_thrmo_op_sta_log_fn Parameters ................................................................... 134
Table 343 – zwthrmo_op_sta_log_t structure ................................................................................. 135
Table 344 – zwif_thrmo_op_sta_log_get Parameters .................................................................... 135
Table 345 – zwif_thrmo_setb_rpt_set Parameters .......................................................................... 135
Table 346 – zwrep_thrmo_setb_fn Parameters ............................................................................... 135
Table 347 – ZW_THRMO_SETB_TYP_XXX ................................................................................... 136
Table 348 – ZW_THRMO_SETB_STA_XXX ................................................................................... 136
Table 349 – zwif_thrmo_setb_get Parameters ................................................................................ 136
Table 350 – zwif_thrmo_setb_set Parameters................................................................................. 136
Table 351 – zwif_thrmo_setp_rpt_set Parameters .......................................................................... 137
Table 352 – zwrep_thrmo_setp_fn Parameters ............................................................................... 137
Table 353 – zwsetp_t structure ......................................................................................................... 137
Table 354 – ZW_THRMO_SETP_TYP_XXX ................................................................................... 137
Table 355 – ZW_THRMO_SETP_UNIT_XXX ................................................................................. 138
Table 356 – zwif_thrmo_setp_get Parameters ................................................................................ 138
Table 357 – zwif_thrmo_setp_set Parameters................................................................................. 138
Table 358 – zwif_thrmo_setp_sup_get Parameters ........................................................................ 138
INS14129-5 Z-Ware Library User Guide 2018-05-02
silabs.com | Building a more connected world.
Page xix of xxii
Table 359 – zwrep_thrmo_setp_sup_fn Parameters ...................................................................... 138
Table 360 – zwif_thrmo_setp_sup_cache_get Parameters ........................................................... 139
Table 361 – zwif_thrmo_setp_sup_range_get Parameters ........................................................... 139
Table 362 – zwrep_thrmo_setp_range_fn Parameters .................................................................. 139
Table 363 – zwif_thrmo_setp_sup_range_cache_get Parameters .............................................. 139
Table 364 – zwif_clock_rpt_set Parameters..................................................................................... 140
Table 365 – zwrep_clock_fn Parameters .......................................................................................... 140
Table 366 – ZW_CLOCK_XXX .......................................................................................................... 140
Table 367 – zwif_clock_get Parameters ........................................................................................... 140
Table 368 – zwif_clock_set Parameters ........................................................................................... 141
Table 369 – zwif_clmt_ctl_schd_rpt_set Parameters ..................................................................... 141
Table 370 – zwrep_clmt_ctl_schd_fn Parameters ........................................................................... 141
Table 371 – zwcc_shed_t structure .................................................................................................. 141
Table 372 – zwcc_shed_swpt_t structure ......................................................................................... 142
Table 373 – zwif_clmt_ctl_schd_get Parameters ............................................................................ 142
Table 374 – zwif_clmt_ctl_schd_set Parameters ............................................................................ 142
Table 375 – zwif_clmt_ctl_schd_chg_rpt_set Parameters ............................................................. 142
Table 376 – zwrep_clmt_ctl_schd_chg_fn Parameters .................................................................. 142
Table 377 – zwif_clmt_ctl_schd_chg_get Parameters ................................................................... 143
Table 378 – zwif_clmt_ctl_schd_ovr_rpt_set Parameters .............................................................. 143
Table 379 – zwrep_clmt_ctl_schd_ovr_fn Parameters ................................................................... 143
Table 380 – zwcc_shed_t structure .................................................................................................. 143
Table 381 – zwif_clmt_ctl_schd_ovr_get Parameters .................................................................... 143
Table 382 – zwif_clmt_ctl_schd_ovr_set Parameters ..................................................................... 144
Table 383 – zwif_prot_rpt_set Parameters ....................................................................................... 144
Table 384 – zwrep_prot_fn Parameters ............................................................................................ 144
Table 385 – ZW_LPROT_XXX ........................................................................................................... 144
Table 386 – ZW_RFPROT_XXX ........................................................................................................ 145
Table 387 – zwif_prot_get Parameters ............................................................................................. 145
Table 388 – zwif_prot_set Parameters .............................................................................................. 145
Table 389 – zwif_prot_sup_get Parameters ..................................................................................... 145
Table 390 – zwrep_prot_sup_fn Parameters ................................................................................... 146
Table 391 – zwprot_sup_t structure .................................................................................................. 146
Table 392 – zwif_prot_sup_cache_get Parameters ........................................................................ 146
Table 393 – zwif_prot_ec_rpt_set Parameters ................................................................................ 146
Table 394 – zwrep_prot_ec_fn Parameters ..................................................................................... 146
Table 395 – zwif_prot_ec_get Parameters ....................................................................................... 147
Table 396 – zwif_prot_ec_set Parameters ....................................................................................... 147
Table 397 – zwif_prot_tmout_rpt_set Parameters ........................................................................... 147
Table 398 – zwrep_prot_tmout_fn Parameters ................................................................................ 147
Table 399 – zwif_prot_tmout_get Parameters ................................................................................. 148
Table 400 – zwif_prot_tmout_set Parameters ................................................................................. 148
Table 401 – zwif_appl_busy_rpt_set Parameters ........................................................................... 148
Table 402 – zwrep_appl_busy_fn Parameters................................................................................. 148
Table 403 – ZW_BSY_STS_XXX ...................................................................................................... 149
INS14129-5 Z-Ware Library User Guide 2018-05-02
silabs.com | Building a more connected world.
Page xx of xxii
Table 404 – zwif_appl_reject_rpt_set Parameters .......................................................................... 149
Table 405 – zwrep_appl_reject_fn Parameters ............................................................................... 149
Table 406 – ZW_RJ_STS_XXX ......................................................................................................... 149
Table 407 – zwif_ind_rpt_set Parameters ........................................................................................ 149
Table 408 – zwrep_fn Parameters ..................................................................................................... 150
Table 409 – zwif_ind_get Parameters ............................................................................................... 150
Table 410 – zwif_ind_set Parameters ............................................................................................... 150
Table 411 – zwif_fw_info_get Parameters ........................................................................................ 150
Table 412 – zwrep_fw_info_fn Parameters ...................................................................................... 151
Table 413 – zwfw_info_t structure ..................................................................................................... 151
Table 414 – zwif_fw_updt_req Parameters ...................................................................................... 151
Table 415 – zwfw_updt_req_t structure ............................................................................................ 151
Table 416 – zwrep_fw_updt_sts_fn Parameters ............................................................................. 152
Table 417 – ZW_FW_UPDT_ERR_XXX .......................................................................................... 152
Table 418 – zwrep_fw_updt_cmplt_fn Parameters ......................................................................... 152
Table 419 – ZW_FW_UPDT_CMPLT_XXX ..................................................................................... 152
Table 420 – zwrep_fw_tgt_restart_fn Parameters ........................................................................... 153
Table 421 – ZW_FW_UPDT_ RESTART_XXX ............................................................................... 153
Table 422 – zwif_gw_mode_set Parameters ................................................................................... 153
Table 423 – zwgw_portal_prof_t structure ........................................................................................ 154
Table 424 – zwif_gw_mode_get Parameters ................................................................................... 154
Table 425 – zwrep_gw_mode_fn Parameters ................................................................................. 154
Table 426 – zwif_gw_mode_get Parameters ................................................................................... 155
Table 427 – zwif_gw_unsolicit_set Parameters ............................................................................... 155
Table 428 – zwif_gw_unsolicit_get Parameters............................................................................... 155
Table 429 – zwrep_gw_unsolicit_fn Parameters ............................................................................. 155
Table 430 – zwif_gw_cfg_set Parameters ........................................................................................ 156
Table 431 – zwportal_cfg_t structure ................................................................................................ 156
Table 432 – zwrep_cfg_sts_fn Parameters ...................................................................................... 156
Table 433 – zwif_gw_mode_get Parameters ................................................................................... 157
Table 434 – zwrep_gw_cfg_fn Parameters ...................................................................................... 157
Table 435 – zwif_power_level_rpt_set Parameters ....................................................................... 157
Table 436 – zwrep_power_level_fn Parameters ............................................................................. 157
Table 437 – zwif_power_level_get Parameters ............................................................................... 157
Table 438 – zwif_power_level_set Parameters ............................................................................... 158
Table 439 – zwif_power_level_test_rpt_set Parameters ............................................................... 158
Table 440 – zwrep_power_level_test_fn Parameters ..................................................................... 158
Table 441 – POWERLEVEL_TEST_XXX ......................................................................................... 158
Table 442 – zwif_power_level_test_get Parameters ...................................................................... 159
Table 443 – zwif_power_level_test_set Parameters ....................................................................... 159
Table 444 – zwif_csc_rpt_set Parameters ........................................................................................ 159
Table 445 – zwrep_csc_fn Parameters ............................................................................................. 159
Table 446 – zwcsc_notif_t structure ................................................................................................. 159
Table 447 – ZW_CSC_KEY_ATTRIB_XXX ..................................................................................... 160
Table 448– zwif_csc_sup_get Parameters ....................................................................................... 160
  • Page 1 1
  • Page 2 2
  • Page 3 3
  • Page 4 4
  • Page 5 5
  • Page 6 6
  • Page 7 7
  • Page 8 8
  • Page 9 9
  • Page 10 10
  • Page 11 11
  • Page 12 12
  • Page 13 13
  • Page 14 14
  • Page 15 15
  • Page 16 16
  • Page 17 17
  • Page 18 18
  • Page 19 19
  • Page 20 20
  • Page 21 21
  • Page 22 22
  • Page 23 23
  • Page 24 24
  • Page 25 25
  • Page 26 26
  • Page 27 27
  • Page 28 28
  • Page 29 29
  • Page 30 30
  • Page 31 31
  • Page 32 32
  • Page 33 33
  • Page 34 34
  • Page 35 35
  • Page 36 36
  • Page 37 37
  • Page 38 38
  • Page 39 39
  • Page 40 40
  • Page 41 41
  • Page 42 42
  • Page 43 43
  • Page 44 44
  • Page 45 45
  • Page 46 46
  • Page 47 47
  • Page 48 48
  • Page 49 49
  • Page 50 50
  • Page 51 51
  • Page 52 52
  • Page 53 53
  • Page 54 54
  • Page 55 55
  • Page 56 56
  • Page 57 57
  • Page 58 58
  • Page 59 59
  • Page 60 60
  • Page 61 61
  • Page 62 62
  • Page 63 63
  • Page 64 64
  • Page 65 65
  • Page 66 66
  • Page 67 67
  • Page 68 68
  • Page 69 69
  • Page 70 70
  • Page 71 71
  • Page 72 72
  • Page 73 73
  • Page 74 74
  • Page 75 75
  • Page 76 76
  • Page 77 77
  • Page 78 78
  • Page 79 79
  • Page 80 80
  • Page 81 81
  • Page 82 82
  • Page 83 83
  • Page 84 84
  • Page 85 85
  • Page 86 86
  • Page 87 87
  • Page 88 88
  • Page 89 89
  • Page 90 90
  • Page 91 91
  • Page 92 92
  • Page 93 93
  • Page 94 94
  • Page 95 95
  • Page 96 96
  • Page 97 97
  • Page 98 98
  • Page 99 99
  • Page 100 100
  • Page 101 101
  • Page 102 102
  • Page 103 103
  • Page 104 104
  • Page 105 105
  • Page 106 106
  • Page 107 107
  • Page 108 108
  • Page 109 109
  • Page 110 110
  • Page 111 111
  • Page 112 112
  • Page 113 113
  • Page 114 114
  • Page 115 115
  • Page 116 116
  • Page 117 117
  • Page 118 118
  • Page 119 119
  • Page 120 120
  • Page 121 121
  • Page 122 122
  • Page 123 123
  • Page 124 124
  • Page 125 125
  • Page 126 126
  • Page 127 127
  • Page 128 128
  • Page 129 129
  • Page 130 130
  • Page 131 131
  • Page 132 132
  • Page 133 133
  • Page 134 134
  • Page 135 135
  • Page 136 136
  • Page 137 137
  • Page 138 138
  • Page 139 139
  • Page 140 140
  • Page 141 141
  • Page 142 142
  • Page 143 143
  • Page 144 144
  • Page 145 145
  • Page 146 146
  • Page 147 147
  • Page 148 148
  • Page 149 149
  • Page 150 150
  • Page 151 151
  • Page 152 152
  • Page 153 153
  • Page 154 154
  • Page 155 155
  • Page 156 156
  • Page 157 157
  • Page 158 158
  • Page 159 159
  • Page 160 160
  • Page 161 161
  • Page 162 162
  • Page 163 163
  • Page 164 164
  • Page 165 165
  • Page 166 166
  • Page 167 167
  • Page 168 168
  • Page 169 169
  • Page 170 170
  • Page 171 171
  • Page 172 172
  • Page 173 173
  • Page 174 174
  • Page 175 175
  • Page 176 176
  • Page 177 177
  • Page 178 178
  • Page 179 179
  • Page 180 180
  • Page 181 181
  • Page 182 182
  • Page 183 183
  • Page 184 184
  • Page 185 185
  • Page 186 186
  • Page 187 187
  • Page 188 188
  • Page 189 189
  • Page 190 190
  • Page 191 191
  • Page 192 192
  • Page 193 193
  • Page 194 194
  • Page 195 195
  • Page 196 196
  • Page 197 197
  • Page 198 198
  • Page 199 199
  • Page 200 200
  • Page 201 201
  • Page 202 202
  • Page 203 203
  • Page 204 204
  • Page 205 205
  • Page 206 206
  • Page 207 207

Silicon Labs Z-Ware Library User guide

Type
User guide

Ask a question and I''ll find the answer in the document

Finding information in a document is now easier with AI