跳到主要内容

更新 VibeKeys 固件

本指南介绍如何更新 VibeKeys 设备上的固件。根据设备是否正常工作，有两种更新方式。

固件已预装

你的 VibeKeys Max 设备出厂时已预装固件。首次设置无需刷写固件，请直接前往 快速入门 配置设备。

什么是固件？​

固件是运行在 VibeKeys 设备硬件上的软件，负责蓝牙连接、WiFi 处理、按键响应和与电脑的通信。

如何选择正确的方式​

情况方式耗时
设备正常，想更新到最新版本OTA 更新（见下方）5-10 分钟
设备无法连接或出现故障ESP LaunchPad（见后续）10-15 分钟
设备需要恢复出厂设置ESP LaunchPad（见后续）10-15 分钟

方式一：OTA 更新（推荐）​

设备正常且已连接 WiFi 时使用此方式。 OTA（空中下载）更新允许你通过无线方式安装新固件。

第一步：连接 WiFi​

  1. 开启 VibeKeys Max
  2. 打开浏览器访问 setup.html
  3. 点击 Connect，从列表中选择 "VibeKeys Max"
  4. 输入你的 WiFi 名称和密码，点击保存
  5. 连接成功后，屏幕应显示 "Ready" 状态

第二步：进入 OTA 模式​

  1. 开启 VibeKeys Max 后立即按下 ESC 键
  2. 持续按住直到屏幕显示更新 URL，如 http://192.168.x/ alt text

第三步：打开更新 URL​

  1. 在电脑浏览器中输入 VibeKeys Max 屏幕上显示的 URL

  2. 下载最新固件：vibekeys_ota.bin

    如果你收到的键盘屏幕和上图中尺寸不一致，那它应该是 V2 版本，请使用此固件：vibekeys_max2.bin

  3. 上传固件到网页并点击 Start

  4. 等待更新完成（通常 1-3 分钟）

alt text

屏幕会显示更新进度。完成后，设备会自动重启。

无需 USB 线

OTA 更新完全通过 WiFi 进行——无需 USB 连接。这比 ESP LaunchPad 方式更快更方便。

方式二：ESP LaunchPad（恢复/出厂重置）​

当设备需要恢复、出厂重置或 OTA 更新不可用时使用此方式。

先备份

使用 ESP LaunchPad 之前，请尽可能记下当前的 WiFi 和服务器设置，因为更新后需要重新配置。

前置要求​

你需要
  • 一台 VibeKeys Max 设备
  • 一根 USB 数据线（USB-A 转 USB-C 或 USB-C 转 USB-C，取决于你的电脑）
  • 一台有浏览器的电脑（推荐 Chrome 或 Edge）
  • 互联网连接

第一步：连接设备​

  1. 找到 USB-C 接口（在 VibeKeys Max 设备右侧）
  2. 将 USB 线一端连接到设备
  3. 另一端连接到电脑
使用数据线

确保使用支持数据传输的 USB 线，而不仅仅是充电线。有些线缆只能充电。

第二步：打开 ESP Launch Pad​

  1. 打开浏览器（推荐 Chrome 或 Edge）

  2. 访问：

    https://espressif.github.io/esp-launchpad/?flashConfigURL=https://vibekeys.dev/firmware/vibekeys.toml

alt text

第三步：连接设备​

  1. 点击 ESP Launch Pad 界面顶部的 "Connect"
  2. 浏览器提示时允许 USB 设备访问
    • 点击 "Allow" 授予权限
    • Web 工具需要此权限与设备通信

第四步：更新固件​

  1. 查看显示的固件版本信息
  2. 点击 "Flash" 开始更新固件
  3. 等待完成 - 通常需要 2-5 分钟

更新过程会显示：

  • 从 VibeKeys 服务器下载固件
  • 擦除旧固件
  • 写入新固件
  • 验证安装
请勿断开连接

在整个更新过程中保持 USB 线连接。中断更新可能导致设备无法使用。

更新完成。

相关文档​

需要帮助？​

如果你遇到本指南未涉及的问题：

  1. 查看 GitHub Issues - 类似问题可能已有解决方案
  2. 联系支持：vibekeys-customer-support@secondstate.io
  3. 加入社区：访问 GitHub 仓库参与讨论和获取更新