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
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
use std::time::Duration;
pub mod apl {
pub mod aps {
mod frame_format{
pub enum FrameType {
Data,
Command,
Acknowledgement
}
pub enum DeliveryMode {
NormalUnicastDelivery = 0,
Broadcast = 2,
GroupAddressing = 3
}
pub struct FrameControlField {
pub frame_type: FrameType,
pub delivery_mode: DeliveryMode,
pub ack_format: bool,
pub security: bool,
pub ack_request: bool,
pub extended_header_present: bool
}
pub struct AddressingFields {
pub destination_endpoint: Option<u8>,
pub group_address: Option<u16>,
pub cluster_identifier: Option<u16>,
pub profile_identifier: Option<u16>,
pub source_endpoint: u8
}
pub enum FragmentationField {
NotFragmented,
FirstPart,
NotFirstPart
}
pub struct AckBitfield {
}
pub struct ExtHeader {
pub fragmentation: FragmentationField,
pub block_number: Option<u8>,
pub ack_bitfield: Option<AckBitfield>
}
pub struct Apdu<'a> {
pub frame_control: FrameControlField,
pub address: AddressingFields,
pub aps_counter: u8,
pub extended_header: Option<ExtHeader>,
pub frame_payload: &'a[u8]
}
}
#[derive(Clone, Copy)]
pub enum AddrAndEp{
None,
ShortAddressNoEp(u16),
ShortAddressWithEp(u16, u8),
LongAddress(u64, u8)
}
pub enum SecurityStatus {
Unsecured,
SecuredNwkKey,
SecuredLinkKey
}
pub enum IndicationStatus {
Success,
DefragUnupported,
DefragDeferred,
SecurityProcessingError
}
pub struct TxOptions {
pub security_enabled: bool,
pub use_nwk_key: bool,
pub acknowledged_transmission: bool,
pub fragmentation_permitted: bool,
pub include_extended_nonce_in_aps_security_frame: bool,
}
pub struct DataIndication<'a> {
pub dst_addr_ep: AddrAndEp,
pub src_addr_ep: AddrAndEp,
pub profile_id: u16,
pub cluster_id: u16,
pub asdu: &'a[u8],
pub status: IndicationStatus,
pub security_status: SecurityStatus,
pub link_quality: u8,
pub rx_time: ::Duration
}
pub enum DataConfirmStatus {
Success,
NoShortAddress,
NoBoundDevice,
SecurityFail,
NoAck,
AsduTooLong,
NldeError
}
pub struct DataConfirm {
pub dst: AddrAndEp,
pub src_endpoint: u8,
pub status: DataConfirmStatus,
pub tx_time: ::Duration
}
pub struct DataRequest<'a> {
pub dst: AddrAndEp,
pub profile_id: u16,
pub cluster_id: u16,
pub src_endpoint: u8,
pub asdu: &'a[u8],
pub options: TxOptions,
pub radius: u8
}
pub trait ApsdeSap{
fn data_request(&self, request: DataRequest) -> DataConfirm;
fn register_application_object(&self, indication_callback: Fn(DataIndication));
}
pub struct BindRequest {
pub src_addr: u64,
pub src_endpoint: u8,
pub cluster_id: u16,
pub dst_addr: AddrAndEp
}
pub enum BindStatus {
Success,
IllegalRequest,
TableFull,
NotSupported
}
pub struct BindConfirm {
pub status: BindStatus,
pub src_addr: u64,
pub src_endpoint: u8,
pub cluster_id: u16,
pub dst_addr: AddrAndEp
}
type UnbindRequest = BindRequest;
pub enum UnbindStatus {
Success,
IllegalRequest,
InvalidBinding
}
pub struct UnbindConfirm {
pub status: UnbindStatus,
pub src_addr: u64,
pub src_endpoint: u8,
pub cluster_id: u16,
pub dst_addr: AddrAndEp
}
pub struct BindingTable {
}
pub struct ChannelMask {
}
pub struct GroupTable<'a> {
entries: &'a Iterator<Item=(u16, Iterator<Item = u8>)>
}
pub struct PermissionsConfiguration {
}
pub enum AddGroupStatus {
Success,
InvalidParameter,
TableFull
}
pub struct AddGroupConfirm{
pub status: AddGroupStatus,
pub group_address: u16,
pub endpoint: u8
}
pub enum RemoveGroupStatus {
Success,
InvalidGroup,
InvalidParameter,
}
pub struct RemoveGroupConfirm{
pub status: RemoveGroupStatus,
pub group_address: u16,
pub endpoint: u8
}
pub enum RemoveAllGroupsStatus {
Success,
InvalidParameter
}
pub struct RemoveAllGroupsConfirm{
pub status: RemoveAllGroupsStatus,
pub endpoint: u8
}
pub trait ApsmeSap{
fn bind_request(&self, request: BindRequest) -> BindConfirm;
fn unbind_request(&self, request: UnbindRequest) -> UnbindConfirm;
fn binding_table(&self) -> Option<BindingTable> { None }
fn designated_coordinator(&self) -> bool { false }
fn channel_mask(&self) -> Option<ChannelMask>;
fn use_extended_pan_id(&self) -> u64 { 0 }
fn group_table(&self) -> Option<GroupTable> { None }
fn nonmember_radius(&self) -> u8 { 2 }
fn permissions_configuration(&self) -> Option<PermissionsConfiguration>{
None
}
fn use_insecure_join(&self) -> bool { true }
fn interframe_delay(&self) -> u8;
fn last_channel_energy(&self) -> Option<u8>;
fn last_channel_failure_rate(&self) -> Option<f32>;
fn channel_timer(&self) -> Option<f32>;
fn max_window_size(&self) -> Option<u8>;
fn set_binding_table(&self, BindingTable) -> Result<(), ()>;
fn set_designated_coordinator(&self, bool) -> Result<(), ()>;
fn set_channel_mask(&self, ChannelMask) -> Result<(), ()>;
fn set_extended_pan_id(&self, u64) -> Result<(), ()>;
fn set_group_table(&self, GroupTable) -> Result<(), ()>;
fn set_nonmember_radius(&self, u8) -> Result<(), ()>;
fn set_permissions_configuration(&self, PermissionsConfiguration) -> Result<(), ()>;
fn set_insecure_join(&self, bool) -> Result<(), ()>;
fn set_interframe_delay(&self, u8) -> Result<(), ()>;
fn set_last_channel_energy(&self, u8) -> Result<(), ()>;
fn set_last_channel_failure_rate(&self, f32) -> Result<(), ()>;
fn set_channel_timer(&self, f32) -> Result<(), ()>;
fn set_max_window_size(&self, u8) -> Result<(), ()>;
fn add_group_request(&self, group_adderss: u16, endpoint: u8) -> AddGroupConfirm;
fn remove_group_request(&self, group_adderss: u16, endpoint: u8) -> RemoveGroupConfirm;
fn remove_all_groups_request(&self, endpoint: u8) -> RemoveAllGroupsConfirm;
}
pub const MAX_DESCRIPTOR_SIZE: usize = 64;
pub const MAX_FRAME_RETRIES: u32 = 3;
pub const MIN_DUPLICATE_REJECTION_TABLE_SIZE: usize = 1;
pub const MIN_HEADER_OVERHEAD: usize = 0x0C;
}
}
pub mod nwk{
pub trait NlmeSap{
fn nlme_get(&self);
fn nlme_set(&self);
}
}