This guide will help you get started with your ESP32-based NFC and fingerprint device. Whether you're a developer, tinkerer, or just curious about this technology, we've got you covered.
- Introduction
- Prerequisites
- Setting Up
- Installing Required Libraries
- Uploading the Example Sketch
- Serial Communication
- Additional Resources
- Contact and Support
Chhavi is an open-source project that offers an ESP32-based NFC and fingerprint device. This device has a range of applications, from security systems to access control. Our goal is to provide a seamless and accessible platform for developers and enthusiasts to explore and utilize NFC and fingerprint technologies.
Before you dive into the Chhavi project, make sure you have the following:
- Chhavi Device: Ensure you have received the Chhavi device, either through distribution or assembly.
- Computer: You'll need a computer to program the device and interact with it.
- Micro-USB Cable: Use this to connect the Chhavi device to your computer.
- Arduino IDE: Install the Arduino Integrated Development Environment (IDE) from arduino.cc.
- CP2102 Driver: Install the driver to establish serial communication with Chhavi. Download the driver from Silicon Labs and choose the Virtual COM Port (VCP) driver.
To start with Chhavi, install these Arduino libraries:
- Ticker
- ESPAsyncWebServer
- AsyncTCP
- Adafruit_SSD1306 and its dependent libraries.
Install libraries via Arduino Library Manager:
- Open Arduino IDE.
- Go to Sketch > Include Library > Manage Libraries.
- Search for each library and click Install.
To begin exploring the capabilities of your Chhavi device, we've provided an example project located in the Firmware -> Arduino -> Example_Websocket
folder. This example project hosts an HTTP server and WebSocket server, allowing fingerprint sensors to communicate with the device and display live data in a web browser.
Device must need to power up before you see a serial port in computer, there is a side-button near the type-c port which needs to be pressed 4-5 seconds after you plug in the type-c cable in order to see a serial port in device.
Follow these steps to run the example project:
-
Open Arduino IDE.
-
Go to File > Open and navigate to the Chhavi repository.
-
Inside the repository, navigate to
Firmware -> Arduino -> Example_Websocket
and open theExample_Websocket.ino
file. -
In the Arduino IDE, ensure you have selected the correct board. Go to Tools > Board and choose the ESP32 WROOM module option.
-
Update the WiFi credentials to match your network. Look for the following line in the code (usually around line 14):
const char* ssid = "your_wifi_ssid"; const char* password = "your_wifi_password";
To communicate with Chhavi via serial:
- Connect Chhavi to your computer.
- Open Arduino IDE.
- Go to Tools > Serial Monitor.
- In Serial Monitor, select the baud rate (usually 115200) from the dropdown at the bottom.
- Observe the device's serial output for debugging and monitoring.
- For hardware resources, such as design files and schematics, refer to our crowd-supply campaign page once active.
- For firmware resources, explore the code in our repository.
For questions, issues, or sharing your Chhavi projects, contact us at contact@vicharak.in.
Thank you for joining us on this exciting Chhavi journey!
Remember, Chhavi is not just a device; it's a key to unlock endless possibilities.
Happy tinkering!
Discord server!