A comprehensive React Native test application for the react-native-gnss-status-checker library v1.0.2+.
This test app has been completely upgraded to showcase the major enhancements in the GNSS library:
- Detailed Satellite Information: Individual satellite data with SVID, signal strength, elevation, azimuth
- 15+ Helper Functions: Filter and analyze satellites by constellation, signal quality, and usage
- Comprehensive Statistics: Total, used in fix, ephemeris/almanac status, average C/N0
- Sean Barbeau's GNSS Research: Comprehensive frequency mapping across all constellations
- Dual-Frequency Detection: Enhanced detection for L2, L5, E5a, E5b, B2a, B3, E6, LEX, S-band
- Frequency Band Identification: Automatic identification of specific frequency bands
- Constellation Filtering: GPS, GLONASS, Galileo, BeiDou, NavIC/IRNSS, QZSS separation
- Signal Quality Analysis: Filter satellites by C/N0 threshold (e.g., >25 dB-Hz)
- Performance Metrics: Fix quality, signal quality, dual-frequency capability assessment
- React Hooks Integration: Live updates using the
useGnssStatushook pattern - Event-Driven Updates: Real-time satellite and measurement changes via
DeviceEventEmitter - Background Monitoring: Continuous GNSS status tracking
The enhanced test app provides 4 comprehensive testing modes:
- Traditional GNSS capability check
- Shows supported constellations and carrier frequencies
- Displays first 5 satellites with detailed information
- API level and feature compatibility assessment
- Constellation Breakdown: Per-constellation satellite counts
- Signal Analysis: Total, used in fix, ephemeris/almanac status
- Quality Assessment: High-quality satellites (>25 dB-Hz threshold)
- Performance Indicators: Fix quality percentage, signal quality metrics
- Detected Frequencies: Real-time frequency identification with band mapping
- Reference Table: Complete frequency mapping for all GNSS constellations
- Capability Assessment: Dual-frequency support analysis
- Device Compatibility: API level and feature support evaluation
- Live Monitoring: Real-time updates using React hooks
- Performance Metrics: Live satellite counts, signal quality, frequencies
- Event-Driven: Updates via
DeviceEventEmitteras shown in npm docs
interface SatelliteInfo {
svid: number; // Satellite ID
constellationType: number; // GPS, GLONASS, etc.
constellationName: string; // Human readable
cn0DbHz?: number; // Signal strength
elevation?: number; // Angle above horizon
azimuth?: number; // Compass direction
hasEphemeris: boolean; // Orbital data
hasAlmanac: boolean; // Satellite almanac
usedInFix: boolean; // Used in position calculation
carrierFrequencyHz?: number; // Frequency (API 26+)
}getSatellitesByConstellation()- Filter by constellation typegetSatellitesUsedInFix()- Get satellites used in position fixgetSatellitesWithGoodSignal()- Filter by signal strength thresholdgetSatelliteStatistics()- Generate comprehensive statisticsidentifyFrequencyBand()- Identify specific frequency bandsgetFrequencyBandInfo()- Detailed frequency analysis
const useGnssStatus = () => {
const [status, setStatus] = useState<GnssStatusResult | null>(null);
const [isListening, setIsListening] = useState(false);
// Real-time monitoring with DeviceEventEmitter
// Automatic cleanup and error handling
return { status, isListening };
};| Feature | Min API | Android Version | Support Level |
|---|---|---|---|
| Basic satellite count | 21 | 5.0 | ✅ Always |
| Signal strength (C/N0) | 24 | 7.0 | ✅ Conditional |
| Carrier frequencies | 26 | 8.0 | ✅ Conditional |
| Enhanced analysis | 24 | 7.0 | ✅ Helper functions |
-
Install Dependencies:
npm install # or yarn install -
Update Package:
npm install [email protected]
-
Build & Run:
npx react-native run-android
- Satellites: 8-25+ visible satellites
- Constellations: GPS + GLONASS + Galileo (+ BeiDou, NavIC)
- Frequencies: L1 (1575.42 MHz) + others
- Dual-Frequency: L5 (1176.45 MHz) on modern devices
- Signal Quality: Multiple satellites >25 dB-Hz
- Satellites: 0-4 satellites (severely limited)
- Signal Quality: Poor (usually <20 dB-Hz)
- Frequency Detection: May not detect advanced features
Based on Sean Barbeau's GNSS research, includes all major frequency bands:
- GPS: L1, L2, L5
- GLONASS: L1, L2 (with frequency ranges)
- Galileo: E1, E5a, E5b, E6
- BeiDou: B1, B2a, B3
- NavIC: L5, S-band
- QZSS: L1, L5, LEX
- Individual satellite analysis with detailed metrics
- Constellation-specific filtering and statistics
- Signal quality assessment with configurable thresholds
- Real-time performance monitoring
- Custom React hooks for GNSS monitoring
- Event-driven real-time updates
- Proper cleanup and error handling
- TypeScript support throughout
- Solution: Requires Android 7.0+ (API 24+)
- Alternative: Basic satellite count still works on older devices
- Solution: Requires Android 8.0+ (API 26+)
- Alternative: Frequency mapping and identification still available
- Solution: Update to
[email protected] - Check: Verify import statements match new API
- Solution: Move outdoors with clear sky view
- Wait: Allow 2-5 minutes for satellite acquisition
- Check: Ensure location permissions are granted
- NPM Package: react-native-gnss-status-checker
- Sean Barbeau's Research: GNSS frequency mapping and dual-frequency detection
- Android GNSS API: LocationManager, GnssStatus, GnssMeasurementsEvent
This test application demonstrates the comprehensive capabilities of the enhanced GNSS library. Feel free to extend the testing modes or add new analysis features!
MIT License - Test application for the react-native-gnss-status-checker library.
🎯 This enhanced test app showcases the transformation from a basic satellite checker to a comprehensive GNSS analysis toolkit with research-backed frequency detection and real-time monitoring capabilities.