Add high-side-switch package and update .gitignore

Include the existing high-side-switch P-FET power switch package and add
layouts/ to .gitignore (auto-generated by atopile builds).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: napowderly

.gitignore

@@ -1,7 +1,4 @@
-# For PCBs designed using KiCad: https://www.kicad.org/
-# Format documentation: https://kicad.org/help/file-formats/
-
-# Temporary files
+# === KiCad ===
 *.000
 *.bak
 *.bck
@@ -17,34 +14,35 @@ _autosave-*
 *-save.kicad_pcb
 *.kicad_pcb.lck
 fp-info-cache
-
-# Netlist files (exported from Eeschema)
 *.net
-
-# Autorouter files (exported from Pcbnew)
 *.dsn
 *.ses
 
-# Exported BOM files
-*.xml
-*.csv
-
-build/
-.DS_Store
-
-# Virtual environment
-.venv/
-venv/
-
-# .ato directory
+# === atopile ===
 .ato/
+build/
+layouts/
 
-# IDEs
-.vscode/
-
+# === Zephyr / west ===
+firmware/build/
+firmware/card/build/
+firmware/card/twister-out*
+.west/
 
-# Python cache files
+# === Python ===
 __pycache__/
 *.pyc
 *.pyo
 *.pyd
+*.egg-info/
+dist/
+.venv/
+venv/
+
+# === OS ===
+.DS_Store
+Thumbs.db
+
+# === IDEs ===
+.vscode/
+.idea/

elec/packages/high-side-switch/ato.yaml

@@ -0,0 +1,13 @@
+requires-atopile: "^0.9.0"
+
+paths:
+    src: "."
+    layout: ./layouts
+
+builds:
+    default:
+        entry: high-side-switch.ato:HighSidePowerSwitch
+    example:
+        entry: high-side-switch.ato:Example
+
+dependencies: []

elec/packages/high-side-switch/high-side-switch.ato

@@ -0,0 +1,89 @@
+#pragma experiment("BRIDGE_CONNECT")
+
+# High-Side Power Switch
+# ======================
+# P-channel MOSFET with NPN gate driver for GPIO-controlled power switching.
+# Default state: OFF (gate pulled high via pull-up resistor).
+# Active-high enable: NPN pulls MOSFET gate low to turn on.
+#
+# Designed for 24V, 6A continuous (5.14A worst-case per slot).
+# P-FET: Si4435DDY or equivalent (-30V, -8.5A, Rds(on) 20mohm)
+# Power dissipation at 5A: I²R = 25 * 0.02 = 0.5W
+
+import Resistor
+import Capacitor
+
+# --- High-Side Power Switch Module ---
+
+module HighSidePowerSwitch:
+    "P-FET high-side switch with NPN gate driver. Active-high enable, default OFF."
+
+    # External interfaces
+    power_in = new ElectricPower      # 24V bus input
+    power_out = new ElectricPower     # Switched 24V output
+    enable = new ElectricLogic        # Active-high enable from GPIO expander
+
+    # --- P-Channel MOSFET (high-side switch) ---
+    # Source connected to power_in.hv (24V)
+    # Drain connected to power_out.hv (switched 24V)
+    # Gate controlled by NPN driver
+    #
+    # Gate-Source pull-up resistor (default OFF: gate pulled to source = VGS=0)
+    r_gs_pullup = new Resistor
+    r_gs_pullup.resistance = 10kohm +/- 5%
+    r_gs_pullup.package = "0402"
+
+    # --- NPN Gate Driver ---
+    # When enable is HIGH: NPN turns on, pulls MOSFET gate to GND -> VGS = -24V -> MOSFET ON
+    # When enable is LOW: NPN off, pull-up holds gate at source potential -> MOSFET OFF
+    #
+    # Base resistor (limits base current from 3.3V GPIO)
+    r_base = new Resistor
+    r_base.resistance = 10kohm +/- 5%
+    r_base.package = "0402"
+
+    # Base-emitter pull-down (ensures NPN stays off when GPIO is floating)
+    r_be_pulldown = new Resistor
+    r_be_pulldown.resistance = 100kohm +/- 5%
+    r_be_pulldown.package = "0402"
+
+    # Gate resistor (limits inrush current to gate capacitance, provides soft-start)
+    r_gate = new Resistor
+    r_gate.resistance = 100ohm +/- 5%
+    r_gate.package = "0402"
+
+    # Shared ground between input and output
+    power_in.lv ~ power_out.lv
+
+    # --- Connections ---
+    # P-FET gate-source pull-up: gate to source (power_in.hv)
+    # NPN collector to gate via gate resistor
+    # NPN base from enable via base resistor
+    # NPN emitter to GND
+    #
+    # NOTE: The P-FET and NPN transistor are discrete components that need
+    # explicit part selection. The connectivity is:
+    #   power_in.hv ---- r_gs_pullup ---- GATE ---- r_gate ---- NPN_collector
+    #                |                                           NPN_emitter ---- GND
+    #                |--- P-FET source                           NPN_base ---- r_base ---- enable.line
+    #                                                            NPN_base ---- r_be_pulldown ---- GND
+    #   power_out.hv --- P-FET drain
+    #
+    # TODO: Add P-FET and NPN component definitions when JLCPCB parts are selected
+    # P-FET: Si4435DDY (-30V, -8.5A, Rds(on) 20mohm, SOT-23/SO-8)
+    # NPN: 2N3904 or MMBT3904 (SOT-23)
+
+
+# --- Example Usage ---
+
+module Example:
+    "Example: High-side switch on a 24V bus controlled by a GPIO"
+
+    power_24v = new ElectricPower
+    power_24v_switched = new ElectricPower
+    enable = new ElectricLogic
+
+    sw = new HighSidePowerSwitch
+    sw.power_in ~ power_24v
+    sw.power_out ~ power_24v_switched
+    sw.enable ~ enable

elec/packages/high-side-switch/parts/UNI_ROYAL_0402WGF1000TCE/0402WGF1000TCE.kicad_sym

@@ -0,0 +1,103 @@
+(kicad_symbol_lib
+	(version 20241229)
+	(generator "faebryk_convert")
+	(symbol "0402WGF1000TCE"
+		(property "Reference" "R"
+			(id 0)
+			(at 0 5.08 0)
+			(effects
+				(font
+					(size 1.27 1.27)
+				)
+			)
+		)
+		(property "Value" "0402WGF1000TCE"
+			(id 1)
+			(at 0 -5.08 0)
+			(effects
+				(font
+					(size 1.27 1.27)
+				)
+			)
+		)
+		(property "Footprint" "C25076:R0402"
+			(id 2)
+			(at 0 -7.62 0)
+			(effects
+				(font
+					(size 1.27 1.27)
+				)
+			)
+		)
+		(property "Datasheet" "https://lcsc.com/product-detail/Chip-Resistor-Surface-Mount-UniOhm_100R-1000-1_C25076.html"
+			(id 3)
+			(at 0 -10.16 0)
+			(effects
+				(font
+					(size 1.27 1.27)
+				)
+			)
+		)
+		(property "LCSC Part" "C25076"
+			(id 5)
+			(at 0 -12.7 0)
+			(effects
+				(font
+					(size 1.27 1.27)
+				)
+			)
+		)
+		(in_bom yes)
+		(on_board yes)
+		(symbol "0402WGF1000TCE_0_1"
+			(rectangle
+				(start -2.54 1.02)
+				(end 2.54 -1.02)
+				(stroke
+					(width 0)
+					(type default)
+					(color 0 0 0 0)
+				)
+				(fill
+					(type background)
+				)
+			)
+			(pin input line
+				(at 5.08 -0 180)
+				(length 2.54)
+				(name "2"
+					(effects
+						(font
+							(size 1.27 1.27)
+						)
+					)
+				)
+				(number "2"
+					(effects
+						(font
+							(size 1.27 1.27)
+						)
+					)
+				)
+			)
+			(pin input line
+				(at -5.08 -0 0)
+				(length 2.54)
+				(name "1"
+					(effects
+						(font
+							(size 1.27 1.27)
+						)
+					)
+				)
+				(number "1"
+					(effects
+						(font
+							(size 1.27 1.27)
+						)
+					)
+				)
+			)
+		)
+	)
+)