获取中燃燃气剩余金额和使用燃气量的 Home Assistant 集成

• 支持多个燃气表（多个 IC 卡编号）
• 自动为每个燃气表创建传感器实体
• 提供燃气用量、余额和更新时间传感器
• 通过服务调用手动刷新数据
• 基于云轮询的集成

1. 打开 HACS
2. 点击 "集成" -> "添加集成"
3. 搜索 "中燃燃气表" 或 "China Gas Stat"
4. 点击 "安装"
5. 重启 Home Assistant

1. 下载最新版本的 china_gas_stat 目录
2. 将 china_gas_stat 目录复制到 Home Assistant 的 custom_components 目录
3. 重启 Home Assistant

1. 浏览器打开 https://zrds.95007.com/controller/phone/uni/index.html#/ 并登录
2. 点击 燃气缴费 图标，输入自己的 用户/客户号 点确定，再确认，选择 物联网表（推荐）
3. 在打开的页面中显示的 "IC 卡号" 就是，一般以本地区号开头的16位数字

1. 使用代理工具（如 Charles、Fiddler 等）设置手机代理
2. 在手机上打开中燃在线小程序
3. 点击燃气缴费图标，再点击 去充值，触发数据加载
4. 在代理工具中查看 API 调用记录，找到调用 https://zrds.95007.com/zrmgr_iot/meterInfo/queryLatestMeterInfo.do 的请求
5. 在请求参数中找到 icCardCode 参数，其值即为所需的 IC 卡编号

1. 进入配置 > 集成
2. 点击 "添加集成" 并搜索 "中燃燃气表"
3. 输入您的 IC 卡编号（每行一个）
4. 点击 "提交"

1. 进入配置 > 集成
2. 找到 "中燃燃气表" 并点击 "配置"
3. 更新 IC 卡编号
4. 点击 "提交"

对于每个 IC 卡编号，集成会创建以下传感器：

• sensor.gas_{ic_card_code}_gas_consumption - 燃气用量（单位：m³）
• sensor.gas_{ic_card_code}_balance - 燃气余额（单位：¥）
• sensor.gas_{ic_card_code}_remaining - 剩余气量（单位：m³）
• sensor.gas_{ic_card_code}_time - 燃气更新时间

手动刷新所有燃气表的数据。

• 确保您的 IC 卡编号正确
• 检查 API 端点是否可访问
• 验证您的 Home Assistant 是否有互联网访问权限

集成使用以下 API 端点：

• https://zrds.95007.com/zrmgr_iot/meterInfo/queryLatestMeterInfo.do

此端点由中燃燃气提供，用于查询最新的燃气表信息。

• 版本：2026.03.03
• 集成类型：设备
• IoT 类别：云轮询

欢迎提交问题和拉取请求来改进此集成。

此项目使用 MIT 许可证。