前 言

創龍科技研發的評估板需配套專項開發案例實現功能開發。為助力開發者快速上手，本文提供 Linux 與 Python 兩類開發案例，詳細講解各案例功能、硬件連接、操作命令及關鍵代碼，同時說明案例編譯與運行環境配置要點，幫助開發者高效完成評估板應用開發與功能驗證。

如需重新編譯Linux常用開發案例，請先參考《Debian系統使用手冊》文檔正確安裝、編譯LinuxSDK，構建適配評估板的交叉編譯工具鏈。然后將對應案例src目錄拷貝至Ubuntu工作目錄下，在src目錄執行如下命令配置交叉編譯工具鏈，并執行make命令進行案例編譯。編譯完成后，將在當前目錄下生成可執行文件。

Host# export PATH=/home/tronlong/RK3588/rk3588_linux_release_v1.2.1/extra-tools/gcc-linaro-10.2.1-2021.01-x86_64_aarch64-linux-gnu/bin:$PATH

Host# make CC=aarch64-linux-gnu-gcc

圖 1

Linux常用開發案例

led_flash案例

案例功能

本案例通過向評估底板用戶可編程指示燈LED設備節點反復交替寫入1、0數值，實現LED閃爍效果。LED點亮與熄滅時間均為0.5s。

程序流程如下圖所示。

圖 2

LED設備節點為"/sys/class/leds/user-ledX/"目錄下的brightness。

圖 3

操作說明

將本案例bin目錄下的可執行程序led_flash拷貝至評估板文件系統，并在可執行程序所在目錄執行如下命令運行程序，即可看到評估底板LED以0.5s的時間間隔進行閃爍。同時，串口終端打印系統全部LED設備信息和程序當前控制的LED設備信息。

Target# ./led_flash -help

Target# ./led_flash -n 2

圖 4

關鍵代碼

（1）預定義LED數組。程序由此數組獲取LED信息，數組信息必須為系統已有LED信息，否則程序運行報錯。

圖 5

（2）LED亮滅操作和時間間隔。

圖 6

key_demo案例

案例功能

本案例通過監聽用戶輸入按鍵USER1(KEY4)、USER2(KEY5)的狀態，檢測按鍵事件。

案例將獲取按鍵事件后進行按鍵鍵值匹配，再進行事件處理，程序流程如下圖所示。

圖 7

操作說明

本次測試以用戶輸入按鍵USER1(KEY4)示例進行測試，如需測試用戶輸入按鍵USER2(KEY5)，請修改對應的設備節點。

將本案例bin目錄下的可執行程序key_demo拷貝至評估板文件系統，在可執行程序所在目錄執行如下命令運行程序，串口終端將打印提示信息。再按下評估板用戶輸入按鍵USER1(KEY4)，程序將檢測到按鍵事件，并打印按鍵狀態信息。

Target# ./key_demo -help

Target# ./key_demo -d /dev/input/event6

圖 8

關鍵代碼

（1）定義按鍵。

圖 9

（2）監聽按鍵事件。

圖 10

（3）循環監聽。

圖 11

can_echo案例

案例功能

本案例實現通過綁定一個CAN總線接口用于接收數據，當CAN端口接收到數據后，將數據重新發送到CAN總線接口。

程序流程如下圖所示。

圖 12

操作說明

請使用USB-CAN分析儀（型號：廣成科技USBCAN-II FD）連接評估板CAN0SPI0或CAN1SPI0任一接口至PC機USB接口，硬件連接如下圖所示。

本次測試以CAN0SPI0接口（設備節點為：can0）為例進行演示。如需測試CAN1SPI0接口，請將設備節點修改為can1。

圖 13

評估板CAN0 SPI0接口與USB-CAN分析儀的連接關系如下表所示。

請參照《調試工具安裝》文檔安裝GCAN Tools調試軟件。在PC端打開GCANTools軟件，選擇設備類型，然后點擊“打開設備”。根據USB-CAN分析儀實際硬件連接，選擇CAN1或CAN2。等待軟件檢測到設備后，設置波特率為"1000K"，然后點擊“確定”，如下圖所示。

圖 14

進入GCANTools軟件發送界面，取消"CAN FD"選項，USB-CAN分析儀連接成功后將會顯示Connected狀態，如下圖所示。

圖 15

評估板啟動進入評估板文件系統，執行如下命令配置CAN0SPI0接口波特率為1Mbps，并啟動CAN0總線。

Target# ip link set can0 down

Target# ip link set can0 type can bitrate 1000000

Target# ip link set can0 up

圖 16

將本案例bin目錄下的可執行程序can_echo拷貝至評估板文件系統，進入可執行程序所在目錄，執行如下命令查看程序參數信息。

Target# ./can_echo --help

圖 17

執行如下命令綁定CAN SPI0接口，并接收由GCANTools發出的數據，然后將接收到的數據重新發送出去。在GCANTools中輸入數據并點擊發送按鈕，可看到有兩幀數據，一幀是發送數據，另一幀是接收數據。

Target# ./can_echo -v can0

圖 18

圖 19

圖 20

圖 21

可按"Ctrl + Z"暫停程序，并執行如下命令退出程序。

Target# killall -9 can_echo

圖 22

關鍵代碼

（1）使用socket監聽CAN接口。

圖 23

（2）將從CAN接口接收到的數據重新發送出去。

圖 24

tcp_udp案例

案例功能

本案例主要實現客戶端(client)與服務端(server)的文本數據相互收發功能。本案例包含4個程序：

（1）tcp_server：TCP服務端測試程序。

（2）tcp_client：TCP客戶端測試程序。

（3）udp_server：UDP服務端測試程序。

（4）udp_client：UDP客戶端測試程序。

程序流程如下圖所示。

圖 25?TCP通信

圖 26?UDP通信

服務端和客戶端程序均可在評估板、PC機Ubuntu系統上運行。本章節采用評估板本地回環測試，即服務端與客戶端程序均在評估板上運行，通過127.0.0.1進行本地回環測試，無需經過路由器。案例bin目錄下的4個文件均為ARM端可執行程序。

操作說明

將本案例bin目錄下的4個可執行程序拷貝至評估板文件系統。

在Ubuntu中執行如下命令使用OpenSSH登錄評估板文件系統，如下圖所示。

Host# sudossh root@192.168.13.19 //192.168.13.19為評估板IP地址，請根據實際情況修改

圖 27

（1）TCP通信測試

在可執行程序所在目錄執行如下命令，分別在評估板運行TCP服務端和客戶端程序。2233為服務端程序指定的端口號，客戶端程序端口號參數需與服務端程序一致。

Target# ./tcp_server 2233 //TCP服務端命令

Host# ./tcp_client 127.0.0.12233 //TCP客戶端命令

程序執行后，客戶端將會連接服務端。在服務端(Target)輸入字符串"Tronlong"，按下回車鍵即可在客戶端顯示對應內容。在客戶端(Host)輸入字符串"Hello Tronlong"，按下回車鍵即可在服務端顯示對應內容，如下圖所示。

圖 28?TCP服務端

圖 29?TCP客戶端

（2）UDP通信測試

在可執行程序所在目錄執行如下命令，分別在評估板運行UDP服務端和客戶端程序。2233為服務端程序指定的端口號，客戶端程序端口號參數需與服務端程序一致。

Target# ./udp_server 2233 //UDP服務端命令

Host# ./udp_client 127.0.0.12233 //UDP客戶端命令

程序執行后，客戶端將不會自動連接服務端。服務端在收到客戶端信息前無法得知客戶端的存在，因此需要客戶端先向服務端發送信息。

在客戶端(Host)輸入字符串"Tronlong"，按下回車鍵即可在服務端顯示對應內容。在服務端(Target)輸入字符串"Hello Tronlong"，按下回車鍵即可在客戶端顯示對應內容，如下圖所示。

圖 30?UDP客戶端

圖 31?UDP服務端

如需在PC機Ubuntu系統運行服務端或客戶端程序，請將案例src源碼目錄拷貝至Ubuntu工作目錄。進入源碼目錄后執行make命令，即可在當前目錄下生成x86端可執行程序。在不同終端運行服務端或客戶端程序的命令類似，但127.0.0.1需使用服務器IP地址替代。

Host# make

圖 32

關鍵代碼

以TCP通信程序為例。

（1）tcp_client.c

注意源碼中的struct sockaddr_in、socket、connect、fgets、send、recv等數據結構和系統調用的使用。

（2）tcp_server.c

注意源碼中的struct sockaddr_in、socket、connect、fgets、send、recv、bind、listen、accept等數據結構和系統調用的使用。

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

審核編輯 黃宇