ETSI ETS 300 917-1998 Digital Cellular Telecommunications System (Phase 2+) GSM Application Programming Interface (GSM-API)《数字蜂窝通信系统(第2+阶段) GSM应用编程接口GSM-API) GSM 07 08(版本5 2 1)》.pdf

1、 STD-ETSI ETS 100 7L7-ENGL 1778 3400855 0300Li23 787 TAND DARD ETS 300 917 May 1998 Source: SMG Reference: DE/SMG-O40708Q ICs: 33.020 Key words: Digital cellular telecommunications system, Global System for Mobile communications (GSM) Digital cellular telecommunications system (Phase 2+); GSM Applic

2、ation Programming Interface (GSM-API) (GSM 07.08 version 5.2.1) ETSI European Telecommunications Standards Institute ETSI Secretariat Postal address: F-O6921 Sophia Antipolis CEDEX - FRANCE Office address: 650 Route des Lucioles - Sophia Antipolis - Valbonne - FRANCE Internet: secretariat Q etsi.fr

3、 http:/www.etsi.fr - http:/www.etsi.org Tel.: +33 4 92 94 42 O0 - Fax: +33 4 93 65 47 16 Copyright Notification: No part may be reproduced except as authorized by written permission. The copyright and the foregoing restriction extend to reproduction in all media. O European Telecommunications Stand

4、ards Institute 1998. All rights reserved. - STD-ETSI ETS 300 717-ENGL 1998 3900855 0300429 bL3 W Page 2 ETS 300 917 (GSM 07.08 version 5.2.1): May 1998 Whilst every care has been taken in the preparation and publication of this document, errors in content, typographical or otherwise, may occur. If y

5、ou have comments concerning its accuracy, please write to “ETSI Editing and Committee Support Dept.“ at the address shown on the title page. STD-ETSI ETS 300 9L7-ENGL 1998 3qOCl855 0300Li25 55T Page 3 ETS 300 917 (GSM 07.08 version 5.2.1): May 1998 Contents Foreword _. 7 Introduction . ._“. . 7 1 Sc

6、ope . 9 2 Normative references 9 3 Definitions and abbreviations . 11 3.1 Definitions 11 3.2 Abbreviations . 11 4 Profile A compatible part of GSM-API 11 5 Profile B compatible part of GSM-API 12 5.1 Ovewiew “ . 12 5.2 Parameter description . 12 5.2.1 5.2.2 5.2.3 5.2.4 5.2.5 5.2.6 5.2.7 5.2.8 5.2.9

7、5.2.1 O 5.2.1 1 5.2.12 5.2.13 5.2.14 5.2.15 5.2.16 5.2.17 5.2.18 5.2.19 5.2.20 5.2.21 5.2.22 5.2.23 5.2.24 5.2.25 5.2.26 5.2.27 5.2.28 5.2.29 5.2.30 5.2.31 5.2.32 5.2.33 5.2.34 5.2.35 5.2.36 5.2.37 5.2.38 5.2.39 5.2.40 Additional Info 13 B Channel Information . 13 B Protocol 14 B1 Protocol 14 82 Pro

8、tocol 15 83 Protocol 15 B1 Configuration 16 82 Configuration 16 83 Configuration 16 Called Party Number . 17 Called Party Subaddress . 18 Calling Party Number 18 Calling Party Subaddress 18 CIP Value 19 CIP mask . 22 Connected Number . 23 Connected Subaddress . 23 Control ler . 24 Data . 25 Data Len

9、gth . 25 Data Handle 25 Facility Selector . 25 Faci I i ty Request Para me ter . 26 Facility Confirmation Parameter 26 Facility Indication Parameter . 27 Facility Response Parameter 27 Flags 27 HLC . 28 Info 28 Info Element 30 Info Mask . 30 Info Number . 31 LLC 32 Manu ID . 32 Manufacturer Specific

10、 32 NCCI 33 NCP I 34 PLCI 35 Reason 35 BC . 17 STD-ETSI ETS 300 717-ENGL 1778 3i.iOO855 030042b 47b Page 4 ETS 300 917 (GSM 07.08 verslon 5.2.1): May 1998 5.2.41 Reason_B3 . 36 5.2.42 Reject 37 6 GSM specific part of GSM-API (addition to ETS 300 838profile A) 37 7 GSM specific part of GSM-API (addit

11、ion to ETC 300 838profile B) 38 7.1 Overview . “ 38 7.2 GSM specific functionality 83 7.3 Extension mechanism . 38 7.4 Registration of GSM support . 39 7.4.1 Register GSM support facility message parameter 39 7.5 Support of GSM Tele and Bearer Services . 40 7.5.1 Emergency Calls . 40 7.6 Basic GSM f

12、unctions 40 7.6.1 Facility message parameter 41 7.6.1.1 Send Short Messages . 41 7.6.1.2 Receive Short Message 42 7.6.1.3 Receive Cell Broadcast Messages . 44 7.6.1.4 In Call Modification 44 7.6.1.5 Read SIM Data 45 7.6.1.6 Update SIM Data . 47 7.6.1.7 Invalidate SIM file 48 7.6.1.8 Rehabilitate SIM

13、 file 48 7.6.1.9 Get SIM File Status . 49 7.6.1.1 O Handle PIN code . 50 7.6.1.1 1 Get available PLMNs 51 7.6.1.12 Set PLMN Mode 52 GSM Supplementary Service functions . 52 GSM Supplementary Services Parameters 53 ss-operat ion 53 7.7.3.2 Forwarding Feature . 54 Facility message parameter 54 Restric

14、t SS Information . 54 Mobile Originated SS Transaction 55 Clear Mobile Originated SS Transaction . 56 7.7 7.7.1 Overview . 52 7.7.2 7.7.3 Enable GSM Supplementary Service Functionality 53 7.7.3.1 7.7.4 7.7.4.1 7.7.4.2 7.7.4.3 7.7.4.4 Receive SS Message 57 7.7.4.5 Call Hold 57 7.7.4.6 Call Retrieve 5

15、8 7.7.4.7 Call Related Ussd . 58 7.7.4.8 Receive Call Related Facility . 59 Facility Message parameter 60 Get Service State 60 Rx Level and RX Quality 60 Get SIM Present Info 61 7.8 Extended GSM functionality 59 7.8.1 7.8.1.1 7.8.1.2 7.8.1.3 Annex A (informative): GSM Supplementary Services Message

16、flow 62 A.l Restrict SS information . 62 A.2 Mobile Originated SS transaction 62 A.3 Receive SS Message (Forward Check Indication) . 62 A.4 A.5 Mobile originated USSD . 63 Mobile terminated USSD 63 A.6 Call related USSD . 63 A.7 Call hold . 64 Page 5 ETS 300 917 (GSM 07.08 version 5.2.1): May 1998 A

17、8 Receiving a Call related Facility . 64 Annex B (informative): Change history . 65 History. ,. ,. ,. . . . , , . . . , , , , , , . . . . . . . . . . , , , . . . . , , , , , , , , . . . 66 STD-ETSI ETS 300 9L7-ENGL 1998 m 3q00855 03OOLi28 2b9 m Page 7 ETS 300 917 (GSM 07.08 version 5.2.1): May 1998

18、 Foreword This European Telecommunication Standard (ETS) has been produced by the Special Mobile Group (SMG) of the European Telecommunications Standards Institute (ETSI). This ETS defines GSM-API, the application programming interface within the digital cellular telecommunications system. The conte

19、nts of this ETS may be subject to continuing work within SMG and may change following formal SMG approval. Should SMG modify the contents of this ETS, it will be submitted for OAP by ETSI with an identifying change of release date and an increase in version number as follows: Version 5.x.y where: y

20、the third digit is incremented when editorial only changes have been incorporated in the specification; x the second digit is incremented for all other types of changes, .e. technical enhancements, corrections, updates, etc. Introduction This ETC defines GSM Application Programming Interface (GSM-AP

21、I), the Application Programming Interface as an extension to ETS 300 838 (HPCI). GSM-API can be used by PCI applications without any modification. The same existing applications can be used to transfer data inside GSM networks as well as between GSM networks and ISDNs. Thus it unifies access to digi

22、tal networks from applications point of view. GSM-API enables applications to access GSM interfaces like mobiles, adapter boards, handhelds, etc. in a straightforward manner and allows unrestricted use of their functions through a standardized software interface. Applications which use this interfac

23、e will not be affected by future expansions or hardware changes. GSM-API makes the changes transparent to applications using it. Future expansions that retain compatibility with existing software base are possible. GSM-API provides an abstraction of GSM services and features that is independent from

24、 the network provider and from the interfaces used to connect to the network. It provides an easy-to-use interface for applications and offers a unique access to the different GSM services and features like data transfer, fax, voice, modem, short message service, SIM access, etc. GSM-API provides th

25、e base for modular applications development in GSM network systems. Transposition dates Date of adoption of this ETS: Date of latest announcement of this ETS (doa): 1 May 1998 31 August 1998 Date of latest publication of new National Standard or endorsement of this ETS (doph): 28 February 1999 I 1 D

26、ate of withdrawal of any conflicting National Standard (dow): 28 February 1999 Previous page is blank STD-ETSI ETS 300 917-ENGL 1998 3400855 0300427 LT5 Page 9 ETS 300 917 (GSM 07.08 version 5.2.1): May 1998 1 Scope This European Telecommunication Standard (ETS) defines the GSM Application Programmi

27、ng Interface (GSM-API) in two parts. The first part describes, how compatibility to existing application interface ETS 300 838 14 is covered for the GSM network. So existing PCI applications are able to be used in a GSM environment. For these applications the necessary mapping and local knowledge be

28、tween application interface and network is described. The only modifications needed in ETS 300 838 14 to fulfil this requirements are covered by changes of the parameter description. These changes of parameters are defined in clauses 4 and 5 of this ETS. An application compliant with this ETC shall

29、not imply compliance with ETS 300 838 (HPCI). Clause 4 is meant to replace subclause 5.7 message parameters of ETS 300 838 14. which defines the parameters of the profile A of the HPCI. NOTE 1 : Clause 4is for further study. Clause 5 replaces subclause 6.8 parameter description of ETS 300 838, which

30、 defines the parameters of the profile B of the HPCI. The second part defines GSM specific features. New GSM-API applications need extensions to ETS 300 838 14 which are defined in section 6 and 70f this ETS. These sections are meant as an addition to ETS 300 838 14. They do not replace any clause o

31、f ETS 300 838 14. Clause 6 defines the extensions according to the profile A of ETS 300 838 14. NOTE 2: Clause 6 is for further study. Clause 7 defines the extensions according to the profile B of ETS 300 838 14 (bit compatible to COMMON ISDN API). The messages and the operating system dependent par

32、t of ETS 300 838 14 will not be changed for GSM-API. 2 Normative references This ETS incorporates by dated and undated reference, provisions from other publications. These normative references are cited at the appropriate places in the text and the publications are listed hereafter. For dated refere

33、nces, subsequent amendments to or revisions of any of these publications apply to this ETS only when incorporated in it by amendment or revision. For undated references, the latest edition of the publication referred to applies. 31 i41 151 GSM O1 .O4 (ETR 350): “Digital cellular telecommunications s

34、ystem (Phase 2+); Abbreviations and acronyms“. GSM 02.04 (ETS 300 918): “Digital cellular telecommunications system (Phase 2+); General on supplementary services“. GSM 02.30 (ETS 300 907): “Digital cellular telecommunications system (Phase 2+); Man-Machine Interface (MMI) of the Mobile Station (MS)“

35、 GSM 03.38 (ETS 300 900): “Digital cellular telecommunications system (Phase 2+); Alphabets and language-specific information“. GSM 03.40 (ETS 300 901): “Digital cellular telecommunications system (Phase 2+); Technical realization of the Short Message Service (SMS) Point to Point (PP)“. GSM 03.41 (

36、ETS 300 902): “Digital cellular telecommunications system (Phase 2+); Technical realization of Short Message Service Cell Broadcast (S MS CB)“ . Previous page is blank STD-ETSI ETS 300 717-ENGL 1978 = 3400855 O3UOq3O 717 = Page 10 ETS 300 917 (GSM 07.08 version 5.2.1): May 1998 i71 PI 91 i 31 i 41 G

37、SM 04.08 (ETS 300 940): “Digital cellular telecommunications system (Phase 2+); Mobile radio interface layer 3 specification“. GSM 04.1 1 (ETS 300 942): “Digital cellular telecommunications system (Phase 2+); Point-to-Point (PP) Short Message Service (SMS) support on mobile radio interface“. GSM 04.

38、80 (ETS 300 950): “Digital cellular telecommunications system (Phase 2+); Mobile radio interface layer 3 supplementary services specification Formats and coding“. GSM 04.90 (ETS 300 957): “Digital cellular telecommunications system; Unstructured supplementary services operation - Stage 3“. GSM 05.08

39、 (ETS 300 91 1): “Digital cellular telecommunications system (Phase 2+); Radiosubsystem link control“. GSM 09.02 (ETS 300 974): “Digital cellular telecommunications system (Phase 2+); Mobile Application Part (MAP) specification“. GSM 11.1 1 (ETS 300 977): “Digital cellular telecommunications system

40、Phase 2+); Specification of the Subscriber Identity Module - Mobile Equipment (SIM - ME) interface“. ETS 300 383 (1997): “Integrated Services Digital Network (ISDN); Harmonized Programmable Communication Interface (HPCI) for ISDN“. ETS 300-102-1 (1990): “Integrated Services Digital Network (ISDN),

41、Usernetwork interface layer 3, Specifications for basic call control“. ITU-T Recommendation 0931 (1993): “Digital subscriber Signalling System No. one (DSS1) - ISDN user network interface layer 3 specification for basic call control“. IS0 7776 (1 986): “Information Processing systems; Data communica

42、tions; High-level data link control procedures: Description of the X.25 LAPD compatible DTE data link procedures“. I81 IBM publication: “IBM Synchronous Data Link Control Concepts“ (GA27-3093). i 91 ITU-T Recommendation Q921 (1993): “ISDN user network interface - Data link layer specification“. ITU-

43、T Recommendation T.30 (1993): “Procedures for document facsimile transmission in the general switched telephone Network. 211 1221 Request For Comment (RFC) 1661 : “The Point-to-Point Protocol (PPP)“ Request For Comment (RFC) 1618: “PPP over ISDN“. CCITT Recommendation T.90 (1 992): “Characteristics

44、and protocols for terminals for telematic services in ISDN“. 1241 1251 IS0 8208 (1 990): “Information technology: Data communications; X.25 Packet Layer Protocol for Data Terminal Equipment“. ITU-T Recommendation X.213 (1 992): “Information technology - Network service definition for Open Systems“.

45、ITU-T Recommendation X.400: “Reference model open System interconnection for CCITT applications“. ITU-T Recommendation X.200: “Message handling system and service overview“. ETS 300 097 (1992): “Integrated Services Digital Network (ISDN), Connected Line Identification Presentation (COLP) supplementa

46、ry service; Digital Subscriber Signalling System No. one (DSS1) protocol part 1; Protocol implementation description“. - STDDETSI ETS 300 Sb7-ENGL 1798 3400855 0300433 853 Page 11 ETC 300 917 (GSM 07.08 version 5.2.1): May 1998 3 Definitions and abbreviations 3.1 Definitions For the purposes of this

47、 ETS, the following definitions and those given in ETS 300 838 14 apply: Invalidate SIM File This is a procedure to change the availability of a SIM file. With the invalidate function, the corresponding file will no longer be available. See GSM 11.1 1 13. Rehabilitate SIM File This function will mak

48、e a SIM file available for an application. See GSM 11.11 13. RP cause This is an error cause used in the GSM Short Messages Service at the SMR (Short Message Relay) layer. All causes are listed in GSM 04.11 16. 3.2 Abbrevlatlons For the purpose of this ETS, the following abbreviations apply: API ASN

49、 1 CAP1 CBS DCS DTM F GSM-API HPCI MI PIN Code PLMN PPP RLP sc SIM SMS SMS Command ss TPDU Application Programming Interface Abstract Syntax Notation Number 1. This notation is used in different GSM services. COMMON-ISDN-API Cell Broadcast Service. It is a specific GSM service used to broadcast messages to all subscribers. See GSM 03.41 IS. Data Coding Scheme. It defines an alphabet and/or a class and/or a language for a message. It is used for the SMS and the CBS. See GSM 03.38 4. Dual Tone Multi