fix(env_support): move cmsis-pack to env_support folder (#3026)

* fix(env_support): move cmsis-pack to env_support folder * fix(cmsis-pack): change version info from v8.1.0 to v8.1.1 * feat(cmsis-pack): catchup before merge
2022-01-20 10:40:47 +00:00
parent 1efe61fda2
commit b0949109bd
6 changed files with 13 additions and 17 deletions
--- a/env_support/cmsis-pack/README.md
+++ b/env_support/cmsis-pack/README.md
@@ -0,0 +1,119 @@
+# 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'
+
+```c
+...
+/* clang-format off */
+#if 1 /*Set it to "1" to enable content*/
+...
+```
+
+
+3. Add including for '**RTE_Components.h**'
+
+```c
+#ifndef LV_CONF_H
+#define LV_CONF_H
+
+#include <stdint.h>
+#include "RTE_Components.h"
+...
+```
+
+4. Remove macro definitions for 
+   - LV_USE_GPU_STM32_DMA2D
+   - LV_USE_GPU_NXP_PXP
+   - LV_USE_GPU_NXP_VG_LITE
+5. Update macro LV_ATTRIBUTE_MEM_ALIGN to force a WORD alignment.
+```c
+#define LV_ATTRIBUTE_MEM_ALIGN      __attribute__((aligned(4)))
+```
+6. Update Theme related macros:
+
+```c
+#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
+```
+
+7. Thoroughly remove the 'DEMO USAGE' section.
+8. Thoroughly remove the '3rd party libraries' section.
+9. rename '**lv_conf_template.h**' to '**lv_conf_cmsis.h**'.
+
+
+
+## STEP 2 Check, Update and Run the 'gen_pack.sh'
+
+```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:
+
+```sh
+./gen_pack.sh
+```
+
+
+
+### B. For Linux Users
+
+Update '**PATH_TO_ADD**' if necessary. 
+
+go to the cmsis-pack folder. 
+
+enter the following command:
+
+```sh
+./gen_pack.sh
+```
+