# cyberboard-cli: reconstructing CyberBoard R4 configuration writes

> cyberboard-cli reconstructs the AngryMiao CyberBoard R4 configuration protocol used by AM Master. Its CLI reads keymaps and writes keymap and LED configuration through USB CDC serial frames, with protocol notes describing 64-byte framing and CRC-8. The author reports hardware-tested writes and keymap reads; per-key LED authoring remains unfinished.

- Type: Case study
- Targets: Protocol
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-06
- Added to the catalog: 2026-11-08
- Original resource: <https://github.com/GeneralD/cyberboard-cli>
- Primary source: <https://github.com/GeneralD/cyberboard-cli/blob/c8e3be448552e6c0e33ed1ec5fdf057142e3bf71/README.md>
- Catalog page: <https://awesomerea.org/resources/cyberboard-cli-case/>
- Record JSON: <https://awesomerea.org/resources/cyberboard-cli-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/cyberboard-cli-case/index.md)

## Requirements & limits

- **Prerequisites:** Python 3.11+ and an AngryMiao CyberBoard R4; device operation uses pyserial.
- **Limits:** Per-key LED authoring remains in progress.
- **License:** MIT.

## Primary sources

1. <https://github.com/GeneralD/cyberboard-cli/blob/c8e3be448552e6c0e33ed1ec5fdf057142e3bf71/README.md>
2. <https://github.com/GeneralD/cyberboard-cli/blob/c8e3be448552e6c0e33ed1ec5fdf057142e3bf71/.claude/rules/30-write-protocol.md>

## More in Protocols

- [gm1356-recordings: reading a sound meter through its USB-HID protocol](https://awesomerea.org/resources/gm1356-recordings-case/index.md) · Case study
- [TwoTrees SK1: reconstructing the display UART interface](https://awesomerea.org/resources/twotrees-sk1-display-case/index.md) · Case study
- [KW330 OBD Data Access: reconstructing the scanner's USB data stream](https://awesomerea.org/resources/kw330-obd-datastream-case/index.md) · Case study
- [AstralPool Halo Cloud: reconstructing chlorinator cloud control](https://awesomerea.org/resources/astralpool-halo-cloud-case/index.md) · Case study
- [zen-go-tui: reconstructing Zen Go USB HID controls](https://awesomerea.org/resources/zen-go-tui-case/index.md) · Case study
- [tinyscreen: reconstructing an ArtInChip USB display protocol](https://awesomerea.org/resources/tinyscreen-artinchip-case/index.md) · Case study

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.