Overview Doorbird Door Station



This function block integrates a Doorbird video door station via its local network interface (LAN API). The controller reports doorbell and motion events, operates the door opener and the light, and provides the camera image for the Doorbird Door Station control element.

The camera image is fetched by the controller and forwarded to the operating devices over the existing connection — the door station only needs to be reachable in the controller's local network, so the display also works remotely via the app/VPN connection.

Requirements:
  • The Doorbird is on the same network as the controller and has a fixed IP address (or a resolvable host name).
  • Create a dedicated user for the controller in the Doorbird app under Administration → User (user name e. g. "abcdef0001"). This user requires the "watch always" permission, otherwise the door station only delivers the image briefly after a ring event.
Setup — step by step:
  1. Insert the block and open its properties. Enter IP address, user and password.
  2. Use the Test connection / select relay button to verify the connection (controller must be connected). The dialog shows device type and firmware as well as all available relays; double-click a relay to use it for the door opener.
  3. Generate the addresses via address generation and link the control element to the block via right click.
Doorbell and motion events are received over a permanent connection to the door station and are available immediately: the ring/motion outputs deliver a pulse (configurable duration), and the linked control element in the visualization automatically opens a popup with live image and door opener button.

Note: The Doorbird handles only about one API request per second. After several requests with a wrong password the device blocks authentication for one minute (error code 1 on the output).

Inputs
FG
 Enable
 1 = block active (default). With 0 no connections to the door station are established.
TO
 Door opener trigger
 A rising edge operates the door opener (configured relay).
LI
 Light trigger
 A rising edge switches on the light (infrared/ white light of the door station).
CR
 Ring counter reset
 1 resets the ring counter to 0.

Outputs
KL
 Ring pulse
 Pulse (duration = pulse length parameter) when the doorbell is pressed.
BW
 Motion pulse
 Pulse when motion is detected (motion sensor of the door station).
ST
 Status
 0 = offline, 1 = reachable, 2 = reachable and event connection active
KZ
 Ring counter
 Number of doorbell presses since the last reset.
ER
 Error code
 Last error: 0 = OK, 1 = authentication failed/blocked, 2 = timeout, 3 = permission missing (enable "watch always" for the Doorbird user), 4 = busy (another party is already talking)
TA
 Door opener pulse
 Pulse (duration = pulse length parameter) whenever the door opener is triggered — via input TO as well as via the button in the control element. This allows switching a door lock that is not wired to the Doorbird relay but to a separate actuator. Active with mode "Output" or "Both", see parameter Door opener via.
LA
 Light pulse
 Like TA, but for the light (parameter Light via).

Parameters
IP address / host name
 Address of the Doorbird in the local network
Port
 HTTP port of the door station (default 80)
Use HTTPS
 Encrypted connection (port 443, self-signed certificate of the Doorbird). Only effective if the controller was built with SSL support.
User / password
 Credentials of the Doorbird user for the controller (see requirements).
Door opener relay
 Relay to switch, e. g. "1", "2" or "gggaaa@1" (paired door controller). Selectable via the connection test dialog.
Door opener via
 Where the door opener command is routed — it applies to the button in the control element as well as to input TO.
Doorbird relay: the configured relay of the Doorbird (default).
Output: output TA only. The Doorbird is not contacted at all — suitable when the door lock is wired to a separate actuator.
Both: relay and output together.
Light via
 Like Door opener via, but for the light (output LA).
Timeout
 Connection timeout in seconds
Pulse length
 Duration of the ring, motion, door opener and light output pulses in seconds
Debug
 Additional diagnostic output in the error log

See also common parameters of all function blocks.