[DRIVER] Centri / MyPropane cellular propane tank monitor — unsupported

Centri's MyPropane monitor is a solar-powered cellular propane tank sensor — no Wi-Fi or Bluetooth, it talks to an LTE network directly. Centri publishes a small REST API for it, and Home Assistant has had an integration for a while, but as far as I could find there was nothing for Hubitat. So I wrote (with Claude.ai help) one for my own tank and I'm putting it out there in case anyone else has the same hardware.

Up front: this is unsupported. No warranty, no commitment to maintain it, no promise I'll answer problem reports. I have exactly one monitor on one account, so anything beyond that configuration is untested. I'm not affiliated with Centri in any way. Please don't rely on it as your only indication of tank level you must use the app or a physical gauge for anything that matters. With that said, it's been running fine on my hub and the code is MIT licensed, so fork away.

What it exposes

Tank level as a percentage, remaining gallons, and Centri's own alert status (No Alert / Low Level / Critical Level) from the thresholds you set in the app, plus a separate low-level threshold you can set in the driver. Battery percentage and raw voltage, solar panel voltage, device temperature in your hub's scale, and LTE signal strength.

It also derives consumption locally (used since last reading, a rolling daily use rate, and an estimated days remaining) since the API reports level only and never usage. Level increases of more than 5% are treated as a delivery rather than negative usage, and stamp a lastRefillDate. Readings are deduplicated on the API's own post timestamp, so a repeated poll never double-counts.

On polling

Centri limits API access to 4 calls per device per day, which matches how often the monitor posts. Instead of a blind 6-hour timer, the driver reads NextPostTimeIso out of each response and schedules its next poll about ten minutes after the device's own next post. You get each reading as soon as it exists and stay inside the cap. There's a callsLast24h attribute if you want to watch that, and a 6-hour fallback if the timestamp comes back unusable.

Install

Drivers Code → New Driver → Import, paste

https://raw.githubusercontent.com/saintlou/hubitat-centri-mypropane/main/drivers/centri-mypropane-tank-monitor.groovy

Save, then add a virtual device of that type. It's not in Hubitat Package Manager, so manual import only, so use the Import button again with the same URL if I ever push a fix.

You'll need your User ID, Device ID and Device Auth code. Those come with the monitor or from Centri support for free, API access is included.

Live results screenshot can be found on GitHub undert saintlou/hubitat-centri-mypropane/main/live_results.png