This directory contains detailed documentation for all Meshtastic Node Mapper features, with a focus on the latest enhancements introduced in version 1.1.0.
RF Link Visualization ⭐ NEW
- Real-time RF connection detection and visualization
- Traceroute and packet-based link discovery
- Signal quality color coding
- Hop depth filtering
- Bidirectional link detection
- Time range selection
- Link statistics and analytics
Map Features
- Interactive OpenStreetMap-based visualization
- Multiple tile layer support
- Node clustering for performance
- Real-time position updates
- Coverage area visualization
- Custom overlays and layers
Theme Customization ⭐ NEW
- Light, dark, and auto theme modes
- System preference detection
- Smooth theme transitions
- Theme-aware maps and charts
- Mobile browser integration
- Persistent theme preferences
Mobile Optimization ⭐ NEW
- Responsive layout for all screen sizes
- Touch-optimized controls (44x44px minimum)
- Bottom sheet navigation on mobile
- Adaptive font sizing
- Progressive Web App (PWA) support
- Offline mode capabilities
- Location services integration
Dashboard Analytics ⭐ NEW
- Six real-time metric cards
- Seven interactive charts
- Network activity trends (7 days)
- Node activity distribution
- Gateway activity analysis
- Signal quality distribution
- Message routing patterns
- Protocol usage breakdown
- Most active nodes table
- Auto-refresh every 60 seconds
Network Insights
- Comprehensive network statistics
- Node distribution analysis
- Message analytics
- Network health monitoring
- Coverage analysis
- Utilization tracking
Distance Calculation ⭐ NEW
- Haversine formula implementation
- Distance display on RF links
- Longest links analysis
- Multi-hop distance calculation
- Location history caching
- Age warnings for stale data
Line of Sight Analysis ⭐ NEW
- Two-node LOS analysis
- Elevation profile visualization
- Fresnel zone clearance calculation
- Terrain obstruction detection
- Bearing/azimuth calculation
- Historical connectivity data
- Shareable analysis URLs
Gateway Comparison ⭐ NEW
- Side-by-side gateway analysis
- Common packet detection
- Signal quality comparison
- RSSI and SNR scatter plots
- Timeline charts
- Difference histograms
- CSV export capability
Packet Analysis ⭐ NEW
- Packet grouping by ID
- Advanced filtering options
- Time range filters
- Node and gateway pickers
- Port number filtering
- Hop count filtering
- RSSI/SNR range filters
- TEXT_MESSAGE_APP decoding
- Relay node formatting
Data Retention ⭐ NEW
- Configurable retention policies
- Automatic data cleanup
- Batch deletion operations
- VACUUM optimization
- Manual cleanup triggers
- Audit trail logging
- Disk space monitoring
Data Export
- Multiple format support (CSV, JSON, KML)
- Filtered exports
- Scheduled reports
- Backup and restore
- Shareable URLs
UI Components ⭐ NEW
- NodePicker: Searchable node dropdown
- GatewayPicker: Gateway selection
- ModernTable: Paginated, sortable tables
- SignalQualityBadge: Color-coded signal indicators
- TimeRangePicker: Date/time selection
- LoadingSpinner: Loading states
- EmptyState: Empty data displays
- ActionButtonGroup: Icon button groups
URL State Management ⭐ NEW
- Filter state in URL
- Bookmarkable views
- Shareable links
- Browser navigation support
- Debounced updates
- Parameter validation
Priority 1.0 - Core Network Visualization
- RF Link Visualization
- Hop Depth Filtering
- Distance Calculation
Priority 1.1 - User Experience
- Theme Support
- Mobile Responsiveness
Priority 1.2 - Analytics
- Dashboard Analytics
- Network Insights
Priority 2.0 - Advanced Analysis
- Packet Analysis
- Line of Sight
- Gateway Comparison
Priority 3.0 - Infrastructure
- Data Retention
- Reusable Components
- URL State Management
For Network Operators
- RF Link Visualization
- Dashboard Analytics
- Network Insights
- MQTT Monitor
- Data Retention
For Field Technicians
- Mobile Optimization
- Line of Sight Analysis
- Distance Calculation
- Location Services
- Offline Mode
For Analysts
- Gateway Comparison
- Packet Analysis
- Data Export
- Advanced Filtering
- Historical Data
For Administrators
- Theme Customization
- Configuration Management
- Data Retention
- Backup and Restore
- Performance Tuning
- Start with the User Guide for basic features
- Review Installation Guide for setup
- Explore RF Link Visualization for network topology
- Check Dashboard Analytics for insights
- Review Deployment Guide for upgrade steps
- Explore new features:
- Update configuration with new options
- Test new features in your environment
- Read Mobile Usage Guide
- Install as PWA for app-like experience
- Enable location services for distance features
- Configure offline mode for field use
- Adjust theme for your environment
- Review API Guide for new endpoints
- Check Developer Documentation for architecture
- Explore reusable components for custom features
- Review URL state management for integration
- Read Implementation Guides for technical details
| Feature | v1.0.0 | v1.1.0 |
|---|---|---|
| RF Link Visualization | ❌ | ✅ |
| Theme Support | ❌ | ✅ |
| Mobile Optimization | Partial | ✅ Full |
| Dashboard Analytics | Basic | ✅ Advanced |
| Packet Grouping | ❌ | ✅ |
| Distance Calculation | ❌ | ✅ |
| Line of Sight | ❌ | ✅ |
| Gateway Comparison | ❌ | ✅ |
| Data Retention | ❌ | ✅ |
| URL State Management | ❌ | ✅ |
| Reusable Components | Limited | ✅ Extensive |
- Dashboard Analytics - Real-time metrics
- RF Link Visualization - Topology view
- MQTT Monitor - Message stream
- Network Insights - Statistics
- RF Link Visualization - Connection issues
- Line of Sight Analysis - Coverage problems
- Gateway Comparison - Signal quality
- Packet Analysis - Message delivery
- Line of Sight Analysis - Node placement
- Distance Calculation - Coverage estimation
- Coverage Analysis - Gap identification
- Dashboard Analytics - Capacity planning
- Mobile Usage - Mobile interface
- Location Services - GPS integration
- Offline Mode - No connectivity
- Distance Calculation - Range testing
- Dashboard Analytics - Trends and patterns
- Data Export - External analysis
- Gateway Comparison - Performance comparison
- Packet Analysis - Message patterns
All features can be configured in config/app.yml. See Deployment Guide for configuration examples.
# Enable all new features
rfLinks:
enabled: true
theme:
enabled: true
mobile:
enabled: true
dashboard:
enabled: true
packets:
groupingEnabled: true
distance:
enabled: true
lineOfSight:
enabled: true
gatewayComparison:
enabled: true- Increase cache timeouts
- Reduce time ranges
- Enable data sampling
- Use hop depth filtering
- Limit visible nodes
See Performance Optimization for details.
- Enable battery saver mode
- Use dark theme (OLED screens)
- Reduce update frequency
- Enable offline mode
- Lower map quality
See Mobile Usage Guide for details.
Common issues and solutions:
- RF Links Not Appearing: Check RF Link Troubleshooting
- Theme Not Changing: See Theme Troubleshooting
- Mobile Layout Issues: Review Mobile Troubleshooting
- Dashboard Not Loading: Check Dashboard Troubleshooting
For general issues, see the main Troubleshooting Guide.
All features are accessible via REST API. See API Guide for:
- RF Links:
GET /api/map/links - Dashboard:
GET /api/analytics/dashboard - Distance:
GET /api/links/longest - Line of Sight:
GET /api/analysis/line-of-sight - Gateway Comparison:
GET /api/gateways/compare - Packets:
GET /api/packets/grouped
- User Guide - Complete feature walkthrough
- Installation Guide - Setup instructions
- API Guide - API documentation
- Developer Guide - Development documentation
- Troubleshooting - Common issues
- Documentation: Start here for feature guides
- GitHub Issues: Report bugs and request features
- GitHub Discussions: Ask questions and share tips
- Meshtastic Forums: Connect with the community
Version: 1.1.0
Last Updated: December 2024
Status: All features documented and tested