breadkit 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 233212f063c6709cfaa93b8243125e71a80fd0bfb75b1904e4b989b40cd68c0a
-  data.tar.gz: e665337ec30e9f01baca29c27d66ab819d4c398533cb97d3d04d4c5a7edbeae6
+  metadata.gz: 0d260ec0ed4e1c801bca1cef667f8744801c873b3030d0b0374b55ba792e1c39
+  data.tar.gz: e3385f84d1c1db667220610c88b92aaccf6418764848fbd25e48b28803a6b650
 SHA512:
-  metadata.gz: 0d0bb60ddd1caba719db069e196aee4babb237b534451276763ca04c5f3c40534ebb17b8727bc7b95b0bdabcbaad44c462d8b20d8331e8f835c65b65e5650518
-  data.tar.gz: 313859b4d73d837d2b734ca2bbc613c263d38efb40ac5b4ec8e6c058863aff52e3a86b1d6f7bbda37062d5452b308ec55783896fbfa6e9561687060733510145
+  metadata.gz: e0f7b8dfe9bc040913684edd4dd33bdb8f08faa0a8d4a87d660d8c44945d445db2dc6fc15df1e533f7212a18d063ce189f28359877ed0a92aa54ea451ccf665d
+  data.tar.gz: '08ddeeed6aafd4324d55d56432af21f457d28308ebb151459096806e31f5d8f0ba37cf635b5c4eb79bd51df21941568786d07321a09fa37204df42680c3442d4'

data/.codespellignore

@@ -0,0 +1,2 @@
+registor
+SER

data/.yamllint

@@ -0,0 +1,16 @@
+extends: default
+ignore: |
+  build/
+  node_modules/
+  runtime/build/
+  tmp/
+  **/*.dSYM/**
+
+rules:
+  comments:
+    min-spaces-from-content: 1
+  document-start: disable
+  line-length:
+    max: 200
+  truthy:
+    check-keys: false

data/README.md

@@ -1,16 +1,119 @@
-# breadkit
+<p align="center">
+  <img src="site/favicon.svg" width="72" height="72" alt="">
+</p>
 
-`breadkit` provides the Ruby DSL, board and part definitions, connectivity analysis, and JSON IR used by [`breadkit-render`](https://github.com/breadkit/breadkit-render) and [`breadkit-lint`](https://github.com/breadkit/breadkit-lint).
+<h1 align="center">breadkit</h1>
 
-Project site: https://breadkit.github.io/breadkit/
+<p align="center">
+  <strong>Describe breadboard circuits in Ruby, YAML, or TOML. See how every connection fits together.</strong>
+</p>
+
+<p align="center">
+  <a href="https://rubygems.org/gems/breadkit"><img src="https://img.shields.io/gem/v/breadkit.svg" alt="RubyGems version"></a>
+  <a href="https://github.com/breadkit/breadkit/actions/workflows/ci.yml"><img src="https://github.com/breadkit/breadkit/actions/workflows/ci.yml/badge.svg" alt="CI status"></a>
+  <img src="https://img.shields.io/badge/Ruby-%3E%3D%203.3-CC342D.svg" alt="Ruby 3.3 or newer">
+  <a href="LICENSE.txt"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT license"></a>
+</p>
+
+Breadkit resolves board holes, part pins, wires, and switch states into connected
+nets. It exports JSON IR for other tools and checks declared connection intent.
+
+<p align="center">
+  <img src="site/assets/05_sensor_demo.png" width="700" alt="RP2040 breadboard circuit with an OLED, two SHT31 sensors, switches, and IR modules">
+</p>
+
+<p align="center">
+  <a href="examples/05_sensor_demo.bk.rb">Circuit source</a> ·
+  <a href="https://breadkit.github.io/breadkit-render/images/sensor-demo.svg">Explore its layers</a>
+</p>
+
+## Quick start
+
+Install with Ruby 3.3 or newer:
 
 ```sh
 gem install breadkit
+```
+
+Save this as `circuit.bk.rb`:
+
+```ruby
+title "Button and LED"
+board :half
+
+supply :USB, voltage: 5.0, plus: "B+1", minus: "B-1"
+net :VCC, at: "B+1"
+net :GND, at: "B-1"
+
+button :SW1, at: "e10"
+resistor :R1, "330", pins: %w[a12 a16]
+led :D1, color: :red, anode: "b16", cathode: "b17"
+
+wire "a10", "B+", color: :red
+wire "a17", "B-", color: :black
+```
+
+```sh
 breadkit nets circuit.bk.rb
 breadkit ir circuit.bk.rb > circuit.json
-breadkit parts
 ```
 
-Ruby DSL files execute as code. Load only trusted files; use IR JSON for data-only input.
+This README follows main (0.2.0). If `breadkit --version` shows an older
+published release, use the [source checkout](#development) for newer features.
+The same circuit is available in [YAML](examples/06_declarative_led.bk.yml) and
+[TOML](examples/07_declarative_led.bk.toml).
+
+## Layered module example
+
+The [sensor demo](examples/05_sensor_demo.bk.rb) combines an RP2040 module with
+an OLED, two SHT31 sensors, switches, and IR modules. Its `layer:` declarations
+group parts and wires in the interactive SVG. These lines are from the full
+example:
+
+```ruby
+offboard :OLED, :ssd1306_oled, side: :right, at: "a7", address: "0x3C", layer: "2 I2C"
+offboard :SHT31A, :sht31, side: :right, at: "a12", address: "0x44", unused: ["ALR"], layer: "2 I2C"
+offboard :SHT31B, :sht31, side: :right, at: "a19", address: "0x45", unused: ["ALR"], layer: "2 I2C"
+
+wire "j5", "T+5", color: "#E24B4A", layer: "1 Power"
+wire "OLED.SDA", "g24", color: "#378ADD", route: :edge, layer: "2 I2C"
+```
+
+Run `bundle exec ruby exe/breadkit nets examples/05_sensor_demo.bk.rb` from a
+source checkout to inspect the full circuit. The optional 5 V emitter layer is
+an alternative: disconnect its 3.3 V feed before using it.
+
+## Explore
+
+- [User guide](https://breadkit.github.io/breadkit/guide/) and [circuit gallery](https://breadkit.github.io/breadkit/gallery/)
+- [DSL reference](https://breadkit.github.io/breadkit/guide/dsl/) and [component catalog](https://breadkit.github.io/breadkit/guide/components/)
+- [CLI reference](docs/CLI.md), [YAML/TOML guide](docs/DECLARATIVE.md), and [JSON IR](docs/IR.md)
+- [Browser Playground](https://breadkit.github.io/breadkit/playground/) and [editor integration](docs/LSP.md)
+- [MCP server](docs/MCP.md), [Rake task](docs/RAKE.md), [jumper kit](docs/JUMPER_KIT.md), and [definition lockfile](docs/LOCK.md)
+
+The companion repositories are [breadkit-render](https://github.com/breadkit/breadkit-render)
+for diagrams, [breadkit-lint](https://github.com/breadkit/breadkit-lint)
+for circuit checks, [breadkit-rspec](https://github.com/breadkit/breadkit-rspec)
+for connection matchers, and [breadkit-parts](https://github.com/breadkit/breadkit-parts)
+for model-specific definitions. Each gem is released independently.
+
+Ruby DSL files execute code; load only files you trust. YAML, TOML, and JSON IR
+are parsed as data.
+
+## Development
+
+```sh
+git clone https://github.com/breadkit/breadkit.git
+cd breadkit
+bundle install
+bundle exec ruby exe/breadkit nets examples/01_led_button.bk.rb
+bundle exec rake
+```
+
+Clone companion repositories beside this checkout when working on their main
+branches. See the [compatibility policy](docs/COMPATIBILITY.md) before changing
+a public data format.
+
+## License
 
-See the [user guide](https://breadkit.github.io/breadkit/guide/), [component catalog](https://breadkit.github.io/breadkit/guide/components/), [DSL reference](https://breadkit.github.io/breadkit/guide/dsl/), and [project design](docs/DESIGN.md).
+[MIT](LICENSE.txt).

data/data/boards/double_full.yml

@@ -0,0 +1,18 @@
+id: double_full
+name: Double full-size breadboard (1660 tie points)
+terminal:
+  columns: 126
+  rows: [a, b, c, d, e, f, g, h, i, j]
+  groups: [[a, b, c, d, e], [f, g, h, i, j]]
+  ravine_between: [e, f]
+rails:
+  - {id: "T+", side: top, order: 0}
+  - {id: "T-", side: top, order: 1}
+  - {id: "B+", side: bottom, order: 1}
+  - {id: "B-", side: bottom, order: 0}
+rail_layout:
+  holes: 100
+  group_size: 5
+  start_column: 3
+  segments: [[1, 50], [51, 100]]
+  split_segments: [[1, 25], [26, 50], [51, 75], [76, 100]]

data/data/boards/stripboard.yml

@@ -0,0 +1,9 @@
+id: stripboard
+name: Stripboard (30 x 20 continuous copper rows)
+terminal:
+  columns: 30
+  rows: [a, b, c, d, e, f, g, h, i, j, k, l, m, n, o, p, q, r, s, t]
+  groups: [[a], [b], [c], [d], [e], [f], [g], [h], [i], [j], [k], [l], [m], [n], [o], [p], [q], [r], [s], [t]]
+  strip_direction: row
+  wire_attachment: solder
+rails: []

data/data/boards/universal.yml

@@ -0,0 +1,8 @@
+id: universal
+name: Universal perfboard (30 x 20 isolated pads)
+terminal:
+  columns: 30
+  rows: [a, b, c, d, e, f, g, h, i, j, k, l, m, n, o, p, q, r, s, t]
+  groups: [[a], [b], [c], [d], [e], [f], [g], [h], [i], [j], [k], [l], [m], [n], [o], [p], [q], [r], [s], [t]]
+  wire_attachment: solder
+rails: []

data/data/parts/2n3904.yml

@@ -0,0 +1,11 @@
+# Onsemi 2N3904 TO-92 pin order (front view): emitter, base, collector.
+# https://www.onsemi.com/download/data-sheet/pdf/2n3904-d.pdf
+id: 2n3904
+category: transistor
+transistor_polarity: NPN
+placement: leads
+pins:
+  - {num: 1, name: emitter, aliases: [e]}
+  - {num: 2, name: base, aliases: [b]}
+  - {num: 3, name: collector, aliases: [c]}
+render: {shape: generic}

data/data/parts/2n7000_onsemi_to92.yml

@@ -0,0 +1,10 @@
+# Onsemi TO-92 CASE 135AN; other manufacturers may use a different pin order.
+# https://www.onsemi.com/pdf/datasheet/nds7002a-d.pdf
+id: 2n7000_onsemi_to92
+category: mosfet
+placement: leads
+pins:
+  - {num: 1, name: source, aliases: [s]}
+  - {num: 2, name: gate, aliases: [g]}
+  - {num: 3, name: drain, aliases: [d]}
+render: {shape: generic}

data/data/parts/74hc00.yml

@@ -0,0 +1,22 @@
+# https://www.ti.com/lit/ds/symlink/sn74hc00.pdf
+id: 74hc00
+category: ic
+placement: dip
+package: {pins: 14}
+pins:
+  - {num: 1, name: 1A, type: input}
+  - {num: 2, name: 1B, type: input}
+  - {num: 3, name: 1Y, type: output}
+  - {num: 4, name: 2A, type: input}
+  - {num: 5, name: 2B, type: input}
+  - {num: 6, name: 2Y, type: output}
+  - {num: 7, name: GND, type: ground}
+  - {num: 8, name: 3Y, type: output}
+  - {num: 9, name: 3A, type: input}
+  - {num: 10, name: 3B, type: input}
+  - {num: 11, name: 4Y, type: output}
+  - {num: 12, name: 4A, type: input}
+  - {num: 13, name: 4B, type: input}
+  - {num: 14, name: VCC, type: power}
+supply_range: [2, 6]
+render: {shape: dip, label: 74HC00}

data/data/parts/74hc04.yml

@@ -0,0 +1,22 @@
+# https://www.ti.com/lit/ds/symlink/sn74hc04.pdf
+id: 74hc04
+category: ic
+placement: dip
+package: {pins: 14}
+pins:
+  - {num: 1, name: 1A, type: input}
+  - {num: 2, name: 1Y, type: output}
+  - {num: 3, name: 2A, type: input}
+  - {num: 4, name: 2Y, type: output}
+  - {num: 5, name: 3A, type: input}
+  - {num: 6, name: 3Y, type: output}
+  - {num: 7, name: GND, type: ground}
+  - {num: 8, name: 4Y, type: output}
+  - {num: 9, name: 4A, type: input}
+  - {num: 10, name: 5Y, type: output}
+  - {num: 11, name: 5A, type: input}
+  - {num: 12, name: 6Y, type: output}
+  - {num: 13, name: 6A, type: input}
+  - {num: 14, name: VCC, type: power}
+supply_range: [2, 6]
+render: {shape: dip, label: 74HC04}

data/data/parts/74hc08.yml

@@ -0,0 +1,22 @@
+# https://www.ti.com/lit/ds/symlink/sn74hc08.pdf
+id: 74hc08
+category: ic
+placement: dip
+package: {pins: 14}
+pins:
+  - {num: 1, name: 1A, type: input}
+  - {num: 2, name: 1B, type: input}
+  - {num: 3, name: 1Y, type: output}
+  - {num: 4, name: 2A, type: input}
+  - {num: 5, name: 2B, type: input}
+  - {num: 6, name: 2Y, type: output}
+  - {num: 7, name: GND, type: ground}
+  - {num: 8, name: 3Y, type: output}
+  - {num: 9, name: 3A, type: input}
+  - {num: 10, name: 3B, type: input}
+  - {num: 11, name: 4Y, type: output}
+  - {num: 12, name: 4A, type: input}
+  - {num: 13, name: 4B, type: input}
+  - {num: 14, name: VCC, type: power}
+supply_range: [2, 6]
+render: {shape: dip, label: 74HC08}

data/data/parts/74hc14.yml

@@ -0,0 +1,22 @@
+# https://www.ti.com/lit/ds/symlink/sn74hc14.pdf
+id: 74hc14
+category: ic
+placement: dip
+package: {pins: 14}
+pins:
+  - {num: 1, name: 1A, type: input}
+  - {num: 2, name: 1Y, type: output}
+  - {num: 3, name: 2A, type: input}
+  - {num: 4, name: 2Y, type: output}
+  - {num: 5, name: 3A, type: input}
+  - {num: 6, name: 3Y, type: output}
+  - {num: 7, name: GND, type: ground}
+  - {num: 8, name: 4Y, type: output}
+  - {num: 9, name: 4A, type: input}
+  - {num: 10, name: 5Y, type: output}
+  - {num: 11, name: 5A, type: input}
+  - {num: 12, name: 6Y, type: output}
+  - {num: 13, name: 6A, type: input}
+  - {num: 14, name: VCC, type: power}
+supply_range: [2, 6]
+render: {shape: dip, label: 74HC14}

data/data/parts/74hc165.yml

@@ -0,0 +1,24 @@
+# https://www.ti.com/lit/ds/symlink/sn74hc165.pdf
+id: 74hc165
+category: ic
+placement: dip
+package: {pins: 16}
+pins:
+  - {num: 1, name: SH_LD, type: input}
+  - {num: 2, name: CLK, type: input}
+  - {num: 3, name: E, type: input}
+  - {num: 4, name: F, type: input}
+  - {num: 5, name: G, type: input}
+  - {num: 6, name: H, type: input}
+  - {num: 7, name: QH_INV, type: output}
+  - {num: 8, name: GND, type: ground}
+  - {num: 9, name: QH, type: output}
+  - {num: 10, name: SER, type: input}
+  - {num: 11, name: A, type: input}
+  - {num: 12, name: B, type: input}
+  - {num: 13, name: C, type: input}
+  - {num: 14, name: D, type: input}
+  - {num: 15, name: CLK_INH, type: input}
+  - {num: 16, name: VCC, type: power}
+supply_range: [2, 6]
+render: {shape: dip, label: 74HC165}

data/data/parts/74hc32.yml

@@ -0,0 +1,22 @@
+# https://www.ti.com/lit/ds/symlink/sn74hc32.pdf
+id: 74hc32
+category: ic
+placement: dip
+package: {pins: 14}
+pins:
+  - {num: 1, name: 1A, type: input}
+  - {num: 2, name: 1B, type: input}
+  - {num: 3, name: 1Y, type: output}
+  - {num: 4, name: 2A, type: input}
+  - {num: 5, name: 2B, type: input}
+  - {num: 6, name: 2Y, type: output}
+  - {num: 7, name: GND, type: ground}
+  - {num: 8, name: 3Y, type: output}
+  - {num: 9, name: 3A, type: input}
+  - {num: 10, name: 3B, type: input}
+  - {num: 11, name: 4Y, type: output}
+  - {num: 12, name: 4A, type: input}
+  - {num: 13, name: 4B, type: input}
+  - {num: 14, name: VCC, type: power}
+supply_range: [2, 6]
+render: {shape: dip, label: 74HC32}

data/data/parts/74hc595.yml

@@ -0,0 +1,24 @@
+# https://www.ti.com/lit/ds/symlink/sn74hc595.pdf
+id: 74hc595
+category: ic
+placement: dip
+package: {pins: 16}
+pins:
+  - {num: 1, name: QB, type: output}
+  - {num: 2, name: QC, type: output}
+  - {num: 3, name: QD, type: output}
+  - {num: 4, name: QE, type: output}
+  - {num: 5, name: QF, type: output}
+  - {num: 6, name: QG, type: output}
+  - {num: 7, name: QH, type: output}
+  - {num: 8, name: GND, type: ground}
+  - {num: 9, name: QH_SERIAL, type: output}
+  - {num: 10, name: SRCLR, type: input}
+  - {num: 11, name: SRCLK, type: input}
+  - {num: 12, name: RCLK, type: input}
+  - {num: 13, name: OE, type: input}
+  - {num: 14, name: SER, type: input}
+  - {num: 15, name: QA, type: output}
+  - {num: 16, name: VCC, type: power}
+supply_range: [2, 6]
+render: {shape: dip, label: 74HC595}

data/data/parts/active_buzzer.yml

@@ -0,0 +1,8 @@
+id: active_buzzer
+category: output
+placement: leads
+pins:
+  - {num: 1, name: "plus", type: power}
+  - {num: 2, name: "minus", type: ground}
+polarity: {positive: plus, negative: minus}
+render: {shape: generic}

data/data/parts/ams1117_3v3.yml

@@ -0,0 +1,12 @@
+# Advanced Monolithic Systems fixed 3.3 V SOT-223 device; surface-mount only.
+# https://www.electronica-pt.com/pdf/AMS1117.pdf
+id: ams1117_3v3
+category: regulator
+placement: offboard
+pins:
+  - {num: 1, name: GND, type: ground}
+  - {num: 2, name: VOUT, type: power}
+  - {num: 3, name: VIN, type: power}
+  - {num: 4, name: TAB, type: power}
+internal: [[VOUT, TAB]]
+render: {shape: offboard, label: AMS1117-3.3}

data/data/parts/arduino_nano.yml

@@ -0,0 +1,70 @@
+# https://docs.arduino.cc/resources/pinouts/A000005-full-pinout.pdf
+# Synthetic pin numbers: left header top to bottom, then right header bottom to top.
+id: arduino_nano
+category: module
+placement: footprint
+straddle: true
+pins:
+  - {num: 1, name: D13, type: gpio, max_voltage: 5, output_capable: true}
+  - {num: 2, name: 3V3, type: power}
+  - {num: 3, name: AREF, type: analog}
+  - {num: 4, name: A0, type: gpio, max_voltage: 5, output_capable: true}
+  - {num: 5, name: A1, type: gpio, max_voltage: 5, output_capable: true}
+  - {num: 6, name: A2, type: gpio, max_voltage: 5, output_capable: true}
+  - {num: 7, name: A3, type: gpio, max_voltage: 5, output_capable: true}
+  - {num: 8, name: A4, type: gpio, max_voltage: 5, output_capable: true}
+  - {num: 9, name: A5, type: gpio, max_voltage: 5, output_capable: true}
+  - {num: 10, name: A6, type: analog}
+  - {num: 11, name: A7, type: analog}
+  - {num: 12, name: 5V, type: power}
+  - {num: 13, name: RESET1, type: reset}
+  - {num: 14, name: GND1, type: ground, aliases: [GND]}
+  - {num: 15, name: VIN, type: power}
+  - {num: 16, name: D1, type: gpio, aliases: [TX], max_voltage: 5, output_capable: true}
+  - {num: 17, name: D0, type: gpio, aliases: [RX], max_voltage: 5, output_capable: true}
+  - {num: 18, name: RESET2, type: reset}
+  - {num: 19, name: GND2, type: ground}
+  - {num: 20, name: D2, type: gpio, max_voltage: 5, output_capable: true}
+  - {num: 21, name: D3, type: gpio, max_voltage: 5, output_capable: true}
+  - {num: 22, name: D4, type: gpio, max_voltage: 5, output_capable: true}
+  - {num: 23, name: D5, type: gpio, max_voltage: 5, output_capable: true}
+  - {num: 24, name: D6, type: gpio, max_voltage: 5, output_capable: true}
+  - {num: 25, name: D7, type: gpio, max_voltage: 5, output_capable: true}
+  - {num: 26, name: D8, type: gpio, max_voltage: 5, output_capable: true}
+  - {num: 27, name: D9, type: gpio, max_voltage: 5, output_capable: true}
+  - {num: 28, name: D10, type: gpio, max_voltage: 5, output_capable: true}
+  - {num: 29, name: D11, type: gpio, max_voltage: 5, output_capable: true}
+  - {num: 30, name: D12, type: gpio, max_voltage: 5, output_capable: true}
+internal: [[GND1, GND2], [RESET1, RESET2]]
+footprint:
+  "1": [0, 0]
+  "2": [1, 0]
+  "3": [2, 0]
+  "4": [3, 0]
+  "5": [4, 0]
+  "6": [5, 0]
+  "7": [6, 0]
+  "8": [7, 0]
+  "9": [8, 0]
+  "10": [9, 0]
+  "11": [10, 0]
+  "12": [11, 0]
+  "13": [12, 0]
+  "14": [13, 0]
+  "15": [14, 0]
+  "16": [14, 6]
+  "17": [13, 6]
+  "18": [12, 6]
+  "19": [11, 6]
+  "20": [10, 6]
+  "21": [9, 6]
+  "22": [8, 6]
+  "23": [7, 6]
+  "24": [6, 6]
+  "25": [5, 6]
+  "26": [4, 6]
+  "27": [3, 6]
+  "28": [2, 6]
+  "29": [1, 6]
+  "30": [0, 6]
+render: {shape: module, label: Arduino Nano, size_mm: [45, 18], fill: "#2C2C2A", stroke: "#171715", text_color: "#FFFFFF"}

data/data/parts/arduino_uno.yml

@@ -2,33 +2,36 @@ id: arduino_uno
 category: offboard
 placement: offboard
 pins:
-  - {num: 1, name: D0}
-  - {num: 2, name: D1}
-  - {num: 3, name: D2}
-  - {num: 4, name: D3}
-  - {num: 5, name: D4}
-  - {num: 6, name: D5}
-  - {num: 7, name: D6}
-  - {num: 8, name: D7}
-  - {num: 9, name: D8}
-  - {num: 10, name: D9}
-  - {num: 11, name: D10}
-  - {num: 12, name: D11}
-  - {num: 13, name: D12}
-  - {num: 14, name: D13}
-  - {num: 15, name: GND, role: ground}
-  - {num: 16, name: 5V, role: power}
-  - {num: 17, name: A0}
-  - {num: 18, name: A1}
-  - {num: 19, name: A2}
-  - {num: 20, name: A3}
-  - {num: 21, name: A4}
-  - {num: 22, name: A5}
-  - {num: 23, name: 3V3, role: power}
-  - {num: 24, name: VIN, role: power}
-  - {num: 25, name: GND2, role: ground}
-  - {num: 26, name: GND3, role: ground}
+  - {num: 1, name: D0, type: gpio, max_voltage: 5}
+  - {num: 2, name: D1, type: gpio, max_voltage: 5}
+  - {num: 3, name: D2, type: gpio, max_voltage: 5}
+  - {num: 4, name: D3, type: gpio, max_voltage: 5}
+  - {num: 5, name: D4, type: gpio, max_voltage: 5}
+  - {num: 6, name: D5, type: gpio, max_voltage: 5}
+  - {num: 7, name: D6, type: gpio, max_voltage: 5}
+  - {num: 8, name: D7, type: gpio, max_voltage: 5}
+  - {num: 9, name: D8, type: gpio, max_voltage: 5}
+  - {num: 10, name: D9, type: gpio, max_voltage: 5}
+  - {num: 11, name: D10, type: gpio, max_voltage: 5}
+  - {num: 12, name: D11, type: gpio, max_voltage: 5}
+  - {num: 13, name: D12, type: gpio, max_voltage: 5}
+  - {num: 14, name: D13, type: gpio, max_voltage: 5}
+  - {num: 15, name: GND, type: ground}
+  - {num: 16, name: 5V, type: power}
+  - {num: 17, name: A0, type: gpio, max_voltage: 5}
+  - {num: 18, name: A1, type: gpio, max_voltage: 5}
+  - {num: 19, name: A2, type: gpio, max_voltage: 5}
+  - {num: 20, name: A3, type: gpio, max_voltage: 5}
+  - {num: 21, name: A4, type: gpio, max_voltage: 5}
+  - {num: 22, name: A5, type: gpio, max_voltage: 5}
+  - {num: 23, name: 3V3, type: power}
+  - {num: 24, name: VIN, type: power}
+  - {num: 25, name: GND2, type: ground}
+  - {num: 26, name: GND3, type: ground}
   - {num: 27, name: RESET}
   - {num: 28, name: AREF}
 internal: [[15, 25], [15, 26]]
+provides:
+  - {positive: 5V, negative: GND, voltage: 5}
+  - {positive: 3V3, negative: GND, voltage: 3.3}
 render: {shape: offboard, label: Arduino Uno}

data/data/parts/atmega328p.yml

@@ -0,0 +1,37 @@
+# https://ww1.microchip.com/downloads/aemDocuments/documents/MCU08/ProductDocuments/DataSheets/ATmega48A-PA-88A-PA-168A-PA-328-P-DS-DS40002061B.pdf
+id: atmega328p
+category: mcu
+placement: dip
+package: {pins: 28}
+pins:
+  - {num: 1, name: PC6_RESET, type: reset, aliases: [RESET]}
+  - {num: 2, name: PD0, type: gpio}
+  - {num: 3, name: PD1, type: gpio}
+  - {num: 4, name: PD2, type: gpio}
+  - {num: 5, name: PD3, type: gpio}
+  - {num: 6, name: PD4, type: gpio}
+  - {num: 7, name: VCC, type: power}
+  - {num: 8, name: GND1, type: ground}
+  - {num: 9, name: PB6, type: gpio}
+  - {num: 10, name: PB7, type: gpio}
+  - {num: 11, name: PD5, type: gpio}
+  - {num: 12, name: PD6, type: gpio}
+  - {num: 13, name: PD7, type: gpio}
+  - {num: 14, name: PB0, type: gpio}
+  - {num: 15, name: PB1, type: gpio}
+  - {num: 16, name: PB2, type: gpio}
+  - {num: 17, name: PB3, type: gpio}
+  - {num: 18, name: PB4, type: gpio}
+  - {num: 19, name: PB5, type: gpio}
+  - {num: 20, name: AVCC, type: power}
+  - {num: 21, name: AREF, type: input}
+  - {num: 22, name: GND2, type: ground}
+  - {num: 23, name: PC0, type: gpio}
+  - {num: 24, name: PC1, type: gpio}
+  - {num: 25, name: PC2, type: gpio}
+  - {num: 26, name: PC3, type: gpio}
+  - {num: 27, name: PC4, type: gpio}
+  - {num: 28, name: PC5, type: gpio}
+internal: [[GND1, GND2]]
+supply_range: [1.8, 5.5]
+render: {shape: dip, label: ATMEGA328P}

data/data/parts/attiny85.yml

@@ -0,0 +1,16 @@
+# https://ww1.microchip.com/downloads/en/devicedoc/atmel-2586-avr-8-bit-microcontroller-attiny25-attiny45-attiny85_datasheet.pdf
+id: attiny85
+category: mcu
+placement: dip
+package: {pins: 8}
+pins:
+  - {num: 1, name: PB5_RESET, type: reset, aliases: [RESET]}
+  - {num: 2, name: PB3, type: gpio}
+  - {num: 3, name: PB4, type: gpio}
+  - {num: 4, name: GND, type: ground}
+  - {num: 5, name: PB0, type: gpio}
+  - {num: 6, name: PB1, type: gpio}
+  - {num: 7, name: PB2, type: gpio}
+  - {num: 8, name: VCC, type: power}
+supply_range: [2.7, 5.5]
+render: {shape: dip, label: ATTINY85}

data/data/parts/battery_box.yml

@@ -0,0 +1,8 @@
+id: battery_box
+category: power
+placement: offboard
+pins:
+  - {num: 1, name: "POS", type: power}
+  - {num: 2, name: "NEG", type: ground}
+polarity: {positive: POS, negative: NEG}
+render: {shape: offboard, label: Battery Box}

data/data/parts/cd4017.yml

@@ -0,0 +1,24 @@
+# https://www.ti.com/lit/ds/symlink/cd4017b.pdf
+id: cd4017
+category: ic
+placement: dip
+package: {pins: 16}
+pins:
+  - {num: 1, name: Q5, type: output}
+  - {num: 2, name: Q1, type: output}
+  - {num: 3, name: Q0, type: output}
+  - {num: 4, name: Q2, type: output}
+  - {num: 5, name: Q6, type: output}
+  - {num: 6, name: Q7, type: output}
+  - {num: 7, name: Q3, type: output}
+  - {num: 8, name: VSS, type: ground}
+  - {num: 9, name: Q8, type: output}
+  - {num: 10, name: Q4, type: output}
+  - {num: 11, name: Q9, type: output}
+  - {num: 12, name: CARRY, type: output}
+  - {num: 13, name: CLOCK_INH, type: input}
+  - {num: 14, name: CLOCK, type: input}
+  - {num: 15, name: RESET, type: input}
+  - {num: 16, name: VDD, type: power}
+supply_range: [3, 18]
+render: {shape: dip, label: CD4017}