Custom integration for Midnite Solar Classic 150 solar charge controllers (and compatible models). Communicates with the device over Modbus TCP
- Periodic polling of all Classic registers via Modbus TCP
- Configurable polling interval from 10 to 3,600 seconds
- Select which parameters to expose as HA entities via the UI
- Connection validation and automatic device name retrieval during setup
- Multi-device support (multiple Classic controllers with different IP addresses)
- Options flow (⚙️ icon) to change interval and parameter without reconfiguring
- Ability to change six register values allowing remote control of the Classic from HA
- A button is made available to write register changes to EEPROM.
- A switch to turn the Classic ON or OFF
| Component | Description |
|---|---|
| Home Assistant OS | Built on version 2026.3+ |
| pymodbus | Built with version ≥ 3.6.0 (installed automatically in HAOS) |
| network | The Classic must be connected to the local network and reachable from Home Assistant. → Need the address and the Classic's name must be set in the unit. See Network in user manual. |
- Goto Settings → Devices & Services → Add integration
- Find HACS and follow the installation
- Login with GitHub
In the HACS interface:
- Click on the 3 dots on top right corner
- Select Custom repositories
- Add the repo's URL https://github.com/qcda1/ha_midnite_classic
- Use Type Integration
- Click Add
Once the addition of the repository:
- Search for Midnite Solar Classic in HACS
- Click on "Download"
- Restart Home Assistant: Settings → System → Restart (Restart icon top right).
Settings → Devices & services → + Add integration → search for Midnite Solar Classic.
| Field | Description | Default |
|---|---|---|
| IP Address | Classic's IP on the local network | — |
| Modbus TCP Port | Classic's Modbus server port | 502 |
| Interval (s) | Polling frequency in seconds (30–3600) | 60 |
The integration connects immediately to validate the connection and read the device name (Name register).
A checklist displays all parameters returned by your Classic.
Checked by default:
BatVoltage, PVVoltage, BatCurrent, EnergyToday, Power, ChargeStage, State, PVCurrent, TotalEnergy, Name, ChargeStateText
Each selected parameter becomes a sensor entity with unit, device class and state class assigned automatically.
For example:
| Parameter | Unit | Class |
|---|---|---|
| BatVoltage | V | voltage / measurement |
| PVVoltage | V | voltage / measurement |
| BatCurrent | A | current / measurement |
| Power | W | power / measurement |
| EnergyToday | kWh | energy / total_increasing |
| TotalEnergy | kWh | energy / total_increasing |
| ChargeStateText | — | — |
- The integration will also create seven configuration entities allowing user to change the Classic register values. This allow remote control of the Classic from Home Assistant.
| Parameter | Unit | Values | Register |
|---|---|---|---|
| endingAmps | A | See Classic Owner's Manual | 4246h |
| AbsorbVoltageSetPoint (Set) | V | See battery specs | 4149h |
| FloatVoltageSetPoint (Set) | V | See battery specs | 4150h |
| EqualizeVoltageSetPoint (Set) | A | See battery specs | 4151h |
| EqualizeTimeSetPoint (Set) | s | See battery specs max 4h (14400s) | 4162h |
| EqualizeIntervalDay (Set) | day | Nb days between Equalize stages | 4163h |
| DaysBetweenBulkAbsorb (Set) | Days | Days between Bulk/Absorb. Skip days. | 4252h |
- A button is created with the equipment to write modified data from RAM to EEPROM (Electrically Erasable Programmable Read-Only Memory). It mimik the "DATA SENT AND SAVED TO THE CONTROLLER" message on the MNGP when users change controller's parameters. This ensure the changes will remain in effect after a controller full shutdown or a reboot.
- A switch is created to allow the user to switch the controller ON and OFF the same way he would do with the MNGP (MODE ➔ On/Off).
- Equalize Time SetPoint = 0 → Manual mode. Equalize Time SetPoint ≠ 0 enables 'EQ Auto' mode
- Don't forget that EqualizeVoltage >= AbsorbVoltage >= FloatVoltage
- Refer to the Midnite Solar Classic Owner’s Manual for details about adjustments of these values.
- It is important to push the "Save Settings to EEPROM" button to store the modified values in memory to the EEPROM so it keeps its on controller shsutdown or reboot.
- Details on Classic's registers are documented here → Register map
Click ⚙️ to change the polling interval or the monitored parameter list.
Changes take effect immediately.
Repeat "Add integration" with a different IP address for each device.
| Symptom | Solution |
|---|---|
| "Cannot connect" | Check IP, port, and that the Classic is powered on and reachable from HA |
| Unavailable entities | Check HA logs: Settings → System → Logs |
| pymodbus error | Restart HA — pymodbus ≥ 3.6.0 is installed automatically |
| Changes reverted to old value after a reboot or shutdown | Make sure the "Save Settings to EEPROM" button is pressed after the change is made to the registers |
MIT.
Based on the work of ClassicDIY/ClassicMQTT and qcda1/MidniteClassic.
