20 KiB

Raw Permalink Blame History Unescape Escape

Wio Terminal

Το Wio Terminal από την Seeed Studios είναι ένας μικροελεγκτής συμβατός με Arduino, με ενσωματωμένο WiFi, αισθητήρες και ενεργοποιητές, καθώς και θύρες για την προσθήκη περισσότερων αισθητήρων και ενεργοποιητών, χρησιμοποιώντας ένα οικοσύστημα υλικού που ονομάζεται Grove.

Ρύθμιση

Για να χρησιμοποιήσετε το Wio Terminal, θα χρειαστεί να εγκαταστήσετε δωρεάν λογισμικό στον υπολογιστή σας. Θα χρειαστεί επίσης να ενημερώσετε το firmware του Wio Terminal πριν το συνδέσετε στο WiFi.

Εργασία - Ρύθμιση

Εγκαταστήστε το απαραίτητο λογισμικό και ενημερώστε το firmware.

Εγκαταστήστε το Visual Studio Code (VS Code). Αυτός είναι ο επεξεργαστής που θα χρησιμοποιήσετε για να γράψετε τον κώδικα της συσκευής σας σε C/C++. Ανατρέξτε στην τεκμηρίωση του VS Code για οδηγίες εγκατάστασης.

💁 Ένα άλλο δημοφιλές IDE για ανάπτυξη με Arduino είναι το Arduino IDE. Αν είστε ήδη εξοικειωμένοι με αυτό το εργαλείο, μπορείτε να το χρησιμοποιήσετε αντί για το VS Code και το PlatformIO, αλλά τα μαθήματα θα παρέχουν οδηγίες βασισμένες στη χρήση του VS Code.
Εγκαταστήστε την επέκταση PlatformIO για το VS Code. Αυτή είναι μια επέκταση που υποστηρίζει τον προγραμματισμό μικροελεγκτών σε C/C++. Ανατρέξτε στην τεκμηρίωση της επέκτασης PlatformIO για οδηγίες εγκατάστασης. Αυτή η επέκταση εξαρτάται από την επέκταση Microsoft C/C++, η οποία εγκαθίσταται αυτόματα με την εγκατάσταση του PlatformIO.
Συνδέστε το Wio Terminal στον υπολογιστή σας. Το Wio Terminal διαθέτει μια θύρα USB-C στο κάτω μέρος, η οποία πρέπει να συνδεθεί σε μια θύρα USB του υπολογιστή σας. Το Wio Terminal συνοδεύεται από ένα καλώδιο USB-C σε USB-A, αλλά αν ο υπολογιστής σας διαθέτει μόνο θύρες USB-C, θα χρειαστείτε είτε ένα καλώδιο USB-C είτε έναν προσαρμογέα USB-A σε USB-C.
Ακολουθήστε τις οδηγίες στην τεκμηρίωση WiFi Overview του Wio Terminal Wiki για να ρυθμίσετε το Wio Terminal και να ενημερώσετε το firmware.

Hello world

Είναι παραδοσιακό όταν ξεκινάτε με μια νέα γλώσσα προγραμματισμού ή τεχνολογία να δημιουργείτε μια εφαρμογή 'Hello World' - μια μικρή εφαρμογή που εμφανίζει κάτι όπως το κείμενο "Hello World" για να επιβεβαιώσετε ότι όλα τα εργαλεία έχουν ρυθμιστεί σωστά.

Η εφαρμογή Hello World για το Wio Terminal θα διασφαλίσει ότι έχετε εγκαταστήσει σωστά το Visual Studio Code με το PlatformIO και ότι είναι έτοιμο για ανάπτυξη μικροελεγκτών.

Δημιουργία έργου PlatformIO

Το πρώτο βήμα είναι να δημιουργήσετε ένα νέο έργο χρησιμοποιώντας το PlatformIO, ρυθμισμένο για το Wio Terminal.

Εργασία - Δημιουργία έργου PlatformIO

Δημιουργήστε το έργο PlatformIO.

Συνδέστε το Wio Terminal στον υπολογιστή σας.
Εκκινήστε το VS Code.
Το εικονίδιο του PlatformIO θα βρίσκεται στη γραμμή μενού στο πλάι:

Επιλέξτε αυτό το στοιχείο μενού και στη συνέχεια επιλέξτε PIO Home -> Open.
Από την οθόνη υποδοχής, επιλέξτε το κουμπί + New Project.
Ρυθμίστε το έργο στον Οδηγό Έργου:
1. Ονομάστε το έργο σας nightlight.
2. Από το αναπτυσσόμενο μενού Board, πληκτρολογήστε WIO για να φιλτράρετε τις πλακέτες και επιλέξτε Seeeduino Wio Terminal.
3. Αφήστε το Framework ως Arduino.
4. Είτε αφήστε επιλεγμένο το Use default location είτε αποεπιλέξτε το και επιλέξτε μια τοποθεσία για το έργο σας.
5. Επιλέξτε το κουμπί Finish.
Το PlatformIO θα κατεβάσει τα απαραίτητα στοιχεία για τη μεταγλώττιση κώδικα για το Wio Terminal και θα δημιουργήσει το έργο σας. Αυτό μπορεί να διαρκέσει μερικά λεπτά.

Εξερεύνηση του έργου PlatformIO

Ο εξερευνητής του VS Code θα εμφανίσει έναν αριθμό αρχείων και φακέλων που δημιουργήθηκαν από τον οδηγό του PlatformIO.

Φάκελοι

.pio - αυτός ο φάκελος περιέχει προσωρινά δεδομένα που χρειάζεται το PlatformIO, όπως βιβλιοθήκες ή μεταγλωττισμένο κώδικα. Δημιουργείται αυτόματα αν διαγραφεί και δεν χρειάζεται να τον προσθέσετε στον έλεγχο πηγαίου κώδικα αν μοιράζεστε το έργο σας σε ιστότοπους όπως το GitHub.
.vscode - αυτός ο φάκελος περιέχει τη ρύθμιση που χρησιμοποιείται από το PlatformIO και το VS Code. Δημιουργείται αυτόματα αν διαγραφεί και δεν χρειάζεται να τον προσθέσετε στον έλεγχο πηγαίου κώδικα αν μοιράζεστε το έργο σας σε ιστότοπους όπως το GitHub.
include - αυτός ο φάκελος είναι για εξωτερικά αρχεία κεφαλίδας που χρειάζονται όταν προσθέτετε επιπλέον βιβλιοθήκες στον κώδικά σας. Δεν θα χρησιμοποιήσετε αυτόν τον φάκελο σε αυτά τα μαθήματα.
lib - αυτός ο φάκελος είναι για εξωτερικές βιβλιοθήκες που θέλετε να καλέσετε από τον κώδικά σας. Δεν θα χρησιμοποιήσετε αυτόν τον φάκελο σε αυτά τα μαθήματα.
src - αυτός ο φάκελος περιέχει τον κύριο πηγαίο κώδικα της εφαρμογής σας. Αρχικά, θα περιέχει ένα μόνο αρχείο - main.cpp.
test - αυτός ο φάκελος είναι για τυχόν μονάδες δοκιμών για τον κώδικά σας.

Αρχεία

main.cpp - αυτό το αρχείο στον φάκελο src περιέχει το σημείο εισόδου για την εφαρμογή σας. Ανοίξτε αυτό το αρχείο και θα περιέχει τον ακόλουθο κώδικα:
```
#include <Arduino.h>

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

void loop() {
  // put your main code here, to run repeatedly:
}
```
Όταν η συσκευή ξεκινά, το πλαίσιο Arduino θα εκτελέσει τη συνάρτηση setup μία φορά και στη συνέχεια θα εκτελεί επανειλημμένα τη συνάρτηση loop μέχρι να απενεργοποιηθεί η συσκευή.
.gitignore - αυτό το αρχείο παραθέτει τα αρχεία και τους φακέλους που πρέπει να αγνοηθούν όταν προσθέτετε τον κώδικά σας στον έλεγχο πηγαίου κώδικα, όπως όταν τον ανεβάζετε σε ένα αποθετήριο στο GitHub.
platformio.ini - αυτό το αρχείο περιέχει τη ρύθμιση για τη συσκευή και την εφαρμογή σας. Ανοίξτε αυτό το αρχείο και θα περιέχει τον ακόλουθο κώδικα:
```
[env:seeed_wio_terminal]
platform = atmelsam
board = seeed_wio_terminal
framework = arduino
```
Η ενότητα [env:seeed_wio_terminal] έχει ρυθμίσεις για το Wio Terminal. Μπορείτε να έχετε πολλές ενότητες env ώστε ο κώδικάς σας να μπορεί να μεταγλωττιστεί για πολλές πλακέτες.

Οι υπόλοιπες τιμές αντιστοιχούν στη ρύθμιση από τον οδηγό έργου:
- platform = atmelsam ορίζει το υλικό που χρησιμοποιεί το Wio Terminal (ένας μικροελεγκτής βασισμένος στο ATSAMD51).
- board = seeed_wio_terminal ορίζει τον τύπο της πλακέτας μικροελεγκτή (το Wio Terminal).
- framework = arduino ορίζει ότι αυτό το έργο χρησιμοποιεί το πλαίσιο Arduino.

Γράψτε την εφαρμογή Hello World

Είστε πλέον έτοιμοι να γράψετε την εφαρμογή Hello World.

Εργασία - Γράψτε την εφαρμογή Hello World

Γράψτε την εφαρμογή Hello World.

Ανοίξτε το αρχείο main.cpp στο VS Code.
Αλλάξτε τον κώδικα ώστε να ταιριάζει με τον ακόλουθο:
```
#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 αρχικοποιεί μια σύνδεση με τη σειριακή θύρα - σε αυτή την περίπτωση, τη θύρα USB που χρησιμοποιείται για τη σύνδεση του Wio Terminal με τον υπολογιστή σας. Η παράμετρος 9600 είναι η ταχύτητα baud (γνωστή και ως ρυθμός συμβόλων), ή η ταχύτητα με την οποία τα δεδομένα θα αποστέλλονται μέσω της σειριακής θύρας σε bits ανά δευτερόλεπτο. Αυτή η ρύθμιση σημαίνει ότι 9.600 bits (0s και 1s) δεδομένων αποστέλλονται κάθε δευτερόλεπτο. Στη συνέχεια, περιμένει να είναι έτοιμη η σειριακή θύρα.

Η συνάρτηση loop στέλνει τη γραμμή Hello World! στη σειριακή θύρα, ώστε οι χαρακτήρες του Hello World! μαζί με έναν χαρακτήρα νέας γραμμής να αποστέλλονται. Στη συνέχεια, κοιμάται για 5.000 χιλιοστά του δευτερολέπτου ή 5 δευτερόλεπτα. Μετά το τέλος της loop, εκτελείται ξανά, και ξανά, και ούτω καθεξής όσο η μικροελεγκτής είναι ενεργοποιημένος.
Βάλτε το Wio Terminal σε λειτουργία μεταφόρτωσης. Θα χρειαστεί να το κάνετε αυτό κάθε φορά που ανεβάζετε νέο κώδικα στη συσκευή:
1. Τραβήξτε δύο φορές γρήγορα τον διακόπτη τροφοδοσίας προς τα κάτω - θα επιστρέψει στη θέση ενεργοποίησης κάθε φορά.
2. Ελέγξτε το μπλε LED κατάστασης στη δεξιά πλευρά της θύρας USB. Θα πρέπει να αναβοσβήνει.
Κάντε κλικ στην παραπάνω εικόνα για να δείτε ένα βίντεο που δείχνει πώς να το κάνετε αυτό.
Μεταγλωττίστε και ανεβάστε τον κώδικα στο Wio Terminal.
1. Ανοίξτε το command palette του VS Code.
2. Πληκτρολογήστε PlatformIO Upload για να αναζητήσετε την επιλογή μεταφόρτωσης και επιλέξτε PlatformIO: Upload.
  
  Το PlatformIO θα μεταγλωττίσει αυτόματα τον κώδικα αν χρειάζεται πριν τον ανεβάσει.
3. Ο κώδικας θα μεταγλωττιστεί και θα ανέβει στο Wio Terminal.
  
  💁 Αν χρησιμοποιείτε macOS, θα εμφανιστεί μια ειδοποίηση για DISK NOT EJECTED PROPERLY. Αυτό συμβαίνει επειδή το Wio Terminal προσαρτάται ως δίσκος κατά τη διαδικασία εγγραφής και αποσυνδέεται όταν ο μεταγλωττισμένος κώδικας γράφεται στη συσκευή. Μπορείτε να αγνοήσετε αυτή την ειδοποίηση.
⚠️ Αν λάβετε σφάλματα σχετικά με τη μη διαθεσιμότητα της θύρας μεταφόρτωσης, βεβαιωθείτε πρώτα ότι το Wio Terminal είναι συνδεδεμένο στον υπολογιστή σας, ενεργοποιημένο με τον διακόπτη στη δεξιά πλευρά της οθόνης και σε λειτουργία μεταφόρτωσης. Το πράσινο φως στο κάτω μέρος πρέπει να είναι αναμμένο και το μπλε φως να αναβοσβήνει. Αν εξακολουθείτε να λαμβάνετε το σφάλμα, τραβήξτε τον διακόπτη ενεργοποίησης/απενεργοποίησης δύο φορές γρήγορα ξανά για να αναγκάσετε το Wio Terminal να μπει σε λειτουργία μεταφόρτωσης και δοκιμάστε ξανά τη μεταφόρτωση.

Το PlatformIO διαθέτει ένα Serial Monitor που μπορεί να παρακολουθεί δεδομένα που αποστέλλονται μέσω του καλωδίου USB από το Wio Terminal. Αυτό σας επιτρέπει να παρακολουθείτε τα δεδομένα που αποστέλλονται από την εντολή Serial.println("Hello World");.

Ανοίξτε το command palette του VS Code.
Πληκτρολογήστε PlatformIO Serial για να αναζητήσετε την επιλογή Serial Monitor και επιλέξτε PlatformIO: Serial Monitor.

Ένα νέο τερματικό θα ανοίξει και τα δεδομένα που αποστέλλονται μέσω της σειριακής θύρας θα εμφανίζονται σε αυτό το τερματικό:
```
> 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 θα εκτυπώνεται στο Serial Monitor κάθε 5 δευτερόλεπτα.

💁 Μπορείτε να βρείτε αυτόν τον κώδικα στον φάκελο code/wio-terminal.

😀 Το πρόγραμμα 'Hello World' σας ήταν επιτυχές!

Αποποίηση ευθύνης:
Αυτό το έγγραφο έχει μεταφραστεί χρησιμοποιώντας την υπηρεσία αυτόματης μετάφρασης Co-op Translator. Παρόλο που καταβάλλουμε προσπάθειες για ακρίβεια, παρακαλούμε να έχετε υπόψη ότι οι αυτοματοποιημένες μεταφράσεις ενδέχεται να περιέχουν λάθη ή ανακρίβειες. Το πρωτότυπο έγγραφο στη μητρική του γλώσσα θα πρέπει να θεωρείται η αυθεντική πηγή. Για κρίσιμες πληροφορίες, συνιστάται επαγγελματική ανθρώπινη μετάφραση. Δεν φέρουμε ευθύνη για τυχόν παρεξηγήσεις ή εσφαλμένες ερμηνείες που προκύπτουν από τη χρήση αυτής της μετάφρασης.

20 KiB Raw Permalink Blame History Unescape Escape