'\" t
.\"     Title: lcdgps
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.18
.\"      Date: 2023-01-10
.\"    Manual: GPSD Documentation
.\"    Source: GPSD Version 3.25
.\"  Language: English
.\"
.TH "LCDGPS" "1" "2023-01-10" "GPSD Version 3.25" "GPSD Documentation"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "NAME"
lcdgps \- LCD client for gpsd
.SH "SYNOPSIS"
.sp
\fBlcdgps\fP [OPTIONS] [server[:port[:device]]]
.sp
\fBlcdgps\fP \-h
.sp
\fBlcdgps\fP \-V
.SH "DESCRIPTION"
.sp
\fBlcdgps\fP is a client that passes \fBgpsd\fP data to \fBlcdproc\fP, turning your
car computer into a very expensive and nearly feature\-free GPS receiver.
Currently assumes a 4x40 LCD and writes data formatted to fit that size
screen. Also displays 4\- or 6\-character Maidenhead grid square output.
.sp
\fBlcdgps\fP does not require root privileges. It will also run fine as root.
Running under sudo will cause loss of functionality.
.SH "OPTIONS"
.sp
\fB\-?\fP, \fB\-h\fP, \fB\-\-help\fP
.RS 4
Print a summary of options and then exit.
.RE
.sp
\fB\-s\fP, \fB\-\-sleep\fP
.RS 4
Sleep for 10 seconds before starting.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
Print the package version and exit.
.RE
.SH "ARGUMENTS"
.sp
By default, clients collect data from the local \fBgpsd\fP daemon running
on localhost, using the default GPSD port 2947. The optional argument
to any client may override this behavior: \fB[server[:port[:device]]]\fP
.sp
For further explanation, and examples, see the \fBARGUMENTS\fP section in
the \fBgps\fP(1) man page
.SH "ENVIRONMENT"
.sp
The environment variable \fBGPSD_UNITS\fP is checked if no unit system is
specified on the command line. It may be set to \*(Aqi\*(Aq. \*(Aqimperial\*(Aq, \*(Aqm\*(Aq,
\*(Aqmetric\*(Aq, or \*(Aqn\*(Aq, \*(Aqnautical\*(Aq.
.sp
LC_MEASUREMENT and then LANG are checked if no unit system has
been specified on the command line, or in GPSD_UNITS. If the value
is \*(AqC\*(Aq, \*(AqPOSIX\*(Aq, or begins with \*(Aqen_US\*(Aq the unit system is set to
imperial. The default if no system has been selected defaults to metric.
.SH "RETURN VALUES"
.sp
\fB0\fP
.RS 4
on success.
.RE
.sp
\fB1\fP
.RS 4
on failure
.RE
.SH "SEE ALSO"
.sp
\fBcgps\fP(1), \fBgegps\fP(1), \fBgpsctl\fP(1), \fBgps\fP(1), gpsprof*(1), \fBgpsfake\fP(1),
\fBgpscat\fP(1), \fBgpspipe\fP(1), \fBgpsmon\fP(1), xgps*(1). \fBxgpsspeed\fP(1)
.sp
\fBlibgps\fP(3), \fBlibgpsmm\fP(3)
.sp
\fBgpsd\fP(8)
.SH "RESOURCES"
.sp
\fBProject web site:\fP \c
.URL "https://gpsd.io/" "" ""
.SH "COPYING"
.sp
This file is Copyright 2013 by the GPSD project
.br
SPDX\-License\-Identifier: BSD\-2\-clause