fusible 0.20.5

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

//! File templates written by `fusible init`.

/// Default `.gitignore` for a new project.
pub(super) const GITIGNORE: &str =
    "node_modules/\ndist/\n.tscircuit/\n.fusible/\ntarget/\n*.kicad_prl\n*.bak\n";

/// Default `hardware/tsconfig.json`.
pub(super) const TSCONFIG_JSON: &str = r#"{
  "compilerOptions": {
    "target": "ESNext",
    "module": "ESNext",
    "moduleResolution": "bundler",
    "jsx": "react-jsx",
    "jsxImportSource": "@tscircuit/core",
    "strict": true,
    "skipLibCheck": true
  },
  "include": ["**/*.ts", "**/*.tsx"]
}
"#;

/// Starter `hardware/index.tsx` circuit.
pub(super) const INDEX_TSX: &str = r#"export default () => (
  <board width="40mm" height="30mm">
    {/* Microcontroller */}
    <chip
      name="U1"
      footprint="qfp32"
      pinLabels={{
        pin1: "GND",
        pin2: "VDD3V3",
        pin3: "GPIO0",
        pin4: "GPIO1",
      }}
    />

    {/* Power Input Header */}
    <chip
      name="J1"
      footprint="pinrow2"
      pinLabels={{
        pin1: "VDD3V3",
        pin2: "GND",
      }}
    />

    {/* Status LED with Current Limiting */}
    <resistor name="R_LED" resistance="1k" footprint="0603" />

    {/* Power Rails */}
    <trace from=".J1 > .VDD3V3" to="net.VDD3V3" />
    <trace from=".J1 > .GND" to="net.GND" />
    <trace from=".U1 > .VDD3V3" to="net.VDD3V3" />
    <trace from=".U1 > .GND" to="net.GND" />

    {/* Status LED Circuit */}
    <trace from=".U1 > .GPIO0" to=".R_LED > .pin1" />
    <trace from=".R_LED > .pin2" to="net.GND" />
  </board>
);
"#;

/// Renders `fusible.yml` for `project_name` targeting `mcu_chip`.
pub(super) fn manifest(project_name: &str, mcu_chip: &str) -> String {
    let yaml_name = serde_yaml::to_string(project_name)
        .map(|y| y.trim_end().to_string())
        .unwrap_or_default();
    format!(
        r#"name: {yaml_name}

boards:
  main:
    entry: hardware/index.tsx
    out_dir: dist
    port: 3020
    mcu: {mcu_chip}

firmware:
  app:
    board: main
    path: apps/firmware
    framework: esp-idf
    pins_rs: apps/firmware/src/pins.rs
    build_cmd: cargo test

# bodies:
#   enclosure:
#     generate: enclosure            # Fusible owns this file and regenerates it
#     board: main
#   bracket:
#     source: bodies/bracket.step    # authored in any CAD tool, never overwritten
"#
    )
}

/// Renders `hardware/package.json` for `project_name`.
pub(super) fn package_json(project_name: &str) -> String {
    let package_name =
        serde_json::to_string(&format!("{project_name}-hardware")).unwrap_or_default();
    format!(
        r#"{{
  "name": {package_name},
  "version": "0.1.0",
  "private": true,
  "dependencies": {{
    "@tscircuit/core": "^0.0.229",
    "tscircuit": "^0.0.229"
  }},
  "devDependencies": {{
    "@types/react": "^18.3.0"
  }}
}}
"#
    )
}