A Swift library for boards with the u-Blox 6/7/8 family of A-GPS receivers with an UART serial connection.
Summary
This library interfaces with boards based on u-Blox 6/7/8 A-GPS receivers, that use the NMEA0183 protocol to provide GPS data over an UART serial connection (for a low cost option, search for some NEO6M-based board that usually cost around a measly $20). UBX configuration commands and connection via I2C are not supported at the moment.
You’ll be able to retrieve your current location, elevation, speed, status data on the currently reachable satellites and more.
The first time you’ll use the receiver it will need a few minutes to find some satellites and provide a position, but after that a few seconds will be enough to obtain a valid position.
Supported Boards
Every board supported by SwiftyGPIO with support for UART interfaces.
To use this library, you’ll need a Linux ARM board with Swift 3.x.
The example below will use a RaspberryPi 2 board but you can easily modify the example to use one the the other supported boards, a full working demo projects for the RaspberryPi2 is available in the Examples directory.
Usage
If you are using a RaspberryPi, run raspi-config and enable the serial port but disable the Linux login support in Interfacing Options > Serial.
The first thing we need to do is to obtain an instance of UARTInterface from SwiftyGPIO and use it to initialize the UBloxGPS object:
import SwiftyGPIO
import UBloxGPS
let uarts = SwiftyGPIO.UARTs(for:.RaspberryPi2)!
var uart = uarts[0]
let gps = UBloxGPS(uart)
We must then start the background thread that will update the GPS location and other information calling startUpdating. The library allows to print a quick recap of all available data with printStatus:
gps.startUpdating()
// We'll simply clear the screen and print a recap of the current gps data
while true {
system("clear")
gps.printStatus()
sleep(2)
}
The UBloxGPS object has some accessible properties that you can use to retrieve the specific data you need:
Property
Description
isDataValid
Is the current GPS data valid? True when a valid position is obtained
datetime
Date and time in stringified format
latitude
Latitude in degrees
longitude
Longitude in degrees
satellitesNum
Number of visible satellites
satellitesActiveNum
Number of active satellites (visible and with a signal strong enough to used)
altitude
Altitude from sea level
altitudeUnit
Unit for altitude
satellites
Information about the satellites that are currently in the line of sight (max 12), the structure contains: a numerical id, elevation (0..60 in degrees), azimuth (0..360 in degrees) and an snr(dB) value for an indication of the noise affecting the signal
When you don’t need to update the location data anymore or to pause updates just call stopUpdating().
Installation
Please refer to the SwiftyGPIO readme for Swift installation instructions.
Once your board runs Swift, if your version support the Swift Package Manager, you can simply add this library as a dependency of your project and compile with swift build:
And once all the files have been downloaded, create an additional file that will contain the code of your application (e.g. main.swift). When your code is ready, compile it with:
UBloxGPS.swift
A Swift library for boards with the u-Blox 6/7/8 family of A-GPS receivers with an UART serial connection.
Summary
This library interfaces with boards based on u-Blox 6/7/8 A-GPS receivers, that use the NMEA0183 protocol to provide GPS data over an UART serial connection (for a low cost option, search for some NEO6M-based board that usually cost around a measly $20). UBX configuration commands and connection via I2C are not supported at the moment.
You’ll be able to retrieve your current location, elevation, speed, status data on the currently reachable satellites and more.
The first time you’ll use the receiver it will need a few minutes to find some satellites and provide a position, but after that a few seconds will be enough to obtain a valid position.
Supported Boards
Every board supported by SwiftyGPIO with support for UART interfaces.
To use this library, you’ll need a Linux ARM board with Swift 3.x.
The example below will use a RaspberryPi 2 board but you can easily modify the example to use one the the other supported boards, a full working demo projects for the RaspberryPi2 is available in the
Examplesdirectory.Usage
If you are using a RaspberryPi, run
raspi-configand enable the serial port but disable the Linux login support inInterfacing Options > Serial.The first thing we need to do is to obtain an instance of
UARTInterfacefrom SwiftyGPIO and use it to initialize theUBloxGPSobject:We must then start the background thread that will update the GPS location and other information calling
startUpdating. The library allows to print a quick recap of all available data withprintStatus:The
UBloxGPSobject has some accessible properties that you can use to retrieve the specific data you need:When you don’t need to update the location data anymore or to pause updates just call
stopUpdating().Installation
Please refer to the SwiftyGPIO readme for Swift installation instructions.
Once your board runs Swift, if your version support the Swift Package Manager, you can simply add this library as a dependency of your project and compile with
swift build:The directory
Examplescontains sample projects that uses SPM, compile it and run the sample with./.build/debug/TestNEO6M.If SPM is not supported, you’ll need to manually download the library and its dependencies:
And once all the files have been downloaded, create an additional file that will contain the code of your application (e.g. main.swift). When your code is ready, compile it with:
The compiler will create a main executable.