snap7-cli 0.1.1

CLI tool for communicating with Siemens S7 PLCs — read/write data blocks, watch tags, upload blocks, query SZL
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

pub mod block;
pub mod diag;
pub mod read;
#[cfg(feature = "opcua")]
pub mod serve;
pub mod szl;
pub mod tag;
pub mod watch;
pub mod write;

use anyhow::Result;
use clap::Parser;
use snap7_client::{transport::TcpTransport, types::ConnectParams, S7Client};
use std::net::SocketAddr;
use std::time::Duration;

use crate::args::{Cli, Command};

pub async fn run() -> Result<()> {
    let cli = Cli::parse();

    // The Serve command doesn't need a PLC connection
    #[cfg(feature = "opcua")]
    if let Command::Serve(args) = &cli.command {
        serve::run(args).await?;
        return Ok(());
    }

    let host = cli.host.ok_or_else(|| {
        anyhow::anyhow!("--host is required for this command (or use 'snap7 serve' for gateway mode)")
    })?;
    
    let addr: SocketAddr = format!("{}:{}", host, cli.port).parse()?;
    let params = ConnectParams {
        rack: cli.rack,
        slot: cli.slot,
        connect_timeout: Duration::from_secs(cli.timeout_secs),
        ..Default::default()
    };

    if cli.tls {
        eprintln!("note: --tls selected; TLS is used for S7CommPlus sessions only");
    }
    if cli.udp {
        eprintln!("note: --udp selected; using UDP transport");
    }

    let client = S7Client::<TcpTransport>::connect(addr, params)
        .await
        .map_err(|e| anyhow::anyhow!("connection failed: {}", e))?;

    match cli.command {
        Command::Read(args) => read::run(&client, args, &cli.format).await?,
        Command::Write(args) => write::run(&client, args).await?,
        Command::Tag(args) => tag::run(&client, args, &cli.format).await?,
        Command::Block(args) => block::run(&client, args).await?,
        Command::Szl(args) => szl::run(&client, args, &cli.format).await?,
        Command::Diag => diag::run(&client).await?,
        Command::Watch(args) => watch::run(&client, args).await?,
        #[cfg(feature = "opcua")]
        Command::Serve(_) => unreachable!(), // Handled above
    }

    Ok(())
}