mvpreceiver.h

   1 /*
   2     Copyright 2004-2005 Chris Tallon
   3
   4     This file is part of VOMP.
   5
   6     VOMP is free software; you can redistribute it and/or modify
   7     it under the terms of the GNU General Public License as published by
   8     the Free Software Foundation; either version 2 of the License, or
   9     (at your option) any later version.
  10
  11     VOMP is distributed in the hope that it will be useful,
  12     but WITHOUT ANY WARRANTY; without even the implied warranty of
  13     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14     GNU General Public License for more details.
  15
  16     You should have received a copy of the GNU General Public License
  17     along with VOMP; if not, write to the Free Software
  18     Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  19 */
  20
  21 #ifndef MVPRECEIVER_H
  22 #define MVPRECEIVER_H
  23
  24 #include <vdr/channels.h>
  25 #include <vdr/device.h>
  26 #include <vdr/receiver.h>
  27
  28 #include "log.h"
  29 #include "thread.h"
  30 #include "ringbuffer.h"
  31 #include "tcp.h"
  32 #include "thread.h"
  33
  34 class MVPReceiver : public cReceiver, public Thread
  35 {
  36   public:
  37     static MVPReceiver* create(cChannel*, int priority);
  38     virtual ~MVPReceiver();
  39     int init(TCP* tcp, ULONG streamID);
  40     ULONG getBlock(unsigned char* buffer, unsigned long amount);
  41     bool isVdrActivated();
  42
  43   private:
  44     MVPReceiver(cChannel* channel, cDevice* device);
  45
  46     Log* logger;
  47     bool vdrActivated;
  48     int inittedOK;
  49     Ringbuffer processed;    // A simpler deleting ringbuffer for processed data
  50     pthread_mutex_t processedRingLock; // needs outside locking
  51
  52     TCP* tcp;
  53     ULONG streamID;
  54     ULONG streamDataCollected;
  55     const static int streamChunkSize = 50000;
  56
  57     // cReciever stuff
  58     void Activate(bool On);
  59     void Receive(UCHAR *Data, int Length);
  60
  61   protected:
  62     void threadMethod();
  63 };
  64
  65 #endif
  66
  67
  68 /*
  69     cReceiver docs from the header file
  70
  71     void Activate(bool On);
  72       // This function is called just before the cReceiver gets attached to
  73       // (On == true) or detached from (On == false) a cDevice. It can be used
  74       // to do things like starting/stopping a thread.
  75       // It is guaranteed that Receive() will not be called before Activate(true).
  76     void Receive(uchar *Data, int Length);
  77       // This function is called from the cDevice we are attached to, and
  78       // delivers one TS packet from the set of PIDs the cReceiver has requested.
  79       // The data packet must be accepted immediately, and the call must return
  80       // as soon as possible, without any unnecessary delay. Each TS packet
  81       // will be delivered only ONCE, so the cReceiver must make sure that
  82       // it will be able to buffer the data if necessary.
  83
  84 */
  85
  86 /*
  87
  88   cDevice docs
  89
  90 (VDR 1.4)
  91   static cDevice *GetDevice(const cChannel *Channel, int Priority = -1, bool *NeedsDetachReceivers = NULL);
  92      ///< Returns a device that is able to receive the given Channel at the
  93      ///< given Priority.
  94      ///< See ProvidesChannel() for more information on how
  95      ///< priorities are handled, and the meaning of NeedsDetachReceivers.
  96
  97 (VDR >1.5)
  98   static cDevice *GetDevice(const cChannel *Channel, int Priority, bool LiveView);
  99      ///< Returns a device that is able to receive the given Channel at the
 100      ///< given Priority, with the least impact on active recordings and
 101      ///< live viewing. The LiveView parameter tells whether the device will
 102      ///< be used for live viewing or a recording.
 103      ///< If the Channel is encrypted, a CAM slot that claims to be able to
 104      ///< decrypt the channel is automatically selected and assigned to the
 105      ///< returned device. Whether or not this combination of device and CAM
 106      ///< slot is actually able to decrypt the channel can only be determined
 107      ///< by checking the "scrambling control" bits of the received TS packets.
 108      ///< The Action() function automatically does this and takes care that
 109      ///< after detaching any receivers because the channel can't be decrypted,
 110      ///< this device/CAM combination will be skipped in the next call to
 111      ///< GetDevice().
 112      ///< See also ProvidesChannel().
 113
 114 */