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
parent
ea370ac702
commit
e7c8fad272
8 changed files with 884 additions and 47 deletions
255
docs/ROADMAP.md
Normal file
255
docs/ROADMAP.md
Normal 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*
|
||||
Loading…
Add table
Add a link
Reference in a new issue