「App:Library:LVGL:docs:Porting:Input device interface」の版間の差分
43行目: | 43行目: | ||
Visit [https://docs.lvgl.io/8.2/overview/indev.html '''Input devices to'''] learn more about input devices in general. | Visit [https://docs.lvgl.io/8.2/overview/indev.html '''Input devices to'''] learn more about input devices in general. | ||
− | | | + | |入力デバイスを登録するには、変数<code style="color: #bb0000;">lv_indev_drv_t</code>を初期化する必要があります。 |
'''入力デバイスを登録する前に、必ず少なくとも1つのディスプレイを登録してください。''' | '''入力デバイスを登録する前に、必ず少なくとも1つのディスプレイを登録してください。''' | ||
395行目: | 395行目: | ||
− | + | 次のパラメータのデフォルト値は、<code style="color: #bb0000;">lv_indev_drv_t</code>で変更できます。 | |
* <code style="color: #bb0000;">scroll_limit</code>オブジェクトを実際にスクロールする前にスライドするピクセル数。 | * <code style="color: #bb0000;">scroll_limit</code>オブジェクトを実際にスクロールする前にスライドするピクセル数。 | ||
* <code style="color: #bb0000;">scroll_throw</code>[%]でスロースロー(勢い)をスクロールします。値が大きいほど、速度が速くなります。 | * <code style="color: #bb0000;">scroll_throw</code>[%]でスロースロー(勢い)をスクロールします。値が大きいほど、速度が速くなります。 | ||
− | * <code style="color: #bb0000;">long_press_time</code> | + | * <code style="color: #bb0000;">long_press_time</code>:<code style="color: #bb0000;">LV_EVENT_LONG_PRESSED</code>を送信するのに押す時間(ミリ秒単位) |
− | * <code style="color: #bb0000;">long_press_rep_time</code> | + | * <code style="color: #bb0000;">long_press_rep_time</code>:<code style="color: #bb0000;">LV_EVENT_LONG_PRESSED_REPEAT</code>を送信する間隔(ミリ秒単位) |
− | * <code style="color: #bb0000;">read_timer</code><font class="goog-text-highlight"> | + | * <code style="color: #bb0000;">read_timer</code><font class="goog-text-highlight">:</font>入力デバイスを読み取る<code style="color: #bb0000;">lv_timer</code>へのポインタ。そのパラメータは<code style="color: #bb0000;">lv_timer_...()</code>関数によって変更できます。<code style="color: #bb0000;">lv_conf.h</code>の中の<code style="color: #bb0000;">LV_INDEV_DEF_READ_PERIOD</code>では、デフォルトの読み取り期間を設定します。 |
|} | |} | ||
:[[App:Library:LVGL:docs:Porting|戻る : Previous]] | :[[App:Library:LVGL:docs:Porting|戻る : Previous]] | ||
412行目: | 412行目: | ||
|- | |- | ||
| | | | ||
− | Besides <code style="color: #bb0000;">read_cb</code> a <code style="color: #bb0000;">feedback_cb</code> callback can be also specified in <code style="color: #bb0000;">lv_indev_drv_t</code>. <code style="color: #bb0000;">feedback_cb</code> is called when any type of event is sent by the input devices (independently of its type). This allows generating feedback for the user, e.g. to play a sound on <code style="color: #bb0000;">LV_EVENT_CLICKED</code>. | + | Besides <code style="color: #bb0000;">read_cb</code> a <code style="color: #bb0000;">feedback_cb</code> callback can be also specified in <code style="color: #bb0000;">lv_indev_drv_t</code>. |
− | | | + | |
+ | <code style="color: #bb0000;">feedback_cb</code> is called when any type of event is sent by the input devices (independently of its type). | ||
+ | |||
+ | This allows generating feedback for the user, e.g. to play a sound on <code style="color: #bb0000;">LV_EVENT_CLICKED</code>. | ||
+ | |<code style="color: #bb0000;">read_cb</code>コールバックに加えて、<code style="color: #bb0000;">lv_indev_drv_t</code>の中の<code style="color: #bb0000;">feedback_cb</code>で指定することもできます。 | ||
+ | <code style="color: #bb0000;">feedback_cb</code>は、任意のタイプのイベントが(そのタイプに関係なく)入力デバイスによって送信されたときに呼び出されます。 | ||
+ | |||
+ | これにより、ユーザーにフィードバックを生成できます。 | ||
+ | |||
+ | たとえば、<code style="color: #bb0000;">LV_EVENT_CLICKED</code>でサウンドを再生できます。 | ||
|} | |} | ||
:[[App:Library:LVGL:docs:Porting|戻る : Previous]] | :[[App:Library:LVGL:docs:Porting|戻る : Previous]] | ||
424行目: | 433行目: | ||
|- | |- | ||
| | | | ||
− | Every input device is associated with a display. By default, a new input device is added to the last display created or explicitly selected (using <code style="color: #bb0000;">lv_disp_set_default()</code>). The associated display is stored and can be changed in <code style="color: #bb0000;">disp</code> field of the driver. | + | Every input device is associated with a display. |
− | | | + | |
+ | By default, a new input device is added to the last display created or explicitly selected (using <code style="color: #bb0000;">lv_disp_set_default()</code>). | ||
+ | |||
+ | The associated display is stored and can be changed in <code style="color: #bb0000;">disp</code> field of the driver. | ||
+ | |すべての入力デバイスはディスプレイに関連付けられています。 | ||
+ | デフォルトでは、(<code style="color: #bb0000;">lv_disp_set_default()</code>を使用して)作成または明示的に選択された最後のディスプレイに新しい入力デバイスが追加されます。 | ||
+ | |||
+ | 関連する表示が保存され、ドライバーの<code style="color: #bb0000;">disp</code>フィールドで 変更できます。 | ||
|} | |} | ||
:[[App:Library:LVGL:docs:Porting|戻る : Previous]] | :[[App:Library:LVGL:docs:Porting|戻る : Previous]] | ||
436行目: | 452行目: | ||
|- | |- | ||
| | | | ||
− | By default, LVGL calls <code style="color: #bb0000;">read_cb</code> periodically. Because of this intermittent polling there is a chance that some user gestures are missed. | + | By default, LVGL calls <code style="color: #bb0000;">read_cb</code> periodically. |
+ | |||
+ | Because of this intermittent polling there is a chance that some user gestures are missed. | ||
+ | |||
+ | |||
+ | To solve this you can write an event driven driver for your input device that buffers measured data. | ||
+ | |||
+ | In <code style="color: #bb0000;">read_cb</code> you can report the buffered data instead of directly reading the input device. | ||
+ | |||
+ | Setting the <code style="color: #bb0000;">data->continue_reading</code> flag will tell LVGL there is more data to read and it should call <code style="color: #bb0000;">read_cb</code> again. | ||
+ | |デフォルトでは、LVGLは<code style="color: #bb0000;">read_cb</code>を定期的に呼び出します。 | ||
+ | この断続的なポーリングのために、一部のユーザージェスチャが見落とされる可能性があります。 | ||
+ | |||
+ | これを解決するために、測定データをバッファリングする入力デバイス用のイベント駆動型ドライバーを作成できます。 | ||
− | + | <code style="color: #bb0000;">read_cb</code>では、入力デバイスを直接読み取る代わりに、バッファリングされたデータをレポートできます。 | |
− | |||
− | + | <code style="color: #bb0000;">data->continue_reading</code>フラグを設定すると、LVGLに読み取るデータがさらにあることが通知され、<code style="color: #bb0000;">read_cb</code>を再度呼び出す必要があります。 | |
|} | |} | ||
:[[App:Library:LVGL:docs:Porting|戻る : Previous]] | :[[App:Library:LVGL:docs:Porting|戻る : Previous]] |
2022年6月29日 (水) 14:28時点における版
https://docs.lvgl.io/8.2/porting/indev.html
英文 | 自動翻訳 |
---|---|
Input device interface
Types of input devices
英文 | 自動翻訳 |
---|---|
To register an input device an Be sure to register at least one display before you register any input devices. lv_disp_drv_register(&disp_drv);
static lv_indev_drv_t indev_drv;
lv_indev_drv_init(&indev_drv); /*Basic initialization*/
indev_drv.type =... /*See below.*/
indev_drv.read_cb =... /*See below.*/
/*Register the driver in LVGL and save the created input device object*/
lv_indev_t * my_indev = lv_indev_drv_register(&indev_drv);
The
Visit Input devices to learn more about input devices in general. |
入力デバイスを登録するには、変数lv_indev_drv_t を初期化する必要があります。
入力デバイスを登録する前に、必ず少なくとも1つのディスプレイを登録してください。 lv_disp_drv_register (&disp_drv );
static lv_indev_drv_t indev_drv ;
lv_indev_drv_init (&indev_drv ); /*基本的な初期化*/
indev_drv 。type = ... /*以下を参照してください。*/
indev_drv 。read_cb = ... /*以下を参照してください。* // * LVGL
にドライバーを登録し、作成した入力デバイスオブジェクトを保存します* /
lv_indev_t * my_indev = lv_indev_drv_register (&indev_drv );
一般的な入力デバイスの詳細については、入力デバイスにアクセスしてください。 |
Touchpad, mouse or any pointer
英文 | 自動翻訳 |
---|---|
Input devices that can click points on the screen belong to this category. indev_drv.type = LV_INDEV_TYPE_POINTER;
indev_drv.read_cb = my_input_read;
...
void my_input_read(lv_indev_drv_t * drv, lv_indev_data_t*data)
{
if(touchpad_pressed) {
data->point.x = touchpad_x;
data->point.y = touchpad_y;
data->state = LV_INDEV_STATE_PRESSED;
} else {
data->state = LV_INDEV_STATE_RELEASED;
}
}
To set a mouse cursor use |
画面上のポイントをクリックできる入力デバイスは、このカテゴリに属します。
indev_drv 。タイプ = LV_INDEV_TYPE_POINTER ;
indev_drv 。read_cb = my_input_read ;
...
void my_input_read (lv_indev_drv_t * drv 、 lv_indev_data_t * data )
{
if (touchpad_pressed ) {
data- > point 。x = touchpad_x ;
データ->ポイント。y = touchpad_y ;
データ->状態 = LV_INDEV_STATE_PRESSED ;
} else {
データ->状態 = LV_INDEV_STATE_RELEASED ;
}
}
マウスカーソルを設定するには、を使用します |
Keypad or keyboard
英文 | 自動翻訳 |
---|---|
Full keyboards with all the letters or simple keypads with a few navigation buttons belong here. To use a keyboard/keypad:
indev_drv.type = LV_INDEV_TYPE_KEYPAD;
indev_drv.read_cb = keyboard_read;
...
void keyboard_read(lv_indev_drv_t * drv, lv_indev_data_t*data){
data->key = last_key(); /*Get the last pressed or released key*/
if(key_pressed()) data->state = LV_INDEV_STATE_PRESSED;
else data->state = LV_INDEV_STATE_RELEASED;
}
|
キーボード/キーパッドを使用するには:
indev_drv 。タイプ = LV_INDEV_TYPE_KEYPAD ;
indev_drv 。read_cb = Keyboard_read ;
...
void Keyboard_read (lv_indev_drv_t * drv 、 lv_indev_data_t * data ){
data- > key = last_key (); /*最後に押されたキーまたはリリースされたキーを取得します*/
if (key_pressed ()) data- > state = LV_INDEV_STATE_PRESSED ;
else データ->状態 = LV_INDEV_STATE_RELEASED ;
}
|
Encoder
英文 | 自動翻訳 |
---|---|
With an encoder you can do the following:
indev_drv.type = LV_INDEV_TYPE_ENCODER;
indev_drv.read_cb = encoder_read;
...
void encoder_read(lv_indev_drv_t * drv, lv_indev_data_t*data){
data->enc_diff = enc_get_new_moves();
if(enc_pressed()) data->state = LV_INDEV_STATE_PRESSED;
else data->state = LV_INDEV_STATE_RELEASED;
}
|
つまり、エンコーダ入力デバイスは次のように機能します。
エンコーダー(キーパッドと同様) を使用するには、オブジェクトをグループに追加する必要があります。 indev_drv 。タイプ = LV_INDEV_TYPE_ENCODER ;
indev_drv 。read_cb = エンコーダー読み取り;
...
void エンコーダー読み取り(lv_indev_drv_t * drv 、 lv_indev_data_t * data ){
data- > enc_diff = enc_get_new_moves ();
if (enc_pressed ()) data- > state = LV_INDEV_STATE_PRESSED ;
else データ->状態 = LV_INDEV_STATE_RELEASED ;
}
|
Using buttons with Encoder logic
英文 | 自動翻訳 |
---|---|
In addition to standard encoder behavior, you can also utilize its logic to navigate(focus) and edit widgets using buttons. This is especially handy if you have only few buttons available, or you want to use other buttons in addition to encoder wheel.
indev_drv.type = LV_INDEV_TYPE_ENCODER;
indev_drv.read_cb = encoder_with_keys_read;
...
void encoder_with_keys_read(lv_indev_drv_t * drv, lv_indev_data_t*data){
data->key = last_key(); /*Get the last pressed or released key*/
/* use LV_KEY_ENTER for encoder press */
if(key_pressed()) data->state = LV_INDEV_STATE_PRESSED;
else {
data->state = LV_INDEV_STATE_RELEASED;
/* Optionally you can also use enc_diff, if you have encoder*/
data->enc_diff = enc_get_new_moves();
}
}
|
3つのボタンを使用できるようにする必要があります。
キーを押したままにすると、で指定された期間でエンコーダの前進をシミュレートします indev_drv 。タイプ = LV_INDEV_TYPE_ENCODER ;
indev_drv 。read_cb = エンコーダーwith_keys_read ;
...
void エンコーダ_with_keys_read (lv_indev_drv_t * drv 、 lv_indev_data_t * data ){
data- > key = last_key (); /*最後に押されたキーまたは離されたキーを取得します*
//*エンコーダーを押すためにLV_KEY_ENTERを使用します*/
if (key_pressed ()) data- > state = LV_INDEV_STATE_PRESSED ;
else {
データ->状態 = LV_INDEV_STATE_RELEASED ;
/ *エンコーダーがある場合は、オプションでenc_diffを使用することもできます* /
data- >enc_diff = enc_get_new_moves ();
}
}
|
Button
英文 | 自動翻訳 |
---|---|
Buttons mean external "hardware" buttons next to the screen which are assigned to specific coordinates of the screen. If a button is pressed it will simulate the pressing on the assigned coordinate. (Similarly to a touchpad)
Important: The points_array can't go out of scope. Either declare it as a global variable or as a static variable inside a function. indev_drv.type = LV_INDEV_TYPE_BUTTON;
indev_drv.read_cb = button_read;
...
void button_read(lv_indev_drv_t * drv, lv_indev_data_t*data){
static uint32_t last_btn = 0; /*Store the last pressed button*/
int btn_pr = my_btn_read(); /*Get the ID (0,1,2...) of the pressed button*/
if(btn_pr >= 0) { /*Is there a button press? (E.g. -1 indicated no button was pressed)*/
last_btn = btn_pr; /*Save the ID of the pressed button*/
data->state = LV_INDEV_STATE_PRESSED; /*Set the pressed state*/
} else {
data->state = LV_INDEV_STATE_RELEASED; /*Set the released state*/
}
data->btn = last_btn; /*Save the last button*/
}
|
ボタンを座標に割り当てるには、を使用します
重要:points_arrayはスコープ外に出ることはできません。グローバル変数または関数内の静的変数として宣言します。 indev_drv 。タイプ = LV_INDEV_TYPE_BUTTON ;
indev_drv 。read_cb = button_read ;
...
void button_read (lv_indev_drv_t * drv 、 lv_indev_data_t * data ){
static uint32_t last_btn = 0 ; /*最後に押されたボタンを保存します*/
int btn_pr = my_btn_read (); / *押されたボタンのID(0,1,2 ...)を取得します* /
if (btn_pr > = 0 ) { / *ボタンが押されましたか?(例-1はボタンが押されていないことを示します)* /
last_btn = btn_pr ; /*押されたボタンのIDを保存します*/
データ->状態 = LV_INDEV_STATE_PRESSED ; /*押された状態を設定します*/
} else {
データ->状態 = LV_INDEV_STATE_RELEASED ; /*リリース状態を設定します*/
}
データ-> btn = last_btn ; /*最後のボタンを保存します*/
}
|
Other features
Parameters
英文 | 自動翻訳 |
---|---|
The default value of the following parameters can be changed in
|
|
Feedback
英文 | 自動翻訳 |
---|---|
Besides
This allows generating feedback for the user, e.g. to play a sound on |
read_cb コールバックに加えて、lv_indev_drv_t の中のfeedback_cb で指定することもできます。
これにより、ユーザーにフィードバックを生成できます。 たとえば、 |
Associating with a display
英文 | 自動翻訳 |
---|---|
Every input device is associated with a display. By default, a new input device is added to the last display created or explicitly selected (using The associated display is stored and can be changed in |
すべての入力デバイスはディスプレイに関連付けられています。
デフォルトでは、( 関連する表示が保存され、ドライバーの |
Buffered reading
英文 | 自動翻訳 |
---|---|
By default, LVGL calls Because of this intermittent polling there is a chance that some user gestures are missed.
In Setting the |
デフォルトでは、LVGLはread_cb を定期的に呼び出します。
この断続的なポーリングのために、一部のユーザージェスチャが見落とされる可能性があります。
|
Further reading
英文 | 自動翻訳 |
---|---|
|
|
API
英文 | 自動翻訳 |
---|---|
@description Input Device HAL interface layer header file Typedefs typedef struct _lv_indev_drv_t lv_indev_drv_t
typedef struct _lv_indev_proc_t _lv_indev_proc_t
typedef struct _lv_indev_t lv_indev_t
|
Typedef typedef struct _ lv_indev_drv_t lv_indev_drv_t
typedef struct _ lv_indev_proc_t _lv_indev_proc_t
typedef struct _ lv_indev_t lv_indev_t
|
Enums
英文 | 自動翻訳 |
---|---|
enum lv_indev_type_t
enum lv_indev_state_t
|
列挙型lv_indev_state_t
|
Functions
英文 | 自動翻訳 |
---|---|
void lv_indev_drv_init(struct _lv_indev_drv_t *driver)
lv_indev_t *lv_indev_drv_register(struct _lv_indev_drv_t *driver)
void lv_indev_drv_update(lv_indev_t *indev, struct _lv_indev_drv_t *new_drv)
void lv_indev_delete(lv_indev_t *indev)
lv_indev_t *lv_indev_get_next(lv_indev_t *indev)
void _lv_indev_read(lv_indev_t *indev, lv_indev_data_t *data)
struct lv_indev_data_t
struct _lv_indev_drv_t
struct _lv_indev_proc_t
struct _lv_indev_t
|
lv_indev_t * lv_indev_drv_register(struct _ lv_indev_drv_t * driver)
void lv_indev_drv_update(lv_indev_t * indev、struct _lv_indev_drv_t * new_drv)
void lv_indev_delete(lv_indev_t * indev)
lv_indev_t * lv_indev_get_next( lv_indev_t * indev)
void _lv_indev_read(lv_indev_t * indev、lv_indev_data_t * data)
struct lv_indev_data_t
struct _lv_indev_drv_t
struct _lv_indev_proc_t
struct _lv_indev_t
|