MythTV  master
Public Member Functions | Protected Member Functions | Private Attributes | List of all members
ExternalChannel Class Reference

#include <ExternalChannel.h>

Inheritance diagram for ExternalChannel:
Inheritance graph
[legend]
Collaboration diagram for ExternalChannel:
Collaboration graph
[legend]

Public Member Functions

 ExternalChannel (TVRec *parent, const QString &device)
 
 ~ExternalChannel (void)
 
bool Open (void) override
 Opens the channel changing hardware for use. More...
 
void Close (void) override
 Closes the channel changing hardware to use. More...
 
bool Tune (const DTVMultiplex &) override
 This performs the actual frequency tuning and in some cases input switching. More...
 
bool Tune (const QString &channum) override
 Leave it up to the implementation to map the channnum appropriately. More...
 
bool Tune (const QString &freqid, int) override
 This tunes on the frequency Identification parameter for hardware that supports it. More...
 
bool EnterPowerSavingMode (void) override
 Enters power saving mode if the card supports it. More...
 
bool IsOpen (void) const override
 Reports whether channel is already open. More...
 
QString GetDevice (void) const override
 Returns String representing device, useful for debugging. More...
 
bool IsPIDTuningSupported (void) const override
 
QString UpdateDescription (void)
 
QString GetDescription (void)
 
virtual bool Tune (const DTVMultiplex &tuning)=0
 This performs the actual frequency tuning and in some cases input switching. More...
 
virtual bool Tune (const IPTVTuningData &, bool)
 Performs IPTV Tuning. Only implemented by IPTVChannel. More...
 
virtual bool Tune (const QString &)
 Leave it up to the implementation to map the channnum appropriately. More...
 
bool Tune (const QString &freqid, int finetune) override
 This tunes on the frequency Identification parameter for hardware that supports it. More...
 
virtual bool Tune (uint64_t frequency)
 
- Public Member Functions inherited from DTVChannel
 DTVChannel (TVRec *parent)
 
virtual ~DTVChannel ()
 
bool SetChannelByString (const QString &chan) override
 
void SetFormat (const QString &format) override
 
QString GetFormat (void)
 
virtual bool TuneMultiplex (uint mplexid, QString inputname)
 To be used by the channel scanner and possibly the EIT scanner. More...
 
virtual bool Tune (const IPTVTuningData &, bool)
 Performs IPTV Tuning. Only implemented by IPTVChannel. More...
 
virtual bool Tune (uint64_t frequency)
 
int GetProgramNumber (void) const
 Returns program number in PAT, -1 if unknown. More...
 
uint GetMajorChannel (void) const
 Returns major channel, 0 if unknown. More...
 
uint GetMinorChannel (void) const
 Returns minor channel, 0 if unknown. More...
 
uint GetOriginalNetworkID (void) const
 Returns DVB original_network_id, 0 if unknown. More...
 
uint GetTransportID (void) const
 Returns DVB transport_stream_id, 0 if unknown. More...
 
QString GetSIStandard (void) const
 Returns PSIP table standard: MPEG, DVB, ATSC, or OpenCable. More...
 
QString GetSuggestedTuningMode (bool is_live_tv) const
 Returns suggested tuning mode: "mpeg", "dvb", or "atsc". More...
 
QString GetTuningMode (void) const
 Returns tuning mode last set by SetTuningMode(). More...
 
virtual vector< DTVTunerTypeGetTunerTypes (void) const
 Returns a vector of supported tuning types. More...
 
void GetCachedPids (pid_cache_t &pid_cache) const
 Returns cached MPEG PIDs for last tuned channel. More...
 
void RegisterForMaster (const QString &key)
 
void DeregisterForMaster (const QString &key)
 
virtual bool IsMaster (void) const
 Returns true if this is the first of a number of multi-rec devs. More...
 
virtual bool IsIPTV (void) const
 
bool HasGeneratedPAT (void) const
 
bool HasGeneratedPMT (void) const
 
const ProgramAssociationTableGetGeneratedPAT (void) const
 
const ProgramMapTableGetGeneratedPMT (void) const
 
void SetTuningMode (const QString &tuning_mode)
 Sets tuning mode: "mpeg", "dvb", "atsc", etc. More...
 
void SaveCachedPids (const pid_cache_t &pid_cache) const
 Saves MPEG PIDs to cache to database. More...
 
- Public Member Functions inherited from ChannelBase
 ChannelBase (TVRec *parent)
 
virtual ~ChannelBase (void)
 
virtual bool Init (QString &startchannel, bool setchan)
 
virtual bool IsTunable (const QString &channum) const
 
virtual int SetFreqTable (const QString &)
 
virtual void SetFd (int fd)
 Sets file descriptor. More...
 
virtual int GetFd (void) const
 Returns file descriptor, -1 if it does not exist. More...
 
virtual bool IsExternalChannelChangeInUse (void)
 
virtual uint GetNextChannel (uint chanid, ChannelChangeDirection direction) const
 
virtual uint GetNextChannel (const QString &channum, ChannelChangeDirection direction) const
 
virtual QString GetChannelName (void) const
 
virtual int GetChanID (void) const
 
virtual int GetInputID (void) const
 
virtual QString GetInputName (void) const
 
virtual uint GetSourceID (void) const
 
bool IsCommercialFree (void) const
 Returns true iff commercial detection is not required. More...
 
virtual void Renumber (uint sourceid, const QString &oldChanNum, const QString &newChanNum)
 Changes a channum if we have it cached anywhere. More...
 
virtual bool InitializeInput (void)
 Fills in input map from DB. More...
 
virtual bool Retune (void)
 
virtual void StoreInputChannels (void)
 Saves current channel as the default channel for the current input. More...
 
virtual bool InitPictureAttributes (void)
 
virtual int GetPictureAttribute (PictureAttribute) const
 
virtual int ChangePictureAttribute (PictureAdjustType, PictureAttribute, bool)
 
bool CheckChannel (const QString &channum) const
 
void SetInputID (uint _inputid)
 
int GetMajorID (void)
 

Protected Member Functions

bool IsExternalChannelChangeSupported (void) override
 
- Protected Member Functions inherited from DTVChannel
void SetSIStandard (const QString &)
 Sets PSIP table standard: MPEG, DVB, ATSC, or OpenCable. More...
 
void SetDTVInfo (uint atsc_major, uint atsc_minor, uint dvb_orig_netid, uint mpeg_tsid, int mpeg_pnum)
 
void ClearDTVInfo (void)
 
virtual void CheckOptions (DTVMultiplex &) const
 Checks tuning for problems, and tries to fix them. More...
 
void HandleScriptEnd (bool ok) override
 
- Protected Member Functions inherited from ChannelBase
virtual bool IsInputAvailable (uint &mplexid_restriction, uint &chanid_restriction) const
 Switches to another input on hardware, and sets the channel is setstarting is true. More...
 
bool KillScript (void)
 
void HandleScript (const QString &freqid)
 
uint GetScriptStatus (bool holding_lock=false)
 
bool ChangeExternalChannel (const QString &changer, const QString &freqid)
 
bool ChangeInternalChannel (const QString &freqid, uint cardinputid)
 

Private Attributes

QString m_device
 
QStringList m_args
 
ExternalStreamHandlerm_stream_handler {nullptr}
 
QString m_loc
 

Additional Inherited Members

- Public Types inherited from DTVChannel
typedef DTVChannelDTVChannelP
 
- Static Public Member Functions inherited from DTVChannel
static DTVChannelGetMasterLock (const QString &key)
 
static void ReturnMasterLock (DTVChannelP &)
 
- Static Public Member Functions inherited from ChannelBase
static ChannelBaseCreateChannel (TVRec *tvrec, const GeneralDBOptions &genOpt, const DVBDBOptions &dvbOpt, const FireWireDBOptions &fwOpt, const QString &startchannel, bool enter_power_save_mode, QString &rbFileExt, bool setchan)
 
- Protected Types inherited from DTVChannel
typedef QMap< QString, QList< DTVChannel * > > MasterMap
 
- Protected Attributes inherited from DTVChannel
QMutex m_dtvinfo_lock
 
DTVTunerType m_tunerType {DTVTunerType::kTunerTypeUnknown}
 
QString m_sistandard {"mpeg"}
 PSIP table standard: MPEG, DVB, ATSC, OpenCable. More...
 
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}
 
ProgramAssociationTablem_genPAT {nullptr}
 This is a generated PAT for RAW pid tuning. More...
 
ProgramMapTablem_genPMT {nullptr}
 This is a generated PMT for RAW pid tuning. More...
 
- Protected Attributes inherited from ChannelBase
TVRecm_pParent {nullptr}
 
QString m_curchannelname
 
bool m_commfree {false}
 
uint m_inputid {0}
 
uint m_sourceid {0}
 
QString m_name
 
QString m_startChanNum
 
QString m_externalChanger
 
QString m_tuneToChannel
 
ChannelInfoList m_channels
 channels across all inputs More...
 
QMutex m_system_lock
 
MythSystemLegacym_system {nullptr}
 
uint m_system_status {0}
 These get mapped from the GENERIC_EXIT_* to these values for use with the signalmonitor code. More...
 
- Static Protected Attributes inherited from DTVChannel
static QReadWriteLock s_master_map_lock
 
static MasterMap s_master_map
 

Detailed Description

Definition at line 17 of file ExternalChannel.h.

Constructor & Destructor Documentation

◆ ExternalChannel()

ExternalChannel::ExternalChannel ( TVRec parent,
const QString &  device 
)
inline

Definition at line 20 of file ExternalChannel.h.

◆ ~ExternalChannel()

ExternalChannel::~ExternalChannel ( void  )

Definition at line 13 of file ExternalChannel.cpp.

Member Function Documentation

◆ Open()

bool ExternalChannel::Open ( void  )
overridevirtual

Opens the channel changing hardware for use.

Implements ChannelBase.

Definition at line 19 of file ExternalChannel.cpp.

◆ Close()

void ExternalChannel::Close ( void  )
overridevirtual

Closes the channel changing hardware to use.

Implements ChannelBase.

Definition at line 56 of file ExternalChannel.cpp.

Referenced by EnterPowerSavingMode(), Open(), and ~ExternalChannel().

◆ Tune() [1/8]

bool ExternalChannel::Tune ( const DTVMultiplex tuning)
inlineoverridevirtual

This performs the actual frequency tuning and in some cases input switching.

In rare cases such as ASI this does nothing since all the channels are in the same MPTS stream on the same input. But generally you will need to implement this when adding support for new hardware.

Implements DTVChannel.

Definition at line 31 of file ExternalChannel.h.

Referenced by Tune().

◆ Tune() [2/8]

bool ExternalChannel::Tune ( const QString &  )
overridevirtual

Leave it up to the implementation to map the channnum appropriately.

Used by the ExternalRecorder.

Reimplemented from DTVChannel.

Definition at line 87 of file ExternalChannel.cpp.

◆ Tune() [3/8]

bool ExternalChannel::Tune ( const QString &  freqid,
int  finetune 
)
overridevirtual

This tunes on the frequency Identification parameter for hardware that supports it.

This is only called when there is no frequency set. This is used to implement "Channel Numbers" in analog tuning scenarios and to implement "Virtual Channels" in the OCUR and Firewire tuners.

Reimplemented from DTVChannel.

Definition at line 117 of file ExternalChannel.cpp.

◆ EnterPowerSavingMode()

bool ExternalChannel::EnterPowerSavingMode ( void  )
overridevirtual

Enters power saving mode if the card supports it.

Reimplemented from DTVChannel.

Definition at line 122 of file ExternalChannel.cpp.

◆ IsOpen()

bool ExternalChannel::IsOpen ( void  ) const
inlineoverridevirtual

Reports whether channel is already open.

Implements ChannelBase.

Definition at line 39 of file ExternalChannel.h.

Referenced by Close(), Open(), Tune(), and ~ExternalChannel().

◆ GetDevice()

QString ExternalChannel::GetDevice ( void  ) const
inlineoverridevirtual

Returns String representing device, useful for debugging.

Reimplemented from ChannelBase.

Definition at line 41 of file ExternalChannel.h.

Referenced by GetDescription(), ExternalRecorder::Open(), and UpdateDescription().

◆ IsPIDTuningSupported()

bool ExternalChannel::IsPIDTuningSupported ( void  ) const
inlineoverridevirtual

Reimplemented from DTVChannel.

Definition at line 43 of file ExternalChannel.h.

◆ UpdateDescription()

QString ExternalChannel::UpdateDescription ( void  )

Definition at line 67 of file ExternalChannel.cpp.

Referenced by Tune().

◆ GetDescription()

QString ExternalChannel::GetDescription ( void  )

Definition at line 77 of file ExternalChannel.cpp.

Referenced by Open().

◆ IsExternalChannelChangeSupported()

bool ExternalChannel::IsExternalChannelChangeSupported ( void  )
inlineoverrideprotectedvirtual

Reimplemented from ChannelBase.

Definition at line 50 of file ExternalChannel.h.

◆ Tune() [4/8]

virtual bool DTVChannel::Tune

This performs the actual frequency tuning and in some cases input switching.

In rare cases such as ASI this does nothing since all the channels are in the same MPTS stream on the same input. But generally you will need to implement this when adding support for new hardware.

◆ Tune() [5/8]

virtual bool DTVChannel::Tune
inline

Performs IPTV Tuning. Only implemented by IPTVChannel.

Definition at line 59 of file dtvchannel.h.

◆ Tune() [6/8]

virtual bool DTVChannel::Tune
inline

Leave it up to the implementation to map the channnum appropriately.

Used by the ExternalRecorder.

Definition at line 64 of file dtvchannel.h.

◆ Tune() [7/8]

bool DTVChannel::Tune
inlineoverride

This tunes on the frequency Identification parameter for hardware that supports it.

This is only called when there is no frequency set. This is used to implement "Channel Numbers" in analog tuning scenarios and to implement "Virtual Channels" in the OCUR and Firewire tuners.

Definition at line 76 of file dtvchannel.h.

◆ Tune() [8/8]

virtual bool DTVChannel::Tune
inline

Definition at line 82 of file dtvchannel.h.

Member Data Documentation

◆ m_device

QString ExternalChannel::m_device
private

Definition at line 54 of file ExternalChannel.h.

Referenced by Open().

◆ m_args

QStringList ExternalChannel::m_args
private

Definition at line 55 of file ExternalChannel.h.

◆ m_stream_handler

ExternalStreamHandler* ExternalChannel::m_stream_handler {nullptr}
private

Definition at line 56 of file ExternalChannel.h.

Referenced by Close(), GetDescription(), Open(), Tune(), and UpdateDescription().

◆ m_loc

QString ExternalChannel::m_loc
private

Definition at line 57 of file ExternalChannel.h.

Referenced by GetDescription(), and UpdateDescription().


The documentation for this class was generated from the following files: