前 言

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

開發(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-[版本號]（基于rk3588_linux_release_v1.2.1_20230720）

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

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

術(shù)語表

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

注意事項

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

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

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

使用概要

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

評估板接口測試匯總

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

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

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

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

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

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

評估板快速測試

系統(tǒng)啟動測試

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

圖 1

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

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

圖 2

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

圖 3

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

圖 4

圖 5

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

圖 6

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

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

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

圖 7

圖 8

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

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

圖 9

文件傳送測試

PC機和評估板之間傳送文件的常見方式如下：

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

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

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

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

圖 10

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

Host# sudo mount /dev/sdb6/mnt

Host# ls /mnt/

圖 11

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

Host# touch test0

Host# sudo cp test0 /mnt/root/

圖 12

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

Host# sudo umount /dev/sdb6

圖 13

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

Target# ls

圖 14

通過OpenSSH

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

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

Host# ssh -v

圖 15

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

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

Target# udhcpc -i eth0

圖 16

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

Target# ifconfig

圖 17

（1）使用OpenSSH從PC機傳送文件至評估板

執(zhí)行如下命令在Ubuntu創(chuàng)建文件test1，并使用OpenSSH命令將test1文件拷貝至評估板文件系統(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)?"，請輸入：yes。

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

Target# ls /

圖 19

（2）使用OpenSSH從評估板傳送文件至PC機

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

Target# cd /

Target# touch test2 //新建文件

圖 20

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

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

Host# ls test2

圖 21

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

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

Host# sudo ssh root@192.168.13.21

圖 22

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

LED測試

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

進入評估板文件系統(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

按鍵測試

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

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

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

（2）PWRON按鍵測試

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

（3）Maskrom按鍵測試

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

Target# cat /proc/bus/input/devices

圖 24

圖 25

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

Target# od -x /dev/input/event5

圖 26

（4）用戶輸入按鍵測試

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

Target# cat /proc/bus/input/devices

圖 27

圖 28

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

Target# od -x /dev/input/event6

圖 29

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

Target# od -x /dev/input/event7

圖 30

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

審核編輯 黃宇