AndroidAisMap/GPS_NMEA_TROUBLESHOOTING.md

Решение проблем с NMEA сообщениями в Android

Проблема

RMC пакеты то приходят, то не приходят, особенно при старте приложения. Это типичная проблема холодного запуска GPS в Android.

Причины проблемы

1. Холодный запуск GPS

• GPS модуль включен ≠ GPS активен и отправляет данные
• Android может держать GPS в "спящем" режиме для экономии батареи
• NMEA сообщения не отправляются без активных слушателей

2. Отсутствие активного запроса локации

• addNmeaListener() регистрирует слушатель, но не активирует GPS
• Нужен активный requestLocationUpdates() для "пробуждения" GPS
• Без этого NMEA может не приходить часами

3. Проблемы с регистрацией слушателей

• Неправильный порядок регистрации
• Отсутствие обработки ошибок
• Проблемы с версиями Android API

Решения

1. Улучшенная регистрация NMEA слушателя

// Регистрируем с Handler для лучшей производительности
locationManager.addNmeaListener(this, mainHandler);

// Сразу запрашиваем обновления локации для активации GPS
requestLocationUpdates();

2. Агрессивная активация GPS

// Минимальные интервалы для быстрой активации
locationManager.requestLocationUpdates(
    LocationManager.GPS_PROVIDER, 
    100,  // 100мс вместо 1000мс
    0,    // 0 метров
    locationListener,
    mainHandler
);

// Дополнительно запрашиваем одиночное обновление
locationManager.requestSingleUpdate(LocationManager.GPS_PROVIDER, ...);

3. Обработка GPS событий

// При старте GNSS сразу активируем GPS
@Override
public void onStarted() {
    requestLocationUpdates(); // Активируем GPS
}

// При первом фиксировании также активируем
@Override
public void onFirstFix(int ttffMillis) {
    requestLocationUpdates(); // Дополнительная активация
}

4. Поддержка старых версий Android

if (Build.VERSION.SDK_INT < Build.VERSION_CODES.N) {
    // Старый API - GpsStatus.Listener
    locationManager.addGpsStatusListener(gpsStatusListener);
} else {
    // Новый API - GnssStatus.Callback
    locationManager.registerGnssStatusCallback(gnssStatusCallback, mainHandler);
}

Диагностика

Логи для отслеживания

=== ДИАГНОСТИКА GPS ===
Доступные провайдеры:
  gps: включен
  network: включен
  passive: включен

=== РЕГИСТРАЦИЯ СЛУШАТЕЛЕЙ ===
✅ NMEA слушатель зарегистрирован
✅ GNSS статус callback зарегистрирован (новый API)
✅ Location updates запрошены с минимальным интервалом (100мс)
✅ Одиночное обновление запрошено

🎯 NMEA [RMC] получено: $GPRMC,123456,A,...
🚢 RMC сообщение получено - GPS активен!

Проверка состояния

// Детальная информация о GPS
String gpsInfo = nmeaListener.getGPSStatusInfo();
Log.i(TAG, gpsInfo);

// Принудительная активация
nmeaListener.forceGPSActivation();

Рекомендации

1. При запуске приложения

• Сразу регистрируйте NMEA слушатель
• Запрашивайте location updates с минимальными интервалами
• Обрабатывайте GPS события для дополнительной активации

2. При проблемах с получением NMEA

• Проверьте логи на наличие ошибок
• Убедитесь, что GPS провайдер включен
• Попробуйте принудительную активацию GPS
• Проверьте количество видимых спутников

3. Оптимизация

• Используйте минимальные интервалы только при необходимости
• Обрабатывайте ошибки и повторяйте попытки
• Мониторьте состояние GPS через callback'и

Тестирование

Используйте NMEATestHelper для диагностики:

NMEATestHelper testHelper = new NMEATestHelper(context);
testHelper.startTest(); // Запускает тест с периодической диагностикой
testHelper.forceGPSActivation(); // Принудительная активация
testHelper.stopTest(); // Остановка теста

Частые проблемы

1. "GPS провайдер отключен" - включите GPS в настройках
2. "Нет разрешения ACCESS_FINE_LOCATION" - запросите разрешение
3. "LocationManager недоступен" - проверьте инициализацию
4. NMEA не приходит - проверьте логи, попробуйте принудительную активацию

Заключение

Проблема с RMC пакетами решается правильной последовательностью:

1. Регистрация NMEA слушателя
2. Активация GPS через location updates
3. Обработка GPS событий
4. Диагностика и мониторинг

После этих изменений NMEA сообщения должны приходить стабильно, даже при холодном запуске GPS.