hardware/peripherals/kscan.html · hardware/peripherals/kscan.rst 공식 원문 ↗

Zephyr 3.7.0 · Hardware · Peripherals · Keyboard Scan

Keyboard Scan

적은 pin으로 matrix row·column을 읽어 key event를 찾는 방법을 설명합니다.

Official pathhardware/peripherals/kscan.html
Source filehardware/peripherals/kscan.rst
Source versionZephyr 3.7.0
TranslationFull · reviewed

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

Part 1

요약·해설

Physical key 배열, electrical matrix, manufacturer keymap의 역할을 구분합니다.

Matrix

rows · columns

Mapping

manufacturer keymap

Part 2

접을 수 있는 영어 원문 전체

영어 원문 전체 펼치기
원문 SHA-256 B287BB756A9BB49E6907BFCDF0798E153688CBE6846BE872CD34E7D1C4AC504C
.. _kscan_api:


Keyboard Scan
#############

Overview
********
The kscan driver (keyboard scan matrix) is used for detecting a key press in a
connected matrix keyboard or any device with buttons such as joysticks.
Typically, matrix keyboards are implemented using a two-dimensional
configuration in order to sense several keys.  This allows interfacing to
many keys through fewer physical pins. Keyboard matrix
drivers read the rows while applying power through the columns one at a time
with the purpose of detecting key events.
There is no correlation between the physical and electrical layout of keys.
For, example, the physical layout may be one array of 16 or fewer keys, which
may be electrically connected to a 4 x 4 array. In addition, key values are
defined by a keymap provided by the keyboard manufacturer.

Configuration Options
*********************

Related configuration options:

* :kconfig:option:`CONFIG_KSCAN`

API Reference
*************

.. doxygengroup:: kscan_interface

Part 3

한국어 전문 번역

Overview

Kscan driver(keyboard scan matrix)는 연결된 matrix keyboard의 key press, 또는 joystick처럼 button이 있는 device의 입력을 감지합니다.

Matrix keyboard는 보통 적은 수의 physical pin으로 많은 key에 연결하기 위해 2차원 구성으로 구현합니다. Keyboard matrix driver는 column에 하나씩 차례로 power를 공급하면서 row를 읽어 key event를 감지합니다.

Key의 physical layout과 electrical layout 사이에는 직접적인 상관관계가 없습니다. 예를 들어 물리적으로 16개 이하의 key가 한 줄처럼 배치돼도 전기적으로는 4 x 4 array로 연결될 수 있습니다. Key value는 keyboard manufacturer가 제공한 keymap으로 정의합니다.

Configuration Options

관련 configuration option은 CONFIG_KSCAN입니다.

API Reference

kscan_interface Doxygen group이 keyboard scan interface의 공식 API reference를 제공합니다.

Source

출처

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