# HA-MIC05R2 深圳交接说明 — 工厂版 + 演示版固件

> 仅限公司内部使用，禁止外发。问题联系：yuki@gmic.ai（总部）
> 版本：2026-07-07（v3 — 工厂版升级为监控式自动录音；固件 2.8.606 / 2.8.707）

深圳这边一共交接**两条固件线**，用途不同、互相独立：

| | 工厂版 | 演示版 |
|---|---|---|
| 固件版本 | 2.8.606（6xx 系列） | 2.8.707（7xx 系列） |
| 用途 | 日常办公：会议室纪要、办公室讨论、产线意见反馈、订单进度跟进 | 客户/内部演示：实时 AI 对讲 |
| 工作模式 | 两模式：私享 / 共享 | 三模式：私享 / 共享 / 实时对讲 |
| 录音方式 | **上电自动录音（监控式），无需按键** | 前键手动开始/停止 |
| 实时对讲 | 无（已移除） | 有，需先自建桥服务（见第 4 节） |
| 录音+上传 | 有 | 有 |
| 后续升级 | 自动走 ota-factory.gmic.ai | 自动走 ota-demo.gmic.ai |
| 烧录包下载 | https://ota-factory.gmic.ai/factory/ | https://ota-demo.gmic.ai/demo/ |

同一台设备任意时刻只能是其中一个版本；两个版本可以随时用 USB 互相改刷。

两个版本都是 **release 构建**：调试串口已关闭（防逆向）。设备运行日志自动记录在 SD 卡（滚动保留最近 20MB，自动清旧，不会占满存储），总部可远程拉取、清理——现场遇到问题只需向总部报设备尾号，无需接线抓日志。

---

## 1. 烧录（两个版本方法相同）

**第一次拿到设备必须 USB 烧录**（设备出厂固件的升级通道不同，OTA 拉不到这两个版本）。烧录之后的小版本升级走 OTA，不用再连电脑。

1. Windows 电脑下载对应版本的 `*-usb-update.exe`（下载地址见上表，同目录 README.txt 里有 SHA256 可校验）。
2. 双击运行 exe。
3. 设备用 USB 线连接电脑，让设备进入下载模式：**前键连按 5 次，第 5 次按住不放约 3 秒**。
4. 等待烧录工具提示完成，设备自动重启。
5. 验证：开机后**侧键双击**切模式——工厂版只有 2 个模式（绿/琥珀），演示版有 3 个模式（绿/琥珀/蓝）。工厂版另一个标志：开机约 10~20 秒后**自动亮红灯开始录音**。

⚠️ 烧录过程中不要拔线、不要按键。

## 2. 按键操作（两版本通用）

| 操作 | 功能 |
|---|---|
| 前键单击 | 开始 / 停止录音（录音中红灯） |
| 前键双击 | 语音播报当前所在模式 |
| 前键 5 击 | 手动检查 OTA 升级 |
| 侧键双击 | 切换工作模式（每个模式有语音+灯色提示） |
| 侧键三击 | 紧急上传（立即上传未传录音，不等定时） |

模式灯色：**私享=绿色，共享=琥珀色，实时对讲=蓝色**（仅演示版有蓝色），**红色专属录音状态**。

录音上传节奏：设备录音后自动经 WiFi 定时上传——电池供电约每 30 分钟一轮，插电充电时约每 5 分钟一轮。想立刻传：插上电源，或侧键三击。

WiFi 配网：与你们现有 gmic 设备的 App 配网流程相同；设备配上 WiFi 后上传/OTA/实时对讲才可用。

## 3. 工厂版（2.8.606）日常使用 —— 监控式自动录音

**像监控摄像头一样：设备一通电就自动开始录音（开机后约 10~20 秒），一直录到断电，全程无需按键。**

- 录音自动分段并经 WiFi 上传到公司系统，按设备号区分，无需人工操作。
- SD 卡录满会自动覆盖最旧的录音（环形存储），不会因为存满而停录。
- 需要暂停（如私密谈话）：前键按一下即停；**10 分钟后设备会自动恢复录音**——监控不会被永久关掉。想立刻恢复：再按一下前键。
- 建议固定工位**常插电**：插电时 WiFi 常开、约 5 分钟一轮上传，基本准实时；电池供电也照录，约 30 分钟一轮上传。
- 该版本没有实时对讲，侧键双击只在两个模式间切换，属正常现象。

## 4. 演示版（2.8.707）：先搭桥，再演示

演示版的"实时对讲"模式需要一个**桥服务**（设备 ↔ AI 之间的中转），固件里写死的桥地址是 `rt.odm.md`。**桥没搭好之前，进实时模式设备不会有 AI 回复（录音功能不受影响）。**

### 4.1 自建桥服务（IT 同事操作，一次性）

完整步骤见代码仓库 README，这里是流程概览：

1. **克隆仓库**：`git.xcu.ai/xtrigg/ha-mic-realtime-bridge`（私有仓库，账号找总部开通）。
2. **配置**：`cp .env.example .env`，填入总部下发的 `MINT_URL` + `MINT_AUTH_SECRET`。**不需要你们自己的 OpenAI key**——长期密钥由总部统一管理，桥每次会话自动换取一个几分钟就过期的短时 token。⚠️ 桥所在机器需要能访问 `rt-mint.gmic.ai` 和 `api.openai.com`（出海线路自行解决）。
3. **启动**：`docker compose up -d --build`，`curl http://localhost:18080/` 返回 ok 即正常。
4. **前置代理**（同一台机器装 nginx）：
   - 443 端口 TLS → 本机 18080。证书用总部签好的包：https://ota-demo.gmic.ai/demo/rt-odm-md-cert.tar.gz （解压后 fullchain.cer + rt.odm.md.key，nginx 配置样例在仓库 README；**私钥不要外传**；证书 2026-10 初到期，到期前找总部换新）。
   - 80 端口**明文** → 本机 18080（设备拉回复音频只走明文 HTTP，**不能配置强制跳转 https**）。
5. **报 IP 给总部**：把桥的出口公网 IP（或设备同内网部署时桥机器的内网 IP）发给 yuki@gmic.ai，总部把 `rt.odm.md` 域名指过去。DNS 生效后设备即可连上。

### 4.2 演示操作

1. 侧键双击切到**实时对讲模式**（蓝灯 + 语音提示）。
2. **前键按一下 = 开始说话**（对着设备正常讲）。
3. **再按一下 = 说完**，1~2 秒后 AI 语音回复从设备播出。
4. AI 回复播放中想插话：直接按前键，立即打断并开始新一轮。
5. 演示完侧键双击切回其他模式（退出实时模式会释放 WiFi 占用）。

### 4.3 排障速查

| 现象 | 检查 |
|---|---|
| 进实时模式没反应 | 桥服务起了没（`docker ps`）；`rt.odm.md` 解析的 IP 对不对；443 证书装对没 |
| 说完话没有回复 | 桥日志（`docker logs ha-mic-rtbridge`）有没有 `commit ... opus bytes`；有无 `mint request failed`（到 rt-mint.gmic.ai 通不通、MINT_AUTH_SECRET 对不对）；AI 出海线路通不通 |
| 回复播一小段就断 | 80 端口是否被强制跳转 https；nginx 是否配了 `proxy_buffering off` |
| 设备连不上 WiFi | 先用 App 重新配网；确认现场 2.4G WiFi 可用 |

---

## 5. 红线（务必遵守）

1. 两个烧录 exe、证书包、本文档：**仅限公司内部，禁止外发**。
2. `MINT_AUTH_SECRET` 等凭据只放在桥服务器的 .env 里，**任何情况下不进设备、不进群聊、不进代码仓库**（泄露请立即联系总部作废重发）。
3. 桥服务只对内网/演示环境开放即可，不要挂到公网大开（仓库 README 里有设备白名单配置 `DEVICE_ALLOWLIST`，建议演示机 ID 填进去）。