Skip to content

Firmware Update~

When openHASP is already running on the device you can upgrade the firmware from the Web UI. For Over-The-Air updates you need to use the ota binary files.

Over-The-Air~

HTTP Upload~

Click 'Browse' to select the ota file from your computer and click 'Update Firmware'. The 'Target' should be 'Firmware'.

HTTP Update~

You can also enter the ota URL to download new firmware from a webserver on your network or from the internet. Both http and https links are supported but using https is recommended for additinal security.

Some content providers -like Github- redirect links to a server which is closest to you. For safety reasons openHASP will not follow these redirect headers by default. This behaviour can be changed by setting 'Follow Redirects' to either 'Strict' or 'Always':

  • Strict adheres to RFC2616 and only follows redirects using GET or HEAD methods
  • Always will follow all redirects regardless of a used method, which is less secure

Note

You can also trigger an upgrade using the update command from the Serial console, telnet or MQTT.

Arduino OTA~

When you are developing locally it can be useful to update a plate Over-The-Air using Arduino OTA. The Arduino OTA service is not enabled in the official releases.

For this option to work, the firmware has to be compiled with HASP_USE_ARDUINOOTA=1 enabled in include/user_config_override.h. Then update the platformio_override.ini with the IP address instead of a serial port:

[env:lanbon_l8]
; upload_port = COM3       ; Disable serial upload
; monitor_port = COM3      ; Disable serial upload
upload_protocol = espota   ; Use Arduino OTA to flash the firmware over-the-air
upload_port = 192.168.7.89 ; Specify the IP of the ESP
upload_flags =
    --auth=haspadmin       ; optional OTA password, none by default
    --port=3232            ; optional remote port on the ESP, 3232 by default
    --host_port=45678      ; optional local port for access through the firewall

Serial Update~

If you can not update the firmware Over-The-Air it is possible to re-flash a full binary file onto the ESP. This should retain the filesystem and user configuration as long as the partition scheme was not modified between versions! The procedure is the same as the initial installation.

Please make a full backup of the device first just to be safe!

Warning

Do not erase the flash first in this situation because that will destroy all files and settings!

Last update: 2023-12-09