Button Switch Brick



Pictured with the KY-004 kit module plugged in.
Kit Bricks · SKU TP-K04
A tactile push button on the bus.
₹299
Works with TinkerPie V1 · Arduino C++ with the TinkerPieBricks library · Delivery across India: ₹100, 3–7 days · 7-day replacement for damaged or defective kits
About this kit
A tactile push button on the bus. The Button Switch Brick is a carrier for the KY-004 module from common 37-in-1 sensor kits: plug the module into the socket and connect one cable to a TinkerPie SENSOR port. A small CH32V003 processor on the brick does the timing work, so your program simply reads the result over I2C.
Features
- Debounced press / release
- Press counter
- Chain many buttons on one port
- Plug the kit module straight into the socket – no jumper wires
- One cable to any TinkerPie SENSOR port (I2C), BUS IN + BUS OUT to chain more bricks
- On-board CH32V003 does the timing – your code just reads the result
Specifications
| Kit module | KY-004 Button Switch (module 4 of the 37-in-1 sensor kit) |
|---|---|
| Socket | KIT SENSOR: 2.54 mm female, S + - |
| Size | 48 x 32 mm, M3 holes on the 8 mm grid |
| Connectors | 2 x JST-PH 4-pin TP-BUS (IN / OUT) |
| Interface | I2C 0x08-0x0F (8 on one bus) |
| Power | 3.3 V from the SENSOR port |
| Brain | WCH CH32V003 |
| Arduino class | tpb::KitSensor |
How to use it with TinkerPie
- Plug the KY-004 module into the 2.54 mm socket on the top edge. Match the pin names: the brick says S + -, the module has the same letters.
- Connect BUS IN to any TinkerPie SENSOR 1-4 port with a 4-pin JST-PH cable (the same cable as the other sensors).
- More bricks? Plug the next one into BUS OUT. Two bricks of the same type need different addresses: bridge ADDR +1, +2 or +4 on the back (0x08-0x0F; the first is 0x08).
- Install the TinkerPie and TinkerPieBricks Arduino libraries, open the quick-start sketch below, choose the board ESP32S3 Dev Module and upload.
Libraries: TinkerPie and TinkerPieBricks (Arduino IDE: Sketch → Include Library → Add .ZIP Library). Full guide: getting started with TinkerPie Bricks.
Quick start
Upload this, open the Serial Monitor at 115200 baud and watch the TinkerPie matrix.
Quick-start sketch (Arduino C++)
// Button Switch Brick (TP-K04): quick start
// Reads the brick and shows the value on the TinkerPie matrix and in the Serial Monitor (115200 baud).
#include <TinkerPie.h>
#include <TinkerPieBricks.h>
using namespace tinkerpie;
tpb::KitSensor s;
void setup() {
Serial.begin(115200);
tinkerpie::begin(); // also starts the SENSOR ports (I2C bus Wire1)
if (!s.begin()) Serial.println("Button Switch Brick not found at 0x08: check the cable to SENSOR 1-4");
}
void loop() {
bool level = s.state(); // the S pin, debounced
uint8_t n = s.events(); // how many times it fired (counts up, wraps at 255)
Serial.printf("S = %d events = %u\n", level, n);
if (level) led::fill(Colors::Green); else basic::clearScreen();
basic::pause(100);
}
Project: Reaction-time game
Wait for the green screen, then press the kit button as fast as you can. TinkerPie shows your time in milliseconds.
Reaction-time game (Arduino C++)
// Reaction-time game: Button Switch Brick (TP-K04)
// Wait for the green screen, then press the kit button as fast as you can. TinkerPie shows your time in milliseconds.
#include <TinkerPie.h>
#include <TinkerPieBricks.h>
using namespace tinkerpie;
tpb::KitSensor btn;
void setup() {
Serial.begin(115200);
tinkerpie::begin(); // also starts the SENSOR ports (I2C bus Wire1)
if (!btn.begin()) Serial.println("Button Switch Brick not found at 0x08: check the cable to SENSOR 1-4");
}
void loop() {
basic::showIcon(IconNames::Target, Colors::Red);
basic::pause(1000 + random(3000));
led::fill(Colors::Green);
uint8_t start = btn.events(); uint32_t t0 = millis();
while (btn.events() == start && millis() - t0 < 3000) basic::pause(1);
uint32_t ms = millis() - t0;
basic::showNumber(ms, Colors::Yellow);
Serial.printf("%lu ms\n", (unsigned long) ms);
basic::pause(1500);
}
More TinkerPie Bricks
DS18B20 Temperature BrickTP-K01 · Environment · KY-001Waterproof-grade digital thermometer chip, read in C over I2C.₹299Pre-order
Shock Switch BrickTP-K02 · Motion · KY-002Detects knocks and vibration with a spring switch.₹299Pre-order
Hall Magnetic Sensor BrickTP-K03 · Magnetic · KY-003Senses a magnet near the A3144 hall switch.₹299Pre-order
IR Receiver BrickTP-K05 · Communication · KY-022Control your robot with any TV remote.₹299Pre-order