产品 FAQ

问：为什么我的开发板只连接电脑 USB 接口后没有正常启动？

答：VENTUNO Q 的 USB-C 供电需要通过 USB PD 协商获得至少 9 V，仅提供 5 V 的电脑 USB 接口无法为开发板供电。使用电脑 USB-C 连接模式时，先通过 DC 圆孔接口或接线端子供电，再连接数据线。具体规格见供电方式。

答：App Lab 网络模式依靠 mDNS（Multicast DNS，多播 DNS）发现设备。SSH 可以访问某个 IP 地址，并不代表本地网络允许 mDNS 发现。

先确认电脑与开发板位于同一本地网络。访客 Wi-Fi、网络隔离、VPN 和防火墙可能影响发现。Windows 首次运行时，如出现针对 mdns-discovery.exe 的访问提示，允许其在所用本地网络中通信；防火墙需允许 mDNS 使用的 UDP 5353 端口。

答：先确认开发板已供电，并在 App Lab 中选择了已连接的 VENTUNO Q。使用 USB-C 连接时，检查线缆是否支持数据传输，然后切换页面并重新打开 "Examples"。

如果仍显示 "No examples found"，请保留 App Lab 的提示信息，并检查开发板的连接状态。

答：如果出现 Unknown FQBN: board arduino:zephyr:ventunoq not found，先在开发板终端中检查已安装的核心版本和开发板定义：

arduino-cli core list
arduino-cli board listall ventuno

Arduino Zephyr core 的正式发布版从 1.0.0 起包含 VENTUNO Q 定义，部分预发布版本也包含该定义。如果列表没有 arduino:zephyr:ventunoq，且 arduino:zephyr 未安装或正式发布版低于 1.0.0，可在开发板终端执行：

arduino-cli core update-index
arduino-cli core install arduino:zephyr@1.0.0

安装完成后，再次运行 arduino-cli board listall ventuno，确认列表包含 arduino:zephyr:ventunoq，然后在 App Lab 中重新运行示例。安装时开发板需要联网；如果下载超时，先检查网络连接。

如果列表已包含 VENTUNO Q 定义，但仍有同样的报错，请保留上述两条检查命令的输出和 App Lab 的完整报错，以便进一步排查。

答：首次运行示例时，App Lab 可能需要下载 Python 运行环境。如果 "App launch" 中出现 ghcr.io 下载超时、TLS handshake timeout 或连接中断，先检查开发板的网络连接，再重新运行示例。若仍无法下载，可更换网络后重试。

下载期间保持开发板供电和联网。即使 LED 已闪烁或点阵已有显示，也应等待启动过程结束，并检查 "App launch" 中是否还有错误。若问题仍然存在，请保留完整启动日志以便进一步排查。

答：内置示例不能直接编辑或设置为开机运行。先使用 "Copy and edit App" 创建副本，再修改代码或启用 "Run at startup"。操作见 App Lab 使用说明。

答：40-pin 排针由 MPU 管理，提供经过电平转换的 3.3 V 信号；UNO 排针由 STM32 MCU 管理，使用 Arduino 引脚名称编程，例如 D0、D1 和 A0。

Bluetooth 启用时，40-pin 排针中的物理引脚 8、10、11 和 36 被板载无线模块的 UART 占用，不能同时供外部 HAT 使用。接口说明见硬件接口。

答：UNO 排针上的 I2C 使用 Wire，Qwiic 接口使用 Wire1，两者不是同一连接入口。先确认传感器连接位置、3.3 V 供电和地址，再选择相应对象。连接方式见 I2C 与 Qwiic。

答：板载四组 RGB LED 为低电平点亮：LOW 点亮对应颜色，HIGH 熄灭。外接 LED 的点亮电平取决于实际接线。示例见 RGB LED。

答：在 SSH / ADB 模式下，长按电源按钮 10 秒以上会关闭开发板，之后需要断开并重新连接电源才能启动。接入电源后开发板会自动启动，无需按电源按钮。