CHISA LAB QK80 MK2 WEB DRIVER
QK80 MK2VID 514B · PID 4D02
Protocol
Layers
CDC
安全上下文:检测中 浏览器 API:检测中
DEVICE CONTROL

QK80 MK2

改键、宏、灯光、点阵与设备参数集中管理。

QK80 MK2 可视化改键

紧凑同屏改键:上方选实体键,下方立即选择功能并应用。支持 Layer 0–3、搜索与分区键池。

连接 HID 后读取键位。
SELECTED KEY

尚未选择键帽

点击上面的任意键帽开始改键。

准备改为 请选择下方功能
高级:Hex / Matrix
尚未选择键帽

主键盘逐键 RGB 画板

RAM_FRAME_V2 负责 91 灯原子整帧;V3 提供按键掩码顺滑播放;V4 可把一组按键的呼吸或流动渐变参数保存到键盘,关闭网页及断电后仍可运行。

KEYBOARD LIGHTING

氛围灯 / 轴灯

普通灯效与逐键 RGB 统一放在主键盘灯光页。

Frame 1 左键点击/拖动上色 · 从已亮键开始可连续熄灭 · 宽键自动同步多颗灯 · 浏览器自动保存当前工作区
就绪
实际 FPS
当前帧
本帧更新0 Keys
传输耗时
超周期帧0
注意:颜色通过 RGB888 整帧写入 RAM,不会写 EEPROM;断电、拔插或点击“退出接管”后恢复官方灯效。关闭或刷新页面时网页也会尽力自动退出接管。
动画帧预览点击切换 · 拖动调整顺序
LED 物理映射(已验证)

已固化 0–90 共 91 颗灯。Backspace、反斜杠、Enter、左 Shift、Space 和右 Alt 会自动控制对应的多颗灯。

当前键未选择
固定映射:91/91 已实机验证(宽键自动控制多颗灯)
主键盘 RGB 通道状态RAM_FRAME_V2

安全诊断只读取 VIA、Layer、CDC 与轴灯基础参数。整帧写入走 07 16 05,每帧 BEGIN + 13 DATA + COMMIT,不会 SAVE / EEPROM。

RAM_FRAME_V2 已完成 91 灯、全黑、原子刷新、乱序拒绝与恢复实机验证。

正式版默认使用实机验证稳定的 10 ms / 4 FPS。静态帧使用 50 ms 安全间隔;不稳定的 5 ms 与 0 ms 档已移除。

320×172 彩色屏幕

图片、GIF / MP4、相册均在浏览器本地转换为 RGB565,再保存到键盘屏幕存储。与 7×7 点阵是两套独立功能。

屏幕素材通道使用同一个 Web Serial / CDC 连接
选择图片开始

图片支持 PNG / JPG / BMP;动画支持 GIF / MP4;相册可多选图片或选择文件夹。

7×7 自定义点阵动画

CDC:115200 baud · 64-byte packet · C0/C1 · HSV888 row-major。

Web Serial / CDC未连接
DOT LIGHTING

点阵屏普通灯效

亮度 / 模式 / 颜色与自定义动画放在同一个专栏。

左键绘制 · 右键擦除

宏 M0–M15

QK80 MK2 当前 Protocol 0x000C 支持 VIA v11+ 宏格式:按键按下 / 松开 / Tap / 延时 / 文本。

VISUAL MACRO EDITOR

M0

先读取宏,或点击“录制”开始添加键盘 / 鼠标事件。
高级:原始宏表达式
Tap:{KC_A}按下:{+KC_LCTL}松开:{-KC_LCTL}延时:{100} 鼠标:{KC_MS_BTN1} / {KC_MS_WH_UP}
先点击“从键盘读取”。

Profile 保存 / 加载

把 Layer、宏、灯光、设备设置与当前点阵编辑器帧保存成一个 CHISA QK80 MK2 Profile。

备份当前键盘

从键盘读取 4 个 Layer、Macro、灯光与 MAGIC / FEATURES / 连接参数。

尚未导出

载入 Profile

先选择 JSON,再检查摘要。连接模式和点阵动画默认不会自动覆盖。

尚未选择文件

设备设置

参数映射来自 QK80 MK2 官方 VIA definition;修改后会写入对应 Custom Menu channel。

MAGIC

FEATURES

日期 / 时间

按官方实现写入 Channel 25:本地 Unix 时间(已补偿时区)。

连接

切出 USB 后网页 HID / CDC 可能立即断开,这是正常现象。

EEPROM Reset

清空 VIA 动态配置、键位、宏等设置。执行后通常需要重新插拔键盘。

界面样式

主题、选中键高亮、整体主色与背景都只保存在当前浏览器本地;清除该站点数据后会恢复默认。

PRESETS

主题预设

Angry Lime
COLORS

自定义颜色

实时保存
BACKGROUND

自定义背景

未设置图片
LOCAL BACKGROUND图片只保存在当前浏览器
本地保存说明主题参数保存在 localStorage,背景图片保存在 IndexedDB。部署到正式网页后,每个浏览器 / 每台设备各自保存一份;清除浏览器记录、站点数据或无痕模式结束后,需要重新上传背景。

QK80 MK2 UF2 固件升级

选择并校验最新版自制 PLC 固件,然后转到 QK 官方驱动完成升级。本网页不再直接写入键盘。

⚠ 固件刷写有风险

实测本网页原来的“另存为到引导盘”升级方式存在兼容问题,现已停用。请使用键盘原装 USB 线、直连电脑 USB 口,并在 QK 官方驱动中升级;自制固件若出现任何问题,请立即刷回官方固件。

STEP 1

选择最新版固件

未选择
文件
控制器
UF2 块
地址范围
大小
SHA-256

V4 已由用户通过 QK 官方驱动完成实机刷写,持久保存功能正常,只适用于 PLC。 点击后会在本地检查 UF2 结构、Family ID、地址范围和 SHA-256。

STEP 2

交给官方驱动刷入

等待
  1. 点击下方按钮并确认后,网页会下载已校验的 V4 UF2,同时打开 QK 官方驱动。
  2. 在官方驱动的固件升级页面选择刚下载的 UF2。
  3. 确认目标是 PLC 后开始升级,完成前不要断电或拔线。
请先选择最新版固件。本页不会直接写入键盘。
等待选择最新版固件。实际刷写统一由 QK 官方驱动完成。

调试日志

显示本页发出的 HID / CDC 数据,方便继续逆向。