3、4g模塊高新興物聯(lián)welinkopen sdk api手冊(cè)_v1.3

1、ME3630Version: V13Date: 2018-04-29LTE ModuleWebsite:WelinkOpenREVISION HISTORY2VersionDateNoteV10 V112018-02-09First version2018-03-28更新SMS 枚舉類型及數(shù)據(jù)結(jié)構(gòu)新增 BSP 相關(guān) API 函數(shù)V12 V132018-04-19新增 WeFOTA 章節(jié)2018-04-29新增 gsdk_device_gpio_isr 更新文檔模板WelinkOpenCONTENTS1簡(jiǎn)介 6111213功能概述 7客戶端域 113132333435范圍 6讀者 6規(guī)范 623

2、客戶端函數(shù) 11客戶端消息標(biāo)識(shí)符 13客戶端消息結(jié)構(gòu)體 13常見(jiàn)枚舉 15常見(jiàn)的數(shù)據(jù)結(jié)構(gòu) 18設(shè)備管理（DM） 194DM 消息標(biāo)識(shí) 19DM 消息結(jié)構(gòu) 19DM 相關(guān)常量 21DM 相關(guān)枚舉 2141424344網(wǎng)絡(luò)235網(wǎng)絡(luò)消息標(biāo)識(shí)符 23網(wǎng)絡(luò)消息數(shù)據(jù)結(jié)構(gòu)體 24NW相關(guān)常量 33NW 相關(guān)枚舉 34NW數(shù)據(jù)結(jié)構(gòu) 375152535455數(shù)據(jù)業(yè)務(wù)呼叫 426數(shù)據(jù)業(yè)務(wù)消息標(biāo)識(shí)符 42數(shù)據(jù)業(yè)務(wù)消息結(jié)構(gòu)體 43數(shù)據(jù)相關(guān)常量 52Data 相關(guān)枚舉 53Data 數(shù)據(jù)結(jié)構(gòu) 596162636465SMS 6271727374757SMS消息標(biāo)識(shí)符 62SMS消息結(jié)構(gòu)體 63SMS 相關(guān)常量 68S

3、MS 相關(guān)枚舉 68SMS數(shù)據(jù)結(jié)構(gòu) 70移動(dòng)接入點(diǎn)(Mobile AP) 738Mobile AP消息標(biāo)識(shí)符 73Mobile AP消息結(jié)構(gòu)體 76Mobile AP相關(guān)常量 105Mobile Ap相關(guān)枚舉 107Mobile AP數(shù)據(jù)結(jié)構(gòu) 1098182838485Voice 11393WelinkOpenVoice 消息標(biāo)識(shí)符 113Voice消息結(jié)構(gòu)體 115Voice Constants 130Voice相關(guān)枚舉 131Voice相關(guān)數(shù)據(jù)結(jié)構(gòu) 1379192939495SIM(Subscriber Identity Module) 139101 SIM消息標(biāo)識(shí)符 139102 SIM

4、消息結(jié)構(gòu)體 140103 SIM常量 154104 SIM枚舉類型 156105 SIM數(shù)據(jù)結(jié)構(gòu) 159AT命令處理機(jī) 166111 ATCoP Message Identifiers 166112 ATCoP消息結(jié)構(gòu)體 166113 ATCoP 常量 167模塊 168101112消息體標(biāo)識(shí) 168消息體的結(jié)構(gòu) 169相關(guān)常量 179枚舉類型 181數(shù)據(jù)結(jié)構(gòu) 184121122123124125BSP相關(guān)API函數(shù) 18813gsdk_device_set_rtc_timer 188gsdk_device_get_rtc_timer 188gsdk_device_cancel_rtc_tim

5、er 188gsdk_device_force_sleep 189gsdk_mcu_wakeup_module 189gsdk_modem_wakeup_mcu 190gsdk_device_get_usb_state 190gsdk_device_set_usb_state 190gsdk_device_get_adc 191gsdk_device_conf_gpio 192gsdk_device_read_gpio 192gsdk_device_write_gpio 192131132133134135136137138139131013111312WeFOTA相關(guān)API函數(shù)及使用 194

6、141 數(shù)據(jù)類型定義 194142 函數(shù)接口定義 194143示例： 195MCM APIs使用說(shuō)明 19914A初始化MCM客戶端 199用參數(shù)初始化請(qǐng)求對(duì)象 199創(chuàng)建響應(yīng)對(duì)象并分配內(nèi)存 199A1A2 A3 A4 A5 A6 A7打200定義異步回調(diào)函數(shù) 200定義指示回調(diào)函數(shù)（可選） 201客戶端句柄 2014WelinkOpen編譯代碼 201A85WelinkOpen1簡(jiǎn)介范圍11本文了模塊ME3630支持的OpenLinux MCM(Mobile Connection Manager)接口，該接口使得Linux 應(yīng)用程序可以直接高通MDM9X07平臺(tái)提供的服務(wù)。讀者12該文檔適用

7、于使用MCM接口進(jìn)行OpenLinux開(kāi)發(fā)的軟件開(kāi)發(fā)有一定程度的了解。，并需要讀者對(duì)Linux編程規(guī)范13本文代碼變量使用尖括號(hào)包圍。例如: <number>函數(shù)參數(shù)傳遞方向如下所示：in表示該參數(shù)是輸入?yún)?shù)。out 表示該參數(shù)是輸出參數(shù)。in,out表示該參數(shù)既可以用于輸入，也可以用于輸出。6WelinkOpen功能概述2MCM是Linux用戶面的框架服務(wù)，提供了豐富的功能接口供Linux用戶程序調(diào)用，并支持多客戶端并發(fā)操作。MCM接口是基于消息機(jī)制的，客戶端程序填充MCM消息結(jié)構(gòu)（例如：建立數(shù)據(jù)撥號(hào)的消息類型），然后調(diào)用消息函數(shù)消息到MCM框架，該消息請(qǐng)求執(zhí)行完成后，MCM框架

8、執(zhí)行結(jié)果到客戶端。客戶端也可以主動(dòng)上報(bào)回調(diào)函數(shù)，MCM框架通過(guò)回調(diào)函數(shù)將上報(bào)傳給客戶端。MCM消息類型有請(qǐng)求、回復(fù)和主動(dòng)上報(bào)三種類型。消息結(jié)構(gòu)定義在C頭文件中，客戶端可以通過(guò)MCM接口。例如：mcm_data_start_data_call_req_msg 消息建立數(shù)據(jù)連接。消息類型通常帶有版本前綴便于版本控制。例如：mcm_data_start_data_call_req_msg_v01。每個(gè)消息可以通過(guò)同步或者異步的方式端線程，直到接收返回結(jié)果；調(diào)用異步函數(shù)返回。給MCM框架，區(qū)別在于，同步操作會(huì)阻塞客戶消息會(huì)立即返回。執(zhí)行結(jié)果通過(guò)回調(diào)函數(shù)客戶程序MCM 消息前，必須先調(diào)用mcm_clie

9、nt_init函數(shù)初始化獲取客戶端句柄，結(jié)束前需調(diào)用mcm_client_release函數(shù)該句柄。圖2-1說(shuō)明客戶端初始化和流程。7WelinkOpenApplicationMCMMcm_client_init(out handle,in ind_cb,in default_resp_cb)Application workmcm_client_release(handle)ApplicationMCM圖 2-1 客戶端初始化和流程客戶程序初始化時(shí)，需提供一組回調(diào)函數(shù)，MCM框架通過(guò)主動(dòng)上報(bào)回調(diào)函數(shù)通知客戶端相關(guān)信息，或者通過(guò)異步請(qǐng)求回調(diào)函數(shù)傳遞消息執(zhí)行結(jié)果給客戶程序。異步請(qǐng)求回調(diào)函數(shù)如下所示

10、：typedef void (*mcm_client_async_cb)(mcm_client_handle_type uint32void uint32 voidhndl, msg_id,*resp_c_struct, resp_len,*token_id);主動(dòng)上報(bào)回調(diào)函數(shù)如下所示：typedef void (*mcm_client_ind_cb)(mcm_client_handle_type uint32void uint32hndl, msg_id,*ind_c_struct, ind_len);8WelinkOpen參數(shù)msg_id標(biāo)識(shí)主動(dòng)上報(bào)的類型或回復(fù)結(jié)果的類型。第三個(gè)參數(shù)與該類

11、型對(duì)應(yīng)。例如，當(dāng)MCM框架調(diào)用語(yǔ)音報(bào)號(hào)請(qǐng)求(MCM_VOICE_DIAL_REQ_V01)的回調(diào)函數(shù)時(shí)，回調(diào)函數(shù)的msg_id 被設(shè)置為MCM_VOICE_DIAL_RESP_V01，而resp_c_struct (ind_c_struct for indications)是指向mcm_voice_dial_resp_msg_v01結(jié)構(gòu)的指針，該結(jié)構(gòu)的長(zhǎng)度由參數(shù)resp_len (ind_len for indications) 提供。需要注意的是：所有的回調(diào)函數(shù)由MCM框架的接收者線程調(diào)用，所以客戶程序應(yīng)該注意以下兩點(diǎn)：Note that all callbacks are called i

12、n the context of a receiver thread created by the MCM, and some restrictions apply as to what can be done by the application in that context: 客戶程序應(yīng)該避免長(zhǎng)時(shí)間阻塞回調(diào)函數(shù)，否則主動(dòng)上報(bào)或回復(fù)在回調(diào)函數(shù)返回以前不能給客戶程序 客戶程序不能在回調(diào)函數(shù)中請(qǐng)求消息可以通過(guò)以下三種方式任何請(qǐng)求，否則會(huì)導(dǎo)致死鎖：mcm_ mcm_mcm_mand_async mand_syncmand_sync_exmcm_mand_async 函數(shù)是異步處理函數(shù)，應(yīng)用程序調(diào)

13、用該函數(shù)消息時(shí)，會(huì)立即返回。該消息的執(zhí)行結(jié)果通過(guò)回調(diào)函數(shù)（如果非空）或初始化時(shí)提供的默認(rèn)回調(diào)函數(shù)返回。調(diào)用該函數(shù)時(shí)，應(yīng)該傳入請(qǐng)求消息結(jié)構(gòu)體和返回結(jié)果結(jié)構(gòu)體。消息執(zhí)行結(jié)束后，MCM填充返回結(jié)果結(jié)構(gòu)體，并通過(guò)回調(diào)函數(shù)傳給應(yīng)用程序。mcm_mand_sync 函數(shù)是同步處理函數(shù)，該調(diào)用流程會(huì)被一直阻塞，直到請(qǐng)求的消息執(zhí)行完成。mcm_該函數(shù)超時(shí)也會(huì)返回，即使請(qǐng)求消息未處理完成。mand_sync_ex函數(shù)增加超時(shí)參數(shù)，作為簡(jiǎn)化這些函數(shù)調(diào)用的下面的宏提供了更簡(jiǎn)短的調(diào)用：式，函數(shù)結(jié)構(gòu)體的每個(gè)結(jié)構(gòu)指針，必須傳入相應(yīng)的長(zhǎng)度， MCM_ MCM_ MCM_ MCM_ MCM_ MCM_MAND_ASYNCMA

14、ND_NO_PAYLOAD_ASYNCMAND_SYNCMAND_NO_PAYLOAD_SYNCMAND_SYNC_EXMAND_NO_PAYLOAD_SYNC_EX9WelinkOpensynchronoApplication圖 2-2 同步和異步語(yǔ)音撥號(hào)調(diào)用流程10WelinkOpen客戶端域3本章包含MCM面向客戶端的接口和常見(jiàn)類型。 Client Functions Client MessageIdentifiers Client Message Structures Common Enumerations Common Data Structures客戶端函數(shù)31本節(jié)包含MCM客戶端

15、函數(shù)。函數(shù)文檔311uint32 mcm_client_init ( mcm_client_handle_type hndl,3111mcm_client_ind_cbind_cb, mcm_client_async_cb default_resp_cb)初始化MCM客戶端庫(kù)。該函數(shù)在調(diào)用任何其他函數(shù)之前被調(diào)用。參數(shù)返回值MCM_SUCCESS 0 表示成功。MCM_ERROR_ 查看 3412節(jié)錯(cuò)誤返回類型。311211outhndl客戶端句柄。inind_cb主動(dòng)上報(bào)回調(diào)函數(shù)指針。indefault_resp_cb異步處理的默認(rèn)響應(yīng)回調(diào)函數(shù)指針。WelinkOpen異步一個(gè)命令到MCM框架

16、服務(wù)。參數(shù)返回值MCM_SUCCESS 0表示成功。MCM_ERROR_ 查看 3412節(jié)錯(cuò)誤返回類型。3113uint32 mcm_mand_sync( mcm_client_handle_type hndl, int msg_id, void req_c_struct, req_c_struct_len, void resp_c_struct, int resp_c_struct_len )一個(gè)命令到MCM框架服務(wù)。int同步參數(shù)返回值MCM_SUCCESS 0表示成功。MCM_ERROR_ 查看 3412節(jié)錯(cuò)誤返回類型。311412inhndl客戶端句柄。inmsg_id消息 IDinr

17、eq_c_struct命令請(qǐng)求結(jié)構(gòu)體指針。inreq_c_struct_len命令請(qǐng)求結(jié)構(gòu)體長(zhǎng)度。inresp_c_struct命令響應(yīng)結(jié)構(gòu)體指針。inresp_c_struct_len命令響應(yīng)結(jié)構(gòu)體長(zhǎng)度。inhndl客戶端句柄。inmsg_id消息 IDinreq_c_struct命令請(qǐng)求結(jié)構(gòu)體指針。inreq_c_struct_len命令請(qǐng)求結(jié)構(gòu)體長(zhǎng)度。inresp_c_struct命令響應(yīng)結(jié)構(gòu)體指針。inresp_c_struct_len命令響應(yīng)結(jié)構(gòu)體長(zhǎng)度。inasync_resp_cb異步響應(yīng)回調(diào)函數(shù)指針。intoken_idToken IDWelinkOpen同步一個(gè)命令到MCM框架

18、服務(wù)，可指定超時(shí)參數(shù)。參數(shù)返回值MCM_SUCCESS 0表示成功。MCM_ERROR_ 查看 3412節(jié)錯(cuò)誤返回類型。3115uint32 mcm_client_release ( mcm_client_handle_type hndl )客戶端句柄。參數(shù)返回值MCM_SUCCESS 0表示成功。MCM_ERROR_ 查看 3412節(jié)錯(cuò)誤返回類型。客戶端消息標(biāo)識(shí)符32本小節(jié)包含MCM客戶端消息標(biāo)識(shí)符#define MCM_CLIENT_REQUIRE_REQ_V01 0x0800#define MCM_CLIENT_REQUIRE_RESP_V01 0x0800#define MCM_CLI

19、ENT_NOT_REQUIRE_REQ_V01 0x0801#define MCM_CLIENT_NOT_REQUIRE_RESP_V01 0x0801客戶端消息結(jié)構(gòu)體3313inhndl客戶端句柄。inhndl客戶端句柄。inmsg_id消息 IDinreq_c_struct命令請(qǐng)求結(jié)構(gòu)體指針。inreq_c_struct_len命令請(qǐng)求結(jié)構(gòu)體長(zhǎng)度。inresp_c_struct命令響應(yīng)結(jié)構(gòu)體指針。inresp_c_struct_len命令響應(yīng)結(jié)構(gòu)體長(zhǎng)度。intimeout超時(shí)參數(shù)，：ms。WelinkOpen本小節(jié)包含MCM客戶端消息結(jié)構(gòu)體。數(shù)據(jù)結(jié)構(gòu)體文檔3313311struct mcm

20、_client_require_req_msg_v01請(qǐng)求消息; 所需的客戶端服務(wù)數(shù)據(jù)成員3312struct mcm_client_require_resp_msg_v01數(shù)據(jù)成員3313struct mcm_client_not_require_req_msg_v01請(qǐng)求消息; 可選的客戶端服務(wù)3314struct mcm_client_not_require_resp_msg_v01響應(yīng)消息; 可選的客戶端服務(wù)14參數(shù)mcm_response-_t_v01response響應(yīng)。參數(shù)uint16_tnot_require_- service要在設(shè)備上加載的首選服務(wù)；mcm_client_s

21、ervice_type位掩碼。參數(shù)mcm_response-_t_v01response響應(yīng)。參數(shù)uint16_trequire_service要在設(shè)備上加載的首選服務(wù)；mcm_client_service_type位掩碼。WelinkOpen常見(jiàn)枚舉34本小節(jié)包含MCM常見(jiàn)枚舉類型。枚舉類型文檔3413411enum mcm_result_t_v01MCM_RESULT_SUCCESS_V01 SuccessMCM_RESULT_FAILURE_V01 Failure3412enum mcm_error_t_v01可能的返回值。MCM_SUCCESS_V01 SuccessMCM_SUCCE

22、SS_CONDITIONAL_SUCCESS_V01 Conditional success MCM_ERROR_MCM_SERVICES_NOT_AVAILABLE_V01 MCM services not available MCM_ERROR_GENERIC_V01 Generic errorMCM_ERROR_BADPARM_V01 Bad parameter MCM_ERROR_MEMORY_V01 Memory error MCM_ERROR_INVALID_STATE_V01 Invalid state MCM_ERROR_MALFORMED_MSG_V01 Malformed

23、message MCM_ERROR_NO_MEMORY_V01 No memory MCM_ERROR_INTERNAL_V01 Internal error MCM_ERROR_ABORTED_V01 Action was abortedMCM_ERROR_CLIENT_IDS_EXHAUSTED_V01 Client IDs have been exhausted MCM_ERROR_UNABORTABLE_TRANSACTION_V01 Unabortable transaction MCM_ERROR_INVALID_CLIENT_ID_V01 Invalid client ID MC

24、M_ERROR_NO_THRESHOLDS_V01 No thresholds MCM_ERROR_INVALID_HANDLE_V01 Invalid handle MCM_ERROR_INVALID_PROFILE_V01 Invalid profile MCM_ERROR_INVALID_PINID_V01 Invalid PIN IDMCM_ERROR_INCORRECT_PIN_V01 Incorrect PIN MCM_ERROR_NO_NETWORK_FOUND_V01 No network found MCM_ERROR_CALL_FAILED_V01 Call failed

25、MCM_ERROR_OUT_OF_CALL_V01 Out of call MCM_ERROR_NOT_PROVISIONED_V01 Not provisioned MCM_ERROR_MISSING_ARG_V01 Missing argument MCM_ERROR_ARG_TOO_LONG_V01 Argument is too long MCM_ERROR_INVALID_TX_ID_V01 Invalid Tx ID MCM_ERROR_DEVICE_IN_USE_V01 Device is in useMCM_ERROR_OP_NETWORK_UNSUPPORTED_V01 OP

26、 network is not supported15WelinkOpenMCM_ERROR_OP_DEVICE_UNSUPPORTED_V01 OP device is not supportedMCM_ERROR_NO_EFFECT_V01 No effect MCM_ERROR_NO_FREE_PROFILE_V01 No free profile MCM_ERROR_INVALID_PDP_TYPE_V01 Invalid PDP typeMCM_ERROR_INVALID_TECH_PREF_V01 Invalid technical preference MCM_ERROR_INV

27、ALID_PROFILE_TYPE_V01 Invalid profile type MCM_ERROR_INVALID_SERVICE_TYPE_V01 Invalid service type MCM_ERROR_INVALID_REGISTER_ACTION_V01 Invalid register action MCM_ERROR_INVALID_PS_ATTACH_ACTION_V01 Invalid PS attach action MCM_ERROR_AUTHENTICATION_FAILED_V01 Authentication failed MCM_ERROR_PIN_BLO

28、CKED_V01 PIN is blocked MCM_ERROR_PIN_PERM_BLOCKED_V01 PIN is permanently blocked MCM_ERROR_SIM_NOT_INITIALIZED_V01 SIM is not initializedum QoS requests are in useMCM_ERROR_MAX_QOS_REQUESTS_IN_USE_V01MCM_ERROR_INCORRECT_FLOW_FILTER_V01 Incorrect flow filterMCM_ERROR_NETWORK_QOS_UNAWARE_V01 Network

29、QoS is unaware MCM_ERROR_INVALID_ID_V01 Invalid ID MCM_ERROR_INVALID_QOS_ID_V01 Invalid QoS IDMCM_ERROR_REQUESTED_NUM_UNSUPPORTED_V01 Requested number is not supportedMCM_ERROR_INTERFACE_NOT_FOUND_V01 Interface was not found MCM_ERROR_FLOW_SUSPENDED_V01 Flow is suspended MCM_ERROR_INVALID_DATA_FORMA

30、T_V01 Invalid data format MCM_ERROR_GENERAL_V01 General error MCM_ERROR_UNKNOWN_V01 Unknown error MCM_ERROR_INVALID_ARG_V01 Invalid argument MCM_ERROR_INVALID_INDEX_V01 Invalid index MCM_ERROR_NO_ENTRY_V01 No entry MCM_ERROR_DEVICE_STORAGE_FULL_V01 Device storage is full MCM_ERROR_DEVICE_NOT_READY_V

31、01 Device is not ready MCM_ERROR_NETWORK_NOT_READY_V01 Network is not ready MCM_ERROR_CAUSE_CODE_V01 Cause code error MCM_ERROR_MESSAGE_NOT_SENT_V01 Message was not sentMCM_ERROR_MESSAGE_DELIVERY_FAILURE_V01 Message delivery failure MCM_ERROR_INVALID_MESSAGE_ID_V01 Invalid message ID MCM_ERROR_ENCOD

32、ING_V01 Encoding error MCM_ERROR_AUTHENTICATION_LOCK_V01 Authentication lock error MCM_ERROR_INVALID_TRANSITION_V01 Invalid transition MCM_ERROR_NOT_A_MCAST_IFACE_V01 Not an MCast interfaceum MCast requests are in useMCM_ERROR_MAX_MCAST_REQUESTS_IN_USE_V01MCM_ERROR_INVALID_MCAST_HANDLE_V01 Invalid M

33、Cast handleMCM_ERROR_INVALID_IP_FAMILY_PREF_V01 Invalid IP family preference MCM_ERROR_SESSION_INACTIVE_V01 Session is inactive MCM_ERROR_SESSION_INVALID_V01 Session is invalid MCM_ERROR_SESSION_OWNERSHIP_V01 Session ownership error MCM_ERROR_INSUFFICIENT_RESOURCES_V01 Insufficient resources MCM_ERR

34、OR_DISABLED_V01 Disabled MCM_ERROR_INVALID_OPERATION_V01 Invalid operation16WelinkOpenMCM_ERROR_INVALID_CMD_V01 Invalid commandMCM_ERROR_TPDU_TYPE_V01 Transfer Protocol data unit type error MCM_ERROR_SMSC_ADDR_V01 Short message service center address error MCM_ERROR_INFO_UNAVAILABLE_V01 Information

35、is not available MCM_ERROR_SEGMENT_TOO_LONG_V01 Segment is too long MCM_ERROR_SEGMENT_ORDER_V01 Segment order error MCM_ERROR_BUNDLING_NOT_SUPPORTED_V01 Bundling is not supportedMCM_ERROR_OP_PARTIAL_FAILURE_V01 OP partial failure MCM_ERROR_POLICY_MISMATCH_V01 Policy mismatch MCM_ERROR_SIM_FILE_NOT_F

36、OUND_V01 SIM file was not found MCM_ERROR_EXTENDED_INTERNAL_V01 Extended internal error MCM_ERROR_ACCESS_DENIED_V01 Access is denied MCM_ERROR_HARDWARE_RESTRICTED_V01 Hardware is restricted MCM_ERROR_ACK_NOT_SENT_V01 Acknowledgement was not sent MCM_ERROR_INJECT_TIMEOUT_V01 Inject timeout errorpatib

37、le statePATIBLE_STATE_V01MCM_ERROR_FDN_RESTRICT_V01 Fixed dialing number restrict errorMCM_ERROR_SUPS_FAILURE_CAUSE_V01 SUPS failure cause MCM_ERROR_NO_RADIO_V01 No radio MCM_ERROR_NOT_SUPPORTED_V01 Not supported MCM_ERROR_NO_SUBSCRIPTION_V01 No subscription MCM_ERROR_CARD_CALL_CONTROL_FAILED_V01 Ca

38、rd call control failed MCM_ERROR_NETWORK_ABORTED_V01 Network was aborted MCM_ERROR_MSG_BLOCKED_V01 Message was blocked MCM_ERROR_INVALID_SESSION_TYPE_V01 Invalid session type MCM_ERROR_INVALID_PB_TYPE_V01 Invalid phonebook type MCM_ERROR_NO_SIM_V01 No SIM was found MCM_ERROR_PB_NOT_READY_V01 Phonebo

39、ok not ready MCM_ERROR_PIN_RESTRICTION_V01 PIN restriction MCM_ERROR_PIN2_RESTRICTION_V01 PIN2 restriction MCM_ERROR_PUK_RESTRICTION_V01 PIN unlocking key restriction MCM_ERROR_PUK2_RESTRICTION_V01 PIN unlocking key2 restrictionMCM_ERROR_PB_ACCESS_RESTRICTED_V01 Phonebook access is restricted MCM_ER

40、ROR_PB_DELETE_IN_PROG_V01 Phonebook delete is in progress MCM_ERROR_PB_TEXT_TOO_LONG_V01 Phonebook text is too long MCM_ERROR_PB_NUMBER_TOO_LONG_V01 Phonebook number is too long MCM_ERROR_PB_HIDDEN_KEY_RESTRICTION_V01 Phonebook hidden key restriction MCM_ERROR_PB_NOT_AVAILABLE_V01 Phonebook is not a

41、vailable MCM_ERROR_DEVICE_MEMORY_ERROR_V01 Device memory error MCM_ERROR_SIM_PIN_BLOCKED_V01 SIM PIN is blocked MCM_ERROR_SIM_PIN_NOT_INITIALIZED_V01 SIM PIN is not initialized MCM_ERROR_SIM_INVALID_PIN_V01 SIM PIN is invalid MCM_ERROR_SIM_INVALID_PERSO_CK_V01 SIM invalid personalization CK MCM_ERRO

42、R_SIM_PERSO_BLOCKED_V01 SIM personalization blocked MCM_ERROR_SIM_PERSO_INVALID_DATA_V01 SIM personalization contains invalid data MCM_ERROR_SIM_ACCESS_DENIED_V01 SIM access is denied MCM_ERROR_SIM_INVALID_FILE_PATH_V01 SIM file path is invalid17WelinkOpenMCM_ERROR_SIM_SERVICE_NOT_SUPPORTED_V01 SIM

43、service is not supportedMCM_ERROR_SIM_AUTH_FAIL_V01 SIM authorization failureMCM_ERROR_SIM_PIN_PERM_BLOCKED_V01 SIM PIN is permanently blocked35 常見(jiàn)的數(shù)據(jù)結(jié)構(gòu)本小節(jié)包含MCM常見(jiàn)數(shù)據(jù)結(jié)構(gòu)。數(shù)據(jù)結(jié)構(gòu)文檔3513511struct mcm_response_t_v01數(shù)據(jù)成員18參數(shù)mcm_result_t_- v01result結(jié)果碼: MCM_RESULT_SUCCESS MCM_RESULT_FAILUREmcm_error_t_- v01erro

44、r錯(cuò)誤碼。每個(gè)消息定義的錯(cuò)誤碼了可能的錯(cuò)誤代碼值。WelinkOpen設(shè)備管理（DM）4本章規(guī)定了MCM的DM模塊數(shù)據(jù)類型，用于管理移動(dòng)聯(lián)網(wǎng)設(shè)備，比如modem，融合modem 或者多modem DM 消息標(biāo)識(shí) DM 消息結(jié)構(gòu) DM相關(guān)常量 DM相關(guān)枚舉類型DM 消息標(biāo)識(shí)41本節(jié)規(guī)定了MCM DM相關(guān)的消息標(biāo)識(shí)。#define MCM_DM_GET_RADIO_MODE_REQ_V01 0x0201#define MCM_DM_GET_RADIO_MODE_RESP_V01 0x0201#define MCM_DM_SET_RADIO_MODE_REQ_V01 0x0202#define MC

45、M_DM_SET_RADIO_MODE_RESP_V01 0x0202#define MCM_DM_EVENT_REGISTER_REQ_V01 0x0203#define MCM_DM_EVENT_REGISTER_RESP_V01 0x0203#define MCM_DM_RADIO_MODE_CHANGED_EVENT_IND_V01 0x0204DM 消息結(jié)構(gòu)42本節(jié)規(guī)定了MCM DM相關(guān)的消息標(biāo)識(shí)結(jié)構(gòu)。數(shù)據(jù)結(jié)構(gòu)集4214211struct mcm_dm_get_radio_mode_resp_msg_v01結(jié)構(gòu)類型：回復(fù)；結(jié)構(gòu)功能：回復(fù)網(wǎng)絡(luò)狀態(tài)。19參數(shù)WelinkOpen4212s

46、truct mcm_dm_set_radio_mode_req_msg_v01結(jié)構(gòu)類型：請(qǐng)求；結(jié)構(gòu)功能：設(shè)置網(wǎng)絡(luò)狀態(tài)。4213struct mcm_dm_set_radio_mode_resp_msg_v01結(jié)構(gòu)類型：回復(fù)；結(jié)構(gòu)功能：網(wǎng)絡(luò)狀態(tài)設(shè)置的結(jié)果。4214struct mcm_dm_event_register_req_msg_v01結(jié)構(gòu)類型：請(qǐng)求；結(jié)構(gòu)功能：網(wǎng)絡(luò)狀態(tài)設(shè)置的結(jié)果。20參數(shù)參數(shù)mcm_response-_t_v01response結(jié)果碼uint8_tno_change_- valid如果有no_change的參數(shù)傳遞，必須設(shè)置為TRUEuint8_tno_changeNo

47、change參數(shù)mcm_dm_- radio_mode_t_- v01radio_mode要設(shè)置的網(wǎng)絡(luò)狀態(tài)mcm_response-_t_v01response結(jié)果碼uint8_tradio_mode_- valid如果有網(wǎng)絡(luò)狀態(tài)上報(bào)，必須設(shè)置為真。mcm_dm_- radio_mode_t_- v01radio_mode當(dāng)前網(wǎng)絡(luò)狀態(tài)，必須是mcm_dm_radio_mode_t_v01類型中的一種。WelinkOpen4215struct mcm_dm_event_register_resp_msg_v01結(jié)構(gòu)類型：主動(dòng)上報(bào)；結(jié)構(gòu)功能：網(wǎng)絡(luò)狀態(tài)設(shè)置的結(jié)果。4216struct mcm_dm_

48、radio_mode_changed_event_ind_msg_v0143 DM 相關(guān)常量本節(jié)規(guī)定了MCM DM功能的相關(guān)常量宏定義集4314311#define MCM_MAX_ARRAY_LIMIT_V01 252數(shù)組大小上限44 DM 相關(guān)枚舉本節(jié)規(guī)定了MCM DM 相關(guān)枚舉類型21參數(shù)uint8_tradio_mode_- valid如果有radio_mode值傳遞，此值設(shè)置為TRUE。mcm_dm_- radio_mode_t_- v01radio_mode網(wǎng)絡(luò)狀態(tài)參數(shù)mcm_response-_t_v01responseResponseuint8_tregister_radio_

49、- mode_changed-_event_valid如果有register_radio_mode_changed_event 傳過(guò)來(lái)，此項(xiàng)必須設(shè)置為TRUEuint8_tregister_radio_- mode_changed-_event網(wǎng)絡(luò)狀態(tài)變化。WelinkOpen枚舉類型集4414411enum mcm_dm_radio_mode_t_v01MCM_DM_RADIO_MODE_OFFLINE_V01 無(wú)線模塊下電或狀態(tài)未知MCM_DM_RADIO_MODE_ONLINE_V01 Radio 無(wú)線功能正常MCM_DM_RADIO_MODE_UNAVAILABLE_V01 無(wú)線功能不

50、可用22WelinkOpen網(wǎng)絡(luò)5本章包含了消息、常量、數(shù)據(jù)結(jié)構(gòu)、管理和報(bào)告 移動(dòng)網(wǎng)絡(luò)(NW)的連接,狀態(tài)和統(tǒng)計(jì)數(shù)據(jù)的枚舉類型。 Network MessageIdentifiers Network Message Structures NW Constants NW Enumerations NW Data Structures網(wǎng)絡(luò)消息標(biāo)識(shí)符51本節(jié)包含了MCM網(wǎng)絡(luò)消息標(biāo)識(shí)符：#define MCM_NW_SET_CONFIG_REQ_V01 0x0500#define MCM_NW_SET_CONFIG_RESP_V01 0x0500#define MCM_NW_GET_CONFIG_RE

51、Q_V01 0x0501#define MCM_NW_GET_CONFIG_RESP_V01 0x0501#define MCM_NW_GET_REGISTRATION_STATUS_REQ_V01 0x0502#define MCM_NW_GET_REGISTRATION_STATUS_RESP_V01 0x0502#define MCM_NW_SCAN_REQ_V01 0x0503#define MCM_NW_SCAN_RESP_V01 0x0503#define MCM_NW_GET_OPERATOR_NAME_REQ_V01 0x0504#define MCM_NW_GET_OPERA

52、TOR_NAME_RESP_V01 0x0504#define MCM_NW_SCREEN_ON_OFF_REQ_V01 0x0505#define MCM_NW_SCREEN_ON_OFF_RESP_V01 0x0505#define MCM_NW_SELECTION_REQ_V01 0x0506#define MCM_NW_SELECTION_RESP_V01 0x0506#define MCM_NW_GET_SIGNAL_STRENGTH_REQ_V01 0x050723WelinkOpen#define MCM_NW_GET_CELL_ACCESS_STATE_REQ_V01 0x05

53、08#define MCM_NW_GET_CELL_ACCESS_STATE_RESP_V01 0x0508#define MCM_NW_GET_NITZ_TIME_INFO_REQ_V01 0x0509#define MCM_NW_GET_NITZ_TIME_INFO_RESP_V01 0x0509#define MCM_NW_EVENT_REGISTER_REQ_V01 0x050A#define MCM_NW_EVENT_REGISTER_RESP_V01 0x050A#define MCM_NW_VOICE_REGISTRATION_EVENT_IND_V01 0x050B#define MCM_NW_DATA_REGISTRATION_EVENT_IND_V01 0x050C#define MCM_NW_SIGNAL_STRENGTH_EVENT_IND_V01 0x050D#define MCM_NW_CELL_ACCESS_STATE_CHANGE_EVENT_IND_V0