1GPSINIT(8)                    GPSD Documentation                    GPSINIT(8)
2
3
4

NAME

6       gpsinit - initialize CAN kernel modules for GPSD
7

SYNOPSIS

9       gpsinit [-n control] [-s speed] module_name [interface_name]
10
11       gpsinit -h
12
13       gpsinit -v
14

DESCRIPTION

16       gpsinit initializes whatever kernel-level modules are needed to enable
17       special non-serial hardware to communicate with a gpsd instance. Note:
18       it will need root permissions to load modules and perform other special
19       operations, such as changing kernel-interface baudrates.
20
21       At present, all modes of this tool are concerned with setting up
22       kernel-level interfaces to hardware on a CAN (Control Area Network)
23       speaking NMEA2000.
24
25       The program accepts the following options:
26
27       -h
28           Display a brief help text.
29
30       -v
31           Display the version of gpsinit.
32
33       -n
34           Set the CAN network number. The default is 0.
35
36       -s
37           Set the baudrate to be used to communicate over the serial line to
38           the CAN hardware. The default is 38400 baud.
39
40       The parameter module_name is mandatory. The socket CAN driver module
41       module_name.ko will be loaded.  gpsinit recognize the following module
42       names:
43
44       plx_pci, esd_usb2, vcan, slcan
45           The parameter interface_name and -s speed can used here.
46
47       beaglebone
48           The dcan module needed for the beaglebone is part of the Linux
49           kernel, so no module is loaded in this case.
50
51       The parameter interface_name is needed for slcan hardware only. It
52       gives the name of the serial device to which the SL CAN hardware is
53       connected. The default is /dev/ttyUSB0.
54

EXAMPLES

56       sudo gpsinit plx_pci
57           Attempt to load the module plx_pci and initialize net 0 for the
58           connection to a NMEA2000 network. It will set the baudrate to
59           250kBits.
60
61       sudo gpsinit -n 1 plx_pci
62           As above, but use net 1.
63
64       sudo gpsinit -s 38400 slcan /dev/ttyUSB0
65           Attempt to load the module slcan and talk to the hardware at 38400
66           baud connected to port /dev/ttyUSB0.
67
68       gpsinit -h
69           Display a brief help message.
70
71       gpsinit -v
72           Display the version of gpsinit.
73

SEE ALSO

75       gpsd(8), gps(1), libgps(3), libgpsmm(3).
76

AUTHOR

78       Reinhard Arlt <reinhard.arlt@t-online.de>.
79
80
81
82The GPSD Project                  18 Jan 2013                       GPSINIT(8)