/** * * @file ESP8266HTTPUpdate.cpp * @date 21.06.2015 * @author Markus Sattler * * Copyright (c) 2015 Markus Sattler. All rights reserved. * This file is part of the ESP8266 Http Updater. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 of the License, or (at your option) any later version. * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, write to the Free Software * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA * */ #include "ESP8266httpUpdate.h" #include #include ESP8266HTTPUpdate::ESP8266HTTPUpdate(void) : _httpClientTimeout(8000) { } ESP8266HTTPUpdate::ESP8266HTTPUpdate(int httpClientTimeout) : _httpClientTimeout(httpClientTimeout) { } ESP8266HTTPUpdate::~ESP8266HTTPUpdate(void) { } /** * set the Authorization for the http request * @param user const String& * @param password const String& */ void ESP8266HTTPUpdate::setAuthorization(const String &user, const String &password) { _user = user; _password = password; } /** * set the Authorization for the http request * @param auth const String& base64 */ void ESP8266HTTPUpdate::setAuthorization(const String &auth) { _auth = auth; } HTTPUpdateResult ESP8266HTTPUpdate::update(WiFiClient& client, const String& url, const String& currentVersion) { HTTPClient http; http.begin(client, url); return handleUpdate(http, currentVersion, false); } HTTPUpdateResult ESP8266HTTPUpdate::updateFS(WiFiClient& client, const String& url, const String& currentVersion) { HTTPClient http; http.begin(client, url); return handleUpdate(http, currentVersion, true); } HTTPUpdateResult ESP8266HTTPUpdate::update(WiFiClient& client, const String& host, uint16_t port, const String& uri, const String& currentVersion) { HTTPClient http; http.begin(client, host, port, uri); return handleUpdate(http, currentVersion, false); } HTTPUpdateResult ESP8266HTTPUpdate::update(HTTPClient& httpClient, const String& currentVersion) { return handleUpdate(httpClient, currentVersion, false); } HTTPUpdateResult ESP8266HTTPUpdate::updateFS(HTTPClient& httpClient, const String& currentVersion) { return handleUpdate(httpClient, currentVersion, true); } /** * return error code as int * @return int error code */ int ESP8266HTTPUpdate::getLastError(void) { return _lastError; } /** * return error code as String * @return String error */ String ESP8266HTTPUpdate::getLastErrorString(void) { if(_lastError == 0) { return String(); // no error } // error from Update class if(_lastError > 0) { StreamString error; Update.printError(error); error.trim(); // remove line ending return String(F("Update error: ")) + error; } // error from http client if(_lastError > -100) { return String(F("HTTP error: ")) + HTTPClient::errorToString(_lastError); } switch(_lastError) { case HTTP_UE_TOO_LESS_SPACE: return F("Not Enough space"); case HTTP_UE_SERVER_NOT_REPORT_SIZE: return F("Server Did Not Report Size"); case HTTP_UE_SERVER_FILE_NOT_FOUND: return F("File Not Found (404)"); case HTTP_UE_SERVER_FORBIDDEN: return F("Forbidden (403)"); case HTTP_UE_SERVER_WRONG_HTTP_CODE: return F("Wrong HTTP Code"); case HTTP_UE_SERVER_FAULTY_MD5: return F("Wrong MD5"); case HTTP_UE_BIN_VERIFY_HEADER_FAILED: return F("Verify Bin Header Failed"); case HTTP_UE_BIN_FOR_WRONG_FLASH: return F("New Binary Does Not Fit Flash Size"); case HTTP_UE_SERVER_UNAUTHORIZED: return F("Unauthorized (401)"); } return String(); } /** * * @param http HTTPClient * * @param currentVersion const char * * @return HTTPUpdateResult */ HTTPUpdateResult ESP8266HTTPUpdate::handleUpdate(HTTPClient& http, const String& currentVersion, bool spiffs) { HTTPUpdateResult ret = HTTP_UPDATE_FAILED; // use HTTP/1.0 for update since the update handler not support any transfer Encoding http.useHTTP10(true); http.setTimeout(_httpClientTimeout); http.setFollowRedirects(_followRedirects); http.setUserAgent(F("ESP8266-http-Update")); http.addHeader(F("x-ESP8266-Chip-ID"), String(ESP.getChipId())); http.addHeader(F("x-ESP8266-STA-MAC"), WiFi.macAddress()); http.addHeader(F("x-ESP8266-AP-MAC"), WiFi.softAPmacAddress()); http.addHeader(F("x-ESP8266-free-space"), String(ESP.getFreeSketchSpace())); http.addHeader(F("x-ESP8266-sketch-size"), String(ESP.getSketchSize())); http.addHeader(F("x-ESP8266-sketch-md5"), String(ESP.getSketchMD5())); http.addHeader(F("x-ESP8266-chip-size"), String(ESP.getFlashChipRealSize())); http.addHeader(F("x-ESP8266-sdk-version"), ESP.getSdkVersion()); if(spiffs) { http.addHeader(F("x-ESP8266-mode"), F("spiffs")); } else { http.addHeader(F("x-ESP8266-mode"), F("sketch")); } if(currentVersion && currentVersion[0] != 0x00) { http.addHeader(F("x-ESP8266-version"), currentVersion); } if (!_user.isEmpty() && !_password.isEmpty()) { http.setAuthorization(_user.c_str(), _password.c_str()); } if (!_auth.isEmpty()) { http.setAuthorization(_auth.c_str()); } const char * headerkeys[] = { "x-MD5" }; size_t headerkeyssize = sizeof(headerkeys) / sizeof(char*); // track these headers http.collectHeaders(headerkeys, headerkeyssize); int code = http.GET(); int len = http.getSize(); if(code <= 0) { DEBUG_HTTP_UPDATE("[httpUpdate] HTTP error: %s\n", http.errorToString(code).c_str()); _setLastError(code); http.end(); return HTTP_UPDATE_FAILED; } DEBUG_HTTP_UPDATE("[httpUpdate] Header read fin.\n"); DEBUG_HTTP_UPDATE("[httpUpdate] Server header:\n"); DEBUG_HTTP_UPDATE("[httpUpdate] - code: %d\n", code); DEBUG_HTTP_UPDATE("[httpUpdate] - len: %d\n", len); if(code != HTTP_CODE_OK) { DEBUG_HTTP_UPDATE("[httpUpdate] - payload: %s\n", http.getString().c_str()); } String md5; if (_md5Sum.length()) { md5 = _md5Sum; } else if(http.hasHeader("x-MD5")) { md5 = http.header("x-MD5"); } if(md5.length()) { DEBUG_HTTP_UPDATE("[httpUpdate] - MD5: %s\n", md5.c_str()); } DEBUG_HTTP_UPDATE("[httpUpdate] ESP8266 info:\n"); DEBUG_HTTP_UPDATE("[httpUpdate] - free Space: %d\n", ESP.getFreeSketchSpace()); DEBUG_HTTP_UPDATE("[httpUpdate] - current Sketch Size: %d\n", ESP.getSketchSize()); DEBUG_HTTP_UPDATE("[httpUpdate] - current Sketch MD5: %s\n", ESP.getSketchMD5().c_str()); if(currentVersion && currentVersion[0] != 0x00) { DEBUG_HTTP_UPDATE("[httpUpdate] - current version: %s\n", currentVersion.c_str() ); } switch(code) { case HTTP_CODE_OK: ///< OK (Start Update) if(len > 0) { bool startUpdate = true; if(spiffs) { size_t spiffsSize = ((size_t)FS_end - (size_t)FS_start); if(len > (int) spiffsSize) { DEBUG_HTTP_UPDATE("[httpUpdate] spiffsSize to low (%d) needed: %d\n", spiffsSize, len); startUpdate = false; } } else { if(len > (int) ESP.getFreeSketchSpace()) { DEBUG_HTTP_UPDATE("[httpUpdate] FreeSketchSpace to low (%d) needed: %d\n", ESP.getFreeSketchSpace(), len); startUpdate = false; } } if (!startUpdate) { _setLastError(HTTP_UE_TOO_LESS_SPACE); ret = HTTP_UPDATE_FAILED; } else { // Warn main app we're starting up... if (_cbStart) { _cbStart(); } WiFiClient * tcp = http.getStreamPtr(); if (!tcp) { DEBUG_HTTP_UPDATE("[httpUpdate] WiFiClient connection unexpectedly absent\n"); _setLastError(HTTPC_ERROR_CONNECTION_LOST); http.end(); return HTTP_UPDATE_FAILED; } if (_closeConnectionsOnUpdate) { WiFiUDP::stopAll(); WiFiClient::stopAllExcept(tcp); } delay(100); int command; if(spiffs) { command = U_FS; DEBUG_HTTP_UPDATE("[httpUpdate] runUpdate filesystem...\n"); } else { command = U_FLASH; DEBUG_HTTP_UPDATE("[httpUpdate] runUpdate flash...\n"); } if(!spiffs) { uint8_t buf[4]; if(tcp->peekBytes(&buf[0], 4) != 4) { DEBUG_HTTP_UPDATE("[httpUpdate] peekBytes magic header failed\n"); _setLastError(HTTP_UE_BIN_VERIFY_HEADER_FAILED); http.end(); return HTTP_UPDATE_FAILED; } // check for valid first magic byte if(buf[0] != 0xE9 && buf[0] != 0x1f) { DEBUG_HTTP_UPDATE("[httpUpdate] Magic header does not start with 0xE9\n"); _setLastError(HTTP_UE_BIN_VERIFY_HEADER_FAILED); http.end(); return HTTP_UPDATE_FAILED; } // it makes no sense to check flash size in auto flash mode // (sketch size would have to be set in bin header, instead of flash size) #if !FLASH_MAP_SUPPORT if (buf[0] == 0xe9) { uint32_t bin_flash_size = ESP.magicFlashChipSize((buf[3] & 0xf0) >> 4); // check if new bin fits to SPI flash if(bin_flash_size > ESP.getFlashChipRealSize()) { DEBUG_HTTP_UPDATE("[httpUpdate] New binary does not fit SPI Flash size\n"); _setLastError(HTTP_UE_BIN_FOR_WRONG_FLASH); http.end(); return HTTP_UPDATE_FAILED; } } #endif } if(runUpdate(*tcp, len, md5, command)) { ret = HTTP_UPDATE_OK; DEBUG_HTTP_UPDATE("[httpUpdate] Update ok\n"); http.end(); // Warn main app we're all done if (_cbEnd) { _cbEnd(); } #ifdef ATOMIC_FS_UPDATE if(_rebootOnUpdate) { #else if(_rebootOnUpdate && !spiffs) { #endif ESP.restart(); } } else { ret = HTTP_UPDATE_FAILED; DEBUG_HTTP_UPDATE("[httpUpdate] Update failed\n"); } } } else { _setLastError(HTTP_UE_SERVER_NOT_REPORT_SIZE); ret = HTTP_UPDATE_FAILED; DEBUG_HTTP_UPDATE("[httpUpdate] Content-Length was 0 or wasn't set by Server?!\n"); } break; case HTTP_CODE_NOT_MODIFIED: ///< Not Modified (No updates) ret = HTTP_UPDATE_NO_UPDATES; break; case HTTP_CODE_NOT_FOUND: _setLastError(HTTP_UE_SERVER_FILE_NOT_FOUND); ret = HTTP_UPDATE_FAILED; break; case HTTP_CODE_FORBIDDEN: _setLastError(HTTP_UE_SERVER_FORBIDDEN); ret = HTTP_UPDATE_FAILED; break; case HTTP_CODE_UNAUTHORIZED: _setLastError(HTTP_UE_SERVER_UNAUTHORIZED); ret = HTTP_UPDATE_FAILED; break; default: _setLastError(HTTP_UE_SERVER_WRONG_HTTP_CODE); ret = HTTP_UPDATE_FAILED; DEBUG_HTTP_UPDATE("[httpUpdate] HTTP Code is (%d)\n", code); //http.writeToStream(&Serial1); break; } http.end(); return ret; } /** * write Update to flash * @param in Stream& * @param size uint32_t * @param md5 String * @return true if Update ok */ bool ESP8266HTTPUpdate::runUpdate(Stream& in, uint32_t size, const String& md5, int command) { StreamString error; if (_cbProgress) { Update.onProgress(_cbProgress); } if(!Update.begin(size, command, _ledPin, _ledOn)) { _setLastError(Update.getError()); Update.printError(error); error.trim(); // remove line ending DEBUG_HTTP_UPDATE("[httpUpdate] Update.begin failed! (%s)\n", error.c_str()); return false; } if (_cbProgress) { _cbProgress(0, size); } if(md5.length()) { if(!Update.setMD5(md5.c_str())) { _setLastError(HTTP_UE_SERVER_FAULTY_MD5); DEBUG_HTTP_UPDATE("[httpUpdate] Update.setMD5 failed! (%s)\n", md5.c_str()); return false; } } if(Update.writeStream(in) != size) { _setLastError(Update.getError()); Update.printError(error); error.trim(); // remove line ending DEBUG_HTTP_UPDATE("[httpUpdate] Update.writeStream failed! (%s)\n", error.c_str()); return false; } if (_cbProgress) { _cbProgress(size, size); } if(!Update.end()) { _setLastError(Update.getError()); Update.printError(error); error.trim(); // remove line ending DEBUG_HTTP_UPDATE("[httpUpdate] Update.end failed! (%s)\n", error.c_str()); return false; } return true; } /** * @brief Get avialable firmware version from update server * @author Holger Mueller * @date 2023-08-03 * * @param client WiFiClient to use (see HTTPClient::begin) * @param host Update host name or IP (see HTTPClient::begin) * @param port Port on host (see HTTPClient::begin) * @param uri Update URI on server (see HTTPClient::begin) * @param current_version Current firmware version * @param available_version Firmware version available on update server * @return ESP8266HTTPUpdate::HTTPUpdateResult, HTTP_UPDATE_OK in case of success */ HTTPUpdateResult ESP8266HTTPUpdate::getAvailableVersion(WiFiClient& client, const String& host, uint16_t port, const String& uri, const String& current_version, String& available_version) { HTTPUpdateResult ret = HTTP_UPDATE_FAILED; HTTPClient http; http.begin(client, host, port, uri); // use HTTP/1.0 for update since the update handler not support any transfer Encoding http.useHTTP10(true); http.setTimeout(_httpClientTimeout); http.setFollowRedirects(_followRedirects); http.setUserAgent(F("ESP8266-http-Update")); http.addHeader(F("x-ESP8266-Chip-ID"), String(ESP.getChipId())); http.addHeader(F("x-ESP8266-STA-MAC"), WiFi.macAddress()); http.addHeader(F("x-ESP8266-AP-MAC"), WiFi.softAPmacAddress()); http.addHeader(F("x-ESP8266-free-space"), String(ESP.getFreeSketchSpace())); http.addHeader(F("x-ESP8266-sketch-size"), String(ESP.getSketchSize())); http.addHeader(F("x-ESP8266-sketch-md5"), String(ESP.getSketchMD5())); http.addHeader(F("x-ESP8266-chip-size"), String(ESP.getFlashChipRealSize())); http.addHeader(F("x-ESP8266-sdk-version"), ESP.getSdkVersion()); http.addHeader(F("x-ESP8266-mode"), F("version")); if (current_version && current_version[0] != 0x00) { http.addHeader(F("x-ESP8266-version"), current_version); } if (!_user.isEmpty() && !_password.isEmpty()) { http.setAuthorization(_user.c_str(), _password.c_str()); } if (!_auth.isEmpty()) { http.setAuthorization(_auth.c_str()); } const char* headerkeys[] = {"x-MD5", "x-version"}; size_t headerkeyssize = sizeof(headerkeys) / sizeof(char*); // track these headers http.collectHeaders(headerkeys, headerkeyssize); int code = http.GET(); if (code <= 0) { DEBUG_HTTP_UPDATE("[httpUpdate] HTTP error: %s\n", http.errorToString(code).c_str()); _setLastError(code); http.end(); return HTTP_UPDATE_FAILED; } DEBUG_HTTP_UPDATE("[httpUpdate] Header read fin.\n"); DEBUG_HTTP_UPDATE("[httpUpdate] Server header:\n"); DEBUG_HTTP_UPDATE("[httpUpdate] - code: %d\n", code); DEBUG_HTTP_UPDATE("[httpUpdate] - len: %d\n", http.getSize()); if (code != HTTP_CODE_OK) { DEBUG_HTTP_UPDATE("[httpUpdate] - payload: %s\n", http.getString().c_str()); } switch (code) { case HTTP_CODE_OK: ///< OK (check for version) if (http.hasHeader("x-version")) { available_version = http.header("x-version"); ret = HTTP_UPDATE_OK; DEBUG_HTTP_UPDATE("[httpUpdate] - current version: %s\n", current_version.c_str()); DEBUG_HTTP_UPDATE("[httpUpdate] - server version: %s\n", available_version.c_str()); } else { _setLastError(HTTP_UE_SERVER_NOT_REPORT_VERSION); ret = HTTP_UPDATE_FAILED; DEBUG_HTTP_UPDATE("[httpUpdate] Server did not respond with a firmware version\n"); } if (http.hasHeader("x-MD5")) { DEBUG_HTTP_UPDATE("[httpUpdate] - current Sketch MD5: %s\n", ESP.getSketchMD5().c_str()); DEBUG_HTTP_UPDATE("[httpUpdate] - server Sketch MD5: %s\n", http.header("x-MD5").c_str()); } break; case HTTP_CODE_NOT_FOUND: _setLastError(HTTP_UE_SERVER_FILE_NOT_FOUND); ret = HTTP_UPDATE_FAILED; break; case HTTP_CODE_FORBIDDEN: _setLastError(HTTP_UE_SERVER_FORBIDDEN); ret = HTTP_UPDATE_FAILED; break; case HTTP_CODE_UNAUTHORIZED: _setLastError(HTTP_UE_SERVER_UNAUTHORIZED); ret = HTTP_UPDATE_FAILED; break; default: _setLastError(HTTP_UE_SERVER_WRONG_HTTP_CODE); ret = HTTP_UPDATE_FAILED; DEBUG_HTTP_UPDATE("[httpUpdate] HTTP Code is (%d)\n", code); break; } http.end(); return ret; } #if !defined(NO_GLOBAL_INSTANCES) && !defined(NO_GLOBAL_HTTPUPDATE) ESP8266HTTPUpdate ESPhttpUpdate; #endif