Skip to content

feat: add USB Power Delivery Trigger HAT tutorial#708

Open
Ojas2095 wants to merge 1 commit into
tscircuit:mainfrom
Ojas2095:feat/add-usb-pd-trigger-hat-tutorial
Open

feat: add USB Power Delivery Trigger HAT tutorial#708
Ojas2095 wants to merge 1 commit into
tscircuit:mainfrom
Ojas2095:feat/add-usb-pd-trigger-hat-tutorial

Conversation

@Ojas2095

@Ojas2095 Ojas2095 commented Jun 5, 2026

Copy link
Copy Markdown

/claim #601

Summary

Adds a comprehensive tutorial for building a USB Power Delivery Trigger HAT for Raspberry Pi using the CH224K PD controller.

What's included

  • Step-by-step circuit design with interactive \CircuitPreview\ and \TscircuitIframe\ components
  • USB PD protocol explanation — voltage negotiation profiles (5V-20V)
  • CH224K configuration — resistor strapping table for all voltage options
  • Input/output filtering — proper capacitor sizing and placement
  • Status LED — visual power indicator circuit
  • Complete Bill of Materials with component values and packages
  • Python monitoring script — detect USB PD power presence via GPIO
  • Safety considerations — high-power design guidelines
  • PCB layout — component placement with interactive viewer

Format

Follows the exact same pattern as the existing Buzzer HAT tutorial:

  • MDX with frontmatter
  • \TscircuitIframe\ for the full 3D preview at top
  • \CircuitPreview\ for step-by-step schematic builds
  • Component explanation sections
  • Python code for Raspberry Pi control
  • BOM table and ordering guide

Requirements from issue #601

  • USB PD controller (FP28XX/CH224K/PD2001) ✅ CH224K
  • Voltage negotiation (5V-20V) ✅ Full CFG table
  • Terminal block outputs ✅ TB1
  • Status LED ✅ LED1 + R1
  • Filtering capacitors ✅ C1, C2, C3
  • Step-by-step circuit design ✅ 5 steps
  • Schematic and 3D previews ✅ Interactive
  • Bill of materials ✅ Full BOM table
  • Testing procedures ✅ Python script
  • Example code ✅ GPIO monitoring

Add comprehensive tutorial for building a USB PD Trigger HAT using
the CH224K controller. Includes:

- Step-by-step circuit design with interactive previews
- USB PD protocol explanation and voltage negotiation
- CH224K configuration via resistor strapping (5V-20V)
- Input/output filtering with capacitor sizing
- Status LED indicator circuit
- Complete bill of materials
- Python monitoring script
- Safety considerations for high-power USB PD
- PCB layout with component placement guide

Closes tscircuit#601
@vercel

vercel Bot commented Jun 5, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment Jun 5, 2026 9:36am

Request Review

@github-actions

github-actions Bot commented Jun 8, 2026

Copy link
Copy Markdown

This PR has been automatically marked as stale because it has had no recent activity. It will be closed if no further activity occurs.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant