/** * * @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 extern "C" uint32_t _SPIFFS_start; extern "C" uint32_t _SPIFFS_end; ESP8266HTTPUpdate::ESP8266HTTPUpdate(void) : _httpClientTimeout(8000), _ledPin(-1) { } ESP8266HTTPUpdate::ESP8266HTTPUpdate(int httpClientTimeout) : _httpClientTimeout(httpClientTimeout), _ledPin(-1) { } ESP8266HTTPUpdate::~ESP8266HTTPUpdate(void) { } #ifdef HTTPUPDATE_1_2_COMPATIBLE HTTPUpdateResult ESP8266HTTPUpdate::update(const String& url, const String& currentVersion, const String& httpsFingerprint, bool reboot) { rebootOnUpdate(reboot); #pragma GCC diagnostic push #pragma GCC diagnostic ignored "-Wdeprecated-declarations" return update(url, currentVersion, httpsFingerprint); #pragma GCC diagnostic pop } HTTPUpdateResult ESP8266HTTPUpdate::update(const String& url, const String& currentVersion) { HTTPClient http; #pragma GCC diagnostic push #pragma GCC diagnostic ignored "-Wdeprecated-declarations" http.begin(url); #pragma GCC diagnostic pop return handleUpdate(http, currentVersion, false); } HTTPUpdateResult ESP8266HTTPUpdate::update(const String& url, const String& currentVersion, const String& httpsFingerprint) { HTTPClient http; #pragma GCC diagnostic push #pragma GCC diagnostic ignored "-Wdeprecated-declarations" http.begin(url, httpsFingerprint); #pragma GCC diagnostic pop return handleUpdate(http, currentVersion, false); } HTTPUpdateResult ESP8266HTTPUpdate::update(const String& url, const String& currentVersion, const uint8_t httpsFingerprint[20]) { HTTPClient http; #pragma GCC diagnostic push #pragma GCC diagnostic ignored "-Wdeprecated-declarations" http.begin(url, httpsFingerprint); #pragma GCC diagnostic pop return handleUpdate(http, currentVersion, false); } #endif HTTPUpdateResult ESP8266HTTPUpdate::update(WiFiClient& client, const String& url, const String& currentVersion) { HTTPClient http; http.begin(client, url); return handleUpdate(http, currentVersion, false); } #ifdef HTTPUPDATE_1_2_COMPATIBLE HTTPUpdateResult ESP8266HTTPUpdate::updateSpiffs(const String& url, const String& currentVersion, const String& httpsFingerprint) { HTTPClient http; #pragma GCC diagnostic push #pragma GCC diagnostic ignored "-Wdeprecated-declarations" http.begin(url, httpsFingerprint); #pragma GCC diagnostic pop return handleUpdate(http, currentVersion, true); } HTTPUpdateResult ESP8266HTTPUpdate::updateSpiffs(const String& url, const String& currentVersion, const uint8_t httpsFingerprint[20]) { HTTPClient http; #pragma GCC diagnostic push #pragma GCC diagnostic ignored "-Wdeprecated-declarations" http.begin(url, httpsFingerprint); #pragma GCC diagnostic pop return handleUpdate(http, currentVersion, true); } HTTPUpdateResult ESP8266HTTPUpdate::updateSpiffs(const String& url, const String& currentVersion) { HTTPClient http; #pragma GCC diagnostic push #pragma GCC diagnostic ignored "-Wdeprecated-declarations" http.begin(url); #pragma GCC diagnostic pop return handleUpdate(http, currentVersion, true); } #endif HTTPUpdateResult ESP8266HTTPUpdate::updateSpiffs(WiFiClient& client, const String& url, const String& currentVersion) { HTTPClient http; http.begin(client, url); return handleUpdate(http, currentVersion, true); } #ifdef HTTPUPDATE_1_2_COMPATIBLE HTTPUpdateResult ESP8266HTTPUpdate::update(const String& host, uint16_t port, const String& uri, const String& currentVersion, bool https, const String& httpsFingerprint, bool reboot) { (void)https; rebootOnUpdate(reboot); if (httpsFingerprint.length() == 0) { #pragma GCC diagnostic push #pragma GCC diagnostic ignored "-Wdeprecated-declarations" return update(host, port, uri, currentVersion); } else { return update(host, port, uri, currentVersion, httpsFingerprint); #pragma GCC diagnostic pop } } HTTPUpdateResult ESP8266HTTPUpdate::update(const String& host, uint16_t port, const String& uri, const String& currentVersion) { HTTPClient http; #pragma GCC diagnostic push #pragma GCC diagnostic ignored "-Wdeprecated-declarations" http.begin(host, port, uri); #pragma GCC diagnostic pop return handleUpdate(http, currentVersion, false); } HTTPUpdateResult ESP8266HTTPUpdate::update(const String& host, uint16_t port, const String& url, const String& currentVersion, const String& httpsFingerprint) { HTTPClient http; #pragma GCC diagnostic push #pragma GCC diagnostic ignored "-Wdeprecated-declarations" http.begin(host, port, url, httpsFingerprint); #pragma GCC diagnostic pop return handleUpdate(http, currentVersion, false); } HTTPUpdateResult ESP8266HTTPUpdate::update(const String& host, uint16_t port, const String& url, const String& currentVersion, const uint8_t httpsFingerprint[20]) { HTTPClient http; #pragma GCC diagnostic push #pragma GCC diagnostic ignored "-Wdeprecated-declarations" http.begin(host, port, url, httpsFingerprint); #pragma GCC diagnostic pop return handleUpdate(http, currentVersion, false); } #endif 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); } /** * 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"); } 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.setUserAgent(F("ESP8266-http-Update")); 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); } 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()); _lastError = 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(http.hasHeader("x-MD5")) { DEBUG_HTTP_UPDATE("[httpUpdate] - MD5: %s\n", http.header("x-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()); 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) &_SPIFFS_end - (size_t) &_SPIFFS_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) { _lastError = HTTP_UE_TOO_LESS_SPACE; ret = HTTP_UPDATE_FAILED; } else { WiFiClient * tcp = http.getStreamPtr(); WiFiUDP::stopAll(); WiFiClient::stopAllExcept(tcp); delay(100); int command; if(spiffs) { command = U_SPIFFS; DEBUG_HTTP_UPDATE("[httpUpdate] runUpdate spiffs...\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"); _lastError = HTTP_UE_BIN_VERIFY_HEADER_FAILED; http.end(); return HTTP_UPDATE_FAILED; } // check for valid first magic byte if(buf[0] != 0xE9) { DEBUG_HTTP_UPDATE("[httpUpdate] Magic header does not start with 0xE9\n"); _lastError = HTTP_UE_BIN_VERIFY_HEADER_FAILED; http.end(); return HTTP_UPDATE_FAILED; } 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"); _lastError = HTTP_UE_BIN_FOR_WRONG_FLASH; http.end(); return HTTP_UPDATE_FAILED; } } if(runUpdate(*tcp, len, http.header("x-MD5"), command)) { ret = HTTP_UPDATE_OK; DEBUG_HTTP_UPDATE("[httpUpdate] Update ok\n"); http.end(); if(_rebootOnUpdate && !spiffs) { ESP.restart(); } } else { ret = HTTP_UPDATE_FAILED; DEBUG_HTTP_UPDATE("[httpUpdate] Update failed\n"); } } } else { _lastError = 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: _lastError = HTTP_UE_SERVER_FILE_NOT_FOUND; ret = HTTP_UPDATE_FAILED; break; case HTTP_CODE_FORBIDDEN: _lastError = HTTP_UE_SERVER_FORBIDDEN; ret = HTTP_UPDATE_FAILED; break; default: _lastError = 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, String md5, int command) { StreamString error; if(!Update.begin(size, command, _ledPin, _ledOn)) { _lastError = 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(md5.length()) { if(!Update.setMD5(md5.c_str())) { _lastError = HTTP_UE_SERVER_FAULTY_MD5; DEBUG_HTTP_UPDATE("[httpUpdate] Update.setMD5 failed! (%s)\n", md5.c_str()); return false; } } if(Update.writeStream(in) != size) { _lastError = 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(!Update.end()) { _lastError = 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; } #if !defined(NO_GLOBAL_INSTANCES) && !defined(NO_GLOBAL_HTTPUPDATE) ESP8266HTTPUpdate ESPhttpUpdate; #endif