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

#include <ExternalSignalMonitor.h>

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

Public Member Functions

 ExternalSignalMonitor (int db_cardnum, ExternalChannel *_channel, bool _release_stream, uint64_t _flags=0)
 Initializes signal lock and signal values. More...
 
virtual ~ExternalSignalMonitor ()
 Stops signal monitoring and table monitoring threads. More...
 
void Stop (void) override
 Stop signal monitoring and table monitoring threads. More...
 
- Public Member Functions inherited from DTVSignalMonitor
 DTVSignalMonitor (int db_cardnum, DTVChannel *_channel, bool _release_stream, uint64_t wait_for_mask)
 
virtual ~DTVSignalMonitor ()
 
QStringList GetStatusList (void) const override
 Returns QStringList containing all signals and their current values. More...
 
void SetChannel (int major, int minor)
 
int GetMajorChannel () const
 
int GetMinorChannel () const
 
void SetProgramNumber (int progNum)
 
int GetProgramNumber () const
 
void SetDVBService (uint network_id, uint transport_id, int service_id)
 
uint GetTransportID (void) const
 
uint GetNetworkID (void) const
 
int GetServiceID (void) const
 
uint GetDetectedNetworkID (void) const
 
uint GetDetectedTransportID (void) const
 
virtual void SetRotorTarget (float)
 Sets rotor target pos from 0.0 to 1.0. More...
 
virtual void GetRotorStatus (bool &was_moving, bool &is_moving)
 
virtual void SetRotorValue (int)
 
void AddFlags (uint64_t _flags) override
 
void RemoveFlags (uint64_t _flags) override
 
virtual void SetStreamData (MPEGStreamData *data)
 Sets the MPEG stream data for DTVSignalMonitor to use, and connects the table signals to the monitor. More...
 
MPEGStreamDataGetStreamData ()
 Returns the MPEG stream data if it exists. More...
 
ATSCStreamDataGetATSCStreamData ()
 Returns the ATSC stream data if it exists. More...
 
DVBStreamDataGetDVBStreamData ()
 Returns the DVB stream data if it exists. More...
 
ScanStreamDataGetScanStreamData ()
 Returns the scan stream data if it exists. More...
 
const MPEGStreamDataGetStreamData () const
 Returns the MPEG stream data if it exists. More...
 
const ATSCStreamDataGetATSCStreamData () const
 Returns the ATSC stream data if it exists. More...
 
const DVBStreamDataGetDVBStreamData () const
 Returns the DVB stream data if it exists. More...
 
const ScanStreamDataGetScanStreamData () const
 Returns the scan stream data if it exists. More...
 
bool IsAllGood (void) const override
 
void HandlePAT (const ProgramAssociationTable *) override
 
void HandleCAT (const ConditionalAccessTable *) override
 
void HandlePMT (uint, const ProgramMapTable *) override
 
void HandleEncryptionStatus (uint, bool enc_status) override
 
void HandleSTT (const SystemTimeTable *) override
 
void HandleVCT (uint, const VirtualChannelTable *) override
 
void HandleMGT (const MasterGuideTable *) override
 
void HandleTVCT (uint, const TerrestrialVirtualChannelTable *) override
 
void HandleCVCT (uint, const CableVirtualChannelTable *) override
 
void HandleRRT (const RatingRegionTable *) override
 
void HandleDCCT (const DirectedChannelChangeTable *) override
 
void HandleDCCSCT (const DirectedChannelChangeSelectionCodeTable *) override
 
void HandleTDT (const TimeDateTable *) override
 
void HandleNIT (const NetworkInformationTable *) override
 
void HandleSDT (uint, const ServiceDescriptionTable *) override
 
void IgnoreEncrypted (bool ignore)
 
- Public Member Functions inherited from SignalMonitor
virtual ~SignalMonitor ()
 Stops monitoring thread. More...
 
virtual void Start ()
 Start signal monitoring thread. More...
 
bool HasFlags (uint64_t _flags) const
 
bool HasAnyFlag (uint64_t _flags) const
 
uint64_t GetFlags (void) const
 
virtual bool HasExtraSlowTuning (void) const
 
bool GetNotifyFrontend () const
 Returns whether or not a SIGNAL MythEvent is being sent regularly to the frontend. More...
 
int GetUpdateRate () const
 Returns milliseconds between signal monitoring events. More...
 
bool HasSignalLock (void) const
 Returns true iff scriptStatus.IsGood() and signalLock.IsGood() return true. More...
 
bool IsErrored (void) const
 
void SetNotifyFrontend (bool notify)
 Enables or disables frontend notification of the current signal value. More...
 
void SetMonitoring (TVRec *parent, bool EITscan, bool monitor)
 Indicate if table monitoring is needed. More...
 
void SetUpdateRate (int msec)
 Sets the number of milliseconds between signal monitoring attempts in the signal monitoring thread. More...
 
void AddListener (SignalMonitorListener *listener)
 
void RemoveListener (SignalMonitorListener *listener)
 
void SendMessage (SignalMonitorMessageType type, const SignalMonitorValue &val)
 
void SendMessageAllGood (void)
 
virtual void EmitStatus (void)
 
- Public Member Functions inherited from MPEGStreamListener
virtual void HandleSplice (const SpliceInformationTable *)
 

Protected Member Functions

 ExternalSignalMonitor (void)
 
 ExternalSignalMonitor (const ExternalSignalMonitor &)
 
void UpdateValues (void) override
 Fills in frontend stats and emits status Qt signals. More...
 
ExternalChannelGetExternalChannel (void)
 
bool HasLock (void)
 
int GetSignalStrengthPercent (void)
 
int GetLockTimeout (void)
 
- Protected Member Functions inherited from DTVSignalMonitor
DTVChannelGetDTVChannel (void)
 
void UpdateMonitorValues (void)
 
void UpdateListeningForEIT (void)
 
- Protected Member Functions inherited from SignalMonitor
 SignalMonitor (int _inputid, ChannelBase *_channel, bool _release_stream, uint64_t wait_for_mask)
 Initializes signal lock and signal values. More...
 
 SignalMonitor (int, ChannelBase *, uint64_t, bool)=delete
 
void run (void) override
 Basic signal monitoring loop. More...
 
- Protected Member Functions inherited from MThread
int exec (void)
 Enters the qt event loop. call exit or quit to exit thread. More...
 
 MThread (const QString &objectName)
 Standard constructor. More...
 
 MThread (const QString &objectName, QRunnable *runnable)
 Use this constructor if you want the default run() method to run the QRunnable's run() method instead of entering the Qt event loop. More...
 
virtual ~MThread ()
 
void RunProlog (void)
 Sets up a thread, call this if you reimplement run(). More...
 
void RunEpilog (void)
 Cleans up a thread's resources, call this if you reimplement run(). More...
 
QThread * qthread (void)
 Returns the thread, this will always return the same pointer no matter how often you restart the thread. More...
 
void setObjectName (const QString &name)
 
QString objectName (void) const
 
void setPriority (QThread::Priority priority)
 
QThread::Priority priority (void) const
 
bool isFinished (void) const
 
bool isRunning (void) const
 
void setStackSize (uint stackSize)
 
uint stackSize (void) const
 
void exit (int retcode=0)
 Use this to exit from the thread if you are using a Qt event loop. More...
 
void start (QThread::Priority=QThread::InheritPriority)
 Tell MThread to start running the thread in the near future. More...
 
void terminate (void)
 Kill a thread unsafely. More...
 
void quit (void)
 calls exit(0) More...
 
bool wait (unsigned long time=ULONG_MAX)
 Wait for the MThread to exit, with a maximum timeout. More...
 
- Protected Member Functions inherited from MPEGStreamListener
virtual ~MPEGStreamListener ()=default
 
- Protected Member Functions inherited from ATSCMainStreamListener
virtual ~ATSCMainStreamListener ()=default
 
- Protected Member Functions inherited from ATSCAuxStreamListener
virtual ~ATSCAuxStreamListener ()=default
 
- Protected Member Functions inherited from DVBMainStreamListener
virtual ~DVBMainStreamListener ()=default
 

Protected Attributes

ExternalStreamHandlerm_stream_handler {nullptr}
 
bool m_stream_handler_started {false}
 
int m_lock_timeout {0}
 
- Protected Attributes inherited from DTVSignalMonitor
MPEGStreamDatam_stream_data {nullptr}
 
vector< uintm_eit_pids
 
SignalMonitorValue m_seenPAT
 
SignalMonitorValue m_seenPMT
 
SignalMonitorValue m_seenMGT
 
SignalMonitorValue m_seenVCT
 
SignalMonitorValue m_seenNIT
 
SignalMonitorValue m_seenSDT
 
SignalMonitorValue m_seenCrypt
 
SignalMonitorValue m_matchingPAT
 
SignalMonitorValue m_matchingPMT
 
SignalMonitorValue m_matchingMGT
 
SignalMonitorValue m_matchingVCT
 
SignalMonitorValue m_matchingNIT
 
SignalMonitorValue m_matchingSDT
 
SignalMonitorValue m_matchingCrypt
 
int m_majorChannel {-1}
 
int m_minorChannel {-1}
 
uint m_networkID {0}
 
uint m_transportID {0}
 
uint m_detectedNetworkID {0}
 
uint m_detectedTransportID {0}
 
int m_programNumber {-1}
 
QList< uint64_t > m_seen_table_crc
 
bool m_ignore_encrypted {false}
 
- Protected Attributes inherited from SignalMonitor
ChannelBasem_channel {nullptr}
 
TVRecm_pParent {nullptr}
 
int m_inputid
 
volatile uint64_t m_flags
 
bool m_release_stream
 
int m_update_rate {25}
 
uint m_minimum_update_rate {5}
 
bool m_update_done {false}
 
bool m_notify_frontend {true}
 
bool m_tablemon {false}
 
bool m_eit_scan {false}
 
QString m_error
 
SignalMonitorValue m_signalLock
 
SignalMonitorValue m_signalStrength
 
SignalMonitorValue m_scriptStatus
 
vector< SignalMonitorListener * > m_listeners
 
QMutex m_startStopLock
 
QWaitCondition m_startStopWait
 
volatile bool m_running {false}
 
volatile bool m_exit {false}
 
QMutex m_statusLock {QMutex::Recursive}
 
QMutex m_listenerLock
 
- Protected Attributes inherited from MThread
MThreadInternalm_thread {nullptr}
 
QRunnable * m_runnable {nullptr}
 
bool m_prolog_executed {true}
 
bool m_epilog_executed {true}
 

Additional Inherited Members

- Static Public Member Functions inherited from SignalMonitor
static bool IsRequired (const QString &cardtype)
 Returns true iff the card type supports signal monitoring. More...
 
static bool IsSupported (const QString &cardtype)
 
static SignalMonitorInit (const QString &cardtype, int db_cardnum, ChannelBase *channel, bool release_stream)
 
- Static Public Attributes inherited from SignalMonitor
static const uint64_t kDTVSigMon_PATSeen = 0x0000000001ULL
 We've seen a PAT, which maps MPEG program numbers to pids where we find PMTs. More...
 
static const uint64_t kDTVSigMon_PMTSeen = 0x0000000002ULL
 We've seen a PMT, which maps program to audio, video and other stream PIDs. More...
 
static const uint64_t kDTVSigMon_MGTSeen = 0x0000000004ULL
 We've seen a MGT, which tells us on which PIDs to find VCT and other ATSC tables. More...
 
static const uint64_t kDTVSigMon_VCTSeen = 0x0000000008ULL
 We've seen a VCT, which maps ATSC Channels to MPEG program numbers, and provides additional data. More...
 
static const uint64_t kDTVSigMon_TVCTSeen = 0x0000000010ULL
 We've seen a TVCT, the terrestrial version of the VCT. More...
 
static const uint64_t kDTVSigMon_CVCTSeen = 0x0000000020ULL
 We've seen a CVCT, the cable version of the VCT. More...
 
static const uint64_t kDTVSigMon_NITSeen = 0x0000000040ULL
 We've seen a NIT, which tells us where to find SDT and other DVB tables. More...
 
static const uint64_t kDTVSigMon_SDTSeen = 0x0000000080ULL
 We've seen a SDT, which maps DVB Channels to MPEG program numbers, and provides additional data. More...
 
static const uint64_t kFWSigMon_PowerSeen = 0x0000000100ULL
 We've seen the FireWire STB power state. More...
 
static const uint64_t kDTVSigMon_CryptSeen = 0x0000000200ULL
 We've seen something indicating whether the data stream is encrypted. More...
 
static const uint64_t kDTVSigMon_PATMatch = 0x0000001000ULL
 We've seen a PAT matching our requirements. More...
 
static const uint64_t kDTVSigMon_PMTMatch = 0x0000002000ULL
 We've seen a PMT matching our requirements. More...
 
static const uint64_t kDTVSigMon_MGTMatch = 0x0000004000ULL
 We've seen an MGT matching our requirements. More...
 
static const uint64_t kDTVSigMon_VCTMatch = 0x0000008000ULL
 We've seen a VCT matching our requirements. More...
 
static const uint64_t kDTVSigMon_TVCTMatch = 0x0000010000ULL
 We've seen a TVCT matching our requirements. More...
 
static const uint64_t kDTVSigMon_CVCTMatch = 0x0000020000ULL
 We've seen a CVCT matching our requirements. More...
 
static const uint64_t kDTVSigMon_NITMatch = 0x0000040000ULL
 We've seen an NIT matching our requirements. More...
 
static const uint64_t kDTVSigMon_SDTMatch = 0x0000080000ULL
 We've seen an SDT matching our requirements. More...
 
static const uint64_t kFWSigMon_PowerMatch = 0x0000100000ULL
 We've seen a FireWire STB power state matching our requirements. More...
 
static const uint64_t kDTVSigMon_CryptMatch = 0x0000200000ULL
 We've seen unencrypted data in data stream. More...
 
static const uint64_t kDTVSigMon_WaitForPAT = 0x0001000000ULL
 
static const uint64_t kDTVSigMon_WaitForPMT = 0x0002000000ULL
 
static const uint64_t kDTVSigMon_WaitForMGT = 0x0004000000ULL
 
static const uint64_t kDTVSigMon_WaitForVCT = 0x0008000000ULL
 
static const uint64_t kDTVSigMon_WaitForNIT = 0x0010000000ULL
 
static const uint64_t kDTVSigMon_WaitForSDT = 0x0020000000ULL
 
static const uint64_t kSigMon_WaitForSig = 0x0040000000ULL
 
static const uint64_t kFWSigMon_WaitForPower = 0x0080000000ULL
 
static const uint64_t kDTVSigMon_WaitForCrypt =0x0100000000ULL
 
static const uint64_t kDTVSigMon_WaitForAll = 0x01FF000000ULL
 
static const uint64_t kDVBSigMon_WaitForSNR = 0x1000000000ULL
 Wait for the Signal to Noise Ratio to rise above a threshold. More...
 
static const uint64_t kDVBSigMon_WaitForBER = 0x2000000000ULL
 Wait for the Bit Error Rate to fall below a threshold. More...
 
static const uint64_t kDVBSigMon_WaitForUB = 0x4000000000ULL
 Wait for uncorrected FEC blocks to fall below a threshold. More...
 
static const uint64_t kDVBSigMon_WaitForPos = 0x8000000000ULL
 Wait for rotor to complete turning the antenna. More...
 
- Static Protected Member Functions inherited from MThread
static void setTerminationEnabled (bool enabled=true)
 
static void sleep (unsigned long time)
 
static void msleep (unsigned long time)
 
static void usleep (unsigned long time)
 
static void ThreadSetup (const QString &)
 This is to be called on startup in those few threads that haven't been ported to MThread. More...
 
static void ThreadCleanup (void)
 This is to be called on exit in those few threads that haven't been ported to MThread. More...
 
static void Cleanup (void)
 This will print out all the running threads, call exit(1) on each and then wait up to 5 seconds total for all the threads to exit. More...
 
static void GetAllThreadNames (QStringList &list)
 
static void GetAllRunningThreadNames (QStringList &list)
 
- Static Protected Attributes inherited from MThread
static const int kDefaultStartTimeout
 

Detailed Description

Definition at line 15 of file ExternalSignalMonitor.h.

Constructor & Destructor Documentation

◆ ExternalSignalMonitor() [1/3]

ExternalSignalMonitor::ExternalSignalMonitor ( int  db_cardnum,
ExternalChannel _channel,
bool  _release_stream,
uint64_t  _flags = 0 
)

Initializes signal lock and signal values.

Start() must be called to actually begin continuous signal monitoring. The timeout is set to 3 seconds, and the signal threshold is initialized to 0%.

Parameters
db_cardnumRecorder number to monitor, if this is less than 0, SIGNAL events will not be sent to the frontend even if SetNotifyFrontend(true) is called.
_channelExternalChannel for card
_flagsFlags to start with

Definition at line 40 of file ExternalSignalMonitor.cpp.

◆ ~ExternalSignalMonitor()

ExternalSignalMonitor::~ExternalSignalMonitor ( )
virtual

Stops signal monitoring and table monitoring threads.

Definition at line 61 of file ExternalSignalMonitor.cpp.

◆ ExternalSignalMonitor() [2/3]

ExternalSignalMonitor::ExternalSignalMonitor ( void  )
protected

◆ ExternalSignalMonitor() [3/3]

ExternalSignalMonitor::ExternalSignalMonitor ( const ExternalSignalMonitor )
protected

Member Function Documentation

◆ Stop()

void ExternalSignalMonitor::Stop ( void  )
overridevirtual

Stop signal monitoring and table monitoring threads.

Reimplemented from SignalMonitor.

Definition at line 71 of file ExternalSignalMonitor.cpp.

Referenced by ~ExternalSignalMonitor().

◆ UpdateValues()

void ExternalSignalMonitor::UpdateValues ( void  )
overrideprotectedvirtual

Fills in frontend stats and emits status Qt signals.

This is automatically called by run(), after Start() has been used to start the signal monitoring thread.

Reimplemented from SignalMonitor.

Definition at line 94 of file ExternalSignalMonitor.cpp.

◆ GetExternalChannel()

ExternalChannel* ExternalSignalMonitor::GetExternalChannel ( void  )
inlineprotected

Definition at line 29 of file ExternalSignalMonitor.h.

Referenced by UpdateValues().

◆ HasLock()

bool ExternalSignalMonitor::HasLock ( void  )
protected

Definition at line 160 of file ExternalSignalMonitor.cpp.

Referenced by UpdateValues().

◆ GetSignalStrengthPercent()

int ExternalSignalMonitor::GetSignalStrengthPercent ( void  )
protected

Definition at line 176 of file ExternalSignalMonitor.cpp.

Referenced by UpdateValues().

◆ GetLockTimeout()

int ExternalSignalMonitor::GetLockTimeout ( void  )
protected

Definition at line 202 of file ExternalSignalMonitor.cpp.

Referenced by ExternalSignalMonitor().

Member Data Documentation

◆ m_stream_handler

ExternalStreamHandler* ExternalSignalMonitor::m_stream_handler {nullptr}
protected

◆ m_stream_handler_started

bool ExternalSignalMonitor::m_stream_handler_started {false}
protected

Definition at line 41 of file ExternalSignalMonitor.h.

Referenced by Stop(), and UpdateValues().

◆ m_lock_timeout

int ExternalSignalMonitor::m_lock_timeout {0}
protected

Definition at line 42 of file ExternalSignalMonitor.h.

Referenced by ExternalSignalMonitor().


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