fixed: compile
[deb_libcec.git] / src / lib / adapter / AdapterCommunication.h
CommitLineData
abbca718
LOK
1#pragma once
2/*
3 * This file is part of the libCEC(R) library.
4 *
b492c10e 5 * libCEC(R) is Copyright (C) 2011-2012 Pulse-Eight Limited. All rights reserved.
abbca718
LOK
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
ba65909d 34#include "../platform/util/StdString.h"
ef7696f5 35
abbca718
LOK
36namespace CEC
37{
7bb4ed43
LOK
38 typedef enum cec_adapter_message_state
39 {
40 ADAPTER_MESSAGE_STATE_UNKNOWN = 0, /**< the initial state */
41 ADAPTER_MESSAGE_STATE_WAITING_TO_BE_SENT, /**< waiting in the send queue of the adapter, or timed out */
42 ADAPTER_MESSAGE_STATE_SENT, /**< sent and waiting on an ACK */
43 ADAPTER_MESSAGE_STATE_SENT_NOT_ACKED, /**< sent, but failed to ACK */
44 ADAPTER_MESSAGE_STATE_SENT_ACKED, /**< sent, and ACK received */
45 ADAPTER_MESSAGE_STATE_INCOMING, /**< received from another device */
46 ADAPTER_MESSAGE_STATE_ERROR /**< an error occured */
47 } cec_adapter_message_state;
ef7696f5 48
9ceaabcd 49 class IAdapterCommunicationCallback
b1f94db1
LOK
50 {
51 public:
9ceaabcd
LOK
52 IAdapterCommunicationCallback(void) {}
53 virtual ~IAdapterCommunicationCallback(void) {}
54
b1f94db1
LOK
55 /*!
56 * @brief Callback method for IAdapterCommunication, called when a new cec_command is received
57 * @param command The command that has been received
58 * @return True when it was handled by this listener, false otherwise.
59 */
60 virtual bool OnCommandReceived(const cec_command &command) = 0;
61 };
62
9ceaabcd 63 class IAdapterCommunication
abbca718
LOK
64 {
65 public:
9ceaabcd
LOK
66 IAdapterCommunication(void) {}
67 virtual ~IAdapterCommunication(void) {}
68
7bb4ed43
LOK
69 /*!
70 * @brief Open a connection to the CEC adapter
b1f94db1 71 * @param cb The callback struct. if set to NULL, the Read() method has to be used to read commands. if set, OnCommandReceived() will be called for each command that was received
7bb4ed43 72 * @param iTimeoutMs Connection timeout in ms
a2198e5e 73 * @param bSkipChecks Skips all initial checks of the adapter, and starts the reader/writer threads directly after connecting.
7bb4ed43
LOK
74 * @return True when connected, false otherwise
75 */
a2198e5e 76 virtual bool Open(IAdapterCommunicationCallback *cb, uint32_t iTimeoutMs = 10000, bool bSkipChecks = false) = 0;
7bb4ed43
LOK
77
78 /*!
79 * @brief Close an open connection
80 */
81 virtual void Close(void) = 0;
82
83 /*!
84 * @return True when the connection is open, false otherwise
85 */
86 virtual bool IsOpen(void) = 0;
87
88 /*!
89 * @return The last error message, or an empty string if there was none
90 */
91 virtual CStdString GetError(void) const = 0;
92
93 /*!
94 * @brief Reads one cec_command from the adapter
95 * @param command The command that will be read (output)
96 * @param iTimeout The read timeout
97 * @return True when a command has been read, false otherwise.
98 */
99 virtual bool Read(cec_command &command, uint32_t iTimeout) = 0;
ef7696f5 100
7bb4ed43
LOK
101 /*!
102 * @brief Write a cec_command to the adapter
103 * @param data The command to write
104 * @param iMaxTries The maximum number of tries
105 * @param iLineTimeout The line timeout for the first try
106 * @param iRetryLineTimeout The line timeout for each next try
107 * @return The last state of the transmitted command
108 */
109 virtual cec_adapter_message_state Write(const cec_command &data, uint8_t iMaxTries, uint8_t iLineTimeout = 3, uint8_t iRetryLineTimeout = 3) = 0;
ef7696f5 110
7bb4ed43
LOK
111 /*!
112 * @brief Change the current line timeout on the CEC bus
113 * @param iTimeout The new timeout
114 * @return True when set, false otherwise
115 */
116 virtual bool SetLineTimeout(uint8_t iTimeout) = 0;
ef7696f5 117
7bb4ed43
LOK
118 /*!
119 * @brief Put the device in bootloader mode (which will disrupt CEC communication when it succeeds)
120 * @return True when the bootloader command has been sent, false otherwise.
121 */
122 virtual bool StartBootloader(void) = 0;
ef7696f5 123
7bb4ed43
LOK
124 /*!
125 * @brief Change the ACK-mask of the device, the mask for logical addresses to which the CEC device should ACK
126 * @param iMask The new mask
127 * @return True when set, false otherwise.
128 */
129 virtual bool SetAckMask(uint16_t iMask) = 0;
6729ac71 130
7bb4ed43
LOK
131 /*!
132 * @brief Check whether the CEC adapter responds
133 * @return True when the ping was sent and acked, false otherwise.
134 */
135 virtual bool PingAdapter(void) = 0;
ef7696f5 136
7bb4ed43
LOK
137 /*!
138 * @return The firmware version of this CEC adapter.
139 */
140 virtual uint16_t GetFirmwareVersion(void) = 0;
b057edad
BL
141
142 /*!
143 * @return True when the control mode has been set, false otherwise.
144 */
145 virtual bool SetControlledMode(bool controlled) = 0;
224ea877
LOK
146
147 /*!
148 * @brief Persist the given configuration in adapter (if supported)
149 * @brief The configuration to store.
150 * @return True when the configuration was persisted, false otherwise.
151 */
152 virtual bool PersistConfiguration(libcec_configuration *configuration) = 0;
cba904a6
LOK
153
154 /*!
155 * @return The name of the port
156 */
157 virtual CStdString GetPortName(void) = 0;
8670c970
LOK
158
159 /*!
160 * @return The physical address, if the adapter supports this. 0 otherwise.
161 */
162 virtual uint16_t GetPhysicalAddress(void) = 0;
abbca718
LOK
163 };
164};