aaribaud/ESPSomfy-RTS
0
0
Fork 0
mirror of https://github.com/rstrouse/ESPSomfy-RTS.git synced 2025-12-15 03:52:11 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions

Updated Installing the Firmware (markdown)

rstrouse 2023-03-19 18:46:25 -07:00
parent ec1432e07e
commit 9d76bfa9a4
1 changed files with 17 additions and 7 deletions
Download patch file Download diff file Expand all files Collapse all files

24
Installing-the-Firmware.md

@ -1,14 +1,24 @@
There are two (actually 3 but the third method uses the command line) methods you can use to upload the initial firmware to your device. Both of them are a bit technical but not insurmountable. If you develop software on ESP devices then you probably already have the Arduino IDE v1.8 software installed on your computer. If you do not then choose the ESP32 flash download tool method as it is fairly straight forward. I didn't ask him to try, but I think that even the hairy dude from the Geico commercials can get this done.
There are three (actually 4 but the fourth method uses the command line) methods you can use to upload the initial firmware to your device. Two of them are a bit technical but not insurmountable. If you develop software on ESP devices then you probably already have the Arduino IDE v1.8 software installed on your computer. If you do not then choose either the ESP32 flash download tool method or the ESPHome web method as they are fairly straight forward. I didn't ask him to try, but I think that even the hairy cave dude from the Geico commercials can get this done.
# Using ESP32 Flash Download tool
The flash download tool is probably the most straight forward way to onboard your new ESPSomfy RTS device. Depending on the device you have chosen, you may need to set the device into download mode. For instance, the WT32-ETH01 requires a jumper between the IO0 and ground before uploading any firmware to it. So check your documentation and set the board appropriately.
For those of you using a regular ESP32S device then you do not need to set any jumpers. The chip select will be controlled by the software.
The initial firmware onboarding can be performed using a single file. These are `SomfyController.onboard.esp32.bin`. Download this file to your computer somewhere. The file is located on this repository under releases on the right side of the main page.
The initial firmware onboarding can be performed using a single file without having to recompile the software using the `SomfyController.onboard.esp32.bin` file for the release. Download this file to your computer somewhere. The file is located on this repository under releases on the right side of the main page. Please note that if you flash this file to your device it will erase your shade configuration so if this is not a new install perform the update procedure instead of this onboarding procedure.
![image](https://user-images.githubusercontent.com/47839015/221660466-ab827cf1-4bfe-4e4d-8b5a-5b1245544a53.png)
Next connect your ESPSomfy RTS device to your computer with a USB data cable. You must use a data cable and not a charge only cable. You will not be able to tell these apart and if you are having issues communicating with the device, it is likely that you have a charge only cable. Dig through that big box of cables that everyone has for another one and give it a try.
# Using ESPHome Web
The easiest way to onboard a new ESPSomfy RTS device is to use the https://web.esphome.io website. To get started, set up your device to begin receive firmware. If you are using an ESP32s device there is nothing to do here other than connecting a USB data cable between your computer and the ESPSomfy RTS device. For others you may need to enable the firmware flash mode by jumpering certain pins on the board. Check the documentation for your board to set it into firmware flash mode.
After you have dowloaded the `SomfyController.onboard.esp32.bin` file from the releases section of this repository, open the https://web.esphome.io website. Next click the connect button on the ESPHome web interface and a list of installed serial ports should appear in a dialog. Select the port that your ESPSomfy RTS device is connected to and press connect.
Ignore the Prepare for first use button and choose install. When the Install your existing ESPHome project dialog appears, click on the choose file button and select the `SomfyController.onboard.esp32.bin` file. Finally, click the `INSTALL` button and the firmware will load onto your device.
# Using ESP32 Flash Download tool
The flash download tool is a straight forward way to onboard your new ESPSomfy RTS device but requires downloading the flash download tool to your computer. Depending on the device you have chosen, you may need to set the device into download mode. For instance, the WT32-ETH01 requires a jumper between the IO0 and ground before uploading any firmware to it. So check your documentation and set the board appropriately.
For those of you using a regular ESP32S device then you do not need to set any jumpers. The chip select will be controlled by the software.
Download the ESP32 Flash Download tool from the Espressif website. https://www.espressif.com/en/support/download/other-tools
This tool only works in Windows but I suspect that if you are on a Linux environment you will be using the other method anyway. For you Mac users, I just dunno... yet. If you have some variant on how to get this done when a user has five thumbs on each hand let me know.