前 言

為助力開(kāi)發(fā)者高效開(kāi)展創(chuàng)龍科技研發(fā)的 TL3588-EVM 評(píng)估板物聯(lián)網(wǎng)應(yīng)用開(kāi)發(fā)，本文聚焦藍(lán)牙、WIFI、PCIe WIFI6、4G 四大物聯(lián)網(wǎng)模塊，詳細(xì)講解各模塊功能測(cè)試流程、操作命令及驅(qū)動(dòng)編譯方法，覆蓋多場(chǎng)景應(yīng)用需求，幫助開(kāi)發(fā)者快速掌握模塊使用要點(diǎn)，順利實(shí)現(xiàn)評(píng)估板物聯(lián)網(wǎng)功能開(kāi)發(fā)與驗(yàn)證。

適用開(kāi)發(fā)環(huán)境：

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

開(kāi)發(fā)環(huán)境：VMware16.2.5、Ubuntu20.04.6 64bit

U-Boot：U-Boot-2017.09

Kernel：Linux-5.10.160

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

無(wú)特殊說(shuō)明情況下，默認(rèn)使用USB TO UART2作為調(diào)試串口，使用系統(tǒng)啟動(dòng)卡（即SD啟動(dòng)卡，Micro SD方式）啟動(dòng)系統(tǒng)。

本文檔對(duì)應(yīng)案例的測(cè)試接口、測(cè)試結(jié)果說(shuō)明如下表所示。

藍(lán)牙功能測(cè)試

評(píng)估板已板載藍(lán)牙模塊，本小節(jié)主要演示藍(lán)牙模塊的通信功能。評(píng)估板上電時(shí)藍(lán)牙指示燈LED3呈閃爍狀態(tài)，當(dāng)藍(lán)牙連接成功后，指示燈常亮。

本案例測(cè)試需準(zhǔn)備一臺(tái)智能手機(jī)。將手機(jī)藍(lán)牙功能開(kāi)啟，在手機(jī)應(yīng)用商店搜索“調(diào)試全能王”APP進(jìn)行藍(lán)牙測(cè)試工具安裝。

圖 1

安裝完成后打開(kāi)APP，點(diǎn)擊"BLE GATT"，然后點(diǎn)擊右下角的搜索圖標(biāo)，找到名為"WH-BLE 105"的設(shè)備點(diǎn)擊進(jìn)行連接，如下圖所示。

圖 2

圖 3

圖 4

（1）評(píng)估板發(fā)送測(cè)試

藍(lán)牙連接后，在手機(jī)APP操作界面點(diǎn)擊對(duì)應(yīng)圖標(biāo)訂閱"NOTIFY"，并使能"WRITE,WRITE_NO_RESPONSE"，然后設(shè)置字符類型為"us-ascii"，如下圖所示。

圖 5

進(jìn)入評(píng)估板文件系統(tǒng)，執(zhí)行如下命令，由評(píng)估板通過(guò)藍(lán)牙方式發(fā)送信息至手機(jī)終端。

備注：如下警告信息忽略即可，不影響功能測(cè)試。

Target# stty -F /dev/ttyS7 ispeed 57600 ospeed 57600 cs8 -icanon

Target# echo tronlong > /dev/ttyS7

圖 6

在手機(jī)APP操作界面，點(diǎn)擊“實(shí)時(shí)日志”，并設(shè)置字符類型為"us-ascii"，接收到的數(shù)據(jù)如下圖所示。

圖 7

（2）評(píng)估板接收測(cè)試

評(píng)估板執(zhí)行如下命令，等待接收手機(jī)發(fā)送的信息。

Target# cat /dev/ttyS7

圖 8

在手機(jī)APP操作界面輸入數(shù)據(jù)后點(diǎn)擊“發(fā)送”。

圖 9

評(píng)估板調(diào)試串口終端將接收到手機(jī)發(fā)送的字符信息，如下圖所示。

圖 10

WIFI模塊案例

案例說(shuō)明

案例功能：演示評(píng)估板板載WIFI模塊的STA和AP模式功能。

評(píng)估板已板載WIFI模塊，型號(hào)為：必聯(lián)BL-R8188EU2，支持STA和AP模式。請(qǐng)將2.4G天線接至評(píng)估板的WIFI(CON18)接口，如下圖所示。

圖 11

相關(guān)測(cè)試文件目錄位于產(chǎn)品資料“4-軟件資料Demomodule-demosusb_wifi”目錄下，驅(qū)動(dòng)源碼位于案例"driversrc"目錄下。

（1）STA模式：在STA工作模式下，WIFI模塊可接收來(lái)自無(wú)線路由器發(fā)出的信號(hào)，實(shí)現(xiàn)通過(guò)路由器連接互聯(lián)網(wǎng)。

（2）AP模式：在AP工作模式下，WIFI模塊會(huì)創(chuàng)建一個(gè)無(wú)線局域網(wǎng)熱點(diǎn)，手機(jī)、電腦等設(shè)備可通過(guò)此熱點(diǎn)組建局域網(wǎng)。

為方便測(cè)試，產(chǎn)品資料中提供了經(jīng)過(guò)驗(yàn)證的腳本程序，腳本程序位于案例bin目錄下。請(qǐng)將bin目錄下所有文件和"driverbin8188eu.ko"驅(qū)動(dòng)模塊拷貝至評(píng)估板文件系統(tǒng)任意相同路徑下。

案例測(cè)試

WIFI STA功能測(cè)試

進(jìn)入評(píng)估板文件系統(tǒng)，在WIFI驅(qū)動(dòng)8188eu.ko文件所在路徑下執(zhí)行如下命令加載WIFI驅(qū)動(dòng)。

備注：目前加載驅(qū)動(dòng)后將會(huì)存在兩個(gè)wlan，具體原因未知，不影響功能使用，其中wlan0節(jié)點(diǎn)不可用。

Target# insmod-f 8188eu.ko

圖 12

執(zhí)行如下命令，關(guān)閉其他網(wǎng)絡(luò)，僅保留WIFI網(wǎng)絡(luò)。

Target# ifconfig

Target# ifconfig eth0 down

Target# ifconfig eth1 down

Target# ifconfigeth2 down

Target# ifconfig

圖 13

圖 14

執(zhí)行如下命令，將評(píng)估板板載WIFI模塊連接至路由器。"-i"指定WIFI名稱，"-p"指定WIFI密碼，請(qǐng)根據(jù)實(shí)際情況修改。

Target# ./wifi_setup.sh -i Tronlong -p omapl138

圖 15

執(zhí)行如下命令，關(guān)閉wpa_supplicant進(jìn)程。

備注：本次測(cè)試wpa_supplicant進(jìn)程的PID為598，請(qǐng)根據(jù)實(shí)際情況修改

Target# ps -A | grep wpa_supplicant

Target# kill -9 598

圖 16

執(zhí)行如下命令連接至路由器。

Target# wpa_supplicant -i wlan1 -B -c /etc/wpa_supplicant.conf

圖 17

執(zhí)行如下命令修改"/etc/resolv.conf"文件。

Target# route -n

Target# vi /etc/resolv.conf

Target# apt-get update //更新鏡像源

圖 18

圖 19

圖 20

（1）網(wǎng)絡(luò)連通測(cè)試

執(zhí)行如下命令查看獲取的IP地址，并通過(guò)ping命令測(cè)試評(píng)估板與PC機(jī)通信是否正常。192.168.13.51為Ubuntu實(shí)際IP地址。

Target# ifconfig

Target# ping 192.168.13.51

圖 21

（2）TCP帶寬測(cè)試

如下使用Iperf3工具測(cè)試評(píng)估板與PC機(jī)的網(wǎng)絡(luò)通信帶寬。若未安裝，可在Ubuntu中執(zhí)行"sudo apt-get install iperf3"安裝。

在Ubuntu執(zhí)行如下命令查看PC機(jī)IP地址并等待評(píng)估板連接。

Host# ifconfig

Host# iperf3 -s

圖 22

在評(píng)估板文件系統(tǒng)執(zhí)行如下命令測(cè)試網(wǎng)絡(luò)通信帶寬，192.168.13.51為Ubuntu實(shí)際IP地址。測(cè)試完成后，Ubuntu和評(píng)估板均會(huì)打印測(cè)試結(jié)果，不同測(cè)試環(huán)境，測(cè)試結(jié)果將會(huì)有所差異。

Target# iperf3 -c 192.168.13.51

圖 23

圖 24

WIFI AP功能測(cè)試

請(qǐng)重啟評(píng)估板，在WIFI驅(qū)動(dòng)8188eu.ko文件所在路徑下執(zhí)行如下命令加載WIFI驅(qū)動(dòng)。

Target# insmod -f8188eu.ko

圖 25

執(zhí)行如下命令，關(guān)閉其他網(wǎng)絡(luò)，僅保留WIFI網(wǎng)絡(luò)。

Target# ifconfig

Target# ifconfig eth0 down

Target# ifconfig eth1 down

Target# ifconfigeth2 down

Target# ifconfig

圖 26

圖 27

在ap_setup.sh文件所在路徑下執(zhí)行如下命令，將WIFI模塊設(shè)置為AP模式。

Target# ./ap_setup.sh

圖 28

默認(rèn)設(shè)置的WIFI名稱為：rtl8188eu，密碼為：88888888，可在rtl_hostapd_2G.conf配置文件內(nèi)進(jìn)行修改。

將具有WIFI功能的PC機(jī)（比如筆記本電腦或裝有USB WIFI的臺(tái)式電腦）連接至此無(wú)線局域網(wǎng)熱點(diǎn)，并斷開(kāi)已有的有線網(wǎng)絡(luò)連接。連接成功后，評(píng)估板將會(huì)打印如下信息，顯示Ubuntu已分配的IP地址。如使用虛擬機(jī) +Ubuntu的開(kāi)發(fā)方式，將會(huì)獲取到兩個(gè)IP地址，其中一個(gè)為Windows端IP地址，一個(gè)為Ubuntu端IP地址。

圖 29

（1）網(wǎng)絡(luò)連通測(cè)試

執(zhí)行如下命令測(cè)試無(wú)線局域網(wǎng)設(shè)備之間網(wǎng)絡(luò)連接是否正常。若出現(xiàn)連接超時(shí)或失敗，可嘗試關(guān)閉PC機(jī)防火墻后再次連接。

Target# ping 192.168.0.111

圖 30

（2）TCP帶寬測(cè)試

在Ubuntu執(zhí)行如下命令查看Ubuntu的IP地址并等待評(píng)估板連接。

Host# ifconfig

Host# iperf3 -s

圖 31

在評(píng)估板文件系統(tǒng)執(zhí)行如下命令測(cè)試網(wǎng)絡(luò)通信帶寬，192.168.0.111為Ubuntu實(shí)際IP地址。測(cè)試完成后，Ubuntu和評(píng)估板均會(huì)打印測(cè)試結(jié)果。不同測(cè)試環(huán)境，測(cè)試結(jié)果將會(huì)有所差異。

Target# iperf3 -c 192.168.0.111

圖 32

圖 33

驅(qū)動(dòng)編譯

請(qǐng)先參考《Debian系統(tǒng)使用手冊(cè)》編譯LinuxSDK后，再將usb_wifi的"driversrc"目錄下的WIFI驅(qū)動(dòng)源碼拷貝至Ubuntu任意路徑并解壓。

Host# tar -zxvf rtl8188eus.tar.gz

圖 34

圖 35

進(jìn)入驅(qū)動(dòng)源碼目錄，打開(kāi)Makefile文件。

Host# cd rtl8188eus/

Host# vim Makefile

圖 36

Makefile文件內(nèi)容請(qǐng)按如下說(shuō)明進(jìn)行修改。

KSRC := /home/tronlong/RK3588/rk3588_linux_release_v1.2.1/kernel //設(shè)置內(nèi)核源碼實(shí)際路徑

CROSS_COMPILE := /home/tronlong/RK3588/rk3588_linux_release_v1.2.1/extra-tools/gcc-linaro-10.2.1-2021.01-x86_64_aarch64-linux-gnu/bin/aarch64-linux-gnu- //設(shè)置交叉編譯工具鏈

圖 37

在驅(qū)動(dòng)源碼所在路徑執(zhí)行如下命令編譯WIFI驅(qū)動(dòng)。

Host# make

圖 38

圖 39

編譯完成后即可在當(dāng)前目錄生成WIFI驅(qū)動(dòng)8188eu.ko文件。

圖 40

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

審核編輯 黃宇