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 提供按键掩码顺滑播放;V5 可把完整静态画板和一组按键的呼吸或流动渐变一起保存到键盘,关闭网页及断电后仍可运行。

KEYBOARD LIGHTING

氛围灯 / 轴灯

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

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

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—

首次安装必须分别刷入 Master V2 和 PLC V5;已经刷过 Master V2 的键盘只需升级 PLC V5。 两个文件均会在本地检查 UF2 结构、Family ID、地址范围和 SHA-256;每次刷写都要在官方驱动中确认控制器目标与文件一致。

STEP 2

交给官方驱动刷入

等待
  1. 首次安装先选择并下载 Master V2,在官方驱动中确认目标为 Master 后升级。
  2. 然后返回本页选择并下载 PLC V5,在官方驱动中确认目标为 PLC 后升级。
  3. 已经刷过 Master V2 的用户可跳过第一步,只升级 PLC V5。
  4. 每次升级完成前不要断电或拔线,两个固件不能选错控制器。
请先选择最新版固件。本页不会直接写入键盘。
等待选择最新版固件。实际刷写统一由 QK 官方驱动完成。