跳到主要内容

入门指南

系统准备与屏幕配置​

部分早期版本的 Arduino UNO Q 系统可能缺少屏幕所需的驱动及设备树文件，导致屏幕无法正常使用。请按照以下步骤检查系统并完成屏幕配置。

通过 Arduino App Lab 配置​

  1. 在电脑上打开 Arduino App Lab，详细操作请参考 App Lab 使用说明，使用 Type-C 线材将 UNO Q 连接至电脑。

  2. 按照提示完成初始设置及账号密码配置后，点击 Arduino App Lab 左下角的 设置（⚙） 图标，进入 Settings 页面，找到 Carriers 选项，开启 Enable external carriers。

    UNO Q 开启扩展板设置

    开启时可能出现以下提示：

    • Attach carrier board：请确认 UNO Q 已在断电状态下按照 硬件连接说明 正确安装屏幕扩展板，确认后点击 Ok, Got it 继续。

      UNO Q 开启扩展板设置

    • Update required：表示当前系统版本不支持 Media Carrier，点击 Update Board，按照界面提示完成系统更新。更新完成后重新进入 Settings → Carriers 启用扩展板功能。

      更新 UNO Q 系统

    如果未出现系统更新提示，可直接继续后续配置。

  3. 更新完成后，根据提示重启 UNO Q，重新进入 Settings → Carriers，确认 Enable external carriers 已启用。

  4. 在显示设备选项中选择 10-dsi-touch-a。如果未连接摄像头，将 CAMERA0 和 CAMERA1 均设置为 none。 选择 10.1 寸屏幕

  5. 点击 Apply and Reboot，等待 UNO Q 重启完成后，检查屏幕显示及触摸功能是否正常。

信息
  • 配置屏幕前，请确保 UNO Q 与屏幕已按照 硬件连接说明 正确连接。
  • 更新过程中请保持 UNO Q 供电及网络连接稳定，避免中途断电。
  • 如果无法通过 App Lab 完成系统更新，先备份主板上的应用及个人文件，再参考 Arduino 官方系统刷写指南。重新刷写会清除主板中保存的数据。

通过命令行配置（可选）​

也可以通过 SSH 或 ADB 进入 UNO Q 终端，使用命令行配置屏幕。

1. 查看支持的设备

sudo arduino-linux-config carrier list

确认设备列表中包含 media-carrier，且显示设备选项中包含 10-dsi-touch-a。

2. 启用屏幕

未连接摄像头时，执行：

sudo arduino-linux-config carrier enable media-carrier camera0=none camera1=none display=10-dsi-touch-a

如果 CAMERA0 接口连接了兼容的 IMX219 摄像头，可使用：

sudo arduino-linux-config carrier enable media-carrier camera0=type1-2lanes camera1=none display=10-dsi-touch-a

3. 检查配置

sudo arduino-linux-config carrier show media-carrier

确认下次启动的显示配置为 10-dsi-touch-a。

4. 重启设备

sudo reboot

等待 UNO Q 重启完成后，检查屏幕显示及触摸功能。

摄像头使用​

信息
  • 本产品仅支持 IMX219 摄像头。如无需使用摄像头，可跳过本节。
  • 当 CAMERA0 和 CAMERA1 均已启用，但仅连接一颗摄像头时，请将摄像头连接至 CAMERA0。

启用摄像头​

  1. 关闭 UNO Q 并断开电源，按 摄像头连接说明 将摄像头接到 CAMERA0，确认排线方向正确后再供电。

  2. 在 App Lab 的 "Settings" > "Carriers" 中，将 CAMERA0 设为 type1-2lanes，CAMERA1 设为 none，显示保持 10-dsi-touch-a，点击 "Apply and Reboot"。

    选择摄像头

提示

也可以在 UNO Q 终端执行以下命令完成配置。

使用一颗摄像头：

sudo arduino-linux-config carrier enable media-carrier camera0=type1-2lanes camera1=none display=10-dsi-touch-a
sudo reboot

使用两颗摄像头：

sudo arduino-linux-config carrier enable media-carrier camera0=type1-2lanes camera1=type1-2lanes display=10-dsi-touch-a
sudo reboot

安装并打开 Cheese​

需要桌面拍照或录像时，在 UNO Q 终端安装 Cheese：

sudo apt update
sudo apt install cheese -y

安装完成后，在设备桌面的 "Applications" > "Multimedia" > "Cheese" 打开应用。

从 UNO Q 桌面打开 Cheese

也可在已登录桌面的终端执行以下命令，无需 sudo：

cheese

设置分辨率并拍照、录像​

使用前退出其他占用摄像头的程序。需要测试两颗摄像头时，先按上方步骤启用 CAMERA0 和 CAMERA1。

  1. 打开 Cheese 右上角菜单，选择 "Preferences"（首选项），进入 "Webcam" 页。

    Cheese 首选项菜单入口

  2. 在 "Device" 中选择摄像头，将 "Photo resolution" 和 "Video resolution" 均设为 816 × 616。

    Cheese 摄像头及照片、录像分辨率设置

  3. 关闭首选项，等待几秒观察画面。若之前已采集失败，退出并重新打开 Cheese。

  4. 在 "Photo" 模式点击拍摄按钮，确认照片能打开。

  5. 切换到 "Video" 模式，点击录制，等待约 4 秒后点击停止，确认录像能播放。

  6. 已连接并启用两颗摄像头时，返回首选项，选择另一颗摄像头，重新检查两项分辨率并重复拍照、录像测试。

照片默认保存到 ~/Pictures/Webcam/，录像默认保存到 ~/Videos/Webcam/。系统图片或视频目录已改名，或另行设置了保存位置时，以本机实际目录为准。

音频使用​

图形界面配置​

底板提供 2 个 3.5 mm 音频接口，并内置两个扬声器，可用于音频输入和输出。

  1. 在设备桌面的 "Applications" > "Multimedia" 打开 "Volume Control"。

    音频设置

  2. 在 "Configuration" 中查看 "Profile" 配置；选择所需配置后，在 "Output Devices" 中检查实际输出，取消静音并先设置较低音量。

    音频设置

接口 / 模式类型功能
Line Out（线路输出）4Pin 喇叭接口线路电平音频输出，单声道
Headphones（耳机输出）3.5 mm 音频接口支持麦克风输入和耳机输出，双声道
Earphones（耳机输出）3.5 mm 音频接口耳机音频输出，单声道
Pro Audio（专业音频）音频配置模式支持专业音频应用及多通道音频输入输出
Off（关闭）音频配置模式禁用当前音频设备
  1. 播放音频文件，在 "Playback" 中确认该应用使用所需输出，再检查耳机是否有声音。 需要使用麦克风时，在 "Input Devices" 中选择对应输入，取消静音，检查电平是否随声音变化。

命令行切换音频输出​

以下命令仅切换输出末端的开关，适用于基础播放路由已配置完成、且声卡 0 存在对应控制项的系统。先用 aplay -l 和 amixer -c 0 controls 核对声卡及控制项；卡号不同时替换命令中的 0。若尚未配置播放路由，优先使用上面的图形界面，不能仅凭开关命令成功判断已经有声音。

切换至 Earphones（耳机输出）：

amixer -c 0 cset name='LO_RDAC Switch' off
amixer -c 0 cset name='EAR_RDAC Switch' on

切换至 Line Out（线路输出）：

amixer -c 0 cset name='EAR_RDAC Switch' off
amixer -c 0 cset name='LO_RDAC Switch' on

音频输入​

接口连接

进行麦克风录音测试时，请将麦克风连接至 MIC-IN/HPH 接口，切勿误接至 Earphones Out 接口，否则可能导致无法录音。

连接完成并在 "Volume Control" 中选择、启用对应输入后，可测试麦克风录音。以下步骤以录音路由已初始化为前提；仅调整录音增益不能启用 ADC 和录音通道。未初始化时，应先按当前镜像的音频配置完成路由。

1. 安装音频工具

打开终端，执行以下命令安装 ALSA 工具：

sudo apt update
sudo apt install alsa-utils -y

2. 查看音频设备

执行以下命令，查看系统识别到的录音及播放设备：

arecord -l
aplay -l

确认麦克风对应的声卡编号和设备编号。以下以声卡 0、录音设备 2 为例；实际编号不同时同步修改后续命令。

3. 设置麦克风录音增益

确认声卡 0 中存在该控制项且允许的数值范围包含 70 后，执行以下命令设置录音增益：

amixer -c 0 cset name='TX_DEC0 Volume' 70

4. 录制音频

当前账号主目录中已有 recording.wav 时，先改用其他文件名。执行以下命令录制 5 秒音频，并保存为 WAV 文件：

arecord -D plughw:0,2 -f S32_LE -c 1 -r 48000 -d 5 "$HOME/recording.wav"

5. 播放录音

录音完成后，执行以下命令播放录音文件：

aplay "$HOME/recording.wav"
提示

如果录音时提示 Device or resource busy，说明录音设备可能正在被其他音频服务或应用程序使用。请关闭正在使用麦克风的软件，或检查当前音频服务的设备占用情况。

RGB 状态灯使用​

本产品配备 4 组 RGB 状态指示灯，每组均可独立控制红、绿、蓝三个颜色通道，可用于设备状态指示及应用反馈。

控制 RGB LED​

在 UNO Q 终端执行以下命令，以第一组 RGB LED 为例：

点亮红色 LED：

echo none | sudo tee /sys/class/leds/media-carrier:red1/trigger
echo 1 | sudo tee /sys/class/leds/media-carrier:red1/brightness

点亮绿色 LED：

echo none | sudo tee /sys/class/leds/media-carrier:green1/trigger
echo 1 | sudo tee /sys/class/leds/media-carrier:green1/brightness

点亮蓝色 LED：

echo none | sudo tee /sys/class/leds/media-carrier:blue1/trigger
echo 1 | sudo tee /sys/class/leds/media-carrier:blue1/brightness

关闭第一组 RGB LED：

for color in red green blue; do
    echo 0 | sudo tee /sys/class/leds/media-carrier:${color}1/brightness
done
提示

将设备名称末尾的数字 1 替换为 2、3 或 4，即可控制其他组 RGB LED。不同颜色通道可以同时点亮，实现颜色混合。

关闭全部 RGB LED​

执行以下命令，关闭 4 组 RGB LED 的所有颜色通道：

sudo sh -c '
for n in 1 2 3 4; do
    for color in red green blue; do
        path="/sys/class/leds/media-carrier:${color}${n}"
        echo none > "$path/trigger"
        echo 0 > "$path/brightness"
    done
done
'