更正文檔

概述

LCD (Liquid Crystal Display) 即液晶顯示器。AliOS Things 提供了多款LCD組件供開發者使用，適配了目前應用最多的LCD模塊。 組件支持以下功能：

• LCD 繪制簡單幾何圖形

• LCD 基于 fbdev組件 (frame buffer) 和 udisplay組件，對接更高層的圖形庫如 LVGL 或 SDL

• 支持接入多塊 LCD

版權信息

目錄結構

├── src
│   └── st7789.c                # st7789驅動組件實現
├── include
│   └── st7789.h
├── example
│   └── st7789_example.c        # 測試代碼
├── package.yaml                # 編譯配置文件
└── README.md                   # 組件使用文檔

依賴組件

• base

• vfs

• spi

• gpio

常用配置

typedef struct _st7789_dev_t
{
    int spi_port;       // 屏幕使用的SPI口
    int spi_freq;       // SPI的驅動頻率
    int gpio_dc_id;     // D/C引腳對應開發板的PIN腳
    int gpio_reset_id;  // ResetT引腳對應開發板的PIN腳
    int gpio_bgl_id;    // BackGroundLight引腳對應開發板的PIN腳，對于部分開發板，可以直接接入VCC代表背光常亮

    int spi_fd;
    int gpio_fd;
} st7789_dev_t;

API說明

st7789硬件初始化

int st7789_hw_init(st7789_dev_t *st7789_dev)

st7789硬件去初始化

int st7789_hw_uninit(st7789_dev_t *st7789_dev)

st7789繪畫像素點

void st7789_draw_pixel(st7789_dev_t st7789_dev, uint16_t x, uint16_t y, uint16_t color)

st7789區域繪畫

void st7789_draw_area(st7789_dev_t st7789_dev, uint16_t x, uint16_t y, uint16_t width, uint16_t height, uint8_t *frame)

st7789繪畫矩形

void st7789_draw_rect(st7789_dev_t st7789_dev, uint16_t x, uint16_t y, uint16_t width, uint16_t height, uint16_t color)

st7789全屏填充

void        st7789_draw_frame(st7789_dev_t st7789_dev, uint8_t *frame)

使用示例

組件使用示例相關的代碼下載、編譯和固件燒錄均依賴AliOS Things配套的開發工具，所以首先需要參考《AliOS Things集成開發環境使用說明之搭建開發環境》，下載安裝。 待開發環境搭建完成后，可以按照以下步驟進行示例的測試。

步驟1 創建或打開工程

打開已有工程

如果用于測試的案例工程已存在，可參考《AliOS Things集成開發環境使用說明之打開工程》打開已有工程。

創建新的工程

組件的示例代碼可以通過編譯鏈接到AliOS Things的任意案例（solution）來運行，這里選擇helloworld_demo案例。helloworld_demo案例相關的源代碼下載可參考《AliOS Things集成開發環境使用說明之創建工程》。

步驟2 添加st7789組件

depends:
  - st7789: dev_aos # helloworld_demo中引入st7789組件

步驟3 下載組件

在已安裝了的開發環境工具欄中，選擇Terminal -> New Terminal啟動終端，并且默認工作路徑為當前工程的workspace，此時在終端命令行中輸入：

aos install st7789

上述命令執行成功后，組件源碼則被下載到了./components/drivers/external_device路徑中。

步驟4 添加示例代碼

source_file:
  - "src/*.c"
  - "example/st7789_example.c" # add st7789_example.c

步驟5 編譯固件

在示例代碼已經添加至組件的配置文件，并且helloworld_demo已添加了對該組件的依賴后，就可以編譯helloworld_demo案例來生成固件了，具體編譯方法可參考《AliOS Things集成開發環境使用說明之編譯固件》。

步驟6 燒錄固件

helloworld_demo案例的固件生成后，可參考《AliOS Things集成開發環境使用說明之燒錄固件》來燒錄固件。

步驟7 打開串口

固件燒錄完成后，可以通過串口查看示例的運行結果，打開串口的具體方法可參考《AliOS Things集成開發環境使用說明之查看日志》。

當串口終端打開成功后，可在串口中輸入help來查看已添加的測試命令。

步驟8 st7789示例測試

example_st7789_hw_init
example_st7789_draw_ract

drawing rectangle at 233 55 183 159 in color 1AC1