13 KiB

Raw Permalink Blame History

Wio Terminal

A Seeed Studios Wio Terminal egy Arduino-kompatibilis mikrokontroller, beépített WiFi-vel, néhány érzékelővel és aktuátorral, valamint portokkal, amelyek lehetővé teszik további érzékelők és aktuátorok csatlakoztatását a Grove nevű hardveres ökoszisztéma segítségével.

Beállítás

A Wio Terminal használatához telepítened kell néhány ingyenes szoftvert a számítógépedre. Emellett frissítened kell a Wio Terminal firmware-jét, mielőtt csatlakoztatnád WiFi-hez.

Feladat - beállítás

Telepítsd a szükséges szoftvereket és frissítsd a firmware-t.

Telepítsd a Visual Studio Code (VS Code) programot. Ez lesz az a szerkesztő, amelyben a készülékedhez C/C++ kódot fogsz írni. A telepítési útmutatóért tekintsd meg a VS Code dokumentációját.

💁 Egy másik népszerű IDE az Arduino fejlesztéshez az Arduino IDE. Ha már ismered ezt az eszközt, akkor használhatod a VS Code és PlatformIO helyett, de a leckék a VS Code használatára vonatkozó utasításokat tartalmaznak.
Telepítsd a VS Code PlatformIO bővítményt. Ez egy olyan bővítmény, amely támogatja a mikrokontrollerek programozását C/C++ nyelven. A telepítési útmutatóért tekintsd meg a PlatformIO bővítmény dokumentációját. Ez a bővítmény a Microsoft C/C++ bővítményre támaszkodik, amely automatikusan települ a PlatformIO telepítésekor.
Csatlakoztasd a Wio Terminalt a számítógépedhez. A Wio Terminal alján található egy USB-C port, amelyet egy USB porthoz kell csatlakoztatni a számítógépen. A Wio Terminalhoz tartozik egy USB-C - USB-A kábel, de ha a számítógépeden csak USB-C portok vannak, akkor szükséged lesz egy USB-C kábelre vagy egy USB-A - USB-C adapterre.
Kövesd a Wio Terminal Wiki WiFi Overview dokumentációjában található utasításokat a Wio Terminal beállításához és a firmware frissítéséhez.

Hello World

Hagyományosan, amikor egy új programozási nyelvet vagy technológiát kezdünk el használni, létrehozunk egy 'Hello World' alkalmazást - egy kis alkalmazást, amely például a "Hello World" szöveget jeleníti meg, hogy megbizonyosodjunk arról, hogy minden eszköz megfelelően van konfigurálva.

A Wio Terminal Hello World alkalmazása biztosítja, hogy a Visual Studio Code megfelelően telepítve van PlatformIO-val, és be van állítva mikrokontroller fejlesztéshez.

PlatformIO projekt létrehozása

Az első lépés egy új projekt létrehozása PlatformIO-val, amely a Wio Terminalhoz van konfigurálva.

Feladat - PlatformIO projekt létrehozása

Hozd létre a PlatformIO projektet.

Csatlakoztasd a Wio Terminalt a számítógépedhez.
Indítsd el a VS Code-ot.
A PlatformIO ikon a bal oldali menüsávon található:

Válaszd ki ezt a menüpontot, majd válaszd a PIO Home -> Open lehetőséget.
A kezdőképernyőn válaszd ki a + New Project gombot.
Konfiguráld a projektet a Project Wizard-ban:
1. Nevezd el a projektet nightlight.
2. A Board legördülő menüben írd be, hogy WIO, hogy szűkítsd a listát, majd válaszd ki a Seeeduino Wio Terminal-t.
3. Hagyd a Framework-ot Arduino-ként.
4. Hagyd bejelölve a Use default location jelölőnégyzetet, vagy töröld a jelölést, és válassz egy helyet a projekt számára.
5. Kattints a Finish gombra.
A PlatformIO letölti a szükséges komponenseket a Wio Terminal kódjának fordításához, és létrehozza a projektet. Ez néhány percet igénybe vehet.

PlatformIO projekt vizsgálata

A VS Code felfedezője megjeleníti a PlatformIO varázsló által létrehozott fájlokat és mappákat.

Mappák

.pio - ez a mappa ideiglenes adatokat tartalmaz, amelyeket a PlatformIO használ, például könyvtárakat vagy lefordított kódot. Automatikusan újra létrejön, ha törlöd, és nem kell hozzáadnod a forráskód vezérléshez, ha megosztod a projektet például a GitHubon.
.vscode - ez a mappa a PlatformIO és a VS Code által használt konfigurációt tartalmazza. Automatikusan újra létrejön, ha törlöd, és nem kell hozzáadnod a forráskód vezérléshez, ha megosztod a projektet például a GitHubon.
include - ez a mappa külső fejlécfájlok számára van, amelyeket további könyvtárak hozzáadásakor használsz a kódodban. Ebben a leckében nem fogod használni ezt a mappát.
lib - ez a mappa külső könyvtárak számára van, amelyeket a kódodban szeretnél meghívni. Ebben a leckében nem fogod használni ezt a mappát.
src - ez a mappa tartalmazza az alkalmazásod fő forráskódját. Kezdetben egyetlen fájlt tartalmaz - main.cpp.
test - ez a mappa az egységtesztek számára van, amelyeket a kódodhoz írsz.

Fájlok

main.cpp - ez a fájl a src mappában található, és az alkalmazás belépési pontját tartalmazza. Nyisd meg ezt a fájlt, és a következő kódot fogja tartalmazni:
```
#include <Arduino.h>

void setup() {
  // put your setup code here, to run once:
}

void loop() {
  // put your main code here, to run repeatedly:
}
```
Amikor az eszköz elindul, az Arduino keretrendszer egyszer futtatja a setup függvényt, majd folyamatosan futtatja a loop függvényt, amíg az eszköz ki nem kapcsol.
.gitignore - ez a fájl felsorolja azokat a fájlokat és mappákat, amelyeket figyelmen kívül kell hagyni, amikor a kódot hozzáadod a git forráskód vezérléshez, például egy GitHubon lévő tárolóba való feltöltéskor.
platformio.ini - ez a fájl tartalmazza az eszköz és az alkalmazás konfigurációját. Nyisd meg ezt a fájlt, és a következő kódot fogja tartalmazni:
```
[env:seeed_wio_terminal]
platform = atmelsam
board = seeed_wio_terminal
framework = arduino
```
A [env:seeed_wio_terminal] szekció tartalmazza a Wio Terminal konfigurációját. Több env szekciót is létrehozhatsz, hogy a kódod több táblára is lefordítható legyen.

A többi érték megegyezik a projekt varázslóban megadott konfigurációval:
- platform = atmelsam meghatározza a Wio Terminal által használt hardvert (egy ATSAMD51-alapú mikrokontroller)
- board = seeed_wio_terminal meghatározza a mikrokontroller típusát (a Wio Terminal)
- framework = arduino meghatározza, hogy ez a projekt az Arduino keretrendszert használja.

Írd meg a Hello World alkalmazást

Most készen állsz arra, hogy megírd a Hello World alkalmazást.

Feladat - Hello World alkalmazás írása

Írd meg a Hello World alkalmazást.

Nyisd meg a main.cpp fájlt a VS Code-ban.
Módosítsd a kódot az alábbiak szerint:
```
#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);
}
```
A setup függvény inicializálja a kapcsolatot a soros porttal - ebben az esetben az USB porttal, amelyet a Wio Terminal csatlakoztatására használsz a számítógépedhez. A 9600 paraméter a baud rate (más néven szimbólumsebesség), vagyis az adatátvitel sebessége a soros porton másodpercenkénti bitekben. Ez a beállítás azt jelenti, hogy másodpercenként 9,600 bit (0 és 1) adat kerül továbbításra. Ezután várja, hogy a soros port készen álljon.

A loop függvény elküldi a Hello World! sort a soros porton keresztül, így a Hello World! karakterek egy új sor karakterrel együtt továbbítódnak. Ezután 5,000 milliszekundumig, azaz 5 másodpercig várakozik. Miután a loop véget ér, újra és újra fut, amíg a mikrokontroller be van kapcsolva.
Állítsd a Wio Terminalt feltöltési módba. Ezt minden alkalommal meg kell tenned, amikor új kódot töltesz fel az eszközre:
1. Kétszer gyorsan húzd le a bekapcsoló kapcsolót - az vissza fog ugrani az "on" pozícióba minden alkalommal.
2. Ellenőrizd a kék állapotjelző LED-et az USB port jobb oldalán. Pulzálnia kell.
Kattints a fenti képre, hogy megnézd a videót.
Fordítsd le és töltsd fel a kódot a Wio Terminalra.
1. Nyisd meg a VS Code parancspalettáját.
2. Írd be, hogy PlatformIO Upload, hogy megkeresd a feltöltési opciót, majd válaszd a PlatformIO: Upload lehetőséget.
  
  A PlatformIO automatikusan lefordítja a kódot, ha szükséges, mielőtt feltölti.
3. A kód lefordításra kerül, majd feltöltődik a Wio Terminalra.
  
  💁 Ha macOS-t használsz, egy értesítés jelenik meg a DISK NOT EJECTED PROPERLY üzenettel. Ez azért van, mert a Wio Terminal meghajtóként csatlakozik a villogási folyamat részeként, és lecsatlakozik, amikor a lefordított kódot az eszközre írják. Ezt az értesítést figyelmen kívül hagyhatod.
⚠️ Ha hibát kapsz arról, hogy a feltöltési port nem elérhető, először győződj meg arról, hogy a Wio Terminal csatlakoztatva van a számítógépedhez, és be van kapcsolva a képernyő bal oldalán lévő kapcsolóval, valamint feltöltési módba van állítva. Az alsó zöld fénynek világítania kell, és a kék fénynek pulzálnia kell. Ha továbbra is hibát kapsz, húzd le kétszer gyorsan a be-/kikapcsoló kapcsolót, hogy kényszerítsd a Wio Terminalt feltöltési módba, majd próbáld újra a feltöltést.

A PlatformIO rendelkezik egy Soros Monitorral, amely figyelheti az USB kábelen keresztül a Wio Terminal által küldött adatokat. Ez lehetővé teszi, hogy figyeld a Serial.println("Hello World"); parancs által küldött adatokat.

Nyisd meg a VS Code parancspalettáját.

Írd be, hogy PlatformIO Serial, hogy megkeresd a Soros Monitor opciót, majd válaszd a PlatformIO: Serial Monitor lehetőséget.

Egy új terminál nyílik meg, és a soros porton keresztül küldött adatok ebbe a terminálba kerülnek:

> 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

A Hello World minden 5 másodpercben megjelenik a soros monitoron.

💁 Ezt a kódot megtalálod a code/wio-terminal mappában.

😀 A 'Hello World' programod sikeres volt!

Felelősség kizárása:
Ez a dokumentum az AI fordítási szolgáltatás Co-op Translator segítségével lett lefordítva. Bár törekszünk a pontosságra, kérjük, vegye figyelembe, hogy az automatikus fordítások hibákat vagy pontatlanságokat tartalmazhatnak. Az eredeti dokumentum az eredeti nyelvén tekintendő hiteles forrásnak. Kritikus információk esetén javasolt professzionális emberi fordítást igénybe venni. Nem vállalunk felelősséget semmilyen félreértésért vagy téves értelmezésért, amely a fordítás használatából eredhet.

13 KiB Raw Permalink Blame History