src/lib/implementations/CECCommandHandler.h

   1 #pragma once
   2 /*
   3  * This file is part of the libCEC(R) library.
   4  *
   5  * libCEC(R) is Copyright (C) 2011-2012 Pulse-Eight Limited.  All rights reserved.
   6  * libCEC(R) is an original work, containing original code.
   7  *
   8  * libCEC(R) is a trademark of Pulse-Eight Limited.
   9  *
  10  * This program is dual-licensed; you can redistribute it and/or modify
  11  * it under the terms of the GNU General Public License as published by
  12  * the Free Software Foundation; either version 2 of the License, or
  13  * (at your option) any later version.
  14  *
  15  * This program is distributed in the hope that it will be useful,
  16  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  17  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  18  * GNU General Public License for more details.
  19  *
  20  * You should have received a copy of the GNU General Public License
  21  * along with this program; if not, write to the Free Software
  22  * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
  23  *
  24  *
  25  * Alternatively, you can license this library under a commercial license,
  26  * please contact Pulse-Eight Licensing for more information.
  27  *
  28  * For more information contact:
  29  * Pulse-Eight Licensing       <license@pulse-eight.com>
  30  *     http://www.pulse-eight.com/
  31  *     http://www.pulse-eight.net/
  32  */
  33
  34 #include "../../../include/cectypes.h"
  35 #include <vector>
  36 #include <map>
  37 #include "../platform/threads/mutex.h"
  38 #include "../platform/util/StdString.h"
  39
  40 namespace CEC
  41 {
  42   class CCECProcessor;
  43   class CCECBusDevice;
  44
  45   class CResponse
  46   {
  47   public:
  48     CResponse(cec_opcode opcode) :
  49         m_opcode(opcode){}
  50     ~CResponse(void)
  51     {
  52       Broadcast();
  53     }
  54
  55     bool Wait(uint32_t iTimeout)
  56     {
  57       return m_event.Wait(iTimeout);
  58     }
  59
  60     void Broadcast(void)
  61     {
  62       m_event.Broadcast();
  63     }
  64
  65   private:
  66     cec_opcode       m_opcode;
  67     PLATFORM::CEvent m_event;
  68   };
  69
  70   class CWaitForResponse
  71   {
  72   public:
  73     CWaitForResponse(void) {}
  74     ~CWaitForResponse(void)
  75     {
  76       PLATFORM::CLockObject lock(m_mutex);
  77       for (std::map<cec_opcode, CResponse*>::iterator it = m_waitingFor.begin(); it != m_waitingFor.end(); it++)
  78       {
  79         it->second->Broadcast();
  80         delete it->second;
  81       }
  82       m_waitingFor.clear();
  83     }
  84
  85     bool Wait(cec_opcode opcode, uint32_t iTimeout = 2000)
  86     {
  87       CResponse *response = GetEvent(opcode);
  88       return response ? response->Wait(iTimeout) : false;
  89     }
  90
  91     void Received(cec_opcode opcode)
  92     {
  93       CResponse *response = GetEvent(opcode);
  94       if (response)
  95         response->Broadcast();
  96     }
  97
  98   private:
  99     CResponse *GetEvent(cec_opcode opcode)
 100     {
 101       CResponse *retVal(NULL);
 102       {
 103         PLATFORM::CLockObject lock(m_mutex);
 104         std::map<cec_opcode, CResponse*>::iterator it = m_waitingFor.find(opcode);
 105         if (it != m_waitingFor.end())
 106         {
 107           retVal = it->second;
 108         }
 109         else
 110         {
 111           retVal = new CResponse(opcode);
 112           m_waitingFor[opcode] = retVal;
 113         }
 114         return retVal;
 115       }
 116     }
 117
 118     PLATFORM::CMutex                 m_mutex;
 119     std::map<cec_opcode, CResponse*> m_waitingFor;
 120   };
 121
 122   class CCECCommandHandler
 123   {
 124   public:
 125     CCECCommandHandler(CCECBusDevice *busDevice);
 126     virtual ~CCECCommandHandler(void);
 127
 128     virtual bool HandleCommand(const cec_command &command);
 129     virtual cec_vendor_id GetVendorId(void) { return m_vendorId; };
 130     virtual void SetVendorId(cec_vendor_id vendorId) { m_vendorId = vendorId; }
 131     static bool HasSpecificHandler(cec_vendor_id vendorId) { return vendorId == CEC_VENDOR_LG || vendorId == CEC_VENDOR_SAMSUNG || vendorId == CEC_VENDOR_PANASONIC;}
 132
 133     virtual bool InitHandler(void) { return true; }
 134     virtual bool ActivateSource(void);
 135     virtual uint8_t GetTransmitRetries(void) const { return m_iTransmitRetries; }
 136
 137     virtual bool PowerOn(const cec_logical_address iInitiator, const cec_logical_address iDestination);
 138     virtual bool TransmitImageViewOn(const cec_logical_address iInitiator, const cec_logical_address iDestination);
 139     virtual bool TransmitStandby(const cec_logical_address iInitiator, const cec_logical_address iDestination);
 140     virtual bool TransmitRequestCecVersion(const cec_logical_address iInitiator, const cec_logical_address iDestination);
 141     virtual bool TransmitRequestMenuLanguage(const cec_logical_address iInitiator, const cec_logical_address iDestination);
 142     virtual bool TransmitRequestOSDName(const cec_logical_address iInitiator, const cec_logical_address iDestination);
 143     virtual bool TransmitRequestPhysicalAddress(const cec_logical_address iInitiator, const cec_logical_address iDestination);
 144     virtual bool TransmitRequestPowerStatus(const cec_logical_address iInitiator, const cec_logical_address iDestination);
 145     virtual bool TransmitRequestVendorId(const cec_logical_address iInitiator, const cec_logical_address iDestination);
 146     virtual bool TransmitActiveSource(const cec_logical_address iInitiator, uint16_t iPhysicalAddress);
 147     virtual bool TransmitCECVersion(const cec_logical_address iInitiator, const cec_logical_address iDestination, cec_version cecVersion);
 148     virtual bool TransmitInactiveSource(const cec_logical_address iInitiator, uint16_t iPhysicalAddress);
 149     virtual bool TransmitMenuState(const cec_logical_address iInitiator, const cec_logical_address iDestination, cec_menu_state menuState);
 150     virtual bool TransmitOSDName(const cec_logical_address iInitiator, const cec_logical_address iDestination, CStdString strDeviceName);
 151     virtual bool TransmitOSDString(const cec_logical_address iInitiator, const cec_logical_address iDestination, cec_display_control duration, const char *strMessage);
 152     virtual bool TransmitPhysicalAddress(const cec_logical_address iInitiator, uint16_t iPhysicalAddress, cec_device_type type);
 153     virtual bool TransmitPoll(const cec_logical_address iInitiator, const cec_logical_address iDestination);
 154     virtual bool TransmitPowerState(const cec_logical_address iInitiator, const cec_logical_address iDestination, cec_power_status state);
 155     virtual bool TransmitVendorID(const cec_logical_address iInitiator, uint64_t iVendorId);
 156     virtual bool TransmitAudioStatus(const cec_logical_address iInitiator, const cec_logical_address iDestination, uint8_t state);
 157     virtual bool TransmitSetSystemAudioMode(const cec_logical_address iInitiator, const cec_logical_address iDestination, cec_system_audio_status state);
 158     virtual bool TransmitSystemAudioModeStatus(const cec_logical_address iInitiator, const cec_logical_address iDestination, cec_system_audio_status state);
 159     virtual bool TransmitDeckStatus(const cec_logical_address iInitiator, const cec_logical_address iDestination, cec_deck_info state);
 160     virtual bool TransmitKeypress(const cec_logical_address iInitiator, const cec_logical_address iDestination, cec_user_control_code key, bool bWait = true);
 161     virtual bool TransmitKeyRelease(const cec_logical_address iInitiator, const cec_logical_address iDestination, bool bWait = true);
 162     virtual bool TransmitSetStreamPath(uint16_t iStreamPath);
 163     virtual bool SendDeckStatusUpdateOnActiveSource(void) const { return m_bOPTSendDeckStatusUpdateOnActiveSource; };
 164
 165   protected:
 166     virtual bool HandleActiveSource(const cec_command &command);
 167     virtual bool HandleDeckControl(const cec_command &command);
 168     virtual bool HandleDeviceCecVersion(const cec_command &command);
 169     virtual bool HandleDeviceVendorCommandWithId(const cec_command &command);
 170     virtual bool HandleDeviceVendorId(const cec_command &command);
 171     virtual bool HandleFeatureAbort(const cec_command &command);
 172     virtual bool HandleGetCecVersion(const cec_command &command);
 173     virtual bool HandleGiveAudioStatus(const cec_command &command);
 174     virtual bool HandleGiveDeckStatus(const cec_command &command);
 175     virtual bool HandleGiveDevicePowerStatus(const cec_command &command);
 176     virtual bool HandleGiveDeviceVendorId(const cec_command &command);
 177     virtual bool HandleGiveOSDName(const cec_command &command);
 178     virtual bool HandleGivePhysicalAddress(const cec_command &command);
 179     virtual bool HandleGiveSystemAudioModeStatus(const cec_command &command);
 180     virtual bool HandleImageViewOn(const cec_command &command);
 181     virtual bool HandleMenuRequest(const cec_command &command);
 182     virtual bool HandleReportAudioStatus(const cec_command &command);
 183     virtual bool HandleReportPhysicalAddress(const cec_command &command);
 184     virtual bool HandleReportPowerStatus(const cec_command &command);
 185     virtual bool HandleRequestActiveSource(const cec_command &command);
 186     virtual bool HandleRoutingChange(const cec_command &command);
 187     virtual bool HandleRoutingInformation(const cec_command &command);
 188     virtual bool HandleSetMenuLanguage(const cec_command &command);
 189     virtual bool HandleSetOSDName(const cec_command &command);
 190     virtual bool HandleSetStreamPath(const cec_command &command);
 191     virtual bool HandleSystemAudioModeRequest(const cec_command &command);
 192     virtual bool HandleStandby(const cec_command &command);
 193     virtual bool HandleSystemAudioModeStatus(const cec_command &command);
 194     virtual bool HandleSetSystemAudioMode(const cec_command &command);
 195     virtual bool HandleTextViewOn(const cec_command &command);
 196     virtual bool HandleUserControlPressed(const cec_command &command);
 197     virtual bool HandleUserControlRelease(const cec_command &command);
 198     virtual bool HandleVendorCommand(const cec_command &command);
 199     virtual void UnhandledCommand(const cec_command &command);
 200
 201     virtual size_t GetMyDevices(std::vector<CCECBusDevice *> &devices) const;
 202     virtual CCECBusDevice *GetDevice(cec_logical_address iLogicalAddress) const;
 203     virtual CCECBusDevice *GetDeviceByPhysicalAddress(uint16_t iPhysicalAddress) const;
 204     virtual CCECBusDevice *GetDeviceByType(cec_device_type type) const;
 205
 206     virtual bool SetVendorId(const cec_command &command);
 207     virtual void SetPhysicalAddress(cec_logical_address iAddress, uint16_t iNewAddress);
 208
 209     virtual bool Transmit(cec_command &command, bool bExpectResponse = true, cec_opcode expectedResponse = CEC_OPCODE_NONE);
 210
 211     CCECBusDevice *                       m_busDevice;
 212     CCECProcessor *                       m_processor;
 213     int32_t                               m_iTransmitTimeout;
 214     int32_t                               m_iTransmitWait;
 215     int8_t                                m_iTransmitRetries;
 216     bool                                  m_bHandlerInited;
 217     bool                                  m_bOPTSendDeckStatusUpdateOnActiveSource;
 218     cec_vendor_id                         m_vendorId;
 219     CWaitForResponse                     *m_waitForResponse;
 220   };
 221 };