/*
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 = 32768000;
unsigned sampleRate = 2048000;
double frequency = 0.0;
double txgain = 0.0;
bool enableSync = false;
bool muteNoTimestamps = false;
unsigned dabMode = 0;
unsigned maxGPSHoldoverTime = 0;
/* 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 = false;
// static delay in microseconds
int staticDelayUs = 0;
};
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