You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
IoT-For-Beginners/translations/fi/1-getting-started/lessons/1-introduction-to-iot/wio-terminal.md

12 KiB

Wio Terminal

Wio Terminal Seeed Studiosilta on Arduino-yhteensopiva mikrokontrolleri, jossa on WiFi sekä sisäänrakennettuja sensoreita ja toimilaitteita. Lisäksi siinä on liitäntöjä, joiden avulla voit lisätä enemmän sensoreita ja toimilaitteita käyttäen laitteistoekosysteemiä nimeltä Grove.

Seeed Studiosin Wio Terminal

Asennus

Jotta voit käyttää Wio Terminalia, sinun täytyy asentaa tietokoneellesi ilmainen ohjelmisto. Lisäksi sinun täytyy päivittää Wio Terminalin laiteohjelmisto ennen kuin voit yhdistää sen WiFi-verkkoon.

Tehtävä - asennus

Asenna tarvittava ohjelmisto ja päivitä laiteohjelmisto.

  1. Asenna Visual Studio Code (VS Code). Tämä on editori, jota käytät kirjoittaaksesi laitteen koodia C/C++-kielellä. Katso VS Code -dokumentaatio saadaksesi ohjeet VS Coden asentamiseen.

    💁 Toinen suosittu IDE Arduino-kehitykseen on Arduino IDE. Jos olet jo tuttu tämän työkalun kanssa, voit käyttää sitä VS Coden ja PlatformIO:n sijaan, mutta oppitunneilla annetaan ohjeet käyttäen VS Codea.

  2. Asenna VS Coden PlatformIO-laajennus. Tämä on VS Codeen tarkoitettu laajennus, joka tukee mikrokontrollerien ohjelmointia C/C++-kielellä. Katso PlatformIO-laajennuksen dokumentaatio saadaksesi ohjeet tämän laajennuksen asentamiseen VS Codeen. Tämä laajennus vaatii Microsoftin C/C++-laajennuksen toimiakseen C- ja C++-koodin kanssa, ja C/C++-laajennus asennetaan automaattisesti, kun asennat PlatformIO:n.

  3. Yhdistä Wio Terminal tietokoneeseesi. Wio Terminalissa on USB-C-portti pohjassa, ja tämä täytyy yhdistää tietokoneesi USB-porttiin. Wio Terminalin mukana tulee USB-CUSB-A-kaapeli, mutta jos tietokoneessasi on vain USB-C-portteja, tarvitset joko USB-C-kaapelin tai USB-AUSB-C-sovittimen.

  4. Seuraa Wio Terminal Wiki WiFi Overview -dokumentaation ohjeita asentaaksesi Wio Terminalin ja päivittääksesi laiteohjelmiston.

Hello World

On perinteistä aloittaa uuden ohjelmointikielen tai teknologian käyttö luomalla 'Hello World' -sovellus pieni sovellus, joka tulostaa esimerkiksi tekstin "Hello World" osoittaakseen, että kaikki työkalut on asennettu oikein.

Wio Terminalin Hello World -sovellus varmistaa, että Visual Studio Code on asennettu oikein PlatformIO:n kanssa ja että se on valmis mikrokontrollerikehitykseen.

Luo PlatformIO-projekti

Ensimmäinen askel on luoda uusi projekti PlatformIO:ssa, joka on konfiguroitu Wio Terminalille.

Tehtävä - luo PlatformIO-projekti

Luo PlatformIO-projekti.

  1. Yhdistä Wio Terminal tietokoneeseesi.

  2. Käynnistä VS Code.

  3. PlatformIO-kuvake löytyy sivupalkista:

    PlatformIO-valikkovaihtoehto

    Valitse tämä valikkovaihtoehto ja valitse PIO Home -> Open.

    PlatformIO:n avausvaihtoehto

  4. Tervetulonäytöstä valitse + New Project -painike.

    Uuden projektin painike

  5. Konfiguroi projekti Project Wizardissa:

    1. Nimeä projektisi nightlight.

    2. Board-pudotusvalikosta kirjoita WIO suodattaaksesi lautoja ja valitse Seeeduino Wio Terminal.

    3. Jätä Framework kohdaksi Arduino.

    4. Jätä Use default location -valintaruutu valituksi tai poista valinta ja valitse sijainti projektillesi.

    5. Valitse Finish-painike.

    Valmis projektin ohjattu toiminto

    PlatformIO lataa tarvittavat komponentit koodin kääntämiseksi Wio Terminalille ja luo projektisi. Tämä voi kestää muutaman minuutin.

Tutki PlatformIO-projektia

VS Coden resurssienhallinta näyttää joukon tiedostoja ja kansioita, jotka PlatformIO:n ohjattu toiminto on luonut.

Kansiot

  • .pio - tämä kansio sisältää väliaikaista dataa, jota PlatformIO tarvitsee, kuten kirjastoja tai käännettyä koodia. Se luodaan automaattisesti uudelleen, jos se poistetaan, eikä sitä tarvitse lisätä versionhallintaan, jos jaat projektisi esimerkiksi GitHubissa.
  • .vscode - tämä kansio sisältää PlatformIO:n ja VS Coden käyttämän konfiguraation. Se luodaan automaattisesti uudelleen, jos se poistetaan, eikä sitä tarvitse lisätä versionhallintaan, jos jaat projektisi esimerkiksi GitHubissa.
  • include - tämä kansio on ulkoisille otsikkotiedostoille, joita tarvitaan lisäkirjastojen lisäämiseen koodiin. Et käytä tätä kansiota näissä oppitunneissa.
  • lib - tämä kansio on ulkoisille kirjastoille, joita haluat kutsua koodistasi. Et käytä tätä kansiota näissä oppitunneissa.
  • src - tämä kansio sisältää sovelluksesi pääkoodin. Aluksi siinä on yksi tiedosto - main.cpp.
  • test - tämä kansio on tarkoitettu yksikkötesteille koodillesi.

Tiedostot

  • main.cpp - tämä tiedosto src-kansiossa sisältää sovelluksesi aloituspisteen. Avaa tämä tiedosto, ja siinä on seuraava koodi:

    #include <Arduino.h>
    
    void setup() {
      // put your setup code here, to run once:
    }
    
    void loop() {
      // put your main code here, to run repeatedly:
    }
    

    Kun laite käynnistyy, Arduino-kehys suorittaa setup-funktion kerran ja sen jälkeen loop-funktion toistuvasti, kunnes laite sammutetaan.

  • .gitignore - tämä tiedosto listaa tiedostot ja kansiot, jotka tulee jättää huomiotta, kun lisäät koodisi git-versionhallintaan, kuten ladatessasi sen GitHub-repositorioon.

  • platformio.ini - tämä tiedosto sisältää konfiguraation laitteellesi ja sovelluksellesi. Avaa tämä tiedosto, ja siinä on seuraava koodi:

    [env:seeed_wio_terminal]
    platform = atmelsam
    board = seeed_wio_terminal
    framework = arduino
    

    [env:seeed_wio_terminal]-osio sisältää konfiguraation Wio Terminalille. Voit lisätä useita env-osioita, jotta koodisi voidaan kääntää useille laudoille.

    Muut arvot vastaavat projektin ohjatun toiminnon konfiguraatiota:

    • platform = atmelsam määrittää laitteiston, jota Wio Terminal käyttää (ATSAMD51-pohjainen mikrokontrolleri).
    • board = seeed_wio_terminal määrittää mikrokontrollerilaudan tyypin (Wio Terminal).
    • framework = arduino määrittää, että tämä projekti käyttää Arduino-kehystä.

Kirjoita Hello World -sovellus

Olet nyt valmis kirjoittamaan Hello World -sovelluksen.

Tehtävä - kirjoita Hello World -sovellus

Kirjoita Hello World -sovellus.

  1. Avaa main.cpp-tiedosto VS Codessa.

  2. Muuta koodi vastaamaan seuraavaa:

    #include <Arduino.h>
    
    void setup()
    {
        Serial.begin(9600);
    
        while (!Serial)
            ; // Wait for Serial to be ready
    
        delay(1000);
    }
    
    void loop()
    {
        Serial.println("Hello World");
        delay(5000);
    }
    

    setup-funktio alustaa yhteyden sarjaporttiin tässä tapauksessa USB-porttiin, jota käytetään Wio Terminalin yhdistämiseen tietokoneeseen. Parametri 9600 on baudinopeus (tunnetaan myös nimellä symbolinopeus), eli nopeus, jolla dataa lähetetään sarjaportin kautta bitteinä sekunnissa. Tämä asetus tarkoittaa, että 9 600 bittiä (0:ia ja 1:siä) dataa lähetetään sekunnissa. Se odottaa sitten, että sarjaportti on valmis.

    loop-funktio lähettää rivin Hello World! sarjaporttiin, eli Hello World!-merkit ja uuden rivin merkin. Se sitten nukkuu 5 000 millisekuntia eli 5 sekuntia. Kun loop päättyy, se suoritetaan uudelleen, ja uudelleen, ja niin edelleen niin kauan kuin mikrokontrolleri on päällä.

  3. Aseta Wio Terminal lataustilaan. Sinun täytyy tehdä tämä joka kerta, kun lataat uutta koodia laitteeseen:

    1. Vedä virtakytkintä alas nopeasti kahdesti se palautuu takaisin päälle-asentoon joka kerta.

    2. Tarkista sininen tilavalo USB-portin oikealla puolella. Sen pitäisi sykkiä.

    Video, joka näyttää, miten Wio Terminal asetetaan lataustilaan

    Klikkaa yllä olevaa kuvaa nähdäksesi videon, joka näyttää, miten tämä tehdään.

  4. Rakenna ja lataa koodi Wio Terminalille.

    1. Avaa VS Coden komentopaletti.

    2. Kirjoita PlatformIO Upload etsiäksesi latausvaihtoehdon ja valitse PlatformIO: Upload.

      PlatformIO:n latausvaihtoehto komentopaletissa

      PlatformIO kääntää koodin automaattisesti tarvittaessa ennen lataamista.

    3. Koodi käännetään ja ladataan Wio Terminalille.

      💁 Jos käytät macOS:ia, ilmoitus DISK NOT EJECTED PROPERLY ilmestyy. Tämä johtuu siitä, että Wio Terminal liitetään asemaksi osana ohjelmointiprosessia, ja se irrotetaan, kun käännetty koodi kirjoitetaan laitteeseen. Voit ohittaa tämän ilmoituksen.

    ⚠️ Jos saat virheitä, joissa latausportti ei ole käytettävissä, varmista ensin, että Wio Terminal on yhdistetty tietokoneeseesi ja kytketty päälle näytön vasemmalla puolella olevalla kytkimellä, ja asetettu lataustilaan. Vihreän valon pohjassa pitäisi olla päällä, ja sinisen valon pitäisi sykkiä. Jos virhe jatkuu, vedä virtakytkintä alas nopeasti kahdesti uudelleen pakottaaksesi Wio Terminal lataustilaan ja yritä latausta uudelleen.

PlatformIO:ssa on sarjaportin monitori, joka voi seurata USB-kaapelin kautta lähetettyä dataa Wio Terminalilta. Tämä mahdollistaa datan seuraamisen, jonka Serial.println("Hello World");-komento lähettää.

  1. Avaa VS Coden komentopaletti.

  2. Kirjoita PlatformIO Serial etsiäksesi sarjaportin monitorivaihtoehdon ja valitse PlatformIO: Serial Monitor.

    PlatformIO:n sarjaportin monitorivaihtoehto komentopaletissa

    Uusi terminaali avautuu, ja sarjaportin kautta lähetetty data striimataan tähän terminaaliin:

    > Executing task: platformio device monitor <
    
    --- Available filters and text transformations: colorize, debug, default, direct, hexlify, log2file, nocontrol, printable, send_on_enter, time
    --- More details at http://bit.ly/pio-monitor-filters
    --- Miniterm on /dev/cu.usbmodem101  9600,8,N,1 ---
    --- Quit: Ctrl+C | Menu: Ctrl+T | Help: Ctrl+T followed by Ctrl+H ---
    Hello World
    Hello World
    

    Hello World tulostuu sarjaportin monitoriin joka 5. sekunti.

💁 Löydät tämän koodin code/wio-terminal-kansiosta.

😀 'Hello World' -ohjelmasi onnistui!


Vastuuvapauslauseke:
Tämä asiakirja on käännetty käyttämällä tekoälypohjaista käännöspalvelua Co-op Translator. Vaikka pyrimme tarkkuuteen, huomioithan, että automaattiset käännökset voivat sisältää virheitä tai epätarkkuuksia. Alkuperäinen asiakirja sen alkuperäisellä kielellä tulisi pitää ensisijaisena lähteenä. Kriittisen tiedon osalta suositellaan ammattimaista ihmiskäännöstä. Emme ole vastuussa väärinkäsityksistä tai virhetulkinnoista, jotka johtuvat tämän käännöksen käytöstä.