IDS peak genericC++ v1.10.0
Loading...
Searching...
No Matches
Public Types | Public Member Functions | Friends | List of all members
peak::core::FirmwareUpdateProgressObserver Class Reference

Allows to observe a firmware update process. More...

#include <peak/device/peak_firmware_update_progress_observer.hpp>

Public Types

using UpdateStartedCallback
 
using UpdateStartedCallbackHandle = UpdateStartedCallback*
 
using UpdateStepStartedCallback
 
using UpdateStepStartedCallbackHandle = UpdateStepStartedCallback*
 
using UpdateStepProgressChangedCallback
 
using UpdateStepProgressChangedCallbackHandle = UpdateStepProgressChangedCallback*
 
using UpdateStepFinishedCallback = std::function<void(FirmwareUpdateStep updateStep)>
 
using UpdateStepFinishedCallbackHandle = UpdateStepFinishedCallback*
 
using UpdateFinishedCallback = std::function<void(void)>
 
using UpdateFinishedCallbackHandle = UpdateFinishedCallback*
 
using UpdateFailedCallback = std::function<void(const std::string& errorDescription)>
 
using UpdateFailedCallbackHandle = UpdateFailedCallback*
 

Public Member Functions

 FirmwareUpdateProgressObserver ()
 
 ~FirmwareUpdateProgressObserver ()
 
 FirmwareUpdateProgressObserver (const FirmwareUpdateProgressObserver &other)=delete
 
FirmwareUpdateProgressObserver & operator= (const FirmwareUpdateProgressObserver &other)=delete
 
 FirmwareUpdateProgressObserver (FirmwareUpdateProgressObserver &&other)=delete
 
FirmwareUpdateProgressObserver & operator= (FirmwareUpdateProgressObserver &&other)=delete
 
UpdateStartedCallbackHandle RegisterUpdateStartedCallback (UpdateStartedCallback callback)
 Registers a callback for signaling a started update.
 
void UnregisterUpdateStartedCallback (UpdateStartedCallbackHandle callbackHandle)
 Unregisters an update started callback.
 
UpdateStepStartedCallbackHandle RegisterUpdateStepStartedCallback (UpdateStepStartedCallback callback)
 Registers a callback for signaling a started update step.
 
void UnregisterUpdateStepStartedCallback (UpdateStepStartedCallbackHandle callbackHandle)
 Unregisters an update step started callback.
 
UpdateStepProgressChangedCallbackHandle RegisterUpdateStepProgressChangedCallback (UpdateStepProgressChangedCallback callback)
 Registers a callback for signaling progress in an update step.
 
void UnregisterUpdateStepProgressChangedCallback (UpdateStepProgressChangedCallbackHandle callbackHandle)
 Unregisters an update step progress changed callback.
 
UpdateStepFinishedCallbackHandle RegisterUpdateStepFinishedCallback (UpdateStepFinishedCallback callback)
 Registers a callback for signaling a finished update step.
 
void UnregisterUpdateStepFinishedCallback (UpdateStepFinishedCallbackHandle callbackHandle)
 Unregisters an update step finished callback.
 
UpdateFinishedCallbackHandle RegisterUpdateFinishedCallback (UpdateFinishedCallback callback)
 Registers a callback for signaling a finished update.
 
void UnregisterUpdateFinishedCallback (UpdateFinishedCallbackHandle callbackHandle)
 Unregisters an update finished callback.
 
UpdateFailedCallbackHandle RegisterUpdateFailedCallback (UpdateFailedCallback callback)
 Registers a callback for signaling a failed update.
 
void UnregisterUpdateFailedCallback (UpdateFailedCallbackHandle callbackHandle)
 Unregisters an update failed callback.
 

Friends

class FirmwareUpdater
 

Detailed Description

Allows to observe a firmware update process.

Observe a firmware update process by registering several callbacks. These callbacks get called when the observer is passed to the FirmwareUpdater::UpdateDevice() function. The callbacks inform about changes of the status of the firmware update process.

Member Typedef Documentation

◆ UpdateFailedCallback

using peak::core::FirmwareUpdateProgressObserver::UpdateFailedCallback = std::function<void(const std::string& errorDescription)>

The type of update failed callbacks.

◆ UpdateFailedCallbackHandle

using peak::core::FirmwareUpdateProgressObserver::UpdateFailedCallbackHandle = UpdateFailedCallback*

The type of update failed callback handles.

◆ UpdateFinishedCallback

using peak::core::FirmwareUpdateProgressObserver::UpdateFinishedCallback = std::function<void(void)>

The type of update finished callbacks.

◆ UpdateFinishedCallbackHandle

using peak::core::FirmwareUpdateProgressObserver::UpdateFinishedCallbackHandle = UpdateFinishedCallback*

The type of update finished callback handles.

◆ UpdateStartedCallback

using peak::core::FirmwareUpdateProgressObserver::UpdateStartedCallback
Initial value:
std::function<void(
const std::shared_ptr<FirmwareUpdateInformation>& updateInformation, uint32_t estimatedDuration_ms)>

The type of update started callbacks.

◆ UpdateStartedCallbackHandle

using peak::core::FirmwareUpdateProgressObserver::UpdateStartedCallbackHandle = UpdateStartedCallback*

The type of update started callback handles.

◆ UpdateStepFinishedCallback

using peak::core::FirmwareUpdateProgressObserver::UpdateStepFinishedCallback = std::function<void(FirmwareUpdateStep updateStep)>

The type of update step finished callbacks.

◆ UpdateStepFinishedCallbackHandle

using peak::core::FirmwareUpdateProgressObserver::UpdateStepFinishedCallbackHandle = UpdateStepFinishedCallback*

The type of update step finished callback handles.

◆ UpdateStepProgressChangedCallback

using peak::core::FirmwareUpdateProgressObserver::UpdateStepProgressChangedCallback
Initial value:
std::function<void(FirmwareUpdateStep updateStep, double progressPercentage)>
peak::core::FirmwareUpdateStep
FirmwareUpdateStep
The possible firmware update step types.
Definition peak_firmware_update_progress_observer.hpp:34

The type of update step progress changed callbacks.

◆ UpdateStepProgressChangedCallbackHandle

using peak::core::FirmwareUpdateProgressObserver::UpdateStepProgressChangedCallbackHandle = UpdateStepProgressChangedCallback*

The type of update step progress changed callback handles.

◆ UpdateStepStartedCallback

using peak::core::FirmwareUpdateProgressObserver::UpdateStepStartedCallback
Initial value:
std::function<void(
FirmwareUpdateStep updateStep, uint32_t estimatedDuration_ms, const std::string& description)>

The type of update step started callbacks.

◆ UpdateStepStartedCallbackHandle

using peak::core::FirmwareUpdateProgressObserver::UpdateStepStartedCallbackHandle = UpdateStepStartedCallback*

The type of update step started callback handles.

Constructor & Destructor Documentation

◆ FirmwareUpdateProgressObserver() [1/3]

peak::core::FirmwareUpdateProgressObserver::FirmwareUpdateProgressObserver ( )
inline

◆ ~FirmwareUpdateProgressObserver()

peak::core::FirmwareUpdateProgressObserver::~FirmwareUpdateProgressObserver ( )
inline

◆ FirmwareUpdateProgressObserver() [2/3]

peak::core::FirmwareUpdateProgressObserver::FirmwareUpdateProgressObserver ( const FirmwareUpdateProgressObserver & other)
delete

◆ FirmwareUpdateProgressObserver() [3/3]

peak::core::FirmwareUpdateProgressObserver::FirmwareUpdateProgressObserver ( FirmwareUpdateProgressObserver && other)
delete

Member Function Documentation

◆ operator=() [1/2]

FirmwareUpdateProgressObserver & peak::core::FirmwareUpdateProgressObserver::operator= ( const FirmwareUpdateProgressObserver & other)
delete

◆ operator=() [2/2]

FirmwareUpdateProgressObserver & peak::core::FirmwareUpdateProgressObserver::operator= ( FirmwareUpdateProgressObserver && other)
delete

◆ RegisterUpdateFailedCallback()

FirmwareUpdateProgressObserver::UpdateFailedCallbackHandle peak::core::FirmwareUpdateProgressObserver::RegisterUpdateFailedCallback ( FirmwareUpdateProgressObserver::UpdateFailedCallback callback)
inline

Registers a callback for signaling a failed update.

Parameters
[in]callbackThe callback to call if a update has failed.
Since
1.0
Exceptions
InternalErrorExceptionAn internal error has occurred.

◆ RegisterUpdateFinishedCallback()

FirmwareUpdateProgressObserver::UpdateFinishedCallbackHandle peak::core::FirmwareUpdateProgressObserver::RegisterUpdateFinishedCallback ( FirmwareUpdateProgressObserver::UpdateFinishedCallback callback)
inline

Registers a callback for signaling a finished update.

Parameters
[in]callbackThe callback to call if a update is finished.
Since
1.0
Exceptions
InternalErrorExceptionAn internal error has occurred.

◆ RegisterUpdateStartedCallback()

FirmwareUpdateProgressObserver::UpdateStartedCallbackHandle peak::core::FirmwareUpdateProgressObserver::RegisterUpdateStartedCallback ( FirmwareUpdateProgressObserver::UpdateStartedCallback callback)
inline

Registers a callback for signaling a started update.

Parameters
[in]callbackThe callback to call if a update is started.
Since
1.0
Exceptions
InternalErrorExceptionAn internal error has occurred.

◆ RegisterUpdateStepFinishedCallback()

FirmwareUpdateProgressObserver::UpdateStepFinishedCallbackHandle peak::core::FirmwareUpdateProgressObserver::RegisterUpdateStepFinishedCallback ( FirmwareUpdateProgressObserver::UpdateStepFinishedCallback callback)
inline

Registers a callback for signaling a finished update step.

Parameters
[in]callbackThe callback to call if a update step is finished.
Since
1.0
Exceptions
InternalErrorExceptionAn internal error has occurred.

◆ RegisterUpdateStepProgressChangedCallback()

FirmwareUpdateProgressObserver::UpdateStepProgressChangedCallbackHandle peak::core::FirmwareUpdateProgressObserver::RegisterUpdateStepProgressChangedCallback ( FirmwareUpdateProgressObserver::UpdateStepProgressChangedCallback callback)
inline

Registers a callback for signaling progress in an update step.

Parameters
[in]callbackThe callback to call if progress is made in a update step.
Since
1.0
Exceptions
InternalErrorExceptionAn internal error has occurred.

◆ RegisterUpdateStepStartedCallback()

FirmwareUpdateProgressObserver::UpdateStepStartedCallbackHandle peak::core::FirmwareUpdateProgressObserver::RegisterUpdateStepStartedCallback ( FirmwareUpdateProgressObserver::UpdateStepStartedCallback callback)
inline

Registers a callback for signaling a started update step.

Parameters
[in]callbackThe callback to call if a update step is started.
Since
1.0
Exceptions
InternalErrorExceptionAn internal error has occurred.

◆ UnregisterUpdateFailedCallback()

void peak::core::FirmwareUpdateProgressObserver::UnregisterUpdateFailedCallback ( FirmwareUpdateProgressObserver::UpdateFailedCallbackHandle callbackHandle)
inline

Unregisters an update failed callback.

This function unregisters an update failed callback by taking its handle.

Parameters
[in]callbackHandleThe handle of the callback to unregister.
Since
1.0
Exceptions
InternalErrorExceptionAn internal error has occurred.

◆ UnregisterUpdateFinishedCallback()

void peak::core::FirmwareUpdateProgressObserver::UnregisterUpdateFinishedCallback ( FirmwareUpdateProgressObserver::UpdateFinishedCallbackHandle callbackHandle)
inline

Unregisters an update finished callback.

This function unregisters an update finished callback by taking its handle.

Parameters
[in]callbackHandleThe handle of the callback to unregister.
Since
1.0
Exceptions
InternalErrorExceptionAn internal error has occurred.

◆ UnregisterUpdateStartedCallback()

void peak::core::FirmwareUpdateProgressObserver::UnregisterUpdateStartedCallback ( FirmwareUpdateProgressObserver::UpdateStartedCallbackHandle callbackHandle)
inline

Unregisters an update started callback.

This function unregisters an update started callback by taking its handle.

Parameters
[in]callbackHandleThe handle of the callback to unregister.
Since
1.0
Exceptions
InternalErrorExceptionAn internal error has occurred.

◆ UnregisterUpdateStepFinishedCallback()

void peak::core::FirmwareUpdateProgressObserver::UnregisterUpdateStepFinishedCallback ( FirmwareUpdateProgressObserver::UpdateStepFinishedCallbackHandle callbackHandle)
inline

Unregisters an update step finished callback.

This function unregisters an update step finished callback by taking its handle.

Parameters
[in]callbackHandleThe handle of the callback to unregister.
Since
1.0
Exceptions
InternalErrorExceptionAn internal error has occurred.

◆ UnregisterUpdateStepProgressChangedCallback()

void peak::core::FirmwareUpdateProgressObserver::UnregisterUpdateStepProgressChangedCallback ( FirmwareUpdateProgressObserver::UpdateStepProgressChangedCallbackHandle callbackHandle)
inline

Unregisters an update step progress changed callback.

This function unregisters an update step progress changed callback by taking its handle.

Parameters
[in]callbackHandleThe handle of the callback to unregister.
Since
1.0
Exceptions
InternalErrorExceptionAn internal error has occurred.

◆ UnregisterUpdateStepStartedCallback()

void peak::core::FirmwareUpdateProgressObserver::UnregisterUpdateStepStartedCallback ( FirmwareUpdateProgressObserver::UpdateStepStartedCallbackHandle callbackHandle)
inline

Unregisters an update step started callback.

This function unregisters an update step started callback by taking its handle.

Parameters
[in]callbackHandleThe handle of the callback to unregister.
Since
1.0
Exceptions
InternalErrorExceptionAn internal error has occurred.

Friends And Related Symbol Documentation

◆ FirmwareUpdater

friend class FirmwareUpdater
friend
The documentation for this class was generated from the following file: