knust 0.1.2

Asynchronous KNX/IP library for Rust
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
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118

//! Example for proper connection handling and graceful disconnection.
//!
//! Demonstrates connecting to KNX/IP device, performing operations, and properly disconnecting.

use std::time::Duration;
use tokio::signal;
use tokio::time::sleep;

use knust::protocol::address::{Address, GroupAddress, IndividualAddress};
use knust::protocol::telegram::{Direction, Priority, Telegram, TelegramType};
use knust::{ConnectionConfig, ConnectionType, Knx};

async fn graceful_shutdown(knx: Knx) -> Result<(), Box<dyn std::error::Error>> {
    println!("Shutting down gracefully...");

    // Perform any cleanup operations here
    // For example, turn off all lights

    // Disconnect from KNX network
    knx.disconnect().await?;
    println!("Disconnected from KNX network");

    Ok(())
}

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    const MAX_RETRIES: u32 = 3;

    // Initialize logging
    env_logger::init();

    // Configure connection
    let config = ConnectionConfig {
        connection_type: ConnectionType::Tunneling,
        gateway_ip: Some("192.168.1.100".parse()?),
        individual_address: IndividualAddress::new(1, 1, 240),
        auto_reconnect: true,
        ..Default::default()
    };

    // Create Knx instance
    let knx = Knx::new(config).await?;

    // Set up signal handler for graceful shutdown
    let knx_clone = knx.clone();
    tokio::spawn(async move {
        signal::ctrl_c().await.expect("Failed to listen for Ctrl+C");
        println!("Received Ctrl+C, initiating graceful shutdown...");
        if let Err(e) = graceful_shutdown(knx_clone).await {
            eprintln!("Error during shutdown: {e}");
        }
        std::process::exit(0);
    });

    println!("Connecting to KNX network...");

    // Connect to KNX network with retry logic
    let mut retry_count = 0;

    loop {
        match knx.connect().await {
            Ok(()) => {
                println!("Successfully connected to KNX network");
                break;
            }
            Err(e) => {
                retry_count += 1;
                if retry_count >= MAX_RETRIES {
                    eprintln!("Failed to connect after {MAX_RETRIES} attempts: {e}");
                    return Err(e.into());
                }
                println!("Connection attempt {retry_count} failed: {e}. Retrying in 2 seconds...");
                sleep(Duration::from_secs(2)).await;
            }
        }
    }

    // Perform some operations - toggle a switch's group address directly
    let source = IndividualAddress::new(1, 1, 240);
    let switch_address = GroupAddress::from_parts(1, 0, 9).expect("Valid address");
    let switch_telegram = |on: bool| Telegram {
        source,
        destination: Address::Group(switch_address),
        payload: vec![u8::from(on)],
        priority: Priority::Normal,
        direction: Direction::Outgoing,
        telegram_type: TelegramType::GroupValueWrite,
        gateway_id: None,
        timestamp: std::time::SystemTime::now(),
    };

    println!("Performing operations...");

    for i in 1..=5 {
        println!("Operation {i}/5: Toggling switch");

        knx.send_telegram(&switch_telegram(true)).await?;
        sleep(Duration::from_secs(1)).await;

        knx.send_telegram(&switch_telegram(false)).await?;
        sleep(Duration::from_secs(1)).await;
    }

    // Check connection status
    if knx.is_connected().await {
        println!("Connection is still active");
    } else {
        println!("Connection lost, attempting to reconnect...");
        knx.connect().await?;
    }

    // Graceful shutdown
    graceful_shutdown(knx).await?;

    println!("Disconnect example completed successfully!");
    Ok(())
}