IDM Navigator Heatpump API Documentation
An asynchronous Python library for monitoring and controlling IDM Navigator 2.0, Navigator 10 and Navigator Pro heat pumps over local Modbus TCP.
What this library provides
- Model and capability detection for IDM Navigator controllers.
- Register maps for temperatures, energy, heating circuits, hot water, PV, solar, cascade and diagnostics.
- Safe asynchronous reads, retries, reconnection and validated register writes.
- Optional read-only local web access for values that are not available through Modbus.
Start here
- Install the Python package
- Read an IDM heat pump with Python
- Browse the GitHub Wiki
- Use the Home Assistant integration
- Install from PyPI
Local communication
Enable Modbus TCP on the IDM controller. The default connection uses port 502 and slave ID 1; no IDM cloud account is required.