takproto 0.4.2

Rust library for TAK (Team Awareness Kit) Protocol - send CoT messages to TAK servers with mTLS support
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
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150

use std::env;
use std::time::{SystemTime, UNIX_EPOCH};
use takproto::proto::{CotEvent, Detail};
use takproto::{TakClient, TlsConfig};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let args: Vec<String> = env::args().collect();

    if args.len() < 6 {
        eprintln!(
            "Usage: {} <server_addr> <server_name> <ca_cert> <client_cert> <client_key>",
            args[0]
        );
        std::process::exit(1);
    }

    let server_addr = &args[1];
    let server_name = &args[2];
    let ca_cert_path = &args[3];
    let client_cert_path = &args[4];
    let client_key_path = &args[5];

    let tls_config =
        TlsConfig::new_with_client_cert(ca_cert_path, client_cert_path, client_key_path)?;

    println!("Connecting to TAK server...");
    let mut client = TakClient::connect_tls(server_addr, server_name, tls_config).await?;
    println!("Connected!\n");

    let now_ms = SystemTime::now().duration_since(UNIX_EPOCH)?.as_millis() as u64;

    // Test 1: Using <url> element (iTAK-friendly)
    println!("Sending marker with <url> element...");
    let event = CotEvent {
        r#type: "b-m-p-s-m".to_string(),
        uid: "URL-ELEMENT-TEST".to_string(),
        send_time: now_ms,
        start_time: now_ms,
        stale_time: now_ms + 300_000,
        how: "h-e".to_string(),

        lat: 39.377445,
        lon: -76.83216000,
        hae: 10.0,
        ce: 9.9,
        le: 9.9,

        detail: Some(Detail {
            // Using <url> instead of <link>
            xml_detail: r#"<url url="https://www.rust-lang.org" name="Rust Website"/>
<remarks>Using URL element - tap Details to see link</remarks>
<color value="-65536"/>"#
                .to_string(), // Red
            ..Default::default()
        }),

        ..Default::default()
    };

    client.send_cot_event_xml(event).await?;
    println!("✓ Sent RED marker with <url> element\n");

    // Test 2: Multiple URLs
    println!("Sending marker with multiple <url> elements...");
    let event2 = CotEvent {
        r#type: "b-m-p-s-m".to_string(),
        uid: "MULTI-URL-TEST".to_string(),
        send_time: now_ms + 1000,
        start_time: now_ms + 1000,
        stale_time: now_ms + 301_000,
        how: "h-e".to_string(),

        lat: 39.380000,
        lon: -76.835000,
        hae: 10.0,
        ce: 9.9,
        le: 9.9,

        detail: Some(Detail {
            xml_detail: r#"<url url="https://www.rust-lang.org" name="Rust Homepage"/>
<url url="https://github.com/rust-lang/rust" name="Rust GitHub"/>
<url url="https://doc.rust-lang.org/book/" name="The Rust Book"/>
<remarks>Multiple URLs - tap Details to access</remarks>
<color value="-16711936"/>"#
                .to_string(), // Green
            ..Default::default()
        }),

        ..Default::default()
    };

    client.send_cot_event_xml(event2).await?;
    println!("✓ Sent GREEN marker with multiple <url> elements\n");

    // Test 3: Both <link> and <url> for compatibility
    println!("Sending marker with BOTH <link> AND <url>...");
    let event3 = CotEvent {
        r#type: "b-m-p-s-m".to_string(),
        uid: "HYBRID-TEST".to_string(),
        send_time: now_ms + 2000,
        start_time: now_ms + 2000,
        stale_time: now_ms + 302_000,
        how: "h-e".to_string(),

        lat: 39.382000,
        lon: -76.838000,
        hae: 10.0,
        ce: 9.9,
        le: 9.9,

        detail: Some(Detail {
            // Include both for maximum compatibility
            /*
                        xml_detail: r#"<link uid="HYBRID-TEST" type="b-m-p-s-m" relation="p-p" url="https://www.rust-lang.org" mime="text/html" remarks="Rust Website"/>
            <url url="https://www.rust-lang.org" name="Rust Website"/>
            <remarks>Both link and url elements for compatibility</remarks>
            <color value="-16776961"/>"#.to_string(), // Blue
                        */
            xml_detail: r#"<contact callsign="Hybrid Test"/>
    <remarks>Rust website link</remarks>
    <url url="https://www.rust-lang.org" name="Rust Website"/>
    <!-- Optional: color still goes in detail -->
    <color value="-16776961"/>"#
                .to_string(),
            ..Default::default()
        }),

        ..Default::default()
    };

    client.send_cot_event_xml(event3).await?;
    println!("✓ Sent BLUE marker with both elements\n");

    println!("=== CHECK iTAK ===");
    println!("Look for 3 markers:");
    println!("  🔴 RED:   URL-ELEMENT-TEST");
    println!("  🟢 GREEN: MULTI-URL-TEST (3 URLs)");
    println!("  🔵 BLUE:  HYBRID-TEST");
    println!();
    println!("For each marker:");
    println!("  1. Tap the marker");
    println!("  2. Tap 'Details' button");
    println!("  3. Look for clickable links/URLs");
    println!();
    println!("If you see links now, the <url> element works for your iTAK version!");

    client.close().await?;
    Ok(())
}