Emergency Call Module

The following modules must be loaded before this module:

The following libraries or applications must be installed before running OpenSIPS with this module loaded:

The database url must be specified.

Default value is “NULL”.

...
modparam("emergency", "db_url", "mysql://opensips:opensipsrw@localhost/opensips”)
...
		

The name of the db table storing routing information to emergency calls.

Default value is “emergency_routing”.

...
modparam("emergency", "db_table_routing", "emergency_routing")
...
		

The name of the db table that stores the emergency call report.

Default value is “emergency_report”.

...
modparam("emergency", "db_table_report", "emergency_report")
...
		

The name of the db table that stores the nodes information of organization involved in emergency calls.

Default value is “emergency_service_provider”.

...
modparam("emergency", "db_table_provider", "emergency_service_provider")
...
		

This parameter define what role the opensips will take to treat emergency call:

0 – The opensips is the Call Server in scenario I. In this role the opensips implements the V2 interface, directly queries the VPC for ESGWRI/ESQK, selects the proper ESGW given the ESGWRI and routes calls Via the PSTN using the LRO if routing fails.

1 – The opensips is the Call Server in scenario II that sends the INVITE on emergency call to a Routing Proxy provider. The Routing Proxy provider implements the V2 interface.

2 - The opensips is the Routing Proxy in scenario II. In this role the opensips implements the V2 interface, directly queries the VPC for ESGWRI/ESQK, selects the proper ESGW given the ESGWRI and routes calls Via the PSTN using the LRO if routing fails.

3 - The opensips is the Redirect Proxy in scenario III that receives the INVITE on emergency call from Call Server. The Redirect Server obtains the ESGWRI/ESQK from the VPC and sends in the SIP 3xx response to the Call Server.

4 - The opensips is the Call Server in scenario III that sends the INVITE on emergency call to a Redirect Server. The Redirect Server obtains the ESGWRI/ESQK from the VPC. It returns the call to the opensips with the ESGWRI/ESQK in the header contact in the SIP response. The opensips selects the proper ESGW based on the ESGWRI.

Default value is “0”.

...
modparam("emergency", "proxy_role", 0))
...
		

The VPC url that opensips request the routing information to emergency call. This VPC url has IP:Port format

Default value is “empty string”.

...
modparam("emergency", "url_vpc", “192.168.0.103:5060”)
...
		

Local emergency number. Opensips uses this number to recognize a emergency call beyond the username default defined by RFC-5031 (urn:service.sos.). Along with the number should be given a brief description about this code. The format is code_number-description. It can register multiple emergency numbers.

Default value is “NULLg”.

...
modparam("emergency", "emergency_codes", “911-us emegency code”)
...
		

Sets the time interval polling to make the copy in memory of the db_table_routing.

Default value is “10”.

...
modparam("emergency","timer_interval",20)
...
		

The contingency_hostname is the url of the server que will route the call to the PSTN using the number of contingency.

Default value is “NULL”.

...
modparam("emergency","contingency_hostname",“176.34,29.102:5060”)
...
		

The emergency_call_server is the url of the Routing Proxy/Redirect Server that will handle the emergency call in cenario II. Its is mandatory if Opensips act as Call Server in scenario II (proxy_role = 1 and flag_third_enterprise = 0) or Call Server in scenario III (proxy_role = 2).

Default value is “NULL”.

...
modparam("emergency","emergency_call_server",“124.78.29.123:5060”)
...
		

Checks whether the incoming call is an emergency call, case it is treats, and routes the call to the destination determined by VPC. The function returns true if is a emergency call and the treat was Ok.

This function can be used from the REQUEST routes.

...
# Example of treat of emergency call

    if (emergency_call()){

        xlog("emergency call\n");
        t_on_failure("emergency_call");
        t_relay();
        exit;

  	}
...
		

This function is used when trying to route the emergency call to the destination specified by the VPC and doesn't work, then uses this function to make one last attempt for a contingency number. The function returns true if the contingency treat was OK.

This function can be used from the FAILURE routes.

...
# Example od treat of contingency in emergency call

    if (failure()) {
        if (!t_relay()) {
           send_reply(500,"Internal Error");
        };
        exit;
    }
...