dvbchannel.h

Go to the documentation of this file.

// -*- Mode: c++ -*-
/*
 *  Copyright (C) Kenneth Aafloy 2003
 *
 *  Copyright notice is in dvbchannel.cpp of the MythTV project.
 */
 
#ifndef DVBCHANNEL_H
#define DVBCHANNEL_H
 
#include <QMap>
#include <QObject>
#include <QString>
 
#include "libmythbase/mythdate.h"
#include "libmythbase/mythdbcon.h"
 
#include "diseqc.h"
#include "dtvchannel.h"
#include "dtvconfparserhelpers.h" // for DTVTunerType
#include "mpeg/streamlisteners.h"
 
class TVRec;
class DVBCam;
class DVBRecorder;
class DVBChannel;
 
using IsOpenMap = QMap<const DVBChannel*,bool>;
 
class DVBChannel : public DTVChannel
{
  public:
    explicit DVBChannel(QString device, TVRec *parent = nullptr);
    ~DVBChannel() override;
 
    bool Open(void) override // ChannelBase
        { return Open(this); }
    void Close(void) override // ChannelBase
        { Close(this); }
 
    bool Init(QString &startchannel, bool setchan) override; // ChannelBase
 
    // Sets
    void SetPMT(const ProgramMapTable *pmt);
    void SetTimeOffset(double offset);
    void SetSlowTuning(std::chrono::milliseconds how_slow)
        { m_tuningDelay = how_slow; }
 
    // Gets
    bool IsOpen(void) const override; // ChannelBase
    int  GetFd(void) const  override // ChannelBase
        { return m_fdFrontend; }
    bool IsTuningParamsProbeSupported(void) const;
 
    QString GetDevice(void) const override // ChannelBase
        { return m_device; }
    QString GetCardNum(void)            const { return m_device; };
    QString GetFrontendName(void)       const { return m_frontendName; }
    bool IsMaster(void)                 const override; // DTVChannel
    bool HasCRCBug(void)                const { return m_hasCrcBug; }
    std::chrono::milliseconds GetMinSignalMonitorDelay(void) const { return m_sigMonDelay; }
    const DiSEqCDevRotor *GetRotor(void) const;
 
    bool HasLock(bool *ok = nullptr) const;
    double GetSignalStrength(bool *ok = nullptr) const;
    double GetSNR(bool *ok = nullptr) const;
    double GetBitErrorRate(bool *ok = nullptr) const;
    double GetUncorrectedBlockCount(bool *ok = nullptr) const;
    uint64_t GetCapabilities(void) const { return m_capabilities; }
    bool CanDo(uint64_t capability) const { return (m_capabilities & capability) != 0; }
 
    // Commands
    bool SwitchToInput(int newcapchannel, bool setstarting);
    using DTVChannel::Tune;
    bool Tune(const DTVMultiplex &tuning) override; // DTVChannel
    bool Tune(const DTVMultiplex &tuning,
              bool force_reset = false, bool same_input = false);
    bool Retune(void) override; // ChannelBase
 
    bool ProbeTuningParams(DTVMultiplex &tuning) const;
 
    int  GetChanID(void) const override; // ChannelBase
 
  protected:
    void CheckOptions(DTVMultiplex &t) const override; // DTVChannel
 
  private:
    bool Open(DVBChannel *who);
    void Close(DVBChannel *who);
 
    void CheckFrequency(uint64_t frequency) const;
    bool CheckModulation(DTVModulation modulation) const;
    bool CheckCodeRate(DTVCodeRate rate) const;
 
    DVBChannel *GetMasterLock(void) const;
    static void ReturnMasterLock(DVBChannel* &dvbm);
 
    double GetSignalStrengthDVBv5(bool *ok) const;
    double GetSNRDVBv5(bool *ok) const;
    double GetBitErrorRateDVBv5(bool *ok) const;
    double GetUncorrectedBlockCountDVBv5(bool *ok) const;
 
    void DrainDVBEvents(void);
    bool WaitForBackend(std::chrono::milliseconds timeout_ms);
 
  private:
    IsOpenMap         m_isOpen;
 
    // Data
    DiSEqCDevSettings m_diseqcSettings;
    DiSEqCDevTree    *m_diseqcTree          {nullptr};
    DVBCam           *m_dvbCam              {nullptr};  // Used to decrypt encrypted streams
 
    // Device info
    QString           m_frontendName;
    uint64_t          m_capabilities        {0};
    uint64_t          m_extModulations      {0};
    uint64_t          m_frequencyMinimum    {0};
    uint64_t          m_frequencyMaximum    {0};
    uint              m_symbolRateMinimum   {0};
    uint              m_symbolRateMaximum   {0};
 
    uint              m_version             {0};      // DVB API version
    bool              m_legacyFe            {false};  // Use legacy DVBv3 API
    bool              m_hasV5Stats          {false};  // Use DVBv5 API for statistics
          DTVModulationSystem        m_currentSys;          // Currently configured modulation system
    QList<DTVModulationSystem> m_sysList;             // List of supported modulation systems
 
    // Tuning State
    mutable QMutex    m_tuneLock;
    mutable QRecursiveMutex m_hwLock;
 
    DTVMultiplex      m_desiredTuning;      // Last tuning options Tune() attempted to send to hardware
    DTVMultiplex      m_prevTuning;         // Last tuning options Tune() succesfully sent to hardware
 
    uint              m_lastLnbDevId        {(uint)~0x0};
 
    std::chrono::milliseconds m_tuningDelay { 0ms};   // Extra delay to add for broken drivers
    std::chrono::milliseconds m_sigMonDelay {25ms};   // Minimum delay between FE_LOCK checks
    bool              m_firstTune           {true};   // Used to force hardware reset
 
    // Other State
    int               m_fdFrontend          {-1};     // File descriptor for tuning hardware
    QString           m_device;                       // DVB Device
    QString           m_key;                          // master lock key
    bool              m_hasCrcBug           {false};  // true iff our driver munges PMT
 
    static std::chrono::milliseconds s_lastTuning;    // Time of last tuning
    QMutex            m_tuneDelayLock;
};
 
#endif