Lists the different callbacks that can be used during OTA updates.
Callbacks of type tpfOtaNotifCb and tpfOtaUpdateCb should be passed onto m2m_ota_init at system initialization. Other callbacks are provided to handle the various steps of Host File Download.
|
typedef void(* | tpfFileEraseCb )(uint8 u8Status) |
| A callback executed when the file erase has been completed. More...
|
|
typedef void(* | tpfFileGetCb )(uint8 u8Status, uint8 u8Handler, uint32 u32Size) |
| A callback to notify the application of the result of the download (success/fail), the generated handler ID and the size of the file which has just finished downloading (size expressed in bytes). More...
|
|
typedef void(* | tpfFileReadCb )(uint8 u8Status, void *pBuff, uint32 u32Size) |
| A callback to handle a buffer of data after requesting a Host File read. The callback will provide the status of the read operation and if successful, a pointer to a valid placeholder containing the data read and the amount of data available. Such callback is required when using Host File read via the HIF. More...
|
|
typedef void(* | tpfOtaNotifCb )(tstrOtaUpdateInfo *pstrOtaUpdateInfo) |
| A callback to get notification about a potential OTA update. More...
|
|
typedef void(* | tpfOtaUpdateCb )(uint8 u8OtaUpdateStatusType, uint8 u8OtaUpdateStatus) |
| A callback to get OTA status update, the callback provides the status type and its status.
The OTA callback provides the download status, the switch to the downloaded firmware status, roll-back status and Host File Download status. More...
|
|
void(* tpfFileEraseCb)(uint8 u8Status) |
A callback executed when the file erase has been completed.
- Parameters
-
A callback to notify the application of the result of the download (success/fail), the generated handler ID and the size of the file which has just finished downloading (size expressed in bytes).
- Parameters
-
[in] | u8Status | Status of the operation (see tenuOtaUpdateStatus). |
[in] | u8Handler | Generated handler ID for the new file. |
[in] | u32Size | Total size of the downloaded file (in bytes). |
- Warning
- The file handler passed onto this callback will be the valid file handler generated by the WINC when the download finished successfully. This handler will be required for all operations on the file like read and erase.
void(* tpfFileReadCb)(uint8 u8Status, void *pBuff, uint32 u32Size) |
A callback to handle a buffer of data after requesting a Host File read. The callback will provide the status of the read operation and if successful, a pointer to a valid placeholder containing the data read and the amount of data available. Such callback is required when using Host File read via the HIF.
- Parameters
-
[in] | u8Status | Status of the operation (see tenuOtaUpdateStatus). |
[in] | pBuff | Pointer to a placeholder where the data can be retrieved from. |
[in] | u32Size | Amount of data available after reading (in bytes). |
- Warning
- After the callback is executed, pBuff will be freed.
A callback to get notification about a potential OTA update.
- Parameters
-
[in] | pstrOtaUpdateInfo | A structure to provide notification payload. |
- See Also
- tstrOtaUpdateInfo
- Warning
- The notification is not supported (Not implemented yet)
void(* tpfOtaUpdateCb)(uint8 u8OtaUpdateStatusType,uint8 u8OtaUpdateStatus) |
A callback to get OTA status update, the callback provides the status type and its status.
The OTA callback provides the download status, the switch to the downloaded firmware status, roll-back status and Host File Download status.
- Parameters
-
- Note
- Executes other callbacks passed to the OTA module.
- See Also
- tenuOtaUpdateStatusType tenuOtaUpdateStatus