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

//! Example for sending raw telegrams to KNX bus.
//!
//! Connect to KNX/IP device and send custom telegrams.

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

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

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    // 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),
        ..Default::default()
    };

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

    // Connect to KNX network
    knx.connect().await?;

    println!("Sending custom telegrams...");

    // Send a switch ON telegram
    let switch_on_telegram = Telegram {
        source: IndividualAddress::new(1, 1, 240),
        destination: Address::Group(GroupAddress::from_parts(1, 2, 3)?),
        payload: vec![0x01], // ON value
        priority: Priority::Normal,
        direction: Direction::Outgoing,
        telegram_type: TelegramType::GroupValueWrite,
        gateway_id: None,
        timestamp: std::time::SystemTime::now(),
    };

    println!(
        "Sending switch ON telegram to {}...",
        switch_on_telegram.destination
    );
    knx.send_telegram(&switch_on_telegram).await?;

    sleep(Duration::from_secs(2)).await;

    // Send a switch OFF telegram
    let switch_off_telegram = Telegram {
        source: IndividualAddress::new(1, 1, 240),
        destination: Address::Group(GroupAddress::from_parts(1, 2, 3)?),
        payload: vec![0x00], // OFF value
        priority: Priority::Normal,
        direction: Direction::Outgoing,
        telegram_type: TelegramType::GroupValueWrite,
        gateway_id: None,
        timestamp: std::time::SystemTime::now(),
    };

    println!(
        "Sending switch OFF telegram to {}...",
        switch_off_telegram.destination
    );
    knx.send_telegram(&switch_off_telegram).await?;

    sleep(Duration::from_secs(1)).await;

    // Send a brightness value telegram
    let brightness_telegram = Telegram {
        source: IndividualAddress::new(1, 1, 240),
        destination: Address::Group(GroupAddress::from_parts(1, 2, 4)?),
        payload: vec![128], // 50% brightness
        priority: Priority::Normal,
        direction: Direction::Outgoing,
        telegram_type: TelegramType::GroupValueWrite,
        gateway_id: None,
        timestamp: std::time::SystemTime::now(),
    };

    println!(
        "Sending brightness telegram to {}...",
        brightness_telegram.destination
    );
    knx.send_telegram(&brightness_telegram).await?;

    // Disconnect
    knx.disconnect().await?;

    println!("Send telegrams example completed successfully!");
    Ok(())
}