前 言

創(chuàng)龍科技研發(fā)的評(píng)估板需通過專項(xiàng)測(cè)試驗(yàn)證性能。為助力開發(fā)者快速完成接口功能驗(yàn)證與系統(tǒng)配置，本文針對(duì)其多類接口，分步講解測(cè)試流程、硬件連接與命令操作，兼顧基礎(chǔ)功能與進(jìn)階配置，同時(shí)說明 PCIe 網(wǎng)卡測(cè)試及驅(qū)動(dòng)編譯，為評(píng)估板應(yīng)用與開發(fā)提供實(shí)用指南。

開發(fā)環(huán)境

Windows開發(fā)環(huán)境：Windows 7 64bit、Windows 10 64bit

Linux開發(fā)環(huán)境：VMware16.2.5、Ubuntu20.04 64bit

LinuxSDK開發(fā)包：LinuxSDK-[版本號(hào)]（基于rk3588_linux_release_v1.2.1_20230720）

評(píng)估板系統(tǒng)版本：Debian11、Linux-5.10.160、U-Boot-2017.09

備注：本文基于4GByte DDR、32GByte eMMC配置核心板進(jìn)行測(cè)試，不同配置型號(hào)核心板實(shí)測(cè)結(jié)果可能存在偏差。

術(shù)語表

為便于閱讀，下表對(duì)文檔出現(xiàn)的關(guān)鍵術(shù)語進(jìn)行解釋；對(duì)于廣泛認(rèn)同釋義的術(shù)語，在此不做注釋。

注意事項(xiàng)

（1）為保障處理器使用壽命，滿足更多工業(yè)應(yīng)用場(chǎng)景要求，我司已將RK3588J/RK3588處理器Cortex-A76核心最高主頻默認(rèn)配置為1.6GHz，Cortex-A55核心最高主頻默認(rèn)配置為1.3GHz。如需調(diào)整為更高主頻，請(qǐng)參考《Debian系統(tǒng)使用手冊(cè)》文檔進(jìn)行操作。

（2）無特殊說明情況下，默認(rèn)使用USB TO UART2接口作為調(diào)試串口，使用系統(tǒng)啟動(dòng)卡（即SD啟動(dòng)卡，Micro SD方式）啟動(dòng)系統(tǒng)，通過路由器與PC機(jī)進(jìn)行網(wǎng)絡(luò)連接。

（3）評(píng)估板出廠時(shí)未固化最新系統(tǒng)鏡像至eMMC存儲(chǔ)。為確保您體驗(yàn)到我司提供的最新系統(tǒng)功能，建議您參考《系統(tǒng)啟動(dòng)卡制作及系統(tǒng)固化》文檔，按照指引將最新系統(tǒng)鏡像固化至eMMC。

使用概要

本小節(jié)主要描述評(píng)估板存儲(chǔ)設(shè)備分區(qū)和Linux設(shè)備驅(qū)動(dòng)等系統(tǒng)等配置信息，以及匯總說明評(píng)估板接口性能測(cè)試結(jié)果。

評(píng)估板接口測(cè)試匯總

評(píng)估板接口功能測(cè)試結(jié)果匯總說明如下表所示。

Linux設(shè)備驅(qū)動(dòng)說明

（由于表格內(nèi)容過多，表格內(nèi)容不逐一展示，更多內(nèi)容請(qǐng)?jiān)u論區(qū)留言）

Linux設(shè)備分區(qū)說明

系統(tǒng)啟動(dòng)卡和eMMC分區(qū)說明如下表所示，其中系統(tǒng)啟動(dòng)卡對(duì)應(yīng)的設(shè)備節(jié)點(diǎn)為mmcblk1，eMMC對(duì)應(yīng)的設(shè)備節(jié)點(diǎn)為mmcblk0。

（由于表格內(nèi)容過多，表格內(nèi)容不逐一展示，更多內(nèi)容請(qǐng)?jiān)u論區(qū)留言）

評(píng)估板快速測(cè)試

系統(tǒng)啟動(dòng)測(cè)試

將系統(tǒng)啟動(dòng)卡插至評(píng)估板Micro SD卡槽，評(píng)估板接入電源，將評(píng)估板HDMI OUT接口連接至HDMI顯示屏，將鼠標(biāo)連接至評(píng)估板USB2.0 HOST任意一層接口，并使用Type-C線將評(píng)估板的USB TO UART2調(diào)試串口連接至PC機(jī)。評(píng)估板硬件連接如下圖所示。

圖 1

評(píng)估板上電啟動(dòng)，系統(tǒng)啟動(dòng)后，可在HDMI顯示屏觀察到如下顯示界面。

備注：請(qǐng)?jiān)谠u(píng)估板上電前正確連接硬件，并確保HDMI顯示屏通過HDMI顯示，否則HDMI顯示屏?xí)霈F(xiàn)顯示異常情況。

圖 2

可通過鼠標(biāo)點(diǎn)擊桌面圖標(biāo)進(jìn)行功能測(cè)試。如點(diǎn)擊主文件夾圖標(biāo)，將顯示如下界面。

圖 3

評(píng)估板斷電，打開設(shè)備管理器，確認(rèn)評(píng)估板USB TO UART2調(diào)試串口對(duì)應(yīng)的COM端口號(hào)。

圖 4

圖 5

打開串口調(diào)試終端SecureCRT，選擇對(duì)應(yīng)的COM端口號(hào)，設(shè)置波特率為115200，8N1，無校驗(yàn)位。建立串口連接，如下圖所示。

圖 6

評(píng)估板上電啟動(dòng)，評(píng)估板將優(yōu)先從系統(tǒng)啟動(dòng)卡啟動(dòng)系統(tǒng)。

系統(tǒng)上電后，由CPU內(nèi)部BootRom的引導(dǎo)代碼依次從eMMC FLASH、SD卡、USB接口檢測(cè)SPL啟動(dòng)程序，從第一個(gè)包含SPL啟動(dòng)程序的設(shè)備開始啟動(dòng)。SPL啟動(dòng)后，將優(yōu)先從SD系統(tǒng)卡（非常規(guī)SD卡）引導(dǎo)U-Boot鏡像，否則，將從原啟動(dòng)設(shè)備引導(dǎo)U-Boot鏡像。詳情請(qǐng)查閱“6-開發(fā)參考資料Rockchip官方參考文檔CommonMMC”目錄下的官方參考文檔《Rockchip_Developer_Guide_SD_Boot_CN》。

系統(tǒng)啟動(dòng)后將自動(dòng)登錄root用戶，調(diào)試串口會(huì)打印如下類似啟動(dòng)信息。"Bootdev(atags)：mmc 1"表示從系統(tǒng)啟動(dòng)卡啟動(dòng)。

圖 7

圖 8

核心板LED在系統(tǒng)啟動(dòng)過程中的變化說明如下：

評(píng)估板上電后電源指示燈LED0點(diǎn)亮；U-Boot啟動(dòng)階段點(diǎn)亮LED2；隨后Linux內(nèi)核啟動(dòng)運(yùn)行時(shí)，LED1、LED2閃爍；Linux內(nèi)核穩(wěn)定運(yùn)行時(shí)，LED2熄滅，LED1進(jìn)行心跳閃爍；eMMC進(jìn)行讀寫時(shí)，LED2閃爍。

圖 9

文件傳送測(cè)試

PC機(jī)和評(píng)估板之間傳送文件的常見方式如下：

（1）通過系統(tǒng)啟動(dòng)卡、U盤等存儲(chǔ)介質(zhì)方式拷貝。

（2）通過NFS、TFTP、OpenSSH等網(wǎng)絡(luò)方式拷貝。

通過系統(tǒng)啟動(dòng)卡

將配套的系統(tǒng)啟動(dòng)卡通過讀卡器插至PC機(jī)掛載至虛擬機(jī)Ubuntu系統(tǒng)，如下圖，查詢系統(tǒng)啟動(dòng)卡設(shè)備節(jié)點(diǎn)，其中"/dev/sdb6"為系統(tǒng)啟動(dòng)卡文件系統(tǒng)分區(qū)，具體以實(shí)際名稱為準(zhǔn)。

圖 10

執(zhí)行如下命令，將"/dev/sdb6"設(shè)備節(jié)點(diǎn)掛載至"/mnt/"目錄下。

Host# sudo mount /dev/sdb6/mnt

Host# ls /mnt/

圖 11

執(zhí)行如下命令在Ubuntu創(chuàng)建文件test0，將test0文件拷貝至評(píng)估板文件系統(tǒng)root目錄。

Host# touch test0

Host# sudo cp test0 /mnt/root/

圖 12

文件拷貝完成后，請(qǐng)執(zhí)行如下命令卸載設(shè)備，并拔出讀卡器，從中取出系統(tǒng)啟動(dòng)卡。

Host# sudo umount /dev/sdb6

圖 13

將系統(tǒng)啟動(dòng)卡插至評(píng)估板Micro SD卡槽，評(píng)估板上電啟動(dòng)即可查看文件系統(tǒng)root目錄下的文件。

Target# ls

圖 14

通過OpenSSH

OpenSSH是SSH(Secure Shell)協(xié)議的免費(fèi)開源實(shí)現(xiàn)。SSH協(xié)議族可用來進(jìn)行遠(yuǎn)程控制，或在計(jì)算機(jī)之間傳送文件，評(píng)估板文件系統(tǒng)默認(rèn)已支持SSH庫。

在Ubuntu中執(zhí)行如下命令，查詢是否已安裝OpenSSH。

Host# ssh -v

圖 15

可看到系統(tǒng)已自帶OpenSSH。如未安裝，請(qǐng)先自行正確安裝OpenSSH。

將評(píng)估板ETH0網(wǎng)口（CON15雙層RJ45連接器下層）通過網(wǎng)線連接至路由器。在評(píng)估板上執(zhí)行如下命令可自動(dòng)獲取到IP，如下圖所示。"-i"用于指定網(wǎng)卡，eth0為網(wǎng)卡名字，請(qǐng)根據(jù)實(shí)際情況修改。

Target# udhcpc -i eth0

圖 16

執(zhí)行如下命令可查詢IP地址。本次查詢到的IP地址是192.168.13.21。

Target# ifconfig

圖 17

（1）使用OpenSSH從PC機(jī)傳送文件至評(píng)估板

執(zhí)行如下命令在Ubuntu創(chuàng)建文件test1，并使用OpenSSH命令將test1文件拷貝至評(píng)估板文件系統(tǒng)根目錄。

Host# touch test1 //新建文件

Host# scp test1root@192.168.13.21:/

圖 18

若出現(xiàn)提示"Are you sure you want to continue connecting (yes/no)?"，請(qǐng)輸入：yes。

在評(píng)估板執(zhí)行如下命令可看到從PC機(jī)拷貝過來的文件，如下圖所示。

Target# ls /

圖 19

（2）使用OpenSSH從評(píng)估板傳送文件至PC機(jī)

執(zhí)行如下命令在評(píng)估板文件系統(tǒng)根目錄新建一個(gè)測(cè)試文件test2。

Target# cd /

Target# touch test2 //新建文件

圖 20

在Ubuntu上執(zhí)行如下OpenSSH命令將評(píng)估板測(cè)試文件test2拷貝至PC機(jī)"/home/tronlong/"目錄下。若傳輸?shù)氖俏募A，請(qǐng)?jiān)趕cp后面添加參數(shù)"-r"。

Host# sudo scp root@192.168.13.21:/test2 /home/tronlong/

Host# ls test2

圖 21

（3）使用OpenSSH登錄至評(píng)估板文件系統(tǒng)

在Ubuntu執(zhí)行如下命令可通過OpenSSH登錄評(píng)估板文件系統(tǒng)。

Host# sudo ssh root@192.168.13.21

圖 22

如需退出登錄，請(qǐng)執(zhí)行exit或者logout命令。

LED測(cè)試

評(píng)估底板用戶可編程指示燈LED1、LED2與GPIO對(duì)應(yīng)關(guān)系如下表所示。

進(jìn)入評(píng)估板文件系統(tǒng)，執(zhí)行如下命令控制LED亮滅。

Target# echo 1 > /sys/class/leds/user-led0/brightness //控制LED1亮

Target# echo 0 > /sys/class/leds/user-led0/brightness //控制LED1滅

Target# echo 1> /sys/class/leds/user-led1/brightness //控制LED2亮

Target# echo 0 > /sys/class/leds/user-led1/brightness //控制LED2滅

圖 23

按鍵測(cè)試

評(píng)估底板包含1個(gè)系統(tǒng)復(fù)位按鍵RESETn(KEY1)，1個(gè)PMIC開關(guān)機(jī)按鍵PWRON(KEY2)，1個(gè)Maskrom按鍵Maskrom(KEY3)，2個(gè)用戶輸入按鍵：USER1(KEY4)、USER2(KEY5)。

（1）系統(tǒng)復(fù)位按鍵測(cè)試

評(píng)估板上電，按下系統(tǒng)復(fù)位按鍵RESETn(KEY1)，核心板板載LED1停止閃爍；松開按鍵后，系統(tǒng)將會(huì)重新啟動(dòng)。

（2）PWRON按鍵測(cè)試

評(píng)估板默認(rèn)系統(tǒng)（Debian系統(tǒng)）暫不支持休眠喚醒功能。

（3）Maskrom按鍵測(cè)試

執(zhí)行如下命令，查看Maskrom按鍵對(duì)應(yīng)的事件號(hào)。其中Maskrom(KEY3)對(duì)應(yīng)的按鍵事件號(hào)為event5。

Target# cat /proc/bus/input/devices

圖 24

圖 25

執(zhí)行如下命令，按下Maskrom(KEY3)進(jìn)行按鍵測(cè)試，可看到如下打印信息，按"Ctrl + C"可終止測(cè)試命令。

Target# od -x /dev/input/event5

圖 26

（4）用戶輸入按鍵測(cè)試

執(zhí)行如下命令，查看用戶輸入按鍵對(duì)應(yīng)的事件號(hào)。其中USER1(KEY4)對(duì)應(yīng)的按鍵事件號(hào)為event6，USER2(KEY5)對(duì)應(yīng)的按鍵事件號(hào)為event7。

Target# cat /proc/bus/input/devices

圖 27

圖 28

執(zhí)行如下命令，按下USER1(KEY4)進(jìn)行按鍵測(cè)試，可看到如下打印信息，按"Ctrl + C"可終止測(cè)試命令。

Target# od -x /dev/input/event6

圖 29

執(zhí)行如下命令，按下USER2(KEY5)進(jìn)行按鍵測(cè)試，可看到如下打印信息，按"Ctrl + C"可終止測(cè)試命令。

Target# od -x /dev/input/event7

圖 30

由于篇幅過長(zhǎng)等原因，部分內(nèi)容均不逐一展示，如需獲取完整版詳細(xì)資料，請(qǐng)關(guān)注創(chuàng)龍科技微信公眾號(hào)或官網(wǎng)，或者評(píng)論區(qū)留言，感謝您的支持！

審核編輯 黃宇