Skip to content

Commit 7224092

Browse files
committed
auto format - first fix of shields ...
1 parent aa6bac0 commit 7224092

File tree

1 file changed

+20
-21
lines changed

1 file changed

+20
-21
lines changed

README.md

Lines changed: 20 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -5,30 +5,30 @@
55

66
Arduino Library for the SparkFun Fingerprint Sensor - FPC2534 Pro
77

8-
![License](https://img.shields.io/github/license/sparkfun/SparkFun_Qwiic_Ultrasonic_Arduino_Library)
9-
![Release](https://img.shields.io/github/v/release/sparkfun/SparkFun_Qwiic_Ultrasonic_Arduino_Library)
10-
![Release Date](https://img.shields.io/github/release-date/sparkfun/SparkFun_Qwiic_Ultrasonic_Arduino_Library)
11-
![Documentation - build](https://img.shields.io/github/actions/workflow/status/sparkfun/SparkFun_Qwiic_Ultrasonic_Arduino_Library/build-deploy-ghpages.yml?label=doc%20build)
12-
![Compile - Test](https://img.shields.io/github/actions/workflow/status/sparkfun/SparkFun_Qwiic_Ultrasonic_Arduino_Library/compile-sketch.yml?label=compile%20test)
13-
![GitHub issues](https://img.shields.io/github/issues/sparkfun/SparkFun_Qwiic_Ultrasonic_Arduino_Library)
8+
![License](https://img.shields.io/github/license/sparkfun/SparkFun_FPC2534_Arduino_Library)
9+
![Release](https://img.shields.io/github/v/release/sparkfun/SparkFun_FPC2534_Arduino_Library)
10+
![Release Date](https://img.shields.io/github/release-date/sparkfun/SparkFun_FPC2534_Arduino_Library)
11+
![Documentation - build](https://img.shields.io/github/actions/workflow/status/sparkfun/SparkFun_FPC2534_Arduino_Library/build-deploy-ghpages.yml?label=doc%20build)
12+
![Compile - Test](https://img.shields.io/github/actions/workflow/status/sparkfun/SparkFun_FPC2534_Arduino_Library/compile-sketch.yml?label=compile%20test)
13+
![GitHub issues](https://img.shields.io/github/issues/sparkfun/SparkFun_FPC2534_Arduino_Library)
1414

15-
The [SparkFun Fingerprint Sensor - FPC2534 Pro]() is a small, highly capable and robust fingerprint sensor that can easily be integrated into virutally any application. Based off the AllKey Biometric System family from Fingerprints Cards (FPC), the FPC2534AP delivers incredible functionality in a small, compact formfactor.
15+
The [SparkFun Fingerprint Sensor - FPC2534 Pro]() is a small, highly capable and robust fingerprint sensor that can easily be integrated into virutally any application. Based off the AllKey Biometric System family from Fingerprints Cards (FPC), the FPC2534AP delivers incredible functionality in a small, compact formfactor.
1616

1717
## Functionality
1818

19-
The SparkFun Fingerprint Sensor - FPC2534 Pro is accessable via a variety of interfaces, including I2C and UART, which are supported by this library.
19+
The SparkFun Fingerprint Sensor - FPC2534 Pro is accessable via a variety of interfaces, including I2C and UART, which are supported by this library.
2020

2121
This library provides a message-based, easy to use interface that enables fingerprint biometric authentication and simple finger-based navigation. Specificatlly, the FPC2534AP provides:
2222

23-
- Fingerprint enrollment - adding a fingerprint to the sensor
23+
- Fingerprint enrollment - adding a fingerprint to the sensor
2424
- Fingerprint template management - managing recorded fingerprints
2525
- Fingerprint matching/indentification for biometric authentication
2626
- Trackpad like functionalality for simple, finger-based navigation
2727
- Application integration via a variety of communication methods
2828

2929
### Communication
3030

31-
The operation of the FPC2534AP is performed by a messaging protocol implemented on the device. A client application sends message requests to the sensor and recieves responses to the request made.
31+
The operation of the FPC2534AP is performed by a messaging protocol implemented on the device. A client application sends message requests to the sensor and recieves responses to the request made.
3232

3333
To support integration and messaging, the FPC2534AP provides support for four (4) different communication implementations. These are:
3434

@@ -53,18 +53,18 @@ In addition to the communication method selected, the FPC2534AP requires additio
5353

5454
## Library
5555

56-
Unlike a majority of sensors and their associated libraries which are synchronous function calls - a function/method call returns a requested value or performs a specific action - the FPC2534AP operates using a messaging methodlogy - sending messages to the client as actions occur on the device, or in reponse to earlier requests.
56+
Unlike a majority of sensors and their associated libraries which are synchronous function calls - a function/method call returns a requested value or performs a specific action - the FPC2534AP operates using a messaging methodlogy - sending messages to the client as actions occur on the device, or in reponse to earlier requests.
5757

5858
Since messaging methodology is used by the FPC2534AP, this library makes makese use of the following implementation pattern:
5959

6060
- User provided callback functions that the library calls when a specific message is recieved from the library (like when a finger is pressed on the sensor).
6161
- A process message method that is called to process the next available message from the sensor if one is available. This method is called within your applications main processing loop (for Arduino, this is the `loop()` function).
6262

63-
While this methodlogy is unique to the when compaired to other libraries, it fits well with the event driven nature of the FPC2534AP fingerprint sensor.
63+
While this methodlogy is unique to the when compaired to other libraries, it fits well with the event driven nature of the FPC2534AP fingerprint sensor.
6464

6565
### Using the Library
6666

67-
The first step to using the library is selected the method used to communicate with the device. The library supports I2C on select platforms, or UART (a Serial interface in Arduino). Once selected, and device connected as outlined in the hookup guide for theSparkFun Fingerprint Sensor - FPC2534 Pro. The type of connection depends on the method used to communicate with the device.
67+
The first step to using the library is selected the method used to communicate with the device. The library supports I2C on select platforms, or UART (a Serial interface in Arduino). Once selected, and device connected as outlined in the hookup guide for theSparkFun Fingerprint Sensor - FPC2534 Pro. The type of connection depends on the method used to communicate with the device.
6868

6969
#### Using I2C (Qwiic)
7070

@@ -90,7 +90,7 @@ An example of calling the begin method:
9090

9191
At this point, the sensor is ready for normal operation.
9292

93-
##### A note on "pinging" the FPC2534 sensor
93+
##### A note on "pinging" the FPC2534 sensor
9494

9595
Often, to determine if a sensor is available on the I2C bus, the bus is queried at the address for the device (a simple "ping"). In arduino this often looks like:
9696

@@ -101,7 +101,7 @@ Often, to determine if a sensor is available on the I2C bus, the bus is queried
101101
Serial.println("The Touch Sensor FPC2534 is available");
102102
```
103103

104-
Developing with the sensor has shown that once the sensor is "pinged", it enters an unknown state. To ensure proper device operation, a `reset()` of the device is needed after a `ping` operation is performed.
104+
Developing with the sensor has shown that once the sensor is "pinged", it enters an unknown state. To ensure proper device operation, a `reset()` of the device is needed after a `ping` operation is performed.
105105

106106
> [!NOTE]
107107
> The I2C (qwiic) interface for the SparkFun Fingerprint Sensor - FPC2534 Pro board is currently only supported on ESP32 and Raspberry RP2 (RP2040, RP2350) boards. The I2C Implemention of the FPC2534 device performs a dynamic payload transmission that is not supported by the Arduino Wire library. Because of this, a custom implementation is provided by this library for the ESP32 and RP2 platforms.
@@ -123,22 +123,22 @@ Configure the following settings on the UART/Serial connection being used:
123123
| Config | SERIAL_8N1|
124124
| Read Buffer Size | 512|
125125

126-
127126
> [!NOTE]
128127
> Due to the amount of information sent by the fingerprint sensor, the default size of the internal buffer used by Arduino Serial objects is rapidly exceeded. To prevent this, the buffer size must be be increased before intializing the FPC2534AP device.
129-
>
128+
>
130129
> To increase the buffer size when using a Raspberry pi RP2 Microcontroller:
130+
>
131131
> ```c++
132132
> Serial1.setFIFOSize(512);
133133
>```
134+
>
134135
> On an ESP32:
136+
>
135137
> ```c++
136138
> Serial.setRxBufferSize(512);
137139
> ```
138140
139-
140-
To initialize the device, the Serial object used to communicate with the device is passed into the begin call.
141-
141+
To initialize the device, the Serial object used to communicate with the device is passed into the begin call.
142142
143143
An example of calling the begin method:
144144
@@ -147,4 +147,3 @@ An example of calling the begin method:
147147
```
148148
149149
At this point, the sensor is ready for normal operation.
150-

0 commit comments

Comments
 (0)