初学者的IoT开发课程

本文集文档发布于灏天文库

WioTerminal

文档摘要

Wio Terminal Wio Terminal是由Seeed Studios制造的Arduino兼容微控制器，集成了WiFi以及一些传感器和执行器，并且有端口可以添加更多的传感器和执行器，这些都基于一个名为Grove的硬件生态系统。 Seeed Studios的Wio Terminal 设置 要使用你的Wio Terminal，你需要在电脑上安装一些免费软件。你还需要更新Wio Terminal固件才能连接到WiFi。 任务 - 设置 安装所需软件并更新固件。 安装Visual Studio Code（简称VS Code）。这是你将用来编写设备代码（C/C++）的编辑器。参考VS Code文档以获取安装说明。 另一个流行的Arduino开发IDE是Arduino IDE。

Wio Terminal

Wio Terminal是由Seeed Studios制造的Arduino兼容微控制器，集成了WiFi以及一些传感器和执行器，并且有端口可以添加更多的传感器和执行器，这些都基于一个名为Grove的硬件生态系统。

Seeed Studios的Wio Terminal

设置

要使用你的Wio Terminal，你需要在电脑上安装一些免费软件。你还需要更新Wio Terminal固件才能连接到WiFi。

任务 - 设置

安装所需软件并更新固件。

  1. 安装Visual Studio Code（简称VS Code）。这是你将用来编写设备代码（C/C++）的编辑器。参考VS Code文档以获取安装说明。

    另一个流行的Arduino开发IDE是Arduino IDE。如果你已经熟悉这个工具，那么你可以用它代替VS Code和PlatformIO，但课程将基于使用VS Code提供指导。

  2. 安装VS Code的PlatformIO扩展。这是一个支持使用C/C++编程微控制器的VS Code扩展。参考PlatformIO扩展文档以获取在VS Code中安装此扩展的说明。该扩展依赖于Microsoft的C/C++扩展来处理C和C++代码，当你安装PlatformIO时，C/C++扩展会自动安装。

  3. 将你的Wio Terminal连接到电脑。Wio Terminal底部有一个USB-C接口，需要连接到电脑上的USB端口。Wio Terminal附带了一根USB-C到USB-A线缆，但如果电脑只有USB-C端口，则需要一根USB-C线缆或USB-A到USB-C适配器。

  4. 按照Wio Terminal Wiki WiFi概述文档中的说明设置Wio Terminal并更新固件。

Hello World

当开始学习一种新的编程语言或技术时，传统做法是创建一个“Hello World”应用程序——一个小应用输出像文本"Hello World"这样的内容，以显示所有工具配置正确。

Wio Terminal的Hello World应用将确保你已正确安装并配置了Visual Studio Code与PlatformIO，以进行微控制器开发。

创建PlatformIO项目

第一步是使用PlatformIO为Wio Terminal配置一个新的项目。

任务 - 创建PlatformIO项目

创建PlatformIO项目。

  1. 将Wio Terminal连接到电脑

  2. 启动VS Code

  3. PlatformIO图标将在侧边菜单栏中：

    Platform IO菜单选项

    选择此菜单项，然后选择PIO Home -> Open

    Platform IO打开选项

  4. 从欢迎屏幕中，选择**+ 新建项目**按钮

    新建项目按钮

  5. 在项目向导中配置项目：

    1. 将项目命名为nightlight

    2. 在板子下拉列表中，输入WIO以筛选板子，并选择Seeeduino Wio Terminal

    3. 保持框架为Arduino

    4. 要么保持使用默认位置复选框被勾选，要么取消勾选并选择项目的位置

    5. 选择完成按钮

    完成的项目向导

    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 function once, then run the loop function repeatedly until the device is turned off.

  • .gitignore - this file lists the files and directories to be ignored when adding your code to git source code control, such as uploading to a repository on GitHub.

  • platformio.ini - 这个文件包含你的设备和应用的配置。打开此文件，它将包含以下代码：

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

    [env:seeed_wio_terminal] section has configuration for the Wio Terminal. You can have multiple env sections so your code can be compiled for multiple boards.

    The other values match the configuration from the project wizard:

    • platform = atmelsam defines the hardware that the Wio Terminal uses (an ATSAMD51-based microcontroller)
    • board = seeed_wio_terminal defines the type of microcontroller board (the Wio Terminal)
    • framework = arduino定义了该项目正在使用Arduino框架。

编写Hello World应用

现在你准备好编写Hello World应用了。

任务 - 编写Hello World应用

编写Hello World应用。

  1. 在VS Code中打开main.cpp文件

  2. 将代码更改为以下内容：

    #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 function initializes a connection to the serial port - in this case, the USB port that is used to connect the Wio Terminal to your computer. The parameter 9600 is the baud rate (also known as Symbol rate), or speed that data will be sent over the serial port in bits per second. This setting means 9,600 bits (0s and 1s) of data are sent each second. It then waits for the serial port to be ready.

    The loop function sends the line Hello World! to the serial port, so the characters of Hello World! along with a new line character. It then sleeps for 5,000 milliseconds or 5 seconds. After the loop ends, it is run again, and again, and so on all the time the microcontroller is powered on.

  3. Put your Wio Terminal into upload mode. You will need to do this every time you upload new code to the device:

    1. Pull down twice quickly on the power switch - it will spring back to the on position each time.

    2. Check the blue status LED to the right hand side of the USB port. It should be pulsing.

    Click the image above for a video showing how to do this.

  4. Build and upload the code to the Wio Terminal

    1. Open the VS Code command palette

    2. Type PlatformIO Upload to search for the upload option, and select PlatformIO: Upload

      The PlatformIO upload option in the command palette

      PlatformIO will automatically build the code if needed before uploading.

    3. The code will be compiled and uploaded to the Wio Terminal

      If you are using macOS, a notification about a DISK NOT EJECTED PROPERLY will appear. This is because the Wio Terminal gets mounted as a drive as part of the flashing process, and it is disconnected when the compiled code is written to the device. You can ignore this notification.

    ⚠️ If you get errors about the upload port being unavailable, first make sure you have the Wio Terminal connected to your computer, and switched on using the switch on the left hand side of the screen, and set into upload mode. The green light on the bottom should be on, and the blue light should be pulsing. If you still get the error, pull the on/off switch down twice in quick succession again to force the Wio Terminal into upload mode and try the upload again.

PlatformIO has a Serial Monitor that can monitor data sent over the USB cable from the Wio Terminal. This allows you to monitor the data sent by the Serial.println("Hello World"); command.

  1. Open the VS Code command palette

  2. Type PlatformIO Serial找到Serial监视器选项，然后选择PlatformIO: Serial Monitor

    命令行中的PlatformIO串行监视器选项

    新的终端将打开，并通过串行端口发送的数据将流式传输到此终端：

    > 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每5秒打印到串行监视器。

你可以在code/wio-terminal文件夹中找到此代码。

你的“Hello World”程序成功了！

声明:
本文件灏天文库团队进行了翻译。尽管我们力求准确，但请注意，翻译可能包含错误或不准确之处。原文档以其原始语言为准。我们不对因使用此翻译而产生的任何误解或误译负责。

发布者: 作者: 转发
评论区 (0)
U
0/500