Gixie Clock W 固件更新说明
固件版本：HW1.1 - FW1.1.1
本次更新主要增加了闹钟、倒计时、自动轮播和网络数据显示功能，并改进了时区、按键、配网和显示稳定性。部分功能需要配合最新版 App 才会显示。
一、更新内容速览
| 功能 | 本次变化 |
|---|---|
| 闹钟 | 最多 10 组；每组可设置重复星期 |
| 倒计时 | 增加倒数日、正数日两种日期模式；日期模式断电后可继续计算 |
| 显示模式 | 增加循环显示，可选择多个模式和切换间隔 |
| 网络数据 | 增加数字货币价格、自定义数据；B 站接口可自定义地址 |
| 时间设置 | 支持 UTC-12:00 至 UTC+14:00 的 15 分钟步进时区，并增加夏令时开关 |
| 设备管理 | 可以设置自定义设备名称，方便区分多台时钟 |
| 按键 | 增加配网退出和恢复出厂操作；加减键支持按住连续调节 |
| 稳定性 | 优化显示、配网、断线重连、数据刷新、定时开关机和按键识别 |
二、闹钟升级
旧版本最多设置 3 组闹钟，新版本最多设置 10 组。每组闹钟都可以单独选择重复方式：
- 永不重复：响过一次后自动关闭，适合一次性的提醒。
- 每天重复：每天在设定时间响铃。
- 自定义星期：从周一至周日中任意选择，例如只在工作日响铃。
使用方法：打开 App 的“闹钟”页面，添加或编辑闹钟，设置时间、重复星期和开关状态后保存。闹钟响起时，单击时钟上的功能键即可停止响铃。
三、倒计时升级
App 的“定时器”页面现在提供三种模式：
1. 24 小时内倒计时
按小时、分钟、秒设置倒计时。倒计时结束后会提醒；单击功能键可以停止提醒并退出结束状态。
2. 倒数日
输入剩余天数，时钟每天按日期减少 1 天。
3. 正数日
输入起始天数后每天增加 1 天。
日期模式的其他改进：
- 断电或重新启动后，会根据当前日期继续计算，不需要重新开始。
- 开始倒计时前的显示模式会被记住；停止或结束后会返回原来的显示模式。
- 天数范围为 0 至 9999，实际显示位数会根据 4 管、6 管或 8 管机型自动适配。
四、循环显示（新增）
开启“循环显示”后，时钟会在选定的显示模式之间自动切换。
- 在 App 首页打开“时钟模式”。
- 打开“循环显示”开关。
- 勾选至少两种要循环的模式。
- 选择 30 秒、1 分钟、5 分钟，或输入自定义间隔（5 秒至 3600 秒）。
- 保存设置。
以下情况会暂时暂停循环，恢复正常显示后继续：配网、手动调时、倒计时运行、时钟处于关灯状态。只选择一种模式时，循环不会切换。
五、网络数据显示（原数据模式扩展）
在网络数据模式中，可以选择以下数据来源：
| 数据来源 | 用途 |
|---|---|
| B 站粉丝数 | 输入 UID；可按需要填写自定义 HTTPS 接口 |
| 数字货币价格 | 例如 BTC/USDT、ETH/USDT、DOGE/USDT |
| 自定义数据 | 显示股票价格、温度、人数、步数等数字 |
数字货币价格
默认交易对为 BTCUSDT，可以在 App 中改为其他交易对。数据通常每分钟刷新一次。币价接口需要返回顶层 price 字段，例如：
{"symbol":"BTCUSDT","price":"67890.12"}
辉光管不显示小数点，设备按以下规则转换价格：
- 价格大于等于 1：只显示整数部分，小数部分不显示，并在左侧补 0。
- 价格小于 1：不显示
0.，只取小数点后的数字，在右侧补 0；超过灯管位数的数字会被截断，不进行四舍五入。 - 数字长度超过灯管数量：显示该机型可显示的最大值（4 管为
9999、6 管为999999、8 管为99999999）。
示例（同一个价格在不同灯管机型上的显示）：
| 原始价格 | 4 管 | 6 管 | 8 管 | 处理方式 |
|---|---|---|---|---|
123.45 | 0123 | 000123 | 00000123 | 大于等于 1，只取整数 123 |
67890.12 | 9999 | 067890 | 00067890 | 4 管超出范围；6/8 管显示整数 67890 |
0.03125 | 0312 | 031250 | 03125000 | 小于 1，取小数数字并补 0 |
0.5 | 5000 | 500000 | 50000000 | 小于 1，取小数数字并补 0 |
数字货币交易对只填写字母和数字，例如 BTCUSDT、ETHUSDT、DOGEUSDT。如使用自定义币价接口，地址必须为 HTTPS，并用 {symbol} 表示 App 中填写的交易对，例如：
https://example.com/price?symbol={symbol}
接口返回内容仍须包含顶层 price 字段，且字段值应为普通十进制价格文本。
自定义数据
自定义数据接口用于显示股票价格、温度、人数、步数或其他计数值。填写一个以 https:// 开头的数据地址，设备通过 GET 请求访问，并读取返回 JSON 的顶层 value 字段。
推荐返回格式：
{"value":12345}
也可以将整数作为字符串返回：
{"value":"12345"}
接口要求：
- 必须使用 HTTPS 地址。
- 返回内容必须是合法 JSON 对象。
- 必须有顶层
value字段，值只能是非负整数，例如0、18、123456。 - 不支持小数、负数、千位分隔符或带单位的字符串，例如
12.5、-3、1,234、"25°C"都不能正常解析。 - 地址最长 96 个字符，响应内容应保持简短；建议响应正文不超过 1 KB。
- 数字超过机型可显示范围时会限制为最大值：4 管
9999、6 管999999、8 管99999999。
可直接测试的示例：
https://example.com/api/temperature
返回：
{"value":26}
时钟会显示 26（根据灯管数量在左侧补 0）。如果要显示自定义计数器，例如在线人数，可以返回：
{"value":1288}
接口不可访问、返回内容不符合要求或网络信号较弱时，设备会跳过本次刷新并稍后重试，不会影响时钟走时。修改地址后在 App 中重新保存即可生效，一般不需要重启设备。
六、时间、时区和显示格式
时区
新版本支持 UTC-12:00 至 UTC+14:00，并以 15 分钟为步进。印度（UTC+5:30）、尼泊尔（UTC+5:45）、纽芬兰（UTC-3:30）等非整点时区可以直接选择。
夏令时
在设置页面打开“夏令时”即可增加 1 小时；不使用夏令时的地区保持关闭。换季时请根据当地规则开关此选项。
时间显示
除时分秒外，还可以选择年月日、月日时分，并设置是否自动轮换以及 1 分钟、2 分钟或 5 分钟的切换间隔。
联网后设备会自动校时；短时断网时继续使用本机时间运行，网络恢复后会再次同步。
七、按键操作
功能键为 K1，另外两个按键为 K2（加） 和 K3（减）。
| 操作 | 作用 |
|---|---|
| K1 单击 | 开灯或关灯；闹钟响起时停止闹钟；倒计时结束保持时停止提醒并退出 |
| K1 双击 | 切换到下一个显示模式 |
| K1 三连击 | 进入配网模式 |
| 配网模式下 K1 再三连击 | 退出配网并重启，恢复正常连接 |
| K1 长按约 1 秒后松开 | 进入手动调时，依次调整时、分、秒并保存 |
| K1 持续长按约 5 秒 | 进入恢复出厂确认阶段，灯管变为红色并提示 |
| 继续按住约 10 秒 | 执行恢复出厂，灯管变为紫色并自动重启 |
| 进入恢复出厂确认后松手 | 取消操作，恢复原来的颜色和设置 |
| K2/K3 单击 | 调整显示颜色；调时状态下调整当前的时、分或秒 |
| K2/K3 按住不放 | 连续调整颜色或当前时间数值 |
恢复出厂是破坏性操作，会清除 WiFi、颜色、显示模式、闹钟、倒计时、网络数据和定时开关机等设置。若只出现红色提示，松手即可取消。
八、显示模式
App 中共有 8 种显示模式：
| 模式 | 名称 | 说明 |
|---|---|---|
| 1 | 单色时钟 | 使用固定颜色显示时间 |
| 2 | 整体彩虹 | 所有灯管一起渐变 |
| 3 | 单管彩虹 | 每根灯管独立渐变 |
| 4 | 数字刷新 | 数字循环刷新显示 |
| 5 | 世界线（内置） | 显示内置的变化数值 |
| 6 | 世界线（自定义） | 显示用户设置的数字组 |
| 7 | 0101 模式 | 灯管随机显示 0 和 1 |
| 8 | 网络数据模式 | 显示粉丝数、币价或自定义数据 |
九、设备名称
在 App 的设置页面可以给设备设置名称。名称用于设备发现和多设备区分，最多 32 字节，中文约 10 个字。留空时继续使用设备默认名称。
十、在线升级提示
- 先将 App 更新到最新版，再检查设备是否能正常连接 WiFi。
- 在 App 的固件升级入口确认设备型号和可用版本后开始升级。
- 升级过程中请保持设备通电、网络稳定，不要反复断电或操作按键。
- 升级完成后设备会自动重启；重新连接 App 后，请检查固件版本、时间、显示模式和其他常用设置。
从旧固件升级时，系统会尝试保留 WiFi 信息，时区也可能被保留；由于新旧版本设置项目不同，颜色、闹钟、显示模式、网络数据和定时开关机等其他设置可能恢复为默认值。升级前请先截图或记录重要设置，升级后按需要重新设置。
如果升级后 App 暂时找不到设备，请等待设备完成重启并确认手机与时钟连接到同一 WiFi；仍无法找到时，重新搜索或按说明进入配网。
十一、常见问题
Q：倒数日或正数日断电后从头开始了吗？
A：日期模式会根据当前日期继续计算。重新上电并联网后，请在“定时器”页面刷新确认状态。
Q：循环显示不切换？
A：确认开关已打开、至少选择两种模式，并且设备没有处于配网、调时、倒计时或关灯状态。
Q：网络数据显示为 0 或没有更新？
A：请检查 WiFi、数据地址和账号信息。接口异常时设备会稍后重试；修改配置后重新保存即可再次请求。
Q：误进入恢复出厂提示怎么办？
A：在红色提示阶段松开 K1 即可取消，不会清除设置。只有继续长按到约 10 秒才会执行恢复出厂。
本说明对应 HW1.1-FW1.1.1。使用新版 App 和支持该功能的固件后，才会显示相应的新增入口。如遇到无法连接、升级失败或显示异常，请先重新搜索设备并确认 WiFi 状态，再联系售后。