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 |
|