a rust wrapper of libplctag, with rust style APIs and useful extensions.
Add plctag to your Cargo.toml
toml
[dependencies]
plctag= "0.3"
libplctagplctag```rust use plctag::{Encode, Decode, RawTag}; let timeout = 100;//ms let path="protocol=ab-eip&plc=controllogix&path=1,0&gateway=192.168.1.120&name=MyTag1&elemcount=1&elemsize=16";// YOUR TAG DEFINITION let tag = RawTag::new(path, timeout).unwrap();
//read tag let status = tag.read(timeout); assert!(status.isok()); let offset = 0; let value:u16 = tag.getvalue(offset).unwrap(); println!("tag value: {}", value);
let value = value + 10; tag.set_value(offset, value).unwrap();
//write tag let status = tag.write(timeout); assert!(status.is_ok()); println!("write done!"); ```
read/write UDT
```rust use plctag::{Decode, Encode, RawTag, Result};
// define your UDT
struct MyUDT { #[tag(offset = 0)] v1: u16, #[tag(offset = 2)] v2: u16, }
let timeout = 100; //ms // YOUR TAG DEFINITION let path = "protocol=ab-eip&plc=controllogix&path=1,0&gateway=192.168.1.120&name=MyTag2&elemcount=2&elemsize=16"; let tag = RawTag::new(path, timeout).unwrap();
//read tag let status = tag.read(timeout); assert!(status.isok()); let offset = 0; let mut value: MyUDT = tag.getvalue(offset).unwrap(); println!("tag value: {:?}", value);
value.v1 += 10; tag.set_value(offset, value).unwrap();
//write tag let status = tag.write(timeout); assert!(status.is_ok()); println!("write done!");
```
Note:
Do not perform expensive operations when you derives Decode or Encode.
```rust use plctag::futures::{AsyncTag, Error};
use tokio::runtime;
let rt = runtime::Runtime::new().unwrap(); let res: Result<_, Error> = rt.blockon(async { let path="protocol=ab-eip&plc=controllogix&path=1,0&gateway=192.168.1.120&name=MyTag1&elemcount=1&elemsize=16"; // YOUR TAG DEFINITION let tag = AsyncTag::create(path).await?; let tagref = tag.get().await?; let offset = 0; let value: u16 = tagref.readvalue(offset).await?; println!("tag value: {}", value);
let value = value + 10;
tag_ref.write_value(offset, value).await?;
Ok(())
}); res.unwrap();
```
```rust use plctag::builder::*; use plctag::RawTag;
let timeout = 100; let path = PathBuilder::default() .protocol(Protocol::EIP) .gateway("192.168.1.120") .plc(PlcKind::ControlLogix) .name("MyTag1") .elementsize(16) .elementcount(1) .path("1,0") .readcachems(0) .build() .unwrap(); let tag = RawTag::new(path, timeout).unwrap(); let status = tag.status(); assert!(status.is_ok());
```
libplctag```rust use plctag::log::logadapt; use plctag::log::setdebug_level; use plctag::log::DebugLevel;
logadapt(); //register logger setdebug_level(DebugLevel::Info); // set debug level
// now, you can receive log messages by any of logging implementations of crate log
```
Please refer to How to build to setup build environment.
shell
cargo bench
The plots and saved data are stored under target/criterion/$BENCHMARK_NAME/
Processor: Intel(R) Core(TM) i7-9700KF CPU @ 3.60GHz 3.60 GHz RAM: 64.0 GB
``` sync read time: [5.8721 ms 5.9099 ms 5.9585 ms] change: [+0.0881% +0.7138% +1.4994%] (p = 0.06 > 0.05) No change in performance detected. Found 8 outliers among 100 measurements (8.00%) 2 (2.00%) low severe 1 (1.00%) low mild
async read time: [8.5650 ms 8.6148 ms 8.6786 ms] change: [-1.1842% -0.2853% +0.7350%] (p = 0.55 > 0.05) No change in performance detected. Found 7 outliers among 100 measurements (7.00%) 1 (1.00%) low severe
async batch-20 read time: [18.205 ms 18.431 ms 18.676 ms] change: [-2.0615% -0.1733% +1.5987%] (p = 0.86 > 0.05) No change in performance detected. Found 3 outliers among 100 measurements (3.00%) 2 (2.00%) high mild 1 (1.00%) high severe ```
MIT