Z1追逐灯使用说明
文档版本：v1.0（2026-10-07）
适用对象： Z1 追逐灯灯具、车队控制器 Master、电脑端「ZZD 灯控工作台」、手机端「相泽梓灯控」
配套文档：《Z1追逐灯安装教程》（接线、供电、安装）、《Z1追逐灯常规故障检修》（故障排查）
本文档介绍 Z1 追逐灯的灯光编程、车队控制器（Master）的使用、灯具组网与流水灯设置，以及上位机软件与灯具、Master 之间的关系。
| 产品名称 | 智能双光警示灯（追逐灯 Z1） |
|---|---|
| 工作电压 | 10V-30V DC |
| 额定功率 | 约20W |
| 光源 | 4颗高亮LED（红光+橙光） |
| 发光方式 | 正面发光 + 侧面发光 |
| 防护等级 | IP67 |
| 控制方式 | 自动 / 联动 / 2.4G组队控制 |
| 联动说明 | 组队 / 同频联动需搭配车队控制器（Master） |
| 灯效编辑 | 支持手机版 / 电脑端自定义灯效 |
| 信号联动 | 支持倒车灯 / 刹车灯信号输入 |
| 外壳工艺 | CNC铝合金 + 阳极氧化 |
| 面板材质 | 钢化玻璃 |
| 产品尺寸 | 约50 × 30 × 10mm |
| 线长 | 约100cm |
一、系统组成
整套系统由三部分组成：
| 组成 | 作用 |
|---|---|
| Z1 追逐灯（灯具端） | 独立运行默认灯光效果；通过 2.4G 接收控制，保存自身灯效数据 |
| 车队控制器 Master | 2.4G 与上位机（手机 APP 与 Win）之间的桥梁；可提前写入灯效，实现上电离线自动广播灯效 |
| 上位机软件 | 电脑端 或 手机端，用于编程、设置、广播、下发灯效等自定义功能 |
控制链路为：
上位机 →（USB 或蓝牙）→ 车队控制器 Master →（2.4G）→ 灯具/灯具群
上位机不能直接与灯具通信，所有灯具类控制都必须经过一台车队控制器 Master，否则无法设置、更改和控制灯具等自定义功能。
无论任何数量的灯具，都需要至少配置一个车队控制器 Master；任何数量的灯具只需一个车队控制器 Master 即可实现全部广播控制。
三端各自保存的数据如下：
| 端 | 保存内容 | 断电后 |
|---|---|---|
| 灯具 | 可保存 4 组编排组×5 个灯效，共 20 个灯效、4 个编排组。另含角色映射、安全设置、队列位置 | 保留 |
| Master | 可保存 1 组编排组×5 个灯效，实现上电自动广播 | 保留 |
| 上位机 | 本地灯效与编排组 | 保留 |
灯具的「同步编程」和「车队主网同步」只临时播放，不写入灯具存储，断电后灯具恢复自身 Flash 中的效果。
二、灯具工作方式
2.1 上电与默认灯效
灯具通电后立即运行「常规」编排组的默认灯效，不需要 Master 或上位机参与。出厂默认灯效为：
红光闪 2 下 → 橙光闪 2 下 → 停 2.5 秒 → 红光闪 3 下 → 橙光闪 3 下 → 停 2.5 秒，如此循环。
每一下点亮 150 ms、熄灭 150 ms。
2.2 车辆信号触发
灯具检测到刹车、倒车信号后会临时切换为对应触发效果；信号释放后恢复之前运行的灯效。出厂默认触发效果如下：
| 触发状态 | 默认效果 |
|---|---|
| 仅刹车 | 红光 10 Hz 高闪 |
| 仅倒车 | 橙光 10 Hz 高闪 |
| 刹车 + 倒车同时 | 红光 + 橙光同步 10 Hz 高闪 |
三种触发效果均可通过上位机重新设置。触发判定优先级为：刹车+倒车 > 刹车 > 倒车。
2.3 灯光编程模型
灯光效果由「灯效」和「编排组」两级组成。
灯效是一个可循环的闪烁片段，是构成编排组的基本片段，不可直接向外广播和收录，但可在本地编程时预览。
若需向外广播和写入灯具中，需将灯效添加进编排组，通过广播编排组和写入编排组。
灯效包含以下字段：
| 字段 | 说明 |
|---|---|
| 红色通道位图 | 红光在片段内的点亮/熄灭时序 |
| 橙色通道位图 | 橙光在片段内的点亮/熄灭时序 |
| 单次点亮时长 | 每格点亮时间（ms） |
| 单次熄灭时长 | 每格熄灭时间（ms） |
| 循环后等待 | 每轮循环结束后的停顿时间（ms） |
| 亮度 | 0～100（100 为产品允许的最大亮度） |
| 循环次数 | 0 = 无限循环，最大 255 |
编排组由最多 5 个灯效组成，每一步引用一个灯效并指定该灯效播完后的等待时间。
灯具共可保存 4 个编排组，分别对应四种工作状态：
| 组 | 工作状态 |
|---|---|
| 组 0 | 常规（待机默认） |
| 组 1 | 倒车触发 |
| 组 2 | 刹车触发 |
| 组 3 | 刹车 + 倒车触发 |
每个编排组引用自己连续的 5 个灯效（4 组共 20 个灯效槽），各组数据互不覆盖。
灯具不支持呼吸灯式连续渐变。灯效只能由不同持续时间的点亮、熄灭、红光、橙光、双色组合及不同亮度组合而成。
通过编排多步骤、多灯效，可以编排出大量爆闪、交替、流水效果。
2.4 功率与温控
灯具内置三层功率保护，正常使用中自动生效，无需设置：
- 产品亮度上限：任何灯效单独橙光、红光，单独或同时点亮的最大功率为20瓦。
- 积热模型：内置功率保护，灯光长时间点亮和连续性爆闪会主动降低功率，以防灯珠烧毁和过度光衰。
- 温度保护：灯体温度约 40 ℃ 起开始线性降低输出功率，约 85 ℃ 时输出接近关闭；温度回落自动恢复。
因此，不建议长期常亮使用。如需长时间点亮，建议将亮度设置为 20% 或以下。高温降功率属于正常保护机制，并非故障。
上位机在编辑可能触发降功率的灯效时会显示提示。
三、车队控制器 Master
3.1 作用
Master 负责把上位机的指令转换为 2.4G 无线信号。一台 Master 可以管理附近的所有 Z1 灯具，支持：
扫描与选择灯具、读写灯具灯效、批量写入、广域同步、多灯流水、离线运行。
单次扫描最多列出 64 台灯具；多灯组网的实际可管理数量受现场无线覆盖条件限制。
广域灯效向外广播同步所控制设备暂无上限，理论模型可达到上千台。
灯具群若线性排列，灯具群队列中间200米~360米之间不可有真空地带（以及不可有设备断电）。否则，控制器 Master 发送的广播指令无法通过队列向后传递。
Master 在车队主网同步时所处的位置无要求，可处于队伍任意一个位置均可控制整组灯光。
3.2 指示灯
Master 通过红绿两颗指示灯显示状态，灯语如下（优先级从高到低）：
| 灯效 | 含义 | 节奏 |
|---|---|---|
| 红、绿、红、绿、双亮，然后长灭 | 时钟基准、相位时基故障（最高优先级，需返修） | 每段 120 ms，灭 1.4 s，2 s 一循环 |
| 两灯同时慢闪 | 过热 | 亮 1 s / 灭 1 s |
| 红绿交替 | 等待上位机连接 | 红 250 ms / 绿 250 ms |
| 绿灯每 10 秒短亮一次 | 无人连接，正在自动广播离线编排组（需提前设置离线编排组） | 绿 200 ms |
| 红灯短闪 | 收到一条上位机请求 | 120 ms |
| 绿灯短闪 | 向上位机发出应答 | 120 ms |
| 红灯 10 Hz 快闪 | 2.4G 正在发射（扫描/读写/广播/回包） | 每次发射持续约 150 ms |
上电后先以红绿交替提示待连接，持续 10 秒；期间有上位机接入则直接进入连接状态。若 10 秒后仍无上位机接入且提前设置和启用了离线运行编排组，则改为绿灯每 10 秒短亮，表示正在自动广播。
3.3 连接上位机
Master 提供两条上位机链路，同一时间只有一条生效：
| 链路 | 说明 |
|---|---|
| 电脑 USB | 接上电脑即可用；电脑端上位机可按 USB 身份自动识别 |
| 手机蓝牙 | 广播名 XZZ-Z1-Master-xxxx，App 扫描前缀 XZZ |
同一时间只使用一个上位机进行实时操作
四、上位机软件
4.1 电脑端
主要页面：
| 页面 | 用途 |
|---|---|
| 本地灯效编程 | 离线编辑灯效与编排组，只保存在电脑上 |
| 车队主网同步 | 将编排组临时广播给整组灯具；设置离线运行、流水灯 |
| 单一灯效读写 | 扫描并选择一台灯具，读取/写入其数据，或同步编程预览 |
| 批量灯效写入 | 按编排组批量覆盖附近灯具的灯效数据（灯具内部的批量灯效写入，默认为关。需提前连接灯具，点击设置，开启批量灯效写入） |
灯效与编排组草稿保存在配置文件 ZZD_Workbench\workbench_state.json。备份该文件即可备份全部草稿；删除它即回到出厂空白。
手机端暂无灯效数据的配置导出和导入功能，请等待后续版本更新。
4.2 手机端
通过蓝牙连接 Master：
- 打开 App，进入添加设备页，扫描蓝牙；
- 选择名称以
XZZ-Z1-Master-开头的设备并连接； - 连接成功后即可使用与电脑端对等的全部功能。
五、常用操作
以下操作在电脑端与手机端的入口和结果一致。
5.1 扫描与选择设备
在「单一灯效读写」页点击扫描。Master 会在约 3 秒内收集附近灯具并列出。点击列表中某台灯具进行连接：
- 连接成功时灯具会满亮度闪 3 下作为确认；
- 连接后上位机会自动保活；若约 20 秒无通信，灯具自动结束会话并恢复进入前的灯效（断开连接后，灯具自动结束会话并恢复常规组默认灯效，不再回到进入前的广域灯效。如若重新进入车队主网同步，需 Master 有持续广播控制，但在单一灯效读写的时候，Master 会暂时关闭对附近灯光的广播控制）。
5.2 读取灯光效果
连接后选择「读取灯光效果」，上位机会分页读回该灯具 Flash 中的全部数据，可将其保存到本地。
5.3 修改单一灯具
| 操作 | 行为 |
|---|---|
| 同步编程 | 将编排临时写入灯具 RAM 播放（临时播放，灯具内部不保存）；用于边改边预览 |
| 写入灯光数据 | 将编排保存到灯具 Flash，断电后保留 |
| 预览 / 播放 / 停止 | 控制当前会话的播放；停止后灯具保持熄灭，直到断开连接或会话超时才恢复默认灯效 |
5.4 批量灯效写入
用于一次覆盖附近所有灯具的数据：
- 灯具默认不允许批量写入，需先在「设备设置」中打开「允许批量写入灯效」；
- 最多选择 4 个编排组，对应四种工作状态的角色映射（角色映射 = 编排组与常规/倒车/刹车/双触发四种工作状态的对应关系）；
- 底部已勾选编排组会被覆盖；未勾选的不发送，灯内数据保持不变；
- 勾选空白编排组（灯效为空）写入，等于清空该组数据；
- 批量写入无回执，若有信号干扰或距离过远可能导致部分灯效没有完全覆盖，如若发现异常可再重新靠近写入（注意，是车队控制器 Master 靠近灯具，而非手机靠近灯具）。
5.5 车队主网同步
将一套编排组提交给 Master，由 Master 统一广播给范围内所有灯具，实现整组灯同步播放（属于临时控制，车队控制器 Master 断电以及灯具断电后恢复默认）。
- 车队控制器 Master 约每 10 秒广播一次，后上线的灯具一般一个周期（约 10 秒）内即可同步，通常不会超过30秒；
- 先向外广播的车队控制器 Master 拥有附近灯具的广播控制权，通电后广播的 Master 无法再次控制以接收广播数据的灯具（旨在为防止广域灯效混乱）。故而，一个区域内最好只有一个控制器控制灯光，若有两个控制器 Master 出现同时广播，而广域灯效控制断层，可将另一套 Master 断电以及另一套所控制的灯具全部断电重启，即可并入。
- 「暂停 / 继续广域灯效」可冻结/恢复播放（注意灯光关闭后，灯具仍有待机电流，不建议作为长期待机替代物理断电）；
- 若在上位机点击了其他窗口，比如单一灯效读写页面、批量灯效写入等，控制器 Master 会暂停广播控制；当从其他页面退回广域灯效控制页面时，需手动重新广播或点击「恢复广域灯效控制」；
5.6 流水灯设置
实现多灯依次点亮（左→右、右→左等方向流水）：
- 需使用上位机连接控制器 Master，在「单一灯效读写 → 扫描 → 连接 → 设置」中为每台灯具设置队列位置，队列位置可正可负，广域灯效控制最大支持65536套灯具（单一灯效读写 最多只支持扫描到64台设备，请控制方圆200米~360米范围内灯具密度）；
- 在「广域灯效控制」页勾选「启用流水灯」并填写「流水灯速度（ms，正负代表方向）」，该值为相邻灯具的切换间隔，越大越慢；
- 速度为正数时按队列位置正向流动，负数时反向流动。
5.7 离线运行
把一套编排组存入 Master 自身 Flash，使 Master 脱离上位机也能自动广播：
- 在「广域灯效控制」页卡片上点「设置离线运行」，即可将该编排组保存到控制器 Master 内部（下次上电10秒内无任何上位机连接，会自动广播）；
- 如若不希望重启控制器 Master 而立即广播控制器 Master 内部的编排组，可点击「广域灯效控制」→「离线运行设置」→「立即广播」；
- 上电后 Master 先等待 10 秒：期间无上位机接入，才自动开始广播（指示灯切换为绿灯每 10 秒短亮）；期间有上位机接入，则本次上电不再自动广播；
- 自动广播开始后若有上位机接入，广播立即退出并交还上位机，之后即使上位机断开也不会自动恢复（需重新上电或由上位机显式接管）。
5.8 设备设置
「单一灯效读写 → 设备设置」中可配置灯具的安全与行为参数：
| 设置项 | 默认值 | 说明 |
|---|---|---|
| 一对一访问密码 | 0000（无密码） | 0～9999；设置后对该灯具的一对一操作需先认证（可防止别人篡改灯效和设置） |
| 允许广域灯效 | 开 | 关闭后该灯具不参与广域同步显示 |
| 允许批量写入灯效 | 关 | 打开后才接受批量写入 |
| 自动灯效开关（4 项） | 全开 | 分别控制常规/刹车/倒车/刹车+倒车四种状态是否显示（开关位，关闭时不会删除编排组数据） |
| 队列位置 | 0 | 用于流水灯方向与顺序 |
六、注意事项
- 数据归属：「同步编程」与「车队主网同步」不写入灯具存储；只有「写入灯光数据」和「批量写入」会保存到灯具 Flash。灯具断电重启后总是先运行 Flash 中的常规组灯效（除非其被关闭或清空，数据被清空后会保持关闭状态）。
- 单主机操作：同一时间只用一台上位机操作 Master；若需切换电脑和手机，需断电重启。电脑端连接时会按 USB 身份自动选中 Master 串口，但不会自动连接，需手动点击连接。
- 固件升级：灯具与 Master 的固件目前不支持无线升级（OTA 尚未开放），已售卖产品不支持固件更新。上位机软件自身支持在线更新。
- 道路使用：使用时请遵守当地规定，请在封闭路段或非道路路段使用，以防影响其他车辆安全。