/* Copyright (C) 2005, 2006, 2007, 2008, 2009, 2010 Her Majesty the Queen in Right of Canada (Communications Research Center Canada) Copyright (C) 2014 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 . */ #ifndef OUTPUT_UHD_H #define OUTPUT_UHD_H #ifdef HAVE_CONFIG_H # include #endif #include #include #include #include #include #include #include #include #include #include "Log.h" #include "ModOutput.h" #include "EtiReader.h" #include "TimestampDecoder.h" #include "RemoteControl.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 typedef std::complex complexf; struct UHDWorkerFrameData { // Buffer holding frame data void* buf; // Full timestamp struct frame_timestamp ts; // Frame counter uint32_t fct; }; enum refclk_lock_loss_behaviour_t { CRASH, IGNORE }; struct UHDWorkerData { uhd::usrp::multi_usrp::sptr myUsrp; unsigned sampleRate; // Double buffering between the two threads // Each buffer contains one OFDM frame, and it's // associated timestamp // A full timestamp contains a TIST according to standard // and time information within MNSC with tx_second. bool sourceContainsTimestamp; // When working with timestamps, mute the frames that // do not have a timestamp bool muteNoTimestamps; struct UHDWorkerFrameData frame0; struct UHDWorkerFrameData frame1; size_t bufsize; // in bytes // If we want to verify loss of refclk bool check_refclk_loss; // muting set by remote control bool muting; // A barrier to synchronise the two threads boost::shared_ptr sync_barrier; // What to do when the reference clock PLL loses lock refclk_lock_loss_behaviour_t refclk_lock_loss_behaviour; // The common logger Logger* logger; }; class UHDWorker { public: UHDWorker () { running = false; } void start(struct UHDWorkerData *uhdworkerdata) { running = true; uwd = uhdworkerdata; uhd_thread = boost::thread(&UHDWorker::process, this); } void stop() { running = false; uhd_thread.interrupt(); uhd_thread.join(); } void process(); private: struct UHDWorkerData *uwd; bool running; boost::thread uhd_thread; uhd::tx_streamer::sptr myTxStream; }; /* This structure is used as initial configuration for OutputUHD */ 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; int txgain; bool enableSync; bool muteNoTimestamps; /* 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; }; class OutputUHD: public ModOutput, public RemoteControllable { public: OutputUHD( OutputUHDConfig& config, Logger& logger, zmq::context_t *pContext, const std::string &zmqCtrlEndpoint); ~OutputUHD(); int process(Buffer* dataIn, Buffer* dataOut); const char* name() { return "OutputUHD"; } void setETIReader(EtiReader *etiReader) { myEtiReader = etiReader; } /*********** REMOTE CONTROL ***************/ /* virtual void enrol_at(BaseRemoteController& controller) * is inherited */ /* 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: Logger& myLogger; EtiReader *myEtiReader; OutputUHDConfig myConf; uhd::usrp::multi_usrp::sptr myUsrp; boost::shared_ptr mySyncBarrier; UHDWorker worker; bool first_run; struct UHDWorkerData uwd; int activebuffer; // muting can only be changed using the remote control bool myMuting; private: // zmq receiving method //TODO: Should be implemented as an alternative to RemoteControllerTelnet and //moved to the RemoteControl.h/cpp file instead. void ZmqCtrl(void); void RecvAll(zmq::socket_t* pSocket, std::vector &message); void SendOkReply(zmq::socket_t *pSocket); void SendFailReply(zmq::socket_t *pSocket, const std::string &error); // data int myStaticDelay; std::vector m_delayBuf; zmq::context_t *m_pContext; std::string m_zmqCtrlEndpoint; boost::thread *m_pZmqRepThread; size_t lastLen; }; #endif // OUTPUT_UHD_H