前 言

為助力開發者高效開展創龍科技研發的 TL3588-EVM 評估板物聯網應用開發，本文聚焦藍牙、WIFI、PCIe WIFI6、4G 四大物聯網模塊，詳細講解各模塊功能測試流程、操作命令及驅動編譯方法，覆蓋多場景應用需求，幫助開發者快速掌握模塊使用要點，順利實現評估板物聯網功能開發與驗證。

適用開發環境：

Windows開發環境：Windows 7 64bit、Windows 10 64bit

開發環境：VMware16.2.5、Ubuntu20.04.6 64bit

U-Boot：U-Boot-2017.09

Kernel：Linux-5.10.160

LinuxSDK：LinuxSDK-[版本號]（基于rk3588_linux_release_v1.2.1_20230720）

無特殊說明情況下，默認使用USB TO UART2作為調試串口，使用系統啟動卡（即SD啟動卡，Micro SD方式）啟動系統。

本文檔對應案例的測試接口、測試結果說明如下表所示。

藍牙功能測試

評估板已板載藍牙模塊，本小節主要演示藍牙模塊的通信功能。評估板上電時藍牙指示燈LED3呈閃爍狀態，當藍牙連接成功后，指示燈常亮。

本案例測試需準備一臺智能手機。將手機藍牙功能開啟，在手機應用商店搜索“調試全能王”APP進行藍牙測試工具安裝。

圖 1

安裝完成后打開APP，點擊"BLE GATT"，然后點擊右下角的搜索圖標，找到名為"WH-BLE 105"的設備點擊進行連接，如下圖所示。

圖 2

圖 3

圖 4

（1）評估板發送測試

藍牙連接后，在手機APP操作界面點擊對應圖標訂閱"NOTIFY"，并使能"WRITE,WRITE_NO_RESPONSE"，然后設置字符類型為"us-ascii"，如下圖所示。

圖 5

進入評估板文件系統，執行如下命令，由評估板通過藍牙方式發送信息至手機終端。

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

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

Target# echo tronlong > /dev/ttyS7

圖 6

在手機APP操作界面，點擊“實時日志”，并設置字符類型為"us-ascii"，接收到的數據如下圖所示。

圖 7

（2）評估板接收測試

評估板執行如下命令，等待接收手機發送的信息。

Target# cat /dev/ttyS7

圖 8

在手機APP操作界面輸入數據后點擊“發送”。

圖 9

評估板調試串口終端將接收到手機發送的字符信息，如下圖所示。

圖 10

WIFI模塊案例

案例說明

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

評估板已板載WIFI模塊，型號為：必聯BL-R8188EU2，支持STA和AP模式。請將2.4G天線接至評估板的WIFI(CON18)接口，如下圖所示。

圖 11

相關測試文件目錄位于產品資料“4-軟件資料Demomodule-demosusb_wifi”目錄下，驅動源碼位于案例"driversrc"目錄下。

（1）STA模式：在STA工作模式下，WIFI模塊可接收來自無線路由器發出的信號，實現通過路由器連接互聯網。

（2）AP模式：在AP工作模式下，WIFI模塊會創建一個無線局域網熱點，手機、電腦等設備可通過此熱點組建局域網。

為方便測試，產品資料中提供了經過驗證的腳本程序，腳本程序位于案例bin目錄下。請將bin目錄下所有文件和"driverbin8188eu.ko"驅動模塊拷貝至評估板文件系統任意相同路徑下。

案例測試

WIFI STA功能測試

進入評估板文件系統，在WIFI驅動8188eu.ko文件所在路徑下執行如下命令加載WIFI驅動。

備注：目前加載驅動后將會存在兩個wlan，具體原因未知，不影響功能使用，其中wlan0節點不可用。

Target# insmod-f 8188eu.ko

圖 12

執行如下命令，關閉其他網絡，僅保留WIFI網絡。

Target# ifconfig

Target# ifconfig eth0 down

Target# ifconfig eth1 down

Target# ifconfigeth2 down

Target# ifconfig

圖 13

圖 14

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

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

圖 15

執行如下命令，關閉wpa_supplicant進程。

備注：本次測試wpa_supplicant進程的PID為598，請根據實際情況修改

Target# ps -A | grep wpa_supplicant

Target# kill -9 598

圖 16

執行如下命令連接至路由器。

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

圖 17

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

Target# route -n

Target# vi /etc/resolv.conf

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

圖 18

圖 19

圖 20

（1）網絡連通測試

執行如下命令查看獲取的IP地址，并通過ping命令測試評估板與PC機通信是否正常。192.168.13.51為Ubuntu實際IP地址。

Target# ifconfig

Target# ping 192.168.13.51

圖 21

（2）TCP帶寬測試

如下使用Iperf3工具測試評估板與PC機的網絡通信帶寬。若未安裝，可在Ubuntu中執行"sudo apt-get install iperf3"安裝。

在Ubuntu執行如下命令查看PC機IP地址并等待評估板連接。

Host# ifconfig

Host# iperf3 -s

圖 22

在評估板文件系統執行如下命令測試網絡通信帶寬，192.168.13.51為Ubuntu實際IP地址。測試完成后，Ubuntu和評估板均會打印測試結果，不同測試環境，測試結果將會有所差異。

Target# iperf3 -c 192.168.13.51

圖 23

圖 24

WIFI AP功能測試

請重啟評估板，在WIFI驅動8188eu.ko文件所在路徑下執行如下命令加載WIFI驅動。

Target# insmod -f8188eu.ko

圖 25

執行如下命令，關閉其他網絡，僅保留WIFI網絡。

Target# ifconfig

Target# ifconfig eth0 down

Target# ifconfig eth1 down

Target# ifconfigeth2 down

Target# ifconfig

圖 26

圖 27

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

Target# ./ap_setup.sh

圖 28

默認設置的WIFI名稱為：rtl8188eu，密碼為：88888888，可在rtl_hostapd_2G.conf配置文件內進行修改。

將具有WIFI功能的PC機（比如筆記本電腦或裝有USB WIFI的臺式電腦）連接至此無線局域網熱點，并斷開已有的有線網絡連接。連接成功后，評估板將會打印如下信息，顯示Ubuntu已分配的IP地址。如使用虛擬機 +Ubuntu的開發方式，將會獲取到兩個IP地址，其中一個為Windows端IP地址，一個為Ubuntu端IP地址。

圖 29

（1）網絡連通測試

執行如下命令測試無線局域網設備之間網絡連接是否正常。若出現連接超時或失敗，可嘗試關閉PC機防火墻后再次連接。

Target# ping 192.168.0.111

圖 30

（2）TCP帶寬測試

在Ubuntu執行如下命令查看Ubuntu的IP地址并等待評估板連接。

Host# ifconfig

Host# iperf3 -s

圖 31

在評估板文件系統執行如下命令測試網絡通信帶寬，192.168.0.111為Ubuntu實際IP地址。測試完成后，Ubuntu和評估板均會打印測試結果。不同測試環境，測試結果將會有所差異。

Target# iperf3 -c 192.168.0.111

圖 32

圖 33

驅動編譯

請先參考《Debian系統使用手冊》編譯LinuxSDK后，再將usb_wifi的"driversrc"目錄下的WIFI驅動源碼拷貝至Ubuntu任意路徑并解壓。

Host# tar -zxvf rtl8188eus.tar.gz

圖 34

圖 35

進入驅動源碼目錄，打開Makefile文件。

Host# cd rtl8188eus/

Host# vim Makefile

圖 36

Makefile文件內容請按如下說明進行修改。

KSRC := /home/tronlong/RK3588/rk3588_linux_release_v1.2.1/kernel //設置內核源碼實際路徑

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- //設置交叉編譯工具鏈

圖 37

在驅動源碼所在路徑執行如下命令編譯WIFI驅動。

Host# make

圖 38

圖 39

編譯完成后即可在當前目錄生成WIFI驅動8188eu.ko文件。

圖 40

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

審核編輯 黃宇