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/vi/1-getting-started/lessons/1-introduction-to-iot/wio-terminal.md

14 KiB

Wio Terminal

Wio Terminal từ Seeed Studios là một vi điều khiển tương thích với Arduino, được tích hợp WiFi cùng một số cảm biến và bộ truyền động, cũng như các cổng để thêm cảm biến và bộ truyền động khác, sử dụng hệ sinh thái phần cứng gọi là Grove.

Hình ảnh Wio Terminal từ Seeed Studios

Cài đặt

Để sử dụng Wio Terminal, bạn cần cài đặt một số phần mềm miễn phí trên máy tính của mình. Bạn cũng cần cập nhật firmware của Wio Terminal trước khi có thể kết nối nó với WiFi.

Nhiệm vụ - cài đặt

Cài đặt phần mềm cần thiết và cập nhật firmware.

  1. Cài đặt Visual Studio Code (VS Code). Đây là trình soạn thảo bạn sẽ sử dụng để viết mã cho thiết bị của mình bằng C/C++. Tham khảo tài liệu VS Code để biết hướng dẫn cài đặt VS Code.

    💁 Một IDE phổ biến khác để phát triển Arduino là Arduino IDE. Nếu bạn đã quen thuộc với công cụ này, bạn có thể sử dụng nó thay vì VS Code và PlatformIO, nhưng các bài học sẽ hướng dẫn dựa trên việc sử dụng VS Code.

  2. Cài đặt tiện ích mở rộng PlatformIO cho VS Code. Đây là một tiện ích mở rộng hỗ trợ lập trình vi điều khiển bằng C/C++. Tham khảo tài liệu về tiện ích mở rộng PlatformIO để biết hướng dẫn cài đặt tiện ích này trong VS Code. Tiện ích này phụ thuộc vào tiện ích mở rộng Microsoft C/C++ để làm việc với mã C và C++, và tiện ích C/C++ sẽ được cài đặt tự động khi bạn cài đặt PlatformIO.

  3. Kết nối Wio Terminal với máy tính của bạn. Wio Terminal có một cổng USB-C ở phía dưới, và cổng này cần được kết nối với một cổng USB trên máy tính của bạn. Wio Terminal đi kèm với một cáp USB-C sang USB-A, nhưng nếu máy tính của bạn chỉ có cổng USB-C, bạn sẽ cần một cáp USB-C hoặc một bộ chuyển đổi USB-A sang USB-C.

  4. Làm theo hướng dẫn trong tài liệu Wiki WiFi Overview của Wio Terminal để thiết lập Wio Terminal và cập nhật firmware.

Hello World

Khi bắt đầu với một ngôn ngữ lập trình hoặc công nghệ mới, thông thường bạn sẽ tạo một ứng dụng 'Hello World' - một ứng dụng nhỏ hiển thị văn bản như "Hello World" để kiểm tra xem tất cả các công cụ đã được cấu hình đúng hay chưa.

Ứng dụng Hello World cho Wio Terminal sẽ đảm bảo rằng bạn đã cài đặt Visual Studio Code đúng cách với PlatformIO và thiết lập để phát triển vi điều khiển.

Tạo dự án PlatformIO

Bước đầu tiên là tạo một dự án mới sử dụng PlatformIO được cấu hình cho Wio Terminal.

Nhiệm vụ - tạo dự án PlatformIO

Tạo dự án PlatformIO.

  1. Kết nối Wio Terminal với máy tính của bạn.

  2. Mở VS Code.

  3. Biểu tượng PlatformIO sẽ xuất hiện trên thanh menu bên cạnh:

    Tùy chọn menu PlatformIO

    Chọn mục menu này, sau đó chọn PIO Home -> Open.

    Tùy chọn mở PlatformIO

  4. Từ màn hình chào mừng, chọn nút + New Project.

    Nút tạo dự án mới

  5. Cấu hình dự án trong Project Wizard:

    1. Đặt tên dự án của bạn là nightlight.

    2. Từ menu thả xuống Board, nhập WIO để lọc các bảng, và chọn Seeeduino Wio Terminal.

    3. Giữ nguyên FrameworkArduino.

    4. Hoặc giữ nguyên hộp kiểm Use default location được chọn, hoặc bỏ chọn và chọn một vị trí cho dự án của bạn.

    5. Chọn nút Finish.

    Trình hướng dẫn dự án đã hoàn tất

    PlatformIO sẽ tải xuống các thành phần cần thiết để biên dịch mã cho Wio Terminal và tạo dự án của bạn. Quá trình này có thể mất vài phút.

Khám phá dự án PlatformIO

Trình khám phá của VS Code sẽ hiển thị một số tệp và thư mục được tạo bởi trình hướng dẫn PlatformIO.

Thư mục

  • .pio - thư mục này chứa dữ liệu tạm thời cần thiết bởi PlatformIO như thư viện hoặc mã đã biên dịch. Nó sẽ được tạo lại tự động nếu bị xóa, và bạn không cần thêm thư mục này vào kiểm soát mã nguồn nếu bạn chia sẻ dự án của mình trên các trang như GitHub.
  • .vscode - thư mục này chứa cấu hình được sử dụng bởi PlatformIO và VS Code. Nó sẽ được tạo lại tự động nếu bị xóa, và bạn không cần thêm thư mục này vào kiểm soát mã nguồn nếu bạn chia sẻ dự án của mình trên các trang như GitHub.
  • include - thư mục này dành cho các tệp tiêu đề bên ngoài cần thiết khi thêm thư viện bổ sung vào mã của bạn. Bạn sẽ không sử dụng thư mục này trong bất kỳ bài học nào.
  • lib - thư mục này dành cho các thư viện bên ngoài mà bạn muốn gọi từ mã của mình. Bạn sẽ không sử dụng thư mục này trong bất kỳ bài học nào.
  • src - thư mục này chứa mã nguồn chính cho ứng dụng của bạn. Ban đầu, nó sẽ chứa một tệp duy nhất - main.cpp.
  • test - thư mục này là nơi bạn sẽ đặt bất kỳ bài kiểm tra đơn vị nào cho mã của mình.

Tệp

  • main.cpp - tệp này trong thư mục src chứa điểm bắt đầu cho ứng dụng của bạn. Mở tệp này, và nó sẽ chứa mã sau:

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

    Khi thiết bị khởi động, framework Arduino sẽ chạy hàm setup một lần, sau đó chạy hàm loop lặp đi lặp lại cho đến khi thiết bị bị tắt.

  • .gitignore - tệp này liệt kê các tệp và thư mục cần bỏ qua khi thêm mã của bạn vào kiểm soát mã nguồn git, chẳng hạn như khi tải lên một kho lưu trữ trên GitHub.

  • platformio.ini - tệp này chứa cấu hình cho thiết bị và ứng dụng của bạn. Mở tệp này, và nó sẽ chứa mã sau:

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

    Phần [env:seeed_wio_terminal] có cấu hình cho Wio Terminal. Bạn có thể có nhiều phần env để mã của bạn có thể được biên dịch cho nhiều bảng khác nhau.

    Các giá trị khác khớp với cấu hình từ trình hướng dẫn dự án:

    • platform = atmelsam định nghĩa phần cứng mà Wio Terminal sử dụng (vi điều khiển dựa trên ATSAMD51).
    • board = seeed_wio_terminal định nghĩa loại bảng vi điều khiển (Wio Terminal).
    • framework = arduino định nghĩa rằng dự án này sử dụng framework Arduino.

Viết ứng dụng Hello World

Bây giờ bạn đã sẵn sàng viết ứng dụng Hello World.

Nhiệm vụ - viết ứng dụng Hello World

Viết ứng dụng Hello World.

  1. Mở tệp main.cpp trong VS Code.

  2. Thay đổi mã để khớp với mã sau:

    #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);
    }
    

    Hàm setup khởi tạo kết nối với cổng nối tiếp - trong trường hợp này là cổng USB được sử dụng để kết nối Wio Terminal với máy tính của bạn. Tham số 9600tốc độ baud (còn được gọi là tốc độ ký hiệu), hoặc tốc độ mà dữ liệu sẽ được gửi qua cổng nối tiếp tính bằng bit mỗi giây. Cài đặt này có nghĩa là 9.600 bit (0 và 1) dữ liệu được gửi mỗi giây. Sau đó, nó chờ cổng nối tiếp sẵn sàng.

    Hàm loop gửi dòng Hello World! đến cổng nối tiếp, cùng với một ký tự dòng mới. Sau đó, nó ngủ trong 5.000 mili giây hoặc 5 giây. Sau khi hàm loop kết thúc, nó sẽ được chạy lại, và cứ thế tiếp tục trong suốt thời gian vi điều khiển được bật.

  3. Đưa Wio Terminal của bạn vào chế độ tải lên. Bạn sẽ cần làm điều này mỗi khi tải mã mới lên thiết bị:

    1. Kéo xuống hai lần nhanh chóng trên công tắc nguồn - nó sẽ bật lại vị trí bật mỗi lần.

    2. Kiểm tra đèn LED trạng thái màu xanh lam ở bên phải cổng USB. Nó nên nhấp nháy.

    Video hướng dẫn cách đưa Wio Terminal vào chế độ tải lên

    Nhấp vào hình ảnh trên để xem video hướng dẫn cách thực hiện.

  4. Biên dịch và tải mã lên Wio Terminal.

    1. Mở bảng lệnh của VS Code.

    2. Nhập PlatformIO Upload để tìm tùy chọn tải lên, và chọn PlatformIO: Upload.

      Tùy chọn tải lên PlatformIO trong bảng lệnh

      PlatformIO sẽ tự động biên dịch mã nếu cần trước khi tải lên.

    3. Mã sẽ được biên dịch và tải lên Wio Terminal.

      💁 Nếu bạn đang sử dụng macOS, một thông báo về DISK NOT EJECTED PROPERLY sẽ xuất hiện. Điều này xảy ra vì Wio Terminal được gắn như một ổ đĩa trong quá trình nạp mã, và nó bị ngắt kết nối khi mã đã biên dịch được ghi vào thiết bị. Bạn có thể bỏ qua thông báo này.

    ⚠️ Nếu bạn gặp lỗi về cổng tải lên không khả dụng, trước tiên hãy đảm bảo rằng bạn đã kết nối Wio Terminal với máy tính, bật nó bằng công tắc ở bên trái màn hình, và đặt vào chế độ tải lên. Đèn xanh ở phía dưới nên sáng, và đèn xanh lam nên nhấp nháy. Nếu vẫn gặp lỗi, kéo công tắc bật/tắt xuống hai lần nhanh chóng để buộc Wio Terminal vào chế độ tải lên và thử tải lại.

PlatformIO có một Serial Monitor cho phép theo dõi dữ liệu được gửi qua cáp USB từ Wio Terminal. Điều này cho phép bạn theo dõi dữ liệu được gửi bởi lệnh Serial.println("Hello World");.

  1. Mở bảng lệnh của VS Code.

  2. Nhập PlatformIO Serial để tìm tùy chọn Serial Monitor, và chọn PlatformIO: Serial Monitor.

    Tùy chọn Serial Monitor của PlatformIO trong bảng lệnh

    Một terminal mới sẽ mở ra, và dữ liệu được gửi qua cổng nối tiếp sẽ được hiển thị trong terminal này:

    > 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 sẽ được in ra Serial Monitor mỗi 5 giây.

💁 Bạn có thể tìm thấy mã này trong thư mục code/wio-terminal.

😀 Chương trình 'Hello World' của bạn đã thành công!


Tuyên bố miễn trừ trách nhiệm:
Tài liệu này đã được dịch bằng dịch vụ dịch thuật AI Co-op Translator. Mặc dù chúng tôi cố gắng đảm bảo độ chính xác, xin lưu ý rằng các bản dịch tự động có thể chứa lỗi hoặc không chính xác. Tài liệu gốc bằng ngôn ngữ bản địa nên được coi là nguồn thông tin chính thức. Đối với các thông tin quan trọng, khuyến nghị sử dụng dịch vụ dịch thuật chuyên nghiệp bởi con người. Chúng tôi không chịu trách nhiệm cho bất kỳ sự hiểu lầm hoặc diễn giải sai nào phát sinh từ việc sử dụng bản dịch này.