summaryrefslogtreecommitdiff
path: root/driver/fingerprint/elan/elan_setting.h
blob: feaf5e155082b7db202caf46aad6ccac141a4fc9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
/* Copyright 2021 The Chromium OS Authors. All rights reserved.
 * Use of this source code is governed by a BSD-style license that can be
 * found in the LICENSE file.
 */

#ifndef ELAN_SETTING_H
#define ELAN_SETTING_H

#include <stdint.h>

/* The hardware ID information and FW version */
#define VID 0x04F3
#define PID 0x0903
#define MID 0x01
#define VERSION 0x100B

/* SPI tx and rx buffer size */
#define CONFIG_SPI_TX_BUF_SIZE 1024
#define CONFIG_SPI_RX_BUF_SIZE 5120

/**
 * Elan sensor operation is controlled by sending commands and receiving
 * through the SPI interface. There are several SPI command codes for
 * controlling FP sensor:
 *
 * - START_SCAN            Start scan
 * - START_READ_IMAGE      Start read the image
 * - SRST                  Software reset
 * - FUSE_LOAD             Load OTP trims data to control registers
 * - READ_REG_HEAD         Register single read
 * - WRITE_REG_HEAD        Register burst write
 * - READ_SERIER_REG_HEAD  Register burst read
 * - PAGE_SEL              Register page selection
 * - SENSOR_STATUS         Read sensor status
 */
#define START_SCAN 0x01
#define START_READ_IMAGE 0x10
#define SRST 0x31
#define FUSE_LOAD 0x04
#define READ_REG_HEAD 0x40
#define WRITE_REG_HEAD 0x80
#define READ_SERIER_REG_HEAD 0xC0
#define PAGE_SEL 0x07
#define SENSOR_STATUS 0x03

/* Sensor type name */
#define EFSA515 1
#define EFSA80SC 2
#if defined(CONFIG_FP_SENSOR_ELAN80)
#define IC_SELECTION EFSA80SC
#elif defined(CONFIG_FP_SENSOR_ELAN515)
#define IC_SELECTION EFSA515
#endif

/* Sensor pixel resolution */
#if (IC_SELECTION == EFSA80SC)
#define IMAGE_WIDTH 80
#define IMAGE_HEIGHT 80
#elif (IC_SELECTION == EFSA515)
#define IMAGE_WIDTH 150
#define IMAGE_HEIGHT 52
#endif

/**
 * Sensor real image size:
 * ((IMAGE_HEIGHT * ONE_PIXEL_BYTE) + FP_DUMMY_BYTE) * IMAGE_WIDTH
 */
#define FP_DUMMY_BYTE 2
#define ONE_PIXEL_BYTE 2
#define IMAGE_TOTAL_PIXEL (IMAGE_WIDTH * IMAGE_HEIGHT)
#define RAW_PIXEL_SIZE (IMAGE_HEIGHT * ONE_PIXEL_BYTE)
#define RAW_DATA_SIZE (RAW_PIXEL_SIZE + FP_DUMMY_BYTE)
#define IMG_BUF_SIZE (RAW_DATA_SIZE * IMAGE_WIDTH)

/* Polling scan status counter */
#define POLLING_SCAN_TIMER 10000

/* Re-calibration timer */
#define REK_TIMES 3

/* Console output macros */
#define LOGE_SA(format, args...) cprints(CC_FP, format, ##args)

/**
 * Set ELAN fingerprint sensor register initialization
 *
 * @return 0 on success.
 *         negative value on error.
 */
int register_initialization(void);

/**
 * To calibrate ELAN fingerprint sensor and keep the calibration results
 * for correcting fingerprint image data
 *
 * @return 0 on success.
 *         negative value on error.
 */
int calibration(void);

#endif /* _ELAN_SETTING_H */