HOWTO: Resolve FreePBX and Sipura/Linksys Feature Code Conflicts

Resolving FreePBX and Sipura/Linksys Supplementary Service and Feature Code Conflicts

One problem faced by users of FreePBX that have Sipura or Linksys
endpoints (VoIP adapters, etc.) is deciding how to set the
Supplementary Services and Feature Codes on the endpoint so that there
is no conflict between FreePBX features and Sipura/Linksys features.
The presumption here is that we want FreePBX to handle as much as
possible, and only allow the endpoints to perform functions that they
must provide - for example, if the endpoint provides dial tone, then
only the endpoint can provide stutter dial tone as a message waiting
indication. So we can't just disable all the endpoint features and
feature codes and expect everything to work.

Some may feel that it would be more efficient to allow the endpoint
to handle certain functions, and while that may be true in the short
term, it has the potential to "break" something when new features are
added to FreePBX, or when there are unintended feature interactions
that FreePBX could resolve if it had control of the feature. Also,
sometimes the default Sipura/Linksys feature codes do not have the same
meaning as the equivalent FreePBX feature codes, and the presumption is
that in order to keep things uniform throughout the system, we want all
extensions to use the same feature codes.

So, here are the suggested settings for the Sipura/Linksys
endpoints (note that this document covers VoIP lines only, and has
nothing to do with PSTN lines on the Sipura/Linksys 3xxx series).

Supplementary Services

Each of these services can be set to "Yes" or "No". First the
parameter name, then the description, then the suggested setting, and
underneath any notes, conflicts, etc.

• Call Waiting Serv - Enable Call Waiting Service - yes
• If this isn't activated, the device won't be able to accept call waiting calls.
• This normally uses *56 to Enable Call Waiting on all calls, and *57 to Disable Call Waiting on all calls.
• It also uses *71 to Enable Call Waiting for the next call, and *70 to Disable Call Waiting for the next call.
• These codes may need to be changed or deactivated to avoid a conflict with FreePBX feature codes.
• The FreePBX standard is to use *70 for Call Waiting - Activate and *71 for Call Waiting - Deactivate.
• However, the PSTN standard in much of North America is to use *70 to Disable Call Waiting for the next call.
• At present FreePBX does not use the *56 or *57 codes for anything by default.

• Block CID Serv - Enable Block Caller ID Service - no
• In most cases, the FreePBX extension page, or the trunk
  definition specifies the outgoing CallerID, therefore this generally
  has no effect.
• This normally uses *67 to Block CID on all outbound calls, and *68 to Unblock CID on all outbound calls.
• It also uses *81 to Block CID on the next outbound call, and *82 to Unblock CID on the next outbound call.
• FreePBX does not appear to provide this feature at the preset
  time (although it may be able to pass a "Block CID on the next outbound
  call" code through on an outbound trunk, where it may be honored by a
  provider).
• The PSTN standard in much of North America is to use *67 to Block CID on the next outbound call.
• At present FreePBX does not use the *67 code for anything by default.

• Block ANC Serv - Enable Block Anonymous Calls Service - no
• This normally uses *77 to Block all anonymous calls, and *87 to Unblock all anonymous calls.
• FreePBX provides this function (although it cannot be enabled
  or disabled using a feature code), and can give the caller the option
  to enter their number.
• FreePBX by default uses *77 to save a recording.

• Dist Ring Serv - Enable Distinctive Ringing Service - yes
• FreePBX can send distinctive ringing requests but the device will ignore them unless this is set to yes.
• This normally uses *26 to Enable Distinctive Ringing, and *46
  to Disable Distinctive Ringing (some Linksys docs say *61 and *81
  respectively, but I believe those may be wrong, judging from what I've
  seen on actual adapters).
• These codes may need to be changed or deactivated to avoid a conflict with FreePBX feature codes.
• At present FreePBX does not use the *26 or *46, or for that
  matter, *61 or *81 codes for anything by default. However, Trixbox uses
  *61 to provide a weather service.

• Cfwd All Serv - Enable Call Forward All Service - no
• This normally uses *72 to Forward all calls to the target
  specified after the activation code, and *73 to Cancel call forward
  all.
• FreePBX provides the same functions using the same feature
  codes by default, and in addition uses *74 for Call Forward All
  Prompting Deactivate.

• Cfwd Busy Serv - Enable Call Forward Busy Service - no
• This normally uses *90 to Forward busy calls to the target
  specified after the activation code, and *91 to Cancel call forward
  busy.
• FreePBX provides the same functions using the same feature
  codes by default, and in addition uses *92 for Call Forward Busy
  Prompting Deactivate.

• Cfwd No Ans Serv - Enable Call Forward No Answer Service - no
• This normally uses *92 to Forward no-answer calls to the
  target specified after the activation code, and *93 to Cancel call
  forward no-answer.
• FreePBX provides the same functions using *52 for Call
  Forward No Answer/Unavailable Activate, and *53 for Call Forward No
  Answer/Unavailable Deactivate.
• FreePBX by default uses *92 for Call Forward Busy Prompting Deactivate.

• Cfwd Sel Serv - Enable Call Forward Selective Service - no
• FreePBX doesn't provide this YET so you could enable it if you really need it, but most users don't.
• Configured in the user tab of the device's web interface, does not use any feature codes.

• Cfwd Last Serv - Enable Forward Last Call Service - no
• This normally uses *63 to Forward the last inbound or
  outbound calls to the target specified after the activation code, and
  *83 to Cancel call forward last.
• At present FreePBX does not use the *63 or *83 codes for anything by default.

• Block Last Serv - Enable Block Last Call Service - no
• This normally uses *60 to Block the last inbound call, and *80 to Cancel blocking of the last inbound call.
• FreePBX has the ability to maintain a blacklist, though not yet on a per-extension basis.
• FreePBX by default uses *60 for the Speaking Clock, and *80 as the Intercom prefix.

• Accept Last Serv - Enable Accept Last Call Service - no
• This normally uses *64 to Accept the last outbound call. Let
  it ring through when DND or Call Forward All is in effect. It also uses
  *84 Cancel Accept Last.
• FreePBX does not appear to provide this feature at the
  preset time, although there is a code to remove a number from the
  blacklist.
• At present FreePBX does not use the *64 or *84 codes for anything by default.

• DND Serv - Enable Do Not Disturb Service - no
• This normally uses *78 to Enable Do Not Disturb, and *79 to Disable Do Not Disturb.
• FreePBX provides the same functions using the same feature codes by default.

• CID Serv - Enable Caller ID Service - yes
• If this isn't activated, the device won't send Caller ID information to the telephone.
• This normally uses *65 to Enable Caller-ID Generation and *85 to Disable Call-ID Generation.
• These codes may need to be changed or deactivated to avoid a conflict with FreePBX feature codes.
• At present FreePBX uses *65 for Speak Your Exten Number. FreePBX does not use *85 at present.

• CWCID Serv - Enable Call Waiting Caller ID Service - yes
• If this isn't activated, the device won't send Caller ID on Call Waiting information to the telephone.
• This normally uses *25 to Enable Call Waiting Caller-ID generation, and *45 to Disable Call Waiting Caller-ID generation.
• These codes may need to be changed or deactivated to avoid a conflict with FreePBX feature codes.
• At present FreePBX does not use the *25 or *45 codes for anything by default.

• Call Return Serv - Enable Call Return Service - no
• This normally uses *69 to Call the last caller.
• FreePBX uses *69 for Call Trace, which provides the same feature but with additional functionality.

• Call Back Serv - Enable Call Back Service - no
• This normally uses *66 to Callback when the last outbound call is not busy, and *86 to Cancel callback.
• FreePBX does not appear to provide this feature at the preset time.
• At present FreePBX does not use the *66 or *86 codes for anything by default.

• Three Way Call Serv - Enable Three Way Calling Service - yes
• Three Way Calling is required for Three Way Conference and Attended Transfer

• Three Way Conf Serv - Enable Three Way Conference Service - yes
• Three Way Conference is required for Attended Transfer.

• Attn Transfer Serv - Enable Attended Call Transfer Service - yes
• This is when you flash, call a third party, speak to them privately, then hang up and the original call transfers.
• Does not use any feature codes.

• Unattn Transfer Serv - Enable Unattended (Blind) Call Transfer Service - yes
• This normally uses *98 to Blind transfer current call to the target.
• FreePBX uses *98 for Voicemail access by default, however
  there is usually no conflict because the code is used in different
  contexts.
• Blind transfer only works if the caller is engaged in a
  call, flashes to a second dial tone, dials *98, then waits for an
  additional dial tone and dials the number the call is to be transferred
  to, therefore *98 works normally for retrieving voicemail if the user
  does not have an existing call on hold.
• This feature can be disabled (or the feature code changed)
  if there is a desire to be able to flash away from a call and retrieve
  voicemail.

• MWI Serv - Enable MWI Service - yes
• MWI is available only if a Voice Mail Service is set-up in the deployment

• VMWI Serv - Enable VMWI Service (FSK) - yes
• This is the service that activates the message waiting light on most phones

• Speed Dial Serv - Enable Speed Dial Service - no
• This normally uses *74 to Assign a speed dial number.
• FreePBX uses *74 for Call Forward All Prompting Deactivate.
• FreePBX provides user speed dial functions (using the *75 code by default).

• Secure Call Serv - Enable Secure Call Service - no
• As far as I know, Asterisk doesn't yet support this.
• This normally uses *16 to make all outbound calls secure and *17 to make all outbound calls not secure.
• It also uses *18 make the next outbound call secure, and *19 to make the next outbound call not secure.
• At present FreePBX does not use the *16, *17, *18, or *19 codes for anything by default.

• Referral Serv - Enable Referral Service - yes
• This has no effect unless you add some referral service codes, in which case you probably know what you're doing.

• Feature Dial Serv - Enable Feature Dial Service - yes
• This has no effect unless you add some feature dial service codes, in which case you probably know what you're doing.

• Service Announcement Serv - Undocumented (does anyone know what this is?) - no

When you are all finished your Supplementary Service Subscription
settings should look something like this (note that this may be
slightly different from your unit, depending on the actual model you
have):

If your device is a multi-line unit, don't forget to make these changes in the Line tab associated with each line of the device that is used with FreePBX!

Vertical Service Activation Codes (Feature Codes)

If you have used the suggested settings EXACTLY as shown above,
then you don't have to change or blank out many of the Vertical Service
Activation Codes (found under Admin login, select Advanced view, Regional
tab). The following are the changes that I do suggest. The yellow
highlighted text shows the existing code assignments in a PAP2 - where
followed by NA
that means the feature is deactivated (again, only IF you followed the
suggested settings above EXACTLY) so you don't have to worry about that
code. Where a feature needs to stay activated but there's a potential
code conflict, I suggest how to deal with it. In this, I make certain
assumptions - for example, that you don't want to be able to
accidentally deactivate a feature such as call waiting, caller ID, or
distinctive ringing.

Note that after you make these changes you MUST go to the device's User
tab(s) and set the dropdowns in the Supplementary Service Settings
section to known values, otherwise the device may not work as expected.
More on that in a moment.

This list is obviously subject to change if FreePBX adds or changes feature codes! It is current as of December 20, 2006:

First column (PAP2):

Call Return Code: *69 NA

Call Back Act Code: *66 NA

Cfwd All Act Code: *72 NA

Cfwd Busy Act Code: *90 NA

Cfwd No Ans Act Code: *92 NA

Cfwd Last Act Code: *63 NA

Block Last Act Code: *60 NA

Accept Last Act Code: *64 NA

CW Act Code: *56 (Delete this entry)

CW Per Call Act Code: *71 (Delete this entry)

Block CID Act Code: *67 NA

Block CID Per Call Act Code: *81 NA

Block ANC Act Code: *77 NA

DND Act Code: *78 NA

CID Act Code: *65 (Delete this entry)

CWCID Act Code: *25 (Delete this entry)

Dist Ring Act Code: *26 (Delete this entry)

Speed Dial Act Code: *74 NA

Secure No Call Act Code: *17 NA

Secure One Call Deact Code: *19 NA

Attn-Xfer Act Code: (Blank by default)

Second column (PAP2):

Blind Transfer Code: *98 (Same as FreePBX voicemail but used in different contexts, suggest leaving as is but change if desired)

Call Back Deact Code: *86 NA

Cfwd All Deact Code: *73 NA

Cfwd Busy Deact Code: *91 NA

Cfwd No Ans Deact Code: *93 NA

Cfwd Last Deact Code: *83 NA

Block Last Deact Code: *80 NA

Accept Last Deact Code: *84 NA

CW Deact Code: *57 (Delete this entry)

CW Per Call Deact Code: *70 (Suggest leaving as is wherever *70 is PSTN standard for per call call waiting deactivation)

Block CID Deact Code: *68 NA

Block CID Per Call Deact Code: *82 NA

Block ANC Deact Code: *87 NA

DND Deact Code: *79 NA

CID Deact Code: *85 (Delete this entry)

CWCID Deact Code: *45 (Delete this entry)

Dist Ring Deact Code: *46 (Delete this entry)

Secure All Call Act Code: *16 NA

Secure One Call Act Code: *18 NA

Conference Act Code: (Blank by default)

Modem Line Toggle Code: *99
(Not in all adapters, conflicts with FreePBX "Check Recording", suggest
you delete UNLESS you have a device that attempts to send data through
the adapter, in which case it might be better to change the "Check
Recording" code in FreePBX to some unused code like *76)

AFTER you make the above changes and save them (by clicking on "Save Settings"), go to the device's User tab(s) (User 1 and User 2 in a PAP2, SPA-2000, etc.), Supplementary Service Settings section, and make sure that the options there are set like this:

If you need to change any of these, be sure to once again click
"Save Settings" at the bottom of the page, and don't forget to do this
in each User tab if there is more than one.

List of default feature codes

Here is a list of default feature codes used by Linksys/Sipura, FreePBX, and Trixbox. Code conflicts are shown in red (for conflicts of dissimilar functions) or orange (for conflicts of similar functions):

** FreePBX: Call Pickup (Can be used with GXP-2000)

*0 FreePBX: Speeddial prefix

*11 FreePBX: User Logon

*12 FreePBX: User Logoff

*16 Linksys/Sipura: Make all outbound calls secure

*17 Linksys/Sipura: Make all outbound calls not secure

*18 Linksys/Sipura: Make the next outbound call secure. This operation is redundant if all outbound calls are secure by default.

*19 Linksys/Sipura: Make the next
outbound call not secure. This operation is redundant if all outbound
calls are not secure by default.

*25 Linksys/Sipura: Enable Call Waiting Caller-ID generation

*26 Linksys/Sipura: Enable Distinctive Ringing

*30 FreePBX: Blacklist a number

*31 FreePBX: Remove a number from the blacklist

*32 FreePBX: Blacklist the last caller

*34 FreePBX: Perform dictation

*35 FreePBX: Email completed dictation

*43 FreePBX: Echo Test

*45 Linksys/Sipura: Disable Call Waiting Caller-ID generation

*46 Linksys/Sipura: Disable Distinctive Ringing

*52 FreePBX: Call Forward No Answer/Unavailable Activate

*53 FreePBX: Call Forward No Answer/Unavailable Deactivate

*54 FreePBX: User lntercom Allow

*55 FreePBX: User lntercom Disallow

*57 Linksys/Sipura: Disable Call Waiting on all calls

*60 FreePBX: Speaking Clock

*60 Linksys/Sipura: Block the last inbound call

*61 Trixbox: Weather

*62 Trixbox: Wakeup

*63 Linksys/Sipura: Forward the last inbound or outbound calls to the target specified after the activation code

*64 Linksys/Sipura: Accept the last outbound call. Let it ring through when DND or Call Forward All is in effect

*65 FreePBX: Speak Your Exten Number

*65 Linksys/Sipura: Enable Caller-ID Generation

*66 Linksys/Sipura: Callback when the last outbound call is not busy

*67 Linksys/Sipura: Block CID on all outbound calls

*68 Linksys/Sipura: Unblock CID on all outbound calls

*69 FreePBX: Call Trace

*69 Linksys/Sipura: Call the last caller.

*70 FreePBX: Call Waiting - Activate

*70 Linksys/Sipura: Disable Call Waiting for the next call

*71 FreePBX: Call Waiting - Deactivate

*71 Linksys/Sipura: Enable Call Waiting for the next call

*72 FreePBX: Call Forward All Activate

*72 Linksys/Sipura: Forward all calls to the target specified after the activation code

*73 FreePBX: Call Forward All Deactivate

*73 Linksys/Sipura: Cancel call forward all

*74 FreePBX: Call Forward All Prompting Deactivate

*74 Linksys/Sipura: Assign a speed dial number

*75 FreePBX: Set user speed dial

*77 FreePBX: Save Recording

*77 Linksys/Sipura: Block all anonymous calls

*78 FreePBX: DND Activate

*78 Linksys/Sipura: Enable Do Not Disturb

*79 FreePBX: DND Deactivate

*79 Linksys/Sipura: Disable Do Not Disturb

*80 FreePBX: Intercom prefix

*80 Linksys/Sipura: Cancel blocking of the last inbound call

*81 Linksys/Sipura: Block CID on the next outbound call

*82 Linksys/Sipura: Unblock CID on the next inbound call

*83 Linksys/Sipura: Cancel call forward last

*84 Linksys/Sipura: Cancel Accept Last

*85 Linksys/Sipura: Disable Call-ID Generation

*86 Linksys/Sipura: Cancel callback

*87 Linksys/Sipura: Unblock all anonymous calls

*90 FreePBX: Call Forward Busy Activate

*90 Linksys/Sipura: Forward busy calls to the target specified after the activation code

*91 FreePBX: Call Forward Busy Deactivate

*91 Linksys/Sipura: Cancel call forward busy

*92 FreePBX: Call Forward Busy Prompting Deactivate

*92 Linksys/Sipura: Forward no-answer calls to the target specified after the activation code

*93 Linksys/Sipura: Cancel call forward no-answer

*97 FreePBX: My Voicemail

*98 FreePBX: Dial Voicemail

*98 Linksys/Sipura: Blind transfer current call to the target specified after the activation code

*99 FreePBX: Check Recording

*99 Linksys/Sipura: Modem Line Toggle Code