/* Copyright (C) 2005, 2006, 2007, 2008, 2009, 2010 Her Majesty the Queen in Right of Canada (Communications Research Center Canada) Copyright (C) 2016 Matthias P. Braendli, matthias.braendli@mpb.li http://opendigitalradio.org DESCRIPTION: It is an output driver for the USRP family of devices, and uses the UHD library. This version is multi-threaded. A separate thread sends the data to the device. Data between the modulator and the UHD thread is exchanged by swapping buffers at a synchronisation barrier. */ /* This file is part of ODR-DabMod. ODR-DabMod 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. ODR-DabMod 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 ODR-DabMod. If not, see . */ #pragma once #ifdef HAVE_CONFIG_H # include #endif #ifdef HAVE_OUTPUT_UHD #include #include #include #include #include #include #include #include #include "Log.h" #include "ModPlugin.h" #include "EtiReader.h" #include "TimestampDecoder.h" #include "RemoteControl.h" #include "ThreadsafeQueue.h" #include #include #define MDEBUG(fmt, args...) fprintf (LOG, fmt , ## args) //#define MDEBUG(fmt, args...) // If the timestamp is further in the future than // 100 seconds, abort #define TIMESTAMP_ABORT_FUTURE 100 // Add a delay to increase buffers when // frames are too far in the future #define TIMESTAMP_MARGIN_FUTURE 0.5 // Maximum number of frames that can wait in uwd.frames #define FRAMES_MAX_SIZE 2 typedef std::complex complexf; // Each frame contains one OFDM frame, and its // associated timestamp struct UHDWorkerFrameData { // Buffer holding frame data std::vector buf; // A full timestamp contains a TIST according to standard // and time information within MNSC with tx_second. struct frame_timestamp ts; }; enum refclk_lock_loss_behaviour_t { CRASH, IGNORE }; struct UHDWorkerData { bool running; uhd::usrp::multi_usrp::sptr myUsrp; unsigned sampleRate; bool sourceContainsTimestamp; // When working with timestamps, mute the frames that // do not have a timestamp bool muteNoTimestamps; ThreadsafeQueue frames; // If we want to verify loss of refclk bool check_refclk_loss; // If we want to check for the gps_timelock sensor bool check_gpsfix; bool gpsdo_is_ettus; // Set to false in case the ODR LEA-M8F board is used // muting set by remote control bool muting; // What to do when the reference clock PLL loses lock refclk_lock_loss_behaviour_t refclk_lock_loss_behaviour; }; class UHDWorker { public: UHDWorker(struct UHDWorkerData *uhdworkerdata) { uwd = uhdworkerdata; } void start(struct UHDWorkerData *uhdworkerdata) { uwd->running = true; uhd_thread = boost::thread(&UHDWorker::process_errhandler, this); } void stop() { if (uwd) { uwd->running = false; } uhd_thread.interrupt(); uhd_thread.join(); } ~UHDWorker() { stop(); } UHDWorker(const UHDWorker& other) = delete; UHDWorker& operator=(const UHDWorker& other) = delete; private: // Asynchronous message statistics int num_underflows; int num_late_packets; uhd::tx_metadata_t md; bool last_tx_time_initialised; uint32_t last_tx_second; uint32_t last_tx_pps; // Used to print statistics once a second std::chrono::steady_clock::time_point last_print_time; void print_async_metadata(const struct UHDWorkerFrameData *frame); void handle_frame(const struct UHDWorkerFrameData *frame); void tx_frame(const struct UHDWorkerFrameData *frame, bool ts_update); struct UHDWorkerData *uwd; boost::thread uhd_thread; uhd::tx_streamer::sptr myTxStream; void process(); void process_errhandler(); }; /* This structure is used as initial configuration for OutputUHD. * It must also contain all remote-controllable settings, otherwise * they will get lost on a modulator restart. */ struct OutputUHDConfig { std::string device; std::string usrpType; // e.g. b100, b200, usrp2 // The USRP1 can accept two daughterboards std::string subDevice; // e.g. A:0 long masterClockRate; unsigned sampleRate; double frequency; double txgain; bool enableSync; bool muteNoTimestamps; unsigned dabMode; unsigned maxGPSHoldoverTime; /* allowed values : auto, int, sma, mimo */ std::string refclk_src; /* allowed values : int, sma, mimo */ std::string pps_src; /* allowed values : pos, neg */ std::string pps_polarity; /* What to do when the reference clock PLL loses lock */ refclk_lock_loss_behaviour_t refclk_lock_loss_behaviour; // muting can only be changed using the remote control bool muting; // static delay in microseconds int staticDelayUs; }; class OutputUHD: public ModOutput, public RemoteControllable { public: OutputUHD(OutputUHDConfig& config); ~OutputUHD(); int process(Buffer* dataIn); const char* name() { return "OutputUHD"; } void setETISource(EtiSource *etiSource); /*********** REMOTE CONTROL ***************/ /* Base function to set parameters. */ virtual void set_parameter(const std::string& parameter, const std::string& value); /* Getting a parameter always returns a string. */ virtual const std::string get_parameter( const std::string& parameter) const; protected: OutputUHD(const OutputUHD& other) = delete; OutputUHD& operator=(const OutputUHD& other) = delete; EtiSource *myEtiSource; OutputUHDConfig& myConf; uhd::usrp::multi_usrp::sptr myUsrp; std::shared_ptr mySyncBarrier; bool first_run; bool gps_fix_verified; struct UHDWorkerData uwd; UHDWorker worker; private: // Resize the internal delay buffer according to the dabMode and // the sample rate. void SetDelayBuffer(unsigned int dabMode); // data // The remote-controllable static delay is in the OutputUHDConfig int myTFDurationMs; // TF duration in milliseconds std::vector myDelayBuf; size_t lastLen; // GPS Fix check variables int num_checks_without_gps_fix; struct timespec first_gps_fix_check; struct timespec last_gps_fix_check; struct timespec time_last_frame; boost::packaged_task gps_fix_pt; boost::unique_future gps_fix_future; boost::thread gps_fix_task; // Wait time in seconds to get fix static const int initial_gps_fix_wait = 180; // Interval for checking the GPS at runtime static constexpr double gps_fix_check_interval = 10.0; // seconds void check_gps(); void set_usrp_time(); void initial_gps_check(); }; #endif // HAVE_OUTPUT_UHD