Packetcable™ Network-Based Call Signaling Protocol Specification
Total Page:16
File Type:pdf, Size:1020Kb
PacketCable™ Network-Based Call Signaling Protocol Specification PKT-SP-EC-MGCP-I11-050812 ISSUED Notice This PacketCable specification is a cooperative effort undertaken at the direction of Cable Television Laboratories, Inc. (CableLabs®) for the benefit of the cable industry. Neither CableLabs, nor any other entity participating in the creation of this document, is responsible for any liability of any nature whatsoever resulting from or arising out of use or reliance upon this document by any party. This document is furnished on an AS-IS basis and neither CableLabs, nor other participating entity, provides any representation or warranty, express or implied, regarding its accuracy, completeness, or fitness for a particular purpose. © Copyright 1999 - 2005 Cable Television Laboratories, Inc. All rights reserved. PKT-SP-EC-MGCP-I11-050812 PacketCable™ 1.0 Specifications Document Status Sheet Document Control Number: PKT-SP-EC-MGCP-I11-050812 Document Title: PacketCable™ Network-Based Call Signaling Protocol Specification Revision History: I01 — Issued March 12, 1999 I02 — Issued December 1, 1999 I03 — Issued June 20, 2001 I04 — Issued December 21, 2001 I05 — Issued October 18, 2002 I06 — Issued November 27, 2002 I07 — Issued April 15, 2003 I08 — Issued July 28, 2003 I09 — Issued January 13, 2004 I10 — Issued April 2, 2004 I11 — Issued August 12, 2005 Date: August 12, 2005 Status: Work in Draft Issued Released Progress Distribution Restrictions: Author Only CL/Member CL/ Public PacketCable/V endor Key to Document Status Codes: Work in Progress An incomplete document, designed to guide discussion and generate feedback, that may include several alternative requirements for consideration. Draft A document in specification format considered largely complete, but lacking review by Members and vendors. Drafts are susceptible to substantial change during the review process. Issued A stable document, which has undergone rigorous member and vendor review and is suitable for product design and development, cross-vendor interoperability, and for certification testing. Closed A static document, reviewed, tested, validated, and closed to further engineering change requests to the specification through CableLabs. DOCSIS®, eDOCSIS™, PacketCable™, CableHome®, CableOffice™, OpenCable™, OCAP™, CableCARD™, M-CMTS™ and CableLabs® are trademarks of Cable Television Laboratories, Inc. 08/12/05 CableLabs® ii PacketCable™ Network-Based Call Signaling Protocol Specification PKT-SP-EC-MGCP-I11-050812 Contents 1 STATUS OF THIS DOCUMENT........................................................................1 1.1 Specification Language ......................................................................................1 2 SCOPE ..............................................................................................................2 3 INTRODUCTION ...............................................................................................4 3.1 Relation With H.323 Standards ..........................................................................5 3.2 Relation With IETF Standards ............................................................................5 3.3 Relation to RFC 3435 and ABNF Grammar ......................................................6 4 MEDIA GATEWAY CONTROL INTERFACE (MGCI) .......................................7 4.1 Model and Naming Conventions........................................................................7 4.1.1 Endpoint Names ........................................................................................7 4.1.1.1 Embedded Client Endpoint Names........................................................8 4.1.1.1.1 Analog Access Line Endpoints...........................................................8 4.1.1.1.2 Video Endpoints .................................................................................9 4.1.2 Call Names ................................................................................................9 4.1.3 Connection Names ....................................................................................9 4.1.4 Names of Call Agents and Other Entities ..................................................9 4.1.5 Digit Maps................................................................................................10 4.1.6 Events and Signals..................................................................................12 4.2 SDP Use..............................................................................................................14 4.3 Gateway Control Functions..............................................................................14 4.3.1 NotificationRequest..................................................................................16 4.3.2 Notifications .............................................................................................22 4.3.3 CreateConnection....................................................................................23 4.3.4 ModifyConnection....................................................................................29 4.3.5 DeleteConnection (From the Call Agent).................................................31 4.3.6 DeleteConnection (From the Embedded Client)......................................33 4.3.7 DeleteConnection (Multiple Connections From the Call Agent) ..............33 4.3.8 Auditing....................................................................................................34 4.3.8.1 AuditEndPoint ......................................................................................34 4.3.8.2 AuditConnection ..................................................................................37 4.3.9 Restart in Progress..................................................................................38 4.4 States, Failover and Race Conditions .............................................................39 4.4.1 Recaps and Highlights.............................................................................39 4.4.2 Retransmission, and Detection of Lost Associations...............................40 4.4.3 Race Conditions ......................................................................................43 4.4.3.1 Quarantine list......................................................................................43 4.4.3.2 Explicit Detection .................................................................................47 4.4.3.3 Transactional Semantics .....................................................................48 4.4.3.4 Ordering of Commands, and Treatment of Disorder............................48 4.4.3.5 Fighting the Restart Avalanche............................................................49 iii CableLabs® 08/12/05 PKT-SP-EC-MGCP-I11-050812 PacketCable™ 1.0 Specifications 4.4.3.6 Disconnected Endpoints ......................................................................50 4.4.3.7 Call Agent Handling of Disconnected Endpoints .................................52 4.5 Return Codes and Error Codes........................................................................54 4.6 Reason Codes....................................................................................................55 4.7 Use of Local Connection Options and Connection Descriptors...................55 4.7.1 Remote IP and Port Negotiation ..............................................................58 5 MEDIA GATEWAY CONTROL PROTOCOL ..................................................59 5.1 General Description ..........................................................................................59 5.2 Command Header..............................................................................................59 5.2.1 Command Line ........................................................................................60 5.2.1.1 Requested Verb Coding ......................................................................60 5.2.1.2 Transaction Identifiers .........................................................................60 5.2.1.3 Endpoint, Call Agent and NotifiedEntity Name Coding........................61 5.2.1.4 Protocol Version Coding ......................................................................61 5.2.2 Parameter Lines ......................................................................................61 5.2.2.1 Response Acknowledgement ..............................................................64 5.2.2.2 RequestIdentifier..................................................................................64 5.2.2.3 Local Connection Options....................................................................64 5.2.2.4 Capabilities ..........................................................................................66 5.2.2.5 Connection Parameters .......................................................................67 5.2.2.6 Reason Codes .....................................................................................68 5.2.2.7 Connection Mode.................................................................................68 5.2.2.8 Event/Signal Name Coding..................................................................68 5.2.2.9 RequestedEvents ................................................................................69 5.2.2.10 SignalRequests................................................................................70 5.2.2.11 ObservedEvents ..............................................................................71 5.2.2.12 RequestedInfo..................................................................................71