This repository contains the source files for the Doorman S3 Intercom Gateway, a device which lets you connect your TCS or Koch intercom to any home automation system.
However it's not limited to TCS and Koch intercoms only. With the integrated relais you can easily simulate a button press to trigger the door opener or the light (up to 40V, max 2.5A).
If your intercom is not a TCS or Koch one but operates on a 2-wire bus (14-24V) it might be possible to implement other protocols as well.
You could also monitor the voltage level on older intercoms (14-24V) by replacing the tcs_intercom component with a template Binary Sensor combined with ADC and trigger specific actions based on it.
I'm happy to answer your questions on Discord or GitHub Issues.
At the root of the repository you will find these directories:
pcb
: KiCad schematic and PCB design filesfirmware
: ESPHome configuration filesenclosure
: Enclosure STL Files
- Powered by ESP32-S3
- USB-C port for easy flashing (and because USB-C is cool π)
- It's super small (37mm x 37mm) and fits almost everywhere
- Configurable WS2812B RGB LED to indicate specific events
- 2 additional GPIO via Screw Terminal for easy expansion with your own sensors and devices
- 1 Relay via Screw Terminal to switch up to 40V (max. 2.5A) for oldschool intercom systems
- 1 External Button via Screw Terminal (G + BTN)
- Bridge Rectifier on the Bus Input to correct wire polarity
- TCS Bus Communication (e.g. Open the front door, Detect Doorbell)
- You can optionally use your Doorman as a Nuki Bridge (incompatible with Nuki App, Bluetooth only)
The ESPHome Doorman Stock Firmware implements the following:
- Party Mode
Automatically opens the Door when the Doorbell is pressed.
The Party Mode Switch Entity is disabled by default.
Furthermore you could implement the following:
- Doorbell Button Pattern Detection
Automatically open the door when the Doorbell is pressed x times in a certain way.
You can find an Example in the Firmware Examples directory.
If your TCS or Koch Intercom got a, b and P labeled Screw Terminals and is operating on 24V DC it's likely compatible.
You can use Doorman S3 with your prefered Firmware.
There are a few Options:
-
ESPHome - Doorman Stock
This is the prefered Firmware as it works out of the Box with the Doorman S3 Firmware Configuration Files. -
ESPHome - Doorman Nuki-Bridge
This Configuration inherits everything from the Stock Firmware and adds a Nuki Bridge Component via BLE on top. -
Doorman by peteh
You need to adjust a few things to make it work with Doorman S3.
If your Intercom is connected in 2-wire mode and you dont have a separate 24V P-Line you need to use an external Power Supply via USB-C or P (+5V to +24V) and B (Ground) Screw Terminal.
If it is connected in 3-wire mode you should be able to use the P-Line to power your Doorman in most cases.
- a is usually the Bus line (+24V)
- b is usually GND
- P is the +24V line in 3-wire mode or just the apartment bell button in 2-wire mode
β On some installations the a and b wires are twisted but it doesn't matter because Doorman has an integrated bridge rectifier to fix that for you.
β οΈ BE AWARE
The minimum output current of the intercom power supply must be 60mA in order to achieve a stable operation!
However it is possible that some other devices using the 24V-wire are taking too much current so it's not sufficient to power Doorman anymore.
A best case scenario would be that you can use the P-wire with 60mA. That doesn't work for everyone tho.\Please power your Doorman with an external Power Supply (USB-C or Screw Terminal) if your Intercom provides less than 60mA or whenever you notice an unstable operation.
β οΈ DO NOT USE THE +24V P-LINE AND USB-C AT THE SAME TIME
- Open the Intercom enclosure
- Connect the a-wire (24V Bus) to the a-Terminal of your Doorman
- Connect the b-wire (Ground) to the b-Terminal of your Doorman
- Connect an external Power Supply via USB-C Port or P (+5V to +24V) and b (Ground) Screw Terminals of your Doorman
- Open the Intercom enclosure
- Connect the a-wire (24V Bus) to the a-Terminal of your Doorman
- Connect the b-wire (Ground) to the b-Terminal of your Doorman
- Connect the P-wire (+24V) to the P-Terminal of your Doorman
Depending on the Firmware you are using, there are different methods to obtain Command Codes.
-
ESPHome
If you use the ESPHome Doorman Firmware from this Repository, every received Command Code is logged in the ESPHome Console and also published as an Home Assistant Event. Besides that there is a "Last Bus Command" Text Sensor (disabled by default) which also shows the last Bus Command. -
Doorman by peteh
You can find a detailed explanation in the repository. It's kinda similar.
TODO
Depending on your needs you can print your own Doorman Enclosure.
Just use the STL files provided here.
Please DO NOT use the +24V P-Line if the Power Supply is not powerful enough.
Check your Power Supply first as there are some Power Supply Models which supply less than 60mA on 24V and that won't be enough to power the ESP32.
If you would like to contribute, please feel free to open a Pull Request.
Doorman is heavily built on the code and the information of the following projects and people.
This project would not have been possible without all of them. β€οΈ
TCSIntercomArduino
Different Methods to read from and write to the TCS Bus.
Feel free to watch the Reverse Engineering Video if you're interested.
tcs-monitor
An mqtt monitor for listening to the TCS Bus.
You can find more information in this Blog Post.
Doorman
A lot of this Doorman project is based on peteh's one.
The main goal is to provide a proper PCB for his Doorman Project.
ESPHome_nuki_lock
This module builds an ESPHome lock platform for Nuki Smartlock (nuki_lock).
AStrehlau
Thanks a lot for your time, patience and every single valuable advice that made this Project better, smaller and more affordable.