NOTE: PLEASE READ THIS ENTIRE DOCUMENT BEFORE ENTERING THE URL LISTED BELOW INTO YOUR DEVICE. THIS URL WILL OVERWRITE SETTINGS THAT ARE ALREADY PRESENT AND THE SETTINGS IT WILL CHANGE ARE CLEARLY LISTED BELOW. I ACCEPT NO RESPONSIBILITY FOR ANY LOSSES (SUCH AS YOUR OWN TIME) THAT MAY OCCUR AS A RESULT OF USING THIS CONFIGURATION FILE. THESE SETTINGS WILL NOT DAMAGE YOUR HARDWARE BUT COULD RESULT IN THE INABILITY TO DIAL SOME NUMBERS IF THE DIALPLAN DOES NOT MATCH YOUR CURRENT ONE.
INSTRUCTIONS ON HOW TO REMOVE THIS CONFIGURATION ARE AT THE BOTTOM OF THIS POST.
If you're using a VoIP provider there is a good chance you may well have a Linksys IP phone or Analogue Telephone Adapter (ATA). The Linksys 92x/94x series of IP phone, SPA2102 and 3102, and older SPA3000 and PAP2 ATA's are a very popular choice due to their great performance and reasonable pricing.
If you live in New Zealand and are using one of these are a handful of configuration changes that need to be made to configure the device to New Zealand telephone standards and to ensure that the tones heard match those from PSTN providers such as Telecom, TelstraClear, Orcon and Vodafone who all use the same tones which are specified in Telecom's Telepermit specifications. If you fail to correctly set some other settings such as the FXS impedance on your device you risk echo on your calls due to an impedance mismatch with your analogue phone, likewise if you set the incorrect impedance on the FXO port on a SPA3102 or SPA3000 you will also risk echo due an impedance mismatch with the PSTN line. Ideally you'll also want a correct dialplan that allows calls to connect immediately after you dial the number, and not have to wait several seconds for this to happen.
At present WorldxChange are the only VoIP provider in New Zealand to offer a full autoprovisiong service for their customers. If you sign up to their VFX or DVX service you can enter a URL into your device which will connect to their servers and correctly configure your device with the optimal settings and user settings.
DO NOT USE THIS FILE IF YOU ARE ON VFX or DVX. THERE IS NO NEED AND IT WILL WIPE YOUR CONFIGURATION!
If you're using another provider such as 2talk, iTalk, or a Linksys device on your own IP PBX, you're on your own when it comes to configuring your device. These providers and others provide a list of settings, however many of these are either not correct or not optimal for New Zealand. This leaves people who know nothing about VoIP left to configure their own device, and in many cases making mistakes or using incorrect settings that may result in an inferior quality call, and left blaming VoIP as being an inferior technology when the reality is it's not.
I've been working for several weeks on a New Zealand specific configuration file for Linksys devices, and also hosting this file so that anybody who wants to quickly and easily configure their device can enter a web URL into their device which will download all the correct settings. The only thing required by the end user is to configure their SIP user account details, network settings, and a couple of other optional setting that I'll leave to the end user such as the preferred voice codec. By default your device will check once per week for a new configuration file however this can be easily disabled if you do not want to do this. Instructions on how to change this are at the bottom.
To enable this provisioning file log into your device and click on the Provisioning tab. Into the Profile Rule field enter the following http://voipzone.co.nz/spaconfig.cfg Also check that the Provision Enable is set to Yes and Resync On Reset is also set to Yes
Your device will now reset and download the provisioning file. This can take approximately 30 seconds or so to occur and once it is complete the device will reset again. If you look in the menu options listed below you should now see these updated to reflect the new settings.
A list of all settings in my file is listed here. This file could change in the future if any updates are needed and because it's a XML file rather than a LInksys compiled configuration file you can view the contents of the file at any time from a web browser by entering the URL above.
CONTENTS OF THIS PROVISIONING FILE
<!-- Linksys SPAxxx Config File with NZ specific indications and setup (C)2010 Steven Biddle firstname.lastname@example.org ->
<Call_Return_Code ua="na"> </Call_Return_Code>
<Blind_Transfer_Code ua="na"> </Blind_Transfer_Code>
<Call_Back_Act_Code ua="na"> </Call_Back_Act_Code>
<Call_Redial_Code ua="na"> </Call_Redial_Code>
<Call_Back_Busy_Act_Code ua="na"> </Call_Back_Busy_Act_Code>
<Cfwd_All_Act_Code ua="na"> </Cfwd_All_Act_Code>
<Cfwd_All_Deact_Code ua="na"> </Cfwd_All_Deact_Code>
<Cfwd_Busy_Act_Code ua="na"> </Cfwd_Busy_Act_Code>
<Cfwd_Busy_Deact_Code ua="na"> </Cfwd_Busy_Deact_Code>
<Cfwd_No_Ans_Act_Code ua="na"> </Cfwd_No_Ans_Act_Code>
<Cfwd_No_Ans_Deact_Code ua="na"> </Cfwd_No_Ans_Deact_Code>
<Cfwd_Last_Act_Code ua="na"> </Cfwd_Last_Act_Code>
<Cfwd_Last_Deact_Code ua="na"> </Cfwd_Last_Deact_Code>
<Accept_Last_Act_Code ua="na"> </Accept_Last_Act_Code>
<Accept_Last_Deact_Code ua="na"> </Accept_Last_Deact_Code>
<Block_Last_Act_Code ua="na"> </Block_Last_Act_Code>
<Block_Last_Deact_Code ua="na"> </Block_Last_Deact_Code>
<CW_Act_Code ua="na"> </CW_Act_Code>
<CW_Deact_Code ua="na"> </CW_Deact_Code>
<CW_Per_Call_Act_Code ua="na"> </CW_Per_Call_Act_Code>
<CW_Per_Call_Deact_Code ua="na"> </CW_Per_Call_Deact_Code>
<Block_CID_Act_Code ua="na"> </Block_CID_Act_Code>
<Block_CID_Deact_Code ua="na"> </Block_CID_Deact_Code>
<Block_CID_Per_Call_Act_Code ua="na"> </Block_CID_Per_Call_Act_Code>
<Block_CID_Per_Call_Deact_Code ua="na"> </Block_CID_Per_Call_Deact_Code>
<Block_ANC_Act_Code ua="na"> </Block_ANC_Act_Code>
<Block_ANC_Deact_Code ua="na"> </Block_ANC_Deact_Code>
<DND_Act_Code ua="na"> </DND_Act_Code>
<DND_Deact_Code ua="na"> </DND_Deact_Code>
<Secure_All_Call_Act_Code ua="na"> </Secure_All_Call_Act_Code>
<Secure_No_Call_Act_Code ua="na"> </Secure_No_Call_Act_Code>
<Secure_One_Call_Act_Code ua="na"> </Secure_One_Call_Act_Code>
<Secure_One_Call_Deact_Code ua="na"> </Secure_One_Call_Deact_Code>
<Paging_Code ua="na"> </Paging_Code>
<Call_Park_Code ua="na"> </Call_Park_Code>
<Call_Pickup_Code ua="na"> </Call_Pickup_Code>
<Call_UnPark_Code ua="na"> </Call_UnPark_Code>
<Group_Call_Pickup_Code ua="na"> </Group_Call_Pickup_Code>
<Media_Loopback_Code ua="na"> </Media_Loopback_Code>
<Referral_Services_Codes ua="na"> </Referral_Services_Codes>
<CID_Act_Code ua="na"> </CID_Act_Code>
<CID_Deact_Code ua="na"> </CID_Deact_Code>
<CWCID_Act_Code ua="na"> </CWCID_Act_Code>
<CWCID_Deact_Code ua="na"> </CWCID_Deact_Code>
<Dist_Ring_Act_Code ua="na"> </Dist_Ring_Act_Code>
<Dist_Ring_Deact_Code ua="na"> </Dist_Ring_Deact_Code>
<Speed_Dial_Act_Code ua="na"> </Speed_Dial_Act_Code>
<Modem_Line_Toggle_Code ua="na"> </Modem_Line_Toggle_Code>
<Ring5_Cadence ua="na"> </Ring5_Cadence>
<Ring6_Cadence ua="na"> </Ring6_Cadence>
<Ring7_Cadence ua="na"> </Ring7_Cadence>
<Ring8_Cadence ua="na"> </Ring8_Cadence>
A BRIEF RUNDOWN OF THE SETTINGS
RESYNC PERIODIC = time of 604800 which is 7 days. The device will check every 7 days (or on reset) for a new configuration.
NTP/Time settings = Use nz.pool.ntp.org as a time server. Also correctly configure NZ DST settings. Because of a bug in earlier Linksys firmware not being able to handle DST in the Southern Hemisphere starting in a different year to the end date we reverse things and use GMT+13 as the normal time during DST and deduct 1hr from April to September.
All service activation codes have been disabled to stop them clashing with codes your VoIP provider or PBX may use. Depending on your setup you may wish to set some of these again. For example if you use an ATA you will not get the correct Call Forward dialtone with DND/CallFwd enabled if you do not map these to your VoIP provider or PBX as the ATA has no idea about these codes. This is not needed with an IP phone as the DND/Cfwd is managed via SIP messages.
All tones have been set to the NZ standard as defined by Telecom's TNA102 specifications. The only exception to this is the Reorder tone which is technically incorrect but these devices use this tone differently to normal POTS phones. All tones have been set to -15dB which is slightly louder than the -19dB Linksys default settings (I'm open to discussion as to whether this is too loud or too quiet, I personally think it's about right). Distinctive Ring cadences have also been set to the Telepermit specifications.
RTP packet size has been set to 20ms and both FXO and FXS line impedance has been set to the correct 370+620||310nF that is used here in NZ (and is clearly documented in the Telepermit specifications).
Some new firmware releases from Linksys do not support this setting. If this option is not available the safest option to use is 600 Ohm.
And now to look at the dialplan. This will pattern match virtually every number that the normal person will need to call. I've detailed the number ranges below and how they are matched. While I've put a lot of effort into this there is a chance that some errors may exist or there could be service numbers or calling card access numbers that I have missed. Any feedback on these is appreciated.
# = Asterisk/FreePBX directory
*xx = Asterisk/FreePBX shortcodes
*0xx.= Linksys codec selection. Also pattern matches *0 for Epygi Quadro Voicemail access
[2-9]xxxxxx = local calls
xxxS1 = local 3 digit PBX extns with short timeout as well as 3 digit emergency and service codes 111, 123 etc
0210xxxxxxx = 0210 + 8 digits
0212xxxxxx = 0212 + 7 digits
021[3-9]xxxxx = 0213 - 0219 + 6 digits
02xxxxxxx = 020 + 022 + 027 + 029 + 7 digits
0240xxxxxx = 0240 + 6 digits
024[1-9]xxxxxxx = 0241 - 0249 + 7 digits
028xxxxxx = 0280 + 0281 + 0283 + 0284 + 0285 + 0286 + 0287 + 7 digits
028xxxxxxx = 0282 + 0288 + 0289 + 8 digits
026[1-3]xxxxx = 0261 + 0262 + 0263 + 6 digits
0264xxxxxx = 0264 + 7 digits
0[0-9]xxxxxx = all 03 + 04 + 06 + 07 + 09 toll calls as well as 0900
0508xxxxxx = 0508
070xxxxxxx = 070 personal numbers. Allocated for use but not currently in use. Possible that shortly they may be available.
080[1-8]xxxxxx = 0800 + 0800 - 0808 as defined by NAD guidelines but not currently used
1xxx = service codes mainly Telecom
08[2-3]xxx = 082210 and 083210 for voicemail on WxC and Telecom and Telecom's 083030, 083032 and 083033 conferencing
01681x. = Telecom's USA toll free service for calling North American toll free 800 numbers
083201234 = recorded message number you are calling from
014xx = calling card platform
015xxx = calling card platform
017 = 0170 and 0172 for international directories
00x. = international calls
In trying to create a dialplan that can be used across both standalone phones and phones connected to a PBX there is one small issue I am aware of that is not possible (at least that I can work out!) to resolve. To try and pattern match local 3 digit PBX extensions as well as local 7 digit numbers means using a small delay (S1) after the phone detects 3 digits. If you are dialling a 7 digit local number and pause for too long after the 3rd digit you will find that the call is pattern matched as a 3 digit local number.
OPTIONAL SECURITY SETTING
VoIP "hacking" is becoming a real risk these days and if you have an insecure VoIP device you are leaving yourself wide open to possible fraud. Do not under any circumstances port forward the web interface for your IP phone or ATA so it's accessible from the web. This is about as secure to leaving your front door wide open!
From VoIP security perspective inbound URI calling also poses security risks that end users need to be aware of. URI calling is the ability to call another SIP device directly over the internet without the call going via a VoIP provider or PSTN. If you have a Linksys ATA at home on your internet connection somebody else using a VoIP device can call you directly by dialling the SIP URI email@example.com, ie firstname.lastname@example.org
There have been numerous cases lately of SIP trojans actively scanning devices looking for valid user accounts. Once it detects a SIP device on port 5060 it repeatedly tries usernames until it finds the correct one. I recommend that you set "'AUTH INVITE" to 'YES' in your Linksys device configuration. This will only allow a SIP invite message from an authorised SIP peer (ie your VoIP provider). This setting will disable the ability to accept inbound SIP URI calls so if you need this ability do not change this setting.
EDIT: It seems this setting may disable inbound calls on iTalk and 2talk. If you are using iTalk or 2talk leave this setting set to 'no'. Another option which exists only in the ATA devices called 'Restrict Source IP' that will lock down inbound SIP traffic to the IP of your SIP proxy server. Setting this to 'yes' will perform a similar job.
HOW TO REMOVE OR DISABLE THESE SETTINGS
As mentioned above entering this provisioning URL this file will cause the device to attempt to reprovision itself once every 7 days to get an updated configuration file. If you want to disable this feature set the "Provision Enable" setting show in the web interface menu above to "NO". If you are going to change any of the settings listed above such as the Service Activation Codes it's important that you change this setting to "NO". If you fail to do this your changes will be deleted every week when the device checks for a new configuration file.
If you are uncertain about proceeding with this URL I recommend taking a snapshot of your current settings, in particular your dialplan before proceeding. This file will only change the settings listed above, it will not change any other settings in your device such as network or SIP user settings. If you are unhappy with the results you can return to your existing configuration by disabling the Provision Enable setting as detailed in the paragraph above, removing the provisioning URL, and manually entering your settings again.
I've been using Linksys devices for many years but only recently decided to publish this information because the number of poorly configured devices and misinformation about NZ configurations got the better of me! I'm open to any feedback or comments about this project and am very interested in comment about the dialplan settings. It is possible this setting may stop you being able to dial some numbers and some PBX's may use different codes that I have not included. Please let me know about any issues so I can attempt to resolve them.
I have also developed a modified trixbox Linksys autoprovisioning tool that will help those who are using Asterisk, trixbox or Elastix and want to correctly configure their Linksys devices with their PBX. For help with this or to suggest improvements my contact details are listed in the right.
PS: Thanks also has to go to Mike Beattie who helped test the dialplan settings.
PPS: If you are going to include these settings on your site some link love to my post and acknowledgement would be appreciated.
Other related posts:
Obihai OBi 200 Analogue Telephone Adapter (ATA) Review
Raspberry Pi – the ultimate home Asterisk PBX.
G.722 HD Audio. What’s the big deal?
Comment by hads, on 20-Apr-2010 12:28
Nice work Steve, I'm sure it will be very helpful to a lot of users if they take the time to use it.
Do you know if the Cisco SPA500 series use the same style provisioning?
I've got a basic dialplan for snom phones here;
doesn't include as many service codes etc. as yours but is still be useful for those using snom phones.
Comment by richms, on 20-Apr-2010 17:24
Plenty of phones work better with the standard 600 ohm impedance rather than the telecom non standard one.
I dont think that it actually matters for telepermiting, you just give them a report from some place they accept reports from.
I got less echo problems off one of my cordlesses when changing it to 600 which made conversations bareable over it.
Comment by Skolink, on 20-Apr-2010 22:42
I wish you'd posted this a couples of months ago - the hours I spent trying to correctly configure the SPA8000 for 2Talk...
Great info and explanations, thanks.
Comment by vespaman, on 21-Apr-2010 08:38
Good work. It's been trial and error for years with the SPA's. I've noticed some versions of firmware on different SPA devices don't retain the changes somehow unless you actually reboot them every time you change something. Thanks for the tip on the impedance - will check my set up.
Comment by petercox, on 24-May-2010 13:41
Wow, that's fantastic. I've had all sorts of odd problems with VOIP, and though I've only just tried it, there seems to be a big improvement in responsiveness.
Comment by jpoff, on 30-Jul-2010 15:59
I do not see a code in there for Pager numbers starting with 0868 or 0865, both with 5 digits after them. There may be other pager numbers, but these are two I am aware of.
Comment by Alan Pugh, on 12-Aug-2010 12:15
Hi Steve That's a great post thanks. At home I have a analoguephone - PAP2T - TelstraClearCable - 2Talk system in place. I configured the ATA using the guide on the 2Talk site. The phone works 90% correctly but incoming dialers sometimes have problem phoning me ('it doesn't ring'). What's your hunch, is that something I could fix by changing the config? Thanks, Alan
Comment by hasso, on 16-Sep-2010 12:31
Good job on the dialplan. I did notice your comment re: a small delay (S1) after the phone detects 3 digits. Most of the time my big fingers are not fast enough to get past three digits which means I'm constantly calling things like 021 instead of 021blahblahblah.... Any more thought on how this could be avoided? Right now I've changed xxxS1 to 111S1.
Comment by Binh, on 4-Nov-2010 13:31
Thanks for this information. I have a Linksys PAP2T, do you think this configuration will work? I've set it up to work with iTalk and things seem to be ok. I have a question if you can help. With my Linksys PAP2T + iTalk, when someone calls me, the number shows up as "6491234567" which is a pain because I *can't* call it back from iTalk using my phone. Its a pain when you get a missed call and all you want to do is just see the miss call and press the dial button. Would you know if it's just a matter of changing the dial plan or something else? Any help appreciated. Many thanks,
Comment by gordonz, on 10-Dec-2010 09:04
Thanks Steve, made the process of setting up my SPA8000 for 2 talk so quick and easy, much appreciated!
Comment by 0224warwick, on 3-Feb-2011 18:28
Gdaym8. I bought an SPA9000 new for $15.50 on Trademe, and I've only got an analogue fax/phone at the moment.
Got it configured so it's registered, and it can receive calls, but can't dial out and the ring tone is scrappy.
I'm need to get this working properly, and would like to load your file to provision it better.
I realise this has probably been dealt with in other posts elsewhere.
But you the man, Your provisioning file probably won't solve the no ringing in though? or will it.?
I *ucked around with this too much already.
It would have been better to buy a 2102, or a pap2t I guess, but it sounds like they would still need your download to get the ring tones right.
Comment by 0224warwick, on 3-Feb-2011 19:14
P.S. I'm with WXC, and although some of the guys have been helpful, they don't support this device, so even though I'm a customer, I'm on my own.
I tried to go back into my device as you said, but found that I was locked out.
WXC informed me that once the line is registered they lock access.
So, that's not helpful if there are still things not right, and then they say ,TRY GEEKZONE.
Damn it takes a long time to figure out all the traps and what's what, and where to get the right stuff from.
Comment by Warwick, on 4-Feb-2011 16:01
Hi , Steve. The dial tone is music to the ears thanks to your provisioning file. Cool.
Comment by snowfly, on 14-Feb-2011 13:24
Do you have a new location for this linksys VoIP config file?
Appears that the domain voipzone.co.nz was cancelled on 12 Feb 2011.
Comment by ocs, on 17-Feb-2011 20:25
I've had a SPA9000 running for about 2 years. I had more than my share of frustration in setting it up initially but it's been stable now for many months and I wouldn't get rid of it. It has much more functionality than my previous SPA3010 including being able to have multiple lines and multiple phones. I use separate lines for the house and for working from home. For $15 your one certainly was a bargain.
I connect to italk and although their support staff know very little about their product, it works and I can't fault their product.
Two hints that may help:
DTMF problems - resolved by changing settings on FXS1/2:
DTMF Tx Method: INFO
DTMF Detection Mode: NORMAL
Call quality - fix on Regional:
FXS Port Input Gain: -3
FXS Port Output Gain: -2
Many other changes that I've made - most of them I've forgotten.
Comment by Warren, on 10-Mar-2011 15:47
to answer binh's question about italk prefix 064(x)xxxxxxx, I have worked out a way to redial with number substitution, add the following to your dialplan xxxxxxxx
Comment by Warren, on 10-Mar-2011 17:26
Comment by Warren, on 10-Mar-2011 17:28
for some reason the webpage continues to dlete the correct dialplan I post, it is as follows: ( xxxxxxxx ) or T064:0Txxxxxxxx otherwise substitute capital T with triangle brackets
Comment by amok, on 14-Apr-2011 06:41
How much do you know about the RTA1046VW?
Comment by davemc, on 10-Jun-2011 14:46
Link appears not to be working. Gives 404 error.
Comment by Warren, on 11-Aug-2011 18:42
Hey Steve, This is a really nice write up, some questions... In the dial plan you have 0210xxxxxxx = 0210 + 8 digits 0212xxxxxx = 0212 + 7 digits Why is this?
Comment by Harry, on 6-Oct-2011 11:20
Hi Steve. Ive used Slingshot's iTalk service for almost 2 years now and added your URL for the config file into my SPA2102 earlier this year. I've noticed that since then, whenever we get an incoming call on call waiting, our outgoing audio mutes for about 5 seconds. We can still hear the existing caller along with the call waiting beeps, but the other party doesn't hear us for that short period. I know Slingshot say that call waiting is not supported on iTalk, so this could be part of the reason, but if you have any info, then that would be most appreciated. Thanks Harry
Comment by mthand, on 12-Oct-2011 21:10
Try going to the Regional Tab, Distinctive Call Waiting Tone Patterns, change CWT Cadence from 10(.2/3,.2/3,.2/3) to 30(.3/9.7)
I had exactly the same issue, and it was fixed by changing this (which is recommended by 2Talk)
Comment by Alex Ortiz G, on 4-Nov-2011 16:51
"I have also developed a modified trixbox Linksys autoprovisioning tool that will help those who are using Asterisk, trixbox or Elastix and want to correctly configure their Linksys devices with their PBX. For help with this or to suggest improvements my contact details are listed in the right." ..........Mr. Biddle, I most certainly would love to take you up on that autoprovisioning tool. And of course we will be more than delighted to set up links or tags to your site, for the credits and all the smiles :) you´ve less thought of recieving from a lot of our happy customers. Alex Ortiz Marketing Director Servicios Internos Inc. email@example.com México City, MX. http://serviciosinternos.net
Comment by Tony, on 5-Jul-2012 16:53
Hi will the provisioning file work with the SPA122. Cheers Tony
Comment by Lakshmi Toleti, on 27-Jul-2012 16:33
Hi Steve, It happened to see your webpage when I google for some device. I thought I would request your suggestion on that. I am looking for a router/modem which got 1) A DSL port to connect to ISP 2) few ethernet ports to connect to PC etc 3) WiFi capable (usual range or extended range) 4) Phone ports (for VoIP/ATA/PSTN) I know there are some models in Cisco which got all the features above except DSL. Could you please suggest a model which got all above..? I enquirer in DickSmith, Horvey Norman, JB, NoelL, BondNBond etc... No luck, sales guys get confused and says no. Your suggestion is highly appreciated. Thanks Lakshmi Toleti
Comment by Peter Flowers, on 11-Dec-2012 21:57
Hi Steve I have used this successfully in the past on a couple of occasions and ithas been a huge time saver. Thanks. Tried again tonight and it seems like http://voipzone.co.nz has disappeared off the face of the internet. Is this domain no longer active? thanks
Comment by pdjackson, on 28-Nov-2015 15:59
Not sure if anyone is looking here anymore, but...
My SPA was working well until fibre broadband came along. Now it does not detect the disconnect tone.
Any suggestions? Suspect there has been a change in the tone slightly or the levels? Nothing I have tried yet helps.
Comment by John Kenderdine, on 17-Jan-2016 12:10
Hi - I have been using a voip phone on slingshot for a few years and have a SPA2102 ATA box and recently it has turned to custard and slingshot have been totally unhelpful. I am not technically competent in this field and am wondering if anyone can help - my signal is from a friends place using Engenius aerials, so I am dependent on their router and power supply.All has worked reasonably well with some poor incoming signals during peak usage time.But now it has stopped all outgoing signals - just going "beep, beep, beep" except very occasionally - incoming calls are mostly diverted immediately to the answer service and I can access them on email.But occasional an incoming call will get thru??My friends have tried a new router and I have tried a new phone - no successAny thoughts on this?cheers, John Kenderdine (74 year old luddite)