教程:VENTUNO Q/初次设置

来自WindwizPi wiki
< 教程:VENTUNO Q
Windwiz​（留言 | 贡献）2026年9月28日 (一) 05:58的版本 （导入 VENTUNO Q 中文教程）
(差异) ←上一版本 | 最后版本 (差异) | 下一版本→ (差异)

概述

在本教程中，你将学习如何使用 Arduino App Lab 设置 Arduino® VENTUNO™ Q，并在开发板上运行你的第一个 App。完成后，你将看到 LED 闪烁，以此确认一切正常工作。

<img src="thumbnail.png" alt="VENTUNO Q" />

说明：

本教程侧重使用主机电脑设置 VENTUNO Q。若要将 VENTUNO Q 作为带显示器、鼠标和键盘的独立电脑使用，请参阅 单板电脑 教程。

硬件与软件要求

硬件要求

\*也可使用其他电源，电压范围为 7–24 V，电流 ≥ 3 A。更多信息请参阅 用户手册 - 电源部分。

注意：

Arduino USB-C Power Supply (65W) 附带一个可将 USB-C® 转换为 DC 圆口插头的小型适配器。如需通过圆口连接器为开发板供电，请使用该适配器。

软件要求

Arduino App Lab

<img src="banner.png" alt="Arduino App Lab" />

Arduino App Lab 是面向基于 Linux 的 Arduino 开发板的统一开发环境。通过创建并部署 Apps*，你可以在 Linux 处理器（Qualcomm® Dragonwing™ QCS8275）上运行 Python 脚本，并在 MCU（STM32H5F5）上运行 sketch。

  • Apps 在 Arduino App Lab 中创建，包含一个 sketch（MCU）和一个 Python 环境（Linux），并使用 Bricks 来运行从 Web 服务器到 AI 模型等各种功能。

步骤 1：为开发板供电

首次设置时，可通过 圆口（barrel jack） 或 螺丝端子 为开发板供电：

  • 使用圆口插头连接外部 +7–24 VDC（最大 5 A）电源。
  • 将外部 +7–24 VDC 电源（最大 10 A）连接到螺丝端子排。
  • 使用支持 USB-C® with Power Delivery 的外部电源（9–20 VDC，3 A）。

警告：

请注意，开发板不能直接通过电脑的 USB 端口供电。

<img src="ventuno-power-options.png" alt="VENTUNO Q 供电选项" />

步骤 2：设置 Arduino App Lab

要在电脑上设置 Arduino App Lab，请按以下步骤操作：

  1. 从 Arduino 下载页面 下载最新版本。
  2. 在你的操作系统上运行该应用程序。
  3. 通过 USB-C® 端口将开发板连接到电脑（请确保开发板已供电，参见上方的 电源部分）。
  4. VENTUNO Q 应会出现在 Arduino App Lab 中，你可以选择它。
    <img src="ventuno-detected.png" alt="Arduino App Lab - 已检测到开发板" />
  5. 首次启动时，系统会提示你设置 Board Name、Keyboard Language 和 Wi-Fi® 凭据。
  6. 完成设置后，你需要执行 board update（开发板更新）。这是获取最新更新所必需的。请注意，此过程可能需要数分钟。
  7. 更新完成后，即可在 Arduino App Lab 中运行示例。

<img src="ventuno-app-lab-examples.png" alt="Arduino App Lab 示例" />

网络模式

开发板配置完成后，即可在 Network Mode（网络模式）下使用：

  • 下次打开 Arduino App Lab 时，如果你的开发板已连接到本地网络，它将显示 网络图标而非 USB。
  • 从网络模式进入时，输入配置开发板时创建的密码。
  • 此时你已通过网络访问开发板，意味着电脑无需再与开发板保持物理连接。

<img src="ventuno-network-mode.png" alt="网络模式" />

通过这种方式，你可以从本地网络中的任意机器访问 VENTUNO Q，并以与通过 USB-C® 连接时相同的方式开发并运行 Apps。

步骤 3：在 VENTUNO Q 上运行 App

为了测试 VENTUNO Q，我们将运行经典的 Blink 示例。该示例用于验证开发板已正确连接到 Arduino App Lab 并正常工作。

  1. 确保你的开发板 供电正确。
  2. 打开 Arduino App Lab，并连接到你的开发板（通过 USB-C® 或网络模式）。
  3. 转到 Examples 选项卡，点击 Blink LED 示例。
    <img src="ventuno-select-blink.png" alt="Arduino App Lab 起始页" />
  4. 点击右上角的 Run 按钮，等待 App 上传完成。
    <img src="ventuno-launch-app.png" alt="运行与烧录" />

此时你应能看到板载 RGB LED 中的红色 LED 亮起一秒、熄灭一秒，如此反复。

<img src="ventuno-blink.gif" alt="红色 LED 闪烁" />

总结

你已成功使用 Arduino App Lab 设置 VENTUNO Q，并运行了第一个 App。接下来，你可以探索其他内置示例，使用 Bricks 构建自己的 Apps，或通过 SSH 或 ADB 连接开发板以进行更高级的控制。

延伸阅读

原文：https://docs.arduino.cc/tutorials/ventuno-q/first-setup/ 本页为 Arduino 官方教程的中文翻译，供内部查阅。命令与代码保持原文。

检索自“https://windwiz-pi.com/index.php?title=教程:VENTUNO_Q/初次设置&oldid=2015”