待补充
bokub/ha-linky
3/5
🧩 软硬件结合
已发布
项目简介
📊 Home Assistant app for Linky smart meters
HA Linky 是一个专为法国智能电表用户设计的 Home Assistant 插件,旨在将 Linky 电表的能耗数据无缝同步到 Home Assistant 的能源仪表板中。该项目由开发者 bokub 基于其自建的 Conso API 服务和 linky npm 模块构建,解决了法国用户无法直接在 Home Assistant 中获取 Enedis 官方电表数据的痛点。
标签
项目特点
**无缝集成**:与 Home Assistant 能源仪表板完美对接,无需额外配置即可查看能耗数据。
**实时数据同步**:通过 Conso API 自动获取 Linky 电表的实时用电数据,保持信息更新。
**基于官方API**:依托 Enedis 官方授权的 Conso API,数据来源可靠且合规。
**轻量级插件**:安装简单,资源占用低,适合在树莓派等低功耗设备上运行。
**开源社区支持**:代码完全开源,用户可自行修改或提交问题,社区活跃度高。
**法国用户专属**:专为法国 Linky 智能电表设计,解决本地化需求痛点。
技术规格
| 平台 | Home Assistant(HACS 或自定义仓库安装) |
|---|---|
| 数据源 | Conso API(Enedis 官方接口) |
| 依赖库 | linky npm 模块 |
| 支持设备 | 法国 Linky 智能电表 |
| 数据更新频率 | 实时(取决于 API 调用限制) |
| 编程语言 | Python(Home Assistant 插件标准) |
| 许可证 | 未知(需查看仓库确认) |
| 最低 Home Assistant 版本 | 2021.x 及以上(推荐最新稳定版) |
项目资源
搜索资源
物料清单 (BOM)
| 物料名称 | 数量 | 参考价格 | 备注 |
|---|---|---|---|
| 运行 Home Assistant 的设备(如树莓派、NAS、PC) | 1 | — | 需能稳定运行 Home Assistant |
| Linky 智能电表 | 1 | — | 由 Enedis 安装,需已激活 |
| Home Assistant 系统 | 1 | — | 推荐最新稳定版 |
| HACS(Home Assistant Community Store) | 1 | — | 可选,用于简化插件安装 |
| Conso API 密钥 | 1 | — | 需在 conso.boris.sh 注册获取 |
能力画像
**记忆与知识检索**:2/5 — 项目依赖外部 API 和文档,自身不涉及复杂知识库。
**动手与操作**:3/5 — 需要安装 Home Assistant 并配置插件,操作步骤简单但需一定动手能力。
**编程与算法**:2/5 — 插件代码已封装,用户无需编程,但可修改配置或提交代码改进。
**设计与建模**:1/5 — 项目不涉及硬件设计或建模,专注于数据集成。
**实验与调试**:3/5 — 配置过程中可能需要调试 API 连接或数据同步问题。
**协作与分享**:4/5 — 开源项目,支持 Issue 提交、PR 贡献和社区讨论。
**学习与研究**:3/5 — 适合学习 Home Assistant 插件开发或智能电表数据集成。
**系统集成**:5/5 — 核心能力是将 Linky 电表数据无缝集成到 Home Assistant 能源系统。
项目图库
所需技能
基础 Home Assistant 操作(安装插件、配置集成)
了解法国 Enedis 智能电表基本概念
能够注册并获取 Conso API 密钥
熟悉 HACS 或手动安装第三方插件的方法
基本网络故障排查能力(如 API 连接问题)
适用场景
法国家庭用户希望将 Linky 电表数据接入 Home Assistant 能源仪表板
智能家居爱好者需要实时监控家庭用电情况
能源管理项目需要自动化分析用电数据
开发者学习 Home Assistant 插件开发与 API 集成的参考案例
需要将电表数据与其他智能设备联动(如自动关闭高耗能设备)