samples/sensor/grow_r502a/README.html · samples/sensor/grow_r502a/README.rst 공식 원문 ↗

Zephyr 3.7.0 · Samples · Sensor · Biometrics

GROW R502-A fingerprint sensor

UART와 GPIO를 구성하고 fingerprint library에서 enroll·match·delete lifecycle을 실행합니다.

Official pathsamples/sensor/grow_r502a/README.html
Source filesamples/sensor/grow_r502a/README.rst
Source versionZephyr 3.7.0
TranslationFull · reviewed

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

Part 1

요약·해설

일곱 기능, SENSOR_ATTR와 SENSOR_TRIG_TOUCH 조건, 실제 ID·confidence 출력을 보존합니다.

Records

Add · Find · Delete

Transport

UART

Result

ID · Confidence

Part 2

접을 수 있는 영어 원문 전체

영어 원문 전체 펼치기
원문 SHA-256 B1A0D62E3DF15E6D0EC2C755376293F45FB24C357F452AED48BCDD94B60D0BCF
.. _grow_r502a:

GROW_R502A Fingerprint Sensor
#############################

Overview
********

This sample has the below functionalities:

#. Sensor LED is controlled using led APIs from zephyr subsystem.
#. Shows the number of fingerprints stored in the sensor.
#. Shows the sensor device's configurations like baud rate, library size, address and data packet size in UART frame.
#. When SENSOR_ATTR_RECORD_FREE_IDX is set then it search for free index in sensor library.
#. When SENSOR_ATTR_RECORD_ADD is set then it adds a new fingerprint to the sensor.
#. When SENSOR_ATTR_RECORD_FIND is set then it tries to find a match for the input fingerprint. On finding a match it returns ID and confidence.
#. When SENSOR_ATTR_RECORD_DEL is set then it deletes a fingerprint from the sensor.

Note: Fingerprint add functionality work only when SENSOR_TRIG_TOUCH is set.

Wiring
*******

This sample uses an external breakout for the sensor.  A devicetree
overlay must be provided to identify the UART bus and the GPIO
used to control the sensor. Sensor can be powered using mentioned optional GPIO.

References
**********

For more information about the GROW_R502A Fingerprint Sensor see
http://en.hzgrow.com/product/143.html

Building and Running
********************

After providing a devicetree overlay that specifies the sensor location,
build this sample app using:

.. zephyr-app-commands::
   :zephyr-app: samples/sensor/grow_r502a
   :board: esp32_devkitc_wroom/esp32/procpu
   :goals: build flash

Sample Output
*************

.. code-block:: console

    *** Booting Zephyr OS build v3.6.0-3147-g8ae1a2e2718e ***
    template count : 4
    baud 57600
    addr 0xffffffff
    lib_size 200
    data_pkt_size 128
    Fingerprint Deleted at ID #3
    Fingerprint template free idx at ID #3
    Waiting for valid finger to enroll as ID #3
    Place your finger
    Fingerprint successfully stored at #3
    template count : 4
    Matched ID : 2
    confidence : 110
    <repeats endlessly>

Part 3

한국어 전문 번역

개요

이 sample은 다음 기능을 제공합니다.

  1. Zephyr subsystem의 LED API로 sensor LED를 제어합니다.
  2. Sensor에 저장된 fingerprint 수를 표시합니다.
  3. UART frame의 baud rate, library size, address와 data packet size 같은 sensor device configuration을 표시합니다.
  4. SENSOR_ATTR_RECORD_FREE_IDX를 설정하면 sensor library에서 비어 있는 index를 찾습니다.
  5. SENSOR_ATTR_RECORD_ADD를 설정하면 새 fingerprint를 sensor에 추가합니다.
  6. SENSOR_ATTR_RECORD_FIND를 설정하면 입력 fingerprint와 일치하는 record를 찾고, 일치하면 ID와 confidence를 반환합니다.
  7. SENSOR_ATTR_RECORD_DEL을 설정하면 fingerprint를 sensor에서 삭제합니다.

Fingerprint 추가 기능은 SENSOR_TRIG_TOUCH가 설정되어 있을 때만 동작합니다.

배선

이 sample은 외부 sensor breakout을 사용합니다. UART bus와 sensor 제어용 GPIO를 식별하는 Devicetree overlay를 제공해야 합니다. 선택적인 GPIO로 sensor에 전원을 공급할 수도 있습니다.

참고 자료

빌드 및 실행

Sensor 위치를 지정하는 Devicetree overlay를 준비한 뒤 다음 명령으로 sample application을 build하고 flash합니다.

# From the root of the zephyr repository
west build -b esp32_devkitc_wroom/esp32/procpu samples/sensor/grow_r502a
west flash

출력 예

*** Booting Zephyr OS build v3.6.0-3147-g8ae1a2e2718e ***
template count : 4
baud 57600
addr 0xffffffff
lib_size 200
data_pkt_size 128
Fingerprint Deleted at ID #3
Fingerprint template free idx at ID #3
Waiting for valid finger to enroll as ID #3
Place your finger
Fingerprint successfully stored at #3
template count : 4
Matched ID : 2
confidence : 110
<repeats endlessly>

예제에서는 ID 3을 삭제한 뒤 free index 3을 찾아 새 지문을 등록하고, 입력 지문을 ID 2와 confidence 110으로 일치시킵니다.

Source

출처

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