RuuviTagien käyttö onnistuu tavallisella älypuhelimella tai esimerkiksi kotiautomaatiojärjestelmän Bluetooth -yhteyden avulla. Näiden kuuluvuudessa voi kuitenkin olla jossain tilanteissa toivomisen varaa. Parempaa kuuluvuutta tavoitteleville on saatavilla tehokkaalla apila-antennilla varustettu Ruuvi Gateway.

Ruuvi Gatewayn asennus on helppoa. Laite kytketään mukana tulevalla kaapelilla lähiverkkoon ja yhdistetään USB-virtalähteeseen. Muuta ei käytännössä tarvita. Laite välittää RuuviTagien tiedot automaattisesti samassa verkossa olevalle puhelinsovellukselle. Tarvittaessa laite on mahdollista liittää myös langattomaan verkkoon. Ruuvi tarjoaa myös pilvipalvelua RuuviTagien tilastojen etätarkastelua varten.

Toistaiseksi Ruuvi Gatewaylle ei ole suoraa integraatiota Home Assistantiin. Laitteen asetuksissa on kuitenkin mahdollista määritellä oma MQTT -palvelin, jonne RuuviTagien tiedot lähetetään. Omaksi MQTT -palvelimeksi Home Assistant suosittelee Mosquitto MQTT Brokeria. Sen voi asentaa järjestelmästä riippuen esimerkiksi Home Assistantin Add-onina tai omaan Docker-konttiin:

# docker-compose.yaml for Mosquitto
version: '3.3'
services:
  eclipse-mosquitto:
    image: eclipse-mosquitto
    container_name: mosquitto
    ports:
      - 1883:1883
      - 9001:9001
    volumes:
      - ./:/mosquitto/:rw
    restart: unless-stopped

# mosquitto.conf

listener 1883


## Authentication ##
password_file /mosquitto/config/password.txt

Tämän lisäksi Home Assistantiin tarvitaan MQTT -integraatio, jonka avulla MQTT -palvelimelle syötetyt tiedot saadaan Home Assistantin käyttöön. Ruuvi Gatewayn tapauksessa Home Assistant ei kuitenkaan tunnista antureita MQTT-palvelimen kautta suoraan. Tätä varten Home Assistantiin täytyy vielä asentaa Pyscript integraatio HACS:n avulla ja siihen sopiva scripti. Skriptin tehtävä on lukea Ruuvi Gatewayn syöttämät tiedot MQTT-palvelimelta ja kirjoittaa ne sinne uudelleen Home Assistantin ymmärtämässä muodossa. Pyscriptille on lisäksi kerrottava antureiden MAC -osoitteet ja miten uudet tiedot muodostetaan. Esimerkkiskriptistä hieman muokattu versio:

pyscript:
  allow_all_imports: true
  apps:
    ruuvi-gateway:
      mqtt_topic_prefix: ruuvi
      ruuvitags:
        ab01cdef23f4: Piha
      measurements:
        temperature:
          config:
            stat_t: homeassistant/sensor/<MAC>/temperature/state
            json_attr_t: homeassistant/sensor/<MAC>/temperature/attributes
            name: Lämpötila
            unit_of_meas: "\u00b0C"
            dev_cla: temperature
            uniq_id: ruuvitag_<MAC>_temperature
            device:
              ids: ruuvitag-<MAC>
              mf: Ruuvi Innovations
              mdl: RuuviTag
              name: <TAG_NAME>
          attributes:
            Ruuvitag: <MAC>
            Measure: Lämpötila
            Unit: "\u00b0C"
          source_metric: temperature
          precision: 1

Huom! Home Assistantin versiosta 2023.2 alkaen on ollut mahdollista käyttää natiivia integraaitiota, minkä ansiosta asennus on erittäin helppoa. MQTT:tä tai Pyscriptiä ei tällöin tarvita lainkaan. Myös pelkät RuuviTagit toimivat nykyisellään natiivisti Home Assistantin kanssa. Tällöin tosin tarvitaan erillinen Bluetooth vastaanotin.