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:
parent
ea370ac702
commit
e7c8fad272
8 changed files with 884 additions and 47 deletions
79
README.md
79
README.md
|
|
@ -1,6 +1,8 @@
|
|||
# MaUWB ESP32-S3 Positioning System
|
||||
|
||||
Ultra-wideband (UWB) positioning system using ESP32-S3 and Makerfabs UWB modules.
|
||||
Ultra-wideband (UWB) positioning system using ESP32-S3 and Makerfabs UWB modules for indoor positioning and warehouse mapping applications.
|
||||
|
||||

|
||||
|
||||
## Features
|
||||
- ESP32-S3 based anchor and tag devices
|
||||
|
|
@ -8,12 +10,14 @@ Ultra-wideband (UWB) positioning system using ESP32-S3 and Makerfabs UWB modules
|
|||
- OLED display for status and measurements
|
||||
- Multiple tag support (up to 64 tags)
|
||||
- 6.8Mbps communication rate
|
||||
- Serial debugging output
|
||||
- Complete AT command implementation
|
||||
- Position calculation with trilateration
|
||||
- Anchor auto-positioning system
|
||||
- Real-time positioning with USB data logging
|
||||
|
||||
## Hardware
|
||||
- ESP32-S3 DevKit
|
||||
- Makerfabs UWB AT Module
|
||||
- SSD1306 OLED Display (128x64)
|
||||

|
||||
|
||||
**Hardware:** [Makerfabs MaUWB ESP32-S3 UWB Module](https://www.makerfabs.com/mauwb-esp32s3-uwb-module.html) with SSD1306 OLED displays
|
||||
|
||||
## Environments
|
||||
- `anchor`: Base station for positioning
|
||||
|
|
@ -33,8 +37,63 @@ pio run -e tag -t upload
|
|||
pio device monitor
|
||||
```
|
||||
|
||||
## AT Command Support
|
||||
|
||||
Complete implementation of all AT commands from the official manual:
|
||||
|
||||
### Basic Commands
|
||||
- `AT?` - Test connection
|
||||
- `AT+GETVER?` - Get firmware version
|
||||
- `AT+RESTART` - Restart module
|
||||
- `AT+RESTORE` - Factory reset
|
||||
- `AT+SAVE` - Save configuration
|
||||
|
||||
### Configuration
|
||||
- `AT+SETCFG` / `AT+GETCFG?` - Device configuration
|
||||
- `AT+SETANT` / `AT+GETANT?` - Antenna delay calibration
|
||||
- `AT+SETCAP` / `AT+GETCAP?` - System capacity settings
|
||||
- `AT+SETRPT` / `AT+GETRPT?` - Auto-reporting control
|
||||
|
||||
### Network & Power
|
||||
- `AT+SETPAN` / `AT+GETPAN?` - Network ID configuration
|
||||
- `AT+SETPOW` / `AT+GETPOW?` - Transmission power control
|
||||
- `AT+SLEEP` - Sleep mode for battery conservation
|
||||
|
||||
### Data Communication
|
||||
- `AT+DATA` / `AT+RDATA` - Custom data transmission
|
||||
- Real-time range reporting via `AT+RANGE` parsing
|
||||
|
||||
## Library Features
|
||||
|
||||
The enhanced UWBHelper library provides:
|
||||
- **Complete AT command coverage**
|
||||
- **Advanced range data parsing** for multiple anchors
|
||||
- **Position calculation algorithms** (trilateration, multilateration)
|
||||
- **Anchor position management** for auto-positioning
|
||||
- **Distance filtering** for improved accuracy
|
||||
- **Backward compatibility** with existing code
|
||||
|
||||
## Configuration
|
||||
- Network ID: 1234
|
||||
- Baud Rate: 115200
|
||||
- Communication: 6.8Mbps
|
||||
- Range filtering: Enabled
|
||||
- **Network ID**: 1234 (configurable via AT+SETPAN)
|
||||
- **Baud Rate**: 115200
|
||||
- **Communication**: 6.8Mbps (AT+SETCFG parameter)
|
||||
- **Range filtering**: Enabled for accuracy
|
||||
- **Refresh Rate**: 10Hz (configurable via AT+SETCAP)
|
||||
- **Max Anchors**: Unlimited (tags connect to 8 closest)
|
||||
- **Max Tags**: 64 per network
|
||||
|
||||
|
||||
## Documentation
|
||||
|
||||
- [AT Command Manual](docs/manuals/Makerfabs%20UWB%20AT%20Module%20AT%20Command%20Manual(v1.1.1).pdf) - Complete AT command reference
|
||||
- [Hardware Product Page](https://www.makerfabs.com/mauwb-esp32s3-uwb-module.html) - Official hardware documentation
|
||||
- [Project Roadmap](docs/ROADMAP.md) - Development plan for indoor positioning system
|
||||
|
||||
## Applications
|
||||
|
||||
This system is designed for:
|
||||
- **Indoor positioning** in warehouses and large buildings
|
||||
- **Asset tracking** and inventory management
|
||||
- **Navigation assistance** in GPS-denied environments
|
||||
- **WiFi signal mapping** and coverage analysis
|
||||
- **Research and development** in UWB positioning
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue