libosdp 0.1.2

Library implementation of IEC 60839-11-5 OSDP (Open Supervised Device Protocol)
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

# OSDP Rust library

This crate is a rust wrapper for [LibOSDP][1] - the most popular open source
library for creating OSDP devices. See github.cobm/goToMain/liosdp for more
information.

## Features

  - Supports secure channel communication (AES-128)
  - Can be used to setup a PD or CP mode of operation
  - Most OSDP specified commands and replies are supported (see [doc][3])

## Usage

To add libosdp to your rust project, do:

```
cargo add libosdp
```

### Control Panel:

A simplified CP implementation:

```
let pd_info = PdInfo::new(...);
let mut cp = ControlPanel::new(&mut pd_info)?;
cp.set_event_callback(|pd, event| {
    println!("Received event from {pd}: {:?}", event);
});
loop {
    cp.refresh();
    cp.send_command(0, OsdpCommand::new(...));
}
```

See [examples][2] for a working implementation.

### Peripheral Device:

A simplified PD implementation:

```
let pd_info = PdInfo::new(...);
let mut pd = PeripheralDevice::new(&mut pd_info)?;
pd.set_command_callback(|cmd| {
    println!("Received command {:?}", cmd);
});
loop {
    pd.refresh();
    cp.notify_event(OsdpEvent::new(...));
}
```

See [examples][2] for a working implementation.

[1]: https://github.cobm/goToMain/liosdp
[2]: https://github.com/goToMain/libosdp/blob/master/rust/examples
[3]: https://libosdp.sidcha.dev/protocol/commands-and-replies