Skip to the content
2 layers48 × 79.6 mmBuffering cat, the printed circuit board in 3D

Open-source CH32V003 LED cat hardware, firmware, and WebHID updater

Size
48 × 79.6 mm
Copper layers
2
Thickness
1.6 mm
Parts
22
Nets
30
Pads
98
Tracks, vias
233, 54
Pours
2
Routed
Yes
KiCad
KiCad 10.0 (file 20260206)
Created
13 Aug 2026
Updated
31 Oct 2026

Overview

Buffering cat is an open-source printed circuit board by zhixuan2333, from the zhixuan2333/buffering_cat repository on GitHub, published under the MIT licence. It is a 2-layer board of 48 × 79.6 mm with 22 parts on 30 nets, routed with 233 tracks and 54 vias.

It is built around the CH32V003F4P6, ME6211C33M5G-N and USBLC6-2SC6. Its parts include 8 diodes, 5 resistors, 3 ICs, 2 capacitors and 2 connectors. It belongs with the RISC-V boards of this library.

Main components

3

README

README.md

Buffering Cat

Buffering Cat is a tiny USB status light built around the WCH CH32V003. Eight LEDs form a ring around a cat face and can be controlled from the browser, the Rust CLI, or lightweight Codex/ChatGPT activity hooks.

The repository contains the complete KiCad design, firmware, host tools, and a WebHID controller with browser-based firmware updates.

Buffering Cat PCB preview

Repository layout

Generated fabrication files, KiCad backups, editor state, build products, dependencies, and tool caches are intentionally excluded from Git.

Hardware revisions

RevisionLED matrix GPIOUSB GPIONotes
v1.0PA1/PD4/PA2 × PD0/PC7/PC0PD3=D+, PD2=D-Original 3×3 matrix; A2/C2 share a node and can ghost
v1.1PC0/PD4/PC1/PA1 × PC2/PA2PD3=D+, PD2=D-, PD0=DPUCurrent KiCad 4×2 matrix; PD0 drives R5 (1.5 kΩ)

On v1.0, D1 is at the left and D2–D8 continue counter-clockwise. Starting with v1.1, D1 is at the top and D2–D8 continue counter-clockwise. Select the matching hardware revision when building or updating; a build for the wrong revision will drive the wrong GPIOs.

Firmware releases

GitHub Actions builds application images for both v1.0 and v1.1, the common USB bootloader, and native Rust controller binaries for Linux, macOS, and Windows on both x86_64 and ARM64.

  • A push to main that changes firmware creates a prerelease whose tag is the first eight characters of the Git commit hash. GitHub rejects tag names made of exactly 40 hexadecimal characters, so a full SHA cannot be used directly.
  • Run workflow → Firmware release accepts a manual vX.Y.Z version and publishes it as the latest stable release.
  • Every release includes both .bin files, the one-time bootloader, six native CLI archives, firmware-manifest.json, and SHA256SUMS.

The application embeds the release version, Git hash, hardware revision, and HID protocol version. buffering-cat status and the web controller expose the machine-readable hardware/hash fields.

Firmware updates

Install buffering-cat-usb-bootloader.bin once with WCH-Link. After that, open the WebHID site in current Chrome or Edge, select the hardware revision and release, reboot the device to updater mode, and install directly in the browser. A local .bin can be selected when testing an unreleased build. On connection, the site automatically detects the hardware revision and firmware commit. It also resolves and selects the matching vX.Y.Z GitHub Release when one exists.

The Rust CLI remains available as a recovery/update path:

sh
buffering-cat bootloader
buffering-cat flash-usb buffering-cat-v1.1-v1.2.3.bin

The web controller is a serverless static export intended for self-deployment to Cloudflare Pages. Use webhid as the project root and out as the build output directory; no OpenAI/ChatGPT hosting integration is included.

Local checks

sh
make -C firmware HARDWARE_REV=10
make -C firmware clean
make -C firmware HARDWARE_REV=11
cargo test --manifest-path host/Cargo.toml
npm --prefix webhid test

The firmware Makefile expects sibling ch32fun and rv003usb checkouts by default; see firmware/README.md for path overrides.

Links

Project announcement video

Watch or download the video (MP4) · View the original post on X

License

MIT. See LICENSE.

Parts

22
QtyValueFootprintReferences
8LED_45degLED_SMD:LED_0603_1608Metric_Pad1.05x0.95mm_HandSolderD1, D2, D3, D4, D5, D6, D7, D8
21uCapacitor_SMD:C_0603_1608MetricC1, C2
25.1kResistor_SMD:R_0603_1608MetricR1, R2
2MountingHoleMountingHole:MountingHole_3.2mm_M3H1, H2
2RResistor_SMD:R_0603_1608Metric_Pad0.98x0.95mm_HandSolderR3, R4
11.5kResistor_SMD:R_0603_1608MetricR5
1CH32V003F4P6Package_SO:TSSOP-20_4.4x6.5mm_P0.65mmU3
1Conn_ARM_SWD_TagConnect_TC2030Connector:Tag-Connect_TC2030-IDC-FP_2x03_P1.27mm_VerticalJ2
1ME6211C33M5Package_TO_SOT_SMD:SOT-23-5U2
1USBLC6-2SC6Package_TO_SOT_SMD:SOT-23-6U1
1USB_C_Receptacle_USB2.0_16PConnector_USB:USB_C_Receptacle_Palconn_UTC16-GJ1

Similar boards

  • 2 layers32 × 29 mmNode, the printed circuit board in 3D

    Node

    cUDGk/vrc-fbt-hardware

    VRChat向けフルボディトラッキング基板 — ハブ+デイジーチェーン端末・数と位置を自由に変更可能・KiCad/OpenSCAD一式

    25 parts
  • 6 layers90 × 90 mmCodex micro wired revA route nognd, the printed circuit board in 3D

    Codex micro wired revA route nognd

    slopus/codex-keybored

    A 100% vibe-coded hardware build: Fusion 360, six-layer KiCad PCB, STM32 firmware, and live JLC factory handoff.

    97 parts10
  • 2 layers35 × 100 mmWalkieTalkie, the printed circuit board in 3D

    WalkieTalkie

    GuzziFlipFlops/ESP32-Walkie-Talkie

    An open source ESPNOW based walkie talkie with a 600 meter tested distance, with an OLED and multiple buttons to interact with

    66 parts7MIT
  • 2 layers86.5 × 27.5 mmComfospot50 full, the printed circuit board in 3D

    Comfospot50 full

    cornim/comfospot50

    The schematic and PCB in this directory are the project-authored controller board design. The board is intended to interface an ESP32-C3 with the existing ComfoSpot panel.

    29 parts4GPL-3.0
  • 4 layers41 × 33 mmDarknet smao, the printed circuit board in 3D

    Darknet smao

    dcbokonon/darknet-smao

    Darknet SMAO: Meshtastic LoRa+BLE mesh node SAO for DEF CON 34

    36 parts4
  • 2 layers23.5 × 30.5 mmEsp flasher, the printed circuit board in 3D

    Esp flasher

    makerspacelt/esp-flasher

    This is ESP8266 modular flasher based on CH340 usb uart converter and USB-C port.

    49 parts4CERN-OHL-S-2.0
  • 4 layers62.5 × 96.2 mmESP32 C3 EReader, the printed circuit board in 3D

    ESP32 C3 EReader

    IS7V4N/ESP32_E-Reader

    ESP32 based E-Ink reader

    95 parts3
  • 4 layers51 × 21 mmNyx2b, the printed circuit board in 3D

    Nyx2b

    rh1tech/nyx

    Enhanced open source Raspberry Pi Pico / Raspberry Pi Pico 2 clone

    54 parts2MIT

Questions

How big is the Buffering cat PCB?

It measures 48 × 79.6 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Buffering cat use?

22 parts, built around the CH32V003F4P6, ME6211C33M5G-N and USBLC6-2SC6. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.

Where can I download the Buffering cat KiCad files?

From the zhixuan2333/buffering_cat repository on GitHub, at the commit this page was made from: the board is buffering_cat.kicad_pcb and its schematic buffering_cat.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Buffering cat design in my own project?

Its repository publishes it under the MIT licence: you may reuse it on that licence's terms (keep the author's notice, and for a copyleft licence share your changes alike).