「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>lv_indev_drv_t</code>変数を初期化する必要があります。 |
+ | |||
+ | '''入力デバイスを登録する前に、必ず少なくとも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 ); | ||
+ | <code>type</code>メンバーは次 のようになります。 | ||
+ | |||
+ | * <code>LV_INDEV_TYPE_POINTER</code>タッチパッドまたはマウス | ||
+ | * <code>LV_INDEV_TYPE_KEYPAD</code>キーボードまたはキーパッド | ||
+ | * <code>LV_INDEV_TYPE_ENCODER</code>左/右回転およびプッシュオプション付きエンコーダ | ||
+ | * <code>LV_INDEV_TYPE_BUTTON</code>画面を仮想的に押す外部ボタン | ||
+ | |||
+ | <code>read_cb</code>入力デバイスの現在の状態を報告するために定期的に呼び出される関数ポインタです。 | ||
+ | |||
+ | '''一般的な入力デバイスの詳細については、入力デバイスにアクセスして'''ください。 | ||
|} | |} | ||
:[[App:Library:LVGL:docs:Porting|戻る : Previous]] | :[[App:Library:LVGL:docs:Porting|戻る : Previous]] | ||
73行目: | 93行目: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
To set a mouse cursor use <code style="color: #bb0000;">lv_indev_set_cursor(my_indev, &img_cursor)</code>. (<code style="color: #bb0000;">my_indev</code> is the return value of <code style="color: #bb0000;">lv_indev_drv_register</code>) | To set a mouse cursor use <code style="color: #bb0000;">lv_indev_set_cursor(my_indev, &img_cursor)</code>. (<code style="color: #bb0000;">my_indev</code> is the return value of <code style="color: #bb0000;">lv_indev_drv_register</code>) | ||
− | | | + | |画面上のポイントをクリックできる入力デバイスは、このカテゴリに属します。 |
+ | 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 ; | ||
+ | } | ||
+ | } | ||
+ | マウスカーソルを設定するには、を使用します<code>lv_indev_set_cursor(my_indev, &img_cursor)</code>。(<code>my_indev</code>はの戻り値です<code>lv_indev_drv_register</code>) | ||
|} | |} | ||
:[[App:Library:LVGL:docs:Porting|戻る : Previous]] | :[[App:Library:LVGL:docs:Porting|戻る : Previous]] | ||
106行目: | 142行目: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| | | | ||
+ | |||
+ | |||
+ | すべての文字を含むフルキーボード、またはいくつかのナビゲーションボタンを備えたシンプルなキーパッドがここに属します。 | ||
+ | |||
+ | キーボード/キーパッドを使用するには: | ||
+ | |||
+ | * <font class="goog-text-highlight">入力デバイスを登録するには、</font><code>read_cb</code>タイプで関数を登録します<code>LV_INDEV_TYPE_KEYPAD</code>。 | ||
+ | * オブジェクトグループを作成する必要があります:<code>lv_group_t * g = lv_group_create()</code>そしてオブジェクトを追加する必要があります<code>lv_group_add_obj(g, obj)</code> | ||
+ | * 作成されたグループは、入力デバイスに割り当てる必要があります:(<code>lv_indev_set_group(my_indev, g)</code>はの<code>my_indev</code>戻り値です<code>lv_indev_drv_register</code>) | ||
+ | * <font class="goog-text-highlight">入力デバイスを登録するには、</font><code>LV_KEY_...</code>グループ内のオブジェクト間を移動するために使用します。<code>lv_core/lv_group.h</code>使用可能なキーについては、を参照してください。 | ||
+ | |||
+ | 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 ; | ||
+ | } | ||
|} | |} | ||
:[[App:Library:LVGL:docs:Porting|戻る : Previous]] | :[[App:Library:LVGL:docs:Porting|戻る : Previous]] | ||
147行目: | 205行目: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| | | | ||
+ | |||
+ | |||
+ | エンコーダーを使用すると、次のことができます。 | ||
+ | |||
+ | # そのボタンを押す | ||
+ | # ボタンを長押しします | ||
+ | # 左折してください | ||
+ | # 右に曲がる | ||
+ | |||
+ | つまり、エンコーダ入力デバイスは次のように機能します。 | ||
+ | |||
+ | * エンコーダーを回すと、次/前のオブジェクトに焦点を合わせることができます。 | ||
+ | * 単純なオブジェクト(ボタンなど)でエンコーダーを押すと、クリックされます。 | ||
+ | * 複雑なオブジェクト(リスト、メッセージボックスなど)でエンコーダーを押すと、オブジェクトは編集モードになり、エンコーダーを回してオブジェクト内を移動できます。 | ||
+ | * 編集モードを終了するには、ボタンを長押しします。 | ||
+ | |||
+ | ''エンコーダー(キーパッド''と同様) を使用するには、オブジェクトをグループに追加する必要があります。 | ||
+ | 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 ; | ||
+ | } | ||
|} | |} | ||
:[[App:Library:LVGL:docs:Porting|戻る : Previous]] | :[[App:Library:LVGL:docs:Porting|戻る : Previous]] | ||
187行目: | 273行目: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| | | | ||
+ | |||
+ | |||
+ | 標準のエンコーダー動作に加えて、そのロジックを利用して、ボタンを使用してウィジェットをナビゲート(フォーカス)および編集することもできます。これは、使用できるボタンが少ない場合、またはエンコーダーホイールに加えて他のボタンを使用する場合に特に便利です。 | ||
+ | |||
+ | 3つのボタンを使用できるようにする必要があります。 | ||
+ | |||
+ | * <code>LV_KEY_ENTER</code>エンコーダボタンの押下または押下をシミュレートします | ||
+ | * <code>LV_KEY_LEFT</code>エンコーダを左に回すシミュレーションを行います | ||
+ | * <code>LV_KEY_RIGHT</code>エンコーダを右に回すシミュレーションを行います | ||
+ | * 他のキーはフォーカスされたウィジェットに渡されます | ||
+ | |||
+ | キーを押したままにすると、で指定された期間でエンコーダの前進をシミュレートします<code>indev_drv.long_press_rep_time</code>。 | ||
+ | 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 (); | ||
+ | } | ||
+ | } | ||
|} | |} | ||
:[[App:Library:LVGL:docs:Porting|戻る : Previous]] | :[[App:Library:LVGL:docs:Porting|戻る : Previous]] | ||
225行目: | 338行目: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| | | | ||
+ | |||
+ | |||
+ | ''ボタン''とは、画面の特定の座標に割り当てられた、画面の横にある外部の「ハードウェア」ボタンを意味します。ボタンが押されると、割り当てられた座標の押下をシミュレートします。(タッチパッドと同様) | ||
+ | |||
+ | ボタンを座標に割り当てるには、を使用します<code>lv_indev_set_button_points(my_indev, points_array)</code>。 | ||
+ | |||
+ | <code>points_array</code>次のようになります<code>const lv_point_t points_array[] = { {12,30},{60,90}, ...}</code> | ||
+ | |||
+ | '''重要''':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 ; /*最後のボタンを保存します*/ | ||
+ | } | ||
|} | |} | ||
:[[App:Library:LVGL:docs:Porting|戻る : Previous]] | :[[App:Library:LVGL:docs:Porting|戻る : Previous]] | ||
245行目: | 384行目: | ||
* <code style="color: #bb0000;">read_timer</code> pointer to the <code style="color: #bb0000;">lv_timer</code> which reads the input device. Its parameters can be changed by <code style="color: #bb0000;">lv_timer_...()</code> functions. <code style="color: #bb0000;">LV_INDEV_DEF_READ_PERIOD</code> in <code style="color: #bb0000;">lv_conf.h</code> sets the default read period. | * <code style="color: #bb0000;">read_timer</code> pointer to the <code style="color: #bb0000;">lv_timer</code> which reads the input device. Its parameters can be changed by <code style="color: #bb0000;">lv_timer_...()</code> functions. <code style="color: #bb0000;">LV_INDEV_DEF_READ_PERIOD</code> in <code style="color: #bb0000;">lv_conf.h</code> sets the default read period. | ||
| | | | ||
+ | |||
+ | |||
+ | 次のパラメータのデフォルト値は、次の場所で変更できます<code>lv_indev_drv_t</code>。 | ||
+ | |||
+ | * <code>scroll_limit</code>オブジェクトを実際にスクロールする前にスライドするピクセル数。 | ||
+ | * <code>scroll_throw</code>[%]でスロースロー(勢い)をスクロールします。値が大きいほど、速度が速くなります。 | ||
+ | * <code>long_press_time</code>送信する時間を押す<code>LV_EVENT_LONG_PRESSED</code>(ミリ秒単位) | ||
+ | * <code>long_press_rep_time</code>送信間隔<code>LV_EVENT_LONG_PRESSED_REPEAT</code>(ミリ秒単位) | ||
+ | * <code>read_timer</code><font class="goog-text-highlight">入力デバイスを登録するには、</font><code>lv_timer</code>入力デバイスを読み取るへのポインタ。そのパラメータは<code>lv_timer_...()</code>関数によって変更できます。<code>LV_INDEV_DEF_READ_PERIOD</code>in<code>lv_conf.h</code>は、デフォルトの読み取り期間を設定します。 | ||
|} | |} | ||
:[[App:Library:LVGL:docs:Porting|戻る : Previous]] | :[[App:Library:LVGL:docs:Porting|戻る : Previous]] | ||
256行目: | 404行目: | ||
| | | | ||
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>read_cb</code>て、で指定することもできます。任意のタイプのイベントが(そのタイプに関係なく)入力デバイスによって送信されたときに呼び出されます。これにより、ユーザーにフィードバックを生成できます。たとえば、でサウンドを再生できます。 <code>feedback_cblv_indev_drv_tfeedback_cbLV_EVENT_CLICKED</code> |
|} | |} | ||
:[[App:Library:LVGL:docs:Porting|戻る : Previous]] | :[[App:Library:LVGL:docs:Porting|戻る : Previous]] | ||
268行目: | 416行目: | ||
| | | | ||
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>lv_disp_set_default()</code>)作成または明示的に選択された最後のディスプレイに新しい入力デバイスが追加されます。<code>disp</code>関連する表示が保存され、ドライバーのフィールドで 変更できます。 |
|} | |} | ||
:[[App:Library:LVGL:docs:Porting|戻る : Previous]] | :[[App:Library:LVGL:docs:Porting|戻る : Previous]] | ||
283行目: | 431行目: | ||
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. | 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>read_cb</code>定期的に呼び出します。この断続的なポーリングのために、一部のユーザージェスチャが見落とされる可能性があります。 |
+ | |||
+ | これを解決するために、測定データをバッファリングする入力デバイス用のイベント駆動型ドライバーを作成できます。では<code>read_cb</code>、入力デバイスを直接読み取る代わりに、バッファリングされたデータをレポートできます。フラグを設定する<code>data->continue_reading</code>と、LVGLに読み取るデータがさらにあることが通知され、<code>read_cb</code>再度呼び出す必要があります。 | ||
|} | |} | ||
:[[App:Library:LVGL:docs:Porting|戻る : Previous]] | :[[App:Library:LVGL:docs:Porting|戻る : Previous]] | ||
297行目: | 447行目: | ||
* [https://docs.lvgl.io/8.2/overview/display.html '''INdev features'''] to learn more about higher level input device features. | * [https://docs.lvgl.io/8.2/overview/display.html '''INdev features'''] to learn more about higher level input device features. | ||
| | | | ||
+ | * 独自のドライバーのテンプレートの'''lv_port_indev_template.c 。''' | ||
+ | * [https://docs.lvgl.io/8.2/overview/display.html]より高いレベルの入力デバイス機能についてさらに学ぶための'''INdev機能。''' | ||
|} | |} | ||
:[[App:Library:LVGL:docs:Porting|戻る : Previous]] | :[[App:Library:LVGL:docs:Porting|戻る : Previous]] | ||
320行目: | 472行目: | ||
: The main input device descriptor with driver, runtime data ('proc') and some additional information | : The main input device descriptor with driver, runtime data ('proc') and some additional information | ||
| | | | ||
+ | |||
+ | |||
+ | @description入力デバイスHALインターフェイスレイヤーヘッダーファイル | ||
+ | |||
+ | Typedef | ||
+ | |||
+ | typedef struct _ lv_indev_drv_t lv_indev_drv_t | ||
+ | |||
+ | : ユーザーによって初期化され、「lv_indev_add()」によって登録されます | ||
+ | |||
+ | typedef struct _ lv_indev_proc_t _lv_indev_proc_t | ||
+ | |||
+ | : 入力デバイスの実行時データライブラリによって内部的に使用されるため、ライブラリに触れる必要はありません。 | ||
+ | |||
+ | typedef struct _ lv_indev_t lv_indev_t | ||
+ | |||
+ | : ドライバー、ランタイムデータ(「proc」)、およびいくつかの追加情報を含むメイン入力デバイス記述子 | ||
|} | |} | ||
:[[App:Library:LVGL:docs:Porting|戻る : Previous]] | :[[App:Library:LVGL:docs:Porting|戻る : Previous]] | ||
350行目: | 519行目: | ||
: <span style="background-color: #eeeeee;">enumerator LV_INDEV_STATE_PRESSED </span> | : <span style="background-color: #eeeeee;">enumerator LV_INDEV_STATE_PRESSED </span> | ||
| | | | ||
+ | |||
+ | |||
+ | 列挙型lv_indev_type_t | ||
+ | |||
+ | : 可能な入力デバイスタイプ ''値:'' | ||
+ | : 列挙子LV_INDEV_TYPE_NONE | ||
+ | :: 初期化されていない状態 | ||
+ | : 列挙子LV_INDEV_TYPE_POINTER | ||
+ | :: タッチパッド、マウス、外部ボタン | ||
+ | : 列挙子LV_INDEV_TYPE_KEYPAD | ||
+ | :: キーパッドまたはキーボード | ||
+ | : 列挙子LV_INDEV_TYPE_BUTTON | ||
+ | :: 画面の特定のポイントに割り当てられている外部(ハードウェアボタン) | ||
+ | : 列挙子LV_INDEV_TYPE_ENCODER | ||
+ | :: 左折、右折、ボタンのみのエンコーダ | ||
+ | |||
+ | 列挙型lv_indev_state_t | ||
+ | |||
+ | : 入力デバイスの状態 | ||
+ | : ''値:'' | ||
+ | : 列挙子LV_INDEV_STATE_RELEASED | ||
+ | :: | ||
+ | : 列挙子LV_INDEV_STATE_PRESSED | ||
|} | |} | ||
:[[App:Library:LVGL:docs:Porting|戻る : Previous]] | :[[App:Library:LVGL:docs:Porting|戻る : Previous]] | ||
519行目: | 711行目: | ||
:: Array points assigned to the button ()screen will be pressed here by the buttons | :: Array points assigned to the button ()screen will be pressed here by the buttons | ||
| | | | ||
+ | |||
+ | |||
+ | void lv_indev_drv_init(struct _ lv_indev_drv_t * driver) | ||
+ | |||
+ | : 入力デバイスドライバーをデフォルト値で初期化します。これは、メモリジャンクではなく、フィールドに既知の値を確実に持つために使用されます。その後、フィールドを設定できます。 | ||
+ | : '''パラメーター''' | ||
+ | :: '''driver-初期化するドライバー'''変数へのポインター | ||
+ | |||
+ | '''lv_indev_t''' * lv_indev_drv_register(struct _ lv_indev_drv_t * driver) | ||
+ | |||
+ | : 初期化された入力デバイスドライバを登録します。 | ||
+ | : '''パラメーター''' | ||
+ | :: '''driver-'''初期化された'lv_indev_drv_t'変数へのポインター(ローカル変数にすることができます) | ||
+ | : '''戻り値''' | ||
+ | :: 新しい入力デバイスへのポインタ、またはエラーの場合はNULL | ||
+ | |||
+ | void lv_indev_drv_update('''lv_indev_t''' * indev、struct _lv_indev_drv_t * new_drv) | ||
+ | |||
+ | : 実行時にドライバーを更新します。 | ||
+ | : '''パラメーター''' | ||
+ | ::* '''indev--'''入力デバイスへのポインタ。(の戻り値<code>lv_indev_drv_register</code>) | ||
+ | ::* '''new_drv--'''新しいドライバへのポインタ | ||
+ | |||
+ | void lv_indev_delete('''lv_indev_t''' * indev) | ||
+ | |||
+ | : 付属の入力デバイスを取り外します。その後、付属の入力デバイスを使用しないように注意してください。 | ||
+ | : '''パラメーター''' | ||
+ | :: '''indev--'''削除するポインタ | ||
+ | |||
+ | '''lv_indev_t''' * lv_indev_get_next( '''lv_indev_t''' * indev) | ||
+ | |||
+ | : 次の入力デバイスを取得します。 | ||
+ | : '''パラメーター''' | ||
+ | :: '''indev--'''現在の入力デバイスへのポインタ。初期化するにはNULL。 | ||
+ | : '''戻り値''' | ||
+ | :: 次の入力デバイス。それ以上ない場合はNULL。パラメータがNULLの場合、最初の入力デバイスを提供します | ||
+ | |||
+ | void _lv_indev_read('''lv_indev_t''' * indev、'''lv_indev_data_t''' * data) | ||
+ | |||
+ | : 入力デバイスからデータを読み取ります。 | ||
+ | : '''パラメーター''' | ||
+ | ::* '''indev-'''入力デバイスへのポインタ | ||
+ | ::* '''data-'''入力デバイスはここにデータを書き込みます | ||
+ | |||
+ | struct lv_indev_data_t | ||
+ | |||
+ | : ''#include <lv_hal_i'ndev.h>'' | ||
+ | : 入力ドライバーに渡されて入力されるデータ構造 | ||
+ | : '''パブリックメンバー''' | ||
+ | : lv_point_tポイント | ||
+ | :: LV_INDEV_TYPE_POINTERの場合、現在押されているポイント | ||
+ | : uint32_tキー | ||
+ | :: LV_INDEV_TYPE_KEYPADの場合、現在押されているキー | ||
+ | : uint32_t btn_id | ||
+ | :: LV_INDEV_TYPE_BUTTONの場合、現在押されているボタン | ||
+ | : int16_t enc_diff | ||
+ | :: LV_INDEV_TYPE_ENCODERの場合、前回の読み取り以降のステップ数 | ||
+ | : '''lv_indev_state_t'''状態 | ||
+ | :: LV_INDEV_STATE_RELまたはLV_INDEV_STATE_PR | ||
+ | : bool continue_reading | ||
+ | :: trueに設定すると、読み取りコールバックが再度呼び出されます | ||
+ | |||
+ | struct _lv_indev_drv_t | ||
+ | |||
+ | : ''#include <lv_hal_i'ndev.h>'' | ||
+ | : ユーザーによって初期化され、「lv_indev_add()」によって登録されます | ||
+ | : | ||
+ | : '''パブリックメンバー''' | ||
+ | : '''lv_indev_type_t'''タイプ | ||
+ | :: <入力デバイスタイプ入力デバイスデータを読み取るための関数ポインタ。 | ||
+ | : void(* read_cb)(struct _ '''lv_indev_drv_t''' * indev_drv、'''lv_indev_data_t''' * data) | ||
+ | :: | ||
+ | : void(* Feedback_cb)(struct _ '''lv_indev_drv_t''' *、uint8_t) | ||
+ | :: 入力デバイスでアクションが発生したときに呼び出されます。 | ||
+ | :: 2番目のパラメータはからのイベントです<code>lv_event_t</code> | ||
+ | : void * user_data | ||
+ | :: | ||
+ | : struct _ '''lv_disp_t''' * disp | ||
+ | :: <入力デバイスを定期的に読み取るための割り当てられたディスプレイタイマーへのポインタ | ||
+ | : '''lv_timer_t''' * read_timer | ||
+ | :: オブジェクトを実際にドラッグする前にスライドするピクセル数 | ||
+ | : uint8_t scroll_limit | ||
+ | :: [%]でスロースローダウンをドラッグします。 | ||
+ | :: 値が大きいほど、速度が速くなります | ||
+ | : uint8_t scroll_throw | ||
+ | :: ジェスチャーとして評価するには、少なくともこの違いは2つのポイントの間にある必要があります | ||
+ | : uint8_tジェスチャー_min_velocity | ||
+ | :: 少なくともこの違いは、ジェスチャーを送信することです | ||
+ | : uint8_tジェスチャー制限 | ||
+ | :: ミリ秒単位の長押し時間 | ||
+ | : uint16_t long_press_time | ||
+ | :: 長押しで繰り返されるトリガー期間[ms] | ||
+ | : uint16_t long_press_repeat_time | ||
+ | :: | ||
+ | |||
+ | struct _lv_indev_proc_t | ||
+ | |||
+ | : ''#include <lv_hal_indev.h>''入力デバイスの実行時データライブラリによって内部的に使用されるため、ライブラリに触れる必要はありません。 | ||
+ | : | ||
+ | : '''パブリックメンバー''' | ||
+ | : '''lv_indev_state_t'''状態 | ||
+ | :: 入力デバイスの現在の状態。 | ||
+ | : uint8_t long_pr_sent | ||
+ | :: | ||
+ | : uint8_t reset_query | ||
+ | :: | ||
+ | : uint8_tが無効 | ||
+ | :: | ||
+ | : uint8_t wait_until_release | ||
+ | :: | ||
+ | : lv_point_t act_point | ||
+ | :: 入力デバイスの現在のポイント。 | ||
+ | : lv_point_t last_point | ||
+ | :: 入力デバイスの最後のポイント。 | ||
+ | : lv_point_t last_raw_point | ||
+ | :: read_cbから読み取られた最後のポイント。 | ||
+ | : lv_point_t vect | ||
+ | :: <font class="goog-text-highlight">入力デバイスを登録するには、</font><code>act_point</code>との違い<code>last_point</code>。 | ||
+ | : lv_point_t scroll_sum | ||
+ | :: | ||
+ | : lv_point_t scroll_throw_vect | ||
+ | :: | ||
+ | : lv_point_t scroll_throw_vect_ori | ||
+ | :: | ||
+ | : struct _ '''lv_obj_t''' * act_obj | ||
+ | :: | ||
+ | : struct _ '''lv_obj_t''' * last_obj | ||
+ | :: | ||
+ | : struct _ '''lv_obj_t''' * scroll_obj | ||
+ | :: | ||
+ | : struct _ '''lv_obj_t''' * last_pressed | ||
+ | :: | ||
+ | : lv_area_t scroll_area | ||
+ | :: | ||
+ | : lv_point_tジェスチャー_sum | ||
+ | :: | ||
+ | : lv_dir_t scroll_dir | ||
+ | :: | ||
+ | : lv_dir_tジェスチャー_dir | ||
+ | :: | ||
+ | : uint8_tジェスチャー_送信済み | ||
+ | :: | ||
+ | : struct _ '''lv_indev_proc_t''' :: [anonymous]::[anonymous]ポインタ | ||
+ | :: | ||
+ | : '''lv_indev_state_t''' last_state | ||
+ | :: | ||
+ | : uint32_t last_key | ||
+ | :: | ||
+ | : struct _ lv_indev_proc_t :: [anonymous]::[anonymous]キーパッド | ||
+ | :: | ||
+ | : union _ lv_indev_proc_t ::[匿名]タイプ | ||
+ | :: | ||
+ | : uint32_t pr_timestamp | ||
+ | :: 押されたタイムスタンプ | ||
+ | : uint32_t longpr_rep_timestamp | ||
+ | :: 長押しリピートタイムスタンプ | ||
+ | |||
+ | struct _lv_indev_t | ||
+ | |||
+ | : ''#include <lv_h'al_indev.h '''>'''''<nowiki/>'''ドライバー、ランタイムデータ('proc')、およびいくつかの追加情報を含むメイン入力デバイス記述子パブリックメンバー''' | ||
+ | : struct _ '''lv_indev_drv_t''' * driver | ||
+ | :: | ||
+ | : '''_lv_indev_proc_t''' proc | ||
+ | :: | ||
+ | : struct _ '''lv_obj_t''' * cursor | ||
+ | :: LV_INPUT_TYPE_POINTERのカーソル | ||
+ | : struct _ '''lv_group_t''' * group | ||
+ | :: キーパッドの宛先グループ | ||
+ | : const lv_point_t * btn_points | ||
+ | :: ボタン()画面に割り当てられた配列ポイントは、ここでボタンによって押されます | ||
|} | |} | ||
:[[App:Library:LVGL:docs:Porting|戻る : Previous]] | :[[App:Library:LVGL:docs:Porting|戻る : Previous]] |
2022年6月22日 (水) 14:10時点における版
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 |
コールバックに加えread_cb て、で指定することもできます。任意のタイプのイベントが(そのタイプに関係なく)入力デバイスによって送信されたときに呼び出されます。これにより、ユーザーにフィードバックを生成できます。たとえば、でサウンドを再生できます。 feedback_cblv_indev_drv_tfeedback_cbLV_EVENT_CLICKED
|
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 |
すべての入力デバイスはディスプレイに関連付けられています。デフォルトでは、(を使用してlv_disp_set_default() )作成または明示的に選択された最後のディスプレイに新しい入力デバイスが追加されます。disp 関連する表示が保存され、ドライバーのフィールドで 変更できます。
|
Buffered reading
英文 | 自動翻訳 |
---|---|
By default, LVGL calls
|
デフォルトでは、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
|