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 <QObject>
#include <QString>
#include <QMap>

#include "mythcontext.h"
#include "mythdbcon.h"
#include "dtvchannel.h"
#include "dtvconfparserhelpers.h" // for DTVTunerType
#include "streamlisteners.h"
#include "diseqc.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(uint how_slow_in_ms)
        { m_tuningDelay = how_slow_in_ms; }

    // 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; }
    uint 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;

    // 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;

  private:
    bool Open(DVBChannel *who);
    void Close(DVBChannel *who);

    int  GetChanID(void) const override; // ChannelBase

    void CheckOptions(DTVMultiplex &t) const override; // DTVChannel
    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;

  private:
    IsOpenMap         m_isOpen;

    // Data
    DiSEqCDevSettings m_diseqcSettings;
    DiSEqCDevTree    *m_diseqcTree          {nullptr};
    DVBCam           *m_dvbCam              {nullptr};

    // 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};

    // Tuning State
    mutable QMutex    m_tuneLock;
    mutable QMutex    m_hwLock              {QMutex::Recursive};
    DTVMultiplex      m_desiredTuning;
    DTVMultiplex      m_prevTuning;

    uint              m_lastLnbDevId        {(uint)~0x0};

    uint              m_tuningDelay         {0};
    uint              m_sigMonDelay         {25};
    bool              m_firstTune           {true};

    // Other State
    int               m_fdFrontend          {-1};
    QString           m_device;      
    bool              m_hasCrcBug           {false};

    static QDateTime  s_lastTuning;
    QMutex            m_tuneDelayLock;
};

#endif