1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
|
'\" t
.\" Title: gpsinit
.\" Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
.\" Date: 18 Jan 2013
.\" Manual: GPSD Documentation
.\" Source: The GPSD Project
.\" Language: English
.\"
.TH "GPSINIT" "8" "18 Jan 2013" "The GPSD Project" "GPSD Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
gpsinit \- initialize CAN kernel modules for GPSD
.SH "SYNOPSIS"
.HP \w'\fBgpsinit\fR\ 'u
\fBgpsinit\fR [\-n\ \fIcontrol\fR] [\-s\ \fIspeed\fR] \fImodule_name\fR [\fIinterface_name\fR]
.HP \w'\fBgpsinit\fR\ 'u
\fBgpsinit\fR \-h
.HP \w'\fBgpsinit\fR\ 'u
\fBgpsinit\fR \-v
.SH "DESCRIPTION"
.PP
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\&.
.PP
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\&.
.PP
The program accepts the following options:
.PP
\-h
.RS 4
Display a brief help text\&.
.RE
.PP
\-v
.RS 4
Display the version of
gpsinit\&.
.RE
.PP
\-n
.RS 4
Set the CAN network number\&. The default is 0\&.
.RE
.PP
\-s
.RS 4
Set the baudrate to be used to communicate over the serial line to the CAN hardware\&. The default is 38400 baud\&.
.RE
.PP
The parameter
\fImodule_name\fR
is mandatory\&. The socket CAN driver module
\fImodule_name\fR\&.ko will be loaded\&.
\fBgpsinit\fR
recognize the following module names:
.PP
plx_pci, esd_usb2, vcan, slcan
.RS 4
The parameter
\fIinterface_name\fR
and
\fI\-s \fR\fI\fIspeed\fR\fR
can used here\&.
.RE
.PP
beaglebone
.RS 4
The dcan module needed for the beaglebone is part of the Linux kernel, so no module is loaded in this case\&.
.RE
.PP
The parameter
\fIinterface_name\fR
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\&.
.SH "EXAMPLES"
.PP
\fBsudo gpsinit plx_pci\fR
.RS 4
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\&.
.RE
.PP
\fBsudo gpsinit \-n 1 plx_pci\fR
.RS 4
As above, but use net 1\&.
.RE
.PP
\fBsudo gpsinit \-s 38400 slcan /dev/ttyUSB0\fR
.RS 4
Attempt to load the module slcan and talk to the hardware at 38400 baud connected to port /dev/ttyUSB0\&.
.RE
.PP
\fBgpsinit \-h \fR
.RS 4
Display a brief help message\&.
.RE
.PP
\fBgpsinit \-v \fR
.RS 4
Display the version of gpsinit\&.
.RE
.SH "SEE ALSO"
.PP
\fBgpsd\fR(8),
\fBgps\fR(1),
\fBlibgps\fR(3),
\fBlibgpsd\fR(3)\&.
.SH "AUTHOR"
.PP
Reinhard Arlt
<reinhard\&.arlt@t\-online\&.de>\&.
|
