pbx_doorcom

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision		 Previous revision
pbx_doorcom [2019/03/20 17:04] – external edit 127.0.0.1pbx_doorcom [2023/09/04 12:45] (current) – [Integration example: 2N Helios IP] ingrid
Line 6: Line 6:
  
   * **PBX port** This property allows to specify the PBX port if different from the default one (5060).   * **PBX port** This property allows to specify the PBX port if different from the default one (5060).
-  * **Accounts PBX** This property represents the list of extensions (clients) to be registered in the PBX. +  * **Accounts PBX** This property represents the list of **extensions (clients)** to be registered in the PBX. 
-  * **Ring groups** This property represents the list of ring groups to be registered in the PBX. Ring groups allow to call more than one extension using a single number. The outdoor station can forward the call to several clients using a single number. +  * **Ring groups** This property represents the list of **ring groups** to be registered in the PBX. Ring groups allow to call more than one extension using a single number. The outdoor station can forward the call to several clients using a single number. 
-  * **Intercom devices** This property represents the list of intercom devices to be registered in the PBX.+  * **Intercom devices** This property represents the list of **intercom devices** to be registered in the PBX.
  
 +The diagram below gives a general overview on the configuration when using a Thinknx server as a VoIP PBX.
 +
 +{{ :server_pbx_internal.png?direct |Thinknx server used as a VoIP PBX}}
 +<WRAP center 60%> <WRAP centeralign> Thinknx server used as a VoIP PBX </WRAP></WRAP>
 +
 +<WRAP Important center round 80%> When using an external VoIP PBX, there is no need to add the object "VoIP PBX" in System. All the extensions are configured on the external PBX. It is only essential to create one user per extension in "Sytem"-->"Users and Groups", and disable the "System PBX" parameter in order to enter the correct settings for the user. </WRAP>
 ==== Adding PBX accounts ==== ==== Adding PBX accounts ====
  
 Click on the button displayed on the right to open the PBX users editor window, then click on ”Add” and adjust the properties in the grid: Click on the button displayed on the right to open the PBX users editor window, then click on ”Add” and adjust the properties in the grid:
  
-  * **Extension** This property allows to specify the extension number used by the client to join the PBX.+  * **Extension** This property allows to specify the extension number used by the client to join the PBX. Extension number starts from 100.
   * **Password** This property allows to specify the password associated to the extension number.   * **Password** This property allows to specify the password associated to the extension number.
  
Line 24: Line 30:
   * **Accounts PBX** PBX accounts associated to this ring group   * **Accounts PBX** PBX accounts associated to this ring group
  
 +co
 ==== Adding intercom devices ==== ==== Adding intercom devices ====
  
 Click on the button displayed on the right to open the intercom devices editor, click on ”Add” and adjust the properties in the grid: Click on the button displayed on the right to open the intercom devices editor, click on ”Add” and adjust the properties in the grid:
  
-  * **Device type** It can be selected from the following list: +  * **Device type** By selecting the option "**Generic IP Doorstation**" from the list, it is possible to integrate with most intercom support the SIP protocol such as: 
-    * //2N Elios IP// +    * //2N// 
-    * //Mobotix M24// +    * //Doorbird// 
-    * //TCS gateway// +    * //Fermax// 
-    * //TCS Native// +    * //Mobotix// 
-    * //Generic IP doorstation//+    * //TCS// 
 +    * and much more!
   * **Username web** This property corresponds to on of the login parameters of intercom management web page.   * **Username web** This property corresponds to on of the login parameters of intercom management web page.
   * **Password web** This property corresponds to on of the login parameters of intercom management web page.   * **Password web** This property corresponds to on of the login parameters of intercom management web page.
Line 45: Line 53:
     * Ring Group PBX: Ring group associated to this button.     * Ring Group PBX: Ring group associated to this button.
  
-==== Integration example: 2N Helios IP ====+==== Integration example: 2N IP ====
  
-The Helios IP Verso SIP Door Station is an SIP Door Station solution with an integrated video camera for monitoring door activity. Here follows settings to apply to the 2N Helios door station to work properly with Thinknx PBX. It applies to 2N firmware version 2.10.0 (2015). The following features are supported:+The intercom used in this example is the 2N IP Helios, an SIP Door Station solution with an integrated video camera for monitoring door activity, however, the same concept can be applicable to the other products within the same 2N series. The below configuration was applied to 2N firmware version 2.10.0 (2015), where the following features are supported:
   * Paging: When the call button is pressed on the door station, it will call all appropriate clients based on the settings of the ring group called.   * Paging: When the call button is pressed on the door station, it will call all appropriate clients based on the settings of the ring group called.
   * 2Way audio call: the user at the client station can converse with the person outside the door   * 2Way audio call: the user at the client station can converse with the person outside the door
Line 55: Line 63:
 === Preliminary Requirements === === Preliminary Requirements ===
  
-The 2N Helio IP door station has to be connected to the ethernet using a CAT5 cable and it has to be in the same network to which Thinknx server is attached. Also the clients have to be connected to the same network. Special network configuration is possible using the needed routing/firewalling devices.+The 2N IP door station has to be connected to the ethernet using a CAT5 cable and it has to be in the same network to which Thinknx server is attached. Also the clients have to be connected to the same network. Special network configuration is possible using the needed routing/firewalling devices.
  
 === Voip PBX setup === === Voip PBX setup ===
Line 62: Line 70:
   * Add several users into the "Accounts PBX" tab   * Add several users into the "Accounts PBX" tab
   * Add an intercom into the "Intercom devices" and set it as generic intercom. A number will be shown. That is the ID of the intercom (extension number). The password for the registration to the PBX is identical to that number (user 901/pass 901)   * Add an intercom into the "Intercom devices" and set it as generic intercom. A number will be shown. That is the ID of the intercom (extension number). The password for the registration to the PBX is identical to that number (user 901/pass 901)
-  * Add a ring group and select the users you want to call with that ring group. A number will be shown. That number is the extension associated to that ring group (9001). Calling that number will canuse all the associated users to ring.+  * Add a ring group and select the users you want to call with that ring group. A number will be shown. That number is the extension associated to that ring group (9001). Calling that number will cause all the associated users to ring.
  
-=== 2N Helios IP setup ===+=== 2N IP setup ===
  
 Enter the IP Address of the door station into a Web Browser. You will be taken to the login page for the Door Station. Log in to the Door Station. By default, the user name is **Admin** and the password is **2n**. You will be taken to the Configuration Utility: Enter the IP Address of the door station into a Web Browser. You will be taken to the login page for the Door Station. Log in to the Door Station. By default, the user name is **Admin** and the password is **2n**. You will be taken to the Configuration Utility:
Line 113: Line 121:
  
 To be able to open the Lock connected to the 2N device you have two options: to send **DTMF** tones during conversation or to send html **GET** messages to the device. To be able to open the Lock connected to the 2N device you have two options: to send **DTMF** tones during conversation or to send html **GET** messages to the device.
-If you want to use DTMF tones, it will be enough to create a Generic Buttom into the UI and select as action the generation of DTMF tone as in the following picture. DTMF code must be the same inserted into the 2N configuration page followed by **#** (in the example 1234#).+If you want to use DTMF tones, it will be enough to create a Generic Buttom into the UI and select as action the generation of DTMF tone as in the following picture. DTMF code must be the same inserted into the 2N configuration page followed by ***** (in the example 1234*).
  
 If you prefer to use html GET solution, you need to use the Thinknx Ethernet Gateway plugin and configure a Generic Button to perform an action with the following parameters: If you prefer to use html GET solution, you need to use the Thinknx Ethernet Gateway plugin and configure a Generic Button to perform an action with the following parameters:
Line 142: Line 150:
   * Add several users into the "Accounts PBX" tab   * Add several users into the "Accounts PBX" tab
   * Add an intercom into the "Intercom devices" and set it as generic intercom. A number will be shown. That is the ID of the intercom (extension number). The password for the registration to the PBX is identical to that number (user 901/pass 901)   * Add an intercom into the "Intercom devices" and set it as generic intercom. A number will be shown. That is the ID of the intercom (extension number). The password for the registration to the PBX is identical to that number (user 901/pass 901)
-  * Add a ring group and select the users you want to call with that ring group. A number will be shown. That number is the extension associated to that ring group (9001). Calling that number will canuse all the associated users to ring.+  * Add a ring group and select the users you want to call with that ring group. A number will be shown. That number is the extension associated to that ring group (9001). Calling that number will cause all the associated users to ring.
  
 === Doorbird setup === === Doorbird setup ===
Line 161: Line 169:
   - Set the Autocall doorbell as sip:9001@x.x.x.x, where “x.x.x.x” is the IP Address of the Thinknx Server and 9001 is the extension number to call (ring group in this case).   - Set the Autocall doorbell as sip:9001@x.x.x.x, where “x.x.x.x” is the IP Address of the Thinknx Server and 9001 is the extension number to call (ring group in this case).
   - Set DTMF to enabled to be able to open the lock using DTMF codes   - Set DTMF to enabled to be able to open the lock using DTMF codes
 +  - Finally, make sure that the Thinknx account is allowed to make calls by selecting all the days of the week in the schedule as seen in the picture below.
 +
 +{{ :doorbird_schedule.png?direct&800 |}}
 +
 +The same procedure can be done using the DoorBird app into the dedicated SIP configuration section, or by accessing their portal on https://webadmin.doorbird.com/login.
  
-The same procedure can be done using the DoorBird app into the dedicated SIP configuration section. 
  
 To be able to see the images coming from the device you need to add a Camera inside Thinknx UI and configure to grab images using the following parameters: To be able to see the images coming from the device you need to add a Camera inside Thinknx UI and configure to grab images using the following parameters:
Line 171: Line 183:
  
 To be able to open the Lock connected to the Doorbird device you have two options: to send **DTMF** tones during conversation or to send html **GET** messages to the device. To be able to open the Lock connected to the Doorbird device you have two options: to send **DTMF** tones during conversation or to send html **GET** messages to the device.
-If you wnat to use DTMF tones, it will be enough to create a Generic Buttom into the UI and select as action the generation of DTMF tone as in the following picture. DTMF code must be the same inserted into the Doorbird configuration page followed by **#** (in the example 1234#).+If you wnat to use DTMF tones, it will be enough to create a Generic Buttom into the UI and select as action the generation of DTMF tone as in the following picture. DTMF code must be the same inserted into the Doorbird configuration page followed by ***** (in the example 1234*).
  
 {{ :doorbirddtmf.png?direct&800 |}} {{ :doorbirddtmf.png?direct&800 |}}
Line 182: Line 194:
  
 {{ :doorbirdethgw.png?direct&800 |}} {{ :doorbirdethgw.png?direct&800 |}}
 +
 +==== Integration example: Mobotix T25 doorstation====
 +
 +The Mobotix T25 is a SIP door station solution with an integrated video camera for monitoring door activity. Below are the settings to apply to the Mobotix T25 to work properly with Thinknx PBX. The following features are supported:
 +  * Paging: When the call button is pressed on the door station, it will call all appropriate clients based on the settings of the ring group called.
 +  * 2Way audio call: the user at the client station can converse with the person outside the door
 +  * Video monitoring: the camera in the door station can be accessed by the client to view the caller and the outside area
 +  * Relay/Door strike actuation from the server: the internal relays can be actuated from Thinknx client/server.
 +
 +=== Preliminary Requirements ===
 +
 +The Mobotix T25 has to be connected to the ethernet using a CAT5 cable and it has to be in the same network to which Thinknx server is connected. Also, the clients have to be connected to the same network. Special network configuration is possible using the needed routing/firewalling devices.
 +
 +=== Voip PBX setup ===
 +
 +Add the Voip PBX object and configure as follow:
 +  * Add several users into the "Accounts PBX" tab
 +  * Add an intercom into the "Intercom devices" and set it as generic intercom. A number will be shown. That is the ID of the intercom (extension number). The password for the registration to the PBX is identical to that number (user 901/pass 901)
 +  * Add a ring group and select the users you want to call with that ring group. A number will be shown. That number is the extension associated to that ring group (9001). Calling that number will cause all the associated users to ring.
 +
 +=== Mobotix T25 setup ===
 +
 +Enter the IP Address of the door station into your web browser and login using your admin username and password. You will be redirected to the live page of the camera with a main menu to the left.
 +
 +Press the “Admin Menu” button to access the administration settings.
 +
 +Scroll down through the list to reach the section called “Audio and VoIP Telephony. 
 +
 +{{ :mx_admin_SIPmenu.png?direct&800 |}}
 +
 +**SIP Server**
 +
 +Click on “SIP Server Settings”.
 +Once inside the page, make sure that the internal SIP Server of Mobotix is OFF. We will not need to activate this since the SIP server used will be the Thinknx server.
 +
 +{{ :mx_SIP_server.png?direct&800 |}}
 +
 +**SIP Clients**
 +
 +Go back to the Audio and VoIP Telephony, and click on the SIP Client Settings. Here we need to configure the Mobotix as a SIP client so it can communicate with Thinknx client devices.
 +  * Make sure that SIP Client is Enabled.
 +  * Click on “Add new SIP account” to create a new entry in the SIP Accounts table. 
 +  * Under SIP address, enter the extension 901 as username, and the IP address of your Thinknx server as Domain.
 +  * Under Authentication, enter 901 as username and password.
 +  * Under Server, enter the IP address of your Thinknx server as Hostname/Address, and 5060 as port.
 +  * Enable “Available as Proxy” and “Use as Registrar”. 
 +  * Leave the Register Expiration as 5 min.
 +
 +{{ :mx_sip_client1.png?direct&800 |}}
 +
 +Scroll down through the settings till you reach the Audio Codec Settings.
 +
 +Make sure that you enable “Use PCMA Codec” and “Use PCMU Codec”, and disable "Use G.722 Codec".
 +
 +{{ :mx_SIP_client2.png?direct&800 |}}
 +
 +<WRAP center important round 80%> If you are unable to view the parameters above, make sure that you scroll down to the "Setup Mode" and select "Expert Setup". </WRAP>
 +
 +{{ :mx_SIP_client3.png?direct&800 |}}
 +
 +**Configure Outgoing Calls**
 +
 +Access the “Outgoing Call Settings” from the Audio and VoIP Telephony menu. We will need to create the accounts that the Mobotix will try to call once the intercom button is pressed. Since our accounts have been added to a group call from inside the configurator, then we will only need to create an entry for extension 9001.
 +
 +To create the profile, click on “Add new profile”.
 +
 +{{ :mx_outgoing_call.png?direct&800 |}}
 +
 +Add the extension 9001 as Phone Number or SIP Address. Under "SIP Proxy", select the option whith the following template "IP_Thinknx_Server(9001@IP_Thinknx_Server)".
 +
 +For “Connection type”, choose “SIP Audio”.
 +
 +For the option “After the message has been sent” choose “intercom”.
 +
 +Click on Set to save the settings.
 +
 +**Configure Intercom Button**
 +
 +The final step to be able to make a call from the intercom would be to configure the button on the Mobotix.
 +To do that, close the “Admin menu” and instead access the “Setup Menu” from the live interface.
 +
 +Once inside, look for “Event Control” and click on “Action Group Overview”.
 +
 +{{ :mx_setup_menu.png?direct&800 |}}
 +
 +Click on “Add new group” to create a new entry and name it “Button” or “Bell Button”.
 +
 +{{ :mx_action_group.png?direct&800 |}}
 +
 +Click on Edit to configure the newly created entry.
 +
 +Under “Event Selection”, select “Signal:CameraBellButton”. This will trigger the call when the Bell button on the intercom unit is pressed.
 +
 +Under Actions, click on “Add new action” and select the action “Phone Call: call_1”. This will allow you to call the extension configured in the Outgoing Call.
 +
 +{{ :mx_action_button.png?direct&800 |}}
 +
 +<WRAP center round important 80%> It is recommended to tune the microphone and speaker volume on the Mobotix intercom for a good quality call. This can be done by going to the Admin Menu and clicking on "Speaker and Microphone" under "Audio and VoIP Telephony". </WRAP>
 +
 +<WRAP center round important 80%> Once the configuration is completed, do not forget to store the settings on the Mobotix device. This can be done by going to the Admin Menu and scrolling down to the bottom where you will see the option "Store". A reboot will need to take place after storing. </WRAP>
 +
 +{{ :mx_admin_main.png?direct&800 |}}
 +
 +==== Integration example: Fermax Milo Panel ====
 +
 +The information below is extracted from a more detailed guide available on Fermax:
 +
 +https://meet.fermax.com/wp-content/uploads/2022/07/CASE-STUDY-TEC-THINKNX_EN-ANDROID-4.pdf
 +
 +=== Voip PBX setup ===
 +
 +Add the Voip PBX object and configure as follow:
 +  * Add several users into the "Accounts PBX" tab, for example, user 100 and 101.
 +  * Add an intercom into the "Intercom devices" and set it as generic intercom. A number will be shown. That is the ID of the intercom (extension number). The password for the registration to the PBX is identical to that number (user 901/pass 901)
 +  * Add a ring group and select the users you want to call at the same time with that ring group. A number will be shown. That number is the extension associated to that ring group (9001). Calling that number will cause all the associated users to ring.
 +
 +=== Configuring Milo Panel ===
 +
 +On your Milo Panel webpage, access Web server > General > Configure MEET P2P call (Block = 1; Apart. = 101)
 +
 +{{ :fermax_1.png?direct&600 |}}
 +
 +Open SIP > Register the ThinKNX Micro server as your panel's SIP server with extension 901.
 +
 +{{ :fermax_2.png?direct&600 |}}
 +
 +Access SIP Call and configure your Apartment 101 to call group 9001 on the SIP Thinknx server.
 +
 +{{ :fermax_3.png?direct&600 |}}
 +
 +=== Camera Configuration ===
 +In a new page on your interface, add the object "Camera". Set the parameters as seen in the picture below:
 +
 +{{ :fermax_4.png?direct&800 |}}
 +
 +=== Door Opening ===
 +In the same page created earlier, add the object "Generic command" and configure the command to send a DTMF tone during the call. Write down the DTMF number or combination of numbers configured on your Fermax intercom to activate the door opener. They can be numeric characters and special characters such as # or *.
 +
 +{{ :fermax_5.png?direct&800 |}}
 +
 +
  • pbx_doorcom.1553097883.txt.gz
  • Last modified: 2019/03/20 17:04
  • by 127.0.0.1