Skip to content

document USB-C connector standard usage #21

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
MustafaMulla29 merged 2 commits into from
May 1, 2026
Merged

document USB-C connector standard usage #21

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
a0dc95a
document USB-C connector standard usage
MustafaMulla29 Apr 30, 2026
1d6f4bd
upd
MustafaMulla29 Apr 30, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 3 additions & 2 deletions CLI.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -41,8 +41,8 @@ tsci search --jlcpcb "ATmega328"
# Search JLCPCB by part number
tsci search --jlcpcb "C14877"

# Search for USB-C connectors on JLCPCB
tsci search --jlcpcb "USB-C 16pin"
Comment thread
MustafaMulla29 marked this conversation as resolved.
# Search JLCPCB for Micro-USB connectors
tsci search --jlcpcb "micro usb connector"

# Search KiCad footprints
tsci search --kicad "QFP-32"
Expand Down Expand Up @@ -88,6 +88,7 @@ tsci search --jlcpcb "ATmega328" --json
- Use when you need to bring a specific part into your project
- Searches both the tscircuit registry and JLCPCB parts database
- Opens an interactive picker to select and import the component
- For USB-C connectors, prefer `<connector standard="usb_c" />` directly instead of importing from JLCPCB

Workflow:
```bash
Expand Down
1 change: 1 addition & 0 deletions SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,7 @@ When this Skill is active:

3) Find and install components
- Use `tsci search "<query>"` to discover footprints and tscircuit registry packages.
- For USB-C receptacles/connectors, prefer builtin syntax with `<connector standard="usb_c" />` instead of importing from JLCPCB.
- Use one of:
- `tsci add <author/pkg>` for registry packages (installs `@tsci/*` packages)
- `tsci import <query>` when you need to import a component from JLCPCB or the registry.
Expand Down
8 changes: 8 additions & 0 deletions SYNTAX.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -123,6 +123,14 @@ Use `<connector />` for all USB connector footprints (USB-C, Micro-USB, Mini-USB

If a `<chip />` is currently modeling a USB receptacle, plug, or jack, consider refactoring it to `<connector />` so additional USB-specific DRC checks can apply.

For a USB-C connector component, prefer the built-in standard:

```tsx
<connector name="USBC" standard="usb_c" />
```

No JLC import is required for this default USB-C connector usage.

## 7) Connectivity with `<trace />`

Connect pins with port selectors:
Expand Down
1 change: 1 addition & 0 deletions WORKFLOW.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,7 @@

- Decide net names (`net.GND`, `net.VCC`, `net.V3_3`, etc.)
- Add power entry (USB-C, barrel jack, header) and protection (fuse/TVS) as appropriate.
- For USB-C, use `<connector standard="usb_c" />` directly (no JLC import needed).

## 3) Search before you model

Expand Down
10 changes: 10 additions & 0 deletions elements/connector.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -77,6 +77,16 @@ export default () => (
)
```

## USB-C standard example

```tsx
export default () => (
<board width="20mm" height="20mm">
<connector name="USBC" standard="usb_c" pcbX={0} pcbY={0} />
</board>
)
```

## Accessible orientation warning

Placement checks can warn when a connector faces away from the nearest board edge:
Expand Down