Update readme

README.md

@@ -20,13 +20,13 @@ You could also monitor the voltage level on older intercoms (14-24V) by replacin
 Thanks a lot to [PCBWay](https://pcbway.com) for sponsoring this Project.
 Scroll down to "Manufacturing" to read more.
 
-** Please also take a look at the Getting started section for first-use instructions.**
+**Please also take a look at the Getting started section for first-use instructions.**
 
 ## 📦 Interested in buying one?
 
 Feel free to contact me on [Discord](https://discord.gg/t2d34dvmBf), [GitHub Issues](https://github.com/AzonInc/Doorman/issues) or by [E-Mail](mailto:flo@azon.ai?subject=Doorman).
 
-I offer you a fully assembled and tested Doorman-S3 for **26€** which comes with ESPHome pre-Installed for direct integration and adoption into Home Assistant.
+I offer you a fully assembled and tested Doorman-S3 which comes with ESPHome pre-installed for direct integration and adoption into Home Assistant.
 
 ## 📫 Have a question? Ran into a problem?
 
@@ -81,22 +81,7 @@ This is the prefered Firmware as it works out of the Box with the Doorman S3 Fir
 This Configuration inherits everything from the Stock Firmware and adds a Nuki Bridge Component via BLE on top.
 
 - **[Doorman by peteh](https://github.com/peteh/doorman)**\
-You need to adjust a few things to make it work with Doorman S3.
-
-## 🖲️ GPIO
-
-Doorman-S3 is using some GPIO for a specific purpose and offers free GPIO as well.
-
-| GPIO | Purpose |
-| :-----: | :-----:|
-| GPIO01 | Red Status LED |
-| GPIO02 | WS2812B RGB Status LED |
-| GPIO08 | TCS Bus TX - Shorts the Bus to Ground |
-| GPIO09 | TCS Bus RX - Reading Bus Data / ADC input (behind Voltage Divider - 1M+160K) |
-| GPIO40 | Free I/O |
-| GPIO41 | External Button (10K Resistor) |
-| GPIO42 | Relay for analog door opener |
-| GPIO48 | Free I/O |
+You need to adjust a few things (GPIO, Board Type, Flash Size) to make it work with Doorman S3.
 
 ## ⚡ Wiring
 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 +30V) and B (Ground) Screw Terminal.\
@@ -110,7 +95,6 @@ If it is connected in 3-wire mode you should be able to use the P-Line to power
 
 > [!NOTE]
 > On some installations the a and b wires are twisted but it doesn't matter because Doorman has an integrated bridge rectifier to handles that for you.
-<!--> However if you want to power your Doorman in two-wire-mode using the bus wire it's only possible with hardware revision >= V1.4.-->
 
 > [!WARNING]
 > The minimum output current of the intercom power supply **must be 60mA** in order to achieve a stable operation!\
@@ -126,14 +110,10 @@ If it is connected in 3-wire mode you should be able to use the P-Line to power
 #### 2-Wire Mode (with external Power Supply)
 <img src=".github/images/wiring_2wire_power_screwterminal.png" alt="2 Wire Installation" height="275">
 
-> [!IMPORTANT]
-> Please check the polarity of a- and b-wires as the bridge rectifier can only handle two wires but not three.
-> Be sure to connect the ground wire of your external power supply to the same Screw Terminal as the ground wire that comes from your intercom.
-
 1. Open the Intercom enclosure
 2. Connect the a-wire (24V Bus) to one of the TCS:BUS-Terminals of your Doorman
 3. Connect the b-wire (Ground) to the other TCS:BUS-Terminal of your Doorman
-4. Connect an external Power Supply via USB-C Port or P (+5V to +30V) and b (Ground) Screw Terminals of your Doorman
+4. Connect an external Power Supply via P (+5V to +30V) and G (Ground) Screw Terminals of your Doorman
 
 #### 2-Wire Mode (with external Power Supply via USB-C)
 <img src=".github/images/wiring_2wire_power_usb_c.png" alt="2 Wire Installation" height="275">
@@ -160,17 +140,45 @@ If it is connected in 3-wire mode you should be able to use the P-Line to power
 1. Open the Intercom enclosure
 2. Connect the a-wire (24V Bus) to one of the TCS:BUS-Terminals of your Doorman
 3. Connect the b-wire (Ground) to the other TCS:BUS-Terminal of your Doorman
-4. Connect the P-wire (+24V) to the P-Terminal of your Doorman 
+4. Connect the P-wire (+24V) to the P-Terminal of your Doorman
+
+## 🚀 Getting started
+
+When you power on your Doorman-S3 for the first time it opens an Access Point called "Doorman-S3 Setup".
+The AP Password is "open-sesame".
+You can setup your WiFi credentials there or also via Improv Serial + Improv Bluetooth.
+
+Thanks to mDNS Support Homeassistant will find your Doorman out of the box.
+After adding your Doorman to Homeassistant you need to enable the Last Bus Command Sensor to capture the Bus commands of your intercom.
+
+When you obtained all neccessary commands you can adopt the device in your ESPHome Dashboard and flash the `stock.example.yaml` firmware with adjusted command values.
+
+After flashing the example you should have the following entities (if you enable all of them):
+
+<img src=".github/images/dashboard.png" alt="Homeassistant Device Dashboard" height="500">
+
+That's basically everything you need to do. Happy automating!
 
 ## 📟 Obtaining Command Codes from the Bus
 
-Depending on the Firmware you are using, there are different methods to obtain Command Codes.
+Every received Command Code is logged in the ESPHome Console (Debug Log-Level) and also published as an Home Assistant Event.
+Besides that there is a "Last Bus Command" Text Sensor (disabled by default) which shows the last Bus Command.
+If you use the command in your yaml config file you need to prepend 0x in order to interpret is as a hexadecimal number.
 
-- **[ESPHome](https://github.com/AzonInc/doorman/tree/master/firmware)**\
-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.
+## 🖲️ GPIO
 
-- **[Doorman by peteh](https://github.com/peteh/doorman)**\
-You can find a detailed explanation in the repository. It's kinda similar.
+Doorman-S3 needs some GPIO for a specific purpose and offers free GPIO for your sensors.
+
+| GPIO | Purpose |
+| :----- | :-----|
+| GPIO01 | Red Status LED |
+| GPIO02 | WS2812B RGB Status LED |
+| GPIO08 | TCS Bus TX - Shorts the Bus to Ground |
+| GPIO09 | TCS Bus RX - Reading Bus Data / ADC input (onboard Voltage Divider - 1M+160K) |
+| GPIO40 | Free I/O |
+| GPIO41 | External Button (10K onboard resistor) |
+| GPIO42 | Relay for analog door opener |
+| GPIO48 | Free I/O |
 
 ## 🛠️ Manufacturing
 
@@ -193,19 +201,6 @@ In case you want an enclosure you can print your own one.\
 Just use the STL files provided [here](https://github.com/AzonInc/Doorman/tree/master/enclosure) and you'll be good to go.\
 <img src=".github/images/enclosure.png" alt="Doorman S3" height="275">
 
-## 🚀 Getting started
-
-When you power on your Doorman-S3 for the first time it opens an Access Point called "Doorman-S3 Setup".
-The AP Password is "open-sesame".
-You can setup your WiFi credentials there or also via Improv Serial + Improv Bluetooth.
-
-Thanks to mDNS Support Homeassistant will find your Doorman out of the box.
-After adding your Doorman to Homeassistant you need to enable the Last Bus Command Sensor to capture the Bus commands of your intercom.
-
-When you obtained all neccessary commands you can adopt the device in your ESPHome Dashboard and flash the `stock.example.yaml` firmware with adjusted command values.
-
-That's basically everything you need to do. Happy automating!
-
 ## ⚠️ Disclaimer
 
 Please DO NOT use the +24V P-Line if the Power Supply is not powerful enough.\