🏠
+
NG
Home Assistant Integration

NexGenIOT for
Home Assistant

Install the NexGenIOT Bridge add-on via the HA Add-on Store. All your devices appear as native entities — switches, sensors, binary sensors — ready for automations and dashboards.

Add-on Install Guide Entity Reference Android Auto
Integration Features

Everything exposed. Nothing hidden.

The NexGenIOT integration creates native HA entities for every device on your account — all accessible in automations, dashboards, and scripts.

🔌

Easy Add-on Store Install

Add the NexGen repository to your HA Add-on Store, install, link your account with a code, and all devices appear automatically. No YAML required.

🔄

Real-Time State Updates

Door and gate states update in HA within milliseconds via MQTT push — no polling, no delay.

📊

Full Sensor History

Temperature, humidity, CO₂, VOC, and PM2.5 readings stored in HA's long-term statistics database.

🤖

Automation Ready

Use any NexGen entity as an automation trigger or action. Close the garage at sunset. Alert when CO₂ exceeds 1000 ppm.

🎛️

Lovelace Dashboard Cards

Drop any NexGen entity onto a Lovelace dashboard with standard HA cards — button, entity, gauge, history-graph.

🔔

Native HA Notifications

Trigger HA notifications when doors open, close, or are left open — through any HA notification platform.


Installation

Install via HA Add-on Store

The NexGen IoT Bridge is a Home Assistant Supervisor add-on. Add the repository to your HA instance and it installs like any other official add-on.

Prerequisites: Home Assistant OS or Supervised (2024.1+), Mosquitto MQTT broker add-on installed. An active NexGen IoT account and at least one claimed device.

1

Add the NexGen Repository

In HA go to Settings → Add-ons → Add-on Store → ⋮ (top right) → Repositories. Paste in: https://github.com/nexgen-iot/nexgen-iot-ha-addon and click Add.

2

Install NexGen IoT Bridge

Scroll down in the Add-on Store to find NexGen IoT Bridge. Click it → Install. Wait for the build to complete.

3

Start the Add-on & Get Your Code

Click Start, then open the Log tab. You'll see a link code printed — e.g. Link code: ABCD1234.

4

Link Your NexGen Account

Open portal.nexgen-iot.co.za/ha-link, sign in, and enter the code. The add-on confirms "Home Assistant linked successfully."

5

Devices Appear Automatically

All your NexGen devices are discovered via MQTT and appear in HA within seconds — no YAML, no manual entity setup.

View on GitHub →

Configuration

Optional YAML configuration.

The integration works without any YAML, but advanced users can add custom settings to configuration.yaml.

Example automation — close garage at sunset

automation:
  - alias: "Close Garage at Sunset"
    trigger:
      - platform: sun
        event: sunset
        offset: "+00:15:00"
    condition:
      - condition: state
        entity_id: binary_sensor.nexgen_garage_door
        state: "on"  # open
    action:
      - service: button.press
        target:
          entity_id: button.nexgen_garage_door_trigger
      - service: notify.mobile_app
        data:
          message: "Garage closed automatically at sunset."

Example — alert on high CO₂

automation:
  - alias: "Alert High CO₂"
    trigger:
      - platform: numeric_state
        entity_id: sensor.nexgen_co2
        above: 1000
    action:
      - service: notify.mobile_app
        data:
          message: "⚠️ CO₂ level is {{ states('sensor.nexgen_co2') }} ppm — ventilate the garage."

Entity Reference

Every entity, documented.

All entities follow the naming pattern platform.nexgen_<device-name>_<type>. Device names are set in the NexGen app.

Entity ID (example) Type Device Description
button.nexgen_garage_door_trigger button NexDoor Pro / NexGate Pro Momentary trigger — sends a pulse to the relay.
binary_sensor.nexgen_garage_door_state binary_sensor NexDoor Pro Door open/closed state from the reed sensor. on = open.
button.nexgen_gate_trigger button NexGate Pro Momentary trigger — sends a pulse to the gate relay.
binary_sensor.nexgen_gate_state binary_sensor NexGate Pro Gate open/closed state. on = open.
switch.nexgen_relay_1 switch NexSwitch Dual Latching on/off control for relay channel 1.
switch.nexgen_relay_2 switch NexSwitch Dual Latching on/off control for relay channel 2.
sensor.nexgen_temperature sensor NexSense T/H, NexSense AQ Temperature in °C. Updates every 30 seconds.
sensor.nexgen_humidity sensor NexSense T/H, NexSense AQ Relative humidity in %. Updates every 30 seconds.
sensor.nexgen_co2 sensor NexSense AQ CO₂ concentration in ppm (SCD40). Updated every 5 seconds.
sensor.nexgen_voc_index sensor NexSense AQ VOC index (0–500). Higher = more volatile compounds detected.
sensor.nexgen_pm25 sensor NexSense AQ PM2.5 particulate matter in µg/m³.
sensor.nexgen_air_quality_index sensor NexSense AQ Composite AQI score (0–500). Exposed as a state class measurement.
binary_sensor.nexgen_door_sensor_state binary_sensor NexDoor Sensor Door/window open state. on = open. Device class: door.

Android Auto

Control your gates and garages from your car.

NexGen IoT works with Android Auto through the Home Assistant Android Auto integration. Trigger your garage door or gate directly from your car's dashboard — hands-free and distraction-free.

🚗

Dashboard Shortcuts

Your NexGen doors and gates appear as script shortcuts on the Android Auto Home Assistant screen.

🎙️

Google Assistant Voice Commands

"Hey Google, run open garage door" — HA scripts triggered by voice via Android Auto.

📍

Geofence Automations

Use HA's zone automations to open your garage automatically when your phone enters your home zone.

Requirement: Android Auto integration for Home Assistant must be enabled. Install the HA Companion App and enable Android Auto in the app settings.

Home Assistant
NexGen IoT Shortcuts
09:41
🏠
Open Main Garage
button.nexgen_garage_door_trigger
🚪
Open Sliding Gate
button.nexgen_gate_trigger
🏢
Office Entry Gate
button.nexgen_office_gate_trigger

How to set up Android Auto

1

Install the NexGenIOT HA integration

Follow the add-on installation steps above. All NexGen devices must be visible in HA as entities before proceeding.

2

Create HA Scripts for each device

In HA, go to Settings → Automations & Scenes → Scripts. Create a script for each device (e.g. "Open Main Garage") that calls button.press on the relevant NexGen trigger entity.

3

Enable Android Auto in the HA Companion App

Open the Home Assistant Android appSettings → Companion App → Android Auto. Enable it and select which scripts to show on the car screen.

4

Connect your phone to Android Auto

The Home Assistant shortcuts will appear on your car's display. Tap once to trigger the garage or gate — no unlock needed while driving.

Professional Services

Need help setting up Home Assistant?

We offer remote and on-site Home Assistant setup, NexGen device integration, custom dashboard development, and ongoing support — so you can skip the learning curve.

Starter
R 999
once-off · remote

Basic Home Assistant server setup with no integrations. Perfect if you just need HA installed and configured on your hardware.

  • HA OS / Container install
  • Network configuration
  • Remote access setup
  • Add-on Store installation
  • Device integrations
  • Custom dashboard
Get Started
MOST POPULAR
Full Setup
R 2,999
once-off · remote

Full installation including NexGen device integration, user accounts, automations, backup config, and an overview dashboard.

  • Everything in Starter
  • NexGen IoT integration
  • User accounts & permissions
  • Basic automations
  • Overview dashboard
  • Backup configuration
Get Started
Premium
R 4,999
3 months · remote

Full setup plus 3 months of unlimited support, monthly health checks, and priority response. Ideal for businesses or new HA users.

  • Everything in Full Setup
  • Unlimited updates & backups
  • Monthly health checks
  • Priority business-hours support
  • Custom dashboard included
  • Android Auto setup
Get Started
🛠️

Ad-Hoc Support

Need help outside a package? We offer hourly remote support nationwide and on-site assistance in Gauteng.

Remote Support R 450 /hour
On-Site (Helderberg) R 450 /hour + travel
Book Support
🎨

Custom Dashboards

We design and build bespoke Lovelace dashboards tailored to your home, devices, and preferences — room-by-room layouts, custom cards, and mobile-optimised views.

  • Room & area grouping
  • NexGen device cards
  • Mobile & tablet optimised
  • Priced per quote
Request a Quote

Get Started

Don't have a NexGen device yet?

Pick up a NexGate Pro or NexDoor Pro and have Home Assistant + Android Auto control running within the hour.