「App:Library:LVGL:docs:Porting:Set up a project」の版間の差分
54行目: | 54行目: | ||
To add LVGL to your Makefile based build system add these lines to your main Makefile: | To add LVGL to your Makefile based build system add these lines to your main Makefile: | ||
− | <source lang="C++" | + | <source lang="C++"> |
LVGL_DIR_NAME ?= lvgl #The name of the lvgl folder (change this if you have renamed it) | 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 | LVGL_DIR ?= ${shell pwd} #The path where the lvgl folder is |
2022年6月22日 (水) 09:52時点における版
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
directory.It contains a couple of folders but to use
lvgl
you only need.c
and.h
files from thesrc
folder.グラフィックライブラリ自体は lvgl
ディレクトリです。いくつかのフォルダがありますが、
lvgl
を使うにはsrc
フォルダにある.c
と.h
のファイルだけが必要です。
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.EclipseやVSCodeのように、IDEが自動的にプロジェクトフォルダにコピーされたフォルダのファイルを追加する場合は、 lvgl
フォルダをそのままプロジェクトにコピーすればOKです。
Make and CMake
英文 自動翻訳 LVGL also supports
make
andCMake
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フォルダのあるパス include $(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.
Get startedセクションには、ESP32、Arduino、NXP、RT-Thread、NuttXなど、プラットフォーム固有の記述が多く含まれています。
Demos and Examples
英文 自動翻訳 The
lvgl
folder also contains anexamples
and ademos
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
andCMake
handles the examples and demos, so no extra action required in these cases.lvglフォルダには、 examples
とdemos
フォルダが含まれています。もし、ソースファイルを手動でプロジェクトに追加する必要があった場合、この2つのフォルダのソースファイルについても同じように追加することができます。
make
とCMake
は、examples と demos を処理するので、これらの場合、余分なアクションは必要ありません。
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 thelvgl
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 inlv_conf.h
.
Alternatively,lv_conf.h
can be copied to another place but then you should add theLV_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 includelv_conf.h
simply with#include "lv_conf.h"
.
You can even use a different name forlv_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"
IfLV_CONF_SKIP
is defined, LVGL will not try to includelv_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 viaKconfig
andmenuconfig
.You can use
lv_conf.h
together with Kconfig, but keep in mind that the value fromlv_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 defineLV_CONF_SKIP
.LVGLには、lv_conf.h という設定用のヘッダファイルがあります。 このヘッダを修正して、ライブラリの基本動作の設定、未使用のモジュールや機能の無効化、コンパイル時のメモリバッファのサイズ調整などを行います。
lv_conf.h
を入手するには、lvgl/lv_conf_template.hをlvgl
ディレクトリの隣にコピーし、lv_conf.h にリネームしてください。このファイルを開き、冒頭の
そうする事により、ファイルのレイアウトは次のようになります。#if 0
を#if 1
に変更し、内容を有効にして下さい。| -lvgl | -lv_conf.h |-他の ファイル と フォルダ
設定ファイル内のコメントでオプションの意味を説明しています。少なくとも
LV_COLOR_DEPTH
は、ディスプレイの色深度に合わせて設定してください。なお、lv_conf.h
では、例題やデモを明示的に有効化する必要があります。
また,LV_CONF_INCLUDE_SIMPLE
をコンパイラのオプションに追加し例:GCCコンパイラでは-DLV_CONF_INCLUDE_SIMPLE
),インクルードパスを手動設定(例:-I../include/gui
)してください。この場合,LVGLは
lv_conf.h
を単に#include"lv_conf.h"
でインクルードしようとします.
lv_conf.h
を別の名前にすることもできます。カスタムパスは
LV_CONF_PATH
の定義で設定することができます。例えば、
-DLV_CONF_PATH="/home/joe/my_project/my_custom_conf.h"
LV_CONF_SKIP
が定義されていると、LVGLはlv_conf.h
をincludeしようとしません。その代わり、ビルドオプションを使用して設定定義を渡すことができます。
たとえば
"-DLV_COLOR_DEPTH=32-DLV_USE_BTN 1"
。設定されていないオプションは、
lv_conf_template.h
にあるのと同じデフォルト値が取得されます。
LVGLをKconfig
とmenuconfig
を通して使うこともできます。あなたはKconfigと共に
lv_conf.h
を使うことができますが、、Kconfigの中の値を、lv_conf.h
からの値または、build settings(-D...
)で上書きする事を忘れてはいけません。lv_conf.h
からの config を無視するために、単にその内容を除去するか、又はLV_CONF_SKIP
を定義してください。
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)
everyx
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.
グラフィックライブラリを使用するには、初期化および必要なコンポーネントのセットアップを行う必要があります。
初期化の順序は次の通りです。
lv_init()
を呼び出します。- ドライバーを初期化します。
- LVGLにディスプレイとインプットデバイスのドライバを登録します。ディスプレイと入力デバイスの登録について、詳しくはこちらをご覧ください。
lv_tick_inc(x)
をx
msec毎に割り込みで呼び、経過時間をLVGLに報告します。詳しくはこちら。- 数ミリ秒ごとに
lv_timer_handler()
を呼び出し、LVGL関連の処理を行う。詳細はこちら。
- Call