2N OS

About The integration of 2N with the Loxone automation system.

Key Features

Call Notifications:

- When the call button on the 2N intercom is pressed, a Push Notification is sent to the Loxone mobile application, notifying the user about an incoming call.

Live Video Streaming:

- Users can view live video from the intercom's camera directly within the Loxone mobile application. - This functionality is available both locally and remotely (outside the local network) by utilising the Loxone Remote Connect.

Two-Way Communication:

- With the Loxone mobile application, users can establish two-way audio and video calls to the 2N intercom to communicate seamlessly with anyone at the door. - This functionality is available over the local network. If you would like to set up an external connection (outside the local network), you must utilise an external SIP provider.

We cannot offer any support, warranty or liability for external services.

Door opening:

- Users can securely open the door of 2N devices via a dedicated button in the Loxone mobile application.

I/O monitoring:

- The Loxone Miniserver can monitor the status of inputs and outputs on 2N devices, allowing for customised actions within the system.

Home Automation Control:

- Customizable buttons on the 2N Indoor units allow users to control their Loxone home directly by sending commands to the Loxone Miniserver.

Calling To complete the setup, follow these three stages: first, prepare the Loxone system, then apply the necessary settings inside the 2N intercom, and finally, complete the configuration back in Loxone.

1. Loxone Miniserver Virtual Input To notify the Loxone system about an incoming call, the 2N intercom triggers the Loxone virtual input via HTTP API. Follow the steps below to create a virtual input:

1. Create Virtual Input. 2. Give it a name, for example, “call”. 3. Drag and drop the input to any available page. 4. Disable this input from being used in the user interface.

Creating user To authenticate the HTTP API request to trigger a virtual input from the 2N intercom, it is recommended to create a separate user and password. Follow the steps below to create a new user:

1. Add New User. 2. Change the username, for example, “2N”. 3. Set your password.

Set rights & permissions

1. Select the newly created user and open the permission manager. 2. Grant access rights to the Web Interface/Apps and allow changing own passwords (optional). 3. Find the previously created virtual input “call”. 4. Grant Internal and External access for user “2N” to use the virtual input.

2. 2N Intercom Local Calling To allow the intercom to make or receive calls within the local network, you must enable the SIP 1 account.

1. Navigate to the section Calling and open the SIP1 account. 2. Enable the SIP account. 3. Set the Automatic Answering Mode for the SIP1 account in the general settings.

External Calling For the intercom to make or receive calls while connected externally, you need to use an external service (for example, Antisip). We cannot offer any support, warranty or liability for external services.

1. Navigate to the section Calling and open the SIP3 account (recommended). 2. Enable the SIP account. 3. Configure the SIP account using the credentials provided by the external service (for example, Antisip). 4. Set the Automatic Answering Mode for the SIP3 account in the general settings.

HTTP API Services To open the door, monitor inputs and outputs and control 2N devices from Loxone, you need to configure the HTTP API Services as follows:

1. Navigate to the HTTP API section. 2. Change the authentication method for the selected services to Basic.

API Account To authenticate the HTTP API commands sent to the 2N device, you need to create a separate account for the Loxone Miniserver:

1. Create your username and password, for example, “loxone”. 2. Grant access to selected services for this account.

Automation (calling) To notify the Loxone Miniserver about an incoming call, you must create an automation that triggers the previously created virtual input “call”.

1. Navigate to the Automation section. 2. Select any available slot and click on the edit function button (pencil). 3. Drag and drop the KeyPressed event onto the page; for the first Quick Dial Button, set the input parameter to “%1”. 4. Drag and drop the SendHttpRequest action onto the page, configure it, and connect it with the KeyPressed event: 5. As URI use the IP address of the Loxone Miniserver followed by “/dev/sps/io/call/pulse” (https://<ip_address>/dev/sps/io/<input_name>/pulse). 6. Use the Username and Password for the user "2N", which was previously set up in Loxone. 7. If you are not using custom SSL certificates, disable certificate validation. 8. Save the automation and proceed to the last step.

3. Loxone Miniserver Adding Intercom

1. Under the Intercom section, add User Defined Intercom. 2. Add name to the 2N intercom, for example, “2N”. 3. Properly configure its properties: 4. To construct the video stream URL, use the intercom's IP address (substitute the IP address with "remoteconnect" for external connections), followed by “/api/camera/snapshot?width=1920&height=1080&fps=15” (supported resolution may vary based on the intercom model). 5. To view the video, you must authorise using the previously created 2N API account. 6. The host address should be the intercom's IP address. For external calls, use the host address provided by the external service. 7. For local calls host username is not required. For external calls, use the username provided by the external service. 8. Connect the virtual input “call” with the “Bell” input on the Intercom block.

Intercom control To control the 2N device, for example, to open the door during a call from the Loxone mobile application, you must use a virtual output that sends HTTP API commands directly to the 2N device.

1. Install 2N AddOn from Loxone Library 2. You must include the Loxone account's username and password directly before the 2N device’s IP address, following the Basic Auth format: 3. https://<username>:<password>@<ip_address> 4. Click the "plus" icon under the intercom configuration and enable the custom output, which will create a button in the user interface. 5. Assign it a descriptive name that clearly communicates the button's function to the user. 6. Drag&connect the Virtual Output Command (Switch1 trigger) with the OPEN output (O1).