# BigTreeTech HBB Handheld Button Board

> RP2040-based handheld button board with 7 mechanical switches and RGB NeoPixel LEDs for manual control of Klipper 3D printers. Triggers homing, heating, motor disable and other macros via USB.

## Quick Facts

- **Brand:** BigTreeTech
- **Board Type:** Expansion Board
- **Price:** ~$17.99
- **Product Readiness:** consumer
- **CPU:** RP2040
- **CPU Architecture:** ARM Cortex-M0+
- **CPU Cores:** 2
- **RAM:** 264KB
- **Flash:** 2MB
- **USB:** USB Type-C
- **Power:** 5V
- **Operating Voltage:** 3.3V
- **SD Card:** No

## Open Source

- **Firmware:** Yes
- **Schematics:** Yes
- **PCB Layout:** Yes

## Compatible Firmware

Klipper

## Use Cases

- 3D Printing

## Components

- **7x Mechanical Switch** (button): 7 mechanical key switches on GPIO pins for triggering Klipper macros (homing, heating, motor disable) — [Datasheet](https://openhardware.directory/r?to=https%3A%2F%2Fgithub.com%2Fbigtreetech%2FHBB%2Fblob%2Fmaster%2Fsample-bigtreetech-hbb.cfg&ref=openhardware.directory&product=bigtreetech-hbb-handheld-button-board&source=md-export)
- **WS2812B NeoPixel** (led): 7-LED WS2812B NeoPixel chain (GPIO20, GRB) for button status feedback — [Datasheet](https://openhardware.directory/r?to=https%3A%2F%2Fcdn-shop.adafruit.com%2Fdatasheets%2FWS2812B.pdf&ref=openhardware.directory&product=bigtreetech-hbb-handheld-button-board&source=md-export)

## Protocols

- **USB**

## Description

## Overview

The BigTreeTech HBB (Handheld Button Board) is a compact RP2040-powered button controller for Klipper 3D printers. It connects via USB and presents as a standard Klipper MCU, allowing the 7 onboard mechanical key switches to trigger any Klipper macro or command. The "HBB Fe" variant features a premium aesthetic with translucent keycaps and is priced at $19.99.

## Key Features

The HBB provides 7 tactile mechanical switches mapped to individual GPIO pins (GPIO12, 13, 18, 19, 25, 26, 27) and a 7-LED WS2812B NeoPixel chain on GPIO20 for status feedback. Default button mappings include X/Y/Z axis homing, full home cycle, motor disable, hotend heating to 200°C, and bed heating to 60°C — all configurable via Klipper macros. It is powered and communicates entirely via USB Type-C.

## Open Source

Hardware schematics, PCB layout files, 3D printable parts, and the Klipper sample configuration are published on GitHub at github.com/bigtreetech/HBB.

## Where to Buy

- [BIQU Equipment](https://openhardware.directory/r?to=https%3A%2F%2Fbiqu.equipment%2Fproducts%2Fbigtreetech-hbb&ref=openhardware.directory&product=bigtreetech-hbb-handheld-button-board&source=md-export) — $17.99

## Resources

- [github](https://openhardware.directory/r?to=https%3A%2F%2Fgithub.com%2Fbigtreetech%2FHBB&ref=openhardware.directory&product=bigtreetech-hbb-handheld-button-board&source=md-export)
- [product](https://openhardware.directory/r?to=https%3A%2F%2Fbiqu.equipment%2Fproducts%2Fbigtreetech-hbb&ref=openhardware.directory&product=bigtreetech-hbb-handheld-button-board&source=md-export)

## Tags

`handheld-controller`, `button-board`, `klipper`, `3d-printing`, `rp2040`, `bigtreetech`, `hbb`, `neopixel`, `mechanical-switches`, `usb`

## Images

![BigTreeTech HBB Handheld Button Board](https://nbg1.your-objectstorage.com/openhardware-directory/entities/bigtreetech-hbb-handheld-button-board/b4674d5526bf.jpg)
![BigTreeTech HBB Handheld Button Board](https://nbg1.your-objectstorage.com/openhardware-directory/entities/bigtreetech-hbb-handheld-button-board/e05b939a2203.jpg)
![BigTreeTech HBB Handheld Button Board](https://nbg1.your-objectstorage.com/openhardware-directory/entities/bigtreetech-hbb-handheld-button-board/17f45711c4bb.jpg)
![BigTreeTech HBB Handheld Button Board](https://nbg1.your-objectstorage.com/openhardware-directory/entities/bigtreetech-hbb-handheld-button-board/7dd0c1f772d9.jpg)
![BigTreeTech HBB Handheld Button Board](https://nbg1.your-objectstorage.com/openhardware-directory/entities/bigtreetech-hbb-handheld-button-board/28940df95875.jpg)
![BigTreeTech HBB Handheld Button Board](https://nbg1.your-objectstorage.com/openhardware-directory/entities/bigtreetech-hbb-handheld-button-board/95d630e8f099.jpg)
![BigTreeTech HBB Handheld Button Board](https://nbg1.your-objectstorage.com/openhardware-directory/entities/bigtreetech-hbb-handheld-button-board/a9f4b6c5d2c8.jpg)
![BigTreeTech HBB Handheld Button Board](https://nbg1.your-objectstorage.com/openhardware-directory/entities/bigtreetech-hbb-handheld-button-board/dcb5181f5acd.jpg)

---
[View full device page](https://openhardware.directory/devices/bigtreetech-hbb-handheld-button-board)