> For the complete documentation index, see [llms.txt](https://docs.voltmasters.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.voltmasters.io/device-integrations/battery-systems/goodwe.md). # GoodWe Our EMS supports the **GoodWe SEC3000C** Smart Energy Controller for GoodWe's **ESA125K / ESA261 (261 kWh)** commercial storage scenario. The SEC3000C is not an inverter itself but an **all-in-one EMS gateway**: it aggregates a whole site — battery energy storage, PV and a built-in grid meter — behind a single Modbus TCP endpoint. Because everything is reached through one connection, our EMS exposes the site as several logical devices (battery, PV, grid meter) that are all served by the same integration. {% hint style="info" %} Only the **C variant** (SEC3000**C**) is supported. It is the only variant that supports parallel connection and control of GoodWe's on-grid and hybrid inverters. The plain SEC3000 is monitoring-only and is not supported. {% endhint %} ### Supported devices | Model | Role | Scenario | | -------- | ----------------------- | ---------------- | | SEC3000C | Smart Energy Controller | ESA125K / ESA261 | The integration communicates over **Modbus TCP** (default port `502`). The SEC3000C itself is addressed as logical device id `0`; the built-in **GM330** smart meter is addressed on its own RS485 address. ## How the integration works A single SEC3000C is modelled in our EMS as one parent device with up to three child devices, all driven from the same Modbus connection: * **PCS (battery inverter)** — the parent device. Receives the charge/discharge commands and reports the energy-storage active/reactive power. * **BMS** — reports the battery state of charge (SOC), state of health (SOH) and charge/discharge state. * **PV** — reports the combined PV production, the available PV power and the PV rated power. * **Grid meter** — the built-in **GM330** smart meter, exposed as a grid energy meter. Optional: only active when the meter's RS485 address is configured. Battery capacity and the minimum/maximum state of charge are configured on the BMS child device; the rated power is configured on the PCS. The PV rated power and the battery SOC are read back from the device. There is no separate wiring or extra Modbus device to add — the children are created automatically from the parent. ### Control approach We steer the system through the SEC3000C's **remote control interface**. The controller is held in **Remote Control Mode** (asserted continuously) so it follows EMS setpoints, and every control cycle (≈1 s) we (re)assert the requested commands: * **Battery (ESS) setpoint** — a direct charge/discharge power setpoint, clamped to the energy-storage rated power and the device's real-time max charge/discharge limits. * **PV curtailment** — an explicit PV active-power limit, used when production has to be capped. ### What is read back * Battery: SOC, SOH, active and reactive power, on-/off-grid status, real-time max charge and discharge power. * PV: actual production, currently available power and rated power. * System: total PV + storage active power and the min/max controllable power. * Grid meter (when configured): per-phase voltages and currents, total active/reactive/apparent power, power factor, frequency and cumulative import/export energy. ## What is possible with which setup The built-in **GM330 grid meter** is optional. Whether it is configured determines whether real grid measurements are available. | Capability | With GM330 meter | Without GM330 meter | | ------------------------------ | :--------------: | :-----------------: | | Battery monitoring (SOC / SOH) | ✅ | ✅ | | PV monitoring | ✅ | ✅ | | Grid import/export monitoring | ✅ | ❌ | | Charge / discharge to setpoint | ✅ | ✅ | | PV curtailment | ✅ | ✅ | | Grid limit (import/export) | ✅ | ❌ | > **Key takeaway:** battery and PV control work without the meter. The GM330 is required for grid measurements and grid import/export limiting. ## Configuration parameters Beyond the standard battery parameters (capacity, min/max state of charge), the SEC3000C PCS exposes: * **Rated power (kW)** — the energy-storage system's nominal AC power. The PV rated power is read from the device and pre-fills the PV child's production capacity. The GM330 grid meter, when used, is added as the grid energy-meter child device; its RS485 address is forwarded to the PCS so the meter can be read over the shared connection. ## Validation status The integration is implemented against the **SEC3000C MODBUS Interface Definition Description (v06)**. Additional functionality may be added over time as integration capabilities evolve. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.voltmasters.io/device-integrations/battery-systems/goodwe.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.