模板: 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. 在网络连接中找到对应的以太网设备并右击选择属性
      2. 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
取自“https://www.waveshare.net/w/index.php?title=模板:RDK_X3_MD_User_Guide&oldid=111002”