Volkswagen Connect 组件指南 for Home Assistant
项目介绍
Volkswagen Connect 是一个专为 Home Assistant 设计的自定义组件,它允许您与大众汽车的 Volkswagen Connect 服务进行交互(仅限欧洲区域)。此组件支持包括Passat、Golf、e-Golf、Tiguan以及ID系列等在内的多种大众车型。要求您的车辆需有一个活跃且功能正常的在线订阅。通过这个整合,您可以享受到类似于“Volkswagen Connect”应用程序的功能,如远程控制辅助加热器等。值得注意的是,目前主要验证在欧盟地区使用的车辆上,鼓励贡献者帮助扩展其在美国或其他地区的兼容性。
项目快速启动
为了快速启动并运行 Volkswagen Connect 组件,您需要遵循以下步骤:
安装前提
确保您的 Home Assistant 系统已准备好安装自定义组件,并且您已经启用了 HACS(Home Assistant Community Store)或者准备手动添加组件。
手动安装步骤
-
克隆仓库
在您的 Home Assistant 的custom_components
目录下创建(如果不存在的话)并进入该目录。mkdir -p /config/custom_components/volkswagencarnet cd /config/custom_components/volkswagencarnet
-
下载组件
使用 Git 克隆仓库或直接下载ZIP文件解压到当前目录。git clone https://github.com/robinostlund/homeassistant-volkswagencarnet.git .
或 下载ZIP文件然后解压缩到当前目录。
-
配置 Home Assistant
打开您的configuration.yaml
文件,加入以下配置段落:sensor: - platform: volkswagencarnet username: "您的Volkswagen Connect用户名" password: "您的Volkswagen Connect密码" ScanInterval: 30 # 可选,设置更新间隔(默认30分钟) vehicles: - vin: "您的车辆识别号"
-
重启 Home Assistant
完成上述步骤后,重启您的 Home Assistant 实例以加载新组件。 -
启用调试日志(可选) 要查看更详细的日志以便于故障排查,可以在
configuration.yaml
中添加:logger: default: warning logs: custom_components.volkswagencarnet: debug
应用案例与最佳实践
-
自动化示例: 利用 Volkswagen Connect 组件的数据来触发自动化,例如当车门未锁时发送通知。
automation: trigger: platform: state entity_id: sensor.your_car_door_status to: 'open' action: service: notify.notify data: message: "警告:您的车门未锁!"
-
最佳实践: 定期检查并更新组件至最新版本以获取最新的功能和修复。利用 Home Assistant 的自动升级机制或手动检查仓库更新。
典型生态项目
-
Lovelace UI 卡片集成
推荐使用 endor-force/lovelace-carnet 这个 Lovelace 卡片,它为 Volkswagen Connect 数据提供了美观且用户友好的展示方式。 -
与 Node-RED 结合
观看 Tristan 的视频 学习如何将此组件与 Node-RED 集成,实现更多高级自动化逻辑。
通过这些步骤和提示,您可以充分利用 Volkswagen Connect 组件,在 Home Assistant 平台上享受更加智能化的车辆管理体验。记得遵守官方社区的指导原则和安全措施,愉快地定制您的智能家居系统!