Reorganize project structure and create development roadmap

- Move documentation to organized docs/ directory structure
- Add dev notes
- Create comprehensive 5-phase roadmap for indoor positioning system
- Move AT command manual and hardware images to docs/
- Update README with hardware links and project overview
- Remove sleep mode and OTA functionality for simplification
- Clean up project structure for production development
This commit is contained in:
martin 2025-08-20 14:19:41 +02:00
commit e7c8fad272
8 changed files with 884 additions and 47 deletions

255
docs/ROADMAP.md Normal file
View file

@ -0,0 +1,255 @@
# Indoor Positioning System Roadmap
**MaUWB ESP32-S3 Warehouse Positioning & WiFi Mapping System**
---
## 🎯 Project Overview
**Purpose**: Indoor positioning system for warehouse WiFi strength mapping
- **Hardware**: 1 mobile tag + 8+ battery-powered anchors
- **Connectivity**: Tag connects to PC via USB, anchors are wireless-only
- **Constraint**: Tag connects to 8 closest anchors (auto-switching)
- **Goal**: Quick installation (<15 min) with automatic anchor positioning
---
## 📋 System Requirements
### Hardware Components
- [ ] **Tag Device**: ESP32-S3 with USB connectivity
- [ ] **Anchor Devices**: 8+ ESP32-S3 units (battery powered)
- [ ] **PC Interface**: USB connection for data collection
- [ ] **Power Management**: Battery-powered anchors (no mains/WiFi)
### Core Constraints
- ✅ Battery-powered anchors (no WiFi connectivity)
- ✅ Tag connects to 8 closest anchors (auto-switching)
- ✅ USB-only connection (tag to PC)
- ✅ No WiFi scanning needed (handled by PC)
- ✅ Warehouse too large for simultaneous connection to all anchors
---
## 🏗️ System Architecture
### Data Flow Design
```
Anchors (Battery) → Auto-Position Calibration → Store Coordinates Locally
Tag (Mobile) → Collect Raw Data + Anchor Coordinates → PC (USB) → Real-time Display
↓ ↓
Two Log Files Live Position View
Web Application
(Load both files)
```
### Critical Problem Solved
**Challenge**: How do battery-powered anchors transmit calibrated positions to PC?
**Solution**: Dual-file approach - Tag logs raw positioning data + anchor coordinates separately, webapp loads both files for offline processing
---
## 🚀 Implementation Roadmap
### Phase 1: Anchor Auto-Positioning System
**Duration**: 2-3 weeks
#### 1.1 Distributed Positioning Algorithm
- [ ] **Anchor Discovery Protocol**
- All anchors broadcast discovery signals on startup
- Build neighbor discovery table for each anchor
- Implement range-based network topology mapping
- [ ] **Distance Measurement Matrix**
- Each anchor measures distances to all neighbors in range
- Store distance measurements locally (EEPROM/flash)
- Handle partial connectivity (not all anchors can reach each other)
- [ ] **Coordinate System Establishment**
- Designate anchor with most connections as origin (0,0)
- Establish coordinate system orientation
- Implement distributed position calculation algorithm
- [ ] **Position Calculation & Storage**
- Each anchor calculates its own position using trilateration
- Store calculated position in local memory
- Implement position confidence scoring
#### 1.2 Anchor Communication Protocol
- [ ] **Inter-Anchor Data Exchange**
- Protocol for sharing distance measurements
- Handle multi-hop communication for distant anchors
- Implement data consistency checks
- [ ] **Position Refinement**
- Iterative position improvement algorithm
- Consensus mechanism for coordinate system alignment
- Error detection and correction
### Phase 2: Tag Data Relay System
**Duration**: 2 weeks
#### 2.1 Enhanced Tag Functionality
- [ ] **Anchor Discovery & Connection**
- Scan for available anchors
- Connect to 8 closest/strongest anchors
- Implement smooth anchor switching logic
- [ ] **Position Data Collection**
- Request calibrated positions from connected anchors
- Aggregate anchor position data
- Handle missing or incomplete anchor data
- [ ] **Real-time Positioning**
- Calculate tag position using 8 connected anchors
- Maintain position continuity during anchor handoffs
- Implement position smoothing/filtering
#### 2.2 Tag Data Logging System
- [ ] **Dual-File Logging**
- **File 1**: Raw positioning data (distances, RSSI, timestamps)
- **File 2**: Anchor coordinates database (collected from connected anchors)
- USB transfer to PC for both files
- [ ] **Data Collection Protocol**
- Request anchor coordinates: "Send me your calibrated position"
- Anchor responds: {anchor_id, x, y, calibration_confidence}
- Store coordinates locally and update anchor database file
- Continue logging raw positioning data as current system does
### Phase 3: PC Software Development
**Duration**: 2 weeks
#### 3.1 Real-time PC Application
- [ ] **USB Communication & Live Display**
- Receive real-time data stream from tag via USB
- Parse incoming data: raw distances + anchor coordinates
- Calculate live tag position using anchor coordinates
- Display real-time position on 2D map
- [ ] **Live Monitoring Features**
- Show current tag position with live updates
- Display connected anchors and their positions
- Real-time signal strength indicators
- Live path tracking during mapping session
#### 3.2 Dual-File Logging (Background)
- [ ] **Simultaneous Data Logging**
- **raw_positioning.csv**: Tag positioning data (distances, RSSI, timestamps)
- **anchor_coordinates.csv**: Anchor position database
- Log files generated automatically during real-time session
- Export files for webapp analysis after session
- [ ] **Data Validation**
- Verify file integrity and format
- Check timestamp consistency
- Validate anchor coordinate data
### Phase 4: Web Visualization Application
**Duration**: 2-3 weeks
#### 4.1 Core Web Interface
- [ ] **Dual-File Upload & Processing**
- Upload **raw_positioning.csv** and **anchor_coordinates.csv**
- Parse and correlate both datasets
- Data validation and error handling
- Calculate actual tag positions using raw data + anchor coordinates
- [ ] **2D Warehouse Visualization**
- Display anchor positions from coordinates file
- Calculate and plot tag path using positioning algorithm
- Interactive warehouse floor plan with scalable coordinate system
#### 4.2 Path Analysis Features
- [ ] **Path Tracking Visualization**
- Tag movement path overlay
- Timeline scrubbing and playback
- Speed and direction indicators
- [ ] **Data Analysis Tools**
- Path statistics and metrics
- Export functionality (images, reports)
- Comparison between multiple mapping sessions
### Phase 5: System Integration & Optimization
**Duration**: 1-2 weeks
#### 5.1 Quick Installation Workflow
- [ ] **Automated Setup Process**
- Power-on all anchors simultaneously
- Auto-discovery and network formation
- Position calibration and verification
- Tag pairing and PC connection setup
- Target: Ready-to-use in <15 minutes
#### 5.2 System Validation
- [ ] **Accuracy Testing**
- Position accuracy validation
- Anchor auto-positioning verification
- End-to-end system testing
- [ ] **Performance Optimization**
- Battery life optimization for anchors
- Data transmission efficiency
- Real-time performance tuning
---
## 🎯 Key Technical Challenges
### 1. Distributed Anchor Positioning
**Challenge**: Anchors must calculate positions without central coordination
**Solution**: Implement distributed trilateration with consensus mechanism
### 2. Data Relay Through Tag
**Challenge**: Getting anchor position data to PC without direct connectivity
**Solution**: Tag acts as mobile bridge collecting and relaying data
### 3. Coordinate System Consistency
**Challenge**: Ensuring all anchors use same coordinate system
**Solution**: Distributed coordinate system establishment protocol
### 4. Anchor Handoff Management
**Challenge**: Smooth positioning during anchor switching
**Solution**: Position continuity algorithms and coordinate system alignment
### 5. Partial Connectivity Handling
**Challenge**: Not all anchors can communicate directly
**Solution**: Multi-hop communication and distributed data sharing
---
## 📦 Deliverables
### Software Components
- [ ] **Enhanced Anchor Firmware** - Auto-positioning and data storage
- [ ] **Enhanced Tag Firmware** - Data relay and USB communication
- [ ] **PC Data Collection Software** - USB interface and logging
- [ ] **Web Visualization Application** - Path analysis and mapping
### Documentation
- [ ] **Installation Guide** - Quick setup procedures
- [ ] **User Manual** - Operation and troubleshooting
- [ ] **Technical Documentation** - API and protocol specifications
- [ ] **Calibration Procedures** - System validation and accuracy testing
### Test Results
- [ ] **Positioning Accuracy Report** - Performance metrics
- [ ] **Battery Life Analysis** - Power consumption data
- [ ] **Installation Time Study** - Setup procedure validation
---
## 🔄 Success Criteria
1. **Installation Time**: Complete system setup in <15 minutes
2. **Positioning Accuracy**: <30cm accuracy in warehouse environment
3. **Battery Life**: Anchors operate >8 hours on single charge
4. **System Reliability**: 99%+ uptime during mapping sessions
5. **Data Integrity**: Complete path tracking with <1% data loss
6. **User Experience**: Simple web interface for path visualization
*Last Updated: 2025-01-19*
*Version: 1.0*

Binary file not shown.

After

Width:  |  Height:  |  Size: 622 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 951 KiB