tesla

tesla

Tesla车辆和能源管理的Home Assistant自定义集成组件

这是一个基于Home Assistant的Tesla自定义集成组件,提供Tesla车辆和能源站点的全面管理功能。包括车辆状态监控、远程控制、充电管理、位置追踪以及Powerwall能源管理。组件采用定期轮询和事件触发方式更新数据,并提供灵活配置选项以平衡功能与电池消耗。适用于希望将Tesla设备整合到智能家居系统的用户。

TeslaHome Assistant集成API自动化Github开源项目

Tesla 自定义集成

GitHub 发布 GitHub 所有发布 GitHub 发布 (最新语义化版本) GitHub 活动

许可证

hacs 项目维护 赞助

Discord 社区论坛

这是之前 Home Assistant 官方 Tesla 集成的一个分支,由于 Tesla 登录问题,官方集成已被移除。请勿向 Home Assistant 报告问题。

要使用此组件,您需要一个应用程序来生成 Tesla 刷新令牌:

安装

  1. 使用 HACS,在 HACS > 集成 > 浏览并添加存储库 中搜索 "Tesla"。将 https://github.com/alandtse/tesla 添加为自定义存储库后,跳至步骤 7。
  2. 如果您没有 HACS,请使用您选择的工具打开 HA 配置目录(您可以找到 configuration.yaml 的位置)。
  3. 如果该目录中没有 custom_components 目录,您需要创建一个。
  4. custom_components 目录中创建一个名为 tesla_custom 的新文件夹。
  5. 从本仓库的 custom_components/tesla_custom/ 目录下载所有文件。
  6. 将下载的文件放入您创建的新目录中。
  7. 重启 Home Assistant。
  8. 添加集成 或在 HA 用户界面中,转到 "设置" -> "设备和服务",然后点击 "+" 并搜索 "Tesla 自定义集成"。
  9. 对于大多数车辆,您需要使用 Tesla Fleet API 代理(见下文)。

注意:此集成在安装过程中会唤醒您的车辆。

Tesla Fleet API 代理

Tesla 已经弃用了大多数车辆的 Owner API,转而使用具有端到端加密的新 Fleet API。如果您在尝试发送命令时在日志中看到错误,就说明您受到了影响(传感器无论如何都会正常工作)。

如果您的车辆受到影响(很可能如此),您需要安装 Tesla HTTP 代理 附加组件,并配置此组件以使用它。这需要复杂的设置;详情请参阅此处。配置完附加组件后,在此组件中勾选 "Fleet API 代理" 选项,配置流程将自动填写您的客户端 ID、代理 URL 和 SSL 证书。

使用

Tesla 集成提供了与 Tesla 云服务的集成,并提供存在检测以及充电器状态和温度等传感器。

此集成为车辆提供以下实体:

  • 二进制传感器 - 充电器连接、充电状态、车辆在线、驻车制动、车辆休眠和车门状态。
  • 按钮 - 喇叭、闪灯、唤醒<sup>1</sup>、强制数据更新<sup>1</sup>、触发 HomeLink 和远程启动。注意: HomeLink 按钮默认禁用,因为某些车辆没有此选项。如果需要,可通过配置/实体启用。
  • 空调 - 开启/关闭空调、设置目标温度、设置预设模式(除霜、保持开启、宠物模式和露营模式)。
  • 设备追踪器 - 车辆位置<sup>1</sup>和当前路线目的地。
  • 车门 - 充电口门、前备箱、后备箱和车窗。
  • 锁 - 车门锁和充电口锁。 注意:状态 设置为 heat_cooloff 可通过场景启用/禁用 Tesla 的空调系统。
  • 选择器 - 座椅加热和客舱过热保护<sup>2</sup>注意: 开启座椅加热将导致空调开启。
  • 传感器 - 电池电量、充电速率、已添加能量、充电器功率、内/外温度、里程表、预估续航里程、充电完成时间、胎压监测系统压力、当前路线到达时间和到达距离。
  • 开关 - 方向盘加热、充电器、哨兵模式、轮询和代客模式<sup>1</sup>
  • 更新 - 软件更新<sup>2</sup>

<sup>1</sup> 诊断实体。<br/> <sup>2</sup> 配置实体。

此集成为能源站点提供以下实体:

  • 二进制传感器 - Powerwall 充电和电网状态。
  • 选择器 - 电网充电、输出规则和运行模式。
  • 传感器 - 太阳能发电量、电网功率、负载功率、电池电量、电池剩余瓦时和备用储备。

选项

Tesla 选项可通过 配置 -> 集成 -> Tesla -> 选项 进行设置。

  • 轮询间隔秒数 - 下文称为 polling_interval
  • 启动时唤醒车辆 - 是否在 Home Assistant 启动时唤醒休眠的车辆。这允许用户选择是否让车辆继续休眠(不更新信息),或唤醒车辆,可能会中断长期休眠并增加静态耗电。
  • 轮询策略 - 我们何时主动轮询车辆以获取更新,何时尝试让车辆休眠。详情请参阅 Wiki
  • 通过 MQTT 从 TeslaMate 同步数据 - 启用通过 MQTT 从 TeslaMate 实例同步数据,本质上为更新启用流式 API。这需要在 Home Assistant 中配置 MQTT。

潜在的电池影响

以下是在实施 Tesla 组件时需要考虑和了解的一些事项,以及它可能对您车辆电池的影响。

  • polling_interval决定何时检查车辆是否处于唤醒状态并有新信息可用,但Tesla集成不会在轮询期间唤醒休眠中的车辆。默认情况下,轮询将每660秒进行一次。过于频繁地轮询车辆可能会使车辆保持唤醒状态并耗尽电池。不同固件版本和Tesla车型的测量结果显示,进入睡眠模式可能需要11到15分钟。由于没有关于睡眠模式时间的官方信息,因此您的实际情况可能有所不同,建议尝试不同的轮询时间以获得最佳体验。

  • 然而,当主动向车辆发送命令时(如解锁车门或打开空调),车辆会被唤醒。此时,它还会根据polling_interval在车辆唤醒期间获取更新的信息。

  • 可以通过发送无害命令(例如锁车命令)来故意唤醒车辆以获取最新信息。这可以用于自动化中,例如确保每天早晨都能获得更新的信息。(请注意,命令必须适用于特定车型。比如,给Model 3的前备箱上锁不会唤醒该车。)

  • 您还可以通过自动化或Lovelace UI来打开/关闭polling switch,完全禁用对车辆的轮询。

欢迎贡献!

如果您想为此项目贡献,请阅读贡献指南

组件基于integration_blueprint构建。


编辑推荐精选

讯飞智文

讯飞智文

一键生成PPT和Word,让学习生活更轻松

讯飞智文是一个利用 AI 技术的项目,能够帮助用户生成 PPT 以及各类文档。无论是商业领域的市场分析报告、年度目标制定,还是学生群体的职业生涯规划、实习避坑指南,亦或是活动策划、旅游攻略等内容,它都能提供支持,帮助用户精准表达,轻松呈现各种信息。

AI办公办公工具AI工具讯飞智文AI在线生成PPTAI撰写助手多语种文档生成AI自动配图热门
讯飞星火

讯飞星火

深度推理能力全新升级,全面对标OpenAI o1

科大讯飞的星火大模型,支持语言理解、知识问答和文本创作等多功能,适用于多种文件和业务场景,提升办公和日常生活的效率。讯飞星火是一个提供丰富智能服务的平台,涵盖科技资讯、图像创作、写作辅助、编程解答、科研文献解读等功能,能为不同需求的用户提供便捷高效的帮助,助力用户轻松获取信息、解决问题,满足多样化使用场景。

热门AI开发模型训练AI工具讯飞星火大模型智能问答内容创作多语种支持智慧生活
Spark-TTS

Spark-TTS

一种基于大语言模型的高效单流解耦语音令牌文本到语音合成模型

Spark-TTS 是一个基于 PyTorch 的开源文本到语音合成项目,由多个知名机构联合参与。该项目提供了高效的 LLM(大语言模型)驱动的语音合成方案,支持语音克隆和语音创建功能,可通过命令行界面(CLI)和 Web UI 两种方式使用。用户可以根据需求调整语音的性别、音高、速度等参数,生成高质量的语音。该项目适用于多种场景,如有声读物制作、智能语音助手开发等。

Trae

Trae

字节跳动发布的AI编程神器IDE

Trae是一种自适应的集成开发环境(IDE),通过自动化和多元协作改变开发流程。利用Trae,团队能够更快速、精确地编写和部署代码,从而提高编程效率和项目交付速度。Trae具备上下文感知和代码自动完成功能,是提升开发效率的理想工具。

AI工具TraeAI IDE协作生产力转型热门
咔片PPT

咔片PPT

AI助力,做PPT更简单!

咔片是一款轻量化在线演示设计工具,借助 AI 技术,实现从内容生成到智能设计的一站式 PPT 制作服务。支持多种文档格式导入生成 PPT,提供海量模板、智能美化、素材替换等功能,适用于销售、教师、学生等各类人群,能高效制作出高品质 PPT,满足不同场景演示需求。

讯飞绘文

讯飞绘文

选题、配图、成文,一站式创作,让内容运营更高效

讯飞绘文,一个AI集成平台,支持写作、选题、配图、排版和发布。高效生成适用于各类媒体的定制内容,加速品牌传播,提升内容营销效果。

热门AI辅助写作AI工具讯飞绘文内容运营AI创作个性化文章多平台分发AI助手
材料星

材料星

专业的AI公文写作平台,公文写作神器

AI 材料星,专业的 AI 公文写作辅助平台,为体制内工作人员提供高效的公文写作解决方案。拥有海量公文文库、9 大核心 AI 功能,支持 30 + 文稿类型生成,助力快速完成领导讲话、工作总结、述职报告等材料,提升办公效率,是体制打工人的得力写作神器。

openai-agents-python

openai-agents-python

OpenAI Agents SDK,助力开发者便捷使用 OpenAI 相关功能。

openai-agents-python 是 OpenAI 推出的一款强大 Python SDK,它为开发者提供了与 OpenAI 模型交互的高效工具,支持工具调用、结果处理、追踪等功能,涵盖多种应用场景,如研究助手、财务研究等,能显著提升开发效率,让开发者更轻松地利用 OpenAI 的技术优势。

Hunyuan3D-2

Hunyuan3D-2

高分辨率纹理 3D 资产生成

Hunyuan3D-2 是腾讯开发的用于 3D 资产生成的强大工具,支持从文本描述、单张图片或多视角图片生成 3D 模型,具备快速形状生成能力,可生成带纹理的高质量 3D 模型,适用于多个领域,为 3D 创作提供了高效解决方案。

3FS

3FS

一个具备存储、管理和客户端操作等多种功能的分布式文件系统相关项目。

3FS 是一个功能强大的分布式文件系统项目,涵盖了存储引擎、元数据管理、客户端工具等多个模块。它支持多种文件操作,如创建文件和目录、设置布局等,同时具备高效的事件循环、节点选择和协程池管理等特性。适用于需要大规模数据存储和管理的场景,能够提高系统的性能和可靠性,是分布式存储领域的优质解决方案。

下拉加载更多