X-Git-Url: https://git.piment-noir.org/?a=blobdiff_plain;f=include%2FCECExportsC.h;h=359b0e6d7a8431e552e49ad715dd6ac3eec932c8;hb=ddb76c470aa282f59064c8e2ffe20a0785463167;hp=19706f468f93ddd70f607072c03a0aec79204428;hpb=390b42d67f9c62486ee6d1b9fb57927c9cd4dafc;p=deb_libcec.git diff --git a/include/CECExportsC.h b/include/CECExportsC.h index 19706f4..359b0e6 100644 --- a/include/CECExportsC.h +++ b/include/CECExportsC.h @@ -45,32 +45,47 @@ extern "C" { * @param iPhysicalAddress The physical address of this device. 0x1000 by default. * @return True when initialised, false otherwise. */ - #ifdef __cplusplus -extern DECLSPEC bool cec_init(const char *strDeviceName, CEC::cec_logical_address iLogicalAddress = CEC::CECDEVICE_PLAYBACKDEVICE1, int iPhysicalAddress = CEC_DEFAULT_PHYSICAL_ADDRESS); +extern DECLSPEC bool cec_init(const char *strDeviceName, CEC::cec_logical_address iLogicalAddress = CEC::CECDEVICE_PLAYBACKDEVICE1, uint16_t iPhysicalAddress = CEC_DEFAULT_PHYSICAL_ADDRESS); #else -extern DECLSPEC bool cec_init(const char *strDeviceName, cec_logical_address iLogicalAddress = CECDEVICE_PLAYBACKDEVICE1, int iPhysicalAddress = CEC_DEFAULT_PHYSICAL_ADDRESS); +extern DECLSPEC bool cec_init(const char *strDeviceName, cec_logical_address iLogicalAddress = CECDEVICE_PLAYBACKDEVICE1, uint16_t iPhysicalAddress = CEC_DEFAULT_PHYSICAL_ADDRESS); #endif +/*! + * @brief Unload the CEC adapter library. + */ +extern DECLSPEC void cec_destroy(void); + /*! * @brief Open a connection to the CEC adapter. * @param strPort The path to the port. * @param iTimeout Connection timeout in ms. * @return True when connected, false otherwise. */ -extern DECLSPEC bool cec_open(const char *strPort, int iTimeout); +extern DECLSPEC bool cec_open(const char *strPort, uint32_t iTimeout); /*! * @brief Close the connection to the CEC adapter. - * @param iTimeout Timeout in ms */ -extern DECLSPEC bool cec_close(int iTimeout); +extern DECLSPEC void cec_close(void); + +/*! + * @brief Try to find all connected CEC adapters. Only implemented on Linux at the moment. + * @param deviceList The vector to store device descriptors in. + * @param strDevicePath Optional device path. Only adds device descriptors that match the given device path. + * @return The number of devices that were found, or -1 when an error occured. + */ +#ifdef __cplusplus +extern DECLSPEC int8_t cec_find_adapters(CEC::cec_adapter *deviceList, uint8_t iBufSize, const char *strDevicePath = NULL); +#else +extern DECLSPEC int8_t cec_find_adapters(cec_adapter *deviceList, uint8_t iBufSize, const char *strDevicePath = NULL); +#endif /*! * @brief Ping the CEC adapter. * @return True when the ping was succesful, false otherwise. */ -extern DECLSPEC bool cec_ping(void); +extern DECLSPEC bool cec_ping_adapters(void); /*! * @brief Start the bootloader of the CEC adapter. @@ -79,13 +94,14 @@ extern DECLSPEC bool cec_ping(void); extern DECLSPEC bool cec_start_bootloader(void); /*! - * @depcrecated Use cec_standby_devices() instead + * @return Get the minimal version of libcec that this version of libcec can interface with. */ -#ifdef __cplusplus -extern DECLSPEC bool cec_power_off_devices(CEC::cec_logical_address address = CEC::CECDEVICE_BROADCAST); -#else -extern DECLSPEC bool cec_power_off_devices(cec_logical_address address = CECDEVICE_BROADCAST); -#endif +extern DECLSPEC int8_t cec_get_min_version(void); + +/*! + * @return Get the version of libcec. + */ +extern DECLSPEC int8_t cec_get_lib_version(void); /*! * @brief Power on the connected CEC capable devices. @@ -161,9 +177,9 @@ extern DECLSPEC bool cec_get_next_command(cec_command *command); * @return True when the data was sent and acked, false otherwise. */ #ifdef __cplusplus -extern DECLSPEC bool cec_transmit(const CEC::cec_frame &data, bool bWaitForAck = true); +extern DECLSPEC bool cec_transmit(const CEC::cec_command &data, bool bWaitForAck = true); #else -extern DECLSPEC bool cec_transmit(const cec_frame &data, bool bWaitForAck = true); +extern DECLSPEC bool cec_transmit(const cec_command &data, bool bWaitForAck = true); #endif /*! @@ -177,36 +193,6 @@ extern DECLSPEC bool cec_set_logical_address(CEC::cec_logical_address iLogicalAd extern DECLSPEC bool cec_set_logical_address(cec_logical_address myAddress, cec_logical_address targetAddress); #endif -/*! - * @deprecated Use cec_set_logical_address() instead. - * @brief Set the ack mask of the CEC adapter. - * @param iMask The cec adapter's ack mask. - * @return True when the ack mask was sent succesfully, false otherwise. - */ -extern DECLSPEC bool cec_set_ack_mask(uint16_t iMask); - -/*! - * @return Get the minimal version of libcec that this version of libcec can interface with. - */ -extern DECLSPEC int cec_get_min_version(void); - -/*! - * @return Get the version of libcec. - */ -extern DECLSPEC int cec_get_lib_version(void); - -/*! - * @brief Try to find all connected CEC adapters. Only implemented on Linux at the moment. - * @param deviceList The vector to store device descriptors in. - * @param strDevicePath Optional device path. Only adds device descriptors that match the given device path. - * @return The number of devices that were found, or -1 when an error occured. - */ -#ifdef __cplusplus -extern DECLSPEC int cec_find_devices(std::vector &deviceList, const char *strDevicePath = NULL); -#else -extern DECLSPEC int cec_find_devices(std::vector &deviceList, const char *strDevicePath = NULL); -#endif - #ifdef __cplusplus }; #endif