Skip to content

Examples: FreeSwitch

Alexandr Dubovikov edited this page Apr 19, 2016 · 12 revisions

FreeSwitch

FreeSWITCH Capture Agent

Freeswitch ships with an integrated HEP Capture Agent designed to work with HOMER

UPDATE: FreeSwitch is being updated to support HEP2/3 pending PR

Global Configuration

To enable HEP capturing, open sofia.conf.xml and set capture-server param

<param name="capture-server" value="udp:192.168.0.1:9060"/>

Freeswitch 1.7 (master git) has support for HEPv2 and HEPv3. The new syntax is:

<param name="capture-server" value="udp:homer.domain.com:5060;hep=3;capture_id=100"/>

open internal.xml and change sip-capture param to "yes"

<param name="sip-capture" value="yes"/>

note: the ip address and port must be same as the listen param in your kamailio.cfg


To enable/disable the HEP agent on demand, you can use CLI commands:

freeswitch@fsnode04> sofia global capture on
 
+OK Global capture on
freeswitch@fsnode04> sofia global capture off
 
+OK Global capture off

Profile Configuration

You can choose to activate HEP capturing only for a specific profile:

freeswitch@fsnode04> sofia profile internal capture on
 
Enabled sip capturing on internal

freeswitch@fsnode04> sofia profile internal capture off
 
Disabled sip capturing on internal

ESL Integration (beta)

hepipe.js provides experimental support for FreeSWITCH ESL integration for call quality reports feeding to HOMER 5, effectively providing external HEP3/EEP features with correlation support.

Events

ESL Event Hep Mode HEP Type
CHANNEL_CREATE LOG 100
CHANNEL_ANSWER LOG 100
CHANNEL_DESTROY LOG 100
CUSTOM LOG 100
RECV_RTCP_MESSAGE RTCP 5
CHANNEL_DESTROY CUSTOM QoS 99

For full instructions and details please checkout hepipe.js

If you test or extend this feature please share your feedback!

Clone this wiki locally