|
Linux SDK (lite-fw)
MBPL_SDK_R25_ENG3
|
The lite-fw module allows for Firmware Download operation for EM919x devices. More...
Files | |
| file | lite-fw.h |
Data Structures | |
| struct | image_node |
| struct | _userOptions |
| struct | _litefw_FirmwareInfo_ |
Typedefs | |
| typedef struct image_node | image_node_t |
| typedef struct _litefw_FirmwareInfo_ | litefw_FirmwareInfo |
| typedef void(* | litefwlogger) (uint8_t lvl, const char *buff) |
The lite-fw module allows for Firmware Download operation for EM919x devices.
The Firmware Download application lite-fw-download included in this SDK is a working sample that demonstrates how to perform a Firmware Download operation for EM919x devices.
Overview of the lite-fw-download functionality:
| typedef struct image_node image_node_t |
Image list file name
| full_file_name |
|
| next |
|
| typedef struct _litefw_FirmwareInfo_ litefw_FirmwareInfo |
This structure contains information of the response parameters associated with a Read Transparent API.
| szModelid_str |
|
| szFwversion_str |
|
| szSku_str |
|
| szPackageid_str |
|
| szCarrier_str |
|
| szCarrierPriversion_str |
|
| typedef void(* litefwlogger) (uint8_t lvl, const char *buff) |
This function is the Custom Log prototype.
| [in] | lvl |
|
| [in] | buff |
|
| enum fwdwl_modem_mode |
| enum fwdwl_modem_states |
| enum fwdwl_type |
Error codes for applications
| enum litefw_Fw_Type |
litefw internal error codes
| enum litefw_Models |
| int check_dev_family | ( | struct _userOptions * | pUserOption | ) |
This API checks device chip set family.
| [in] | pUserOption |
|
| bool find_adapter_path | ( | struct _userOptions * | user_opt_data | ) |
This API finds device adapter path
| [in] | user_opt_data |
|
| int FWVersionAfterDownload | ( | struct _userOptions * | user_options | ) |
This API verify the FW download status and device images after FW download
| [in] | user_options |
|
| bool get_image_list | ( | struct _userOptions * | pUserOptData, |
| int * | num_of_images, | ||
| image_node_t ** | image_list, | ||
| bool | no_check | ||
| ) |
This API create an image list which includes all the image files from the user specified FW location folder.
| [in] | pUserOptData |
|
| [out] | num_of_images |
|
| [in,out] | image_list |
|
| [in] | no_check |
|
| int litefw_BuildAutoSimImgPrefRequest | ( | pack_fms_SetImagesPreference_t * | pack | ) |
This API build image preference request for device AUTO-SIM feature.
| [out] | pack |
|
| int litefw_BuildImagesPreferenceRequest | ( | litefw_FirmwareInfo | info, |
| pack_fms_SetImagesPreference_t * | pack, | ||
| bool | force | ||
| ) |
This API Build Image Preference Request Using Firmware Information.
| [in] | info |
|
| [out] | pack |
|
| [in] | force |
|
| int litefw_CalculateImageMask | ( | unpack_fms_SetImagesPreference_t | SetPrefRspFromModem | ) |
This API Calculate Image Mask for Firmware Download.
| [in] | SetPrefRspFromModem |
|
| bool litefw_cfg_dev_mode | ( | struct _userOptions * | pUserOptData | ) |
This API checks device mode.
| [in] | pUserOptData |
|
| int litefw_CheckValidFirmwareInfo | ( | litefw_FirmwareInfo | info | ) |
This API Check Valid Firmware Information to build Image Prefernce Request.
| [in] | info |
|
| int litefw_download | ( | struct _userOptions | userOptData | ) |
This API initiate a FW download session based on the specified user options.
| [in] | userOptData |
|
| unsigned int litefw_DownloadFW | ( | char * | pImagePath, |
| char * | szTTYPath, | ||
| int | iFWImageType, | ||
| int | image_mask, | ||
| int | iModelFamily, | ||
| int | img_list_size, | ||
| image_node_t * | img_list | ||
| ) |
This API Download Firmware.
| [in] | pImagePath |
|
| [in] | szTTYPath |
|
| [in] | iFWImageType |
|
| [in] | image_mask |
|
| [in] | iModelFamily |
|
| [in] | img_list_size |
|
| [in] | img_list |
|
| int litefw_ExtractFirmwareParametersByFile | ( | char * | fw, |
| char * | pri, | ||
| litefw_FirmwareInfo * | info | ||
| ) |
This API Extrace Firmware Parameters From FW and PRI Files specified.
| [in] | fw |
|
| [in] | pri |
|
| [out] | info |
|
| int litefw_ExtractFirmwareParametersByPath | ( | char * | pImagePath, |
| litefw_FirmwareInfo * | info, | ||
| bool * | bIsSpkImg | ||
| ) |
This API Extrace Firmware Parameters From Path.
| [in] | pImagePath |
|
| [out] | info |
|
| [out] | bIsSpkImg |
|
| int litefw_ExtractImageParamsByFile | ( | char * | img, |
| litefw_FirmwareInfo * | info | ||
| ) |
This API extracts the image info of the specified image
| [in] | img |
|
| [out] | info |
|
| int litefw_getFileType | ( | char * | szPath | ) |
This API Get File Type By Path
| [in] | szPath |
|
| int litefw_getFwDownloadType | ( | char * | szPath | ) |
This API Get Firmware Download Type By Path
| [in] | szPath |
|
| int litefw_GetModelFamily | ( | char * | pModelString | ) |
This API Get Model Famliy from a model string.
| [in] | pModelString |
|
| int litefw_GetQTLDownloadMode | ( | ) |
This API Get QDL port donwload mode.
| int litefw_GetQTLHWFlowControl | ( | ) |
This API Get QDL port Hardware flow control.
| char* litefw_GetVersion | ( | ) |
This API Get Lib SDP Version.
| void litefw_logsenable | ( | int | log_en | ) |
This function enables/disables lite firmware debug logs.
| [in] | log_en |
|
| int litefw_set_log_func | ( | logger | func | ) |
This API Set Custom Log function.
| [in] | func |
|
| int litefw_SetQTLDownloadMode | ( | int | iMode | ) |
This API set QDL port donwload mode.
| [in] | iMode |
|
| int litefw_SetQTLHWFlowControl | ( | int | iMode | ) |
This API Set QDL port Hardware flow control.
| [in] | iMode |
| void litefw_SetReadBlockSize | ( | unsigned long | lBlockSize | ) |
This API Set Read BlockSize.
| [in] | lBlockSize |
|
| int litefw_switch_9x07_to_downloadmode | ( | char * | szTTYPath | ) |
This API switch 9x07 modem to download mode.
| [in] | szTTYPath |
|
| int litefw_switch_to_BootHoldMode | ( | char * | szTTYPath | ) |
This API switch modem to boot hold modem via QDL port.
| [in] | szTTYPath |
|
| bool locate_adapter_path | ( | struct _userOptions * | user_opt_data | ) |
This API locate modem network adapter device path
| [in] | user_opt_data |
|
| bool locate_qdl_path | ( | struct _userOptions * | user_opt_data | ) |
This API locate modem QDL port device path
| [in] | user_opt_data |
|
| void print_hex | ( | void * | pBuffer, |
| int | bufSize, | ||
| bool | read | ||
| ) |
This function prints pBuffer in hex format.
| [in] | pBuffer |
|
| [in] | bufSize |
|
| [in] | read |
|
| int ResetModem | ( | ) |
This API reset device
| int SendImagesPreference | ( | pack_fms_SetImagesPreference_t | pack_request, |
| unpack_fms_SetImagesPreference_t * | pSetPrefRspFromModem, | ||
| struct _userOptions * | pUserOption | ||
| ) |
This API sends image preferences to device for image switching type of FW download.
| [in] | pack_request |
|
| [out] | pSetPrefRspFromModem |
|
| [in] | pUserOption |
|
| int SetFirmwarePref | ( | unpack_dms_SetFirmwarePreference_t * | pSetFirmwarePref | ) |
This API switch device to download mode for non image switching type of FW download
| [out] | pSetFirmwarePref |
|
| int VerifyAutoSimImageSwitch | ( | struct _userOptions * | user_options | ) |
This API verify the device AUTO-SIM based image switch feature
| [in] | user_options |
|