fetzu/teslamate-abrp Docker 镜像 - 轩辕镜像

TeslaMate: MQTT 至 ABRP 桥梁

![codecov]([] ![Test and Build]([] ![Test and Build]([] ![Test and Build]([] ![GitHub release]([] ![Docker Image Size]([] ![Docker Pulls]([] ![GitHub license]([]

一个将Tesla车辆数据从TeslaMate发送到A Better Route Planner (ABRP)的桥梁。

特性

• 自动将MQTT TeslaMate数据发送至A Better Route Planner
• 基于车辆状态（行驶中、充电中、停放）的可变（且可配置）更新频率
• 用于认证和(MQTT)TLS加密的安全MQTT选项
• 支持Docker密钥管理
• 可选的位置***化
• Alpha（前沿版本）镜像可在fetzu/teslamate-abrp:alpha获取
• Beta（预发布版）镜像可在fetzu/teslamate-abrp:beta获取

设置指南

前提条件

• 已启用MQTT的TeslaMate实例
• ABRP用户令牌
• Docker（推荐）或Python 3.x环境

获取ABRP用户令牌

1. 登录ABRP网页应用或移动应用
2. 导航至您的车辆设置
3. 使用"通用"卡片（底部最后一个）生成用户令牌
4. 安全保存此令牌 - 配置teslamate-abrp时需要使用

选项1：Docker设置（推荐）

将teslamate-abrp服务添加到现有TeslaMate的docker-compose.yml中：

yaml
ABRP:
  container_name: TeslaMate_ABRP
  image: fetzu/teslamate-abrp:latest
  restart: always
  environment:
    - MQTT_SERVER=mosquitto
    - USER_TOKEN=您的ABRP用户令牌
    - CAR_NUMBER=1
    # 可选参数（参见配置部分）
    # - CAR_MODEL=tesla:m3:20:bt37:heatpump
    # - MQTT_USERNAME=用户名
    # - MQTT_PASSWORD=密码
    # - MQTT_PORT=1883
    # - MQTT_TLS=True
    # - STATUS_TOPIC=teslamate-abrp
    # - SKIP_LOCATION=True
    # - TM2ABRP_DEBUG=True

部署服务：

bash
docker-compose pull ABRP
docker-compose up -d ABRP

选项2：使用Docker密钥（更安全）

为提高安全性，使用Docker密钥管理敏感信息：

yaml
version: '3'
services:
  ABRP:
    container_name: TeslaMate_ABRP
    image: fetzu/teslamate-abrp:latest
    restart: always
    environment:
      - MQTT_SERVER=mosquitto
      - CAR_NUMBER=1
      - MQTT_USERNAME=用户名
      - MQTT_TLS=True
      - MQTT_PORT=8883
    secrets:
      - USER_TOKEN
      - MQTT_PASSWORD

secrets:
  USER_TOKEN:
    file: ./path/to/abrp-token.txt
  MQTT_PASSWORD:
    file: ./path/to/mqtt-password.txt

选项3：作为Python脚本运行

1. 克隆仓库：

   bash
   git clone [***]
   cd teslamate-abrp
   

2. 安装依赖：

   bash
   pip install -r requirements.txt
   

3. 运行脚本：

   bash
   python teslamate_mqtt2abrp.py USER_TOKEN 1 mqtt-server-address
   

配置

必要参数

可选参数

车型识别

为获得最佳路线规划，建议使用CAR_MODEL参数手动指定车型。从以下地址获取正确标识符：

[***]

示例：

• 带热泵的特斯拉Model 3长续航版：tesla:m3:20:bt37:heatpump
• 特斯拉Model Y Performance：tesla:my:19:bt37:perf
• 特斯拉Model S 100D：s100d

故障排除

1. 检查日志中的连接问题：

   bash
   docker-compose logs ABRP
   

2. 验证MQTT连接性：

   bash
   docker-compose exec ABRP python -c "import paho.mqtt.client as mqtt; client = mqtt.Client(); client.connect('mosquitto', 1883); print('连接成功')"
   

3. 常见问题：

   • MQTT服务器无法访问
   • MQTT凭据不正确
   • ABRP令牌无效
   • TeslaMate车辆编号错误

高级用法

自定义更新频率

应用根据车辆状态使用不同的更新频率：

• 行驶中：每1秒更新
• 充电中：每6秒更新
• 停放/休眠：每30秒更新

这些值可通过编辑Python脚本顶部的常量进行自定义。

credits

基于letienne的原始代码，并由多位贡献者改进（参见提交历史）。

许可证

基于MIT许可证授权。===SHORT_DESC=== 一个将TeslaMate的车辆数据通过MQTT发送到A Better Route Planner (ABRP)的桥梁，支持基于车辆状态的可变更新频率、安全MQTT配置及位置***化等功能。 ===FULL_DESC===# TeslaMate: MQTT 至 ABRP 桥梁

![codecov]([] ![Test and Build]([] ![Test and Build]([] ![Test and Build]([] ![GitHub release]([] ![Docker Image Size]([] ![Docker Pulls]([] ![GitHub license]([]

一个将Tesla车辆数据从TeslaMate发送到A Better Route Planner (ABRP)的桥梁。

特性

• 自动将MQTT TeslaMate数据发送至A Better Route Planner
• 基于车辆状态（行驶中、充电中、停放）的可变（且可配置）更新频率
• 用于认证和(MQTT)TLS加密的安全MQTT选项
• 支持Docker密钥管理
• 可选的位置***化
• Alpha（前沿版本）镜像可在fetzu/teslamate-abrp:alpha获取
• Beta（预发布版）镜像可在fetzu/teslamate-abrp:beta获取

设置指南

前提条件

• 已启用MQTT的TeslaMate实例
• ABRP用户令牌
• Docker（推荐）或Python 3.x环境

获取ABRP用户令牌

1. 登录ABRP网页应用或移动应用
2. 导航至您的车辆设置
3. 使用"通用"卡片（底部最后一个）生成用户令牌
4. 安全保存此令牌 - 配置teslamate-abrp时需要使用

选项1：Docker设置（推荐）

将teslamate-abrp服务添加到现有TeslaMate的docker-compose.yml中：

yaml
ABRP:
  container_name: TeslaMate_ABRP
  image: fetzu/teslamate-abrp:latest
  restart: always
  environment:
    - MQTT_SERVER=mosquitto
    - USER_TOKEN=您的ABRP用户令牌
    - CAR_NUMBER=1
    # 可选参数（参见配置部分）
    # - CAR_MODEL=tesla:m3:20:bt37:heatpump
    # - MQTT_USERNAME=用户名
    # - MQTT_PASSWORD=密码
    # - MQTT_PORT=1883
    # - MQTT_TLS=True
    # - STATUS_TOPIC=teslamate-abrp
    # - SKIP_LOCATION=True
    # - TM2ABRP_DEBUG=True

部署服务：

bash
docker-compose pull ABRP
docker-compose up -d ABRP

选项2：使用Docker密钥（更安全）

为提高安全性，使用Docker密钥管理敏感信息：

yaml
version: '3'
services:
  ABRP:
    container_name: TeslaMate_ABRP
    image: fetzu/teslamate-abrp:latest
    restart: always
    environment:
      - MQTT_SERVER=mosquitto
      - CAR_NUMBER=1
      - MQTT_USERNAME=用户名
      - MQTT_TLS=True
      - MQTT_PORT=8883
    secrets:
      - USER_TOKEN
      - MQTT_PASSWORD

secrets:
  USER_TOKEN:
    file: ./path/to/abrp-token.txt
  MQTT_PASSWORD:
    file: ./path/to/mqtt-password.txt

选项3：作为Python脚本运行

1. 克隆仓库：

   bash
   git clone [***]
   cd teslamate-abrp
   

2. 安装依赖：

   bash
   pip install -r requirements.txt
   

3. 运行脚本：

   bash
   python teslamate_mqtt2abrp.py USER_TOKEN 1 mqtt-server-address
   

配置

必要参数

可选参数

车型识别

为获得最佳路线规划，建议使用CAR_MODEL参数手动指定车型。从以下地址获取正确标识符：

[***]

示例：

• 带热泵的特斯拉Model 3长续航版：tesla:m3:20:bt37:heatpump
• 特斯拉Model Y Performance：tesla:my:19:bt37:perf
• 特斯拉Model S 100D：s100d

故障排除

1. 检查日志中的连接问题：

   bash
   docker-compose logs ABRP
   

2. 验证MQTT连接性：

   bash
   docker-compose exec ABRP python -c "import paho.mqtt.client as mqtt; client = mqtt.Client(); client.connect('mosquitto', 1883); print('连接成功')"
   

3. 常见问题：

   • MQTT服务器无法访问
   • MQTT凭据不正确
   • ABRP令牌无效
   • TeslaMate车辆编号错误

高级用法

自定义更新频率

应用根据车辆状态使用不同的更新频率：

• 行驶中：每1秒更新
• 充电中：每6秒更新
• 停放/休眠：每30秒更新

这些值可通过编辑Python脚本顶部的常量进行自定义。

credits

基于letienne的原始代码，并由多位贡献者改进（参见提交历史）。

许可证

基于MIT许可证授权。