Z1追逐灯常规故障检修
本文用于排查 Z1 追逐灯的供电、信号输入、灯具组网、广域灯效同步、流水灯、上位机连接和批量写入问题。涉及接线或测量时，请先断电，确认使用的是 10V-30V DC 电源；黄线、蓝线只能作为信号输入，不能代替红线和黑线给灯具主电源供电。
排查前的通用检查
- 使用万用表确认红线与黑线之间的实际电压处于 10V-30V DC 范围内，红线接正极，黑线接负极/GND。
- 确认黄线、蓝线没有接入高压电源。信号输入电压也必须小于 30V，极限峰值不应超过 32V。
- 电脑端或手机端同一时间只连接一台上位机，并确认没有另一台 Master 正在对同一组灯具进行控制。
- 需要无线扫描、连接或广域同步时，让 Master 靠近灯具，先排除距离、遮挡和供电不稳定造成的影响。
- 需要修改灯具设置时，优先在「单一灯效读写」中单独扫描并连接一台灯具，确认单灯通信正常后再进行广域或批量操作。
Z1追逐灯通电不亮
问题关键词：Z1灯具不亮、通电无反应、灯具不发光、上电不亮、灯具烧毁
- 检查供电电压是否处在 10V-30V 范围之内。
- 是否有意外接入高压烧毁灯具？透过玻璃检查灯具内部是否有烧黑痕迹。
处理步骤：
- 确保供电电压处在 10V-30V 范围之内，将灯具接入供电，红色线为正极，黑色线为负极。
- 在红线、黑线正常供电的前提下，分别将黄线、蓝线短时连接到供电正极，看灯具是否有反应。黄线、蓝线只能作为信号输入，不能单独替代主电源。
- 使用上位机连接控制器 Master，点击「单一灯效读写」→「扫描」，检查是否可以扫描到该灯具。
- 如果可以搜索到，说明灯具系统并未损坏。点击「连接」→「设置」，检查灯具内部是否关闭了「默认灯光效果」开关，或是否向默认灯光效果中写入了空白数据，覆盖了原有数据。
- 如果未搜索到，先靠近灯具重新扫描，并重新确认红线、黑线供电和 Master 状态；仍未搜索到时，说明灯具内部系统可能已损毁，需进一步检修或联系售后。
Z1追逐灯黄色、蓝色信号线不亮
问题关键词：黄线不亮、蓝线不亮、刹车灯不响应、倒车灯不响应、信号输入无效
- 灯具待机状态下是否有灯光显示？
- 如果工作，说明灯具主系统正常，仅信号线不响应，可能是关闭了信号线响应功能，或信号线对应的灯光编排组被空白数据覆盖。
- 如果不工作，请先查看上文《Z1追逐灯通电不亮》。
- 同时检查黄色、蓝色信号线是否意外接入过高压。透过玻璃检查灯具内部是否有烧黑痕迹。
处理步骤：
- 确保供电电压处在 10V-30V 范围之内，红色线接正极，黑色线接负极。
- 在红线、黑线正常供电的前提下，分别将黄线、蓝线连接到供电正极，看灯具是否有反应。
- 上位机连接控制器 Master，点击「单一灯效读写」→「扫描」→「连接」→「设置」，检查灯具内部是否关闭了「刹车灯」「倒车灯」「刹车灯+倒车灯」的开关，或是否向对应灯光效果中写入了空白数据。
- 如果开启开关后黄色、蓝色信号线仍未反应，退回连接页面，点击「写入灯光数据」，将「刹车灯」「倒车灯」「刹车灯+倒车灯」的角色映射数据写入有效的灯光编排组。
- 写入后断开信号，再重新触发一次刹车或倒车信号，确认三种状态分别能够响应。
Z1追逐灯无法和其他灯同步
问题关键词：灯具不同步、组网失败、广域同步无效、多灯不同步、其他灯没有反应
广域灯效同步要求参与同步的每一台灯具都允许接收广域灯效，并且由同一个 Master 负责广播。
处理步骤：
- 只保留一台手机或电脑作为上位机，关闭其他上位机上的 Master 连接和广域广播。
- 在「单一灯效读写」→「扫描」中逐台扫描并连接灯具。
- 进入每台灯具的「设置」，检查「允许广域灯效」或「广域灯效同步」按钮是否关闭；如果关闭，将其打开并保存设置。
- 确认每台灯具都能单独连接，且没有灯具断电、超出无线覆盖或处于异常重启状态。
- 同一个空间范围内只允许存在一台 Master 控制灯光。多台 Master 同时通电并向外广播时，会发生区域控制权限争抢；后上电的 Master 可能无法控制灯具群，或只能抢占部分灯具群，从而造成光效不同步。断开多余的 Master，并将不同步的灯具断电重启，使其重新并入同一个广播控制网。
- 回到「广域灯效控制」页面，重新选择编排组并点击广播/开始同步。广域同步是临时控制，Master 或灯具断电后会恢复灯具自身保存的效果。
单一灯效读写点击连接时忘记密码
问题关键词：连接要密码、访问密码忘记、一对一密码、无法认证、0000密码
如果密码是 0000，表示灯具没有设置访问密码，系统不会启动认证，也不需要输入 0000。一旦灯具已经设置了访问密码，连接时必须输入设置时的原密码；输入 0000 不能绕过认证。Z1 无法通过上位机恢复出厂设置，忘记密码后只能找回原来设置的密码，请务必妥善保存。
广域灯效同步时流水灯混乱
问题关键词：流水灯顺序错乱、流水方向错误、多个灯同时亮、流水灯跳灯、流水灯位置重复
流水灯依靠每台灯具保存的「队列位置」确定先后顺序。队列位置重复、遗漏或方向设置不一致，都会造成灯光顺序混乱；同一个空间内如果有多台 Master 同时通电并向外广播，也可能发生控制权争抢，导致部分灯具被不同 Master 控制。
处理步骤：
- 同一个空间范围内只保留一台 Master 控制灯光，断开其他 Master 的电源，停止其他 Master 的广播。
- 如果已经出现部分灯具不同步，将不同步的灯具断电重启，使其重新并入同一个广播控制网。
- 在「单一灯效读写」→「扫描」中逐台连接参与流水灯的灯具。
- 进入每台灯具的「设置」，记录当前「队列位置」。
- 按灯具实际排列方向重新分配队列位置，建议使用连续且唯一的编号，例如
0、1、2、3……；同一流水灯组内不能重复，也不要遗漏中间位置。 - 保存每台灯具的设置，重新扫描并复核一遍，确认每个位置只对应一台灯具。
- 在「广域灯效控制」中启用流水灯，填写流水灯速度：正数按队列正向流动，负数按反向流动；数值越大，切换间隔越长、流水越慢。
- 重新广播编排组，观察灯具是否按照实际安装方向依次点亮。
广域灯效同步流水灯无法开启或不工作
问题关键词：流水灯无法开启、流水灯不动、流水灯设置无效、队列位置为空、流水灯没有效果
流水灯开始前，每台参与灯具都需要提前设置有效的队列位置，同时允许接收广域灯效。
处理步骤：
- 同一个空间范围内只保留一台 Master 控制灯光，断开多余 Master，并将已经不同步的灯具断电重启。
- 使用这台 Master 在「单一灯效读写」→「扫描」中逐台连接所有参与流水灯的灯具。
- 进入每台灯具的「设置」，检查「允许广域灯效」是否开启，并检查「队列位置」是否已设置；不能让所有灯具都保持相同的默认位置。
- 按实际排列顺序为灯具设置连续且唯一的队列位置，保存后重新连接确认。
- 回到「广域灯效控制」，勾选「启用流水灯」，设置非零的流水灯速度，并确认当前编排组中有有效灯效。
- 点击广播/开始同步。这里仅排查流水灯本身；如果普通广域灯效也无法同步，请按「Z1追逐灯无法和其他灯同步」排查。
单一灯效读写页面无法扫描到灯具
问题关键词：扫描不到灯具、搜索不到设备、设备列表为空、Master扫描失败
处理步骤：
- 检查灯具红线、黑线是否正常供电，确认实际电压处于 10V-30V 范围内。
- 检查灯具或黄线、蓝线是否曾意外接入高压；透过玻璃观察是否存在烧黑痕迹。
- 确认 Master 已经通电，并且电脑端 USB 或手机端蓝牙已经连接到正确的 Master。
- 让 Master 靠近灯具，停止其他 Master 的广播或连接后重新点击「扫描」。
- 如果只有某一台灯具扫描不到，优先检查该灯具的供电、线路和高压损坏；如果附近所有灯具都扫描不到，优先检查 Master、上位机连接和 Master 的供电。
- 扫描到设备后，先只连接一台灯具进行测试，不要立即开始批量写入或广域广播。
单一灯效读写页面无法连接到灯具
问题关键词：扫描得到但无法连接、连接失败、设备连接不上、Master占用、连接超时
扫描到灯具但连接失败，常见原因是另一台 Master 或另一台上位机正在占用控制会话。
处理步骤：
- 关闭其他手机、电脑上的上位机页面，停止其他 Master 对该区域的广域广播。
- 同一时间只保留一台上位机操作 Master；如果刚从电脑切换到手机，先断电重启 Master，再重新连接。
- 让 Master 靠近目标灯具，重新扫描后点击「连接」。
- 如果弹出认证框，说明该灯具已经设置了访问密码，必须输入设置时的原密码；未设置密码的灯具不会启动认证，输入
0000没有意义。忘记原密码时，按「单一灯效读写点击连接时忘记密码」处理。 - 仍然连接失败时，断开灯具和 Master 的电源后重新上电，等待 Master 完成启动，再重复扫描和连接。
批量灯效写入不生效
问题关键词：批量写入无效、批量灯效不生效、写入后没有变化、部分灯具未更新
灯具出厂时「允许批量写入灯效」开关默认为关闭。关闭时，批量写入指令不会覆盖灯具内部数据。
处理步骤：
- 先在「单一灯效读写」→「扫描」中找到目标灯具，并逐台点击「连接」。
- 进入每台灯具的「设置」，打开「允许批量写入灯效」，点击保存。
- 返回批量灯效写入页面，选择需要覆盖的编排组并开始写入。
- 底部已勾选的编排组会被覆盖；未勾选的编排组不会发送，灯具中原有数据保持不变。
- 如果选择空白编排组写入，该组数据会被清空，灯具可能表现为对应状态没有灯光效果。
- 批量写入没有可靠的逐灯回执；写入后建议靠近灯具逐台读取或触发对应状态，确认数据已经生效。
仍无法解决时
请记录以下信息后联系售后：
- 灯具数量、灯具排列方式和供电电压；
- 红线、黑线、黄线、蓝线的实际接线方式；
- 使用电脑端还是手机端、Master 的连接方式；
- 是扫描失败、连接失败、写入失败，还是灯光效果异常；
- 是否曾接入超过 30V 的电压，以及灯具玻璃内部是否有烧黑痕迹。