簡(jiǎn)介一套可直接在STM32F103上運(yùn)行的SPI接口LVGL屏幕移植程序面向有嵌入式基礎(chǔ)的GUI開(kāi)發(fā)者和需要快速搭建人機(jī)界面的單片機(jī)工程師。內(nèi)容覆蓋從SPI外設(shè)寄存器配置、常見(jiàn)屏幕驅(qū)動(dòng)適配到LVGL庫(kù)移植、幀緩沖管理與控件事件響應(yīng)的完整鏈路自寫(xiě)代碼可實(shí)際運(yùn)行便于學(xué)習(xí)或二次開(kāi)發(fā)。壓縮包共761個(gè)文件約3.77MB以C/H源碼、工程配置、編譯中間文件為主另有圖片素材、腳本與說(shuō)明文檔目錄結(jié)構(gòu)清晰可直接對(duì)照閱讀。已有4222人學(xué)習(xí)下載適合希望理解MCU驅(qū)動(dòng)大屏顯示原理或想少走彎路完成STM32F103LVGL界面落地的開(kāi)發(fā)者。1. 一塊SPI屏和一個(gè)GUI庫(kù)為什么這個(gè)組合值得認(rèn)真對(duì)待在嵌入式產(chǎn)品里“能顯示”和“顯示得好”之間隔著一條很深的溝。很多開(kāi)發(fā)者拿到一塊SPI接口的TFT彩屏和一套LVGL源碼以為點(diǎn)亮屏幕就能把界面跑起來(lái)結(jié)果折騰兩周還停在白屏或者花屏上。這里的問(wèn)題不在于LVGL本身難而在于底層移植鏈路太長(zhǎng)SPI時(shí)序、屏幕控制器初始化、顯存策略、LVGL的刷新鉤子每一環(huán)都可能把整體拖垮。這篇筆記圍繞“STM32F103 SPI屏幕 LVGL自寫(xiě)移植可用”這個(gè)組合把驅(qū)動(dòng)到GUI的完整路徑拆開(kāi)講適合正在做小型儀表盤(pán)、家用設(shè)備交互界面、低成本彩屏應(yīng)用的開(kāi)發(fā)者。結(jié)論先行F103跑LVGL完全可行前提是你愿意在幀率、緩存和控件復(fù)雜度上做正確取舍。2. 先看清楚整條鏈路從SPI物理層到LVGL渲染管線的三段式結(jié)構(gòu)2.1 三段分離驅(qū)動(dòng)層、適配層和GUI層各自要解決什么移植LVGL到F103SPI屏本質(zhì)上是在驅(qū)動(dòng)層Dri→ 適配層Port→ GUI層這三段之間建立一條高效的通道。驅(qū)動(dòng)層負(fù)責(zé)把像素字節(jié)按時(shí)序?qū)懙狡聊豢刂破骼镞m配層負(fù)責(zé)告訴LVGL“我的顯存長(zhǎng)什么樣、怎么刷、多久刷一次”GUI層則是你真正寫(xiě)界面代碼的地方。很多移植失敗的案例問(wèn)題都出在把三段混在一起調(diào)LVGL初始化失敗先懷疑屏幕驅(qū)動(dòng)屏幕出現(xiàn)撕裂又去改GUI邏輯。實(shí)際上這三段可以獨(dú)立驗(yàn)證順序是先讓驅(qū)動(dòng)層單獨(dú)能畫(huà)純色再讓適配層能通過(guò)LVGL的回調(diào)刷出一張簡(jiǎn)單的單色圖最后才進(jìn)入控件和動(dòng)畫(huà)階段。在F103上SPI外設(shè)的時(shí)鐘配置需要格外注意。我一般把SPI1掛在APB2總線上時(shí)鐘配置為18MHz分頻到9MHz或者4.5MHz這取決于屏幕控制器的極限速率和你的PCB走線質(zhì)量。超過(guò)10MHz的SPI時(shí)鐘在杜邦線連接下很容易出現(xiàn)數(shù)據(jù)錯(cuò)位表現(xiàn)為屏幕顏色錯(cuò)亂或者局部花屏這不是代碼問(wèn)題是物理鏈路問(wèn)題。一個(gè)常見(jiàn)的誤區(qū)是盲目追求滿速SPI。ST7789這類控制器雖然標(biāo)稱支持幾十MHz但F103的SPI外設(shè)本身要處理DMA請(qǐng)求和FIFO加上中斷延遲實(shí)際穩(wěn)定吞吐率在6-9MHz已經(jīng)足夠。LVGL的幀率瓶頸往往不在SPI速度而在F103的Cortex-M3內(nèi)核跑圖形運(yùn)算的速度。2.2 屏幕控制器差異ST7789、ILI9341與ST7735的選型權(quán)衡在這個(gè)標(biāo)題組合里屏幕控制器基本逃不開(kāi)三款ST7789、ILI9341和ST7735。它們都是SPI接口的TFT控制芯片但初始化序列、顯存組織方式和色彩格式支持有細(xì)微差別這會(huì)直接影響你接下來(lái)的移植代碼怎么寫(xiě)。ST7789是目前小尺寸圓屏和方屏里最常見(jiàn)的初始化序列短支持RGB565和RGB666顯存是240x320或者240x280F103驅(qū)動(dòng)起來(lái)壓力不大適合做2.0寸以下的產(chǎn)品界面。ILI9341是經(jīng)典大屏控制器初始化序列長(zhǎng)但文檔豐富支持240x320SPI讀取功能完整適合需要讀回屏幕內(nèi)容的場(chǎng)景但代價(jià)是初始化代碼占Flash較多。ST7735是老一代小屏控制器色彩偏淡初始化時(shí)序?qū)呃偷捻樞蛎舾行马?xiàng)目建議直接避開(kāi)。這三款控制器的代碼不能直接通用但移植成本差異不大每個(gè)控制器的初始化序列本質(zhì)是一串寄存器寫(xiě)入操作你只要把序列換成目標(biāo)控制器對(duì)應(yīng)的值再微調(diào)像素格式設(shè)置即可。這不叫從零移植叫換控制器適配。真正決定工作量的不是控制器型號(hào)而是你的屏幕分辨率、排線和F103的Flash/RAM余量。2.3 顯存策略全緩存、行緩存與分塊緩存的取舍LVGL渲染需要一個(gè)中間緩沖這直接決定了F103的RAM夠不夠用。F103系列里C8有20KB RAMRCT6有48KB RAMZET6有64KB RAM。而一個(gè)240x320的RGB565全屏緩存是240x320x2字節(jié)約150KB——沒(méi)有任何一款F103能裝下。所以必須用局部緩存。LVGL 8.x的配置里L(fēng)V_MEM_SIZE是LVGL內(nèi)部動(dòng)態(tài)內(nèi)存池而lv_disp_draw_buf_t是渲染緩沖區(qū)這兩個(gè)概念經(jīng)常被混為一談。實(shí)際工程中我的做法是給lv_disp_draw_buf_t分配兩個(gè)緩沖區(qū)每個(gè)大小取屏幕寬度的十分之一行數(shù)也就是一行的1/10約24行240x24x211520字節(jié)約11KB。兩個(gè)緩沖即22KB在RCT6上占不到一半RAM剩余空間留給LVGL對(duì)象和你的業(yè)務(wù)變量。一幀的刷新次數(shù)和緩沖區(qū)大小成反比緩沖區(qū)越小刷新次數(shù)越多撕裂概率越高但內(nèi)存占用越低。F103上經(jīng)典的折中方案是240x24x2的x2雙緩沖。如果你用的是ZET6可以放寬到240x40x2的x2流暢度會(huì)有可感知的提升。而全緩存方案只在內(nèi)存大于150KB的平臺(tái)上才成立F103不要想。3. 先把屏幕點(diǎn)亮用最少代碼驗(yàn)證SPI和控制器初始化3.1 一個(gè)最小可用的SPI驅(qū)動(dòng)模板與其參數(shù)解釋在碰LVGL之前先把屏幕點(diǎn)亮并保持純色穩(wěn)定輸出。這是整條移植鏈的“冒煙測(cè)試”如果你連純色都刷不出來(lái)就不要繼續(xù)往下走。以下是我常用的一套最小SPI初始化模板面向ST77894線SPI模式// spi_screen_init.h 片段基于STM32標(biāo)準(zhǔn)外設(shè)庫(kù) void SPI_Screen_Init(void) { GPIO_InitTypeDef GPIO_InitStructure; SPI_InitTypeDef SPI_InitStructure; // 使能SPI1和對(duì)應(yīng)GPIO的時(shí)鐘SPI1在APB2上 RCC_APB2PeriphClockCmd(RCC_APB2Periph_SPI1 | RCC_APB2Periph_GPIOA, ENABLE); // SCKPA5, MOSIPA7, CSPA4, DCPA2, RSTPA3 GPIO_InitStructure.GPIO_Pin GPIO_Pin_5 | GPIO_Pin_7; GPIO_InitStructure.GPIO_Mode GPIO_Mode_AF_PP; GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; GPIO_Init(GPIOA, GPIO_InitStructure); GPIO_InitStructure.GPIO_Pin GPIO_Pin_4 | GPIO_Pin_2 | GPIO_Pin_3; GPIO_InitStructure.GPIO_Mode GPIO_Mode_Out_PP; GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; GPIO_Init(GPIOA, GPIO_InitStructure); SPI_InitStructure.SPI_Direction SPI_Direction_2Lines_FullDuplex; SPI_InitStructure.SPI_Mode SPI_Mode_Master; SPI_InitStructure.SPI_DataSize SPI_DataSize_8b; SPI_InitStructure.SPI_CPOL SPI_CPOL_High; // SPI模式0CPOL1, CPHA1 SPI_InitStructure.SPI_CPHA SPI_CPHA_2Edge; SPI_InitStructure.SPI_NSS SPI_NSS_Soft; SPI_InitStructure.SPI_BaudRatePrescaler SPI_BaudRatePrescaler_8; // 72MHz / 8 9MHz SPI_InitStructure.SPI_FirstBit SPI_FirstBit_MSB; SPI_Init(SPI1, SPI_InitStructure); SPI_Cmd(SPI1, ENABLE); }這個(gè)初始化塊的關(guān)鍵點(diǎn)有兩個(gè)。一是SPI模式必須和屏幕控制器匹配ST7789和ILI9341都支持SPI Mode 0CPOL0, CPHA1和Mode 3CPOL1, CPHA2但不同廠家模組默認(rèn)接法可能不同。如果你在純色測(cè)試階段發(fā)現(xiàn)顏色錯(cuò)亂但畫(huà)面完整先試著翻轉(zhuǎn)CPOL和CPHA不要改接線。二是波特率預(yù)分頻選8是因?yàn)镾TM32F103的APB2最高72MHz分頻后9MHz落在穩(wěn)定區(qū)間。如果你用杜邦線連接且線長(zhǎng)超過(guò)10cm建議降到16分頻即4.5MHz。3.2 初始化序列之外的兩個(gè)驗(yàn)證方法純色刷屏和像素點(diǎn)掃描屏幕控制器的初始化序列會(huì)很長(zhǎng)這里不逐行粘貼。但有兩種驗(yàn)證方法能快速判斷初始化序列是否正確比看白屏瞎猜高效得多。第一種是刷純色。初始化完成后向整個(gè)顯存區(qū)域?qū)懭?xFF白色和0x00黑色用肉眼觀察屏幕亮度是否變化。如果黑屏完全沒(méi)有變化大概率是背光引腳沒(méi)拉高、RST引腳時(shí)序不對(duì)或者初始化序列根本沒(méi)執(zhí)行到。如果屏幕顯示雪花噪點(diǎn)或條形干擾則多半是SPI時(shí)鐘極性/相位配錯(cuò)或者M(jìn)ISO/MOSI接反。第二種是像素點(diǎn)掃描。用一個(gè)雙層循環(huán)向屏幕的每個(gè)像素坐標(biāo)寫(xiě)入一個(gè)顏色漸變值坐標(biāo)到顏色的映射關(guān)系寫(xiě)成一個(gè)固定公式比如color (x * 5) 8 | (y * 3)。掃描完成后屏幕上應(yīng)該出現(xiàn)一個(gè)從左上到右下連續(xù)漸變的矩形。如果漸變方向反了說(shuō)明你的列地址和行地址映射關(guān)系寫(xiě)反如果漸變出現(xiàn)斷層說(shuō)明你寫(xiě)入的坐標(biāo)超出了屏幕的顯存范圍。這兩個(gè)方法總共需要不到100行代碼卻能篩掉后面LVGL移植中80%的玄學(xué)問(wèn)題。我見(jiàn)過(guò)太多開(kāi)發(fā)者跳過(guò)這一步直接上LVGL結(jié)果白屏后只能靠猜到底是SPI問(wèn)題還是LVGL問(wèn)題一顆幾十元的屏幕先花一小時(shí)做冒煙測(cè)試后續(xù)能省兩周的排查時(shí)間。4. 把LVGL跑起來(lái)裁剪配置、回調(diào)注冊(cè)與心跳機(jī)制4.1 lv_conf.h 里必須改的7個(gè)配置項(xiàng)LVGL下載下來(lái)后第一步不是寫(xiě)代碼而是裁剪lv_conf.h。F103的資源有限默認(rèn)配置是面向開(kāi)發(fā)板的寬松設(shè)置直接編譯會(huì)超出Flash和RAM。以下7個(gè)配置項(xiàng)是必須手動(dòng)確認(rèn)的每一項(xiàng)都直接關(guān)系能否在F103上跑起來(lái)。// lv_conf.h 關(guān)鍵裁剪項(xiàng)LVGL 8.x #define LV_COLOR_DEPTH 16 // RGB565最省內(nèi)存的色彩格式 #define LV_MEM_SIZE (32U * 1024U) // LVGL內(nèi)部動(dòng)態(tài)內(nèi)存池RCT6可用32KB #define LV_DISP_DEF_REFR_PERIOD 30 // 刷新周期30ms約33fps #define LV_DPI_DEF 80 // DPI定義影響控件物理尺寸縮放 #define LV_FONT_MONTSERRAT_14 1 // 只保留14號(hào)默認(rèn)字體 #define LV_USE_LABEL 1 // 標(biāo)簽控件開(kāi)啟 #define LV_USE_BTN 1 // 按鈕控件開(kāi)啟 // LV_USE_CHART、LV_USE_TABLE、LV_USE_CANVAS 等重型控件保持0LV_COLOR_DEPTH設(shè)為16是硬件層面的決定你的屏幕控制器接收RGB565格式F103的幀緩沖也按RGB565計(jì)算可以做到一次像素搬運(yùn)不做格式轉(zhuǎn)換。如果設(shè)為32每個(gè)像素多占一倍緩沖刷新速度反而下降。LV_MEM_SIZE是LVGL內(nèi)部malloc的內(nèi)存池大小這個(gè)值不是越大越好。F103 RCT6的48KB RAM里你還要留一部分給兩個(gè)幀緩沖一部分給業(yè)務(wù)代碼的局部變量。我實(shí)測(cè)32KB夠跑一個(gè)標(biāo)簽按鈕進(jìn)度條的界面如果后續(xù)界面復(fù)雜度上來(lái)先調(diào)這個(gè)值再考慮是否增加外部SRAM。LV_DISP_DEF_REFR_PERIOD是LVGL的心跳刷新周期。LVGL不是實(shí)時(shí)重繪而是每過(guò)這個(gè)周期主動(dòng)檢查一次是否需要重繪。30ms是F103能穩(wěn)定處理的刷新節(jié)奏如果界面有快速動(dòng)畫(huà)調(diào)到20ms也能跑但CPU占用會(huì)明顯上升。4.2 三個(gè)回調(diào)函數(shù)flush、hres/vres與tick的注冊(cè)順序LVGL跑起來(lái)需要三個(gè)底層鉤子顯示刷新回調(diào)disp_flush、分辨率描述hor_res和ver_res以及系統(tǒng)心跳tick_get。這三個(gè)鉤子的注冊(cè)順序很重要順序錯(cuò)了會(huì)出現(xiàn)“能編譯但屏幕不刷新”的怪現(xiàn)象。// LVGL顯示驅(qū)動(dòng)初始化模板 void LVGL_Port_Init(void) { static lv_disp_draw_buf_t draw_buf; static lv_color_t buf_1[240 * 24]; static lv_color_t buf_2[240 * 24]; lv_init(); lv_disp_draw_buf_init(draw_buf, buf_1, buf_2, 240 * 24); // 先初始化draw_buf再初始化display driver順序不能顛倒 static lv_disp_drv_t disp_drv; lv_disp_drv_init(disp_drv); disp_drv.hor_res 240; disp_drv.ver_res 320; disp_drv.flush_cb my_disp_flush; disp_drv.draw_buf draw_buf; lv_disp_drv_register(disp_drv); lv_tick_set_cb(my_tick_get); }hor_res和ver_res必須和屏幕控制器的實(shí)際分辨率一致不能填屏幕模組的物理對(duì)角線尺寸。比如你的屏幕物理尺寸是2.0寸但分辨率是240x320這里就必須填240和320。如果填錯(cuò)LVGL的坐標(biāo)系統(tǒng)會(huì)錯(cuò)亂控件排列和觸摸映射全部偏移。lv_tick_set_cb用于注冊(cè)系統(tǒng)心跳。正常情況下F103的SysTick中斷里要調(diào)用lv_tick_inc(1)或者提供一個(gè)返回毫秒數(shù)的鉤子函數(shù)。抖動(dòng)的心跳會(huì)導(dǎo)致動(dòng)畫(huà)忽快忽慢這在F103上很隱蔽如果你發(fā)現(xiàn)按鈕按下去動(dòng)畫(huà)正常但進(jìn)度條走得有時(shí)快有時(shí)慢先查時(shí)鐘源再查L(zhǎng)VGL的代碼。my_disp_flush是核心回調(diào)它負(fù)責(zé)把一個(gè)矩形區(qū)域的像素?cái)?shù)據(jù)真正寫(xiě)到屏幕上。這個(gè)回調(diào)會(huì)在LVGL渲染完一個(gè)局部區(qū)域后被調(diào)用參數(shù)包括左上角坐標(biāo)、右下角坐標(biāo)和像素?cái)?shù)據(jù)指針?；卣{(diào)里要做的三件事設(shè)置屏幕的窗口區(qū)域、逐個(gè)像素寫(xiě)入、最后調(diào)用lv_disp_flush_ready通知LVGL緩沖區(qū)已釋放。這后面兩個(gè)步驟缺一不可只有flush_ready被調(diào)用LVGL才會(huì)繼續(xù)用這塊緩沖區(qū)渲染下一塊區(qū)域。4.3 一個(gè)能跑通的標(biāo)準(zhǔn)flush回調(diào)實(shí)現(xiàn)把flush回調(diào)寫(xiě)得又快又穩(wěn)是F103上LVGL性能的關(guān)鍵。以下是一個(gè)經(jīng)過(guò)實(shí)測(cè)的模板直接用SPI DMA搬運(yùn)像素?cái)?shù)據(jù)。// my_disp_flush 典型實(shí)現(xiàn) void my_disp_flush(lv_disp_drv_t *disp_drv, const lv_area_t *area, lv_color_t *color_p) { // 設(shè)置屏幕窗口區(qū)域讓控制器知道數(shù)據(jù)從哪個(gè)坐標(biāo)開(kāi)始寫(xiě) ST7789_SetWindow(area-x1, area-y1, area-x2, area-y2); // 像素?cái)?shù)據(jù)按行連續(xù)搬運(yùn)利用SPI DMA減少CPU占用 uint32_t pixel_count (area-x2 - area-x1 1) * (area-y2 - area-y1 1); uint32_t byte_count pixel_count * 2; // RGB565 每像素2字節(jié) ST7789_WriteDataDMA((uint8_t *)color_p, byte_count); // 必須調(diào)用flush_ready否則LVGL會(huì)一直等待緩沖區(qū)釋放 lv_disp_flush_ready(disp_drv); }這里的ST7789_SetWindow是對(duì)控制器指令CASET和RASET的封裝它告訴屏幕“接下來(lái)要寫(xiě)哪個(gè)矩形區(qū)域”。如果你的屏幕控制器是ILI9341只是寄存器地址不同函數(shù)內(nèi)部換成對(duì)應(yīng)指令即可。ST7789_WriteDataDMA內(nèi)部使用SPI1的DMA通道使能DMA傳輸后不等傳輸完成就直接返回。這里有一個(gè)微妙的點(diǎn)如果DMA還在搬運(yùn)數(shù)據(jù)lv_disp_flush_ready就開(kāi)始通知LVGL緩沖區(qū)可用新一幀的渲染可能會(huì)覆蓋尚在DMA傳輸中的數(shù)據(jù)。解決方式是在DMA傳輸完成中斷里調(diào)用lv_disp_flush_ready而不是在發(fā)起DMA后立即調(diào)用。這一點(diǎn)如果沒(méi)處理好會(huì)出現(xiàn)畫(huà)面隨機(jī)撕裂而且很難復(fù)現(xiàn)。color_p指針指向的是LVGL內(nèi)部的渲染緩沖不是你的顯存。所以不要在flush回調(diào)里試圖“保存”這份數(shù)據(jù)它的生命周期只持續(xù)到flush_ready被調(diào)用之前。5. 移植過(guò)程中的五個(gè)高頻坑現(xiàn)象、原因和解決辦法5.2 坑一白屏但背光亮初始化序列跑完沒(méi)反應(yīng)現(xiàn)象是屏幕背光正常點(diǎn)亮但屏幕一直白色沒(méi)有任何顯示即使刷純色也沒(méi)有反應(yīng)。這個(gè)坑最容易讓人懷疑LVGL實(shí)際上問(wèn)題幾乎都在底層。原因排查下來(lái)有三種常見(jiàn)情況RST引腳時(shí)序不對(duì)屏幕控制器一直處于復(fù)位狀態(tài)DC引腳電平不對(duì)數(shù)據(jù)/命令模式錯(cuò)亂導(dǎo)致初始化指令被當(dāng)成像素?cái)?shù)據(jù)寫(xiě)入供電不足F103的3.3V引腳帶不動(dòng)屏幕模組內(nèi)部的升壓電路。解決方法是逐一確認(rèn)RST引腳先拉低至少10ms再拉高等待120ms讓控制器完成上電復(fù)位用示波器或萬(wàn)用表量DC引腳在初始化期間的電平是否在切換給屏幕模組單獨(dú)接一個(gè)100uF電解電容和0.1uF陶瓷電容分別放在模組電源引腳附近。這三級(jí)排查做完99%的白屏都能解決。5.3 坑二畫(huà)面出現(xiàn)水平撕裂紋刷新越快越明顯現(xiàn)象是屏幕在刷新動(dòng)畫(huà)時(shí)出現(xiàn)明顯的水平分割線上半屏和下半屏的內(nèi)容不在同一幀時(shí)刻。這在低端屏上非常常見(jiàn)但在F103上往往是FPU和DMA的配合問(wèn)題。原因在于LVGL的flush回調(diào)發(fā)起了DMA傳輸?shù)玣lush_ready被過(guò)早調(diào)用。DMA還在搬運(yùn)上半屏的數(shù)據(jù)時(shí)下半屏已經(jīng)在被渲染和寫(xiě)入。解決方法是把lv_disp_flush_ready從flush回調(diào)的直接調(diào)用處移到DMA傳輸完成中斷里確保一幀數(shù)據(jù)完全送出后才通知LVGL重新使用緩沖區(qū)。這類問(wèn)題用軟件難以徹底消除但可以大幅降低發(fā)生率。另一個(gè)有效的輔助手段是打開(kāi)LVGL的LV_DISP_DEF_REFR_PERIOD到40ms人為降低刷新頻率給DMA留出足夠時(shí)間。5.4 坑三觸摸坐標(biāo)和顯示畫(huà)面錯(cuò)位偏移量固定現(xiàn)象是界面上的按鈕顯示在A位置但通過(guò)觸摸屏點(diǎn)擊時(shí)必須點(diǎn)擊B位置才能觸發(fā)。這個(gè)坑出現(xiàn)在帶觸摸功能的屏幕模組上SPI屏幕和觸摸控制器是兩個(gè)獨(dú)立器件坐標(biāo)系統(tǒng)天然不同。原因是觸摸控制器的X/Y坐標(biāo)方向和屏幕控制器的掃描方向不一致。很多模組的觸摸面板和顯示面板在物理上呈90度旋轉(zhuǎn)你的LVGL坐標(biāo)以屏幕左上角為原點(diǎn)但觸摸控制器上報(bào)的坐標(biāo)以觸摸面板的物理原點(diǎn)為準(zhǔn)。解決方法是在觸摸回調(diào)里做坐標(biāo)轉(zhuǎn)換常見(jiàn)做法是交換X/Y并把對(duì)應(yīng)方向取反。比如屏幕240x320、觸摸面板320x240時(shí)轉(zhuǎn)換邏輯為lv_x touch_ylv_y 319 - touch_x。具體數(shù)值取決你的模組出廠方向所以不要在代碼里寫(xiě)死先用一個(gè)簡(jiǎn)單的測(cè)試界面打印原始觸摸坐標(biāo)再確定轉(zhuǎn)換公式。5.5 坑四LVGL編譯通過(guò)但運(yùn)行后進(jìn)入HardFault現(xiàn)象是程序燒錄后屏幕不亮調(diào)試器顯示停在HardFault中斷卡死在memcpy或者memset相關(guān)函數(shù)。原因通常是LV_MEM_SIZE配置過(guò)大超過(guò)了F103的RAM余量。F103 RC系列只有20KB RAM如果你把LV_MEM_SIZE配成40KB再加上兩個(gè)幀緩沖各11KBRAM直接爆掉棧指針指向非法地址后觸發(fā)HardFault。解決方法是第一步裁剪LV_MEM_SIZE降到24KB幀緩沖從240*24降到240*16先確認(rèn)能跑通再逐一加大回原來(lái)的水平。第二步要看map文件確認(rèn)內(nèi)存分布編譯生成的.map文件里能查到堆、棧和全局變量的地址范圍只要這些區(qū)域重疊必定HardFault。5.6 坑五長(zhǎng)時(shí)間運(yùn)行后內(nèi)存耗盡界面卡死現(xiàn)象是界面運(yùn)行幾分鐘后開(kāi)始卡頓最終完全無(wú)響應(yīng)重啟后恢復(fù)正常。這個(gè)坑在LVGL 8.x里很典型。原因是LVGL對(duì)象創(chuàng)建后沒(méi)有釋放。每次點(diǎn)擊按鈕動(dòng)態(tài)創(chuàng)建標(biāo)簽或圖片卻沒(méi)有在合適時(shí)機(jī)調(diào)用lv_obj_del導(dǎo)致LVGL內(nèi)部的內(nèi)存池一點(diǎn)點(diǎn)耗盡。F103的LV_MEM_SIZE只有32KB一個(gè)標(biāo)簽對(duì)象約占用200-300字節(jié)看似不多但如果界面每秒創(chuàng)建3個(gè)對(duì)象并持續(xù)運(yùn)行幾分鐘內(nèi)存池必然見(jiàn)底。解決方法是建立對(duì)象復(fù)用機(jī)制在界面初始化時(shí)一次性創(chuàng)建好所有可能用到的控件后續(xù)只是修改它們的文字、位置和顏色不要頻繁創(chuàng)建和刪除。另一種做法是在創(chuàng)建新對(duì)象前檢查內(nèi)存池余量用lv_mem_monitor打印剩余空間低于閾值時(shí)主動(dòng)刪除不可見(jiàn)對(duì)象。6. 從能顯示到看得順用局部刷新和控件精簡(jiǎn)榨干F103的最后性能當(dāng)你的LVGL界面能穩(wěn)定運(yùn)行下一步是讓它“看得順眼”。這里有一個(gè)具體技巧把LVGL的“全區(qū)域重繪”思維改成“局部區(qū)域重繪”思維。LVGL默認(rèn)會(huì)合并同一幀內(nèi)的多個(gè)臟區(qū)域但如果你有一個(gè)實(shí)時(shí)更新的數(shù)據(jù)面板比如溫濕度數(shù)字這個(gè)面板每秒鐘變一次而周圍的背景圖標(biāo)和標(biāo)題都不會(huì)變那么你不應(yīng)該讓LVGL把整個(gè)屏幕都重畫(huà)一遍。實(shí)現(xiàn)方式是利用LVGL的lv_obj_invalidate方法只讓數(shù)據(jù)面板所在的對(duì)象標(biāo)記為“需要重繪”并把對(duì)象的opa_scale_en和paddings設(shè)到最小。這個(gè)操作能顯著縮短每幀的渲染面積F103上實(shí)測(cè)全屏重繪需要約45ms而局部重繪一個(gè)120x60的數(shù)字面板只需要約8ms這是一個(gè)數(shù)量級(jí)的差距。另一個(gè)技巧是精簡(jiǎn)字體加載。F103的Flash只有128KB或256KB完整的中文字庫(kù)動(dòng)輒幾百KB根本放不下。正確的做法是只加載你界面里實(shí)際出現(xiàn)的漢字剩下的用圖片或者ASCII替代。LVGL 8.x支持字形子集裁剪你可以把界面里所有中文字符匯總成一個(gè)字符串用官方工具生成一個(gè)自定義字體文件體積可以控制在20KB以內(nèi)這在F103上是非常寶貴的空間。再來(lái)說(shuō)說(shuō)控件精簡(jiǎn)。F103的CPU頻率只有72MHz沒(méi)有FPUCortex-M3的整數(shù)運(yùn)算能力也有限。LVGL的陰影、圓角、漸變和透明效果都會(huì)消耗大量運(yùn)算一個(gè)帶圓角的進(jìn)度條在F103上重繪一次的耗時(shí)是不帶圓角的三到五倍。所以我的習(xí)慣是背景用純色按鈕用平面樣式進(jìn)度條不做漸變動(dòng)畫(huà)字體只用14號(hào)一個(gè)尺寸。畫(huà)面上沒(méi)有“酷炫”但有穩(wěn)定的幀率和實(shí)時(shí)的響應(yīng)。我最初在一款基于F103的低成本設(shè)備上做界面時(shí)也是什么都想加結(jié)果幀率掉到個(gè)位數(shù)。后來(lái)咬著牙把界面砍到只剩狀態(tài)欄、一個(gè)動(dòng)態(tài)數(shù)值和一個(gè)開(kāi)關(guān)按鈕功耗和流暢度都達(dá)到量產(chǎn)要求。這個(gè)取舍不只在F103上適用任何低算力MCU跑GUI都是這個(gè)邏輯先保幀率再談效果。最后留一個(gè)調(diào)試習(xí)慣第一次跑LVGL界面時(shí)打開(kāi)LV_USE_LOG并把日志等級(jí)設(shè)為L(zhǎng)V_LOG_LEVEL_WARN這一段代碼會(huì)在串口輸出LVGL內(nèi)部的內(nèi)存警告和刷新警告很多玄學(xué)的卡頓和內(nèi)存問(wèn)題都能從這里直接看到蛛絲馬跡。希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取