Navien Hot Water heater - Navilink

It’s not compatible with Navilink 128 (at least the version I have), even the HA “official” Cozytouch integration (Overkiz) isn’t.

I made a custom integration for Cozytouch that works with my Navilink 128 + Naema Micro 25, you can try it if you want : GitHub - gduteil/cozytouch: Atlantic Cozytouch integration for Home Assistant

Thanks!
what sensors are available?

It depends on your device, and some adjustments need to be done if your device has not been integrated yet.
What device are you using ?

Lot of sensors and controls are available in the Cozytouch API, at least everything you can have in the official app will be accessible in the integration, but much more sensors are published and not used by the app.

I have an NPE-240A2 and I just ordered a NaviLink Lite. I also have a logic analyzer as well as a capable digital storage oscilloscope. I think I am going to set things up initially using this integration, but for fun I also think I am going to have a go at examining the RS-485 traffic. I’ll let you know what I find out :grinning:.

oh - can you say more about examining the RS-485 traffic? i have another device i want to do that on. i have a couple of USB to RS-485 connectors but haven’t used them yet, haven’t figured out where to start actually. that’s the next rabbit hole i’m going down :joy:

@mbcomer Were you able to do this exploration, and did you figure out anything interesting?

I am a little confused by the name of these items and what the on/off button is or isn’t?

  1. what is the difference between inlet temp and hot water temp?
  2. is the button my hot power button / circulation being on or a true power on/off button to the unit as a whole?

i didn’t see the note about dip switches until after i had installed the navilink lite and i would prefer not to re-open as our unit it is a little difficult to get too, so hoping can someone clarify if I have the full set of entities?

A few questions regarding this integration. Thanks to @nikshriv for your work on this.

I’ve installed the Navilink Lite and the integration and seem to have access to the entities exposed by the integration, including the hot button recirc switch.

My unit doesn’t have a remote temp sensor installed but does have the dedicated recirc circuit. Can this work without a remote temp sensor? If not, any pointers to a workable wireless solution?

If it can work without the remote temp sensor, are there any particular settings that I should look at on the water heater itself? Temp differential would see it has no effect if there is no temp sensor.

The recirc pump does not run more than a couple of minutes when the recirc is triggered. I’ve increated fixture distance to 400 feet but doesn’t seem to have any effect. Water at the fawcet is luke warm at best when running on cycle of every 30 min.

Appreciate any guidance on this.

wow thanks man! I was struggling with this unit for almost one day :wink:

I have an NPE-240A2. If I read everything correctly then if I add a NaviLink Lite and I can use the app to communicate with the heater? Thanks

I have a NHB-150H boiler. The temp setting, inlet temp and outlet temp don’t work - I assume because for a boiler (not DHW) the topics in the AWS MQTT are different… Any idea what they could be? Or is the only way to sniff communications between the mobile app and cloud somehow?

I sniffed the traffic myself and the topics for a boiler are “currentSupplyTemp” and “currentReturnTemp”, and the set point is “heatSettingTemp”

I’ve been playing around with adding NWP500 support to the existing custom integration. If you’re interested and willing to test my code of questionable quality, I can add these for you as well.

NWP500 support required extensive changes because it doesn’t use the same MQTT topics or structure as anything else. (They implemented a completely new messaging scheme for it.)

Here’s some stuff on the Navien NWP-500 from a Reddit Thread:
https://www.reddit.com/r/heatpumps/comments/1ndxk2o/navien_nwp500_install/

Python, etc:

I started working on this fork for the NWP-500. It’s not quite ready to merge yet as it still has some issues with reconnection, but I’ve been using it successfully for a while: GitHub - kbuck1/hass_navien_water_heater: Home Assistant custom component for Navien water heaters using NaviLink

I have NWP500 support reasonably stable now, in a fork of @nikshriv’s original NaviLink custom integration.

Here’s what’s changed:

  1. Added NWP500 support.
  2. Rewrote reconnection logic to be very robust.
  3. Rewrote config flow; instead of picking which devices to poll, all devices on the account are polled by default, and you can disable a device in Home Assistant to stop polling it.
  4. Rewrote temperature conversions.

I’ve been running this on my NWP500 unit for several months now and it has been stable.

Here’s what I haven’t tested:

  • Support for non-NWP500 models. (Although I tried to ensure that nothing was broken.)
  • Whether the upgrade flow works when upgrading from a previous version.
  • Multiple devices on one account.
  • NWP500 models that have a built-in recirculation pump / hot button support. (Mine doesn’t have it.)

Here’s a README that describes what’s supported for the NWP500: README_NWP500.md

If you want to try it, add https://github.com/kbuck1/hass_navien_water_heater as a custom repository in HACS.

I have a NFB-200H boiler. Which integration would be best for me?

Looks like the integration is broken since updating to 2026.7.0.

The following is the error message I see:

Setup failed for custom integration 'navien_water_heater': Requirements for navien_water_heater not found: ['AWSIoTPythonSDK>=1.5.4'].

Hopefully somebody can fix this.....