tokio-mc

tokio-mc is a pure Rust library for Mitsubishi Communication (MC) protocol, built on top of tokio.

Features

• Async & Sync communication with Mitsubishi and Keyence PLCs using the 3E frame protocol.
• Easy integration with the tokio ecosystem for async programming.

Installation

Add the following to your Cargo.toml to use tokio-mc with the desired features:

• Async Feature (3e-async): For asynchronous communication
• Sync Feature (3e-sync): For synchronous communication

Example Dependency

# For async usage
tokio-mc = { version = "0.1.2", features = ["3e-async"] }

# For sync usage
tokio-mc = { version = "0.1.2", features = ["3e-sync"] }

Async Example

Here's how to use the async features of tokio-mc:

use std::net::SocketAddr;
use tokio::time::Duration;
use tokio_mc::{
    client::{tcp::*, Reader},
    frame::Model,
    Error,
};

#[tokio::main]
async fn main() -> Result<(), Error> {
    let addr = "192.168.1.30:5000"
        .parse::<SocketAddr>()
        .map_err(|e| Error::Transport(std::io::Error::new(std::io::ErrorKind::InvalidInput, e)))?;

    let mut context = connect(addr).await?;

    context.set_plc_model(Model::Keyence);

    let result = context.read_i32s("D1000", 1).await?;
    println!("Read U8s response: {:?}", result);
    Ok(())
}

Sync Example

Here's how to use the sync features of tokio-mc:

use std::net::SocketAddr;
use tokio::time::Duration;
use tokio_mc::{
    client::{tcp::*, Reader},
    frame::Model,
    Error,
};

#[tokio::main]
use std::net::SocketAddr;
use tokio_mc::{client::sync::*, frame::Model, Error};

fn main() -> Result<(), Error> {
    let addr = "192.168.110.252:5000".parse::<SocketAddr>().unwrap();
    let mut context = tcp::connect(addr)?;
    context.set_plc_model(Model::Keyence);

    let reult = context.read_reconver_string("D1404", 10)?;
    println!("Read words response: {:?}", reult);

    Ok(())
}

Disclaimer

When using this library for PLC communication, please first make sure that there is no abnormality in your connection. I used the 3E frame protocol, which has been tested with Keyence and Mitsubishi and used in actual projects. If you have any feedback or suggestions, please contact me via QQ email. My experience is limited, and I may add simulated servers and various protocol frames in the future.

Some codes are referenced from tokio-modbus。