dtvchannel.h

Go to the documentation of this file.

/* -*- Mode: c++ -*-
 *  DTVChannel
 *  Copyright (c) 2005,2006 by Daniel Kristjansson
 *  Contains base class for digital channels.
 */
 
#ifndef DTVCHANNEL_H
#define DTVCHANNEL_H
 
// C++ headers
#include <cstdint>
#include <vector>
 
// Qt headers
#include <QReadWriteLock>
#include <QString>
#include <QMutex>
#include <QList>                        // for QList
#include <QMap>                         // for QMap
 
// MythTV headers
#include "dtvconfparserhelpers.h" // for DTVTunerType
#include "channelbase.h"
#include "channelutil.h" // for pid_cache_t, IPTVTuningData
 
class ProgramAssociationTable;
class ProgramMapTable;
class TVRec;
 
class DTVChannel : public ChannelBase
{
  public:
    explicit DTVChannel(TVRec *parent) : ChannelBase(parent) {}
    ~DTVChannel() override;
 
    // Commands
    bool SetChannelByString(const QString &chan) override; // ChannelBase
 
    /* Allow 'MPTS' format to be set, so we know when to process the
       full, unfiltered MPTS from the transport stream. */
    void SetFormat(const QString & format) override // ChannelBase
        { m_tvFormat = format; }
    QString GetFormat(void) { return m_tvFormat; }
 
    virtual bool TuneMultiplex(uint mplexid, const QString& inputname);
    virtual bool Tune(const DTVMultiplex &tuning) = 0;
    virtual bool Tune(const IPTVTuningData &/*tuning*/, bool /*scanning*/) { return false; }
    virtual bool Tune(const QString &/*channum*/) { return true; }
    virtual bool EnterPowerSavingMode(void)
    {
        return true;
    }
    bool Tune([[maybe_unused]] const QString &freqid,
              [[maybe_unused]] int finetune) override // ChannelBase
    {
        return false;
    }
 
    virtual bool Tune([[maybe_unused]] uint64_t frequency)
    {
        return false;
    }
 
    // Gets
 
    int GetProgramNumber(void) const
        { return m_currentProgramNum; };
 
    uint GetMajorChannel(void) const
        { return m_currentATSCMajorChannel; };
 
    uint GetMinorChannel(void) const
        { return m_currentATSCMinorChannel; };
 
    uint GetOriginalNetworkID(void) const
        { return m_currentOriginalNetworkID; };
 
    uint GetTransportID(void) const
        { return m_currentTransportID; };
 
    QString GetSIStandard(void) const;
 
    QString GetSuggestedTuningMode(bool is_live_tv) const;
 
    QString GetTuningMode(void) const;
 
    virtual std::vector<DTVTunerType> GetTunerTypes(void) const;
 
    void GetCachedPids(pid_cache_t &pid_cache) const;
 
    void RegisterForMaster(const QString &key);
    void DeregisterForMaster(const QString &key);
    static DTVChannel *GetMasterLock(const QString &key);
    using DTVChannelP = DTVChannel*;
    static void ReturnMasterLock(DTVChannelP &chan);
 
    virtual bool IsMaster(void) const { return false; }
 
    virtual bool IsPIDTuningSupported(void) const { return false; }
 
    virtual bool IsIPTV(void) const { return false; }
 
    bool HasGeneratedPAT(void) const { return m_genPAT != nullptr; }
    bool HasGeneratedPMT(void) const { return m_genPMT != nullptr; }
    const ProgramAssociationTable *GetGeneratedPAT(void) const {return m_genPAT;}
    const ProgramMapTable         *GetGeneratedPMT(void) const {return m_genPMT;}
 
    // Sets
 
    void SetTuningMode(const QString &tuning_mode);
 
    void SaveCachedPids(const pid_cache_t &pid_cache) const;
 
  protected:
    void SetSIStandard(const QString &si_std);
    void SetDTVInfo(uint atsc_major, uint atsc_minor,
                    uint dvb_orig_netid,
                    uint mpeg_tsid, int mpeg_pnum);
    void ClearDTVInfo(void) { SetDTVInfo(0, 0, 0, 0, -1); }
    virtual void CheckOptions(DTVMultiplex &/*tuning*/) const {}
    void HandleScriptEnd(bool ok) override; // ChannelBase
 
  protected:
    mutable QMutex m_dtvinfoLock;
 
    DTVTunerType   m_tunerType {DTVTunerType::kTunerTypeUnknown};
    QString        m_sistandard               {"mpeg"};
    QString        m_tuningMode;
    QString        m_tvFormat;
    int            m_currentProgramNum        {-1};
    uint           m_currentATSCMajorChannel  {0};
    uint           m_currentATSCMinorChannel  {0};
    uint           m_currentTransportID       {0};
    uint           m_currentOriginalNetworkID {0};
 
    ProgramAssociationTable *m_genPAT {nullptr};
    ProgramMapTable         *m_genPMT {nullptr};
 
    using MasterMap = QMap<QString,QList<DTVChannel*> >;
    static QReadWriteLock    s_master_map_lock;
    static MasterMap         s_master_map;
};
 
#endif // DTVCHANNEL_H