导语｜授时不是调试的附属品
开源时间同步把 CDC-ACM 串口授时推到台前：通用串行总线连接后，内核把设备暴露为 ttyACM 节点，time-sync-server 脚本启动串口授时服务；ADB 用于安装、调试与恢复 ACM 配置。两者相关，但不是同一条链路。把授时当成 ADB 附属品，会在“设备列表是空的”或“脚本在跑但偏移很大”时同时误判。
两条链路的分工
授时链路关心串口节点、权限、偏移与失锁；调试链路关心授权、安装与属性配置。
可以出现调试失败但授时仍可用，或反过来。分类日志是排障第一刀。
恢复 ACM 的属性设置是为了让授时节点出现，不是用调试桥接代替授时协议。
文档把分工写清，是为了减少现场口头传说。
权限、udev 与组
首次运行配置规则与拨号组，常需重新登录或刷新组。忽略这步会反复权限拒绝。
节点号重排时要用稳定绑定策略。
线缆与集线器质量纳入备件清单。
权限问题与驱动问题要用不同检查表。
服务质量如何度量
用偏移直方图与失锁次数，而不是进程还在。
长稳测试覆盖热插拔与长时间运行。
阈值写入验收附件。
异常时保留原始日志，勿只截一句报错。
与上传、录制的编排
先授时再录制再上传。
多设备共主机时明确映射表。
不要私自改用网络时间协议替代，除非书面评估。
编排脚本应一键可复现。
开源贡献与平台差异
补平台差异时附发行版与内核版本。
通用修复可上游，板级特例走评估。
Issue 同时贴 ttyACM 与设备列表。
贡献指南写明日志最小集。
授时验收清单
把下列项作为开源授时通过标准。
- ttyACM 节点可见且权限正确
- 授时服务稳定，偏移在阈值内
- 调试列表问题与授时问题可分类
- 热插拔与长稳测试通过
- 编排顺序演练通过
- 日志与阈值进入附件
组织与培训
录制员培训要包含“看不见串口时怎么办”。
支持团队按链路分流工单。
把一次成功的授时演示拍成内部短片。
授时稳定是多相机叙事的地基。
常见误区纠正
误区一：有调试列表就等于已授时。误区二：脚本在跑就等于偏移可接受。误区三：板端显示时钟可代替串口授时。
逐条写入新人对课。
客户现场用对照表沟通，减少情绪化争吵。
纠正误区本身就是专业交付。
工程深挖、现场门禁、问答与附录要求
围绕「串口授时」，建议在项目周报单列进展与风险：已验证的事实、未验证的假设、下一步实验各写一句。这样开源集成不会停在感觉良好，而会停在可检查的证据。对外部协作方，也可以用同一格式同步，减少会议空转。
在涉及「调试桥接」的变更窗口，冻结并行大改：先完成小范围回归，再放开多人提交。硬件开源最怕多变量同时动。回归包应包含最短路径的成功样例与已知失败样例，保证失败可重复。
把「拨号组」写入新人首周任务：不是阅读口号，而是亲手完成一次操作并提交记录截图或日志摘要。通过率低说明文档缺口，而不是只说明新人能力。文档缺口要回流到仓库或资料台账。
针对「udev」建立反例库：正确做法旁必须放错误做法与后果。现场人员对反例的记忆深于对条文的记忆。反例库每个季度删增一次，保持与当前固件和工具链同步。
若指标与「偏移直方图」相关出现漂移，先做分层诊断：设备、主机、网络、规程、人因。禁止直接跳到改模型或改硬件选型。分层诊断记录保留九十天，供审计与复盘。
对外演示「失锁」时，优先展示门禁与日志，而不是只展示最终画面。决策者更信任可重复过程。演示脚本版本化，避免每次临场发挥造成承诺不一致。
与「线缆备件」相关的责任人必须有明确的否决权与升级路径。没有否决权的质量角色等于装饰。升级路径写到支持手册，节假日也能执行。
度量「节点重排」不要只用二元是否成功，而要保留分布：百分之五十、百分之九十五分位与极端尾部。尾部决定生产痛苦。分布图进周会，比平均值更能推动资源分配。
当「编排顺序」需要跨团队协作时，先写一页接口：输入、输出、超时、失败码、所有者。接口比共识会议便宜。接口变更走短评审，避免私聊决定影响全局。
回顾「网络时间协议禁替」的历史事故时，使用统一模板：现象、影响会话、根因、修复、是否需要重采。模板强制区分偶发与系统性。系统性必须回流到固件、文档或规程，而不是靠个人英雄。
在预算讨论里，把「发行版日志」的成本拆成工具时间、人因时间、返工时间。只看工具采购价会低估总拥有成本。拆分后的数字更能支持开源治理投资。
保持「热插拔」相关的最小可运行样例永远可运行：样例损坏等于文档损坏。持续集成夜间跑样例，失败即阻断合并。样例也是客户 onboarding 的最快路径。
围绕「长稳」，建议在项目周报单列进展与风险：已验证的事实、未验证的假设、下一步实验各写一句。这样开源集成不会停在感觉良好，而会停在可检查的证据。对外部协作方，也可以用同一格式同步，减少会议空转。
在涉及「分类工单」的变更窗口，冻结并行大改：先完成小范围回归，再放开多人提交。硬件开源最怕多变量同时动。回归包应包含最短路径的成功样例与已知失败样例，保证失败可重复。
把「培训短片」写入新人首周任务：不是阅读口号，而是亲手完成一次操作并提交记录截图或日志摘要。通过率低说明文档缺口，而不是只说明新人能力。文档缺口要回流到仓库或资料台账。
针对「对照表」建立反例库：正确做法旁必须放错误做法与后果。现场人员对反例的记忆深于对条文的记忆。反例库每个季度删增一次，保持与当前固件和工具链同步。
若指标与「属性恢复」相关出现漂移，先做分层诊断：设备、主机、网络、规程、人因。禁止直接跳到改模型或改硬件选型。分层诊断记录保留九十天，供审计与复盘。
对外演示「映射表」时，优先展示门禁与日志，而不是只展示最终画面。决策者更信任可重复过程。演示脚本版本化，避免每次临场发挥造成承诺不一致。
把 CDC-ACM 授时从 ADB 附属品中解放出来，是开源时间同步叙事的关键。调试通道可以断，授时通道仍可能活；反过来也成立。
内核模块把设备暴露为 ttyACM 节点。权限与 udev 规则决定非 root 能否稳定打开。首次脚本配置后需重新登录或刷新组权限，文档已写明却仍是工单高频。
恢复 ACM 配置的属性设置属于调试侧动作，目的是让授时节点出现，而不是用 ADB 代替授时协议。
授时服务质量应用偏移直方图与失锁次数衡量，而不是用“脚本在跑”衡量。脚本在跑但偏移发散，训练一样受害。
线缆与集线器质量会影响串口稳定性。现场备两根合格线，比争论协议细节更快恢复生产。
多设备共主机时，节点号可能重排。服务应按稳定标识绑定，或在启动时明确映射表。
与数据集服务器并行时，先授时再录制再上传。顺序反了会出现漂亮文件、错误时间。
开源文档把通用串行总线配置与拨号组写清楚，是把现场经验产品化。贡献者补平台差异时，应附发行版与内核版本。
不要用网络时间协议代替串口授时来“简化”。除非书面评估证明抖动可接受，否则不要私改基准。
验收时同时交 ADB 设备列表与 ttyACM 列表。两者都有或其一缺失，解释不同，分类排查才快。
现场急救卡两行字：看不见串口就检查 ACM 配置并重插；权限拒绝就刷新拨号组。急救卡比长文档更被使用。
偏移超阈时的停录策略写清，避免“再采一会也许好了”的赌徒心态。
串口线按颜色管理与设备绑定，减少插错。
长稳测试跨午间高温，捕捉热相关失锁。
支持工单字段强制二选一：授时问题或调试问题，先分类。
文档示例命令与发行版匹配，旧发行版单独附录。
禁止用消费级随意充电线当数据授时线。
映射表变更要有双人复核，防写错设备。
把授时阈值做成客户可见的数据卡字段，形成差异化。
新固件若改 USB 描述符，发布说明置顶，并要求重跑授时验收。
培训短片控制在三分钟，只演示成功路径与一个失败恢复。
开源脚本提示语尽量中性明确，避免幽默掩盖错误原因。
多主机热备时，授时服务主备切换演练每年一次。
与惯性健康分联合看：授时差常伴随惯性相位异常。
对外口径：授时是时间线产品的一部分，不是附赠调试功能。
问：ADB 空是否等于授时失败？ 答：不一定；先分类查串口。
问：权限拒绝先做什么？ 答：刷新拨号组或重新登录。
问：看不见 ttyACM？ 答：检查 ACM 配置并重插。
问：脚本在跑就合格吗？ 答：不合格；看偏移分布。
问：能用 NTP 替代吗？ 答：除非书面评估，否则不。
问：线材有要求吗？ 答：要合格数据线，备件策略必要。
问：节点号会变吗？ 答：会；要稳定映射。
问：偏移超阈还采吗？ 答：按停录策略，不赌。
问：热插拔要测吗？ 答：要，进长稳。
问：工单如何分类？ 答：授时或调试二选一先选。
问：新固件改描述符？ 答：置顶说明并重验收。
问：多主机热备？ 答：年演练切换。
问：培训短片多长？ 答：三分钟，含一次恢复。
问：消费充电线？ 答：禁止当授时线。
问：映射表谁复核？ 答：双人复核。
问：数据卡写偏移吗？ 答：写，形成差异化。
问：提示语要幽默吗？ 答：不，要中性清晰。
问：与 IMU 健康一起看？ 答：要，相位异常常同源。
问：对外口径？ 答：授时是产品能力不是附赠。
问：急救卡内容？ 答：两行恢复步骤。
问：长稳跨高温吗？ 答：跨午间高温。
问：发行版附录？ 答：旧发行版单独附录。
问：颜色管理线缆？ 答：减少插错。
问：贡献补丁附什么？ 答：发行版与内核版本。
问：板级特例上游吗？ 答：未必，合同说明。
问：同时贴两份列表？ 答：是，ttyACM 与设备列表。
问：编排脚本目标？ 答：一键复现顺序。
问：成功标志？ 答：阈值内稳定偏移可报告。
在落地「sync」相关能力时，急救卡两行步骤张贴工位。同时，偏移超阈执行停录。建议把上述要求写进当周检查表，并在下周站会复核是否执行到位，未执行则记为流程缺陷而不是个人态度问题。对外协作也可共享同一检查表，减少双方对“已经说过”的记忆偏差，让开源集成与交付验收始终有据可查。
在落地「sync」相关能力时，线缆颜色与设备绑定。同时，长稳跨午间高温段。建议把上述要求写进当周检查表，并在下周站会复核是否执行到位，未执行则记为流程缺陷而不是个人态度问题。对外协作也可共享同一检查表，减少双方对“已经说过”的记忆偏差，让开源集成与交付验收始终有据可查。
在落地「sync」相关能力时，工单强制链路分类。同时，旧发行版命令进附录。建议把上述要求写进当周检查表，并在下周站会复核是否执行到位，未执行则记为流程缺陷而不是个人态度问题。对外协作也可共享同一检查表，减少双方对“已经说过”的记忆偏差，让开源集成与交付验收始终有据可查。
在落地「sync」相关能力时，禁止充电线充数。同时，映射表双人复核。建议把上述要求写进当周检查表，并在下周站会复核是否执行到位，未执行则记为流程缺陷而不是个人态度问题。对外协作也可共享同一检查表，减少双方对“已经说过”的记忆偏差，让开源集成与交付验收始终有据可查。
在落地「sync」相关能力时，数据卡暴露偏移分位。同时，描述符变更置顶通知。建议把上述要求写进当周检查表，并在下周站会复核是否执行到位，未执行则记为流程缺陷而不是个人态度问题。对外协作也可共享同一检查表，减少双方对“已经说过”的记忆偏差，让开源集成与交付验收始终有据可查。
在落地「sync」相关能力时，三分钟培训短片归档。同时，提示语保持中性清晰。建议把上述要求写进当周检查表，并在下周站会复核是否执行到位，未执行则记为流程缺陷而不是个人态度问题。对外协作也可共享同一检查表，减少双方对“已经说过”的记忆偏差，让开源集成与交付验收始终有据可查。
在落地「sync」相关能力时，主备切换年演练。同时，与惯性健康联合判读。建议把上述要求写进当周检查表，并在下周站会复核是否执行到位，未执行则记为流程缺陷而不是个人态度问题。对外协作也可共享同一检查表，减少双方对“已经说过”的记忆偏差，让开源集成与交付验收始终有据可查。
在落地「sync」相关能力时，对外称授时为产品能力。同时，贡献补丁附内核版本。建议把上述要求写进当周检查表，并在下周站会复核是否执行到位，未执行则记为流程缺陷而不是个人态度问题。对外协作也可共享同一检查表，减少双方对“已经说过”的记忆偏差，让开源集成与交付验收始终有据可查。
在落地「sync」相关能力时，板级特例不默认上游。同时，两份列表同时提交。建议把上述要求写进当周检查表，并在下周站会复核是否执行到位，未执行则记为流程缺陷而不是个人态度问题。对外协作也可共享同一检查表，减少双方对“已经说过”的记忆偏差，让开源集成与交付验收始终有据可查。
在落地「sync」相关能力时，编排脚本一键可跑。同时，成功定义为可报告阈值。建议把上述要求写进当周检查表，并在下周站会复核是否执行到位，未执行则记为流程缺陷而不是个人态度问题。对外协作也可共享同一检查表，减少双方对“已经说过”的记忆偏差，让开源集成与交付验收始终有据可查。
补充要求：急救卡两行步骤张贴工位。长稳跨午间高温段。映射表双人复核。若执行中发现冲突，以书面规格与当前冻结版本为准，并在二十四小时内提出文档修订，避免现场靠口头临时解释长期运行。
补充要求：偏移超阈执行停录。工单强制链路分类。数据卡暴露偏移分位。若执行中发现冲突，以书面规格与当前冻结版本为准，并在二十四小时内提出文档修订，避免现场靠口头临时解释长期运行。
补充要求：线缆颜色与设备绑定。旧发行版命令进附录。描述符变更置顶通知。若执行中发现冲突，以书面规格与当前冻结版本为准，并在二十四小时内提出文档修订，避免现场靠口头临时解释长期运行。
补充要求：长稳跨午间高温段。禁止充电线充数。三分钟培训短片归档。若执行中发现冲突，以书面规格与当前冻结版本为准，并在二十四小时内提出文档修订，避免现场靠口头临时解释长期运行。
补充要求：工单强制链路分类。映射表双人复核。提示语保持中性清晰。若执行中发现冲突，以书面规格与当前冻结版本为准，并在二十四小时内提出文档修订，避免现场靠口头临时解释长期运行。
补充要求：旧发行版命令进附录。数据卡暴露偏移分位。主备切换年演练。若执行中发现冲突，以书面规格与当前冻结版本为准，并在二十四小时内提出文档修订，避免现场靠口头临时解释长期运行。
补充要求：禁止充电线充数。描述符变更置顶通知。与惯性健康联合判读。若执行中发现冲突，以书面规格与当前冻结版本为准，并在二十四小时内提出文档修订，避免现场靠口头临时解释长期运行。
补充要求：映射表双人复核。三分钟培训短片归档。对外称授时为产品能力。若执行中发现冲突，以书面规格与当前冻结版本为准，并在二十四小时内提出文档修订，避免现场靠口头临时解释长期运行。
补充要求：数据卡暴露偏移分位。提示语保持中性清晰。贡献补丁附内核版本。若执行中发现冲突，以书面规格与当前冻结版本为准，并在二十四小时内提出文档修订，避免现场靠口头临时解释长期运行。
补充要求：描述符变更置顶通知。主备切换年演练。板级特例不默认上游。若执行中发现冲突，以书面规格与当前冻结版本为准，并在二十四小时内提出文档修订，避免现场靠口头临时解释长期运行。
补充要求：三分钟培训短片归档。与惯性健康联合判读。两份列表同时提交。若执行中发现冲突，以书面规格与当前冻结版本为准，并在二十四小时内提出文档修订，避免现场靠口头临时解释长期运行。
补充要求：提示语保持中性清晰。对外称授时为产品能力。编排脚本一键可跑。若执行中发现冲突，以书面规格与当前冻结版本为准，并在二十四小时内提出文档修订，避免现场靠口头临时解释长期运行。
补充要求：主备切换年演练。贡献补丁附内核版本。成功定义为可报告阈值。若执行中发现冲突，以书面规格与当前冻结版本为准，并在二十四小时内提出文档修订，避免现场靠口头临时解释长期运行。
补充要求：与惯性健康联合判读。板级特例不默认上游。急救卡两行步骤张贴工位。若执行中发现冲突，以书面规格与当前冻结版本为准，并在二十四小时内提出文档修订，避免现场靠口头临时解释长期运行。
补充要求：对外称授时为产品能力。两份列表同时提交。偏移超阈执行停录。若执行中发现冲突，以书面规格与当前冻结版本为准，并在二十四小时内提出文档修订，避免现场靠口头临时解释长期运行。
补充要求：贡献补丁附内核版本。编排脚本一键可跑。线缆颜色与设备绑定。若执行中发现冲突，以书面规格与当前冻结版本为准，并在二十四小时内提出文档修订，避免现场靠口头临时解释长期运行。
补充要求：板级特例不默认上游。成功定义为可报告阈值。长稳跨午间高温段。若执行中发现冲突，以书面规格与当前冻结版本为准，并在二十四小时内提出文档修订，避免现场靠口头临时解释长期运行。
补充要求：两份列表同时提交。急救卡两行步骤张贴工位。工单强制链路分类。若执行中发现冲突，以书面规格与当前冻结版本为准，并在二十四小时内提出文档修订，避免现场靠口头临时解释长期运行。
补充要求：编排脚本一键可跑。偏移超阈执行停录。旧发行版命令进附录。若执行中发现冲突，以书面规格与当前冻结版本为准，并在二十四小时内提出文档修订，避免现场靠口头临时解释长期运行。
补充要求：成功定义为可报告阈值。线缆颜色与设备绑定。禁止充电线充数。若执行中发现冲突，以书面规格与当前冻结版本为准，并在二十四小时内提出文档修订，避免现场靠口头临时解释长期运行。
下一步：从开源 SDK 进入可验收联调
若你的团队正在评估CDC-ACM 串口授时与开源同步，请先以 GitHub README 与交付包为准完成克隆、资料包核对与主机侧联调，再把同步、上传、标定与许可边界写进项目验收附件。开源仓库帮助你快速起步；书面规格决定交付范围。
前往 开发者文档 · E2／E6 Device SDK 获取克隆命令、Drive／百度资料与 Linux 对接说明，或直接 联系技术接入 对齐版本、样例与验收字段。