@vinjocarsales/xiao-series 0.1.4

package/README.md

@@ -0,0 +1,203 @@
+# @vinjocarsales/xiao-series
+
+Reusable [tscircuit](https://tscircuit.com) components for the Seeed Studio XIAO ESP32-S3 and ESP32-C3 module family.
+
+## Installation
+
+```sh
+npm install @vinjocarsales/xiao-series @tscircuit/core
+```
+
+## Usage
+
+```tsx
+import { XiaoEsp32S3Dip, XiaoEsp32S3Smd } from "@vinjocarsales/xiao-series";
+
+export default () => (
+  <board width="45mm" height="35mm">
+    <XiaoEsp32S3Dip name="U1" />
+
+    <led name="LED1" footprint="0805" />
+
+    <trace from="U1.D0" to="LED1.anode" />
+    <trace from="LED1.cathode" to="U1.GND" />
+  </board>
+);
+```
+
+## Components
+
+- `XiaoEsp32S3Dip` — ESP32-S3 XIAO with 2.54mm through-hole DIP pads.
+- `XiaoEsp32S3Smd` — ESP32-S3 XIAO with castellated SMD pads.
+- `XiaoEsp32C3Dip` — ESP32-C3 XIAO with 2.54mm through-hole DIP pads.
+- `XiaoEsp32C3Smd` — ESP32-C3 XIAO with castellated SMD pads.
+
+Each component requires a `name` prop, extends `CommonLayoutProps`, and exports a matching hook:
+
+```tsx
+import { useXiaoEsp32S3Dip } from "@vinjocarsales/xiao-series";
+
+const U1 = useXiaoEsp32S3Dip("U1");
+```
+
+## Pin Labels
+
+### ESP32-S3
+
+| Pin   | Label |
+| ----- | ----- |
+| pin1  | D0    |
+| pin2  | D1    |
+| pin3  | D2    |
+| pin4  | D3    |
+| pin5  | D4    |
+| pin6  | D5    |
+| pin7  | D6    |
+| pin8  | D7    |
+| pin9  | D8    |
+| pin10 | D9    |
+| pin11 | D10   |
+| pin12 | 3V3   |
+| pin13 | GND   |
+| pin14 | VBUS  |
+
+`3V3` and `VBUS` are marked as power pins. `GND` is marked as ground.
+
+### ESP32-C3
+
+| Pin   | Label |
+| ----- | ----- |
+| pin1  | D0    |
+| pin2  | D1    |
+| pin3  | D2    |
+| pin4  | D3    |
+| pin5  | D4    |
+| pin6  | D5    |
+| pin7  | D6    |
+| pin8  | D7    |
+| pin9  | D8    |
+| pin10 | D9    |
+| pin11 | D10   |
+| pin12 | 3V3   |
+| pin13 | GND   |
+| pin14 | 5V    |
+
+`3V3` and `5V` are marked as power pins. `GND` is marked as ground.
+
+## Footprints
+
+- DIP variants use two rows of seven plated through-holes.
+- DIP pitch is `2.54mm`.
+- DIP row spacing is `17.78mm` center-to-center.
+- DIP holes are `1.0mm` with `1.8mm` outer copper diameter.
+- SMD variants use XIAO-compatible castellated side pads on the top layer.
+- ESP32-C3 variants include a STEP 3D model from `assets/xiao-esp32-c3.step`.
+- KiCad through-hole footprints can be referenced with `kicad:` and the `LED_THT` family, for example `kicad:LED_THT/LED_D1.8mm_W1.8mm_H2.4mm_Horizontal_O1.27mm_Z1.6mm`.
+
+## 3D Models
+
+The ESP32-C3 DIP and SMD components use the bundled STEP model by default:
+
+```tsx
+<XiaoEsp32C3Smd name="U1" />
+```
+
+ESP32-S3 components in this package do not include a bundled STEP model, so `XiaoEsp32S3Dip` and `XiaoEsp32S3Smd` will render only the PCB footprint by default.
+
+You can override the model or tune placement with `cadModel`:
+
+```tsx
+<XiaoEsp32C3Smd
+  name="U1"
+  cadModel={{
+    stepUrl: "https://example.com/xiao-esp32-c3.step",
+    zOffsetFromSurface: "0mm",
+    rotationOffset: { x: 0, y: 0, z: 0 },
+    positionOffset: { x: 0, y: 0, z: 0 },
+  }}
+/>
+```
+
+## Examples
+
+### Blink
+
+```tsx
+import { XiaoEsp32S3Dip } from "@vinjocarsales/xiao-series";
+
+export default () => (
+  <board width="45mm" height="35mm">
+    <XiaoEsp32S3Dip name="U1" pcbX={0} pcbY={0} />
+
+    <led name="LED1" footprint="0805" pcbX={16} pcbY={4} color="red" />
+
+    <resistor name="R1" footprint="0805" resistance="330" pcbX={16} pcbY={-4} />
+
+    <trace from="U1.D0" to="R1.pin1" />
+    <trace from="R1.pin2" to="LED1.anode" />
+    <trace from="LED1.cathode" to="U1.GND" />
+  </board>
+);
+```
+
+### Button
+
+```tsx
+import { XiaoEsp32C3Dip } from "@vinjocarsales/xiao-series";
+
+export default () => (
+  <board width="50mm" height="35mm">
+    <XiaoEsp32C3Dip name="U1" pcbX={-6} pcbY={0} />
+
+    <pushbutton
+      name="SW1"
+      footprint="pushbutton_id1.3mm_od2mm"
+      pcbX={17}
+      pcbY={0}
+    />
+
+    <trace from="U1.D2" to="SW1.pin1" />
+    <trace from="SW1.pin2" to="U1.GND" />
+  </board>
+);
+```
+
+### C3 3D Example
+
+```tsx
+import { XiaoEsp32C3Dip } from "@vinjocarsales/xiao-series";
+
+export default () => (
+  <board width="50mm" height="35mm">
+    <XiaoEsp32C3Dip name="U1" pcbX={-6} pcbY={0} />
+
+    <led name="LED1" footprint="0805" pcbX={16} pcbY={4} color="green" />
+
+    <resistor name="R1" footprint="0805" resistance="330" pcbX={16} pcbY={-4} />
+
+    <trace from="U1.D0" to="R1.pin1" />
+    <trace from="R1.pin2" to="LED1.anode" />
+    <trace from="LED1.cathode" to="U1.GND" />
+  </board>
+);
+```
+
+### Flashlight
+
+```tsx
+import { XiaoEsp32S3Smd } from "@vinjocarsales/xiao-series";
+
+export default () => (
+  <board width="55mm" height="32mm">
+    <XiaoEsp32S3Smd name="U1" pcbX={-10} pcbY={0} />
+
+    <led name="LED1" footprint="0805" pcbX={18} pcbY={3} color="white" />
+
+    <resistor name="R1" footprint="0805" resistance="150" pcbX={18} pcbY={-4} />
+
+    <trace from="U1.D10" to="R1.pin1" />
+    <trace from="R1.pin2" to="LED1.anode" />
+    <trace from="LED1.cathode" to="U1.GND" />
+  </board>
+);
+```

package/assets/MODULE_XIAO_ESP32C3.kicad_mod

@@ -0,0 +1,43 @@
+
+(footprint MODULE_XIAO_ESP32C3 (layer F.Cu) (tedit 6A2F9006)
+  (descr "")
+  (fp_text reference REF** (at -5.715 -13.135 0) (layer F.SilkS)
+    (effects (font (size 1.0 1.0) (thickness 0.15)))
+  )
+  (fp_text value MODULE_XIAO_ESP32C3 (at 3.175 11.615 0) (layer F.Fab)
+    (effects (font (size 1.0 1.0) (thickness 0.15)))
+  )
+  (pad 11 thru_hole circle (at 7.62 0.0635) (size 1.358 1.358) (drill 0.85) (layers *.Cu *.Mask) (solder_mask_margin 0.102))
+  (pad 10 thru_hole circle (at 7.62 2.6035) (size 1.358 1.358) (drill 0.85) (layers *.Cu *.Mask) (solder_mask_margin 0.102))
+  (pad 9 thru_hole circle (at 7.62 5.1435) (size 1.358 1.358) (drill 0.85) (layers *.Cu *.Mask) (solder_mask_margin 0.102))
+  (pad 8 thru_hole circle (at 7.62 7.6835) (size 1.358 1.358) (drill 0.85) (layers *.Cu *.Mask) (solder_mask_margin 0.102))
+  (pad 12 thru_hole circle (at 7.62 -2.4765) (size 1.358 1.358) (drill 0.85) (layers *.Cu *.Mask) (solder_mask_margin 0.102))
+  (pad 13 thru_hole circle (at 7.62 -5.0165) (size 1.358 1.358) (drill 0.85) (layers *.Cu *.Mask) (solder_mask_margin 0.102))
+  (pad 14 thru_hole circle (at 7.62 -7.5565) (size 1.358 1.358) (drill 0.85) (layers *.Cu *.Mask) (solder_mask_margin 0.102))
+  (pad 4 thru_hole circle (at -7.62 0.0635) (size 1.358 1.358) (drill 0.85) (layers *.Cu *.Mask) (solder_mask_margin 0.102))
+  (pad 5 thru_hole circle (at -7.62 2.6035) (size 1.358 1.358) (drill 0.85) (layers *.Cu *.Mask) (solder_mask_margin 0.102))
+  (pad 6 thru_hole circle (at -7.62 5.1435) (size 1.358 1.358) (drill 0.85) (layers *.Cu *.Mask) (solder_mask_margin 0.102))
+  (pad 7 thru_hole circle (at -7.62 7.6835) (size 1.358 1.358) (drill 0.85) (layers *.Cu *.Mask) (solder_mask_margin 0.102))
+  (pad 3 thru_hole circle (at -7.62 -2.4765) (size 1.358 1.358) (drill 0.85) (layers *.Cu *.Mask) (solder_mask_margin 0.102))
+  (pad 2 thru_hole circle (at -7.62 -5.0165) (size 1.358 1.358) (drill 0.85) (layers *.Cu *.Mask) (solder_mask_margin 0.102))
+  (pad 1 thru_hole rect (at -7.62 -7.5565) (size 1.358 1.358) (drill 0.85) (layers *.Cu *.Mask) (solder_mask_margin 0.102))
+  (fp_line (start 8.89 -10.4775) (end 8.89 10.4775) (layer F.SilkS) (width 0.127))
+  (fp_line (start -8.89 10.4775) (end -8.89 -10.4775) (layer F.SilkS) (width 0.127))
+  (fp_line (start -8.89 -10.4775) (end 8.89 -10.4775) (layer F.SilkS) (width 0.127))
+  (fp_line (start 8.89 10.4775) (end -8.89 10.4775) (layer F.SilkS) (width 0.127))
+  (fp_line (start 9.14 -12.2375) (end -9.14 -12.2375) (layer F.CrtYd) (width 0.05))
+  (fp_line (start -9.14 -12.2375) (end -9.14 10.7275) (layer F.CrtYd) (width 0.05))
+  (fp_line (start -9.14 10.7275) (end 9.14 10.7275) (layer F.CrtYd) (width 0.05))
+  (fp_line (start 9.14 10.7275) (end 9.14 -12.2375) (layer F.CrtYd) (width 0.05))
+  (fp_circle (center -9.5 -7.6835) (end -9.4 -7.6835) (layer F.SilkS) (width 0.2))
+  (fp_circle (center -9.5 -7.6835) (end -9.4 -7.6835) (layer F.Fab) (width 0.2))
+  (fp_line (start 8.89 -10.4775) (end 8.89 10.4775) (layer F.Fab) (width 0.127))
+  (fp_line (start -8.89 10.4775) (end -8.89 -10.4775) (layer F.Fab) (width 0.127))
+  (fp_line (start -8.89 -10.4775) (end -4.5 -10.4775) (layer F.Fab) (width 0.127))
+  (fp_line (start -4.5 -10.4775) (end 4.5 -10.4775) (layer F.Fab) (width 0.127))
+  (fp_line (start 4.5 -10.4775) (end 8.89 -10.4775) (layer F.Fab) (width 0.127))
+  (fp_line (start 8.89 10.4775) (end -8.89 10.4775) (layer F.Fab) (width 0.127))
+  (fp_line (start -4.5 -10.4775) (end -4.5 -11.9875) (layer F.Fab) (width 0.127))
+  (fp_line (start -4.5 -11.9875) (end 4.5 -11.9875) (layer F.Fab) (width 0.127))
+  (fp_line (start 4.5 -11.9875) (end 4.5 -10.4775) (layer F.Fab) (width 0.127))
+)

package/assets/XIAO_ESP32C3.kicad_sym

@@ -0,0 +1,170 @@
+
+(kicad_symbol_lib (version 20211014) (generator kicad_symbol_editor)
+  (symbol "XIAO_ESP32C3" (pin_names (offset 1.016)) (in_bom yes) (on_board yes)
+    (property "Reference" "U" (id 0) (at -12.7 16.002 0)
+      (effects (font (size 1.27 1.27)) (justify bottom left))
+    )
+    (property "Value" "XIAO_ESP32C3" (id 1) (at -12.7 -17.78 0)
+      (effects (font (size 1.27 1.27)) (justify bottom left))
+    )
+    (property "Footprint" "XIAO_ESP32C3:MODULE_XIAO_ESP32C3" (id 2) (at 0 0 0)
+      (effects (font (size 1.27 1.27)) (justify bottom) hide)
+    )
+    (property "MF" "Seeed Studio" (id 4) (at 0 0 0)
+      (effects (font (size 1.27 1.27)) (justify bottom) hide)
+    )
+    (property "MAXIMUM_PACKAGE_HEIGHT" "N/A" (id 5) (at 0 0 0)
+      (effects (font (size 1.27 1.27)) (justify bottom) hide)
+    )
+    (property "Package" "None" (id 6) (at 0 0 0)
+      (effects (font (size 1.27 1.27)) (justify bottom) hide)
+    )
+    (property "Price" "None" (id 7) (at 0 0 0)
+      (effects (font (size 1.27 1.27)) (justify bottom) hide)
+    )
+    (property "Check_prices" "https://www.snapeda.com/parts/XIAO%20ESP32C3/Seeed+Studio/view-part/?ref=eda" (id 8) (at 0 0 0)
+      (effects (font (size 1.27 1.27)) (justify bottom) hide)
+    )
+    (property "STANDARD" "Manufacturer Recommendations" (id 9) (at 0 0 0)
+      (effects (font (size 1.27 1.27)) (justify bottom) hide)
+    )
+    (property "PARTREV" "23/05/2022" (id 10) (at 0 0 0)
+      (effects (font (size 1.27 1.27)) (justify bottom) hide)
+    )
+    (property "SnapEDA_Link" "https://www.snapeda.com/parts/XIAO%20ESP32C3/Seeed+Studio/view-part/?ref=snap" (id 11) (at 0 0 0)
+      (effects (font (size 1.27 1.27)) (justify bottom) hide)
+    )
+    (property "MP" "XIAO ESP32C3" (id 12) (at 0 0 0)
+      (effects (font (size 1.27 1.27)) (justify bottom) hide)
+    )
+    (property "Description" "\n                        \n                            Dev.kit: evaluation; u.FL antenna,prototype board; XIAO; PIN: 2x7\n                        \n" (id 13) (at 0 0 0)
+      (effects (font (size 1.27 1.27)) (justify bottom) hide)
+    )
+    (property "MANUFACTURER" "Seeed Technology" (id 14) (at 0 0 0)
+      (effects (font (size 1.27 1.27)) (justify bottom) hide)
+    )
+    (property "Availability" "In Stock" (id 15) (at 0 0 0)
+      (effects (font (size 1.27 1.27)) (justify bottom) hide)
+    )
+    (property "SNAPEDA_PN" "113991054" (id 16) (at 0 0 0)
+      (effects (font (size 1.27 1.27)) (justify bottom) hide)
+    )
+    (symbol "XIAO_ESP32C3_0_0"
+      (rectangle (start -12.7 -15.24) (end 12.7 15.24)
+        (stroke (width 0.254)) (fill (type background))
+      )
+      (pin power_in line (at 17.78 10.16 180.0) (length 5.08)
+        (name "VUSB"
+          (effects (font (size 1.016 1.016)))
+        )
+        (number "14"
+          (effects (font (size 1.016 1.016)))
+        )
+      )
+      (pin power_in line (at 17.78 12.7 180.0) (length 5.08)
+        (name "VCC_3V3"
+          (effects (font (size 1.016 1.016)))
+        )
+        (number "12"
+          (effects (font (size 1.016 1.016)))
+        )
+      )
+      (pin power_in line (at 17.78 -12.7 180.0) (length 5.08)
+        (name "GND"
+          (effects (font (size 1.016 1.016)))
+        )
+        (number "13"
+          (effects (font (size 1.016 1.016)))
+        )
+      )
+      (pin bidirectional line (at -17.78 5.08 0) (length 5.08)
+        (name "D0"
+          (effects (font (size 1.016 1.016)))
+        )
+        (number "1"
+          (effects (font (size 1.016 1.016)))
+        )
+      )
+      (pin bidirectional line (at -17.78 2.54 0) (length 5.08)
+        (name "D1"
+          (effects (font (size 1.016 1.016)))
+        )
+        (number "2"
+          (effects (font (size 1.016 1.016)))
+        )
+      )
+      (pin bidirectional line (at -17.78 0.0 0) (length 5.08)
+        (name "D2"
+          (effects (font (size 1.016 1.016)))
+        )
+        (number "3"
+          (effects (font (size 1.016 1.016)))
+        )
+      )
+      (pin bidirectional line (at -17.78 -2.54 0) (length 5.08)
+        (name "D3"
+          (effects (font (size 1.016 1.016)))
+        )
+        (number "4"
+          (effects (font (size 1.016 1.016)))
+        )
+      )
+      (pin bidirectional line (at -17.78 -5.08 0) (length 5.08)
+        (name "D4"
+          (effects (font (size 1.016 1.016)))
+        )
+        (number "5"
+          (effects (font (size 1.016 1.016)))
+        )
+      )
+      (pin bidirectional line (at -17.78 -7.62 0) (length 5.08)
+        (name "D5"
+          (effects (font (size 1.016 1.016)))
+        )
+        (number "6"
+          (effects (font (size 1.016 1.016)))
+        )
+      )
+      (pin bidirectional line (at 17.78 5.08 180.0) (length 5.08)
+        (name "TX_D6"
+          (effects (font (size 1.016 1.016)))
+        )
+        (number "7"
+          (effects (font (size 1.016 1.016)))
+        )
+      )
+      (pin bidirectional line (at 17.78 2.54 180.0) (length 5.08)
+        (name "RX_D7"
+          (effects (font (size 1.016 1.016)))
+        )
+        (number "8"
+          (effects (font (size 1.016 1.016)))
+        )
+      )
+      (pin bidirectional line (at 17.78 0.0 180.0) (length 5.08)
+        (name "D8"
+          (effects (font (size 1.016 1.016)))
+        )
+        (number "9"
+          (effects (font (size 1.016 1.016)))
+        )
+      )
+      (pin bidirectional line (at 17.78 -2.54 180.0) (length 5.08)
+        (name "D9"
+          (effects (font (size 1.016 1.016)))
+        )
+        (number "10"
+          (effects (font (size 1.016 1.016)))
+        )
+      )
+      (pin bidirectional line (at 17.78 -5.08 180.0) (length 5.08)
+        (name "D10"
+          (effects (font (size 1.016 1.016)))
+        )
+        (number "11"
+          (effects (font (size 1.016 1.016)))
+        )
+      )
+    )
+  )
+)