About

If you use SCCP please test the Patterns Dialplan Configuration halfway down this page and provide feedback at the bottom of this page on how it works. Specifically, will FreeSWITCH recognize variable length dial strings and will it timeout properly as specified by the data provided to the skinny-wait dialplan application. Thanks.

FreeSWITCH Configuration

The configuration is loaded from autolad_configs as usual. The default is:

conf/autoload_configs/skinny.conf.xml

Profile Configurations

Each profile is put in conf/skinny_profiles. The default configuration should work without modifications.

conf/skinny_profiles/internal.xmlExpand source

Icon

If ip="", mod_skinny will listen on all IP addresses. If you want to force IPv6, use ip="::"

If ext-autodial is set, the phone will do a ringdown/automatically dial that number when taken off-hook. This is useful for customer service and emergency phones.

mod_skinny logs a lot under [DEBUG], every skinny message received or sent. keepAlive and keepAliveAck messages are only logged if profile's debug is >=10.

When issuing a reloadxml command, those values are not reloaded. Use skinny profile <profile_name> set <name> <value> instead.

You typically don't have to bother about the firmware-version unless your phone asks for it through skinny (most Cisco phones use XML files from tftp). If you have missed one, mod_skinny will complain in the log with the following message:

[DEBUG] skinny_server.c:1501 Device SEP001120AABBCC:0 is requesting for firmware version, but none is set.

The auto-restart param is used when a network interface ip changes. If set to true, the socket will be closed (including all connected listeners) and reopened on the new IP.

Device Configuration

Devices are set up as users in conf/directory. The critical parameter here is id, which corresponds to the MAC address.

Patterns Dialplan configuration

This dialplan is used when calling from a skinny phone. The default configuration will allow you to call SIP phones and some tests like the variable info dump to fs_cli (9192).

As all the call process is made on the server, we need a way to know how many digits are necessary to route the call. Executing the dialplan each time a digit is pressed is not correct. An other dialplan context is used to say simply what mod_skinny should do:

Please test on your SCPP/Skinny system and tell us how to improve this module at

JIRA Issues Macro: Data cannot be retrieved due to an unexpected error

conf/dialplan/skinny-patterns.xml

You can select the diaplan context by setting patterns-dialplan and patterns-context in the skinny profile configuration.

Dialplan configuration

This dialplan snippet is necessary when you need to send a call to a skinny phone. Without this, you will not be able to call your skinny phones!

Add something like this to (Example with 11xx):

conf/dialplan/default.xml

Outgoing Channel Syntax

Basic form:

skinny/<profile>/<number>

API Commands

Note: most of the command arguments can be auto completed on CLI by using tab (for example <ring_type>).