SensorPush Integration for Home Assistant

Home Assistant integration for SensorPush temperature and humidity/hygrometer sensors.

NOTE:

• If you register a new physical sensor with SensorPush, you must restart Home Assistant to discover the new device(s).

• Ideally SensorPush sensors would be located within range of a SensorPush G1 WiFi Gateway for continously collecting and publishing data from the sensors to the SensorPush cloud. However, SensorPush sensors can also synchronize historical data over Bluetooth when nearby to an iOS or Android device with the SensorPush app).

Support

If you have trouble with installation and configuration, visit the SensorPush Home Assistant community discussion.

This integration was developed to cover use cases for my home integration, which I wanted to contribute back to the community. Additional features beyond what has already been provided are the responsibility of the community to implement (unless trivial to add).

Installation

Step 1: Install Custom Components

Mkae sure Home Assistant Community Store (HACS) is installed, then add the "Integration" repository: rsnodgrass/hass-sensorpush.

Note: Manual installation by direct download and copying is not supported, if you have issues, please first try installing this integration with HACS.

Versions

The 'master' branch of this custom component is considered unstable, alpha quality and not guaranteed to work. Please make sure to use one of the official release branches when installing using HACS, see what has changed in each version.

Step 2: Enable API Access

If you've never accessed the SensorPush Gateway account dashboard you must log in once and agree to the terms in order to allow the integration to access your SensorPush account. (If you've done this any time in the past, you may skip this step.) If you see errors in your log stating [pysensorpush] Could not authenticate to SensorPush service with <your_email> and password, and you've checked to ensure your credentials are correct, you probably need to do this.

Step 3: Configure SensorPush

Example configuration.yaml entry:

sensorpush:
  username: your@email.com
  password: your_password

sensor:
  - platform: sensorpush

Lovelace

entities:
  - entity: sensor.warehouse_humidity
  - entity: sensor.warehouse_temperature
show_header_toggle: false
title: SensorPush
type: entities

Lovelace gauge example:

entity: sensor.warehouse_humidity
max: 100
min: 0
name: Office
severity:
  green: 45
  red: 15
  yellow: 25
theme: Backend-selected
type: gauge

More complex example using mini-graph-card and color thresholds:

cards:
  - color_thresholds:
      - color: '#00ff00'
        value: 0
      - color: '#abf645'
        value: 30
      - color: '#FFD500'
        value: 50
      - color: '#ff0000'
        value: 60
    decimals: 0
    entities:
      - entity: sensor.warehouse_humidity
        name: Humidity
    font_size: 75
    hours_to_show: 12
    line_color: blue
    line_width: 8
    points_per_hour: 2
    show:
      fill: true
      icon: false
    type: 'custom:mini-graph-card'
  - color_thresholds:
      - color: '#abf645'
        value: 0
    decimals: 0
    entities:
      - entity: sensor.warehouse_temperature
        name: Temperature
    font_size: 75
    hours_to_show: 12
    line_color: var(--accent-color)
    line_width: 8
    points_per_hour: 2
    show:
      icon: false
    type: 'custom:mini-graph-card'
type: horizontal-stack

Tracking Battery

The battery level of sensors are attributes on each sensor, a separate sensor is not provided. However, if you wish to track battery levels, you can add a template sensor.

sensor:
  - platform: template
    sensors:
      fridge_sensor_battery_voltage:
        friendly_name: 'Fridge SensorPush battery voltage'
        unit_of_measurement: 'V'
        value_template: '{{ state_attr("sensor.fridge_humidity", "battery_voltage") }}'

Hardware Requirements

• SensorPush Wireless Thermometer/Hygrometer - Humidity & Temperature Smart Sensor
• SensorPush G1 WiFi Gateway

See Also

• Community support for Home Assistant SensorPush integration
• pysensorpush - Python interface to SensorPush cloud API
• SensorPush (official product page)
• ReviewGeek's review of SensorPush

Known Issues

Future Enhancements

• support Celsius (in addition to Fahrenheit) when SensorPush exposes units via its APIs

Out of Scope

No plans to implement the following at this time:

• determine if the following devices work with SensorPush (all were tested/approved the same day, with same internal designs), but these may require a custom firmware flash:

• Mitsubishi Kumo Cloud temp/humidity sensor (PAC-USWHS003-TH-1)
• Oasis OH-31 HT Tracker (FCC Grantee 2AL92, ID: 2AL92-OH31) like the SensorPush (FCC Grantee 2AL9W and 2AL9X HT1)
• iBeTag Beacon IB004NPLUSSHT (FCC Grantee 2AB4P)
• Jaalee Beacon IB004NPLUSSHT (FCC Grantee 2ABRO)
• Saalee iB004N-Plus-SHT
• AnkhMaway iB004N-Plus-SHT LT / (https://www.beaconzone.co.uk/iB004NPLUSLight)
• BLW Eddystone iBeacon
• iBeTag AKMW-iB004N-5

• allow fetching data directly from the sensor via Bluetooth (no cloud dependency required); may be required to integrate with above sensors