App:Library:LVGL:docs:Porting:Set up a project
https://docs.lvgl.io/8.2/porting/project.html
Set up a project
Get the library
英文 | 自動翻訳 |
---|---|
LVGL is available on GitHub: https://github.com/lvgl/lvgl. You can clone it or Download the latest version of the library from GitHub. |
LVGLはGitHubで入手できます:https://github.com/lvgl/lvgl。
クローンを作成するか、GitHubからライブラリの最新バージョンをダウンロードできます。 |
Add lvgl to your project
英文 | 自動翻訳 |
---|---|
The graphics library itself is the |
グラフィックライブラリ自体がlvgl ディレクトリです。いくつかのフォルダが含まれていますが、使用するにはフォルダのファイルlvgl のみが必要です。 .c.hsrc
|
Automatically add files
英文 | 自動翻訳 |
---|---|
If your IDE automatically adds the files from the folders copied to the project folder (as Eclipse or VSCode does), you can simply copy the |
IDEが(EclipseまたはVSCodeのように)プロジェクトフォルダーにコピーされたフォルダーからファイルを自動的に追加する場合は、フォルダーをそのままプロジェクトにコピーするだけですlvgl 。
|
Make and CMake
英文 | 自動翻訳 |
---|---|
LVGL also supports LVGL_DIR_NAME ?= lvgl #The name of the lvgl folder (change this if you have renamed it) LVGL_DIR ?= ${shell pwd} #The path where the lvgl folder is include $(LVGL_DIR)/$(LVGL_DIR_NAME)/lvgl.mk For integration with CMake take a look this section of the Documentation. |
LVGLは、すぐに使用できるシステムのサポートmake とCMake 構築も行います。MakefileベースのビルドシステムにLVGLを追加するには、次の行をメインのMakefileに追加します。
LVGL_DIR_NAME?= lvgl#lvglフォルダーの名前(名前を変更した場合はこれを変更してください) LVGL_DIR?= $ {shell pwd}#lvglフォルダーがあるパス $(LVGL_DIR)/ $(LVGL_DIR_NAME)/lvgl.mkを含める CMakeとの統合については、ドキュメントのこのセクションをご覧ください。 |
Other platforms and tools
英文 | 自動翻訳 |
---|---|
The Get started section contains many platform specific descriptions e.g. for ESP32, Arduino, NXP, RT-Thread, NuttX, etc. |
Demos and Examples
英文 | 自動翻訳 |
---|---|
The |
Configuration file
There is a configuration header file for LVGL called lv_conf.h. You modify this header to set the library's basic behavior, disable unused modules and features, adjust the size of memory buffers in compile-time, etc.
To get lv_conf.h
copy lvgl/lv_conf_template.h next to the lvgl
directory and rename it to lv_conf.h. Open the file and change the #if 0
at the beginning to #if 1
to enable its content. So the layout of the files should look like this:
|-lvgl
|-lv_conf.h
|-other files and folders
Comments in the config file explain the meaning of the options. Be sure to set at least LV_COLOR_DEPTH
according to your display's color depth. Note that, the examples and demos explicitly need to be enabled in lv_conf.h
.
Alternatively, lv_conf.h
can be copied to another place but then you should add the LV_CONF_INCLUDE_SIMPLE
define to your compiler options (e.g. -DLV_CONF_INCLUDE_SIMPLE
for GCC compiler) and set the include path manually (e.g. -I../include/gui
). In this case LVGL will attempt to include lv_conf.h
simply with #include "lv_conf.h"
.
You can even use a different name for lv_conf.h
. The custom path can be set via the LV_CONF_PATH
define. For example -DLV_CONF_PATH="/home/joe/my_project/my_custom_conf.h"
If LV_CONF_SKIP
is defined, LVGL will not try to include lv_conf.h
. Instead you can pass the config defines using build options. For example "-DLV_COLOR_DEPTH=32 -DLV_USE_BTN 1"
. The unset options will get a default value which is the same as the ones in lv_conf_template.h
.
LVGL also can be used via Kconfig
and menuconfig
. You can use lv_conf.h
together with Kconfig, but keep in mind that the value from lv_conf.h
or build settings (-D...
) overwrite the values set in Kconfig. To ignore the configs from lv_conf.h
simply remove its content, or define LV_CONF_SKIP
.
Initialization
英文 | 自動翻訳 |
---|---|
To use the graphics library you have to initialize it and setup required components. The order of the initialization is:
|