From 71050df80b76ae851335c584d99009e4b8ef8234 Mon Sep 17 00:00:00 2001 From: GRHM <13894957+grayum@users.noreply.github.com> Date: Thu, 29 Oct 2026 14:38:18 +0100 Subject: [PATCH] Document TYWE1S backup, flashing and pinout; credit Paul Add contributed carrier-board pinout and edited connection/flashing notes. Document a separately sourced full-flash backup procedure and outstanding hardware verification. Credit Paul for development and the original hardware documentation. Co-authored-by: Paul --- AGENTS.md | 4 +- esphome/eurom-mon-soleil-dsp/CHANGELOG.md | 7 + esphome/eurom-mon-soleil-dsp/DATAPOINTS.md | 4 + esphome/eurom-mon-soleil-dsp/README.md | 36 +++- esphome/eurom-mon-soleil-dsp/TESTING.md | 6 + esphome/eurom-mon-soleil-dsp/TODO.md | 12 +- .../eurom-mon-soleil-dsp/TYWE1S_flashing.txt | 187 ++++++++++++++++++ .../eurom-mon-soleil-dsp/images/pinout.png | Bin 0 -> 37303 bytes 8 files changed, 245 insertions(+), 11 deletions(-) create mode 100644 esphome/eurom-mon-soleil-dsp/TYWE1S_flashing.txt create mode 100644 esphome/eurom-mon-soleil-dsp/images/pinout.png diff --git a/AGENTS.md b/AGENTS.md index 85f472c..a969c15 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -7,7 +7,7 @@ This repository contains public Home Assistant and ESPHome examples. Read the re ## Privacy and publication - Never commit actual credentials, API keys, private addresses, household details, private logs, firmware images or flash backups. Use `!secret` and explicit example values. -- Only the supplied public configuration and two approved device photographs may be published from the initial source material. Do not add the manufacturer PDF or extracted manual pages. Link to the manufacturer instead. +- The supplied public configuration, two approved device photographs, Paul-contributed TYWE1S flashing notes and approved pinout image may be published. Do not add the manufacturer PDF or extracted manual pages. Link to the manufacturer instead. - Never assume `.gitignore` removes already tracked secrets. Inspect the staged diff and filenames before a commit. - Do not embed a remote GitHub package dependency, telemetry or a cloud service into a working local configuration without an explicit request. @@ -19,7 +19,7 @@ This repository contains public Home Assistant and ESPHome examples. Read the re - M mode is manual heat control; setting a target temperature does not make M mode thermostatic. Do not describe it otherwise. - DP101 is shared by the climate component and a writable select. Account for the climate component writing it on Heat commands. Document and test changes to this interaction. - Do not add automatic heating on boot, reconnect or time synchronization. Do not bypass safety mechanisms or create artificial fault conditions to test protections. -- Keep factory-backup, initial-flash and four-pin-connector instructions as TODO until verified evidence is provided. A qualified contributor may submit a PR with measurements, orientation photos and revision details. +- TYWE1S_flashing.txt and images/pinout.png contain contributor-supplied carrier-board information. Keep the supplied board numbering separate from bare-module pins and the GPIO assignments in YAML. Distinguish supplied steps from documentation-added backup guidance; do not claim either was independently hardware-tested. Restoration, PCB-revision measurements and connector-to-GPIO tracing remain TODO until evidence is provided. ## Validation and reporting diff --git a/esphome/eurom-mon-soleil-dsp/CHANGELOG.md b/esphome/eurom-mon-soleil-dsp/CHANGELOG.md index 039a5b2..af38894 100644 --- a/esphome/eurom-mon-soleil-dsp/CHANGELOG.md +++ b/esphome/eurom-mon-soleil-dsp/CHANGELOG.md @@ -1,5 +1,12 @@ # Changelog +## Unreleased - TYWE1S documentation contribution 2026-10-29 + +- Added Paul-contributed `TYWE1S_flashing.txt` and the approved carrier-board `images/pinout.png`, with development credit linking to @ph-wheels. +- Corrected spelling and clarified board pin numbering, crossed UART connections, the carrier's separate 5 V supply and 3.3 V TTL signaling, manual bootloader entry, browser serial installation and reconnection. +- Added a documentation-sourced full-flash backup procedure with two reads and comparison; it was absent from the original notes and remains untested on the heater. Restoration remains open. +- Updated the README, agent instructions, datapoint provenance, test notes and TODOs without changing heater-control YAML or claiming new model compatibility. + ## Unreleased - public starter prepared 2026-10-29 - Added the experimental Eurom Mon Soleil DSP project, attributed datapoint observations and the two maintainer-supplied photographs. diff --git a/esphome/eurom-mon-soleil-dsp/DATAPOINTS.md b/esphome/eurom-mon-soleil-dsp/DATAPOINTS.md index 9b7829d..59e00fe 100644 --- a/esphome/eurom-mon-soleil-dsp/DATAPOINTS.md +++ b/esphome/eurom-mon-soleil-dsp/DATAPOINTS.md @@ -29,6 +29,10 @@ No changed datapoint was observed when testing the remote's open-window control. These values describe firmware settings for the test installation. They do not identify the exact module, confirm flash size, specify connector pin order or prove safe voltage levels/isolation. GPIO15 is an ESP8266 boot strap pin; the existing hardware must maintain correct boot conditions. Do not rewire based only on this table. +## Separate carrier-board contribution + +[Paul (@ph-wheels)](https://github.com/ph-wheels) contributed [TYWE1S connection/flashing notes](TYWE1S_flashing.txt) and a [carrier-board pinout](images/pinout.png), supplied through the maintainer on 2026-10-29. The guide uses programming RXD0/TXD0 at carrier pins 9/10; the four-pin heater connector is separately labelled 1=RX, 2=TX, 3=GND, 4=5V. These are contributor-supplied carrier-board labels, not a new module pin definition or a traced mapping to the GPIO13/GPIO15 settings above. Board-revision measurements and independent verification remain open. + ## Evidence needed for changes For a mapping change or new device, provide model/article number, revision, ESPHome version and a redacted sequence showing initial state, one physical/HA action, changed DP value/type and resulting display/heat indication. Include conflicting observations and unknown enum values. Keep private identifiers out of logs, and never intentionally trigger dangerous physical fault conditions. diff --git a/esphome/eurom-mon-soleil-dsp/README.md b/esphome/eurom-mon-soleil-dsp/README.md index 8d7038e..d06a9d9 100644 --- a/esphome/eurom-mon-soleil-dsp/README.md +++ b/esphome/eurom-mon-soleil-dsp/README.md @@ -8,7 +8,7 @@ Home Assistant communicates with ESPHome through its native API; ESPHome exchang ## Current scope -This project provides configuration and operating notes for a suitable device **already running ESPHome with a verified MCU connection**. It is not yet a complete stock-to-ESPHome conversion guide. Factory firmware backup/restoration, initial flashing, module identification and the internal four-pin connector pinout are still [TODO](TODO.md). Do not infer a wiring or flashing procedure from the YAML. +This project provides configuration and operating notes, plus [Paul's TYWE1S carrier-board connection and flashing guide](TYWE1S_flashing.txt) and the [supplied pinout](images/pinout.png). The edited guide adds a factory-flash backup procedure based on Espressif's documentation. These board-specific instructions have not been independently hardware-tested. Restoration, exact PCB-revision verification, electrical measurements and connector-to-GPIO tracing remain [TODO](TODO.md). Do not infer a wiring or flashing procedure from the YAML alone. This is a mains-powered heater. Internal work must be performed by a competent, qualified person with the appliance disconnected and made safe. Do not connect a computer/programmer to potentially mains-referenced electronics. Follow the manufacturer's placement and operating instructions, keep the heater uncovered and supervise experimental operation. Home Assistant availability, a fault sensor reading of zero and a successful software build are not safety guarantees. @@ -39,15 +39,41 @@ Article numbers identify the product family, not verified electronics. Check the The board (`esp01_1m`), RX GPIO13, TX GPIO15 and 9600 baud are retained from the maintainer's source YAML. They are not a verified connector diagram or evidence that every production unit contains the same module. +## TYWE1S carrier-board connections and initial flashing + +Read the complete [connecting, backup and flashing instructions](TYWE1S_flashing.txt) before proceeding. The original notes and drawing were contributed by [Paul (@ph-wheels)](https://github.com/ph-wheels); spelling, sequencing and explanations were edited for this project. The original text did not include backup commands; the added esptool procedure is explicitly labelled as documentation guidance awaiting a hardware test record. + +![Paul-contributed TYWE1S carrier-board pinout, with a four-pin connector at left and programming pads at top](images/pinout.png) + +**The numbers refer to the carrier board shown above, not to a bare TYWE1S module.** Use the orientation in the drawing. Its printed dimensions are approximately 49.6 × 31 mm and identify the supplied drawing, not a guarantee of compatibility with every board revision. + +| Carrier-board pin | Supplied label | Use in the contributed instructions | +| --- | --- | --- | +| 1 | RX | Four-pin heater connector; leave disconnected during programming | +| 2 | TX | Four-pin heater connector; leave disconnected during programming | +| 3 | GND | External supply ground | +| 4 | 5V | Regulated 5 V DC input to this carrier board | +| 5 | 3.3V | Not used by this procedure; never apply 5 V here | +| 6 | GND | USB-to-UART adapter ground; temporary BOOT bridge ground | +| 7 | BOOT | Temporarily bridged to pin 6 when powering up for serial bootloader entry | +| 8 | TXD1 | Not used by this procedure | +| 9 | RXD0 | Connect adapter TX, with verified 3.3 V TTL signaling | +| 10 | TXD0 | Connect adapter RX, with verified 3.3 V TTL signaling | +| 11 | RST | Not used by this procedure | + +The carrier must be disconnected from the heater and all its wiring before connecting a computer or bench supply. The adapter's power output stays disconnected; the separate 5 V input is for carrier pin 4 only. Do not use RS-232 or 5 V UART signals. The supplied connector labels do not establish a traced GPIO13/GPIO15 mapping, measured voltage levels or mains isolation. + +**Back up before flashing:** the guide detects flash size, reads the full factory flash twice and compares the results. Matching reads check consistency, not recoverability; restoration has not been tested. Dumps may contain credentials, and they belong in private storage outside this repository. A Wi-Fi-module dump does not back up a separate heater MCU or establish how all timer settings are stored. + ## Setup in ESPHome Device Builder -1. Back up your current **local ESPHome YAML and secrets** before editing. This is separate from the factory flash-backup procedure, which is not documented yet. If the heater is still on stock firmware, stop here until a verified conversion guide is available. +1. Back up your current **local ESPHome YAML and secrets** before editing. For a matching TYWE1S carrier still running stock firmware, first read the [connection and flashing guide](TYWE1S_flashing.txt), verify the actual board and make a private factory flash backup before any installation. Other modules/revisions are not covered by that contribution. 2. Use ESPHome **2026.10.1** for the documented validation baseline. The encrypted OTA syntax requires ESPHome 2026.9.0 or later; older versions are not covered by this example. 3. Copy [eurom-400-wifi.yaml](eurom-400-wifi.yaml) to the Device Builder configuration directory, normally `/config/esphome/`. Keep an existing device's node name and encryption key when updating it. For an additional heater, choose a unique `esphome.name`, `friendly_name` and fallback AP SSID, and use a distinct device key and AP password. 4. Merge the entries from [secrets.example.yaml](secrets.example.yaml) into your local `secrets.yaml` in the same directory. Do not overwrite an existing secrets file or reuse the example credentials. 5. For a new device, generate a 32-byte base64 key with `openssl rand -base64 32`. Set a unique fallback AP password of 8-63 characters. For an existing device, retain its current API/OTA key: a new key in the uploader config alone will not rotate the installed key and can prevent updates. 6. Review the GPIO, board and datapoint assumptions against your already verified installation. Validate the configuration, then compile it in Device Builder. A passing validation is not a successful firmware build. Check flash/OTA size limits for the 1 MB target before installing. -7. Only update a known working ESPHome installation through its established update path. The example requires encrypted OTA. If the installed firmware does not yet offer it, follow the [official OTA migration procedure](https://esphome.io/components/ota/esphome/#enabling-encryption-on-an-existing-device), retaining the existing key/password as directed. No initial flashing procedure is provided here. +7. For an existing ESPHome installation, use its established update path. The example requires encrypted OTA. If the installed firmware does not yet offer it, follow the [official OTA migration procedure](https://esphome.io/components/ota/esphome/#enabling-encryption-on-an-existing-device), retaining the existing key/password as directed. For a first serial installation on the matching carrier, follow the [contributed flashing guide](TYWE1S_flashing.txt) instead. 8. In Home Assistant, use the discovered ESPHome integration, or add **ESPHome** under **Settings → Devices & services → Add integration** using the device hostname/IP and API key. Confirm the entities and state feedback before operating the heater. See the [official integration documentation](https://www.home-assistant.io/integrations/esphome/). 9. In a supervised session, select **Thermostat (P)** for temperature regulation, then exercise Heat/Off and temperature changes and compare the physical display and logs. Use [TESTING.md](TESTING.md) to record results. Set the Home Assistant area locally if wanted. @@ -75,6 +101,7 @@ Photographs supplied by the maintainer show the controls of the test unit; they ## Project notes +- [TYWE1S connecting, factory-backup and flashing instructions](TYWE1S_flashing.txt) and [carrier-board pinout](images/pinout.png) - [Datapoint evidence and unknowns](DATAPOINTS.md) - [Hardware test checklist and software validation record](TESTING.md) - [Backup, flashing, connector and compatibility TODO](TODO.md) @@ -85,5 +112,6 @@ Photographs supplied by the maintainer show the controls of the test unit; they - [Eurom product page](https://eurom.nl/product/permanente-verwarming/infrarood-verwarming/mon-soleil-dsp-400-wifi/) and [manufacturer manual/downloads page](https://eurom.nl/nl/manuals/). The supplied manual's English section, pages 48-63, was consulted for original operating behavior; no copy of the PDF is included in this repository. - [ESPHome Tuya MCU](https://esphome.io/components/tuya/), [Tuya climate](https://esphome.io/components/climate/tuya/) and [encrypted OTA](https://esphome.io/components/ota/esphome/). +- [Espressif esptool commands](https://docs.espressif.com/projects/esptool/en/latest/esp8266/esptool/basic-commands.html), [manual reset options](https://docs.espressif.com/projects/esptool/en/latest/esp8266/esptool/advanced-options.html) and [ESP8266 boot mode selection](https://docs.espressif.com/projects/esptool/en/latest/esp8266/advanced-topics/boot-mode-selection.html) support the documentation-added backup procedure. -Developed and maintained by [Graham van der Wielen](https://github.com/grayum). Created with assistance from ChatGPT & Codex (OpenAI). Independent community project; not affiliated with Eurom. See the repository [MIT License](../../LICENSE). +Developed by [Graham van der Wielen](https://github.com/grayum) and [Paul (@ph-wheels)](https://github.com/ph-wheels). Maintained by Graham van der Wielen. Paul contributed the original TYWE1S connection/flashing instructions and carrier-board pinout. Created with assistance from ChatGPT & Codex (OpenAI). Independent community project; not affiliated with Eurom. See the repository [MIT License](../../LICENSE). diff --git a/esphome/eurom-mon-soleil-dsp/TESTING.md b/esphome/eurom-mon-soleil-dsp/TESTING.md index c47f287..5e896c0 100644 --- a/esphome/eurom-mon-soleil-dsp/TESTING.md +++ b/esphome/eurom-mon-soleil-dsp/TESTING.md @@ -73,3 +73,9 @@ Remaining uncertainties: | GitHub Actions | Workflow supplied; not run on GitHub before publication | Time zone is normally inferred from the build environment when it is not set in YAML. Check the resulting local day/time on the heater; set `time.homeassistant.timezone` explicitly in your private configuration if needed. Time-source availability and timer behavior remain hardware test items. + +## TYWE1S documentation contribution - 2026-10-29 + +Paul (@ph-wheels) supplied connection/initial-flashing notes and a numbered carrier-board drawing through the maintainer. Editing corrects typos (including TYME1S → TYWE1S), clarifies 3.3 V UART logic versus the carrier's 5 V input, and adds a full-flash backup/readback comparison procedure based on Espressif's documentation. Backup commands were absent from the source contribution; they are not presented as a completed device test. + +The pin table was checked against the supplied drawing and the original connection notes. No voltage, isolation, connector-to-GPIO, flash-read, flash-write or restoration test was performed during this documentation edit. No heater-control YAML or validation-tooling behavior was changed. Record those hardware results before closing the remaining installation/recovery TODOs. diff --git a/esphome/eurom-mon-soleil-dsp/TODO.md b/esphome/eurom-mon-soleil-dsp/TODO.md index ab9c8aa..6952cd3 100644 --- a/esphome/eurom-mon-soleil-dsp/TODO.md +++ b/esphome/eurom-mon-soleil-dsp/TODO.md @@ -2,13 +2,15 @@ ## Installation and recovery documentation -- [ ] Confirm the maintainer's exact article number, Wi-Fi module, flash size and PCB revisions. -- [ ] Document a verified way to back up the original manufacturer flash/configuration before modification, including integrity checks and private storage. Distinguish a full flash image from readable settings; do not upload either. +- [x] Add Paul-contributed TYWE1S carrier-board connection/flashing notes and pinout, with edited spelling and clearer instructions. +- [x] Add a full-flash backup/readback comparison procedure based on Espressif's documentation, labelled as awaiting device testing. +- [ ] Confirm the maintainer's exact article number, module/PCB revisions and detected flash size against the contributed TYWE1S drawing and existing YAML profile. +- [ ] Run the backup procedure on the actual unit and record matching reads, detected capacity and tool version without publishing the dumps or credentials. Distinguish Wi-Fi-module flash from separate heater MCU settings. - [ ] Verify restoration/recovery using the owner's own backup and document the limitations. -- [ ] Document replacing stock firmware with ESPHome for a specifically identified module/revision, with safe isolation, power and programming requirements reviewed by a qualified person. -- [ ] Document the **internal four-pin connector**: clearly oriented photo, connector numbering, measured supply and logic levels, ground, signal directions, ESP pin mapping, revision and isolation evidence. Do not guess from wire color or the GPIO settings. +- [ ] Independently verify the contributed stock-to-ESPHome instructions on the identified board revision and record the result, including a qualified review of isolation, supply and logic levels. +- [ ] Supplement the supplied **four-pin connector** drawing (1=RX, 2=TX, 3=GND, 4=5V) with an oriented board photograph, measured supply/logic levels, confirmed signal directions, traced ESP GPIO mapping, PCB revision and isolation evidence. Do not infer these from the drawing or YAML alone. -These installation items are intentionally placeholders. Contributors may submit evidence-backed PRs. This starter does not provide a wiring diagram or initial flashing commands. +The [connection/flashing notes](TYWE1S_flashing.txt) and [pinout](images/pinout.png) now provide contributor-supplied starting information. The backup section was added during documentation review; neither it nor restoration has been independently hardware-tested. Remaining checkboxes concern verification and missing evidence, not a claim that the contribution has already been measured or certified. ## Behavior and compatibility diff --git a/esphome/eurom-mon-soleil-dsp/TYWE1S_flashing.txt b/esphome/eurom-mon-soleil-dsp/TYWE1S_flashing.txt new file mode 100644 index 0000000..52af459 --- /dev/null +++ b/esphome/eurom-mon-soleil-dsp/TYWE1S_flashing.txt @@ -0,0 +1,187 @@ +Eurom Mon Soleil DSP: connecting, backing up and flashing a TYWE1S carrier board + +Development, original connection/flashing notes and pinout contribution: +Paul (https://github.com/ph-wheels). +Editing and integration: Graham van der Wielen, with ChatGPT & Codex assistance. + +The pin numbers below refer to the CARRIER BOARD in images/pinout.png, not +the pins of a bare TYWE1S module. Use the drawing's orientation and numbering. +The contribution is board-specific; PCB revisions and other heater models have +not been independently checked. The backup commands in section 4 were added +during documentation review using Espressif's esptool documentation. They were +not present in the original notes and have not been tested on this heater. + +1. Before connecting anything + +This heater contains mains-powered electronics. Internal work must be carried +out by a competent, qualified person. Disconnect the heater from mains, make +it safe and remove/disconnect the Wi-Fi carrier board from the heater and ALL +of its wiring before attaching a computer, USB adapter or external supply. +Never power it from mains and a programmer/bench supply at the same time. + +Use a regulated, current-limited 5 V DC supply for the pictured carrier board +and a USB-to-UART adapter with verified 3.3 V TTL logic. Check both the board +revision/pinout and the adapter's actual I/O voltage before powering it: a +"3.3 V" selector may change only its power output, not the UART signal level. +Do not use RS-232 signaling or 5 V TTL: either can damage the ESP electronics. + +2. Wiring with power off + +USB-to-UART adapter connections: + Adapter TX -> carrier pin 9, RXD0 + Adapter RX -> carrier pin 10, TXD0 + Adapter GND -> carrier pin 6, GND + +Separate carrier-board power supply connections: + Regulated +5 V DC -> carrier pin 4, 5V + Supply GND -> carrier pin 3, GND + +The adapter and supply must share the board's ground reference. Verify the +ground connections on the actual board. Leave the adapter's VCC/5V/3V3 output +disconnected; power this board from the separate supply only. + +The supplied drawing also labels pin 5 as 3.3V. Do NOT apply 5 V to pin 5, +any UART/BOOT pin, or the bare ESP module. The 5 V instruction above applies +only to carrier pin 4 on the pictured board, not to a bare module. + +Leave the four-pin heater connector's pins 1 (RX) and 2 (TX) disconnected +during programming. They are not the serial flashing connection described +here. Pin 8 (TXD1) and pin 11 (RST) are not used by these steps. + +3. Enter the serial bootloader + +With the carrier supply switched off, temporarily bridge carrier pin 7 +(BOOT) to carrier pin 6 (GND), then switch on the external 5 V supply. The +supplied procedure uses this bridge to hold the ESP8266 boot input low at +startup. Remove the bridge once the tool has established a serial connection; +remove it before the next normal power-up. Do not short arbitrary pins. + +For EACH esptool operation below, manually repeat this power-off/bridge/ +power-on sequence. The three-wire UART connection has no automatic reset +wiring. Stop on unexpected current draw, heating or a failed connection; +the original notes' idle-current observation is not a safe supply-rating rule. + +4. Back up the original flash BEFORE installing ESPHome + +Skip this section only if a verified, privately stored factory backup already +exists. Once overwritten, stock firmware cannot be recovered from ESPHome. +A flash image may contain credentials and device-specific data; never commit, +upload or attach it to an issue. A Wi-Fi flash dump does not back up a separate +heater MCU or prove that all heater schedules/settings can be restored. + +On the computer with the USB adapter, use esptool 5.x. In a shell: + + python3 -m venv ~/.venvs/eurom-flash + . ~/.venvs/eurom-flash/bin/activate + python -m pip install 'esptool>=5,<6' + python -m serial.tools.list_ports + +Set EUROM_PORT to the ACTUAL serial port, for example: + + EUROM_PORT=/dev/ttyUSB0 + +On macOS it will normally look like /dev/cu.usbserial-...; on Windows use the +appropriate COM port (the shell examples above are for macOS/Linux). + +Enter the bootloader as in section 3, then detect the flash size: + + python -m esptool --chip esp8266 --port "$EUROM_PORT" --baud 115200 --before no-reset --after no-reset flash-id + +Record the detected size privately. Do not infer it from esp01_1m in the YAML. +Create a NEW private backup directory outside the repository: + + EUROM_BACKUP_DIR="$(mktemp -d "$HOME/eurom-factory-backup.XXXXXX")" + chmod 700 "$EUROM_BACKUP_DIR" + +Re-enter the bootloader before each read. Read the entire detected flash twice: + + python -m esptool --chip esp8266 --port "$EUROM_PORT" --baud 115200 --before no-reset --after no-reset read-flash 0 ALL "$EUROM_BACKUP_DIR/factory-read-1.bin" + + python -m esptool --chip esp8266 --port "$EUROM_PORT" --baud 115200 --before no-reset --after no-reset read-flash 0 ALL "$EUROM_BACKUP_DIR/factory-read-2.bin" + +Compare the files and record checksums: + + cmp "$EUROM_BACKUP_DIR/factory-read-1.bin" "$EUROM_BACKUP_DIR/factory-read-2.bin" + python -m esptool version + python -c 'import hashlib,pathlib,sys; [(print(p.name, p.stat().st_size, hashlib.sha256(p.read_bytes()).hexdigest())) for p in map(pathlib.Path, sys.argv[1:])]' "$EUROM_BACKUP_DIR/factory-read-1.bin" "$EUROM_BACKUP_DIR/factory-read-2.bin" + +Proceed only if both reads succeeded, cmp exits with status 0 and each file's +size matches flash-id's detected capacity. Two matching reads check readback +consistency; they do not prove restoration. Store a protected second copy +elsewhere and record model/article number, module/PCB revision if known, +detected flash size, tool version and date. Restoration testing remains TODO; +no erase or restore commands are supplied by this contribution. + +5. Prepare ESPHome Device Builder + +Only continue after verifying the factory backup. Open ESPHome Device Builder +in Home Assistant and create a new ESP8266 project (menu labels vary by +version). Give the device a unique name. Check the detected flash size against +the supplied configuration's esp01_1m (1 MB) profile before using that profile. +If it differs, stop and review the board configuration rather than guessing. + +Use the project's eurom-400-wifi.yaml and README setup instructions as the +basis for the new device, retaining its unique name, Wi-Fi settings and API +key. Merge the example secret entries into the existing PRIVATE secrets.yaml; +do not overwrite that file or publish its contents. Keep text_sensor: when +removing any unrelated helper entry. Validate and compile the final YAML. + +The original notes flashed a generic ESP8266 project first, then copied in the +heater configuration and updated over Wi-Fi. Preparing the complete final +configuration before the first serial flash avoids that extra migration and +retains the project's encrypted API/OTA setup from the start. + +6. Install using the attached USB-to-UART adapter + +Use a browser supported by ESPHome's serial installer (normally Chrome/Edge) +on the computer to which the adapter is attached. Open Device Builder through +a secure browser context, normally HTTPS; plain HTTP on a remote HA host may +not offer serial access. Close terminal/monitor programs using the same port. + +With the board still disconnected from the heater, enter the serial bootloader +as in section 3. In Device Builder select Install, then "Plug into this +computer" (wording may vary). Choose the adapter's serial port and connect. +Remove the BOOT-to-GND bridge after connection and allow installation to finish. +Browser serial flashing does not create a factory backup: section 4 comes first. + +Switch off the external supply. Confirm the BOOT bridge is removed, then power +the isolated board normally and check that it joins Wi-Fi and is reachable in +Device Builder/Home Assistant. With no heater MCU attached, Tuya datapoints +may be unavailable; that does not by itself indicate a failed flash. + +If a browser serial installer is unavailable, stop and consult ESPHome's +official installation documentation. Do not guess an image type, offset or +erase command. Do not operate on a port belonging to another device. + +7. Disconnect the programmer and reconnect the heater + +Turn off the bench supply and disconnect the USB adapter. Remove ALL temporary +programming/power wires and the boot bridge before reinstalling the board. +With the heater still disconnected from mains, have the qualified person +restore its original connector orientation and enclosure. The drawing labels +the four-pin connector as 1=RX, 2=TX, 3=GND, 4=5V; these are the supplied BOARD +labels, not an independently traced GPIO map or permission to swap the harness. + +Follow README.md and TESTING.md for supervised initial operation. P mode is +required for thermostat regulation. Subsequent updates can use "Wirelessly" / +"On the network" with the same installed API/OTA key; follow the official OTA +migration procedure if changing from an older unencrypted installation. + +8. References and evidence limits + +Pinout and connection/initial-install sequence: Paul (@ph-wheels), supplied +through the maintainer on 2026-10-29. This edited guide and drawing have not +been independently hardware-tested. Board orientation, exact revision, +connector-to-GPIO tracing, measured voltages/isolation and restoration testing +remain open evidence items in TODO.md. No heater-control YAML is changed. + +Espressif basic commands (flash-id and full read-flash): +https://docs.espressif.com/projects/esptool/en/latest/esp8266/esptool/basic-commands.html +Espressif manual reset options: +https://docs.espressif.com/projects/esptool/en/latest/esp8266/esptool/advanced-options.html +ESP8266 boot mode selection: +https://docs.espressif.com/projects/esptool/en/latest/esp8266/advanced-topics/boot-mode-selection.html +ESPHome getting started / installation: +https://esphome.io/install/getting-started/ +ESPHome encrypted OTA and migration: +https://esphome.io/components/ota/esphome/ diff --git a/esphome/eurom-mon-soleil-dsp/images/pinout.png b/esphome/eurom-mon-soleil-dsp/images/pinout.png new file mode 100644 index 0000000000000000000000000000000000000000..929961080dfc3a716dbb27b14d640b0013bbeb4e GIT binary patch literal 37303 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 R9QPX_{{uSB