Button-bolt-on

Introduction

The Button Bolt-on for the ESP32-X2 development board features a TS-1002S-04326C tactile switch and WS2812B 2020 RGB LEDs. The TS-1002S-04326C is a compact, low-profile push button from XUNPU, designed for reliable on/off operation in space-constrained applications. Its 6x6 mm size and 4.3 mm actuator height make it easy to use while minimizing accidental activations. This switch is widely used in consumer electronics and industrial control panels.The WS2812B 2020 RGB LED, known for its minimal 2x2 mm size, offers individually addressable lighting with vibrant colors, operated with a 5V power supply. It is perfect for space-sensitive applications like wearables and mobile devices.Each tactile switch on the Button Bolt-on board is paired with two WS2812B 2020 RGB LEDs, providing a total of four switches and eight LEDs. This combination enhances the interactivity and visual feedback for user inputs.

Features

Following are the features of 2 main components TS-1002S-04326C and WS2812 (2020 package) that are used in the Button bolt-on board.<be>

TS-1002S-04326C (Tactile Switch):

Compact design with 6x6 mm square footprint
Actuator height of 4.3 mm for easy pressing
Rated for reliable on/off tactile feedback in electronic circuits
Mechanical lifespan suitable for frequent-use applications
SPST (Single Pole, Single Throw) contact configuration
Compatible with through-hole mounting for secure placement on PCBs
Ideal for consumer electronics, control panels, and portable devices

WS2812 (2020 package):

Ultra-compact 2x2 mm package for space-sensitive applications
Individually addressable RGB LED with built-in driver IC
800 kHz data transmission rate for seamless color control
24-bit color depth (8-bit per channel), supporting 16 million colors
Operates on a 5V power supply
Single-wire data communication protocol, simplifying wiring
Daisy-chainable for easy multi-LED control with a single data line
High brightness and adjustable color intensity for vivid lighting effects
Low power consumption with idle current < 1 mA per LED
Suitable for wearables, mobile devices, and compact LED matrices

Getting Started

Components

The Assembly of the bolt-on board includes the following components:

8x RGB LED WS2812 (2020 Package)
4x Tactile Switch TS-1002S-04326C
Printed Circuit Board with LED and tactile switch

Hardware Connection

The assembly requires 2 x 20-pin headers to be soldered onto the PCB, providing the necessary connections.

These headers are available separately from a variety of sources (male/female) Amazon | Ebay

Hardware, Pin Description, Connections

WS2812 RGB LED Hardware

The hardware of the WS2812 LED module is as follows:

WS2812 RGB LED Pin Description

Pin Description of the WS2812B LED with 2020 package is as follows:

**WS2812 RGB LED Pin Description**
Symbol	Description
DO	Data Output (DOUT): Outputs the control data signal to the next device in the chain. Used for cascading multiple modules or LEDs to create a series connection. Connect to the DI of the next module in a daisy-chain setup.
GND	Ground: Connect to the ground (0V) of the power supply. Ensures stable operation by providing a common reference point for the circuit.
DIN	Data Input (DIN): Receives the control data signal from the microcontroller or the previous device in the chain. Used for controlling the LED or module by sending data signals through this input pin.
VDD	Power Supply: Connect to a 5V DC power source to power the module. Ensure a stable and sufficient power source to support the device’s operation.

Tactile switch Hardware

The hardware of the TS-1002S-04326C module is as follows:

Tactile switch Pin Description

The pin description of the TS-1002S-04326C can be found in the sheet with the mechanical drawing. TS-1002S-04326C Datasheet

Connections

Connection details of the button bolt-on board are as follows.

Button bolt-on Connections
SV1 Pins	ESP32 GPIO	Purpose
7	GPIO14	Connect to DIN of U1 (WS2812)
8	GPIO21	Connect to Push button S1
9	GPIO47	Connect to Push button S2
10	GPIO48	Connect to Push button S3
14	GPIO38	Connect to Push button S4

Demo Code

Access the source code repository through the provided link.