Examples: 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:192.168.0.1:9060;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!