namespace CEC {
#endif
-//default physical address 1.0.0.0, HDMI port 1
+/*!
+ * default physical address 1.0.0.0, HDMI port 1
+ */
#define CEC_DEFAULT_PHYSICAL_ADDRESS 0x1000
+/*!
+ * default HDMI port to which the adapter is connected, port 1
+ */
#define CEC_DEFAULT_HDMI_PORT 1
+/*!
+ * default logical address of the device to which the adapter is connected, TV
+ */
#define CEC_DEFAULT_BASE_DEVICE 0
-#define MSGSTART 0xFF
-#define MSGEND 0xFE
-#define MSGESC 0xFD
-#define ESCOFFSET 3
+
+/*!
+ * timeout in milliseconds to send a key release event after receiving a key press
+ */
#define CEC_BUTTON_TIMEOUT 500
+
+/*!
+ * don't send the same key twice within this timeout in milliseconds
+ */
+#define CEC_DOUBLE_TAP_TIMEOUT_MS 200
+
+/*!
+ * don't query the power state for the same device within this timeout in milliseconds
+ */
#define CEC_POWER_STATE_REFRESH_TIME 30000
+
+/*!
+ * unknown firmware version value
+ */
#define CEC_FW_VERSION_UNKNOWN 0xFFFF
+
+/*!
+ * unknown build date value
+ */
#define CEC_FW_BUILD_UNKNOWN 0
+
+/*!
+ * maximum number of retries when opening a connection
+ */
#define CEC_CONNECT_TRIES 3
+/*!
+ * physical address of the TV
+ */
#define CEC_PHYSICAL_ADDRESS_TV 0
+
+/*!
+ * minimum physical address for the adapter
+ */
#define CEC_MIN_PHYSICAL_ADDRESS 0x1000
+
+/*!
+ * maximum physical address for the adapter
+ */
#define CEC_MAX_PHYSICAL_ADDRESS 0xFFFE
+
+/*!
+ * invalid physical address value
+ */
#define CEC_INVALID_PHYSICAL_ADDRESS 0xFFFF
+/*!
+ * minimum vendor ID value
+ */
#define CEC_MIN_VENDORID 1
+
+/*!
+ * maximum vendor ID value
+ */
#define CEC_MAX_VENDORID 0xFFFFFE
+
+/*!
+ * invalid vendor ID value
+ */
#define CEC_INVALID_VENDORID 0xFFFFFF
+/*!
+ * minimum HDMI port number value
+ */
#define CEC_MIN_HDMI_PORTNUMBER 1
+
+/*!
+ * maximum HDMI port number value
+ */
#define CEC_MAX_HDMI_PORTNUMBER 15
+
+/*!
+ * invalid HDMI port number value
+ */
#define CEC_HDMI_PORTNUMBER_NONE 0
+/*!
+ * default value for settings "use tv menu language"
+ */
#define CEC_DEFAULT_SETTING_USE_TV_MENU_LANGUAGE 1
+
+/*!
+ * default value for settings "activate source"
+ */
#define CEC_DEFAULT_SETTING_ACTIVATE_SOURCE 1
+
+/*!
+ * default value for settings "power off on shutdown"
+ */
#define CEC_DEFAULT_SETTING_POWER_OFF_SHUTDOWN 1
+
+/*!
+ * default value for settings "power off when activating the screensaver"
+ */
#define CEC_DEFAULT_SETTING_POWER_OFF_SCREENSAVER 1
+
+/*!
+ * default value for settings "power off on standby"
+ */
#define CEC_DEFAULT_SETTING_POWER_OFF_ON_STANDBY 1
+
+/*!
+ * default value for settings "shutdown on standby"
+ */
#define CEC_DEFAULT_SETTING_SHUTDOWN_ON_STANDBY 0
+
+/*!
+ * default value for settings "send inactive source when stopping"
+ */
#define CEC_DEFAULT_SETTING_SEND_INACTIVE_SOURCE 1
+
+/*!
+ * default value for settings "power off devices when going to standby"
+ */
#define CEC_DEFAULT_SETTING_POWER_OFF_DEVICES_STANDBY 1
+
+/*!
+ * default value for settings "device menu language"
+ */
#define CEC_DEFAULT_DEVICE_LANGUAGE "eng"
+
+/*!
+ * default value for settings "autodetect physical address"
+ */
#define CEC_DEFAULT_SETTING_AUTODETECT_ADDRESS 0
+
+/*!
+ * default value for settings "get settings from ROM"
+ */
#define CEC_DEFAULT_SETTING_GET_SETTINGS_FROM_ROM 0
+
+/*!
+ * default value for settings "libCEC CEC version"
+ */
#define CEC_DEFAULT_SETTING_CEC_VERSION 0x05
+/*!
+ * wait this amount of milliseconds before retrying to send a failed message
+ */
#define CEC_DEFAULT_TRANSMIT_RETRY_WAIT 500
+
+/*!
+ * transmission fails when not acked within this amount of milliseconds after sending the initial packet
+ */
#define CEC_DEFAULT_TRANSMIT_TIMEOUT 1000
+
+/*!
+ * wait this amount of milliseconds for an ack
+ */
#define CEC_DEFAULT_TRANSMIT_WAIT 1000
+
+/*!
+ * default number of retries
+ */
#define CEC_DEFAULT_TRANSMIT_RETRIES 1
+/*!
+ * default connection timeout in milliseconds
+ */
#define CEC_DEFAULT_CONNECT_TIMEOUT 10000
+
+/*!
+ * wait this amount of milliseconds before retrying when failing to connect
+ */
#define CEC_DEFAULT_CONNECT_RETRY_WAIT 1000
+
+/*!
+ * default serial baudrate
+ */
#define CEC_SERIAL_DEFAULT_BAUDRATE 38400
+
+/*!
+ * maximum time to wait when clearing input
+ */
#define CEC_CLEAR_INPUT_DEFAULT_WAIT 1000
-#define CEC_ACTIVE_SOURCE_SWITCH_RETRY_TIME_MS 5000
+/*!
+ * wait this amount of milliseconds before retrying when libCEC failed to make itself the active source
+ */
+#define CEC_ACTIVE_SOURCE_SWITCH_RETRY_TIME_MS 1000
+
+/*!
+ * don't forward any power off command to the client application for this amount of milliseconds after sending a power off command
+ */
#define CEC_FORWARD_STANDBY_MIN_INTERVAL 10000
+/*!
+ * the virtual device path to use for the Raspberry Pi's CEC wire
+ */
#define CEC_RPI_VIRTUAL_PATH "Raspberry Pi"
+
+/*!
+ * the name of the virtual COM port to use for the Raspberry Pi's CEC wire
+ */
#define CEC_RPI_VIRTUAL_COM "RPI"
-#define CEC_MIN_LIB_VERSION 1
-#define CEC_LIB_VERSION_MAJOR 1
-#define CEC_LIB_VERSION_MAJOR_STR "1"
-#define CEC_LIB_VERSION_MINOR 9
+/*!
+ * the path to use for the TDA995x's CEC wire
+ */
+#define CEC_TDA995x_PATH "/dev/hdmicec"
+
+/*!
+ * the name of the virtual COM port to use for the TDA995x's CEC wire
+ */
+#define CEC_TDA995x_VIRTUAL_COM "CuBox"
+
+/*!
+ * Mimimum client version
+ */
+#define CEC_MIN_LIB_VERSION 2
+
+/*!
+ * libCEC's major version number
+ */
+#define CEC_LIB_VERSION_MAJOR 2
+
+/*!
+ * libCEC's major version number as string
+ */
+#define CEC_LIB_VERSION_MAJOR_STR "2"
+
+/*!
+ * libCEC's minor version number
+ */
+#define CEC_LIB_VERSION_MINOR 0
+
+#define MSGSTART 0xFF
+#define MSGEND 0xFE
+#define MSGESC 0xFD
+#define ESCOFFSET 3
+
typedef enum cec_abort_reason
{
- CEC_ABORT_REASON_UNRECOGNIZED_OPCODE = 0,
- CEC_ABORT_REASON_NOT_IN_CORRECT_MODE_TO_RESPOND = 1,
- CEC_ABORT_REASON_CANNOT_PROVIDE_SOURCE = 2,
- CEC_ABORT_REASON_INVALID_OPERAND = 3,
- CEC_ABORT_REASON_REFUSED = 4
+ CEC_ABORT_REASON_UNRECOGNIZED_OPCODE = 0,//!< CEC_ABORT_REASON_UNRECOGNIZED_OPCODE
+ CEC_ABORT_REASON_NOT_IN_CORRECT_MODE_TO_RESPOND = 1,//!< CEC_ABORT_REASON_NOT_IN_CORRECT_MODE_TO_RESPOND
+ CEC_ABORT_REASON_CANNOT_PROVIDE_SOURCE = 2,//!< CEC_ABORT_REASON_CANNOT_PROVIDE_SOURCE
+ CEC_ABORT_REASON_INVALID_OPERAND = 3,//!< CEC_ABORT_REASON_INVALID_OPERAND
+ CEC_ABORT_REASON_REFUSED = 4 //!< CEC_ABORT_REASON_REFUSED
} cec_abort_reason;
typedef enum cec_analogue_broadcast_type
ADAPTERTYPE_UNKNOWN = 0,
ADAPTERTYPE_P8_EXTERNAL = 0x1,
ADAPTERTYPE_P8_DAUGHTERBOARD = 0x2,
- ADAPTERTYPE_RPI = 0x100
+ ADAPTERTYPE_RPI = 0x100,
+ ADAPTERTYPE_TDA995x = 0x200
} cec_adapter_type;
typedef struct cec_menu_language
CEC_CLIENT_VERSION_1_8_2 = 0x1802,
CEC_CLIENT_VERSION_1_9_0 = 0x1900,
CEC_CLIENT_VERSION_1_99_0 = 0x1990,
+ CEC_CLIENT_VERSION_2_0_0 = 0x2000,
} cec_client_version;
typedef enum cec_server_version
CEC_SERVER_VERSION_1_8_2 = 0x1802,
CEC_SERVER_VERSION_1_9_0 = 0x1900,
CEC_SERVER_VERSION_1_99_0 = 0x1990,
+ CEC_SERVER_VERSION_2_0_0 = 0x2000,
} cec_server_version;
struct libcec_configuration
uint8_t bMonitorOnly; /*!< won't allocate a CCECClient when starting the connection when set (same as monitor mode). added in 1.6.3 */
cec_version cecVersion; /*!< CEC spec version to use by libCEC. defaults to v1.4. added in 1.8.0 */
cec_adapter_type adapterType; /*!< type of the CEC adapter that we're connected to. added in 1.8.2 */
+ uint8_t iDoubleTapTimeoutMs; /*!< prevent double taps withing this timeout. defaults to 200ms. added in 2.0.0 */
#ifdef __cplusplus
libcec_configuration(void) { Clear(); }
bool operator==(const libcec_configuration &other) const
{
- return ( clientVersion == other.clientVersion &&
- !strncmp(strDeviceName, other.strDeviceName, 13) &&
- deviceTypes == other.deviceTypes &&
- bAutodetectAddress == other.bAutodetectAddress &&
- iPhysicalAddress == other.iPhysicalAddress &&
- baseDevice == other.baseDevice &&
- iHDMIPort == other.iHDMIPort &&
- tvVendor == other.tvVendor &&
- wakeDevices == other.wakeDevices &&
- powerOffDevices == other.powerOffDevices &&
- serverVersion == other.serverVersion &&
- bGetSettingsFromROM == other.bGetSettingsFromROM &&
- bUseTVMenuLanguage == other.bUseTVMenuLanguage &&
- bActivateSource == other.bActivateSource &&
- bPowerOffScreensaver == other.bPowerOffScreensaver &&
- bPowerOffOnStandby == other.bPowerOffOnStandby &&
- bSendInactiveSource == other.bSendInactiveSource &&
- /* libcec 1.5.3+ */
- (other.clientVersion < CEC_CLIENT_VERSION_1_5_3 || logicalAddresses == other.logicalAddresses) &&
- /* libcec 1.6.0+ */
- (other.clientVersion < CEC_CLIENT_VERSION_1_6_0 || iFirmwareVersion == other.iFirmwareVersion) &&
- (other.clientVersion < CEC_CLIENT_VERSION_1_6_0 || bPowerOffDevicesOnStandby == other.bPowerOffDevicesOnStandby) &&
- (other.clientVersion < CEC_CLIENT_VERSION_1_6_0 || bShutdownOnStandby == other.bShutdownOnStandby) &&
- /* libcec 1.6.2+ */
- (other.clientVersion < CEC_CLIENT_VERSION_1_6_2 || !strncmp(strDeviceLanguage, other.strDeviceLanguage, 3)) &&
- (other.clientVersion < CEC_CLIENT_VERSION_1_6_2 || iFirmwareBuildDate == other.iFirmwareBuildDate) &&
- /* libcec 1.6.3+ */
- (other.clientVersion < CEC_CLIENT_VERSION_1_6_3 || bMonitorOnly == other.bMonitorOnly) &&
- /* libcec 1.8.0+ */
- (other.clientVersion < CEC_CLIENT_VERSION_1_8_0 || cecVersion == other.cecVersion) &&
- /* libcec 1.8.2+ */
- (other.clientVersion < CEC_CLIENT_VERSION_1_8_2 || adapterType == other.adapterType));
+ return ( clientVersion == other.clientVersion &&
+ !strncmp(strDeviceName, other.strDeviceName, 13) &&
+ deviceTypes == other.deviceTypes &&
+ bAutodetectAddress == other.bAutodetectAddress &&
+ iPhysicalAddress == other.iPhysicalAddress &&
+ baseDevice == other.baseDevice &&
+ iHDMIPort == other.iHDMIPort &&
+ tvVendor == other.tvVendor &&
+ wakeDevices == other.wakeDevices &&
+ powerOffDevices == other.powerOffDevices &&
+ serverVersion == other.serverVersion &&
+ bGetSettingsFromROM == other.bGetSettingsFromROM &&
+ bUseTVMenuLanguage == other.bUseTVMenuLanguage &&
+ bActivateSource == other.bActivateSource &&
+ bPowerOffScreensaver == other.bPowerOffScreensaver &&
+ bPowerOffOnStandby == other.bPowerOffOnStandby &&
+ bSendInactiveSource == other.bSendInactiveSource &&
+ logicalAddresses == other.logicalAddresses &&
+ iFirmwareVersion == other.iFirmwareVersion &&
+ bPowerOffDevicesOnStandby == other.bPowerOffDevicesOnStandby &&
+ bShutdownOnStandby == other.bShutdownOnStandby &&
+ !strncmp(strDeviceLanguage, other.strDeviceLanguage, 3) &&
+ iFirmwareBuildDate == other.iFirmwareBuildDate &&
+ bMonitorOnly == other.bMonitorOnly &&
+ cecVersion == other.cecVersion &&
+ adapterType == other.adapterType &&
+ iDoubleTapTimeoutMs == other.iDoubleTapTimeoutMs);
}
bool operator!=(const libcec_configuration &other) const
baseDevice = (cec_logical_address)CEC_DEFAULT_BASE_DEVICE;
iHDMIPort = CEC_DEFAULT_HDMI_PORT;
tvVendor = (uint64_t)CEC_VENDOR_UNKNOWN;
- clientVersion = (uint32_t)CEC_CLIENT_VERSION_PRE_1_5;
- serverVersion = (uint32_t)CEC_SERVER_VERSION_PRE_1_5;
+ clientVersion = (uint32_t)CEC_CLIENT_VERSION_2_0_0;
+ serverVersion = (uint32_t)CEC_SERVER_VERSION_2_0_0;
bAutodetectAddress = 0;
bGetSettingsFromROM = CEC_DEFAULT_SETTING_GET_SETTINGS_FROM_ROM;
bUseTVMenuLanguage = CEC_DEFAULT_SETTING_USE_TV_MENU_LANGUAGE;
bMonitorOnly = 0;
cecVersion = (cec_version)CEC_DEFAULT_SETTING_CEC_VERSION;
adapterType = ADAPTERTYPE_UNKNOWN;
+ iDoubleTapTimeoutMs = CEC_DOUBLE_TAP_TIMEOUT_MS;
memset(strDeviceName, 0, 13);
deviceTypes.Clear();