📡 React Native RFID (UHF) Scanner

This is my React Native CLI project for UHF RFID scanning, reading, and writing on a handheld RFID scanner device.

The project integrates the RFID scanner device SDK (with native .so libraries) through a custom Kotlin module (UhfModule.kt), making it possible to access hardware-level RFID functions directly inside a React Native app.

---

✨ Features

• 🔍 Scan RFID (UHF) tags in real-time
• 📖 Read tag data (EPC / memory banks)
• ✍️ Write data to RFID tags
• 📜 Display scanned tags with EPC, signal strength, and timestamp
• 🎵 Optional beep feedback when tags are detected
• 🔘 Supports scanning via both UI button and physical hardware trigger button
• 🔌 Supports multiple connection methods:
  • Bluetooth
  • USB (OTG)
  • Built-in module on RFID devices

---

🛠️ Tech Stack

• React Native CLI – cross-platform mobile framework
• Kotlin (Android Native Module) – to bridge the SDK with React Native
• RFID Scanner Device SDK – provided by hardware vendor (includes .so libraries for low-level access)
• Tested on Android-based RFID scanner devices

---

⚡ Usage Overview

• Tap Scan in the app to continuously detect nearby RFID tags
• Press the physical hardware trigger button on the device to scan tags without touching the UI
• View EPC + RSSI + timestamp in the live list
• Use Read / Write functions to interact with tag memory banks
• Optional beep sound feedback confirms successful scans

---

📋 Example Logs

UI Scan:

D UhfModule: Scanning started (source=UI)
D UhfModule: UI scan EPC tag: E2806A96000040225CE4C20C

Hardware Scan:

D UhfModule: Scanning started (source=HW)
D UhfModule: HW scan EPC tag: E2806A96000040225CE41A0C

---

🏗️ Architecture

 ┌────────────────────────┐
 │   React Native (JS)    │
 │  UI (UhfScanner.tsx)   │
 └───────────▲────────────┘
             │
   React Native Bridge
             │
 ┌───────────▼────────────┐
 │     Kotlin Module      │
 │     (UhfModule.kt)     │
 └───────────▲────────────┘
             │
     RFID Device SDK
    (with native .so libs)
             │
 ┌───────────▼────────────┐
 │   RFID Scanner Device  │
 │   (UHF Hardware)       │
 └────────────────────────┘

---

📝 Future Improvements

• Export scanned tag list to CSV/Excel
• Tag filtering, sorting, and grouping
• Enhanced UI/UX with animations and charts
• Battery optimization for long scanning sessions

---

🤝 Contributing

This project is part of my learning journey 🚀. Suggestions, ideas, and improvements are always welcome!