12 KiB

Raw Permalink Blame History

Wio Terminal

Wio Terminal dari Seeed Studios adalah mikrokontroler yang serasi dengan Arduino, dilengkapi dengan WiFi serta beberapa sensor dan aktuator terbina, serta port untuk menambah lebih banyak sensor dan aktuator menggunakan ekosistem perkakasan yang dipanggil Grove.

Persediaan

Untuk menggunakan Wio Terminal anda, anda perlu memasang beberapa perisian percuma pada komputer anda. Anda juga perlu mengemas kini firmware Wio Terminal sebelum dapat menyambungkannya ke WiFi.

Tugasan - persediaan

Pasang perisian yang diperlukan dan kemas kini firmware.

Pasang Visual Studio Code (VS Code). Ini adalah editor yang akan anda gunakan untuk menulis kod peranti anda dalam C/C++. Rujuk dokumentasi VS Code untuk arahan memasang VS Code.

💁 IDE popular lain untuk pembangunan Arduino ialah Arduino IDE. Jika anda sudah biasa dengan alat ini, anda boleh menggunakannya sebagai ganti VS Code dan PlatformIO, tetapi pelajaran ini akan memberikan arahan berdasarkan penggunaan VS Code.
Pasang sambungan PlatformIO untuk VS Code. Ini adalah sambungan untuk VS Code yang menyokong pengaturcaraan mikrokontroler dalam C/C++. Rujuk dokumentasi sambungan PlatformIO untuk arahan memasang sambungan ini dalam VS Code. Sambungan ini bergantung pada sambungan Microsoft C/C++ untuk bekerja dengan kod C dan C++, dan sambungan C/C++ akan dipasang secara automatik apabila anda memasang PlatformIO.
Sambungkan Wio Terminal anda ke komputer. Wio Terminal mempunyai port USB-C di bahagian bawah, dan ini perlu disambungkan ke port USB pada komputer anda. Wio Terminal disertakan dengan kabel USB-C ke USB-A, tetapi jika komputer anda hanya mempunyai port USB-C, anda perlu menggunakan kabel USB-C atau penyesuai USB-A ke USB-C.
Ikuti arahan dalam dokumentasi Wio Terminal Wiki WiFi Overview untuk menyediakan Wio Terminal anda dan mengemas kini firmware.

Hello World

Adalah tradisi apabila memulakan dengan bahasa pengaturcaraan atau teknologi baru untuk mencipta aplikasi 'Hello World' - aplikasi kecil yang mengeluarkan sesuatu seperti teks "Hello World" untuk menunjukkan bahawa semua alat telah dikonfigurasi dengan betul.

Aplikasi Hello World untuk Wio Terminal akan memastikan bahawa anda telah memasang Visual Studio Code dengan betul bersama PlatformIO dan disediakan untuk pembangunan mikrokontroler.

Cipta projek PlatformIO

Langkah pertama adalah mencipta projek baru menggunakan PlatformIO yang dikonfigurasi untuk Wio Terminal.

Tugasan - cipta projek PlatformIO

Cipta projek PlatformIO.

Sambungkan Wio Terminal ke komputer anda
Lancarkan VS Code
Ikon PlatformIO akan berada di bar menu sisi:

Pilih item menu ini, kemudian pilih PIO Home -> Open
Dari skrin selamat datang, pilih butang + New Project
Konfigurasikan projek dalam Project Wizard:
1. Namakan projek anda nightlight
2. Dari dropdown Board, taipkan WIO untuk menapis papan, dan pilih Seeeduino Wio Terminal
3. Biarkan Framework sebagai Arduino
4. Sama ada biarkan kotak semak Use default location ditandai, atau nyah tanda dan pilih lokasi untuk projek anda
5. Pilih butang Finish
PlatformIO akan memuat turun komponen yang diperlukan untuk menyusun kod untuk Wio Terminal dan mencipta projek anda. Ini mungkin mengambil masa beberapa minit.

Selidiki projek PlatformIO

Penjelajah VS Code akan menunjukkan beberapa fail dan folder yang dicipta oleh wizard PlatformIO.

Folder

.pio - folder ini mengandungi data sementara yang diperlukan oleh PlatformIO seperti perpustakaan atau kod yang disusun. Ia akan dicipta semula secara automatik jika dipadamkan, dan anda tidak perlu menambah ini ke kawalan kod sumber jika anda berkongsi projek anda di laman seperti GitHub.
.vscode - folder ini mengandungi konfigurasi yang digunakan oleh PlatformIO dan VS Code. Ia akan dicipta semula secara automatik jika dipadamkan, dan anda tidak perlu menambah ini ke kawalan kod sumber jika anda berkongsi projek anda di laman seperti GitHub.
include - folder ini adalah untuk fail header luaran yang diperlukan apabila menambah perpustakaan tambahan ke kod anda. Anda tidak akan menggunakan folder ini dalam mana-mana pelajaran ini.
lib - folder ini adalah untuk perpustakaan luaran yang ingin anda panggil dari kod anda. Anda tidak akan menggunakan folder ini dalam mana-mana pelajaran ini.
src - folder ini mengandungi kod sumber utama untuk aplikasi anda. Pada mulanya, ia akan mengandungi satu fail - main.cpp.
test - folder ini adalah tempat anda meletakkan sebarang ujian unit untuk kod anda.

Fail

main.cpp - fail ini dalam folder src mengandungi titik masuk untuk aplikasi anda. Buka fail ini, dan ia akan mengandungi kod berikut:
```
#include <Arduino.h>

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

void loop() {
  // put your main code here, to run repeatedly:
}
```
Apabila peranti dimulakan, kerangka Arduino akan menjalankan fungsi setup sekali, kemudian menjalankan fungsi loop berulang kali sehingga peranti dimatikan.
.gitignore - fail ini menyenaraikan fail dan direktori yang akan diabaikan apabila menambah kod anda ke kawalan kod git, seperti memuat naik ke repositori di GitHub.
platformio.ini - fail ini mengandungi konfigurasi untuk peranti dan aplikasi anda. Buka fail ini, dan ia akan mengandungi kod berikut:
```
[env:seeed_wio_terminal]
platform = atmelsam
board = seeed_wio_terminal
framework = arduino
```
Bahagian [env:seeed_wio_terminal] mempunyai konfigurasi untuk Wio Terminal. Anda boleh mempunyai beberapa bahagian env supaya kod anda boleh disusun untuk beberapa papan.

Nilai lain sepadan dengan konfigurasi dari wizard projek:
- platform = atmelsam mentakrifkan perkakasan yang digunakan oleh Wio Terminal (mikrokontroler berasaskan ATSAMD51)
- board = seeed_wio_terminal mentakrifkan jenis papan mikrokontroler (Wio Terminal)
- framework = arduino mentakrifkan bahawa projek ini menggunakan kerangka Arduino.

Tulis aplikasi Hello World

Anda kini bersedia untuk menulis aplikasi Hello World.

Tugasan - tulis aplikasi Hello World

Tulis aplikasi Hello World.

Buka fail main.cpp dalam VS Code
Tukar kod untuk sepadan dengan berikut:
```
#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);
}
```
Fungsi setup memulakan sambungan ke port serial - dalam kes ini, port USB yang digunakan untuk menyambungkan Wio Terminal ke komputer anda. Parameter 9600 adalah baud rate (juga dikenali sebagai kadar simbol), atau kelajuan data akan dihantar melalui port serial dalam bit sesaat. Tetapan ini bermaksud 9,600 bit (0s dan 1s) data dihantar setiap saat. Ia kemudian menunggu port serial untuk bersedia.

Fungsi loop menghantar baris Hello World! ke port serial, jadi aksara Hello World! bersama dengan aksara baris baru. Ia kemudian tidur selama 5,000 milisaat atau 5 saat. Selepas loop berakhir, ia dijalankan semula, dan lagi, dan seterusnya sepanjang masa mikrokontroler dihidupkan.
Letakkan Wio Terminal anda dalam mod muat naik. Anda perlu melakukan ini setiap kali anda memuat naik kod baru ke peranti:
1. Tarik turun dua kali dengan cepat pada suis kuasa - ia akan kembali ke posisi hidup setiap kali.
2. Periksa LED status biru di sebelah kanan port USB. Ia sepatutnya berdenyut.
Klik imej di atas untuk video menunjukkan cara melakukannya.
Bina dan muat naik kod ke Wio Terminal
1. Buka palet arahan VS Code
2. Taip PlatformIO Upload untuk mencari pilihan muat naik, dan pilih PlatformIO: Upload
  
  PlatformIO akan secara automatik membina kod jika diperlukan sebelum memuat naik.
3. Kod akan disusun dan dimuat naik ke Wio Terminal
  
  💁 Jika anda menggunakan macOS, pemberitahuan tentang DISK NOT EJECTED PROPERLY akan muncul. Ini kerana Wio Terminal dipasang sebagai pemacu sebagai sebahagian daripada proses flashing, dan ia diputuskan apabila kod yang disusun ditulis ke peranti. Anda boleh mengabaikan pemberitahuan ini.
⚠️ Jika anda mendapat ralat tentang port muat naik tidak tersedia, pertama pastikan anda telah menyambungkan Wio Terminal ke komputer anda, dan dihidupkan menggunakan suis di sebelah kiri skrin, dan diletakkan dalam mod muat naik. Lampu hijau di bahagian bawah sepatutnya menyala, dan lampu biru sepatutnya berdenyut. Jika anda masih mendapat ralat, tarik suis hidup/mati ke bawah dua kali dengan cepat lagi untuk memaksa Wio Terminal ke mod muat naik dan cuba muat naik semula.

PlatformIO mempunyai Serial Monitor yang boleh memantau data yang dihantar melalui kabel USB dari Wio Terminal. Ini membolehkan anda memantau data yang dihantar oleh arahan Serial.println("Hello World");.

Buka palet arahan VS Code

Taip PlatformIO Serial untuk mencari pilihan Serial Monitor, dan pilih PlatformIO: Serial Monitor

Terminal baru akan dibuka, dan data yang dihantar melalui port serial akan disiarkan ke terminal ini:

> 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 akan dicetak ke serial monitor setiap 5 saat.

💁 Anda boleh menemui kod ini dalam folder code/wio-terminal.

😀 Program 'Hello World' anda berjaya!

Penafian:
Dokumen ini telah diterjemahkan menggunakan perkhidmatan terjemahan AI Co-op Translator. Walaupun kami berusaha untuk memastikan ketepatan, sila ambil maklum bahawa terjemahan automatik mungkin mengandungi kesilapan atau ketidaktepatan. Dokumen asal dalam bahasa asalnya harus dianggap sebagai sumber yang berwibawa. Untuk maklumat penting, terjemahan manusia profesional adalah disyorkan. Kami tidak bertanggungjawab atas sebarang salah faham atau salah tafsir yang timbul daripada penggunaan terjemahan ini.

12 KiB Raw Permalink Blame History