1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
|
/*
* Copyright@ Samsung Electronics Co. LTD
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
#ifndef _LIBCEC_H_
#define _LIBCEC_H_
#ifdef __cplusplus
extern "C" {
#endif
/** Maximum CEC frame size */
#define CEC_MAX_FRAME_SIZE 16
/** Not valid CEC physical address */
#define CEC_NOT_VALID_PHYSICAL_ADDRESS 0xFFFF
/** CEC broadcast address (as destination address) */
#define CEC_MSG_BROADCAST 0x0F
/** CEC unregistered address (as initiator address) */
#define CEC_LADDR_UNREGISTERED 0x0F
/*
* CEC Messages
*/
//@{
/** @name Messages for the One Touch Play Feature */
#define CEC_OPCODE_ACTIVE_SOURCE 0x82
#define CEC_OPCODE_IMAGE_VIEW_ON 0x04
#define CEC_OPCODE_TEXT_VIEW_ON 0x0D
//@}
//@{
/** @name Messages for the Routing Control Feature */
#define CEC_OPCODE_INACTIVE_SOURCE 0x9D
#define CEC_OPCODE_REQUEST_ACTIVE_SOURCE 0x85
#define CEC_OPCODE_ROUTING_CHANGE 0x80
#define CEC_OPCODE_ROUTING_INFORMATION 0x81
#define CEC_OPCODE_SET_STREAM_PATH 0x86
//@}
//@{
/** @name Messages for the Standby Feature */
#define CEC_OPCODE_STANDBY 0x36
//@}
//@{
/** @name Messages for the One Touch Record Feature */
#define CEC_OPCODE_RECORD_OFF 0x0B
#define CEC_OPCODE_RECORD_ON 0x09
#define CEC_OPCODE_RECORD_STATUS 0x0A
#define CEC_OPCODE_RECORD_TV_SCREEN 0x0F
//@}
//@{
/** @name Messages for the Timer Programming Feature */
#define CEC_OPCODE_CLEAR_ANALOGUE_TIMER 0x33
#define CEC_OPCODE_CLEAR_DIGITAL_TIMER 0x99
#define CEC_OPCODE_CLEAR_EXTERNAL_TIMER 0xA1
#define CEC_OPCODE_SET_ANALOGUE_TIMER 0x34
#define CEC_OPCODE_SET_DIGITAL_TIMER 0x97
#define CEC_OPCODE_SET_EXTERNAL_TIMER 0xA2
#define CEC_OPCODE_SET_TIMER_PROGRAM_TITLE 0x67
#define CEC_OPCODE_TIMER_CLEARED_STATUS 0x43
#define CEC_OPCODE_TIMER_STATUS 0x35
//@}
//@{
/** @name Messages for the System Information Feature */
#define CEC_OPCODE_CEC_VERSION 0x9E
#define CEC_OPCODE_GET_CEC_VERSION 0x9F
#define CEC_OPCODE_GIVE_PHYSICAL_ADDRESS 0x83
#define CEC_OPCODE_GET_MENU_LANGUAGE 0x91
//#define CEC_OPCODE_POLLING_MESSAGE
#define CEC_OPCODE_REPORT_PHYSICAL_ADDRESS 0x84
#define CEC_OPCODE_SET_MENU_LANGUAGE 0x32
//@}
//@{
/** @name Messages for the Deck Control Feature */
#define CEC_OPCODE_DECK_CONTROL 0x42
#define CEC_OPCODE_DECK_STATUS 0x1B
#define CEC_OPCODE_GIVE_DECK_STATUS 0x1A
#define CEC_OPCODE_PLAY 0x41
//@}
//@{
/** @name Messages for the Tuner Control Feature */
#define CEC_OPCODE_GIVE_TUNER_DEVICE_STATUS 0x08
#define CEC_OPCODE_SELECT_ANALOGUE_SERVICE 0x92
#define CEC_OPCODE_SELECT_DIGITAL_SERVICE 0x93
#define CEC_OPCODE_TUNER_DEVICE_STATUS 0x07
#define CEC_OPCODE_TUNER_STEP_DECREMENT 0x06
#define CEC_OPCODE_TUNER_STEP_INCREMENT 0x05
//@}
//@{
/** @name Messages for the Vendor Specific Commands Feature */
#define CEC_OPCODE_DEVICE_VENDOR_ID 0x87
#define CEC_OPCODE_GET_DEVICE_VENDOR_ID 0x8C
#define CEC_OPCODE_VENDOR_COMMAND 0x89
#define CEC_OPCODE_VENDOR_COMMAND_WITH_ID 0xA0
#define CEC_OPCODE_VENDOR_REMOTE_BUTTON_DOWN 0x8A
#define CEC_OPCODE_VENDOR_REMOVE_BUTTON_UP 0x8B
//@}
//@{
/** @name Messages for the OSD Display Feature */
#define CEC_OPCODE_SET_OSD_STRING 0x64
//@}
//@{
/** @name Messages for the Device OSD Transfer Feature */
#define CEC_OPCODE_GIVE_OSD_NAME 0x46
#define CEC_OPCODE_SET_OSD_NAME 0x47
//@}
//@{
/** @name Messages for the Device Menu Control Feature */
#define CEC_OPCODE_MENU_REQUEST 0x8D
#define CEC_OPCODE_MENU_STATUS 0x8E
#define CEC_OPCODE_USER_CONTROL_PRESSED 0x44
#define CEC_OPCODE_USER_CONTROL_RELEASED 0x45
//@}
//@{
/** @name Messages for the Remote Control Passthrough Feature */
//@}
//@{
/** @name Messages for the Power Status Feature */
#define CEC_OPCODE_GIVE_DEVICE_POWER_STATUS 0x8F
#define CEC_OPCODE_REPORT_POWER_STATUS 0x90
//@}
//@{
/** @name Messages for General Protocol messages */
#define CEC_OPCODE_FEATURE_ABORT 0x00
#define CEC_OPCODE_ABORT 0xFF
//@}
//@{
/** @name Messages for the System Audio Control Feature */
#define CEC_OPCODE_GIVE_AUDIO_STATUS 0x71
#define CEC_OPCODE_GIVE_SYSTEM_AUDIO_MODE_STATUS 0x7D
#define CEC_OPCODE_REPORT_AUDIO_STATUS 0x7A
#define CEC_OPCODE_SET_SYSTEM_AUDIO_MODE 0x72
#define CEC_OPCODE_SYSTEM_AUDIO_MODE_REQUEST 0x70
#define CEC_OPCODE_SYSTEM_AUDIO_MODE_STATUS 0x7E
//@}
//@{
/** @name Messages for the Audio Rate Control Feature */
#define CEC_OPCODE_SET_AUDIO_RATE 0x9A
//@}
//@{
/** @name CEC Operands */
//TODO: not finished
#define CEC_DECK_CONTROL_MODE_STOP 0x03
#define CEC_PLAY_MODE_PLAY_FORWARD 0x24
//@}
/**
* @enum CECDeviceType
* Type of CEC device
*/
enum CECDeviceType {
/** TV */
CEC_DEVICE_TV,
/** Recording Device */
CEC_DEVICE_RECODER,
/** Tuner */
CEC_DEVICE_TUNER,
/** Playback Device */
CEC_DEVICE_PLAYER,
/** Audio System */
CEC_DEVICE_AUDIO,
};
int CECOpen();
int CECClose();
int CECAllocLogicalAddress(int paddr, enum CECDeviceType devtype);
int CECSendMessage(unsigned char *buffer, int size);
int CECReceiveMessage(unsigned char *buffer, int size, long timeout);
int CECIgnoreMessage(unsigned char opcode, unsigned char lsrc);
int CECCheckMessageSize(unsigned char opcode, int size);
int CECCheckMessageMode(unsigned char opcode, int broadcast);
#ifdef __cplusplus
}
#endif
#endif /* _LIBCEC_H_ */
|
