robinostlund/homeassistant-volkswagencarnet 源：https://github.com/robinostlund/homeassistant-volkswagencarnet hacs_badge (https://github.com/hacs/integration) 版本 PyPi 下载 代码风格 已知漏洞 CodeQL (https://github.com/robinostlund/homeassistant-volkswagencarnet/actions/workflows/codeql-analysis.yml) # Volkswagen Connect - 一个与大众互联服务交互的 Home Assistant 自定义组件（仅限欧盟）

支持该项目

买杯咖啡给我 (https://www.buymeacoffee.com/robinostlund)

描述

欢迎使用 Volkswagen Connect 自定义组件 for Home Assistant (https://www.home-assistant.io)，它允许您与大众互联服务以及您的汽车进行交互。此组件支持 大众互联车辆，例如 Passat、Golf、e-Golf、Tiguan、ID 系列等。需要与您的汽车关联的有效 VW 在线订阅。新款电动汽车（包括 ID 系列）也受支持。该集成可访问官方“Volkswagen Connect”应用中的大部分功能。

注意： 到目前为止，此组件仅在 欧盟 销售的汽车上被成功验证。欢迎贡献代码以支持欧盟以外的车辆（例如美国）。目前，我们无法访问非欧盟的 VW Connect 账户来验证功能。

安装

使用 HACS 安装（推荐）

打开您的 Home Assistant 实例，并在 Home Assistant Community Store 中打开一个仓库。(https://my.home-assistant.io/redirect/hacs_repository/?owner=robinostlund&repository=homeassistant-volkswagencarnet&category=Integration)

或者，在 HACS 中搜索 Volkswagen Connect，并在 集成 类别下安装它。

1. 重启 Home Assistant。
2. 在 Home Assistant 界面中，进入 设置 → 集成，点击 + 添加集成，搜索 Volkswagen Connect。HACS 将自动跟踪更新，方便您升级到最新版本。

手动安装

更多详情：

• 从最新发布的版本 (https://github.com/robinostlund/homeassistant-volkswagencarnet/releases) 下载 volkswagencarnet.zip 文件。
• 将 custom_components 目录的内容解压到您的 Home Assistant 安装目录的 /custom_components 文件夹中。
• 重启 Home Assistant。
• 在 Home Assistant 界面中，进入 设置 → 集成，点击 + 添加集成，搜索 Volkswagen Connect。

请注意，只有打包的发布版本（zip 文件）包含了依赖配置，以便 Home Assistant 能够自动找到它们。如果您使用源代码或 git 分支，则需要手动安装所有正确版本的依赖项，例如使用 pip install -r requirements.txt。

配置

• 重启 Home Assistant
• 通过界面添加并配置组件：配置 > 集成 > 搜索 “Volkswagen Connect” 并按照向导进行配置（使用您的 Volkswagen Connect 凭据）
• 选择车辆识别码（VIN）后，您汽车的所有可用功能应自动添加。

配置流程设置

• 命名您的汽车 - 输入自定义名称，默认为 VIN（可选）
• 用户名/密码 - Volkswagen Connect（必填）
• 地区 - 车辆销售的国家（必填）
• 可变操作 - 如果启用，您可以与汽车交互；如果禁用，仅呈现汽车数据（可选）
• S-PIN - 某些特定选项（如锁车/解锁）需要（可选）
• 距离单位转换 - 选择是否使用 “斯堪的纳维亚英里 (mil)” 或英制英里 (mi) 代替公里（可选，默认为公里）
• 传感器更新间隔（分钟） - 设置从车辆获取数据的频率（默认：5 分钟，范围：0-60）。较低的值提供更频繁的更新，但会使用更多 API 调用。设置为 0 可禁用自动更新（仅手动刷新）。您还可以在设置后使用“扫描间隔”数字实体为每辆车调整此值。

图片

注意： 大众 API 每天有 480 次调用 的连接限制（大约每 3 分钟一次调用）。此集成的默认更新间隔 5 分钟 将每天使用 288 次调用，仅剩余 192 次调用 用于其他应用程序（例如官方 VW 应用），这可能不够。如果您计划将此集成与官方 VW 应用同时使用，建议 将更新间隔增加到 10 分钟。您可以通过进入 Home Assistant 中的集成，选择 配置，然后修改 传感器更新间隔（分钟） 来进行调整。

遇到此组件的问题？

在创建问题之前，请确保通过网页浏览器，您的 VW Connect 服务能够正常使用。不仅要测试登录，还要测试服务是否能正确与您的汽车交互，包括传感器更新和位置跟踪。此组件完全依赖 VW Connect 服务—如果他们的服务出现问题，该集成将无法工作。其可靠性完全取决于 VW Connect 平台本身。

启用调试日志

查看此 Wiki 页面：https://github.com/robinostlund/homeassistant-volkswagencarnet/wiki/Enabling-Debug-Logging-in-Home-Assistant

致谢

衷心感谢所有贡献者—您的代码、反馈、测试和支持是推动此项目前进的动力。每一份贡献，无论大小，都真诚感谢！❤️