#define CEC_DEFAULT_SETTING_SHUTDOWN_ON_STANDBY 0
#define CEC_DEFAULT_SETTING_SEND_INACTIVE_SOURCE 1
#define CEC_DEFAULT_SETTING_POWER_OFF_DEVICES_STANDBY 1
+#define CEC_DEFAULT_DEVICE_LANGUAGE "eng"
#define CEC_DEFAULT_TRANSMIT_RETRY_WAIT 500
#define CEC_DEFAULT_TRANSMIT_TIMEOUT 1000
typedef struct cec_menu_language
{
- char language[4]; /**< the iso language code */
+ char language[4]; /**< the iso language code. @bug the language code is only 3 chars long, not 4. will be changed in v2.0, because changing it now would break backwards compat */
cec_logical_address device; /**< the logical address of the device */
} cec_menu_language;
return *this;
}
- bool IsEmpty(void) const { return size == 0; }
- bool IsFull(void) const { return size == 100; }
+ bool IsEmpty(void) const { return size == 0; } /**< @return True when this packet is empty, false otherwise. */
+ bool IsFull(void) const { return size == 100; } /**< @return True when this packet is false, false otherwise. */
+
+ /*!
+ * @brief Get the byte at the requested position.
+ * @param pos The position.
+ * @return The byte, or 0 when out of bounds.
+ */
uint8_t operator[](uint8_t pos) const { return pos < size ? data[pos] : 0; }
+ /*!
+ * @brief Get the byte at the requested position.
+ * @param pos The position.
+ * @return The byte, or 0 when out of bounds.
+ */
uint8_t At(uint8_t pos) const { return pos < size ? data[pos] : 0; }
+ /*!
+ * @brief Shift the contents of this packet.
+ * @param iShiftBy The number of positions to shift.
+ */
void Shift(uint8_t iShiftBy)
{
if (iShiftBy >= size)
}
}
+ /*!
+ * @brief Push a byte to the end of this packet.
+ * @param add The byte to add.
+ */
void PushBack(uint8_t add)
{
if (size < 100)
data[size++] = add;
}
+ /*!
+ * @brief Clear this packet.
+ */
void Clear(void)
{
memset(data, 0, sizeof(data));
return *this;
}
+ /*!
+ * @brief Formats a cec_command.
+ * @param command The command to format.
+ * @param initiator The logical address of the initiator.
+ * @param destination The logical addres of the destination.
+ * @param opcode The opcode of the command.
+ * @param timeout The transmission timeout.
+ */
static void Format(cec_command &command, cec_logical_address initiator, cec_logical_address destination, cec_opcode opcode, int32_t timeout = CEC_DEFAULT_TRANSMIT_TIMEOUT)
{
command.Clear();
}
}
+ /*!
+ * @brief Push a byte to the back of this command.
+ * @param data The byte to push.
+ */
void PushBack(uint8_t data)
{
if (initiator == CECDEVICE_UNKNOWN && destination == CECDEVICE_UNKNOWN)
parameters.PushBack(data);
}
+ /*!
+ * @brief Clear this command, resetting everything to the default values.
+ */
void Clear(void)
{
initiator = CECDEVICE_UNKNOWN;
#ifdef __cplusplus
/*!
- * @deprecated
+ * @deprecated Use Clear() instead.
+ * @brief Clear this list.
*/
void clear(void) { Clear(); }
/*!
- * @deprecated
+ * @deprecated Use Add() instead.
+ * @brief Add a type to this list.
+ * @param type The type to add.
*/
void add(const cec_device_type type) { Add(type); }
+ /*!
+ * @brief Clear this list.
+ */
void Clear(void)
{
for (unsigned int iPtr = 0; iPtr < 5; iPtr++)
types[iPtr] = CEC_DEVICE_TYPE_RESERVED;
}
+ /*!
+ * @brief Add a type to this list.
+ * @param type The type to add.
+ */
void Add(const cec_device_type type)
{
for (unsigned int iPtr = 0; iPtr < 5; iPtr++)
}
}
+ /*!
+ * @brief Check whether a type is set in this list.
+ * @param type The type to check.
+ * @return True when set, false otherwise.
+ */
bool IsSet(cec_device_type type)
{
bool bReturn(false);
return bReturn;
}
+ /*!
+ * @return True when this list is empty, false otherwise.
+ */
bool IsEmpty() const
{
bool bReturn(true);
return bReturn;
}
+ /*!
+ * @brief Get the type at the requested position.
+ * @param pos The position.
+ * @return The type, or CEC_DEVICE_TYPE_RESERVED when out of bounds.
+ */
cec_device_type operator[](uint8_t pos) const { return pos < 5 ? types[pos] : CEC_DEVICE_TYPE_RESERVED; }
+
bool operator==(const cec_device_type_list &other) const
{
bool bEqual(true);
int addresses[16]; /**< the list of addresses */
#ifdef __cplusplus
+ /*!
+ * @brief Clear this list.
+ */
void Clear(void)
{
primary = CECDEVICE_UNKNOWN;
addresses[iPtr] = 0;
}
+ /*!
+ * @return True when empty, false otherwise.
+ */
bool IsEmpty(void) const
{
return primary == CECDEVICE_UNKNOWN;
}
+ /*!
+ * @brief Calculate the ack-mask for this list, the mask to use when determining whether to send an ack message or not.
+ * @return The ack-mask.
+ */
uint16_t AckMask(void) const
{
uint16_t mask = 0;
return mask;
}
+ /*!
+ * @brief Mark a logical address as 'set'
+ * @param address The logical address to add to this list.
+ */
void Set(cec_logical_address address)
{
if (primary == CECDEVICE_UNKNOWN)
addresses[(int) address] = 1;
}
+ /*!
+ * @brief Mark a logical address as 'unset'
+ * @param address The logical address to remove from this list.
+ */
void Unset(cec_logical_address address)
{
if (primary == address)
addresses[(int) address] = 0;
}
+ /*!
+ * @brief Check whether an address is set in this list.
+ * @param address The address to check.
+ * @return True when set, false otherwise.
+ */
bool IsSet(cec_logical_address address) const { return addresses[(int) address] == 1; }
+
+ /*!
+ * @brief Check whether an address is set in this list.
+ * @param pos The address to check.
+ * @return True when set, false otherwise.
+ */
bool operator[](uint8_t pos) const { return pos < 16 ? IsSet((cec_logical_address) pos) : false; }
bool operator==(const cec_logical_addresses &other) const
typedef int (CEC_CDECL* CBCecCommandType)(void *param, const cec_command &);
typedef int (CEC_CDECL* CBCecConfigurationChangedType)(void *param, const libcec_configuration &);
typedef int (CEC_CDECL* CBCecAlertType)(void *param, const libcec_alert, const libcec_parameter &);
+typedef int (CEC_CDECL* CBCecMenuStateChangedType)(void *param, const cec_menu_state newVal);
typedef struct ICECCallbacks
{
* @return 1 when ok, 0 otherwise
*/
CBCecAlertType CBCecAlert;
+
+ /*!
+ * @brief Transfer a menu state change to the client.
+ * Transfer a menu state change to the client. If the command returns 1, then the change will be processed by
+ * the busdevice. If 0, then the state of the busdevice won't be changed, and will always be kept 'activated',
+ * so keypresses are always routed.
+ * @param newVal The new value.
+ * @return 1 when this change should be processed by the CCECBusDevice, false otherwise.
+ */
+ CBCecMenuStateChangedType CBCecMenuStateChanged;
+
+#ifdef __cplusplus
+ ICECCallbacks(void) { Clear(); }
+ ~ICECCallbacks(void) { Clear(); };
+
+ void Clear(void)
+ {
+ CBCecLogMessage = NULL;
+ CBCecKeyPress = NULL;
+ CBCecCommand = NULL;
+ CBCecConfigurationChanged = NULL;
+ CBCecAlert = NULL;
+ CBCecMenuStateChanged = NULL;
+ }
+#endif
} ICECCallbacks;
typedef enum cec_client_version
CEC_CLIENT_VERSION_1_5_2 = 0x1502,
CEC_CLIENT_VERSION_1_5_3 = 0x1503,
CEC_CLIENT_VERSION_1_6_0 = 0x1600,
- CEC_CLIENT_VERSION_1_6_1 = 0x1601
+ CEC_CLIENT_VERSION_1_6_1 = 0x1601,
+ CEC_CLIENT_VERSION_1_6_2 = 0x1602
} cec_client_version;
typedef enum cec_server_version
uint16_t iFirmwareVersion; /*!< the firmware version of the adapter. added in 1.6.0 */
uint8_t bPowerOffDevicesOnStandby; /*!< put devices in standby when the PC/player is put in standby. added in 1.6.0 */
uint8_t bShutdownOnStandby; /*!< shutdown this PC when the TV is switched off. only used when bPowerOffOnStandby = 0. added in 1.6.0 */
+ char strDeviceLanguage[3]; /*!< the menu language used by the client. 3 character ISO 639-2 country code. see http://http://www.loc.gov/standards/iso639-2/ */
#ifdef __cplusplus
+ libcec_configuration(void) { Clear(); }
+ ~libcec_configuration(void) { Clear(); }
+
+ /*!
+ * @brief Reset this configution struct to the default values.
+ */
void Clear(void)
{
memset(strDeviceName, 0, 13);
logicalAddresses.Clear();
iFirmwareVersion = CEC_FW_VERSION_UNKNOWN;
bPowerOffDevicesOnStandby = CEC_DEFAULT_SETTING_POWER_OFF_DEVICES_STANDBY;
+ memcpy(strDeviceLanguage, CEC_DEFAULT_DEVICE_LANGUAGE, 3);
callbackParam = NULL;
callbacks = NULL;