- nic.at Emergency Call Project
Contents
1. gt lt path gt lt locationUsed id zapt FIXME not_implemented gt lt listServicesByLoc lat ionResponse gt Figure 2 Zap debug window 4 Configuration When Zap is running enter the configuration screen by selecting Configuration on the sidebar 4 1 SIP Configuration SIP specific settings are under SIP Settings Configure the SIP service by clicking on the button Configure SIP Services A new identity that uses a SIP service is created on the Zap main screen by clicking on the button Create new identity Zap also has a feature to automatically guess settings for the service So it may be sufficient to create a new identity without having to add a new SIP service first Moreover it is not necessary to register to a SIP proxy in order to place calls with Zap The identity sip thisis anonymous invalid is default Note that Zap may not be able to traverse a NAT without help of a SIP proxy server Be aware that Zap may also mix up IP addresses on systems with multiple interfaces 4 2 Emergency Call Configuration On the configuration screen there are important settings for the emergency call feature By default no location determination and service discovery is performed at all since the components for the IETF emergency call framework are not deployed in most networks yet For emergency calls the following settings are available see Figure 3 e LIS URI the URI of the Location Information Server2. 1 html eae Zap Emergency Call Extension Manual micat the austrian registry To get debug information Zap can be started with the command line parameter console zap console To enable the JavaScript console add the command line parameter jsconsole zap console jsconsole In the console output all ongoing location determination and service discovery results are printed see Figure 2 e Wownload zap 0 2 3 20060729 win32 xulrunner xulrunner exe Trying to get LoST at Location 37 775 122 422 ILoST Request lt xml version 1 6 encoding UTF 8 gt KlistServicesByLocation xmlns urn ietf params xml ins losti xmlns gp urn ietf params xml ns pidf geoprivi xmlns cl urn ietf pn s ixml ins pidf geoprivi civicLoc xmlns gml urn opengis specif icat ion gml schema xsd feature v3 8 gt lt lo cation id zapt FIXME not_implemented profile geodetic 2d gt lt gml Point gml id pointi srsName urn ogc def crs EPSG 4 326 gt lt gml pos gt 37 775 122 422 lt gml1 pos gt lt gm1 Point gt lt locat ion gt lt service gt urn service sos lt service gt lt listServicesByLocation gt LoST Response O encoding UTF 8 gt lt listServicesByLocationResponse xmlns urn ietf params xml ns losti gt lt serviceList gt iwn service sos police urn service sos fire urn service sos ems urn service sos poison lt serviceList gt lt pat 91iserv irt cs columbia edu
3. We an oar may EE Ch e Lige Ge RK gt z 4814 ZER nno0n12874 JDP 1 pc Figure 8 Incoming call alert bar After hanging up the location information is still visible on the screen In case a user hung up too early or the call was lost location information is available Even if the caller hangs up before the call was answered the missed calls window accessible via the sidebar shows location information A click on the label Location opens a separate browser window and shows the location of the caller on Google maps 10 Zap Emergency Call Extension Manual nicat the austrian registry sl zap v0 2 3 aA File Tools Help 122 k Je Identity sip thisis anonymous invalid Kid A Home g sip thisis anonymous invalid L a SIP Call ID a calls 7b0d535f fed5 47d4 6e06 0432d8f24eb6 khw ubuntu E Missed Local Address a Received Bergrettung Hainburg an der Donau lt sip psap 10 10 0 46 gt Dialed Remote Address E Contacts lt sip thisis anonymous invalid gt W Configuration Subject Current Status Confirmed Duration ei 25 Location Call from 48 142637 16 94937 Emergency Location 48 14263999462128 16 94990000128746 Listening for UDP TCP SIP traffic on port 5060 Figure 9 Active inbound call 8 Setup for Testing Emergency Calls If you want to use Zap for experimenting with the emergency call feature it is recommended to set up two machines with the
4. can be accessed via the side bar by clicking on Calls and then selecting the call from the list The link to Google maps is also accessible for these calls 7 Receiving Calls with Location Information Inbound When a call comes in the user is alerted by a red alert bar appearing on the top of the window see Figure 8 The alert bar directly displays location information if conveyed with the incoming call After accepting the call location information is shown in the active call window see Figure 9 Zap Emergency Call Extension Manual nicat Create new identity Le sip thisis anonymous invalid l a Manage Contact E Ki Cals Emergency Services Status S Missed S Received Dialed Welcome to zap the Open Source Mozilla SIP Client B Contacts Read more about the goals of zap in this whitepaper or visit the project home page A7 Configuration www croczilla comjzapi Here are some SIP addresses you can try calling straight away no SIP account required e sip 613 fwd pulver com The ubiquitous callback test at FWD e sip 411 Fwd pulver com 1 800 555 TELL service Honestly you will want to try this e sip 266300 sipbroker com Monkey sounds from blueFace ie e sip 266305 sipbroker com Chill music from blueface ie e sip 74719498245414 sipbroker com University of California Irvine voice menu via sipphone com Enroll in a course using zap e sip 2589123 sipbroker com UK Time via voiptalk org
5. CalHD sipithisis anonymous invalid d924f4ef 352f 4bab bea4 b90790a6f6bb inspiron6000 Local Address ke Calls 2 Missed lt sip thisis anonymous invalid gt Received Ee Dialed Bergrettung Hainburg an der Donau lt sip enum test sip nemox net gt Li Contacts Subject 7 Configuration Current Status Calling Duration Lei Location Conveyed Location Information 48 142637 16 94937 Emergency Location 48 142637 16 94937 Listening for UDP TCP SIP traffic on port 5060 Figure 7 Active outbound call window The Active outbound call screen informs about all the important details of the current call The field Remote Address shows the display name and the SIP URI of the emergency centre the call goes to Current Status shows calling ringing connected or an error message if the session could not be set up Again the field Location reminds the user that location information is conveyed for this call and summarizes the location information sent to the remote party The label Location is a link to Google maps showing the location information on a map The maps window opens in a separate browser window Once the call ended press hang up button this call information is still available A button SIP logs allows to the see all the SIP messages sent and received by Zap for diagnostic purposes All the call details and SIP logs are stored by Zap and
6. LIS for HELD location determination e openLLDP location output file specifies the directory and filename of the file that is created by openLLDP s LLDP MED location identification TLV extension This file contains the location information provided by LLDP MED and is read by Zap for location determination Note openLLDP is currently not available for Windows but 4 Zap Emergency Call Extension Manual nicat the austrian registry openLLDP developers are working on it For now it can be used on Linux or it is possible to simulate LLDP MED location information on Windows by creating a stub file e LoST Server URI the Location to Service Translation Server URI for service discovery e Discover DHCP Location Check this box for location discovery by DHCP Note this might be a rather time consuming task on Windows when having multiple interfaces and no DHCP server responding Consequently Zap start up may significantly slow down For information on DHCP location determination on Linux please refer to the ECRITDHCP XPCOM component document File Tools Help X Le Identity sip thisis anonymous invalid A Home sip thisis anonymous invalid Se Calls S Missed weg E Received US URI http lis example com Dialed This is the Location Information Server LIS setting Contacts Uf Configuration openLLDP Location Output file crYloc out LoST Server URI http lost example com i D
7. Location Information and Service Mapping The configuration is stored in the Zap profile folder On Windows systems the profile is located in Document and Settings Application Data Mozilla Zap on Linux systems the profile is located in mozilla zap When there are problems with Zap or in order to restore the default configuration just delete the profile folder All the user settings are lost and default configuration is restored 4 4 Supported Methods for Location Determination Zap supports location determination by HELD DHCP and LLDP MED All these methods support geodetic location information as well as civic location information With HELD both types of location information may be retrieved at once In the case of DHCP there are two separate options for civic and geodetic which are both requested by Zap when the DHCP location determination is activated The current specification of LLDP MED just allows receiving either civic or geodetic location information not both at once on a single interface Zap always tries to perform all location determination steps For location conveyance see Chapter 6 the first available location information is selected from the order LLDP MED DHCP and HELD This order is chosen because of the recommendation by the DSL Forum PD 164 Requirements for CPE in Support of Accessing Emergency Services 5 Emergency Services Status Information In order to check the determined location information i
8. cognize this call as an emergency call and indicate that location information will be conveyed for this call After pressing Call the emergency centre Zap should start ringing and display the location information of the caller For more information on placing and receiving calls refer to the previous chapters 9 Limitations This chapter briefly list the limitation of the software regarding the IETF emergency call framework Note that the emergency call framework is still under development and might have changed since this implementation was done The software has the following limitations list might be incomplete Location by reference not supported just location by value is implemented HELD and LIS discovery not supported servers are specified manually HELD and LoST not fully implemented just basic functionality Service URNS are not supported Geodetic shapes just Point Location information or service mapping is not refreshed right before placing an emergency call openLLDP runs on Linux only not on Windows The command refresh performs all location determination methods again and not only the previously successful method DHCP takes first successful response only LoST Service boundary not evaluated Home emergency dialstring not supported DHCP geodetic location information is converted to a GML point shape latitude and longitude in PDIF LO only e Not all civic PIDF LO elements supported Namespace used urn ietf param
9. iscover DHCP Location i UA Instance ID urn uuid 5d335 4b 8468 45cF 9eal ebdceSb93d31 SIP port base 5060 Registration Failure Tmax 1800 Flow Failure Tbase 60 Registration failure Tbase DND response code Additional DND headers Compatibility Use short branch parameters i Configure SIP Services v Apply changes Cancel Emergency Location 48 142637 16 94937 Listening for UDP TCP SIP traffic on port 5060 Figure 3 Zap Configuration Window An empty field for the LoST LIS or LLDP MED setting deactivates the functionality It is possible to use Zap completely without the emergency call extension or just with the LIS and LoST settings and having DHCP and LLDP MED deactivated for example In order to place emergency calls at least one method for location determination and the service discovery performed by a LoST server must succeed Help is available by clicking on the yellow exclamation mark on the right side 4 3 Applying Changes After a change in the configuration settings click on Apply changes on the red bar appearing at the bottom of the window The configuration for location determination and ER Zap Emergency Call Extension Manual nicat the austrian registry service discovery will become effective by either restarting Zap or switching to the Emergency Services Status window accessible via a button on Zap s home window and clicking on the button Refresh
10. l WE E 4 4 3 Applying Chan eege deit a aE 5 4 4 Supported Methods for Location Determination esseesseseeseesrsereeeesrreresressrrsreeeresee 6 5 Emergency Services Status Information osccciscctsscccsessasssacessgsstassaseaasandveaesdetearsaseveceasansvenses 6 6 Placing Emergency Calls with Location Information Outbound eee eee eeeeeeeeeeeee 8 7 Receiving Calls with Location Information Inbound cee eeeseeceeceeeeeeeeeeeeeeeeneeeeeaes 9 8 Setup for Testing Emergency Call 5 scsuiniwasvansaeetassewedstnnddsusdsuswesacnwed diensuddedncentesdtasudeuesenss 11 8 1 Location Determination Set p sisrecsennsrnin ieia ier R EE E 11 8 2 Service Mapping Server Setup viscsxcssencceansnaaseaacvanensceeaasssasstesdendvanaveaesaadeads canedecvesededs 12 8 3 Place EMmersency EE 12 9 LEET eene EE R A E E E RRS 12 Zap Emergency Call Extension Manual nicat 1 Introduction This is the user manual of the emergency call extension to Zap the Mozilla SIP client based on XULRunner The implementation is based on the emergency call framework currently under development by the IETF Relevant documents are available at the ECRIT GEOPRIV and SIP working group Note well that the standardization by the IETF is not completed at the time of implementation Zap is licensed under Mozilla Public Licence The original developer is Alex Fritze 2 Installation Download the current Zap version with emergency call extension A version for Wi
11. lcome tn zanl the Nnen Source Mozilla SIP Client On the next screen see Figure 6 Zap shows that an emergency call was detected since there is a mapping for 911 toaservice sos URN provided by the LoST server zap v0 2 3 Eile Tools Help Dt Identity sip thisis anonymnous invalid DND A Home sip thisis anonymous invalid Remote party amp lt sip 911 teluri gt amp Calls Subject I Missed S Received Dialed a Contacts Let other party make offer W Configuration Provide media offer Media offer Audio V Enable PEMU Codec V Enable PEMA Codec Enable Speex Codec Enable Telephone Events DTMF Location Information is conveyed for this call since this is an Emergency Call Emergency Location 48 142637 16 94937 Listening for UDP TCP SIP traffic on port 5060 Figure 6 Make outgoing call window with notification that location information is conveyed since this is an emergency call Location information will only be conveyed for emergency calls In case there was not an emergency number entered no location information will be conveyed at all in order to protect privacy By pressing the Call button or just hitting return again Zap initiates the call see Figure 7 Zap Emergency Call Extension Manual micat the austrian registry sl zap v0 2 3 Eile Tools Help jou Identity sip thisis anonymous invalid Brome SIP
12. micat the austrian registry Zap Emergency Call Extension Manual http ecrit labs nic at Create new identity a sip thisis anonymous invalid a Manage Contact ag a S Emergency Services Status iss ET Received i elcome to zap en Source Mozilla ent Q Dialed Wel to zap the S Mozilla SIP Client E Contacts Read more about the goals of zap in this whitepaper or visit the project home page 7 Configuration www croczilla comjzap Here are some SIP addresses you can try calling straight away no SIP account required e sip 613 fwd pulver com The ubiquitous callback test at FWD e sip 411 fwd pulver com 1 800 555 TELL service Honestly you will want to try this e sip 266300 sipbroker com Monkey sounds from blueface ie e sipi 266305 sipbroker com Chill music from blueface ie o sip 74719498245414 sipbroker com University of California Irvine voice menu via sipphone com Enroll in a course using zap e sip 2589123 sipbroker com UK Time via voiptalk org Emergency Location 4814263999462128 16 94990000128746 Listening For UDP TCP SIP traffic on port 5060 Project implemented by nic at GmbH Dipl Ing Karl Heinz Wolf Ing Michael Braun der Ing Alexander Mayrhofer v1 0 Zap Emergency Call Extension Manual micat Contents i ERI ee E 3 2 ANTS aU FU Tae gcse E E E E 3 3 Starting Zapsio tee E RAE E O E ORE EIA EREET 3 e ZE E E 4 4 1 SEENEN 4 4 2 Emergency Cal
13. n PIDF LO format and the discovered services click on the button Emergency Services Status on Zap s home window If no mappings and or location information is shown check the emergency related configuration the network connection and consider starting a debug window for further investigation as explained in Chapter 3 Figure 4 shows an exemplary emergency services status window HELD and DHCP location determination have been successful The PIDF LO as received from the location information server and the PIDF LO created out of the data provided by the DHCP option is displayed LLDP MED resulted in no location meaning that this method didn t succeed either because it is not configured at all the configuration setting is wrong or location information is not available Zap Emergency Call Extension Manual nicat i zap v0 2 3 Eile Tools Help S co Identity sip thisis anonymous invalid A Home sip thisis anonymous invalid Emergency Services Status a This page shows the status of the emergency call Functionality IF you do not get information here look at the Configuration menu at the sidebar and check the 5 L calls emergency configuration gt Missed Refresh Location Information and Service Mapping EP Received a Dialled Show my current location on Google maps opens in your browser window E Contacts D Emergency Services determined by LoST Configuration Call 911 fo
14. ndows and Linux is available Installation of Zap is achieved by simply extracting zap to a folder on the hard disk No special setup routine is necessary 3 Starting Zap The Zap application is started by launching zap exe on Windows systems or by executing zap on Linux systems The main Zap window opens and a splash screen appears while location determination and service discovery is performed see Figure 1 After the splash screen disappears Zap is ready for a call zap v0 2 3 File Tools Help sip thisis anonymous invalid A Home sip thisis anonymous invalid Create new identity amp Calls Manage Contact I Missed I Received Dialed E contacts Welcome to zap the Open Source Mozilla SIP Client WP Configuration Emergency Services Status Read more about the goals of zap in this whitepaper or visit the project home page www croczilla comjzap Here are some SIP addresses you can try calling straight away no SIP account required e sip 613 fwd pulver com The ubiquitous callback test at FWD sip 411 fwd pulver com 1 800 555 TELL service Honestly you will want to try this e sip 266300 sipbroker com Monkey sounds from blueface ie e sip 266305 sipbroker com Chill music from blueface ie e sip 747194982454 14 sipbroker com University of California Irvine voice menu via sipphone com Enroll in a course using zap e sip 2589123 sipbroker com UK Time
15. opens in a separate browser window and shows the determined location on Google maps At the bottom of the Zap window there is a status bar telling the available location information that is used for location conveyance in case of an emergency call This provides a quick overview of location determination without having to go to the emergency services status window oe Zap Emergency Call Extension Manual nicat the austrian registry 6 Placing Emergency Calls with Location Information Outbound To be able to place an emergency call and to convey location information to the remote party location information and service numbers must be available That means at least one method of location determination and service discovery needs to complete successfully before such a call In Zap a call can be initiated by entering the SIP address or in case of an emergency call the emergency dial string service number to the address bar see Figure 5 After entering the emergency number press enter or click on the Go button Before it is possible to select the identity on the right which will be used for call setup zy zap v0 2 3 File Tools Help jou Jeo Identity sip thisis anonymous invalid ono A Home E sip thisis anonymous invalid amp calls Manage Contact S Missed B Received Dialed Figure 5 Dial 911 Create new identity Emergency Services Status Ss We
16. r Bergrettung Hainburg an der Donau which is the mountainrescue service for your location and connects you to sip psap 10 10 0 46 Call 123 For Polizeikommando NOE which is the police service For your location and connects you to sip enum test sip nemox net Call 122 for Freiwillige Feuerwehr Hainburg an der Donau which is the fire service for your location and connects you to sip feuerwehr 10 10 0 140 The services listed above are currently available at your location Determined Location Information The Following textareas display the location information that was determined by HELD DHCP or LLDP MED by the location file generated by openLLDP PIDF LO retrieved from LIS by HELD lt xml version 1 0 encoding UTF 8 gt lt presence xmins urn ietf params xml ns pidf xmins gp urn ietf params xmlins pidf geopriy10 xmins gml urn opengis specification gml schema xsd feature v3 0 entity pres geotarget example com gt lt tuple id sg89ae gt lt status gt lt gp geopriv gt lt gp location info gt lt gmi location gt lt gml Point gml id point1 srsName epsq 4326 gt lt gml pos gt 48 142637 16 94937 lt gml pos gt lt fgml Point gt lt gml location gt lt gp location info gt lt gp usage rules gt PIDF LO retrieved by DHCP options lt xml version 1 0 encoding UTF 8 gt lt presence xmins urn ietF params xml ns pidf xmins gp urn ietf params xml ns pidF geop
17. riv10 xmins cl urn ietf params xml ns pidF geopriv 10 civicLoc xmins gml urn opengis specification gml schema xsd Feature v3 0 entity pres user zap lidp gt lt tuple id zap gt lt gp status gt lt gp geopriv gt lt gp location info gt lt gml location gt lt gml Paint srsName urn oge def crs EP5G 4326 gt lt qml pos gt 48 14263999462128 16 94990000128746 lt gml pos gt lt jgml Point gt lt gml location gt lt gp location info gt lt gp usage rules gt lt gp retransmission allowed gt yes lt gp retransmission allawed DHCP HELD test only no registered XML namespace lt gp provided by gt lt gp method gt Manual lt gp method gt lt gp geopriy gt lt gp status gt lt tuple gt lt j presence gt lt PIDF LO retrieved by LLDP MED by the location file of openLLDP no location Figure 4 Zap Emergency Services Status window In order to refresh location information and the service discovery click on the button Refresh Location Information and Service Mapping Any applied emergency configuration changes will be effective right now Wait until this task is completed and the refreshed data is shown in the emergency service status window Zap will perform all configured location determination methods regardless of which methods were successful previously Note that mapping of services can only be done if location information is available in the first place Below the refresh button is a link that
18. s xml ins pidf geoprivl0 civicAddr 7 http sourceforge net projects held location http honamsun cs columbia edu lost_homepage 12
19. same Zap version with emergency call extension Use one machine as your emergency centre The other client will generate the emergency calls Test your setup by placing a simple call between the two SIP User Agents Zap can only detect emergency calls when there is a valid mapping of the emergency dialstring to a SIP URI otherwise emergency call functions are unavailable In order to get a mapping from the LoST server you have to determine your location first 8 1 Location Determination Setup Zap supports three ways of location determination e LLDP MED e DHCP e HELD For LLDP MED the output file of openLLDP with the MED extension for location TLVs is needed Specify the path to this file on the configuration screen If you don t have openLLDP running you can use a stub file an example file is provided on the Zap emergency call project webpage http ecrit labs nic at For DHCP configure your DHCP server to provide DHCP options 99 and or 123 for location configuration HELD communicates with a Location Information Server LIS for location retrieval Since Zap generates an HTTP GET request to the LIS to get location information it is possible to simply put a static PIDF LO document on your web server for test purposes PIDF LO examples are available in RFC 4119 draft ietf geopriv pdif lo profile and draft ietf geopriv revised civic lo for example An open source LIS is available at sourceforge Note that Zap expects http w
20. via voiptalk org o sip 266303 sipbroker com eler o sip 612 fwd pulver com New YP O An T A Please wait for Location Determination and Service Discovery Trouble Please visit irc moznet zap or send an e If you are having trouble connecting to H If the local echo test works fine i e you can hear it ringing and you can hear yourself after accepting the call the problem might be firewall related SIP Accounts To get zap to register with your SIP account create a new identity Sidebar gt Identities gt New Identity and enter the address of record Registered contacts appear in the sidebar with a green halo around them If registration Fails for your account you might need to add a new SIP service definition Sidebar gt Configuration gt SIP Settings gt Configure SIP Services gt Add new Service Please tell us about your new service definitions so that we can include them in the master list You can register with several accounts at the same time Use the Identity dropdown in the toolbar to switch your identity for outgoing calls Improving Zap We are now offering cash bounties for new features and improvements Visit www croczilla com 2zap bounties for the list of available bounties and the rules to claims them Figure 1 Zap main window and splash screen http croczilla com zap http tools ietf org html draft ietf ecrit framework work in progress http www mozilla org MPL MPL 1
21. ww ietf org rfc rfc4 119 txt http www tools ietf org html draft ietf geopriv pdif lo profile work in progress http tools ietf org html draft ietf geopriv revised civic lo work in progress 1ll Zap Emergency Call Extension Manual micat the austrian registry the namespace urn ietf params xml ns pidf geopriv10 civicAddr for civic addresses 8 2 Service Mapping Server Setup A LoST server is needed for the mapping of the location information to available services providing Zap with the dialstrings for detecting emergency calls and the SIP URI of the emergency centre Provision your prototype LoST server with the SIP URI of your Zap emergency centre installation so that calls to the emergency dialstring will go directly to your second Zap installation for testing purposes In order to see how a LoST server works you may try the sample LoST server from Columbia University The Zap LoST client functionality is compatible with this server implementation However the SIP URIs currently provided by this demo LoST server are not valid so you cannot make any test calls but you can try the mapping procedure 8 3 Placing Emergency Calls When the setup for location determination and service discovery is ready start Zap and check if location information was determined and the services are shown on the emergency services status page Next enter your emergency dialstring to the Zap address bar and press enter Zap should now re
Download Pdf Manuals
Related Search