update lvgl porting guide

Signed-off-by: Zheng Hua <hua.zheng@embeddedboys.com>

Author: IotaHydrae

content/docs/porting/lvgl-port.md

@@ -16,9 +16,11 @@ seo:
 
 ## 写在前面
 
-如果您对LVGL十分感兴趣，我非常建议自己尝试一下移植LVGL，本文将以通俗易懂的方式，向大家介绍LVGL移植的过程，希望读者能在本文的辅助下，独自完成LVGL的移植。在本文的最后部分会向大家介绍有关性能优化的细节。
+如果您对LVGL十分感兴趣，我非常建议自己尝试一下移植LVGL，本文将以通俗易懂的方式，向大家介绍LVGL移植的过程，希望读者能在本文的辅助下，独自完成LVGL的移植。 在本文的最后部分会向大家介绍有关性能优化的细节。
 
-事实上，LVGL的每个大版本，driver部分的接口都有较大的变化，所以我们选择了两个目前最新的release版本讲述移植过程，分别是 `v8.3` 和 `v9`。
+事实上，LVGL的每个大版本，driver部分的接口都有较大的变化，所以我们选择了两个目前最新的release版本讲述移植过程，分别是 `v8.4` 和 `v9`。
+
+**你可以在 `lvgl` 工程源码的 `examples/porting` 文件夹下找到当前版本的移植模板文件**
 
 ## 准备工作
 
@@ -132,6 +134,8 @@ static int ili9488_set_addr_win(struct ili9488_priv *priv, int xs, int ys, int x
 
 发送颜色数据一般跟在 `0x2C` 命令之后，如果你选择局部数据更新，则还应该在这之前设置绘制区域 `0x2A`, `0x2B`。
 
+如下所示的是一个窗口绘制函数，接受一个矩形区域的参数和一个给定长度的像素数据buffer
+
 ```c
 static void ili9488_video_sync(struct ili9488_priv *priv, int xs, int ys, int xe, int ye, void *vmem16, size_t len)
 {
@@ -141,13 +145,213 @@ static void ili9488_video_sync(struct ili9488_priv *priv, int xs, int ys, int xe
 }
 ```
 
+在本工程中，`write_buf_rs` 是一个宏定义，会根据另一个宏`DISP_OVER_PIO`来决定是否通过`PIO`外设模拟I8080协议发送数据
+
+```c
+/* rs=0 means writing register, rs=1 means writing data */
+#if DISP_OVER_PIO
+    #define write_buf_rs(p, b, l, r) i80_write_buf_rs(b, l, r)
+#else
+    #define write_buf_rs(p, b, l, r) fbtft_write_gpio16_wr_rs(p, b, l, r)
+#endif
+```
+
+下面是两个函数的原型，执行的逻辑是先设置RS引脚，再发送给定buffer中的数据到I8080端口。
+
+```c
+static void fbtft_write_gpio16_wr_rs(struct ili9488_priv *priv, void *buf, size_t len, bool rs)
+void i80_write_buf_rs(void *buf, size_t len, bool rs);
+```
+
 #### 全屏刷新
 
-待添加
+如果你需要全屏刷新，则必须先分配一个全屏的buffer，在本工程中，一块全屏buffer的大小为 `307200` 字节，
+这超出了RP2040上的 256KB SRAM 限制，不过在RP2350上，有512KB SRAM，可以使用全屏刷新。
 
-## LVGL 8.3
+在发送完初始化序列后，设置一次绘制区域为整屏大小，然后发送命令`0x2C`，下面是一个示例
 
-待添加
+```
+priv->tftops->set_addr_win(priv, 0, 0,
+                         priv->display->xres - 1,
+                         priv->display->yres - 1);
+```
+
+然后就可以循环发送全屏buffer，驱动IC中的行列指针会根据发送的数据自动移动的复位。
+
+全屏刷新一般用于内部有 LCD 控制器的 MCU 或 MPU，例如在 F1C200s 上，可以将 TCON 设置成I8080模式，
+在初始化TCON之前，先通过GPIO模拟I8080端口，初始化显示屏，然后再初始化 TCON, BE, FE 等，根据framebuffer
+中的数据输出I8080时序，就可以实现 LCD 控制器全屏刷新的效果。
+
+
+## LVGL 8.4
+
+### 显示驱动
+
+可以参考`pico_dm_qd3503728_noos/porting/lv_port_disp_template.c`
+
+#### 1. 分配 LVGL 显示 buffer
+```c
+
+    /* 你可以在这里调用 LCD 的初始化函数 */
+    disp_init();
+
+#ifndef MY_DISP_BUF_SIZE
+    #warning '"MY_DISP_BUF_SIZE" is not defined, defaulting to (HOR_RES * VER_RES / 2)'
+    #define MY_DISP_BUF_SIZE    (MY_DISP_HOR_RES * MY_DISP_VER_RES / 2)
+#endif
+
+    static lv_disp_draw_buf_t draw_buf_dsc_1;
+    static lv_color_t buf_1[MY_DISP_BUF_SIZE];
+
+    /* 调用lvgl接口初始化显示buffer */
+    lv_disp_draw_buf_init(&draw_buf_dsc_1, buf_1, NULL, MY_DISP_BUF_SIZE);
+```
+
+#### 2. 分配、注册 LVGL 显示驱动
+```c
+    static lv_disp_drv_t disp_drv;                         /*Descriptor of a display driver*/
+    lv_disp_drv_init(&disp_drv);                    /*Basic initialization*/
+
+    /* 你的屏幕的宽高分辨率 */
+    disp_drv.hor_res = MY_DISP_HOR_RES;
+    disp_drv.ver_res = MY_DISP_VER_RES;
+
+    /* 这个是需要你实现的显示 buffer 刷新的回调函数 */
+    disp_drv.flush_cb = ili9488_flush;
+
+    /* 将第一步分配的 LVGL 显示 buffer 注册到显示驱动中 */
+    disp_drv.draw_buf = &draw_buf_dsc_1;
+
+    /* 注册显示驱动 */
+    lv_disp_drv_register(&disp_drv);
+```
+
+下面是 `ili9488_flush` 相关函数的实现
+
+```c
+static inline void ili9488_write_cmd(uint16_t cmd)
+{
+    write_buf_rs(&g_priv, &cmd, sizeof(cmd), 0);
+}
+#define write_cmd ili9488_write_cmd
+static inline void ili9488_write_data(uint16_t data)
+{
+    write_buf_rs(&g_priv, &data, sizeof(data), 1);
+}
+#define write_data ili9488_write_data
+
+#include "lvgl/lvgl.h"
+void ili9488_flush(lv_disp_drv_t * disp_drv, const lv_area_t * area, lv_color_t * color_p)
+{
+#if 1
+    write_cmd(0x2A);
+    write_data(area->x1 >> 8);
+    write_data(area->x1);
+    write_data(area->x2 >> 8);
+    write_data(area->x2);
+
+    /* set row address */
+    write_cmd(0x2B);
+    write_data(area->y1 >> 8);
+    write_data(area->y1);
+    write_data(area->y2 >> 8);
+    write_data(area->y2);
+
+    /* write start */
+    write_cmd(0x2C);
+    write_buf_rs(&g_priv, (void *)color_p, lv_area_get_size(area) * 2, 1);
+#else
+    struct ili9488_priv *priv = &g_priv;
+    priv->tftops->set_addr_win(priv, area->x1, area->y1, area->x2, area->y2);
+    write_buf_rs(priv, (void *)px_map, lv_area_get_size(area) * 2, 1);
+#endif
+    lv_disp_flush_ready(disp_drv);
+}
+```
+
+### 输入驱动
+
+可以参考`pico_dm_qd3503728_noos/porting/lv_port_indev_template.c`
+
+#### 1. 分配、注册 LVGL Touchpad 驱动
+
+```c
+    static lv_indev_drv_t indev_drv;
+
+    /*------------------
+     * Touchpad
+     * -----------------*/
+
+    /* 你可以在这里初始化你的触摸屏 */
+    touchpad_init();
+
+    /* 初始化 LVGL 触摸屏驱动 */
+    lv_indev_drv_init(&indev_drv);
+
+    /* 设置驱动类型为点类型 */
+    indev_drv.type = LV_INDEV_TYPE_POINTER;
+
+    /* 设置触摸屏驱动的读取回调函数，这个需要你自己实现 */
+    indev_drv.read_cb = touchpad_read;
+
+    /* 注册触摸屏驱动 */
+    indev_touchpad = lv_indev_drv_register(&indev_drv);
+```
+
+下面是 `touchpad_read` 相关函数的实现
+
+```c
+static void touchpad_read(lv_indev_drv_t * indev_drv, lv_indev_data_t * data)
+{
+    static lv_coord_t last_x = 0;
+    static lv_coord_t last_y = 0;
+
+    /*Save the pressed coordinates and the state*/
+    if(touchpad_is_pressed()) {
+        touchpad_get_xy(&last_x, &last_y);
+        // printf("touchpad is pressed, x: %d, y: %d\n", last_x, last_y);
+        data->state = LV_INDEV_STATE_PR;
+    }
+    else {
+        data->state = LV_INDEV_STATE_REL;
+    }
+
+    /*Set the last pressed coordinates*/
+    data->point.x = last_x;
+    data->point.y = last_y;
+}
+
+static bool touchpad_is_pressed(void)
+{
+    /*Your code comes here*/
+    return ft6236_is_pressed();
+    // return false;
+}
+
+static void touchpad_get_xy(lv_coord_t * x, lv_coord_t * y)
+{
+    /*Your code comes here*/
+    (*x) = ft6236_read_x();
+    (*y) = ft6236_read_y();
+}
+```
+
+### Tick 驱动
+
+v8.4 版本的 LVGL 允许在 lv_conf.h 中设置 tick 回调函数
+
+```c
+#define LV_TICK_CUSTOM 1
+#if LV_TICK_CUSTOM
+    #define LV_TICK_CUSTOM_INCLUDE "pico/time.h"         /*Header for the system time function*/
+    #define LV_TICK_CUSTOM_SYS_TIME_EXPR (time_us_32() / 1000LL)    /*Expression evaluating to current system time in ms*/
+    /*If using lvgl as ESP32 component*/
+    // #define LV_TICK_CUSTOM_INCLUDE "esp_timer.h"
+    // #define LV_TICK_CUSTOM_SYS_TIME_EXPR ((esp_timer_get_time() / 1000LL))
+#endif   /*LV_TICK_CUSTOM*/
+```
+
+`time_us_32()` 是 Pico SDK 中的一个函数，用于获取系统启动后经过的时间，单位为微秒，因为 LVGL 的tick以毫秒为单位，所以需要除1000
 
 ## LVGL 9
 

hugo_stats.json

@@ -11,7 +11,6 @@
       "code",
       "details",
       "div",
-      "em",
       "figcaption",
       "figure",
       "footer",
@@ -297,6 +296,8 @@
     "ids": [
       "1-修改-mpy工程的-micropy_gc_heap_size从预分配改为根据使用情况在ld文件中确定",
       "1-修改lv_confh配置文件将-lv_color_depth-hardcode-为-16虽然可以在cmakeliststxt中添加宏但是目前我们没这样做",
+      "1-分配-lvgl-显示-buffer",
+      "1-复位显示模组",
       "1-安装前置依赖",
       "1-官方版本",
       "1-拉取工程并更新子模块",
@@ -305,19 +306,22 @@
       "2-使用thonny或micropico上传库文件",
       "2-关闭-portsrp2makefile-中的cmake-cache机制",
       "2-准备-esp-idf-环境",
+      "2-分配注册-lvgl-显示驱动",
       "2-合宙-pico-核心板",
+      "2-向显示模组写入初始化序列",
       "2-在-driverrp2-下创建一个名为-pio-的目录其中放置-pio-相关的驱动例如-pio_i80这些文件都是从-c-工程中直接拿过来的跟micropython工程没有关系所以不作说明",
       "21-boardcmake",
       "22-ft6236c",
       "3-修改-portsrp2cmakeliststxt-引入我们需要的宏及文件",
       "3-在-driverrp2-下创建板级目录-pico_dm_qd3503728目录文件如下",
       "3-拉取-pico-sdk-子仓库代码",
+      "3-设置绘制区域",
       "3-运行测试",
       "3-配置并编译烧录",
+      "4-发送颜色数据",
       "4-提供一个build脚本用来编译固件",
       "8080屏模板工程",
       "TableOfContents",
-      "a",
       "arduino",
       "awtk",
       "buildroot",
@@ -341,7 +345,6 @@
       "fzf",
       "h-rh-i-0",
       "hagl",
-      "heading",
       "lcd-相关",
       "linux",
       "luckfox-lyra-plus",
@@ -403,6 +406,7 @@
       "tabs-install-sdk-requirements-0-tab",
       "tabs-install-sdk-requirements-1",
       "tabs-install-sdk-requirements-1-tab",
+      "tick-驱动",
       "toc",
       "ubuntu",
       "uf2",
@@ -416,6 +420,7 @@
       "为什么我的-pico-无法启动",
       "产品参数",
       "从我们的服务器下载",
+      "全屏刷新",
       "写在前面",
       "准备工作",
       "合理超频",
@@ -428,6 +433,7 @@
       "官方版本国产版1",
       "官方版本国产版2",
       "家庭智能中控",
+      "局部刷新",
       "引脚定义",
       "性能优化",
       "我在使用git拉取github工程时出现如下错误",
@@ -471,6 +477,7 @@
       "说明",
       "调整dvdd电压",
       "超频预设",
+      "输入驱动",
       "适用于rp2040的",
       "选择显示驱动",
       "选择触摸驱动",