Connect to Home Assistant

This guide covers the current local-network Home Assistant path for Atmos Wi-Fi devices after they are already connected to your home Wi-Fi.

• You need an Atmos device already connected to your home network.
• You need a working Home Assistant instance on the same local network.
• You need the device IP address, or a network where Home Assistant discovery can reach the device.
• You can confirm the device is online by opening http://DEVICE_IP/ in a browser.
• Useful local pages and endpoints include /, /ota, /status, /sensors, /config.json, and /ws.

1. Open HACS in Home Assistant.
2. Open Integrations.
3. Add the custom repository https://github.com/11ado33/ha-homebrainz-integration.
4. Set the category to Integration.
5. Install HomeBrainz.
6. Restart Home Assistant.

1. Open your Home Assistant configuration folder.
2. Create custom_components/homebrainz if it does not exist.
3. Copy the files from the custom_components/homebrainz folder of the integration repository into that folder.
4. Restart Home Assistant.

1. In Home Assistant, open Settings > Devices & Services.
2. Select Add Integration.
3. Search for HomeBrainz.
4. If Home Assistant discovers the device automatically, select it.
5. If not, enter the device IP address manually.
6. Finish the config flow.

Home Assistant discovery can work with current HomeBrainz and inkVision naming variants, but manual IP entry is always a valid fallback.

• Sensor entities for temperature, humidity, pressure, Wi-Fi signal, and air-quality values.
• Brightness and timezone controls.
• Screen rotation controls.
• Firmware check and install actions.
• Speaker or media-player controls on supported builds.

Before or after adding the device to Home Assistant, you can compare the device state directly in its built-in local pages.

1. Open http://DEVICE_IP/.
2. Use the inkVision Device Dashboard to inspect device health, live sensor values, brightness, screen rotation, OTA check or install actions, and restart controls.
3. Open http://DEVICE_IP/ota if you want to upload a local firmware .bin file manually.
4. If Home Assistant shows stale values, compare them against the dashboard or the raw /status and /sensors responses.

1. Open the new HomeBrainz device page in Home Assistant.
2. Confirm that sensor values are updating.
3. Open the device's local web link from Home Assistant if available.
4. If your build has controls, test one safe action such as brightness.

If discovery does not work, make sure Home Assistant and the Atmos device are on the same LAN or reachable local subnet, verify that http://DEVICE_IP/status responds, and add the integration again with the IP address manually.

If some entities are missing, keep in mind that sensor entities require a sensor-equipped build, speaker controls require an audio-enabled build, and display controls require a display-enabled build.

If the integration is added but values do not update, reload the integration, reboot the Atmos device once, and check Home Assistant logs for connection or WebSocket errors.

If you do not know the device IP address, check your router's client list or use a local network scanner.