Loading...
This website stores data, such as cookies, to enable basic site functionality and for marketing, personalization and analytics purposes. You can change your settings at any time or accept the default settings. You can close this banner to continue using only the cookies you need.

Privacy Policy
Cookie Settings
Cookies necessary for the correct operation of the site are always enabled.
Other cookies are configurable.
Marketing
Disabled
These elements are used to deliver ads that are more relevant to you and your interests. They can also be used to limit the number of ad impressions and measure the effectiveness of advertising campaigns. Advertising networks usually place them with the permission of the site operator.
Analytics
Disabled
These elements help the website operator understand how his website works, how visitors interact with the site, and whether there may be technical problems. This type of storage usually does not collect identifying information about the visitor.
Connecting NeboAir to Home Assistant via MQTT
connecting the NeboAir sensor to the Home Assistant
In the world of smart home technology, connectivity is key. One protocol that plays a vital role in connecting remote devices with minimal network bandwidth is MQTT. Designed specifically for the Internet of Things (IoT), MQTT is a lightweight messaging transport layer that simplifies communication in smart homes. In this tutorial we will show you how to configure the MQTT broker in Home Assistant and how to connect Nebo Air to send MQTT messages.
Setup MQTT & Mosquitto Broker on Home Assistant
To communicate over MQTT, we need an MQTT broker to manage, store and action the messages.
Before you start setting up, make sure you have "advanced mode" enabled. To do this, open your profile in Home Assistant and enable "advanced mode".
Getting started
To locate and install Mosquitto, follow these steps:

    1. Within your Home Assistant frontend/home navigate to the Settings menu
    2. Click Add-ons
    3. Click ADD-ON STORE in the lower right corner
    4. Go to the Search add-ons box
    5. Type Mosquitto broker
    6. Click on Mosquitto broker from the list
    7. Click INSTALL and wait for the Mosquitto broker to be installed
    8. Enable Start on boot and Watchdog
    9. Click START to start the broker
    10. Go to the Log tab and verify that the broker has been successfully launched.
    Then you need to install File editor and make the necessary configuration:
      1. In the bottom right corner, click ADD-ON STORE
      2. Go to the Find Add-ons field
      3. Enter File editor
      4. Select File editor from the list
      5. Click INSTALL and wait for File editor to install
      6. Click START
      7. Click Open Web UI
      8. Click on the folder icon
      9. Then write the following value in the mqtt.yaml file (Or you can download a ready-made mqtt.yaml file by downloading it from this link) :
      
      sensor:
        - name: "neboair_pressure"
          state_topic: "homeassistant/pressure"
          device_class: "pressure"
          unit_of_measurement: "mmHg"
        - name: "neboair_humidity"
          state_topic: "homeassistant/humidity"
          device_class: "humidity"
          unit_of_measurement: "%"
        - name: "neboair_temperature"
          state_topic: "homeassistant/temperature"
          device_class: "temperature"
          unit_of_measurement: "°C"
        - name: "neboair_pm01"
          state_topic: "homeassistant/pm01"
          device_class: "pm1"
          unit_of_measurement: "µg/m³"
        - name: "neboair_pm10"
          state_topic: "homeassistant/pm10"
          device_class: "pm10"
          unit_of_measurement: "µg/m³"    
        - name: "neboair_pm25"
          state_topic: "homeassistant/pm25"
          device_class: "pm25"
          unit_of_measurement: "µg/m³"
        - name: "neboair_aqi"
          state_topic: "homeassistant/aqi"
          device_class: "aqi"
      
      10. Then add the following value in the configuration.yaml file and save the settings:
      
      mqtt: !include mqtt.yaml
      
      MQTT Authentication
      Now in order for Nebo Air to authenticate to the MQTT Broker, you need to create an mqtt user account.
      1. Within your Home Assistant frontend/home navigate to the Settings menu
      2. Click on Users
      3. Click on ADD USER in the lower right corner
      4. Enter a name, in this example we will use nebo-mqtt
      5. Enter the password and confirm it (It is desirable not to use logins and passwords longer than 16 characters)
      6. Click CREAT
      MQTT settings in the app
      Connect using the Nebo app to the sensor and fill in the following fields in the MQTT settings:

      1. IP address of your device on which Home Assistant is installed
      2. Port
      3.The name of the user you have created, in the example nebo-mqtt.
      4. Password for this user
      5. In the last field, enter the name "homeassistant"
      MQTT Integration
      1. Within your Home Assistant frontend/home navigate to the Settings menu
      2. Click on Devices & Services
      3. Make sure you are the Integrations part (shown on the upper side of the screen)
      4. MQTT should appear as a discovered integration at the top of the page
      5. Click on CONFIGURE on the MQTT integration
      6. Click SUBMIT
      7. Click FINISH
      Modify the configuration

      1. Click on the MQTT configuration
      2. Click on Configure
      3. Click Re-configure MQTT
      4. Enable advanced mode
      5. Increase the keep alive value to 280 sec.
      6. Change the MQTT protocol version to version 5
      7. Click Submit
      Congratulations, your Nebo Air is now connected to Home Assistant!


      If you still have questions, please contact our support team at support@nebo.live.
      Copyright © 2024 Nebo Devices Ltd.
      ROOM 606, 6/F, HOLLYWOOD CENTRE, NO. 77-91 QUEEN'S ROAD WEST, SHEUNG WAN, Hong Kong