12 KiB

Raw Permalink Blame History Unescape Escape

Wio Terminal

Wio Terminal fra Seeed Studios er en Arduino-kompatibel mikrokontroller med innebygd WiFi, sensorer og aktuatorer, samt porter for å legge til flere sensorer og aktuatorer ved hjelp av et maskinvareøkosystem kalt Grove.

Oppsett

For å bruke din Wio Terminal må du installere gratis programvare på datamaskinen din. Du må også oppdatere Wio Terminal-firmware før du kan koble den til WiFi.

Oppgave - oppsett

Installer nødvendig programvare og oppdater firmware.

Installer Visual Studio Code (VS Code). Dette er editoren du vil bruke til å skrive kode for enheten din i C/C++. Se VS Code-dokumentasjonen for instruksjoner om hvordan du installerer VS Code.

💁 En annen populær IDE for Arduino-utvikling er Arduino IDE. Hvis du allerede er kjent med dette verktøyet, kan du bruke det i stedet for VS Code og PlatformIO, men leksjonene vil gi instruksjoner basert på bruk av VS Code.
Installer VS Code PlatformIO-utvidelsen. Dette er en utvidelse for VS Code som støtter programmering av mikrokontrollere i C/C++. Se PlatformIO-utvidelsesdokumentasjonen for instruksjoner om hvordan du installerer denne utvidelsen i VS Code. Denne utvidelsen er avhengig av Microsoft C/C++-utvidelsen for å fungere med C- og C++-kode, og C/C++-utvidelsen installeres automatisk når du installerer PlatformIO.
Koble din Wio Terminal til datamaskinen. Wio Terminal har en USB-C-port på bunnen, og denne må kobles til en USB-port på datamaskinen din. Wio Terminal leveres med en USB-C til USB-A-kabel, men hvis datamaskinen din bare har USB-C-porter, trenger du enten en USB-C-kabel eller en USB-A til USB-C-adapter.
Følg instruksjonene i Wio Terminal Wiki WiFi Overview-dokumentasjonen for å sette opp din Wio Terminal og oppdatere firmware.

Hello world

Det er tradisjonelt når man starter med et nytt programmeringsspråk eller teknologi å lage en 'Hello World'-applikasjon – en liten applikasjon som viser tekst som "Hello World" for å bekrefte at alle verktøyene er riktig konfigurert.

Hello World-appen for Wio Terminal vil sikre at du har installert Visual Studio Code korrekt med PlatformIO og satt opp for mikrokontrollerutvikling.

Opprett et PlatformIO-prosjekt

Første steg er å opprette et nytt prosjekt ved hjelp av PlatformIO konfigurert for Wio Terminal.

Oppgave - opprett et PlatformIO-prosjekt

Opprett PlatformIO-prosjektet.

Koble Wio Terminal til datamaskinen din
Start VS Code
PlatformIO-ikonet vil være på sidemenyen:

Velg dette menyvalget, og deretter PIO Home -> Open
Fra velkomstskjermen, velg + New Project-knappen
Konfigurer prosjektet i Project Wizard:
1. Navngi prosjektet ditt nightlight
2. Fra Board-nedtrekksmenyen, skriv inn WIO for å filtrere kortene, og velg Seeeduino Wio Terminal
3. La Framework stå som Arduino
4. Enten la Use default location-avkrysningsboksen være krysset av, eller fjern krysset og velg en plassering for prosjektet ditt
5. Velg Finish-knappen
PlatformIO vil laste ned komponentene det trenger for å kompilere kode for Wio Terminal og opprette prosjektet ditt. Dette kan ta noen minutter.

Utforsk PlatformIO-prosjektet

VS Code Explorer vil vise en rekke filer og mapper opprettet av PlatformIO-veiviseren.

Mapper

.pio - denne mappen inneholder midlertidige data som trengs av PlatformIO, som biblioteker eller kompilert kode. Den opprettes automatisk på nytt hvis den slettes, og du trenger ikke legge denne til kildekodekontroll hvis du deler prosjektet ditt på nettsteder som GitHub.
.vscode - denne mappen inneholder konfigurasjonen brukt av PlatformIO og VS Code. Den opprettes automatisk på nytt hvis den slettes, og du trenger ikke legge denne til kildekodekontroll hvis du deler prosjektet ditt på nettsteder som GitHub.
include - denne mappen er for eksterne header-filer som trengs når du legger til ekstra biblioteker i koden din. Du vil ikke bruke denne mappen i noen av disse leksjonene.
lib - denne mappen er for eksterne biblioteker som du vil kalle fra koden din. Du vil ikke bruke denne mappen i noen av disse leksjonene.
src - denne mappen inneholder hovedkildekoden for applikasjonen din. Opprinnelig vil den inneholde én fil - main.cpp.
test - denne mappen er der du kan legge eventuelle enhetstester for koden din.

Filer

main.cpp - denne filen i src-mappen inneholder startpunktet for applikasjonen din. Åpne denne filen, og den vil inneholde følgende kode:
```
#include <Arduino.h>

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

void loop() {
  // put your main code here, to run repeatedly:
}
```
Når enheten starter opp, vil Arduino-rammeverket kjøre setup-funksjonen én gang, og deretter kjøre loop-funksjonen gjentatte ganger til enheten slås av.
.gitignore - denne filen lister opp filer og kataloger som skal ignoreres når du legger koden din til git kildekodekontroll, som for eksempel opplasting til et GitHub-repositorium.
platformio.ini - denne filen inneholder konfigurasjon for enheten og appen din. Åpne denne filen, og den vil inneholde følgende kode:
```
[env:seeed_wio_terminal]
platform = atmelsam
board = seeed_wio_terminal
framework = arduino
```
Seksjonen [env:seeed_wio_terminal] har konfigurasjon for Wio Terminal. Du kan ha flere env-seksjoner slik at koden din kan kompileres for flere kort.

De andre verdiene samsvarer med konfigurasjonen fra prosjektveiviseren:
- platform = atmelsam definerer maskinvaren som Wio Terminal bruker (en ATSAMD51-basert mikrokontroller)
- board = seeed_wio_terminal definerer typen mikrokontrollerkort (Wio Terminal)
- framework = arduino definerer at dette prosjektet bruker Arduino-rammeverket.

Skriv Hello World-appen

Du er nå klar til å skrive Hello World-appen.

Oppgave - skriv Hello World-appen

Skriv Hello World-appen.

Åpne main.cpp-filen i VS Code
Endre koden til å samsvare med følgende:
```
#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-funksjonen initialiserer en tilkobling til den serielle porten – i dette tilfellet USB-porten som brukes til å koble Wio Terminal til datamaskinen din. Parameteren 9600 er baud rate (også kjent som symbolrate), eller hastigheten som data sendes over den serielle porten i biter per sekund. Denne innstillingen betyr at 9,600 biter (0-er og 1-ere) av data sendes hvert sekund. Den venter deretter på at den serielle porten skal være klar.

loop-funksjonen sender linjen Hello World! til den serielle porten, slik at tegnene Hello World! sammen med et linjeskift sendes. Den sover deretter i 5,000 millisekunder eller 5 sekunder. Etter at loop avsluttes, kjøres den igjen, og igjen, og så videre hele tiden mens mikrokontrolleren er slått på.
Sett Wio Terminal i opplastingsmodus. Du må gjøre dette hver gang du laster opp ny kode til enheten:
1. Skyv strømbryteren ned to ganger raskt – den vil sprette tilbake til på-posisjonen hver gang.
2. Sjekk den blå status-LED-en til høyre for USB-porten. Den skal pulsere.
Klikk på bildet over for en video som viser hvordan du gjør dette.
Bygg og last opp koden til Wio Terminal
1. Åpne VS Code-kommandopaletten
2. Skriv PlatformIO Upload for å søke etter opplastingsvalget, og velg PlatformIO: Upload
  
  PlatformIO vil automatisk bygge koden hvis nødvendig før opplasting.
3. Koden vil bli kompilert og lastet opp til Wio Terminal
  
  💁 Hvis du bruker macOS, vil en melding om DISK NOT EJECTED PROPERLY vises. Dette skyldes at Wio Terminal blir montert som en stasjon som en del av flash-prosessen, og den kobles fra når den kompilerte koden skrives til enheten. Du kan ignorere denne meldingen.
⚠️ Hvis du får feil om at opplastingsporten ikke er tilgjengelig, må du først sørge for at Wio Terminal er koblet til datamaskinen din, slått på med bryteren på venstre side av skjermen, og satt i opplastingsmodus. Det grønne lyset på bunnen skal være på, og det blå lyset skal pulsere. Hvis du fortsatt får feilen, skyv på/av-bryteren ned to ganger raskt igjen for å tvinge Wio Terminal inn i opplastingsmodus og prøv opplastingen på nytt.

PlatformIO har en Serial Monitor som kan overvåke data sendt over USB-kabelen fra Wio Terminal. Dette lar deg overvåke data sendt av Serial.println("Hello World");-kommandoen.

Åpne VS Code-kommandopaletten

Skriv PlatformIO Serial for å søke etter Serial Monitor-valget, og velg PlatformIO: Serial Monitor

En ny terminal vil åpne seg, og data sendt over den serielle porten vil bli strømmet inn i denne terminalen:

> 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 vil skrives ut til den serielle monitoren hvert 5. sekund.

💁 Du finner denne koden i code/wio-terminal-mappen.

😀 Din 'Hello World'-program var en suksess!

Ansvarsfraskrivelse:
Dette dokumentet er oversatt ved hjelp av AI-oversettelsestjenesten Co-op Translator. Selv om vi streber etter nøyaktighet, vær oppmerksom på at automatiserte oversettelser kan inneholde feil eller unøyaktigheter. Det originale dokumentet på sitt opprinnelige språk bør anses som den autoritative kilden. For kritisk informasjon anbefales profesjonell menneskelig oversettelse. Vi er ikke ansvarlige for misforståelser eller feiltolkninger som oppstår ved bruk av denne oversettelsen.

12 KiB Raw Permalink Blame History Unescape Escape