// // 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)); }