cec: cleanups, documentation and some fixes for the last commits
[deb_libcec.git] / src / lib / adapter / USBCECAdapterCommands.h
index b88651e11619dfe5456074d43010f04853ceaf19..d961240fc13c3ca282c53a5c41545792505f004c 100644 (file)
@@ -57,14 +57,14 @@ namespace CEC
      * @param configuration The configuration to persist.
      * @return True when persisted, false otherwise.
      */
-    bool PersistConfiguration(libcec_configuration *configuration);
+    bool PersistConfiguration(const libcec_configuration &configuration);
 
     /*!
      * @brief Get the persisted configuration from the EEPROM.
      * @param configuration The persisted configuration.
      * @return True when retrieved, false otherwise.
      */
-    bool GetConfiguration(libcec_configuration *configuration);
+    bool GetConfiguration(libcec_configuration &configuration);
 
     /*!
      * @brief Send a ping command to the adapter.
@@ -100,6 +100,12 @@ namespace CEC
      */
     bool SetControlledMode(bool controlled);
 
+    /*!
+     * @brief Request the firmware build date from the device.
+     * @return The build date in seconds since epoch, or 0 when no (valid) reply was received.
+     */
+    uint32_t RequestBuildDate(void);
+
   private:
     /*!
      * @brief Reads all settings from the eeprom.
@@ -218,5 +224,6 @@ namespace CEC
     uint16_t                     m_iSettingLAMask;         /**< the value of the LA mask setting */
     bool                         m_bNeedsWrite;            /**< true when we sent changed settings to the adapter that have not been persisted */
     libcec_configuration         m_persistedConfiguration; /**< the configuration that is persisted in the eeprom */
+    uint32_t                     m_iBuildDate;             /**< the build date of the firmware */
   };
 }