6 December 2020
gpsinit 8 The GPSD Project GPSD Documentation
gpsinit initialize CAN kernel modules for GPSD
`gpsinit` -n control -s speed module_name interface_name `gpsinit` -h `gpsinit` -V

## DESCRIPTION

gpsinit initializes whatever kernel-level modules are needed to enable special non-serial hardware to communicate with a gpsd instance. Note: it will need root permissions to load modules and perform other special operations, such as changing kernel-interface baudrates.

At present, all modes of this tool are concerned with setting up kernel-level interfaces to hardware on a CAN (Control Area Network) speaking NMEA2000.

The program accepts the following options:

`-h`

  Display a brief help text.

`-n`

  Set the CAN network number. The default is 0.

`-s`

  Set the baudrate to be used to communicate over the serial line to the CAN hardware. The default is 38400 baud.

`-V`

  Display the version of gpsinit.

The parameter module_name is mandatory. The socket CAN driver module module_name.ko will be loaded. `gpsinit` recognize the following module names:

plx_pci
esd_usb2
vcan
slcan

  The parameter interface_name and -s speed can used here.

beaglebone

  The dcan module needed for the beaglebone is part of the Linux kernel, so no module is loaded in this case.

The parameter interface_name is needed for slcan hardware only. It gives the name of the serial device to which the SL CAN hardware is connected. The default is /dev/ttyUSB0.

## EXAMPLES

All the following examples probably need to be run as root.

`gpsinit plx_pci`

  Attempt to load the module plx_pci and initialize net 0 for the connection to a NMEA2000 network. It will set the baudrate to 250kBits.

`gpsinit -n 1 plx_pci`

  As above, but use net 1.

`gpsinit -s 38400 slcan /dev/ttyUSB0`

  Attempt to load the module slcan and talk to the hardware at 38400 baud connected to port /dev/ttyUSB0.

`gpsinit -h`

  Display a brief help message.

`gpsinit -v`

  Display the version of gpsinit.

## SEE ALSO

gpsd 8 , gps 1 , libgps 3 , libgpsmm 3 .

## AUTHOR

Reinhard Arlt reinhard.arlt@t-online.de.