udisplay
概述
udisplay是AliOS Things一套顯示接口組件,udisplay通過posix接口調(diào)用fbdev設(shè)備及backlight設(shè)備驅(qū)動(dòng),避免用戶和LCD顯示驅(qū)動(dòng)直接交互,調(diào)用udisplay組件中的函數(shù)來進(jìn)行framebuffer及背光調(diào)節(jié)相關(guān)操作。
版權(quán)信息
Apache 2.0 License
目錄結(jié)構(gòu)
├── include
│ ├── udisplay.h # 對(duì)外頭文件
│ └── udispaly_cli.h # 對(duì)外頭文件
├── package.yaml # 編譯配置文件
├── src
│ └── udisplay.c # udisplay核心處理層
└──example
└── udisplay_example.c # udisplay測(cè)試用例
依賴組件
osal_aos
fbdev
常用配置
def_config: # 組件的可配置項(xiàng)
AOS_COMP_UDISPLAY: 1 # 使能組件宏定義
API說明
使用示例
組件使用示例相關(guān)的代碼下載、編譯和固件燒錄均依賴AliOS Things配套的開發(fā)工具,所以首先需要參考《AliOS Things集成開發(fā)環(huán)境使用說明之搭建開發(fā)環(huán)境》,下載安裝。 待開發(fā)環(huán)境搭建完成后,可以按照以下步驟進(jìn)行示例的測(cè)試。
步驟1 創(chuàng)建或打開工程
打開已有工程
如果用于測(cè)試的案例工程已存在,可參考《AliOS Things集成開發(fā)環(huán)境使用說明之打開工程》打開已有工程。
創(chuàng)建新的工程
組件的示例代碼可以通過編譯鏈接到AliOS Things的任意案例(solution)來運(yùn)行,這里選擇helloworld_demo案例。helloworld_demo案例相關(guān)的源代碼下載可參考《AliOS Things集成開發(fā)環(huán)境使用說明之創(chuàng)建工程》。
步驟2 添加組件
案例下載完成后,需要在helloworld_demo組件的package.yaml中添加對(duì)組件的依賴:
depends:
- udisplay: master # helloworld_demo 中引入udisplay組件
- ili9341: master # helloworld_demo 中引入ili9341屏幕驅(qū)動(dòng)
def_config:
CLI_IOBOX_ENABLE: 1 # 可選:使能文件系統(tǒng)測(cè)試命令,例如ls, ll, mkdir, touch, echo等
步驟3 下載組件
在已安裝了的開發(fā)環(huán)境工具欄中,選擇Terminal -> New Terminal啟動(dòng)終端,并且默認(rèn)工作路徑為當(dāng)前工程的workspace,此時(shí)在終端命令行中輸入:
aos install udisplay
上述命令執(zhí)行成功后,組件源碼則被下載到了./components/udisplay路徑中。
步驟4 添加示例
在udisplay組件的package.yaml中添加example示例代碼:
source_file:
- "example/udisplay_example.c" # add udisplay_example.c
LCD連線使用本測(cè)試示例時(shí),請(qǐng)先連接SPI LCD屏幕。
LCD購買鏈接https://item.taobao.com/item.htm?spm=a1z09.2.0.0.768d2e8d9D3S7s&id=38842179442&_u=m1tg6s6048c2
請(qǐng)選擇購買2.4寸屏。
HaaS100開發(fā)板請(qǐng)務(wù)必使用V1.1以上的版本,HaaS100擴(kuò)展口:
LCD與HaaS100接線對(duì)應(yīng)pin腳:
步驟5 編譯固件
在示例代碼已經(jīng)添加至組件的配置文件,并且helloworld_demo已添加了對(duì)該組件的依賴后,就可以編譯helloworld_demo案例來生成固件了,具體編譯方法可參考《AliOS Things集成開發(fā)環(huán)境使用說明之編譯固件》。
步驟6 燒錄固件
上述步驟執(zhí)行后,可參考《AliOS Things集成開發(fā)環(huán)境使用說明之燒錄固件》來燒錄固件。
步驟7 打開串口
固件燒錄完成后,可以通過串口查看示例的運(yùn)行結(jié)果,打開串口的具體方法可參考《AliOS Things集成開發(fā)環(huán)境使用說明之查看日志》。
當(dāng)串口終端打開成功后,可在串口中輸入help來查看已添加的測(cè)試命令。
步驟8 測(cè)試示例
測(cè)試步驟:
$ udisplay_init # 初始化udisplay組件
$ udisplay pattern 16 0x0000 # 繪制pattern顏色為黑色
udisplay 初始化命令:
udisplay_init
CLI命令行輸入:
udisplay pattern 16 0x0000
pattern 是測(cè)試pattern固定字符.
16: ili9341 屏幕為 RGB565
0x0000 RGB565 顏色設(shè)置