Skip to content

add LED and button wiring circuit diagram #111

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
TheTrainGoes merged 2 commits into from
Oct 29, 2025
Merged

add LED and button wiring circuit diagram #111

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
47fb9c3
add LED and button wiring circuit diagram
Oct 16, 2025
e01e820
split wiring schematics, improve wording
Oct 28, 2025
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
Binary file added docs/assets/wiring/Chained_button_schematic.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/assets/wiring/LEDs_schematic.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/assets/wiring/Separate_buttons_schematic.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
17 changes: 17 additions & 0 deletions docs/controller-build/wiring.mdx
View file
Open in desktop
Copy link
Contributor

@TheTrainGoes TheTrainGoes Oct 20, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would prefer that we breakout the LED and buttons section if we are going to add basic sections for them.

Copy link
Contributor Author

@Lycowolf Lycowolf Oct 28, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

done

Original file line number Diff line number Diff line change
Expand Up @@ -53,3 +53,20 @@ The Raspberry Pi Pico pinout can also be used on clone boards with the same form

![Adafruit KB2040 Pinout](../assets/wiring/SeeedXIAORP2040_Pinout.png)

# Buttons

GP2040-CE configures the input GPIO pins to be pulled up, expecting the button to short the pin to the ground when pressed.

You can either wire each button using two wires (one to the GPIO pin, the other to the ground):

![Buttons connected separately to GPIO and ground](../assets/wiring/Separate_buttons_schematic.png)

Or you can chain the groud wire from button to button, e. g. by crimping two wires at once to a FASTON terminal or by soldering two wires to a button pin. The other contact of each button must be connected to a separate GPIO pin:

![Buttons connected using chained ground wire](../assets/wiring/Chained_button_schematic.png)

# PWM LEDs

The PWM player LED pins are configured similarly: the pin is shorted to the ground when active and pulled up otherwise. This means the LED anodes must be connected to the +3.3V output of the microcontroller and each cathode to its GPIO pin, in an arrangement called common anode. A current-limiting resistor must be inserted into the circuit to protect the GPIO pins; use an online calculator to compute its value if unsure. The maximum safe current is cca 20mA.

![How to conect LEDs and buttons to the GPIO](../assets/wiring/LEDs_schematic.png)
4 changes: 4 additions & 0 deletions docs/web-configurator/menu-pages/02-gpio-pin-mapping.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -79,3 +79,7 @@ At this time, profiles are limited to changing GPIO pin assignment and cannot be
- Keyboard Host Button-to-Key mapping

:::

## Custom builds

How to wire buttons to GPIO pins is described in the [Wiring section](../../controller-build/wiring.mdx).
6 changes: 6 additions & 0 deletions docs/web-configurator/menu-pages/05-led-configuration.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -47,6 +47,12 @@ Available selections for `Player LED Type` are `None`, `PWM` or `RGB`.

### PWM Player LEDs

:::note

How to wire LEDs to GPIO pins is described in the [Wiring section](../../controller-build/wiring.mdx).

:::

![GP2040-CE Configurator - PWM Player LEDs](../../assets/images/gpc-pled-pwm.png)

- `PLED #[1-4] Pin` - The GPIO pin the standard LED is connected to.
Expand Down