Project Architecture Overview

flux

1:57

General
Project
Knowledge Base

Explaining project components.

Crafting hardware queries.

Linking components in design.

Linking component details.

Defining design intents.

Using Knowledge Base Tool.

Ensuring output compliance.

Here’s a concise, system-level explanation of your Pico Macro Keyboard project: what it is, how it’s built, and how the pieces work together, with design choices, trade-offs, and improvement ideas.
Purpose and overview
  • Goal: A compact, programmable macro pad using Raspberry Pi’s latest MCU, with per-key RGB lighting and two rotary encoders for rich input, powered and connected via USB-C.
  • High level: U1 is the brain. A USB-C connector J1 provides VBUS and data. A buck regulator U2 generates the 3.3 V logic rail. External QSPI flash U3 stores firmware. Per-key RGB is an addressable LED chain (e.g., U4). The key switches (e.g., SW2) form a diode-isolated matrix (e.g., D2). Rotary encoders are SW14 and SW15. Support pieces include a crystal Y1, external inductor for MCU’s internal DC/DC L1, programming header PROG, a status LED LED1, a potentiometer RV1, a power-path MOSFET Q1, and a power-stage inductor L2. A Schottky D1 sits on VBUS power.
Core components and interactions
  • USB-C and power-in: J1 brings in 5 V (VBUS) and USB D+/D−. D1 (Schottky) provides reverse protection/path isolation for the LED rail and the main regulator input.
  • 3.3 V logic rail: U2 is a step-down regulator feeding +3V3. It powers U1, QSPI flash U3, encoder switches, and logic for the keyboard matrix.
  • MCU and timing: U1 handles USB, scans the key matrix, reads encoders, and drives the RGB LED chain. Y1 provides a stable clock; L1 and nearby capacitors close the loop for the MCU’s internal regulator (tight placement and return paths matter).
  • Storage: U3 is on the QSPI bus for code and assets; signals (SCLK, IO0–IO3, CS) are short and matched enough for reliable high-speed boots.
  • RGB lighting: Addressable LEDs (example U4) are daisy-chained via DI/DO. One MCU GPIO drives WS2812_DATA into the first LED; each LED regenerates data for the next.
  • Key matrix: Keys (example SW2) are arranged in rows/columns with steering diodes (example D2) to prevent ghosting. The MCU sequentially drives columns and reads rows (or vice versa).
  • Rotary encoders: SW14 and SW15 provide quadrature A/B signals and push switches to GPIOs. Pull-ups/filters ensure clean edges.
  • Extras: PROG breaks out SWD for debug; LED1 is a status LED on an MCU GPIO; RV1 provides an analog control (e.g., brightness/speed). Q1 is used in the power path for gating/measurement.
Design breakdown, choices, and trade-offs
  • USB-C device port: Simple and compact. Trade-off: needs correct CC termination and robust ESD; the baseline connector alone doesn’t provide that.
  • Schottky vs ideal diode: D1 is simple and fast. Trade-off: forward drop causes heat and lowers LED headroom. An ideal diode controller would cut losses but adds cost/complexity.
  • External buck for 3.3 V (U2): Efficient for LED-heavy loads compared to an LDO. Trade-off: EMI and layout sensitivity; requires careful L2/diode/cap placement and return control.
  • WS2812 chain: Very flexible lighting with minimal GPIO use. Trade-offs: tight timing (precise bitstream), step current on VDD, and sensitive to ground bounce and data ringing.
  • Diode-matrix keyboard: Fewer GPIOs, scalable. Trade-offs: requires steering diodes per key, careful scanning firmware, and debouncing.
  • Rotary encoders: Intuitive input with detents. Trade-offs: mechanical bounce; need pull-ups and stable thresholds; EMC on long runs.
  • RP-series QSPI boot: High-speed boot and large code space. Trade-off: signal integrity on QSPI traces and decoupling quality directly impact reliability.
  • Internal MCU DC/DC (L1): Better efficiency than pure LDO core. Trade-off: tight placement constraints around the MCU for low noise.
Key technologies and dependencies
  • USB Full-Speed device on U1 via J1.
  • QSPI external flash U3 for firmware and assets.
  • WS2812-compatible RGBs (e.g., U4) daisy chain with one data pin.
  • Buck conversion (U2, L2) for logic power; Schottky D1 for reverse/OR’ing.
  • Mechanical matrix switches (e.g., SW2) with steering diodes (e.g., D2).
  • Rotary encoders SW14, SW15.
  • Timing with Y1; internal regulator loop with L1.
Performance and implementation considerations
  • WS2812 power integrity (Flux KB): Avoid “current limit” resistors in WS2812 power paths; use a low-RDS(on) MOSFET to gate the 5 V LED rail to reduce idle draw; for longer chains, inject power at multiple points (start/middle/end). A fast Schottky in series with 5 V helps protect against reverse connection.
  • USB protection (Flux KB): Add bidirectional TVS on D+/D− with capacitance below 1 pF per line to preserve signal quality.
  • Encoder signal quality (Flux KB): Provide pull-ups, RC debouncing, and consider Schmitt-trigger cleanup for clean quadrature edges; keep decoupling close on the MCU rail.
  • Buck/inductor layout: Keep the hot loop (switch pin, L2, diode/caps) tiny with a solid ground reference. Place bulk caps at the LED rail entry to handle transient current.
  • QSPI and clocking: Keep QSPI traces short, length- and skew-aware; route clock away from noisy switch nodes. Place Y1 and its load parts tight to U1.
  • Matrix scanning: Choose a scan rate that balances responsiveness with CPU time and EMI. Diode orientation must be consistent to avoid ghosting.
  • Thermal: The Schottky drop across D1 and LED current can add measurable dissipation; check derating for LED current and diode thermal resistance.
Potential challenges
  • Data integrity on WS2812: Ground bounce and ringing can corrupt the bitstream. Pay attention to ground return and optionally add a small series resistor near the MCU on WS2812_DATA to damp edges.
  • EMI from switching rails: Both U2 and the MCU’s internal regulator loop (L1) can inject noise; prioritize loop area and ground pour continuity.
  • USB-C correctness: Ensure proper CC termination for device mode and robust ESD protection; otherwise enumeration and protection can be unreliable.
  • Keyboard feel and ESD: Long runs to switches and encoders can pick up ESD/EMI; consider shielded return paths and local TVS on exposed connectors if needed.
Real-world applications
  • Productivity macro pad for design tools, DAW control, streaming, and gaming.
  • RGB/encoder-driven interfaces like scene selection, timeline scrubbing, zoom, brush size, etc.
  • Educational platform for USB HID, LED timing, matrix scanning, and encoder decoding.
Targeted improvements and future enhancements
  • WS2812 rail control (Flux KB): Add a dedicated low-RDS(on) P-channel or load switch to gate the LED VDD for true idle-off and thermal relief.
  • USB-C robustness: Add CC resistors for device identification and a low-capacitance, bidirectional ESD array (<1 pF per line) on D+/D−; consider a shield-to-chassis strategy for connector ESD.
  • Matrix diodes: Replace general-purpose diodes (e.g., D2) with small-signal, fast diodes (e.g., 1N4148 class) to reduce capacitance, improve scanning speed, and save space.
  • LED power integrity: Add bulk capacitance at the start of the LED chain and evaluate multi-point injection if you expand LED count (Flux KB: inject at start/middle/end for long chains).
  • Data-line conditioning: Add an optional 33–300 ohm series resistor at the MCU end of WS2812_DATA to reduce overshoot/ringing on fast edges.
  • Firmware resilience: Implement key debouncing with per-row timing, encoder state machines with hysteresis, and brown-out safe LED updates. Consider a bootloader with field firmware update from QSPI.
  • Manufacturability: Check DRC clearances around hot loops, place thermal relief where needed, and verify part availability for switches/encoders/LEDs.
If you want, I can review specific subsystems (USB-C, LED power, matrix, QSPI) in detail or help apply these improvements directly in the project.
Review USB-C protections
Plan LED power gating
Size LED power budget
Encoder debounce options
Check USB-C CC setup
10 days

Ready.

Sign up to send
please explain what U3 does.
Someone is typing...
please explain what R10 does.
Someone is typing...
20
what is this?
Someone is typing...
3
please explain what C7 does.
Someone is typing...
21
explain this project.
Someone is typing...
5
create a high level mermaid block diagram of this project. Include key component...
Someone is typing...
5
please explain what D1 does.
Someone is typing...
8
please explain what GPIO29\_ADC3, +3V3, Q1, C21, R16, VSYS, R15, R17 do.
Someone is typing...
19
I'm not currently able to talk here. Please message me in the Copilot Tab on the...
Someone is typing...
23
please explain what Q1 does.
Someone is typing...
13
explain this project.
Someone is typing...
15
explain this project.
Someone is typing...
7
explain this project.
Someone is typing...
6
explain this project.
Someone is typing...
14
please explain what U3 does.
Someone is typing...
10
please explain what Q1 does.
Someone is typing...
16
explain this project.
Someone is typing...
12
create a high level mermaid block diagram of this project. Include key component...
Someone is typing...
18
  • Ground
    Ground
    A common return path for electric current. Commonly known as ground.
    jharwinbarrozo
    20.5M
  • Net Portal
    Net Portal
    Wirelessly connects nets on schematic. Used to organize schematics and separate functional blocks. To wirelessly connect net portals, give them same designator. #portal
    jharwinbarrozo
    43.0M
  • Power Net Portal
    Power Net Portal
    Wirelessly connects power nets on schematic. Identical to the net portal, but with a power symbol. Used to organize schematics and separate functional blocks. To wirelessly connect power net portals, give them the same designator. #portal #power
    jharwinbarrozo
    11.4M
  • Generic Resistor
    Generic Resistor
    A generic fixed resistor for rapid developing circuit topology. Save precious design time by seamlessly add more information to this part (value, footprint, etc.) as it becomes available. Standard resistor values: 1.0Ω 10Ω 100Ω 1.0kΩ 10kΩ 100kΩ 1.0MΩ 1.1Ω 11Ω 110Ω 1.1kΩ 11kΩ 110kΩ 1.1MΩ 1.2Ω 12Ω 120Ω 1.2kΩ 12kΩ 120kΩ 1.2MΩ 1.3Ω 13Ω 130Ω 1.3kΩ 13kΩ 130kΩ 1.3MΩ 1.5Ω 15Ω 150Ω 1.5kΩ 15kΩ 150kΩ 1.5MΩ 1.6Ω 16Ω 160Ω 1.6kΩ 16kΩ 160kΩ 1.6MΩ 1.8Ω 18Ω 180Ω 1.8KΩ 18kΩ 180kΩ 1.8MΩ 2.0Ω 20Ω 200Ω 2.0kΩ 20kΩ 200kΩ 2.0MΩ 2.2Ω 22Ω 220Ω 2.2kΩ 22kΩ 220kΩ 2.2MΩ 2.4Ω 24Ω 240Ω 2.4kΩ 24kΩ 240kΩ 2.4MΩ 2.7Ω 27Ω 270Ω 2.7kΩ 27kΩ 270kΩ 2.7MΩ 3.0Ω 30Ω 300Ω 3.0KΩ 30KΩ 300KΩ 3.0MΩ 3.3Ω 33Ω 330Ω 3.3kΩ 33kΩ 330kΩ 3.3MΩ 3.6Ω 36Ω 360Ω 3.6kΩ 36kΩ 360kΩ 3.6MΩ 3.9Ω 39Ω 390Ω 3.9kΩ 39kΩ 390kΩ 3.9MΩ 4.3Ω 43Ω 430Ω 4.3kΩ 43KΩ 430KΩ 4.3MΩ 4.7Ω 47Ω 470Ω 4.7kΩ 47kΩ 470kΩ 4.7MΩ 5.1Ω 51Ω 510Ω 5.1kΩ 51kΩ 510kΩ 5.1MΩ 5.6Ω 56Ω 560Ω 5.6kΩ 56kΩ 560kΩ 5.6MΩ 6.2Ω 62Ω 620Ω 6.2kΩ 62KΩ 620KΩ 6.2MΩ 6.8Ω 68Ω 680Ω 6.8kΩ 68kΩ 680kΩ 6.8MΩ 7.5Ω 75Ω 750Ω 7.5kΩ 75kΩ 750kΩ 7.5MΩ 8.2Ω 82Ω 820Ω 8.2kΩ 82kΩ 820kΩ 8.2MΩ 9.1Ω 91Ω 910Ω 9.1kΩ 91kΩ 910kΩ 9.1MΩ #generics #CommonPartsLibrary
    jharwinbarrozo
    1.5M
  • Generic Capacitor
    Generic Capacitor
    A generic fixed capacitor ideal for rapid circuit topology development. You can choose between polarized and non-polarized types, its symbol and the footprint will automatically adapt based on your selection. Supported options include standard SMD sizes for ceramic capacitors (e.g., 0402, 0603, 0805), SMD sizes for aluminum electrolytic capacitors, and through-hole footprints for polarized capacitors. Save precious design time by seamlessly add more information to this part (value, footprint, etc.) as it becomes available. Standard capacitor values: 1.0pF 10pF 100pF 1000pF 0.01uF 0.1uF 1.0uF 10uF 100uF 1000uF 10,000uF 1.1pF 11pF 110pF 1100pF 1.2pF 12pF 120pF 1200pF 1.3pF 13pF 130pF 1300pF 1.5pF 15pF 150pF 1500pF 0.015uF 0.15uF 1.5uF 15uF 150uF 1500uF 1.6pF 16pF 160pF 1600pF 1.8pF 18pF 180pF 1800pF 2.0pF 20pF 200pF 2000pF 2.2pF 22pF 20pF 2200pF 0.022uF 0.22uF 2.2uF 22uF 220uF 2200uF 2.4pF 24pF 240pF 2400pF 2.7pF 27pF 270pF 2700pF 3.0pF 30pF 300pF 3000pF 3.3pF 33pF 330pF 3300pF 0.033uF 0.33uF 3.3uF 33uF 330uF 3300uF 3.6pF 36pF 360pF 3600pF 3.9pF 39pF 390pF 3900pF 4.3pF 43pF 430pF 4300pF 4.7pF 47pF 470pF 4700pF 0.047uF 0.47uF 4.7uF 47uF 470uF 4700uF 5.1pF 51pF 510pF 5100pF 5.6pF 56pF 560pF 5600pF 6.2pF 62pF 620pF 6200pF 6.8pF 68pF 680pF 6800pF 0.068uF 0.68uF 6.8uF 68uF 680uF 6800uF 7.5pF 75pF 750pF 7500pF 8.2pF 82pF 820pF 8200pF 9.1pF 91pF 910pF 9100pF #generics #CommonPartsLibrary
    jharwinbarrozo
    1.5M
  • Generic Inductor
    Generic Inductor
    A generic fixed inductor for rapid developing circuit topology. *You can now change the footprint and 3D model at the top level anytime you want. This is the power of #generics
    jharwinbarrozo
    15.1k
  • Terminal
    Terminal
    An electrical connector acting as reusable interface to a conductor and creating a point where external circuits can be connected.
    natarius
  • RMCF0805JT47K0
    RMCF0805JT47K0
    47 kOhms ±5% 0.125W, 1/8W Chip Resistor 0805 (2012 Metric) Automotive AEC-Q200 Thick Film #forLedBlink
    jharwinbarrozo
    1.2M
  • 875105359001
    875105359001
    10uF Capacitor Aluminum Polymer 20% 16V SMD 5x5.3mm #forLedBlink #commonpartslibrary #capacitor #aluminumpolymer #radialcan
    jharwinbarrozo
    1.2M
  • CTL1206FYW1T
    CTL1206FYW1T
    Yellow 595nm LED Indication - Discrete 1.7V 1206 (3216 Metric) #forLedBlink
    jharwinbarrozo
    1.1M

Inspect

Pico Macro Keyboard

Pico Macro Keyboard
Description

Created
Last updated by jharwinbarrozo
2 Contributor(s)
jharwinbarrozo
brooks

Controls

Properties

Availability & Pricing

DistributorQty 1
Arrow$2.61
Digi-Key$9.30–$10.93
LCSC$8.46–$8.58
Mouser$9.53
Verical$8.04–$8.59

Assets