blob: 54f960fe87be652e5646ce49064f81ef0552754e (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
|
/* packet-zbee-nwk.h
* Dissector routines for the ZigBee Network Layer (NWK)
* By Owen Kirby <osk@exegin.com>
* Copyright 2009 Exegin Technologies Limited
*
* Wireshark - Network traffic analyzer
* By Gerald Combs <gerald@wireshark.org>
* Copyright 1998 Gerald Combs
*
* SPDX-License-Identifier: GPL-2.0-or-later
*/
#ifndef PACKET_ZBEE_NWK_H
#define PACKET_ZBEE_NWK_H
/* ZigBee NWK FCF fields */
#define ZBEE_NWK_FCF_FRAME_TYPE 0x0003
#define ZBEE_NWK_FCF_VERSION 0x003C
#define ZBEE_NWK_FCF_DISCOVER_ROUTE 0x00C0
#define ZBEE_NWK_FCF_MULTICAST 0x0100 /* ZigBee 2006 and Later */
#define ZBEE_NWK_FCF_SECURITY 0x0200
#define ZBEE_NWK_FCF_SOURCE_ROUTE 0x0400 /* ZigBee 2006 and Later */
#define ZBEE_NWK_FCF_EXT_DEST 0x0800 /* ZigBee 2006 and Later */
#define ZBEE_NWK_FCF_EXT_SOURCE 0x1000 /* ZigBee 2006 and Later */
#define ZBEE_NWK_FCF_END_DEVICE_INITIATOR 0x2000 /* ZigBee PRO r21 */
/* ZigBee NWK FCF Frame Types */
#define ZBEE_NWK_FCF_DATA 0x0000
#define ZBEE_NWK_FCF_CMD 0x0001
#define ZBEE_NWK_FCF_INTERPAN 0x0003
/* ZigBee NWK Discovery Modes. */
#define ZBEE_NWK_FCF_DISCOVERY_SUPPRESS 0x0000
#define ZBEE_NWK_FCF_DISCOVERY_ENABLE 0x0001
#define ZBEE_NWK_FCF_DISCOVERY_FORCE 0x0003
/* Multicast Control */
#define ZBEE_NWK_MCAST_MODE 0x03 /* ZigBee 2006 and later */
#define ZBEE_NWK_MCAST_RADIUS 0x1c /* ZigBee 2006 and later */
#define ZBEE_NWK_MCAST_MAX_RADIUS 0xe0 /* ZigBee 2006 and later */
#define ZBEE_NWK_MCAST_MODE_NONMEMBER 0x00 /* ZigBee 2006 and later */
#define ZBEE_NWK_MCAST_MODE_MEMBER 0x01 /* ZigBee 2006 and later */
/* ZigBee NWK Command Types */
#define ZBEE_NWK_CMD_ROUTE_REQ 0x01
#define ZBEE_NWK_CMD_ROUTE_REPLY 0x02
#define ZBEE_NWK_CMD_NWK_STATUS 0x03
#define ZBEE_NWK_CMD_LEAVE 0x04 /* ZigBee 2006 and Later */
#define ZBEE_NWK_CMD_ROUTE_RECORD 0x05 /* ZigBee 2006 and later */
#define ZBEE_NWK_CMD_REJOIN_REQ 0x06 /* ZigBee 2006 and later */
#define ZBEE_NWK_CMD_REJOIN_RESP 0x07 /* ZigBee 2006 and later */
#define ZBEE_NWK_CMD_LINK_STATUS 0x08 /* ZigBee 2007 and later */
#define ZBEE_NWK_CMD_NWK_REPORT 0x09 /* ZigBee 2007 and later */
#define ZBEE_NWK_CMD_NWK_UPDATE 0x0a /* ZigBee 2007 and later */
#define ZBEE_NWK_CMD_ED_TIMEOUT_REQUEST 0x0b /* r21 */
#define ZBEE_NWK_CMD_ED_TIMEOUT_RESPONSE 0x0c /* r21 */
#define ZBEE_NWK_CMD_LINK_PWR_DELTA 0x0d /* r22 */
#define ZBEE_NWK_CMD_COMMISSIONING_REQUEST 0x0e /* r23 */
#define ZBEE_NWK_CMD_COMMISSIONING_RESPONSE 0x0f /* r23 */
/* ZigBee NWK Route Options Flags */
#define ZBEE_NWK_CMD_ROUTE_OPTION_REPAIR 0x80 /* ZigBee 2004 only. */
#define ZBEE_NWK_CMD_ROUTE_OPTION_MCAST 0x40 /* ZigBee 2006 and later */
#define ZBEE_NWK_CMD_ROUTE_OPTION_DEST_EXT 0x20 /* ZigBee 2007 and later (route request only). */
#define ZBEE_NWK_CMD_ROUTE_OPTION_MANY_MASK 0x18 /* ZigBee 2007 and later (route request only). */
#define ZBEE_NWK_CMD_ROUTE_OPTION_RESP_EXT 0x20 /* ZigBee 2007 and layer (route reply only). */
#define ZBEE_NWK_CMD_ROUTE_OPTION_ORIG_EXT 0x10 /* ZigBee 2007 and later (route reply only). */
/* Many-to-One modes, ZigBee 2007 and later (route request only). */
#define ZBEE_NWK_CMD_ROUTE_OPTION_MANY_NONE 0x00
#define ZBEE_NWK_CMD_ROUTE_OPTION_MANY_REC 0x01
#define ZBEE_NWK_CMD_ROUTE_OPTION_MANY_NOREC 0x02
/* ZigBee NWK Leave Options Flags */
#define ZBEE_NWK_CMD_LEAVE_OPTION_CHILDREN 0x80
#define ZBEE_NWK_CMD_LEAVE_OPTION_REQUEST 0x40
#define ZBEE_NWK_CMD_LEAVE_OPTION_REJOIN 0x20
/* ZigBee NWK Link Status Options. */
#define ZBEE_NWK_CMD_LINK_OPTION_LAST_FRAME 0x40
#define ZBEE_NWK_CMD_LINK_OPTION_FIRST_FRAME 0x20
#define ZBEE_NWK_CMD_LINK_OPTION_COUNT_MASK 0x1f
/* ZigBee NWK Link Status cost fields. */
#define ZBEE_NWK_CMD_LINK_INCOMMING_COST_MASK 0x07
#define ZBEE_NWK_CMD_LINK_OUTGOING_COST_MASK 0x70
/* ZigBee NWK Report Options. */
#define ZBEE_NWK_CMD_NWK_REPORT_COUNT_MASK 0x1f
#define ZBEE_NWK_CMD_NWK_REPORT_ID_MASK 0xe0
#define ZBEE_NWK_CMD_NWK_REPORT_ID_PAN_CONFLICT 0x00
#define ZBEE_NWK_CMD_NWK_REPORT_ID_ZBOSS_KEY_TRACE 6
/* ZigBee NWK Update Options. */
#define ZBEE_NWK_CMD_NWK_UPDATE_COUNT_MASK 0x1f
#define ZBEE_NWK_CMD_NWK_UPDATE_ID_MASK 0xe0
#define ZBEE_NWK_CMD_NWK_UPDATE_ID_PAN_UPDATE 0x00
/* ZigBee NWK Values of the Parent Information Bitmask (Table 3.47) */
#define ZBEE_NWK_CMD_ED_TIMEO_RSP_PRNT_INFO_MAC_DATA_POLL_KEEPAL_SUPP 0x01
#define ZBEE_NWK_CMD_ED_TIMEO_RSP_PRNT_INFO_ED_TIMOU_REQ_KEEPAL_SUPP 0x02
#define ZBEE_NWK_CMD_ED_TIMEO_RSP_PRNT_INFO_PWR_NEG_SUPP 0x04
/* ZigBee NWK Link Power Delta Options */
#define ZBEE_NWK_CMD_NWK_LINK_PWR_DELTA_TYPE_MASK 0x03
/* Network Status Code Definitions. */
#define ZBEE_NWK_STATUS_NO_ROUTE_AVAIL 0x00
#define ZBEE_NWK_STATUS_TREE_LINK_FAIL 0x01
#define ZBEE_NWK_STATUS_NON_TREE_LINK_FAIL 0x02
#define ZBEE_NWK_STATUS_LOW_BATTERY 0x03
#define ZBEE_NWK_STATUS_NO_ROUTING 0x04
#define ZBEE_NWK_STATUS_NO_INDIRECT 0x05
#define ZBEE_NWK_STATUS_INDIRECT_EXPIRE 0x06
#define ZBEE_NWK_STATUS_DEVICE_UNAVAIL 0x07
#define ZBEE_NWK_STATUS_ADDR_UNAVAIL 0x08
#define ZBEE_NWK_STATUS_PARENT_LINK_FAIL 0x09
#define ZBEE_NWK_STATUS_VALIDATE_ROUTE 0x0a
#define ZBEE_NWK_STATUS_SOURCE_ROUTE_FAIL 0x0b
#define ZBEE_NWK_STATUS_MANY_TO_ONE_FAIL 0x0c
#define ZBEE_NWK_STATUS_ADDRESS_CONFLICT 0x0d
#define ZBEE_NWK_STATUS_VERIFY_ADDRESS 0x0e
#define ZBEE_NWK_STATUS_PANID_UPDATE 0x0f
#define ZBEE_NWK_STATUS_ADDRESS_UPDATE 0x10
#define ZBEE_NWK_STATUS_BAD_FRAME_COUNTER 0x11
#define ZBEE_NWK_STATUS_BAD_KEY_SEQNO 0x12
#define ZBEE_NWK_STATUS_UNKNOWN_COMMAND 0x13
#define ZBEE_SEC_CONST_KEYSIZE 16
typedef struct{
bool security;
bool discovery;
bool multicast; /* ZigBee 2006 and Later */
bool route; /* ZigBee 2006 and Later */
bool ext_dst; /* ZigBee 2006 and Later */
bool ext_src; /* ZigBee 2006 and Later */
uint16_t type;
uint8_t version;
uint16_t dst;
uint16_t src;
uint64_t dst64; /* ZigBee 2006 and Later */
uint64_t src64; /* ZigBee 2006 and Later */
uint8_t radius;
uint8_t seqno;
uint8_t mcast_mode; /* ZigBee 2006 and Later */
uint8_t mcast_radius; /* ZigBee 2006 and Later */
uint8_t mcast_max_radius; /* ZigBee 2006 and Later */
uint8_t payload_offset;
uint8_t payload_len;
uint16_t cluster_id; /* an application-specific message identifier that
* happens to be included in the transport (APS) layer header.
*/
void *private_data; /* For ZigBee (sub)dissector specific data */
} zbee_nwk_packet;
/* Key used for link key hash table. */
typedef struct {
uint64_t lt_addr64; /* lesser than address */
uint64_t gt_addr64; /* greater than address */
} table_link_key_t;
typedef enum
{
ZBEE_APS_NO_RELAY,
ZBEE_APS_RELAY_UPSTREAM,
ZBEE_APS_RELAY_DOWNSTREAM
} aps_relay_type_t;
/* Values in the key rings. */
typedef struct {
unsigned frame_num;
char *label;
uint8_t key[ZBEE_SEC_CONST_KEYSIZE];
} key_record_t;
typedef struct {
int src_pan; /* source pan */
int src; /* short source address from nwk */
#if 0
int ieee_src; /* short source address from mac */
#endif
ieee802154_map_rec *map_rec; /* extended src from nwk */
key_record_t *nwk; /* Network key found for this packet */
key_record_t *link; /* Link key found for this packet */
aps_relay_type_t relay_type ; /* Is it upstream/downstream relayed packet? */
uint64_t joiner_addr64; /* long address from Relay frame */
} zbee_nwk_hints_t;
extern ieee802154_map_tab_t zbee_nwk_map;
extern GHashTable *zbee_table_nwk_keyring;
extern GHashTable *zbee_table_link_keyring;
/* Key Types */
#define ZBEE_USER_KEY 0x01
/* ZigBee PRO beacons */
#define ZBEE_NWK_BEACON_PROTOCOL_ID 0x00
#define ZBEE_NWK_BEACON_STACK_PROFILE 0x000f
#define ZBEE_NWK_BEACON_PROTOCOL_VERSION 0x00f0
#define ZBEE_NWK_BEACON_ROUTER_CAPACITY 0x0400
#define ZBEE_NWK_BEACON_NETWORK_DEPTH 0x7800
#define ZBEE_NWK_BEACON_END_DEVICE_CAPACITY 0x8000
#define ZBEE_NWK_BEACON_LENGTH 15
/* ZigBee IP beacons */
#define ZBEE_IP_BEACON_PROTOCOL_ID 0x02
#define ZBEE_IP_BEACON_ALLOW_JOIN 0x01
#define ZBEE_IP_BEACON_ROUTER_CAPACITY 0x02
#define ZBEE_IP_BEACON_HOST_CAPACITY 0x04
#define ZBEE_IP_BEACON_UNSECURE 0x80 /* Undocumented bit for test networks. */
#define ZBEE_IP_BEACON_TLV_LENGTH_MASK 0x0f
#define ZBEE_IP_BEACON_TLV_TYPE_MASK 0xf0
#define ZBEE_IP_BEACON_TLV_TYPE_LFDI 0x0
#endif /* PACKET_ZBEE_NWK_H */
/*
* Editor modelines - https://www.wireshark.org/tools/modelines.html
*
* Local variables:
* c-basic-offset: 4
* tab-width: 8
* indent-tabs-mode: nil
* End:
*
* vi: set shiftwidth=4 tabstop=8 expandtab:
* :indentSize=4:tabSize=8:noTabs=true:
*/
|
