Prerequisite

Project Mina Prerequisites

🛠️ Development Environment

Arduino IDE

• Version: 2.3.6 or newer
• Download: Arduino IDE

ESP32 Board Support

1. Open Arduino IDE
2. Go to File → Preferences
3. Add ESP32 board URL to Additional Board URLs:

   https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json
   

4. Go to Tools → Board → Boards Manager
5. Search for "ESP32"
6. Install "ESP32 by Espressif Systems"

📚 Required Libraries

Library	Purpose	Installation
ESPAsyncWebServer	Async HTTP and WebSocket server	Library Manager
AsyncTCP	Required by ESPAsyncWebServer	Library Manager
RTClib	RTC support by Adafruit	Library Manager
ArduinoJson	JSON parsing and creation	Library Manager
NTPClient	Network time synchronization	Library Manager
Preferences	Settings persistence	Built-in
WiFi	Network connectivity	Built-in

⚙️ Board Configuration

Set these options under Tools menu:

Setting	Value
Board	ESP32 Dev Module
Upload Speed	921600
CPU Frequency	240MHz
Flash Frequency	80MHz
Flash Mode	QIO
Flash Size	4MB (32Mb)
Partition Scheme	Default 4MB with spiffs

📥 LittleFS Setup

1. Install LittleFS Uploader:

   • Download ESP32 LittleFS Plugin
   • Check Resources section for detailed installation guide

2. Install LittleFS Library:

   • See Resources section for setup details

💾 Memory Requirements

Required free space:

• Program storage: TBD
• Dynamic memory: TBD

🔌 Hardware Compatibility

Currently tested on:

• ESP32 DevKit V1 (30-pin version)
• Other ESP32 boards may work but are untested

🔗 Resources

Essential documentation and guides:

• ESP32 Arduino Core Documentation
• ESPAsyncWebServer Wiki
• RTClib Documentation
• Arduino IDE 2 Installation Guide
• LittleFS Uploader Guide

⚠️ Common Issues

1. LittleFS Upload Fails

   • Close Serial Monitor
   • Restart Arduino IDE
   • Check correct COM port selection

2. Library Conflicts

   • Install AsyncTCP before ESPAsyncWebServer
   • Use compatible library versions

3. Upload Errors

   • Hold BOOT button while pressing and releasing the RESET/EN button
   • Check USB cable data capability
   • Verify board settings

_{Last updated: April 2025}