ToolEase

A modern, open-source RFID-based tool leasing and inventory management system for educational, industrial, and makerspace environments.

Overview

ToolEase is a complete IoT solution for managing tool lending, inventory, and asset tracking. It combines a robust Flutter mobile app with an ESP32-based RFID hardware interface, enabling real-time, per-unit tracking of tools and equipment. Designed for schools, universities, workshops, and industrial settings, ToolEase streamlines the process of borrowing, returning, and maintaining tools, ensuring accountability and reducing loss.

Why ToolEase?

Eliminate manual logbooks and spreadsheets
Prevent tool loss and unauthorized borrowing
Gain real-time visibility into inventory and usage
Simplify reporting and compliance

Key Features

Per-Unit RFID Tracking: Every tool is uniquely tagged and tracked
Student & User Management: Register, search, and manage borrowers
Multi-Storage Support: Organize tools by location or cabinet
Borrow/Return Workflow: Scan to borrow, scan to return, with condition assessment
Admin Dashboard: Real-time stats, PDF reports, and analytics
Kiosk Mode: Secure, tablet-optimized interface for public use
Offline Operation: Local database ensures reliability without internet
Auto-Reconnect: Robust WiFi/WebSocket connection with status feedback
Security: Biometric/PIN admin access, audit logs, and session management

System Architecture

┌───────────────┐    WebSocket    ┌───────────────┐
│  Flutter App  │◄──────────────►│    ESP32      │
│   (Tablet)    │                │  (RFID HW)    │
│               │                │               │
│ • UI/UX       │                │ • MFRC522     │
│ • SQLite DB   │                │ • WiFi AP     │
│ • WebSocket   │                │ • AsyncServer │
└───────────────┘                └───────────────┘
     │                                 │
     ▼                                 ▼
   Students, Admins                  RFID Tags

Bill of Materials (BOM) & Procurement Sources

Below is a comprehensive list of all components required to build the ToolEase system, grouped by category. Each item includes recommended sources and price notes. For the latest prices, search the listed stores (Lazada, Makerlab Electronics, TechLife, or your local hardware store).

1. Electronics (Makerlab Electronics – Lazada or Direct Store)

Item	Quantity	Source	Price (₱, est.)	Notes
ESP32 30-pin module (ESP32-DEVKIT V1)	1	Makerlab Electronics (Lazada)	~₱350	WiFi microcontroller board
RFID-RC522 module	1	Makerlab Electronics (Lazada)	~₱120	RFID reader (SPI)
RFID Tags	15	Makerlab Electronics (Lazada)	~₱300	MIFARE Classic 1K/4K, cards or keyfobs
24 AWG hookup wires	1 bundle	Makerlab Electronics (Lazada)	~₱80	For all connections
JST-XH 4-pin connectors	1 pack	Makerlab Electronics (Lazada)	~₱40	For modular wiring
JST-XH 3-pin connectors	1 pack	Makerlab Electronics (Lazada)	~₱40	For modular wiring

2. Display

Item	Quantity	Source	Price (₱, est.)	Notes
8-inch tablet – TechLife Lite 8" (TLPADL03)	1	TechLife Store / Lazada	~₱4,999	Main user interface

3. Power System

Item	Quantity	Source	Price (₱, est.)	Notes
220V to 5V 3A power supply	1	Makerlab Electronics (Lazada)	~₱180	For stable power

4. Enclosure / Physical Build (Hardware Store)

Item	Quantity	Source	Price (₱, est.)	Notes
1/2-inch Nebraska plywood (full sheet)	1	Local hardware store	₱980	For enclosure/cabinet
Nails	1 pack	Local hardware store	₱20	For assembly
Tek screws	1 pack	Local hardware store	₱30	For mounting

Procurement Notes

All electronics (ESP32, RFID module, tags, wires, JST-XH connectors, power supply) are best sourced from Makerlab Electronics via Lazada or their direct store for quality and support.
Display/tablet is available from the official TechLife store or Lazada. Always check for the latest model and price.
Enclosure materials (plywood, nails, screws) are available at any local hardware store. Prices may vary by region.

Total Estimated Cost Breakdown

Category	Subtotal (₱, est.)
Electronics	₱930
Display	₱4,999
Power System	₱180
Enclosure	₱1,030
Total	₱7,139

Prices are estimates as of December 2025. Always check Lazada, Makerlab, and TechLife for current pricing and availability.

Physical Assembly & Views

ToolEase is designed for robust, real-world deployment. Below are detailed renders and diagrams to guide you through the assembly, wiring, and enclosure design. Each view and diagram is provided to ensure clarity for both hardware assembly and troubleshooting.

Full Device Views

Complete Assembly (All Angles)

This render shows the fully assembled ToolEase device, including the ESP32, RFID module, and all enclosure parts. Use this as a reference for the final look and for verifying that all components are properly housed.

Front View

The front view highlights the RFID scan area, user interface, and any status indicators. This is the main interaction side for users.

Back View

The back view shows cable management, mounting options, and access to the ESP32 board for maintenance.

Side View

The side profile demonstrates the device’s thickness, bracket placement, and ventilation if present.

Top View

The top view is useful for understanding the layout of ports, buttons, and the RFID antenna’s position.

3D Printed Parts & Covers

Download all STL files and 3D models on Thingiverse:

All official ToolEase 3D printable parts are available for free on Thingiverse. Download, remix, or print the latest versions directly from the project page: https://www.thingiverse.com/thing:7220168

Board Case:
- Houses the ESP32 and main electronics, providing robust protection and easy access for maintenance.
Bracket:
- Used for mounting the device securely to a wall, table, or enclosure.
Case Cover:
- Protects the internal components and provides a clean, finished look.
Tablet Cover:
- Custom-fit cover for the tablet, ensuring it stays in place and protected during use.
Port Cover:
- Shields the ESP32’s ports from dust and accidental contact.
Cable Cover:
- A new addition designed to neatly route and protect power/data cables, preventing tangling and accidental unplugging. The cable cover snaps into place and can be removed for servicing.
All Parts Joined:
- Visual reference for how all 3D printed parts fit together in the final assembly.

Each part is designed for easy 3D printing and assembly. The covers, brackets, and cable management solutions ensure protection, stability, and a professional, safe finish for the device.

Wiring Diagram & Fritzing

Visual Wiring Diagram

This diagram provides a clear, color-coded map of all connections between the ESP32 and MFRC522 RFID module. Double-check your wiring against this image before powering on.

Fritzing Source File

Download Wiring.fzz

The Fritzing file allows you to view, edit, or print the wiring diagram using the Fritzing app. This is ideal for customizing the hardware layout or troubleshooting.

Software Dependencies

Flutter App

Flutter SDK 3.8+
Dart SDK 3.0+
Riverpod, Drift ORM, Material 3, PDF, Kiosk Mode, Local Auth, Permission Handler

ESP32 Firmware

Arduino IDE 1.8+
ESP32 Arduino Core v2.0.14
ESPAsyncWebServer, AsyncTCP, EasyMFRC522

Installation & Setup

ESP32 Setup

Open Arduino IDE
Load source/esp32/Toolease/Toolease.ino
Select ESP32 Dev Module (Board Manager: v2.0.14 recommended)
Install libraries: ESPAsyncWebServer, AsyncTCP, EasyMFRC522
Upload firmware
Open Serial Monitor (115200 baud)
Confirm: "Access Point started" and "IP Address: 192.168.4.1"

Flutter App Setup

Clone repository: git clone https://github.com/qppd/Toolease.git
cd Toolease/source/flutter/Toolease
Install dependencies: flutter pub get
Build and run: flutter run or flutter build apk --release
Install APK on tablet

Connect Tablet to ESP32 WiFi

Settings → WiFi → Connect to ToolEase_RFID (password: toolease123)
Ignore "No internet" warning, turn OFF mobile data
Open ToolEase app, wait for green WiFi icon

Configuration

Flutter App

Kiosk mode, feature toggles, biometric/PIN admin access, WebSocket server settings

ESP32

WiFi credentials, RFID pin assignments, WebSocket port (default 81), debug level

Database

Auto-migrates on first run; settings and admin credentials configurable in-app

Operation Guide

For Students

Register via app, enter details
Borrow: select item, scan RFID tag
Return: select item, scan RFID, assess condition

For Admins

Authenticate, manage students/items/storages
Assign RFID tags, generate reports, configure settings

RFID Workflow

Assign tag: admin selects item, places tag on reader, app writes data
Borrow: student scans tag, app records transaction
Return: scan tag, record condition

API & Communication

WebSocket Protocol

ESP32 → App: { "action": "rfid_scan", "uid": "A1:B2:C3:D4:E5:F6" }
App → ESP32: { "action": "write_tag", "data": "item_id:unit_id" }

Database API

Full CRUD for all entities, atomic transactions, real-time queries, advanced search/filter

Serial Commands (ESP32)

test, scan <uid>, help

Testing & Validation

Follow Quick Start and WiFi Setup
Upload ESP32 firmware, verify AP
Build/install app, connect to WiFi
Test RFID scan, borrow/return, admin dashboard
Simulate disconnects, test auto-reconnect
Use Serial Monitor and Flutter DevTools for debugging

Troubleshooting

Issue	Solution
No WiFi network	ESP32 powered on? Serial Monitor shows AP?
Can't connect WiFi	Correct password? Mobile data OFF?
Red WiFi icon	Wait 3s for auto-reconnect. Check Serial Monitor.
Scan timeout	Green WiFi icon? Hold tag close to reader?
Connection drops	Move closer to ESP32. Check for interference.

See full section above for detailed troubleshooting.

Project Structure

Toolease/
├── LICENSE
├── README.md
├── models/           # 3D printable parts
├── source/
│   ├── esp32/
│   │   └── Toolease/ (firmware)
│   └── flutter/
│       └── Toolease/ (Flutter app)
└── wiring/           # Hardware diagrams

Future Enhancements

Cloud sync for multi-device
Barcode/QR code support
Advanced analytics and reporting
Maintenance scheduling
Mobile app for students
Multi-location, centralized management
AI-powered predictive maintenance

Contributing

We welcome contributions! Please fork, create a feature branch, commit, and open a pull request. See code standards and dev setup in the repo.

Support & Contact

Developer: Quezon Province Provincial Developer
Email: quezon.province.pd@gmail.com
Portfolio: sajed-mendoza.onrender.com
GitHub: qppd
Facebook: qppd.dev

License

MIT License. See LICENSE for details.

🚀 Quick Start

ESP32 Setup

Open Arduino IDE
Load source/esp32/Toolease/Toolease.ino
Select ESP32 Dev Module (Board Manager: v2.0.14 recommended)
Install libraries: ESPAsyncWebServer, AsyncTCP, EasyMFRC522
Upload firmware
Open Serial Monitor (115200 baud)
You should see:
- Access Point started
- IP Address: 192.168.4.1
- WebSocket server started on port 80 at /ws

Tablet Setup

Connect to WiFi: ToolEase_RFID (password: toolease123)
Ignore "No internet" warning
Turn OFF mobile data
Open ToolEase app
Wait for green WiFi icon

Usage

Green WiFi icon = Connected
Red WiFi-off icon = Not connected
RFID scanning = Hold tag near RC522 for 1-2 seconds

WiFi/WebSocket Details

SSID: ToolEase_RFID
Password: toolease123
IP: 192.168.4.1
WebSocket URL: ws://192.168.4.1/ws

WiFi & WebSocket Setup

ESP32 creates a WiFi Access Point (ToolEase_RFID)
Tablet connects to ESP32 WiFi
Communication is via WebSocket (ws://192.168.4.1/ws)
No Bluetooth required
Auto-reconnect and error handling built-in

Troubleshooting:

Problem	Solution
No WiFi network	Restart ESP32, check Serial Monitor
Can't connect	Double-check password, turn off mobile data
Red WiFi icon	Wait 3 seconds for auto-reconnect
Scan timeout	Ensure green WiFi icon before scanning
Still not working?	Re-upload firmware, check library versions

System Features

Per-Unit RFID Tracking: Every tool has a unique RFID tag (Serial No.)
Student Registration & Management: Register students with ID, name, year, section
Storage Organization: Manage multiple storage locations
Item Inventory: Add/edit tools, assign RFID, track status (available, borrowed, lost, damaged)
Borrow/Return Workflow: Scan to borrow, scan to return, condition tracking
Admin Panel: Secure PIN/biometric access, real-time stats, PDF reports
Kiosk Mode: Tablet-optimized, restricted navigation
Auto-Reconnect: WiFi/WebSocket auto-reconnect for reliability

Database & Code Structure

Database

SQLite with Drift ORM
Per-unit item tracking (no more quantity fields)
Borrow/return records linked to unique Serial No.

Code Structure

lib/ (Flutter app)
- core/, database/, models/, providers/, screens/, services/, shared/, utils/
source/esp32/Toolease/ (ESP32 firmware)
- Toolease.ino, Websocket_Config.cpp/.h, Rfid_Config.cpp/.h

ESP32 Pinout

ESP32       RC522
GPIO 5   -> SDA (SS)
GPIO 18  -> SCK
GPIO 23  -> MOSI
GPIO 19  -> MISO
GPIO 21  -> RST
3.3V     -> 3.3V
GND      -> GND

Deployment & Testing

Pre-Deployment Checklist

ESP32 firmware uploaded, Serial Monitor shows correct logs
Tablet connects to ToolEase_RFID, mobile data OFF
ToolEase app installed, green WiFi icon appears
RFID scan works for borrow/return
Admin panel accessible, reports generate

Build & Install

flutter pub get
flutter run or flutter build apk --release
Install APK on tablet

Testing

Borrow/return workflow
Student registration
Admin dashboard
Error handling (disconnect WiFi, scan timeout)

Troubleshooting

Common Issues:

ESP32 not creating WiFi: Check power, re-upload firmware
Tablet won’t connect: Double-check password, mobile data OFF
App not connecting: Confirm WebSocket URL is ws://192.168.4.1/ws
Scan timeout: Ensure green WiFi icon, hold tag for 1-2 seconds
Still stuck? Downgrade ESP32 core to 2.0.14, reinstall libraries

Debug Tools:

Serial Monitor (ESP32)
Flutter DevTools
Network tools (ping, WebSocket test apps)

Migration & Changelog

Bluetooth code and dependencies fully removed
ESP32 now uses ESPAsyncWebServer + AsyncTCP for WebSocket
WebSocket URL changed to ws://192.168.4.1/ws (port 80)
All Flutter code uses WebSocket only
Per-unit RFID tracking, no more quantity fields
All documentation merged into this README

License

MIT License. See LICENSE for details.

Borrowing System: Multi-storage, multi-item borrowing with real-time availability checking
Return Processing: Condition-based return tracking (good, damaged, lost) for each item unit
Real-time Synchronization: WebSocket-based communication between mobile app and RFID hardware

Administrative Features

Admin Dashboard: Real-time statistics and system overview
User Management: Student registration and profile management
Inventory Control: Comprehensive item and storage management
Transaction Records: Complete borrowing history with archiving capabilities
Reporting System: Generate PDF reports for inventory status and usage analytics
System Settings: Configurable feature toggles and kiosk mode

Hardware Integration

RFID Reading/Writing: MFRC522-based tag detection and data storage
WiFi Connectivity: Access Point and Station modes for flexible networking
WebSocket Server: Real-time bidirectional communication
Serial Debugging: Command-line interface for testing and diagnostics

User Experience

Kiosk Mode: Lockdown interface for public use scenarios
Biometric Authentication: Local authentication for admin access
Responsive Design: Optimized for tablets and mobile devices
Offline Operation: Local database ensures functionality without internet
User Manuals: Built-in help system for students and administrators

System Architecture

┌─────────────────┐    WebSocket    ┌─────────────────┐
│   Flutter App   │◄──────────────►│     ESP32       │
│   (Mobile)      │                │  (Hardware)     │
│                 │                │                 │
│ • Student UI    │                │ • RFID Reader   │
│ • Admin UI      │                │ • MFRC522       │
│ • Database      │                │ • WiFi AP       │
│ • WebSocket     │                │ • WebSocket     │
│   Client        │                │   Server        │
└─────────────────┘                └─────────────────┘
         │                                 │
         │                                 │
         ▼                                 ▼
┌─────────────────┐               ┌─────────────────┐
│   SQLite DB     │               │   RFID Tags     │
│   (Drift ORM)   │               │   (MIFARE)      │
│                 │               │                 │
│ • Students      │               │ • UID Reading   │
│ • Items         │               │ • Data Storage  │
│ • BorrowRecords │               │ • Tag Writing  │
│ • Settings      │               │                 │
└─────────────────┘               └─────────────────┘

Data Flow

Registration: Students register via mobile app → Stored in local SQLite
Item Setup: Admin adds items and assigns RFID tags → ESP32 writes tag data
Borrowing: Student selects items → App checks availability → RFID scan confirms
Tracking: ESP32 detects RFID tags → Broadcasts UID → App processes transaction
Returns: Student returns items → Condition assessment → Database update

Hardware Components

ESP32 Development Board

Microcontroller: ESP32-WROOM-32
WiFi: 802.11 b/g/n (2.4GHz)
GPIO Pins: 36 total (configurable)
Power: 5V USB or 3.3V regulated

RFID Module (MFRC522)

Protocol: MIFARE Classic 1K/4K, NTAG, etc.
Frequency: 13.56 MHz
Communication: SPI interface
Range: Up to 10cm (depending on antenna)
Data Storage: 1KB per tag (MIFARE Classic 1K)

Power Supply

Input: 5V USB or battery pack
Current: 500mA minimum
Backup: Optional battery for portability

Software Components

Flutter Application

Framework: Flutter 3.8.1+
State Management: Riverpod 2.6.1
Database: Drift ORM 2.28.1
UI Components: Material Design 3
Platform Support: Android, iOS, Windows

ESP32 Firmware

IDE: Arduino IDE 1.8.0+
Core: ESP32 Arduino Core
Libraries:
- EasyMFRC522 (RFID handling)
- ArduinoWebsockets (WebSocket communication)
- WiFi (networking)

Key Dependencies

# Flutter Dependencies
drift: ^2.28.1
flutter_riverpod: ^2.6.1
kiosk_mode: ^0.7.0
local_auth: ^2.3.0
pdf: ^3.11.1
permission_handler: ^12.0.1

Database Schema

Core Tables

Students

CREATE TABLE students (
  id INTEGER PRIMARY KEY AUTOINCREMENT,
  student_id TEXT UNIQUE NOT NULL,
  name TEXT NOT NULL,
  year_level TEXT NOT NULL,
  section TEXT NOT NULL,
  created_at DATETIME DEFAULT CURRENT_TIMESTAMP
);

Storages

CREATE TABLE storages (
  id INTEGER PRIMARY KEY AUTOINCREMENT,
  name TEXT NOT NULL,
  description TEXT,
  created_at DATETIME DEFAULT CURRENT_TIMESTAMP
);

Items

CREATE TABLE items (
  id INTEGER PRIMARY KEY AUTOINCREMENT,
  name TEXT NOT NULL,
  description TEXT,
  storage_id INTEGER REFERENCES storages(id),
  total_quantity INTEGER DEFAULT 0,
  available_quantity INTEGER DEFAULT 0,
  created_at DATETIME DEFAULT CURRENT_TIMESTAMP
);

ItemUnits

CREATE TABLE item_units (
  id INTEGER PRIMARY KEY AUTOINCREMENT,
  item_id INTEGER REFERENCES items(id),
  serial_no TEXT NOT NULL,
  status TEXT NOT NULL,
  created_at DATETIME DEFAULT CURRENT_TIMESTAMP
);

BorrowRecords

CREATE TABLE borrow_records (
  id INTEGER PRIMARY KEY AUTOINCREMENT,
  borrow_id TEXT UNIQUE NOT NULL,
  student_id INTEGER REFERENCES students(id),
  status TEXT NOT NULL,
  borrowed_at DATETIME DEFAULT CURRENT_TIMESTAMP,
  returned_at DATETIME
);

BorrowItems & Conditions

CREATE TABLE borrow_items (
  id INTEGER PRIMARY KEY AUTOINCREMENT,
  borrow_record_id INTEGER REFERENCES borrow_records(id),
  item_id INTEGER REFERENCES items(id),
  quantity INTEGER NOT NULL,
  return_condition TEXT
);

CREATE TABLE borrow_item_conditions (
  id INTEGER PRIMARY KEY AUTOINCREMENT,
  borrow_item_id INTEGER REFERENCES borrow_items(id),
  quantity_unit INTEGER NOT NULL,
  condition TEXT NOT NULL
);

Supporting Tables

Settings: App configuration and feature toggles
Tags: Item categorization system

Installation & Setup

Installation & Setup (WiFi)

Prerequisites

Flutter SDK: 3.8.1 or higher
Dart SDK: 3.0.0 or higher
Android Studio/VS Code: With Flutter extensions
Arduino IDE: 1.8.0+ with ESP32 support
Git: Version control system

ESP32 Setup

Configure WiFi Credentials

Open source/esp32/Toolease/Toolease.ino and set:

const char* ssid = "ToolEase_RFID";
const char* password = "toolease123";

Upload Firmware
- Open Arduino IDE
- Connect ESP32 via USB
- Select: Tools > Board > ESP32 Dev Module
- Select correct Port
- Click Upload
- Open Serial Monitor (115200 baud)
- Confirm: "Access Point started" and "IP Address: 192.168.4.1"

Flutter App Setup

Clone Repository

git clone https://github.com/qppd/Toolease.git
cd Toolease/source/flutter/Toolease

Install Dependencies
```
flutter pub get
```
Build and Run
```
flutter run
```

Connect Tablet to ESP32 WiFi

Go to Settings > WiFi
Connect to: ToolEase_RFID (password: toolease123)
Ignore "No internet" warning
Make sure Mobile Data is OFF

Test RFID Scanning

Open ToolEase app
Wait for green WiFi icon
Try borrowing or registering a student and scan an RFID tag

Hardware Assembly

Connect MFRC522 to ESP32:

MFRC522    ESP32
SDA(SS) -> GPIO5
SCK      -> GPIO18
MOSI     -> GPIO23
MISO     -> GPIO19
RST      -> GPIO21
3.3V     -> 3.3V
GND      -> GND

Power Supply: Connect USB or regulated power
Antenna: Ensure MFRC522 antenna is clear of obstructions

Configuration

Flutter App Settings

Kiosk Mode: Enable/disable lockdown interface
Feature Toggles: Control availability of registration, borrowing, returns
Authentication: Configure biometric requirements
Network Settings: WebSocket server configuration

ESP32 Configuration

WiFi Credentials: SSID and password for Access Point
RFID Pins: GPIO assignments for MFRC522
WebSocket Port: Default 81
Debug Level: Serial output verbosity

Database Initialization

The app automatically creates and migrates the database on first run. Default settings include:

Kiosk mode disabled
All features enabled
Default admin credentials (if applicable)

Operation Guide

Operation Guide (WiFi)

For Students

Registration: Register via app, enter details, submit.
Borrowing: Select items, scan RFID tag, confirm.
Returning: Select borrowed items, scan RFID tag, assess condition, confirm.

For Administrators

Admin Panel: Authenticate, manage students/items/storages, assign tags, generate reports, configure settings.

RFID Workflow

Tag Assignment: Admin selects item, places RFID tag near reader, app writes data.
Borrowing: Student selects items, scans RFID tag, transaction recorded.
Returns: Student returns items, RFID scan verifies, condition recorded.

WiFi/WebSocket Connection

ESP32 creates WiFi AP: ToolEase_RFID (password: toolease123)
Tablet connects to WiFi
App connects to ESP32 via WebSocket (port 81)
Green WiFi icon = connected; red = not connected

API & Communication

WebSocket Protocol

ESP32 → Flutter Messages

{
  "action": "rfid_scan",
  "uid": "A1:B2:C3:D4:E5:F6"
}

Flutter → ESP32 Messages

{
  "action": "write_tag",
  "data": "item_id:unit_id"
}

Database API

Key Operations

CRUD Operations: Full Create, Read, Update, Delete for all entities
Transaction Management: Atomic borrowing/return operations
Real-time Queries: Live data updates via Riverpod providers
Search & Filtering: Advanced querying capabilities

Serial Commands (ESP32)

test          - Send test RFID scan
scan <uid>    - Send specific UID scan
help          - Display available commands

Features in Detail

Student Management

Registration: Unique student ID validation
Profile Management: Update student information
Borrowing History: Track all transactions per student
Access Control: Student ID verification for transactions

Inventory Management

Multi-level Organization: Storages → Items → Units
Quantity Tracking: Total vs available quantities
RFID Integration: Tag assignment and validation
Status Monitoring: Track item conditions and availability

Borrowing System

Multi-storage Selection: Borrow from multiple locations
Quantity Selection: Specify quantities per item
Real-time Validation: Check availability before confirmation
Transaction IDs: Unique borrow identifiers
Due Date Tracking: Optional due date management

Return Processing

Condition Assessment: Good/Damaged/Lost per unit
Bulk Returns: Process multiple items simultaneously
Damage Reporting: Detailed condition tracking
Late Fee Calculation: Optional penalty system

RFID Integration

Tag Reading: Automatic UID detection and broadcasting
Data Writing: Store item/unit information on tags
Validation: Verify tag data matches expected items
Error Handling: Graceful handling of read/write failures

Reporting & Analytics

Inventory Reports: Current stock levels and locations
Usage Reports: Borrowing patterns and frequency
Student Reports: Individual borrowing history
System Reports: Overall system utilization
PDF Export: Professional report generation

Security & Access Control

Biometric Authentication: Fingerprint/Face ID for admin access
Kiosk Mode: Prevent unauthorized system access
Session Management: Automatic logout on inactivity
Audit Trail: Complete transaction logging

Testing & Validation

Pre-Deployment Checklist

Functional Testing

Student registration and lookup
Item creation and RFID assignment
Borrowing workflow completion
Return processing with conditions
Report generation and export
Admin dashboard functionality
Settings configuration
Kiosk mode operation

Troubleshooting

Troubleshooting (WiFi)

ESP32 Not Creating WiFi Network

Problem: Can't find "ToolEase_RFID" network on tablet Solutions:

Check ESP32 is powered on and Serial Monitor shows "Access Point started"
Try restarting the ESP32 (unplug and plug back in)
Make sure WiFi credentials in code match (case-sensitive)
Some ESP32 boards need external antenna for better WiFi range

Tablet Won't Connect to WiFi

Problem: "Authentication error" or "Failed to connect" Solutions:

Double-check password is exactly: toolease123
Forget the network and reconnect
Restart tablet WiFi
Move closer to ESP32 (within 5-10 meters)

App Shows "Not Connected"

Problem: Red WiFi-off icon even though WiFi is connected Solutions:

Check IP address: ESP32 should be at 192.168.4.1
Verify WebSocket port: Should be port 81
Wait a few seconds: Auto-reconnect may be in progress
Check Serial Monitor: Should show "[WS] Client connecting..." when app connects
Restart app: Force close and reopen ToolEase
Check firewall: Some tablets may block local connections

RFID Scan Times Out

Problem: "No RFID tag detected" even after scanning Solutions:

Check WebSocket connection (green WiFi icon)
Verify RFID tag is registered in system
Hold tag closer to RC522 reader
Check Serial Monitor for RFID scan messages
Try scanning slowly (1-2 seconds hold time)

Connection Keeps Dropping

Problem: WiFi icon changes from green to red frequently Solutions:

Move tablet closer to ESP32
Disable tablet battery optimization for ToolEase app
Turn off Mobile Data completely
Check for WiFi interference (microwaves, other 2.4GHz devices)
Use external antenna on ESP32 if available

Common Issues - Quick Reference

Issue	Check This
No WiFi network	ESP32 powered on? Serial Monitor shows "Access Point started"?
Can't connect WiFi	Correct password (toolease123)? Mobile data OFF?
Red WiFi icon	Wait 3 seconds for auto-reconnect. Check Serial Monitor.
Scan timeout	Green WiFi icon first? Hold tag close to reader?
Connection drops	Move closer to ESP32. Check for interference.

Debug Tools

Serial Monitor: ESP32 debugging output
Flutter DevTools: App performance analysis
Database Inspector: View SQLite data
Network Tools: WebSocket traffic monitoring

Migration Summary (Bluetooth → WiFi)

✅ ToolEase: Bluetooth Removed - WiFi Restored

Summary of Changes

All Bluetooth code and dependencies removed from both ESP32 and Flutter
WebSocket over WiFi is now the only communication method
ESP32 creates a WiFi Access Point (ToolEase_RFID)
Tablet connects to ESP32 WiFi and communicates via WebSocket (port 81)
All screens, providers, and services updated to use WebSocket
Documentation and troubleshooting updated for WiFi workflow

Key Improvements

Simpler setup (no Bluetooth pairing)
Faster and more reliable connection
Auto-reconnect on disconnect
Clearer connection status in app
Better range and performance

How to Use

Upload ESP32 firmware
Connect tablet to ToolEase_RFID WiFi
Launch ToolEase app
Look for green WiFi icon
Scan RFID tags as usual

For full details, see the sections above and the WiFi Setup and Testing & Validation checklists.

Project Structure

Toolease/
├── LICENSE
├── README.md
├── models/                          # 3D printable parts
│   ├── *.png                        # Render images
│   └── *.gcode                      # Print files
├── source/
│   ├── esp32/
│   │   └── Toolease/
│   │       ├── Toolease.ino         # Main firmware
│   │       ├── Rfid_Config.h/.cpp   # RFID handling
│   │       └── Websocket_Config.h/.cpp # Network comms
│   └── flutter/
│       └── Toolease/
│           ├── lib/
│           │   ├── main.dart        # App entry point
│           │   ├── core/            # Design system
│           │   ├── models/          # Data models
│           │   ├── providers/       # State management
│           │   ├── database/        # Drift database
│           │   ├── services/        # Business logic
│           │   ├── screens/         # UI screens
│           │   └── shared/          # Reusable components
│           ├── test/                # Unit tests
│           ├── android/             # Android config
│           ├── ios/                 # iOS config
│           └── pubspec.yaml         # Dependencies
└── wiring/                          # Hardware diagrams

Future Enhancements

Short Term

Cloud synchronization for multi-device support
Barcode/QR code integration alongside RFID
Advanced search and filtering capabilities
Email/SMS notifications for due dates
Bulk import/export functionality

Medium Term

User roles and permissions system
Maintenance scheduling and tracking
Cost tracking and budgeting features
Mobile app for students (companion to kiosk)
Advanced analytics and reporting

Long Term

Multi-location support with centralized management
Integration with existing LMS systems
AI-powered predictive maintenance
AR-based item identification
Blockchain-based transaction verification

Contributing

We welcome contributions to Toolease! Please follow these guidelines:

Fork the repository
Create a feature branch (git checkout -b feature/YourFeature)
Commit changes (git commit -m 'Add YourFeature')
Push to branch (git push origin feature/YourFeature)
Open a Pull Request

Development Setup

# Clone and setup
git clone https://github.com/qppd/Toolease.git
cd Toolease/source/flutter/Toolease
flutter pub get
flutter pub run build_runner build

# Run tests
flutter test

# Code formatting
flutter format .

Code Standards

Follow Flutter/Dart best practices
Use Riverpod for state management
Implement proper error handling
Add unit tests for new features
Update documentation

Support & Contact

Developer Information

Developer: Quezon Province Provincial Developer
Email: quezon.province.pd@gmail.com
Portfolio: sajed-mendoza.onrender.com
GitHub: qppd

Community

Facebook: qppd.dev
Facebook Page: QUEZONPROVINCEDEVS

Documentation

User Manual: Built into the Flutter app
API Docs: Inline code documentation
Hardware Guide: Wiring diagrams and assembly instructions

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

ESP32 Community: Excellent documentation and support
Flutter Team: Outstanding cross-platform framework
Drift ORM: Powerful Dart database solution
MFRC522 Contributors: Reliable RFID implementation
Open Source Libraries: WebSockets, Riverpod, and more

Built with ❤️ for educational institutions and workshops worldwide

Name		Name	Last commit message	Last commit date
Latest commit History 31 Commits
.vscode		.vscode
models		models
source		source
wiring		wiring
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md

Folders and files

Latest commit

History

Repository files navigation

ToolEase

Table of Contents

Overview

Key Features

System Architecture

Bill of Materials (BOM) & Procurement Sources

1. Electronics (Makerlab Electronics – Lazada or Direct Store)

2. Display

3. Power System

4. Enclosure / Physical Build (Hardware Store)

Procurement Notes

Total Estimated Cost Breakdown

Physical Assembly & Views

Full Device Views

Complete Assembly (All Angles)

Front View

Back View

Side View

Top View

3D Printed Parts & Covers

Wiring Diagram & Fritzing

Visual Wiring Diagram

Fritzing Source File

Software Dependencies

Flutter App

ESP32 Firmware

Installation & Setup

ESP32 Setup

Flutter App Setup

Connect Tablet to ESP32 WiFi

Configuration

Flutter App

ESP32

Database

Operation Guide

For Students

For Admins

RFID Workflow

API & Communication

WebSocket Protocol

Database API

Serial Commands (ESP32)

Testing & Validation

Troubleshooting

Project Structure

Future Enhancements

Contributing

Support & Contact

License

🚀 Quick Start

ESP32 Setup

Tablet Setup

Usage

WiFi/WebSocket Details

WiFi & WebSocket Setup

System Features

Database & Code Structure

Database

Code Structure

ESP32 Pinout

Deployment & Testing

Pre-Deployment Checklist

Build & Install

Testing

Troubleshooting

Migration & Changelog

License

Administrative Features

Hardware Integration

User Experience

System Architecture

Data Flow

Hardware Components

ESP32 Development Board

RFID Module (MFRC522)

Power Supply