Asennus
Huom! Tämä ohje tarkoitettu Parmair MAC -sarjan laitteisiin joissa eMAC etäohjaus / IoT-etäohjauspaketti
Ensimmäinen vaihe on Home Assistantin asentaminen. Suosittelemme Raspberry Pi järjestelmää Home Assistantin käyttämiseen. Asenna Home Assistant -käyttöjärjestelmä Raspberry Pi -laitteeseen Raspberry Pi Imager tai tai Balena Etcher -ohjelmalla.
Tarvittava laitteisto
- Raspberry Pi 4 Raspberry Pi 3 sopii myös, jos sinulla on sellainen
- Virtalähde Varmista, että virtalähteesi on oikean mallinen
- Micro SD -kortti Vähintään Class 2 kortti. Suositus 32 Gt tai isompi
- SD-kortinlukija Löytyy useimmista kannettavista tietokoneista. Voit käyttää myös erillistä USB-sovitinta
- Ethernet kaapeli Vaaditaan asennusta varten. Asennuksen jälkeen Home Assistant toimii myös Wi-Fi verkossa, mutta Ethernet-yhteys on luotettavampi
Raspberry Pi Imager asennus
1. Asenna Raspberry Pi Imager-ohjelma tietokoneellesi osoitteesta https://www.raspberrypi.com/software/
2. Avaa Raspberry Pi Imager-ohjelma
3. Valitse asennettava käyttöjärjestelmä
2) Valitse Home Assistant OS joka sopii alustallesi (Raspberry Pi 3 tai Raspberry Pi 4).
4. Valitse tallennustila
2) Valitse SD-korttisi.
5. Asenna käyttöjärjestelmä SD-kortille:
2) Odota, että Home Assistant -käyttöjärjestelmä asennetaan SD-kortille.
6. Poista SD-kortti. Siirry kohtaan Käynnistä Raspberry
Balena Etcher asennus
1. Aseta alustettu SD-kortti tietokoneeseen.
2. Asenna Balena Etcher-ohjelma tietokoneellesi osoitteesta https://etcher.balena.io
3. Käynnistä Balena Etcher. Saatat joutua suorittamaan sen järjestelmänvalvojan oikeuksilla Windowsissa.
4. Valitse Flash URL-osoitteesta.
4. Kopioi alapuolelta oikea URL-osoite Raspberry Pi 3:lle tai 4:lle.
Raspberry Pi 3:
Raspberry Pi 4:
https://github.com/home-assistant/operating-system/releases/download/11.1/haos_rpi4-64-11.1.img.xz5. Liitä URL-osoite Balena Etcheriin ja valitse OK.
6. Kun Balena Etcher on ladannut käyttöjärjestelmän, valitse Select target.
7. Valitse SD-kortti, jota haluat käyttää asennuksessa.
8. Valitse Flash! aloittaaksesi käyttöjärjestelmän kirjoittamisen.
9. Kun Balena Etcher on asentanut käyttöjärjestelmän, näet siitä vahvistuksen.
6. Poista SD-kortti. Siirry kohtaan Käynnistä Raspberry
Käynnistä Raspberry
- Aseta SD-kortti, johon on asennettu Home Assistant, Raspberry Pi -laitteeseen.
- Liitä verkossa oleva Ethernet-kaapeli Raspberry Pi -laitteeseen.
- Kytke virtalähde Raspberry Pi -laitteeseen käynnistääksesi laitteen.
Odota hetki, niin pääset selaimella Home Assistantiin osoitteessa:
homeassistant.local:8123
Kun Home Assistant on asennettu, on aika määrittää se. Luo Home Assistantin järjestelmänvalvojan tili. Anna nimi, käyttäjätunnus, salasana ja valitse Luo tili.
Seuraavaksi voit antaa järjestelmälle nimen ja määrittää sijaintisi ja yksikköjärjestelmän. Valitse ’DETECT’ asettaaksesi sijaintisi automaattisesti. Voit asettaa nämä arvot myös manuaalisesti.
Kun olet valmis, napsauta Seuraava. Seuraavaksi Home Assistant näyttää kaikki laitteet, jotka se on löytänyt verkosta. Voit lisätä laitteita manuaalisesti myöhemmin.
Napsauta lopuksi Valmis. Nyt näet Home Assistantin verkkokäyttöliittymään.
VSCODE
Seuraavaksi sinun tulee ladata vscode (Visual Studio Code) niminen lisäosa.
Siirry seuraavaan osoitteeseen:
https://github.com/hassio-addons/addon-vscode/blob/main/vscode/DOCS.md
- Klikkaa Home Assistantin “My ADD-ON” painiketta avataksesi listan lisäosistasi.
- Klikkaa “Install” kohdasta ladataksesi lisäosan.
- Käynnistä ”Studio Code Server” lisäosa ja tarkista, että kaikki meni oikein.
- Napsauta ”OPEN WEB UI” painiketta avataksesi Visual Studio Code
- Jos Visual Studio Code ei aukea, käynnistä uudelleen Home Assistant.
Tämän jälkeen siirry Visual Studio Code -lisäsan “configuration.yaml” tiedostoon ja syötä sinne seuraava koodi:
Käytä alla olevaa koodia ennen 10-2023 (v1.8x) asennetuihin iv-laitteisiin.
# Parmair modbus (v1.83-)
modbus:
- name: "anna_tahan_nimi"
type: tcp
host: # Kirjoita oman ilmanvaihtolaitteesi IPv4 tähän
port: 502
sensors:
#Temperature & humidity sensors
- name: "parmair.ulkoilman_lampotila"
unit_of_measurement: "°C"
slave: 0
address: 1020
input_type: holding
count: 1
precision: 1
data_type: int16
scale: 0.1
scan_interval: 60
device_class: TEMPERATURE
- name: "parmair.LTO_kylmapisteen_lampotila"
unit_of_measurement: "°C"
slave: 0
address: 1022
input_type: holding
count: 1
precision: 1
data_type: int16
scale: 0.1
scan_interval: 60
device_class: TEMPERATURE
- name: "parmair.tuloilman_lampotila"
unit_of_measurement: "°C"
slave: 0
address: 1023
input_type: holding
count: 1
precision: 1
data_type: int16
scale: 0.1
scan_interval: 60
device_class: TEMPERATURE
- name: "parmair.poistoilman_lampotila"
unit_of_measurement: "°C"
slave: 0
address: 1024
input_type: holding
count: 1
precision: 1
data_type: int16
scale: 0.1
scan_interval: 60
device_class: TEMPERATURE
- name: "parmair.jateilman_lampotila"
unit_of_measurement: "°C"
slave: 0
address: 1025
input_type: holding
count: 1
precision: 1
data_type: int16
scale: 0.1
scan_interval: 60
device_class: TEMPERATURE
- name: "parmair.kosteusmittaus_LTO-laite"
unit_of_measurement: "%"
slave: 0
address: 1026
input_type: holding
count: 1
precision: 1
data_type: int16
scale: 1
scan_interval: 60
device_class: MOISTURE
#Muut sensorit
- name: "parmair.saatoasento_LTO "
unit_of_measurement: "%"
slave: 0
address: 1046
input_type: holding
count: 1
precision: 1
data_type: int16
scale: 1
scan_interval: 60
device_class: MOISTURE
- name: "parmair.sisailma_CO2"
unit_of_measurement: "ppm"
slave: 0
address: 1031
input_type: holding
count: 1
precision: 1
data_type: int16
scale: 1
scan_interval: 60
device_class: CARBON_DIOXIDE
- name: "parmair.iv-nopeusasetus"
unit_of_measurement: ""
slave: 0
address: 1187
input_type: holding
count: 1
precision: 0
data_type: int16
scale: 1
scan_interval: 30
device_class: SPEED
- name: "parmair.kosteusmittauksen_24h_keskiarvo"
unit_of_measurement: "%"
slave: 0
address: 1192
input_type: holding
count: 1
precision: 1
data_type: int16
scale: 0.1
scan_interval: 30
device_class: MOISTURE
#Puhaltimet, esi- ja jälkilämmitys
- name: "parmair.saato_tulopuhallin"
unit_of_measurement: "%"
slave: 0
address: 1040
input_type: holding
count: 1
precision: 1
data_type: int16
scale: 0.1
scan_interval: 60
device_class: SPEED
- name: "parmair.saato_poistopuhallin"
unit_of_measurement: "%"
slave: 0
address: 1042
input_type: holding
count: 1
precision: 1
data_type: int16
scale: 0.1
scan_interval: 60
device_class: SPEED
- name: "parmair.saato_jalkilammitys"
unit_of_measurement: "%"
slave: 0
address: 1044
input_type: holding
count: 1
precision: 1
data_type: int16
scale: 0.1
scan_interval: 60
device_class: POWER_FACTOR
- name: "parmair.saato_LTO"
unit_of_measurement: "%"
slave: 0
address: 1046
input_type: holding
count: 1
precision: 1
data_type: int16
scale: 0.1
scan_interval: 60
device_class: POWER_FACTOR
- name: "parmair.saato_ohituslammitys"
unit_of_measurement: "%"
slave: 0
address: 1048
input_type: holding
count: 1
precision: 1
data_type: int16
scale: 0.1
scan_interval: 60
device_class: POWER_FACTORKäytä alla olevaa koodia 10-2023 jälkeen (v2.0x) asennetuihin iv-laitteisiin.
# Parmair modbus (v2.00-)
modbus:
- name: "Anna tähän nimi"
type: tcp
host: # Kirjoita oman ilmanvaihtolaitteesi IPv4 tähän
port: 502
sensors:
#Temperature & humidity sensors
- name: "parmair.raitisilma"
unit_of_measurement: "°C"
slave: 0
address: 1020
input_type: holding
precision: 1
data_type: int16
scale: 0.1
scan_interval: 60
device_class: TEMPERATURE
- name: "parmair.tuloilma"
unit_of_measurement: "°C"
slave: 0
address: 1022
input_type: holding
precision: 1
data_type: int16
scale: 0.1
scan_interval: 60
device_class: TEMPERATURE
- name: "parmair.poistoilma"
unit_of_measurement: "°C"
slave: 0
address: 1024
input_type: holding
precision: 1
data_type: int16
scale: 0.1
scan_interval: 60
device_class: TEMPERATURE
- name: "parmair.jateilma"
unit_of_measurement: "°C"
slave: 0
address: 1023
input_type: holding
precision: 1
data_type: int16
scale: 0.1
scan_interval: 60
device_class: TEMPERATURE
# Kosteusmittaus
- name: "parmair.kosteusmittauksen_24h_ka"
unit_of_measurement: "%"
slave: 0
address: 1192
input_type: holding
precision: 1
data_type: int16
scale: 0.1
scan_interval: 60
device_class: MOISTURE
- name: "parmair.kosteusmittaus"
unit_of_measurement: "%"
slave: 0
address: 1025
input_type: holding
precision: 1
data_type: int16
scale: 1
scan_interval: 60
device_class: MOISTURE
# CO2-mittaus
- name: "parmair.CO2"
unit_of_measurement: "ppm"
slave: 0
address: 1026
input_type: holding
precision: 1
data_type: int16
scale: 1
scan_interval: 60
device_class: CARBON_DIOXIDE
# Ohjaustila
- name: "parmair.iv-nopeusasetus"
unit_of_measurement: ""
slave: 0
address: 1187
input_type: holding
precision: 0
data_type: int16
scale: 1
scan_interval: 30
device_class: SPEED
# parmair.FG50_Y
- name: "parmair.saatoasento_LTO"
unit_of_measurement: "%"
slave: 0
address: 1046
input_type: holding
precision: 1
data_type: int16
scale: 0.1
scan_interval: 30
device_class: POWER_FACTOR
# parmair.TV45_Y
- name: "parmair.jalkilammitys"
unit_of_measurement: "%"
slave: 0
address: 1044
input_type: holding
precision: 1
data_type: int16
scale: 0.1
scan_interval: 60
device_class: MOISTURE
# Puhallinnopeudet - parmair.TF10_Y (tulo) - parmair.PF30_Y (poisto)
- name: "parmair.tulopuhallin_saato"
unit_of_measurement: "%"
slave: 0
address: 1040
input_type: holding
precision: 1
data_type: int16
scale: 0.1
scan_interval: 60
device_class: SPEED
- name: "pa.poistopuhallin_saato"
unit_of_measurement: "%"
slave: 0
address: 1042
input_type: holding
precision: 1
data_type: int16
scale: 0.1
scan_interval: 60
device_class: SPEED
#Sulatusparametrit
- name: "parmair.LTO_kylmapiste"
unit_of_measurement: "°C"
slave: 0
address: 1021
input_type: holding
precision: 1
data_type: int16
scale: 0.1
scan_interval: 60
device_class: TEMPERATURE
- name: "parmair.ohituslammitys"
unit_of_measurement: "%"
slave: 0
address: 1048
input_type: holding
precision: 1
data_type: int16
scale: 0.1
scan_interval: 60
device_class: MOISTURE
Tämä koodi antaa Raspberry Pi:n hakea verkon kautta tietoa laitteessa olevista antureista. Anturit on myös nimetty parmair.xxx, jotta niiden erottaminen olisi helpompaa.
Verkon IP skannaus
Seuraavaksi sinun täytyy selvittää ilmanvaihtolaitteesi IP-osoite.
Tämä hoituu käyttämällä IP-Skanneria.
Siirry osoitteeseen https://www.advanced-ip-scanner.com/
ja lataa ohjelma koneellesi (Windows tai Linux). Ohjelma on ilmainen.
Käytä Skannaa toimintoa löytääksesi verkkoon kytketty ilmanvaihtolaite.
Jos sinulla on käytössä Parmair IoT -paketti, niin tunnistat Parmair ilmanvaihtokoneen fx-alkuisesta nimestä.
Kirjoita IP-osoite muistiin ja lisää se Raspberry Pi:n configuration.yaml tiedostoon.
Huom!
Varmista että ilmanvaihtokone ja tietokone, jolla teet IP-skannauksen ovat samassa verkossa. Muuten IP-Skanneri ei löydä ilmanvaihtokonetta verkosta.
IP-osoitteen lisääminen
configuration.yaml tiedoston koodin alkuun tulee lisätä punaisella kirjoitettuihin kohtiin nimi ja edellisessä vaiheessa etsitty IP-osoite. Nimi pitää olla lainausmerkkien sisällä ilman välilyöntejä.
# Parmair modbus
modbus:
- name: "anna_tahan_nimi"
type: tcp
host: Laitteen IPv4. IP löytyy verkon Skannaamalla
port: 502
sensors: Huom!
Koodissa ei saa olla välilyöntejä sekä rivien sisennykset on oltava täsmälleen oikein, muuten koodi ei toimi!
Käynnistä Home Assistant uudelleen
Aina kun muutat asetuksia tai koodia, sinun on käynnistettävä käyttöjärjestelmä uudelleen. Siirry Home Assistant -käyttöliittymässä kohtaan Asetukset > Järjestelmä ja napsauta Käynnistä uudelleen -painiketta.
Oman ”työpöydän” tekeminen
Seuraavaksi haetaan omalle työpöydälle (Yleisnäkymä-välilehti) Parmair ilmanvaihtokoneen dataa.
- Siirry Yleisnäkymä sivulle ja klikkaa näytön oikeasta yläkulmasta kolmen pisteen -kuvaketta.
- Klikkaa Muokkaa käyttöliittymää.
- Klikkaa näytön alakulmassa olevaa + LISÄÄ KORTTI -painiketta.
- Valitse haluamasi kortti esim. Kohteet-kortti, johon voit lisätä kaikki datan allekkain.
- Anna kortille otsikko.
- Siirry kohtaan ’Kohteet’ ja valitse kynä-kuvakkeen takaa kohde, jonka haluat lisätä.
- Parmair ilmanvaihtolaitteen kohteita voi hakea kirjoittamalla esim. parmair.raitisilma
- Kun olet lisännyt kaikki haluamasi kohteet, klikkaa TALLENNA.
Asennus on nyt valmis
Hienoa, nyt olet saanut Home Assistantin näyttämään ilmanvaihtokoneesi tietoja. Lisää dataa voidaan hakea Modbus-rekisterin avulla.
Ennen 10-2023 asennettuihin Parmair ilmanvaihtokoneisiin joissa on IOT Lataa Parmair Modbus V1.XX rekisteri
Jälkeen 10-2023 asennettuihin Parmair ilmanvaihtokoneisiin joissa on IOT Lataa Parmair Modbus V2.XX rekisteri
Huom!
Parmair IoT -paketin (Ethernet) kautta, eli Modbus TCP niin rekistereihin pitää lisätä 1000. Eli rekisterilistauksen rekisteri 10 onkin 1010.
