tillsteinbach/weconnect-mqtt

WeConnect-MQTT

![PyPI - Downloads]([] ![PyPI - Python Version]([] ![Donate at ]([]

MQTT客户端，用于从大众WeConnect服务发布车辆数据。

用途概述

如果您希望将支持WeConnect的车辆数据集成到系统中，MQTT这类标准协议会非常有用。该客户端可让您与所选的MQTT代理集成（例如家庭自动化解决方案，如ioBroker、FHEM或Home Assistant）。

安装方法

使用docker-compose

通过docker-compose配置WeConnect-MQTT的示例如下：

yml
version: '3.3'

services:
  weconnect-mqtt:
    image: "tillsteinbach/weconnect-mqtt:latest"
    restart: unless-stopped
    environment:
      - TZ=Europe/Berlin  # 时区设置
      - LC_ALL=de_DE      # 区域设置，影响时间格式等
      - USER=my@vwid-user.de  # WeConnect用户名（VWID）
      - PASSWORD=myvwidpassword  # WeConnect密码
      - BROKER_ADDRESS=192.168.0.1  # MQTT代理地址
      - ADDITIONAL_PARAMETERS=--mqtt-username test --mqtt-password test  # MQTT认证等额外参数

S-PIN

某些命令（如部分车型支持的锁定/解锁）除登录信息外，还需要所谓的S-PIN。可通过--spin选项提供：

bash
ADDITIONAL_PARAMETERS=--mqtt-username test --mqtt-password test --spin 1234  # 1234为您的S-PIN

时间设置

默认情况下，车辆返回的时间为UTC isoformat格式。您可以添加--convert-times参数将时间转换为本地时区（使用TZ变量指定的时区）。如需按本地格式显示时间，可在ADDITIONAL_PARAMETERS中添加--timeformat，这将使用LC_ALL变量指定的区域设置默认日期/时间格式。若需自定义格式，例如：

bash
ADDITIONAL_PARAMETERS=--convert-times --timeformat '%a %d %b %Y %T'  # 格式示例："Wed 05 Jun 2024 14:30:00"

不使用Docker

若不使用Docker，可从PyPI获取独立应用，通过以下命令安装：

bash
pip install weconnect-mqtt

已测试车型

• 大众ID.3 2021款
• 大众Passat GTE 2021款

问题反馈

如发现问题，欢迎通过https://github.com/tillsteinbach/WeConnect-mqtt/issues%E6%8F%90%E4%BA%A4%E3%80%82

更多问题？

请参阅https://github.com/tillsteinbach/WeConnect-mqtt/wiki%E6%88%96%E5%8F%91%E8%B5%B7https://github.com/tillsteinbach/WeConnect-mqtt/discussions%E3%80%82

已知问题

• 该工具目前处于alpha阶段，功能可能随时发生意外变更！

相关项目

• https://github.com/tillsteinbach/WeConnect-cli%EF%BC%9A%E4%B8%8E%E5%A4%A7%E4%BC%97WeConnect%E6%9C%8D%E5%8A%A1%E4%BA%A4%E4%BA%92%E7%9A%84%E5%91%BD%E4%BB%A4%E8%A1%8C%E7%95%8C%E9%9D%A2
• https://github.com/tillsteinbach/WeConnect-python%EF%BC%9A%E8%BF%9E%E6%8E%A5%E5%A4%A7%E4%BC%97WeConnect%E6%9C%8D%E5%8A%A1%E7%9A%84Python API
• https://github.com/tillsteinbach/VWsFriend%EF%BC%9A%E5%8F%AF%E8%A7%86%E5%8C%96%E5%92%8C%E8%AE%B0%E5%BD%95%E8%BD%A6%E8%BE%86%E7%BB%9F%E8%AE%A1%E6%95%B0%E6%8D%AE%EF%BC%8C%E5%B9%B6%E6%94%AF%E6%8C%81%E9%80%9A%E8%BF%87HomeKit%E6%8E%A7%E5%88%B6%E8%BD%A6%E8%BE%86%E7%9A%84%E8%BD%AF%E4%BB%B6