inputman.h

   1 /*
   2     Copyright 2020 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, see <https://www.gnu.org/licenses/>.
  18 */
  19
  20 #ifndef INPUTMAN_H
  21 #define INPUTMAN_H
  22
  23 /*
  24 The plan:
  25
  26 The old design had an abstract Remote class with a single Remote* (RemoteWin, RemoteLinux, RemoteLirc)
  27 instantiating.
  28
  29 The new design is:
  30
  31 A single RemoteMan object will look after several Input devices. RemoteMan will have getInstance().
  32
  33 An abstract Input class (old Remote) defines common stuff about input devices.
  34
  35 Many Input* objects may exist at the same time. They will be:
  36
  37 InputLinux
  38 InputCEC
  39 InputUDP
  40 InputWin
  41 InputLirc
  42
  43 Obviously Linux and Win won't be active simultaneously. UDP will roll in the UDP button receiver
  44 into this input system.
  45
  46 The old design grew out of the fact the main thread waited on Remote::getButtonPress. Now the main
  47 thread waits on the MessageQueue. The input system should be separate, run in its own threads and
  48 should insert messages to the queue on input.
  49
  50 Benefits:
  51
  52 It would be nice if the input system could boot up in its own time, not delaying the rest of the
  53 program, but this may not be achievable.
  54
  55 In the future it will be possible to implement hot plugging of USB input devices. (Currently vomp
  56 only uses what is present at vomp-startup).
  57
  58 The CEC code can be removed from InputLinux. Under the new design they are nothing to do with
  59 each other.
  60
  61 Direct Lirc input can be brought back - probably very easily. TODO
  62
  63 Input objects can be easily and individually enabled / disabled.
  64
  65 New types of input can be implemented much easier.
  66
  67 For now, two decisions to make things a bit easier:
  68
  69 1. InputMan will hardcode knowledge about the Input types with hard pointers to each. In future
  70    perhaps this will change to a dynamic list of Input objects where InputMan refers to them
  71    through the Input interface only.
  72
  73 2. InputLinux will continue to represent all devices found in /dev/input. If there is a good
  74    reason in future then this should switch to several InputLinux objects representing one
  75    device each.
  76
  77 */
  78
  79 #include "defines.h"
  80 #include "abstractoption.h"
  81
  82 class InputLinux;
  83 class InputCEC;
  84 class InputWin;
  85 class InputUDP;
  86 class InputLirc;
  87
  88 class InputMan: public AbstractOption
  89 {
  90   public:
  91     InputMan();
  92     virtual ~InputMan();
  93     static InputMan* getInstance();
  94
  95     bool init();
  96     void shutdown();
  97
  98     bool start(); // MessageQueue should be ready before this is called
  99     void stop(); // Nothing should be sent to MQ after this
 100
 101     bool mayHaveFewButtons();
 102
 103     bool handlesVolume(); // Returns true if we have an InputCEC willing to handle volume
 104     void volumeUp();
 105     void volumeDown();
 106     void volumeMute();
 107     void changePowerState(bool powerOn);
 108
 109     // Abstract Option interface
 110     bool addOptionPagesToWTB(WTabBar* wtb);
 111     bool addOptionsToPanes(int panenumber, Options* options, WOptionPane* pane);
 112     bool saveOptionstoServer();
 113
 114     static const char* CommandDesc(UCHAR number);
 115
 116   private:
 117     static InputMan* instance;
 118
 119     InputLinux* inputLinux{};
 120     InputCEC* inputCEC{};
 121     InputWin* inputWin{};
 122     InputUDP* inputUDP{};
 123     InputLirc* inputLirc{};
 124
 125     bool initted{};
 126 };
 127
 128 #endif
 129
 130 // TODO idea:
 131 // don't have Input inherit AbstractOption, just individual inputs. Then one day could test with
 132 // dynamic_cast whether to call the AO IF stuff on them
 133 // could also have a CEC IF and do the same?