From d3d5c21d38b4c57735dc21dd7e89a4bf5cbbbd40 Mon Sep 17 00:00:00 2001 From: Edward Firmo <94725493+edwardtfn@users.noreply.github.com> Date: Fri, 27 Dec 2024 09:27:13 +0100 Subject: [PATCH 01/14] Add install instructions --- README.md | 104 ++++++++++++++++++++++++++++++++++++++++++++++++++---- 1 file changed, 98 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index b6b6b29..9c9f1c6 100644 --- a/README.md +++ b/README.md @@ -92,12 +92,103 @@ Before getting started, ensure you have: ## Installation -Detailed installation instructions coming soon. The process will include: +Follow these steps to get your TX Ultimate device up and running with ESPHome. -1. Initial ESPHome setup -2. Device flashing -3. Home Assistant integration -4. Basic configuration +### 1. ESPHome Integration Setup + +1. Install ESPHome add-on in Home Assistant if not already installed: + - Go to Settings → Add-ons → Add-on Store + - Search for "ESPHome" + - Click Install +2. Start the ESPHome add-on and verify it's running +3. Access ESPHome dashboard through Home Assistant + +### 2. Device Configuration + +1. In ESPHome dashboard, click "+ New Device" +2. Name your device (e.g., "tx-ultimate-living-room") +3. Select ESP32 as your device type +4. Copy this basic configuration to your new device: + ```yaml + substitutions: + name: tx-ultimate-easy # Change this to your device name + friendly_name: TX Ultimate Easy + + packages: + remote_package: + url: https://github.com/edwardtfn/TX-Ultimate-Easy + ref: main # For latest stable release + # ref: dev # For testing new features + files: + - ESPHome/TX-Ultimate-Easy-ESPHome.yaml + + wifi: + ssid: !secret wifi_ssid + password: !secret wifi_password + ``` +5. Click "Save" and then "Install" + +### 3. Device Flashing + +Initial flashing must be done via serial connection. +We recommend using [ESPHome Web](https://web.esphome.io) for the simplest experience. + +#### Required Hardware +- USB-to-UART adapter (3.3V) +- Small Phillips screwdriver +- 5 wires for connections (including one for BOOT to GND) + +#### Flashing Process +1. Open your TX Ultimate device carefully +2. Locate the programming header pins +3. Connect your USB-to-UART adapter: + - GND → GND + - 3.3V → 3.3V + - TX → RX + - RX → TX +4. Put device in flash mode: + - Connect the BOOT pin to GND using a jumper wire + - Power up the device (keeping BOOT connected to GND) + - Remove the BOOT to GND connection +5. Visit [ESPHome Web](https://web.esphome.io) +6. Connect to your device and flash the firmware +7. After successful flash, device will restart and be ready for OTA updates + +#### Detailed Visual Guides +For step-by-step visual instructions, you can reference these existing guides: +- 🇬🇧 [WirelessThings Guide](https://wirelessthings.net/how-to-flash-sonoff-tx-ultimate-with-esphome) - + English guide with detailed photos +- 🇪🇸 [Un loco y su tecnología](https://youtu.be/58v8oqSQgXQ?t=143) - Spanish video tutorial +- 🇩🇪 [SmartHome yourself](https://youtu.be/naDLhX89enQ?t=465) - German video tutorial + +Note: While these guides may use different firmware, the physical flashing process remains the same. + +#### Subsequent Updates +After initial flashing, all future updates can be done wirelessly (OTA) +through the ESPHome dashboard in your ESPHome add-on. + +### 4. Home Assistant Integration + +After successful flashing: +1. Device will automatically be discovered by Home Assistant +2. Accept the discovery notification to add device +3. Device will appear in your Home Assistant Devices dashboard + +### 5. Initial Configuration + +1. In Home Assistant, navigate to: + - Settings → Devices & Services → ESPHome + - Click on your device to access its configuration page +2. Set basic device parameters: + - Model format (EU/US) + - Number of gangs (1-4) + - Relay modes (switch/light) + - Button actions +3. Optional: Configure advanced features + - LED behaviors + - Touch sensitivity + - Haptic feedback + - Audio feedback ## Usage @@ -156,7 +247,8 @@ This project builds upon the work of several amazing projects and contributors: - [SmartHome yourself - SONOFF TX Ultimate for ESPHome](https://github.com/SmartHome-yourself/sonoff-tx-ultimate-for-esphome) - [Un loco y su tecnología - Sonoff TX Ultimate with ESPHome](https://www.youtube.com/watch?v=58v8oqSQgXQ) -- @PxPert - [Sonoff TX Ultimate and Voice Assistant](https://community.home-assistant.io/t/sonoff-tx-ultimate-and-voice-assistant/682214?u=edwardtfn) +- [@PxPert](https://github.com/PxPert) - + [Sonoff TX Ultimate and Voice Assistant](https://community.home-assistant.io/t/sonoff-tx-ultimate-and-voice-assistant/682214?u=edwardtfn) Special thanks to all contributors and community members who help make this project better. From 40f8165d5c814c11ef50c76b3464e0b1ba71ba5f Mon Sep 17 00:00:00 2001 From: Edward Firmo <94725493+edwardtfn@users.noreply.github.com> Date: Fri, 27 Dec 2024 09:30:55 +0100 Subject: [PATCH 02/14] Fix link to reference in English --- README.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 9c9f1c6..a6dd557 100644 --- a/README.md +++ b/README.md @@ -155,11 +155,12 @@ We recommend using [ESPHome Web](https://web.esphome.io) for the simplest experi 7. After successful flash, device will restart and be ready for OTA updates #### Detailed Visual Guides + For step-by-step visual instructions, you can reference these existing guides: -- 🇬🇧 [WirelessThings Guide](https://wirelessthings.net/how-to-flash-sonoff-tx-ultimate-with-esphome) - - English guide with detailed photos +- 🇬🇧 [WirelessThings Guide](https://wirelessthings.io/index.php/2023/12/19/how-to-flash-sonoff-tx-ultimate-with-esphome/) - English guide with detailed photos - 🇪🇸 [Un loco y su tecnología](https://youtu.be/58v8oqSQgXQ?t=143) - Spanish video tutorial - 🇩🇪 [SmartHome yourself](https://youtu.be/naDLhX89enQ?t=465) - German video tutorial + Note: While these guides may use different firmware, the physical flashing process remains the same. From 4266a7cdd8e34e4068311aabab796e0f0eb7be1b Mon Sep 17 00:00:00 2001 From: Edward Firmo <94725493+edwardtfn@users.noreply.github.com> Date: Fri, 27 Dec 2024 09:48:52 +0100 Subject: [PATCH 03/14] Add a bit more of details As suggested by CodeRabbitAI --- README.md | 27 +++++++++++++++++++++++---- 1 file changed, 23 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index a6dd557..120bce4 100644 --- a/README.md +++ b/README.md @@ -118,7 +118,6 @@ Follow these steps to get your TX Ultimate device up and running with ESPHome. remote_package: url: https://github.com/edwardtfn/TX-Ultimate-Easy ref: main # For latest stable release - # ref: dev # For testing new features files: - ESPHome/TX-Ultimate-Easy-ESPHome.yaml @@ -126,6 +125,11 @@ Follow these steps to get your TX Ultimate device up and running with ESPHome. ssid: !secret wifi_ssid password: !secret wifi_password ``` + + You can also use a specific version tag for better control over updates: + ```yaml + ref: v2025.1.3 # Replace with desired version (format: vYYYY.MM.nn) + ``` 5. Click "Save" and then "Install" ### 3. Device Flashing @@ -171,9 +175,24 @@ through the ESPHome dashboard in your ESPHome add-on. ### 4. Home Assistant Integration After successful flashing: -1. Device will automatically be discovered by Home Assistant -2. Accept the discovery notification to add device -3. Device will appear in your Home Assistant Devices dashboard +1. Ensure your device and Home Assistant are on the same network +2. Device should be automatically discovered within a couple of minutes +3. Accept the discovery notification to add device +4. Device will appear in your Home Assistant Devices dashboard + +#### Troubleshooting Integration +If the device isn't discovered automatically: +1. Verify your device is powered and connected to your network: + - Look for the device in your router's client list + - Consider using [manual IP](https://esphome.io/components/wifi.html#manual-ips) in your device +2. If you missed the discovery notification: + - Go to Settings → Devices & Services + - Click "Add Integration" + - Search for "ESPHome" and enter your device's IP address +3. Still having issues? + - Check your network allows mDNS/discovery traffic + - Verify there are no VLANs or network isolation preventing communication + - Try rebooting both the device and Home Assistant ### 5. Initial Configuration From b7a66b2e87c91323a853002ff008b38346e0c265 Mon Sep 17 00:00:00 2001 From: Edward Firmo <94725493+edwardtfn@users.noreply.github.com> Date: Fri, 27 Dec 2024 10:02:05 +0100 Subject: [PATCH 04/14] Adding warnings --- README.md | 20 +++++++++++++++++++- 1 file changed, 19 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 120bce4..ec919f4 100644 --- a/README.md +++ b/README.md @@ -137,8 +137,26 @@ Follow these steps to get your TX Ultimate device up and running with ESPHome. Initial flashing must be done via serial connection. We recommend using [ESPHome Web](https://web.esphome.io) for the simplest experience. +> [!IMPORTANT] +> **SAFETY WARNINGS** +> - ALWAYS disconnect the device from mains power before opening +> - NEVER work on the device while connected to mains power +> - Ensure the device is completely powered off before making any connections +> - Keep your workspace clean, dry, and static-free +> - Use proper insulated tools when working with electronics +> - If unsure about any step, seek help from an experienced person + +> [!CAUTION] +>⚡ **CRITICAL: VOLTAGE WARNING** +> Using a UART adapter with voltage higher than 3.3V WILL DAMAGE YOUR DEVICE. +> Double-check your adapter's voltage before connecting - many common FTDI adapters +> default to 5V which will permanently damage the ESP32 chip. + #### Required Hardware -- USB-to-UART adapter (3.3V) +- USB-to-UART adapter: + - 3.3V logic level ONLY (DO NOT use 5V adapters) + - Must be capable of supplying at least 500mA + - Common adapters: CP2102, CH340, FTDI (ensure 3.3V setting) - Small Phillips screwdriver - 5 wires for connections (including one for BOOT to GND) From 09514e13316e983cd2501e15f1ae5c1a6f752822 Mon Sep 17 00:00:00 2001 From: Edward Firmo <94725493+edwardtfn@users.noreply.github.com> Date: Fri, 27 Dec 2024 10:04:14 +0100 Subject: [PATCH 05/14] Disable markdown lint --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index ec919f4..4668617 100644 --- a/README.md +++ b/README.md @@ -137,6 +137,7 @@ Follow these steps to get your TX Ultimate device up and running with ESPHome. Initial flashing must be done via serial connection. We recommend using [ESPHome Web](https://web.esphome.io) for the simplest experience. + > [!IMPORTANT] > **SAFETY WARNINGS** > - ALWAYS disconnect the device from mains power before opening @@ -151,6 +152,7 @@ We recommend using [ESPHome Web](https://web.esphome.io) for the simplest experi > Using a UART adapter with voltage higher than 3.3V WILL DAMAGE YOUR DEVICE. > Double-check your adapter's voltage before connecting - many common FTDI adapters > default to 5V which will permanently damage the ESP32 chip. + #### Required Hardware - USB-to-UART adapter: From 0779279d442ee72d9c552faf3173abead19d9758 Mon Sep 17 00:00:00 2001 From: Edward Firmo <94725493+edwardtfn@users.noreply.github.com> Date: Fri, 27 Dec 2024 10:10:26 +0100 Subject: [PATCH 06/14] Add dynamic version example --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 4668617..93b6800 100644 --- a/README.md +++ b/README.md @@ -128,7 +128,7 @@ Follow these steps to get your TX Ultimate device up and running with ESPHome. You can also use a specific version tag for better control over updates: ```yaml - ref: v2025.1.3 # Replace with desired version (format: vYYYY.MM.nn) + ref: v[![version]][version] # Using specific version for controlled updates ``` 5. Click "Save" and then "Install" From ebd8a5432ab07f608ba18ac9573793e342c6e509 Mon Sep 17 00:00:00 2001 From: Edward Firmo <94725493+edwardtfn@users.noreply.github.com> Date: Fri, 27 Dec 2024 10:20:24 +0100 Subject: [PATCH 07/14] Minor changes as suggested by CodeRabbitAI --- README.md | 25 +++++++++++++++++-------- 1 file changed, 17 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index 93b6800..fcea48d 100644 --- a/README.md +++ b/README.md @@ -128,8 +128,12 @@ Follow these steps to get your TX Ultimate device up and running with ESPHome. You can also use a specific version tag for better control over updates: ```yaml - ref: v[![version]][version] # Using specific version for controlled updates + ref: v2024.12.2 # Using specific version for controlled updates ``` + + > [!NOTE] + > [Click here](https://github.com/edwardtfn/TX-Ultimate-Easy/tags) for a full list of versions available + 5. Click "Save" and then "Install" ### 3. Device Flashing @@ -171,9 +175,9 @@ We recommend using [ESPHome Web](https://web.esphome.io) for the simplest experi - TX → RX - RX → TX 4. Put device in flash mode: - - Connect the BOOT pin to GND using a jumper wire - - Power up the device (keeping BOOT connected to GND) - - Remove the BOOT to GND connection + - Temporarily connect the BOOT pin to GND using a jumper wire + - While holding BOOT to GND, power up the device + - After device powers up (wait a couple of seconds), remove the BOOT to GND connection 5. Visit [ESPHome Web](https://web.esphome.io) 6. Connect to your device and flash the firmware 7. After successful flash, device will restart and be ready for OTA updates @@ -196,8 +200,9 @@ through the ESPHome dashboard in your ESPHome add-on. After successful flashing: 1. Ensure your device and Home Assistant are on the same network -2. Device should be automatically discovered within a couple of minutes -3. Accept the discovery notification to add device +2. Device should be automatically discovered within 1-2 minutes +3. Accept the discovery notification in Home Assistant to add device + Note: If discovery takes longer than 5 minutes, proceed to troubleshooting steps 4. Device will appear in your Home Assistant Devices dashboard #### Troubleshooting Integration @@ -230,6 +235,9 @@ If the device isn't discovered automatically: - Haptic feedback - Audio feedback +> [!NOTE] +> Some changes may require a device restart + ## Usage After installation, you can: @@ -285,10 +293,11 @@ Note: For proper tracking and resolution: This project builds upon the work of several amazing projects and contributors: + - [SmartHome yourself - SONOFF TX Ultimate for ESPHome](https://github.com/SmartHome-yourself/sonoff-tx-ultimate-for-esphome) - [Un loco y su tecnología - Sonoff TX Ultimate with ESPHome](https://www.youtube.com/watch?v=58v8oqSQgXQ) -- [@PxPert](https://github.com/PxPert) - - [Sonoff TX Ultimate and Voice Assistant](https://community.home-assistant.io/t/sonoff-tx-ultimate-and-voice-assistant/682214?u=edwardtfn) +- [@PxPert](https://github.com/PxPert) - [Sonoff TX Ultimate and Voice Assistant](https://community.home-assistant.io/t/sonoff-tx-ultimate-and-voice-assistant/682214?u=edwardtfn) + Special thanks to all contributors and community members who help make this project better. From 05c40cf7b5b76e2064acd4ac2ce4351f0d64f51a Mon Sep 17 00:00:00 2001 From: Edward Firmo <94725493+edwardtfn@users.noreply.github.com> Date: Fri, 27 Dec 2024 10:24:39 +0100 Subject: [PATCH 08/14] Pinout in a table and test instructions --- README.md | 17 ++++++++++++----- 1 file changed, 12 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index fcea48d..3d81669 100644 --- a/README.md +++ b/README.md @@ -170,10 +170,12 @@ We recommend using [ESPHome Web](https://web.esphome.io) for the simplest experi 1. Open your TX Ultimate device carefully 2. Locate the programming header pins 3. Connect your USB-to-UART adapter: - - GND → GND - - 3.3V → 3.3V - - TX → RX - - RX → TX + | Adapter | Device | + |---------|--------| + | GND | GND | + | 3.3V | 3.3V | + | TX | RX | + | RX | TX | 4. Put device in flash mode: - Temporarily connect the BOOT pin to GND using a jumper wire - While holding BOOT to GND, power up the device @@ -200,7 +202,7 @@ through the ESPHome dashboard in your ESPHome add-on. After successful flashing: 1. Ensure your device and Home Assistant are on the same network -2. Device should be automatically discovered within 1-2 minutes +2. Device should be automatically discovered within 1–2 minutes 3. Accept the discovery notification in Home Assistant to add device Note: If discovery takes longer than 5 minutes, proceed to troubleshooting steps 4. Device will appear in your Home Assistant Devices dashboard @@ -234,6 +236,11 @@ If the device isn't discovered automatically: - Touch sensitivity - Haptic feedback - Audio feedback +4. Test your configuration: + - Verify each relay responds to controls + - Test configured button actions + - Confirm LED behavior matches settings + - Check haptic/audio feedback if enabled > [!NOTE] > Some changes may require a device restart From bd5091293eae054e647a59265ec744f36d75f28f Mon Sep 17 00:00:00 2001 From: Edward Firmo <94725493+edwardtfn@users.noreply.github.com> Date: Fri, 27 Dec 2024 10:29:50 +0100 Subject: [PATCH 09/14] Remove numbered sections --- README.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 3d81669..3aea939 100644 --- a/README.md +++ b/README.md @@ -94,7 +94,7 @@ Before getting started, ensure you have: Follow these steps to get your TX Ultimate device up and running with ESPHome. -### 1. ESPHome Integration Setup +### ESPHome Integration Setup 1. Install ESPHome add-on in Home Assistant if not already installed: - Go to Settings → Add-ons → Add-on Store @@ -103,7 +103,7 @@ Follow these steps to get your TX Ultimate device up and running with ESPHome. 2. Start the ESPHome add-on and verify it's running 3. Access ESPHome dashboard through Home Assistant -### 2. Device Configuration +### Device Configuration 1. In ESPHome dashboard, click "+ New Device" 2. Name your device (e.g., "tx-ultimate-living-room") @@ -136,7 +136,7 @@ Follow these steps to get your TX Ultimate device up and running with ESPHome. 5. Click "Save" and then "Install" -### 3. Device Flashing +### Device Flashing Initial flashing must be done via serial connection. We recommend using [ESPHome Web](https://web.esphome.io) for the simplest experience. @@ -198,7 +198,7 @@ Note: While these guides may use different firmware, the physical flashing proce After initial flashing, all future updates can be done wirelessly (OTA) through the ESPHome dashboard in your ESPHome add-on. -### 4. Home Assistant Integration +### Home Assistant Integration After successful flashing: 1. Ensure your device and Home Assistant are on the same network @@ -221,7 +221,7 @@ If the device isn't discovered automatically: - Verify there are no VLANs or network isolation preventing communication - Try rebooting both the device and Home Assistant -### 5. Initial Configuration +### Initial Configuration 1. In Home Assistant, navigate to: - Settings → Devices & Services → ESPHome From da9dfbf8081ae8863e783476f7bbd09ceee21ea2 Mon Sep 17 00:00:00 2001 From: Edward Firmo <94725493+edwardtfn@users.noreply.github.com> Date: Fri, 27 Dec 2024 10:31:57 +0100 Subject: [PATCH 10/14] Remove duplicated section label --- README.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/README.md b/README.md index 3aea939..4d08ec6 100644 --- a/README.md +++ b/README.md @@ -103,7 +103,7 @@ Follow these steps to get your TX Ultimate device up and running with ESPHome. 2. Start the ESPHome add-on and verify it's running 3. Access ESPHome dashboard through Home Assistant -### Device Configuration +### Setup Device 1. In ESPHome dashboard, click "+ New Device" 2. Name your device (e.g., "tx-ultimate-living-room") @@ -130,10 +130,8 @@ Follow these steps to get your TX Ultimate device up and running with ESPHome. ```yaml ref: v2024.12.2 # Using specific version for controlled updates ``` - > [!NOTE] > [Click here](https://github.com/edwardtfn/TX-Ultimate-Easy/tags) for a full list of versions available - 5. Click "Save" and then "Install" ### Device Flashing From a224cd5f866c74b80645a20cfbaf126484852170 Mon Sep 17 00:00:00 2001 From: Edward Firmo <94725493+edwardtfn@users.noreply.github.com> Date: Fri, 27 Dec 2024 10:33:24 +0100 Subject: [PATCH 11/14] Indentation on note --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 4d08ec6..0695c6e 100644 --- a/README.md +++ b/README.md @@ -130,8 +130,8 @@ Follow these steps to get your TX Ultimate device up and running with ESPHome. ```yaml ref: v2024.12.2 # Using specific version for controlled updates ``` - > [!NOTE] - > [Click here](https://github.com/edwardtfn/TX-Ultimate-Easy/tags) for a full list of versions available + > [!NOTE] + > [Click here](https://github.com/edwardtfn/TX-Ultimate-Easy/tags) for a full list of versions available 5. Click "Save" and then "Install" ### Device Flashing From 8b7fad76c1ccc6e262cd65ada11846c5f120e469 Mon Sep 17 00:00:00 2001 From: Edward Firmo <94725493+edwardtfn@users.noreply.github.com> Date: Fri, 27 Dec 2024 10:34:45 +0100 Subject: [PATCH 12/14] Update README.md --- README.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/README.md b/README.md index 0695c6e..616f521 100644 --- a/README.md +++ b/README.md @@ -130,8 +130,7 @@ Follow these steps to get your TX Ultimate device up and running with ESPHome. ```yaml ref: v2024.12.2 # Using specific version for controlled updates ``` - > [!NOTE] - > [Click here](https://github.com/edwardtfn/TX-Ultimate-Easy/tags) for a full list of versions available + **Note:** [Click here](https://github.com/edwardtfn/TX-Ultimate-Easy/tags) for a full list of versions available. 5. Click "Save" and then "Install" ### Device Flashing From b5a96387cb2ae125f114ca497d0264d1f073ec6e Mon Sep 17 00:00:00 2001 From: Edward Firmo <94725493+edwardtfn@users.noreply.github.com> Date: Fri, 27 Dec 2024 10:35:10 +0100 Subject: [PATCH 13/14] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 616f521..64d0855 100644 --- a/README.md +++ b/README.md @@ -130,7 +130,7 @@ Follow these steps to get your TX Ultimate device up and running with ESPHome. ```yaml ref: v2024.12.2 # Using specific version for controlled updates ``` - **Note:** [Click here](https://github.com/edwardtfn/TX-Ultimate-Easy/tags) for a full list of versions available. + **Note:** [Click here](https://github.com/edwardtfn/TX-Ultimate-Easy/tags) for a full list of versions available. 5. Click "Save" and then "Install" ### Device Flashing From 8a343ab8fe03ae48ddcfa8c45b17ebb73124e9ef Mon Sep 17 00:00:00 2001 From: Edward Firmo <94725493+edwardtfn@users.noreply.github.com> Date: Fri, 27 Dec 2024 10:39:51 +0100 Subject: [PATCH 14/14] CodeRabbitAI --- README.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 64d0855..84ae042 100644 --- a/README.md +++ b/README.md @@ -96,7 +96,7 @@ Follow these steps to get your TX Ultimate device up and running with ESPHome. ### ESPHome Integration Setup -1. Install ESPHome add-on in Home Assistant if not already installed: +1. Install the ESPHome add-on in Home Assistant if not already installed: - Go to Settings → Add-ons → Add-on Store - Search for "ESPHome" - Click Install @@ -105,7 +105,7 @@ Follow these steps to get your TX Ultimate device up and running with ESPHome. ### Setup Device -1. In ESPHome dashboard, click "+ New Device" +1. In the ESPHome dashboard, click "+ New Device" 2. Name your device (e.g., "tx-ultimate-living-room") 3. Select ESP32 as your device type 4. Copy this basic configuration to your new device: @@ -167,12 +167,14 @@ We recommend using [ESPHome Web](https://web.esphome.io) for the simplest experi 1. Open your TX Ultimate device carefully 2. Locate the programming header pins 3. Connect your USB-to-UART adapter: + | Adapter | Device | |---------|--------| | GND | GND | | 3.3V | 3.3V | | TX | RX | | RX | TX | + 4. Put device in flash mode: - Temporarily connect the BOOT pin to GND using a jumper wire - While holding BOOT to GND, power up the device