V5 API Doc

开始阅读前,请先理解以下约定

先弄清文档提供什么、不提供什么;再按下面的电压与最大结束时间规则写控制程序,避免程序卡死。

说明

API 文档只提供模板内容,不提供新内容

文档给出的是通用模板与基础接口,方便直接调用。若你在小车上加了文档里没有的机构或功能,需要自行封装函数或类,文档不会为这些自定义部分提供现成接口。

示例 · 自行加装侧翻

例如在小车侧边加装了侧翻机构:文档不会提供「侧翻」接口,需要你自己封装函数或类来控制它。

约定一

电压区间为 ±12.8 V

文档中的电压取值范围是 −12.8 V ~ +12.8 V。正负决定转向,绝对值决定速度:绝对值越大转得越快;电压减半,速度约减半。

+12.8 V 满速正转
−12.8 V 满速反转
+6.4 V 约一半速度正转
方向与速度对照(示意)
+12.8 V正转 · 100% 速度
+6.4 V正转 · 50% 速度
−12.8 V反转 · 100% 速度
约定二

最大结束时间:按实际情况留足余量

「最大结束时间」没有固定公式,需要根据实测路程、电压与到达时间来判断:只要大于实际跑完全程所需时间即可。

示例 1 · 高电压、短时间

小车跑 600 毫米,以 12.8 V 运行,约 0.5 s 到达。最大结束时间只要 > 0.5 s 即可(例如设为 1 s)。

示例 2 · 低电压、较长时间

同样跑 600 毫米,以 5.0 V 运行,约 1 s 才到达。最大结束时间只要 > 1 s 即可(例如设为 2 s)。

目的:防止程序一直等待而卡死,导致后面的程序无法继续执行。留一点余量,动作完成就能往下走;超时则结束当前等待,保证流程不堵死。
后续接口说明均以上述约定为准 · V5 API Doc