![]() |
SparkFun Fingerprint Sensor - FPC2534 Pro
v0.9.9-3-g5d0d172
Library for the SparkFun Fingerprint Sensor - FPC2534 Pro
|
FPC AllKey Pro API. More...
#include <stdint.h>Go to the source code of this file.
Classes | |
| struct | fpc_frame_hdr_t |
| Frame Header. More... | |
| struct | fpc_cmd_hdr_t |
| Command Header. More... | |
| struct | fpc_frame_hdr_sec_addon_t |
| Frame Header Addon for secure Protocol. More... | |
| struct | fpc_cmd_status_response_t |
| Payload definition of the CMD_STATUS Response / Event. More... | |
| struct | fpc_cmd_version_response_t |
| Payload definition of the CMD_VERSION Response. More... | |
| struct | fpc_cmd_set_crypto_key_request_t |
| Payload definition AES Key Provisioning CMD_SET_CRYPTO_KEY Request. More... | |
| struct | fpc_id_type_t |
| Template ID specifier payload. More... | |
| struct | fpc_cmd_capture_request_t |
| Payload definition of the CMD_CAPTURE Request command. More... | |
| struct | fpc_cmd_enroll_request_t |
| Payload definition of the CMD_ENROLL Request. More... | |
| struct | fpc_cmd_enroll_status_response_t |
| Payload definition of the CMD_ENROLL Status Event. More... | |
| struct | fpc_cmd_identify_request_t |
| Payload definition of the CMD_IDENTIFY Request. More... | |
| struct | fpc_cmd_identify_status_response_t |
| Payload definition of the CMD_IDENTIFY Event. More... | |
| struct | fpc_cmd_template_delete_request_t |
| Payload definition of the CMD_DELETE_TEMPLATE Request. More... | |
| struct | fpc_cmd_template_info_response_t |
| Payload definition of the CMD_LIST_TEMPLATES Response. More... | |
| struct | fpc_cmd_template_data_request_t |
| Payload definition of the Template Data (GET & PUT) Request. More... | |
| struct | fpc_cmd_template_data_response_t |
| Payload definition of the Template Data Response. More... | |
| struct | fpc_cmd_image_request_t |
| Payload definition of the Image request command. More... | |
| struct | fpc_cmd_image_response_t |
| Payload definition of the Image response command. More... | |
| struct | fpc_cmd_navigation_request_t |
| Payload definition of the CMD_NAVIGATION Request. More... | |
| struct | fpc_cmd_navigation_status_event_t |
| Payload definition of the CMD_NAVIGATION Event. More... | |
| struct | fpc_cmd_navigation_ps_status_event_t |
| Payload definition of the CMD_NAVIGATION_PS Event. More... | |
| struct | fpc_cmd_data_put_request_t |
| Payload for CMD_DATA_PUT request. More... | |
| struct | fpc_cmd_data_put_response_t |
| Payload for CMD_DATA_PUT response. More... | |
| struct | fpc_cmd_data_get_request_t |
| Payload for CMD_DATA_GET request. More... | |
| struct | fpc_cmd_data_get_response_t |
| Payload for CMD_DATA_GET response. More... | |
| struct | fpc_system_config_t |
| System Configuration parameters. More... | |
| struct | fpc_cmd_get_config_request_t |
| Payload definition of the CMD_GET_SYSTEM_CONFIG Request. More... | |
| struct | fpc_cmd_get_config_response_t |
| Payload definition of the CMD_GET_SYSTEM_CONFIG Response. More... | |
| struct | fpc_cmd_set_config_request_t |
| Payload definition of the CMD_SET_SYSTEM_CONFIG Request. More... | |
| struct | fpc_cmd_pinctrl_gpio_request_t |
| Payload definition of the CMD_GPIO_CONTROL Request. More... | |
| struct | fpc_cmd_pinctrl_gpio_response_t |
| Payload definition of the CMD_GPIO_CONTROL Response. More... | |
| struct | fpc_cmd_bist_response_t |
Typedefs | |
| typedef uint16_t | fpc_result_t |
Enumerations | |
| enum | fpc_cmd_data_type_t { FPC_CMD_DATA_TYPE_NONE , FPC_CMD_DATA_TYPE_RAM , FPC_CMD_DATA_TYPE_FILE } |
FPC AllKey Pro API.
This is the Command Interface for the Fingerprint Sensor Module fpc2534.
| #define CFG_SYS_FLAG_ALLOW_FACTORY_RESET 0x00000100 |
By default, it is not allowed to do a factory reset (remove templates, AES keys and configuration data). By setting this flag, it becomes an allowed operation.
| #define CFG_SYS_FLAG_STATUS_EVT_AT_BOOT 0x00000001 |
System Configuration Flags.
Send Status Event after system boot.
| #define CFG_SYS_FLAG_UART_IN_STOP_MODE 0x00000010 |
Let system go into stop mode when using UART interface. This requires the system to be woken via wake-up pin (CS) before sending any UART data to host.
| #define CFG_SYS_FLAG_UART_IRQ_BEFORE_TX 0x00000020 |
Set IRQ pin before SiP sends UART data. The delay between IRQ and start of data is configurable via uart_delay_before_irq_ms
| #define CFG_UART_BAUDRATE_115200 4 |
| #define CFG_UART_BAUDRATE_19200 2 |
| #define CFG_UART_BAUDRATE_57600 3 |
| #define CFG_UART_BAUDRATE_921600 5 |
| #define CFG_UART_BAUDRATE_9600 1 |
UART baudrate definitions.
| #define CFG_VERSION 2 |
Version of System Configuration Structure
| #define CMD_ABORT 0x0052 |
| #define CMD_BIST 0x0044 |
| #define CMD_CAPTURE 0x0050 |
| #define CMD_DATA_GET 0x0101 |
| #define CMD_DATA_PUT 0x0102 |
| #define CMD_DELETE_TEMPLATE 0x0061 |
| #define CMD_ENROLL 0x0054 |
| #define CMD_FACTORY_RESET 0x00FA |
| #define CMD_GET_SYSTEM_CONFIG 0x006A |
| #define CMD_GET_TEMPLATE_DATA 0x0062 |
| #define CMD_GPIO_CONTROL 0x0300 |
| #define CMD_IDENTIFY 0x0055 |
| #define CMD_IMAGE_DATA 0x0053 |
| #define CMD_IMAGE_REQUEST_TYPE_GET_FMI 3 |
| #define CMD_IMAGE_REQUEST_TYPE_GET_RAW 2 |
| #define CMD_IMAGE_REQUEST_TYPE_INFO_FMI 1 |
| #define CMD_IMAGE_REQUEST_TYPE_INFO_RAW 0 |
Image request types.
| #define CMD_LIST_TEMPLATES 0x0060 |
| #define CMD_NAV_CFG_ORIENTATION_0 0x00000000 |
Navigation configuration.
| #define CMD_NAV_CFG_ORIENTATION_180 0x00000002 |
| #define CMD_NAV_CFG_ORIENTATION_270 0x00000003 |
| #define CMD_NAV_CFG_ORIENTATION_90 0x00000001 |
| #define CMD_NAV_CFG_ORIENTATION_MASK 0x00000003 |
| #define CMD_NAV_CFG_SEND_SAMPLE_DATA 0x00000008 |
| #define CMD_NAV_CFG_SKIP_FINGER_STABLE 0x00000004 |
| #define CMD_NAV_EVENT_DOWN 2 |
| #define CMD_NAV_EVENT_LEFT 4 |
| #define CMD_NAV_EVENT_LONG_PRESS 6 |
| #define CMD_NAV_EVENT_NONE 0 |
Navigation events.
| #define CMD_NAV_EVENT_PRESS 5 |
| #define CMD_NAV_EVENT_RIGHT 3 |
| #define CMD_NAV_EVENT_UP 1 |
| #define CMD_NAVIGATION 0x0200 |
| #define CMD_NAVIGATION_PS 0x0201 |
| #define CMD_PUT_TEMPLATE_DATA 0x0063 |
| #define CMD_RESET 0x0072 |
| #define CMD_SET_CRYPTO_KEY 0x0083 |
| #define CMD_SET_DBG_LOG_LEVEL 0x00B0 |
| #define CMD_SET_SYSTEM_CONFIG 0x006B |
| #define CMD_STATUS 0x0040 |
Command IDs.
| #define CMD_VERSION 0x0041 |
| #define ENROLL_FEEDBACK_DONE 1 |
Enrollment Feedback.
| #define ENROLL_FEEDBACK_PROGRESS 2 |
| #define ENROLL_FEEDBACK_PROGRESS_IMMOBILE 7 |
| #define ENROLL_FEEDBACK_REJECT_LOW_COVERAGE 4 |
| #define ENROLL_FEEDBACK_REJECT_LOW_MOBILITY 5 |
| #define ENROLL_FEEDBACK_REJECT_LOW_QUALITY 3 |
| #define ENROLL_FEEDBACK_REJECT_OTHER 6 |
| #define EVENT_CMD_FAILED 6 |
| #define EVENT_FINGER_DETECT 3 |
| #define EVENT_FINGER_LOST 4 |
| #define EVENT_IDLE 1 |
| #define EVENT_IMAGE_READY 5 |
| #define EVENT_NONE 0 |
Status Event.
| #define FPC_AES_GCM_IV_SIZE 12 |
| #define FPC_AES_GCM_TAG_SIZE 16 |
| #define FPC_FRAME_FLAG_SECURE 0x0001 |
Frame Flags.
| #define FPC_FRAME_FLAG_SENDER_FW_APP 0x0040 |
| #define FPC_FRAME_FLAG_SENDER_FW_BL 0x0020 |
| #define FPC_FRAME_FLAG_SENDER_HOST 0x0010 |
| #define FPC_FRAME_PROTOCOL_VERSION 0x0004 |
Frame Protocol Version.
| #define FPC_FRAME_TYPE_CMD_EVENT 0x13 |
| #define FPC_FRAME_TYPE_CMD_REQUEST 0x11 |
Frame Type.
| #define FPC_FRAME_TYPE_CMD_RESPONSE 0x12 |
| #define FPC_PENDING_OPERATION 1 |
| #define FPC_RESULT_BAD_IMAGE_QUALITY 42 |
| #define FPC_RESULT_CAPTURE_FAILED 41 |
| #define FPC_RESULT_CMD_ID_NOT_SUPPORTED 3 |
| #define FPC_RESULT_COULD_NOT_ARM 40 |
| #define FPC_RESULT_DATA_NOT_SET 2 |
| #define FPC_RESULT_FAILURE 11 |
| #define FPC_RESULT_FLASH_ERROR 23 |
| #define FPC_RESULT_IDENTIFY_LOCKOUT 24 |
| #define FPC_RESULT_INVALID_PARAM 12 |
| #define FPC_RESULT_IO_BAD_DATA 33 |
| #define FPC_RESULT_IO_BUSY 31 |
| #define FPC_RESULT_IO_NO_DATA 35 |
| #define FPC_RESULT_IO_NOT_SUPPORTED 34 |
| #define FPC_RESULT_IO_RUNTIME_FAILURE 32 |
| #define FPC_RESULT_NO_IMAGE 43 |
| #define FPC_RESULT_NOT_SUPPORTED 16 |
| #define FPC_RESULT_OK 0 |
| #define FPC_RESULT_OUT_OF_MEMORY 14 |
| #define FPC_RESULT_PROTOCOL_VERSION_ERROR 70 |
| #define FPC_RESULT_SENSOR_ERROR 50 |
| #define FPC_RESULT_STORAGE_IS_EMPTY 25 |
| #define FPC_RESULT_STORAGE_IS_FULL 22 |
| #define FPC_RESULT_TIMEOUT 15 |
| #define FPC_RESULT_USER_ID_EXISTS 20 |
| #define FPC_RESULT_USER_ID_NOT_FOUND 21 |
| #define FPC_RESULT_WRONG_STATE 13 |
| #define FPC_STARTUP_FAILURE 101 |
| #define FPC_SYS_CFG_TYPE_CUSTOM 1 |
| #define FPC_SYS_CFG_TYPE_DEFAULT 0 |
| #define GPIO_CONTROL_MODE_INPUT_PULL_DOWN 5 |
| #define GPIO_CONTROL_MODE_INPUT_PULL_NONE 3 |
| #define GPIO_CONTROL_MODE_INPUT_PULL_UP 4 |
| #define GPIO_CONTROL_MODE_NOT_USED 0 |
| #define GPIO_CONTROL_MODE_OUTPUT_OD 2 |
| #define GPIO_CONTROL_MODE_OUTPUT_PP 1 |
| #define GPIO_CONTROL_STATE_RESET 0 |
| #define GPIO_CONTROL_STATE_SET 1 |
| #define GPIO_CONTROL_SUB_CMD_GET 0 |
| #define GPIO_CONTROL_SUB_CMD_SET 1 |
| #define ID_TYPE_ALL 0x2023 |
Template ID ALL, option valid for:
CMD_IDENTIFY Request CMD_DELETE_TEMPLATE Request
| #define ID_TYPE_GENERATE_NEW 0x4045 |
Template ID GENERATE NEW, option valid for:
CMD_ENROLL Request
| #define ID_TYPE_NONE 0x1012 |
Template ID NONE, option valid for:
CMD_IDENTIFY Result (In No Match case)
| #define ID_TYPE_SPECIFIED 0x3034 |
Template ID SPECIFIED, option valid for:
CMD_IDENTIFY Request (Verify) and Response CMD_ENROLL Request CMD_DELETE_TEMPLATE Request
| #define IDENTIFY_RESULT_MATCH 0x61EC |
Identify match results.
| #define IDENTIFY_RESULT_NO_MATCH 0xBAAD |
| #define MAX_HOST_PACKET_SIZE_DEFAULT (2 * 1024) |
| #define STATE_APP_FW_READY 0x0001 |
System States (Bitmap).
| #define STATE_CAPTURE 0x0004 |
| #define STATE_DATA_TRANSFER 0x0040 |
| #define STATE_ENROLL 0x1000 |
| #define STATE_FINGER_DOWN 0x0080 |
| #define STATE_IDENTIFY 0x2000 |
| #define STATE_IMAGE_AVAILABLE 0x0010 |
| #define STATE_NAVIGATION 0x4000 |
| #define STATE_SECURE_INTERFACE 0x0002 |
| #define STATE_SYS_ERROR 0x0400 |
| typedef uint16_t fpc_result_t |
| enum fpc_cmd_data_type_t |