Skip to content

Updating ESPSomfy RTS

rstrouse edited this page Oct 28, 2023 · 3 revisions

After the initial onboarding installation of the firmware and application software has been accomplished you can simply update your device to the latest version using the update function built into the software. There is no need to connect it up to a USB cable or even remove it from its current location. ESPSomfy RTS has a built in over-the-air (OTA) update process. To begin updating your device, navigate to the System section and select the Firmware tab.

Update Options

You have a couple of options when it comes to updating your ESPSomfy RTS device using the OTA (over-the-air) functions. First, as of v2.2.0 you can update directly from this github repository using the Github Update Method. That is if you have outbound internet access from your ESPSomfy RTS device. The second option is to locally upload each of the partitions separately using the local update method.

Github Update Method

Updating your device using the github update function could not make this task any easier. Once you begin the update simply let ESPSomfy RTS complete its download and update of the ESP32. Follow the directions below to perform a Github update.

Select a Version

You can select multiple versions from this repository to install. When a new version becomes available it will show at the top of the ESPSomfy RTS web interface. To select a version click the Github Update button. In the middle of the screen a dropdown will appear to allow you to select the version you would like to install. NOTE: The Github Update function is only available for devices with v2.2.0 and above installed. If you install an earlier version this option will become unavailable and you will need to use the local install

image

On mobile devices, this screen will appear with a manual backup button. This is due to the way downloaded files are handled on mobile devices. A backup of your current configuration should be performed at this time but on a mobile device you will need to press the backup button before you begin. On non-mobile devices this process is automatic and a backup file will be downloaded prior to starting the update.

image

After selecting a version you can click the release notes button to reveal the release notes for the version you have selected. When you are done reading these you can press the ok button to close the release notes.

image

Update the Device

After selecting the release you would like to install press the update button. This may take several minutes as ESPSomfy RTS contacts github to retrieve the firmware and application files. Please be patient. The current update progress will be displayed as the files are installed. Once the files have been installed ESPSomfy RTS will restart to load the version you just installed.

image

Local Update Method

The local update process requires you to first download the binary files for the current release, then upload each of these one at a time. Follow the process below to perform a local update.

Getting the Current files

You must first download the current files to a local computer from this repository home page. You will find the latest release in the releases section on the right hand side of the page. Simply click on the Latest bubble to open the release page.

image

For each release I will include what changes have been made as well as the binary files used to update your device. You will need to download the SomfyController.ino.esp32.bin and the SomfyController.littlefs.bin files by clicking on each of them. This will copy them to your downloads folder.

image

Performing the Update

Next, from the gears menu click on the Updates tab. You will need to first update the firmware then update the application. Unless otherwise specified always update in this order. If you update the application first, there may be additional commands required in the firmware that do not exist so the update may fail. Every attempt is made to make the firmware operate with earlier versions of the application software.

Click the Update Firmware button then select the SomfyController.ino.esp.bin file using the icon next to the file name field. Once selected press the Upload File button and the screen will change to indicate that it is uploading the new firmware to the device. Do not turn off your device or disconnect until the upload finishes completely and the ESPSomfy RTS reboots. The screen will become unavailable for a short period while the device reboots.

image

After you have updated your firmware you must next update the Application. To do this, close the firmware update screen and notice that the firmware version should have changed to the new firmware. If the firmware successfully updated, click on the Update Application button and select the SomfyController.littlefs.bin file using the icon next to the file name field. Once selected, press the upload file button. If you are already on v1.4 or greater of the software, a backup file will be placed in your downloads folder when the process begins.

image

After the application software completes successfully, the browser will reload and you are finished.