Technical Information

Transcription

1 Technical Information MOTOROLA G24 DEVELOPER S GUIDE AT COMMANDS REFERENCE MANUAL Title Page ENGLISH JUNE 29, V28-C

2 SPECIFICATIONS SUBJECT TO CHANGE WITHOUT NOTICE Notice While reasonable efforts have been made to assure the accuracy of this document, Motorola, Inc. assumes no liability resulting from any inaccuracies or omissions in this document, or from use of the information obtained herein. The information in this document has been carefully checked and is believed to be entirely reliable. However, no responsibility is assumed for inaccuracies or omissions. Motorola, Inc. reserves the right to make changes to any products described herein and reserves the right to revise this document and to make changes from time to time in content hereof with no obligation to notify any person of revisions or changes. Motorola, Inc. does not assume any liability arising out of the application or use of any product, software, or circuit described herein; neither does it convey license under its patent rights or the rights of others. It is possible that this publication may contain references to, or information about Motorola products (machines and programs), programming, or services that are not announced in your country. Such references or information must not be construed to mean that Motorola intends to announce such Motorola products, programming, or services in your country. Copyrights This instruction manual, and the Motorola products described in this instruction manual may be, include or describe copyrighted Motorola material, such as computer programs stored in semiconductor memories or other media. Laws in the United States and other countries preserve for Motorola and its licensors certain exclusive rights for copyrighted material, including the exclusive right to copy, reproduce in any form, distribute and make derivative works of the copyrighted material. Accordingly, any copyrighted material of Motorola and its licensors contained herein or in the Motorola products described in this instruction manual may not be copied, reproduced, distributed, merged or modified in any manner without the express written permission of Motorola. Furthermore, the purchase of Motorola products shall not be deemed to grant either directly or by implication, estoppel, or otherwise, any license under the copyrights, patents or patent applications of Motorola, as arises by operation of law in the sale of a product. Computer Software Copyrights The Motorola and 3rd Party supplied Software (SW) products described in this instruction manual may include copyrighted Motorola and other 3rd Party supplied computer programs stored in semiconductor memories or other media. Laws in the United States and other countries preserve for Motorola and other 3rd Party supplied SW certain exclusive rights for copyrighted computer programs, including the exclusive right to copy or reproduce in any form the copyrighted computer program. Accordingly, any copyrighted Motorola or other 3rd Party supplied SW computer programs contained in the Motorola products described in this instruction manual may not be copied (reverse engineered) or reproduced in any manner without the express written permission of Motorola or the 3rd Party SW supplier. Furthermore, the purchase of Motorola products shall not be deemed to grant either directly or by implication, estoppel, or otherwise, any license under the copyrights, patents or patent applications of Motorola or other 3rd Party supplied SW, except for the normal non-exclusive, royalty free license to use that arises by operation of law in the sale of a product. VENDOR COPYRIGHT Apache Software Foundation - Copyright All Rights Reserved Usage and Disclosure Restrictions License Agreements The software described in this document is the property of Motorola, Inc. and its licensors. It is furnished by express license agreement only and may be used only in accordance with the terms of such an agreement. Copyrighted Materials Software and documentation are copyrighted materials. Making unauthorized copies is prohibited by law. No part of the software or documentation may be reproduced, transmitted, transcribed, stored in a retrieval system, or translated into any language or computer language, in any form or by any means, without prior written permission of Motorola, Inc. High Risk Materials Components, units, or third-party products used in the product described herein are NOT fault-tolerant and are NOT designed, manufactured, or intended for use as on-line control equipment in the following hazardous environments requiring fail-safe controls: the operation of Nuclear Facilities, Aircraft Navigation or Aircraft Communication Systems, Air Traffic Control, Life Support, or Weapons Systems (High Risk Activities"). Motorola and its supplier(s) specifically disclaim any expressed or implied warranty of fitness for such High Risk Activities.

3 Trademarks MOTOROLA and the Stylized M Logo are registered in the US Patent & Trademark Office. All other product or service names are the property of their respective owners. Copyright 2006 Motorola, Inc. Copyright, Trademarks and Disclaimer REV052604

4

5 Table of Contents Manual Scope xix Target Audience xix Manual Organization xix Applicable Documents xx Contact Us xx Text Conventions xx Manual Banner Definitions xxi Field Service xxi General Safety xxi Caring for the Environment xxii Limitation of Liability xxiii Warranty Notification xxiii How to Get Warranty Service? xxiv Claiming xxiv Conditions xxv What is Not Covered by the Warranty xxv Installed Data xxvi Out of Warranty Repairs xxvi Revision History xxvii Chapter 1: Product Features Connectivity Interface GPRS Operation Overview Features and Benefits Technical Description (GPRS Class B Operation) CSD Operation Overview Features and Benefits Technical Description Improved OEM Features TCP/UDP IP Connection Overview TCP/IP UDP/IP Features and Benefits Technical Description Audio Overview Features and Benefits Technical Description MUX Integration Overview Features and Benefits Technical Description June 29, 2006 AT Commands Reference Manual i

6 Table of Contents Short Message Service (SMS) Overview Features Technical Description Fax Overview Features and Benefits Technical Description Character Sets ASCII Character Set Management GSM Character Set Management UCS2 Character Set Management UTF-8 Character Set Management Character Set Management AT Commands Summary Chapter 2: Introduction to AT Commands AT Commands Overview General Symbols Used in AT Commands Description General System Abbreviations AT Commands Protocol AT Commands Structure Command Structure Results Code Structure Response and Indications Structure AT Commands Protocol & Structure Configuration Command Token Types Basic Syntax Command Format S-parameters Extended Syntax Command Format Command Argument Types Numeric Constants String Constants Command Mode Types Parameter Set Command Syntax Parameter Read Command Syntax Parameter Test Command Syntax Values Range of Values Compound Range of Values Aborting Commands Core AT Commands Chapter 3: AT Commands Reference Modem ID ii AT Commands Reference Manual June 29, 2006

7 Table of Contents Subscriber Unit Identity CGMI, +GMI, +FMI, Request Manufacturer ID CGMM, +GMM, +FMM, Request Model ID CGMR, +GMR, +FMR, Request Revision CGSN, +GSN, Request Product Serial Number Identification CSCS, Select Terminal Character Set CIMI, Request IMSI CFSN, Read Factory Serial Number I, Request Identification Information CNUM, Request MSISDN(s) $, List of All Available AT Commands CLAC, List of All Available AT Commands Capability Reporting Call Control Managing a CSD (Data) Call Simple Dialing Switching From Data Mode to Command Mode Hanging Up Dialing to an Electronic Telephone Service Receiving a Data Call Call Control AT Commands D, Dial Command D>, Direct Dialing from Phone Books DL, Dial Last Number H, Hang-up Call A, Answer Incoming Call CRC, Cellular Result Codes and RING, +CRING - Incoming Call Indication CLIP, Calling Line Identification CCWA, Call Waiting Command CHLD, Call Related Supplementary Services Command CCFC, Call Forwarding Number and Conditions CLIR, Calling Line Identification Restriction CBST, Select Bearer Service Type O, Return to Online Data State &Q, Asynchronous Mode CHUP, Hang Up Call CSNS, Single Numbering Call Scheme MDC, Selection of Desired Message to Be Displayed Upon Connection of a Voice Call CTFR1, Divert an Incoming Call When User Busy MFIC, Filtering Incomming Calls Call Status Messages CPAS, Phone Activity Status CLCC, List Current Calls MCST, Call Status Messages TCLCC, List Current Calls Call Advice of Charge Commands CAOC, Advice of Charge CACM, Accumulated Call Meter CAMM, Accumulated Call Meter Maximum CPUC, Price per Unit and Currency Table CR, Service Reporting Control June 29, 2006 AT Commands Reference Manual iii

8 Table of Contents Supplementary Services CSSN, Supplementary Service Notifications CUSD, Unstructured Supplementary Service Data COLP, Connected Line Identification Presentation Phone Books and Clock Directory Access Commands CPBS, Select Phone Book Memory CPBR, Read Phone Book Entries CPBF, Find Phone Book Entries CPBW, Write Phone Book Entry CSVM, Set Voice Mail Server MDSI, Motorola Deactivate SIM Card Indication MCSN, Motorola Change Subscriber Number MPDPM, Motorola Phonebook Dynamic Percentage Memory System Date and Time Access Commands CCLK, Read/Set System Date and Time SMS SMS Commands CSMS, Select Message Service CPMS, Preferred Message Storage CMGF, Message Format CSCA, Service Center Address CSMP, Set Text Mode Parameters CSDH, Show Text Mode Parameters CNMI, New Message Indications to Terminal CNMA, New Message Acknowledgment CMTI, Unsolicited Response (New SMS-DELIVER Receipt Indication) CMT, Unsolicited Response (New SMS-DELIVER Receipt) CBM, Unsolicited Response (New CB Message Receipt) CDSI, Unsolicited Response (New SMS-STATUS-REPORT Indication) CDS, Unsolicited Response (New SMS-STATUS-REPORT Receipt) CMGL, +MMGL, List Messages CMGR, +MMGR, Read Message MMAR, Motorola Mark As Read CMSS, Send Message From Storage CMGW, Write Message to Memory CMGD, Delete Message CGSMS, Select Service for MO SMS Messages CMGS, Send SM to Network CSCB, Cell Broadcast Messages MCSAT, Motorola Control SMS Alert Tone MEGA, Gateway Address TSMSRET, Control SMS Sending Retry DCS handling Network Network Commands CSQ, Signal Strength CRLP, Radio Link Protocol CREG, Network Registration Status CGREG, GPRS Network Registration COPS, Operator Selection CPOL, Preferred Operators MFS, Motorola Frequency of Search MCI, Motorola Cell Information iv AT Commands Reference Manual June 29, 2006

9 Table of Contents Hardware Information Hardware Information Commands CBC, Battery Charger Connection CBAUD, Baud Rate Regulation IPR, Local Terminal/G24 Serial Port Rate GCAP, Request Overall Capabilities MTDTR, DTR Line Test Command MTCTS, CTS Line Test Command &K, RTS/CTS Flow Control &C, Circuit 109 Behavior &D, Circuit 108 Behavior MCWAKE, GPRS Coverage MGGIND, GSM/GPRS Service Indicator CFUN, Shut Down Phone Functionality ICF, DTE-DCE Character Framing ATS97, Antenna Diagnostic MRST, Perform Hard Reset TWUS, Wakeup Reason Set TWUR, Wakeup Reason Request TASW, Antenna Switch TADIAG, Query Antennas ADC Value READY, Unsolicited Notification (UART Ready Indication) MIOC, Motorola I/O Configure MIOD, Motorola I/O Define MMAD, Query and Monitor ADC Value Audio Scope Audio Setup Basic Audio Setup Advanced Audio Setup General Audio Commands Basic Audio Setup Commands CRSL, Call Ringer Level CLVL, Loudspeaker Volume CMUT, Mute/Unmute Currently Active Microphone Path S94, Sidetone Effect S96, Echo Canceling Advanced Audio Setup Commands MAPATH, Audio Path MAVOL, Volume Setting MAMUT, Input Devices Mute MAFEAT, Features Selection General Audio Commands MADIGITAL, Analog/Digital Audio Switching CALM, Alert Sound Mode MMICG, Microphone Gain Value CRTT, Ring Type Selection VTD, Tone Duration VTS, Command-Specific Tone Duration Access June 29, 2006 AT Commands Reference Manual v

10 Table of Contents Access Control Commands A/, Repeat Last Command AT, Check AT Communication CPIN, Enter PIN for Unlocking SIM Card or Enter PUK for Unblocking SIM Card EPIN, Enter SIM PIN2 to Verify PIN2 Indicator TPIN, Query Number of Remaining SIM PIN/PUK Entering Attempts CPWD, Change Password CLCK, Facility Lock EMPC, Unlocking or Locking Subsidy Code Modem Configuration and Profile Modem Register Commands V, G24 Response Format Q, Result Code Suppression E, Command Echo X, Result Code Selection and Call Progress Monitoring Control S, Bit Map Registers \S, Show the Status of the Commands and S-registers in Effect \G, Software Control \J, Terminal Auto Rate \N, Link Type CBAND, Change Radio Band ?, Return the Value of the Last Updated S-register &F, Set to Factory Defined Configuration Z, Reset to Default Configuration Sleep Mode Commands Sleep Mode AT Commands Sleep Mode HW Signals S24, Set Number of Seconds Delay Before G24 Enters Sleep Mode S102, Set Delay Before Sending Data to the Terminal S100, Set Minimum Time for Terminal to Fall into Sleep Mode MSCTS, Enable/Disable CTS During Wakeup Period Error Handling Commands CMEE, Report Mobile Equipment Error CEER, Extended Error Report UI (User Interface) CRSM, Restricted SIM Access &V, View Configuration &W, Store User Profile &Y, Default User Profile CKPD, Keypad Control MKPD, Auxiliary Keypad Control CMER, Mobile Equipment Event Reporting CLAN, ME Language CIND, Indicator Control Unsolicited UI Status Messages CKEV, Key Press Echo Output CDEV, Change Display Indication CIEV, Indicator Event Reporting MUPB, Phone Book Event GPRS/EDGE GPRS Functionality vi AT Commands Reference Manual June 29, 2006

11 Table of Contents GPRS Commands CGCLASS, GPRS Mobile Station Class CGDCONT, Define PDP Context CGQMIN, Quality of Service Profile (Min Acceptable) CGQREQ, Quality of Service Profile (Requested) CGATT, GPRS Attach or Detach D*99, Request GPRS Service "D" CGPRS, GPRS Coverage CGACT, PDP Context Activate or Deactivate EDGE Commands CGEQREQ, EDGE Quality of Service Profile (requested) CGEQMIN, (Minimum acceptable) CGEQNEG - (Negotiated) TCP/IP MIPCALL, Create a Wireless Link MIPOPEN, Open a Socket (UDP or TCP) MIPCLOSE, Close a Socket MIPSETS, Set Size for Automatic Push MIPSEND, Send Data MIPPUSH, Push Data into Protocol Stack MIPFLUSH, Flush Data from Buffers MIPRUDP, Receive Data from UDP Protocol Stack MIPRTCP, Receive Data from TCP Protocol Stack MIPSTAT, Status Report MIPXOFF, Flow Control - Xoff MIPXON, Flow Control - Xon MIPCONF - Configure Internal TCP/IP stack MPING, Start Ping Execution (ICMP Protocol) MPINGSTAT, Status Update for +MPING Execution NOP - Compatible IGNORED (Compatible Only) Commands Fax Class Fax Commands FCLASS, Select Mode FTS, Transmit Silence FRS, Receive Silence FTM, Transmit Data FRM, Receive Data FTH, Transmit DATA with HDLC Frame FRH, Receive DATA with HDLC Frame IFC, Terminal-G24 Local Flow Control FPR, Fax Serial Port Rate RS232 Multiplexer Feature MUX Details Protocol Versions System Overview Product Architecture MUX States Overview MUX-Init State MUX State Supported Protocol Services UART Flow Control MUX UART Port Speed CMUX, MUX Startup Command June 29, 2006 AT Commands Reference Manual vii

12 Table of Contents MUX Modes MUX Customer Open Source Code Packet APIs MUX Channels (Information Data Link Control - IDLC) Basic MUX Channel Definitions Channel Priorities Multiple Channel Configuration AT Commands per Channel Configuration Multiple Channel Definitions GPRS Definitions IDLC Modem Profile in MUX State Chapter 4: Using the Commands Setting Up the G24 (Power On and Initial Actions) Recommended G24 Initialization after Powerup RS232 Lines Setup Test G24 Communication Basic Configuration SIM Card Status G24 Network Connection Terminal Synchronization SMS Managing Stored Messages in the G24 Memory Setting the Notification Indication for Incoming Messages (Using AT+CNMI) Another Possible Option for Setting the CNMI Notification Indication Setting TEXT Mode Parameters (Using AT+CMGW and AT+CMGS) Writing, Saving and Sending Messages (Using AT+CMGW and AT+CMSS) Sending Messages (Using AT+CMGS) Deleting Messages (Using AT+CMGD) Call Control Dialing Using ATD Direct Dialing from Phone Book Dialing the Last Number Example Voice Call Manipulations Call Waiting Call Forwarding Conference Call Data Call Switching Modes (Data Mode/Command Mode) GPRS Establishing GPRS PDP Context Activating a Saved Profile in G Two Ways to Activate PDP Context Changing the Character Set Sleep Mode TCP/IP TCP Data Transfer Example Multi-point Data Transfer Example Xoff and Xon Example Error in Reopening a Valid Socket Audio Scenarios for Setting Up Handset Mode or Handsfree Mode Handset Mode Handsfree Mode viii AT Commands Reference Manual June 29, 2006

13 Table of Contents Chapter 5: Tools Tools Overview PC Driver Overview Fax Communication by Standard bps Modem Using WinFAX Establishing GPRS PDP Context (Using GPRS Manager) Installing GPRS Manager on a PC Configuring a Dialer Icon Establishing a Connection Appendix A: Reference Tables A-1 AT Commands Alphabetical Summary A-1 Character Set Table CS1: (GSM -> UCS-2) A-19 Character Set Table CS2: (ASCII <-> UTF-8) A-23 Character Set Table CS3: (UCS-2 <-> UTF-8) A-23 Character Set Table CS6: (UCS-2 Full table) A-23 Character Set Table CS7: (ASCII table) a-23 Appendix B: MUX B-1 PREMUX State B-1 MUX-Init State B-1 MUX State B-2 Software Procedures Related to RS232 HW Lines B-2 RI Hardware Line B-2 DCD Hardware Line B-2 DTR Hardware Line B-2 G24 DTR Interrupt B-2 DSR Hardware Line (Optional) B-2 MUX UART Port Speed B-3 Controlling the UART Port Speed Within MUX State B-3 Basic Mode UART Software Flow Control B-3 Advanced Mode UART Software Flow Control B-3 MUX Modes B-4 Advance Mode Transparency Mechanism B-4 Advance Mode Frame Packing B-4 Advance Mode Frame Unpacking B-5 MUX State Procedures B-5 UIH Frames B-6 Test UIH Control Frames B-6 MSC UIH Control Frame Virtual Channel V.24 signals B-6 UIH Control Frame Aggregate Flow Control B-8 MUX Customer Packet B-8 MUX Customer Open Source Code Packet B-8 APIs B-9 MUX Open Service B-11 MUX Close Service B-11 Data Transfer B-11 June 29, 2006 AT Commands Reference Manual ix

14

15 List of Figures Figure No. Figure Title Page No. 1-1 System Overview Sidetone Echo Suppression G24 with Multiplexer Support Capabilities AT Commands Protocol Basic Structure of a Command Line Response to a Command Line Flow and Structure Configuration Commands Audio Modes Basic Audio Setup Advanced Audio Setup Analog/Digital Switching Audio Paths G24 Audio Gain SIM States Wakeup-In Line Wake up Outline Sleep Mode when S24 > G24 Lines when S24 > G24 with and without MUX PREMUX Architecture Current MUX Architecture MUX States Two-channel Configuration Four-Channel Configuration Using the Additional UART Phone State Transactions Detailed Phone State Transactions Recommended G24 Initialization Workflow RS232 Lines Setup Test G24 Communication Basic Configuration SIM Card Status G24 Network Connection Terminal Synchronization Call States Sleep Mode when S24 > Handset or Handsfree Setup B-1 MUX Integration Packet B-9 June 29, 2006 AT Commands Reference Manual xi

16

17 List of Tables Table No. Table Title Page No. 1-1 AT Commands Core AT Commands CGSN, +GSN Parameters CSCS Parameters CNUM Parameters D Parameters D> Parameters DL Parameters CRC Parameters CLIP Parameters CCWA Parameters CHLD Parameters CHLD Actions According to Call State and Operation CCFC Parameters CLIR Parameters CBST Parameters CSNS Parameters Mapping Table (V.34) MFIC Parameters CPAS Parameters CLCC Parameters MCST Parameters TCLCC Parameters CAOC Parameters CACM Parameters CAMM Parameters CPUC Parameters CR Parameters CSSN Parameters CSSI Notification Values CSSU Notification Values CUSD Parameters CUSD Termination Cause Table Index COLP Parameters CPBS Parameters CPBR Parameters CPBF Parameters CPBW Parameters CSVM Parameters MDSI Parameters MCSN Parameters June 29, 2006 AT Commands Reference Manual xiii

18 List of Tables Table No. Table Title Page No MPDPM Parameters CCLK Parameters CSMS Parameters CPMS Parameters CMGF Parameters CSCA Input Characters and Hexadecimal Values CSCA Parameters CSMP Parameters VP Relative Format (In Integer Frmat) CSDH Parameters CNMI Parameters CMTI Parameters CMT Parameters CBM Parameters CDSI Parameters CDS Parameters CGML/+MMGL Parameters CGMR/+MMGR Parameters Layout of SMS-DELIVER in PDU Mode (according to GSM03.40) <fo> for SMS-DELIVER Message Layout of SMS-STATUS-REPORT in PDU Mode (according to GSM03.40) <fo> for SMS-STATUS-REPORT Message <TP-PI> for SMS-STATUS-REPORT Message MMAR Parameters CMSS Parameters CMGW Parameters Layout of SMS-SUBMIT in PDU Mode: (according to GSM03.40) Layout of SMS-COMMAND in PDU Mode: (according to GSM03.40) <fo> for SMS-SUBMIT Message <fo> for SMS-COMMAND Message CMGD Parameters CGSMS Parameters CMGS Parameters CSCB Parameters MCSAT Parameters MEGA Parameters TSMSRET Parameters <dcs> field and +CSCS settings conversion when writing SM <dcs> field and +CSCS settings conversion when reading SM CSQ Parameters CRLP Parameters CREG Parameters CGREG Parameters COPS Parameters CPOL Parameters MFS Parameters MCI Parameters CBC Parameters CBAUD Parameters IPR Parameters MTDTR Parameters &K Parameters xiv AT Commands Reference Manual June 29, 2006

19 List of Tables Table No. Table Title Page No &C Parameters &D Parameters MCWAKE Parameters MGGIND Parameters CFUN Parameters ICF Parameters ATS97 Parameters TWUS Parameters TASW Parameters TADIAG Parameters MIOC Parameters MIOD Parameters Keypad GPIOs MMAD Parameters Basic and Advanced Audio Modes Comparison CRSL Parameters CLVL Parameters CMUT Parameters ATS94 and ATS96 Behavior S94 Parameters ATS96 and ATS94 Behavior S96 Parameters MAPATH Parameters MAVOL Parameters MAMUT Parameters MAFEAT Parameters MADIGITAL Parameters CALM Parameters MMICG Parameters CRTT Parameters VTD Parameters VTS Parameters SIM Card Errors CPIN Parameters EPIN Parameters TPIN Parameters CPWD Parameters CLCK Parameters EMPC Parameters Effects of Parameter Settings V Parameters Qn Parameters En Parameters X Parameters S2 Parameters S12 Parameters &F Parameters Z Parameters S24 Parameters S102 Parameters Command parameters MSCTS Parameters June 29, 2006 AT Commands Reference Manual xv

20 List of Tables Table No. Table Title Page No CMEE Parameters CME Errors CMS Errors CEER Parameters CRSM Parameters &W Parameters Profile Parameters &Y Parameters CKPD Parameters Character Codes MKPD Parameters CMER Parameters CLAN Parameters CIND Parameters CKEV Parameters CDEV Parameters CIEV Parameters MUPB Parameters CGCLASS Parameters CGDCONT Parameters CGQMIN Parameters CGQREQ Parameters CGATT Parameters D*99 Parameters GPRS Parameters CGACT Parameters CGEQREQ Command Parameters CGEQMIN Command Parameters CGEQNEG Command Parameters MIPCALL Parameters MIPOPEN Parameters MIPCLOSE Parameters MIPSETS Parameters MIPSEND Parameters MIPPUSH Parameters MIPFLUSH Parameters MIPRUDP Parameters MIPRTCP Parameters MIPSTAT Parameters MIPCONF Parameters MPING Command Parameters MPING Unsolicited Response Parameters MPINGSTAT Unsolicited Response Parameters FCLASS Parameters FTS Parameters FRS Parameters Command Modulation Select Codes - Modulation Parameters Command Modulation Select Codes -Modulation Parameters Command Modulation Select Codes - Modulation Parameters <DCE_by_DTE> and <DTE_by_DCE> Parameters FPR Parameter CMUX Parameters xvi AT Commands Reference Manual June 29, 2006