/*
Copyright (C) 2005, 2006, 2007, 2008, 2009, 2010 Her Majesty the
Queen in Right of Canada (Communications Research Center Canada)
Copyright (C) 2014, 2015
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
#define FAKE_UHD 0
#ifdef HAVE_CONFIG_H
# include
#endif
#ifdef HAVE_OUTPUT_UHD
#include
#include
#include
#include
#include
#include
#include
#include "Log.h"
#include "ModOutput.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;
};
struct fct_discontinuity_error : public std::exception
{
const char* what () const throw ()
{
return "FCT discontinuity detected";
}
};
enum refclk_lock_loss_behaviour_t { CRASH, IGNORE };
struct UHDWorkerData {
bool running;
#if FAKE_UHD == 0
uhd::usrp::multi_usrp::sptr myUsrp;
#endif
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:
void start(struct UHDWorkerData *uhdworkerdata) {
uwd = 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();
}
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
double last_usrp_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, Buffer* dataOut);
const char* name() { return "OutputUHD"; }
void setETIReader(EtiReader *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:
OutputUHD(const OutputUHD& other);
OutputUHD& operator=(const OutputUHD& other);
EtiReader *myEtiReader;
OutputUHDConfig& myConf;
uhd::usrp::multi_usrp::sptr myUsrp;
std::shared_ptr mySyncBarrier;
UHDWorker worker;
bool first_run;
bool gps_fix_verified;
struct UHDWorkerData uwd;
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;
// What transmission mode we're using defines by how
// much the FCT should increment for each
// transmission frame.
int fct_increment;
int last_fct;
// 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
#endif // OUTPUT_UHD_H