====== Kiirstardi juhend ======

====== Arenduskeskkonna seadistamine ======

Laadige alla ja installige VS Code [[https://code.visualstudio.com/|siit]]

=====Python'i installimine Windowsi=====

Laadige alla Python [[https://www.python.org/downloads/|siit]]

Enne installimist veenduge, et **Add Python to PATH** valik oleks märgitud

{{:en:iot:examples:setup:check.png?200|}}

=====Python'i installimine Linuxi=====

Avage terminal ja kontrollige, kas teil on Python 3 installitud.

<code>
$ python3 --version
</code>

Kui teil ei ole Python 3 installitud, käivitage järgmine käsk.
<code>
$ sudo apt install python3
</code>

Kas teil oli Python juba installitud või mitte, peate käivitama järgmise käsu.
<code>
$ sudo apt install python3-distutils
</code>

=====PlatformIO IDE installimine VS Code'ile=====

  - Klõpsake **Extensions** ikoonil või vajutage **Ctrl+Shift+X**, et avada laienduste vahekaart
  - Otsige "PlatformIO IDE"
  - Valige esimene valik
  - Klõpsake **Install** nupul

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

Pärast installimist veenduge, et laiendus on lubatud.

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

Pärast seda peaks PlatformIO ikoon ilmuma vasakule külgribale ja **Home** ikoon suunab teid PlatformIO avalehele. Kui ei, taaskäivitage Visual Studio Code.

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

====== Oma esimese projekti loomine ======

=====PlatformIO IDE kasutamine=====

VS Code'is klõpsake PlatformIO **Home** ikoonil. Klõpsake **+ New Project**, et alustada uut projekti.

{{:en:iot:examples:setup:new-project.png?600|}}

Andke oma projektile nimi, valige pardaks **WeMos D1 MINI ESP32 (WEMOS)** ja raamistikuks **Arduino Framework**

{{:en:iot:examples:quickstart:doc1.png?600|}}

Pärast seadistuse lõpetamist peaks projekt olema ligipääsetav explorer vahekaardilt.

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

====platformio.ini fail====

**platformio.ini** fail on PlatformIO konfiguratsioonifail teie projekti jaoks. See näitab platvormi, plaati ja raamistikku teie projekti jaoks. Samuti saate lisada muid konfiguratsioone nagu raamatukogud, üleslaadimisvalikud, Serial Monitor baud rate muutmine ja muud konfiguratsioonid.

Lisage järgmine rida, et lisada ITTIoT raamatukogu ja muud parameetrid (kontrollige õiget porti, näiteks COM3):

<code>
upload_speed = 921600
upload_port = COM3
//upload_port = COM3 // Linuxi puhul /dev/ttyUSB0
monitor_speed = 115200
lib_deps = ITTIoT
</code>

{{:en:iot:examples:quickstart:platformio_ini.png?600|}}

====src kaust====

**src** kaust on teie töökaust. Src kaustas on fail main.cpp. Siia kirjutate oma koodi. Klõpsake sellel failil. Arduino programmi struktuur peaks avanema koos setup() ja loop() funktsioonidega.

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

Kleepige järgmine näidiskood main.cpp faili

<code c>
#include <Arduino.h>
#include <ittiot.h>

void iot_received(String topic, String msg){
    Serial.print("MSG FROM USER callback, topic: ");
    Serial.print(topic);
    Serial.print(" payload: ");
    Serial.println(msg);
}

void iot_connected(){
    Serial.println("MQTT connected callback");
    iot.subscribe("mytopic");
    iot.log("Hello from ESP!");
}

void setup() {
    Serial.begin(115200);
    iot.setConfig("wname", "myWiFi"); //Teie wifi nimi
    iot.setConfig("wpass", "myPassword"); // Teie wifi parool
    iot.setConfig("msrv", ""); // Teie MQTT vahendaja IP
    iot.setConfig("mport", ""); // Teie MQTT vahendaja port - vaikimisi: 1883
    iot.setConfig("muser", ""); // Teie MQTT vahendaja kasutajanimi - vaikimisi tühi
    iot.setConfig("mpass", ""); // Teie MQTT vahendaja parool - vaikimisi tühi
    iot.printConfig(); // prindi json konfiguratsioon serialile
    iot.setBootPin(5);
    iot.setup();
}

void loop() {
    iot.handle();
}
</code>

Veenduge, et olete asendanud ühendusteabe oma andmetega.

=====Koodi üleslaadimine PlatformIO IDE abil=====

Koodi testimiseks ja üleslaadimiseks salvestage esmalt oma kood ja seejärel klõpsake redaktori allosas asuval **Build** ikoonil, et veenduda, et teie kood töötab. Pärast edukat koostamist vajutage **Upload** ikooni. Teise võimalusena võite minna **PIO Project Tasks** menüüsse ja valida sealt build või upload.

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

====== Ühenduse kontrollimine ======

Kui kood on edukalt kompileeritud ja üles laaditud, peaks serial monitor automaatselt avanema ja näitama kontrolleri otseandmeid:

{{:en:iot:examples:quickstart:doc3-1.png?600|}}

Kui serial monitor ei avane automaatselt, klõpsake allolevat nuppu:

{{:en:iot:examples:quickstart:doc3-2.png?600|}}

See tähendab, et kood laaditi edukalt üles ja plaat ühendati MQTT serveriga.

Installige [[https://chrome.google.com/webstore/detail/mqttbox/kaajoficamnjijhkeomgfljpicifbkaf|MQTTBox]] Chrome'i rakendus, et avaldada ja tellida sõnumeid MQTT serverisse.

Seadistage ühendus oma andmetega ja avaldage sõnum teemale, mida teie plaat kuulab (//mytopic// näites).

Plaat peaks sõnumi vastu võtma ja selle serial monitoris välja printima:

{{:en:iot:examples:quickstart:doc4-1.png?600|}}