Files
sunnypilot-guide/02-快速上手.md
2026-05-12 10:14:32 +08:00

5.2 KiB
Raw Permalink Blame History

第二章:快速上手——设备设置

这一章带你完成 sunnypilot 的基础设置,就像新手机开机后要连 Wi-Fi、登录账号一样。


2.1 Device Settings设备设置

在哪里? Settings → Device

设备名称

你可以给自己的设备起个名字,方便在 Sunnylink 云服务里辨认。

单位制

选择你习惯的单位:公制km/h 还是英制mph

🇨🇳 国内用户当然选 km/h

摄像头偏移Camera Offset

如果你的设备安装位置不在正中间(比如偏左或偏右了一点),可以微调这个值。范围:-0.35 到 +0.35

什么情况要调? 安装设备后发现车子在车道里总偏一边,就可以调一下。

⚠️ 默认是 0只有安装偏了才需要调。

录制模式Recording Mode

  • 开启:所有驾驶过程都会被录制
  • 关闭:不录制

GPS 参数GPS Parameters

显示当前的 GPS 坐标,正常开车时会有数据。如果长时间显示"无数据",检查设备安装。

硬件信息Hardware Info

这里显示你的设备型号、序列号、软件版本号——以后跟技术支持沟通时可能会用到。


2.2 Network Settings网络设置

在哪里? Settings → Network

Wi-Fi 连接

像连手机一样,选择你的 Wi-Fi 网络,输入密码。

💡 为什么要连 Wi-Fi

  • 下载新版本系统更新
  • 下载地图数据(用于限速辅助等)
  • 上传驾驶数据Firehose 模式)
  • 和 Sunnylink 云服务通信

建议

  • 停车的地方要有 Wi-Fi 覆盖(比如家里的车库)
  • 如果没有 Wi-Fi也可以用手机热点注意流量消耗

在 comma four 设备上,网络设置是通过 Sunnylink 网页端来配置的。


2.3 Software Settings软件设置

在哪里? Settings → Software

当前分支Current Branch

显示你当前运行的是哪个版本的 sunnypilot比如 staging、dev、release 等)。

已安装版本Installed Version

显示具体的版本号。

更新检查

  • Check Now:立即检查有没有新版本
  • 如果有更新,会提示你下载安装

安装目标分支Target Branch

如果你想切换到不同的分支(比如从 release 切到 staging在这里设置。

更新通知

有新版本时要不要提醒你?开或关。

取消未决更新Cancel Pending Update

如果你不小心点了更新或者不想更新了,可以在这里取消。

禁用更新Disable Updates

⚠️ 高级玩家才会用到。 禁用后不再检查更新。需要在 Developer Settings 里开启"显示高级控制"才能看到这个选项。


在哪里? Settings → Sunnylink

Sunnylink 是 sunnypilot 的云服务平台,帮你安全备份设置远程管理设备

主开关。第一次开启会弹出一个同意提示,确认后才能使用。

📌 只有停车状态下才能开关。

赞助者身份Sponsor Status

显示你的赞助等级。赞助者可以提前体验 Sunnylink 新功能。

关联 GitHub 账号Pair GitHub Account

把你的 GitHub 账号和设备绑定——用于验证赞助身份。

目前仅对最高级别赞助者开放。用来上传驾驶数据测试云服务基础设施。

备份/恢复设置Backup / Restore Settings

这是最有用的两个功能!

操作 说明
备份设置 把你所有的 sunnypilot 配置加密上传到云端。如果以后设备出问题或换设备,一键恢复
恢复设置 从云端下载最近一次备份,恢复所有配置

💡 小白建议:每次调整完重要设置后,顺手备份一下!

设备 IDDongle ID

你的设备的唯一标识码,和设备相关联。


2.5 OSM Settings地图数据下载

在哪里? Settings → OSM

⚠️ 注意:只有 comma 3X/3 设备才有这个设置页面。 comma four 用户需要通过 Sunnylink 网页端配置。

为什么需要下载地图?

OSMOpenStreetMap开源地图数据用于

  • 限速辅助:知道当前道路的限速是多少
  • 弯道减速:预测前方弯道提前减速
  • 显示道路名称

怎么下载?

  1. 点击 Country国家 → 选择你的国家
  2. (如果选美国)点击 State 选择具体的州
  3. 点击 Database Update数据库更新 → 点击 CHECK 检查更新
  4. 系统会自动下载,等进度条走完就行

已下载地图管理

  • 会显示当前地图数据占用了多少存储空间
  • DELETE 按钮可以删除所有已下载的地图(释放空间)

地图版本Mapd Version

显示设备上当前运行的地图处理服务的版本号。

💡 建议:首次安装后先下载你所在地区的地图数据。如果开车经过新地方,再回来更新。