include/cectypes.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 CECTYPES_H_
  35 #define CECTYPES_H_
  36
  37 #include <stdint.h>
  38 #include <string.h>
  39
  40 #if !defined(DECLSPEC)
  41 #if defined(_WIN32) || defined(_WIN64)
  42 #include <windows.h>
  43 #if defined DLL_EXPORT
  44 #define DECLSPEC __declspec(dllexport)
  45 #else
  46 #define DECLSPEC __declspec(dllimport)
  47 #endif
  48 #else
  49 #define DECLSPEC
  50 #endif
  51 #endif
  52
  53 #ifdef __cplusplus
  54 extern "C" {
  55 namespace CEC {
  56 #endif
  57
  58 //default physical address 1.0.0.0, HDMI port 1
  59 #define CEC_DEFAULT_PHYSICAL_ADDRESS 0x1000
  60 #define CEC_DEFAULT_HDMI_PORT        1
  61 #define CEC_DEFAULT_BASE_DEVICE      0
  62 #define MSGSTART                     0xFF
  63 #define MSGEND                       0xFE
  64 #define MSGESC                       0xFD
  65 #define ESCOFFSET                    3
  66 #define CEC_BUTTON_TIMEOUT           500
  67
  68 #define CEC_MIN_LIB_VERSION          1
  69 #define CEC_LIB_VERSION_MAJOR        1
  70 #define CEC_LIB_VERSION_MINOR        2
  71
  72 typedef enum cec_abort_reason
  73 {
  74   CEC_ABORT_REASON_UNRECOGNIZED_OPCODE            = 0,
  75   CEC_ABORT_REASON_NOT_IN_CORRECT_MODE_TO_RESPOND = 1,
  76   CEC_ABORT_REASON_CANNOT_PROVIDE_SOURCE          = 2,
  77   CEC_ABORT_REASON_INVALID_OPERAND                = 3,
  78   CEC_ABORT_REASON_REFUSED                        = 4
  79 } cec_abort_reason;
  80
  81 typedef enum cec_analogue_broadcast_type
  82 {
  83   CEC_ANALOGUE_BROADCAST_TYPE_CABLE      = 0x00,
  84   CEC_ANALOGUE_BROADCAST_TYPE_SATELLITE  = 0x01,
  85   CEC_ANALOGUE_BROADCAST_TYPE_TERRESTIAL = 0x02
  86 } cec_analogue_broadcast_type;
  87
  88 typedef enum cec_audio_rate
  89 {
  90   CEC_AUDIO_RATE_RATE_CONTROL_OFF    = 0,
  91   CEC_AUDIO_RATE_STANDARD_RATE_100   = 1,
  92   CEC_AUDIO_RATE_FAST_RATE_MAX_101   = 2,
  93   CEC_AUDIO_RATE_SLOW_RATE_MIN_99    = 3,
  94   CEC_AUDIO_RATE_STANDARD_RATE_100_0 = 4,
  95   CEC_AUDIO_RATE_FAST_RATE_MAX_100_1 = 5,
  96   CEC_AUDIO_RATE_SLOW_RATE_MIN_99_9  = 6
  97 } cec_audio_rate;
  98
  99 typedef enum cec_audio_status
 100 {
 101   CEC_AUDIO_MUTE_STATUS_MASK      = 0x80,
 102   CEC_AUDIO_VOLUME_STATUS_MASK    = 0x7F,
 103   CEC_AUDIO_VOLUME_MIN            = 0x00,
 104   CEC_AUDIO_VOLUME_MAX            = 0x64,
 105   CEC_AUDIO_VOLUME_STATUS_UNKNOWN = 0x7F
 106 } cec_audio_status;
 107
 108 typedef enum cec_boolean
 109 {
 110   CEC_FALSE = 0,
 111   CEC_TRUE  = 1
 112 } cec_boolean;
 113
 114 typedef enum cec_version
 115 {
 116   CEC_VERSION_UNKNOWN = 0x00,
 117   CEC_VERSION_1_2     = 0x01,
 118   CEC_VERSION_1_2A    = 0x02,
 119   CEC_VERSION_1_3     = 0x03,
 120   CEC_VERSION_1_3A    = 0x04,
 121   CEC_VERSION_1_4     = 0x05
 122 } cec_version;
 123
 124 typedef enum cec_channel_identifier
 125 {
 126   CEC_CHANNEL_NUMBER_FORMAT_MASK = 0xFC000000,
 127   CEC_1_PART_CHANNEL_NUMBER      = 0x04000000,
 128   CEC_2_PART_CHANNEL_NUMBER      = 0x08000000,
 129   CEC_MAJOR_CHANNEL_NUMBER_MASK  = 0x3FF0000,
 130   CEC_MINOR_CHANNEL_NUMBER_MASK  = 0xFFFF
 131 } cec_channel_identifier;
 132
 133 typedef enum cec_deck_control_mode
 134 {
 135   CEC_DECK_CONTROL_MODE_SKIP_FORWARD_WIND   = 1,
 136   CEC_DECK_CONTROL_MODE_SKIP_REVERSE_REWIND = 2,
 137   CEC_DECK_CONTROL_MODE_STOP                = 3,
 138   CEC_DECK_CONTROL_MODE_EJECT               = 4
 139 } cec_deck_control_mode;
 140
 141 typedef enum cec_deck_info
 142 {
 143   CEC_DECK_INFO_PLAY                 = 0x11,
 144   CEC_DECK_INFO_RECORD               = 0x12,
 145   CEC_DECK_INFO_PLAY_REVERSE         = 0x13,
 146   CEC_DECK_INFO_STILL                = 0x14,
 147   CEC_DECK_INFO_SLOW                 = 0x15,
 148   CEC_DECK_INFO_SLOW_REVERSE         = 0x16,
 149   CEC_DECK_INFO_FAST_FORWARD         = 0x17,
 150   CEC_DECK_INFO_FAST_REVERSE         = 0x18,
 151   CEC_DECK_INFO_NO_MEDIA             = 0x19,
 152   CEC_DECK_INFO_STOP                 = 0x1A,
 153   CEC_DECK_INFO_SKIP_FORWARD_WIND    = 0x1B,
 154   CEC_DECK_INFO_SKIP_REVERSE_REWIND  = 0x1C,
 155   CEC_DECK_INFO_INDEX_SEARCH_FORWARD = 0x1D,
 156   CEC_DECK_INFO_INDEX_SEARCH_REVERSE = 0x1E,
 157   CEC_DECK_INFO_OTHER_STATUS         = 0x1F,
 158   CEC_DECK_INFO_OTHER_STATUS_LG      = 0x20
 159 } cec_deck_info;
 160
 161 typedef enum cec_device_type
 162 {
 163   CEC_DEVICE_TYPE_TV               = 0,
 164   CEC_DEVICE_TYPE_RECORDING_DEVICE = 1,
 165   CEC_DEVICE_TYPE_RESERVED         = 2,
 166   CEC_DEVICE_TYPE_TUNER            = 3,
 167   CEC_DEVICE_TYPE_PLAYBACK_DEVICE  = 4,
 168   CEC_DEVICE_TYPE_AUDIO_SYSTEM     = 5
 169 } cec_device_type;
 170
 171 typedef enum cec_display_control
 172 {
 173   CEC_DISPLAY_CONTROL_DISPLAY_FOR_DEFAULT_TIME = 0x00,
 174   CEC_DISPLAY_CONTROL_DISPLAY_UNTIL_CLEARED    = 0x40,
 175   CEC_DISPLAY_CONTROL_CLEAR_PREVIOUS_MESSAGE   = 0x80,
 176   CEC_DISPLAY_CONTROL_RESERVED_FOR_FUTURE_USE  = 0xC0
 177 } cec_display_control;
 178
 179 typedef enum cec_external_source_specifier
 180 {
 181   CEC_EXTERNAL_SOURCE_SPECIFIER_EXTERNAL_PLUG             = 4,
 182   CEC_EXTERNAL_SOURCE_SPECIFIER_EXTERNAL_PHYSICAL_ADDRESS = 5
 183 } cec_external_source_specifier;
 184
 185 typedef enum cec_menu_request_type
 186 {
 187   CEC_MENU_REQUEST_TYPE_ACTIVATE   = 0,
 188   CEC_MENU_REQUEST_TYPE_DEACTIVATE = 1,
 189   CEC_MENU_REQUEST_TYPE_QUERY      = 2
 190 } cec_menu_request_type;
 191
 192 typedef enum cec_menu_state
 193 {
 194   CEC_MENU_STATE_ACTIVATED   = 0,
 195   CEC_MENU_STATE_DEACTIVATED = 1
 196 } cec_menu_state;
 197
 198 typedef enum cec_play_mode
 199 {
 200   CEC_PLAY_MODE_PLAY_FORWARD              = 0x24,
 201   CEC_PLAY_MODE_PLAY_REVERSE              = 0x20,
 202   CEC_PLAY_MODE_PLAY_STILL                = 0x25,
 203   CEC_PLAY_MODE_FAST_FORWARD_MIN_SPEED    = 0x05,
 204   CEC_PLAY_MODE_FAST_FORWARD_MEDIUM_SPEED = 0x06,
 205   CEC_PLAY_MODE_FAST_FORWARD_MAX_SPEED    = 0x07,
 206   CEC_PLAY_MODE_FAST_REVERSE_MIN_SPEED    = 0x09,
 207   CEC_PLAY_MODE_FAST_REVERSE_MEDIUM_SPEED = 0x0A,
 208   CEC_PLAY_MODE_FAST_REVERSE_MAX_SPEED    = 0x0B,
 209   CEC_PLAY_MODE_SLOW_FORWARD_MIN_SPEED    = 0x15,
 210   CEC_PLAY_MODE_SLOW_FORWARD_MEDIUM_SPEED = 0x16,
 211   CEC_PLAY_MODE_SLOW_FORWARD_MAX_SPEED    = 0x17,
 212   CEC_PLAY_MODE_SLOW_REVERSE_MIN_SPEED    = 0x19,
 213   CEC_PLAY_MODE_SLOW_REVERSE_MEDIUM_SPEED = 0x1A,
 214   CEC_PLAY_MODE_SLOW_REVERSE_MAX_SPEED    = 0x1B
 215 } cec_play_mode;
 216
 217 typedef enum cec_power_status
 218 {
 219   CEC_POWER_STATUS_ON                          = 0x00,
 220   CEC_POWER_STATUS_STANDBY                     = 0x01,
 221   CEC_POWER_STATUS_IN_TRANSITION_STANDBY_TO_ON = 0x02,
 222   CEC_POWER_STATUS_IN_TRANSITION_ON_TO_STANDBY = 0x03,
 223   CEC_POWER_STATUS_UNKNOWN                     = 0x99
 224 } cec_power_status;
 225
 226 typedef enum cec_record_source_type
 227 {
 228   CEC_RECORD_SOURCE_TYPE_OWN_SOURCE                = 1,
 229   CEC_RECORD_SOURCE_TYPE_DIGITAL_SERVICE           = 2,
 230   CEC_RECORD_SOURCE_TYPE_ANALOGUE_SERVICE          = 3,
 231   CEC_RECORD_SOURCE_TYPE_EXTERNAL_PLUS             = 4,
 232   CEC_RECORD_SOURCE_TYPE_EXTERNAL_PHYSICAL_ADDRESS = 5
 233 } cec_record_source_type;
 234
 235 typedef enum cec_record_status_info
 236 {
 237   CEC_RECORD_STATUS_INFO_RECORDING_CURRENTLY_SELECTED_SOURCE            = 0x01,
 238   CEC_RECORD_STATUS_INFO_RECORDING_DIGITAL_SERVICE                      = 0x02,
 239   CEC_RECORD_STATUS_INFO_RECORDING_ANALOGUE_SERVICE                     = 0x03,
 240   CEC_RECORD_STATUS_INFO_RECORDING_EXTERNAL_INPUT                       = 0x04,
 241   CEC_RECORD_STATUS_INFO_NO_RECORDING_UNABLE_TO_RECORD_DIGITAL_SERVICE  = 0x05,
 242   CEC_RECORD_STATUS_INFO_NO_RECORDING_UNABLE_TO_RECORD_ANALOGUE_SERVICE = 0x06,
 243   CEC_RECORD_STATUS_INFO_NO_RECORDING_UNABLE_TO_SELECT_REQUIRED_SERVICE = 0x07,
 244   CEC_RECORD_STATUS_INFO_NO_RECORDING_INVALID_EXTERNAL_PLUG_NUMBER      = 0x09,
 245   CEC_RECORD_STATUS_INFO_NO_RECORDING_INVALID_EXTERNAL_ADDRESS          = 0x0A,
 246   CEC_RECORD_STATUS_INFO_NO_RECORDING_CA_SYSTEM_NOT_SUPPORTED           = 0x0B,
 247   CEC_RECORD_STATUS_INFO_NO_RECORDING_NO_OR_INSUFFICIENT_ENTITLEMENTS   = 0x0C,
 248   CEC_RECORD_STATUS_INFO_NO_RECORDING_NOT_ALLOWED_TO_COPY_SOURCE        = 0x0D,
 249   CEC_RECORD_STATUS_INFO_NO_RECORDING_NO_FURTHER_COPIES_ALLOWED         = 0x0E,
 250   CEC_RECORD_STATUS_INFO_NO_RECORDING_NO_MEDIA                          = 0x10,
 251   CEC_RECORD_STATUS_INFO_NO_RECORDING_PLAYING                           = 0x11,
 252   CEC_RECORD_STATUS_INFO_NO_RECORDING_ALREADY_RECORDING                 = 0x12,
 253   CEC_RECORD_STATUS_INFO_NO_RECORDING_MEDIA_PROTECTED                   = 0x13,
 254   CEC_RECORD_STATUS_INFO_NO_RECORDING_NO_SOURCE_SIGNAL                  = 0x14,
 255   CEC_RECORD_STATUS_INFO_NO_RECORDING_MEDIA_PROBLEM                     = 0x15,
 256   CEC_RECORD_STATUS_INFO_NO_RECORDING_NOT_ENOUGH_SPACE_AVAILABLE        = 0x16,
 257   CEC_RECORD_STATUS_INFO_NO_RECORDING_PARENTAL_LOCK_ON                  = 0x17,
 258   CEC_RECORD_STATUS_INFO_RECORDING_TERMINATED_NORMALLY                  = 0x1A,
 259   CEC_RECORD_STATUS_INFO_RECORDING_HAS_ALREADY_TERMINATED               = 0x1B,
 260   CEC_RECORD_STATUS_INFO_NO_RECORDING_OTHER_REASON                      = 0x1F
 261 } cec_record_status_info;
 262
 263 typedef enum cec_recording_sequence
 264 {
 265   CEC_RECORDING_SEQUENCE_SUNDAY    = 0x01,
 266   CEC_RECORDING_SEQUENCE_MONDAY    = 0x02,
 267   CEC_RECORDING_SEQUENCE_TUESDAY   = 0x04,
 268   CEC_RECORDING_SEQUENCE_WEDNESDAY = 0x08,
 269   CEC_RECORDING_SEQUENCE_THURSDAY  = 0x10,
 270   CEC_RECORDING_SEQUENCE_FRIDAY    = 0x20,
 271   CEC_RECORDING_SEQUENCE_SATURDAY  = 0x40,
 272   CEC_RECORDING_SEQUENCE_ONCE_ONLY = 0x00
 273 } cec_recording_sequence;
 274
 275 typedef enum cec_status_request
 276 {
 277   CEC_STATUS_REQUEST_ON   = 1,
 278   CEC_STATUS_REQUEST_OFF  = 2,
 279   CEC_STATUS_REQUEST_ONCE = 3
 280 } cec_status_request;
 281
 282 typedef enum cec_system_audio_status
 283 {
 284   CEC_SYSTEM_AUDIO_STATUS_OFF = 0,
 285   CEC_SYSTEM_AUDIO_STATUS_ON  = 1
 286 } cec_system_audio_status;
 287
 288 typedef enum cec_timer_cleared_status_data
 289 {
 290   CEC_TIMER_CLEARED_STATUS_DATA_TIMER_NOT_CLEARED_RECORDING         = 0x00,
 291   CEC_TIMER_CLEARED_STATUS_DATA_TIMER_NOT_CLEARED_NO_MATCHING       = 0x01,
 292   CEC_TIMER_CLEARED_STATUS_DATA_TIMER_NOT_CLEARED_NO_INF0_AVAILABLE = 0x02,
 293   CEC_TIMER_CLEARED_STATUS_DATA_TIMER_CLEARED                       = 0x80
 294 } cec_timer_cleared_status_data;
 295
 296 typedef enum cec_timer_overlap_warning
 297 {
 298   CEC_TIMER_OVERLAP_WARNING_NO_OVERLAP           = 0,
 299   CEC_TIMER_OVERLAP_WARNING_TIMER_BLOCKS_OVERLAP = 1
 300 } cec_timer_overlap_warning;
 301
 302 typedef enum cec_media_info
 303 {
 304   CEC_MEDIA_INFO_MEDIA_PRESENT_AND_NOT_PROTECTED = 0x00,
 305   CEC_MEDIA_INFO_MEDIA_PRESENT_BUT_PROTECTED     = 0x01,
 306   CEC_MEDIA_INFO_MEDIA_NOT_PRESENT               = 0x02,
 307   CEC_MEDIA_INFO_FUTURE_USE                      = 0x03
 308 } cec_media_info;
 309
 310 typedef enum cec_programmed_indicator
 311 {
 312   CEC_PROGRAMMED_INDICATOR_NOT_PROGRAMMED = 0,
 313   CEC_PROGRAMMED_INDICATOR_PROGRAMMED     = 1
 314 } cec_programmed_indicator;
 315
 316 typedef enum cec_programmed_info
 317 {
 318   CEC_PROGRAMMED_INFO_FUTURE_USE                               = 0x0,
 319   CEC_PROGRAMMED_INFO_ENOUGH_SPACE_AVAILABLE_FOR_RECORDING     = 0x08,
 320   CEC_PROGRAMMED_INFO_NOT_ENOUGH_SPACE_AVAILABLE_FOR_RECORDING = 0x09,
 321   CEC_PROGRAMMED_INFO_MAY_NOT_BE_ENOUGH_SPACE_AVAILABLE        = 0x0B,
 322   CEC_PROGRAMMED_INFO_NO_MEDIA_INFO_AVAILABLE                  = 0x0A
 323 } cec_programmed_info;
 324
 325 typedef enum cec_not_programmed_error_info
 326 {
 327   CEC_NOT_PROGRAMMED_ERROR_INFO_FUTURE_USE                         = 0x0,
 328   CEC_NOT_PROGRAMMED_ERROR_INFO_NO_FREE_TIMER_AVAILABLE            = 0x01,
 329   CEC_NOT_PROGRAMMED_ERROR_INFO_DATE_OUT_OF_RANGE                  = 0x02,
 330   CEC_NOT_PROGRAMMED_ERROR_INFO_RECORDING_SEQUENCE_ERROR           = 0x03,
 331   CEC_NOT_PROGRAMMED_ERROR_INFO_INVALID_EXTERNAL_PLUG_NUMBER       = 0x04,
 332   CEC_NOT_PROGRAMMED_ERROR_INFO_INVALID_EXTERNAL_PHYSICAL_ADDRESS  = 0x05,
 333   CEC_NOT_PROGRAMMED_ERROR_INFO_CA_SYSTEM_NOT_SUPPORTED            = 0x06,
 334   CEC_NOT_PROGRAMMED_ERROR_INFO_NO_OR_INSUFFICIENT_CA_ENTITLEMENTS = 0x07,
 335   CEC_NOT_PROGRAMMED_ERROR_INFO_DOES_NOT_SUPPORT_RESOLUTION        = 0x08,
 336   CEC_NOT_PROGRAMMED_ERROR_INFO_PARENTAL_LOCK_ON                   = 0x09,
 337   CEC_NOT_PROGRAMMED_ERROR_INFO_CLOCK_FAILURE                      = 0x0A,
 338   CEC_NOT_PROGRAMMED_ERROR_INFO_RESERVED_FOR_FUTURE_USE_START      = 0x0B,
 339   CEC_NOT_PROGRAMMED_ERROR_INFO_RESERVED_FOR_FUTURE_USE_END        = 0x0D,
 340   CEC_NOT_PROGRAMMED_ERROR_INFO_DUPLICATE_ALREADY_PROGRAMMED       = 0x0E
 341 } cec_not_programmed_error_info;
 342
 343 typedef enum cec_recording_flag
 344 {
 345   CEC_RECORDING_FLAG_NOT_BEING_USED_FOR_RECORDING = 0,
 346   CEC_RECORDING_FLAG_BEING_USED_FOR_RECORDING     = 1
 347 } cec_recording_flag;
 348
 349 typedef enum cec_tuner_display_info
 350 {
 351   CEC_TUNER_DISPLAY_INFO_DISPLAYING_DIGITAL_TUNER  = 0,
 352   CEC_TUNER_DISPLAY_INFO_NOT_DISPLAYING_TUNER      = 1,
 353   CEC_TUNER_DISPLAY_INFO_DISPLAYING_ANALOGUE_TUNER = 2
 354 } cec_tuner_display_info;
 355
 356 typedef enum cec_broadcast_system
 357 {
 358   CEC_BROADCAST_SYSTEM_PAL_B_G      = 0,
 359   CEC_BROADCAST_SYSTEM_SECAM_L1     = 1,
 360   CEC_BROADCAST_SYSTEM_PAL_M        = 2,
 361   CEC_BROADCAST_SYSTEM_NTSC_M       = 3,
 362   CEC_BROADCAST_SYSTEM_PAL_I        = 4,
 363   CEC_BROADCAST_SYSTEM_SECAM_DK     = 5,
 364   CEC_BROADCAST_SYSTEM_SECAM_B_G    = 6,
 365   CEC_BROADCAST_SYSTEM_SECAM_L2     = 7,
 366   CEC_BROADCAST_SYSTEM_PAL_DK       = 8,
 367   CEC_BROADCAST_SYSTEM_OTHER_SYSTEM = 30
 368 } cec_broadcast_system;
 369
 370 typedef enum cec_user_control_code
 371 {
 372   CEC_USER_CONTROL_CODE_SELECT                      = 0x00,
 373   CEC_USER_CONTROL_CODE_UP                          = 0x01,
 374   CEC_USER_CONTROL_CODE_DOWN                        = 0x02,
 375   CEC_USER_CONTROL_CODE_LEFT                        = 0x03,
 376   CEC_USER_CONTROL_CODE_RIGHT                       = 0x04,
 377   CEC_USER_CONTROL_CODE_RIGHT_UP                    = 0x05,
 378   CEC_USER_CONTROL_CODE_RIGHT_DOWN                  = 0x06,
 379   CEC_USER_CONTROL_CODE_LEFT_UP                     = 0x07,
 380   CEC_USER_CONTROL_CODE_LEFT_DOWN                   = 0x08,
 381   CEC_USER_CONTROL_CODE_ROOT_MENU                   = 0x09,
 382   CEC_USER_CONTROL_CODE_SETUP_MENU                  = 0x0A,
 383   CEC_USER_CONTROL_CODE_CONTENTS_MENU               = 0x0B,
 384   CEC_USER_CONTROL_CODE_FAVORITE_MENU               = 0x0C,
 385   CEC_USER_CONTROL_CODE_EXIT                        = 0x0D,
 386   CEC_USER_CONTROL_CODE_NUMBER0                     = 0x20,
 387   CEC_USER_CONTROL_CODE_NUMBER1                     = 0x21,
 388   CEC_USER_CONTROL_CODE_NUMBER2                     = 0x22,
 389   CEC_USER_CONTROL_CODE_NUMBER3                     = 0x23,
 390   CEC_USER_CONTROL_CODE_NUMBER4                     = 0x24,
 391   CEC_USER_CONTROL_CODE_NUMBER5                     = 0x25,
 392   CEC_USER_CONTROL_CODE_NUMBER6                     = 0x26,
 393   CEC_USER_CONTROL_CODE_NUMBER7                     = 0x27,
 394   CEC_USER_CONTROL_CODE_NUMBER8                     = 0x28,
 395   CEC_USER_CONTROL_CODE_NUMBER9                     = 0x29,
 396   CEC_USER_CONTROL_CODE_DOT                         = 0x2A,
 397   CEC_USER_CONTROL_CODE_ENTER                       = 0x2B,
 398   CEC_USER_CONTROL_CODE_CLEAR                       = 0x2C,
 399   CEC_USER_CONTROL_CODE_NEXT_FAVORITE               = 0x2F,
 400   CEC_USER_CONTROL_CODE_CHANNEL_UP                  = 0x30,
 401   CEC_USER_CONTROL_CODE_CHANNEL_DOWN                = 0x31,
 402   CEC_USER_CONTROL_CODE_PREVIOUS_CHANNEL            = 0x32,
 403   CEC_USER_CONTROL_CODE_SOUND_SELECT                = 0x33,
 404   CEC_USER_CONTROL_CODE_INPUT_SELECT                = 0x34,
 405   CEC_USER_CONTROL_CODE_DISPLAY_INFORMATION         = 0x35,
 406   CEC_USER_CONTROL_CODE_HELP                        = 0x36,
 407   CEC_USER_CONTROL_CODE_PAGE_UP                     = 0x37,
 408   CEC_USER_CONTROL_CODE_PAGE_DOWN                   = 0x38,
 409   CEC_USER_CONTROL_CODE_POWER                       = 0x40,
 410   CEC_USER_CONTROL_CODE_VOLUME_UP                   = 0x41,
 411   CEC_USER_CONTROL_CODE_VOLUME_DOWN                 = 0x42,
 412   CEC_USER_CONTROL_CODE_MUTE                        = 0x43,
 413   CEC_USER_CONTROL_CODE_PLAY                        = 0x44,
 414   CEC_USER_CONTROL_CODE_STOP                        = 0x45,
 415   CEC_USER_CONTROL_CODE_PAUSE                       = 0x46,
 416   CEC_USER_CONTROL_CODE_RECORD                      = 0x47,
 417   CEC_USER_CONTROL_CODE_REWIND                      = 0x48,
 418   CEC_USER_CONTROL_CODE_FAST_FORWARD                = 0x49,
 419   CEC_USER_CONTROL_CODE_EJECT                       = 0x4A,
 420   CEC_USER_CONTROL_CODE_FORWARD                     = 0x4B,
 421   CEC_USER_CONTROL_CODE_BACKWARD                    = 0x4C,
 422   CEC_USER_CONTROL_CODE_STOP_RECORD                 = 0x4D,
 423   CEC_USER_CONTROL_CODE_PAUSE_RECORD                = 0x4E,
 424   CEC_USER_CONTROL_CODE_ANGLE                       = 0x50,
 425   CEC_USER_CONTROL_CODE_SUB_PICTURE                 = 0x51,
 426   CEC_USER_CONTROL_CODE_VIDEO_ON_DEMAND             = 0x52,
 427   CEC_USER_CONTROL_CODE_ELECTRONIC_PROGRAM_GUIDE    = 0x53,
 428   CEC_USER_CONTROL_CODE_TIMER_PROGRAMMING           = 0x54,
 429   CEC_USER_CONTROL_CODE_INITIAL_CONFIGURATION       = 0x55,
 430   CEC_USER_CONTROL_CODE_PLAY_FUNCTION               = 0x60,
 431   CEC_USER_CONTROL_CODE_PAUSE_PLAY_FUNCTION         = 0x61,
 432   CEC_USER_CONTROL_CODE_RECORD_FUNCTION             = 0x62,
 433   CEC_USER_CONTROL_CODE_PAUSE_RECORD_FUNCTION       = 0x63,
 434   CEC_USER_CONTROL_CODE_STOP_FUNCTION               = 0x64,
 435   CEC_USER_CONTROL_CODE_MUTE_FUNCTION               = 0x65,
 436   CEC_USER_CONTROL_CODE_RESTORE_VOLUME_FUNCTION     = 0x66,
 437   CEC_USER_CONTROL_CODE_TUNE_FUNCTION               = 0x67,
 438   CEC_USER_CONTROL_CODE_SELECT_MEDIA_FUNCTION       = 0x68,
 439   CEC_USER_CONTROL_CODE_SELECT_AV_INPUT_FUNCTION    = 0x69,
 440   CEC_USER_CONTROL_CODE_SELECT_AUDIO_INPUT_FUNCTION = 0x6A,
 441   CEC_USER_CONTROL_CODE_POWER_TOGGLE_FUNCTION       = 0x6B,
 442   CEC_USER_CONTROL_CODE_POWER_OFF_FUNCTION          = 0x6C,
 443   CEC_USER_CONTROL_CODE_POWER_ON_FUNCTION           = 0x6D,
 444   CEC_USER_CONTROL_CODE_F1_BLUE                     = 0x71,
 445   CEC_USER_CONTROL_CODE_F2_RED                      = 0X72,
 446   CEC_USER_CONTROL_CODE_F3_GREEN                    = 0x73,
 447   CEC_USER_CONTROL_CODE_F4_YELLOW                   = 0x74,
 448   CEC_USER_CONTROL_CODE_F5                          = 0x75,
 449   CEC_USER_CONTROL_CODE_DATA                        = 0x76,
 450   CEC_USER_CONTROL_CODE_MAX                         = 0x76,
 451   CEC_USER_CONTROL_CODE_UNKNOWN
 452 } cec_user_control_code;
 453
 454 typedef enum cec_an_user_control_code
 455 {
 456   CEC_AN_USER_CONTROL_CODE_RETURN = 0x91
 457 } cec_an_user_control_code;
 458
 459 typedef enum cec_logical_address
 460 {
 461   CECDEVICE_UNKNOWN          = -1, //not a valid logical address
 462   CECDEVICE_TV               = 0,
 463   CECDEVICE_RECORDINGDEVICE1 = 1,
 464   CECDEVICE_RECORDINGDEVICE2 = 2,
 465   CECDEVICE_TUNER1           = 3,
 466   CECDEVICE_PLAYBACKDEVICE1  = 4,
 467   CECDEVICE_AUDIOSYSTEM      = 5,
 468   CECDEVICE_TUNER2           = 6,
 469   CECDEVICE_TUNER3           = 7,
 470   CECDEVICE_PLAYBACKDEVICE2  = 8,
 471   CECDEVICE_RECORDINGDEVICE3 = 9,
 472   CECDEVICE_TUNER4           = 10,
 473   CECDEVICE_PLAYBACKDEVICE3  = 11,
 474   CECDEVICE_RESERVED1        = 12,
 475   CECDEVICE_RESERVED2        = 13,
 476   CECDEVICE_FREEUSE          = 14,
 477   CECDEVICE_UNREGISTERED     = 15,
 478   CECDEVICE_BROADCAST        = 15
 479 } cec_logical_address;
 480
 481 typedef enum cec_opcode
 482 {
 483   CEC_OPCODE_ACTIVE_SOURCE                 = 0x82,
 484   CEC_OPCODE_IMAGE_VIEW_ON                 = 0x04,
 485   CEC_OPCODE_TEXT_VIEW_ON                  = 0x0D,
 486   CEC_OPCODE_INACTIVE_SOURCE               = 0x9D,
 487   CEC_OPCODE_REQUEST_ACTIVE_SOURCE         = 0x85,
 488   CEC_OPCODE_ROUTING_CHANGE                = 0x80,
 489   CEC_OPCODE_ROUTING_INFORMATION           = 0x81,
 490   CEC_OPCODE_SET_STREAM_PATH               = 0x86,
 491   CEC_OPCODE_STANDBY                       = 0x36,
 492   CEC_OPCODE_RECORD_OFF                    = 0x0B,
 493   CEC_OPCODE_RECORD_ON                     = 0x09,
 494   CEC_OPCODE_RECORD_STATUS                 = 0x0A,
 495   CEC_OPCODE_RECORD_TV_SCREEN              = 0x0F,
 496   CEC_OPCODE_CLEAR_ANALOGUE_TIMER          = 0x33,
 497   CEC_OPCODE_CLEAR_DIGITAL_TIMER           = 0x99,
 498   CEC_OPCODE_CLEAR_EXTERNAL_TIMER          = 0xA1,
 499   CEC_OPCODE_SET_ANALOGUE_TIMER            = 0x34,
 500   CEC_OPCODE_SET_DIGITAL_TIMER             = 0x97,
 501   CEC_OPCODE_SET_EXTERNAL_TIMER            = 0xA2,
 502   CEC_OPCODE_SET_TIMER_PROGRAM_TITLE       = 0x67,
 503   CEC_OPCODE_TIMER_CLEARED_STATUS          = 0x43,
 504   CEC_OPCODE_TIMER_STATUS                  = 0x35,
 505   CEC_OPCODE_CEC_VERSION                   = 0x9E,
 506   CEC_OPCODE_GET_CEC_VERSION               = 0x9F,
 507   CEC_OPCODE_GIVE_PHYSICAL_ADDRESS         = 0x83,
 508   CEC_OPCODE_GET_MENU_LANGUAGE             = 0x91,
 509   CEC_OPCODE_REPORT_PHYSICAL_ADDRESS       = 0x84,
 510   CEC_OPCODE_SET_MENU_LANGUAGE             = 0x32,
 511   CEC_OPCODE_DECK_CONTROL                  = 0x42,
 512   CEC_OPCODE_DECK_STATUS                   = 0x1B,
 513   CEC_OPCODE_GIVE_DECK_STATUS              = 0x1A,
 514   CEC_OPCODE_PLAY                          = 0x41,
 515   CEC_OPCODE_GIVE_TUNER_DEVICE_STATUS      = 0x08,
 516   CEC_OPCODE_SELECT_ANALOGUE_SERVICE       = 0x92,
 517   CEC_OPCODE_SELECT_DIGITAL_SERVICE        = 0x93,
 518   CEC_OPCODE_TUNER_DEVICE_STATUS           = 0x07,
 519   CEC_OPCODE_TUNER_STEP_DECREMENT          = 0x06,
 520   CEC_OPCODE_TUNER_STEP_INCREMENT          = 0x05,
 521   CEC_OPCODE_DEVICE_VENDOR_ID              = 0x87,
 522   CEC_OPCODE_GIVE_DEVICE_VENDOR_ID         = 0x8C,
 523   CEC_OPCODE_VENDOR_COMMAND                = 0x89,
 524   CEC_OPCODE_VENDOR_COMMAND_WITH_ID        = 0xA0,
 525   CEC_OPCODE_VENDOR_REMOTE_BUTTON_DOWN     = 0x8A,
 526   CEC_OPCODE_VENDOR_REMOTE_BUTTON_UP       = 0x8B,
 527   CEC_OPCODE_SET_OSD_STRING                = 0x64,
 528   CEC_OPCODE_GIVE_OSD_NAME                 = 0x46,
 529   CEC_OPCODE_SET_OSD_NAME                  = 0x47,
 530   CEC_OPCODE_MENU_REQUEST                  = 0x8D,
 531   CEC_OPCODE_MENU_STATUS                   = 0x8E,
 532   CEC_OPCODE_USER_CONTROL_PRESSED          = 0x44,
 533   CEC_OPCODE_USER_CONTROL_RELEASE          = 0x45,
 534   CEC_OPCODE_GIVE_DEVICE_POWER_STATUS      = 0x8F,
 535   CEC_OPCODE_REPORT_POWER_STATUS           = 0x90,
 536   CEC_OPCODE_FEATURE_ABORT                 = 0x00,
 537   CEC_OPCODE_ABORT                         = 0xFF,
 538   CEC_OPCODE_GIVE_AUDIO_STATUS             = 0x71,
 539   CEC_OPCODE_GIVE_SYSTEM_AUDIO_MODE_STATUS = 0x7D,
 540   CEC_OPCODE_REPORT_AUDIO_STATUS           = 0x7A,
 541   CEC_OPCODE_SET_SYSTEM_AUDIO_MODE         = 0x72,
 542   CEC_OPCODE_SYSTEM_AUDIO_MODE_REQUEST     = 0x70,
 543   CEC_OPCODE_SYSTEM_AUDIO_MODE_STATUS      = 0x7E,
 544   CEC_OPCODE_SET_AUDIO_RATE                = 0x9A,
 545   /* when this opcode is set, no opcode will be sent to the device. this is one of the reserved numbers */
 546   CEC_OPCODE_NONE                          = 0xFD
 547 } cec_opcode;
 548
 549 typedef enum cec_log_level
 550 {
 551   CEC_LOG_ERROR   = 1,
 552   CEC_LOG_WARNING = 2,
 553   CEC_LOG_NOTICE  = 4,
 554   CEC_LOG_TRAFFIC = 8,
 555   CEC_LOG_DEBUG   = 16,
 556   CEC_LOG_ALL     = 31
 557 } cec_log_level;
 558
 559 typedef enum cec_adapter_messagecode
 560 {
 561   MSGCODE_NOTHING = 0,
 562   MSGCODE_PING,
 563   MSGCODE_TIMEOUT_ERROR,
 564   MSGCODE_HIGH_ERROR,
 565   MSGCODE_LOW_ERROR,
 566   MSGCODE_FRAME_START,
 567   MSGCODE_FRAME_DATA,
 568   MSGCODE_RECEIVE_FAILED,
 569   MSGCODE_COMMAND_ACCEPTED,
 570   MSGCODE_COMMAND_REJECTED,
 571   MSGCODE_SET_ACK_MASK,
 572   MSGCODE_TRANSMIT,
 573   MSGCODE_TRANSMIT_EOM,
 574   MSGCODE_TRANSMIT_IDLETIME,
 575   MSGCODE_TRANSMIT_ACK_POLARITY,
 576   MSGCODE_TRANSMIT_LINE_TIMEOUT,
 577   MSGCODE_TRANSMIT_SUCCEEDED,
 578   MSGCODE_TRANSMIT_FAILED_LINE,
 579   MSGCODE_TRANSMIT_FAILED_ACK,
 580   MSGCODE_TRANSMIT_FAILED_TIMEOUT_DATA,
 581   MSGCODE_TRANSMIT_FAILED_TIMEOUT_LINE,
 582   MSGCODE_FIRMWARE_VERSION,
 583   MSGCODE_START_BOOTLOADER,
 584   MSGCODE_FRAME_EOM = 0x80,
 585   MSGCODE_FRAME_ACK = 0x40,
 586 } cec_adapter_messagecode;
 587
 588 typedef enum cec_bus_device_status
 589 {
 590   CEC_DEVICE_STATUS_UNKNOWN,
 591   CEC_DEVICE_STATUS_PRESENT,
 592   CEC_DEVICE_STATUS_NOT_PRESENT,
 593   CEC_DEVICE_STATUS_HANDLED_BY_LIBCEC
 594 } cec_bus_device_status;
 595
 596 typedef enum cec_vendor_id
 597 {
 598   CEC_VENDOR_SAMSUNG   = 0x00F0,
 599   CEC_VENDOR_LG        = 0xE091,
 600   CEC_VENDOR_PANASONIC = 0x8045,
 601   CEC_VENDOR_PIONEER   = 0xE036,
 602   CEC_VENDOR_ONKYO     = 0x09B0,
 603   CEC_VENDOR_YAMAHA    = 0xA0DE,
 604   CEC_VENDOR_PHILIPS   = 0x903E,
 605   CEC_VENDOR_UNKNOWN   = 0
 606 } cec_vendor_id;
 607
 608 typedef struct cec_menu_language
 609 {
 610   char                language[4];
 611   cec_logical_address device;
 612 } cec_menu_language;
 613
 614 typedef struct cec_osd_name
 615 {
 616   char                name[14];
 617   cec_logical_address device;
 618 } cec_osd_name;
 619
 620 typedef struct cec_log_message
 621 {
 622   char          message[1024];
 623   cec_log_level level;
 624   int64_t       time;
 625 } cec_log_message;
 626
 627 typedef struct cec_keypress
 628 {
 629   cec_user_control_code keycode;
 630   unsigned int          duration;
 631 } cec_keypress;
 632
 633 typedef struct cec_adapter
 634 {
 635   char path[1024];
 636   char comm[1024];
 637 } cec_adapter;
 638
 639 typedef struct cec_datapacket
 640 {
 641   uint8_t data[100];
 642   uint8_t size;
 643
 644 #ifdef __cplusplus
 645   cec_datapacket &operator =(const struct cec_datapacket &packet)
 646   {
 647     Clear();
 648     for (uint8_t iPtr = 0; iPtr < packet.size; iPtr++)
 649       PushBack(packet[iPtr]);
 650
 651     return *this;
 652   }
 653
 654   bool    IsEmpty(void) const             { return size == 0; }
 655   bool    IsFull(void) const              { return size == 100; }
 656   uint8_t operator[](uint8_t pos) const { return pos < size ? data[pos] : 0; }
 657   uint8_t At(uint8_t pos) const         { return pos < size ? data[pos] : 0; }
 658
 659   void Shift(uint8_t iShiftBy)
 660   {
 661     if (iShiftBy >= size)
 662     {
 663       Clear();
 664     }
 665     else
 666     {
 667       for (uint8_t iPtr = 0; iPtr < size; iPtr++)
 668         data[iPtr] = (iPtr + iShiftBy < size) ? data[iPtr + iShiftBy] : 0;
 669       size = (uint8_t) (size - iShiftBy);
 670     }
 671   }
 672
 673   void PushBack(uint8_t add)
 674   {
 675     if (size < 100)
 676       data[size++] = add;
 677   }
 678
 679   void Clear(void)
 680   {
 681     memset(data, 0, sizeof(data));
 682     size = 0;
 683   }
 684 #endif
 685
 686 } cec_datapacket;
 687
 688 typedef struct cec_command
 689 {
 690   cec_logical_address initiator;
 691   cec_logical_address destination;
 692   int8_t              ack;
 693   int8_t              eom;
 694   cec_opcode          opcode;
 695   cec_datapacket      parameters;
 696   int8_t              opcode_set;
 697   int32_t             transmit_timeout;
 698   int8_t              retries;
 699
 700 #ifdef __cplusplus
 701   cec_command &operator =(const struct cec_command &command)
 702   {
 703     initiator        = command.initiator;
 704     destination      = command.destination;
 705     ack              = command.ack;
 706     eom              = command.eom;
 707     opcode           = command.opcode;
 708     opcode_set       = command.opcode_set;
 709     transmit_timeout = command.transmit_timeout;
 710     parameters       = command.parameters;
 711     retries          = command.retries;
 712
 713     return *this;
 714   }
 715
 716   static void Format(cec_command &command, cec_logical_address initiator, cec_logical_address destination, cec_opcode opcode)
 717   {
 718     command.Clear();
 719     command.initiator    = initiator;
 720     command.destination  = destination;
 721     if (opcode != CEC_OPCODE_NONE)
 722     {
 723       command.opcode     = opcode;
 724       command.opcode_set = 1;
 725     }
 726   }
 727
 728   void PushBack(uint8_t data)
 729   {
 730     if (initiator == CECDEVICE_UNKNOWN && destination == CECDEVICE_UNKNOWN)
 731     {
 732       initiator   = (cec_logical_address) (data >> 4);
 733       destination = (cec_logical_address) (data & 0xF);
 734     }
 735     else if (!opcode_set)
 736     {
 737       opcode_set = 1;
 738       opcode = (cec_opcode) data;
 739     }
 740     else
 741       parameters.PushBack(data);
 742   }
 743
 744   void Clear(void)
 745   {
 746     initiator        = CECDEVICE_UNKNOWN;
 747     destination      = CECDEVICE_UNKNOWN;
 748     ack              = 0;
 749     eom              = 0;
 750     opcode_set       = 0;
 751     opcode           = CEC_OPCODE_FEATURE_ABORT;
 752     transmit_timeout = 1000;
 753     retries          = 4;
 754     parameters.Clear();
 755   };
 756 #endif
 757 } cec_command;
 758
 759 typedef struct cec_device_type_list
 760 {
 761   cec_device_type types[5];
 762
 763 #ifdef __cplusplus
 764   /*!
 765    * @deprecated
 766    */
 767   void clear(void) { Clear(); }
 768   /*!
 769    * @deprecated
 770    */
 771   void add(const cec_device_type type) { Add(type); }
 772
 773   void Clear(void)
 774   {
 775     for (unsigned int iPtr = 0; iPtr < 5; iPtr++)
 776      types[iPtr] = CEC_DEVICE_TYPE_RESERVED;
 777   }
 778
 779   void Add(const cec_device_type type)
 780   {
 781     for (unsigned int iPtr = 0; iPtr < 5; iPtr++)
 782     {
 783       if (types[iPtr] == CEC_DEVICE_TYPE_RESERVED)
 784       {
 785         types[iPtr] = type;
 786         break;
 787       }
 788     }
 789   }
 790
 791   bool IsSet(cec_device_type type)
 792   {
 793     bool bReturn(false);
 794     for (unsigned int iPtr = 0; !bReturn && iPtr < 5; iPtr++)
 795     {
 796       if (types[iPtr] == type)
 797         bReturn = true;
 798     }
 799     return bReturn;
 800   }
 801
 802   bool IsEmpty()
 803   {
 804     bool bReturn(true);
 805     for (unsigned int iPtr = 0; bReturn && iPtr < 5; iPtr++)
 806     {
 807       if (types[iPtr] != CEC_DEVICE_TYPE_RESERVED)
 808         bReturn = false;
 809     }
 810     return bReturn;
 811   }
 812
 813   cec_device_type operator[](uint8_t pos) const { return pos < 5 ? types[pos] : CEC_DEVICE_TYPE_RESERVED; }
 814 #endif
 815 } cec_device_type_list;
 816
 817 typedef struct cec_logical_addresses
 818 {
 819   cec_logical_address primary;
 820   int                 addresses[16];
 821
 822 #ifdef __cplusplus
 823   void Clear(void)
 824   {
 825     primary = CECDEVICE_UNKNOWN;
 826     for (unsigned int iPtr = 0; iPtr < 16; iPtr++)
 827       addresses[iPtr] = 0;
 828   }
 829
 830   bool IsEmpty(void) const
 831   {
 832     return primary == CECDEVICE_UNKNOWN;
 833   }
 834
 835   uint16_t AckMask(void) const
 836   {
 837     uint16_t mask = 0;
 838     for (unsigned int iPtr = 0; iPtr < 16; iPtr++)
 839       if (addresses[iPtr] == 1)
 840         mask |= 0x1 << iPtr;
 841     return mask;
 842   }
 843
 844   void Set(cec_logical_address address)
 845   {
 846     if (primary == CECDEVICE_UNKNOWN)
 847       primary = address;
 848
 849     addresses[(int) address] = 1;
 850   }
 851
 852   void Unset(cec_logical_address address)
 853   {
 854     if (primary == address)
 855       primary = CECDEVICE_UNKNOWN;
 856
 857     addresses[(int) address] = 0;
 858   }
 859
 860   bool IsSet(cec_logical_address address) const { return addresses[(int) address] == 1; }
 861   bool operator[](uint8_t pos) const { return pos < 16 ? IsSet((cec_logical_address) pos) : false; }
 862 #endif
 863 } cec_logical_addresses;
 864
 865 #ifdef __cplusplus
 866 };
 867 };
 868 #endif
 869
 870 #endif /* CECTYPES_H_ */