|
|
91行目: |
91行目: |
| |- | | |- |
| | | | | |
− | 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 <code>'''lv_conf.h'''</code> copy '''lvgl/lv_conf_template.h''' next to the <code>'''lvgl'''</code> directory and rename it to '''''lv_conf.h'''''. Open the file and change the <code>'''#if 0'''</code> at the beginning to <code>'''#if 1'''</code> 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 <code>LV_COLOR_DEPTH</code> according to your display's color depth. Note that, the examples and demos explicitly need to be enabled in <code>'''lv_conf.h'''</code>.
| |
| | | |
− | Alternatively, <code>'''lv_conf.h'''</code> can be copied to another place but then you should add the <code>'''LV_CONF_INCLUDE_SIMPLE'''</code> define to your compiler options (e.g. <code>'''-DLV_CONF_INCLUDE_SIMPLE'''</code> for GCC compiler) and set the include path manually (e.g. <code>'''-I../include/gui'''</code>). In this case LVGL will attempt to include <code>'''lv_conf.h'''</code> simply with <code>'''#include "lv_conf.h"'''</code>.
| |
| | | |
− | You can even use a different name for <code>'''lv_conf.h'''</code>. The custom path can be set via the <code>'''LV_CONF_PATH'''</code> define. For example <code>'''-DLV_CONF_PATH="/home/joe/my_project/my_custom_conf.h"'''</code>
| |
| | | |
− | If <code>'''LV_CONF_SKIP'''</code> is defined, LVGL will not try to include <code>'''lv_conf.h'''</code>. Instead you can pass the config defines using build options. For example <code>'''"-DLV_COLOR_DEPTH=32 -DLV_USE_BTN 1"'''</code>. The unset options will get a default value which is the same as the ones in <code>'''lv_conf_template.h'''</code>.
| |
− |
| |
− | LVGL also can be used via <code>'''Kconfig'''</code> and <code>'''menuconfig'''</code>. You can use <code>'''lv_conf.h'''</code> together with Kconfig, but keep in mind that the value from <code>'''lv_conf.h'''</code> or build settings (<code>'''-D...'''</code>) overwrite the values set in Kconfig. To ignore the configs from <code>'''lv_conf.h'''</code> simply remove its content, or define <code>'''LV_CONF_SKIP'''</code>.
| |
| | | | | |
| |} | | |} |
| :[[App:Library:LVGL:docs:Porting|戻る : Previous]] | | :[[App:Library:LVGL:docs:Porting|戻る : Previous]] |
− |
| |
| | | |
| === Initialization === | | === Initialization === |
2022年6月21日 (火) 20:22時点における版
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からライブラリの最新バージョンをダウンロードできます。
|
- 戻る : Previous
Add lvgl to your project
英文
|
自動翻訳
|
The graphics library itself is the lvgl directory. It contains a couple of folders but to use lvgl you only need .c and .h files from the src folder.
|
グラフィックライブラリ自体がlvgl ディレクトリです。いくつかのフォルダが含まれていますが、使用するにはフォルダのファイルlvgl のみが必要です。 .c.hsrc
|
- 戻る : Previous
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 lvgl folder as it is into your project.
|
IDEが(EclipseまたはVSCodeのように)プロジェクトフォルダーにコピーされたフォルダーからファイルを自動的に追加する場合は、フォルダーをそのままプロジェクトにコピーするだけですlvgl 。
|
- 戻る : Previous
Make and CMake
英文
|
自動翻訳
|
LVGL also supports make and CMake build systems out of the box. To add LVGL to your Makefile based build system add these lines to your main Makefile:
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との統合については、ドキュメントのこのセクションをご覧ください。
|
- 戻る : Previous
Other platforms and tools
英文
|
自動翻訳
|
The Get started section contains many platform specific descriptions e.g. for ESP32, Arduino, NXP, RT-Thread, NuttX, etc.
|
|
- 戻る : Previous
Demos and Examples
英文
|
自動翻訳
|
The lvgl folder also contains an examples and a demos folder. If you needed to add the source files manually to your project, you can do the same with the source files of these two folders too. make and CMake handles the examples and demos, so no extra action required in these cases.
|
|
- 戻る : Previous
Configuration file
- 戻る : Previous
Initialization
英文
|
自動翻訳
|
To use the graphics library you have to initialize it and setup required components. The order of the initialization is:
- Call
lv_init() .
- Initialize your drivers.
- Register the display and input devices drivers in LVGL. Learn more about Display and Input device registration.
- Call
lv_tick_inc(x) every x milliseconds in an interrupt to report the elapsed time to LVGL. Learn more.
- Call
lv_timer_handler() every few milliseconds to handle LVGL related tasks. Learn more.
|
|
- 戻る : Previous