Mijia 米家
主菜单按键：m
本地 miIO（局域网）与 BLE 米家设备控制：详情、列表、宫格、编组、设备快捷键。
截图
详情页（温湿度传感器）
列表 / 宫格 / 编组
设备详情示例
快捷键
公共
| 按键 | 作用 |
|---|---|
ESC / GO | 返回主菜单 |
h | 打开 / 关闭 Help |
o | 开 |
i | 关 |
t / BtnGO | 切换开关 |
r | 刷新状态（传感器为 BLE 扫描） |
q | 快捷选择页 |
Fn + q | 编辑当前设备热键 |
l | 列表视图 |
g | 宫格视图 |
d | 编组视图 |
; , / ↑← · . / / ↓→ | 切换设备 / 翻页（视当前视图） |
[ ] | 宫格 / 快捷页翻页 |
列表 List
| 按键 | 作用 |
|---|---|
方向 / ;,. / | 翻页 |
l | 返回详情（或保持列表导航，以 tip 为准） |
g | 切到宫格 |
底栏 tip 示例：页码 pN/M · 箭头 page · l · g
宫格 Grid
| 按键 | 作用 |
|---|---|
| 方向键 | 移动选中格 |
[ ] | 翻页 |
1–9 | 直接选中对应格 |
o / i / t / BtnGO | 开 / 关 / 切换 |
编组 Group
| 按键 | 作用 |
|---|---|
, . | 切换编组 |
o / i / t | 整组开 / 关 / 切换 |
- = / 1 0 | 若组成员均为灯：亮度调节 / 预设 |
r | 刷新 |
[ ] | 翻组成员页 |
快捷选择 Quick（q）
| 按键 | 作用 |
|---|---|
q | 返回 |
[ ] | 翻页 |
已配置的 a–z / 0–9 | 跳到对应设备（q 保留给本页） |
热键编辑（Fn+q）
| 按键 | 作用 |
|---|---|
a–z / 0–9 | 输入热键 |
| BtnGO | 保存；冲突时确认替换 |
详情页 · 按设备类型
灯 LIGHT（yeelink.light.*）
| 按键 | 作用 |
|---|---|
- = | 亮度 − / + |
1 / 9 / 0 | 亮度预设（约 1% / 90% / 100%） |
[ ] | 色温（支持 CT 的型号） |
j k | 色相（bslamp2 / color8 / color2） |
风扇 FAN_P5（dmaker.fan.p5）
| 按键 | 作用 |
|---|---|
- = | 风速 |
w | 摇头 |
m | 模式 |
a | 摆角 |
1 / 9 / 0 | 档位预设 |
风扇 FAN_GENERIC（model 含 .fan.）
| 按键 | 作用 |
|---|---|
1–4 | 档位 |
空气净化器 F20（dmaker.airpurifier.f20）
| 按键 | 作用 |
|---|---|
1–5 | 模式 |
- = | 风速 |
空气炸锅 AIR_FRYER
| 按键 | 作用 |
|---|---|
- = | 温度 |
[ ] | 时间 |
温湿度 / BLE 事件（SENSOR_HT · BLE_EVENT）
| 按键 | 作用 |
|---|---|
r | BLE 扫描刷新 |
插座 PLUG / 其它 GENERIC
仅开关与刷新。
使用说明
配置设备
在 config.json 的 devices[] 中填写 name / name_zh / id / ip / token / model 等；BLE 传感器还需 mac 与 ble.key。也可在 Config Web 中管理。
可选字段 hotkey（a–z / 0–9，q 保留）用于一键跳转；列表 / 宫格名称旁会显示彩色热键字母。
编组写在 device_groups[]，成员用设备 id 关联。
视图切换
- 详情：单设备完整状态与类型专属控制
- 列表
l：密集浏览 - 宫格
g：图标网格，适合快速开关 - 编组
d：按房间 / 场景批量控制
无设备时 tip 会提示按 u 进入配网。
通信方式
- 多数 Wi-Fi 设备：局域网 miIO（需与 Cardputer 同一网段）
- 温湿度计、人体 / 遥控等：BLE 扫描读广播
更新机制
米家与 Cursor 类似：miIO 查询 / 控制走 FreeRTOS 后台 task，主循环负责按键、BLE 轮询与局部重绘；不在 task 里画屏，宫格单格刷新在主循环排队执行。
后台 task
| 操作 | 行为 |
|---|---|
| 进入 App | 连 WiFi → 拉当前设备状态 |
| 切换设备 / 翻页 | 递增 gen，作废未完成的旧任务 |
| 开关 / 调亮度 | 异步 SET，完成后写回 UI |
| 宫格 / 编组 | 当前页设备 顺序排队 QUERY 或批量 SET |
| 离开 App | 取消任务、等 task 退出、立刻关 WiFi、停止 BLE |
单设备查询超时约 2s；晚到的结果会被丢弃，状态显示 timeout。若已有 task 在跑，新任务会 暂存，结束后链式执行。
Wi-Fi 设备（miIO）
- 进入米家时自动连配置 WiFi，仅在米家前台保持；离开即断。
- 联网阶段不计入设备查询超时；连上后再发起 QUERY。
- 控制类操作（开 / 关 / 亮度）完成后，空气炸锅等设备会 延迟再 QUERY 一次，以同步滞后状态。
BLE 设备
BLE 禁止在后台 task 里扫描（会闪退），由主循环非阻塞处理：
| 模式 | 触发 | 说明 |
|---|---|---|
| 后台监听 | 进入米家自动开启 | 每轮约 30s，轮流听各 BLE 设备广播，写入按设备缓存 |
| 聚焦扫描 | 详情页按 r | 打断后台，对当前设备聚焦扫约 30s；结束后恢复后台监听 |
详情页先显示缓存读数与 Xs ago 年龄；无缓存时显示 listening，按 r 可强制刷新。宫格 / 列表中的 BLE 设备直接用缓存填格，不走 miIO 队列。
局部刷新
- 详情页：图标与右栏控制区 分开重绘，状态变化时尽量只刷变动区域。
- 宫格：后台 task 写回数据后，将变更格 排队 到主循环刷新，避免整页闪烁。
- 编组：底栏开关 / 亮度进度可 局部刷新；批量操作按成员顺序执行并汇总成功 / 失败。
本地计时
空气炸锅详情页：设备上报的剩余时间在本地 每秒 tick 刷新右栏，无需等下一次 QUERY。
已支持的设备类型（model）
固件按 model 字符串分类（见 mijiaClassifyModel）。下表为控制能力分类；未列到的型号会落入 GENERIC（仍可开关，若图标能匹配则显示对应图标）。
| 类型 | 匹配规则（示例） | 能力概要 | 图标 |
|---|---|---|---|
| LIGHT | yeelink.light.* | 开关、亮度；部分 CT / 色相 | 见下 |
| FAN_P5 | 精确 dmaker.fan.p5 | 风速、摇头、模式、摆角 |  |
| FAN_GENERIC | model 含 .fan. | 1–4 档 | |
| AIR_PURIFIER_F20 | 精确 dmaker.airpurifier.f20 | 模式、风速、AQI 等 |  |
| AIR_FRYER | 含 airfryer 或 .fryer. | 温度、时间 |  |
| PLUG | 含 .plug. | 开关 |  |
| SENSOR_HT | 含 sensor_ht 或 .ht. | BLE 温湿度 |  |
| BLE_EVENT | 含 .motion. / .remote. | BLE 事件设备 | （默认图标） |
| GENERIC | 其它 | 基础开关 |  |
灯型号补充
| model 特征 | 额外能力 |
|---|---|
yeelink.light.lamp2 | 色温约 2500–4800 K |
yeelink.light.lamp1 / lamp4 | 色温约 2700–5000 K |
含 .mono | 色温固定（不可调） |
含 bslamp2 / color8 / color2 | j/k 调色相 |
配置示例：yeelink.light.lamp2、miaomiaoce.sensor_ht.t2。
设备图标资源
图标按 model 子串匹配（长名优先），资源来自固件 data/icon/device/：
| basename | 离 | 开 | 典型 model 片段 |
|---|---|---|---|
airpurifier | |  | airpurifier |
bslamp2 |  |  | bslamp2 |
lamp2 |  |  | lamp2 |
light |  |  | 含 light 的回退 |
fan | |  | fan |
fryer | |  | fryer |
plug | |  | plug |
sensor_ht | |  | sensor_ht |
camera |  |  | camera |
cooker |  |  | cooker |
juicer |  |  | juicer |
wifispeaker |  |  | wifispeaker |
default | |  | 未匹配 |
宫格 / 列表另有 *_25w.png 小图；设备上优先使用同名 .rgb565 烘焙文件以加速绘制。