模板: RDK X3 MD User Guide

来自Waveshare Wiki
跳转至: 导航搜索

硬件准备

底板

RDK X3 MD是核心模组,用户在使用中需要配合底板,由于RDK X3 MD在 硬件设计上兼容树莓派CM4, 这里可以直接使用CM4底板。

供电

底板通过USB Type C接口供电,需要使用支持5V 3A的电源适配器为开发板供电。
注意,请不要使用电脑USB接口为开发板供电,否则会因供电不足造成开发板异常断电、反复重启等异常情况。

显示

RDK X3开发板支持HDMI显示接口,通过HDMI线缆连接开发板和显示器,支持图形化桌面显示。

在进入系统配置后,可以切换为DSI接口显示, 有需要的用户也可以选择DSI触摸屏

安装系统

镜像下载

下载Ubuntu镜像压缩包,解压出Ubuntu系统镜像文件.

注意: RDK X3 Module模组需要使用2.0或以上版本新镜像.
RDK-X3-MD-Images.png

烧录系统到eMMC

下载烧录工具

RDK X3模组支持eMMC存储方式,当烧录系统到eMMC时,需要使用地平线hbupdate烧录工具,请按照以下步骤进行工具的下载和安装:

  1. 下载hbupdate烧录工具,下载链接:hbupdate
  2. 工具分为Windows、Linux两种版本,分别命名为 hbupdate_win64_vx.x.x_rdk.tar.gz、 `hbupdate_linux_gui_vx.x.x_rdk.tar.gz。
  3. 解压烧录工具,解压目录需要不包含空格、中文、特殊字符。
安装USB驱动

驱动安装只有第一次使用的时候才需要用到。

  1. 下载驱动andriod_hobot
  2. 解压 android_hobot.zip ,进入解压后的目录,以管理员身份运行 5-runasadmin_register-CA-cer.cmd 完成驱动程序的注册。
  3. 设置开发板的BootPin为ON模式,将开发板与PC通过USB线连接,然后给开发板上电。
  4. 如PC设备管理器出现USB download gadget未知设备时,需要更新设备驱动,选择解压出的驱动文件夹andriod_hobot,然后点击下一步,完成驱动安装,如下图
    RDK-XD-MD-Driver.png
  5. 驱动安装完成后,设备管理器会显示fastboot设备Android Device,如下图:
    RDK-XD-MD-Driver-2.png
烧录系统

确认PC设备管理器显示fastboot设备Android Device后,运行hbupdate.exe打开烧录工具,并按照以下步骤进行烧录: RDK-XD-MD-Write-1.png

  1. 将底板的BOOT开关拨到ON,并通过 Type C 的USB接口连接到电脑
  2. 选择开发板型号。
    • RDK_X3_2GB: RDK X3(旭日X3派),2GB内存版本,仅支持烧写最小系统镜像
    • RDK_X3_4GB: RDK X3(旭日X3派),4GB内存版本,仅支持烧写最小系统镜像
    • RDK_X3_MD_2GB: RDK X3 Module,2GB内存版本
    • RDK_X3_MD_4GB: RDK X3 Module,4GB内存版本
    RDK-X3-MD-Write-2.png
  3. 点击Browse按钮选择将要烧录的镜像文件.
    RDK-X3-MD-Write-3.png
  4. 点击Start按钮开始刷机,根据弹窗提示开始烧录
    RDK-X3-MD-Write-4.png
  5. 像烧录成功时,工具提示如下:
    RDK-X3-MD-Write-5.png
  6. 烧录完毕断开电源,断开和电脑的连接线,将底板的BOOT开关拨至OFF,重新上电即可
  7. 系统首次启动时会进行默认环境配置,整个过程持续45秒左右,配置结束后会在显示器输出Ubuntu系统桌面。

远程登陆

使用 VNC、SSH 远程登录时要用到设备 IP,因此用户需要提前获取开发板 IP地址,登录用户名:sunrise 密码:sunrise。

SSH登录

    SSH登陆前我们需要配置电脑IP
    从串口登录我们已经获取到了 sunrise x3 pi 的 IP 地址 (192.168.1.10)
    为了使电脑与 sunrise x3 pi 进行通信需要进行以下操作:
  1. 开发板、PC 机 IP 地址前三段相同,例如开发板:192.168.1.10 PC 机:192.168.1.100
  2. 开发板、PC 机的子网掩码、网关保持一致
  3. PC 机网络防火墙处于关闭状态
    配置电脑 IP 主要进行如下几步:
  1. 在网络连接中找到对应的以太网设备并右击选择属性
    1. Network connection.png
  2. 找到 Internet 协议版本 4 选项并双击打开
  3. 在下图红框位置填入对应的网络参数,然后点击确定
      IPv4.png
  4. MobaXterm登录
      MobaXterm configuration SSH.png

    注意:开机输入用户名和密码必须在60S内完成,没完成的重新在60S内再输入一次即可。

VNC 登录

打开VNC软件,在地址栏输入旭日 X3 派的IP地址,回车,按照以下图片配置即可

    VNC 1.png


    VNC 2.png


命令行登录

ubuntu虚拟机打开终端输入:

ssh sunrise@192.168.1.10

Ubuntu terminal.png

网线网络配置

开发板网络配置保存在/etc/network/interfaces 文件中 在使用 vim 编辑器时保存时请先按下Esc键,再输入

 :wq!

推荐使用 nano 编辑器,安装命令如下:

sudo apt update
sudo apt-get install nano

    静态 IP 修改

    通过修改 address、netmask、gateway 等字段,可完成对静态 IP 配置的修改
    例如:

    sudo vim /etc/network/interfaces
    # interfaces(5) file used by ifup(8) and ifdown(8)
    # Include files from/etc/network/interfaces.d:
    source-directory /etc/network/interfaces.d
    auto eth0
    iface eth0 inet static
        address 192.168.1.10
        netmask 255.255.255.0
        gateway 192.168.1.1
        metric 700

    修改完成后,命令行输入

    sudo systemctl restart NetworkManager

    让配置生效。
    重启更新网络频段:

    sudo reboot

    修改 DHCP 配置

    DHCP(Dynamic Host Configuration Protocol,动态主机配置协议)通常被应用在大型的局域网络环境中,主要作用是集中的管理、分配 IP 地址,使网络环境中的主机动态的获得 IP 地址、Gateway 地址、DNS 服务器地址等信息,并能够提升地址的使用率。开发板的 DHCP 网络配置保存在/etc/network/interfaces 文件,通过修改 eth0 相关配置,可完成对 DHCP 模式的修改,例如终端输入:

    sudo vim /etc/network/interfaces

    修改以下内容:

    source-directory /etc/network/interfaces.d
    auto lo
    iface lo inet loopback
    auto eth0
    iface eth0 inet dhcp
        metric 700
    修改完成后,命令行输入
    sudo systemctl restart NetworkManager

    命令让配置生效。
    重启更新网络频段:

    sudo reboot

    修改 MAC 地址配置

    如需修改开发板默认 MAC 地址,可通过在/etc/network/interfaces 文件中增加 pre-up 配置信息,指定用户需要的 MAC 地址,例如:

    sudo vim /etc/network/interfaces

    修改以下内容:

    # interfaces(5) file used by ifup(8) and ifdown(8)# Include files from
    /etc/network/interfaces.d:
    source-directory /etc/network/interfaces.d
    auto eth0
    iface eth0 inet static
        address 192.168.1.10
        netmask 255.255.255.0
        gateway 192.168.1.1
        pre-up ifconfig eth0 hw ether 00:11:22:9f:51:27

    修改完成后,命令行输入

    sudo systemctl restart NetworkManager

    使配置生效。
    重启更新网络频段

    sudo reboot

DSI屏幕使用

由于RDK X3 Module 系统默认采用HDMI输出,需要通过命令切换到LCD显示方式,首先执行下面命令备份DTB

sudo cp /boot/hobot/hobot-x3-cm.dtb /boot/hobot/hobot-x3-cm_backup.dtb

执行以下命令确定当前显示类型:

sudo fdtget /boot/hobot/hobot-x3-cm.dtb /chosen bootargs

以HDMI为例,执行上述命令将会打印:

sunrise@ubuntu:~$ sudo fdtget /boot/hobot/hobot-x3-cm.dtb /chosen bootargs
earlycon loglevel=8 kgdboc=ttyS0 video=hobot:x3sdb-hdmi

执行以下命令修改chosen节点:

sudo fdtput -t s /boot/hobot/hobot-x3-cm.dtb /chosen bootargs "earlycon loglevel=8 kgdboc=ttyS0 video=hobot:cm480p"

执行以下命令打印出修改后的节点,确定修改成功:

sudo fdtget /boot/hobot/hobot-x3-cm.dtb /chosen bootargs

输入以下命令重启开发板:

sync
sudo reboot

此时的显示方式就从HDMI切换成DSI了。
如果想切回HDMI显示,进入内核后,执行下面命令:

sudo cp /boot/hobot/hobot-x3-cm_backup.dtb /boot/hobot/hobot-x3-cm.dtb
sync
sudo reboot

CSI摄像头使用

硬件连接

要测试摄像头,需要给X3派接入HDMI屏幕

将排线的金属面朝内,接入摄像头接口。

测试摄像头

X3派的摄像头接口默认是开启的,上电即可用。系统自带的AI demo可以用来测试摄像头,请确保已经连接HDMI屏幕,可以显示预览画面。
打开终端,输入以下指令:

  • 如果你是通过SSH登录的,需要现指定输出为屏幕
export DISPLAY=:0
  • 使用AI例程测试
cd /app/ai_inference/03_mipi_camera_sample
sudo python3 mipi_camera.py 

摄像头正常情况下会开启预览,并显示图像和对应的物体识别结果。

USB摄像头

终端输入,查看插入前与插入后的变化,检测摄像头是否被识别到

ls /dev/video*

终端输入,查询摄像头是否工作正常

sudo v4l2-ctl -d /dev/video8 --all

Ubuntu Server 镜像操作

先进行桌面VNC 安装
通过如下命令安装 xfce4 桌面:

sudo apt update
sudo apt install xfce4 xfce4-goodies xorg dbus-x11 x11-xserver-utils

通过以下命令安装 VNC 服务端

sudo apt install tightvncserver

安装完成后,使用如下命令查看 vnc 服务是否已经启动:

ps -ef | grep vnc

正常启动的话,可以看到监听了 5900 端口

    通用操作

    登陆 VNC 主机,安装 ffmpeg

    sudo apt install ffmpeg

    连接 USB 摄像头前后,使用以下命令查看当前的 video 设备,确定摄像头的设备号:

    ls /dev/video*

    输入指令启动摄像

    sudo ffplay /dev/video8