How to connect Gree heat pump with Reduxi controller
Add your Gree heat pump to the Reduxi Controller via Modbus.
1 Technical documentation
Instructions on how to connect and configure the heat pump are on the manufacturer web page.
- Gree system documentation – Instructions on how to connect and configure the device (manufacturer web page)
2 Required equipment
You need these components:
- Reduxi Controller
- Network connection between the heat pump and the Reduxi Controller (TCP/IP)
- Laptop or tablet with internet access to configure the device in Reduxi
3 Connect and configure the heat pump
Connect and configure the Gree heat pump as described on the manufacturer web page. See Point 1.
The values are listed in the List of supported devices.
4 Log in to the Reduxi web interface
You can open the Reduxi web interface in two ways:
Text description of this image
Screenshot of three Reduxi mobile app screens side by side, with cyan boxes and number badges 2 to 4. Left screen (dashboard, dark theme): menu icon at top left marked with a box and badge 2; 'reduxi' logo; tabs 'Real time data' (active) and 'Statistics'; price 5.79 € and temperature 3.2 °C; energy flow diagram with a house in the centre (-1.25 kW) and icons with values 69.0 W, 1.3 kW, 1.1 kW (red ring), -165.0 W with 97 % (red ring) and 0.0 W values at the bottom; tabs 'Power' and 'Energy'; bottom navigation: Dashboard, Diagnostics, Device control, Settings. Middle screen (side menu): 'reduxi' logo, 'Number of locations: 1233', heading 'Reduxi device management', entries '+ Add Reduxi location' and 'Reduxi devices' (marked with a box and badge 3), then 'My profile' and 'About app'. Right screen (device page): Back; picture of a black Reduxi controller with two Ethernet ports; status 'Connected'; card 'Update available': 'New update is available for your Reduxi device.' with button 'Download and install update'; card 'Connect to configurator': 'Tunnel connection enables remote access to your Reduxi configurator, without need to be connected to the same local network.' with button 'Activate tunnel connection' (marked with a box and badge 4); card 'Unit details' with field 'Unit ID'.
Text description of this image
Screenshot made of two parts side by side. Left part: Reduxi mobile app screen on a dark background. Top: Back button; picture of a black Reduxi controller with two Ethernet ports and a terminal block; status 'Connected' with a Wi-Fi icon. Card 'Update available': 'New update is available for your Reduxi device.' with button 'Download and install update'. Card 'Connect to configurator' with a key icon: 'Tunnel connection enables remote access to your Reduxi configurator, without need to be connected to the same local network.' and button 'Open configurator', marked with a cyan box and number badge 5. Below: card 'Unit details' with a field 'Unit ID' (value not visible). Right part: Reduxi Configurator opened in a browser, marked with a cyan frame and number badge 6. Header: back arrow, 'Tunnel connection', reload icon. Left sidebar with icons (lightning, chip, lightning bolt, bar chart, gear). Page 'Home' with a green link icon. Green notice: 'New patch available. Click here to apply.' with a close X. Time 09:12:56. Energy flow diagram with a house in the centre (1.700 kW) and icons for grid (0.000 kW), solar (1.700 kW), battery (green, 0.000 kW and 0.800 kW), a device at left (0.900 kW), electric vehicle and a charger or device at bottom. Label 'Energy manager' at the bottom.
http://reduxi.local. You can find the controller's IP address in your router's device list or in the Reduxi app under Reduxi devices.admin · Password: admin (factory default)Text description of this image
Screenshot of the Reduxi Configurator login page in a Chrome browser window. The address bar shows 'Not secure' and 'reduxi.local'; the address bar is marked with a cyan box and an enlarged copy of it (cyan box, text 'Not secure reduxi.local') is shown at the left, connected by a cyan line. Page background: light grey line drawing of a house with solar panels (green), a wall box, an inverter, a car and a charger. Top left: 'reduxi configurator' logo. Login box in the centre with title 'Login', a language selector (English flag, 'English'), a username field and a password field, and a dark 'Login' button.
Text description of this image
Screenshot of the Reduxi Configurator web interface after login, light theme. Top left: 'reduxi configurator' logo. Header bar: 'Home' at left, green 'Connected' status at top right. Left sidebar: expanded section 'Devices' with a list of entries, then collapsed sections 'Manager' and 'Configuration' and 'Settings'. Main area: energy flow diagram. House in the centre with ring, value 24.20 kW. Grid icon at top left, 24.20 kW (red dot on its line). Solar icon at top right, value '-'. Left icon (battery or device), 6.700 kW (green dot on its line). Right icons (battery storage and a device), values '-'. EV charger icon at bottom left, 31.00 kW. A further device icon at bottom right. Label 'Energy manager' below the house.
5 Add the heat pump to Reduxi
Use these steps to add a new heat pump or to edit an existing one.
5.1 Basic settings
Log in locally to the Reduxi Configurator on the controller (see Point 4) and click + Add device.
Enter the basic settings of the device:
- Device type:
HVAC - Type:
Gree - Name: a name of your choice, for example Gree heat pump
5.2 Communication settings
Select the communication channel and enter the device configuration:
| Parameter | Value |
|---|---|
| Communication channel | TCP/IP |
| IP | The IP address of the heat pump in your network |
| Modbus unit ID | Normally 1
|
5.3 Advanced settings
Enter and choose the advanced settings.
5.4 Test communication
Click Test communication at the bottom of the wizard. It reads the Gree heat pump once and saves nothing. If the test succeeds, click Done: only Done creates the device.
Text description of this image
Screenshot of the bottom button bar of a Reduxi Configurator page. Left: button 'Back'. Right: button 'Test communication' (marked with a cyan box) and dark button 'Done'.
Text description of this image
Screenshot of the Reduxi Configurator page 'Communication channel and device configuration'. Connection *: TCP/IP (dropdown). IP *: 192.168.50.243, with button 'Scan for IP'. Port *: 502, with button 'Test port'. Modbus unit ID *: 1. Buttons at the bottom: Back (left), Test communication and Done (right). The Done button is marked with a cyan box.
6 Check the readings
6.1 Last measurements
After communication is established, check the values under Devices – Gree heat pump in the Reduxi Configurator as an additional test.
6.2 Control by Reduxi
The List of supported devices shows the level of integration Read for the Gree heat pump. Reduxi reads the values of the device. It does not control it.
✓ Summary
Preparation (Points 1–2): Open the Gree documentation. Prepare the controller, the network connection and a laptop or tablet.
Gree heat pump (Point 3): Connect and configure the heat pump as described by Gree.
Add to Reduxi (Points 4–5): Log in to the Reduxi web interface. Click + Add device, enter the basic settings, the communication settings and the advanced settings. Run Test communication and click Done.
Go live (Point 6): Check the readings under Devices. Reduxi reads the values of the heat pump.
→ Common issues
| Issue | Solution |
|---|---|
| Test communication fails | Check the Modbus unit ID. Normally 1 is used. Check the IP address of the heat pump. |
| Open configurator does not open or stays empty | The tunnel is not active yet. Wait about 30 seconds and check that the controller is online. |
Login with admin is rejected |
The password was changed during installation. Ask the installer. The Reduxi account password does not work here. |
reduxi.local does not load |
Your device is not in the same network as the controller. Use the IP address or the tunnel connection. |
| Communication test fails, device shows offline | Check reachability, IP address / port / unit ID, and that the protocol is enabled on the device. |