iec61850 0.1.0

A rust implementation of the IEC61850 protocol.
Documentation 
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

# IEC 61850

A pure rust implementation of the [IEC61850 protocol](https://es.wikipedia.org/wiki/IEC_61850).

This crate provides a client that implements the IEC61850 MMS part of the protocol. Goose and sv parts may come in the future. A server implementation may also come in the future. Basic tests where done using a test server but some error may still arise. Despite the client being already working this is still a work in progress and the interfaces may change.

## Usage

A more complete example of how to use the client can be found on the examples folder.

```rust
use iec61850::{
 ClientConfig, Iec61850Client,
 mms::ReportCallback,
};

/// A test report callback that will print the report to the console.
struct TestReportCallback;

#[async_trait::async_trait]
impl ReportCallback for TestReportCallback {
 async fn on_report(&self, report: Report) {
  println!("Report: {:?}", report);
 }
}


#[tokio::main]
async fn main() -> Result<(), dyn std::error::Error> {
    // Connects to a server at localhost:102. Configurations like the serve ip and port can be changed using the ClientConfig
    let client = Iec61850Client::new(ClientConfig::default(), Box::new(TestReportCallback)).await?;

    let model = client.model();
    println!("Ied model: {model:#?}");

    let data = client
  .read_data_from_ld("SampleIEDDevice1", &["DGEN1$ST$Mod", "DGEN1$MX$TotWh"])
  .await?;
 println!("Data: {data:#?}");
}
```

## Contributing

Contributions are welcome and encourage!

If a bug is found open and issue explaining the problem and, if possible, attach some package captures to help understanding the problem.

## Pre-commit usage

A set of [pre-commits](https://pre-commit.com) hooks are provided to help keep the code nice and tidy

1. If not installed, install with your package manager, or `pip install --user pre-commit`
2. Run `pre-commit autoupdate` to update the pre-commit config to use the newest template
3. Run `pre-commit install` to install the pre-commit hooks to your local environment