cec: change the default argument of PowerOnDevices() to CECDEVICE_TV. deprecate Power...
[deb_libcec.git] / include / CECExportsC.h
1 #pragma once
2 /*
3 * This file is part of the libCEC(R) library.
4 *
5 * libCEC(R) is Copyright (C) 2011 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 #ifndef CECEXPORTS_C_H_
35 #define CECEXPORTS_C_H_
36
37 #ifdef __cplusplus
38 extern "C" {
39 #endif
40
41 /*!
42 * @brief Load the CEC adapter library.
43 * @param strDeviceName How to present this device to other devices.
44 * @param iLogicalAddress The logical of this device. PLAYBACKDEVICE1 by default.
45 * @param iPhysicalAddress The physical address of this device. 0x1000 by default.
46 * @return True when initialised, false otherwise.
47 */
48
49 #ifdef __cplusplus
50 extern DECLSPEC bool cec_init(const char *strDeviceName, CEC::cec_logical_address iLogicalAddress = CEC::CECDEVICE_PLAYBACKDEVICE1, int iPhysicalAddress = CEC_DEFAULT_PHYSICAL_ADDRESS);
51 #else
52 extern DECLSPEC bool cec_init(const char *strDeviceName, cec_logical_address iLogicalAddress = CECDEVICE_PLAYBACKDEVICE1, int iPhysicalAddress = CEC_DEFAULT_PHYSICAL_ADDRESS);
53 #endif
54
55 /*!
56 * @brief Open a connection to the CEC adapter.
57 * @param strPort The path to the port.
58 * @param iTimeout Connection timeout in ms.
59 * @return True when connected, false otherwise.
60 */
61 extern DECLSPEC bool cec_open(const char *strPort, int iTimeout);
62
63 /*!
64 * @brief Close the connection to the CEC adapter.
65 * @param iTimeout Timeout in ms
66 */
67 extern DECLSPEC bool cec_close(int iTimeout);
68
69 /*!
70 * @brief Ping the CEC adapter.
71 * @return True when the ping was succesful, false otherwise.
72 */
73 extern DECLSPEC bool cec_ping(void);
74
75 /*!
76 * @brief Start the bootloader of the CEC adapter.
77 * @return True when the command was sent succesfully, false otherwise.
78 */
79 extern DECLSPEC bool cec_start_bootloader(void);
80
81 /*!
82 * @depcrecated Use cec_standby_devices() instead
83 */
84 #ifdef __cplusplus
85 extern DECLSPEC bool cec_power_off_devices(CEC::cec_logical_address address = CEC::CECDEVICE_BROADCAST);
86 #else
87 extern DECLSPEC bool cec_power_off_devices(cec_logical_address address = CECDEVICE_BROADCAST);
88 #endif
89
90 /*!
91 * @brief Power on the connected CEC capable devices.
92 * @param address The logical address to power on.
93 * @return True when the command was sent succesfully, false otherwise.
94 */
95 #ifdef __cplusplus
96 extern DECLSPEC bool cec_power_on_devices(CEC::cec_logical_address address = CEC::CECDEVICE_TV);
97 #else
98 extern DECLSPEC bool cec_power_on_devices(cec_logical_address address = CECDEVICE_TV);
99 #endif
100
101 /*!
102 * @brief Put connected CEC capable devices in standby mode.
103 * @brief address The logical address of the device to put in standby.
104 * @return True when the command was sent succesfully, false otherwise.
105 */
106 #ifdef __cplusplus
107 extern DECLSPEC bool cec_standby_devices(CEC::cec_logical_address address = CEC::CECDEVICE_BROADCAST);
108 #else
109 extern DECLSPEC bool cec_standby_devices(cec_logical_address address = CECDEVICE_BROADCAST);
110 #endif
111
112 /*!
113 * @brief Broadcast a message that notifies connected CEC capable devices that this device is the active source.
114 * @return True when the command was sent succesfully, false otherwise.
115 */
116 extern DECLSPEC bool cec_set_active_view(void);
117
118 /*!
119 * @brief Broadcast a message that notifies connected CEC capable devices that this device is no longer the active source.
120 * @return True when the command was sent succesfully, false otherwise.
121 */
122 extern DECLSPEC bool cec_set_inactive_view(void);
123
124 /*!
125 * @brief Get the next log message in the queue, if there is one.
126 * @param message The next message.
127 * @return True if a message was passed, false otherwise.
128 */
129 #ifdef __cplusplus
130 extern DECLSPEC bool cec_get_next_log_message(CEC::cec_log_message *message);
131 #else
132 extern DECLSPEC bool cec_get_next_log_message(cec_log_message *message);
133 #endif
134
135 /*!
136 * @brief Get the next keypress in the queue, if there is one.
137 * @param key The next keypress.
138 * @return True if a key was passed, false otherwise.
139 */
140 #ifdef __cplusplus
141 extern DECLSPEC bool cec_get_next_keypress(CEC::cec_keypress *key);
142 #else
143 extern DECLSPEC bool cec_get_next_keypress(cec_keypress *key);
144 #endif
145
146 /*!
147 * @brief Get the next CEC command that was received by the adapter.
148 * @param action The next command.
149 * @return True when a command was passed, false otherwise.
150 */
151 #ifdef __cplusplus
152 extern DECLSPEC bool cec_get_next_command(CEC::cec_command *command);
153 #else
154 extern DECLSPEC bool cec_get_next_command(cec_command *command);
155 #endif
156
157 /*!
158 * @brief Transmit a frame on the CEC line.
159 * @param data The frame to send.
160 * @param bWaitForAck Wait for an ACK message for 1 second after this frame has been sent.
161 * @param iTimeout Timeout if the message could not be sent for this amount of ms. Does not influence the timeout of the wait for the ACK message. That timeout is specified by the CEC standard.
162 * @return True when the data was sent and acked, false otherwise.
163 */
164 #ifdef __cplusplus
165 extern DECLSPEC bool cec_transmit(const CEC::cec_frame &data, bool bWaitForAck = true, int64_t iTimeout = (int64_t) 5000);
166 #else
167 extern DECLSPEC bool cec_transmit(const cec_frame &data, bool bWaitForAck = true, int64_t iTimeout = (int64_t) 5000);
168 #endif
169
170 /*!
171 * @brief Set the logical address of the CEC adapter.
172 * @param iLogicalAddress The cec adapter's logical address.
173 * @return True when the logical address was set succesfully, false otherwise.
174 */
175 #ifdef __cplusplus
176 extern DECLSPEC bool cec_set_logical_address(CEC::cec_logical_address iLogicalAddress);
177 #else
178 extern DECLSPEC bool cec_set_logical_address(cec_logical_address myAddress, cec_logical_address targetAddress);
179 #endif
180
181 /*!
182 * @deprecated Use cec_set_logical_address() instead.
183 * @brief Set the ack mask of the CEC adapter.
184 * @param iMask The cec adapter's ack mask.
185 * @return True when the ack mask was sent succesfully, false otherwise.
186 */
187 extern DECLSPEC bool cec_set_ack_mask(uint16_t iMask);
188
189 /*!
190 * @return Get the minimal version of libcec that this version of libcec can interface with.
191 */
192 extern DECLSPEC int cec_get_min_version(void);
193
194 /*!
195 * @return Get the version of libcec.
196 */
197 extern DECLSPEC int cec_get_lib_version(void);
198
199 /*!
200 * @brief Try to find all connected CEC adapters. Only implemented on Linux at the moment.
201 * @param deviceList The vector to store device descriptors in.
202 * @param strDevicePath Optional device path. Only adds device descriptors that match the given device path.
203 * @return The number of devices that were found, or -1 when an error occured.
204 */
205 #ifdef __cplusplus
206 extern DECLSPEC int cec_find_devices(std::vector<CEC::cec_device> &deviceList, const char *strDevicePath = NULL);
207 #else
208 extern DECLSPEC int cec_find_devices(std::vector<cec_device> &deviceList, const char *strDevicePath = NULL);
209 #endif
210
211 #ifdef __cplusplus
212 };
213 #endif
214
215 #endif /* CECEXPORTS_C_H_ */