Skip to content

rsnodgrass/hass-sensorpush

Repository files navigation

SensorPush Integration for Home Assistant

🥈 beta_badge release_badge release_date hacs_badge License

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

NATIVE HOME ASSISTANT SUPPORT

As of the Home Assistant 2022.08 release SensorPush sensors are natively supported WITHOUT require a gateway!

Hardware Supported

Model Temp Humidity Pressure Dewpoint VPD
HT.w X X X X
HTP.xw X X X X X
HT1 X X X X
  1. For constant updates of sensor data without opening the iOS or Android app to synchronize data, the SensorPush G1 WiFi Gateway is required to continually stream data from the sensors to SensorPush's cloud service However, SensorPush sensors can also synchronize historical data over Bluetooth when nearby an iOS or Android device with the SensorPush app).

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

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 and released as a contribution to the community. Implementing new features beyond what exists is the responsibility of the community to contribute.

Installation

Step 1: Install Custom Components

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

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 sign in once to agree to Sensorpush terms before this integration can access data in 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

Lovelace Example

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:

Lovelace Example

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") }}'

See Also

Out of Scope

No plans to implement the following at this time. However, community contributions to add these features would be greatly appreciated!

Alternative Devices

The following hardware is not supported. These are just recorded here as these devices share the same internal design; were tested and approved on the same day; but likely require custom firmware flash to be able to communicate with SensorPush.