CLARYEL PerimetroKeskusteltava hanke
Tekninen asiakirja · 3 / 3

Ohjelmistoratkaisu

Home Assistant paikallisella palvelimella: yksi sovellus kaikille puhelimille, tableteille tai selaimelle, rajatut oikeudet ja hälytykset, jotka tulevat perille myös silloin, kun puhelin on äänettömällä.

Home AssistantAndroid · iPhone · selainOikeudet rooleittainKriittiset hälytyksetKaikki paikallisesti, salattuna, ilman pilveä
1

Mitä pinostamme olemme valinneet ja miksi

Paikallisella palvelimellamme jo toimivasta pinosta tarvitaan vain muutama osa. Loput — tekoälyanalyysi, salattu arkisto, tallenteet — jäävät Home Assistantin ulkopuolelle.

  1. 1

    Home Assistant

    Järjestelmän ainoa keskus: vastaanottaa kehän tapahtumat, hallitsee käyttäjiä ja heidän oikeuksiaan, lähettää hälytykset puhelimiin. Vapaa ohjelmisto, toimii paikallisesti palvelimellamme.

  2. 2

    MQTT (Mosquitto)

    Paikallinen viestikanava kenttäsolmujen (ESP32), tekoälyanalyysin ja Home Assistantin välillä. Tapahtumat kulkevat lyhyinä tekstiviesteinä, ilman kuvia.

  3. 3

    NUT (UPS:n tila)

    Tuo varavirtalähteen tilan Home Assistantiin: sähkökatko tai tyhjenevä akku muuttuu heti tekniseksi hälytykseksi.

  4. 4

    Home Assistant Companion -sovellus

    Virallinen asiakas Androidille ja iPhonelle/iPadille: sen kautta hälytykset tulevat perille ja hyväksytty hallintapaneeli avautuu.

  5. 5

    WireGuard

    Hankkeessa jo yhteyttä varten suunniteltu suojattu kanava: tarvittaessa sen avulla sovellusta voi käyttää myös rakennuksen ulkopuolella, ilman pilvitilauksia.

Home Assistantin ulkopuolelle jää: tekoälyanalyysi, salattu arkisto ja tallenteet pysyvät palvelimella, eikä sovellus voi näyttää niitä.
2

Kaavio: palvelimelta asiakkaille, roolit ja oikeudet

Kenttäpiste

Kamera tai Wi-Fi CSI -moduulit, merkinannolla

Paikallinen palvelin

Tekoälyanalyysi, salaus, arkisto, UPS ja tietojen varmuuskopiointi

Home Assistant

Tapahtumat, käyttäjät, oikeudet, hälytykset

Asiakkaat

Yksi sovellus tai selain

  • Android
  • iPhone / iPad
  • Selain (tietokone)
  • Tabletti

Roolit ja oikeudet

Kaikki näkevät vain hyväksytyn sisällön

  • Tekninen ylläpitäjä
  • Nimetty henkilö
  • Asukas

Home Assistant saa vain tapahtuman (teksti, aika, aitauksen osuus): ei valokuvia eikä videota. Mitä ei ole Home Assistantissa, sitä ei voi nähdä sovelluksessa.

3

Yksi asiakas kaikille laitteille

Asiakas on virallinen Home Assistant Companion -sovellus tai pelkkä selain: valitse se, joka sinulla on.

  • Android

    Home Assistant Companion -sovellus sovelluskaupasta: hälytykset, hyväksytty hallintapaneeli, pikatoiminnot.

  • iPhone ja iPad

    Home Assistant Companion -sovellus iOS:lle ja iPadOS:lle: hälytykset, myös kriittiset, ja hyväksytty hallintapaneeli.

  • Selain tietokoneella

    Riittää, kun avaa Home Assistantin osoitteen: ei asennusta.

  • Tabletti

    Sovellus tai selain; omalla käyttäjällä se voi jäädä seinälle kiinteäksi paneeliksi, esimerkiksi sisäänkäynnille.

Pääsy tapahtuu rakennuksen paikallisverkossa tai rakennuksen ulkopuolella suojatun WireGuard-kanavan kautta. Home Assistant Cloud -tilausta ei tarvita.
4

Pääsy rajatuilla oikeuksilla

Kaikki kirjautuvat omalla käyttäjätunnuksellaan ja salasanallaan (kaksivaiheisella tunnistautumisella, jos se on käytössä) ja näkevät vain roolilleen hyväksytyn sisällön. Alla olevat roolit ovat ehdotus keskustelua varten.

  • Home Assistantin ylläpitäjä

    Tekninen ylläpitäjä

    Määrittää järjestelmän, käyttäjät ja automaatiot. Vähän tilejä, kaksivaiheisella tunnistautumisella; pääsyn voi sallia vain paikallisverkosta.

  • Käyttäjä ilman ylläpitäjän oikeuksia

    Nimetty henkilö

    Vastaanottaa hälytykset toimintopainikkeilla tapahtuman vahvistamiseksi. Arkiston kuviin sovelletaan nimetyille henkilöille varattua menettelyä, jossa on pääsyloki.

  • Käyttäjä ilman ylläpitäjän oikeuksia

    Asukas

    Vastaanottaa hälytykset (vain tekstinä) ja näkee hyväksytyn hallintapaneelin järjestelmän tilasta. Ei pääsyä kameraan, arkistoon tai asetuksiin.

Kuka saa tehdä mitäTekninen ylläpitäjäNimetty henkilöAsukas
Vastaanottaa hälytysilmoitukset
Nähdä järjestelmän tila (hyväksytty hallintapaneeli)
Vahvistaa tapahtuma toimintopainikkeilla
Nähdä arkiston kuvat (vain nimetyt henkilöt, lokiin kirjaten)
Hallita vastaanottajalistaa ja hälytysasetuksia
Muuttaa asetuksia, käyttäjiä ja automaatioita

Miten rajoitus saavutetaan

  • Käyttäjillä ilman ylläpitäjän oikeuksia ei ole pääsyä Asetuksiin, eivätkä he voi hallita käyttäjiä, laitteita, automaatioita ja hallintapaneeleja.
  • Jokaisen hallintapaneelin voi varata ylläpitäjille; asukkaille osoitetaan erillinen, hyväksytty hallintapaneeli.
  • Jokaiselle käyttäjälle pääsyn voi sallia vain paikallisverkosta ja kaksivaiheisen tunnistautumisen voi ottaa käyttöön.
  • Jokaisen laitteen voi kytkeä pois poistamalla sen käyttöoikeustunnus profiilista; käyttäjän tilin voi poistaa käytöstä.
  • Vahvin raja on rakenteellinen: Home Assistant ei tarjoa käyttöliittymässä laitekohtaisia oikeuksia, siksi sinne päätyy vain hyväksytty tieto (hälytystapahtuma, järjestelmän tila, UPS:n tila). Kuvat ja arkisto jäävät ulkopuolelle.
5

Hälytykset, jotka tulevat perille myös äänettömällä

Kun kehää rikotaan vaarallisesti, hälytys lähetetään kriittisenä: alla kuvatulla määrityksellä se soi myös silloin, kun puhelin on äänettömällä ja »Älä häiritse« -tila on päällä, eli kun kaikki saapuvat puhelut on estetty (esimerkiksi yöllä).

Lukitusnäyttö
03:12
Puhelin äänettömälläÄlä häiritse -tila päällä
HÄLYTYSKriittinen hälytys

Huomio! Valvotulla aitauksen osuudella on havaittu ihminen.

iPhone
Lukitusnäyttö
03:12
Puhelin äänettömälläÄlä häiritse -tila päällä
HÄLYTYSalarm_stream

Huomio! Valvotulla aitauksen osuudella on havaittu ihminen.

Android

Esimerkki määrityksestä (virallisesta Home Assistant Companion -dokumentaatiosta)

iPhone ja iPad: kriittinen hälytys

  • iOS:n kriittiset hälytykset (Critical Alerts) näkyvät lukitusnäytön ylimpänä kaikkien muiden ilmoitusten yläpuolella ja soivat myös »Älä häiritse« -tilassa tai iPhonen ollessa äänettömällä.
  • Ne voivat lisäksi ylittää sovelluksen ilmoitusten taajuusrajat.

1× Kerran: iOS:n asetuksissa salli Home Assistant -sovelluksen ilmoitukset, mukaan lukien kriittiset hälytykset.

data:
  push:
    sound:
      name: "default"
      critical: 1
      volume: 1.0

Android: korkea prioriteetti ja hälytyskanava

  • Korkealla prioriteetilla ja elinajalla 0 ilmoitus tulee perille heti, vaikka puhelin olisi paikallaan tai näyttö olisi ollut pitkään pois päältä.
  • Käyttämällä »herätyskellon« äänivirtaa (alarm stream) puhelin soi myös äänettömässä tai värinätilassa.

1× Kerran: avaa sovelluksen järjestelmäasetuksista hälytyskanava ja salli sen ohittaa »Älä häiritse« -tila (oletuksena se ei ohita sitä).

data:
  ttl: 0
  priority: high
  channel: alarm_stream

Mihin kannattaa kiinnittää huomiota

  • Hälytys on suunniteltu tulemaan perille myös äänettömällä, mutta ehdotonta toimitusta ei voida taata: puhelimen on oltava päällä ja tavoitettavissa (datayhteys tai Wi-Fi), ja kertaluonteinen määritys on tehtävä jokaisessa puhelimessa.
  • Viesti on vain tekstiä, ilman valokuvia, videota tai henkilötietoja.
  • Tavallisesti lähetys puhelimeen kulkee Applen tai Googlen push-ilmoitusinfrastruktuurin kautta, kuten missä tahansa sovelluksessa. Rakennuksen paikallisverkossa on käytettävissä myös paikallinen toimitus (Local Push) WebSocketilla, Applea tai Googlea kiertäen.
  • Suosittelemme määräajoin lähetettävää tarkistushälytystä, jotta havaitaan ajoissa, jos jokin puhelin ei enää vastaanota hälytyksiä.
6

Ei vain kehä: muut tärkeät hälytykset

Samalla kanavalla voi kulkea myös muita tärkeitä viestejä eri kiireellisyystasoilla. Soittoäänen ja prioriteetin valinta tehdään kullekin tasolle erikseen.

  • Kriittinen

    Vaarallinen kehän rikkominen: soi aina, myös kun puhelin on äänettömällä.

  • Kiireellinen (tekninen)

    Sähkökatko tai tyhjenevä UPS-akku, yhteys kenttäpisteeseen katkennut, palvelin ei ole tavoitettavissa.

  • Tiedoksi

    Poikkeava lämpötila tai kosteus tai vesivuoto kotelossa, muut taloyhtiön kanssa sovitut viestit. Saa jäädä äänettömäksi.

iOS:ssä »kriittinen« taso ohittaa jopa äänettömän tilan, »time-sensitive« (kiireellinen) ohittaa tarkennustilat, »passiivinen« ei herätä edes näyttöä.

Kaikki paikallisesti, salattuna, ilman pilveä

Analyysi, arkisto ja pääsy pysyvät paikallisella palvelimella, salattuina ja ilman pilvipalveluja. Hälytyksen sattuessa pääsy arkistoon suljetaan heti ja tapahtuman tallenteet suojataan muuttamiselta ja poistamiselta, kuten hankkeessa on kuvattu.

✉

Kysyttävää tai huomautettavaa?

Kirjoita meille: vastaamme mielellämme. Voit käyttää myös hankkeen lomaketta.

Siirry hankkeen lomakkeeseen

Hankeasiakirja asukkaiden ja taloyhtiön hallinnon kanssa käytävää keskustelua varten: toteutus on mahdollinen vasta tarvittavien hyväksyntöjen jälkeen.