Skip to content

About

Home Assistant integration for HomeBrainz inkVision(R) smart devices.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

inkVision(R) Home Assistant Integration

inkVision logo

GitHub Release License hacs

Connect your inkVision(R) devices to Home Assistant for local monitoring and control. No cloud account is needed: the integration talks to the device directly on your network and receives updates in real time.

HomeBrainz develops the inkVision(R) product line. Learn more at homebrainz.eu and inkvision.eu.

Supported Devices

Works with inkVision(R) devices running HomeBrainz firmware. Available entities depend on the device model and its sensors.

Features

  • Local and real-time: live updates over your local network, with automatic reconnection
  • Easy setup: devices are discovered automatically; you can also add one by IP address
  • Environment sensors: temperature, humidity, pressure, and air quality (IAQ, CO2 equivalent, VOC) on supported models
  • Display controls: brightness, timezone, and which screens the display rotates through
  • Speaker (models with a speaker): use the device as a media player for text-to-speech, internet radio, and your Home Assistant media library
  • Firmware updates: see when an update is available and install it from Home Assistant

Installation

HACS (recommended)

Open your Home Assistant instance and open this repository in HACS.

  1. Click the button above, or open HACS in Home Assistant and search for inkVision
  2. Click Download
  3. Restart Home Assistant

Manual installation

  1. Download the latest release from the releases page
  2. Copy the custom_components/inkvision folder into the custom_components folder of your Home Assistant configuration directory (create custom_components if it does not exist)
  3. Restart Home Assistant

Configuration

Open your Home Assistant instance and start setting up inkVision.

Devices on your network are usually discovered automatically and appear under Settings > Devices & Services as ready to configure. To add a device yourself:

  1. Go to Settings > Devices & Services
  2. Click Add Integration and search for inkVision
  3. Enter the device's IP address or hostname

You can find the device's IP address in your router's list of connected devices.

Upgrading from the HomeBrainz integration

This integration used to be called HomeBrainz (homebrainz). After you update it in HACS and restart Home Assistant, your devices move to inkVision automatically. Entity IDs, history, dashboards and device IDs stay the same.

  • Actions were renamed from homebrainz.* to inkvision.*. The old names keep working; when an automation or script uses one, a notice under Settings > Repairs tells you which action to change.
  • HACS leaves the old custom_components/homebrainz folder behind. A repair notice offers to delete it; restart Home Assistant afterwards. Until then the old entries stay under HomeBrainz as disabled, so the old code cannot add the devices again; they are removed on the first start without the folder.

Entities

The integration creates the following entities, depending on your device:

Platform Description
sensor Environment and air-quality readings, Wi-Fi signal, and device diagnostics
number Display brightness
select Device timezone, and what each button tap / long press does on the clock
switch Screens shown in the display rotation
binary_sensor Firmware update available
button Check for and install firmware updates
event Button 1 / Button 2 touch gestures (single_tap, long_press) on the Atmos Smart Clock
media_player Speaker playback, volume, and mute

Services

  • inkvision.set_brightness: set the display brightness
  • inkvision.display_text: show a custom text on the display
  • inkvision.restart_device: restart the device
  • inkvision.set_screen_rotation: choose which screens the display rotates through
  • inkvision.set_timezone: set the device timezone
  • inkvision.set_custom_screen: set the text of a custom screen (slot 1-4); empty text removes it

All services take a target device and can be tried out under Developer Tools > Actions.

Button Automations

Each touch button of the Atmos Smart Clock has an event entity that fires on every single tap and long press, so you can use it as an automation trigger. The event's action attribute tells you what the clock did itself. If you want a button to do nothing on the clock and only trigger your automation, set its action to None (Home Assistant only), either with the button action selects on the device page or in the HomeBrainz app.

triggers:
  - trigger: state
    entity_id: event.atmos_smart_clock_button_1
    attribute: event_type
    to: long_press
actions:
  - action: light.toggle
    target:
      entity_id: light.living_room

Custom Screens

The clock can show up to 4 custom screens in its rotation, after the regular screens. Set them under Settings > Devices & services > inkVision > Configure as templates, for example {{ states('sensor.outdoor_temperature') }}°C. A screen updates whenever its template's result changes. Text longer than the display scrolls. Leave a field empty to remove that screen. You can also set screens from automations with inkvision.set_custom_screen.

The clock doesn't store custom screens. Home Assistant sends them again whenever it reconnects, and clears them when the integration is unloaded.

Device Settings

Each device has its own settings page. Open it from the device page in Home Assistant (Visit).

Troubleshooting

The device cannot be added or shows as unavailable

  1. Make sure the device is powered on and connected to Wi-Fi
  2. Check that Home Assistant and the device are on the same network (same subnet/VLAN)
  3. Open the device's settings page from a browser to confirm it is reachable
  4. Reload the integration under Settings > Devices & Services

The speaker does not play

  1. Make sure the device firmware is up to date
  2. Check that the volume is not muted or set very low
  3. Check the Home Assistant logs for messages from the inkVision integration

Some sensors are missing

Sensors are created only for the hardware your device has. If an expected sensor is missing, update the firmware and reload the integration.

Support

Found a bug or have a feature request? Please open an issue.

About

Home Assistant integration for HomeBrainz inkVision(R) smart devices.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages