GPS - Serial

Kismet can directly use NMEA serial GPS devices, either on a physical serial port or more commonly on a USB-based serial connector.

Kismet can only use serial devices which communicate in standard NMEA. For binary devices, use the gpsd GPS driver.

Modern gpsd (a GPS management daemon) typically works well with all GPS units, making the serial driver less important; generally, the gpsd GPS type will be more effective.

Configuration

gps=serial:device=/path/to/device

To determine the proper path to your GPS unit, look below in the device options.

GPS options

Common options

name={ name }

Set an arbitrary human-readable name for the GPS. This will be used in the Kismet GPS logs.

reconnect={ true } / { false }

Automatically attempt to re-open the GPS if an error occurs or the connection is interrupted.

This is enabled by default.

Serial options

device={ /path/to/serial/device }

Set the path to the serial device the GPS is on. This is required.

The path will vary based on the operating system and type of GPS. Common paths on Linux may be /dev/ttyUSB0 or /dev/ttyACM0. Common paths on macOS may be /dev/cu.usbserial.

If you are unsure of the USB device for your GPS, consult the output of dmesg or lshw after plugging it in (Linux), or ls /dev/cu.* on macOS.

baud={ speed }

Set the serial port data rate for the GPS.

By default, this is set to 4800 which is common for most NMEA GPS units.

Many USB serial adapters do not obey the speed rate and silently ignore it.