Difference between revisions of "Linksys SPA3000"

From LinuxMCE
Jump to: navigation, search
(General Information)
 
(22 intermediate revisions by 7 users not shown)
Line 1: Line 1:
 +
[[Category:Hardware]]
 +
[[Category:Telecom]]
 +
[[Category:VoIP]]
 +
[[Category:ATA]]
 +
{{merge|Linksys SPA3102}}
 +
 +
 
== General Information ==
 
== General Information ==
 +
 +
 +
Note: '''these instructions are obsolete'''. Go to the Linksys SPA3102 page for newest.
 +
  
 
The Sipura (now bought out by Linksys) spa 3000 is a pstn (analog phone line) to Asterisk gateway device that provides a SIP interface for 1 FXO port (analog phone line) and 1 FXS port (analog phone). This allows you to use the Telecom section of LMCE, and use Asterisk to send/recieve/route phone calls.
 
The Sipura (now bought out by Linksys) spa 3000 is a pstn (analog phone line) to Asterisk gateway device that provides a SIP interface for 1 FXO port (analog phone line) and 1 FXS port (analog phone). This allows you to use the Telecom section of LMCE, and use Asterisk to send/recieve/route phone calls.
  
Most office environments have a phone in each room with their own extension number. Most homes, however, are set up with 1 common line (extension) that all phones are connected to - when a call comes in, all phones ring together. LMCE will allow you to have either setup (if you have enough FXS ports to support the number of extensions you want). Since the spa 3000 has only 1 FXS port, I am going to show you how to set it up so that all phones on the main house phone line will be treated as one extension and ring together. The picture below illustrates the installation method that I'm going to outline here.
+
Most office environments have a phone in each room with their own extension number. Most homes, however, are set up with 1 common line (extension) that all phones are connected to - when a call comes in, all phones ring together. LMCE will allow you to have either setup (if you have enough FXS ports/SIP Phones to support the number of extensions you want). Since the spa 3000 has only 1 FXS port, I am going to show you how to set it up so that all phones on the main house phone line will be treated as one extension and ring together. The picture below illustrates the installation method that I'm going to outline here.
 
[[Image:spa3000_setup.png]]
 
[[Image:spa3000_setup.png]]
  
Another interesting feature of the spa3000, is that if the LMCE network goes down, or if there is a loss of power, the spa3000 will bridge the FXO and FXS ports, bypassing LMCE and Asterisk alltogether, so that you will still have use of your phones in such emergencies.
+
 
 +
[[Image:spa3000_setup_DSL.png]]
 +
 
 +
Another interesting feature of the spa3000, is that if the LMCE network goes down, or if there is a loss of power, the spa3000 will bridge the FXO and FXS ports, bypassing LMCE and Asterisk altogether, so that you will still have use of your phones in such emergencies.
  
 
Also, please realize that these instructions are for manually setting up the spa3000. In the near future, the process will be automated, and if this feature is available at the time you are reading this, then you should go the automatic route.
 
Also, please realize that these instructions are for manually setting up the spa3000. In the near future, the process will be automated, and if this feature is available at the time you are reading this, then you should go the automatic route.
  
 
Please set aside some time to do this manual setup - as you will see, there are a lot of steps involved and it may take you quite some time!
 
Please set aside some time to do this manual setup - as you will see, there are a lot of steps involved and it may take you quite some time!
 +
 +
:-:These Instructions are obsolete. Review the Linksys SPA3102 for current ones:-:
 +
 +
Note: these instructions are obsolete. Go to the Linksys SPA3102 page for newest.
 +
 +
{{p}}
  
 
== Setup ==
 
== Setup ==
Line 40: Line 60:
 
Outbound Dial Prefix: leave blank
 
Outbound Dial Prefix: leave blank
  
Trunk Name: House Line (note: remember this!  we have to match this in the spa3000 setup!)
+
Trunk Name: House Line  
  
 
Peer Details:
 
Peer Details:
Line 115: Line 135:
 
One last thing to do while we are in FreePBX. You should see towards the top of the page an orange bar that should say "Apply Configuration Changes". Click this, then when prompted, select to continue with reload.
 
One last thing to do while we are in FreePBX. You should see towards the top of the page an orange bar that should say "Apply Configuration Changes". Click this, then when prompted, select to continue with reload.
  
 
+
Next, go to Wizard->Devices->Phone Lines (on the left pane in the LMCE web admin, not in FreePBX). We are going to add a dummy line (NOTE: this is a temporary hack for now! I won't go into too many details other than saying that it will allow you to use the "Settings" link next to the listing to do some call routing on your pstn line!)
 +
Use the dropdown to select broadvoice. Once you do this, you will see a form to fill in some data. Just put whatever you want in the fields, they won't be used with this hack! After you are done, you will see it listed as a phone line - use the "settings" link next to it to do call routing depending on security mode!
 +
(Note: After creating this "dummy" phone line, go back to the FreePBX admin, and look at the Incoming Route for the broadvoice line. Look at the Custom App option at the bottom of the page. It should contain that same custom-linuxmce,102,1. If it does not, go back to the Incoming Route for the House Line, and change its custom app line to be the same as this one! From my tests, it should be the same (though the 3 digit number can change, so check this to be sure).
  
 
'''Step 2 - Adding the device template for the FXS port (your internal phone/phones)'''
 
'''Step 2 - Adding the device template for the FXS port (your internal phone/phones)'''
Line 124: Line 146:
  
 
'''Step 3 - Configuring the spa3000 (almost done!)'''
 
'''Step 3 - Configuring the spa3000 (almost done!)'''
 +
This part assumes a factory default starting point. To do this, hook up an analog phone to the FXS (phone) port, and dial ****
 +
When prompted, enter 73738# from the telephone keypad. This will reset the unit to factory defaults.
 +
 +
Now go ahead and connect the spa3000's LAN port to your internal network switch. We have to assign it a static IP address, so again dial **** from the connected handset. When prompted, enter 110# and the IP address will be spoken back to you. Write it down. Open up a web browser on the network, and enter the IP address to go to the spa3000 admin page. In the upper right hand corner, click on the links for both Admin Login and Advanced.
 +
 +
Go to the System tab. Under "Internet Connection Type" do the following:
 +
 +
DHCP: no
 +
Static IP: enter a static IP address. I used 192.168.80.253
 +
Netmask: 255.255.255.0
 +
Gateway: 192.168.80.1
 +
 +
Update for SPA-3102 <br>
 +
Router -> WAN Setup<br>
 +
set WAN Web Server to YES<br>
 +
disconnect the LAN port from the network and connect the WAN port to the network.<br>
 +
 +
 +
Next, go to the SIP tab. Change the following:
 +
 +
RTP Packet Size: 0.020
 +
 +
 +
 +
Next, go to the Line 1 tab. Change the following:
 +
 +
Line Enable: Yes
 +
 +
SIP Port: 5060
 +
 +
Proxy: 192.168.80.1
 +
 +
Register: Yes
 +
 +
Register Expires: 300
 +
 +
Make Call Without Reg: yes
 +
 +
Ans Call Without Reg: yes
 +
 +
Display Name: <extension number LMCE assigned your Generic Phone device> (mine was 206 for example)
 +
 +
UserID: <again, extension number LMCE assigned your Generic Phone device>
 +
 +
Password: <once again, extension number LMCE assigned your Generic Phone device>
 +
 +
Use AuthID: no
 +
 +
Preferred Codec: make sure its set to G711u
 +
 +
 +
 +
 +
 +
Lastly, go to the PSTN Line tab. Ensure the following settings:
 +
 +
Line Enable: Yes
 +
 +
SIP Port: 5061
 +
 +
Proxy: 192.168.80.1
 +
 +
Register: yes
 +
 +
Register Expires: 300
 +
 +
Make Calls Without Reg: Yes
 +
 +
Ans Calls Without Reg: Yes
 +
 +
Display Name: PSTN Call (this will be displayed in place of unknown caller ID's. You may want to name this "Unknown Call" or similar)
 +
 +
user ID: House Line (this must match the trunk name you did in the FreePBX setup!)
 +
 +
Password: lmce
 +
 +
Use Auth ID: no
 +
 +
Preferred Codec: make sure it is set to G711u
 +
 +
DTMF Process INFO: yes
 +
 +
DTMF Process AVT: yes
 +
 +
DTMF TxMethod: Auto
 +
 +
Dial Plan 2: (S0<:phone_number_here>)    i.e. (S0<:800-555-1212>) (this is very important - it must match the DID number entered in FreePBX)
 +
 +
VoiP-To-PSTN Gateway Enable: yes
 +
 +
Voip Caller Auth Method: None
 +
 +
Voip PIN Max Retry: 3
 +
 +
One Stage Dialing: yes
 +
 +
Line1 VoIP Caller DP: None
 +
 +
ViOP Valler Default DP: None
 +
 +
Line1 Fallback DP: None (this may need changed to make sure incoming calls come in when the power goes out - will experiment)
 +
 +
 +
 +
PSTN-To-VoIP Gateway Enable: yes
 +
 +
PSTN Caller Auth Method: none
 +
 +
PSTN Right Thru Line 1: no
 +
 +
PSTN Pin Max Retry: 3
 +
 +
PSTN CID for VioP CID: yes
 +
 +
PSTN Caller Default DP: 2  (this is the dialplan 2 that we set up above!)
 +
 +
Off Hook While Calling VoIP: no
 +
 +
Line 1 Signal Hook Flash to PSTN: Disabled
 +
 +
VoIP Answer Delay: 0
 +
 +
PSTN Answer Delay: 3 (this allows enough time for the caller ID information to be passed along)
 +
 +
SPA to PSTN Gain and PSTN to SPA Gain - these can be adjusted to amplify the incoming/outgoing volume to a comfortable level. I like mine set at 6
 +
 +
 +
That should be it!  Enjoy LMCE Telecom on your old analog phone line!
 +
 +
{{p}}
 +
 +
== Disconnect Tone ==
 +
If your line doesn't hang up after a call then you may need to change the disconnect tone. Different countries have different disconnect tones. Go to the SPA3000's configuration page, click on Admin Login and then Advanced. Now head to the PSTN Line tab. Scroll down to the PSTN Disconnect Detection. There is a setting called "Disconnect Tone" and that's what needs to change.
 +
 +
The format entered needs to be of the following: X@-30,X@-30;Y(A/B/1+2)
 +
 +
where:
 +
 +
X = The frequency in Hz.
 +
 +
Y = The cycles the pattern repeats
 +
 +
A = Time in seconds for the frequency
 +
 +
B = Time in seconds for the silence
 +
 +
The -30 is the level in dB.
 +
 +
The 1+2 is saying cycle the first and second tone. So for the example below you can just have 1 instead of 1+2.
 +
 +
The default is 480@-30,620@-30;4(.25/.25/1+2) however this didn't work for me. I live in Switzerland where the disconnect tone is at 425Hz for 200ms followed by a silence at 200ms.
 +
So my settings is at 425@-30,425-30;4(.20/.20/1+2). Due to the simplicity of the Swiss disconnect tone I may not have needed to display the same Hz twice nor have a 4 repeat cycle pattern but it works this way and I haven't tested further.
 +
 +
{{p}}
 +
 +
== BUG REPORTS ==
 +
Please note any bugs, improvements, fixes or Suggestions below so I can make sure it gets included in the final plug-and-play setup!
 +
 +
- Upon power outtage, or network failure/core crash, the FXO and FXS lines are bridged so you can still use the phones. Dialing out works fine (just unplug the power and/or network cable from your spa3000 to see!). However, incoming calls in this failsafe mode only ring once. (not yet fixed)
 +
 +
- Incoming calls don't directly ring the house phone extension. All orbiters alert of the call, and the call can be directed to go to the house line, but I would have expected that the houseline would ring and could be picked up on a call with no orbiter interaction at all. (not quite sure if this a bug or not, of if this is how LMCE should handle it. Can anyone with VoIP confirm the behavior?) (UPDATE: Found the problem. This will not work until do the web admin portion of this - it will essentiall fix its self when I implement that code)

Latest revision as of 03:55, 20 October 2012

It has been suggested that this article or section be merged with Linksys SPA3102



General Information

Note: these instructions are obsolete. Go to the Linksys SPA3102 page for newest.


The Sipura (now bought out by Linksys) spa 3000 is a pstn (analog phone line) to Asterisk gateway device that provides a SIP interface for 1 FXO port (analog phone line) and 1 FXS port (analog phone). This allows you to use the Telecom section of LMCE, and use Asterisk to send/recieve/route phone calls.

Most office environments have a phone in each room with their own extension number. Most homes, however, are set up with 1 common line (extension) that all phones are connected to - when a call comes in, all phones ring together. LMCE will allow you to have either setup (if you have enough FXS ports/SIP Phones to support the number of extensions you want). Since the spa 3000 has only 1 FXS port, I am going to show you how to set it up so that all phones on the main house phone line will be treated as one extension and ring together. The picture below illustrates the installation method that I'm going to outline here. Spa3000 setup.png


Spa3000 setup DSL.png

Another interesting feature of the spa3000, is that if the LMCE network goes down, or if there is a loss of power, the spa3000 will bridge the FXO and FXS ports, bypassing LMCE and Asterisk altogether, so that you will still have use of your phones in such emergencies.

Also, please realize that these instructions are for manually setting up the spa3000. In the near future, the process will be automated, and if this feature is available at the time you are reading this, then you should go the automatic route.

Please set aside some time to do this manual setup - as you will see, there are a lot of steps involved and it may take you quite some time!

-:These Instructions are obsolete. Review the Linksys SPA3102 for current ones:-:

Note: these instructions are obsolete. Go to the Linksys SPA3102 page for newest.



Setup

We are going to accomplish this setup in 3 steps: 1- Configuring the Phone Line in the web admin (FreePBX) 2- Adding the device for the internal phone line (FXS port) 3) Configuring the spa3000 (as we will need information from the previous 2 steps to complete)


Step 1 - Configuring the Phone Line

First, log into the web admin at 192.168.80.1, then navigate to Advanced->Configuration->Phones Setup. This will bring you to the FreePBX Admin page On the left hand side, click on "Trunks", then click "Add SIP Trunk" on the page the follows. You will now have to fill out the folowing information:

Outbound Caller ID: House Line

Never Override Caller ID: leave unchecked

Maximum Channels: 1 (this must be set to 1 as a pstn line can only handle 1 call at a time)

Disable Trunk: leave unchecked

Monitor Trunk Failures: leave the Enable checkbox unchecked

Dial Rules: Leave blank

Dial rules wizards: leave this alone

Outbound Dial Prefix: leave blank

Trunk Name: House Line

Peer Details:

allow=ulaw
canreinvite=no
context=from-trunk
disallow=all
dtmfmode=rfc2833
host=dynamic
incominglimit=1
nat=never
port=5061
qualify=yes
secret=lmce
type=friend
username=House Line

USER Context: leave blank

USER Details: leave blank

Register String: Leave blank

go ahead and save the changes now!


Next, we are going to setup the Outbound Routes. In FreePBX, on the left, click on "Outbound Routes", and add the following for the new route:

Route Name: House Line Out

Route Password: leave blank

Emergency Dialing: leave unchecked

Intra Company Route: leave unchecked

Music On Hold?: leave at default

Dial Paterns:

112
411
911
9|.XXX

Dial Patterns Wizards: leave this alone

Trunk Sequence: select the SIP/House Line option from the drop down at the top position (this is the trunk we created earlier). If you already have VOIP setup, and you are adding the pstn as a second line, you may want to change the sequence order to suit your needs. All this sequence does, is if a call fails while trying the first sequence, then the call will be tried with the next one, and so on.

Submit your changes!


Next, we will setup the inbound routes. In FreePBX, click on "Inbound Routes", and add the following for the new route:

Description: Leave blank

DID Number : your line phone number, I.e. 800-555-1212

Caller ID Number: leave blank

Zaptel Channel: Leave blank

Fax Handling Section - leave these as-is

Privacy Manager : No

Options Settings: Leave as-is

lastly, in the Set Destination settings, select the last radio button, Custom App. Type the following in the text box for Custom App: custom-linuxmce,102,1

submit your changes.


One last thing to do while we are in FreePBX. You should see towards the top of the page an orange bar that should say "Apply Configuration Changes". Click this, then when prompted, select to continue with reload.

Next, go to Wizard->Devices->Phone Lines (on the left pane in the LMCE web admin, not in FreePBX). We are going to add a dummy line (NOTE: this is a temporary hack for now! I won't go into too many details other than saying that it will allow you to use the "Settings" link next to the listing to do some call routing on your pstn line!) Use the dropdown to select broadvoice. Once you do this, you will see a form to fill in some data. Just put whatever you want in the fields, they won't be used with this hack! After you are done, you will see it listed as a phone line - use the "settings" link next to it to do call routing depending on security mode! (Note: After creating this "dummy" phone line, go back to the FreePBX admin, and look at the Incoming Route for the broadvoice line. Look at the Custom App option at the bottom of the page. It should contain that same custom-linuxmce,102,1. If it does not, go back to the Incoming Route for the House Line, and change its custom app line to be the same as this one! From my tests, it should be the same (though the 3 digit number can change, so check this to be sure).

Step 2 - Adding the device template for the FXS port (your internal phone/phones) In the web admin, on the left pane under devices, select Phones. On the resulting page, you should see all of the Orbiter Embedded Phones that your system already has. At the bottom of this page, click the "Add Device" button, then select "Generic Phone" from the Device Template picker. Click the "Pick device template" button. Now notice that you have a new phone device in you list. Change the name to something like "House Line", set the PK_FloorplanObjectType to Pluto Telephone, set the Phone Type to SIP. Notice that the PhoneNumber is already filled out. LEAVE THIS ALONE AND REMEMBER IT! This will be the extension of your internal analog phones (or whatever single phone you have plugged into the FXS Port!) Also, you can assign this phone a room (it really doesn't matter which one you choose) and make sure the "Controlled By" column says Asterisk. If it does not say "Asterisk", click on it and choose Asterisk (Asterisk) - from the dropdown. When finished, Hit the Update button at the bottom of the screen to save these changes. You will have to reload your router, and do a quick regen on all orbiters manually (from the Devices->Orbiters section)


Step 3 - Configuring the spa3000 (almost done!) This part assumes a factory default starting point. To do this, hook up an analog phone to the FXS (phone) port, and dial **** When prompted, enter 73738# from the telephone keypad. This will reset the unit to factory defaults.

Now go ahead and connect the spa3000's LAN port to your internal network switch. We have to assign it a static IP address, so again dial **** from the connected handset. When prompted, enter 110# and the IP address will be spoken back to you. Write it down. Open up a web browser on the network, and enter the IP address to go to the spa3000 admin page. In the upper right hand corner, click on the links for both Admin Login and Advanced.

Go to the System tab. Under "Internet Connection Type" do the following:

DHCP: no Static IP: enter a static IP address. I used 192.168.80.253 Netmask: 255.255.255.0 Gateway: 192.168.80.1

Update for SPA-3102
Router -> WAN Setup
set WAN Web Server to YES
disconnect the LAN port from the network and connect the WAN port to the network.


Next, go to the SIP tab. Change the following:

RTP Packet Size: 0.020


Next, go to the Line 1 tab. Change the following:

Line Enable: Yes

SIP Port: 5060

Proxy: 192.168.80.1

Register: Yes

Register Expires: 300

Make Call Without Reg: yes

Ans Call Without Reg: yes

Display Name: <extension number LMCE assigned your Generic Phone device> (mine was 206 for example)

UserID: <again, extension number LMCE assigned your Generic Phone device>

Password: <once again, extension number LMCE assigned your Generic Phone device>

Use AuthID: no

Preferred Codec: make sure its set to G711u



Lastly, go to the PSTN Line tab. Ensure the following settings:

Line Enable: Yes

SIP Port: 5061

Proxy: 192.168.80.1

Register: yes

Register Expires: 300

Make Calls Without Reg: Yes

Ans Calls Without Reg: Yes

Display Name: PSTN Call (this will be displayed in place of unknown caller ID's. You may want to name this "Unknown Call" or similar)

user ID: House Line (this must match the trunk name you did in the FreePBX setup!)

Password: lmce

Use Auth ID: no

Preferred Codec: make sure it is set to G711u

DTMF Process INFO: yes

DTMF Process AVT: yes

DTMF TxMethod: Auto

Dial Plan 2: (S0<:phone_number_here>) i.e. (S0<:800-555-1212>) (this is very important - it must match the DID number entered in FreePBX)

VoiP-To-PSTN Gateway Enable: yes

Voip Caller Auth Method: None

Voip PIN Max Retry: 3

One Stage Dialing: yes

Line1 VoIP Caller DP: None

ViOP Valler Default DP: None

Line1 Fallback DP: None (this may need changed to make sure incoming calls come in when the power goes out - will experiment)


PSTN-To-VoIP Gateway Enable: yes

PSTN Caller Auth Method: none

PSTN Right Thru Line 1: no

PSTN Pin Max Retry: 3

PSTN CID for VioP CID: yes

PSTN Caller Default DP: 2 (this is the dialplan 2 that we set up above!)

Off Hook While Calling VoIP: no

Line 1 Signal Hook Flash to PSTN: Disabled

VoIP Answer Delay: 0

PSTN Answer Delay: 3 (this allows enough time for the caller ID information to be passed along)

SPA to PSTN Gain and PSTN to SPA Gain - these can be adjusted to amplify the incoming/outgoing volume to a comfortable level. I like mine set at 6


That should be it! Enjoy LMCE Telecom on your old analog phone line!



Disconnect Tone

If your line doesn't hang up after a call then you may need to change the disconnect tone. Different countries have different disconnect tones. Go to the SPA3000's configuration page, click on Admin Login and then Advanced. Now head to the PSTN Line tab. Scroll down to the PSTN Disconnect Detection. There is a setting called "Disconnect Tone" and that's what needs to change.

The format entered needs to be of the following: X@-30,X@-30;Y(A/B/1+2)

where:

X = The frequency in Hz.

Y = The cycles the pattern repeats

A = Time in seconds for the frequency

B = Time in seconds for the silence

The -30 is the level in dB.

The 1+2 is saying cycle the first and second tone. So for the example below you can just have 1 instead of 1+2.

The default is 480@-30,620@-30;4(.25/.25/1+2) however this didn't work for me. I live in Switzerland where the disconnect tone is at 425Hz for 200ms followed by a silence at 200ms. So my settings is at 425@-30,425-30;4(.20/.20/1+2). Due to the simplicity of the Swiss disconnect tone I may not have needed to display the same Hz twice nor have a 4 repeat cycle pattern but it works this way and I haven't tested further.



BUG REPORTS

Please note any bugs, improvements, fixes or Suggestions below so I can make sure it gets included in the final plug-and-play setup!

- Upon power outtage, or network failure/core crash, the FXO and FXS lines are bridged so you can still use the phones. Dialing out works fine (just unplug the power and/or network cable from your spa3000 to see!). However, incoming calls in this failsafe mode only ring once. (not yet fixed)

- Incoming calls don't directly ring the house phone extension. All orbiters alert of the call, and the call can be directed to go to the house line, but I would have expected that the houseline would ring and could be picked up on a call with no orbiter interaction at all. (not quite sure if this a bug or not, of if this is how LMCE should handle it. Can anyone with VoIP confirm the behavior?) (UPDATE: Found the problem. This will not work until do the web admin portion of this - it will essentiall fix its self when I implement that code)