//
// Copyright 2010-2011,2014-2015 Ettus Research LLC
//
// This program is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with this program. If not, see .
//
#include
#include
#include
#include
#include
#include
#include
#include
#include
#include
#include
#include
#include
#include
#include "boost/tuple/tuple.hpp"
#include "boost/foreach.hpp"
using namespace uhd;
using namespace boost::gregorian;
using namespace boost::posix_time;
using namespace boost::algorithm;
using namespace boost::this_thread;
/*!
* A control for GPSDO devices
*/
gps_ctrl::~gps_ctrl(void){
/* NOP */
}
class gps_ctrl_impl : public gps_ctrl{
private:
std::map > sentences;
boost::mutex cache_mutex;
boost::system_time _last_cache_update;
std::string get_sentence(const std::string which, const int max_age_ms, const int timeout, const bool wait_for_next = false)
{
std::string sentence;
boost::system_time now = boost::get_system_time();
boost::system_time exit_time = now + milliseconds(timeout);
boost::posix_time::time_duration age;
if (wait_for_next)
{
boost::lock_guard lock(cache_mutex);
update_cache();
//mark sentence as touched
if (sentences.find(which) != sentences.end())
sentences[which].get<2>() = true;
}
while (1)
{
try
{
boost::lock_guard lock(cache_mutex);
// update cache if older than a millisecond
if (now - _last_cache_update > milliseconds(1))
{
update_cache();
}
if (sentences.find(which) == sentences.end())
{
age = milliseconds(max_age_ms);
} else {
age = boost::get_system_time() - sentences[which].get<1>();
}
if (age < milliseconds(max_age_ms) and (not (wait_for_next and sentences[which].get<2>())))
{
sentence = sentences[which].get<0>();
sentences[which].get<2>() = true;
}
} catch(std::exception &e) {
UHD_MSG(warning) << "get_sentence: " << e.what();
}
if (not sentence.empty() or now > exit_time)
{
break;
}
sleep(boost::posix_time::milliseconds(1));
now = boost::get_system_time();
}
if (sentence.empty())
{
throw uhd::value_error("gps ctrl: No " + which + " message found");
}
return sentence;
}
static bool is_nmea_checksum_ok(std::string nmea)
{
if (nmea.length() < 5 || nmea[0] != '$' || nmea[nmea.length()-3] != '*')
return false;
std::stringstream ss;
boost::uint32_t string_crc;
boost::uint32_t calculated_crc = 0;
// get crc from string
ss << std::hex << nmea.substr(nmea.length()-2, 2);
ss >> string_crc;
// calculate crc
for (size_t i = 1; i < nmea.length()-3; i++)
calculated_crc ^= nmea[i];
// return comparison
return (string_crc == calculated_crc);
}
void update_cache() {
if(not gps_detected() or (_gps_type != GPS_TYPE_INTERNAL_GPSDO)) {
UHD_MSG(error) << "get_stat(): unsupported GPS or no GPS detected";
return;
}
const std::list keys = boost::assign::list_of("GPGGA")("GPRMC")("SERVO");
static const boost::regex servo_regex("^\\d\\d-\\d\\d-\\d\\d.*$");
static const boost::regex gp_msg_regex("^\\$GP.*,\\*[0-9A-F]{2}$");
std::map msgs;
// Get all GPSDO messages available
// Creating a map here because we only want the latest of each message type
for (std::string msg = _recv(0); not msg.empty(); msg = _recv(0))
{
// Strip any end of line characters
erase_all(msg, "\r");
erase_all(msg, "\n");
if (msg.empty())
{
// Ignore empty strings
continue;
}
if (msg.length() < 6)
{
UHD_LOGV(regularly) << __FUNCTION__ << ": Short GPSDO string: " << msg << std::endl;
continue;
}
// Look for SERVO message
if (boost::regex_search(msg, servo_regex, boost::regex_constants::match_continuous))
{
msgs["SERVO"] = msg;
}
else if (boost::regex_match(msg, gp_msg_regex) and is_nmea_checksum_ok(msg))
{
msgs[msg.substr(1,5)] = msg;
}
else
{
UHD_LOGV(regularly) << __FUNCTION__ << ": Malformed GPSDO string: " << msg << std::endl;
}
}
boost::system_time time = boost::get_system_time();
// Update sentences with newly read data
BOOST_FOREACH(std::string key, keys)
{
if (not msgs[key].empty())
{
sentences[key] = boost::make_tuple(msgs[key], time, false);
}
}
_last_cache_update = time;
}
public:
gps_ctrl_impl(uart_iface::sptr uart) :
_uart(uart),
_gps_type(GPS_TYPE_NONE)
{
std::string reply;
bool i_heard_some_nmea = false, i_heard_something_weird = false;
//first we look for an internal GPSDO
_flush(); //get whatever junk is in the rx buffer right now, and throw it away
_send("*IDN?\r\n"); //request identity from the GPSDO
//then we loop until we either timeout, or until we get a response that indicates we're a JL device
const boost::system_time comm_timeout = boost::get_system_time() + milliseconds(GPS_COMM_TIMEOUT_MS);
while(boost::get_system_time() < comm_timeout) {
reply = _recv();
//known devices are JL "FireFly" and "LC_XO"
if(reply.find("FireFly") != std::string::npos or reply.find("LC_XO") != std::string::npos) {
_gps_type = GPS_TYPE_INTERNAL_GPSDO;
break;
} else if(reply.substr(0, 3) == "$GP") {
i_heard_some_nmea = true; //but keep looking
} else if(not reply.empty()) {
i_heard_something_weird = true; //probably wrong baud rate
}
}
if((i_heard_some_nmea) && (_gps_type != GPS_TYPE_INTERNAL_GPSDO)) _gps_type = GPS_TYPE_GENERIC_NMEA;
if((_gps_type == GPS_TYPE_NONE) && i_heard_something_weird) {
UHD_MSG(error) << "GPS invalid reply \"" << reply << "\", assuming none available" << std::endl;
}
switch(_gps_type) {
case GPS_TYPE_INTERNAL_GPSDO:
erase_all(reply, "\r");
erase_all(reply, "\n");
UHD_MSG(status) << "Found an internal GPSDO: " << reply << std::endl;
init_gpsdo();
break;
case GPS_TYPE_GENERIC_NMEA:
UHD_MSG(status) << "Found a generic NMEA GPS device" << std::endl;
break;
case GPS_TYPE_NONE:
default:
UHD_MSG(status) << "No GPSDO found" << std::endl;
break;
}
// initialize cache
update_cache();
}
~gps_ctrl_impl(void){
/* NOP */
}
//return a list of supported sensors
std::vector get_sensors(void) {
std::vector ret = boost::assign::list_of
("gps_gpgga")
("gps_gprmc")
("gps_time")
("gps_locked")
("gps_servo");
return ret;
}
uhd::sensor_value_t get_sensor(std::string key) {
if(key == "gps_gpgga"
or key == "gps_gprmc") {
return sensor_value_t(
boost::to_upper_copy(key),
get_sentence(boost::to_upper_copy(key.substr(4,8)), GPS_NMEA_NORMAL_FRESHNESS, GPS_TIMEOUT_DELAY_MS),
"");
}
else if(key == "gps_time") {
return sensor_value_t("GPS epoch time", int(get_epoch_time()), "seconds");
}
else if(key == "gps_locked") {
return sensor_value_t("GPS lock status", locked(), "locked", "unlocked");
}
else if(key == "gps_servo") {
return sensor_value_t(
boost::to_upper_copy(key),
get_sentence(boost::to_upper_copy(key.substr(4,8)), GPS_SERVO_FRESHNESS, GPS_TIMEOUT_DELAY_MS),
"");
}
else {
throw uhd::value_error("gps ctrl get_sensor unknown key: " + key);
}
}
private:
void init_gpsdo(void) {
//issue some setup stuff so it spits out the appropriate data
//none of these should issue replies so we don't bother looking for them
//we have to sleep between commands because the JL device, despite not acking, takes considerable time to process each command.
sleep(milliseconds(GPSDO_COMMAND_DELAY_MS));
_send("SYST:COMM:SER:ECHO OFF\r\n");
sleep(milliseconds(GPSDO_COMMAND_DELAY_MS));
_send("SYST:COMM:SER:PRO OFF\r\n");
sleep(milliseconds(GPSDO_COMMAND_DELAY_MS));
_send("GPS:GPGGA 1\r\n");
sleep(milliseconds(GPSDO_COMMAND_DELAY_MS));
_send("GPS:GGAST 0\r\n");
sleep(milliseconds(GPSDO_COMMAND_DELAY_MS));
_send("GPS:GPRMC 1\r\n");
sleep(milliseconds(GPSDO_COMMAND_DELAY_MS));
_send("SERV:TRAC 1\r\n");
sleep(milliseconds(GPSDO_COMMAND_DELAY_MS));
}
//helper function to retrieve a field from an NMEA sentence
std::string get_token(std::string sentence, size_t offset) {
boost::tokenizer > tok(sentence);
std::vector toked;
tok.assign(sentence); //this can throw
toked.assign(tok.begin(), tok.end());
if(toked.size() <= offset) {
throw uhd::value_error(str(boost::format("Invalid response \"%s\"") % sentence));
}
return toked[offset];
}
ptime get_time(void) {
int error_cnt = 0;
ptime gps_time;
while(error_cnt < 2) {
try {
// wait for next GPRMC string
std::string reply = get_sentence("GPRMC", GPS_NMEA_NORMAL_FRESHNESS, GPS_COMM_TIMEOUT_MS, true);
std::string datestr = get_token(reply, 9);
std::string timestr = get_token(reply, 1);
if(datestr.size() == 0 or timestr.size() == 0) {
throw uhd::value_error(str(boost::format("Invalid response \"%s\"") % reply));
}
//just trust me on this one
gps_time = ptime( date(
greg_year(boost::lexical_cast(datestr.substr(4, 2)) + 2000),
greg_month(boost::lexical_cast(datestr.substr(2, 2))),
greg_day(boost::lexical_cast(datestr.substr(0, 2)))
),
hours( boost::lexical_cast(timestr.substr(0, 2)))
+ minutes(boost::lexical_cast(timestr.substr(2, 2)))
+ seconds(boost::lexical_cast(timestr.substr(4, 2)))
);
return gps_time;
} catch(std::exception &e) {
UHD_MSG(warning) << "get_time: " << e.what();
error_cnt++;
}
}
throw uhd::value_error("Timeout after no valid message found");
return gps_time; //keep gcc from complaining
}
time_t get_epoch_time(void) {
return (get_time() - from_time_t(0)).total_seconds();
}
bool gps_detected(void) {
return (_gps_type != GPS_TYPE_NONE);
}
bool locked(void) {
int error_cnt = 0;
while(error_cnt < 3) {
try {
std::string reply = get_sentence("GPGGA", GPS_LOCK_FRESHNESS, GPS_COMM_TIMEOUT_MS);
if(reply.empty())
error_cnt++;
else
return (get_token(reply, 6) != "0");
} catch(std::exception &e) {
UHD_MSG(warning) << "locked: " << e.what();
error_cnt++;
}
}
throw uhd::value_error("locked(): unable to determine GPS lock status");
}
uart_iface::sptr _uart;
void _flush(void){
while (not _uart->read_uart(0.0).empty()){
//NOP
}
}
std::string _recv(double timeout = GPS_TIMEOUT_DELAY_MS/1000.){
return _uart->read_uart(timeout);
}
void _send(const std::string &buf){
return _uart->write_uart(buf);
}
enum {
GPS_TYPE_INTERNAL_GPSDO,
GPS_TYPE_GENERIC_NMEA,
GPS_TYPE_NONE
} _gps_type;
static const int GPS_COMM_TIMEOUT_MS = 1300;
static const int GPS_NMEA_NORMAL_FRESHNESS = 1000;
static const int GPS_SERVO_FRESHNESS = 1000;
static const int GPS_LOCK_FRESHNESS = 2500;
static const int GPS_TIMEOUT_DELAY_MS = 200;
static const int GPSDO_COMMAND_DELAY_MS = 200;
};
/***********************************************************************
* Public make function for the GPS control
**********************************************************************/
gps_ctrl::sptr gps_ctrl::make(uart_iface::sptr uart){
return sptr(new gps_ctrl_impl(uart));
}