> 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/ev-chargers/smappee-genius-flex.md). # Smappee Genius Flex Our EMS integrates with the Smappee Genius (Flex) gateway over Modbus TCP. The gateway is the single point of contact for the charging stations behind it: it exposes each configured connector for monitoring and control, and the same connector can be read as a consumption sub-meter. {% hint style="info" %} This manual assumes the Genius gateway and the charging stations have already been installed and commissioned in the Smappee environment. After these steps, the gateway is ready for connection to our EMS. {% endhint %} ### Supported devices * **Genius Flex**: the Smappee Genius (Flex) gateway with its Modbus TCP slave interface, one device per charging-station connector The gateway serves every configured connector under its own Modbus slave ID. In the platform you therefore add one EV charger per connector, each with the same IP address and its own slave ID. ### EMS functionality With the current integration, our EMS enables: * Monitoring of the charging state, the charging power and the per-phase currents of every connector * Monitoring of the running session: charged energy and charging duration * Power limiting per connector, within the installation maximum the gateway reports * Pausing and resuming a running charging session * Load balancing within the limit of the grid connection, together with the battery and PV * Charging at the cheapest moments, including during negative prices * Reading the same connector as an energy meter, so charging consumption is measured as a separate sub-circuit Starting and stopping sessions stays with the driver and the Smappee backend. Our EMS steers the charging power and pauses the session when charging has to stop. Additional functionality may be added over time as integration capabilities evolve. {% hint style="warning" %} **Register refresh rate** The Genius gateway refreshes its Modbus register cache every 15 seconds by default. That is too slow for smart charging: the EMS then steers on measurements that can be a full refresh period old. Ask Smappee support to lower the refresh rate to 2 seconds for EMS control before you commission the installation. {% endhint %} ## Configuring the gateway {% stepper %} {% step %} ### Enable the Modbus TCP slave interface Ask Smappee support to enable the Modbus TCP slave interface on the Genius gateway and to lower the register refresh rate to 2 seconds. Refer to the Smappee document *Control Smappee EV Charger via Modbus TCP/IP* for the interface itself. {% endstep %} {% step %} ### Put the gateway on the local network * Connect the Genius gateway to the same wired network (LAN) as the Voltmasters Controller, on the same subnet. * Give the gateway a fixed IP address and note it. * Verify that the controller can reach that IP address on the Modbus TCP port (502). {% endstep %} {% step %} ### Note the slave ID of every connector Each charging-station connector configured in the Smappee environment answers on its own Modbus slave ID. Note the slave ID per connector: you need it once per device you add. {% endstep %} {% step %} ### Add the connectors in the platform * Add an EV charger for every connector, selecting brand **Smappee** and model **Genius Flex**, and fill in the gateway IP address together with the slave ID of that connector. * Set the **supply connection** to match the installation: 1-phase 230 V or 3-phase 400 V. The Modbus interface has no register for the installation topology, so the EMS needs this to convert between current and power. A fixed single-phase installation left on three-phase would receive a third of the intended charging current. {% endstep %} {% step %} ### Add the connector as an energy meter (optional) Do you want the charging consumption as a separate measurement point? Then add an energy meter with brand **Smappee** and model **Genius Flex**, using the same IP address and the slave ID of the connector. The meter reports the active power, the per-phase currents and the consumed energy of that connector. A charging connector only consumes, so the production stays at 0. {% endstep %} {% endstepper %} The gateway is now successfully configured and ready for use with the EMS. {% hint style="info" %} **State of charge** The state of charge of the vehicle is only reported for DC charging sessions. AC stations leave that register empty, so no state of charge is shown for an AC connector. {% endhint %} --- # 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, and the optional `goal` query parameter: ``` GET https://docs.voltmasters.io/device-integrations/ev-chargers/smappee-genius-flex.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.