ChannelBase Class Reference

Abstract class providing a generic interface to tuning hardware. More...

#include <channelbase.h>

Inheritance diagram for ChannelBase:

Public Member Functions
	ChannelBase (TVRec *parent)
virtual	~ChannelBase (void)
virtual bool	Init (QString &inputname, QString &startchannel, bool setchan)
virtual bool	IsTunable (const QString &input, const QString &channum) const
virtual bool	Open (void)=0
	Opens the channel changing hardware for use.
virtual void	Close (void)=0
	Closes the channel changing hardware to use.
virtual bool	IsOpen (void) const =0
	Reports whether channel is already open.
virtual bool	SetChannelByString (const QString &chan)=0
virtual void	SetFormat (const QString &)
virtual int	SetFreqTable (const QString &)
virtual void	SetFd (int fd)
	Sets file descriptor.
virtual int	GetFd (void) const
	Returns file descriptor, -1 if it does not exist.
virtual bool	Tune (const QString &freqid, int finetune)
virtual bool	IsExternalChannelChangeSupported (void)
virtual uint	GetNextChannel (uint chanid, int direction) const
virtual uint	GetNextChannel (const QString &channum, int direction) const
virtual int	GetInputByName (const QString &input) const
	Returns number of named input, returns -1 if not found.
virtual QString	GetInputByNum (int capchannel) const
	Returns name of numbered input, returns null if not found.
virtual QString	GetCurrentName (void) const
virtual int	GetChanID (void) const
virtual int	GetCurrentInputNum (void) const
virtual QString	GetCurrentInput (void) const
virtual int	GetNextInputNum (void) const
virtual QString	GetNextInput (void) const
virtual QString	GetNextInputStartChan (void)
virtual uint	GetCurrentSourceID (void) const
virtual uint	GetSourceID (int inputID) const
virtual uint	GetInputCardID (int inputNum) const
virtual DBChanList	GetChannels (int inputNum) const
virtual DBChanList	GetChannels (const QString &inputname) const
virtual vector< InputInfo >	GetFreeInputs (const vector< uint > &excluded_cards) const
	Returns the recorders available inputs.
virtual QStringList	GetConnectedInputs (void) const
	Returns names of connected inputs.
bool	IsCommercialFree (void) const
	Returns true iff commercial detection is not required.
virtual QString	GetDevice (void) const
	Returns String representing device, useful for debugging.
virtual void	Renumber (uint srcid, const QString &oldChanNum, const QString &newChanNum)
	Changes a channum if we have it cached anywhere.
virtual bool	SwitchToInput (const QString &input)
virtual bool	SwitchToInput (const QString &input, const QString &chan)
virtual bool	InitializeInputs (void)
	Fills in input map from DB.
virtual bool	Retune (void)
virtual void	StoreInputChannels (void)
	Saves current channel as the default channel for the current input.
virtual bool	InitPictureAttributes (void)
virtual int	GetPictureAttribute (PictureAttribute) const
virtual int	ChangePictureAttribute (PictureAdjustType, PictureAttribute, bool up)
bool	CheckChannel (const QString &channum, QString &inputName) const
void	SetCardID (uint _cardid)
virtual int	GetCardID (void) const
	Returns card id.
Static Public Member Functions
static ChannelBase *	CreateChannel (TVRec *tv_rec, const GeneralDBOptions &genOpt, const DVBDBOptions &dvbOpt, const FireWireDBOptions &fwOpt, const QString &startchannel, bool enter_power_save_mode, QString &rbFileExt)
Protected Member Functions
virtual bool	SwitchToInput (int inputNum, bool setstarting)
	Switches to another input on hardware, and sets the channel is setstarting is true.
virtual bool	IsInputAvailable (int inputNum, uint &mplexid_restriction) const
int	GetStartInput (uint cardid)
	Gets the default input for the cardid.
void	ClearInputMap (void)
bool	KillScript (void)
void	HandleScript (const QString &freqid)
virtual void	HandleScriptEnd (bool ok)
uint	GetScriptStatus (bool holding_lock=false)
bool	ChangeExternalChannel (const QString &changer, const QString &newchan)
bool	ChangeInternalChannel (const QString &newchan, uint cardinputid)
Static Protected Member Functions
static void	StoreInputChannels (const InputMap &)
	Sets starting channel for the each input in the input map.
Protected Attributes
TVRec *	m_pParent
QString	m_curchannelname
int	m_currentInputID
bool	m_commfree
uint	m_cardid
InputMap	m_inputs
DBChanList	m_allchannels
	channels across all inputs
QMutex	m_system_lock
MythSystem *	m_system
uint	m_system_status
	These get mapped from the GENERIC_EXIT_* to these values for use with the signalmonitor code.
Friends
class	SignalMonitor

Detailed Description

Abstract class providing a generic interface to tuning hardware.

This class abstracts channel implementations for analog TV, ATSC, DVB, etc. Also implements many generic functions needed by most derived classes. It is responsible for tuning, i.e. switching channels.

Definition at line 31 of file channelbase.h.

Constructor & Destructor Documentation

ChannelBase::ChannelBase ( TVRec * parent )

Definition at line 49 of file channelbase.cpp.

ChannelBase::~ChannelBase ( void ) [virtual]

Definition at line 56 of file channelbase.cpp.

Member Function Documentation

bool ChannelBase::Init	(	QString &	inputname,
		QString &	startchannel,
		bool	setchan
	)			`[virtual]`

Reimplemented in DVBChannel, and V4LChannel.

Definition at line 65 of file channelbase.cpp.

Referenced by CreateChannel(), and TVRec::TuningGetChanNum().

bool ChannelBase::IsTunable	(	const QString &	input,
		const QString &	channum
	)			const `[virtual]`

Reimplemented in DummyChannel.

Definition at line 177 of file channelbase.cpp.

Referenced by Init().

virtual bool ChannelBase::Open ( void ) [pure virtual]

Opens the channel changing hardware for use.

Implemented in ASIChannel, CetonChannel, DummyChannel, DVBChannel, FirewireChannel, HDHRChannel, IPTVChannel, and V4LChannel.

Referenced by CreateChannel(), ChannelScanner::PreScanCommon(), DTVChannel::SetChannelByString(), TVRec::SetupSignalMonitor(), TVRec::TuningFrequency(), and TVRec::TuningNewRecorder().

virtual void ChannelBase::Close ( void ) [pure virtual]

Closes the channel changing hardware to use.

Implemented in ASIChannel, CetonChannel, DummyChannel, DVBChannel, FirewireChannel, HDHRChannel, IPTVChannel, and V4LChannel.

Referenced by TVRec::CloseChannel(), CreateChannel(), TVRec::TuningNewRecorder(), and TVRec::TuningShutdowns().

virtual bool ChannelBase::IsOpen ( void ) const [pure virtual]

Reports whether channel is already open.

Implemented in ASIChannel, CetonChannel, DummyChannel, DVBChannel, FirewireChannel, HDHRChannel, IPTVChannel, and V4LChannel.

Referenced by DTVChannel::SetChannelByString(), and TVRec::TuningOnSameMultiplex().

virtual bool ChannelBase::SetChannelByString ( const QString & chan ) [pure virtual]

Implemented in CetonChannel, DTVChannel, DummyChannel, HDHRChannel, and IPTVChannel.

Referenced by Init(), SwitchToInput(), and TVRec::TuningFrequency().

virtual void ChannelBase::SetFormat ( const QString & ) [inline, virtual]

Reimplemented in V4LChannel.

Definition at line 52 of file channelbase.h.

Referenced by DTVChannel::SetChannelByString().

virtual int ChannelBase::SetFreqTable ( const QString & ) [inline, virtual]

Reimplemented in V4LChannel.

Definition at line 53 of file channelbase.h.

Referenced by DTVChannel::SetChannelByString().

virtual void ChannelBase::SetFd ( int fd ) [inline, virtual]

Sets file descriptor.

Reimplemented in V4LChannel.

Definition at line 55 of file channelbase.h.

Referenced by TVRec::TeardownRecorder(), TVRec::TuningNewRecorder(), and TVRec::TuningRestartRecorder().

virtual int ChannelBase::GetFd ( void ) const [inline, virtual]

Returns file descriptor, -1 if it does not exist.

Reimplemented in DVBChannel, and V4LChannel.

Definition at line 57 of file channelbase.h.

Referenced by AnalogSignalMonitor::AnalogSignalMonitor(), and AnalogSignalMonitor::UpdateValues().

virtual bool ChannelBase::Tune	(	const QString &	freqid,
		int	finetune
	)			`[inline, virtual]`

Reimplemented in ASIChannel, CetonChannel, DTVChannel, FirewireChannel, HDHRChannel, and V4LChannel.

Definition at line 58 of file channelbase.h.

virtual bool ChannelBase::IsExternalChannelChangeSupported ( void ) [inline, virtual]

Reimplemented in FirewireChannel, and V4LChannel.

Definition at line 59 of file channelbase.h.

Referenced by InitializeInputs(), SignalMonitor::SignalMonitor(), and SignalMonitor::UpdateValues().

uint ChannelBase::GetNextChannel	(	uint	chanid,
		int	direction
	)			const `[virtual]`

Definition at line 240 of file channelbase.cpp.

Referenced by GetNextChannel(), TVRec::GetNextProgram(), Init(), and TVRec::TuningGetChanNum().

uint ChannelBase::GetNextChannel	(	const QString &	channum,
		int	direction
	)			const `[virtual]`

Definition at line 258 of file channelbase.cpp.

int ChannelBase::GetInputByName ( const QString & input ) const [virtual]

Returns number of named input, returns -1 if not found.

Definition at line 335 of file channelbase.cpp.

Referenced by TVRec::CreateLiveTVRingBuffer(), GetChannels(), GetFreeInputs(), GetStartInput(), Init(), TVRec::IsBusy(), IsTunable(), TVRec::SwitchLiveTVRingBuffer(), DVBChannel::SwitchToInput(), SwitchToInput(), V4LChannel::Tune(), DVBChannel::Tune(), and TVRec::TuningCheckForHWChange().

QString ChannelBase::GetInputByNum ( int capchannel ) const [virtual]

Returns name of numbered input, returns null if not found.

Definition at line 324 of file channelbase.cpp.

virtual QString ChannelBase::GetCurrentName ( void ) const [inline, virtual]

Definition at line 66 of file channelbase.h.

Referenced by TVRec::CreateLiveTVRingBuffer(), TVRec::run(), TVRec::SetSignalMonitoringRate(), TVRec::SwitchLiveTVRingBuffer(), TVRec::ToggleChannelFavorite(), TVRec::TuningNewRecorder(), TVRec::TuningOnSameMultiplex(), and TVRec::TuningRestartRecorder().

int ChannelBase::GetChanID ( void ) const [virtual]

Reimplemented in DVBChannel.

Definition at line 878 of file channelbase.cpp.

Referenced by DTVChannel::GetCachedPids(), TVRec::GetChannelInfo(), GetFreeInputs(), GetNextChannel(), TVRec::IsBusy(), IsInputAvailable(), DTVChannel::SaveCachedPids(), and DTVChannel::SetChannelByString().

virtual int ChannelBase::GetCurrentInputNum ( void ) const [inline, virtual]

Definition at line 69 of file channelbase.h.

Referenced by TVRec::CreateLiveTVRingBuffer(), NuppelVideoRecorder::DoV4L1(), GetCurrentInput(), GetCurrentSourceID(), InitializeInputs(), TVRec::IsBusy(), TVRec::SwitchLiveTVRingBuffer(), V4LChannel::Tune(), and TVRec::TuningCheckForHWChange().

virtual QString ChannelBase::GetCurrentInput ( void ) const [inline, virtual]

Reimplemented in DummyChannel.

Definition at line 71 of file channelbase.h.

Referenced by CheckChannel(), TVRec::CreateLiveTVRingBuffer(), TVRec::GetInput(), DTVChannel::GetSuggestedTuningMode(), InitializeInputs(), TVRec::NotifySchedulerOfRecording(), TVRec::SetInput(), and TVRec::SwitchLiveTVRingBuffer().

int ChannelBase::GetNextInputNum ( void ) const [virtual]

Definition at line 268 of file channelbase.cpp.

Referenced by GetNextInput(), GetNextInputStartChan(), InitializeInputs(), and V4LChannel::SetFormat().

virtual QString ChannelBase::GetNextInput ( void ) const [inline, virtual]

Definition at line 74 of file channelbase.h.

Referenced by TVRec::SetInput().

virtual QString ChannelBase::GetNextInputStartChan ( void ) [inline, virtual]

Definition at line 76 of file channelbase.h.

Referenced by TVRec::SetInput().

virtual uint ChannelBase::GetCurrentSourceID ( void ) const [inline, virtual]

Reimplemented in DummyChannel.

Definition at line 78 of file channelbase.h.

Referenced by V4LChannel::ChangePictureAttribute(), TVRec::GetChannelInfo(), V4LChannel::GetPictureAttribute(), V4LChannel::InitPictureAttribute(), Renumber(), DTVChannel::SetChannelByString(), EITScanner::StartPassiveScan(), TVRec::ToggleChannelFavorite(), TVRec::TuningNewRecorder(), and TVRec::TuningOnSameMultiplex().

virtual uint ChannelBase::GetSourceID ( int inputID ) const [inline, virtual]

Definition at line 80 of file channelbase.h.

Referenced by TVRec::GetProgramRingBufferForLiveTV().

uint ChannelBase::GetInputCardID ( int inputNum ) const [virtual]

Definition at line 602 of file channelbase.cpp.

Referenced by TVRec::TuningCheckForHWChange().

DBChanList ChannelBase::GetChannels ( int inputNum ) const [virtual]

Definition at line 610 of file channelbase.cpp.

Referenced by GetChannels(), Init(), and InitializeInputs().

DBChanList ChannelBase::GetChannels ( const QString & inputname ) const [virtual]

Definition at line 622 of file channelbase.cpp.

vector< InputInfo > ChannelBase::GetFreeInputs ( const vector< uint > & excluded_cards ) const [virtual]

Returns the recorders available inputs.

This filters out the connected inputs that belong to an input group which is busy. Recorders in the excluded cardids will not be considered busy for the sake of determining free inputs.

Definition at line 548 of file channelbase.cpp.

Referenced by TVRec::GetFreeInputs().

QStringList ChannelBase::GetConnectedInputs ( void ) const [virtual]

Returns names of connected inputs.

Definition at line 309 of file channelbase.cpp.

Referenced by GetFreeInputs(), Init(), and TVRec::IsBusy().

bool ChannelBase::IsCommercialFree ( void ) const [inline]

Returns true iff commercial detection is not required.

Definition at line 91 of file channelbase.h.

virtual QString ChannelBase::GetDevice ( void ) const [inline, virtual]

Returns String representing device, useful for debugging.

Reimplemented in ASIChannel, CetonChannel, DummyChannel, DVBChannel, FirewireChannel, HDHRChannel, and V4LChannel.

Definition at line 93 of file channelbase.h.

Referenced by GetCardID(), and ChannelScanSM::loc().

void ChannelBase::Renumber	(	uint	srcid,
		const QString &	oldChanNum,
		const QString &	newChanNum
	)			`[virtual]`

Changes a channum if we have it cached anywhere.

Definition at line 997 of file channelbase.cpp.

Referenced by TVRec::SetChannelInfo().

bool ChannelBase::SwitchToInput ( const QString & input ) [virtual]

Definition at line 346 of file channelbase.cpp.

Referenced by Init(), DTVChannel::SetChannelByString(), DVBChannel::SwitchToInput(), SwitchToInput(), and TVRec::TuningFrequency().

bool ChannelBase::SwitchToInput	(	const QString &	input,
		const QString &	chan
	)			`[virtual]`

Reimplemented in DVBChannel.

Definition at line 360 of file channelbase.cpp.

bool ChannelBase::InitializeInputs ( void ) [virtual]

Fills in input map from DB.

Reimplemented in V4LChannel.

Definition at line 908 of file channelbase.cpp.

Referenced by V4LChannel::InitializeInputs(), IPTVChannel::Open(), HDHRChannel::Open(), FirewireChannel::Open(), DVBChannel::Open(), DummyChannel::Open(), CetonChannel::Open(), and ASIChannel::Open().

virtual bool ChannelBase::Retune ( void ) [inline, virtual]

Reimplemented in DVBChannel, FirewireChannel, and V4LChannel.

Definition at line 106 of file channelbase.h.

Referenced by NuppelVideoRecorder::DoV4L2().

virtual void ChannelBase::StoreInputChannels ( void ) [inline, virtual]

Saves current channel as the default channel for the current input.

Definition at line 109 of file channelbase.h.

Referenced by TVRec::HandleTuning(), Renumber(), and StoreInputChannels().

virtual bool ChannelBase::InitPictureAttributes ( void ) [inline, virtual]

Reimplemented in V4LChannel.

Definition at line 113 of file channelbase.h.

Referenced by DTVChannel::SetChannelByString(), and TVRec::TuningNewRecorder().

virtual int ChannelBase::GetPictureAttribute ( PictureAttribute ) const [inline, virtual]

Reimplemented in V4LChannel.

Definition at line 114 of file channelbase.h.

Referenced by TVRec::GetPictureAttribute().

virtual int ChannelBase::ChangePictureAttribute	(	PictureAdjustType	,
		PictureAttribute	,
		bool	up
	)			`[inline, virtual]`

Reimplemented in V4LChannel.

Definition at line 115 of file channelbase.h.

Referenced by TVRec::ChangePictureAttribute().

bool ChannelBase::CheckChannel	(	const QString &	channum,
		QString &	inputName
	)			const

Definition at line 1053 of file channelbase.cpp.

Referenced by TVRec::CheckChannel(), TVRec::CreateLiveTVRingBuffer(), DTVChannel::SetChannelByString(), TVRec::SwitchLiveTVRingBuffer(), and TVRec::TuningCheckForHWChange().

void ChannelBase::SetCardID ( uint _cardid ) [inline]

Definition at line 121 of file channelbase.h.

Referenced by ChannelScanner::PreScanCommon().

int ChannelBase::GetCardID ( void ) const [virtual]

Returns card id.

Definition at line 863 of file channelbase.cpp.

Referenced by V4LChannel::ChangePictureAttribute(), CheckChannel(), DVBChannel::GetChanID(), ChannelScanSM::GetChannelList(), V4LChannel::GetFormatForChannel(), GetFreeInputs(), V4LChannel::GetPictureAttribute(), DTVChannel::GetSuggestedTuningMode(), InitializeInputs(), V4LChannel::InitPictureAttribute(), IsInputAvailable(), and DVBChannel::Open().

ChannelBase * ChannelBase::CreateChannel	(	TVRec *	tv_rec,
		const GeneralDBOptions &	genOpt,
		const DVBDBOptions &	dvbOpt,
		const FireWireDBOptions &	fwOpt,
		const QString &	startchannel,
		bool	enter_power_save_mode,
		QString &	rbFileExt
	)			`[static]`