mohliy e2ff1a23ba 初始版本 4 月之前
..
LVGL.lvgl.8.3.11.pack e2ff1a23ba 初始版本 4 月之前
LVGL.lvgl.pdsc e2ff1a23ba 初始版本 4 月之前
LVGL.pidx e2ff1a23ba 初始版本 4 月之前
README.md e2ff1a23ba 初始版本 4 月之前
gen_pack.sh e2ff1a23ba 初始版本 4 月之前
lv_cmsis_pack.txt e2ff1a23ba 初始版本 4 月之前
lv_conf_cmsis.h e2ff1a23ba 初始版本 4 月之前

README.md

How to Create CMSIS-Pack

STEP 1 Update 'lv_conf_cmsis.h'

  1. Copy the lv_conf_template.h to 'cmsis-pack' directory

  2. Set the macro protector to '1'

    ...
    /* clang-format off */
    #if 1 /*Set it to "1" to enable content*/
    ...
    

remove the misleading guide above this code segment.

/*
 * Copy this file as `lv_conf.h`
 * 1. simply next to the `lvgl` folder
 * 2. or any other places and
 *    - define `LV_CONF_INCLUDE_SIMPLE`
 *    - add the path as include path
 */
  1. Add including for 'RTE_Components.h'

    #ifndef LV_CONF_H
    #define LV_CONF_H
    
    #include <stdint.h>
    #include "RTE_Components.h"
    ...
    
  2. Remove macro definitions for

    • LV_USE_GPU_STM32_DMA2D
    • LV_USE_GPU_NXP_PXP
    • LV_USE_GPU_NXP_VG_LITE
    • LV_USE_GPU_SWM341_DMA2D
    • LV_USE_GPU_ARM2D
    • LV_USE_IME_PINYIN
    • LV_USE_PNG
    • LV_USE_BMP
    • LV_USE_SJPG
    • LV_USE_GIF
    • LV_USE_QRCODE
    • LV_USE_FREETYPE
    • LV_USE_TINY_TTF
    • LV_USE_RLOTTIE
    • LV_USE_FFMPEG
    • LV_USE_SNAPSHOT
    • LV_USE_MONKEY
    • LV_USE_GRIDNAV
    • LV_USE_FRAGMENT
    • LV_USE_IMGFONT
    • LV_USE_MSG
    • LV_USE_IME_PINYIN
  3. Update macro LV_ATTRIBUTE_MEM_ALIGN and LV_ATTRIBUTE_MEM_ALIGN_SIZE to force a WORD alignment.

    #define LV_ATTRIBUTE_MEM_ALIGN_SIZE     4
    #define LV_ATTRIBUTE_MEM_ALIGN          __attribute__((aligned(4)))
    

    Update macro LV_MEM_SIZE to (64*1024U).

Update macro LV_FONT_MONTSERRAT_12 to 1.

Update macro LV_FONT_MONTSERRAT_12 to 1.

  1. Update Theme related macros:

    #ifdef RTE_GRAPHICS_LVGL_USE_EXTRA_THEMES
    /*A simple, impressive and very complete theme*/
    #define LV_USE_THEME_DEFAULT 1
    #if LV_USE_THEME_DEFAULT
    
        /*0: Light mode; 1: Dark mode*/
        #define LV_THEME_DEFAULT_DARK 0
    
        /*1: Enable grow on press*/
        #define LV_THEME_DEFAULT_GROW 1
    
        /*Default transition time in [ms]*/
        #define LV_THEME_DEFAULT_TRANSITION_TIME 80
    #endif /*LV_USE_THEME_DEFAULT*/
    
    /*A very simple theme that is a good starting point for a custom theme*/
    #define LV_USE_THEME_BASIC 1
    
    /*A theme designed for monochrome displays*/
    #define LV_USE_THEME_MONO 1
    #else
    #define LV_USE_THEME_DEFAULT    0
    #define LV_USE_THEME_BASIC      0
    #define LV_USE_THEME_MONO       0
    #endif
    
  2. Update LV_TICK_CUSTOM related macros:

    /*Use a custom tick source that tells the elapsed time in milliseconds.
    *It removes the need to manually update the tick with `lv_tick_inc()`)*/
    #ifdef __PERF_COUNTER__
    #define LV_TICK_CUSTOM 1
    #if LV_TICK_CUSTOM
        extern uint32_t SystemCoreClock;
        #define LV_TICK_CUSTOM_INCLUDE          "perf_counter.h"
        #define LV_TICK_CUSTOM_SYS_TIME_EXPR    get_system_ms()
    #endif   /*LV_TICK_CUSTOM*/
    #else
    #define LV_TICK_CUSTOM 0
    #if LV_TICK_CUSTOM
        #define LV_TICK_CUSTOM_INCLUDE "Arduino.h"         /*Header for the system time function*/
        #define LV_TICK_CUSTOM_SYS_TIME_EXPR (millis())    /*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*/
    #endif       /*__PERF_COUNTER__*/
    
  3. Remove all content in DEMO USAGE section but keep the following:

    /*Show some widget. It might be required to increase `LV_MEM_SIZE` */
    #if LV_USE_DEMO_WIDGETS
    	#define LV_DEMO_WIDGETS_SLIDESHOW 0
    #endif
    
    /*Benchmark your system*/
    #if LV_USE_DEMO_BENCHMARK
    /*Use RGB565A8 images with 16 bit color depth instead of ARGB8565*/
    	#define LV_DEMO_BENCHMARK_RGB565A8 1
    #endif
    
  4. Thoroughly remove the 3rd party libraries section.

  5. rename 'lv_conf_template.h' to 'lv_conf_cmsis.h'.

STEP 2 Check, Update and Run the 'gen_pack.sh'

if [ `uname -s` = "Linux" ]
  then
  CMSIS_PACK_PATH="/home/$USER/.arm/Packs/ARM/CMSIS/5.7.0/"
  PATH_TO_ADD="$CMSIS_PACK_PATH/CMSIS/Utilities/Linux64/"
else
  CMSIS_PACK_PATH="/C/Users/gabriel/AppData/Local/Arm/Packs/ARM/CMSIS/5.7.0"
  PATH_TO_ADD="/C/Program Files (x86)/7-Zip/:$CMSIS_PACK_PATH/CMSIS/Utilities/Win32/:/C/xmllint/"
fi
[[ ":$PATH:" != *":$PATH_TO_ADD}:"* ]] && PATH="${PATH}:${PATH_TO_ADD}"
echo $PATH_TO_ADD appended to PATH
echo " "

A. For Windows users

Update the 'CMSIS_PACK_PATH' accordingly (Usually just replace the name gabriel with your own windows account name is sufficient.).

Update the 'PATH_TO_ADD' to point to the installation folders of 7Zip and xmllint.

Launch the git-bash and go to the cmsis-pack folder.

enter the following command:

./gen_pack.sh

B. For Linux Users

Update 'PATH_TO_ADD' if necessary.

go to the cmsis-pack folder.

enter the following command:

./gen_pack.sh