chipi-core 0.9.1

Core library for chipi: parser, IR, and code generation backends for instruction decoder generation
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
151
152
153
154
155

use chipi_core::*;

#[test]
fn test_variable_length_dsp() {
    let source = r#"
decoder TestDsp {
    width = 16
    bit_order = msb0
    max_units = 2
}

nop     [0:15]=0000000000000000
        | "nop"

halt    [0:15]=0000000000100001
        | "halt"

lri     [0:10]=00000010000 rd:u5[11:15] imm:u16[16:31]
        | "lri r{rd}, #0x{imm:04x}"

call    [0:15]=0000001010111111 addr:u16[16:31]
        | "call 0x{addr:04x}"
"#;

    let result = generate_from_str(source, "test_dsp.chipi");
    match result {
        Ok(code) => {
            // Should generate byte-based decode function
            assert!(code.contains("pub fn decode(data: &[u8]) -> Option<(Self, usize)>"));
            // Should have bounds checks for 2-unit instructions (4 bytes)
            assert!(code.contains("data.len() >= 4"));
            // Should read unit 1 via byte conversion
            assert!(code.contains("u16::from_be_bytes(data[2..4]"));
            println!("Generated code:\n{}", code);
        }
        Err(e) => {
            panic!("Failed to generate code: {}", e);
        }
    }
}

#[test]
fn test_backward_compatibility_single_unit() {
    let source = r#"
decoder TestCpu {
    width = 32
    bit_order = msb0
}

nop     [0:31]=00000000000000000000000000000000
        | "nop"

add     [0:5]=000001 rd:u5[6:10] rs:u5[11:15] rt:u5[16:20] [21:31]=00000000000
        | "add r{rd}, r{rs}, r{rt}"
"#;

    let result = generate_from_str(source, "test_dsp.chipi");
    match result {
        Ok(code) => {
            // Should generate byte-based decode function (unified signature)
            assert!(code.contains("pub fn decode(data: &[u8]) -> Option<(Self, usize)>"));
            // Should read opcode from bytes
            assert!(code.contains("u32::from_be_bytes(data[0..4]"));
            println!("Generated code:\n{}", code);
        }
        Err(e) => {
            panic!("Failed to generate code: {}", e);
        }
    }
}

#[test]
fn test_max_units_validation() {
    let source = r#"
decoder TestDsp {
    width = 16
    bit_order = msb0
    max_units = 1
}

# This should fail validation - requires 2 units but max_units is 1
lri     [0:10]=00000010000 rd:u5[11:15] imm:u16[16:31]
        | "lri r{rd}, #0x{imm:04x}"
"#;

    let result = generate_from_str(source, "test_dsp.chipi");
    assert!(result.is_err());
    let err_str = result.unwrap_err().to_string();
    assert!(err_str.contains("max_units"));
}

#[test]
fn test_cross_unit_field_extraction() {
    let source = r#"
decoder TestDsp {
    width = 16
    bit_order = msb0
    max_units = 2
}

# Field spanning units is now SUPPORTED
# In MSB0: bits 14-31 spans from unit 0 (bits 14-15) into unit 1 (bits 0-15)
cross_unit [0:13]=00000000000000 field:u32[14:31]
           | "cross {field:#x}"
"#;

    let result = generate_from_str(source, "test_dsp.chipi");
    match result {
        Ok(code) => {
            // Should generate byte-based decode function
            assert!(code.contains("pub fn decode(data: &[u8]) -> Option<(Self, usize)>"));
            // Should read unit 1 via byte conversion
            assert!(code.contains("u16::from_be_bytes(data[2..4]"));
            // Should have multi-range extraction (combining bits from multiple units)
            println!("Generated code:\n{}", code);
        }
        Err(e) => {
            panic!("Cross-unit fields should now be supported! Error: {}", e);
        }
    }
}

#[test]
fn test_unit1_pattern_disambiguation() {
    let source = r#"
decoder TestDsp {
    width = 16
    bit_order = msb0
    max_units = 2
}

# Two instructions with same unit 0 pattern but different unit 1 patterns
# This tests that unit 1+ fixed bits are properly checked
instr_a [0:15]=0000000100000000 [16:31]=0000000000000000
        | "instr_a"

instr_b [0:15]=0000000100000000 [16:31]=1111111111111111
        | "instr_b"
"#;

    let result = generate_from_str(source, "test_dsp.chipi");
    match result {
        Ok(code) => {
            // Should generate byte-based decode
            assert!(code.contains("pub fn decode(data: &[u8]) -> Option<(Self, usize)>"));
            // Should read unit 1 via byte conversion to distinguish instructions
            assert!(code.contains("u16::from_be_bytes(data[2..4]"));
            // Should have guards checking unit 1 bits
            println!("Generated code:\n{}", code);
        }
        Err(e) => {
            panic!("Should support unit 1 pattern disambiguation! Error: {}", e);
        }
    }
}