Skip to content

ESP32-S3 based Intercom Gateway (TCS / Koch / Niko / Scantron / Analogue Systems)

License

Notifications You must be signed in to change notification settings

AzonInc/Doorman

Repository files navigation


Doorman S3

Doorman S3

Doorman S3 is a versatile intercom gateway designed to connect your TCS or Koch intercom system to any home automation platform. It's also compatible with rebranded versions of Niko, Scantron, and older Jung intercom models.

But that's not all - the Doorman S3 is more than just an intercom bridge. With its integrated relay, you can simulate button presses to control door openers or lights, supporting up to 40V and a maximum of 2.5A.

Even if your intercom system isn't directly listed, if it operates on a 2-wire bus in the 14-24V DC range, you may still be able to implement other protocols. Additionally, you can monitor voltage levels from older intercom systems to trigger actions based on those readings.

For more information on the manufacturing process, head to the Manufacturing section further down.


    🚀 Getting started

Before diving into the installation process, visit the Doorman Docs for comprehensive setup guides. If you have questions, don't hesitate to reach out on Discord or GitHub Issues. I'm here to assist!


    📦 Interested in buying one?

You can get fully assembled Doorman S3 units with the Stock Firmware pre-installed and ready for immediate integration into Home Assistant.

For inquiries, feel free to reach out via:


    🛠️ Built Your Own Hardware?

Check out the TC:BUS ESPHome component documentation for detailed instructions on integrating your DIY hardware with the TC:BUS. Whether you're expanding your Doorman project or using it as a starting point for your own system, this resource will guide you through seamless integration.


    🤖 Features

  • ESP32-S3 Powered for robust performance
  • USB-C port for effortless flashing (because USB-C is just cool 😎)
  • Compact design fits into any setup
  • Configurable WS2812B RGB LED for event-based visual indicators
  • Two additional GPIOs for easy expansion (e.g., I²C sensors)
  • Solid-state relay for switching up to 40V (max. 2.5A)—perfect for older intercom systems
  • External Button (G + BTN) for manual triggering
  • Bridge Rectifier for correcting polarity on bus-wire input
  • TC:BUS Communication for door functions and detecting the doorbell
  • Nuki Bridge functionality with the Nuki Bridge Firmware (Note: Incompatible with Nuki app but works with Home Assistant app)

    ✔️ Compatibility

If your TCS or Koch intercom uses screw terminals labeled a, b, and P and operates on 24V DC, it's most likely compatible with Doorman.

For more in-depth compatibility information, refer to the Compatibility Docs.


    🛠️ Manufacturing

PCBX Delivery

A huge thanks to PCBX for manufacturing and sponsoring 10 awesome PCBs for this project! Your support means a lot to us, and your prices are seriously hard to beat. We're thrilled to have you on board!

If you're looking for a reliable PCB manufacturer for your own project, definitely check out PCBX. While their production might take a little longer than some others, the unbeatable prices and super-easy part sourcing make it absolutely worth it. They handle everything for you!

You can find all the necessary files for manufacturing the Doorman-S3 here.


    🙌 Contributing

Contributions to the Doorman project are always welcome! Whether it's code improvements, bug fixes, or documentation updates, your help is greatly appreciated. Please feel free to open a Pull Request.


    🚩 Repository Structure

The repository is organized as follows:

  • blueprints: Automation Blueprints for Home Assistant
  • components: External component files for ESPHome
  • docs: Documentation
  • enclosure: STL design files for the enclosure
  • firmware: ESPHome configuration files
  • pcb: KiCad schematic and PCB design files

    📜 Credits

The Doorman S3 project heavily relies on contributions from several key sources. Without their efforts, this project wouldn't be where it is today. ❤️

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
Thank you so much for your time, patience, expertise, and every piece of invaluable advice that helped make this project better, smaller, and more affordable.

calibanorg
Thank you so much for your support, both in terms of encouragement and financial assistance, in the development of Doorman.