====== IoT moodulite konfigureerimine ======

Lühijuhend IoT Kodulabori moodulite konfigureerimiseks nii, et need töötaks mõne muu valitud ruuteri või MQTT-broker-iga. IoT Kodulabori kontrollerimoodulite konfigureerimiseks on vajalik järgmine:
  - Wifi nimi ja parool.
  - MQTT broker-i IP aadress, port, kasutajanimi ja parool (Kui see on määratud).
  - Sülearvuti/PC, millel on olemas WiFi tugi ja programm HTTP POST päringute saatmiseks.

====Vajalik tarkvara====

IoT Kodulabori moodulite konfigureerimiseks on vajalik programm, mis võimaldab teha HTTP POST päringuid. Selles näites kasutame programmi Advanced REST Client (ARC), mida saab alla laadida [[https://install.advancedrestclient.com/install|siit]].

====IoT mooduliga ühendumine====

IoT kontrollerimooduli esimest korda sisse lülitamisel, kui konfiguratsioon puudub või kui moodul ei saa ruuteri või MQTT broker-iga ühendust, läheb see seadistusrežiimi. See tähendab, et luuakse Wifi pääsupunkt, millega saab ühenduda, kasutades arvutit. 

{{:en:iot:examples:setup:iotmodulealgorithm.png?300|}}

Pärast mooduli sisselülitamist ilmub see arvuti Wifi võrkude loendis kujul:

{{:en:iot:examples:setup:wifi.png?300|}}


NB! IoT kontrollerimoodul ei tee Wifi võrku, kui sellel on toimiv ühendus MQTT broker-iga. Mõne teise broker-iga või Wifi võrguga ühendamiseks tuleb moodul olemasoleva Wifi võrgu levialast välja viia. Seda võib teha kas lülitades ruuteri välja või kui see ei ole võimalik, siis tuleb kontroller füüsiliselt ruuteri Wifi leviulatusest välja viia. 

====ARC programmi kasutamine====

Peale ARC programmi avamist tuleb esimesena valida POST meetod. Peale seda tuleb sisestada väljale //Request URL field// järgmine rida:  <code>http://192.168.4.1/set/config</code> Seejärel sisestada //Body parameter// kopeerides järgneva:
<code>{"dname":"ESP44","wname":"raspberryIoT","wpass":"piIoT123","msrv":"192.168.4.1","mport":"1883","muser":"test","mpass":"test","mssl":"false"}</code>
Kui kasutate meie pakutavat Raspberry SD kaardi tõmmist, muutke ainult välja //dname// nime. Kui kasutate mõnda muud MQTT broker-it, tuleb muuta kõik väljad sobivaks. Väljad on järgmised:

^Väli^Selgitus^
|dname|Kontrollermooduli nimi. Nimi on soovitatav moodulile pandud kleepsule kirjutada, et vältida nende segi minekut.|
|wname|Wifi ruuteri SSID, millega soovite ühenduse luua|
|wpass|Wifi-ühenduse parool|
|msrv|MQTT broker-i IP aadress|
|mport|MQTT broker-i port (Tavaliselt 1883, kui ühendutakse kasutades SSL ja kui mitte, siis 8883).|
|muser|MQTT broker-i kasutajanimi. Vajalik, kui kasutatakse SSL ühendusega broker-it.|
|mpass|MQTT broker-i parool. Vajalik, kui kasutatakse SSL ühendusega broker-it.|
|mssl| Tõeväärtus, mis näitab, kas SSL-i kasutatakse või mitte.|

{{:en:iot:examples:setup:arc_settings.png?600|}}

Kui kõik väljad on vastavalt vajadusele konfigureeritud, vajutada SEND, et konfiguratsioon moodulisse üles laadida. Mõne sekundi pärast peaks //body// väljale ilmuma teade //success//. Kui see ei õnnestu, kontrollige, kas ühendus mooduliga on endiselt aktiivne ja kas pole vorminguvigu kuskil.

{{:en:iot:examples:setup:success.png?300|}}