frameassembly 1.2.1

Declarative Rust DSL and compiler to generate deterministic .pcap/.pcapng packet captures across 81 L2-L7 protocols for Wireshark, IDS & CI testing.
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

//! OPC Unified Architecture (OPC UA, IEC 62541-6) Binary Protocol wire payload builder.
//!
//! This module implements [`build_opcua_payload`], which serializes an [`OpcuaSpec`]
//! AST node into an IEC 62541-6 OPC UA Connection Protocol (`UACP`) binary frame over TCP port
//! 4840. Every packet begins with the 8-byte UACP header (3-byte ASCII `MessageType` `HEL`/`ACK`/
//! `OPN`/`CLO`/`MSG`/`ERR`, 1-byte `ChunkType` `'F'`/`'C'`/`'A'`, and 32-bit little-endian
//! `MessageSize`) followed by connection buffer parameters (`EndpointUrl`) or `SecureChannelId`,
//! `TokenId`, `SequenceNumber`, `RequestId`, and `NodeId` service body fields.

use crate::ast::*;
use crate::builders::WireContext;
use alloc::vec::Vec;

/// Builds an OPC UA Binary Protocol packet payload.
pub fn build_opcua_payload(
    _ctx: &WireContext,
    spec: &OpcuaSpec,
    payload_bytes: &[u8],
) -> Vec<u8> {
    let default_msg = if spec.node_id.is_some() && spec.endpoint_url.is_none() {
        "MSG"
    } else {
        "HEL"
    };
    let msg_type_str = spec.msg_type.unwrap_or(default_msg).to_ascii_uppercase();
    let msg_bytes = match msg_type_str.as_str() {
        "HEL" => *b"HEL",
        "ACK" => *b"ACK",
        "OPN" => *b"OPN",
        "CLO" => *b"CLO",
        "MSG" => *b"MSG",
        "ERR" => *b"ERR",
        _ => *b"HEL",
    };

    let chunk_type = spec.chunk_type.unwrap_or('F') as u8;

    let mut body = Vec::new();
    if msg_bytes == *b"HEL" {
        // Hello Message Body (20-byte buffer sizes + 4-byte length + EndpointUrl)
        body.extend_from_slice(&0u32.to_le_bytes()); // Version 0
        body.extend_from_slice(&65536u32.to_le_bytes()); // ReceiveBufferSize
        body.extend_from_slice(&65536u32.to_le_bytes()); // SendBufferSize
        body.extend_from_slice(&16777216u32.to_le_bytes()); // MaxMessageSize (16MB)
        body.extend_from_slice(&5000u32.to_le_bytes()); // MaxChunkCount
        if let Some(url) = spec.endpoint_url {
            let url_bytes = url.as_bytes();
            body.extend_from_slice(&(url_bytes.len() as u32).to_le_bytes());
            body.extend_from_slice(url_bytes);
        } else {
            body.extend_from_slice(&0u32.to_le_bytes()); // EndpointUrl length 0
        }
        if let Some(node_id) = spec.node_id {
            let nid_bytes = node_id.as_bytes();
            body.extend_from_slice(&(nid_bytes.len() as u32).to_le_bytes());
            body.extend_from_slice(nid_bytes);
        }
    } else if msg_bytes == *b"ACK" {
        // Acknowledge Message Body (20 bytes)
        body.extend_from_slice(&0u32.to_le_bytes()); // Version 0
        body.extend_from_slice(&65536u32.to_le_bytes()); // ReceiveBufferSize
        body.extend_from_slice(&65536u32.to_le_bytes()); // SendBufferSize
        body.extend_from_slice(&16777216u32.to_le_bytes()); // MaxMessageSize
        body.extend_from_slice(&5000u32.to_le_bytes()); // MaxChunkCount
    } else {
        // Message / OpenSecureChannel Body
        body.extend_from_slice(&spec.secure_channel_id.unwrap_or(1).to_le_bytes());
        body.extend_from_slice(&spec.token_id.unwrap_or(1).to_le_bytes());
        body.extend_from_slice(&spec.seq_num.unwrap_or(1).to_le_bytes());
        body.extend_from_slice(&spec.req_id.unwrap_or(1).to_le_bytes());
        if let Some(node_id) = spec.node_id {
            let nid_bytes = node_id.as_bytes();
            body.push(0x03); // String NodeId encoding mask
            body.push(0x00); // Namespace index 0
            body.extend_from_slice(&(nid_bytes.len() as u32).to_le_bytes());
            body.extend_from_slice(nid_bytes);
        }
        if let Some(url) = spec.endpoint_url {
            let url_bytes = url.as_bytes();
            body.extend_from_slice(&(url_bytes.len() as u32).to_le_bytes());
            body.extend_from_slice(url_bytes);
        }
    }

    if !payload_bytes.is_empty() {
        body.extend_from_slice(payload_bytes);
    }

    let total_size = (8 + body.len()) as u32;
    let mut pkt = Vec::with_capacity(total_size as usize);
    pkt.extend_from_slice(&msg_bytes);
    pkt.push(chunk_type);
    pkt.extend_from_slice(&total_size.to_le_bytes());
    pkt.extend_from_slice(&body);
    pkt
}