Build a Local NEO-6M GPS Reader

// ESP32 NEO-6M GPS reader
// Prints only valid fixes; no fabricated coordinates are used.
#include <TinyGPS++.h>

TinyGPSPlus gps;
HardwareSerial gpsSerial(2);

const int GPS_RX = 16; // ESP32 receives GPS TX here
const int GPS_TX = 17; // Optional ESP32 TX to GPS RX

unsigned long lastStatusMs = 0;

void setup() {
  Serial.begin(115200);
  gpsSerial.begin(9600, SERIAL_8N1, GPS_RX, GPS_TX);
  Serial.println("GPS reader ready. Place the antenna with a clear sky view.");
}

void loop() {
  while (gpsSerial.available()) {
    gps.encode(gpsSerial.read());
  }

  if (gps.location.isUpdated()) {
    if (gps.location.isValid()) {
      Serial.print("Latitude: ");
      Serial.println(gps.location.lat(), 6);
      Serial.print("Longitude: ");
      Serial.println(gps.location.lng(), 6);
      Serial.print("Satellites: ");
      Serial.println(gps.satellites.value());
      Serial.print("HDOP: ");
      Serial.println(gps.hdop.isValid() ? gps.hdop.hdop() : 0.0, 2);
      Serial.println("---");
    } else {
      Serial.println("GPS data received, but no valid location fix yet.");
    }
  }

  if (millis() - lastStatusMs > 5000) {
    lastStatusMs = millis();
    if (gps.charsProcessed() < 10) {
      Serial.println("No NMEA characters yet. Check TX-to-RX wiring and module power.");
    } else if (!gps.location.isValid()) {
      Serial.println("Waiting for satellite lock. Move antenna near a window or outdoors.");
    }
  }
}