GPS - Cell modem
Added: 2026-10
Many Quectel cell modems include a GNSS receiver. Kismet can use it as a GPS through the cell AT source which holds the modem.
The cellmodem GPS doesn’t open a device itself: the cell AT source reads the modem’s NMEA port, or asks the modem for its position over AT, and forwards the sentences to it. The GPS is idle until that source opens, and goes idle again when the source closes.
Configuration
Name the GPS in the cell AT source definition:
source=cellat-<imei>:gps=modem
gps=true names the GPS after the source. If no GPS with that name exists, the source creates a cellmodem GPS of that name.
The GPS can also be declared in kismet.conf or kismet_site.conf, so that it exists, with its priority, before the source opens:
gps=cellmodem:name=modem,priority=-500
Give each modem its own GPS name; a cellmodem GPS takes its location from one source, and ignores a second source which names the same GPS.
Opening the GNSS
When the source opens, it checks the modem’s GNSS (AT+QGPS?). If the GNSS is off, the source turns it on (AT+QGPS=1), and, when it will read an NMEA port, turns on the USB NMEA output if it is off (AT+QGPSCFG="outport","usbnmea"). When the source closes, the GNSS and the NMEA output are put back the way they were found.
The source then opens the modem’s NMEA port:
- For a modem on Linux serial ports, the NMEA interface of the same USB device (interface 1 on the EG25-G, RM500Q, and RM520N-GL).
- For a
/dev/wwan<N>at0AT port, the/dev/wwan<N>nmea0port beside it. - For a modem reached over libusb, its NMEA interface.
If the NMEA port isn’t found, name it with the gpsport= source option:
source=cellat-<imei>:gps=modem,gpsport=/dev/ttyUSB1
The NMEA port is read separately from the AT commands, so the GNSS and the cell polling don’t wait on each other. A GNSS failure (a modem with no GNSS, a refused AT+QGPS=1) is reported as a warning, and the cell capture keeps running.
Modems with no NMEA port
As of after 2026-10-R1, a modem with no NMEA port can still be used. A PCIe modem on MHI, for example, may expose only its AT, DIAG, and QMI ports. When no NMEA port is found, or with gpsport=at, the source asks the modem for its position with AT+QGPSLOC=0 on the AT port instead:
source=cellat-<imei>:gps=modem,gpsport=at
- The position is asked for once a second, between the cell queries, and is forwarded as NMEA sentences, just as an NMEA port’s are.
- “Not fixed now” (
+CME ERROR: 516, or its verbose form) keeps the GPS connected with no fix. - After 10 polls in a row with no usable answer, the source reports a warning and asks every 30 seconds until the GNSS answers again. A bare
ERROR(the modem’s errors set toAT+CMEE=0, or the GNSS turned off by something else) counts as no answer. - The NMEA output setting is left alone.
- A full scan holds the AT port, so the position pauses for the length of the scan and the GPS may go stale.
- The polls are left out of the
RawATrecords unless the source hasdebug=true.
Only Quectel modems are supported; on other modems gps= reports a warning and the GNSS isn’t used.
Priority
Kismet uses the GPS with the best (lowest) priority which has a location. A cellmodem GPS defaults to priority -500: behind a dedicated GPS (serial, gpsd, and tcp default to -1000), and ahead of the web, meta, and virtual GPS (0). A modem GNSS is often less accurate than a dedicated receiver, so a dedicated GPS is used when one is present.
The cell observations from the source which feeds the GPS are tagged with that modem’s GNSS location once the modem has reported one, even when another GPS has a better priority.
GPS options
Common options
name={ name }
gps=<name>. Names may use letters, digits, -, _, and ., up to 64 characters.priority={ priority }
-500.