build/dts/api/bindings/input/zephyr,lvgl-keypad-input.html · build/dts/api/bindings/input/zephyr,lvgl-keypad-input.rst 공식 원문 ↗

Zephyr 3.7.0 · Devicetree · Input · Zephyr-specific binding

Zephyr LVGL Keypad Input 바인딩

Zephyr input code를 LVGL navigation·keypad code로 mapping를 정의하는 3개 property schema입니다.

Official pathbuild/dts/api/bindings/input/zephyr,lvgl-keypad-input.html
Source filebuild/dts/api/bindings/input/zephyr,lvgl-keypad-input.rst
Source versionZephyr 3.7.0
TranslationFull · reviewed

본문 기준: Zephyr 3.7.0 LTS3 · 이후 유지보수 패치는 별도입니다.

Part 1

요약·해설

공식 원문 106줄과 property 3행을 전수 대조해 parallel input/LVGL code mapping·optional source filtering·special LVGL keys 제약을 보존했습니다.

Compatible

zephyr,lvgl-keypad-input

Vendor

Zephyr-specific binding

Properties

3 rows

Interface

Zephyr key events → LVGL keypad keys

Part 2

접을 수 있는 영어 원문 전체

영어 원문 전체 펼치기
원문 SHA-256 34EF552904C0A37E9811CC32EE2F082EA12CD02C1F50CF833F4E27CF8E66561B
:orphan:

.. raw:: html

    <!--
    FIXME: do not limit page width until content uses another representation
    format other than tables
    -->
    <style>.wy-nav-content { max-width: none; !important }</style>

.. dtcompatible:: zephyr,lvgl-keypad-input
.. _dtbinding_zephyr_lvgl_keypad_input:

zephyr,lvgl-keypad-input
########################

Vendor: :ref:`Zephyr-specific binding <dt_vendor_zephyr>`

Description
***********



.. code-block:: none

   LVGL keypad indev pseudo-device

   Listens for input events and routes the
   lv_indev_data_t to the underlying keypad lv_indev_t managed by LVGL.

   The property input-codes can be used to setup a mapping of input codes
   to the lvgl keys. There are lvgl keys that have a special function:
   https://docs.lvgl.io/master/overview/indev.html#keys.

   The pseudo device can be associated to a specific device to listen only
   for events from that device. Example configuration:

   #include <zephyr/dt-bindings/lvgl/lvgl.h>

   keypad {
           compatible = "zephyr,lvgl-keypad-input";
           input = <&buttons>;
           input-codes = <INPUT_KEY_1 INPUT_KEY_2>;
           lvgl-codes = <LV_KEY_NEXT LV_KEY_PREV>;
   };

Properties
**********

.. tabs::

   .. group-tab:: Node specific properties

      Properties not inherited from the base binding file.

      .. list-table::
         :widths: 1 1 4
         :header-rows: 1

         * - Name
           - Type
           - Details

         * - ``input``
           - ``phandle``
           - .. code-block:: none

                Input device phandle.



         * - ``input-codes``
           - ``array``
           - .. code-block:: none

                Array of input event key codes (INPUT_KEY_* or INPUT_BTN_*).



             This property is **required**.

         * - ``lvgl-codes``
           - ``array``
           - .. code-block:: none

                Array of mapped lvgl keys.



             This property is **required**.



   .. group-tab:: Deprecated node specific properties

      Deprecated properties not inherited from the base binding file.

      (None)

   .. group-tab:: Base properties

      Properties inherited from the base binding file, which defines
      common properties that may be set on many nodes. Not all of these
      may apply to the "zephyr,lvgl-keypad-input" compatible.

      (None)


Part 3

한국어 전문 번역

zephyr,lvgl-keypad-input

Vendor: Zephyr-specific binding

공식 설명

LVGL keypad indev pseudo-device

Listens for input events and routes the
lv_indev_data_t to the underlying keypad lv_indev_t managed by LVGL.

The property input-codes can be used to setup a mapping of input codes
to the lvgl keys. There are lvgl keys that have a special function:
https://docs.lvgl.io/master/overview/indev.html#keys.

The pseudo device can be associated to a specific device to listen only
for events from that device. Example configuration:

#include <zephyr/dt-bindings/lvgl/lvgl.h>

keypad {
        compatible = "zephyr,lvgl-keypad-input";
        input = <&buttons>;
        input-codes = <INPUT_KEY_1 INPUT_KEY_2>;
        lvgl-codes = <LV_KEY_NEXT LV_KEY_PREV>;
};

LVGL keypad indev pseudo-device

Input event를 LVGL이 관리하는 keypad lv_indev_t로 전달합니다. input-codes와 lvgl-codes가 모두 필수이며 두 배열이 code mapping을 구성합니다.

input phandle을 제공하면 특정 device event만 듣습니다. 공식 예는 INPUT_KEY_1·INPUT_KEY_2를 LV_KEY_NEXT·LV_KEY_PREV에 대응시킵니다.

LVGL special key의 의미는 외부 LVGL 문서 링크로 안내되며, 배열 길이 불일치와 duplicate mapping 처리 규칙은 이 schema가 설명하지 않습니다.

속성 전체 번역

공식 node-specific 3개 property를 번역했으며 base property 표는 비어 있습니다.

노드 전용 속성 · 3개
이름형식설명과 제약
inputphandleEvent를 받을 특정 input device의 phandle입니다.
input-codesarrayCAP1203 channel에 대응할 INPUT_KEY_* 또는 INPUT_BTN_* event code 배열입니다.
필수
lvgl-codesarrayInput code에 대응시킬 LVGL key 배열입니다.
필수

Source

출처

영어 원문에는 문단, 문서 지시문, 표, 코드, 코드 심벌, 경로를 그대로 보존했습니다.