fusible 0.8.14

Electronic linter: a fuse that blows to block firmware code generation
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

//! `trace_clearance`: physical copper clearance design rule check (DRC).

use crate::linter::{Diagnostic, LintContext, Rule};

/// Minimum copper clearance in millimeters (standard 6 mil / 0.15mm PCB manufacturing limit).
const MIN_CLEARANCE_MM: f64 = 0.15;

/// Inspects physical PCB copper geometry (pads, traces, vias) and detects
/// short circuits and clearance violations between distinct electrical nets.
pub struct TraceClearanceRule;

#[derive(Debug)]
struct CopperFeature {
    pub net_id: String,
    pub net_name: String,
    pub layer: String,
    pub x: f64,
    pub y: f64,
    pub half_w: f64,
    pub half_h: f64,
}

impl Rule for TraceClearanceRule {
    fn name(&self) -> &'static str {
        "trace_clearance"
    }

    fn check(&self, ctx: &LintContext<'_>) -> Vec<Diagnostic> {
        let features = extract_copper_features(ctx);
        let mut diagnostics = Vec::new();

        // Compare all pairs of copper features on the same layer belonging to different nets
        for i in 0..features.len() {
            for j in (i + 1)..features.len() {
                let f1 = &features[i];
                let f2 = &features[j];

                if f1.net_id == f2.net_id || !f1.layer.eq_ignore_ascii_case(&f2.layer) {
                    continue;
                }

                let dx = (f1.x - f2.x).abs();
                let dy = (f1.y - f2.y).abs();

                let required_x = f1.half_w + f2.half_w + MIN_CLEARANCE_MM;
                let required_y = f1.half_h + f2.half_h + MIN_CLEARANCE_MM;

                if dx < required_x && dy < required_y {
                    let clearance_gap = ((dx - (f1.half_w + f2.half_w)).max(0.0))
                        .hypot((dy - (f1.half_h + f2.half_h)).max(0.0));

                    let is_direct_short =
                        dx < (f1.half_w + f2.half_w) && dy < (f1.half_h + f2.half_h);

                    let msg = if is_direct_short {
                        format!(
                            "direct copper short-circuit on {}: net \"{}\" and net \"{}\" overlap at ({:.2}, {:.2})",
                            f1.layer, f1.net_name, f2.net_name, f1.x, f1.y
                        )
                    } else {
                        format!(
                            "copper clearance violation on {}: net \"{}\" and net \"{}\" have only {:.3}mm spacing (minimum {MIN_CLEARANCE_MM}mm)",
                            f1.layer, f1.net_name, f2.net_name, clearance_gap
                        )
                    };

                    diagnostics.push(Diagnostic {
                        rule: self.name().to_string(),
                        message: msg,
                        help: Some(
                            "reroute copper or relocate pads to maintain at least 0.15mm clearance to prevent manufacturing defects"
                                .to_string(),
                        ),
                    });
                }
            }
        }

        diagnostics
    }
}

fn extract_copper_features(ctx: &LintContext<'_>) -> Vec<CopperFeature> {
    let mut features = Vec::new();

    for pad in ctx.circuit.pads() {
        // Only inspect pads with real physical layout coordinates
        let (x, y) = match (pad.x, pad.y) {
            (Some(x), Some(y)) => (x, y),
            _ => continue,
        };

        let half_w = pad.width.unwrap_or(1.0) / 2.0;
        let half_h = pad.height.unwrap_or(1.0) / 2.0;
        let layer = pad.layer.clone().unwrap_or_else(|| "top".to_string());

        // Resolve net ID and display name
        let net_node = pad
            .pad_id
            .as_deref()
            .and_then(|id| ctx.netlist.pad_to_net.get(id))
            .or_else(|| {
                pad.port_id
                    .as_deref()
                    .and_then(|id| ctx.netlist.port_to_net.get(id))
            })
            .or_else(|| {
                pad.net_id
                    .as_deref()
                    .and_then(|id| ctx.netlist.by_id.get(id))
            })
            .and_then(|&idx| ctx.netlist.nets.get(idx));

        let (net_id, net_name) = match net_node {
            Some(node) => (node.id().to_string(), node.display_name().to_string()),
            None => {
                if let Some(nid) = pad.net_id.as_deref() {
                    (nid.to_string(), nid.to_string())
                } else {
                    continue;
                }
            }
        };

        features.push(CopperFeature {
            net_id,
            net_name,
            layer,
            x,
            y,
            half_w,
            half_h,
        });
    }

    features
}