https://github.com/pilebones/go-gpsd

Go daemon to provides a human readable interface of GPS-device informations
https://github.com/pilebones/go-gpsd

go golang gps-tracking gpsd

Last synced: 17 days ago
JSON representation

Go daemon to provides a human readable interface of GPS-device informations

• Host: GitHub
• URL: https://github.com/pilebones/go-gpsd
• Owner: pilebones
• License: gpl-3.0
• Created: 2017-07-31T13:07:29.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2022-02-19T02:31:20.000Z (almost 3 years ago)
• Last Synced: 2024-06-20T22:35:39.250Z (7 months ago)
• Topics: go, golang, gps-tracking, gpsd
• Language: Go
• Homepage:
• Size: 46.9 KB
• Stars: 4
• Watchers: 0
• Forks: 0
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# go-gpsd [![Go Report Card](https://goreportcard.com/badge/github.com/pilebones/go-gpsd)](https://goreportcard.com/report/github.com/pilebones/go-gpsd) [![GitHub Repo stars](https://img.shields.io/github/stars/pilebones/go-gpsd)](https://somsubhra.github.io/github-release-stats/?username=pilebones&repository=go-gpsd) [![GoDoc](https://godoc.org/github.com/pilebones/go-gpsd?status.svg)](https://godoc.org/github.com/pilebones/go-gpsd) [![Release](https://img.shields.io/github/release/pilebones/go-gpsd.svg)](https://github.com/pilebones/go-gpsd/releases/latest) [![License](https://img.shields.io/github/license/pilebones/go-gpsd)](/LICENSE) ![Build Status](https://github.com/pilebones/go-gpsd/workflows/CI/badge.svg) [![Coverage Status](https://coveralls.io/repos/github/pilebones/go-gpsd/badge.svg?branch=master)](https://coveralls.io/github/pilebones/go-gpsd?branch=master)

GPSd provides a human readable and HTTP interface about GPS-device informations.

__/!\ Work in progress /!\__

Tested with this [GPS Module](http://wiki.52pi.com/index.php/USB-Port-GPS_Module_SKU:EZ-0048) cover [L80 gps protocol specification v1.0.pdf](http://wiki.52pi.com/index.php/File:L80_gps_protocol_specification_v1.0.pdf).

## Features

- Read GPS message from USB-Serial device like `/dev/ttyUSBx`.

- Auto-detect GPS device mode (hot-plug like udev or lookup existing device).

- Provide HTTP API to get GPS informations and state.

## How to

### Get sources

```

go get github.com/pilebones/go-gpsd

```

### Unit test

```

go test ./...

```

### Compile

```

go build

```

### Usage

```

./go-gpsd -help

  -autodetect

        Allow to enable auto-detection of the GPS device (already plugged or hot-plugged)

  -autodetect-timeout duration

        Time spent to try to autodetect the GPS device (exit 2 if fail) (default 5s)

  -input string

        Char device path related to the serial port of the GPS device (default "/dev/ttyUSB0")

  -target string

        HTTP listener to get GPS state (default "127.0.0.1:1234")

  -timeout duration

        Max duration allowed to read and parse a GPS sentence from serial-port (default 5s)

```

Note: you should run binary by user with elevated privileges to have access to /dev kernel struct.

### Example

To auto-detect GPS device and handle GPS message:

```

(sudo) ./go-gpsd -autodetect

```

## Throubleshooting

Don't hesitate to notice if you detect a problem with this tool or library.

## Documentation

- [GoDoc Reference](http://godoc.org/github.com/pilebones/go-gpsd).

## License

go-udev is available under the [GNU GPL v3 - Clause License](https://opensource.org/licenses/GPL-3.0).