Huawei MU736 HSPA+ M.2 Connection Manual

Huawei MU736 HSPA+ M.2 Connection Manual

Connection management api
Hide thumbs Also See for MU736 HSPA+ M.2:

Advertisement

Quick Links

HUAWEI MU736 HSPA+ M.2 Module
Connection Management API
Issue
01
Date
2013-03-12

Advertisement

Table of Contents
loading

Summary of Contents for Huawei MU736 HSPA+ M.2

  • Page 1 HUAWEI MU736 HSPA+ M.2 Module Connection Management API Issue Date 2013-03-12...
  • Page 2 E-mail: mobile@huawei.com Please refer color and shape to product. Huawei reserves the right to make changes or improvements to any of the products without prior notice. Copyright © Huawei Technologies Co., Ltd. 2013. All rights reserved. No part of this document may be reproduced or transmitted in any form or by any means without prior written consent of Huawei Technologies Co., Ltd.
  • Page 3 HUAWEI MU736 HSPA+ M.2 Module Connection Management API About This Document About This Document Revision History Document Date Chapter Descriptions Version 2013-03-12 Creation Huawei Proprietary and Confidential Issue 01(2013-03-12) Copyright © Huawei Technologies Co., Ltd.
  • Page 4: Table Of Contents

    HUAWEI MU736 HSPA+ M.2 Module Connection Management API Contents Contents 1 HW Connection Management API .................... 6 1.1 Overview ............................6 1.2 Call Blocking and Prohibited Blocked Function Calls ..............6 1.3 Common Types ..........................6 1.3.1 Return Codes .......................... 6 1.3.2 Radio Interfaces ........................
  • Page 5 HUAWEI MU736 HSPA+ M.2 Module Connection Management API Contents 1.9.4 SetByteTotalsCallback ......................25 1.9.5 SetDeviceRemovalCallback ....................26 1.10 HW Diagnostics API Functions ....................27 1.10.1 HWDIAGGetPortIDs ......................27 1.10.2 HWDIAGConnect ........................ 27 1.10.3 HWDIAGDisconnect ......................28 1.11 GPS API Functions ........................28 1.11.1 GetPDSState........................
  • Page 6: Hw Connection Management Api

    HUAWEI MU736 HSPA+ M.2 Module Connection Management API HW Connection Management API HW Connection Management API 1.1 Overview The HW Connection Management (CM) interfaces allow applications to communicate with HW’s WWAN device. The functions exposed through the HW CM API are described in this chapter.
  • Page 7: Radio Interfaces

    HUAWEI MU736 HSPA+ M.2 Module Connection Management API HW Connection Management API Value Description General error Internal error Memory error Invalid argument Buffer too small Unable to detect device Invalid device ID No connection to device Unable to obtain required interace...
  • Page 8: Band Classes

    HUAWEI MU736 HSPA+ M.2 Module Connection Management API HW Connection Management API Table 1-2 Radio interface technologies Value Radio interface technology of the signal being measured No service CDMA 1xRTT CDMA 1xEV-DO UMTS 1.3.3 Band Classes The list of band classes is shown as in Table 1-3 .
  • Page 9: Power Modes

    HUAWEI MU736 HSPA+ M.2 Module Connection Management API HW Connection Management API 1.3.4 Power Modes The list of operating power modes is shown as in Table 1-4. Table 1-4 Power modes Value Power Online Low power mode Offline Reset Persistent low power mode 1.4 Device Connectivity Service...
  • Page 10: Wwandisconnect

    HUAWEI MU736 HSPA+ M.2 Module Connection Management API HW Connection Management API Prototype ULONG WWANConnect(); 1.4.2 WWANDisconnect Description This function disconnects from a previously connected WWAN device and releases SDK’s Dlls. This function must be called before the app is terminated.
  • Page 11: Wireless Data Service

    HUAWEI MU736 HSPA+ M.2 Module Connection Management API HW Connection Management API 1.5 Wireless Data Service Table 1-6 Wireless data service functions Function names Description GetIPAddress Return the current data session IPv4 address. Return the Rx/Tx byte counts since the start of the GetByteTotals current packet data session.
  • Page 12: Getsessionduration

    HUAWEI MU736 HSPA+ M.2 Module Connection Management API HW Connection Management API ULONGLONG * pRXTotalBytes); Parameters Type Variable Mode Description ULONGLONG * pTXTotalBytes Bytes transmitted without error ULONGLONG * pRXTotalBytes Bytes received without error 1.5.3 GetSessionDuration Description This function returns the duration of the current packet data session.
  • Page 13: Initiatedomainattach

    HUAWEI MU736 HSPA+ M.2 Module Connection Management API HW Connection Management API 1.6.2 InitiateDomainAttach Description This function initiates a PS domain attached or detached. Function timeout 30 sec The function returns result in a 1 sec timeout added to 30 sec.
  • Page 14 HUAWEI MU736 HSPA+ M.2 Module Connection Management API HW Connection Management API BYTE nameSize, CHAR * pName); Parameters Type Variable Mode Description ULONG * pRegistrationState OUT Registration state 0 – Not registered  1 – Registered  2 – Searching/not registered ...
  • Page 15: Getnetworkpreference

    HUAWEI MU736 HSPA+ M.2 Module Connection Management API HW Connection Management API Type Variable Mode Description WORD * pMCC Mobile country code 0xFFFF – Unknown Note: Applicable only for UMTS networks. WORD * pMNC Mobile network code 0xFFFF – Unknown Note: Applicable only for UMTS networks.
  • Page 16 HUAWEI MU736 HSPA+ M.2 Module Connection Management API HW Connection Management API Parameters Type Variable Mode Description ULONG * pTechnologyPref Bit field representing active radio technology preference; settings are in effect if Duration=Power cycle  Technology (2 bits, bits 0 to 1) 0 –...
  • Page 17: Device Management Service

    HUAWEI MU736 HSPA+ M.2 Module Connection Management API HW Connection Management API Type Variable Mode Description pPersistentTechnol Bit field representing persistent ULONG * ogyPref radio technology preference; settings are in effect if Duration=Persistent Technology (2 bits, bits 0 to 1) ...
  • Page 18: Gethardwarerevision

    HUAWEI MU736 HSPA+ M.2 Module Connection Management API HW Connection Management API 1.7.1 GetHardwareRevision Description This function returns the hardware revision of the device. Function timeout 30 sec The function returns result in a 1 sec timeout added to 30 sec.
  • Page 19: Getpower

    HUAWEI MU736 HSPA+ M.2 Module Connection Management API HW Connection Management API 1.7.3 GetPower Description This function returns the operating mode of the device. Function timeout 30 sec The function returns result in a 1 sec timeout added to 30 sec.
  • Page 20: Wwangetstoreinfo

    HUAWEI MU736 HSPA+ M.2 Module Connection Management API HW Connection Management API Function timeout 2 sec The function returns result in a 1 sec timeout to 2 sec. Prototype ULONG WWANGetCurrentBand( ULONG * CurrentBandClass, ULONG * CurrentCenterFrequency); Parameters Type Variable...
  • Page 21: Firmware Management Service

    HUAWEI MU736 HSPA+ M.2 Module Connection Management API HW Connection Management API 1.8 Firmware Management Service Table 1-9 Firmware management service functions Function names Description GetFirmwareInfo Return the information obtained from the current device firmware. 1.8.1 GetFirmwareInfo Description This function returns the image information obtained from the current device firmware.
  • Page 22: Callback Functions

    HUAWEI MU736 HSPA+ M.2 Module Connection Management API HW Connection Management API 1.9 Callback Functions Table 1-10 Callback functions Function names Description SetDataBearerCallback Enable/disable data bearer status callback function. SetRoamingIndicatorCallback Enable/disable roaming indicator callback function. SetSignalStrengthCallback Enable/disable signal strength callback function.
  • Page 23: Setroamingindicatorcallback

    HUAWEI MU736 HSPA+ M.2 Module Connection Management API HW Connection Management API Callback parameters Type Variable Mode Description ULONG dataBearerTechnology Data bearer technology 1 – CDMA 1xRTT  2 – CDMA 1xEV-DO Rev 0  3 – GPRS  4 – WCDMA ...
  • Page 24: Setsignalstrengthcallback

    HUAWEI MU736 HSPA+ M.2 Module Connection Management API HW Connection Management API Callback parameters Type Variable Mode Description ULONG roaming Roaming indicator 0 – Roaming  1 – Home  2 – Roaming partner  >2 – Operator defined values ...
  • Page 25: Setbytetotalscallback

    HUAWEI MU736 HSPA+ M.2 Module Connection Management API HW Connection Management API Type Variable Mode Description Signal threshold array for INT8 * pThresholds each entry (in dBm); must be 0 when disabling the callback Callback prototype void SignalStrengthCallback( INT8 signalStrength, ULONG radioInterface);...
  • Page 26: Setdeviceremovalcallback

    HUAWEI MU736 HSPA+ M.2 Module Connection Management API HW Connection Management API Type Variable Mode Description Interval in seconds (ignored BYTE interval when disabling) Callback prototype void ByteTotalsCallback( ULONGLONG txTotalBytes, ULONGLONG rxTotalBytes); Callback parameters Type Variable Mode Description ULONGLONG txTotalBytes...
  • Page 27: Hw Diagnostics Api Functions

    HUAWEI MU736 HSPA+ M.2 Module Connection Management API HW Connection Management API 1.10 HW Diagnostics API Functions Table 1-11 HW diagnostics API functions Function names Description HWDIAGGetPortIDs Get available port IDs. Connect to the module’s diagnostics port. HWDIAGConnect HWDIAGDisconnect Disconnect from the device diagnostics port.
  • Page 28: Hwdiagdisconnect

    HUAWEI MU736 HSPA+ M.2 Module Connection Management API HW Connection Management API Prototype ULONG SDKCMAPI HWDIAGConnect(BYTE portID); Parameters Type Variable Mode Description BYTE portID Port ID to connect to 1.10.3 HWDIAGDisconnect Description This function disconnects the HW diagnostics API from the currently connected port.
  • Page 29: Getportautomatictracking

    HUAWEI MU736 HSPA+ M.2 Module Connection Management API HW Connection Management API Prototype ULONG GetPDSState( ULONG * pEnabledStatus, ULONG * pTrackingStatus); Parameters Type Variable Mode Description ULONG * pEnabledStatus GPS enabled status 0 – Disabled  1 – Enabled ...
  • Page 30: Setportautomatictracking

    HUAWEI MU736 HSPA+ M.2 Module Connection Management API HW Connection Management API 1.11.3 SetPortAutomaticTracking Description This function sets the automatic tracking configuration for the NMEA COM port . Function timeout 30 sec The function returns result in a 1 sec timeout added to 30 sec.
  • Page 31: Acronyms And Abbreviations

    HUAWEI MU736 HSPA+ M.2 Module Connection Management API Acronyms and Abbreviations Acronyms and Abbreviations Acronym or Abbreviation Expansion AGPS Assisted Global Positioning System AMPS Advanced Mobile Phone System Application Programming Interface CDMA Code Division Multiple Access EDGE Enhanced Data Rate for GSM Evolution...

Table of Contents