CZMao Documentation

What is CZMao?

CZMao (czmao) is an open-source community focused on custom mechanical keyboards. We cover PCB design, firmware development, driver tools, and keyboard documentation. All PCB source files, firmware, and JSON files are hosted on GitHub and Gitee — free to download, not for commercial use.

Get Started

Manuals

• DS17 — Wired numeric keypad with an 8 kHz polling rate.
• DS22 — 22-key wired numeric keypad.
• DS21 — 17-key + 4-rotary numeric keypad.
• Gamer — 34-key gaming keypad.
• GH60 8K — Wired keyboard with an 8 kHz polling rate.
• DZ17 — 17-key dual-mode numpad (USB wired + Bluetooth 5.0), ZMK firmware.
• DZ87 — 87-key (TKL) dual-mode mechanical keyboard (USB wired + Bluetooth 5.0), ZMK firmware.
• EC87 — 87-key (TKL) electrostatic-capacitive keyboard with web-based actuation calibration.
• DM17 — Tri-mode / dual-mode mechanical keyboard.
• DC22 — 22-key tri-mode numeric keypad (work in progress).
• EAVE — Collaboration model with Swagkeys.
• SW Transition Lite 87 — 87-key Swagkeys keyboard.
• Download Center — Firmware, keymap definitions, drawings, documents.

PCB designs

• DS21 4-Knob (b70_ds21_encoder) — 17 keys + 4 knobs, QMK + VIA open-source PCB.
• DS34 v2 (b23_ds34_v2) — 34-key + 1-knob numpad, QMK + VIA open-source PCB.
• USB_EN Controller (b43_huben) — 5-key + 1-knob desktop controller.
• Left-Handed Keypad (08gamerst) — 35-key left-hand gaming keypad, optional USB HUB version.

Online Tools

• VIA Online Remap — China-hosted, real-time remap.
• VIA (GitHub Pages) — Overseas mirror.

Firmware & Drivers

All PCB source files, firmware and JSON definitions live on GitHub and Gitee — free to download.

• GitHub: micahyy/czmao
• Gitee mirror: micahyy/czmao

Need help?

• VIA usage guide
• FAQ
• QMK keycode reference
• QQ group: 677654482

Contact

Channel	Address
Taobao shop	maiku.taobao.com
MakerWorld	@micahyy
GitHub	github.com/micahyy
Gitee	gitee.com/micahyy/czmao
QQ group	677654482