pcb-toolkit 0.1.5

PCB design calculator library — impedance, current capacity, via properties, and more
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

//! PCB substrate material database.

use serde::{Deserialize, Serialize};

/// A PCB substrate material with dielectric properties.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Material {
    pub name: &'static str,
    /// Relative permittivity (dielectric constant).
    pub er: f64,
    /// Glass transition temperature (°C), if known.
    pub tg: Option<f64>,
    /// Surface roughness correction factor (0.98 for FR-4 variants, 1.0 for smooth).
    pub roughness_factor: f64,
}

/// Built-in material database.
///
/// Roughness factor: 0.98 for FR-4 family, 1.0 for others.
pub static MATERIALS: &[Material] = &[
    Material { name: "FR-4 STD", er: 4.60, tg: Some(130.0), roughness_factor: 0.98 },
    Material { name: "FR-5", er: 4.30, tg: Some(170.0), roughness_factor: 0.98 },
    Material { name: "FR406", er: 4.60, tg: Some(170.0), roughness_factor: 0.98 },
    Material { name: "FR408", er: 3.80, tg: Some(180.0), roughness_factor: 0.98 },
    Material { name: "Getek ML200C", er: 3.80, tg: Some(175.0), roughness_factor: 0.98 },
    Material { name: "Getek ML200D", er: 3.90, tg: Some(175.0), roughness_factor: 0.98 },
    Material { name: "Getek ML200M", er: 3.80, tg: Some(175.0), roughness_factor: 0.98 },
    Material { name: "Getek RG200D", er: 4.20, tg: Some(175.0), roughness_factor: 0.98 },
    Material { name: "Isola P95", er: 3.78, tg: Some(260.0), roughness_factor: 1.0 },
    Material { name: "Isola P96", er: 3.78, tg: Some(260.0), roughness_factor: 1.0 },
    Material { name: "Isola P26N", er: 3.90, tg: Some(250.0), roughness_factor: 1.0 },
    Material { name: "RO2800", er: 2.94, tg: None, roughness_factor: 1.0 },
    Material { name: "RO3003", er: 3.00, tg: None, roughness_factor: 1.0 },
    Material { name: "RO3006", er: 6.15, tg: None, roughness_factor: 1.0 },
    Material { name: "RO3010", er: 10.20, tg: None, roughness_factor: 1.0 },
    Material { name: "RO4003", er: 3.38, tg: Some(280.0), roughness_factor: 1.0 },
    Material { name: "RO4350", er: 3.66, tg: Some(280.0), roughness_factor: 1.0 },
    Material { name: "RT5500", er: 2.50, tg: Some(260.0), roughness_factor: 1.0 },
    Material { name: "RT5870", er: 2.35, tg: Some(260.0), roughness_factor: 1.0 },
    Material { name: "RT5880", er: 2.20, tg: Some(260.0), roughness_factor: 1.0 },
    Material { name: "RT6002", er: 2.94, tg: None, roughness_factor: 1.0 },
    Material { name: "RT6006", er: 6.15, tg: None, roughness_factor: 1.0 },
    Material { name: "RT6010", er: 10.20, tg: None, roughness_factor: 1.0 },
    Material { name: "Teflon PTFE", er: 2.10, tg: Some(240.0), roughness_factor: 1.0 },
    Material { name: "Arlon 25N", er: 3.38, tg: Some(260.0), roughness_factor: 1.0 },
    Material { name: "Arlon 33N", er: 4.25, tg: Some(250.0), roughness_factor: 1.0 },
    Material { name: "Arlon 85N", er: 4.20, tg: Some(250.0), roughness_factor: 1.0 },
    Material { name: "PCL-FR-226", er: 4.50, tg: Some(140.0), roughness_factor: 0.98 },
    Material { name: "PCL-FR-240", er: 4.50, tg: Some(140.0), roughness_factor: 0.98 },
    Material { name: "PCL-FR-370", er: 4.50, tg: Some(175.0), roughness_factor: 0.98 },
    Material { name: "PCL-FR-370HR", er: 4.60, tg: Some(180.0), roughness_factor: 0.98 },
    Material { name: "N4000-7 EF", er: 4.10, tg: Some(165.0), roughness_factor: 0.98 },
    Material { name: "N4000-13", er: 3.70, tg: Some(210.0), roughness_factor: 0.98 },
    Material { name: "N4000-13SI", er: 3.40, tg: Some(210.0), roughness_factor: 0.98 },
    Material { name: "N4000-13 EP", er: 3.70, tg: Some(210.0), roughness_factor: 0.98 },
    Material { name: "N4000-13 EPSI", er: 3.40, tg: Some(210.0), roughness_factor: 0.98 },
    Material { name: "N4000-29", er: 4.50, tg: Some(185.0), roughness_factor: 0.98 },
    Material { name: "N7000-1", er: 3.90, tg: Some(260.0), roughness_factor: 1.0 },
    Material { name: "Ventec VT-47", er: 4.60, tg: Some(180.0), roughness_factor: 0.98 },
    Material { name: "Ventec VT-901", er: 4.15, tg: Some(250.0), roughness_factor: 1.0 },
    Material { name: "Ventec VT-90H", er: 4.15, tg: Some(250.0), roughness_factor: 1.0 },
    Material { name: "Megtron6", er: 3.40, tg: Some(185.0), roughness_factor: 1.0 },
    Material { name: "Kappa 438", er: 4.38, tg: Some(280.0), roughness_factor: 1.0 },
    Material { name: "Kapton", er: 3.40, tg: Some(400.0), roughness_factor: 1.0 },
    Material { name: "Air", er: 1.00, tg: None, roughness_factor: 1.0 },
];

/// Look up a material by name (case-insensitive).
pub fn lookup(name: &str) -> Option<&'static Material> {
    MATERIALS.iter().find(|m| m.name.eq_ignore_ascii_case(name))
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn material_count() {
        assert_eq!(MATERIALS.len(), 45);
    }

    #[test]
    fn lookup_fr4() {
        let m = lookup("FR-4 STD").unwrap();
        assert!((m.er - 4.6).abs() < 1e-10);
        assert_eq!(m.tg, Some(130.0));
        assert!((m.roughness_factor - 0.98).abs() < 1e-10);
    }

    #[test]
    fn lookup_ro4350() {
        let m = lookup("RO4350").unwrap();
        assert!((m.er - 3.66).abs() < 1e-10);
        assert_eq!(m.tg, Some(280.0));
        assert!((m.roughness_factor - 1.0).abs() < 1e-10);
    }

    #[test]
    fn lookup_kapton() {
        let m = lookup("Kapton").unwrap();
        assert!((m.er - 3.40).abs() < 1e-10);
        assert_eq!(m.tg, Some(400.0));
    }

    #[test]
    fn lookup_air() {
        let m = lookup("Air").unwrap();
        assert!((m.er - 1.0).abs() < 1e-10);
        assert_eq!(m.tg, None);
    }

    #[test]
    fn lookup_case_insensitive() {
        assert!(lookup("fr-4 std").is_some());
        assert!(lookup("AIR").is_some());
        assert!(lookup("megtron6").is_some());
    }

    #[test]
    fn lookup_unknown() {
        assert!(lookup("unobtanium").is_none());
    }
}