热门搜索:
britkat/giv_tcp-ma
britkat
GivTCP v3是一款通过modbus连接GivEnergy设备（混合逆变器、AC耦合逆变器、网关、EMS、EV充电器等）的工具，支持网络自动发现，可作为Home Assistant插件或独立Docker容器运行，实现设备监控与控制，并通过MQTT/REST集成到智能家居系统。
7 次收藏下载次数: 0状态：社区镜像维护者：britkat仓库类型：镜像最近更新：5 个月前
GivTCP v3
镜像概述和主要用途
GivTCP v3是一款用于连接和管理GivEnergy设备的工具，支持多种设备类型，通过modbus协议与设备原生WiFi/以太网 dongle 建立连接，可通过局域网或内置SSID AP直接连接。该工具具备网络设备自动发现功能，支持近乎零配置部署，主要用于设备数据采集、监控及控制，并可通过MQTT或REST接口集成到智能家居系统（如Home Assistant）。
核心功能和特性
- 广泛设备支持：兼容混合逆变器、AC耦合逆变器、单/三相逆变器、网关（单/并行模式）、EMS、EV充电器（EVC）及一体式设备
- 灵活连接方式：通过modbus协议连接，支持局域网（LAN）或设备内置SSID AP直接连接
- 自动设备发现：可自动发现网络中的GivEnergy设备，简化配置流程
- 多部署模式：支持作为Home Assistant插件运行，也可作为独立Docker容器部署
- 数据集成能力：通过MQTT协议发布设备数据，支持Home Assistant自动发现；提供REST API接口，便于其他系统集成
- Web配置界面：内置Web配置页面，支持直观配置设备参数、MQTT连接等
- Web仪表盘：可选启用内置Web仪表盘，可视化展示逆变器数据（需单独配置）
使用场景和适用范围
- GivEnergy设备用户需要监控设备运行状态及数据
- 智能家居爱好者需将GivEnergy设备集成到Home Assistant等平台
- 需要通过MQTT或REST接口实现设备远程控制和数据采集的场景
- 多逆变器并行（如并行一体式设备）安装环境的集中管理
详细使用方法和配置说明
快速设置
安装GivTCP
Home Assistant插件方式
- 在Home Assistant的插件商店中添加仓库：
https://github.com/britkat1980/ha-addons - 刷新插件商店，找到GivTCP并点击安装
Docker方式
- 使用Docker Compose文件创建容器（具体配置需参考官方示例）
运行插件/容器
- 启动插件或容器
- 查看日志以确认是否有错误，并记录Web配置URL
配置GivTCP
- 访问Web配置地址（通常为：
http://IP地址:8099/config.html） - 逐步完成配置步骤，GivTCP会自动填充逆变器和MQTT详情
- 检查并确认设置符合需求
- 开启"自动运行"（self_run）
- Home Assistant用户需开启"Home Assistant自动发现"
- 若使用Home Assistant外部的MQTT broker，需进入MQTT页面配置连接信息
- 点击"保存并重启"（Docker用户需手动重启容器）
配置完成后，GivTCP将向MQTT broker发布数据，Home Assistant会自动发现设备。
（可选）Home Assistant检查
GivTCP重启后：
- 进入Home Assistant → 设置 → 集成 → MQTT
- 确认GivTCP设备已创建
此时Home Assistant中会显示多个数据点和控制选项，可开始集成到智能家居系统。更多控制选项和数据点详情见设置指南。
并行一体式设备（Parallel AIO）
并行一体式设备用户（如双AIO）在"逆变器"页面应预填充3个逆变器。若有缺失需手动添加，所有逆变器需设置静态IP。仅网关逆变器可通过GivTCP控制，其他一体式逆变器数据仅作信息展示。
Home Assistant插件
安装
将仓库https://github.com/britkat1980/ha-addons添加到Home Assistant插件商店的仓库列表。
依赖说明
插件默认假设Home Assistant已安装Mosquito MQTT插件（可从插件商店获取），GivTCP会自动连接。若未安装，需自行部署MQTT broker并在配置页面提供连接详情。
使用方法
- GivTCP设计为持续运行，配置审核完成后应开启"自动运行"设置
- 可通过配置修改数据采集频率，不建议将自动运行循环时间设置低于30秒
- 设备会自动在Home Assistant的MQTT集成页面创建，可通过该页面查看
其他使用方法
MQTT
启用MQTT配置后，GivTCP会将逆变器数据发布到指定MQTT broker。默认数据发布主题为GivEnergy/<序列号>/，也可通过设置"MQTT_TOPIC"指定自定义根主题。
控制功能同样通过MQTT实现，发布控制命令到以下主题：
- 默认：
GivEnergy/control/<序列号>/（注意"control"为小写） - 若设置MQTT_TOPIC：
<MQTT_TOPIC>/control/<序列号>/
RESTful服务
GivTCP提供REST API用于数据输出和控制，服务地址为http://IP地址:8099。每个逆变器通过以下端点暴露REST接口：
/REST1//REST2//REST3//REST4//REST5/
调用REST1/api可查看可用API列表。若Docker以Host模式运行，REST服务端口为6345。
Web仪表盘
可在设置页面启用内置Web仪表盘，用于可视化逆变器数据，默认运行在3000端口。更多详情见https://github.com/DanielGallo/GivEnergy-Smart-Home-Display/%E3%80%82
!https://github.com/DanielGallo/GivEnergy-Smart-Home-Display/blob/master/graphics/ReadMe-Landscape.png
Web仪表盘支持单逆变器或多逆变器（单相/三相环境）的数据汇总。有关仪表盘的问题或反馈，可在https://github.com/DanielGallo/GivEnergy-Smart-Home-Display/issues%E6%8F%90%E4%BA%A4%E3%80%82
GivEnergy电动汽车充电器（GivEVC）
GivTCP支持GivEVC的监控与控制，通过本地modbus连接获取实时数据并提供基础控制功能。注意：EVC云控制不使用modbus协议，因此GivTCP的控制操作可能无法同步到官方App/云平台，尤其是充电模式仅为模拟实现。
注意：当前GivEVC存在固件bug，Modbus端口仅在WiFi连接时可用。若EVC通过以太网连接，需切换为WiFi连接以通过GivTCP获取数据。
配置
仅需设置EVC的IP地址和自动运行定时器，将"EVC_ENABLE"设为True即可启用功能。
控制功能说明
- 即插即充（Plug and Go）：开启后车辆插入即开始充电；关闭时需通过RFID卡或"充电控制"触发充电
- 充电控制（Charge Control）："即插即充"开启时，用于启动/停止车辆充电
- 充电模式（Charging Mode）：模拟云平台充电模式
- 电网（Grid）：按"充电限制"设定值充电，不受能源可用性影响（通常从电网取电）
- 太阳能（Solar）：根据家庭负载后剩余太阳能调节充电限制，需至少1.4kW（6A）剩余太阳能（符合EVSE规范）
- 混合（Hybrid）：在6A基础电网充电上，叠加剩余太阳能调节充电限制
- 最大会话能量（Max Session Energy）：限制单次充电会话的最大能量，设为0kWh时禁用
- 进口容量（Import Cap）：监控首个GivTCP逆变器的电网电流，当接近进口容量设定值5%时，降低EVC充电电流以保持在进口容量10%以下，设为0A时禁用
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 giv_tcp-ma 镜像标签
docker pull docker.xuanyuan.run/britkat/giv_tcp-ma:<标签>
DockerHub 原生拉取命令
docker pull britkat/giv_tcp-ma:<标签>
轩辕镜像配置手册
探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式
Docker 配置
登录仓库拉取
通过 Docker 登录认证访问私有仓库
专属域名拉取
无需登录使用专属域名
K8s Containerd
Kubernetes 集群配置 Containerd
K3s
K3s 轻量级 Kubernetes 镜像加速
Dev Containers
VS Code Dev Containers 配置
Podman
Podman 容器引擎配置
Singularity/Apptainer
HPC 科学计算容器配置
其他仓库配置
ghcr、Quay、nvcr 等镜像仓库
Harbor 镜像源配置
Harbor Proxy Repository 对接专属域名
Portainer 镜像源配置
Portainer Registries 加速拉取
Nexus 镜像源配置
Nexus3 Docker Proxy 内网缓存
系统配置
需要其他帮助？请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
镜像拉取常见问题
使用与功能问题
配置了专属域名后，docker search 为什么会报错？
docker search 限制
Docker Hub 上有的镜像，为什么在轩辕镜像网站搜不到？
站内搜不到镜像
机器不能直连外网时，怎么用 docker save / load 迁镜像？
离线 save/load
docker pull 拉插件报错（plugin v1+json）怎么办？
插件要用 plugin install
WSL 里 Docker 拉镜像特别慢，怎么排查和优化？
WSL 拉取慢
轩辕镜像安全吗？如何用 digest 校验镜像没被篡改？
安全与 digest
第一次用轩辕镜像拉 Docker 镜像，要怎么登录和配置？
新手拉取配置
轩辕镜像合规吗？轩辕镜像的合规是怎么做的？
镜像合规机制
错误码与失败问题
docker pull 提示 manifest unknown 怎么办？
manifest unknown
docker pull 提示 no matching manifest 怎么办？
no matching manifest（架构）
镜像已拉取完成，却提示 invalid tar header 或 failed to register layer 怎么办？
invalid tar header（解压）
Docker pull 时 HTTPS / TLS 证书验证失败怎么办？
TLS 证书失败
Docker pull 时 DNS 解析超时或连不上仓库怎么办？
DNS 超时
docker 无法连接轩辕镜像域名怎么办？
域名连通性排查
Docker 拉取出现 410 Gone 怎么办？
410 Gone 排查
出现 402 或「流量用尽」提示怎么办？
402 与流量用尽
Docker 拉取提示 UNAUTHORIZED（401）怎么办？
401 认证失败
遇到 429 Too Many Requests（请求太频繁）怎么办？
429 限流
docker login 提示 Cannot autolaunch D-Bus，还算登录成功吗？
D-Bus 凭证提示
为什么会出现「单层超过 20GB」或 413，无法加速拉取？
413 与超大单层
账号 / 计费 / 权限
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"