From bf2c3d04e28dbdb056ac8f4f16f6a6b9628d8559 Mon Sep 17 00:00:00 2001 From: Matt Jenkins Date: Tue, 12 May 2015 20:13:48 +0100 Subject: [PATCH 01/78] Added advanced web server demo --- .../AdvancedWebServer/AdvancedWebServer.ino | 147 ++++++++++++++++++ 1 file changed, 147 insertions(+) create mode 100644 libraries/ESP8266WebServer/examples/AdvancedWebServer/AdvancedWebServer.ino diff --git a/libraries/ESP8266WebServer/examples/AdvancedWebServer/AdvancedWebServer.ino b/libraries/ESP8266WebServer/examples/AdvancedWebServer/AdvancedWebServer.ino new file mode 100644 index 000000000..0ffdd7172 --- /dev/null +++ b/libraries/ESP8266WebServer/examples/AdvancedWebServer/AdvancedWebServer.ino @@ -0,0 +1,147 @@ +/* + * Copyright (c) 2015, Majenko Technologies + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * * Redistributions of source code must retain the above copyright notice, this + * list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright notice, this + * list of conditions and the following disclaimer in the documentation and/or + * other materials provided with the distribution. + * + * * Neither the name of Majenko Technologies nor the names of its + * contributors may be used to endorse or promote products derived from + * this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND + * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED + * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE + * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR + * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES + * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; + * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON + * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ + +#include +#include +#include +#include + +const char *ssid = "YourSSIDHere"; +const char *password = "YourPSKHere"; +MDNSResponder mdns; + +ESP8266WebServer server ( 80 ); + +const int led = 13; + +void handleRoot() { + digitalWrite ( led, 1 ); + char temp[400]; + int sec = millis() / 1000; + int min = sec / 60; + int hr = min / 60; + + snprintf ( temp, 400, + +"\ + \ + \ + ESP8266 Demo\ + \ + \ + \ +

Hello from ESP8266!

\ +

Uptime: %02d:%02d:%02d

\ + \ + \ +", + + hr, min % 60, sec % 60 + ); + server.send ( 200, "text/html", temp ); + digitalWrite ( led, 0 ); +} + +void handleNotFound() { + digitalWrite ( led, 1 ); + String message = "File Not Found\n\n"; + message += "URI: "; + message += server.uri(); + message += "\nMethod: "; + message += ( server.method() == HTTP_GET ) ? "GET" : "POST"; + message += "\nArguments: "; + message += server.args(); + message += "\n"; + + for ( uint8_t i = 0; i < server.args(); i++ ) { + message += " " + server.argName ( i ) + ": " + server.arg ( i ) + "\n"; + } + + server.send ( 404, "text/plain", message ); + digitalWrite ( led, 0 ); +} + +void setup ( void ) { + pinMode ( led, OUTPUT ); + digitalWrite ( led, 0 ); + Serial.begin ( 115200 ); + WiFi.begin ( ssid, password ); + Serial.println ( "" ); + + // Wait for connection + while ( WiFi.status() != WL_CONNECTED ) { + delay ( 500 ); + Serial.print ( "." ); + } + + Serial.println ( "" ); + Serial.print ( "Connected to " ); + Serial.println ( ssid ); + Serial.print ( "IP address: " ); + Serial.println ( WiFi.localIP() ); + + if ( mdns.begin ( "esp8266", WiFi.localIP() ) ) { + Serial.println ( "MDNS responder started" ); + } + + server.on ( "/", handleRoot ); + server.on ( "/test.svg", drawGraph ); + server.on ( "/inline", []() { + server.send ( 200, "text/plain", "this works as well" ); + } ); + server.onNotFound ( handleNotFound ); + server.begin(); + Serial.println ( "HTTP server started" ); +} + +void loop ( void ) { + mdns.update(); + server.handleClient(); +} + +void drawGraph() { + String out = ""; + char temp[100]; + out += "\n"; + out += "\n"; + out += "\n"; + int y = rand() % 130; + for (int x = 10; x < 390; x+= 10) { + int y2 = rand() % 130; + sprintf(temp, "\n", x, 140 - y, x + 10, 140 - y2); + out += temp; + y = y2; + } + out += "\n\n"; + + server.send ( 200, "image/svg+xml", out); +} From c0fdd09132e04d48f57180645cd374dcd159861d Mon Sep 17 00:00:00 2001 From: ficeto Date: Wed, 13 May 2015 01:09:39 +0300 Subject: [PATCH 02/78] make upload callback packets aligned to defined size having this a multiple of 512 bytes helps writing to SDcard 2048 looks reasonable and fast, but could be lowered if too much --- .../ESP8266WebServer/src/ESP8266WebServer.cpp | 65 +++++++------------ .../ESP8266WebServer/src/ESP8266WebServer.h | 5 +- 2 files changed, 26 insertions(+), 44 deletions(-) diff --git a/libraries/ESP8266WebServer/src/ESP8266WebServer.cpp b/libraries/ESP8266WebServer/src/ESP8266WebServer.cpp index cc4fffcce..656bb8769 100644 --- a/libraries/ESP8266WebServer/src/ESP8266WebServer.cpp +++ b/libraries/ESP8266WebServer/src/ESP8266WebServer.cpp @@ -327,6 +327,15 @@ void ESP8266WebServer::_parseArguments(String data) { } +void ESP8266WebServer::_uploadWriteByte(uint8_t b){ + if(_currentUpload.buflen == HTTP_UPLOAD_BUFLEN){ + if(_fileUploadHandler) _fileUploadHandler(); + _currentUpload.size += _currentUpload.buflen; + _currentUpload.buflen = 0; + } + _currentUpload.buf[_currentUpload.buflen++] = b; +} + void ESP8266WebServer::_parseForm(WiFiClient& client, String boundary, uint32_t len){ #ifdef DEBUG @@ -428,41 +437,25 @@ void ESP8266WebServer::_parseForm(WiFiClient& client, String boundary, uint32_t uint8_t argByte = client.read(); readfile: while(argByte != 0x0D){ - _currentUpload.buf[_currentUpload.buflen++] = argByte; - if(_currentUpload.buflen == 1460){ - #ifdef DEBUG - DEBUG_OUTPUT.println("Write File: 1460"); - #endif - if(_fileUploadHandler) _fileUploadHandler(); - _currentUpload.size += _currentUpload.buflen; - _currentUpload.buflen = 0; - } + _uploadWriteByte(argByte); argByte = client.read(); } argByte = client.read(); if(argByte == 0x0A){ -#ifdef DEBUG - DEBUG_OUTPUT.print("Write File: "); - DEBUG_OUTPUT.println(_currentUpload.buflen); -#endif - if(_fileUploadHandler) _fileUploadHandler(); - _currentUpload.size += _currentUpload.buflen; - _currentUpload.buflen = 0; - argByte = client.read(); if((char)argByte != '-'){ //continue reading the file - _currentUpload.buf[_currentUpload.buflen++] = 0x0D; - _currentUpload.buf[_currentUpload.buflen++] = 0x0A; + _uploadWriteByte(0x0D); + _uploadWriteByte(0x0A); goto readfile; } else { argByte = client.read(); if((char)argByte != '-'){ //continue reading the file - _currentUpload.buf[_currentUpload.buflen++] = 0x0D; - _currentUpload.buf[_currentUpload.buflen++] = 0x0A; - _currentUpload.buf[_currentUpload.buflen++] = (uint8_t)('-'); + _uploadWriteByte(0x0D); + _uploadWriteByte(0x0A); + _uploadWriteByte((uint8_t)('-')); goto readfile; } } @@ -471,7 +464,10 @@ readfile: client.readBytes(endBuf, boundary.length()); if(strstr((const char*)endBuf, (const char*)(boundary.c_str())) != NULL){ + if(_fileUploadHandler) _fileUploadHandler(); + _currentUpload.size += _currentUpload.buflen; _currentUpload.status = UPLOAD_FILE_END; + if(_fileUploadHandler) _fileUploadHandler(); #ifdef DEBUG DEBUG_OUTPUT.print("End File: "); DEBUG_OUTPUT.print(_currentUpload.filename); @@ -480,7 +476,6 @@ readfile: DEBUG_OUTPUT.print(" Size: "); DEBUG_OUTPUT.println(_currentUpload.size); #endif - if(_fileUploadHandler) _fileUploadHandler(); line = client.readStringUntil(0x0D); client.readStringUntil(0x0A); if(line == "--"){ @@ -491,33 +486,17 @@ readfile: } continue; } else { - _currentUpload.buf[_currentUpload.buflen++] = 0x0D; - _currentUpload.buf[_currentUpload.buflen++] = 0x0A; + _uploadWriteByte(0x0D); + _uploadWriteByte(0x0A); uint32_t i = 0; while(i < boundary.length()){ - _currentUpload.buf[_currentUpload.buflen++] = endBuf[i++]; - if(_currentUpload.buflen == 1460){ -#ifdef DEBUG - DEBUG_OUTPUT.println("Write File: 1460"); -#endif - if(_fileUploadHandler) _fileUploadHandler(); - _currentUpload.size += _currentUpload.buflen; - _currentUpload.buflen = 0; - } + _uploadWriteByte(endBuf[i++]); } argByte = client.read(); goto readfile; } } else { - _currentUpload.buf[_currentUpload.buflen++] = 0x0D; - if(_currentUpload.buflen == 1460){ - #ifdef DEBUG - DEBUG_OUTPUT.println("Write File: 1460"); - #endif - if(_fileUploadHandler) _fileUploadHandler(); - _currentUpload.size += _currentUpload.buflen; - _currentUpload.buflen = 0; - } + _uploadWriteByte(0x0D); goto readfile; } break; diff --git a/libraries/ESP8266WebServer/src/ESP8266WebServer.h b/libraries/ESP8266WebServer/src/ESP8266WebServer.h index 423fc6173..c0670159f 100644 --- a/libraries/ESP8266WebServer/src/ESP8266WebServer.h +++ b/libraries/ESP8266WebServer/src/ESP8266WebServer.h @@ -29,6 +29,8 @@ enum HTTPMethod { HTTP_ANY, HTTP_GET, HTTP_POST, HTTP_PUT, HTTP_PATCH, HTTP_DELETE }; enum HTTPUploadStatus { UPLOAD_FILE_START, UPLOAD_FILE_WRITE, UPLOAD_FILE_END }; +#define HTTP_UPLOAD_BUFLEN 2048 + typedef struct { HTTPUploadStatus status; String filename; @@ -36,7 +38,7 @@ typedef struct { String type; size_t size; size_t buflen; - uint8_t buf[1460]; + uint8_t buf[HTTP_UPLOAD_BUFLEN]; } HTTPUpload; class ESP8266WebServer @@ -78,6 +80,7 @@ protected: static const char* _responseCodeToString(int code); static void _appendHeader(String& response, const char* name, const char* value); void _parseForm(WiFiClient& client, String boundary, uint32_t len); + void _uploadWriteByte(uint8_t b); struct RequestHandler; struct RequestArgument { From f4969ce0e5eaaa823b0184b601d286a20eaf2f1a Mon Sep 17 00:00:00 2001 From: ficeto Date: Wed, 13 May 2015 12:07:42 +0300 Subject: [PATCH 03/78] Add WiFiClient.write for Stream reads directly from the stream and fragments the data to achieve maximum data throughput over WiFi --- libraries/ESP8266WiFi/src/WiFiClient.cpp | 28 ++++++++++++++++++++++++ libraries/ESP8266WiFi/src/WiFiClient.h | 1 + 2 files changed, 29 insertions(+) diff --git a/libraries/ESP8266WiFi/src/WiFiClient.cpp b/libraries/ESP8266WiFi/src/WiFiClient.cpp index 707e486cc..8f07b4d03 100644 --- a/libraries/ESP8266WiFi/src/WiFiClient.cpp +++ b/libraries/ESP8266WiFi/src/WiFiClient.cpp @@ -138,6 +138,34 @@ size_t ICACHE_FLASH_ATTR WiFiClient::write(const uint8_t *buf, size_t size) return _client->write(reinterpret_cast(buf), size); } +size_t ICACHE_FLASH_ATTR WiFiClient::write(Stream &src) +{ + uint8_t obuf[1460]; + size_t doneLen = 0; + size_t sentLen; + int i; + + while (src.available() > 1460) + { + for(i=0;i<1460;i++) obuf[i] = src.read(); + sentLen = write(obuf, 1460); + doneLen = doneLen + sentLen; + if(sentLen != 1460){ + DEBUGV("Sent: %u < 1460\r\n", sentLen); + return doneLen; + } + } + + uint16_t leftLen = src.available(); + for(i=0;i Date: Wed, 13 May 2015 12:09:34 +0300 Subject: [PATCH 04/78] Edit SD Server example to use the new Write(Stream) method --- .../examples/SDWebServer/SDWebServer.ino | 17 ++--------------- 1 file changed, 2 insertions(+), 15 deletions(-) diff --git a/libraries/ESP8266WebServer/examples/SDWebServer/SDWebServer.ino b/libraries/ESP8266WebServer/examples/SDWebServer/SDWebServer.ino index d9e230c77..dcb3a9d6e 100644 --- a/libraries/ESP8266WebServer/examples/SDWebServer/SDWebServer.ino +++ b/libraries/ESP8266WebServer/examples/SDWebServer/SDWebServer.ino @@ -111,23 +111,10 @@ bool loadFromSdCard(String path){ dataType = 0; path = 0; - uint8_t obuf[WWW_BUF_SIZE]; - - while (dataFile.available() > WWW_BUF_SIZE){ - dataFile.read(obuf, WWW_BUF_SIZE); - if(client.write(obuf, WWW_BUF_SIZE) != WWW_BUF_SIZE){ - DBG_OUTPUT_PORT.println("Sent less data than expected!"); - dataFile.close(); - return true; - } - } - uint16_t leftLen = dataFile.available(); - dataFile.read(obuf, leftLen); - if(client.write(obuf, leftLen) != leftLen){ + if(client.write(dataFile) != dataFile.size()){ DBG_OUTPUT_PORT.println("Sent less data than expected!"); - dataFile.close(); - return true; } + dataFile.close(); client.stop(); return true; From 2f45612bb8a1e88e39c8aca9d19b4ef338afe1db Mon Sep 17 00:00:00 2001 From: ficeto Date: Wed, 13 May 2015 12:15:52 +0300 Subject: [PATCH 05/78] Revert "Edit SD Server example to use the new Write(Stream) method" This reverts commit 4ae8a6d631d532409dde5ea35af03bccbb62974f. --- .../examples/SDWebServer/SDWebServer.ino | 19 ++++++++++++++++--- 1 file changed, 16 insertions(+), 3 deletions(-) diff --git a/libraries/ESP8266WebServer/examples/SDWebServer/SDWebServer.ino b/libraries/ESP8266WebServer/examples/SDWebServer/SDWebServer.ino index dcb3a9d6e..d9e230c77 100644 --- a/libraries/ESP8266WebServer/examples/SDWebServer/SDWebServer.ino +++ b/libraries/ESP8266WebServer/examples/SDWebServer/SDWebServer.ino @@ -111,10 +111,23 @@ bool loadFromSdCard(String path){ dataType = 0; path = 0; - if(client.write(dataFile) != dataFile.size()){ - DBG_OUTPUT_PORT.println("Sent less data than expected!"); - } + uint8_t obuf[WWW_BUF_SIZE]; + while (dataFile.available() > WWW_BUF_SIZE){ + dataFile.read(obuf, WWW_BUF_SIZE); + if(client.write(obuf, WWW_BUF_SIZE) != WWW_BUF_SIZE){ + DBG_OUTPUT_PORT.println("Sent less data than expected!"); + dataFile.close(); + return true; + } + } + uint16_t leftLen = dataFile.available(); + dataFile.read(obuf, leftLen); + if(client.write(obuf, leftLen) != leftLen){ + DBG_OUTPUT_PORT.println("Sent less data than expected!"); + dataFile.close(); + return true; + } dataFile.close(); client.stop(); return true; From 74a2b75cf9fe106d973daadb07337bfb0082a4c8 Mon Sep 17 00:00:00 2001 From: ficeto Date: Wed, 13 May 2015 12:45:48 +0300 Subject: [PATCH 06/78] Revert "Add WiFiClient.write for Stream" This reverts commit fa24d770c5096ad7a8894c3e5221c1358efe128c. --- libraries/ESP8266WiFi/src/WiFiClient.cpp | 28 ------------------------ libraries/ESP8266WiFi/src/WiFiClient.h | 1 - 2 files changed, 29 deletions(-) diff --git a/libraries/ESP8266WiFi/src/WiFiClient.cpp b/libraries/ESP8266WiFi/src/WiFiClient.cpp index 8f07b4d03..707e486cc 100644 --- a/libraries/ESP8266WiFi/src/WiFiClient.cpp +++ b/libraries/ESP8266WiFi/src/WiFiClient.cpp @@ -138,34 +138,6 @@ size_t ICACHE_FLASH_ATTR WiFiClient::write(const uint8_t *buf, size_t size) return _client->write(reinterpret_cast(buf), size); } -size_t ICACHE_FLASH_ATTR WiFiClient::write(Stream &src) -{ - uint8_t obuf[1460]; - size_t doneLen = 0; - size_t sentLen; - int i; - - while (src.available() > 1460) - { - for(i=0;i<1460;i++) obuf[i] = src.read(); - sentLen = write(obuf, 1460); - doneLen = doneLen + sentLen; - if(sentLen != 1460){ - DEBUGV("Sent: %u < 1460\r\n", sentLen); - return doneLen; - } - } - - uint16_t leftLen = src.available(); - for(i=0;i Date: Wed, 13 May 2015 12:47:29 +0300 Subject: [PATCH 07/78] add template client write can read streams that have "available()" and "read(buf, len)" methods thanks @igrr --- libraries/ESP8266WiFi/src/WiFiClient.h | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/libraries/ESP8266WiFi/src/WiFiClient.h b/libraries/ESP8266WiFi/src/WiFiClient.h index 251f2b3e3..ca6d26637 100644 --- a/libraries/ESP8266WiFi/src/WiFiClient.h +++ b/libraries/ESP8266WiFi/src/WiFiClient.h @@ -56,6 +56,28 @@ public: IPAddress remoteIP(); uint16_t remotePort(); + template size_t write(T &src){ + uint8_t obuf[1460]; + size_t doneLen = 0; + size_t sentLen; + int i; + + while (src.available() > 1460){ + src.read(obuf, 1460); + sentLen = write(obuf, 1460); + doneLen = doneLen + sentLen; + if(sentLen != 1460){ + return doneLen; + } + } + + uint16_t leftLen = src.available(); + src.read(obuf, leftLen); + sentLen = write(obuf, leftLen); + doneLen = doneLen + sentLen; + return doneLen; + } + friend class WiFiServer; using Print::write; From 8d1c59842e37f39317d40e926293b7fa189d9def Mon Sep 17 00:00:00 2001 From: ficeto Date: Wed, 13 May 2015 12:48:14 +0300 Subject: [PATCH 08/78] Revert "Revert "Edit SD Server example to use the new Write(Stream) method"" This reverts commit 163a98375637ab8e3e177bb7853303e397e39dc0. --- .../examples/SDWebServer/SDWebServer.ino | 17 ++--------------- 1 file changed, 2 insertions(+), 15 deletions(-) diff --git a/libraries/ESP8266WebServer/examples/SDWebServer/SDWebServer.ino b/libraries/ESP8266WebServer/examples/SDWebServer/SDWebServer.ino index d9e230c77..dcb3a9d6e 100644 --- a/libraries/ESP8266WebServer/examples/SDWebServer/SDWebServer.ino +++ b/libraries/ESP8266WebServer/examples/SDWebServer/SDWebServer.ino @@ -111,23 +111,10 @@ bool loadFromSdCard(String path){ dataType = 0; path = 0; - uint8_t obuf[WWW_BUF_SIZE]; - - while (dataFile.available() > WWW_BUF_SIZE){ - dataFile.read(obuf, WWW_BUF_SIZE); - if(client.write(obuf, WWW_BUF_SIZE) != WWW_BUF_SIZE){ - DBG_OUTPUT_PORT.println("Sent less data than expected!"); - dataFile.close(); - return true; - } - } - uint16_t leftLen = dataFile.available(); - dataFile.read(obuf, leftLen); - if(client.write(obuf, leftLen) != leftLen){ + if(client.write(dataFile) != dataFile.size()){ DBG_OUTPUT_PORT.println("Sent less data than expected!"); - dataFile.close(); - return true; } + dataFile.close(); client.stop(); return true; From 3ff7641329b2b591907e559b0c2337c345b23a50 Mon Sep 17 00:00:00 2001 From: ficeto Date: Wed, 13 May 2015 19:50:31 +0300 Subject: [PATCH 09/78] Add SPIFFS Support --- cores/esp8266/Arduino.h | 2 + cores/esp8266/FileSystem.cpp | 178 +++ cores/esp8266/FileSystem.h | 59 + cores/esp8266/core_esp8266_wiring.c | 1 + cores/esp8266/spiffs/LICENSE | 20 + cores/esp8266/spiffs/Makefile | 44 + cores/esp8266/spiffs/docs/IMPLEMENTING | 0 cores/esp8266/spiffs/docs/INTEGRATION | 306 ++++ cores/esp8266/spiffs/docs/TECH_SPEC | 239 ++++ cores/esp8266/spiffs/docs/TODO | 1 + cores/esp8266/spiffs/flashmem.h | 73 + cores/esp8266/spiffs/spiffs.c | 179 +++ cores/esp8266/spiffs/spiffs.h | 470 +++++++ cores/esp8266/spiffs/spiffs_cache.c | 303 ++++ cores/esp8266/spiffs/spiffs_check.c | 973 +++++++++++++ cores/esp8266/spiffs/spiffs_config.h | 242 ++++ cores/esp8266/spiffs/spiffs_flashmem.c | 236 ++++ cores/esp8266/spiffs/spiffs_gc.c | 556 ++++++++ cores/esp8266/spiffs/spiffs_hydrogen.c | 871 ++++++++++++ cores/esp8266/spiffs/spiffs_nucleus.c | 1794 ++++++++++++++++++++++++ cores/esp8266/spiffs/spiffs_nucleus.h | 687 +++++++++ 21 files changed, 7234 insertions(+) create mode 100755 cores/esp8266/FileSystem.cpp create mode 100755 cores/esp8266/FileSystem.h create mode 100755 cores/esp8266/spiffs/LICENSE create mode 100755 cores/esp8266/spiffs/Makefile create mode 100755 cores/esp8266/spiffs/docs/IMPLEMENTING create mode 100755 cores/esp8266/spiffs/docs/INTEGRATION create mode 100755 cores/esp8266/spiffs/docs/TECH_SPEC create mode 100755 cores/esp8266/spiffs/docs/TODO create mode 100755 cores/esp8266/spiffs/flashmem.h create mode 100755 cores/esp8266/spiffs/spiffs.c create mode 100755 cores/esp8266/spiffs/spiffs.h create mode 100755 cores/esp8266/spiffs/spiffs_cache.c create mode 100755 cores/esp8266/spiffs/spiffs_check.c create mode 100755 cores/esp8266/spiffs/spiffs_config.h create mode 100755 cores/esp8266/spiffs/spiffs_flashmem.c create mode 100755 cores/esp8266/spiffs/spiffs_gc.c create mode 100755 cores/esp8266/spiffs/spiffs_hydrogen.c create mode 100755 cores/esp8266/spiffs/spiffs_nucleus.c create mode 100755 cores/esp8266/spiffs/spiffs_nucleus.h diff --git a/cores/esp8266/Arduino.h b/cores/esp8266/Arduino.h index 6db13a088..82cc42550 100644 --- a/cores/esp8266/Arduino.h +++ b/cores/esp8266/Arduino.h @@ -38,6 +38,7 @@ extern "C" { #include "pgmspace.h" #include "esp8266_peri.h" #include "twi.h" +#include "spiffs/spiffs.h" void yield(void); @@ -211,6 +212,7 @@ void loop(void); #include "WString.h" #include "HardwareSerial.h" +#include "FileSystem.h" #include "Esp.h" uint16_t makeWord(uint16_t w); diff --git a/cores/esp8266/FileSystem.cpp b/cores/esp8266/FileSystem.cpp new file mode 100755 index 000000000..e33dae38b --- /dev/null +++ b/cores/esp8266/FileSystem.cpp @@ -0,0 +1,178 @@ +/**** + * Sming Framework Project - Open Source framework for high efficiency native ESP8266 development. + * Created 2015 by Skurydin Alexey + * http://github.com/anakod/Sming + * All files of the Sming Core are provided under the LGPL v3 license. + ****/ + +#include "FileSystem.h" +#include "WString.h" + +file_t fileOpen(const String name, FileOpenFlags flags) +{ + int repeats = 0; + bool notExist; + bool canRecreate = (flags & eFO_CreateIfNotExist) == eFO_CreateIfNotExist; + int res; + + do + { + notExist = false; + res = SPIFFS_open(&_filesystemStorageHandle, name.c_str(), (spiffs_flags)flags, 0); + int code = SPIFFS_errno(&_filesystemStorageHandle); + if (res < 0) + { + debugf("open errno %d\n", code); + notExist = (code == SPIFFS_ERR_NOT_FOUND || code == SPIFFS_ERR_DELETED || code == SPIFFS_ERR_FILE_DELETED || code == SPIFFS_ERR_IS_FREE); + //debugf("recreate? %d %d %d", notExist, canRecreate, (repeats < 3)); + if (notExist && canRecreate) + fileDelete(name); // fix for deleted files + } + } while (notExist && canRecreate && repeats++ < 3); + + return res; +} + +void fileClose(file_t file) +{ + SPIFFS_close(&_filesystemStorageHandle, file); +} + +size_t fileWrite(file_t file, const void* data, size_t size) +{ + int res = SPIFFS_write(&_filesystemStorageHandle, file, (void *)data, size); + if (res < 0) + { + debugf("write errno %d\n", SPIFFS_errno(&_filesystemStorageHandle)); + return res; + } + return res; +} + +size_t fileRead(file_t file, void* data, size_t size) +{ + int res = SPIFFS_read(&_filesystemStorageHandle, file, data, size); + if (res < 0) + { + debugf("read errno %d\n", SPIFFS_errno(&_filesystemStorageHandle)); + return res; + } + return res; +} + +int fileSeek(file_t file, int offset, SeekOriginFlags origin) +{ + return SPIFFS_lseek(&_filesystemStorageHandle, file, offset, origin); +} + +bool fileIsEOF(file_t file) +{ + return SPIFFS_eof(&_filesystemStorageHandle, file); +} + +int32_t fileTell(file_t file) +{ + return SPIFFS_tell(&_filesystemStorageHandle, file); +} + +int fileFlush(file_t file) +{ + return SPIFFS_fflush(&_filesystemStorageHandle, file); +} + +int fileStats(const String name, spiffs_stat *stat) +{ + return SPIFFS_stat(&_filesystemStorageHandle, name.c_str(), stat); +} + +int fileStats(file_t file, spiffs_stat *stat) +{ + return SPIFFS_fstat(&_filesystemStorageHandle, file, stat); +} + +void fileDelete(const String name) +{ + SPIFFS_remove(&_filesystemStorageHandle, name.c_str()); +} + +void fileDelete(file_t file) +{ + SPIFFS_fremove(&_filesystemStorageHandle, file); +} + +bool fileExist(const String name) +{ + spiffs_stat stat = {0}; + if (fileStats(name.c_str(), &stat) < 0) return false; + return stat.name[0] != '\0'; +} + + +int fileLastError(file_t fd) +{ + return SPIFFS_errno(&_filesystemStorageHandle); +} + +void fileClearLastError(file_t fd) +{ + _filesystemStorageHandle.errno = SPIFFS_OK; +} + +void fileSetContent(const String fileName, const char *content) +{ + file_t file = fileOpen(fileName.c_str(), eFO_CreateNewAlways | eFO_WriteOnly); + fileWrite(file, content, os_strlen(content)); + fileClose(file); +} + +uint32_t fileGetSize(const String fileName) +{ + file_t file = fileOpen(fileName.c_str(), eFO_ReadOnly); + // Get size + fileSeek(file, 0, eSO_FileEnd); + int size = fileTell(file); + fileClose(file); + return size; +} + +String fileGetContent(const String fileName) +{ + file_t file = fileOpen(fileName.c_str(), eFO_ReadOnly); + // Get size + fileSeek(file, 0, eSO_FileEnd); + int size = fileTell(file); + if (size <= 0) + { + fileClose(file); + return ""; + } + fileSeek(file, 0, eSO_FileStart); + char* buffer = new char[size + 1]; + buffer[size] = 0; + fileRead(file, buffer, size); + fileClose(file); + String res = buffer; + delete[] buffer; + return res; +} + +int fileGetContent(const String fileName, char* buffer, int bufSize) +{ + if (buffer == NULL || bufSize == 0) return 0; + *buffer = 0; + + file_t file = fileOpen(fileName.c_str(), eFO_ReadOnly); + // Get size + fileSeek(file, 0, eSO_FileEnd); + int size = fileTell(file); + if (size <= 0 || bufSize <= size) + { + fileClose(file); + return 0; + } + buffer[size] = 0; + fileSeek(file, 0, eSO_FileStart); + fileRead(file, buffer, size); + fileClose(file); + return size; +} diff --git a/cores/esp8266/FileSystem.h b/cores/esp8266/FileSystem.h new file mode 100755 index 000000000..c9ddb81cf --- /dev/null +++ b/cores/esp8266/FileSystem.h @@ -0,0 +1,59 @@ +/**** + * Sming Framework Project - Open Source framework for high efficiency native ESP8266 development. + * Created 2015 by Skurydin Alexey + * http://github.com/anakod/Sming + * All files of the Sming Core are provided under the LGPL v3 license. + ****/ + +#ifndef _SMING_CORE_FILESYSTEM_H_ +#define _SMING_CORE_FILESYSTEM_H_ + +#include "spiffs/spiffs.h" +class String; + +enum FileOpenFlags +{ + eFO_ReadOnly = SPIFFS_RDONLY, + eFO_WriteOnly = SPIFFS_WRONLY, + eFO_ReadWrite = eFO_ReadOnly | eFO_WriteOnly, + eFO_CreateIfNotExist = SPIFFS_CREAT, + eFO_Append = SPIFFS_APPEND, + eFO_Truncate = SPIFFS_TRUNC, + eFO_CreateNewAlways = eFO_CreateIfNotExist | eFO_Truncate +}; + +static FileOpenFlags operator|(FileOpenFlags lhs, FileOpenFlags rhs) +{ + return (FileOpenFlags) ((int)lhs| (int)rhs); +} + +typedef enum +{ + eSO_FileStart = SPIFFS_SEEK_SET, + eSO_CurrentPos = SPIFFS_SEEK_CUR, + eSO_FileEnd = SPIFFS_SEEK_END +} SeekOriginFlags; + +file_t fileOpen(const String name, FileOpenFlags flags); +void fileClose(file_t file); +size_t fileWrite(file_t file, const void* data, size_t size); +size_t fileRead(file_t file, void* data, size_t size); +int fileSeek(file_t file, int offset, SeekOriginFlags origin); +bool fileIsEOF(file_t file); +int32_t fileTell(file_t file); +int fileFlush(file_t file); +int fileLastError(file_t fd); +void fileClearLastError(file_t fd); +void fileSetContent(const String fileName, const char *content); +uint32_t fileGetSize(const String fileName); +String fileGetContent(const String fileName); +int fileGetContent(const String fileName, char* buffer, int bufSize); + + +int fileStats(const String name, spiffs_stat *stat); +int fileStats(file_t file, spiffs_stat *stat); +void fileDelete(const String name); +void fileDelete(file_t file); +bool fileExist(const String name); + +#endif /* _SMING_CORE_FILESYSTEM_H_ */ diff --git a/cores/esp8266/core_esp8266_wiring.c b/cores/esp8266/core_esp8266_wiring.c index 0170b4bcf..985db8310 100644 --- a/cores/esp8266/core_esp8266_wiring.c +++ b/cores/esp8266/core_esp8266_wiring.c @@ -76,6 +76,7 @@ void delayMicroseconds(unsigned int us) { void init() { initPins(); timer1_isr_init(); + spiffs_mount(); os_timer_setfn(µs_overflow_timer, (os_timer_func_t*) µs_overflow_tick, 0); os_timer_arm(µs_overflow_timer, 60000, REPEAT); } diff --git a/cores/esp8266/spiffs/LICENSE b/cores/esp8266/spiffs/LICENSE new file mode 100755 index 000000000..e9b0c6777 --- /dev/null +++ b/cores/esp8266/spiffs/LICENSE @@ -0,0 +1,20 @@ +The MIT License (MIT) + +Copyright (c) 2013-2015 Peter Andersson (pelleplutt1976gmail.com) + +Permission is hereby granted, free of charge, to any person obtaining a copy of +this software and associated documentation files (the "Software"), to deal in +the Software without restriction, including without limitation the rights to +use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of +the Software, and to permit persons to whom the Software is furnished to do so, +subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS +FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR +COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER +IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN +CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. diff --git a/cores/esp8266/spiffs/Makefile b/cores/esp8266/spiffs/Makefile new file mode 100755 index 000000000..1c44e4ace --- /dev/null +++ b/cores/esp8266/spiffs/Makefile @@ -0,0 +1,44 @@ + +############################################################# +# Required variables for each makefile +# Discard this section from all parent makefiles +# Expected variables (with automatic defaults): +# CSRCS (all "C" files in the dir) +# SUBDIRS (all subdirs with a Makefile) +# GEN_LIBS - list of libs to be generated () +# GEN_IMAGES - list of images to be generated () +# COMPONENTS_xxx - a list of libs/objs in the form +# subdir/lib to be extracted and rolled up into +# a generated lib/image xxx.a () +# +ifndef PDIR +GEN_LIBS = spiffs.a +endif + +############################################################# +# Configuration i.e. compile options etc. +# Target specific stuff (defines etc.) goes in here! +# Generally values applying to a tree are captured in the +# makefile at its root level - these are then overridden +# for a subtree within the makefile rooted therein +# +#DEFINES += + +############################################################# +# Recursion Magic - Don't touch this!! +# +# Each subtree potentially has an include directory +# corresponding to the common APIs applicable to modules +# rooted at that subtree. Accordingly, the INCLUDE PATH +# of a module can only contain the include directories up +# its parent path, and not its siblings +# +# Required for each makefile to inherit from the parent +# + +INCLUDES := $(INCLUDES) -I $(PDIR)include +INCLUDES += -I ./ +INCLUDES += -I ../libc +INCLUDES += -I ../platform +PDIR := ../$(PDIR) +sinclude $(PDIR)Makefile diff --git a/cores/esp8266/spiffs/docs/IMPLEMENTING b/cores/esp8266/spiffs/docs/IMPLEMENTING new file mode 100755 index 000000000..e69de29bb diff --git a/cores/esp8266/spiffs/docs/INTEGRATION b/cores/esp8266/spiffs/docs/INTEGRATION new file mode 100755 index 000000000..085ed8fc1 --- /dev/null +++ b/cores/esp8266/spiffs/docs/INTEGRATION @@ -0,0 +1,306 @@ +* QUICK AND DIRTY INTEGRATION EXAMPLE + +So, assume you're running a Cortex-M3 board with a 2 MB SPI flash on it. The +SPI flash has 64kB blocks. Your project is built using gnumake, and now you +want to try things out. + +First, you simply copy the files in src/ to your own source folder. Exclude +all files in test folder. Then you point out these files in your make script +for compilation. + +Also copy the spiffs_config.h over from the src/default/ folder. + +Try building. This fails, nagging about inclusions and u32_t and whatnot. Open +the spiffs_config.h and delete the bad inclusions. Also, add following +typedefs: + + typedef signed int s32_t; + typedef unsigned int u32_t; + typedef signed short s16_t; + typedef unsigned short u16_t; + typedef signed char s8_t; + typedef unsigned char u8_t; + +Now it should build. Over to the mounting business. Assume you already +implemented the read, write and erase functions to your SPI flash: + + void my_spi_read(int addr, int size, char *buf) + void my_spi_write(int addr, int size, char *buf) + void my_spi_erase(int addr, int size) + +In your main.c or similar, include the spiffs.h and do that spiffs struct: + + #include + + static spiffs fs; + +Also, toss up some of the needed buffers: + + #define LOG_PAGE_SIZE 256 + + static u8_t spiffs_work_buf[LOG_PAGE_SIZE*2]; + static u8_t spiffs_fds[32*4]; + static u8_t spiffs_cache_buf[(LOG_PAGE_SIZE+32)*4]; + +Now, write the my_spiffs_mount function: + + void my_spiffs_mount() { + spiffs_config cfg; + cfg.phys_size = 2*1024*1024; // use all spi flash + cfg.phys_addr = 0; // start spiffs at start of spi flash + cfg.phys_erase_block = 65536; // according to datasheet + cfg.log_block_size = 65536; // let us not complicate things + cfg.log_page_size = LOG_PAGE_SIZE; // as we said + + cfg.hal_read_f = my_spi_read; + cfg.hal_write_f = my_spi_write; + cfg.hal_erase_f = my_spi_erase; + + int res = SPIFFS_mount(&fs, + &cfg, + spiffs_work_buf, + spiffs_fds, + sizeof(spiffs_fds), + spiffs_cache_buf, + sizeof(spiffs_cache_buf), + 0); + printf("mount res: %i\n", res); + } + +Now, build warns about the my_spi_read, write and erase functions. Wrong +signatures, so go wrap them: + + static s32_t my_spiffs_read(u32_t addr, u32_t size, u8_t *dst) { + my_spi_read(addr, size, dst); + return SPIFFS_OK; + } + + static s32_t my_spiffs_write(u32_t addr, u32_t size, u8_t *src) { + my_spi_write(addr, size, dst); + return SPIFFS_OK; + } + + static s32_t my_spiffs_erase(u32_t addr, u32_t size) { + my_spi_erase(addr, size); + return SPIFFS_OK; + } + +Redirect the config in my_spiffs_mount to the wrappers instead: + + cfg.hal_read_f = my_spiffs_read; + cfg.hal_write_f = my_spiffs_write; + cfg.hal_erase_f = my_spiffs_erase; + +Ok, now you should be able to build and run. However, you get this output: + + mount res: -1 + +but you wanted + + mount res: 0 + +This is probably due to you having experimented with your SPI flash, so it +contains rubbish from spiffs's point of view. Do a mass erase and run again. + +If all is ok now, you're good to go. Try creating a file and read it back: + + static void test_spiffs() { + char buf[12]; + + // Surely, I've mounted spiffs before entering here + + spiffs_file fd = SPIFFS_open(&fs, "my_file", SPIFFS_CREAT | SPIFFS_TRUNC | SPIFFS_RDWR, 0); + if (SPIFFS_write(&fs, fd, (u8_t *)"Hello world", 12) < 0) printf("errno %i\n", SPIFFS_errno(&fs)); + SPIFFS_close(&fs, fd); + + fd = SPIFFS_open(&fs, "my_file", SPIFFS_RDWR, 0); + if (SPIFFS_read(&fs, fd, (u8_t *)buf, 12) < 0) printf("errno %i\n", SPIFFS_errno(&fs)); + SPIFFS_close(&fs, fd); + + printf("--> %s <--\n", buf); + } + +Compile, run, cross fingers hard, and you'll get the output: + + --> Hello world <-- + +Got errors? Check spiffs.h for error definitions to get a clue what went voodoo. + + +* THINGS TO CHECK + +When you alter the spiffs_config values, make sure you also check the typedefs +in spiffs_config.h: + + - spiffs_block_ix + - spiffs_page_ix + - spiffs_obj_id + - spiffs_span_ix + +The sizes of these typedefs must not underflow, else spiffs might end up in +eternal loops. Each typedef is commented what check for. + +Also, if you alter the code or just want to verify your configuration, you can +run + + > make test + +in the spiffs folder. This will run all testcases using the configuration in +default/spiffs_config.h and test/params_test.h. The tests are written for linux +but should run under cygwin also. + + +* INTEGRATING SPIFFS + +In order to integrate spiffs to your embedded target, you will basically need: + - A SPI flash device which your processor can communicate with + - An implementation for reading, writing and erasing the flash + - Memory (flash or ram) for the code + - Memory (ram) for the stack + +Other stuff may be needed, threaded systems might need mutexes and so on. + +** Logical structure + +First and foremost, one must decide how to divide up the SPI flash for spiffs. +Having the datasheet for the actual SPI flash in hand will help. Spiffs can be +defined to use all or only parts of the SPI flash. + +If following seems arcane, read the "HOW TO CONFIG" chapter first. + + - Decide the logical size of blocks. This must be a multiple of the biggest + physical SPI flash block size. To go safe, use the physical block size - + which in many cases is 65536 bytes. + - Decide the logical size of pages. This must be a 2nd logarithm part of the + logical block size. To go safe, use 256 bytes to start with. + - Decide how much of the SPI flash memory to be used for spiffs. This must be + on logical block boundary. If unsafe, use 1 megabyte to start with. + - Decide where on the SPI flash memory the spiffs area should start. This must + be on physical block/sector boundary. If unsafe, use address 0. + +** SPI flash API + +The target must provide three functions to spiffs: + + - s32_t (*spiffs_read)(u32_t addr, u32_t size, u8_t *dst) + - s32_t (*spiffs_write)(u32_t addr, u32_t size, u8_t *src) + - s32_t (*spiffs_erase)(u32_t addr, u32_t size) + +These functions define the only communication between the SPI flash and the +spiffs stack. + +On success these must return 0 (or SPIFFS_OK). Anything else will be considered +an error. + +The size for read and write requests will never exceed the logical page size, +but it may be less. + +The address and size on erase requests will always be on physical block size +boundaries. + +** Mount specification + +In spiffs.h, there is a SPIFFS_mount function defined, used to mount spiffs on +the SPI flash. + +s32_t SPIFFS_mount( + spiffs *fs, + spiffs_config *config, + u8_t *work, + u8_t *fd_space, + u32_t fd_space_size, + void *cache, + u32_t cache_size, + spiffs_check_callback check_cb_f) + + - fs Points to a spiffs struct. This may be totally uninitialized. + - config Points to a spiffs_config struct. This struct must be + initialized when mounting. See below. + - work A ram memory buffer being double the size of the logical page + size. This buffer is used excessively by the spiffs stack. If + logical page size is 256, this buffer must be 512 bytes. + - fd_space A ram memory buffer used for file descriptors. + - fd_space_size The size of the file descriptor buffer. A file descriptor + normally is around 32 bytes depending on the build config - + the bigger the buffer, the more file descriptors are + available. + - cache A ram memory buffer used for cache. Ignored if cache is + disabled in build config. + - cache_size The size of the cache buffer. Ignored if cache is disabled in + build config. One cache page will be slightly larger than the + logical page size. The more ram, the more cache pages, the + quicker the system. + - check_cb_f Callback function for monitoring spiffs consistency checks and + mending operations. May be null. + +The config struct must be initialized prior to mounting. One must always +define the SPI flash access functions: + + spiffs_config.hal_read_f - pointing to the function reading the SPI flash + + spiffs_config.hal_write_f - pointing to the function writing the SPI flash + + spiffs_config.hal_erase_f - pointing to the function erasing the SPI flash + +Depending on the build config - if SPIFFS_SINGLETON is set to zero - following +parameters must be defined: + + spiffs_config.phys_size - the physical number of bytes accounted for + spiffs on the SPI flash + + spiffs_config.phys_addr - the physical starting address on the SPI flash + + spiffs_config.phys_erase_block - the physical size of the largest block/sector + on the SPI flash found within the spiffs + usage address space + + spiffs_config.log_block_size - the logical size of a spiffs block + + spiffs_config.log_page_size - the logical size of a spiffs page + +If SPIFFS_SINGLETON is set to one, above parameters must be set ny defines in +the config header file, spiffs_config.h. + + +** Build config + +makefile: The files needed to be compiled to your target resides in files.mk to +be included in your makefile, either by cut and paste or by inclusion. + +Types: spiffs uses the types u8_t, s8_t, u16_t, s16_t, u32_t, s32_t; these must +be typedeffed. + +spiffs_config.h: you also need to define a spiffs_config.h header. Example of +this is found in the default/ directory. + + +** RAM + +Spiffs needs ram. It needs a working buffer being double the size of the +logical page size. It also needs at least one file descriptor. If cache is +enabled (highly recommended), it will also need a bunch of cache pages. + +Say you have a logical page size of 256 bytes. You want to be able to have four +files open simultaneously, and you can give spiffs four cache pages. This +roughly sums up to: + +256*2 (work buffer) + +32*4 (file descriptors) + +(256+32)*4 (cache pages) + 40 (cache metadata) + +i.e. 1832 bytes. + +This is apart from call stack usage. + +To get the exact amount of bytes needed on your specific target, enable +SPIFFS_BUFFER_HELP in spiffs_config.h, rebuild and call: + + SPIFFS_buffer_bytes_for_filedescs + SPIFFS_buffer_bytes_for_cache + +Having these figures you can disable SPIFFS_BUFFER_HELP again to save flash. + + +* HOW TO CONFIG + +TODO \ No newline at end of file diff --git a/cores/esp8266/spiffs/docs/TECH_SPEC b/cores/esp8266/spiffs/docs/TECH_SPEC new file mode 100755 index 000000000..b4755a6db --- /dev/null +++ b/cores/esp8266/spiffs/docs/TECH_SPEC @@ -0,0 +1,239 @@ +* USING SPIFFS + +TODO + + +* SPIFFS DESIGN + +Spiffs is inspired by YAFFS. However, YAFFS is designed for NAND flashes, and +for bigger targets with much more ram. Nevertheless, many wise thoughts have +been borrowed from YAFFS when writing spiffs. Kudos! + +The main complication writing spiffs was that it cannot be assumed the target +has a heap. Spiffs must go along only with the work ram buffer given to it. +This forces extra implementation on many areas of spiffs. + + +** SPI flash devices using NOR technology + +Below is a small description of how SPI flashes work internally. This is to +give an understanding of the design choices made in spiffs. + +SPI flash devices are physically divided in blocks. On some SPI flash devices, +blocks are further divided into sectors. Datasheets sometimes name blocks as +sectors and vice versa. + +Common memory capacaties for SPI flashes are 512kB up to 8MB of data, where +blocks may be 64kB. Sectors can be e.g. 4kB, if supported. Many SPI flashes +have uniform block sizes, whereas others have non-uniform - the latter meaning +that e.g. the first 16 blocks are 4kB big, and the rest are 64kB. + +The entire memory is linear and can be read and written in random access. +Erasing can only be done block- or sectorwise; or by mass erase. + +SPI flashes can normally be erased from 100.000 up to 1.000.000 cycles before +they fail. + +A clean SPI flash from factory have all bits in entire memory set to one. A +mass erase will reset the device to this state. Block or sector erasing will +put the all bits in the area given by the sector or block to ones. Writing to a +NOR flash pulls ones to zeroes. Writing 0xFF to an address is simply a no-op. + +Writing 0b10101010 to a flash address holding 0b00001111 will yield 0b00001010. + +This way of "write by nand" is used considerably in spiffs. + +Common characteristics of NOR flashes are quick reads, but slow writes. + +And finally, unlike NAND flashes, NOR flashes seem to not need any error +correction. They always write correctly I gather. + + +** Spiffs logical structure + +Some terminology before proceeding. Physical blocks/sectors means sizes stated +in the datasheet. Logical blocks and pages is something the integrator choose. + + +** Blocks and pages + +Spiffs is allocated to a part or all of the memory of the SPI flash device. +This area is divided into logical blocks, which in turn are divided into +logical pages. The boundary of a logical block must coincide with one or more +physical blocks. The sizes for logical blocks and logical pages always remain +the same, they are uniform. + +Example: non-uniform flash mapped to spiffs with 128kB logical blocks + +PHYSICAL FLASH BLOCKS SPIFFS LOGICAL BLOCKS: 128kB + ++-----------------------+ - - - +-----------------------+ +| Block 1 : 16kB | | Block 1 : 128kB | ++-----------------------+ | | +| Block 2 : 16kB | | | ++-----------------------+ | | +| Block 3 : 16kB | | | ++-----------------------+ | | +| Block 4 : 16kB | | | ++-----------------------+ | | +| Block 5 : 64kB | | | ++-----------------------+ - - - +-----------------------+ +| Block 6 : 64kB | | Block 2 : 128kB | ++-----------------------+ | | +| Block 7 : 64kB | | | ++-----------------------+ - - - +-----------------------+ +| Block 8 : 64kB | | Block 3 : 128kB | ++-----------------------+ | | +| Block 9 : 64kB | | | ++-----------------------+ - - - +-----------------------+ +| ... | | ... | + +A logical block is divided further into a number of logical pages. A page +defines the smallest data holding element known to spiffs. Hence, if a file +is created being one byte big, it will occupy one page for index and one page +for data - it will occupy 2 x size of a logical page on flash. +So it seems it is good to select a small page size. + +Each page has a metadata header being normally 5 to 9 bytes. This said, a very +small page size will make metadata occupy a lot of the memory on the flash. A +page size of 64 bytes will waste 8-14% on metadata, while 256 bytes 2-4%. +So it seems it is good to select a big page size. + +Also, spiffs uses a ram buffer being two times the page size. This ram buffer +is used for loading and manipulating pages, but it is also used for algorithms +to find free file ids, scanning the file system, etc. Having too small a page +size means less work buffer for spiffs, ending up in more reads operations and +eventually gives a slower file system. + +Choosing the page size for the system involves many factors: + - How big is the logical block size + - What is the normal size of most files + - How much ram can be spent + - How much data (vs metadata) must be crammed into the file system + - How fast must spiffs be + - Other things impossible to find out + +So, chosing the Optimal Page Size (tm) seems tricky, to say the least. Don't +fret - there is no optimal page size. This varies from how the target will use +spiffs. Use the golden rule: + + ~~~ Logical Page Size = Logical Block Size / 256 ~~~ + +This is a good starting point. The final page size can then be derived through +heuristical experimenting for us non-analytical minds. + + +** Objects, indices and look-ups + +A file, or an object as called in spiffs, is identified by an object id. +Another YAFFS rip-off. This object id is a part of the page header. So, all +pages know to which object/file they belong - not counting the free pages. + +An object is made up of two types of pages: object index pages and data pages. +Data pages contain the data written by user. Index pages contain metadata about +the object, more specifically what data pages are part of the object. + +The page header also includes something called a span index. Let's say a file +is written covering three data pages. The first data page will then have span +index 0, the second span index 1, and the last data page will have span index +2. Simple as that. + +Finally, each page header contain flags, telling if the page is used, +deleted, finalized, holds index or data, and more. + +Object indices also have span indices, where an object index with span index 0 +is referred to as the object index header. This page does not only contain +references to data pages, but also extra info such as object name, object size +in bytes, flags for file or directory, etc. + +If one were to create a file covering three data pages, named e.g. +"spandex-joke.txt", given object id 12, it could look like this: + +PAGE 0 + +PAGE 1 page header: [obj_id:12 span_ix:0 flags:USED|DATA] + + +PAGE 2 page header: [obj_id:12 span_ix:1 flags:USED|DATA] + + +PAGE 3 page header: [obj_id:545 span_ix:13 flags:USED|DATA] + + +PAGE 4 page header: [obj_id:12 span_ix:2 flags:USED|DATA] + + +PAGE 5 page header: [obj_id:12 span_ix:0 flags:USED|INDEX] + obj ix header: [name:spandex-joke.txt size:600 bytes flags:FILE] + obj ix: [1 2 4] + +Looking in detail at page 5, the object index header page, the object index +array refers to each data page in order, as mentioned before. The index of the +object index array correlates with the data page span index. + + entry ix: 0 1 2 + obj ix: [1 2 4] + | | | + PAGE 1, DATA, SPAN_IX 0 --------/ | | + PAGE 2, DATA, SPAN_IX 1 --------/ | + PAGE 4, DATA, SPAN_IX 2 --------/ + +Things to be unveiled in page 0 - well.. Spiffs is designed for systems low on +ram. We cannot keep a dynamic list on the whereabouts of each object index +header so we can find a file fast. There might not even be a heap! But, we do +not want to scan all page headers on the flash to find the object index header. + +The first page(s) of each block contains the so called object look-up. These +are not normal pages, they do not have a header. Instead, they are arrays +pointing out what object-id the rest of all pages in the block belongs to. + +By this look-up, only the first page(s) in each block must to scanned to find +the actual page which contains the object index header of the desired object. + +The object lookup is redundant metadata. The assumption is that it presents +less overhead reading a full page of data to memory from each block and search +that, instead of reading a small amount of data from each page (i.e. the page +header) in all blocks. Each read operation from SPI flash normally contains +extra data as the read command itself and the flash address. Also, depending on +the underlying implementation, other criterions may need to be passed for each +read transaction, like mutexes and such. + +The veiled example unveiled would look like this, with some extra pages: + +PAGE 0 [ 12 12 545 12 12 34 34 4 0 0 0 0 ...] +PAGE 1 page header: [obj_id:12 span_ix:0 flags:USED|DATA] ... +PAGE 2 page header: [obj_id:12 span_ix:1 flags:USED|DATA] ... +PAGE 3 page header: [obj_id:545 span_ix:13 flags:USED|DATA] ... +PAGE 4 page header: [obj_id:12 span_ix:2 flags:USED|DATA] ... +PAGE 5 page header: [obj_id:12 span_ix:0 flags:USED|INDEX] ... +PAGE 6 page header: [obj_id:34 span_ix:0 flags:USED|DATA] ... +PAGE 7 page header: [obj_id:34 span_ix:1 flags:USED|DATA] ... +PAGE 8 page header: [obj_id:4 span_ix:1 flags:USED|INDEX] ... +PAGE 9 page header: [obj_id:23 span_ix:0 flags:DELETED|INDEX] ... +PAGE 10 page header: [obj_id:23 span_ix:0 flags:DELETED|DATA] ... +PAGE 11 page header: [obj_id:23 span_ix:1 flags:DELETED|DATA] ... +PAGE 12 page header: [obj_id:23 span_ix:2 flags:DELETED|DATA] ... +... + +Ok, so why are page 9 to 12 marked as 0 when they belong to object id 23? These +pages are deleted, so this is marked both in page header flags and in the look +up. This is an example where spiffs uses NOR flashes "nand-way" of writing. + +As a matter of fact, there are two object id's which are special: + +obj id 0 (all bits zeroes) - indicates a deleted page in object look up +obj id 0xff.. (all bits ones) - indicates a free page in object look up + +Actually, the object id's have another quirk: if the most significant bit is +set, this indicates an object index page. If the most significant bit is zero, +this indicates a data page. So to be fully correct, page 0 in above example +would look like this: + +PAGE 0 [ 12 12 545 12 *12 34 34 *4 0 0 0 0 ...] + +where the asterisk means the msb of the object id is set. + +This is another way to speed up the searches when looking for object indices. +By looking on the object id's msb in the object lookup, it is also possible +to find out whether the page is an object index page or a data page. + diff --git a/cores/esp8266/spiffs/docs/TODO b/cores/esp8266/spiffs/docs/TODO new file mode 100755 index 000000000..88709f022 --- /dev/null +++ b/cores/esp8266/spiffs/docs/TODO @@ -0,0 +1 @@ +* When mending lost pages, also see if they fit into length specified in object index header \ No newline at end of file diff --git a/cores/esp8266/spiffs/flashmem.h b/cores/esp8266/spiffs/flashmem.h new file mode 100755 index 000000000..c4f4252a1 --- /dev/null +++ b/cores/esp8266/spiffs/flashmem.h @@ -0,0 +1,73 @@ +// Based on NodeMCU platform_flash +// https://github.com/nodemcu/nodemcu-firmware + +#ifndef SYSTEM_FLASHMEM_H_ +#define SYSTEM_FLASHMEM_H_ + +#ifdef __cplusplus +extern "C" { +#endif + +#include "spiffs.h" +#include "spi_flash.h" + +#define INTERNAL_FLASH_WRITE_UNIT_SIZE 4 +#define INTERNAL_FLASH_READ_UNIT_SIZE 4 + +#define FLASH_TOTAL_SEC_COUNT (flashmem_get_size_sectors()) + +#define SYS_PARAM_SEC_COUNT 4 +#define FLASH_WORK_SEC_COUNT (FLASH_TOTAL_SEC_COUNT - SYS_PARAM_SEC_COUNT) + +#define INTERNAL_FLASH_SECTOR_SIZE SPI_FLASH_SEC_SIZE +#define INTERNAL_FLASH_SIZE ( (FLASH_WORK_SEC_COUNT) * INTERNAL_FLASH_SECTOR_SIZE ) +#define INTERNAL_FLASH_START_ADDRESS 0x40200000 + +typedef struct +{ + uint8_t unknown0; + uint8_t unknown1; + enum + { + MODE_QIO = 0, + MODE_QOUT = 1, + MODE_DIO = 2, + MODE_DOUT = 15, + } mode : 8; + enum + { + SPEED_40MHZ = 0, + SPEED_26MHZ = 1, + SPEED_20MHZ = 2, + SPEED_80MHZ = 15, + } speed : 4; + enum + { + SIZE_4MBIT = 0, + SIZE_2MBIT = 1, + SIZE_8MBIT = 2, + SIZE_16MBIT = 3, + SIZE_32MBIT = 4, + } size : 4; +} STORE_TYPEDEF_ATTR SPIFlashInfo; + +extern uint32_t flashmem_write( const void *from, uint32_t toaddr, uint32_t size ); +extern uint32_t flashmem_read( void *to, uint32_t fromaddr, uint32_t size ); +extern bool flashmem_erase_sector( uint32_t sector_id ); + +extern SPIFlashInfo flashmem_get_info(); +extern uint8_t flashmem_get_size_type(); +extern uint32_t flashmem_get_size_bytes(); +extern uint16_t flashmem_get_size_sectors(); +uint32_t flashmem_find_sector( uint32_t address, uint32_t *pstart, uint32_t *pend ); +uint32_t flashmem_get_sector_of_address( uint32_t addr ); + +extern uint32_t flashmem_write_internal( const void *from, uint32_t toaddr, uint32_t size ); +extern uint32_t flashmem_read_internal( void *to, uint32_t fromaddr, uint32_t size ); +extern uint32_t flashmem_get_first_free_block_address(); + +#ifdef __cplusplus +} +#endif + +#endif /* SYSTEM_FLASHMEM_H_ */ diff --git a/cores/esp8266/spiffs/spiffs.c b/cores/esp8266/spiffs/spiffs.c new file mode 100755 index 000000000..860b76ae2 --- /dev/null +++ b/cores/esp8266/spiffs/spiffs.c @@ -0,0 +1,179 @@ +#include "spiffs.h" + +#define LOG_PAGE_SIZE 256 + +spiffs _filesystemStorageHandle; + +static u8_t spiffs_work_buf[LOG_PAGE_SIZE*2]; +static u8_t spiffs_fds[32*4]; +static u8_t spiffs_cache[(LOG_PAGE_SIZE+32)*4]; + +static s32_t api_spiffs_read(u32_t addr, u32_t size, u8_t *dst) +{ + flashmem_read(dst, addr, size); + return SPIFFS_OK; +} + +static s32_t api_spiffs_write(u32_t addr, u32_t size, u8_t *src) +{ + //debugf("api_spiffs_write"); + flashmem_write(src, addr, size); + return SPIFFS_OK; +} + +static s32_t api_spiffs_erase(u32_t addr, u32_t size) +{ + debugf("api_spiffs_erase"); + u32_t sect_first = flashmem_get_sector_of_address(addr); + u32_t sect_last = sect_first; + while( sect_first <= sect_last ) + if( !flashmem_erase_sector( sect_first ++ ) ) + return SPIFFS_ERR_INTERNAL; + return SPIFFS_OK; +} + +/******************* +The W25Q32BV array is organized into 16,384 programmable pages of 256-bytes each. Up to 256 bytes can be programmed at a time. +Pages can be erased in groups of 16 (4KB sector erase), groups of 128 (32KB block erase), groups of 256 (64KB block erase) or +the entire chip (chip erase). The W25Q32BV has 1,024 erasable sectors and 64 erasable blocks respectively. +The small 4KB sectors allow for greater flexibility in applications that require data and parameter storage. +********************/ + +spiffs_config spiffs_get_storage_config() +{ + spiffs_config cfg = {0}; + cfg.phys_addr = ( u32_t )flashmem_get_first_free_block_address(); + if (cfg.phys_addr == 0) + return cfg; + cfg.phys_addr += 0x3000; + cfg.phys_addr &= 0xFFFFC000; // align to 4 sector. + cfg.phys_size = INTERNAL_FLASH_SIZE - ( ( u32_t )cfg.phys_addr - INTERNAL_FLASH_START_ADDRESS ); + /*cfg.phys_addr = INTERNAL_FLASH_SIZE - SPIFFS_WORK_SIZE + INTERNAL_FLASH_START_ADDRESS; + cfg.phys_addr += 0x3000; + cfg.phys_addr &= 0xFFFFC000; // align to 4 sector. + cfg.phys_size = SPIFFS_WORK_SIZE;*/ + cfg.phys_erase_block = INTERNAL_FLASH_SECTOR_SIZE; // according to datasheet + cfg.log_block_size = INTERNAL_FLASH_SECTOR_SIZE * 2; // Important to make large + cfg.log_page_size = LOG_PAGE_SIZE; // as we said + return cfg; +} + +bool spiffs_format_internal() +{ + spiffs_config cfg = spiffs_get_storage_config(); + if (cfg.phys_addr == 0) + { + SYSTEM_ERROR("Can't format file system, wrong address"); + return false; + } + + u32_t sect_first, sect_last; + sect_first = cfg.phys_addr; + sect_first = flashmem_get_sector_of_address(sect_first); + sect_last = cfg.phys_addr + cfg.phys_size; + sect_last = flashmem_get_sector_of_address(sect_last); + debugf("sect_first: %x, sect_last: %x\n", sect_first, sect_last); + while( sect_first <= sect_last ) + if(!flashmem_erase_sector( sect_first ++ )) + return false; +} + +void spiffs_mount() +{ + spiffs_config cfg = spiffs_get_storage_config(); + if (cfg.phys_addr == 0) + { + SYSTEM_ERROR("Can't start file system, wrong address"); + return; + } + + debugf("fs.start:%x, size:%d Kb\n", cfg.phys_addr, cfg.phys_size / 1024); + + cfg.hal_read_f = api_spiffs_read; + cfg.hal_write_f = api_spiffs_write; + cfg.hal_erase_f = api_spiffs_erase; + + uint32_t dat; + bool writeFirst = false; + flashmem_read(&dat, cfg.phys_addr, 4); + //debugf("%X", dat); + + if (dat == UINT32_MAX) + { + debugf("First init file system"); + spiffs_format_internal(); + writeFirst = true; + } + + int res = SPIFFS_mount(&_filesystemStorageHandle, + &cfg, + spiffs_work_buf, + spiffs_fds, + sizeof(spiffs_fds), + spiffs_cache, + sizeof(spiffs_cache), + NULL); + debugf("mount res: %d\n", res); + + if (writeFirst) + { + file_t fd = SPIFFS_open(&_filesystemStorageHandle, "initialize_fs_header.dat", SPIFFS_CREAT | SPIFFS_TRUNC | SPIFFS_RDWR, 0); + SPIFFS_write(&_filesystemStorageHandle, fd, (u8_t *)"1", 1); + SPIFFS_fremove(&_filesystemStorageHandle, fd); + SPIFFS_close(&_filesystemStorageHandle, fd); + } + + //dat=0; + //flashmem_read(&dat, cfg.phys_addr, 4); + //debugf("%X", dat); +} + +void spiffs_unmount() +{ + SPIFFS_unmount(&_filesystemStorageHandle); +} + +// FS formatting function +bool spiffs_format() +{ + spiffs_unmount(); + spiffs_format_internal(); + spiffs_mount(); + return true; +} + +//int spiffs_check( void ) +//{ + // ets_wdt_disable(); + // int res = (int)SPIFFS_check(&_filesystemStorageHandle); + // ets_wdt_enable(); + // return res; +//} + +void test_spiffs() +{ + char buf[12] = {0}; + + // Surely, I've mounted spiffs before entering here + + spiffs_file fd; + spiffs_stat st = {0}; + SPIFFS_stat(&_filesystemStorageHandle, "my_file.txt", &st); + if (st.size <= 0) + { + fd = SPIFFS_open(&_filesystemStorageHandle, "my_file.txt", SPIFFS_CREAT | SPIFFS_TRUNC | SPIFFS_RDWR, 0); + if (SPIFFS_write(&_filesystemStorageHandle, fd, (u8_t *)"Hello world", 11) < 0) + debugf("errno %d\n", SPIFFS_errno(&_filesystemStorageHandle)); + SPIFFS_close(&_filesystemStorageHandle, fd); + debugf("file created"); + } + else + debugf("file %s exist :)", st.name); + + + fd = SPIFFS_open(&_filesystemStorageHandle, "my_file.txt", SPIFFS_RDWR, 0); + if (SPIFFS_read(&_filesystemStorageHandle, fd, (u8_t *)buf, 11) < 0) debugf("errno %d\n", SPIFFS_errno(&_filesystemStorageHandle)); + SPIFFS_close(&_filesystemStorageHandle, fd); + + debugf("--> %s <--\n", buf); +} diff --git a/cores/esp8266/spiffs/spiffs.h b/cores/esp8266/spiffs/spiffs.h new file mode 100755 index 000000000..85f7de7f1 --- /dev/null +++ b/cores/esp8266/spiffs/spiffs.h @@ -0,0 +1,470 @@ +/* + * spiffs.h + * + * Created on: May 26, 2013 + * Author: petera + */ + +#ifndef SPIFFS_H_ +#define SPIFFS_H_ + +#ifdef __cplusplus +extern "C" { +#endif + +//#include "c_stdio.h" +#include +#include "spiffs_config.h" +#include "flashmem.h" + +#define SPIFFS_OK 0 +#define SPIFFS_ERR_NOT_MOUNTED -10000 +#define SPIFFS_ERR_FULL -10001 +#define SPIFFS_ERR_NOT_FOUND -10002 +#define SPIFFS_ERR_END_OF_OBJECT -10003 +#define SPIFFS_ERR_DELETED -10004 +#define SPIFFS_ERR_NOT_FINALIZED -10005 +#define SPIFFS_ERR_NOT_INDEX -10006 +#define SPIFFS_ERR_OUT_OF_FILE_DESCS -10007 +#define SPIFFS_ERR_FILE_CLOSED -10008 +#define SPIFFS_ERR_FILE_DELETED -10009 +#define SPIFFS_ERR_BAD_DESCRIPTOR -10010 +#define SPIFFS_ERR_IS_INDEX -10011 +#define SPIFFS_ERR_IS_FREE -10012 +#define SPIFFS_ERR_INDEX_SPAN_MISMATCH -10013 +#define SPIFFS_ERR_DATA_SPAN_MISMATCH -10014 +#define SPIFFS_ERR_INDEX_REF_FREE -10015 +#define SPIFFS_ERR_INDEX_REF_LU -10016 +#define SPIFFS_ERR_INDEX_REF_INVALID -10017 +#define SPIFFS_ERR_INDEX_FREE -10018 +#define SPIFFS_ERR_INDEX_LU -10019 +#define SPIFFS_ERR_INDEX_INVALID -10020 +#define SPIFFS_ERR_NOT_WRITABLE -10021 +#define SPIFFS_ERR_NOT_READABLE -10022 +#define SPIFFS_ERR_CONFLICTING_NAME -10023 + +#define SPIFFS_ERR_INTERNAL -10050 + +#define SPIFFS_ERR_TEST -10100 + + +// spiffs file descriptor index type. must be signed +typedef s16_t spiffs_file; +// spiffs file descriptor flags +typedef u16_t spiffs_flags; +// spiffs file mode +typedef u16_t spiffs_mode; +// object type +typedef u8_t spiffs_obj_type; + +/* spi read call function type */ +typedef s32_t (*spiffs_read)(u32_t addr, u32_t size, u8_t *dst); +/* spi write call function type */ +typedef s32_t (*spiffs_write)(u32_t addr, u32_t size, u8_t *src); +/* spi erase call function type */ +typedef s32_t (*spiffs_erase)(u32_t addr, u32_t size); + +/* file system check callback report operation */ +typedef enum { + SPIFFS_CHECK_LOOKUP = 0, + SPIFFS_CHECK_INDEX, + SPIFFS_CHECK_PAGE +} spiffs_check_type; + +/* file system check callback report type */ +typedef enum { + SPIFFS_CHECK_PROGRESS = 0, + SPIFFS_CHECK_ERROR, + SPIFFS_CHECK_FIX_INDEX, + SPIFFS_CHECK_FIX_LOOKUP, + SPIFFS_CHECK_DELETE_ORPHANED_INDEX, + SPIFFS_CHECK_DELETE_PAGE, + SPIFFS_CHECK_DELETE_BAD_FILE, +} spiffs_check_report; + +/* file system check callback function */ +typedef void (*spiffs_check_callback)(spiffs_check_type type, spiffs_check_report report, + u32_t arg1, u32_t arg2); + +#ifndef SPIFFS_DBG +#define SPIFFS_DBG(...) \ + print(__VA_ARGS__) +#endif +#ifndef SPIFFS_GC_DBG +#define SPIFFS_GC_DBG(...) printf(__VA_ARGS__) +#endif +#ifndef SPIFFS_CACHE_DBG +#define SPIFFS_CACHE_DBG(...) printf(__VA_ARGS__) +#endif +#ifndef SPIFFS_CHECK_DBG +#define SPIFFS_CHECK_DBG(...) printf(__VA_ARGS__) +#endif + +/* Any write to the filehandle is appended to end of the file */ +#define SPIFFS_APPEND (1<<0) +/* If the opened file exists, it will be truncated to zero length before opened */ +#define SPIFFS_TRUNC (1<<1) +/* If the opened file does not exist, it will be created before opened */ +#define SPIFFS_CREAT (1<<2) +/* The opened file may only be read */ +#define SPIFFS_RDONLY (1<<3) +/* The opened file may only be writted */ +#define SPIFFS_WRONLY (1<<4) +/* The opened file may be both read and writted */ +#define SPIFFS_RDWR (SPIFFS_RDONLY | SPIFFS_WRONLY) +/* Any writes to the filehandle will never be cached */ +#define SPIFFS_DIRECT (1<<5) + +#define SPIFFS_SEEK_SET (0) +#define SPIFFS_SEEK_CUR (1) +#define SPIFFS_SEEK_END (2) + +#define SPIFFS_TYPE_FILE (1) +#define SPIFFS_TYPE_DIR (2) +#define SPIFFS_TYPE_HARD_LINK (3) +#define SPIFFS_TYPE_SOFT_LINK (4) + +#ifndef SPIFFS_LOCK +#define SPIFFS_LOCK(fs) +#endif + +#ifndef SPIFFS_UNLOCK +#define SPIFFS_UNLOCK(fs) +#endif + +// phys structs + +// spiffs spi configuration struct +typedef struct { + // physical read function + spiffs_read hal_read_f; + // physical write function + spiffs_write hal_write_f; + // physical erase function + spiffs_erase hal_erase_f; +#if SPIFFS_SINGLETON == 0 + // physical size of the spi flash + u32_t phys_size; + // physical offset in spi flash used for spiffs, + // must be on block boundary + u32_t phys_addr; + // physical size when erasing a block + u32_t phys_erase_block; + + // logical size of a block, must be on physical + // block size boundary and must never be less than + // a physical block + u32_t log_block_size; + // logical size of a page, must be at least + // log_block_size / 8 + u32_t log_page_size; +#endif +} spiffs_config; + +typedef struct { + // file system configuration + spiffs_config cfg; + // number of logical blocks + u32_t block_count; + + // cursor for free blocks, block index + spiffs_block_ix free_cursor_block_ix; + // cursor for free blocks, entry index + int free_cursor_obj_lu_entry; + // cursor when searching, block index + spiffs_block_ix cursor_block_ix; + // cursor when searching, entry index + int cursor_obj_lu_entry; + + // primary work buffer, size of a logical page + u8_t *lu_work; + // secondary work buffer, size of a logical page + u8_t *work; + // file descriptor memory area + u8_t *fd_space; + // available file descriptors + u32_t fd_count; + + // last error + s32_t errno; + + // current number of free blocks + u32_t free_blocks; + // current number of busy pages + u32_t stats_p_allocated; + // current number of deleted pages + u32_t stats_p_deleted; + // flag indicating that garbage collector is cleaning + u8_t cleaning; + // max erase count amongst all blocks + spiffs_obj_id max_erase_count; + +#if SPIFFS_GC_STATS + u32_t stats_gc_runs; +#endif + +#if SPIFFS_CACHE + // cache memory + void *cache; + // cache size + u32_t cache_size; +#if SPIFFS_CACHE_STATS + u32_t cache_hits; + u32_t cache_misses; +#endif +#endif + + // check callback function + spiffs_check_callback check_cb_f; +} spiffs; + +/* spiffs file status struct */ +typedef struct { + spiffs_obj_id obj_id; + u32_t size; + spiffs_obj_type type; + u8_t name[SPIFFS_OBJ_NAME_LEN]; +} spiffs_stat; + +struct spiffs_dirent { + spiffs_obj_id obj_id; + u8_t name[SPIFFS_OBJ_NAME_LEN]; + spiffs_obj_type type; + u32_t size; + spiffs_page_ix pix; +}; + +typedef struct { + spiffs *fs; + spiffs_block_ix block; + int entry; +} spiffs_DIR; + +// functions + +/** + * Initializes the file system dynamic parameters and mounts the filesystem + * @param fs the file system struct + * @param config the physical and logical configuration of the file system + * @param work a memory work buffer comprising 2*config->log_page_size + * bytes used throughout all file system operations + * @param fd_space memory for file descriptors + * @param fd_space_size memory size of file descriptors + * @param cache memory for cache, may be null + * @param cache_size memory size of cache + * @param check_cb_f callback function for reporting during consistency checks + */ +s32_t SPIFFS_mount(spiffs *fs, spiffs_config *config, u8_t *work, + u8_t *fd_space, u32_t fd_space_size, + void *cache, u32_t cache_size, + spiffs_check_callback check_cb_f); + +/** + * Unmounts the file system. All file handles will be flushed of any + * cached writes and closed. + * @param fs the file system struct + */ +void SPIFFS_unmount(spiffs *fs); + +/** + * Creates a new file. + * @param fs the file system struct + * @param path the path of the new file + * @param mode ignored, for posix compliance + */ +s32_t SPIFFS_creat(spiffs *fs, const char *path, spiffs_mode mode); + +/** + * Opens/creates a file. + * @param fs the file system struct + * @param path the path of the new file + * @param flags the flags for the open command, can be combinations of + * SPIFFS_APPEND, SPIFFS_TRUNC, SPIFFS_CREAT, SPIFFS_RD_ONLY, + * SPIFFS_WR_ONLY, SPIFFS_RDWR, SPIFFS_DIRECT + * @param mode ignored, for posix compliance + */ +spiffs_file SPIFFS_open(spiffs *fs, const char *path, spiffs_flags flags, spiffs_mode mode); + +/** + * Opens a file by given dir entry. + * Optimization purposes, when traversing a file system with SPIFFS_readdir + * a normal SPIFFS_open would need to traverse the filesystem again to find + * the file, whilst SPIFFS_open_by_dirent already knows where the file resides. + * @param fs the file system struct + * @param path the dir entry to the file + * @param flags the flags for the open command, can be combinations of + * SPIFFS_APPEND, SPIFFS_TRUNC, SPIFFS_CREAT, SPIFFS_RD_ONLY, + * SPIFFS_WR_ONLY, SPIFFS_RDWR, SPIFFS_DIRECT. + * SPIFFS_CREAT will have no effect in this case. + * @param mode ignored, for posix compliance + */ +spiffs_file SPIFFS_open_by_dirent(spiffs *fs, struct spiffs_dirent *e, spiffs_flags flags, spiffs_mode mode); + +/** + * Reads from given filehandle. + * @param fs the file system struct + * @param fh the filehandle + * @param buf where to put read data + * @param len how much to read + * @returns number of bytes read, or -1 if error + */ +s32_t SPIFFS_read(spiffs *fs, spiffs_file fh, void *buf, u32_t len); + +/** + * Writes to given filehandle. + * @param fs the file system struct + * @param fh the filehandle + * @param buf the data to write + * @param len how much to write + * @returns number of bytes written, or -1 if error + */ +s32_t SPIFFS_write(spiffs *fs, spiffs_file fh, void *buf, u32_t len); + +/** + * Moves the read/write file offset + * @param fs the file system struct + * @param fh the filehandle + * @param offs how much/where to move the offset + * @param whence if SPIFFS_SEEK_SET, the file offset shall be set to offset bytes + * if SPIFFS_SEEK_CUR, the file offset shall be set to its current location plus offset + * if SPIFFS_SEEK_END, the file offset shall be set to the size of the file plus offset + */ +s32_t SPIFFS_lseek(spiffs *fs, spiffs_file fh, s32_t offs, int whence); + +/** + * Removes a file by path + * @param fs the file system struct + * @param path the path of the file to remove + */ +s32_t SPIFFS_remove(spiffs *fs, const char *path); + +/** + * Removes a file by filehandle + * @param fs the file system struct + * @param fh the filehandle of the file to remove + */ +s32_t SPIFFS_fremove(spiffs *fs, spiffs_file fh); + +/** + * Gets file status by path + * @param fs the file system struct + * @param path the path of the file to stat + * @param s the stat struct to populate + */ +s32_t SPIFFS_stat(spiffs *fs, const char *path, spiffs_stat *s); + +/** + * Gets file status by filehandle + * @param fs the file system struct + * @param fh the filehandle of the file to stat + * @param s the stat struct to populate + */ +s32_t SPIFFS_fstat(spiffs *fs, spiffs_file fh, spiffs_stat *s); + +/** + * Flushes all pending write operations from cache for given file + * @param fs the file system struct + * @param fh the filehandle of the file to flush + */ +s32_t SPIFFS_fflush(spiffs *fs, spiffs_file fh); + +/** + * Closes a filehandle. If there are pending write operations, these are finalized before closing. + * @param fs the file system struct + * @param fh the filehandle of the file to close + */ +void SPIFFS_close(spiffs *fs, spiffs_file fh); + +/** + * Renames a file + * @param fs the file system struct + * @param old path of file to rename + * @param new new path of file + */ +s32_t SPIFFS_rename(spiffs *fs, const char *old, const char *newname); + +/** + * Returns last error of last file operation. + * @param fs the file system struct + */ +s32_t SPIFFS_errno(spiffs *fs); + +/** + * Opens a directory stream corresponding to the given name. + * The stream is positioned at the first entry in the directory. + * On hydrogen builds the name argument is ignored as hydrogen builds always correspond + * to a flat file structure - no directories. + * @param fs the file system struct + * @param name the name of the directory + * @param d pointer the directory stream to be populated + */ +spiffs_DIR *SPIFFS_opendir(spiffs *fs, const char *name, spiffs_DIR *d); + +/** + * Closes a directory stream + * @param d the directory stream to close + */ +s32_t SPIFFS_closedir(spiffs_DIR *d); + +/** + * Reads a directory into given spifs_dirent struct. + * @param d pointer to the directory stream + * @param e the dirent struct to be populated + * @returns null if error or end of stream, else given dirent is returned + */ +struct spiffs_dirent *SPIFFS_readdir(spiffs_DIR *d, struct spiffs_dirent *e); + +/** + * Runs a consistency check on given filesystem. + * @param fs the file system struct + */ +s32_t SPIFFS_check(spiffs *fs); + +/** + * Check if EOF reached. + * @param fs the file system struct + * @param fh the filehandle of the file to check + */ +s32_t SPIFFS_eof(spiffs *fs, spiffs_file fh); +s32_t SPIFFS_tell(spiffs *fs, spiffs_file fh); + +#if SPIFFS_TEST_VISUALISATION +/** + * Prints out a visualization of the filesystem. + * @param fs the file system struct + */ +s32_t SPIFFS_vis(spiffs *fs); +#endif + +#if SPIFFS_BUFFER_HELP +/** + * Returns number of bytes needed for the filedescriptor buffer given + * amount of file descriptors. + */ +u32_t SPIFFS_buffer_bytes_for_filedescs(spiffs *fs, u32_t num_descs); + +#if SPIFFS_CACHE +/** + * Returns number of bytes needed for the cache buffer given + * amount of cache pages. + */ +u32_t SPIFFS_buffer_bytes_for_cache(spiffs *fs, u32_t num_pages); +#endif +#endif + +#if SPIFFS_CACHE +#endif + + +void spiffs_mount(); +void spiffs_unmount(); +bool spiffs_format(); +spiffs_config spiffs_get_storage_config(); +extern void test_spiffs(); + +extern spiffs _filesystemStorageHandle; + +#ifdef __cplusplus +} +#endif +#endif /* SPIFFS_H_ */ diff --git a/cores/esp8266/spiffs/spiffs_cache.c b/cores/esp8266/spiffs/spiffs_cache.c new file mode 100755 index 000000000..6de0e493a --- /dev/null +++ b/cores/esp8266/spiffs/spiffs_cache.c @@ -0,0 +1,303 @@ +/* + * spiffs_cache.c + * + * Created on: Jun 23, 2013 + * Author: petera + */ + +#include "spiffs.h" +#include "spiffs_nucleus.h" + +#if SPIFFS_CACHE + +// returns cached page for give page index, or null if no such cached page +static spiffs_cache_page *spiffs_cache_page_get(spiffs *fs, spiffs_page_ix pix) { + spiffs_cache *cache = spiffs_get_cache(fs); + if ((cache->cpage_use_map & cache->cpage_use_mask) == 0) return 0; + int i; + for (i = 0; i < cache->cpage_count; i++) { + spiffs_cache_page *cp = spiffs_get_cache_page_hdr(fs, cache, i); + if ((cache->cpage_use_map & (1<flags & SPIFFS_CACHE_FLAG_TYPE_WR) == 0 && + cp->pix == pix ) { + SPIFFS_CACHE_DBG("CACHE_GET: have cache page %i for %04x\n", i, pix); + cp->last_access = cache->last_access; + return cp; + } + } + //SPIFFS_CACHE_DBG("CACHE_GET: no cache for %04x\n", pix); + return 0; +} + +// frees cached page +static s32_t spiffs_cache_page_free(spiffs *fs, int ix, u8_t write_back) { + s32_t res = SPIFFS_OK; + spiffs_cache *cache = spiffs_get_cache(fs); + spiffs_cache_page *cp = spiffs_get_cache_page_hdr(fs, cache, ix); + if (cache->cpage_use_map & (1<flags & SPIFFS_CACHE_FLAG_TYPE_WR) == 0 && + (cp->flags & SPIFFS_CACHE_FLAG_DIRTY)) { + u8_t *mem = spiffs_get_cache_page(fs, cache, ix); + res = fs->cfg.hal_write_f(SPIFFS_PAGE_TO_PADDR(fs, cp->pix), SPIFFS_CFG_LOG_PAGE_SZ(fs), mem); + } + + cp->flags = 0; + cache->cpage_use_map &= ~(1 << ix); + + if (cp->flags & SPIFFS_CACHE_FLAG_TYPE_WR) { + SPIFFS_CACHE_DBG("CACHE_FREE: free cache page %i objid %04x\n", ix, cp->obj_id); + } else { + SPIFFS_CACHE_DBG("CACHE_FREE: free cache page %i pix %04x\n", ix, cp->pix); + } + } + + return res; +} + +// removes the oldest accessed cached page +static s32_t spiffs_cache_page_remove_oldest(spiffs *fs, u8_t flag_mask, u8_t flags) { + s32_t res = SPIFFS_OK; + spiffs_cache *cache = spiffs_get_cache(fs); + + if ((cache->cpage_use_map & cache->cpage_use_mask) != cache->cpage_use_mask) { + // at least one free cpage + return SPIFFS_OK; + } + + // all busy, scan thru all to find the cpage which has oldest access + int i; + int cand_ix = -1; + u32_t oldest_val = 0; + for (i = 0; i < cache->cpage_count; i++) { + spiffs_cache_page *cp = spiffs_get_cache_page_hdr(fs, cache, i); + if ((cache->last_access - cp->last_access) > oldest_val && + (cp->flags & flag_mask) == flags) { + oldest_val = cache->last_access - cp->last_access; + cand_ix = i; + } + } + + if (cand_ix >= 0) { + res = spiffs_cache_page_free(fs, cand_ix, 1); + } + + return res; +} + +// allocates a new cached page and returns it, or null if all cache pages are busy +static spiffs_cache_page *spiffs_cache_page_allocate(spiffs *fs) { + spiffs_cache *cache = spiffs_get_cache(fs); + if (cache->cpage_use_map == 0xffffffff) { + // out of cache memory + return 0; + } + int i; + for (i = 0; i < cache->cpage_count; i++) { + if ((cache->cpage_use_map & (1<cpage_use_map |= (1<last_access = cache->last_access; + SPIFFS_CACHE_DBG("CACHE_ALLO: allocated cache page %i\n", i); + return cp; + } + } + // out of cache entries + return 0; +} + +// drops the cache page for give page index +void spiffs_cache_drop_page(spiffs *fs, spiffs_page_ix pix) { + spiffs_cache_page *cp = spiffs_cache_page_get(fs, pix); + if (cp) { + spiffs_cache_page_free(fs, cp->ix, 0); + } +} + +// ------------------------------ + +// reads from spi flash or the cache +s32_t spiffs_phys_rd( + spiffs *fs, + u8_t op, + spiffs_file fh, + u32_t addr, + u32_t len, + u8_t *dst) { + (void)fh; + s32_t res = SPIFFS_OK; + spiffs_cache *cache = spiffs_get_cache(fs); + spiffs_cache_page *cp = spiffs_cache_page_get(fs, SPIFFS_PADDR_TO_PAGE(fs, addr)); + cache->last_access++; + if (cp) { +#if SPIFFS_CACHE_STATS + fs->cache_hits++; +#endif + cp->last_access = cache->last_access; + } else { + if ((op & SPIFFS_OP_TYPE_MASK) == SPIFFS_OP_T_OBJ_LU2) { + // for second layer lookup functions, we do not cache in order to prevent shredding + return fs->cfg.hal_read_f( + addr , + len, + dst); + } +#if SPIFFS_CACHE_STATS + fs->cache_misses++; +#endif + res = spiffs_cache_page_remove_oldest(fs, SPIFFS_CACHE_FLAG_TYPE_WR, 0); + cp = spiffs_cache_page_allocate(fs); + if (cp) { + cp->flags = SPIFFS_CACHE_FLAG_WRTHRU; + cp->pix = SPIFFS_PADDR_TO_PAGE(fs, addr); + } + + s32_t res2 = fs->cfg.hal_read_f( + addr - SPIFFS_PADDR_TO_PAGE_OFFSET(fs, addr), + SPIFFS_CFG_LOG_PAGE_SZ(fs), + spiffs_get_cache_page(fs, cache, cp->ix)); + if (res2 != SPIFFS_OK) { + res = res2; + } + } + u8_t *mem = spiffs_get_cache_page(fs, cache, cp->ix); + c_memcpy(dst, &mem[SPIFFS_PADDR_TO_PAGE_OFFSET(fs, addr)], len); + return res; +} + +// writes to spi flash and/or the cache +s32_t spiffs_phys_wr( + spiffs *fs, + u8_t op, + spiffs_file fh, + u32_t addr, + u32_t len, + u8_t *src) { + (void)fh; + spiffs_page_ix pix = SPIFFS_PADDR_TO_PAGE(fs, addr); + spiffs_cache *cache = spiffs_get_cache(fs); + spiffs_cache_page *cp = spiffs_cache_page_get(fs, pix); + + if (cp && (op & SPIFFS_OP_COM_MASK) != SPIFFS_OP_C_WRTHRU) { + // have a cache page + // copy in data to cache page + + if ((op & SPIFFS_OP_COM_MASK) == SPIFFS_OP_C_DELE && + (op & SPIFFS_OP_TYPE_MASK) != SPIFFS_OP_T_OBJ_LU) { + // page is being deleted, wipe from cache - unless it is a lookup page + spiffs_cache_page_free(fs, cp->ix, 0); + return fs->cfg.hal_write_f(addr, len, src); + } + + u8_t *mem = spiffs_get_cache_page(fs, cache, cp->ix); + c_memcpy(&mem[SPIFFS_PADDR_TO_PAGE_OFFSET(fs, addr)], src, len); + + cache->last_access++; + cp->last_access = cache->last_access; + + if (cp->flags && SPIFFS_CACHE_FLAG_WRTHRU) { + // page is being updated, no write-cache, just pass thru + return fs->cfg.hal_write_f(addr, len, src); + } else { + return SPIFFS_OK; + } + } else { + // no cache page, no write cache - just write thru + return fs->cfg.hal_write_f(addr, len, src); + } +} + +#if SPIFFS_CACHE_WR +// returns the cache page that this fd refers, or null if no cache page +spiffs_cache_page *spiffs_cache_page_get_by_fd(spiffs *fs, spiffs_fd *fd) { + spiffs_cache *cache = spiffs_get_cache(fs); + + if ((cache->cpage_use_map & cache->cpage_use_mask) == 0) { + // all cpages free, no cpage cannot be assigned to obj_id + return 0; + } + + int i; + for (i = 0; i < cache->cpage_count; i++) { + spiffs_cache_page *cp = spiffs_get_cache_page_hdr(fs, cache, i); + if ((cache->cpage_use_map & (1<flags & SPIFFS_CACHE_FLAG_TYPE_WR) && + cp->obj_id == fd->obj_id) { + return cp; + } + } + + return 0; +} + +// allocates a new cache page and refers this to given fd - flushes an old cache +// page if all cache is busy +spiffs_cache_page *spiffs_cache_page_allocate_by_fd(spiffs *fs, spiffs_fd *fd) { + // before this function is called, it is ensured that there is no already existing + // cache page with same object id + spiffs_cache_page_remove_oldest(fs, SPIFFS_CACHE_FLAG_TYPE_WR, 0); + spiffs_cache_page *cp = spiffs_cache_page_allocate(fs); + if (cp == 0) { + // could not get cache page + return 0; + } + + cp->flags = SPIFFS_CACHE_FLAG_TYPE_WR; + cp->obj_id = fd->obj_id; + fd->cache_page = cp; + return cp; +} + +// unrefers all fds that this cache page refers to and releases the cache page +void spiffs_cache_fd_release(spiffs *fs, spiffs_cache_page *cp) { + if (cp == 0) return; + u32_t i; + spiffs_fd *fds = (spiffs_fd *)fs->fd_space; + for (i = 0; i < fs->fd_count; i++) { + spiffs_fd *cur_fd = &fds[i]; + if (cur_fd->file_nbr != 0 && cur_fd->cache_page == cp) { + cur_fd->cache_page = 0; + } + } + spiffs_cache_page_free(fs, cp->ix, 0); + + cp->obj_id = 0; +} + +#endif + +// initializes the cache +void spiffs_cache_init(spiffs *fs) { + if (fs->cache == 0) return; + u32_t sz = fs->cache_size; + u32_t cache_mask = 0; + int i; + int cache_entries = + (sz - sizeof(spiffs_cache)) / (SPIFFS_CACHE_PAGE_SIZE(fs)); + if (cache_entries <= 0) return; + + for (i = 0; i < cache_entries; i++) { + cache_mask <<= 1; + cache_mask |= 1; + } + + spiffs_cache cache; + c_memset(&cache, 0, sizeof(spiffs_cache)); + cache.cpage_count = cache_entries; + cache.cpages = (u8_t *)((u8_t *)fs->cache + sizeof(spiffs_cache)); + + cache.cpage_use_map = 0xffffffff; + cache.cpage_use_mask = cache_mask; + c_memcpy(fs->cache, &cache, sizeof(spiffs_cache)); + + spiffs_cache *c = spiffs_get_cache(fs); + + c_memset(c->cpages, 0, c->cpage_count * SPIFFS_CACHE_PAGE_SIZE(fs)); + + c->cpage_use_map &= ~(c->cpage_use_mask); + for (i = 0; i < cache.cpage_count; i++) { + spiffs_get_cache_page_hdr(fs, c, i)->ix = i; + } +} + +#endif // SPIFFS_CACHE diff --git a/cores/esp8266/spiffs/spiffs_check.c b/cores/esp8266/spiffs/spiffs_check.c new file mode 100755 index 000000000..dbe0e80fe --- /dev/null +++ b/cores/esp8266/spiffs/spiffs_check.c @@ -0,0 +1,973 @@ +/* + * spiffs_check.c + * + * Contains functionality for checking file system consistency + * and mending problems. + * Three levels of consistency checks are implemented: + * + * Look up consistency + * Checks if indices in lookup pages are coherent with page headers + * Object index consistency + * Checks if there are any orphaned object indices (missing object index headers). + * If an object index is found but not its header, the object index is deleted. + * This is critical for the following page consistency check. + * Page consistency + * Checks for pages that ought to be indexed, ought not to be indexed, are multiple indexed + * + * + * Created on: Jul 7, 2013 + * Author: petera + */ + +#include "spiffs.h" +#include "spiffs_nucleus.h" + +//--------------------------------------- +// Look up consistency + +// searches in the object indices and returns the referenced page index given +// the object id and the data span index +// destroys fs->lu_work +static s32_t spiffs_object_get_data_page_index_reference( + spiffs *fs, + spiffs_obj_id obj_id, + spiffs_span_ix data_spix, + spiffs_page_ix *pix, + spiffs_page_ix *objix_pix) { + s32_t res; + + // calculate object index span index for given data page span index + spiffs_span_ix objix_spix = SPIFFS_OBJ_IX_ENTRY_SPAN_IX(fs, data_spix); + + // find obj index for obj id and span index + res = spiffs_obj_lu_find_id_and_span(fs, obj_id | SPIFFS_OBJ_ID_IX_FLAG, objix_spix, 0, objix_pix); + SPIFFS_CHECK_RES(res); + + // load obj index entry + u32_t addr = SPIFFS_PAGE_TO_PADDR(fs, *objix_pix); + if (objix_spix == 0) { + // get referenced page from object index header + addr += sizeof(spiffs_page_object_ix_header) + data_spix * sizeof(spiffs_page_ix); + } else { + // get referenced page from object index + addr += sizeof(spiffs_page_object_ix) + SPIFFS_OBJ_IX_ENTRY(fs, data_spix) * sizeof(spiffs_page_ix); + } + + res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU2 | SPIFFS_OP_C_READ, 0, addr, sizeof(spiffs_page_ix), (u8_t *)pix); + + return res; +} + +// copies page contents to a new page +static s32_t spiffs_rewrite_page(spiffs *fs, spiffs_page_ix cur_pix, spiffs_page_header *p_hdr, spiffs_page_ix *new_pix) { + s32_t res; + res = spiffs_page_allocate_data(fs, p_hdr->obj_id, p_hdr, 0,0,0,0, new_pix); + SPIFFS_CHECK_RES(res); + res = spiffs_phys_cpy(fs, 0, + SPIFFS_PAGE_TO_PADDR(fs, *new_pix) + sizeof(spiffs_page_header), + SPIFFS_PAGE_TO_PADDR(fs, cur_pix) + sizeof(spiffs_page_header), + SPIFFS_DATA_PAGE_SIZE(fs)); + SPIFFS_CHECK_RES(res); + return res; +} + +// rewrites the object index for given object id and replaces the +// data page index to a new page index +static s32_t spiffs_rewrite_index(spiffs *fs, spiffs_obj_id obj_id, spiffs_span_ix data_spix, spiffs_page_ix new_data_pix, spiffs_page_ix objix_pix) { + s32_t res; + spiffs_block_ix bix; + int entry; + spiffs_page_ix free_pix; + obj_id |= SPIFFS_OBJ_ID_IX_FLAG; + + // find free entry + res = spiffs_obj_lu_find_free(fs, fs->free_cursor_block_ix, fs->free_cursor_obj_lu_entry, &bix, &entry); + SPIFFS_CHECK_RES(res); + free_pix = SPIFFS_OBJ_LOOKUP_ENTRY_TO_PIX(fs, bix, entry); + + // calculate object index span index for given data page span index + spiffs_span_ix objix_spix = SPIFFS_OBJ_IX_ENTRY_SPAN_IX(fs, data_spix); + if (objix_spix == 0) { + // calc index in index header + entry = data_spix; + } else { + // calc entry in index + entry = SPIFFS_OBJ_IX_ENTRY(fs, data_spix); + } + // load index + res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU2 | SPIFFS_OP_C_READ, + 0, SPIFFS_PAGE_TO_PADDR(fs, objix_pix), SPIFFS_CFG_LOG_PAGE_SZ(fs), fs->lu_work); + SPIFFS_CHECK_RES(res); + spiffs_page_header *objix_p_hdr = (spiffs_page_header *)fs->lu_work; + + // be ultra safe, double check header against provided data + if (objix_p_hdr->obj_id != obj_id) { + spiffs_page_delete(fs, free_pix); + return SPIFFS_ERR_CHECK_OBJ_ID_MISM; + } + if (objix_p_hdr->span_ix != objix_spix) { + spiffs_page_delete(fs, free_pix); + return SPIFFS_ERR_CHECK_SPIX_MISM; + } + if ((objix_p_hdr->flags & (SPIFFS_PH_FLAG_USED | SPIFFS_PH_FLAG_IXDELE | SPIFFS_PH_FLAG_INDEX | + SPIFFS_PH_FLAG_FINAL | SPIFFS_PH_FLAG_DELET)) != + (SPIFFS_PH_FLAG_IXDELE | SPIFFS_PH_FLAG_DELET)) { + spiffs_page_delete(fs, free_pix); + return SPIFFS_ERR_CHECK_FLAGS_BAD; + } + + // rewrite in mem + if (objix_spix == 0) { + ((spiffs_page_ix*)((u8_t *)fs->lu_work + sizeof(spiffs_page_object_ix_header)))[data_spix] = new_data_pix; + } else { + ((spiffs_page_ix*)((u8_t *)fs->lu_work + sizeof(spiffs_page_object_ix)))[SPIFFS_OBJ_IX_ENTRY(fs, data_spix)] = new_data_pix; + } + + res = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_DA | SPIFFS_OP_C_UPDT, + 0, SPIFFS_PAGE_TO_PADDR(fs, free_pix), SPIFFS_CFG_LOG_PAGE_SZ(fs), fs->lu_work); + SPIFFS_CHECK_RES(res); + res = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_LU | SPIFFS_OP_C_UPDT, + 0, SPIFFS_BLOCK_TO_PADDR(fs, SPIFFS_BLOCK_FOR_PAGE(fs, free_pix)) + SPIFFS_OBJ_LOOKUP_ENTRY_FOR_PAGE(fs, free_pix) * sizeof(spiffs_page_ix), + sizeof(spiffs_obj_id), + (u8_t *)&obj_id); + SPIFFS_CHECK_RES(res); + res = spiffs_page_delete(fs, objix_pix); + + return res; +} + +// deletes an object just by marking object index header as deleted +static s32_t spiffs_delete_obj_lazy(spiffs *fs, spiffs_obj_id obj_id) { + spiffs_page_ix objix_hdr_pix; + s32_t res; + res = spiffs_obj_lu_find_id_and_span(fs, obj_id, 0, 0, &objix_hdr_pix); + if (res == SPIFFS_ERR_NOT_FOUND) { + return SPIFFS_OK; + } + SPIFFS_CHECK_RES(res); + u8_t flags = 0xff & ~SPIFFS_PH_FLAG_IXDELE; + res = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_LU | SPIFFS_OP_C_UPDT, + 0, SPIFFS_PAGE_TO_PADDR(fs, objix_hdr_pix) + offsetof(spiffs_page_header, flags), + sizeof(u8_t), + (u8_t *)&flags); + return res; +} + +// validates the given look up entry +static s32_t spiffs_lookup_check_validate(spiffs *fs, spiffs_obj_id lu_obj_id, spiffs_page_header *p_hdr, + spiffs_page_ix cur_pix, spiffs_block_ix cur_block, int cur_entry, int *reload_lu) { + (void)cur_block; + (void)cur_entry; + u8_t delete_page = 0; + s32_t res = SPIFFS_OK; + spiffs_page_ix objix_pix; + spiffs_page_ix ref_pix; + // check validity, take actions + if (((lu_obj_id == SPIFFS_OBJ_ID_DELETED) && (p_hdr->flags & SPIFFS_PH_FLAG_DELET)) || + ((lu_obj_id == SPIFFS_OBJ_ID_FREE) && (p_hdr->flags & SPIFFS_PH_FLAG_USED) == 0)) { + // look up entry deleted / free but used in page header + SPIFFS_CHECK_DBG("LU: pix %04x deleted/free in lu but not on page\n", cur_pix); + *reload_lu = 1; + delete_page = 1; + if (p_hdr->flags & SPIFFS_PH_FLAG_INDEX) { + // header says data page + // data page can be removed if not referenced by some object index + res = spiffs_object_get_data_page_index_reference(fs, p_hdr->obj_id, p_hdr->span_ix, &ref_pix, &objix_pix); + if (res == SPIFFS_ERR_NOT_FOUND) { + // no object with this id, so remove page safely + res = SPIFFS_OK; + } else { + SPIFFS_CHECK_RES(res); + if (ref_pix == cur_pix) { + // data page referenced by object index but deleted in lu + // copy page to new place and re-write the object index to new place + spiffs_page_ix new_pix; + res = spiffs_rewrite_page(fs, cur_pix, p_hdr, &new_pix); + SPIFFS_CHECK_DBG("LU: FIXUP: data page not found elsewhere, rewriting %04x to new page %04x\n", cur_pix, new_pix); + SPIFFS_CHECK_RES(res); + *reload_lu = 1; + SPIFFS_CHECK_DBG("LU: FIXUP: %04x rewritten to %04x, affected objix_pix %04x\n", cur_pix, new_pix, objix_pix); + res = spiffs_rewrite_index(fs, p_hdr->obj_id, p_hdr->span_ix, new_pix, objix_pix); + if (res <= _SPIFFS_ERR_CHECK_FIRST && res > _SPIFFS_ERR_CHECK_LAST) { + // index bad also, cannot mend this file + SPIFFS_CHECK_DBG("LU: FIXUP: index bad %i, cannot mend!\n", res); + res = spiffs_page_delete(fs, new_pix); + SPIFFS_CHECK_RES(res); + res = spiffs_delete_obj_lazy(fs, p_hdr->obj_id); + if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_LOOKUP, SPIFFS_CHECK_DELETE_BAD_FILE, p_hdr->obj_id, 0); + } else { + if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_LOOKUP, SPIFFS_CHECK_FIX_INDEX, p_hdr->obj_id, p_hdr->span_ix); + } + SPIFFS_CHECK_RES(res); + } + } + } else { + // header says index page + // index page can be removed if other index with same obj_id and spanix is found + res = spiffs_obj_lu_find_id_and_span(fs, p_hdr->obj_id | SPIFFS_OBJ_ID_IX_FLAG, p_hdr->span_ix, cur_pix, 0); + if (res == SPIFFS_ERR_NOT_FOUND) { + // no such index page found, check for a data page amongst page headers + // lu cannot be trusted + res = spiffs_obj_lu_find_id_and_span_by_phdr(fs, p_hdr->obj_id | SPIFFS_OBJ_ID_IX_FLAG, 0, 0, 0); + if (res == SPIFFS_OK) { // ignore other errors + // got a data page also, assume lu corruption only, rewrite to new page + spiffs_page_ix new_pix; + res = spiffs_rewrite_page(fs, cur_pix, p_hdr, &new_pix); + SPIFFS_CHECK_DBG("LU: FIXUP: ix page with data not found elsewhere, rewriting %04x to new page %04x\n", cur_pix, new_pix); + SPIFFS_CHECK_RES(res); + *reload_lu = 1; + if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_LOOKUP, SPIFFS_CHECK_FIX_LOOKUP, p_hdr->obj_id, p_hdr->span_ix); + } + } else { + SPIFFS_CHECK_RES(res); + } + } + } + if (lu_obj_id != SPIFFS_OBJ_ID_FREE && lu_obj_id != SPIFFS_OBJ_ID_DELETED) { + // look up entry used + if ((p_hdr->obj_id | SPIFFS_OBJ_ID_IX_FLAG) != (lu_obj_id | SPIFFS_OBJ_ID_IX_FLAG)) { + SPIFFS_CHECK_DBG("LU: pix %04x differ in obj_id lu:%04x ph:%04x\n", cur_pix, lu_obj_id, p_hdr->obj_id); + delete_page = 1; + if ((p_hdr->flags & SPIFFS_PH_FLAG_DELET) == 0 || + (p_hdr->flags & SPIFFS_PH_FLAG_FINAL) || + (p_hdr->flags & (SPIFFS_PH_FLAG_INDEX | SPIFFS_PH_FLAG_IXDELE)) == 0) { + // page deleted or not finalized, just remove it + } else { + if (p_hdr->flags & SPIFFS_PH_FLAG_INDEX) { + // if data page, check for reference to this page + res = spiffs_object_get_data_page_index_reference(fs, p_hdr->obj_id, p_hdr->span_ix, &ref_pix, &objix_pix); + if (res == SPIFFS_ERR_NOT_FOUND) { + // no object with this id, so remove page safely + res = SPIFFS_OK; + } else { + SPIFFS_CHECK_RES(res); + // if found, rewrite page with object id, update index, and delete current + if (ref_pix == cur_pix) { + spiffs_page_ix new_pix; + res = spiffs_rewrite_page(fs, cur_pix, p_hdr, &new_pix); + SPIFFS_CHECK_RES(res); + res = spiffs_rewrite_index(fs, p_hdr->obj_id, p_hdr->span_ix, new_pix, objix_pix); + if (res <= _SPIFFS_ERR_CHECK_FIRST && res > _SPIFFS_ERR_CHECK_LAST) { + // index bad also, cannot mend this file + SPIFFS_CHECK_DBG("LU: FIXUP: index bad %i, cannot mend!\n", res); + res = spiffs_page_delete(fs, new_pix); + SPIFFS_CHECK_RES(res); + res = spiffs_delete_obj_lazy(fs, p_hdr->obj_id); + *reload_lu = 1; + if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_LOOKUP, SPIFFS_CHECK_DELETE_BAD_FILE, p_hdr->obj_id, 0); + } + SPIFFS_CHECK_RES(res); + } + } + } else { + // else if index, check for other pages with both obj_id's and spanix + spiffs_page_ix objix_pix_lu, objix_pix_ph; + // see if other object index page exists for lookup obj id and span index + res = spiffs_obj_lu_find_id_and_span(fs, lu_obj_id | SPIFFS_OBJ_ID_IX_FLAG, p_hdr->span_ix, 0, &objix_pix_lu); + if (res == SPIFFS_ERR_NOT_FOUND) { + res = SPIFFS_OK; + objix_pix_lu = 0; + } + SPIFFS_CHECK_RES(res); + // see if other object index exists for page header obj id and span index + res = spiffs_obj_lu_find_id_and_span(fs, p_hdr->obj_id | SPIFFS_OBJ_ID_IX_FLAG, p_hdr->span_ix, 0, &objix_pix_ph); + if (res == SPIFFS_ERR_NOT_FOUND) { + res = SPIFFS_OK; + objix_pix_ph = 0; + } + SPIFFS_CHECK_RES(res); + // if both obj_id's found, just delete current + if (objix_pix_ph == 0 || objix_pix_lu == 0) { + // otherwise try finding first corresponding data pages + spiffs_page_ix data_pix_lu, data_pix_ph; + // see if other data page exists for look up obj id and span index + res = spiffs_obj_lu_find_id_and_span(fs, lu_obj_id & ~SPIFFS_OBJ_ID_IX_FLAG, 0, 0, &data_pix_lu); + if (res == SPIFFS_ERR_NOT_FOUND) { + res = SPIFFS_OK; + objix_pix_lu = 0; + } + SPIFFS_CHECK_RES(res); + // see if other data page exists for page header obj id and span index + res = spiffs_obj_lu_find_id_and_span(fs, p_hdr->obj_id & ~SPIFFS_OBJ_ID_IX_FLAG, 0, 0, &data_pix_ph); + if (res == SPIFFS_ERR_NOT_FOUND) { + res = SPIFFS_OK; + objix_pix_ph = 0; + } + SPIFFS_CHECK_RES(res); + + spiffs_page_header new_ph; + new_ph.flags = 0xff & ~(SPIFFS_PH_FLAG_USED | SPIFFS_PH_FLAG_INDEX | SPIFFS_PH_FLAG_FINAL); + new_ph.span_ix = p_hdr->span_ix; + spiffs_page_ix new_pix; + if ((objix_pix_lu && data_pix_lu && data_pix_ph && objix_pix_ph == 0) || + (objix_pix_lu == 0 && data_pix_ph && objix_pix_ph == 0)) { + // got a data page for page header obj id + // rewrite as obj_id_ph + new_ph.obj_id = p_hdr->obj_id | SPIFFS_OBJ_ID_IX_FLAG; + res = spiffs_rewrite_page(fs, cur_pix, &new_ph, &new_pix); + SPIFFS_CHECK_DBG("LU: FIXUP: rewrite page %04x as %04x to pix %04x\n", cur_pix, new_ph.obj_id, new_pix); + if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_LOOKUP, SPIFFS_CHECK_FIX_LOOKUP, p_hdr->obj_id, p_hdr->span_ix); + SPIFFS_CHECK_RES(res); + *reload_lu = 1; + } else if ((objix_pix_ph && data_pix_ph && data_pix_lu && objix_pix_lu == 0) || + (objix_pix_ph == 0 && data_pix_lu && objix_pix_lu == 0)) { + // got a data page for look up obj id + // rewrite as obj_id_lu + new_ph.obj_id = lu_obj_id | SPIFFS_OBJ_ID_IX_FLAG; + SPIFFS_CHECK_DBG("LU: FIXUP: rewrite page %04x as %04x\n", cur_pix, new_ph.obj_id); + if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_LOOKUP, SPIFFS_CHECK_FIX_LOOKUP, p_hdr->obj_id, p_hdr->span_ix); + res = spiffs_rewrite_page(fs, cur_pix, &new_ph, &new_pix); + SPIFFS_CHECK_RES(res); + *reload_lu = 1; + } else { + // cannot safely do anything + SPIFFS_CHECK_DBG("LU: FIXUP: nothing to do, just delete\n"); + } + } + } + } + } else if (((lu_obj_id & SPIFFS_OBJ_ID_IX_FLAG) && (p_hdr->flags & SPIFFS_PH_FLAG_INDEX)) || + ((lu_obj_id & SPIFFS_OBJ_ID_IX_FLAG) == 0 && (p_hdr->flags & SPIFFS_PH_FLAG_INDEX) == 0)) { + SPIFFS_CHECK_DBG("LU: %04x lu/page index marking differ\n", cur_pix); + spiffs_page_ix data_pix, objix_pix_d; + // see if other data page exists for given obj id and span index + res = spiffs_obj_lu_find_id_and_span(fs, lu_obj_id & ~SPIFFS_OBJ_ID_IX_FLAG, p_hdr->span_ix, cur_pix, &data_pix); + if (res == SPIFFS_ERR_NOT_FOUND) { + res = SPIFFS_OK; + data_pix = 0; + } + SPIFFS_CHECK_RES(res); + // see if other object index exists for given obj id and span index + res = spiffs_obj_lu_find_id_and_span(fs, lu_obj_id | SPIFFS_OBJ_ID_IX_FLAG, p_hdr->span_ix, cur_pix, &objix_pix_d); + if (res == SPIFFS_ERR_NOT_FOUND) { + res = SPIFFS_OK; + objix_pix_d = 0; + } + SPIFFS_CHECK_RES(res); + + delete_page = 1; + // if other data page exists and object index exists, just delete page + if (data_pix && objix_pix_d) { + SPIFFS_CHECK_DBG("LU: FIXUP: other index and data page exists, simply remove\n"); + } else + // if only data page exists, make this page index + if (data_pix && objix_pix_d == 0) { + SPIFFS_CHECK_DBG("LU: FIXUP: other data page exists, make this index\n"); + if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_LOOKUP, SPIFFS_CHECK_FIX_INDEX, lu_obj_id, p_hdr->span_ix); + spiffs_page_header new_ph; + spiffs_page_ix new_pix; + new_ph.flags = 0xff & ~(SPIFFS_PH_FLAG_USED | SPIFFS_PH_FLAG_FINAL | SPIFFS_PH_FLAG_INDEX); + new_ph.obj_id = lu_obj_id | SPIFFS_OBJ_ID_IX_FLAG; + new_ph.span_ix = p_hdr->span_ix; + res = spiffs_page_allocate_data(fs, new_ph.obj_id, &new_ph, 0, 0, 0, 1, &new_pix); + SPIFFS_CHECK_RES(res); + res = spiffs_phys_cpy(fs, 0, SPIFFS_PAGE_TO_PADDR(fs, new_pix) + sizeof(spiffs_page_header), + SPIFFS_PAGE_TO_PADDR(fs, cur_pix) + sizeof(spiffs_page_header), + SPIFFS_CFG_LOG_PAGE_SZ(fs) - sizeof(spiffs_page_header)); + SPIFFS_CHECK_RES(res); + } else + // if only index exists, make data page + if (data_pix == 0 && objix_pix_d) { + SPIFFS_CHECK_DBG("LU: FIXUP: other index page exists, make this data\n"); + if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_LOOKUP, SPIFFS_CHECK_FIX_LOOKUP, lu_obj_id, p_hdr->span_ix); + spiffs_page_header new_ph; + spiffs_page_ix new_pix; + new_ph.flags = 0xff & ~(SPIFFS_PH_FLAG_USED | SPIFFS_PH_FLAG_FINAL); + new_ph.obj_id = lu_obj_id & ~SPIFFS_OBJ_ID_IX_FLAG; + new_ph.span_ix = p_hdr->span_ix; + res = spiffs_page_allocate_data(fs, new_ph.obj_id, &new_ph, 0, 0, 0, 1, &new_pix); + SPIFFS_CHECK_RES(res); + res = spiffs_phys_cpy(fs, 0, SPIFFS_PAGE_TO_PADDR(fs, new_pix) + sizeof(spiffs_page_header), + SPIFFS_PAGE_TO_PADDR(fs, cur_pix) + sizeof(spiffs_page_header), + SPIFFS_CFG_LOG_PAGE_SZ(fs) - sizeof(spiffs_page_header)); + SPIFFS_CHECK_RES(res); + } else { + // if nothing exists, we cannot safely make a decision - delete + } + } + else if ((p_hdr->flags & SPIFFS_PH_FLAG_DELET) == 0) { + SPIFFS_CHECK_DBG("LU: pix %04x busy in lu but deleted on page\n", cur_pix); + delete_page = 1; + } else if ((p_hdr->flags & SPIFFS_PH_FLAG_FINAL)) { + SPIFFS_CHECK_DBG("LU: pix %04x busy but not final\n", cur_pix); + // page can be removed if not referenced by object index + *reload_lu = 1; + res = spiffs_object_get_data_page_index_reference(fs, lu_obj_id, p_hdr->span_ix, &ref_pix, &objix_pix); + if (res == SPIFFS_ERR_NOT_FOUND) { + // no object with this id, so remove page safely + res = SPIFFS_OK; + delete_page = 1; + } else { + SPIFFS_CHECK_RES(res); + if (ref_pix != cur_pix) { + SPIFFS_CHECK_DBG("LU: FIXUP: other finalized page is referred, just delete\n"); + delete_page = 1; + } else { + // page referenced by object index but not final + // just finalize + SPIFFS_CHECK_DBG("LU: FIXUP: unfinalized page is referred, finalizing\n"); + if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_LOOKUP, SPIFFS_CHECK_FIX_LOOKUP, p_hdr->obj_id, p_hdr->span_ix); + u8_t flags = 0xff & ~SPIFFS_PH_FLAG_FINAL; + res = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_DA | SPIFFS_OP_C_UPDT, + 0, SPIFFS_PAGE_TO_PADDR(fs, cur_pix) + offsetof(spiffs_page_header, flags), + sizeof(u8_t), (u8_t*)&flags); + } + } + } + } + + if (delete_page) { + SPIFFS_CHECK_DBG("LU: FIXUP: deleting page %04x\n", cur_pix); + if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_LOOKUP, SPIFFS_CHECK_DELETE_PAGE, cur_pix, 0); + res = spiffs_page_delete(fs, cur_pix); + SPIFFS_CHECK_RES(res); + } + + return res; +} + +static s32_t spiffs_lookup_check_v(spiffs *fs, spiffs_obj_id obj_id, spiffs_block_ix cur_block, int cur_entry, + u32_t user_data, void *user_p) { + (void)user_data; + (void)user_p; + s32_t res = SPIFFS_OK; + spiffs_page_header p_hdr; + spiffs_page_ix cur_pix = SPIFFS_OBJ_LOOKUP_ENTRY_TO_PIX(fs, cur_block, cur_entry); + + if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_LOOKUP, SPIFFS_CHECK_PROGRESS, + (cur_block * 256)/fs->block_count, 0); + + // load header + res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU2 | SPIFFS_OP_C_READ, + 0, SPIFFS_PAGE_TO_PADDR(fs, cur_pix), sizeof(spiffs_page_header), (u8_t*)&p_hdr); + SPIFFS_CHECK_RES(res); + + int reload_lu = 0; + + res = spiffs_lookup_check_validate(fs, obj_id, &p_hdr, cur_pix, cur_block, cur_entry, &reload_lu); + SPIFFS_CHECK_RES(res); + + if (res == SPIFFS_OK) { + return reload_lu ? SPIFFS_VIS_COUNTINUE_RELOAD : SPIFFS_VIS_COUNTINUE; + } + return res; +} + + +// Scans all object look up. For each entry, corresponding page header is checked for validity. +// If an object index header page is found, this is also checked +s32_t spiffs_lookup_consistency_check(spiffs *fs, u8_t check_all_objects) { + (void)check_all_objects; + s32_t res = SPIFFS_OK; + + if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_LOOKUP, SPIFFS_CHECK_PROGRESS, 0, 0); + + res = spiffs_obj_lu_find_entry_visitor(fs, 0, 0, 0, 0, spiffs_lookup_check_v, 0, 0, 0, 0); + + if (res == SPIFFS_VIS_END) { + res = SPIFFS_OK; + } + + if (res != SPIFFS_OK) { + if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_LOOKUP, SPIFFS_CHECK_ERROR, res, 0); + } + + if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_LOOKUP, SPIFFS_CHECK_PROGRESS, 256, 0); + + return res; +} + +//--------------------------------------- +// Page consistency + +// Scans all pages (except lu pages), reserves 4 bits in working memory for each page +// bit 0: 0 == FREE|DELETED, 1 == USED +// bit 1: 0 == UNREFERENCED, 1 == REFERENCED +// bit 2: 0 == NOT_INDEX, 1 == INDEX +// bit 3: unused +// A consistent file system will have only pages being +// * x000 free, unreferenced, not index +// * x011 used, referenced only once, not index +// * x101 used, unreferenced, index +// The working memory might not fit all pages so several scans might be needed +static s32_t spiffs_page_consistency_check_i(spiffs *fs) { + const u32_t bits = 4; + const spiffs_page_ix pages_per_scan = SPIFFS_CFG_LOG_PAGE_SZ(fs) * 8 / bits; + + s32_t res = SPIFFS_OK; + spiffs_page_ix pix_offset = 0; + + // for each range of pages fitting into work memory + while (pix_offset < SPIFFS_PAGES_PER_BLOCK(fs) * fs->block_count) { + // set this flag to abort all checks and rescan the page range + u8_t restart = 0; + c_memset(fs->work, 0, SPIFFS_CFG_LOG_PAGE_SZ(fs)); + + spiffs_block_ix cur_block = 0; + // build consistency bitmap for id range traversing all blocks + while (!restart && cur_block < fs->block_count) { + if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_PAGE, SPIFFS_CHECK_PROGRESS, + (pix_offset*256)/(SPIFFS_PAGES_PER_BLOCK(fs) * fs->block_count) + + ((((cur_block * pages_per_scan * 256)/ (SPIFFS_PAGES_PER_BLOCK(fs) * fs->block_count))) / fs->block_count), + 0); + + // traverse each page except for lookup pages + spiffs_page_ix cur_pix = SPIFFS_OBJ_LOOKUP_PAGES(fs) + SPIFFS_PAGES_PER_BLOCK(fs) * cur_block; + while (!restart && cur_pix < SPIFFS_PAGES_PER_BLOCK(fs) * (cur_block+1)) { + // read header + spiffs_page_header p_hdr; + res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU2 | SPIFFS_OP_C_READ, + 0, SPIFFS_PAGE_TO_PADDR(fs, cur_pix), sizeof(spiffs_page_header), (u8_t*)&p_hdr); + SPIFFS_CHECK_RES(res); + + u8_t within_range = (cur_pix >= pix_offset && cur_pix < pix_offset + pages_per_scan); + const u32_t pix_byte_ix = (cur_pix - pix_offset) / (8/bits); + const u8_t pix_bit_ix = (cur_pix & ((8/bits)-1)) * bits; + + if (within_range && + (p_hdr.flags & SPIFFS_PH_FLAG_DELET) && (p_hdr.flags & SPIFFS_PH_FLAG_USED) == 0) { + // used + fs->work[pix_byte_ix] |= (1<<(pix_bit_ix + 0)); + } + if ((p_hdr.flags & SPIFFS_PH_FLAG_DELET) && + (p_hdr.flags & SPIFFS_PH_FLAG_IXDELE) && + (p_hdr.flags & (SPIFFS_PH_FLAG_INDEX | SPIFFS_PH_FLAG_USED)) == 0) { + // found non-deleted index + if (within_range) { + fs->work[pix_byte_ix] |= (1<<(pix_bit_ix + 2)); + } + + // load non-deleted index + res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU2 | SPIFFS_OP_C_READ, + 0, SPIFFS_PAGE_TO_PADDR(fs, cur_pix), SPIFFS_CFG_LOG_PAGE_SZ(fs), fs->lu_work); + SPIFFS_CHECK_RES(res); + + // traverse index for referenced pages + spiffs_page_ix *object_page_index; + spiffs_page_header *objix_p_hdr = (spiffs_page_header *)fs->lu_work; + + int entries; + int i; + spiffs_span_ix data_spix_offset; + if (p_hdr.span_ix == 0) { + // object header page index + entries = SPIFFS_OBJ_HDR_IX_LEN(fs); + data_spix_offset = 0; + object_page_index = (spiffs_page_ix *)((u8_t *)fs->lu_work + sizeof(spiffs_page_object_ix_header)); + } else { + // object page index + entries = SPIFFS_OBJ_IX_LEN(fs); + data_spix_offset = SPIFFS_OBJ_HDR_IX_LEN(fs) + SPIFFS_OBJ_IX_LEN(fs) * (p_hdr.span_ix - 1); + object_page_index = (spiffs_page_ix *)((u8_t *)fs->lu_work + sizeof(spiffs_page_object_ix)); + } + + // for all entries in index + for (i = 0; !restart && i < entries; i++) { + spiffs_page_ix rpix = object_page_index[i]; + u8_t rpix_within_range = rpix >= pix_offset && rpix < pix_offset + pages_per_scan; + + if ((rpix != (spiffs_page_ix)-1 && rpix > SPIFFS_MAX_PAGES(fs)) + || (rpix_within_range && SPIFFS_IS_LOOKUP_PAGE(fs, rpix))) { + + // bad reference + SPIFFS_CHECK_DBG("PA: pix %04x bad pix / LU referenced from page %04x\n", + rpix, cur_pix); + // check for data page elsewhere + spiffs_page_ix data_pix; + res = spiffs_obj_lu_find_id_and_span(fs, objix_p_hdr->obj_id & ~SPIFFS_OBJ_ID_IX_FLAG, + data_spix_offset + i, 0, &data_pix); + if (res == SPIFFS_ERR_NOT_FOUND) { + res = SPIFFS_OK; + data_pix = 0; + } + SPIFFS_CHECK_RES(res); + if (data_pix == 0) { + // if not, allocate free page + spiffs_page_header new_ph; + new_ph.flags = 0xff & ~(SPIFFS_PH_FLAG_USED | SPIFFS_PH_FLAG_FINAL); + new_ph.obj_id = objix_p_hdr->obj_id & ~SPIFFS_OBJ_ID_IX_FLAG; + new_ph.span_ix = data_spix_offset + i; + res = spiffs_page_allocate_data(fs, new_ph.obj_id, &new_ph, 0, 0, 0, 1, &data_pix); + SPIFFS_CHECK_RES(res); + SPIFFS_CHECK_DBG("PA: FIXUP: found no existing data page, created new @ %04x\n", data_pix); + } + // remap index + SPIFFS_CHECK_DBG("PA: FIXUP: rewriting index pix %04x\n", cur_pix); + res = spiffs_rewrite_index(fs, objix_p_hdr->obj_id | SPIFFS_OBJ_ID_IX_FLAG, + data_spix_offset + i, data_pix, cur_pix); + if (res <= _SPIFFS_ERR_CHECK_FIRST && res > _SPIFFS_ERR_CHECK_LAST) { + // index bad also, cannot mend this file + SPIFFS_CHECK_DBG("PA: FIXUP: index bad %i, cannot mend - delete object\n", res); + if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_PAGE, SPIFFS_CHECK_DELETE_BAD_FILE, objix_p_hdr->obj_id, 0); + // delete file + res = spiffs_page_delete(fs, cur_pix); + } else { + if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_PAGE, SPIFFS_CHECK_FIX_INDEX, objix_p_hdr->obj_id, objix_p_hdr->span_ix); + } + SPIFFS_CHECK_RES(res); + restart = 1; + + } else if (rpix_within_range) { + + // valid reference + // read referenced page header + spiffs_page_header rp_hdr; + res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU2 | SPIFFS_OP_C_READ, + 0, SPIFFS_PAGE_TO_PADDR(fs, rpix), sizeof(spiffs_page_header), (u8_t*)&rp_hdr); + SPIFFS_CHECK_RES(res); + + // cross reference page header check + if (rp_hdr.obj_id != (p_hdr.obj_id & ~SPIFFS_OBJ_ID_IX_FLAG) || + rp_hdr.span_ix != data_spix_offset + i || + (rp_hdr.flags & (SPIFFS_PH_FLAG_DELET | SPIFFS_PH_FLAG_INDEX | SPIFFS_PH_FLAG_USED)) != + (SPIFFS_PH_FLAG_DELET | SPIFFS_PH_FLAG_INDEX)) { + SPIFFS_CHECK_DBG("PA: pix %04x has inconsistent page header ix id/span:%04x/%04x, ref id/span:%04x/%04x flags:%02x\n", + rpix, p_hdr.obj_id & ~SPIFFS_OBJ_ID_IX_FLAG, data_spix_offset + i, + rp_hdr.obj_id, rp_hdr.span_ix, rp_hdr.flags); + // try finding correct page + spiffs_page_ix data_pix; + res = spiffs_obj_lu_find_id_and_span(fs, p_hdr.obj_id & ~SPIFFS_OBJ_ID_IX_FLAG, + data_spix_offset + i, rpix, &data_pix); + if (res == SPIFFS_ERR_NOT_FOUND) { + res = SPIFFS_OK; + data_pix = 0; + } + SPIFFS_CHECK_RES(res); + if (data_pix == 0) { + // not found, this index is badly borked + SPIFFS_CHECK_DBG("PA: FIXUP: index bad, delete object id %04x\n", p_hdr.obj_id); + if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_PAGE, SPIFFS_CHECK_DELETE_BAD_FILE, p_hdr.obj_id, 0); + res = spiffs_delete_obj_lazy(fs, p_hdr.obj_id); + SPIFFS_CHECK_RES(res); + break; + } else { + // found it, so rewrite index + SPIFFS_CHECK_DBG("PA: FIXUP: found correct data pix %04x, rewrite ix pix %04x id %04x\n", + data_pix, cur_pix, p_hdr.obj_id); + res = spiffs_rewrite_index(fs, p_hdr.obj_id, data_spix_offset + i, data_pix, cur_pix); + if (res <= _SPIFFS_ERR_CHECK_FIRST && res > _SPIFFS_ERR_CHECK_LAST) { + // index bad also, cannot mend this file + SPIFFS_CHECK_DBG("PA: FIXUP: index bad %i, cannot mend!\n", res); + if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_PAGE, SPIFFS_CHECK_DELETE_BAD_FILE, p_hdr.obj_id, 0); + res = spiffs_delete_obj_lazy(fs, p_hdr.obj_id); + } else { + if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_PAGE, SPIFFS_CHECK_FIX_INDEX, p_hdr.obj_id, p_hdr.span_ix); + } + SPIFFS_CHECK_RES(res); + restart = 1; + } + } + else { + // mark rpix as referenced + const u32_t rpix_byte_ix = (rpix - pix_offset) / (8/bits); + const u8_t rpix_bit_ix = (rpix & ((8/bits)-1)) * bits; + if (fs->work[rpix_byte_ix] & (1<<(rpix_bit_ix + 1))) { + SPIFFS_CHECK_DBG("PA: pix %04x multiple referenced from page %04x\n", + rpix, cur_pix); + // Here, we should have fixed all broken references - getting this means there + // must be multiple files with same object id. Only solution is to delete + // the object which is referring to this page + SPIFFS_CHECK_DBG("PA: FIXUP: removing object %04x and page %04x\n", + p_hdr.obj_id, cur_pix); + if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_PAGE, SPIFFS_CHECK_DELETE_BAD_FILE, p_hdr.obj_id, 0); + res = spiffs_delete_obj_lazy(fs, p_hdr.obj_id); + SPIFFS_CHECK_RES(res); + // extra precaution, delete this page also + res = spiffs_page_delete(fs, cur_pix); + SPIFFS_CHECK_RES(res); + restart = 1; + } + fs->work[rpix_byte_ix] |= (1<<(rpix_bit_ix + 1)); + } + } + } // for all index entries + } // found index + + // next page + cur_pix++; + } + // next block + cur_block++; + } + // check consistency bitmap + if (!restart) { + spiffs_page_ix objix_pix; + spiffs_page_ix rpix; + + u32_t byte_ix; + u8_t bit_ix; + for (byte_ix = 0; !restart && byte_ix < SPIFFS_CFG_LOG_PAGE_SZ(fs); byte_ix++) { + for (bit_ix = 0; !restart && bit_ix < 8/bits; bit_ix ++) { + u8_t bitmask = (fs->work[byte_ix] >> (bit_ix * bits)) & 0x7; + spiffs_page_ix cur_pix = pix_offset + byte_ix * (8/bits) + bit_ix; + + // 000 ok - free, unreferenced, not index + + if (bitmask == 0x1) { + + // 001 + SPIFFS_CHECK_DBG("PA: pix %04x USED, UNREFERENCED, not index\n", cur_pix); + + u8_t rewrite_ix_to_this = 0; + u8_t delete_page = 0; + // check corresponding object index entry + spiffs_page_header p_hdr; + res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU2 | SPIFFS_OP_C_READ, + 0, SPIFFS_PAGE_TO_PADDR(fs, cur_pix), sizeof(spiffs_page_header), (u8_t*)&p_hdr); + SPIFFS_CHECK_RES(res); + + res = spiffs_object_get_data_page_index_reference(fs, p_hdr.obj_id, p_hdr.span_ix, + &rpix, &objix_pix); + if (res == SPIFFS_OK) { + if (((rpix == (spiffs_page_ix)-1 || rpix > SPIFFS_MAX_PAGES(fs)) || (SPIFFS_IS_LOOKUP_PAGE(fs, rpix)))) { + // pointing to a bad page altogether, rewrite index to this + rewrite_ix_to_this = 1; + SPIFFS_CHECK_DBG("PA: corresponding ref is bad: %04x, rewrite to this %04x\n", rpix, cur_pix); + } else { + // pointing to something else, check what + spiffs_page_header rp_hdr; + res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU2 | SPIFFS_OP_C_READ, + 0, SPIFFS_PAGE_TO_PADDR(fs, rpix), sizeof(spiffs_page_header), (u8_t*)&rp_hdr); + SPIFFS_CHECK_RES(res); + if (((p_hdr.obj_id & ~SPIFFS_OBJ_ID_IX_FLAG) == rp_hdr.obj_id) && + ((rp_hdr.flags & (SPIFFS_PH_FLAG_INDEX | SPIFFS_PH_FLAG_DELET | SPIFFS_PH_FLAG_USED | SPIFFS_PH_FLAG_FINAL)) == + (SPIFFS_PH_FLAG_INDEX | SPIFFS_PH_FLAG_DELET))) { + // pointing to something else valid, just delete this page then + SPIFFS_CHECK_DBG("PA: corresponding ref is good but different: %04x, delete this %04x\n", rpix, cur_pix); + delete_page = 1; + } else { + // pointing to something weird, update index to point to this page instead + if (rpix != cur_pix) { + SPIFFS_CHECK_DBG("PA: corresponding ref is weird: %04x %s%s%s%s, rewrite this %04x\n", rpix, + (rp_hdr.flags & SPIFFS_PH_FLAG_INDEX) ? "" : "INDEX ", + (rp_hdr.flags & SPIFFS_PH_FLAG_DELET) ? "" : "DELETED ", + (rp_hdr.flags & SPIFFS_PH_FLAG_USED) ? "NOTUSED " : "", + (rp_hdr.flags & SPIFFS_PH_FLAG_FINAL) ? "NOTFINAL " : "", + cur_pix); + rewrite_ix_to_this = 1; + } else { + // should not happen, destined for fubar + } + } + } + } else if (res == SPIFFS_ERR_NOT_FOUND) { + SPIFFS_CHECK_DBG("PA: corresponding ref not found, delete %04x\n", cur_pix); + delete_page = 1; + res = SPIFFS_OK; + } + + if (rewrite_ix_to_this) { + // if pointing to invalid page, redirect index to this page + SPIFFS_CHECK_DBG("PA: FIXUP: rewrite index id %04x data spix %04x to point to this pix: %04x\n", + p_hdr.obj_id, p_hdr.span_ix, cur_pix); + res = spiffs_rewrite_index(fs, p_hdr.obj_id, p_hdr.span_ix, cur_pix, objix_pix); + if (res <= _SPIFFS_ERR_CHECK_FIRST && res > _SPIFFS_ERR_CHECK_LAST) { + // index bad also, cannot mend this file + SPIFFS_CHECK_DBG("PA: FIXUP: index bad %i, cannot mend!\n", res); + if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_PAGE, SPIFFS_CHECK_DELETE_BAD_FILE, p_hdr.obj_id, 0); + res = spiffs_page_delete(fs, cur_pix); + SPIFFS_CHECK_RES(res); + res = spiffs_delete_obj_lazy(fs, p_hdr.obj_id); + } else { + if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_PAGE, SPIFFS_CHECK_FIX_INDEX, p_hdr.obj_id, p_hdr.span_ix); + } + SPIFFS_CHECK_RES(res); + restart = 1; + continue; + } else if (delete_page) { + SPIFFS_CHECK_DBG("PA: FIXUP: deleting page %04x\n", cur_pix); + if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_PAGE, SPIFFS_CHECK_DELETE_PAGE, cur_pix, 0); + res = spiffs_page_delete(fs, cur_pix); + } + SPIFFS_CHECK_RES(res); + } + if (bitmask == 0x2) { + + // 010 + SPIFFS_CHECK_DBG("PA: pix %04x FREE, REFERENCED, not index\n", cur_pix); + + // no op, this should be taken care of when checking valid references + } + + // 011 ok - busy, referenced, not index + + if (bitmask == 0x4) { + + // 100 + SPIFFS_CHECK_DBG("PA: pix %04x FREE, unreferenced, INDEX\n", cur_pix); + + // this should never happen, major fubar + } + + // 101 ok - busy, unreferenced, index + + if (bitmask == 0x6) { + + // 110 + SPIFFS_CHECK_DBG("PA: pix %04x FREE, REFERENCED, INDEX\n", cur_pix); + + // no op, this should be taken care of when checking valid references + } + if (bitmask == 0x7) { + + // 111 + SPIFFS_CHECK_DBG("PA: pix %04x USED, REFERENCED, INDEX\n", cur_pix); + + // no op, this should be taken care of when checking valid references + } + } + } + } + // next page range + if (!restart) { + pix_offset += pages_per_scan; + } + } // while page range not reached end + return res; +} + +// Checks consistency amongst all pages and fixes irregularities +s32_t spiffs_page_consistency_check(spiffs *fs) { + if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_PAGE, SPIFFS_CHECK_PROGRESS, 0, 0); + s32_t res = spiffs_page_consistency_check_i(fs); + if (res != SPIFFS_OK) { + if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_PAGE, SPIFFS_CHECK_ERROR, res, 0); + } + if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_PAGE, SPIFFS_CHECK_PROGRESS, 256, 0); + return res; +} + +//--------------------------------------- +// Object index consistency + +// searches for given object id in temporary object id index, +// returns the index or -1 +static int spiffs_object_index_search(spiffs *fs, spiffs_obj_id obj_id) { + u32_t i; + spiffs_obj_id *obj_table = (spiffs_obj_id *)fs->work; + obj_id &= ~SPIFFS_OBJ_ID_IX_FLAG; + for (i = 0; i < SPIFFS_CFG_LOG_PAGE_SZ(fs) / sizeof(spiffs_obj_id); i++) { + if ((obj_table[i] & ~SPIFFS_OBJ_ID_IX_FLAG) == obj_id) { + return i; + } + } + return -1; +} + +static s32_t spiffs_object_index_consistency_check_v(spiffs *fs, spiffs_obj_id obj_id, spiffs_block_ix cur_block, + int cur_entry, u32_t user_data, void *user_p) { + (void)user_data; + s32_t res_c = SPIFFS_VIS_COUNTINUE; + s32_t res = SPIFFS_OK; + u32_t *log_ix = (u32_t *)user_p; + spiffs_obj_id *obj_table = (spiffs_obj_id *)fs->work; + + if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_INDEX, SPIFFS_CHECK_PROGRESS, + (cur_block * 256)/fs->block_count, 0); + + if (obj_id != SPIFFS_OBJ_ID_FREE && obj_id != SPIFFS_OBJ_ID_DELETED && (obj_id & SPIFFS_OBJ_ID_IX_FLAG)) { + spiffs_page_header p_hdr; + spiffs_page_ix cur_pix = SPIFFS_OBJ_LOOKUP_ENTRY_TO_PIX(fs, cur_block, cur_entry); + + // load header + res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU2 | SPIFFS_OP_C_READ, + 0, SPIFFS_PAGE_TO_PADDR(fs, cur_pix), sizeof(spiffs_page_header), (u8_t*)&p_hdr); + SPIFFS_CHECK_RES(res); + + if (p_hdr.span_ix == 0 && + (p_hdr.flags & (SPIFFS_PH_FLAG_INDEX | SPIFFS_PH_FLAG_FINAL | SPIFFS_PH_FLAG_DELET | SPIFFS_PH_FLAG_IXDELE)) == + (SPIFFS_PH_FLAG_DELET)) { + SPIFFS_CHECK_DBG("IX: pix %04x, obj id:%04x spix:%04x header not fully deleted - deleting\n", + cur_pix, obj_id, p_hdr.span_ix); + if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_INDEX, SPIFFS_CHECK_DELETE_PAGE, cur_pix, obj_id); + res = spiffs_page_delete(fs, cur_pix); + SPIFFS_CHECK_RES(res); + return res_c; + } + + if ((p_hdr.flags & (SPIFFS_PH_FLAG_INDEX | SPIFFS_PH_FLAG_FINAL | SPIFFS_PH_FLAG_DELET | SPIFFS_PH_FLAG_IXDELE)) == + (SPIFFS_PH_FLAG_DELET | SPIFFS_PH_FLAG_IXDELE)) { + return res_c; + } + + if (p_hdr.span_ix == 0) { + // objix header page, register objid as reachable + int r = spiffs_object_index_search(fs, obj_id); + if (r == -1) { + // not registered, do it + obj_table[*log_ix] = obj_id & ~SPIFFS_OBJ_ID_IX_FLAG; + (*log_ix)++; + if (*log_ix >= SPIFFS_CFG_LOG_PAGE_SZ(fs) / sizeof(spiffs_obj_id)) { + *log_ix = 0; + } + } + } else { // span index + // objix page, see if header can be found + int r = spiffs_object_index_search(fs, obj_id); + u8_t delete = 0; + if (r == -1) { + // not in temporary index, try finding it + spiffs_page_ix objix_hdr_pix; + res = spiffs_obj_lu_find_id_and_span(fs, obj_id | SPIFFS_OBJ_ID_IX_FLAG, 0, 0, &objix_hdr_pix); + res_c = SPIFFS_VIS_COUNTINUE_RELOAD; + if (res == SPIFFS_OK) { + // found, register as reachable + obj_table[*log_ix] = obj_id & ~SPIFFS_OBJ_ID_IX_FLAG; + } else if (res == SPIFFS_ERR_NOT_FOUND) { + // not found, register as unreachable + delete = 1; + obj_table[*log_ix] = obj_id | SPIFFS_OBJ_ID_IX_FLAG; + } else { + SPIFFS_CHECK_RES(res); + } + (*log_ix)++; + if (*log_ix >= SPIFFS_CFG_LOG_PAGE_SZ(fs) / sizeof(spiffs_obj_id)) { + *log_ix = 0; + } + } else { + // in temporary index, check reachable flag + if ((obj_table[r] & SPIFFS_OBJ_ID_IX_FLAG)) { + // registered as unreachable + delete = 1; + } + } + + if (delete) { + SPIFFS_CHECK_DBG("IX: FIXUP: pix %04x, obj id:%04x spix:%04x is orphan index - deleting\n", + cur_pix, obj_id, p_hdr.span_ix); + if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_INDEX, SPIFFS_CHECK_DELETE_ORPHANED_INDEX, cur_pix, obj_id); + res = spiffs_page_delete(fs, cur_pix); + SPIFFS_CHECK_RES(res); + } + } // span index + } // valid object index id + + return res_c; +} + +// Removes orphaned and partially deleted index pages. +// Scans for index pages. When an index page is found, corresponding index header is searched for. +// If no such page exists, the index page cannot be reached as no index header exists and must be +// deleted. +s32_t spiffs_object_index_consistency_check(spiffs *fs) { + s32_t res = SPIFFS_OK; + // impl note: + // fs->work is used for a temporary object index memory, listing found object ids and + // indicating whether they can be reached or not. Acting as a fifo if object ids cannot fit. + // In the temporary object index memory, SPIFFS_OBJ_ID_IX_FLAG bit is used to indicate + // a reachable/unreachable object id. + c_memset(fs->work, 0, SPIFFS_CFG_LOG_PAGE_SZ(fs)); + u32_t obj_id_log_ix = 0; + if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_INDEX, SPIFFS_CHECK_PROGRESS, 0, 0); + res = spiffs_obj_lu_find_entry_visitor(fs, 0, 0, 0, 0, spiffs_object_index_consistency_check_v, 0, &obj_id_log_ix, + 0, 0); + if (res == SPIFFS_VIS_END) { + res = SPIFFS_OK; + } + if (res != SPIFFS_OK) { + if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_INDEX, SPIFFS_CHECK_ERROR, res, 0); + } + if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_INDEX, SPIFFS_CHECK_PROGRESS, 256, 0); + return res; +} + diff --git a/cores/esp8266/spiffs/spiffs_config.h b/cores/esp8266/spiffs/spiffs_config.h new file mode 100755 index 000000000..09e791689 --- /dev/null +++ b/cores/esp8266/spiffs/spiffs_config.h @@ -0,0 +1,242 @@ +/* + * spiffs_config.h + * + * Created on: Jul 3, 2013 + * Author: petera + */ + +#ifndef SPIFFS_CONFIG_H_ +#define SPIFFS_CONFIG_H_ + +// ----------- 8< ------------ +// Following includes are for the linux test build of spiffs +// These may/should/must be removed/altered/replaced in your target +// #include "params_test.h" +//#include "c_stdio.h" +//#include "c_stdlib.h" +//#include "c_string.h" +#include "mem.h" +#include "c_types.h" +#include "stddef.h" +#include "osapi.h" +#include "ets_sys.h" +#include +// ----------- >8 ------------ +#define IRAM_ATTR __attribute__((section(".iram.text"))) +#define STORE_TYPEDEF_ATTR __attribute__((aligned(4),packed)) +#define STORE_ATTR __attribute__((aligned(4))) +#define debugf(fmt, ...) os_printf(fmt"\r\n", ##__VA_ARGS__) +#define SYSTEM_ERROR(fmt, ...) os_printf("ERROR: " fmt "\r\n", ##__VA_ARGS__) + +#define SPIFFS_CHACHE 0 + +#define c_memcpy os_memcpy +#define c_printf os_printf +#define c_memset os_memset + +typedef signed short file_t; +typedef long int s32_t; +typedef long unsigned int u32_t; +typedef int16_t s16_t; +typedef uint16_t u16_t; +typedef int8_t s8_t; +typedef uint8_t u8_t; + +#ifndef SEEK_SET +#define SEEK_SET 0 /* set file offset to offset */ +#endif + +#ifndef SEEK_CUR +#define SEEK_CUR 1 /* set file offset to current plus offset */ +#endif + +#ifndef SEEK_END +#define SEEK_END 2 /* set file offset to EOF plus offset */ +#endif + +#ifndef EOF +#define EOF (-1) +#endif + +// compile time switches + +// Set generic spiffs debug output call. +#ifndef SPIFFS_DGB +#define SPIFFS_DBG(...) os_printf(__VA_ARGS__) +#endif +// Set spiffs debug output call for garbage collecting. +#ifndef SPIFFS_GC_DGB +#define SPIFFS_GC_DBG(...) os_printf(__VA_ARGS__) +#endif +// Set spiffs debug output call for caching. +#ifndef SPIFFS_CACHE_DGB +#define SPIFFS_CACHE_DBG(...) os_printf(__VA_ARGS__) +#endif +// Set spiffs debug output call for system consistency checks. +#ifndef SPIFFS_CHECK_DGB +#define SPIFFS_CHECK_DBG(...) os_printf(__VA_ARGS__) +#endif + +// Enable/disable API functions to determine exact number of bytes +// for filedescriptor and cache buffers. Once decided for a configuration, +// this can be disabled to reduce flash. +#ifndef SPIFFS_BUFFER_HELP +#define SPIFFS_BUFFER_HELP 0 +#endif + +// Enables/disable memory read caching of nucleus file system operations. +// If enabled, memory area must be provided for cache in SPIFFS_mount. +#ifndef SPIFFS_CACHE +#define SPIFFS_CACHE 1 +#endif +#if SPIFFS_CACHE +// Enables memory write caching for file descriptors in hydrogen +#ifndef SPIFFS_CACHE_WR +#define SPIFFS_CACHE_WR 1 +#endif + +// Enable/disable statistics on caching. Debug/test purpose only. +#ifndef SPIFFS_CACHE_STATS +#define SPIFFS_CACHE_STATS 0 +#endif +#endif + +// Always check header of each accessed page to ensure consistent state. +// If enabled it will increase number of reads, will increase flash. +#ifndef SPIFFS_PAGE_CHECK +#define SPIFFS_PAGE_CHECK 1 +#endif + +// Define maximum number of gc runs to perform to reach desired free pages. +#ifndef SPIFFS_GC_MAX_RUNS +#define SPIFFS_GC_MAX_RUNS 3 +#endif + +// Enable/disable statistics on gc. Debug/test purpose only. +#ifndef SPIFFS_GC_STATS +#define SPIFFS_GC_STATS 0 +#endif + +// Garbage collecting examines all pages in a block which and sums up +// to a block score. Deleted pages normally gives positive score and +// used pages normally gives a negative score (as these must be moved). +// To have a fair wear-leveling, the erase age is also included in score, +// whose factor normally is the most positive. +// The larger the score, the more likely it is that the block will +// picked for garbage collection. + +// Garbage collecting heuristics - weight used for deleted pages. +#ifndef SPIFFS_GC_HEUR_W_DELET +#define SPIFFS_GC_HEUR_W_DELET (5) +#endif +// Garbage collecting heuristics - weight used for used pages. +#ifndef SPIFFS_GC_HEUR_W_USED +#define SPIFFS_GC_HEUR_W_USED (-1) +#endif +// Garbage collecting heuristics - weight used for time between +// last erased and erase of this block. +#ifndef SPIFFS_GC_HEUR_W_ERASE_AGE +#define SPIFFS_GC_HEUR_W_ERASE_AGE (50) +#endif + +// Object name maximum length. +#ifndef SPIFFS_OBJ_NAME_LEN +#define SPIFFS_OBJ_NAME_LEN (32) +#endif + +// Size of buffer allocated on stack used when copying data. +// Lower value generates more read/writes. No meaning having it bigger +// than logical page size. +#ifndef SPIFFS_COPY_BUFFER_STACK +#define SPIFFS_COPY_BUFFER_STACK (64) +#endif + +// SPIFFS_LOCK and SPIFFS_UNLOCK protects spiffs from reentrancy on api level +// These should be defined on a multithreaded system + +// define this to entering a mutex if you're running on a multithreaded system +#ifndef SPIFFS_LOCK +#define SPIFFS_LOCK(fs) +#endif +// define this to exiting a mutex if you're running on a multithreaded system +#ifndef SPIFFS_UNLOCK +#define SPIFFS_UNLOCK(fs) +#endif + + +// Enable if only one spiffs instance with constant configuration will exist +// on the target. This will reduce calculations, flash and memory accesses. +// Parts of configuration must be defined below instead of at time of mount. +#ifndef SPIFFS_SINGLETON +#define SPIFFS_SINGLETON 0 +#endif + +#if SPIFFS_SINGLETON +// Instead of giving parameters in config struct, singleton build must +// give parameters in defines below. +#ifndef SPIFFS_CFG_PHYS_SZ +#define SPIFFS_CFG_PHYS_SZ(ignore) (1024*1024*2) +#endif +#ifndef SPIFFS_CFG_PHYS_ERASE_SZ +#define SPIFFS_CFG_PHYS_ERASE_SZ(ignore) (65536) +#endif +#ifndef SPIFFS_CFG_PHYS_ADDR +#define SPIFFS_CFG_PHYS_ADDR(ignore) (0) +#endif +#ifndef SPIFFS_CFG_LOG_PAGE_SZ +#define SPIFFS_CFG_LOG_PAGE_SZ(ignore) (256) +#endif +#ifndef SPIFFS_CFG_LOG_BLOCK_SZ +#define SPIFFS_CFG_LOG_BLOCK_SZ(ignore) (65536) +#endif +#endif + +// Set SPFIFS_TEST_VISUALISATION to non-zero to enable SPIFFS_vis function +// in the api. This function will visualize all filesystem using given printf +// function. +#ifndef SPIFFS_TEST_VISUALISATION +#define SPIFFS_TEST_VISUALISATION 1 +#endif +#if SPIFFS_TEST_VISUALISATION +#ifndef spiffs_printf +#define spiffs_printf(...) c_printf(__VA_ARGS__) +#endif +// spiffs_printf argument for a free page +#ifndef SPIFFS_TEST_VIS_FREE_STR +#define SPIFFS_TEST_VIS_FREE_STR "_" +#endif +// spiffs_printf argument for a deleted page +#ifndef SPIFFS_TEST_VIS_DELE_STR +#define SPIFFS_TEST_VIS_DELE_STR "/" +#endif +// spiffs_printf argument for an index page for given object id +#ifndef SPIFFS_TEST_VIS_INDX_STR +#define SPIFFS_TEST_VIS_INDX_STR(id) "i" +#endif +// spiffs_printf argument for a data page for given object id +#ifndef SPIFFS_TEST_VIS_DATA_STR +#define SPIFFS_TEST_VIS_DATA_STR(id) "d" +#endif +#endif + +// Types depending on configuration such as the amount of flash bytes +// given to spiffs file system in total (spiffs_file_system_size), +// the logical block size (log_block_size), and the logical page size +// (log_page_size) + +// Block index type. Make sure the size of this type can hold +// the highest number of all blocks - i.e. spiffs_file_system_size / log_block_size +typedef u16_t spiffs_block_ix; +// Page index type. Make sure the size of this type can hold +// the highest page number of all pages - i.e. spiffs_file_system_size / log_page_size +typedef u16_t spiffs_page_ix; +// Object id type - most significant bit is reserved for index flag. Make sure the +// size of this type can hold the highest object id on a full system, +// i.e. 2 + (spiffs_file_system_size / (2*log_page_size))*2 +typedef u16_t spiffs_obj_id; +// Object span index type. Make sure the size of this type can +// hold the largest possible span index on the system - +// i.e. (spiffs_file_system_size / log_page_size) - 1 +typedef u16_t spiffs_span_ix; + +#endif /* SPIFFS_CONFIG_H_ */ diff --git a/cores/esp8266/spiffs/spiffs_flashmem.c b/cores/esp8266/spiffs/spiffs_flashmem.c new file mode 100755 index 000000000..16c51cbf4 --- /dev/null +++ b/cores/esp8266/spiffs/spiffs_flashmem.c @@ -0,0 +1,236 @@ +#include "flashmem.h" + +// Based on NodeMCU platform_flash +// https://github.com/nodemcu/nodemcu-firmware + +extern char _flash_code_end[]; +extern uint32_t _SPIFFS_start; +extern uint32_t _SPIFFS_end; + +#define SPIFFS_PARTITION_SIZE() (uint32_t)(_SPIFFS_end - _SPIFFS_start) +#define CAN_FIT_ON_SPIFFS(a,l) (((a+l)-_SPIFFS_start) <= SPIFFS_PARTITION_SIZE()) + +uint32_t flashmem_write( const void *from, uint32_t toaddr, uint32_t size ) +{ + if(!CAN_FIT_ON_SPIFFS(toaddr,size)){ + os_printf("File Out Of Bounds\n"); + return 0; + } + uint32_t temp, rest, ssize = size; + unsigned i; + char tmpdata[ INTERNAL_FLASH_WRITE_UNIT_SIZE ]; + const uint8_t *pfrom = ( const uint8_t* )from; + const uint32_t blksize = INTERNAL_FLASH_WRITE_UNIT_SIZE; + const uint32_t blkmask = INTERNAL_FLASH_WRITE_UNIT_SIZE - 1; + + // Align the start + if( toaddr & blkmask ) + { + rest = toaddr & blkmask; + temp = toaddr & ~blkmask; // this is the actual aligned address + // c_memcpy( tmpdata, ( const void* )temp, blksize ); + flashmem_read_internal( tmpdata, temp, blksize ); + for( i = rest; size && ( i < blksize ); i ++, size --, pfrom ++ ) + tmpdata[ i ] = *pfrom; + flashmem_write_internal( tmpdata, temp, blksize ); + if( size == 0 ) + return ssize; + toaddr = temp + blksize; + } + // The start address is now a multiple of blksize + // Compute how many bytes we can write as multiples of blksize + rest = size & blkmask; + temp = size & ~blkmask; + // Program the blocks now + if( temp ) + { + flashmem_write_internal( pfrom, toaddr, temp ); + toaddr += temp; + pfrom += temp; + } + // And the final part of a block if needed + if( rest ) + { + // c_memcpy( tmpdata, ( const void* )toaddr, blksize ); + flashmem_read_internal( tmpdata, toaddr, blksize ); + for( i = 0; size && ( i < rest ); i ++, size --, pfrom ++ ) + tmpdata[ i ] = *pfrom; + flashmem_write_internal( tmpdata, toaddr, blksize ); + } + return ssize; +} + +uint32_t flashmem_read( void *to, uint32_t fromaddr, uint32_t size ) +{ + if(!CAN_FIT_ON_SPIFFS(fromaddr,size)){ + os_printf("File Out Of Bounds\n"); + return 0; + } + uint32_t temp, rest, ssize = size; + unsigned i; + char tmpdata[ INTERNAL_FLASH_READ_UNIT_SIZE ]; + uint8_t *pto = ( uint8_t* )to; + const uint32_t blksize = INTERNAL_FLASH_READ_UNIT_SIZE; + const uint32_t blkmask = INTERNAL_FLASH_READ_UNIT_SIZE - 1; + + // Align the start + if( fromaddr & blkmask ) + { + rest = fromaddr & blkmask; + temp = fromaddr & ~blkmask; // this is the actual aligned address + flashmem_read_internal( tmpdata, temp, blksize ); + for( i = rest; size && ( i < blksize ); i ++, size --, pto ++ ) + *pto = tmpdata[ i ]; + + if( size == 0 ) + return ssize; + fromaddr = temp + blksize; + } + // The start address is now a multiple of blksize + // Compute how many bytes we can read as multiples of blksize + rest = size & blkmask; + temp = size & ~blkmask; + // Program the blocks now + if( temp ) + { + flashmem_read_internal( pto, fromaddr, temp ); + fromaddr += temp; + pto += temp; + } + // And the final part of a block if needed + if( rest ) + { + flashmem_read_internal( tmpdata, fromaddr, blksize ); + for( i = 0; size && ( i < rest ); i ++, size --, pto ++ ) + *pto = tmpdata[ i ]; + } + return ssize; +} + +bool flashmem_erase_sector( uint32_t sector_id ) +{ + WRITE_PERI_REG(0x60000914, 0x73); + return spi_flash_erase_sector( sector_id ) == SPI_FLASH_RESULT_OK; +} + +SPIFlashInfo flashmem_get_info() +{ + volatile SPIFlashInfo spi_flash_info STORE_ATTR; + spi_flash_info = *((SPIFlashInfo *)(INTERNAL_FLASH_START_ADDRESS)); + return spi_flash_info; +} + +uint8_t flashmem_get_size_type() +{ + return flashmem_get_info().size; +} + +uint32_t flashmem_get_size_bytes() +{ + uint32_t flash_size = 0; + switch (flashmem_get_info().size) + { + case SIZE_2MBIT: + // 2Mbit, 256kByte + flash_size = 256 * 1024; + break; + case SIZE_4MBIT: + // 4Mbit, 512kByte + flash_size = 512 * 1024; + break; + case SIZE_8MBIT: + // 8Mbit, 1MByte + flash_size = 1 * 1024 * 1024; + break; + case SIZE_16MBIT: + // 16Mbit, 2MByte + flash_size = 2 * 1024 * 1024; + break; + case SIZE_32MBIT: + // 32Mbit, 4MByte + flash_size = 4 * 1024 * 1024; + break; + default: + // Unknown flash size, fall back mode. + flash_size = 512 * 1024; + break; + } + return flash_size; +} + +uint16_t flashmem_get_size_sectors() +{ + return flashmem_get_size_bytes() / SPI_FLASH_SEC_SIZE; +} + +// Helper function: find the flash sector in which an address resides +// Return the sector number, as well as the start and end address of the sector +uint32_t flashmem_find_sector( uint32_t address, uint32_t *pstart, uint32_t *pend ) +{ + address -= INTERNAL_FLASH_START_ADDRESS; + // All the sectors in the flash have the same size, so just align the address + uint32_t sect_id = address / INTERNAL_FLASH_SECTOR_SIZE; + + if( pstart ) + *pstart = sect_id * INTERNAL_FLASH_SECTOR_SIZE + INTERNAL_FLASH_START_ADDRESS; + if( pend ) + *pend = ( sect_id + 1 ) * INTERNAL_FLASH_SECTOR_SIZE + INTERNAL_FLASH_START_ADDRESS - 1; + return sect_id; +} + +uint32_t flashmem_get_sector_of_address( uint32_t addr ) +{ + return flashmem_find_sector( addr, NULL, NULL ); +} + +///////////////////////////////////////////////////// + +uint32_t flashmem_write_internal( const void *from, uint32_t toaddr, uint32_t size ) +{ + toaddr -= INTERNAL_FLASH_START_ADDRESS; + SpiFlashOpResult r; + const uint32_t blkmask = INTERNAL_FLASH_WRITE_UNIT_SIZE - 1; + uint32_t *apbuf = NULL; + if( ((uint32_t)from) & blkmask ){ + apbuf = (uint32_t *)os_malloc(size); + if(!apbuf) + return 0; + os_memcpy(apbuf, from, size); + } + WRITE_PERI_REG(0x60000914, 0x73); + r = spi_flash_write(toaddr, apbuf?(uint32 *)apbuf:(uint32 *)from, size); + if(apbuf) + os_free(apbuf); + if(SPI_FLASH_RESULT_OK == r) + return size; + else{ + SYSTEM_ERROR( "ERROR in flash_write: r=%d at %08X\n", ( int )r, ( unsigned )toaddr+INTERNAL_FLASH_START_ADDRESS ); + return 0; + } +} + +uint32_t flashmem_read_internal( void *to, uint32_t fromaddr, uint32_t size ) +{ + fromaddr -= INTERNAL_FLASH_START_ADDRESS; + SpiFlashOpResult r; + WRITE_PERI_REG(0x60000914, 0x73); + r = spi_flash_read(fromaddr, (uint32 *)to, size); + if(SPI_FLASH_RESULT_OK == r) + return size; + else{ + SYSTEM_ERROR( "ERROR in flash_read: r=%d at %08X\n", ( int )r, ( unsigned )fromaddr+INTERNAL_FLASH_START_ADDRESS ); + return 0; + } +} + +uint32_t flashmem_get_first_free_block_address(){ + if (_SPIFFS_start == 0){ + debugf("_SPIFFS_start:%08x\n", _SPIFFS_start); + return 0; + } + + // Round the total used flash size to the closest flash block address + uint32_t end; + flashmem_find_sector( _SPIFFS_start - 1, NULL, &end); + return end + 1; +} diff --git a/cores/esp8266/spiffs/spiffs_gc.c b/cores/esp8266/spiffs/spiffs_gc.c new file mode 100755 index 000000000..4d6c89710 --- /dev/null +++ b/cores/esp8266/spiffs/spiffs_gc.c @@ -0,0 +1,556 @@ +#include "spiffs.h" +#include "spiffs_nucleus.h" + +// Erases a logical block and updates the erase counter. +// If cache is enabled, all pages that might be cached in this block +// is dropped. +static s32_t spiffs_gc_erase_block( + spiffs *fs, + spiffs_block_ix bix) { + s32_t res; + u32_t addr = SPIFFS_BLOCK_TO_PADDR(fs, bix); + s32_t size = SPIFFS_CFG_LOG_BLOCK_SZ(fs); + + SPIFFS_GC_DBG("gc: erase block %i\n", bix); + + // here we ignore res, just try erasing the block + while (size > 0) { + SPIFFS_GC_DBG("gc: erase %08x:%08x\n", addr, SPIFFS_CFG_PHYS_ERASE_SZ(fs)); + (void)fs->cfg.hal_erase_f(addr, SPIFFS_CFG_PHYS_ERASE_SZ(fs)); + addr += SPIFFS_CFG_PHYS_ERASE_SZ(fs); + size -= SPIFFS_CFG_PHYS_ERASE_SZ(fs); + } + fs->free_blocks++; + + // register erase count for this block + res = _spiffs_wr(fs, SPIFFS_OP_C_WRTHRU | SPIFFS_OP_T_OBJ_LU2, 0, + SPIFFS_ERASE_COUNT_PADDR(fs, bix), + sizeof(spiffs_obj_id), (u8_t *)&fs->max_erase_count); + SPIFFS_CHECK_RES(res); + + fs->max_erase_count++; + if (fs->max_erase_count == SPIFFS_OBJ_ID_IX_FLAG) { + fs->max_erase_count = 0; + } + +#if SPIFFS_CACHE + { + u32_t i; + for (i = 0; i < SPIFFS_PAGES_PER_BLOCK(fs); i++) { + spiffs_cache_drop_page(fs, SPIFFS_PAGE_FOR_BLOCK(fs, bix) + i); + } + } +#endif + return res; +} + +// Searches for blocks where all entries are deleted - if one is found, +// the block is erased. Compared to the non-quick gc, the quick one ensures +// that no updates are needed on existing objects on pages that are erased. +s32_t spiffs_gc_quick( + spiffs *fs) { + s32_t res = SPIFFS_OK; + u32_t blocks = fs->block_count; + spiffs_block_ix cur_block = 0; + u32_t cur_block_addr = 0; + int cur_entry = 0; + spiffs_obj_id *obj_lu_buf = (spiffs_obj_id *)fs->lu_work; + + SPIFFS_GC_DBG("gc_quick: running\n", cur_block); +#if SPIFFS_GC_STATS + fs->stats_gc_runs++; +#endif + + int entries_per_page = (SPIFFS_CFG_LOG_PAGE_SZ(fs) / sizeof(spiffs_obj_id)); + + // find fully deleted blocks + // check each block + while (res == SPIFFS_OK && blocks--) { + u16_t deleted_pages_in_block = 0; + + int obj_lookup_page = 0; + // check each object lookup page + while (res == SPIFFS_OK && obj_lookup_page < (int)SPIFFS_OBJ_LOOKUP_PAGES(fs)) { + int entry_offset = obj_lookup_page * entries_per_page; + res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU | SPIFFS_OP_C_READ, + 0, cur_block_addr + SPIFFS_PAGE_TO_PADDR(fs, obj_lookup_page), SPIFFS_CFG_LOG_PAGE_SZ(fs), fs->lu_work); + // check each entry + while (res == SPIFFS_OK && + cur_entry - entry_offset < entries_per_page && + cur_entry < (int)(SPIFFS_PAGES_PER_BLOCK(fs)-SPIFFS_OBJ_LOOKUP_PAGES(fs))) { + spiffs_obj_id obj_id = obj_lu_buf[cur_entry-entry_offset]; + if (obj_id == SPIFFS_OBJ_ID_DELETED) { + deleted_pages_in_block++; + } else if (obj_id == SPIFFS_OBJ_ID_FREE) { + // kill scan, go for next block + obj_lookup_page = SPIFFS_OBJ_LOOKUP_PAGES(fs); + res = 1; // kill object lu loop + break; + } else { + // kill scan, go for next block + obj_lookup_page = SPIFFS_OBJ_LOOKUP_PAGES(fs); + res = 1; // kill object lu loop + break; + } + cur_entry++; + } // per entry + obj_lookup_page++; + } // per object lookup page + if (res == 1) res = SPIFFS_OK; + + if (res == SPIFFS_OK && deleted_pages_in_block == SPIFFS_PAGES_PER_BLOCK(fs)-SPIFFS_OBJ_LOOKUP_PAGES(fs)) { + // found a fully deleted block + fs->stats_p_deleted -= deleted_pages_in_block; + res = spiffs_gc_erase_block(fs, cur_block); + return res; + } + + cur_entry = 0; + cur_block++; + cur_block_addr += SPIFFS_CFG_LOG_BLOCK_SZ(fs); + } // per block + + return res; +} + +// Checks if garbaga collecting is necessary. If so a candidate block is found, +// cleansed and erased +s32_t spiffs_gc_check( + spiffs *fs, + u32_t len) { + s32_t res; + u32_t free_pages = + (SPIFFS_PAGES_PER_BLOCK(fs) - SPIFFS_OBJ_LOOKUP_PAGES(fs)) * fs->block_count + - fs->stats_p_allocated - fs->stats_p_deleted; + int tries = 0; + + if (fs->free_blocks > 3 && + len < free_pages * SPIFFS_DATA_PAGE_SIZE(fs)) { + return SPIFFS_OK; + } + + //printf("gcing started %i dirty, blocks %i free, want %i bytes\n", fs->stats_p_allocated + fs->stats_p_deleted, fs->free_blocks, len); + + do { + SPIFFS_GC_DBG("\ngc_check #%i: run gc free_blocks:%i pfree:%i pallo:%i pdele:%i [%i] len:%i of %i\n", + tries, + fs->free_blocks, free_pages, fs->stats_p_allocated, fs->stats_p_deleted, (free_pages+fs->stats_p_allocated+fs->stats_p_deleted), + len, free_pages*SPIFFS_DATA_PAGE_SIZE(fs)); + + spiffs_block_ix *cands; + int count; + spiffs_block_ix cand; + res = spiffs_gc_find_candidate(fs, &cands, &count); + SPIFFS_CHECK_RES(res); + if (count == 0) { + SPIFFS_GC_DBG("gc_check: no candidates, return\n"); + return res; + } +#if SPIFFS_GC_STATS + fs->stats_gc_runs++; +#endif + cand = cands[0]; + fs->cleaning = 1; + //printf("gcing: cleaning block %i\n", cand); + res = spiffs_gc_clean(fs, cand); + fs->cleaning = 0; + if (res < 0) { + SPIFFS_GC_DBG("gc_check: cleaning block %i, result %i\n", cand, res); + } else { + SPIFFS_GC_DBG("gc_check: cleaning block %i, result %i\n", cand, res); + } + SPIFFS_CHECK_RES(res); + + res = spiffs_gc_erase_page_stats(fs, cand); + SPIFFS_CHECK_RES(res); + + res = spiffs_gc_erase_block(fs, cand); + SPIFFS_CHECK_RES(res); + + free_pages = + (SPIFFS_PAGES_PER_BLOCK(fs) - SPIFFS_OBJ_LOOKUP_PAGES(fs)) * fs->block_count + - fs->stats_p_allocated - fs->stats_p_deleted; + + } while (++tries < SPIFFS_GC_MAX_RUNS && (fs->free_blocks <= 2 || + len > free_pages*SPIFFS_DATA_PAGE_SIZE(fs))); + SPIFFS_GC_DBG("gc_check: finished\n"); + + //printf("gcing finished %i dirty, blocks %i free, %i pages free, %i tries, res %i\n", + // fs->stats_p_allocated + fs->stats_p_deleted, + // fs->free_blocks, free_pages, tries, res); + + return res; +} + +// Updates page statistics for a block that is about to be erased +s32_t spiffs_gc_erase_page_stats( + spiffs *fs, + spiffs_block_ix bix) { + s32_t res = SPIFFS_OK; + int obj_lookup_page = 0; + int entries_per_page = (SPIFFS_CFG_LOG_PAGE_SZ(fs) / sizeof(spiffs_obj_id)); + spiffs_obj_id *obj_lu_buf = (spiffs_obj_id *)fs->lu_work; + int cur_entry = 0; + u32_t dele = 0; + u32_t allo = 0; + + // check each object lookup page + while (res == SPIFFS_OK && obj_lookup_page < (int)SPIFFS_OBJ_LOOKUP_PAGES(fs)) { + int entry_offset = obj_lookup_page * entries_per_page; + res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU | SPIFFS_OP_C_READ, + 0, bix * SPIFFS_CFG_LOG_BLOCK_SZ(fs) + SPIFFS_PAGE_TO_PADDR(fs, obj_lookup_page), SPIFFS_CFG_LOG_PAGE_SZ(fs), fs->lu_work); + // check each entry + while (res == SPIFFS_OK && + cur_entry - entry_offset < entries_per_page && cur_entry < (int)(SPIFFS_PAGES_PER_BLOCK(fs)-SPIFFS_OBJ_LOOKUP_PAGES(fs))) { + spiffs_obj_id obj_id = obj_lu_buf[cur_entry-entry_offset]; + if (obj_id == SPIFFS_OBJ_ID_FREE) { + } else if (obj_id == SPIFFS_OBJ_ID_DELETED) { + dele++; + } else { + allo++; + } + cur_entry++; + } // per entry + obj_lookup_page++; + } // per object lookup page + SPIFFS_GC_DBG("gc_check: wipe pallo:%i pdele:%i\n", allo, dele); + fs->stats_p_allocated -= allo; + fs->stats_p_deleted -= dele; + return res; +} + +// Finds block candidates to erase +s32_t spiffs_gc_find_candidate( + spiffs *fs, + spiffs_block_ix **block_candidates, + int *candidate_count) { + s32_t res = SPIFFS_OK; + u32_t blocks = fs->block_count; + spiffs_block_ix cur_block = 0; + u32_t cur_block_addr = 0; + spiffs_obj_id *obj_lu_buf = (spiffs_obj_id *)fs->lu_work; + int cur_entry = 0; + + // using fs->work area as sorted candidate memory, (spiffs_block_ix)cand_bix/(s32_t)score + int max_candidates = MIN(fs->block_count, (SPIFFS_CFG_LOG_PAGE_SZ(fs)-8)/(sizeof(spiffs_block_ix) + sizeof(s32_t))); + *candidate_count = 0; + c_memset(fs->work, 0xff, SPIFFS_CFG_LOG_PAGE_SZ(fs)); + + // divide up work area into block indices and scores + // todo alignment? + spiffs_block_ix *cand_blocks = (spiffs_block_ix *)fs->work; + s32_t *cand_scores = (s32_t *)(fs->work + max_candidates * sizeof(spiffs_block_ix)); + + *block_candidates = cand_blocks; + + int entries_per_page = (SPIFFS_CFG_LOG_PAGE_SZ(fs) / sizeof(spiffs_obj_id)); + + // check each block + while (res == SPIFFS_OK && blocks--) { + u16_t deleted_pages_in_block = 0; + u16_t used_pages_in_block = 0; + + int obj_lookup_page = 0; + // check each object lookup page + while (res == SPIFFS_OK && obj_lookup_page < (int)SPIFFS_OBJ_LOOKUP_PAGES(fs)) { + int entry_offset = obj_lookup_page * entries_per_page; + res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU | SPIFFS_OP_C_READ, + 0, cur_block_addr + SPIFFS_PAGE_TO_PADDR(fs, obj_lookup_page), SPIFFS_CFG_LOG_PAGE_SZ(fs), fs->lu_work); + // check each entry + while (res == SPIFFS_OK && + cur_entry - entry_offset < entries_per_page && + cur_entry < (int)(SPIFFS_PAGES_PER_BLOCK(fs)-SPIFFS_OBJ_LOOKUP_PAGES(fs))) { + spiffs_obj_id obj_id = obj_lu_buf[cur_entry-entry_offset]; + if (obj_id == SPIFFS_OBJ_ID_FREE) { + // when a free entry is encountered, scan logic ensures that all following entries are free also + res = 1; // kill object lu loop + break; + } else if (obj_id == SPIFFS_OBJ_ID_DELETED) { + deleted_pages_in_block++; + } else { + used_pages_in_block++; + } + cur_entry++; + } // per entry + obj_lookup_page++; + } // per object lookup page + if (res == 1) res = SPIFFS_OK; + + // calculate score and insert into candidate table + // stoneage sort, but probably not so many blocks + if (res == SPIFFS_OK && deleted_pages_in_block > 0) { + // read erase count + spiffs_obj_id erase_count; + res = _spiffs_rd(fs, SPIFFS_OP_C_READ | SPIFFS_OP_T_OBJ_LU2, 0, + SPIFFS_ERASE_COUNT_PADDR(fs, cur_block), + sizeof(spiffs_obj_id), (u8_t *)&erase_count); + SPIFFS_CHECK_RES(res); + + spiffs_obj_id erase_age; + if (fs->max_erase_count > erase_count) { + erase_age = fs->max_erase_count - erase_count; + } else { + erase_age = SPIFFS_OBJ_ID_FREE - (erase_count - fs->max_erase_count); + } + + s32_t score = + deleted_pages_in_block * SPIFFS_GC_HEUR_W_DELET + + used_pages_in_block * SPIFFS_GC_HEUR_W_USED + + erase_age * SPIFFS_GC_HEUR_W_ERASE_AGE; + int cand_ix = 0; + SPIFFS_GC_DBG("gc_check: bix:%i del:%i use:%i score:%i\n", cur_block, deleted_pages_in_block, used_pages_in_block, score); + while (cand_ix < max_candidates) { + if (cand_blocks[cand_ix] == (spiffs_block_ix)-1) { + cand_blocks[cand_ix] = cur_block; + cand_scores[cand_ix] = score; + break; + } else if (cand_scores[cand_ix] < score) { + int reorder_cand_ix = max_candidates - 2; + while (reorder_cand_ix >= cand_ix) { + cand_blocks[reorder_cand_ix + 1] = cand_blocks[reorder_cand_ix]; + cand_scores[reorder_cand_ix + 1] = cand_scores[reorder_cand_ix]; + reorder_cand_ix--; + } + cand_blocks[cand_ix] = cur_block; + cand_scores[cand_ix] = score; + break; + } + cand_ix++; + } + (*candidate_count)++; + } + + cur_entry = 0; + cur_block++; + cur_block_addr += SPIFFS_CFG_LOG_BLOCK_SZ(fs); + } // per block + + return res; +} + +typedef enum { + FIND_OBJ_DATA, + MOVE_OBJ_DATA, + MOVE_OBJ_IX, + FINISHED +} spiffs_gc_clean_state; + +typedef struct { + spiffs_gc_clean_state state; + spiffs_obj_id cur_obj_id; + spiffs_span_ix cur_objix_spix; + spiffs_page_ix cur_objix_pix; + int stored_scan_entry_index; + u8_t obj_id_found; +} spiffs_gc; + +// Empties given block by moving all data into free pages of another block +// Strategy: +// loop: +// scan object lookup for object data pages +// for first found id, check spix and load corresponding object index page to memory +// push object scan lookup entry index +// rescan object lookup, find data pages with same id and referenced by same object index +// move data page, update object index in memory +// when reached end of lookup, store updated object index +// pop object scan lookup entry index +// repeat loop until end of object lookup +// scan object lookup again for remaining object index pages, move to new page in other block +// +s32_t spiffs_gc_clean(spiffs *fs, spiffs_block_ix bix) { + s32_t res = SPIFFS_OK; + int entries_per_page = (SPIFFS_CFG_LOG_PAGE_SZ(fs) / sizeof(spiffs_obj_id)); + int cur_entry = 0; + spiffs_obj_id *obj_lu_buf = (spiffs_obj_id *)fs->lu_work; + spiffs_gc gc; + spiffs_page_ix cur_pix = 0; + spiffs_page_object_ix_header *objix_hdr = (spiffs_page_object_ix_header *)fs->work; + spiffs_page_object_ix *objix = (spiffs_page_object_ix *)fs->work; + + SPIFFS_GC_DBG("gc_clean: cleaning block %i\n", bix); + + c_memset(&gc, 0, sizeof(spiffs_gc)); + gc.state = FIND_OBJ_DATA; + + if (fs->free_cursor_block_ix == bix) { + // move free cursor to next block, cannot use free pages from the block we want to clean + fs->free_cursor_block_ix = (bix+1)%fs->block_count; + fs->free_cursor_obj_lu_entry = 0; + SPIFFS_GC_DBG("gc_clean: move free cursor to block %i\n", fs->free_cursor_block_ix); + } + + while (res == SPIFFS_OK && gc.state != FINISHED) { + SPIFFS_GC_DBG("gc_clean: state = %i entry:%i\n", gc.state, cur_entry); + gc.obj_id_found = 0; + + // scan through lookup pages + int obj_lookup_page = cur_entry / entries_per_page; + u8_t scan = 1; + // check each object lookup page + while (scan && res == SPIFFS_OK && obj_lookup_page < (int)SPIFFS_OBJ_LOOKUP_PAGES(fs)) { + int entry_offset = obj_lookup_page * entries_per_page; + res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU | SPIFFS_OP_C_READ, + 0, bix * SPIFFS_CFG_LOG_BLOCK_SZ(fs) + SPIFFS_PAGE_TO_PADDR(fs, obj_lookup_page), + SPIFFS_CFG_LOG_PAGE_SZ(fs), fs->lu_work); + // check each entry + while (scan && res == SPIFFS_OK && + cur_entry - entry_offset < entries_per_page && cur_entry < (int)(SPIFFS_PAGES_PER_BLOCK(fs)-SPIFFS_OBJ_LOOKUP_PAGES(fs))) { + spiffs_obj_id obj_id = obj_lu_buf[cur_entry-entry_offset]; + cur_pix = SPIFFS_OBJ_LOOKUP_ENTRY_TO_PIX(fs, bix, cur_entry); + + // act upon object id depending on gc state + switch (gc.state) { + case FIND_OBJ_DATA: + if (obj_id != SPIFFS_OBJ_ID_DELETED && obj_id != SPIFFS_OBJ_ID_FREE && + ((obj_id & SPIFFS_OBJ_ID_IX_FLAG) == 0)) { + SPIFFS_GC_DBG("gc_clean: FIND_DATA state:%i - found obj id %04x\n", gc.state, obj_id); + gc.obj_id_found = 1; + gc.cur_obj_id = obj_id; + scan = 0; + } + break; + case MOVE_OBJ_DATA: + if (obj_id == gc.cur_obj_id) { + spiffs_page_header p_hdr; + res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU2 | SPIFFS_OP_C_READ, + 0, SPIFFS_PAGE_TO_PADDR(fs, cur_pix), sizeof(spiffs_page_header), (u8_t*)&p_hdr); + SPIFFS_CHECK_RES(res); + SPIFFS_GC_DBG("gc_clean: MOVE_DATA found data page %04x:%04x @ %04x\n", gc.cur_obj_id, p_hdr.span_ix, cur_pix); + if (SPIFFS_OBJ_IX_ENTRY_SPAN_IX(fs, p_hdr.span_ix) != gc.cur_objix_spix) { + SPIFFS_GC_DBG("gc_clean: MOVE_DATA no objix spix match, take in another run\n"); + } else { + spiffs_page_ix new_data_pix; + if (p_hdr.flags & SPIFFS_PH_FLAG_DELET) { + // move page + res = spiffs_page_move(fs, 0, 0, obj_id, &p_hdr, cur_pix, &new_data_pix); + SPIFFS_GC_DBG("gc_clean: MOVE_DATA move objix %04x:%04x page %04x to %04x\n", gc.cur_obj_id, p_hdr.span_ix, cur_pix, new_data_pix); + SPIFFS_CHECK_RES(res); + // move wipes obj_lu, reload it + res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU | SPIFFS_OP_C_READ, + 0, bix * SPIFFS_CFG_LOG_BLOCK_SZ(fs) + SPIFFS_PAGE_TO_PADDR(fs, obj_lookup_page), + SPIFFS_CFG_LOG_PAGE_SZ(fs), fs->lu_work); + SPIFFS_CHECK_RES(res); + } else { + // page is deleted but not deleted in lookup, scrap it + SPIFFS_GC_DBG("gc_clean: MOVE_DATA wipe objix %04x:%04x page %04x\n", obj_id, p_hdr.span_ix, cur_pix); + res = spiffs_page_delete(fs, cur_pix); + SPIFFS_CHECK_RES(res); + new_data_pix = SPIFFS_OBJ_ID_FREE; + } + // update memory representation of object index page with new data page + if (gc.cur_objix_spix == 0) { + // update object index header page + ((spiffs_page_ix*)((u8_t *)objix_hdr + sizeof(spiffs_page_object_ix_header)))[p_hdr.span_ix] = new_data_pix; + SPIFFS_GC_DBG("gc_clean: MOVE_DATA wrote page %04x to objix_hdr entry %02x in mem\n", new_data_pix, SPIFFS_OBJ_IX_ENTRY(fs, p_hdr.span_ix)); + } else { + // update object index page + ((spiffs_page_ix*)((u8_t *)objix + sizeof(spiffs_page_object_ix)))[SPIFFS_OBJ_IX_ENTRY(fs, p_hdr.span_ix)] = new_data_pix; + SPIFFS_GC_DBG("gc_clean: MOVE_DATA wrote page %04x to objix entry %02x in mem\n", new_data_pix, SPIFFS_OBJ_IX_ENTRY(fs, p_hdr.span_ix)); + } + } + } + break; + case MOVE_OBJ_IX: + if (obj_id != SPIFFS_OBJ_ID_DELETED && obj_id != SPIFFS_OBJ_ID_FREE && + (obj_id & SPIFFS_OBJ_ID_IX_FLAG)) { + // found an index object id + spiffs_page_header p_hdr; + spiffs_page_ix new_pix; + // load header + res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU2 | SPIFFS_OP_C_READ, + 0, SPIFFS_PAGE_TO_PADDR(fs, cur_pix), sizeof(spiffs_page_header), (u8_t*)&p_hdr); + SPIFFS_CHECK_RES(res); + if (p_hdr.flags & SPIFFS_PH_FLAG_DELET) { + // move page + res = spiffs_page_move(fs, 0, 0, obj_id, &p_hdr, cur_pix, &new_pix); + SPIFFS_GC_DBG("gc_clean: MOVE_OBJIX move objix %04x:%04x page %04x to %04x\n", obj_id, p_hdr.span_ix, cur_pix, new_pix); + SPIFFS_CHECK_RES(res); + spiffs_cb_object_event(fs, 0, SPIFFS_EV_IX_UPD, obj_id, p_hdr.span_ix, new_pix, 0); + // move wipes obj_lu, reload it + res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU | SPIFFS_OP_C_READ, + 0, bix * SPIFFS_CFG_LOG_BLOCK_SZ(fs) + SPIFFS_PAGE_TO_PADDR(fs, obj_lookup_page), + SPIFFS_CFG_LOG_PAGE_SZ(fs), fs->lu_work); + SPIFFS_CHECK_RES(res); + } else { + // page is deleted but not deleted in lookup, scrap it + SPIFFS_GC_DBG("gc_clean: MOVE_OBJIX wipe objix %04x:%04x page %04x\n", obj_id, p_hdr.span_ix, cur_pix); + res = spiffs_page_delete(fs, cur_pix); + if (res == SPIFFS_OK) { + spiffs_cb_object_event(fs, 0, SPIFFS_EV_IX_DEL, obj_id, p_hdr.span_ix, cur_pix, 0); + } + } + SPIFFS_CHECK_RES(res); + } + break; + default: + scan = 0; + break; + } + cur_entry++; + } // per entry + obj_lookup_page++; + } // per object lookup page + + if (res != SPIFFS_OK) break; + + // state finalization and switch + switch (gc.state) { + case FIND_OBJ_DATA: + if (gc.obj_id_found) { + // find out corresponding obj ix page and load it to memory + spiffs_page_header p_hdr; + spiffs_page_ix objix_pix; + gc.stored_scan_entry_index = cur_entry; + cur_entry = 0; + gc.state = MOVE_OBJ_DATA; + res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU2 | SPIFFS_OP_C_READ, + 0, SPIFFS_PAGE_TO_PADDR(fs, cur_pix), sizeof(spiffs_page_header), (u8_t*)&p_hdr); + SPIFFS_CHECK_RES(res); + gc.cur_objix_spix = SPIFFS_OBJ_IX_ENTRY_SPAN_IX(fs, p_hdr.span_ix); + SPIFFS_GC_DBG("gc_clean: FIND_DATA find objix span_ix:%04x\n", gc.cur_objix_spix); + res = spiffs_obj_lu_find_id_and_span(fs, gc.cur_obj_id | SPIFFS_OBJ_ID_IX_FLAG, gc.cur_objix_spix, 0, &objix_pix); + SPIFFS_CHECK_RES(res); + SPIFFS_GC_DBG("gc_clean: FIND_DATA found object index at page %04x\n", objix_pix); + res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU2 | SPIFFS_OP_C_READ, + 0, SPIFFS_PAGE_TO_PADDR(fs, objix_pix), SPIFFS_CFG_LOG_PAGE_SZ(fs), fs->work); + SPIFFS_CHECK_RES(res); + SPIFFS_VALIDATE_OBJIX(objix->p_hdr, gc.cur_obj_id | SPIFFS_OBJ_ID_IX_FLAG, gc.cur_objix_spix); + gc.cur_objix_pix = objix_pix; + } else { + gc.state = MOVE_OBJ_IX; + cur_entry = 0; // restart entry scan index + } + break; + case MOVE_OBJ_DATA: { + // store modified objix (hdr) page + spiffs_page_ix new_objix_pix; + gc.state = FIND_OBJ_DATA; + cur_entry = gc.stored_scan_entry_index; + if (gc.cur_objix_spix == 0) { + // store object index header page + res = spiffs_object_update_index_hdr(fs, 0, gc.cur_obj_id | SPIFFS_OBJ_ID_IX_FLAG, gc.cur_objix_pix, fs->work, 0, 0, &new_objix_pix); + SPIFFS_GC_DBG("gc_clean: MOVE_DATA store modified objix_hdr page, %04x:%04x\n", new_objix_pix, 0); + SPIFFS_CHECK_RES(res); + } else { + // store object index page + res = spiffs_page_move(fs, 0, fs->work, gc.cur_obj_id | SPIFFS_OBJ_ID_IX_FLAG, 0, gc.cur_objix_pix, &new_objix_pix); + SPIFFS_GC_DBG("gc_clean: MOVE_DATA store modified objix page, %04x:%04x\n", new_objix_pix, objix->p_hdr.span_ix); + SPIFFS_CHECK_RES(res); + spiffs_cb_object_event(fs, 0, SPIFFS_EV_IX_UPD, gc.cur_obj_id, objix->p_hdr.span_ix, new_objix_pix, 0); + } + } + break; + case MOVE_OBJ_IX: + gc.state = FINISHED; + break; + default: + cur_entry = 0; + break; + } + SPIFFS_GC_DBG("gc_clean: state-> %i\n", gc.state); + } // while state != FINISHED + + + return res; +} + diff --git a/cores/esp8266/spiffs/spiffs_hydrogen.c b/cores/esp8266/spiffs/spiffs_hydrogen.c new file mode 100755 index 000000000..48a9e91fd --- /dev/null +++ b/cores/esp8266/spiffs/spiffs_hydrogen.c @@ -0,0 +1,871 @@ +/* + * spiffs_hydrogen.c + * + * Created on: Jun 16, 2013 + * Author: petera + */ + +#include "spiffs.h" +#include "spiffs_nucleus.h" + +static s32_t spiffs_fflush_cache(spiffs *fs, spiffs_file fh); + +#if SPIFFS_BUFFER_HELP +u32_t SPIFFS_buffer_bytes_for_filedescs(spiffs *fs, u32_t num_descs) { + return num_descs * sizeof(spiffs_fd); +} +#if SPIFFS_CACHE +u32_t SPIFFS_buffer_bytes_for_cache(spiffs *fs, u32_t num_pages) { + return sizeof(spiffs_cache) + num_pages * (sizeof(spiffs_cache_page) + SPIFFS_CFG_LOG_PAGE_SZ(fs)); +} +#endif +#endif + +s32_t SPIFFS_mount(spiffs *fs, spiffs_config *config, u8_t *work, + u8_t *fd_space, u32_t fd_space_size, + void *cache, u32_t cache_size, + spiffs_check_callback check_cb_f) { + SPIFFS_LOCK(fs); + c_memset(fs, 0, sizeof(spiffs)); + c_memcpy(&fs->cfg, config, sizeof(spiffs_config)); + fs->block_count = SPIFFS_CFG_PHYS_SZ(fs) / SPIFFS_CFG_LOG_BLOCK_SZ(fs); + fs->work = &work[0]; + fs->lu_work = &work[SPIFFS_CFG_LOG_PAGE_SZ(fs)]; + c_memset(fd_space, 0, fd_space_size); + // align fd_space pointer to pointer size byte boundary, below is safe + u8_t ptr_size = sizeof(void*); +// #pragma GCC diagnostic push +// #pragma GCC diagnostic ignored "-Wpointer-to-int-cast" + u8_t addr_lsb = (u8_t)(((u32_t)fd_space) & (ptr_size-1)); +// #pragma GCC diagnostic pop + if (addr_lsb) { + fd_space += (ptr_size-addr_lsb); + fd_space_size -= (ptr_size-addr_lsb); + } + fs->fd_space = fd_space; + fs->fd_count = (fd_space_size/sizeof(spiffs_fd)); + + // align cache pointer to 4 byte boundary, below is safe +// #pragma GCC diagnostic push +// #pragma GCC diagnostic ignored "-Wpointer-to-int-cast" + addr_lsb = (u8_t)(((u32_t)cache) & (ptr_size-1)); +// #pragma GCC diagnostic pop + if (addr_lsb) { + u8_t *cache_8 = (u8_t *)cache; + cache_8 += (ptr_size-addr_lsb); + cache = cache_8; + cache_size -= (ptr_size-addr_lsb); + } + if (cache_size & (ptr_size-1)) { + cache_size -= (cache_size & (ptr_size-1)); + } +#if SPIFFS_CACHE + fs->cache = cache; + fs->cache_size = cache_size; + spiffs_cache_init(fs); +#endif + + s32_t res = spiffs_obj_lu_scan(fs); + SPIFFS_API_CHECK_RES_UNLOCK(fs, res); + + SPIFFS_DBG("page index byte len: %i\n", SPIFFS_CFG_LOG_PAGE_SZ(fs)); + SPIFFS_DBG("object lookup pages: %i\n", SPIFFS_OBJ_LOOKUP_PAGES(fs)); + SPIFFS_DBG("page pages per block: %i\n", SPIFFS_PAGES_PER_BLOCK(fs)); + SPIFFS_DBG("page header length: %i\n", sizeof(spiffs_page_header)); + SPIFFS_DBG("object header index entries: %i\n", SPIFFS_OBJ_HDR_IX_LEN(fs)); + SPIFFS_DBG("object index entries: %i\n", SPIFFS_OBJ_IX_LEN(fs)); + SPIFFS_DBG("available file descriptors: %i\n", fs->fd_count); + SPIFFS_DBG("free blocks: %i\n", fs->free_blocks); + + fs->check_cb_f = check_cb_f; + + SPIFFS_UNLOCK(fs); + + return 0; +} + +void SPIFFS_unmount(spiffs *fs) { + if (!SPIFFS_CHECK_MOUNT(fs)) return; + SPIFFS_LOCK(fs); + u32_t i; + spiffs_fd *fds = (spiffs_fd *)fs->fd_space; + for (i = 0; i < fs->fd_count; i++) { + spiffs_fd *cur_fd = &fds[i]; + if (cur_fd->file_nbr != 0) { +#if SPIFFS_CACHE + (void)spiffs_fflush_cache(fs, cur_fd->file_nbr); +#endif + spiffs_fd_return(fs, cur_fd->file_nbr); + } + } + fs->block_count = 0; + SPIFFS_UNLOCK(fs); +} + +s32_t SPIFFS_errno(spiffs *fs) { + return fs->errno; +} + +s32_t SPIFFS_creat(spiffs *fs, const char *path, spiffs_mode mode) { + (void)mode; + SPIFFS_API_CHECK_MOUNT(fs); + SPIFFS_LOCK(fs); + spiffs_obj_id obj_id; + s32_t res; + + res = spiffs_obj_lu_find_free_obj_id(fs, &obj_id, (u8_t *)path); + SPIFFS_API_CHECK_RES_UNLOCK(fs, res); + res = spiffs_object_create(fs, obj_id, (u8_t *)path, SPIFFS_TYPE_FILE, 0); + SPIFFS_API_CHECK_RES_UNLOCK(fs, res); + SPIFFS_UNLOCK(fs); + return 0; +} + +spiffs_file SPIFFS_open(spiffs *fs, const char *path, spiffs_flags flags, spiffs_mode mode) { + (void)mode; + SPIFFS_API_CHECK_MOUNT(fs); + SPIFFS_LOCK(fs); + + spiffs_fd *fd; + spiffs_page_ix pix; + + s32_t res = spiffs_fd_find_new(fs, &fd); + SPIFFS_API_CHECK_RES_UNLOCK(fs, res); + + res = spiffs_object_find_object_index_header_by_name(fs, (u8_t*)path, &pix); + if ((flags & SPIFFS_CREAT) == 0) { + if (res < SPIFFS_OK) { + spiffs_fd_return(fs, fd->file_nbr); + } + SPIFFS_API_CHECK_RES_UNLOCK(fs, res); + } + + if ((flags & SPIFFS_CREAT) && res == SPIFFS_ERR_NOT_FOUND) { + spiffs_obj_id obj_id; + // no need to enter conflicting name here, already looked for it above + res = spiffs_obj_lu_find_free_obj_id(fs, &obj_id, 0); + if (res < SPIFFS_OK) { + spiffs_fd_return(fs, fd->file_nbr); + } + SPIFFS_API_CHECK_RES_UNLOCK(fs, res); + res = spiffs_object_create(fs, obj_id, (u8_t*)path, SPIFFS_TYPE_FILE, &pix); + if (res < SPIFFS_OK) { + spiffs_fd_return(fs, fd->file_nbr); + } + SPIFFS_API_CHECK_RES_UNLOCK(fs, res); + flags &= ~SPIFFS_TRUNC; + } else { + if (res < SPIFFS_OK) { + spiffs_fd_return(fs, fd->file_nbr); + } + SPIFFS_API_CHECK_RES_UNLOCK(fs, res); + } + res = spiffs_object_open_by_page(fs, pix, fd, flags, mode); + if (res < SPIFFS_OK) { + spiffs_fd_return(fs, fd->file_nbr); + } + SPIFFS_API_CHECK_RES_UNLOCK(fs, res); + if (flags & SPIFFS_TRUNC) { + res = spiffs_object_truncate(fd, 0, 0); + if (res < SPIFFS_OK) { + spiffs_fd_return(fs, fd->file_nbr); + } + SPIFFS_API_CHECK_RES_UNLOCK(fs, res); + } + + fd->fdoffset = 0; + + SPIFFS_UNLOCK(fs); + + return fd->file_nbr; +} + +spiffs_file SPIFFS_open_by_dirent(spiffs *fs, struct spiffs_dirent *e, spiffs_flags flags, spiffs_mode mode) { + SPIFFS_API_CHECK_MOUNT(fs); + SPIFFS_LOCK(fs); + + spiffs_fd *fd; + + s32_t res = spiffs_fd_find_new(fs, &fd); + SPIFFS_API_CHECK_RES_UNLOCK(fs, res); + + res = spiffs_object_open_by_page(fs, e->pix, fd, flags, mode); + if (res < SPIFFS_OK) { + spiffs_fd_return(fs, fd->file_nbr); + } + SPIFFS_API_CHECK_RES_UNLOCK(fs, res); + if (flags & SPIFFS_TRUNC) { + res = spiffs_object_truncate(fd, 0, 0); + if (res < SPIFFS_OK) { + spiffs_fd_return(fs, fd->file_nbr); + } + SPIFFS_API_CHECK_RES_UNLOCK(fs, res); + } + + fd->fdoffset = 0; + + SPIFFS_UNLOCK(fs); + + return fd->file_nbr; +} + +s32_t SPIFFS_read(spiffs *fs, spiffs_file fh, void *buf, u32_t len) { + SPIFFS_API_CHECK_MOUNT(fs); + SPIFFS_LOCK(fs); + + spiffs_fd *fd; + s32_t res; + + res = spiffs_fd_get(fs, fh, &fd); + SPIFFS_API_CHECK_RES_UNLOCK(fs, res); + + if ((fd->flags & SPIFFS_RDONLY) == 0) { + res = SPIFFS_ERR_NOT_READABLE; + SPIFFS_API_CHECK_RES_UNLOCK(fs, res); + } + +#if SPIFFS_CACHE_WR + spiffs_fflush_cache(fs, fh); +#endif + + if (fd->fdoffset + len >= fd->size) { + // reading beyond file size + s32_t avail = fd->size - fd->fdoffset; + if (avail <= 0) { + SPIFFS_API_CHECK_RES_UNLOCK(fs, SPIFFS_ERR_END_OF_OBJECT); + } + res = spiffs_object_read(fd, fd->fdoffset, avail, (u8_t*)buf); + if (res == SPIFFS_ERR_END_OF_OBJECT) { + fd->fdoffset += avail; + SPIFFS_UNLOCK(fs); + return avail; + } else { + SPIFFS_API_CHECK_RES_UNLOCK(fs, res); + len = avail; + } + } else { + // reading within file size + res = spiffs_object_read(fd, fd->fdoffset, len, (u8_t*)buf); + SPIFFS_API_CHECK_RES_UNLOCK(fs, res); + } + fd->fdoffset += len; + + SPIFFS_UNLOCK(fs); + + return len; +} + +static s32_t spiffs_hydro_write(spiffs *fs, spiffs_fd *fd, void *buf, u32_t offset, s32_t len) { + (void)fs; + s32_t res = SPIFFS_OK; + s32_t remaining = len; + if (fd->size != SPIFFS_UNDEFINED_LEN && offset < fd->size) { + s32_t m_len = MIN((s32_t)(fd->size - offset), len); + res = spiffs_object_modify(fd, offset, (u8_t *)buf, m_len); + SPIFFS_CHECK_RES(res); + remaining -= m_len; + u8_t *buf_8 = (u8_t *)buf; + buf_8 += m_len; + buf = buf_8; + offset += m_len; + } + if (remaining > 0) { + res = spiffs_object_append(fd, offset, (u8_t *)buf, remaining); + SPIFFS_CHECK_RES(res); + } + return len; + +} + +s32_t SPIFFS_write(spiffs *fs, spiffs_file fh, void *buf, u32_t len) { + SPIFFS_API_CHECK_MOUNT(fs); + SPIFFS_LOCK(fs); + + spiffs_fd *fd; + s32_t res; + u32_t offset; + + res = spiffs_fd_get(fs, fh, &fd); + SPIFFS_API_CHECK_RES_UNLOCK(fs, res); + + if ((fd->flags & SPIFFS_WRONLY) == 0) { + res = SPIFFS_ERR_NOT_WRITABLE; + SPIFFS_API_CHECK_RES_UNLOCK(fs, res); + } + + offset = fd->fdoffset; + +#if SPIFFS_CACHE_WR + if (fd->cache_page == 0) { + // see if object id is associated with cache already + fd->cache_page = spiffs_cache_page_get_by_fd(fs, fd); + } +#endif + if (fd->flags & SPIFFS_APPEND) { + if (fd->size == SPIFFS_UNDEFINED_LEN) { + offset = 0; + } else { + offset = fd->size; + } +#if SPIFFS_CACHE_WR + if (fd->cache_page) { + offset = MAX(offset, fd->cache_page->offset + fd->cache_page->size); + } +#endif + } + + SPIFFS_DBG("SPIFFS_write %i %04x offs:%i len %i\n", fh, fd->obj_id, offset, len); + +#if SPIFFS_CACHE_WR + if ((fd->flags & SPIFFS_DIRECT) == 0) { + if (len < (s32_t)SPIFFS_CFG_LOG_PAGE_SZ(fs)) { + // small write, try to cache it + u8_t alloc_cpage = 1; + if (fd->cache_page) { + // have a cached page for this fd already, check cache page boundaries + if (offset < fd->cache_page->offset || // writing before cache + offset > fd->cache_page->offset + fd->cache_page->size || // writing after cache + offset + len > fd->cache_page->offset + SPIFFS_CFG_LOG_PAGE_SZ(fs)) // writing beyond cache page + { + // boundary violation, write back cache first and allocate new + SPIFFS_CACHE_DBG("CACHE_WR_DUMP: dumping cache page %i for fd %i:&04x, boundary viol, offs:%i size:%i\n", + fd->cache_page->ix, fd->file_nbr, fd->obj_id, fd->cache_page->offset, fd->cache_page->size); + res = spiffs_hydro_write(fs, fd, + spiffs_get_cache_page(fs, spiffs_get_cache(fs), fd->cache_page->ix), + fd->cache_page->offset, fd->cache_page->size); + spiffs_cache_fd_release(fs, fd->cache_page); + } else { + // writing within cache + alloc_cpage = 0; + } + } + + if (alloc_cpage) { + fd->cache_page = spiffs_cache_page_allocate_by_fd(fs, fd); + if (fd->cache_page) { + fd->cache_page->offset = offset; + fd->cache_page->size = 0; + SPIFFS_CACHE_DBG("CACHE_WR_ALLO: allocating cache page %i for fd %i:%04x\n", + fd->cache_page->ix, fd->file_nbr, fd->obj_id); + } + } + + if (fd->cache_page) { + u32_t offset_in_cpage = offset - fd->cache_page->offset; + SPIFFS_CACHE_DBG("CACHE_WR_WRITE: storing to cache page %i for fd %i:%04x, offs %i:%i len %i\n", + fd->cache_page->ix, fd->file_nbr, fd->obj_id, + offset, offset_in_cpage, len); + spiffs_cache *cache = spiffs_get_cache(fs); + u8_t *cpage_data = spiffs_get_cache_page(fs, cache, fd->cache_page->ix); + c_memcpy(&cpage_data[offset_in_cpage], buf, len); + fd->cache_page->size = MAX(fd->cache_page->size, offset_in_cpage + len); + fd->fdoffset += len; + SPIFFS_UNLOCK(fs); + return len; + } else { + res = spiffs_hydro_write(fs, fd, buf, offset, len); + SPIFFS_API_CHECK_RES(fs, res); + fd->fdoffset += len; + SPIFFS_UNLOCK(fs); + return res; + } + } else { + // big write, no need to cache it - but first check if there is a cached write already + if (fd->cache_page) { + // write back cache first + SPIFFS_CACHE_DBG("CACHE_WR_DUMP: dumping cache page %i for fd %i:%04x, big write, offs:%i size:%i\n", + fd->cache_page->ix, fd->file_nbr, fd->obj_id, fd->cache_page->offset, fd->cache_page->size); + res = spiffs_hydro_write(fs, fd, + spiffs_get_cache_page(fs, spiffs_get_cache(fs), fd->cache_page->ix), + fd->cache_page->offset, fd->cache_page->size); + spiffs_cache_fd_release(fs, fd->cache_page); + res = spiffs_hydro_write(fs, fd, buf, offset, len); + SPIFFS_API_CHECK_RES(fs, res); + } + } + } +#endif + + res = spiffs_hydro_write(fs, fd, buf, offset, len); + SPIFFS_API_CHECK_RES(fs, res); + fd->fdoffset += len; + + SPIFFS_UNLOCK(fs); + + return res; +} + +s32_t SPIFFS_lseek(spiffs *fs, spiffs_file fh, s32_t offs, int whence) { + SPIFFS_API_CHECK_MOUNT(fs); + SPIFFS_LOCK(fs); + + spiffs_fd *fd; + s32_t res; + res = spiffs_fd_get(fs, fh, &fd); + SPIFFS_API_CHECK_RES(fs, res); + +#if SPIFFS_CACHE_WR + spiffs_fflush_cache(fs, fh); +#endif + + switch (whence) { + case SPIFFS_SEEK_CUR: + offs = fd->fdoffset+offs; + break; + case SPIFFS_SEEK_END: + offs = (fd->size == SPIFFS_UNDEFINED_LEN ? 0 : fd->size) + offs; + break; + } + + if (offs > (s32_t)fd->size) { + res = SPIFFS_ERR_END_OF_OBJECT; + } + SPIFFS_API_CHECK_RES_UNLOCK(fs, res); + + spiffs_span_ix data_spix = offs / SPIFFS_DATA_PAGE_SIZE(fs); + spiffs_span_ix objix_spix = SPIFFS_OBJ_IX_ENTRY_SPAN_IX(fs, data_spix); + if (fd->cursor_objix_spix != objix_spix) { + spiffs_page_ix pix; + res = spiffs_obj_lu_find_id_and_span( + fs, fd->obj_id | SPIFFS_OBJ_ID_IX_FLAG, objix_spix, 0, &pix); + SPIFFS_API_CHECK_RES_UNLOCK(fs, res); + fd->cursor_objix_spix = objix_spix; + fd->cursor_objix_pix = pix; + } + fd->fdoffset = offs; + + SPIFFS_UNLOCK(fs); + + return 0; +} + +s32_t SPIFFS_remove(spiffs *fs, const char *path) { + SPIFFS_API_CHECK_MOUNT(fs); + SPIFFS_LOCK(fs); + + spiffs_fd *fd; + spiffs_page_ix pix; + s32_t res; + + res = spiffs_fd_find_new(fs, &fd); + SPIFFS_API_CHECK_RES_UNLOCK(fs, res); + + res = spiffs_object_find_object_index_header_by_name(fs, (u8_t *)path, &pix); + if (res != SPIFFS_OK) { + spiffs_fd_return(fs, fd->file_nbr); + } + SPIFFS_API_CHECK_RES_UNLOCK(fs, res); + + res = spiffs_object_open_by_page(fs, pix, fd, 0,0); + if (res != SPIFFS_OK) { + spiffs_fd_return(fs, fd->file_nbr); + } + SPIFFS_API_CHECK_RES_UNLOCK(fs, res); + + res = spiffs_object_truncate(fd, 0, 1); + if (res != SPIFFS_OK) { + spiffs_fd_return(fs, fd->file_nbr); + } + SPIFFS_API_CHECK_RES_UNLOCK(fs, res); + + SPIFFS_UNLOCK(fs); + return 0; +} + +s32_t SPIFFS_fremove(spiffs *fs, spiffs_file fh) { + SPIFFS_API_CHECK_MOUNT(fs); + SPIFFS_LOCK(fs); + + spiffs_fd *fd; + s32_t res; + res = spiffs_fd_get(fs, fh, &fd); + SPIFFS_API_CHECK_RES_UNLOCK(fs, res); + + if ((fd->flags & SPIFFS_WRONLY) == 0) { + res = SPIFFS_ERR_NOT_WRITABLE; + SPIFFS_API_CHECK_RES_UNLOCK(fs, res); + } + +#if SPIFFS_CACHE_WR + spiffs_cache_fd_release(fs, fd->cache_page); +#endif + + res = spiffs_object_truncate(fd, 0, 1); + + SPIFFS_API_CHECK_RES_UNLOCK(fs, res); + + SPIFFS_UNLOCK(fs); + + return 0; +} + +static s32_t spiffs_stat_pix(spiffs *fs, spiffs_page_ix pix, spiffs_file fh, spiffs_stat *s) { + spiffs_page_object_ix_header objix_hdr; + spiffs_obj_id obj_id; + s32_t res =_spiffs_rd(fs, SPIFFS_OP_T_OBJ_IX | SPIFFS_OP_C_READ, fh, + SPIFFS_PAGE_TO_PADDR(fs, pix), sizeof(spiffs_page_object_ix_header), (u8_t *)&objix_hdr); + SPIFFS_API_CHECK_RES(fs, res); + + u32_t obj_id_addr = SPIFFS_BLOCK_TO_PADDR(fs, SPIFFS_BLOCK_FOR_PAGE(fs , pix)) + + SPIFFS_OBJ_LOOKUP_ENTRY_FOR_PAGE(fs, pix) * sizeof(spiffs_obj_id); + res =_spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU | SPIFFS_OP_C_READ, fh, + obj_id_addr, sizeof(spiffs_obj_id), (u8_t *)&obj_id); + SPIFFS_API_CHECK_RES(fs, res); + + s->obj_id = obj_id; + s->type = objix_hdr.type; + s->size = objix_hdr.size == SPIFFS_UNDEFINED_LEN ? 0 : objix_hdr.size; + strncpy((char *)s->name, (char *)objix_hdr.name, SPIFFS_OBJ_NAME_LEN); + + return res; +} + +s32_t SPIFFS_stat(spiffs *fs, const char *path, spiffs_stat *s) { + SPIFFS_API_CHECK_MOUNT(fs); + SPIFFS_LOCK(fs); + + s32_t res; + spiffs_page_ix pix; + + res = spiffs_object_find_object_index_header_by_name(fs, (u8_t*)path, &pix); + SPIFFS_API_CHECK_RES_UNLOCK(fs, res); + + res = spiffs_stat_pix(fs, pix, 0, s); + + SPIFFS_UNLOCK(fs); + + return res; +} + +s32_t SPIFFS_fstat(spiffs *fs, spiffs_file fh, spiffs_stat *s) { + SPIFFS_API_CHECK_MOUNT(fs); + SPIFFS_LOCK(fs); + + spiffs_fd *fd; + s32_t res; + + res = spiffs_fd_get(fs, fh, &fd); + SPIFFS_API_CHECK_RES_UNLOCK(fs, res); + +#if SPIFFS_CACHE_WR + spiffs_fflush_cache(fs, fh); +#endif + + res = spiffs_stat_pix(fs, fd->objix_hdr_pix, fh, s); + + SPIFFS_UNLOCK(fs); + + return res; +} + +// Checks if there are any cached writes for the object id associated with +// given filehandle. If so, these writes are flushed. +static s32_t spiffs_fflush_cache(spiffs *fs, spiffs_file fh) { + s32_t res = SPIFFS_OK; +#if SPIFFS_CACHE_WR + + spiffs_fd *fd; + res = spiffs_fd_get(fs, fh, &fd); + SPIFFS_API_CHECK_RES(fs, res); + + if ((fd->flags & SPIFFS_DIRECT) == 0) { + if (fd->cache_page == 0) { + // see if object id is associated with cache already + fd->cache_page = spiffs_cache_page_get_by_fd(fs, fd); + } + if (fd->cache_page) { + SPIFFS_CACHE_DBG("CACHE_WR_DUMP: dumping cache page %i for fd %i:%04x, flush, offs:%i size:%i\n", + fd->cache_page->ix, fd->file_nbr, fd->obj_id, fd->cache_page->offset, fd->cache_page->size); + res = spiffs_hydro_write(fs, fd, + spiffs_get_cache_page(fs, spiffs_get_cache(fs), fd->cache_page->ix), + fd->cache_page->offset, fd->cache_page->size); + if (res < SPIFFS_OK) { + fs->errno = res; + } + spiffs_cache_fd_release(fs, fd->cache_page); + } + } +#endif + + return res; +} + +s32_t SPIFFS_fflush(spiffs *fs, spiffs_file fh) { + SPIFFS_API_CHECK_MOUNT(fs); + s32_t res = SPIFFS_OK; +#if SPIFFS_CACHE_WR + SPIFFS_LOCK(fs); + res = spiffs_fflush_cache(fs, fh); + SPIFFS_API_CHECK_RES_UNLOCK(fs,res); + SPIFFS_UNLOCK(fs); +#endif + + return res; +} + +void SPIFFS_close(spiffs *fs, spiffs_file fh) { + if (!SPIFFS_CHECK_MOUNT(fs)) { + fs->errno = SPIFFS_ERR_NOT_MOUNTED; + return; + } + SPIFFS_LOCK(fs); + +#if SPIFFS_CACHE + spiffs_fflush_cache(fs, fh); +#endif + spiffs_fd_return(fs, fh); + + SPIFFS_UNLOCK(fs); +} + +s32_t SPIFFS_rename(spiffs *fs, const char *old, const char *newname) { + SPIFFS_API_CHECK_MOUNT(fs); + SPIFFS_LOCK(fs); + + spiffs_page_ix pix_old, pix_dummy; + spiffs_fd *fd; + + s32_t res = spiffs_object_find_object_index_header_by_name(fs, (u8_t*)old, &pix_old); + SPIFFS_API_CHECK_RES_UNLOCK(fs, res); + + res = spiffs_object_find_object_index_header_by_name(fs, (u8_t*)newname, &pix_dummy); + if (res == SPIFFS_ERR_NOT_FOUND) { + res = SPIFFS_OK; + } else if (res == SPIFFS_OK) { + res = SPIFFS_ERR_CONFLICTING_NAME; + } + SPIFFS_API_CHECK_RES_UNLOCK(fs, res); + + res = spiffs_fd_find_new(fs, &fd); + SPIFFS_API_CHECK_RES_UNLOCK(fs, res); + + res = spiffs_object_open_by_page(fs, pix_old, fd, 0, 0); + if (res != SPIFFS_OK) { + spiffs_fd_return(fs, fd->file_nbr); + } + SPIFFS_API_CHECK_RES_UNLOCK(fs, res); + + res = spiffs_object_update_index_hdr(fs, fd, fd->obj_id, fd->objix_hdr_pix, 0, (u8_t*)newname, + 0, &pix_dummy); + + if (res != SPIFFS_OK) { + spiffs_fd_return(fs, fd->file_nbr); + } + SPIFFS_API_CHECK_RES_UNLOCK(fs, res); + + SPIFFS_UNLOCK(fs); + + return res; +} + +spiffs_DIR *SPIFFS_opendir(spiffs *fs, const char *name, spiffs_DIR *d) { + (void)name; + if (!SPIFFS_CHECK_MOUNT(fs)) { + fs->errno = SPIFFS_ERR_NOT_MOUNTED; + return 0; + } + d->fs = fs; + d->block = 0; + d->entry = 0; + return d; +} + +static s32_t spiffs_read_dir_v( + spiffs *fs, + spiffs_obj_id obj_id, + spiffs_block_ix bix, + int ix_entry, + u32_t user_data, + void *user_p) { + (void)user_data; + s32_t res; + spiffs_page_object_ix_header objix_hdr; + if (obj_id == SPIFFS_OBJ_ID_FREE || obj_id == SPIFFS_OBJ_ID_DELETED || + (obj_id & SPIFFS_OBJ_ID_IX_FLAG) == 0) { + return SPIFFS_VIS_COUNTINUE; + } + + spiffs_page_ix pix = SPIFFS_OBJ_LOOKUP_ENTRY_TO_PIX(fs, bix, ix_entry); + res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU2 | SPIFFS_OP_C_READ, + 0, SPIFFS_PAGE_TO_PADDR(fs, pix), sizeof(spiffs_page_object_ix_header), (u8_t *)&objix_hdr); + if (res != SPIFFS_OK) return res; + if ((obj_id & SPIFFS_OBJ_ID_IX_FLAG) && + objix_hdr.p_hdr.span_ix == 0 && + (objix_hdr.p_hdr.flags& (SPIFFS_PH_FLAG_DELET | SPIFFS_PH_FLAG_FINAL | SPIFFS_PH_FLAG_IXDELE)) == + (SPIFFS_PH_FLAG_DELET | SPIFFS_PH_FLAG_IXDELE)) { + struct spiffs_dirent *e = (struct spiffs_dirent *)user_p; + e->obj_id = obj_id; + strcpy((char *)e->name, (char *)objix_hdr.name); + e->type = objix_hdr.type; + e->size = objix_hdr.size == SPIFFS_UNDEFINED_LEN ? 0 : objix_hdr.size; + e->pix = pix; + return SPIFFS_OK; + } + + return SPIFFS_VIS_COUNTINUE; +} + +struct spiffs_dirent *SPIFFS_readdir(spiffs_DIR *d, struct spiffs_dirent *e) { + if (!SPIFFS_CHECK_MOUNT(d->fs)) { + d->fs->errno = SPIFFS_ERR_NOT_MOUNTED; + return 0; + } + SPIFFS_LOCK(fs); + + spiffs_block_ix bix; + int entry; + s32_t res; + struct spiffs_dirent *ret = 0; + + res = spiffs_obj_lu_find_entry_visitor(d->fs, + d->block, + d->entry, + SPIFFS_VIS_NO_WRAP, + 0, + spiffs_read_dir_v, + 0, + e, + &bix, + &entry); + if (res == SPIFFS_OK) { + d->block = bix; + d->entry = entry + 1; + ret = e; + } else { + d->fs->errno = res; + } + SPIFFS_UNLOCK(fs); + return ret; +} + +s32_t SPIFFS_closedir(spiffs_DIR *d) { + SPIFFS_API_CHECK_MOUNT(d->fs); + return 0; +} + +s32_t SPIFFS_check(spiffs *fs) { + s32_t res; + SPIFFS_API_CHECK_MOUNT(fs); + SPIFFS_LOCK(fs); + + res = spiffs_lookup_consistency_check(fs, 0); + + res = spiffs_object_index_consistency_check(fs); + + res = spiffs_page_consistency_check(fs); + + res = spiffs_obj_lu_scan(fs); + + SPIFFS_UNLOCK(fs); + return res; +} + +s32_t SPIFFS_eof(spiffs *fs, spiffs_file fh) { + SPIFFS_API_CHECK_MOUNT(fs); + SPIFFS_LOCK(fs); + + spiffs_fd *fd; + s32_t res; + res = spiffs_fd_get(fs, fh, &fd); + SPIFFS_API_CHECK_RES(fs, res); + +#if SPIFFS_CACHE_WR + spiffs_fflush_cache(fs, fh); +#endif + + res = (fd->fdoffset == fd->size); + + SPIFFS_UNLOCK(fs); + return res; +} + +s32_t SPIFFS_tell(spiffs *fs, spiffs_file fh) { + SPIFFS_API_CHECK_MOUNT(fs); + SPIFFS_LOCK(fs); + + spiffs_fd *fd; + s32_t res; + res = spiffs_fd_get(fs, fh, &fd); + SPIFFS_API_CHECK_RES(fs, res); + +#if SPIFFS_CACHE_WR + spiffs_fflush_cache(fs, fh); +#endif + + res = fd->fdoffset; + + SPIFFS_UNLOCK(fs); + return res; +} + +#if SPIFFS_TEST_VISUALISATION +s32_t SPIFFS_vis(spiffs *fs) { + s32_t res = SPIFFS_OK; + SPIFFS_API_CHECK_MOUNT(fs); + SPIFFS_LOCK(fs); + + int entries_per_page = (SPIFFS_CFG_LOG_PAGE_SZ(fs) / sizeof(spiffs_obj_id)); + spiffs_obj_id *obj_lu_buf = (spiffs_obj_id *)fs->lu_work; + spiffs_block_ix bix = 0; + + while (bix < fs->block_count) { + // check each object lookup page + int obj_lookup_page = 0; + int cur_entry = 0; + + while (res == SPIFFS_OK && obj_lookup_page < (int)SPIFFS_OBJ_LOOKUP_PAGES(fs)) { + int entry_offset = obj_lookup_page * entries_per_page; + res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU | SPIFFS_OP_C_READ, + 0, bix * SPIFFS_CFG_LOG_BLOCK_SZ(fs) + SPIFFS_PAGE_TO_PADDR(fs, obj_lookup_page), SPIFFS_CFG_LOG_PAGE_SZ(fs), fs->lu_work); + // check each entry + while (res == SPIFFS_OK && + cur_entry - entry_offset < entries_per_page && cur_entry < (int)(SPIFFS_PAGES_PER_BLOCK(fs)-SPIFFS_OBJ_LOOKUP_PAGES(fs))) { + spiffs_obj_id obj_id = obj_lu_buf[cur_entry-entry_offset]; + if (cur_entry == 0) { + spiffs_printf("%4i ", bix); + } else if ((cur_entry & 0x3f) == 0) { + spiffs_printf(" "); + } + if (obj_id == SPIFFS_OBJ_ID_FREE) { + spiffs_printf(SPIFFS_TEST_VIS_FREE_STR); + } else if (obj_id == SPIFFS_OBJ_ID_DELETED) { + spiffs_printf(SPIFFS_TEST_VIS_DELE_STR); + } else if (obj_id & SPIFFS_OBJ_ID_IX_FLAG){ + spiffs_printf(SPIFFS_TEST_VIS_INDX_STR(obj_id)); + } else { + spiffs_printf(SPIFFS_TEST_VIS_DATA_STR(obj_id)); + } + cur_entry++; + if ((cur_entry & 0x3f) == 0) { + spiffs_printf("\n"); + } + } // per entry + obj_lookup_page++; + } // per object lookup page + + spiffs_obj_id erase_count; + res = _spiffs_rd(fs, SPIFFS_OP_C_READ | SPIFFS_OP_T_OBJ_LU2, 0, + SPIFFS_ERASE_COUNT_PADDR(fs, bix), + sizeof(spiffs_obj_id), (u8_t *)&erase_count); + SPIFFS_CHECK_RES(res); + + if (erase_count != (spiffs_obj_id)-1) { + spiffs_printf("\tera_cnt: %i\n", erase_count); + } else { + spiffs_printf("\tera_cnt: N/A\n"); + } + + bix++; + } // per block + + spiffs_printf("era_cnt_max: %i\n", fs->max_erase_count); + spiffs_printf("last_errno: %i\n", fs->errno); + spiffs_printf("blocks: %i\n", fs->block_count); + spiffs_printf("free_blocks: %i\n", fs->free_blocks); + spiffs_printf("page_alloc: %i\n", fs->stats_p_allocated); + spiffs_printf("page_delet: %i\n", fs->stats_p_deleted); + + SPIFFS_UNLOCK(fs); + return res; +} +#endif diff --git a/cores/esp8266/spiffs/spiffs_nucleus.c b/cores/esp8266/spiffs/spiffs_nucleus.c new file mode 100755 index 000000000..74217cd0a --- /dev/null +++ b/cores/esp8266/spiffs/spiffs_nucleus.c @@ -0,0 +1,1794 @@ +#include "spiffs.h" +#include "spiffs_nucleus.h" + +static s32_t spiffs_page_data_check(spiffs *fs, spiffs_fd *fd, spiffs_page_ix pix, spiffs_span_ix spix) { + s32_t res = SPIFFS_OK; + if (pix == (spiffs_page_ix)-1) { + // referring to page 0xffff...., bad object index + return SPIFFS_ERR_INDEX_REF_FREE; + } + if (pix % SPIFFS_PAGES_PER_BLOCK(fs) < SPIFFS_OBJ_LOOKUP_PAGES(fs)) { + // referring to an object lookup page, bad object index + return SPIFFS_ERR_INDEX_REF_LU; + } + if (pix > SPIFFS_MAX_PAGES(fs)) { + // referring to a bad page + return SPIFFS_ERR_INDEX_REF_INVALID; + } +#if SPIFFS_PAGE_CHECK + spiffs_page_header ph; + res = _spiffs_rd( + fs, SPIFFS_OP_T_OBJ_DA | SPIFFS_OP_C_READ, + fd->file_nbr, + SPIFFS_PAGE_TO_PADDR(fs, pix), + sizeof(spiffs_page_header), + (u8_t *)&ph); + SPIFFS_CHECK_RES(res); + SPIFFS_VALIDATE_DATA(ph, fd->obj_id & ~SPIFFS_OBJ_ID_IX_FLAG, spix); +#endif + return res; +} + +static s32_t spiffs_page_index_check(spiffs *fs, spiffs_fd *fd, spiffs_page_ix pix, spiffs_span_ix spix) { + s32_t res = SPIFFS_OK; + if (pix == (spiffs_page_ix)-1) { + // referring to page 0xffff...., bad object index + return SPIFFS_ERR_INDEX_FREE; + } + if (pix % SPIFFS_PAGES_PER_BLOCK(fs) < SPIFFS_OBJ_LOOKUP_PAGES(fs)) { + // referring to an object lookup page, bad object index + return SPIFFS_ERR_INDEX_LU; + } + if (pix > SPIFFS_MAX_PAGES(fs)) { + // referring to a bad page + return SPIFFS_ERR_INDEX_INVALID; + } +#if SPIFFS_PAGE_CHECK + spiffs_page_header ph; + res = _spiffs_rd( + fs, SPIFFS_OP_T_OBJ_IX | SPIFFS_OP_C_READ, + fd->file_nbr, + SPIFFS_PAGE_TO_PADDR(fs, pix), + sizeof(spiffs_page_header), + (u8_t *)&ph); + SPIFFS_CHECK_RES(res); + SPIFFS_VALIDATE_OBJIX(ph, fd->obj_id, spix); +#endif + return res; +} + +#if !SPIFFS_CACHE + +s32_t spiffs_phys_rd( + spiffs *fs, + u32_t addr, + u32_t len, + u8_t *dst) { + return fs->cfg.hal_read_f(addr, len, dst); +} + +s32_t spiffs_phys_wr( + spiffs *fs, + u32_t addr, + u32_t len, + u8_t *src) { + return fs->cfg.hal_write_f(addr, len, src); +} + +#endif + +s32_t spiffs_phys_cpy( + spiffs *fs, + spiffs_file fh, + u32_t dst, + u32_t src, + u32_t len) { + s32_t res; + u8_t b[SPIFFS_COPY_BUFFER_STACK]; + while (len > 0) { + u32_t chunk_size = MIN(SPIFFS_COPY_BUFFER_STACK, len); + res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_DA | SPIFFS_OP_C_MOVS, fh, src, chunk_size, b); + SPIFFS_CHECK_RES(res); + res = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_DA | SPIFFS_OP_C_MOVD, fh, dst, chunk_size, b); + SPIFFS_CHECK_RES(res); + len -= chunk_size; + src += chunk_size; + dst += chunk_size; + } + return SPIFFS_OK; +} + +// Find object lookup entry containing given id with visitor. +// Iterate over object lookup pages in each block until a given object id entry is found. +// When found, the visitor function is called with block index, entry index and user_data. +// If visitor returns SPIFFS_VIS_CONTINUE, the search goes on. Otherwise, the search will be +// ended and visitor's return code is returned to caller. +// If no visitor is given (0) the search returns on first entry with matching object id. +// If no match is found in all look up, SPIFFS_VIS_END is returned. +// @param fs the file system +// @param starting_block the starting block to start search in +// @param starting_lu_entry the look up index entry to start search in +// @param flags ored combination of SPIFFS_VIS_CHECK_ID, SPIFFS_VIS_CHECK_PH, +// SPIFFS_VIS_NO_WRAP +// @param obj_id argument object id +// @param v visitor callback function +// @param user_data any data, passed to the callback visitor function +// @param user_p any pointer, passed to the callback visitor function +// @param block_ix reported block index where match was found +// @param lu_entry reported look up index where match was found +s32_t spiffs_obj_lu_find_entry_visitor( + spiffs *fs, + spiffs_block_ix starting_block, + int starting_lu_entry, + u8_t flags, + spiffs_obj_id obj_id, + spiffs_visitor_f v, + u32_t user_data, + void *user_p, + spiffs_block_ix *block_ix, + int *lu_entry) { + s32_t res = SPIFFS_OK; + s32_t entry_count = fs->block_count * SPIFFS_OBJ_LOOKUP_MAX_ENTRIES(fs); + spiffs_block_ix cur_block = starting_block; + u32_t cur_block_addr = starting_block * SPIFFS_CFG_LOG_BLOCK_SZ(fs); + + spiffs_obj_id *obj_lu_buf = (spiffs_obj_id *)fs->lu_work; + int cur_entry = starting_lu_entry; + int entries_per_page = (SPIFFS_CFG_LOG_PAGE_SZ(fs) / sizeof(spiffs_obj_id)); + + // wrap initial + if (cur_entry >= (int)SPIFFS_OBJ_LOOKUP_MAX_ENTRIES(fs) - 1) { + cur_entry = 0; + cur_block++; + cur_block_addr = cur_block * SPIFFS_CFG_LOG_BLOCK_SZ(fs); + if (cur_block >= fs->block_count) { + // block wrap + cur_block = 0; + cur_block_addr = 0; + } + } + + // check each block + while (res == SPIFFS_OK && entry_count > 0) { + int obj_lookup_page = cur_entry / entries_per_page; + // check each object lookup page + while (res == SPIFFS_OK && obj_lookup_page < (int)SPIFFS_OBJ_LOOKUP_PAGES(fs)) { + int entry_offset = obj_lookup_page * entries_per_page; + res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU | SPIFFS_OP_C_READ, + 0, cur_block_addr + SPIFFS_PAGE_TO_PADDR(fs, obj_lookup_page), SPIFFS_CFG_LOG_PAGE_SZ(fs), fs->lu_work); + // check each entry + while (res == SPIFFS_OK && + cur_entry - entry_offset < entries_per_page && // for non-last obj lookup pages + cur_entry < (int)SPIFFS_OBJ_LOOKUP_MAX_ENTRIES(fs)) // for last obj lookup page + { + if ((flags & SPIFFS_VIS_CHECK_ID) == 0 || obj_lu_buf[cur_entry-entry_offset] == obj_id) { + if (block_ix) *block_ix = cur_block; + if (lu_entry) *lu_entry = cur_entry; + if (v) { + res = v( + fs, + (flags & SPIFFS_VIS_CHECK_PH) ? obj_id : obj_lu_buf[cur_entry-entry_offset], + cur_block, + cur_entry, + user_data, + user_p); + if (res == SPIFFS_VIS_COUNTINUE || res == SPIFFS_VIS_COUNTINUE_RELOAD) { + if (res == SPIFFS_VIS_COUNTINUE_RELOAD) { + res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU | SPIFFS_OP_C_READ, + 0, cur_block_addr + SPIFFS_PAGE_TO_PADDR(fs, obj_lookup_page), SPIFFS_CFG_LOG_PAGE_SZ(fs), fs->lu_work); + SPIFFS_CHECK_RES(res); + } + res = SPIFFS_OK; + cur_entry++; + entry_count--; + continue; + } else { + return res; + } + } else { + return SPIFFS_OK; + } + } + entry_count--; + cur_entry++; + } // per entry + obj_lookup_page++; + } // per object lookup page + cur_entry = 0; + cur_block++; + cur_block_addr += SPIFFS_CFG_LOG_BLOCK_SZ(fs); + if (cur_block >= fs->block_count) { + if (flags & SPIFFS_VIS_NO_WRAP) { + return SPIFFS_VIS_END; + } else { + // block wrap + cur_block = 0; + cur_block_addr = 0; + } + } + } // per block + + SPIFFS_CHECK_RES(res); + + return SPIFFS_VIS_END; +} + + +static s32_t spiffs_obj_lu_scan_v( + spiffs *fs, + spiffs_obj_id obj_id, + spiffs_block_ix bix, + int ix_entry, + u32_t user_data, + void *user_p) { + (void)bix; + (void)user_data; + (void)user_p; + if (obj_id == SPIFFS_OBJ_ID_FREE) { + if (ix_entry == 0) { + fs->free_blocks++; + // todo optimize further, return SPIFFS_NEXT_BLOCK + } + } else if (obj_id == SPIFFS_OBJ_ID_DELETED) { + fs->stats_p_deleted++; + } else { + fs->stats_p_allocated++; + } + + return SPIFFS_VIS_COUNTINUE; +} + +// Scans thru all obj lu and counts free, deleted and used pages +// Find the maximum block erase count +s32_t spiffs_obj_lu_scan( + spiffs *fs) { + s32_t res; + spiffs_block_ix bix; + int entry; + + fs->free_blocks = 0; + fs->stats_p_allocated = 0; + fs->stats_p_deleted = 0; + + res = spiffs_obj_lu_find_entry_visitor(fs, + 0, + 0, + 0, + 0, + spiffs_obj_lu_scan_v, + 0, + 0, + &bix, + &entry); + + if (res == SPIFFS_VIS_END) { + res = SPIFFS_OK; + } + + SPIFFS_CHECK_RES(res); + + bix = 0; + spiffs_obj_id erase_count_final; + spiffs_obj_id erase_count_min = SPIFFS_OBJ_ID_FREE; + spiffs_obj_id erase_count_max = 0; + while (bix < fs->block_count) { + spiffs_obj_id erase_count; + res = _spiffs_rd(fs, + SPIFFS_OP_T_OBJ_LU2 | SPIFFS_OP_C_READ, + 0, SPIFFS_ERASE_COUNT_PADDR(fs, bix) , + sizeof(spiffs_obj_id), (u8_t *)&erase_count); + SPIFFS_CHECK_RES(res); + if (erase_count != SPIFFS_OBJ_ID_FREE) { + erase_count_min = MIN(erase_count_min, erase_count); + erase_count_max = MAX(erase_count_max, erase_count); + } + bix++; + } + + if (erase_count_min == 0 && erase_count_max == SPIFFS_OBJ_ID_FREE) { + // clean system, set counter to zero + erase_count_final = 0; + } else if (erase_count_max - erase_count_min > (SPIFFS_OBJ_ID_FREE)/2) { + // wrap, take min + erase_count_final = erase_count_min+1; + } else { + erase_count_final = erase_count_max+1; + } + + fs->max_erase_count = erase_count_final; + + return res; +} + +// Find free object lookup entry +// Iterate over object lookup pages in each block until a free object id entry is found +s32_t spiffs_obj_lu_find_free( + spiffs *fs, + spiffs_block_ix starting_block, + int starting_lu_entry, + spiffs_block_ix *block_ix, + int *lu_entry) { + s32_t res; + if (!fs->cleaning && fs->free_blocks < 2) { + res = spiffs_gc_quick(fs); + SPIFFS_CHECK_RES(res); + if (fs->free_blocks < 2) { + return SPIFFS_ERR_FULL; + } + } + res = spiffs_obj_lu_find_id(fs, starting_block, starting_lu_entry, + SPIFFS_OBJ_ID_FREE, block_ix, lu_entry); + if (res == SPIFFS_OK) { + fs->free_cursor_block_ix = *block_ix; + fs->free_cursor_obj_lu_entry = *lu_entry; + if (*lu_entry == 0) { + fs->free_blocks--; + } + } + if (res == SPIFFS_VIS_END) { + SPIFFS_DBG("fs full\n"); + } + + return res == SPIFFS_VIS_END ? SPIFFS_ERR_FULL : res; +} + +// Find object lookup entry containing given id +// Iterate over object lookup pages in each block until a given object id entry is found +s32_t spiffs_obj_lu_find_id( + spiffs *fs, + spiffs_block_ix starting_block, + int starting_lu_entry, + spiffs_obj_id obj_id, + spiffs_block_ix *block_ix, + int *lu_entry) { + s32_t res = spiffs_obj_lu_find_entry_visitor( + fs, starting_block, starting_lu_entry, SPIFFS_VIS_CHECK_ID, obj_id, 0, 0, 0, block_ix, lu_entry); + if (res == SPIFFS_VIS_END) { + res = SPIFFS_ERR_NOT_FOUND; + } + return res; +} + + +static s32_t spiffs_obj_lu_find_id_and_span_v( + spiffs *fs, + spiffs_obj_id obj_id, + spiffs_block_ix bix, + int ix_entry, + u32_t user_data, + void *user_p) { + s32_t res; + spiffs_page_header ph; + spiffs_page_ix pix = SPIFFS_OBJ_LOOKUP_ENTRY_TO_PIX(fs, bix, ix_entry); + res = _spiffs_rd(fs, 0, SPIFFS_OP_T_OBJ_LU2 | SPIFFS_OP_C_READ, + SPIFFS_PAGE_TO_PADDR(fs, pix), sizeof(spiffs_page_header), (u8_t *)&ph); + SPIFFS_CHECK_RES(res); + if (ph.obj_id == obj_id && + ph.span_ix == (spiffs_span_ix)user_data && + (ph.flags & (SPIFFS_PH_FLAG_FINAL | SPIFFS_PH_FLAG_DELET | SPIFFS_PH_FLAG_USED)) == SPIFFS_PH_FLAG_DELET && + !((obj_id & SPIFFS_OBJ_ID_IX_FLAG) && (ph.flags & SPIFFS_PH_FLAG_IXDELE) == 0 && ph.span_ix == 0) && + (user_p == 0 || *((spiffs_page_ix *)user_p) != pix)) { + return SPIFFS_OK; + } else { + return SPIFFS_VIS_COUNTINUE; + } +} + +// Find object lookup entry containing given id and span index +// Iterate over object lookup pages in each block until a given object id entry is found +s32_t spiffs_obj_lu_find_id_and_span( + spiffs *fs, + spiffs_obj_id obj_id, + spiffs_span_ix spix, + spiffs_page_ix exclusion_pix, + spiffs_page_ix *pix) { + s32_t res; + spiffs_block_ix bix; + int entry; + + res = spiffs_obj_lu_find_entry_visitor(fs, + fs->cursor_block_ix, + fs->cursor_obj_lu_entry, + SPIFFS_VIS_CHECK_ID, + obj_id, + spiffs_obj_lu_find_id_and_span_v, + (u32_t)spix, + exclusion_pix ? &exclusion_pix : 0, + &bix, + &entry); + + if (res == SPIFFS_VIS_END) { + res = SPIFFS_ERR_NOT_FOUND; + } + + SPIFFS_CHECK_RES(res); + + if (pix) { + *pix = SPIFFS_OBJ_LOOKUP_ENTRY_TO_PIX(fs, bix, entry); + } + + fs->cursor_block_ix = bix; + fs->cursor_obj_lu_entry = entry; + + return res; +} + +// Find object lookup entry containing given id and span index in page headers only +// Iterate over object lookup pages in each block until a given object id entry is found +s32_t spiffs_obj_lu_find_id_and_span_by_phdr( + spiffs *fs, + spiffs_obj_id obj_id, + spiffs_span_ix spix, + spiffs_page_ix exclusion_pix, + spiffs_page_ix *pix) { + s32_t res; + spiffs_block_ix bix; + int entry; + + res = spiffs_obj_lu_find_entry_visitor(fs, + fs->cursor_block_ix, + fs->cursor_obj_lu_entry, + SPIFFS_VIS_CHECK_PH, + obj_id, + spiffs_obj_lu_find_id_and_span_v, + (u32_t)spix, + exclusion_pix ? &exclusion_pix : 0, + &bix, + &entry); + + if (res == SPIFFS_VIS_END) { + res = SPIFFS_ERR_NOT_FOUND; + } + + SPIFFS_CHECK_RES(res); + + if (pix) { + *pix = SPIFFS_OBJ_LOOKUP_ENTRY_TO_PIX(fs, bix, entry); + } + + fs->cursor_block_ix = bix; + fs->cursor_obj_lu_entry = entry; + + return res; +} + +// Allocates a free defined page with given obj_id +// Occupies object lookup entry and page +// data may be NULL; where only page header is stored, len and page_offs is ignored +s32_t spiffs_page_allocate_data( + spiffs *fs, + spiffs_obj_id obj_id, + spiffs_page_header *ph, + u8_t *data, + u32_t len, + u32_t page_offs, + u8_t finalize, + spiffs_page_ix *pix) { + s32_t res = SPIFFS_OK; + spiffs_block_ix bix; + int entry; + + // find free entry + res = spiffs_obj_lu_find_free(fs, fs->free_cursor_block_ix, fs->free_cursor_obj_lu_entry, &bix, &entry); + SPIFFS_CHECK_RES(res); + + // occupy page in object lookup + res = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_LU | SPIFFS_OP_C_UPDT, + 0, SPIFFS_BLOCK_TO_PADDR(fs, bix) + entry * sizeof(spiffs_obj_id), sizeof(spiffs_obj_id), (u8_t*)&obj_id); + SPIFFS_CHECK_RES(res); + + fs->stats_p_allocated++; + + // write page header + ph->flags &= ~SPIFFS_PH_FLAG_USED; + res = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_DA | SPIFFS_OP_C_UPDT, + 0, SPIFFS_OBJ_LOOKUP_ENTRY_TO_PADDR(fs, bix, entry), sizeof(spiffs_page_header), (u8_t*)ph); + SPIFFS_CHECK_RES(res); + + // write page data + if (data) { + res = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_DA | SPIFFS_OP_C_UPDT, + 0,SPIFFS_OBJ_LOOKUP_ENTRY_TO_PADDR(fs, bix, entry) + sizeof(spiffs_page_header) + page_offs, len, data); + SPIFFS_CHECK_RES(res); + } + + // finalize header if necessary + if (finalize && (ph->flags & SPIFFS_PH_FLAG_FINAL)) { + ph->flags &= ~SPIFFS_PH_FLAG_FINAL; + res = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_DA | SPIFFS_OP_C_UPDT, + 0, SPIFFS_OBJ_LOOKUP_ENTRY_TO_PADDR(fs, bix, entry) + offsetof(spiffs_page_header, flags), + sizeof(u8_t), + (u8_t *)&ph->flags); + SPIFFS_CHECK_RES(res); + } + + // return written page + if (pix) { + *pix = SPIFFS_OBJ_LOOKUP_ENTRY_TO_PIX(fs, bix, entry); + } + + return res; +} + +// Moves a page from src to a free page and finalizes it. Updates page index. Page data is given in param page. +// If page data is null, provided header is used for metainfo and page data is physically copied. +s32_t spiffs_page_move( + spiffs *fs, + spiffs_file fh, + u8_t *page_data, + spiffs_obj_id obj_id, + spiffs_page_header *page_hdr, + spiffs_page_ix src_pix, + spiffs_page_ix *dst_pix) { + s32_t res; + u8_t was_final = 0; + spiffs_page_header *p_hdr; + spiffs_block_ix bix; + int entry; + spiffs_page_ix free_pix; + + // find free entry + res = spiffs_obj_lu_find_free(fs, fs->free_cursor_block_ix, fs->free_cursor_obj_lu_entry, &bix, &entry); + SPIFFS_CHECK_RES(res); + free_pix = SPIFFS_OBJ_LOOKUP_ENTRY_TO_PIX(fs, bix, entry); + + if (dst_pix) *dst_pix = free_pix; + + p_hdr = page_data ? (spiffs_page_header *)page_data : page_hdr; + if (page_data) { + // got page data + was_final = (p_hdr->flags & SPIFFS_PH_FLAG_FINAL) == 0; + // write unfinalized page + p_hdr->flags |= SPIFFS_PH_FLAG_FINAL; + p_hdr->flags &= ~SPIFFS_PH_FLAG_USED; + res = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_DA | SPIFFS_OP_C_UPDT, + 0, SPIFFS_PAGE_TO_PADDR(fs, free_pix), SPIFFS_CFG_LOG_PAGE_SZ(fs), page_data); + } else { + // copy page data + res = spiffs_phys_cpy(fs, fh, SPIFFS_PAGE_TO_PADDR(fs, free_pix), SPIFFS_PAGE_TO_PADDR(fs, src_pix), SPIFFS_CFG_LOG_PAGE_SZ(fs)); + } + SPIFFS_CHECK_RES(res); + + // mark entry in destination object lookup + res = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_LU | SPIFFS_OP_C_UPDT, + 0, SPIFFS_BLOCK_TO_PADDR(fs, SPIFFS_BLOCK_FOR_PAGE(fs, free_pix)) + SPIFFS_OBJ_LOOKUP_ENTRY_FOR_PAGE(fs, free_pix) * sizeof(spiffs_page_ix), + sizeof(spiffs_obj_id), + (u8_t *)&obj_id); + SPIFFS_CHECK_RES(res); + + fs->stats_p_allocated++; + + if (was_final) { + // mark finalized in destination page + p_hdr->flags &= ~(SPIFFS_PH_FLAG_FINAL | SPIFFS_PH_FLAG_USED); + res = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_DA | SPIFFS_OP_C_UPDT, + fh, + SPIFFS_PAGE_TO_PADDR(fs, free_pix) + offsetof(spiffs_page_header, flags), + sizeof(u8_t), + (u8_t *)&p_hdr->flags); + SPIFFS_CHECK_RES(res); + } + // mark source deleted + res = spiffs_page_delete(fs, src_pix); + return res; +} + +// Deletes a page and removes it from object lookup. +s32_t spiffs_page_delete( + spiffs *fs, + spiffs_page_ix pix) { + s32_t res; + spiffs_page_header hdr; + hdr.flags = 0xff & ~(SPIFFS_PH_FLAG_DELET | SPIFFS_PH_FLAG_USED); + // mark deleted entry in source object lookup + spiffs_obj_id d_obj_id = SPIFFS_OBJ_ID_DELETED; + res = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_LU | SPIFFS_OP_C_DELE, + 0, + SPIFFS_BLOCK_TO_PADDR(fs, SPIFFS_BLOCK_FOR_PAGE(fs, pix)) + SPIFFS_OBJ_LOOKUP_ENTRY_FOR_PAGE(fs, pix) * sizeof(spiffs_page_ix), + sizeof(spiffs_obj_id), + (u8_t *)&d_obj_id); + SPIFFS_CHECK_RES(res); + + fs->stats_p_deleted++; + fs->stats_p_allocated--; + + // mark deleted in source page + res = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_DA | SPIFFS_OP_C_DELE, + 0, + SPIFFS_PAGE_TO_PADDR(fs, pix) + offsetof(spiffs_page_header, flags), + sizeof(u8_t), + (u8_t *)&hdr.flags); + + return res; +} + +// Create an object index header page with empty index and undefined length +s32_t spiffs_object_create( + spiffs *fs, + spiffs_obj_id obj_id, + u8_t name[SPIFFS_OBJ_NAME_LEN], + spiffs_obj_type type, + spiffs_page_ix *objix_hdr_pix) { + s32_t res = SPIFFS_OK; + spiffs_block_ix bix; + spiffs_page_object_ix_header oix_hdr; + int entry; + + res = spiffs_gc_check(fs, 0); + SPIFFS_CHECK_RES(res); + + obj_id |= SPIFFS_OBJ_ID_IX_FLAG; + + // find free entry + res = spiffs_obj_lu_find_free(fs, fs->free_cursor_block_ix, fs->free_cursor_obj_lu_entry, &bix, &entry); + SPIFFS_CHECK_RES(res); + SPIFFS_DBG("create: found free page @ %04x bix:%i entry:%i\n", SPIFFS_OBJ_LOOKUP_ENTRY_TO_PIX(fs, bix, entry), bix, entry); + + // occupy page in object lookup + res = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_LU | SPIFFS_OP_C_UPDT, + 0, SPIFFS_BLOCK_TO_PADDR(fs, bix) + entry * sizeof(spiffs_obj_id), sizeof(spiffs_obj_id), (u8_t*)&obj_id); + SPIFFS_CHECK_RES(res); + + fs->stats_p_allocated++; + + // write empty object index page + oix_hdr.p_hdr.obj_id = obj_id; + oix_hdr.p_hdr.span_ix = 0; + oix_hdr.p_hdr.flags = 0xff & ~(SPIFFS_PH_FLAG_FINAL | SPIFFS_PH_FLAG_INDEX | SPIFFS_PH_FLAG_USED); + oix_hdr.type = type; + oix_hdr.size = SPIFFS_UNDEFINED_LEN; // keep ones so we can update later without wasting this page + strncpy((char *)&oix_hdr.name, (char *)name, SPIFFS_OBJ_NAME_LEN); + + + // update page + res = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_DA | SPIFFS_OP_C_UPDT, + 0, SPIFFS_OBJ_LOOKUP_ENTRY_TO_PADDR(fs, bix, entry), sizeof(spiffs_page_object_ix_header), (u8_t*)&oix_hdr); + + SPIFFS_CHECK_RES(res); + spiffs_cb_object_event(fs, 0, SPIFFS_EV_IX_NEW, obj_id, 0, SPIFFS_OBJ_LOOKUP_ENTRY_TO_PIX(fs, bix, entry), SPIFFS_UNDEFINED_LEN); + + if (objix_hdr_pix) { + *objix_hdr_pix = SPIFFS_OBJ_LOOKUP_ENTRY_TO_PIX(fs, bix, entry); + } + + return res; +} + +// update object index header with any combination of name/size/index +// new_objix_hdr_data may be null, if so the object index header page is loaded +// name may be null, if so name is not changed +// size may be null, if so size is not changed +s32_t spiffs_object_update_index_hdr( + spiffs *fs, + spiffs_fd *fd, + spiffs_obj_id obj_id, + spiffs_page_ix objix_hdr_pix, + u8_t *new_objix_hdr_data, + u8_t name[SPIFFS_OBJ_NAME_LEN], + u32_t size, + spiffs_page_ix *new_pix) { + s32_t res = SPIFFS_OK; + spiffs_page_object_ix_header *objix_hdr; + spiffs_page_ix new_objix_hdr_pix; + + obj_id |= SPIFFS_OBJ_ID_IX_FLAG; + + if (new_objix_hdr_data) { + // object index header page already given to us, no need to load it + objix_hdr = (spiffs_page_object_ix_header *)new_objix_hdr_data; + } else { + // read object index header page + res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_IX | SPIFFS_OP_C_READ, + fd->file_nbr, SPIFFS_PAGE_TO_PADDR(fs, objix_hdr_pix), SPIFFS_CFG_LOG_PAGE_SZ(fs), fs->work); + SPIFFS_CHECK_RES(res); + objix_hdr = (spiffs_page_object_ix_header *)fs->work; + } + + SPIFFS_VALIDATE_OBJIX(objix_hdr->p_hdr, obj_id, 0); + + // change name + if (name) { + strncpy((char *)objix_hdr->name, (char *)name, SPIFFS_OBJ_NAME_LEN); + } + if (size) { + objix_hdr->size = size; + } + + // move and update page + res = spiffs_page_move(fs, fd == 0 ? 0 : fd->file_nbr, (u8_t*)objix_hdr, obj_id, 0, objix_hdr_pix, &new_objix_hdr_pix); + + if (res == SPIFFS_OK) { + if (new_pix) { + *new_pix = new_objix_hdr_pix; + } + // callback on object index update + spiffs_cb_object_event(fs, fd, SPIFFS_EV_IX_UPD, obj_id, objix_hdr->p_hdr.span_ix, new_objix_hdr_pix, objix_hdr->size); + if (fd) fd->objix_hdr_pix = new_objix_hdr_pix; // if this is not in the registered cluster + } + + return res; +} + +void spiffs_cb_object_event( + spiffs *fs, + spiffs_fd *fd, + int ev, + spiffs_obj_id obj_id, + spiffs_span_ix spix, + spiffs_page_ix new_pix, + u32_t new_size) { + (void)fd; + // update index caches in all file descriptors + obj_id &= ~SPIFFS_OBJ_ID_IX_FLAG; + u32_t i; + spiffs_fd *fds = (spiffs_fd *)fs->fd_space; + for (i = 0; i < fs->fd_count; i++) { + spiffs_fd *cur_fd = &fds[i]; + if (cur_fd->file_nbr == 0 || (cur_fd->obj_id & ~SPIFFS_OBJ_ID_IX_FLAG) != obj_id) continue; + if (spix == 0) { + if (ev == SPIFFS_EV_IX_NEW || ev == SPIFFS_EV_IX_UPD) { + SPIFFS_DBG(" callback: setting fd %i:%04x objix_hdr_pix to %04x, size:%i\n", cur_fd->file_nbr, cur_fd->obj_id, new_pix, new_size); + cur_fd->objix_hdr_pix = new_pix; + if (new_size != 0) { + cur_fd->size = new_size; + } + } else if (ev == SPIFFS_EV_IX_DEL) { + cur_fd->file_nbr = 0; + cur_fd->obj_id = SPIFFS_OBJ_ID_DELETED; + } + } + if (cur_fd->cursor_objix_spix == spix) { + if (ev == SPIFFS_EV_IX_NEW || ev == SPIFFS_EV_IX_UPD) { + SPIFFS_DBG(" callback: setting fd %i:%04x span:%04x objix_pix to %04x\n", cur_fd->file_nbr, cur_fd->obj_id, spix, new_pix); + cur_fd->cursor_objix_pix = new_pix; + } else { + cur_fd->cursor_objix_pix = 0; + } + } + } +} + +// Open object by id +s32_t spiffs_object_open_by_id( + spiffs *fs, + spiffs_obj_id obj_id, + spiffs_fd *fd, + spiffs_flags flags, + spiffs_mode mode) { + s32_t res = SPIFFS_OK; + spiffs_page_ix pix; + + res = spiffs_obj_lu_find_id_and_span(fs, obj_id | SPIFFS_OBJ_ID_IX_FLAG, 0, 0, &pix); + SPIFFS_CHECK_RES(res); + + res = spiffs_object_open_by_page(fs, pix, fd, flags, mode); + + return res; +} + +// Open object by page index +s32_t spiffs_object_open_by_page( + spiffs *fs, + spiffs_page_ix pix, + spiffs_fd *fd, + spiffs_flags flags, + spiffs_mode mode) { + (void)mode; + s32_t res = SPIFFS_OK; + spiffs_page_object_ix_header oix_hdr; + spiffs_obj_id obj_id; + + res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_IX | SPIFFS_OP_C_READ, + fd->file_nbr, SPIFFS_PAGE_TO_PADDR(fs, pix), sizeof(spiffs_page_object_ix_header), (u8_t *)&oix_hdr); + SPIFFS_CHECK_RES(res); + + spiffs_block_ix bix = SPIFFS_BLOCK_FOR_PAGE(fs, pix); + int entry = SPIFFS_OBJ_LOOKUP_ENTRY_FOR_PAGE(fs, pix); + + res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU | SPIFFS_OP_C_READ, + 0, SPIFFS_BLOCK_TO_PADDR(fs, bix) + entry * sizeof(spiffs_obj_id), sizeof(spiffs_obj_id), (u8_t *)&obj_id); + + fd->fs = fs; + fd->objix_hdr_pix = pix; + fd->size = oix_hdr.size; + fd->offset = 0; + fd->cursor_objix_pix = pix; + fd->cursor_objix_spix = 0; + fd->obj_id = obj_id; + fd->flags = flags; + + SPIFFS_VALIDATE_OBJIX(oix_hdr.p_hdr, fd->obj_id, 0); + + SPIFFS_DBG("open: fd %i is obj id %04x\n", fd->file_nbr, fd->obj_id); + + return res; +} + +// Append to object +// keep current object index (header) page in fs->work buffer +s32_t spiffs_object_append(spiffs_fd *fd, u32_t offset, u8_t *data, u32_t len) { + spiffs *fs = fd->fs; + s32_t res = SPIFFS_OK; + u32_t written = 0; + + res = spiffs_gc_check(fs, len); + SPIFFS_CHECK_RES(res); + + spiffs_page_object_ix_header *objix_hdr = (spiffs_page_object_ix_header *)fs->work; + spiffs_page_object_ix *objix = (spiffs_page_object_ix *)fs->work; + spiffs_page_header p_hdr; + + spiffs_span_ix cur_objix_spix = 0; + spiffs_span_ix prev_objix_spix = (spiffs_span_ix)-1; + spiffs_page_ix cur_objix_pix = fd->objix_hdr_pix; + spiffs_page_ix new_objix_hdr_page; + + spiffs_span_ix data_spix = offset / SPIFFS_DATA_PAGE_SIZE(fs); + spiffs_page_ix data_page; + u32_t page_offs = offset % SPIFFS_DATA_PAGE_SIZE(fs); + + // write all data + while (res == SPIFFS_OK && written < len) { + // calculate object index page span index + cur_objix_spix = SPIFFS_OBJ_IX_ENTRY_SPAN_IX(fs, data_spix); + + // handle storing and loading of object indices + if (cur_objix_spix != prev_objix_spix) { + // new object index page + // within this clause we return directly if something fails, object index mess-up + if (written > 0) { + // store previous object index page, unless first pass + SPIFFS_DBG("append: %04x store objix %04x:%04x, written %i\n", fd->obj_id, + cur_objix_pix, prev_objix_spix, written); + if (prev_objix_spix == 0) { + // this is an update to object index header page + objix_hdr->size = offset+written; + if (offset == 0) { + // was an empty object, update same page (size was 0xffffffff) + res = spiffs_page_index_check(fs, fd, cur_objix_pix, 0); + SPIFFS_CHECK_RES(res); + res = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_IX | SPIFFS_OP_C_UPDT, + fd->file_nbr, SPIFFS_PAGE_TO_PADDR(fs, cur_objix_pix), SPIFFS_CFG_LOG_PAGE_SZ(fs), fs->work); + SPIFFS_CHECK_RES(res); + } else { + // was a nonempty object, update to new page + res = spiffs_object_update_index_hdr(fs, fd, fd->obj_id, + fd->objix_hdr_pix, fs->work, 0, offset+written, &new_objix_hdr_page); + SPIFFS_CHECK_RES(res); + SPIFFS_DBG("append: %04x store new objix_hdr, %04x:%04x, written %i\n", fd->obj_id, + new_objix_hdr_page, 0, written); + } + } else { + // this is an update to an object index page + res = spiffs_page_index_check(fs, fd, cur_objix_pix, prev_objix_spix); + SPIFFS_CHECK_RES(res); + + res = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_IX | SPIFFS_OP_C_UPDT, + fd->file_nbr, SPIFFS_PAGE_TO_PADDR(fs, cur_objix_pix), SPIFFS_CFG_LOG_PAGE_SZ(fs), fs->work); + SPIFFS_CHECK_RES(res); + spiffs_cb_object_event(fs, fd, SPIFFS_EV_IX_UPD,fd->obj_id, objix->p_hdr.span_ix, cur_objix_pix, 0); + // update length in object index header page + res = spiffs_object_update_index_hdr(fs, fd, fd->obj_id, + fd->objix_hdr_pix, 0, 0, offset+written, &new_objix_hdr_page); + SPIFFS_CHECK_RES(res); + SPIFFS_DBG("append: %04x store new size I %i in objix_hdr, %04x:%04x, written %i\n", fd->obj_id, + offset+written, new_objix_hdr_page, 0, written); + } + fd->size = offset+written; + fd->offset = offset+written; + } + + // create or load new object index page + if (cur_objix_spix == 0) { + // load object index header page, must always exist + SPIFFS_DBG("append: %04x load objixhdr page %04x:%04x\n", fd->obj_id, cur_objix_pix, cur_objix_spix); + res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_IX | SPIFFS_OP_C_READ, + fd->file_nbr, SPIFFS_PAGE_TO_PADDR(fs, cur_objix_pix), SPIFFS_CFG_LOG_PAGE_SZ(fs), fs->work); + SPIFFS_CHECK_RES(res); + SPIFFS_VALIDATE_OBJIX(objix_hdr->p_hdr, fd->obj_id, cur_objix_spix); + } else { + spiffs_span_ix len_objix_spix = SPIFFS_OBJ_IX_ENTRY_SPAN_IX(fs, (fd->size-1)/SPIFFS_DATA_PAGE_SIZE(fs)); + // on subsequent passes, create a new object index page + if (written > 0 || cur_objix_spix > len_objix_spix) { + p_hdr.obj_id = fd->obj_id | SPIFFS_OBJ_ID_IX_FLAG; + p_hdr.span_ix = cur_objix_spix; + p_hdr.flags = 0xff & ~(SPIFFS_PH_FLAG_FINAL | SPIFFS_PH_FLAG_INDEX); + res = spiffs_page_allocate_data(fs, fd->obj_id | SPIFFS_OBJ_ID_IX_FLAG, + &p_hdr, 0, 0, 0, 1, &cur_objix_pix); + SPIFFS_CHECK_RES(res); + spiffs_cb_object_event(fs, fd, SPIFFS_EV_IX_NEW, fd->obj_id, cur_objix_spix, cur_objix_pix, 0); + // quick "load" of new object index page + c_memset(fs->work, 0xff, SPIFFS_CFG_LOG_PAGE_SZ(fs)); + c_memcpy(fs->work, &p_hdr, sizeof(spiffs_page_header)); + SPIFFS_DBG("append: %04x create objix page, %04x:%04x, written %i\n", fd->obj_id + , cur_objix_pix, cur_objix_spix, written); + } else { + // on first pass, we load existing object index page + spiffs_page_ix pix; + SPIFFS_DBG("append: %04x find objix span_ix:%04x\n", fd->obj_id, cur_objix_spix); + if (fd->cursor_objix_spix == cur_objix_spix) { + pix = fd->cursor_objix_pix; + } else { + res = spiffs_obj_lu_find_id_and_span(fs, fd->obj_id | SPIFFS_OBJ_ID_IX_FLAG, cur_objix_spix, 0, &pix); + SPIFFS_CHECK_RES(res); + } + SPIFFS_DBG("append: %04x found object index at page %04x\n", fd->obj_id, pix); + res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_IX | SPIFFS_OP_C_READ, + fd->file_nbr, SPIFFS_PAGE_TO_PADDR(fs, pix), SPIFFS_CFG_LOG_PAGE_SZ(fs), fs->work); + SPIFFS_CHECK_RES(res); + SPIFFS_VALIDATE_OBJIX(objix_hdr->p_hdr, fd->obj_id, cur_objix_spix); + cur_objix_pix = pix; + } + fd->cursor_objix_pix = cur_objix_pix; + fd->cursor_objix_spix = cur_objix_spix; + fd->offset = offset+written; + fd->size = offset+written; + } + prev_objix_spix = cur_objix_spix; + } + + // write data + u32_t to_write = MIN(len-written, SPIFFS_DATA_PAGE_SIZE(fs) - page_offs); + if (page_offs == 0) { + // at beginning of a page, allocate and write a new page of data + p_hdr.obj_id = fd->obj_id & ~SPIFFS_OBJ_ID_IX_FLAG; + p_hdr.span_ix = data_spix; + p_hdr.flags = 0xff & ~(SPIFFS_PH_FLAG_FINAL); // finalize immediately + res = spiffs_page_allocate_data(fs, fd->obj_id & ~SPIFFS_OBJ_ID_IX_FLAG, + &p_hdr, &data[written], to_write, page_offs, 1, &data_page); + SPIFFS_DBG("append: %04x store new data page, %04x:%04x offset:%i, len %i, written %i\n", fd->obj_id, + data_page, data_spix, page_offs, to_write, written); + } else { + // append to existing page, fill out free data in existing page + if (cur_objix_spix == 0) { + // get data page from object index header page + data_page = ((spiffs_page_ix*)((u8_t *)objix_hdr + sizeof(spiffs_page_object_ix_header)))[data_spix]; + } else { + // get data page from object index page + data_page = ((spiffs_page_ix*)((u8_t *)objix + sizeof(spiffs_page_object_ix)))[SPIFFS_OBJ_IX_ENTRY(fs, data_spix)]; + } + + res = spiffs_page_data_check(fs, fd, data_page, data_spix); + SPIFFS_CHECK_RES(res); + + res = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_DA | SPIFFS_OP_C_UPDT, + fd->file_nbr, SPIFFS_PAGE_TO_PADDR(fs, data_page) + sizeof(spiffs_page_header) + page_offs, to_write, &data[written]); + SPIFFS_DBG("append: %04x store to existing data page, %04x:%04x offset:%i, len %i, written %i\n", fd->obj_id + , data_page, data_spix, page_offs, to_write, written); + } + + if (res != SPIFFS_OK) break; + + // update memory representation of object index page with new data page + if (cur_objix_spix == 0) { + // update object index header page + ((spiffs_page_ix*)((u8_t *)objix_hdr + sizeof(spiffs_page_object_ix_header)))[data_spix] = data_page; + SPIFFS_DBG("append: %04x wrote page %04x to objix_hdr entry %02x in mem\n", fd->obj_id + , data_page, data_spix); + objix_hdr->size = offset+written; + } else { + // update object index page + ((spiffs_page_ix*)((u8_t *)objix + sizeof(spiffs_page_object_ix)))[SPIFFS_OBJ_IX_ENTRY(fs, data_spix)] = data_page; + SPIFFS_DBG("append: %04x wrote page %04x to objix entry %02x in mem\n", fd->obj_id + , data_page, SPIFFS_OBJ_IX_ENTRY(fs, data_spix)); + } + + // update internals + page_offs = 0; + data_spix++; + written += to_write; + } // while all data + + fd->size = offset+written; + fd->offset = offset+written; + fd->cursor_objix_pix = cur_objix_pix; + fd->cursor_objix_spix = cur_objix_spix; + + // finalize updated object indices + s32_t res2 = SPIFFS_OK; + if (cur_objix_spix != 0) { + // wrote beyond object index header page + // write last modified object index page, unless object header index page + SPIFFS_DBG("append: %04x store objix page, %04x:%04x, written %i\n", fd->obj_id, + cur_objix_pix, cur_objix_spix, written); + + res2 = spiffs_page_index_check(fs, fd, cur_objix_pix, cur_objix_spix); + SPIFFS_CHECK_RES(res2); + + res2 = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_IX | SPIFFS_OP_C_UPDT, + fd->file_nbr, SPIFFS_PAGE_TO_PADDR(fs, cur_objix_pix), SPIFFS_CFG_LOG_PAGE_SZ(fs), fs->work); + SPIFFS_CHECK_RES(res2); + spiffs_cb_object_event(fs, fd, SPIFFS_EV_IX_UPD, fd->obj_id, objix->p_hdr.span_ix, cur_objix_pix, 0); + + // update size in object header index page + res2 = spiffs_object_update_index_hdr(fs, fd, fd->obj_id, + fd->objix_hdr_pix, 0, 0, offset+written, &new_objix_hdr_page); + SPIFFS_DBG("append: %04x store new size II %i in objix_hdr, %04x:%04x, written %i\n", fd->obj_id + , offset+written, new_objix_hdr_page, 0, written); + SPIFFS_CHECK_RES(res2); + } else { + // wrote within object index header page + if (offset == 0) { + // wrote to empty object - simply update size and write whole page + objix_hdr->size = offset+written; + SPIFFS_DBG("append: %04x store fresh objix_hdr page, %04x:%04x, written %i\n", fd->obj_id + , cur_objix_pix, cur_objix_spix, written); + + res2 = spiffs_page_index_check(fs, fd, cur_objix_pix, cur_objix_spix); + SPIFFS_CHECK_RES(res2); + + res2 = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_IX | SPIFFS_OP_C_UPDT, + fd->file_nbr, SPIFFS_PAGE_TO_PADDR(fs, cur_objix_pix), SPIFFS_CFG_LOG_PAGE_SZ(fs), fs->work); + SPIFFS_CHECK_RES(res2); + // callback on object index update + spiffs_cb_object_event(fs, fd, SPIFFS_EV_IX_UPD, fd->obj_id, objix_hdr->p_hdr.span_ix, cur_objix_pix, objix_hdr->size); + } else { + // modifying object index header page, update size and make new copy + res2 = spiffs_object_update_index_hdr(fs, fd, fd->obj_id, + fd->objix_hdr_pix, fs->work, 0, offset+written, &new_objix_hdr_page); + SPIFFS_DBG("append: %04x store modified objix_hdr page, %04x:%04x, written %i\n", fd->obj_id + , new_objix_hdr_page, 0, written); + SPIFFS_CHECK_RES(res2); + } + } + + return res; +} + +// Modify object +// keep current object index (header) page in fs->work buffer +s32_t spiffs_object_modify(spiffs_fd *fd, u32_t offset, u8_t *data, u32_t len) { + spiffs *fs = fd->fs; + s32_t res = SPIFFS_OK; + u32_t written = 0; + + res = spiffs_gc_check(fs, len); + SPIFFS_CHECK_RES(res); + + spiffs_page_object_ix_header *objix_hdr = (spiffs_page_object_ix_header *)fs->work; + spiffs_page_object_ix *objix = (spiffs_page_object_ix *)fs->work; + spiffs_page_header p_hdr; + + spiffs_span_ix cur_objix_spix = 0; + spiffs_span_ix prev_objix_spix = (spiffs_span_ix)-1; + spiffs_page_ix cur_objix_pix = fd->objix_hdr_pix; + spiffs_page_ix new_objix_hdr_pix; + + spiffs_span_ix data_spix = offset / SPIFFS_DATA_PAGE_SIZE(fs); + spiffs_page_ix data_pix; + u32_t page_offs = offset % SPIFFS_DATA_PAGE_SIZE(fs); + + + // write all data + while (res == SPIFFS_OK && written < len) { + // calculate object index page span index + cur_objix_spix = SPIFFS_OBJ_IX_ENTRY_SPAN_IX(fs, data_spix); + + // handle storing and loading of object indices + if (cur_objix_spix != prev_objix_spix) { + // new object index page + // within this clause we return directly if something fails, object index mess-up + if (written > 0) { + // store previous object index (header) page, unless first pass + if (prev_objix_spix == 0) { + // store previous object index header page + res = spiffs_object_update_index_hdr(fs, fd, fd->obj_id, + fd->objix_hdr_pix, fs->work, 0, 0, &new_objix_hdr_pix); + SPIFFS_DBG("modify: store modified objix_hdr page, %04x:%04x, written %i\n", new_objix_hdr_pix, 0, written); + SPIFFS_CHECK_RES(res); + } else { + // store new version of previous object index page + spiffs_page_ix new_objix_pix; + + res = spiffs_page_index_check(fs, fd, cur_objix_pix, prev_objix_spix); + SPIFFS_CHECK_RES(res); + + res = spiffs_page_move(fs, fd->file_nbr, (u8_t*)objix, fd->obj_id, 0, cur_objix_pix, &new_objix_pix); + SPIFFS_DBG("modify: store previous modified objix page, %04x:%04x, written %i\n", new_objix_pix, objix->p_hdr.span_ix, written); + SPIFFS_CHECK_RES(res); + spiffs_cb_object_event(fs, fd, SPIFFS_EV_IX_UPD, fd->obj_id, objix->p_hdr.span_ix, new_objix_pix, 0); + } + } + + // load next object index page + if (cur_objix_spix == 0) { + // load object index header page, must exist + SPIFFS_DBG("modify: load objixhdr page %04x:%04x\n", cur_objix_pix, cur_objix_spix); + res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_IX | SPIFFS_OP_C_READ, + fd->file_nbr, SPIFFS_PAGE_TO_PADDR(fs, cur_objix_pix), SPIFFS_CFG_LOG_PAGE_SZ(fs), fs->work); + SPIFFS_CHECK_RES(res); + SPIFFS_VALIDATE_OBJIX(objix_hdr->p_hdr, fd->obj_id, cur_objix_spix); + } else { + // load existing object index page on first pass + spiffs_page_ix pix; + SPIFFS_DBG("modify: find objix span_ix:%04x\n", cur_objix_spix); + if (fd->cursor_objix_spix == cur_objix_spix) { + pix = fd->cursor_objix_pix; + } else { + res = spiffs_obj_lu_find_id_and_span(fs, fd->obj_id | SPIFFS_OBJ_ID_IX_FLAG, cur_objix_spix, 0, &pix); + SPIFFS_CHECK_RES(res); + } + SPIFFS_DBG("modify: found object index at page %04x\n", pix); + res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_IX | SPIFFS_OP_C_READ, + fd->file_nbr, SPIFFS_PAGE_TO_PADDR(fs, pix), SPIFFS_CFG_LOG_PAGE_SZ(fs), fs->work); + SPIFFS_CHECK_RES(res); + SPIFFS_VALIDATE_OBJIX(objix_hdr->p_hdr, fd->obj_id, cur_objix_spix); + cur_objix_pix = pix; + } + fd->cursor_objix_pix = cur_objix_pix; + fd->cursor_objix_spix = cur_objix_spix; + fd->offset = offset+written; + prev_objix_spix = cur_objix_spix; + } + + // write partial data + u32_t to_write = MIN(len-written, SPIFFS_DATA_PAGE_SIZE(fs) - page_offs); + spiffs_page_ix orig_data_pix; + if (cur_objix_spix == 0) { + // get data page from object index header page + orig_data_pix = ((spiffs_page_ix*)((u8_t *)objix_hdr + sizeof(spiffs_page_object_ix_header)))[data_spix]; + } else { + // get data page from object index page + orig_data_pix = ((spiffs_page_ix*)((u8_t *)objix + sizeof(spiffs_page_object_ix)))[SPIFFS_OBJ_IX_ENTRY(fs, data_spix)]; + } + + p_hdr.obj_id = fd->obj_id & ~SPIFFS_OBJ_ID_IX_FLAG; + p_hdr.span_ix = data_spix; + p_hdr.flags = 0xff; + if (page_offs == 0 && to_write == SPIFFS_DATA_PAGE_SIZE(fs)) { + // a full page, allocate and write a new page of data + res = spiffs_page_allocate_data(fs, fd->obj_id & ~SPIFFS_OBJ_ID_IX_FLAG, + &p_hdr, &data[written], to_write, page_offs, 1, &data_pix); + SPIFFS_DBG("modify: store new data page, %04x:%04x offset:%i, len %i, written %i\n", data_pix, data_spix, page_offs, to_write, written); + } else { + // write to existing page, allocate new and copy unmodified data + + res = spiffs_page_data_check(fs, fd, orig_data_pix, data_spix); + SPIFFS_CHECK_RES(res); + + res = spiffs_page_allocate_data(fs, fd->obj_id & ~SPIFFS_OBJ_ID_IX_FLAG, + &p_hdr, 0, 0, 0, 0, &data_pix); + if (res != SPIFFS_OK) break; + + // copy unmodified data + if (page_offs > 0) { + // before modification + res = spiffs_phys_cpy(fs, fd->file_nbr, + SPIFFS_PAGE_TO_PADDR(fs, data_pix) + sizeof(spiffs_page_header), + SPIFFS_PAGE_TO_PADDR(fs, orig_data_pix) + sizeof(spiffs_page_header), + page_offs); + if (res != SPIFFS_OK) break; + } + if (page_offs + to_write < SPIFFS_DATA_PAGE_SIZE(fs)) { + // after modification + res = spiffs_phys_cpy(fs, fd->file_nbr, + SPIFFS_PAGE_TO_PADDR(fs, data_pix) + sizeof(spiffs_page_header) + page_offs + to_write, + SPIFFS_PAGE_TO_PADDR(fs, orig_data_pix) + sizeof(spiffs_page_header) + page_offs + to_write, + SPIFFS_DATA_PAGE_SIZE(fs) - (page_offs + to_write)); + if (res != SPIFFS_OK) break; + } + + res = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_DA | SPIFFS_OP_C_UPDT, + fd->file_nbr, + SPIFFS_PAGE_TO_PADDR(fs, data_pix) + sizeof(spiffs_page_header) + page_offs, to_write, &data[written]); + if (res != SPIFFS_OK) break; + p_hdr.flags &= ~SPIFFS_PH_FLAG_FINAL; + res = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_DA | SPIFFS_OP_C_UPDT, + fd->file_nbr, + SPIFFS_PAGE_TO_PADDR(fs, data_pix) + offsetof(spiffs_page_header, flags), + sizeof(u8_t), + (u8_t *)&p_hdr.flags); + if (res != SPIFFS_OK) break; + + SPIFFS_DBG("modify: store to existing data page, src:%04x, dst:%04x:%04x offset:%i, len %i, written %i\n", orig_data_pix, data_pix, data_spix, page_offs, to_write, written); + } + + // delete original data page + res = spiffs_page_delete(fs, orig_data_pix); + if (res != SPIFFS_OK) break; + // update memory representation of object index page with new data page + if (cur_objix_spix == 0) { + // update object index header page + ((spiffs_page_ix*)((u8_t *)objix_hdr + sizeof(spiffs_page_object_ix_header)))[data_spix] = data_pix; + SPIFFS_DBG("modify: wrote page %04x to objix_hdr entry %02x in mem\n", data_pix, data_spix); + } else { + // update object index page + ((spiffs_page_ix*)((u8_t *)objix + sizeof(spiffs_page_object_ix)))[SPIFFS_OBJ_IX_ENTRY(fs, data_spix)] = data_pix; + SPIFFS_DBG("modify: wrote page %04x to objix entry %02x in mem\n", data_pix, SPIFFS_OBJ_IX_ENTRY(fs, data_spix)); + } + + // update internals + page_offs = 0; + data_spix++; + written += to_write; + } // while all data + + fd->offset = offset+written; + fd->cursor_objix_pix = cur_objix_pix; + fd->cursor_objix_spix = cur_objix_spix; + + // finalize updated object indices + s32_t res2 = SPIFFS_OK; + if (cur_objix_spix != 0) { + // wrote beyond object index header page + // write last modified object index page + // move and update page + spiffs_page_ix new_objix_pix; + + res2 = spiffs_page_index_check(fs, fd, cur_objix_pix, cur_objix_spix); + SPIFFS_CHECK_RES(res2); + + res2 = spiffs_page_move(fs, fd->file_nbr, (u8_t*)objix, fd->obj_id, 0, cur_objix_pix, &new_objix_pix); + SPIFFS_DBG("modify: store modified objix page, %04x:%04x, written %i\n", new_objix_pix, cur_objix_spix, written); + fd->cursor_objix_pix = new_objix_pix; + fd->cursor_objix_spix = cur_objix_spix; + SPIFFS_CHECK_RES(res2); + spiffs_cb_object_event(fs, fd, SPIFFS_EV_IX_UPD, fd->obj_id, objix->p_hdr.span_ix, new_objix_pix, 0); + + } else { + // wrote within object index header page + res2 = spiffs_object_update_index_hdr(fs, fd, fd->obj_id, + fd->objix_hdr_pix, fs->work, 0, 0, &new_objix_hdr_pix); + SPIFFS_DBG("modify: store modified objix_hdr page, %04x:%04x, written %i\n", new_objix_hdr_pix, 0, written); + SPIFFS_CHECK_RES(res2); + } + + return res; +} + +static s32_t spiffs_object_find_object_index_header_by_name_v( + spiffs *fs, + spiffs_obj_id obj_id, + spiffs_block_ix bix, + int ix_entry, + u32_t user_data, + void *user_p) { + (void)user_data; + s32_t res; + spiffs_page_object_ix_header objix_hdr; + spiffs_page_ix pix = SPIFFS_OBJ_LOOKUP_ENTRY_TO_PIX(fs, bix, ix_entry); + if (obj_id == SPIFFS_OBJ_ID_FREE || obj_id == SPIFFS_OBJ_ID_DELETED || + (obj_id & SPIFFS_OBJ_ID_IX_FLAG) == 0) { + return SPIFFS_VIS_COUNTINUE; + } + res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU2 | SPIFFS_OP_C_READ, + 0, SPIFFS_PAGE_TO_PADDR(fs, pix), sizeof(spiffs_page_object_ix_header), (u8_t *)&objix_hdr); + SPIFFS_CHECK_RES(res); + if (objix_hdr.p_hdr.span_ix == 0 && + (objix_hdr.p_hdr.flags & (SPIFFS_PH_FLAG_DELET | SPIFFS_PH_FLAG_FINAL | SPIFFS_PH_FLAG_IXDELE)) == + (SPIFFS_PH_FLAG_DELET | SPIFFS_PH_FLAG_IXDELE)) { + if (strcmp((char *)user_p, (char *)objix_hdr.name) == 0) { + return SPIFFS_OK; + } + } + + return SPIFFS_VIS_COUNTINUE; +} + +// Finds object index header page by name +s32_t spiffs_object_find_object_index_header_by_name( + spiffs *fs, + u8_t name[SPIFFS_OBJ_NAME_LEN], + spiffs_page_ix *pix) { + s32_t res; + spiffs_block_ix bix; + int entry; + + res = spiffs_obj_lu_find_entry_visitor(fs, + fs->cursor_block_ix, + fs->cursor_obj_lu_entry, + 0, + 0, + spiffs_object_find_object_index_header_by_name_v, + 0, + name, + &bix, + &entry); + + if (res == SPIFFS_VIS_END) { + res = SPIFFS_ERR_NOT_FOUND; + } + SPIFFS_CHECK_RES(res); + + if (pix) { + *pix = SPIFFS_OBJ_LOOKUP_ENTRY_TO_PIX(fs, bix, entry); + } + + fs->cursor_block_ix = bix; + fs->cursor_obj_lu_entry = entry; + + return res; +} + +// Truncates object to new size. If new size is null, object may be removed totally +s32_t spiffs_object_truncate( + spiffs_fd *fd, + u32_t new_size, + u8_t remove) { + s32_t res = SPIFFS_OK; + spiffs *fs = fd->fs; + + res = spiffs_gc_check(fs, 0); + SPIFFS_CHECK_RES(res); + + spiffs_page_ix objix_pix = fd->objix_hdr_pix; + spiffs_span_ix data_spix = (fd->size > 0 ? fd->size-1 : 0) / SPIFFS_DATA_PAGE_SIZE(fs); + u32_t cur_size = fd->size == (u32_t)SPIFFS_UNDEFINED_LEN ? 0 : fd->size ; + spiffs_span_ix cur_objix_spix = 0; + spiffs_span_ix prev_objix_spix = (spiffs_span_ix)-1; + spiffs_page_object_ix_header *objix_hdr = (spiffs_page_object_ix_header *)fs->work; + spiffs_page_object_ix *objix = (spiffs_page_object_ix *)fs->work; + spiffs_page_ix data_pix; + spiffs_page_ix new_objix_hdr_pix; + + // before truncating, check if object is to be fully removed and mark this + if (remove && new_size == 0) { + u8_t flags = ~( SPIFFS_PH_FLAG_USED | SPIFFS_PH_FLAG_INDEX | SPIFFS_PH_FLAG_FINAL | SPIFFS_PH_FLAG_IXDELE); + res = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_IX | SPIFFS_OP_C_UPDT, + fd->file_nbr, SPIFFS_PAGE_TO_PADDR(fs, fd->objix_hdr_pix) + offsetof(spiffs_page_header, flags), + sizeof(u8_t), + (u8_t *)&flags); + SPIFFS_CHECK_RES(res); + } + + // delete from end of object until desired len is reached + while (cur_size > new_size) { + cur_objix_spix = SPIFFS_OBJ_IX_ENTRY_SPAN_IX(fs, data_spix); + + // put object index for current data span index in work buffer + if (prev_objix_spix != cur_objix_spix) { + if (prev_objix_spix != (spiffs_span_ix)-1) { + // remove previous object index page + SPIFFS_DBG("truncate: delete objix page %04x:%04x\n", objix_pix, prev_objix_spix); + + res = spiffs_page_index_check(fs, fd, objix_pix, prev_objix_spix); + SPIFFS_CHECK_RES(res); + + res = spiffs_page_delete(fs, objix_pix); + SPIFFS_CHECK_RES(res); + spiffs_cb_object_event(fs, fd, SPIFFS_EV_IX_DEL, fd->obj_id, objix->p_hdr.span_ix, objix_pix, 0); + if (prev_objix_spix > 0) { + // update object index header page + SPIFFS_DBG("truncate: update objix hdr page %04x:%04x to size %i\n", fd->objix_hdr_pix, prev_objix_spix, cur_size); + res = spiffs_object_update_index_hdr(fs, fd, fd->obj_id, + fd->objix_hdr_pix, 0, 0, cur_size, &new_objix_hdr_pix); + SPIFFS_CHECK_RES(res); + fd->size = cur_size; + } + } + // load current object index (header) page + if (cur_objix_spix == 0) { + objix_pix = fd->objix_hdr_pix; + } else { + res = spiffs_obj_lu_find_id_and_span(fs, fd->obj_id | SPIFFS_OBJ_ID_IX_FLAG, cur_objix_spix, 0, &objix_pix); + SPIFFS_CHECK_RES(res); + } + + SPIFFS_DBG("truncate: load objix page %04x:%04x for data spix:%04x\n", objix_pix, cur_objix_spix, data_spix); + res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_IX | SPIFFS_OP_C_READ, + fd->file_nbr, SPIFFS_PAGE_TO_PADDR(fs, objix_pix), SPIFFS_CFG_LOG_PAGE_SZ(fs), fs->work); + SPIFFS_CHECK_RES(res); + SPIFFS_VALIDATE_OBJIX(objix_hdr->p_hdr, fd->obj_id, cur_objix_spix); + fd->cursor_objix_pix = objix_pix; + fd->cursor_objix_spix = cur_objix_spix; + fd->offset = cur_size; + + prev_objix_spix = cur_objix_spix; + } + + if (cur_objix_spix == 0) { + // get data page from object index header page + data_pix = ((spiffs_page_ix*)((u8_t *)objix_hdr + sizeof(spiffs_page_object_ix_header)))[data_spix]; + ((spiffs_page_ix*)((u8_t *)objix_hdr + sizeof(spiffs_page_object_ix_header)))[data_spix] = SPIFFS_OBJ_ID_FREE; + } else { + // get data page from object index page + data_pix = ((spiffs_page_ix*)((u8_t *)objix + sizeof(spiffs_page_object_ix)))[SPIFFS_OBJ_IX_ENTRY(fs, data_spix)]; + ((spiffs_page_ix*)((u8_t *)objix + sizeof(spiffs_page_object_ix)))[SPIFFS_OBJ_IX_ENTRY(fs, data_spix)] = SPIFFS_OBJ_ID_FREE; + } + + if (cur_size - SPIFFS_DATA_PAGE_SIZE(fs) >= new_size) { + // delete full data page + res = spiffs_page_data_check(fs, fd, data_pix, data_spix); + if (res != SPIFFS_OK) break; + + res = spiffs_page_delete(fs, data_pix); + if (res != SPIFFS_OK) break; + // update current size + if (cur_size % SPIFFS_DATA_PAGE_SIZE(fs) == 0) { + cur_size -= SPIFFS_DATA_PAGE_SIZE(fs); + } else { + cur_size -= cur_size % SPIFFS_DATA_PAGE_SIZE(fs); + } + fd->size = cur_size; + fd->offset = cur_size; + SPIFFS_DBG("truncate: delete data page %04x for data spix:%04x, cur_size:%i\n", data_pix, data_spix, cur_size); + } else { + // delete last page, partially + spiffs_page_header p_hdr; + spiffs_page_ix new_data_pix; + u32_t bytes_to_remove = SPIFFS_DATA_PAGE_SIZE(fs) - (new_size % SPIFFS_DATA_PAGE_SIZE(fs)); + SPIFFS_DBG("truncate: delete %i bytes from data page %04x for data spix:%04x, cur_size:%i\n", bytes_to_remove, data_pix, data_spix, cur_size); + + res = spiffs_page_data_check(fs, fd, data_pix, data_spix); + if (res != SPIFFS_OK) break; + + p_hdr.obj_id = fd->obj_id & ~SPIFFS_OBJ_ID_IX_FLAG; + p_hdr.span_ix = data_spix; + p_hdr.flags = 0xff; + // allocate new page and copy unmodified data + res = spiffs_page_allocate_data(fs, fd->obj_id & ~SPIFFS_OBJ_ID_IX_FLAG, + &p_hdr, 0, 0, 0, 0, &new_data_pix); + if (res != SPIFFS_OK) break; + res = spiffs_phys_cpy(fs, 0, + SPIFFS_PAGE_TO_PADDR(fs, new_data_pix) + sizeof(spiffs_page_header), + SPIFFS_PAGE_TO_PADDR(fs, data_pix) + sizeof(spiffs_page_header), + SPIFFS_DATA_PAGE_SIZE(fs) - bytes_to_remove); + if (res != SPIFFS_OK) break; + // delete original data page + res = spiffs_page_delete(fs, data_pix); + if (res != SPIFFS_OK) break; + p_hdr.flags &= ~SPIFFS_PH_FLAG_FINAL; + res = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_DA | SPIFFS_OP_C_UPDT, + fd->file_nbr, + SPIFFS_PAGE_TO_PADDR(fs, new_data_pix) + offsetof(spiffs_page_header, flags), + sizeof(u8_t), + (u8_t *)&p_hdr.flags); + if (res != SPIFFS_OK) break; + + // update memory representation of object index page with new data page + if (cur_objix_spix == 0) { + // update object index header page + ((spiffs_page_ix*)((u8_t *)objix_hdr + sizeof(spiffs_page_object_ix_header)))[data_spix] = new_data_pix; + SPIFFS_DBG("truncate: wrote page %04x to objix_hdr entry %02x in mem\n", new_data_pix, SPIFFS_OBJ_IX_ENTRY(fs, data_spix)); + } else { + // update object index page + ((spiffs_page_ix*)((u8_t *)objix + sizeof(spiffs_page_object_ix)))[SPIFFS_OBJ_IX_ENTRY(fs, data_spix)] = new_data_pix; + SPIFFS_DBG("truncate: wrote page %04x to objix entry %02x in mem\n", new_data_pix, SPIFFS_OBJ_IX_ENTRY(fs, data_spix)); + } + cur_size = new_size; + fd->size = new_size; + fd->offset = cur_size; + break; + } + data_spix--; + } // while all data + + // update object indices + if (cur_objix_spix == 0) { + // update object index header page + if (cur_size == 0) { + if (remove) { + // remove object altogether + SPIFFS_DBG("truncate: remove object index header page %04x\n", objix_pix); + + res = spiffs_page_index_check(fs, fd, objix_pix, 0); + SPIFFS_CHECK_RES(res); + + res = spiffs_page_delete(fs, objix_pix); + SPIFFS_CHECK_RES(res); + spiffs_cb_object_event(fs, fd, SPIFFS_EV_IX_DEL, fd->obj_id, 0, objix_pix, 0); + } else { + // make uninitialized object + SPIFFS_DBG("truncate: reset objix_hdr page %04x\n", objix_pix); + c_memset(fs->work + sizeof(spiffs_page_object_ix_header), 0xff, + SPIFFS_CFG_LOG_PAGE_SZ(fs) - sizeof(spiffs_page_object_ix_header)); + res = spiffs_object_update_index_hdr(fs, fd, fd->obj_id, + objix_pix, fs->work, 0, SPIFFS_UNDEFINED_LEN, &new_objix_hdr_pix); + SPIFFS_CHECK_RES(res); + } + } else { + // update object index header page + SPIFFS_DBG("truncate: update object index header page with indices and size\n"); + res = spiffs_object_update_index_hdr(fs, fd, fd->obj_id, + objix_pix, fs->work, 0, cur_size, &new_objix_hdr_pix); + SPIFFS_CHECK_RES(res); + } + } else { + // update both current object index page and object index header page + spiffs_page_ix new_objix_pix; + + res = spiffs_page_index_check(fs, fd, objix_pix, cur_objix_spix); + SPIFFS_CHECK_RES(res); + + // move and update object index page + res = spiffs_page_move(fs, fd->file_nbr, (u8_t*)objix_hdr, fd->obj_id, 0, objix_pix, &new_objix_pix); + SPIFFS_CHECK_RES(res); + spiffs_cb_object_event(fs, fd, SPIFFS_EV_IX_UPD, fd->obj_id, objix->p_hdr.span_ix, new_objix_pix, 0); + SPIFFS_DBG("truncate: store modified objix page, %04x:%04x\n", new_objix_pix, cur_objix_spix); + fd->cursor_objix_pix = new_objix_pix; + fd->cursor_objix_spix = cur_objix_spix; + fd->offset = cur_size; + // update object index header page with new size + res = spiffs_object_update_index_hdr(fs, fd, fd->obj_id, + fd->objix_hdr_pix, 0, 0, cur_size, &new_objix_hdr_pix); + SPIFFS_CHECK_RES(res); + } + fd->size = cur_size; + + return res; +} + +s32_t spiffs_object_read( + spiffs_fd *fd, + u32_t offset, + u32_t len, + u8_t *dst) { + s32_t res = SPIFFS_OK; + spiffs *fs = fd->fs; + spiffs_page_ix objix_pix; + spiffs_page_ix data_pix; + spiffs_span_ix data_spix = offset / SPIFFS_DATA_PAGE_SIZE(fs); + u32_t cur_offset = offset; + spiffs_span_ix cur_objix_spix; + spiffs_span_ix prev_objix_spix = (spiffs_span_ix)-1; + spiffs_page_object_ix_header *objix_hdr = (spiffs_page_object_ix_header *)fs->work; + spiffs_page_object_ix *objix = (spiffs_page_object_ix *)fs->work; + + while (cur_offset < offset + len) { + cur_objix_spix = SPIFFS_OBJ_IX_ENTRY_SPAN_IX(fs, data_spix); + if (prev_objix_spix != cur_objix_spix) { + // load current object index (header) page + if (cur_objix_spix == 0) { + objix_pix = fd->objix_hdr_pix; + } else { + SPIFFS_DBG("read: find objix %04x:%04x\n", fd->obj_id, cur_objix_spix); + res = spiffs_obj_lu_find_id_and_span(fs, fd->obj_id | SPIFFS_OBJ_ID_IX_FLAG, cur_objix_spix, 0, &objix_pix); + SPIFFS_CHECK_RES(res); + } + SPIFFS_DBG("read: load objix page %04x:%04x for data spix:%04x\n", objix_pix, cur_objix_spix, data_spix); + res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_IX | SPIFFS_OP_C_READ, + fd->file_nbr, SPIFFS_PAGE_TO_PADDR(fs, objix_pix), SPIFFS_CFG_LOG_PAGE_SZ(fs), fs->work); + SPIFFS_CHECK_RES(res); + SPIFFS_VALIDATE_OBJIX(objix->p_hdr, fd->obj_id, cur_objix_spix); + + fd->offset = cur_offset; + fd->cursor_objix_pix = objix_pix; + fd->cursor_objix_spix = cur_objix_spix; + + prev_objix_spix = cur_objix_spix; + } + + if (cur_objix_spix == 0) { + // get data page from object index header page + data_pix = ((spiffs_page_ix*)((u8_t *)objix_hdr + sizeof(spiffs_page_object_ix_header)))[data_spix]; + } else { + // get data page from object index page + data_pix = ((spiffs_page_ix*)((u8_t *)objix + sizeof(spiffs_page_object_ix)))[SPIFFS_OBJ_IX_ENTRY(fs, data_spix)]; + } + + // all remaining data + u32_t len_to_read = offset + len - cur_offset; + // remaining data in page + len_to_read = MIN(len_to_read, SPIFFS_DATA_PAGE_SIZE(fs) - (cur_offset % SPIFFS_DATA_PAGE_SIZE(fs))); + // remaining data in file + len_to_read = MIN(len_to_read, fd->size); + SPIFFS_DBG("read: offset:%i rd:%i data spix:%04x is data_pix:%04x addr:%08x\n", cur_offset, len_to_read, data_spix, data_pix, + SPIFFS_PAGE_TO_PADDR(fs, data_pix) + sizeof(spiffs_page_header) + (cur_offset % SPIFFS_DATA_PAGE_SIZE(fs))); + if (len_to_read <= 0) { + res = SPIFFS_ERR_END_OF_OBJECT; + break; + } + res = spiffs_page_data_check(fs, fd, data_pix, data_spix); + SPIFFS_CHECK_RES(res); + res = _spiffs_rd( + fs, SPIFFS_OP_T_OBJ_DA | SPIFFS_OP_C_READ, + fd->file_nbr, + SPIFFS_PAGE_TO_PADDR(fs, data_pix) + sizeof(spiffs_page_header) + (cur_offset % SPIFFS_DATA_PAGE_SIZE(fs)), + len_to_read, + dst); + SPIFFS_CHECK_RES(res); + dst += len_to_read; + cur_offset += len_to_read; + fd->offset = cur_offset; + data_spix++; + } + + return res; +} + +typedef struct { + spiffs_obj_id min_obj_id; + spiffs_obj_id max_obj_id; + u32_t compaction; + const u8_t *conflicting_name; +} spiffs_free_obj_id_state; + +static s32_t spiffs_obj_lu_find_free_obj_id_bitmap_v(spiffs *fs, spiffs_obj_id id, spiffs_block_ix bix, int ix_entry, + u32_t user_data, void *user_p) { + if (id != SPIFFS_OBJ_ID_FREE && id != SPIFFS_OBJ_ID_DELETED) { + spiffs_obj_id min_obj_id = user_data; + u8_t *conflicting_name = (u8_t *)user_p; + + // if conflicting name parameter is given, also check if this name is found in object index hdrs + if (conflicting_name && (id & SPIFFS_OBJ_ID_IX_FLAG)) { + spiffs_page_ix pix = SPIFFS_OBJ_LOOKUP_ENTRY_TO_PIX(fs, bix, ix_entry); + int res; + spiffs_page_object_ix_header objix_hdr; + res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU2 | SPIFFS_OP_C_READ, + 0, SPIFFS_PAGE_TO_PADDR(fs, pix), sizeof(spiffs_page_object_ix_header), (u8_t *)&objix_hdr); + SPIFFS_CHECK_RES(res); + if (objix_hdr.p_hdr.span_ix == 0 && + (objix_hdr.p_hdr.flags & (SPIFFS_PH_FLAG_DELET | SPIFFS_PH_FLAG_FINAL | SPIFFS_PH_FLAG_IXDELE)) == + (SPIFFS_PH_FLAG_DELET | SPIFFS_PH_FLAG_IXDELE)) { + if (strcmp((char *)user_p, (char *)objix_hdr.name) == 0) { + return SPIFFS_ERR_CONFLICTING_NAME; + } + } + } + + id &= ~SPIFFS_OBJ_ID_IX_FLAG; + u32_t bit_ix = (id-min_obj_id) & 7; + int byte_ix = (id-min_obj_id) >> 3; + if (byte_ix >= 0 && (u32_t)byte_ix < SPIFFS_CFG_LOG_PAGE_SZ(fs)) { + fs->work[byte_ix] |= (1<conflicting_name && strcmp((const char *)state->conflicting_name, (char *)objix_hdr.name) == 0) { + return SPIFFS_ERR_CONFLICTING_NAME; + } + + id &= ~SPIFFS_OBJ_ID_IX_FLAG; + if (id >= state->min_obj_id && id <= state->max_obj_id) { + u8_t *map = (u8_t *)fs->work; + int ix = (id - state->min_obj_id) / state->compaction; + //SPIFFS_DBG("free_obj_id: add ix %i for id %04x min:%04x max%04x comp:%i\n", ix, id, state->min_obj_id, state->max_obj_id, state->compaction); + map[ix]++; + } + } + } + return SPIFFS_VIS_COUNTINUE; +} + +// Scans thru all object lookup for object index header pages. If total possible number of +// object ids cannot fit into a work buffer, these are grouped. When a group containing free +// object ids is found, the object lu is again scanned for object ids within group and bitmasked. +// Finally, the bitmasked is searched for a free id +s32_t spiffs_obj_lu_find_free_obj_id(spiffs *fs, spiffs_obj_id *obj_id, u8_t *conflicting_name) { + s32_t res = SPIFFS_OK; + u32_t max_objects = (SPIFFS_CFG_PHYS_SZ(fs) / (u32_t)SPIFFS_CFG_LOG_PAGE_SZ(fs)) / 2; + spiffs_free_obj_id_state state; + spiffs_obj_id free_obj_id = SPIFFS_OBJ_ID_FREE; + state.min_obj_id = 1; + state.max_obj_id = max_objects + 1; + if (state.max_obj_id & SPIFFS_OBJ_ID_IX_FLAG) { + state.max_obj_id = ((spiffs_obj_id)-1) & ~SPIFFS_OBJ_ID_IX_FLAG; + } + state.compaction = 0; + state.conflicting_name = conflicting_name; + while (res == SPIFFS_OK && free_obj_id == SPIFFS_OBJ_ID_FREE) { + if (state.max_obj_id - state.min_obj_id <= (spiffs_obj_id)SPIFFS_CFG_LOG_PAGE_SZ(fs)*8) { + // possible to represent in bitmap + u32_t i, j; + SPIFFS_DBG("free_obj_id: BITM min:%04x max:%04x\n", state.min_obj_id, state.max_obj_id); + + c_memset(fs->work, 0, SPIFFS_CFG_LOG_PAGE_SZ(fs)); + res = spiffs_obj_lu_find_entry_visitor(fs, 0, 0, 0, 0, spiffs_obj_lu_find_free_obj_id_bitmap_v, state.min_obj_id, + conflicting_name, 0, 0); + if (res == SPIFFS_VIS_END) res = SPIFFS_OK; + SPIFFS_CHECK_RES(res); + // traverse bitmask until found free obj_id + for (i = 0; i < SPIFFS_CFG_LOG_PAGE_SZ(fs); i++) { + u8_t mask = fs->work[i]; + if (mask == 0xff) { + continue; + } + for (j = 0; j < 8; j++) { + if ((mask & (1<work; + u8_t min_count = 0xff; + + for (i = 0; i < SPIFFS_CFG_LOG_PAGE_SZ(fs)/sizeof(u8_t); i++) { + if (map[i] < min_count) { + min_count = map[i]; + min_i = i; + if (min_count == 0) { + break; + } + } + } + + if (min_count == state.compaction) { + // there are no free objids! + SPIFFS_DBG("free_obj_id: compacted table is full\n"); + return SPIFFS_ERR_FULL; + } + + SPIFFS_DBG("free_obj_id: COMP select index:%i min_count:%i min:%04x max:%04x compact:%i\n", min_i, min_count, state.min_obj_id, state.max_obj_id, state.compaction); + + if (min_count == 0) { + // no id in this range, skip compacting and use directly + *obj_id = min_i * state.compaction + state.min_obj_id; + return SPIFFS_OK; + } else { + SPIFFS_DBG("free_obj_id: COMP SEL chunk:%04x min:%04x -> %04x\n", state.compaction, state.min_obj_id, state.min_obj_id + min_i * state.compaction); + state.min_obj_id += min_i * state.compaction; + state.max_obj_id = state.min_obj_id + state.compaction; + // decrease compaction + } + if ((state.max_obj_id - state.min_obj_id <= (spiffs_obj_id)SPIFFS_CFG_LOG_PAGE_SZ(fs)*8)) { + // no need for compacting, use bitmap + continue; + } + } + // in a work memory of log_page_size bytes, we may fit in log_page_size ids + // todo what if compaction is > 255 - then we cannot fit it in a byte + state.compaction = (state.max_obj_id-state.min_obj_id) / ((SPIFFS_CFG_LOG_PAGE_SZ(fs) / sizeof(u8_t))); + SPIFFS_DBG("free_obj_id: COMP min:%04x max:%04x compact:%i\n", state.min_obj_id, state.max_obj_id, state.compaction); + + c_memset(fs->work, 0, SPIFFS_CFG_LOG_PAGE_SZ(fs)); + res = spiffs_obj_lu_find_entry_visitor(fs, 0, 0, 0, 0, spiffs_obj_lu_find_free_obj_id_compact_v, 0, &state, 0, 0); + if (res == SPIFFS_VIS_END) res = SPIFFS_OK; + SPIFFS_CHECK_RES(res); + state.conflicting_name = 0; // searched for conflicting name once, no need to do it again + } + } + + return res; +} + +s32_t spiffs_fd_find_new(spiffs *fs, spiffs_fd **fd) { + u32_t i; + spiffs_fd *fds = (spiffs_fd *)fs->fd_space; + for (i = 0; i < fs->fd_count; i++) { + spiffs_fd *cur_fd = &fds[i]; + if (cur_fd->file_nbr == 0) { + cur_fd->file_nbr = i+1; + *fd = cur_fd; + return SPIFFS_OK; + } + } + return SPIFFS_ERR_OUT_OF_FILE_DESCS; +} + +s32_t spiffs_fd_return(spiffs *fs, spiffs_file f) { + if (f <= 0 || f > (s16_t)fs->fd_count) { + return SPIFFS_ERR_BAD_DESCRIPTOR; + } + spiffs_fd *fds = (spiffs_fd *)fs->fd_space; + spiffs_fd *fd = &fds[f-1]; + if (fd->file_nbr == 0) { + return SPIFFS_ERR_FILE_CLOSED; + } + fd->file_nbr = 0; + return SPIFFS_OK; +} + +s32_t spiffs_fd_get(spiffs *fs, spiffs_file f, spiffs_fd **fd) { + if (f <= 0 || f > (s16_t)fs->fd_count) { + return SPIFFS_ERR_BAD_DESCRIPTOR; + } + spiffs_fd *fds = (spiffs_fd *)fs->fd_space; + *fd = &fds[f-1]; + if ((*fd)->file_nbr == 0) { + return SPIFFS_ERR_FILE_CLOSED; + } + return SPIFFS_OK; +} diff --git a/cores/esp8266/spiffs/spiffs_nucleus.h b/cores/esp8266/spiffs/spiffs_nucleus.h new file mode 100755 index 000000000..9b10d9181 --- /dev/null +++ b/cores/esp8266/spiffs/spiffs_nucleus.h @@ -0,0 +1,687 @@ +/* + * spiffs_nucleus.h + * + * Created on: Jun 15, 2013 + * Author: petera + */ + +/* SPIFFS layout + * + * spiffs is designed for following spi flash characteristics: + * - only big areas of data (blocks) can be erased + * - erasing resets all bits in a block to ones + * - writing pulls ones to zeroes + * - zeroes cannot be pulled to ones, without erase + * - wear leveling + * + * spiffs is also meant to be run on embedded, memory constraint devices. + * + * Entire area is divided in blocks. Entire area is also divided in pages. + * Each block contains same number of pages. A page cannot be erased, but a + * block can be erased. + * + * Entire area must be block_size * x + * page_size must be block_size / (2^y) where y > 2 + * + * ex: area = 1024*1024 bytes, block size = 65536 bytes, page size = 256 bytes + * + * BLOCK 0 PAGE 0 object lookup 1 + * PAGE 1 object lookup 2 + * ... + * PAGE n-1 object lookup n + * PAGE n object data 1 + * PAGE n+1 object data 2 + * ... + * PAGE n+m-1 object data m + * + * BLOCK 1 PAGE n+m object lookup 1 + * PAGE n+m+1 object lookup 2 + * ... + * PAGE 2n+m-1 object lookup n + * PAGE 2n+m object data 1 + * PAGE 2n+m object data 2 + * ... + * PAGE 2n+2m-1 object data m + * ... + * + * n is number of object lookup pages, which is number of pages needed to index all pages + * in a block by object id + * : block_size / page_size * sizeof(obj_id) / page_size + * m is number data pages, which is number of pages in block minus number of lookup pages + * : block_size / page_size - block_size / page_size * sizeof(obj_id) / page_size + * thus, n+m is total number of pages in a block + * : block_size / page_size + * + * ex: n = 65536/256*2/256 = 2, m = 65536/256 - 2 = 254 => n+m = 65536/256 = 256 + * + * Object lookup pages contain object id entries. Each entry represent the corresponding + * data page. + * Assuming a 16 bit object id, an object id being 0xffff represents a free page. + * An object id being 0x0000 represents a deleted page. + * + * ex: page 0 : lookup : 0008 0001 0aaa ffff ffff ffff ffff ffff .. + * page 1 : lookup : ffff ffff ffff ffff ffff ffff ffff ffff .. + * page 2 : data : data for object id 0008 + * page 3 : data : data for object id 0001 + * page 4 : data : data for object id 0aaa + * ... + * + * + * Object data pages can be either object index pages or object content. + * All object data pages contains a data page header, containing object id and span index. + * The span index denotes the object page ordering amongst data pages with same object id. + * This applies to both object index pages (when index spans more than one page of entries), + * and object data pages. + * An object index page contains page entries pointing to object content page. The entry index + * in a object index page correlates to the span index in the actual object data page. + * The first object index page (span index 0) is called object index header page, and also + * contains object flags (directory/file), size, object name etc. + * + * ex: + * BLOCK 1 + * PAGE 256: objectl lookup page 1 + * [*123] [ 123] [ 123] [ 123] + * [ 123] [*123] [ 123] [ 123] + * [free] [free] [free] [free] ... + * PAGE 257: objectl lookup page 2 + * [free] [free] [free] [free] ... + * PAGE 258: object index page (header) + * obj.id:0123 span.ix:0000 flags:INDEX + * size:1600 name:ex.txt type:file + * [259] [260] [261] [262] + * PAGE 259: object data page + * obj.id:0123 span.ix:0000 flags:DATA + * PAGE 260: object data page + * obj.id:0123 span.ix:0001 flags:DATA + * PAGE 261: object data page + * obj.id:0123 span.ix:0002 flags:DATA + * PAGE 262: object data page + * obj.id:0123 span.ix:0003 flags:DATA + * PAGE 263: object index page + * obj.id:0123 span.ix:0001 flags:INDEX + * [264] [265] [fre] [fre] + * [fre] [fre] [fre] [fre] + * PAGE 264: object data page + * obj.id:0123 span.ix:0004 flags:DATA + * PAGE 265: object data page + * obj.id:0123 span.ix:0005 flags:DATA + * + */ +#ifndef SPIFFS_NUCLEUS_H_ +#define SPIFFS_NUCLEUS_H_ + +#define _SPIFFS_ERR_CHECK_FIRST (SPIFFS_ERR_INTERNAL - 1) +#define SPIFFS_ERR_CHECK_OBJ_ID_MISM (SPIFFS_ERR_INTERNAL - 1) +#define SPIFFS_ERR_CHECK_SPIX_MISM (SPIFFS_ERR_INTERNAL - 2) +#define SPIFFS_ERR_CHECK_FLAGS_BAD (SPIFFS_ERR_INTERNAL - 3) +#define _SPIFFS_ERR_CHECK_LAST (SPIFFS_ERR_INTERNAL - 4) + +#define SPIFFS_VIS_COUNTINUE (SPIFFS_ERR_INTERNAL - 20) +#define SPIFFS_VIS_COUNTINUE_RELOAD (SPIFFS_ERR_INTERNAL - 21) +#define SPIFFS_VIS_END (SPIFFS_ERR_INTERNAL - 22) + +#define SPIFFS_EV_IX_UPD 0 +#define SPIFFS_EV_IX_NEW 1 +#define SPIFFS_EV_IX_DEL 2 + +#define SPIFFS_OBJ_ID_IX_FLAG (1<<(8*sizeof(spiffs_obj_id)-1)) + +#define SPIFFS_UNDEFINED_LEN (u32_t)(-1) + +#define SPIFFS_OBJ_ID_DELETED ((spiffs_obj_id)0) +#define SPIFFS_OBJ_ID_FREE ((spiffs_obj_id)-1) + +#if SPIFFS_SINGLETON == 0 +#define SPIFFS_CFG_LOG_PAGE_SZ(fs) \ + ((fs)->cfg.log_page_size) +#define SPIFFS_CFG_LOG_BLOCK_SZ(fs) \ + ((fs)->cfg.log_block_size) +#define SPIFFS_CFG_PHYS_SZ(fs) \ + ((fs)->cfg.phys_size) +#define SPIFFS_CFG_PHYS_ERASE_SZ(fs) \ + ((fs)->cfg.phys_erase_block) +#define SPIFFS_CFG_PHYS_ADDR(fs) \ + ((fs)->cfg.phys_addr) +#endif + +// total number of pages +#define SPIFFS_MAX_PAGES(fs) \ + ( SPIFFS_CFG_PHYS_SZ(fs)/SPIFFS_CFG_LOG_PAGE_SZ(fs) ) +// total number of pages per block, including object lookup pages +#define SPIFFS_PAGES_PER_BLOCK(fs) \ + ( SPIFFS_CFG_LOG_BLOCK_SZ(fs)/SPIFFS_CFG_LOG_PAGE_SZ(fs) ) +// number of object lookup pages per block +#define SPIFFS_OBJ_LOOKUP_PAGES(fs) \ + (MAX(1, (SPIFFS_PAGES_PER_BLOCK(fs) * sizeof(spiffs_obj_id)) / SPIFFS_CFG_LOG_PAGE_SZ(fs)) ) +// checks if page index belongs to object lookup +#define SPIFFS_IS_LOOKUP_PAGE(fs,pix) \ + (((pix) % SPIFFS_PAGES_PER_BLOCK(fs)) < SPIFFS_OBJ_LOOKUP_PAGES(fs)) +// number of object lookup entries in all object lookup pages +#define SPIFFS_OBJ_LOOKUP_MAX_ENTRIES(fs) \ + (SPIFFS_PAGES_PER_BLOCK(fs)-SPIFFS_OBJ_LOOKUP_PAGES(fs)) +// converts a block to physical address +#define SPIFFS_BLOCK_TO_PADDR(fs, block) \ + ( SPIFFS_CFG_PHYS_ADDR(fs) + (block)* SPIFFS_CFG_LOG_BLOCK_SZ(fs) ) +// converts a object lookup entry to page index +#define SPIFFS_OBJ_LOOKUP_ENTRY_TO_PIX(fs, block, entry) \ + ((block)*SPIFFS_PAGES_PER_BLOCK(fs) + (SPIFFS_OBJ_LOOKUP_PAGES(fs) + entry)) +// converts a object lookup entry to physical address of corresponding page +#define SPIFFS_OBJ_LOOKUP_ENTRY_TO_PADDR(fs, block, entry) \ + (SPIFFS_BLOCK_TO_PADDR(fs, block) + (SPIFFS_OBJ_LOOKUP_PAGES(fs) + entry) * SPIFFS_CFG_LOG_PAGE_SZ(fs) ) +// converts a page to physical address +#define SPIFFS_PAGE_TO_PADDR(fs, page) \ + ( SPIFFS_CFG_PHYS_ADDR(fs) + (page) * SPIFFS_CFG_LOG_PAGE_SZ(fs) ) +// converts a physical address to page +#define SPIFFS_PADDR_TO_PAGE(fs, addr) \ + ( ((addr) - SPIFFS_CFG_PHYS_ADDR(fs)) / SPIFFS_CFG_LOG_PAGE_SZ(fs) ) +// gives index in page for a physical address +#define SPIFFS_PADDR_TO_PAGE_OFFSET(fs, addr) \ + ( ((addr) - SPIFFS_CFG_PHYS_ADDR(fs)) % SPIFFS_CFG_LOG_PAGE_SZ(fs) ) +// returns containing block for given page +#define SPIFFS_BLOCK_FOR_PAGE(fs, page) \ + ( (page) / SPIFFS_PAGES_PER_BLOCK(fs) ) +// returns starting page for block +#define SPIFFS_PAGE_FOR_BLOCK(fs, block) \ + ( (block) * SPIFFS_PAGES_PER_BLOCK(fs) ) +// converts page to entry in object lookup page +#define SPIFFS_OBJ_LOOKUP_ENTRY_FOR_PAGE(fs, page) \ + ( (page) % SPIFFS_PAGES_PER_BLOCK(fs) - SPIFFS_OBJ_LOOKUP_PAGES(fs) ) +// returns data size in a data page +#define SPIFFS_DATA_PAGE_SIZE(fs) \ + ( SPIFFS_CFG_LOG_PAGE_SZ(fs) - sizeof(spiffs_page_header) ) +// returns physical address for block's erase count +#define SPIFFS_ERASE_COUNT_PADDR(fs, bix) \ + ( SPIFFS_BLOCK_TO_PADDR(fs, bix) + SPIFFS_OBJ_LOOKUP_PAGES(fs) * SPIFFS_CFG_LOG_PAGE_SZ(fs) - sizeof(spiffs_obj_id) ) + +// define helpers object + +// entries in an object header page index +#define SPIFFS_OBJ_HDR_IX_LEN(fs) \ + ((SPIFFS_CFG_LOG_PAGE_SZ(fs) - sizeof(spiffs_page_object_ix_header))/sizeof(spiffs_page_ix)) +// entries in an object page index +#define SPIFFS_OBJ_IX_LEN(fs) \ + ((SPIFFS_CFG_LOG_PAGE_SZ(fs) - sizeof(spiffs_page_object_ix))/sizeof(spiffs_page_ix)) +// object index entry for given data span index +#define SPIFFS_OBJ_IX_ENTRY(fs, spix) \ + ((spix) < SPIFFS_OBJ_HDR_IX_LEN(fs) ? (spix) : (((spix)-SPIFFS_OBJ_HDR_IX_LEN(fs))%SPIFFS_OBJ_IX_LEN(fs))) +// object index span index number for given data span index or entry +#define SPIFFS_OBJ_IX_ENTRY_SPAN_IX(fs, spix) \ + ((spix) < SPIFFS_OBJ_HDR_IX_LEN(fs) ? 0 : (1+((spix)-SPIFFS_OBJ_HDR_IX_LEN(fs))/SPIFFS_OBJ_IX_LEN(fs))) + + +#define SPIFFS_OP_T_OBJ_LU (0<<0) +#define SPIFFS_OP_T_OBJ_LU2 (1<<0) +#define SPIFFS_OP_T_OBJ_IX (2<<0) +#define SPIFFS_OP_T_OBJ_DA (3<<0) +#define SPIFFS_OP_C_DELE (0<<2) +#define SPIFFS_OP_C_UPDT (1<<2) +#define SPIFFS_OP_C_MOVS (2<<2) +#define SPIFFS_OP_C_MOVD (3<<2) +#define SPIFFS_OP_C_FLSH (4<<2) +#define SPIFFS_OP_C_READ (5<<2) +#define SPIFFS_OP_C_WRTHRU (6<<2) + +#define SPIFFS_OP_TYPE_MASK (3<<0) +#define SPIFFS_OP_COM_MASK (7<<2) + + +// if 0, this page is written to, else clean +#define SPIFFS_PH_FLAG_USED (1<<0) +// if 0, writing is finalized, else under modification +#define SPIFFS_PH_FLAG_FINAL (1<<1) +// if 0, this is an index page, else a data page +#define SPIFFS_PH_FLAG_INDEX (1<<2) +// if 0, page is deleted, else valid +#define SPIFFS_PH_FLAG_DELET (1<<7) +// if 0, this index header is being deleted +#define SPIFFS_PH_FLAG_IXDELE (1<<6) + + +#define SPIFFS_CHECK_MOUNT(fs) \ + ((fs)->block_count > 0) + +#define SPIFFS_CHECK_RES(res) \ + do { \ + if ((res) < SPIFFS_OK) return (res); \ + } while (0); + +#define SPIFFS_API_CHECK_MOUNT(fs) \ + if (!SPIFFS_CHECK_MOUNT((fs))) { \ + (fs)->errno = SPIFFS_ERR_NOT_MOUNTED; \ + return -1; \ + } + +#define SPIFFS_API_CHECK_RES(fs, res) \ + if ((res) < SPIFFS_OK) { \ + (fs)->errno = (res); \ + return -1; \ + } + +#define SPIFFS_API_CHECK_RES_UNLOCK(fs, res) \ + if ((res) < SPIFFS_OK) { \ + (fs)->errno = (res); \ + SPIFFS_UNLOCK(fs); \ + return -1; \ + } + +#define SPIFFS_VALIDATE_OBJIX(ph, objid, spix) \ + if (((ph).flags & SPIFFS_PH_FLAG_USED) != 0) return SPIFFS_ERR_IS_FREE; \ + if (((ph).flags & SPIFFS_PH_FLAG_DELET) == 0) return SPIFFS_ERR_DELETED; \ + if (((ph).flags & SPIFFS_PH_FLAG_FINAL) != 0) return SPIFFS_ERR_NOT_FINALIZED; \ + if (((ph).flags & SPIFFS_PH_FLAG_INDEX) != 0) return SPIFFS_ERR_NOT_INDEX; \ + if (((objid) & SPIFFS_OBJ_ID_IX_FLAG) == 0) return SPIFFS_ERR_NOT_INDEX; \ + if ((ph).span_ix != (spix)) return SPIFFS_ERR_INDEX_SPAN_MISMATCH; + //if ((spix) == 0 && ((ph).flags & SPIFFS_PH_FLAG_IXDELE) == 0) return SPIFFS_ERR_DELETED; + +#define SPIFFS_VALIDATE_DATA(ph, objid, spix) \ + if (((ph).flags & SPIFFS_PH_FLAG_USED) != 0) return SPIFFS_ERR_IS_FREE; \ + if (((ph).flags & SPIFFS_PH_FLAG_DELET) == 0) return SPIFFS_ERR_DELETED; \ + if (((ph).flags & SPIFFS_PH_FLAG_FINAL) != 0) return SPIFFS_ERR_NOT_FINALIZED; \ + if (((ph).flags & SPIFFS_PH_FLAG_INDEX) == 0) return SPIFFS_ERR_IS_INDEX; \ + if ((objid) & SPIFFS_OBJ_ID_IX_FLAG) return SPIFFS_ERR_IS_INDEX; \ + if ((ph).span_ix != (spix)) return SPIFFS_ERR_DATA_SPAN_MISMATCH; + + +// check id +#define SPIFFS_VIS_CHECK_ID (1<<0) +// report argument object id to visitor - else object lookup id is reported +#define SPIFFS_VIS_CHECK_PH (1<<1) +// stop searching at end of all look up pages +#define SPIFFS_VIS_NO_WRAP (1<<2) + +#if SPIFFS_CACHE + +#define SPIFFS_CACHE_FLAG_DIRTY (1<<0) +#define SPIFFS_CACHE_FLAG_WRTHRU (1<<1) +#define SPIFFS_CACHE_FLAG_OBJLU (1<<2) +#define SPIFFS_CACHE_FLAG_OBJIX (1<<3) +#define SPIFFS_CACHE_FLAG_DATA (1<<4) +#define SPIFFS_CACHE_FLAG_TYPE_WR (1<<7) + +#define SPIFFS_CACHE_PAGE_SIZE(fs) \ + (sizeof(spiffs_cache_page) + SPIFFS_CFG_LOG_PAGE_SZ(fs)) + +#define spiffs_get_cache(fs) \ + ((spiffs_cache *)((fs)->cache)) + +#define spiffs_get_cache_page_hdr(fs, c, ix) \ + ((spiffs_cache_page *)(&((c)->cpages[(ix) * SPIFFS_CACHE_PAGE_SIZE(fs)]))) + +#define spiffs_get_cache_page(fs, c, ix) \ + ((u8_t *)(&((c)->cpages[(ix) * SPIFFS_CACHE_PAGE_SIZE(fs)])) + sizeof(spiffs_cache_page)) + +// cache page struct +typedef struct { + // cache flags + u8_t flags; + // cache page index + u8_t ix; + // last access of this cache page + u32_t last_access; + union { + // type read cache + struct { + // read cache page index + spiffs_page_ix pix; + }; +#if SPIFFS_CACHE_WR + // type write cache + struct { + // write cache + spiffs_obj_id obj_id; + // offset in cache page + u32_t offset; + // size of cache page + u16_t size; + }; +#endif + }; +} spiffs_cache_page; + +// cache struct +typedef struct { + u8_t cpage_count; + u32_t last_access; + u32_t cpage_use_map; + u32_t cpage_use_mask; + u8_t *cpages; +} spiffs_cache; + +#endif + + +// spiffs nucleus file descriptor +typedef struct { + // the filesystem of this descriptor + spiffs *fs; + // number of file descriptor - if 0, the file descriptor is closed + spiffs_file file_nbr; + // object id - if SPIFFS_OBJ_ID_ERASED, the file was deleted + spiffs_obj_id obj_id; + // size of the file + u32_t size; + // cached object index header page index + spiffs_page_ix objix_hdr_pix; + // cached offset object index page index + spiffs_page_ix cursor_objix_pix; + // cached offset object index span index + spiffs_span_ix cursor_objix_spix; + // current absolute offset + u32_t offset; + // current file descriptor offset + u32_t fdoffset; + // fd flags + spiffs_flags flags; +#if SPIFFS_CACHE_WR + spiffs_cache_page *cache_page; +#endif +} spiffs_fd; + + +// object structs + +// page header, part of each page except object lookup pages +typedef struct __attribute(( packed )) { + // object id + spiffs_obj_id obj_id; + // object span index + spiffs_span_ix span_ix; + // flags + u8_t flags; +} spiffs_page_header; + +// object index header page header +typedef struct __attribute(( packed )) { + // common page header + spiffs_page_header p_hdr; + // alignment + u8_t _align[4 - (sizeof(spiffs_page_header)&3)==0 ? 4 : (sizeof(spiffs_page_header)&3)]; + // size of object + u32_t size; + // type of object + spiffs_obj_type type; + // alignment2 + u8_t _align2[4 - (sizeof(spiffs_obj_type)&3)==0 ? 4 : (sizeof(spiffs_obj_type)&3)]; + // name of object + u8_t name[SPIFFS_OBJ_NAME_LEN]; +} spiffs_page_object_ix_header; + +// object index page header +typedef struct __attribute(( packed )) { + spiffs_page_header p_hdr; + u8_t _align[4 - (sizeof(spiffs_page_header)&3)==0 ? 4 : (sizeof(spiffs_page_header)&3)]; +} spiffs_page_object_ix; + +// callback func for object lookup visitor +typedef s32_t (*spiffs_visitor_f)(spiffs *fs, spiffs_obj_id id, spiffs_block_ix bix, int ix_entry, + u32_t user_data, void *user_p); + + +#if SPIFFS_CACHE +#define _spiffs_rd(fs, op, fh, addr, len, dst) \ + spiffs_phys_rd((fs), (op), (fh), (addr), (len), (dst)) +#define _spiffs_wr(fs, op, fh, addr, len, src) \ + spiffs_phys_wr((fs), (op), (fh), (addr), (len), (src)) +#else +#define _spiffs_rd(fs, op, fh, addr, len, dst) \ + spiffs_phys_rd((fs), (addr), (len), (dst)) +#define _spiffs_wr(fs, op, fh, addr, len, src) \ + spiffs_phys_wr((fs), (addr), (len), (src)) +#endif + +#ifndef MIN +#define MIN(a,b) ((a) < (b) ? (a) : (b)) +#endif +#ifndef MAX +#define MAX(a,b) ((a) > (b) ? (a) : (b)) +#endif + +// --------------- + +s32_t spiffs_phys_rd( + spiffs *fs, +#if SPIFFS_CACHE + u8_t op, + spiffs_file fh, +#endif + u32_t addr, + u32_t len, + u8_t *dst); + +s32_t spiffs_phys_wr( + spiffs *fs, +#if SPIFFS_CACHE + u8_t op, + spiffs_file fh, +#endif + u32_t addr, + u32_t len, + u8_t *src); + +s32_t spiffs_phys_cpy( + spiffs *fs, + spiffs_file fh, + u32_t dst, + u32_t src, + u32_t len); + +s32_t spiffs_phys_count_free_blocks( + spiffs *fs); + +s32_t spiffs_obj_lu_find_entry_visitor( + spiffs *fs, + spiffs_block_ix starting_block, + int starting_lu_entry, + u8_t flags, + spiffs_obj_id obj_id, + spiffs_visitor_f v, + u32_t user_data, + void *user_p, + spiffs_block_ix *block_ix, + int *lu_entry); + +// --------------- + +s32_t spiffs_obj_lu_scan( + spiffs *fs); + +s32_t spiffs_obj_lu_find_free_obj_id( + spiffs *fs, + spiffs_obj_id *obj_id, + u8_t *conflicting_name); + +s32_t spiffs_obj_lu_find_free( + spiffs *fs, + spiffs_block_ix starting_block, + int starting_lu_entry, + spiffs_block_ix *block_ix, + int *lu_entry); + +s32_t spiffs_obj_lu_find_id( + spiffs *fs, + spiffs_block_ix starting_block, + int starting_lu_entry, + spiffs_obj_id obj_id, + spiffs_block_ix *block_ix, + int *lu_entry); + +s32_t spiffs_obj_lu_find_id_and_span( + spiffs *fs, + spiffs_obj_id obj_id, + spiffs_span_ix spix, + spiffs_page_ix exclusion_pix, + spiffs_page_ix *pix); + +s32_t spiffs_obj_lu_find_id_and_span_by_phdr( + spiffs *fs, + spiffs_obj_id obj_id, + spiffs_span_ix spix, + spiffs_page_ix exclusion_pix, + spiffs_page_ix *pix); + +// --------------- + +s32_t spiffs_page_allocate_data( + spiffs *fs, + spiffs_obj_id obj_id, + spiffs_page_header *ph, + u8_t *data, + u32_t len, + u32_t page_offs, + u8_t finalize, + spiffs_page_ix *pix); + +s32_t spiffs_page_move( + spiffs *fs, + spiffs_file fh, + u8_t *page_data, + spiffs_obj_id obj_id, + spiffs_page_header *page_hdr, + spiffs_page_ix src_pix, + spiffs_page_ix *dst_pix); + +s32_t spiffs_page_delete( + spiffs *fs, + spiffs_page_ix pix); + +// --------------- + +s32_t spiffs_object_create( + spiffs *fs, + spiffs_obj_id obj_id, + u8_t name[SPIFFS_OBJ_NAME_LEN], + spiffs_obj_type type, + spiffs_page_ix *objix_hdr_pix); + +s32_t spiffs_object_update_index_hdr( + spiffs *fs, + spiffs_fd *fd, + spiffs_obj_id obj_id, + spiffs_page_ix objix_hdr_pix, + u8_t *new_objix_hdr_data, + u8_t name[SPIFFS_OBJ_NAME_LEN], + u32_t size, + spiffs_page_ix *new_pix); + +void spiffs_cb_object_event( + spiffs *fs, + spiffs_fd *fd, + int ev, + spiffs_obj_id obj_id, + spiffs_span_ix spix, + spiffs_page_ix new_pix, + u32_t new_size); + +s32_t spiffs_object_open_by_id( + spiffs *fs, + spiffs_obj_id obj_id, + spiffs_fd *f, + spiffs_flags flags, + spiffs_mode mode); + +s32_t spiffs_object_open_by_page( + spiffs *fs, + spiffs_page_ix pix, + spiffs_fd *f, + spiffs_flags flags, + spiffs_mode mode); + +s32_t spiffs_object_append( + spiffs_fd *fd, + u32_t offset, + u8_t *data, + u32_t len); + +s32_t spiffs_object_modify( + spiffs_fd *fd, + u32_t offset, + u8_t *data, + u32_t len); + +s32_t spiffs_object_read( + spiffs_fd *fd, + u32_t offset, + u32_t len, + u8_t *dst); + +s32_t spiffs_object_truncate( + spiffs_fd *fd, + u32_t new_len, + u8_t remove_object); + +s32_t spiffs_object_find_object_index_header_by_name( + spiffs *fs, + u8_t name[SPIFFS_OBJ_NAME_LEN], + spiffs_page_ix *pix); + +// --------------- + +s32_t spiffs_gc_check( + spiffs *fs, + u32_t len); + +s32_t spiffs_gc_erase_page_stats( + spiffs *fs, + spiffs_block_ix bix); + +s32_t spiffs_gc_find_candidate( + spiffs *fs, + spiffs_block_ix **block_candidate, + int *candidate_count); + +s32_t spiffs_gc_clean( + spiffs *fs, + spiffs_block_ix bix); + +s32_t spiffs_gc_quick( + spiffs *fs); + +// --------------- + +s32_t spiffs_fd_find_new( + spiffs *fs, + spiffs_fd **fd); + +s32_t spiffs_fd_return( + spiffs *fs, + spiffs_file f); + +s32_t spiffs_fd_get( + spiffs *fs, + spiffs_file f, + spiffs_fd **fd); + +#if SPIFFS_CACHE +void spiffs_cache_init( + spiffs *fs); + +void spiffs_cache_drop_page( + spiffs *fs, + spiffs_page_ix pix); + +#if SPIFFS_CACHE_WR +spiffs_cache_page *spiffs_cache_page_allocate_by_fd( + spiffs *fs, + spiffs_fd *fd); + +void spiffs_cache_fd_release( + spiffs *fs, + spiffs_cache_page *cp); + +spiffs_cache_page *spiffs_cache_page_get_by_fd( + spiffs *fs, + spiffs_fd *fd); +#endif +#endif + +s32_t spiffs_lookup_consistency_check( + spiffs *fs, + u8_t check_all_objects); + +s32_t spiffs_page_consistency_check( + spiffs *fs); + +s32_t spiffs_object_index_consistency_check( + spiffs *fs); + +#endif /* SPIFFS_NUCLEUS_H_ */ From 3e7b8515e4640edaf23283a6d0528dbb73a13127 Mon Sep 17 00:00:00 2001 From: ficeto Date: Wed, 13 May 2015 20:01:05 +0300 Subject: [PATCH 10/78] pull get/set NoDelay for WiFiClient --- libraries/ESP8266WiFi/src/WiFiClient.cpp | 13 +++++++++++++ libraries/ESP8266WiFi/src/WiFiClient.h | 2 ++ 2 files changed, 15 insertions(+) diff --git a/libraries/ESP8266WiFi/src/WiFiClient.cpp b/libraries/ESP8266WiFi/src/WiFiClient.cpp index 707e486cc..534c7fa89 100644 --- a/libraries/ESP8266WiFi/src/WiFiClient.cpp +++ b/libraries/ESP8266WiFi/src/WiFiClient.cpp @@ -123,6 +123,19 @@ void ICACHE_FLASH_ATTR WiFiClient::_err(int8_t err) esp_schedule(); } + +void ICACHE_FLASH_ATTR WiFiClient::setNoDelay(bool nodelay) { + if (!_client) + return; + _client->setNoDelay(nodelay); +} + +bool ICACHE_FLASH_ATTR WiFiClient::getNoDelay() { + if (!_client) + return false; + return _client->getNoDelay(); +} + size_t ICACHE_FLASH_ATTR WiFiClient::write(uint8_t b) { return write(&b, 1); diff --git a/libraries/ESP8266WiFi/src/WiFiClient.h b/libraries/ESP8266WiFi/src/WiFiClient.h index ca6d26637..f01aead13 100644 --- a/libraries/ESP8266WiFi/src/WiFiClient.h +++ b/libraries/ESP8266WiFi/src/WiFiClient.h @@ -55,6 +55,8 @@ public: IPAddress remoteIP(); uint16_t remotePort(); + bool getNoDelay(); + void setNoDelay(bool nodelay); template size_t write(T &src){ uint8_t obuf[1460]; From e0c1b47937f95249bfeac4fb22a25d4a00d30139 Mon Sep 17 00:00:00 2001 From: Markus Sattler Date: Wed, 13 May 2015 19:03:21 +0200 Subject: [PATCH 11/78] add some notes to the SPI functions (aligned to 32Bit) - Fatal exception (9) --- libraries/SPI/SPI.cpp | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/libraries/SPI/SPI.cpp b/libraries/SPI/SPI.cpp index be4627740..c96c4fcb8 100644 --- a/libraries/SPI/SPI.cpp +++ b/libraries/SPI/SPI.cpp @@ -308,6 +308,13 @@ void SPIClass::write32(uint32_t data, bool msb) { while(SPI1CMD & SPIBUSY) {} } +/** + * Note: + * data need to be aligned to 32Bit + * or you get an Fatal exception (9) + * @param data uint8_t * + * @param size uint32_t + */ void SPIClass::writeBytes(uint8_t * data, uint32_t size) { while(size) { if(size > 64) { @@ -340,6 +347,15 @@ void SPIClass::writeBytes_(uint8_t * data, uint8_t size) { while(SPI1CMD & SPIBUSY) {} } + +/** + * Note: + * data need to be aligned to 32Bit + * or you get an Fatal exception (9) + * @param data uint8_t * + * @param size uint8_t max for size is 64Byte + * @param repeat uint32_t + */ void SPIClass::writePattern(uint8_t * data, uint8_t size, uint32_t repeat) { if(size > 64) return; //max Hardware FIFO @@ -376,6 +392,14 @@ void SPIClass::writePattern_(uint8_t * data, uint8_t size, uint8_t repeat) { writeBytes(&buffer[0], bytes); } +/** + * Note: + * in and out need to be aligned to 32Bit + * or you get an Fatal exception (9) + * @param out uint8_t * + * @param in uint8_t * + * @param size uint32_t + */ void SPIClass::transferBytes(uint8_t * out, uint8_t * in, uint32_t size) { while(size) { if(size > 64) { From a17aded8d651757a884580c99f1a7480dd817304 Mon Sep 17 00:00:00 2001 From: Markus Sattler Date: Wed, 13 May 2015 22:54:09 +0200 Subject: [PATCH 12/78] add hexdump function for easy debugging. Output: [HEXDUMP] Address: 0x3FFF5188 len: 0x200 (512) [0x3FFF5188] 0x00000000: E6 D1 E6 D1 E6 D1 E6 D1 E6 D1 E6 D1 E6 D1 E6 D1 [0x3FFF5198] 0x00000010: E6 D1 E6 D1 E6 D1 E6 D1 E6 D1 E6 D1 E6 D1 E6 D1 [0x3FFF51A8] 0x00000020: E6 D1 E6 D1 E6 D1 E6 D1 E6 D1 E6 D1 E6 D1 E6 D1 [0x3FFF51B8] 0x00000030: E6 D1 E6 D1 E6 D1 E6 D1 E6 D1 E6 D1 E6 D1 E6 D1 [0x3FFF51C8] 0x00000040: E6 D1 E6 D1 E6 D1 E6 D1 E6 D1 E6 D1 E6 D1 E6 D1 [0x3FFF51D8] 0x00000050: E6 D1 E6 D1 E6 D1 E6 D1 E6 D1 E6 D1 E6 D1 E6 D1 [0x3FFF51E8] 0x00000060: E6 D1 E6 D1 E6 D1 E6 D1 E6 D1 E6 D1 E6 D1 E6 D1 .... --- cores/esp8266/Arduino.h | 3 +++ cores/esp8266/debug.cpp | 21 +++++++++++++++++++++ 2 files changed, 24 insertions(+) create mode 100644 cores/esp8266/debug.cpp diff --git a/cores/esp8266/Arduino.h b/cores/esp8266/Arduino.h index 6db13a088..9cc4ad08b 100644 --- a/cores/esp8266/Arduino.h +++ b/cores/esp8266/Arduino.h @@ -229,6 +229,9 @@ long random(long, long); void randomSeed(unsigned int); long map(long, long, long, long, long); +// Debugging functions +void hexdump(uint8_t *mem, uint32_t len, uint8_t cols = 16); + #endif #include "pins_arduino.h" diff --git a/cores/esp8266/debug.cpp b/cores/esp8266/debug.cpp new file mode 100644 index 000000000..c42016b04 --- /dev/null +++ b/cores/esp8266/debug.cpp @@ -0,0 +1,21 @@ +/* + * debug.c + * + * Created on: 13.05.2015 + * Author: Markus Sattler + */ + +#include "Arduino.h" + +void ICACHE_RAM_ATTR hexdump(uint8_t *mem, uint32_t len, uint8_t cols) { + os_printf("\n[HEXDUMP] Address: 0x%08X len: 0x%X (%d)", mem, len, len); + for(uint32_t i = 0; i < len; i++) { + if(i % cols == 0) { + os_printf("\n[0x%08X] 0x%08X: ", mem, i); + } + os_printf("%02X ", *mem); + mem++; + } + os_printf("\n"); +} + From f501530f371d805386381b94a5be77fb27a379a6 Mon Sep 17 00:00:00 2001 From: ficeto Date: Thu, 14 May 2015 00:44:33 +0300 Subject: [PATCH 13/78] fix SPIFFS to work --- cores/esp8266/spiffs/spiffs.c | 12 +++--- cores/esp8266/spiffs/spiffs_cache.c | 8 ++-- cores/esp8266/spiffs/spiffs_check.c | 10 ++--- cores/esp8266/spiffs/spiffs_config.h | 8 ++-- cores/esp8266/spiffs/spiffs_gc.c | 29 +++++++------- cores/esp8266/spiffs/spiffs_hydrogen.c | 42 ++++++++++---------- cores/esp8266/spiffs/spiffs_nucleus.c | 54 +++++++++++++------------- 7 files changed, 82 insertions(+), 81 deletions(-) diff --git a/cores/esp8266/spiffs/spiffs.c b/cores/esp8266/spiffs/spiffs.c index 860b76ae2..d739795ed 100755 --- a/cores/esp8266/spiffs/spiffs.c +++ b/cores/esp8266/spiffs/spiffs.c @@ -39,15 +39,18 @@ the entire chip (chip erase). The W25Q32BV has 1,024 erasable sectors and 64 era The small 4KB sectors allow for greater flexibility in applications that require data and parameter storage. ********************/ +extern uint32_t _SPIFFS_start; +extern uint32_t _SPIFFS_end; + spiffs_config spiffs_get_storage_config() { spiffs_config cfg = {0}; - cfg.phys_addr = ( u32_t )flashmem_get_first_free_block_address(); + cfg.phys_addr = (u32_t)&_SPIFFS_start; if (cfg.phys_addr == 0) return cfg; cfg.phys_addr += 0x3000; cfg.phys_addr &= 0xFFFFC000; // align to 4 sector. - cfg.phys_size = INTERNAL_FLASH_SIZE - ( ( u32_t )cfg.phys_addr - INTERNAL_FLASH_START_ADDRESS ); + cfg.phys_size = (u32_t)((u32_t)&_SPIFFS_end - (u32_t)&_SPIFFS_start); /*cfg.phys_addr = INTERNAL_FLASH_SIZE - SPIFFS_WORK_SIZE + INTERNAL_FLASH_START_ADDRESS; cfg.phys_addr += 0x3000; cfg.phys_addr &= 0xFFFFC000; // align to 4 sector. @@ -69,9 +72,8 @@ bool spiffs_format_internal() u32_t sect_first, sect_last; sect_first = cfg.phys_addr; - sect_first = flashmem_get_sector_of_address(sect_first); - sect_last = cfg.phys_addr + cfg.phys_size; - sect_last = flashmem_get_sector_of_address(sect_last); + sect_first = flashmem_get_sector_of_address((u32_t)&_SPIFFS_start); + sect_last = flashmem_get_sector_of_address((u32_t)&_SPIFFS_end); debugf("sect_first: %x, sect_last: %x\n", sect_first, sect_last); while( sect_first <= sect_last ) if(!flashmem_erase_sector( sect_first ++ )) diff --git a/cores/esp8266/spiffs/spiffs_cache.c b/cores/esp8266/spiffs/spiffs_cache.c index 6de0e493a..a4fec5c2e 100755 --- a/cores/esp8266/spiffs/spiffs_cache.c +++ b/cores/esp8266/spiffs/spiffs_cache.c @@ -20,7 +20,7 @@ static spiffs_cache_page *spiffs_cache_page_get(spiffs *fs, spiffs_page_ix pix) if ((cache->cpage_use_map & (1<flags & SPIFFS_CACHE_FLAG_TYPE_WR) == 0 && cp->pix == pix ) { - SPIFFS_CACHE_DBG("CACHE_GET: have cache page %i for %04x\n", i, pix); + SPIFFS_CACHE_DBG("CACHE_GET: have cache page %u for %04x\n", i, pix); cp->last_access = cache->last_access; return cp; } @@ -46,9 +46,9 @@ static s32_t spiffs_cache_page_free(spiffs *fs, int ix, u8_t write_back) { cache->cpage_use_map &= ~(1 << ix); if (cp->flags & SPIFFS_CACHE_FLAG_TYPE_WR) { - SPIFFS_CACHE_DBG("CACHE_FREE: free cache page %i objid %04x\n", ix, cp->obj_id); + SPIFFS_CACHE_DBG("CACHE_FREE: free cache page %u objid %04x\n", ix, cp->obj_id); } else { - SPIFFS_CACHE_DBG("CACHE_FREE: free cache page %i pix %04x\n", ix, cp->pix); + SPIFFS_CACHE_DBG("CACHE_FREE: free cache page %u pix %04x\n", ix, cp->pix); } } @@ -98,7 +98,7 @@ static spiffs_cache_page *spiffs_cache_page_allocate(spiffs *fs) { spiffs_cache_page *cp = spiffs_get_cache_page_hdr(fs, cache, i); cache->cpage_use_map |= (1<last_access = cache->last_access; - SPIFFS_CACHE_DBG("CACHE_ALLO: allocated cache page %i\n", i); + SPIFFS_CACHE_DBG("CACHE_ALLO: allocated cache page %u\n", i); return cp; } } diff --git a/cores/esp8266/spiffs/spiffs_check.c b/cores/esp8266/spiffs/spiffs_check.c index dbe0e80fe..aad355122 100755 --- a/cores/esp8266/spiffs/spiffs_check.c +++ b/cores/esp8266/spiffs/spiffs_check.c @@ -190,7 +190,7 @@ static s32_t spiffs_lookup_check_validate(spiffs *fs, spiffs_obj_id lu_obj_id, s res = spiffs_rewrite_index(fs, p_hdr->obj_id, p_hdr->span_ix, new_pix, objix_pix); if (res <= _SPIFFS_ERR_CHECK_FIRST && res > _SPIFFS_ERR_CHECK_LAST) { // index bad also, cannot mend this file - SPIFFS_CHECK_DBG("LU: FIXUP: index bad %i, cannot mend!\n", res); + SPIFFS_CHECK_DBG("LU: FIXUP: index bad %d, cannot mend!\n", res); res = spiffs_page_delete(fs, new_pix); SPIFFS_CHECK_RES(res); res = spiffs_delete_obj_lazy(fs, p_hdr->obj_id); @@ -249,7 +249,7 @@ static s32_t spiffs_lookup_check_validate(spiffs *fs, spiffs_obj_id lu_obj_id, s res = spiffs_rewrite_index(fs, p_hdr->obj_id, p_hdr->span_ix, new_pix, objix_pix); if (res <= _SPIFFS_ERR_CHECK_FIRST && res > _SPIFFS_ERR_CHECK_LAST) { // index bad also, cannot mend this file - SPIFFS_CHECK_DBG("LU: FIXUP: index bad %i, cannot mend!\n", res); + SPIFFS_CHECK_DBG("LU: FIXUP: index bad %d, cannot mend!\n", res); res = spiffs_page_delete(fs, new_pix); SPIFFS_CHECK_RES(res); res = spiffs_delete_obj_lazy(fs, p_hdr->obj_id); @@ -597,7 +597,7 @@ static s32_t spiffs_page_consistency_check_i(spiffs *fs) { data_spix_offset + i, data_pix, cur_pix); if (res <= _SPIFFS_ERR_CHECK_FIRST && res > _SPIFFS_ERR_CHECK_LAST) { // index bad also, cannot mend this file - SPIFFS_CHECK_DBG("PA: FIXUP: index bad %i, cannot mend - delete object\n", res); + SPIFFS_CHECK_DBG("PA: FIXUP: index bad %u, cannot mend - delete object\n", res); if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_PAGE, SPIFFS_CHECK_DELETE_BAD_FILE, objix_p_hdr->obj_id, 0); // delete file res = spiffs_page_delete(fs, cur_pix); @@ -647,7 +647,7 @@ static s32_t spiffs_page_consistency_check_i(spiffs *fs) { res = spiffs_rewrite_index(fs, p_hdr.obj_id, data_spix_offset + i, data_pix, cur_pix); if (res <= _SPIFFS_ERR_CHECK_FIRST && res > _SPIFFS_ERR_CHECK_LAST) { // index bad also, cannot mend this file - SPIFFS_CHECK_DBG("PA: FIXUP: index bad %i, cannot mend!\n", res); + SPIFFS_CHECK_DBG("PA: FIXUP: index bad %d, cannot mend!\n", res); if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_PAGE, SPIFFS_CHECK_DELETE_BAD_FILE, p_hdr.obj_id, 0); res = spiffs_delete_obj_lazy(fs, p_hdr.obj_id); } else { @@ -763,7 +763,7 @@ static s32_t spiffs_page_consistency_check_i(spiffs *fs) { res = spiffs_rewrite_index(fs, p_hdr.obj_id, p_hdr.span_ix, cur_pix, objix_pix); if (res <= _SPIFFS_ERR_CHECK_FIRST && res > _SPIFFS_ERR_CHECK_LAST) { // index bad also, cannot mend this file - SPIFFS_CHECK_DBG("PA: FIXUP: index bad %i, cannot mend!\n", res); + SPIFFS_CHECK_DBG("PA: FIXUP: index bad %u, cannot mend!\n", res); if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_PAGE, SPIFFS_CHECK_DELETE_BAD_FILE, p_hdr.obj_id, 0); res = spiffs_page_delete(fs, cur_pix); SPIFFS_CHECK_RES(res); diff --git a/cores/esp8266/spiffs/spiffs_config.h b/cores/esp8266/spiffs/spiffs_config.h index 09e791689..eaa219d98 100755 --- a/cores/esp8266/spiffs/spiffs_config.h +++ b/cores/esp8266/spiffs/spiffs_config.h @@ -62,19 +62,19 @@ typedef uint8_t u8_t; // Set generic spiffs debug output call. #ifndef SPIFFS_DGB -#define SPIFFS_DBG(...) os_printf(__VA_ARGS__) +#define SPIFFS_DBG(...) //os_printf(__VA_ARGS__) #endif // Set spiffs debug output call for garbage collecting. #ifndef SPIFFS_GC_DGB -#define SPIFFS_GC_DBG(...) os_printf(__VA_ARGS__) +#define SPIFFS_GC_DBG(...) //os_printf(__VA_ARGS__) #endif // Set spiffs debug output call for caching. #ifndef SPIFFS_CACHE_DGB -#define SPIFFS_CACHE_DBG(...) os_printf(__VA_ARGS__) +#define SPIFFS_CACHE_DBG(...) //os_printf(__VA_ARGS__) #endif // Set spiffs debug output call for system consistency checks. #ifndef SPIFFS_CHECK_DGB -#define SPIFFS_CHECK_DBG(...) os_printf(__VA_ARGS__) +#define SPIFFS_CHECK_DBG(...) //os_printf(__VA_ARGS__) #endif // Enable/disable API functions to determine exact number of bytes diff --git a/cores/esp8266/spiffs/spiffs_gc.c b/cores/esp8266/spiffs/spiffs_gc.c index 4d6c89710..6145084dc 100755 --- a/cores/esp8266/spiffs/spiffs_gc.c +++ b/cores/esp8266/spiffs/spiffs_gc.c @@ -11,7 +11,7 @@ static s32_t spiffs_gc_erase_block( u32_t addr = SPIFFS_BLOCK_TO_PADDR(fs, bix); s32_t size = SPIFFS_CFG_LOG_BLOCK_SZ(fs); - SPIFFS_GC_DBG("gc: erase block %i\n", bix); + SPIFFS_GC_DBG("gc: erase block %d\n", bix); // here we ignore res, just try erasing the block while (size > 0) { @@ -129,10 +129,10 @@ s32_t spiffs_gc_check( return SPIFFS_OK; } - //printf("gcing started %i dirty, blocks %i free, want %i bytes\n", fs->stats_p_allocated + fs->stats_p_deleted, fs->free_blocks, len); + //printf("gcing started %d dirty, blocks %d free, want %d bytes\n", fs->stats_p_allocated + fs->stats_p_deleted, fs->free_blocks, len); do { - SPIFFS_GC_DBG("\ngc_check #%i: run gc free_blocks:%i pfree:%i pallo:%i pdele:%i [%i] len:%i of %i\n", + SPIFFS_GC_DBG("\ngc_check #%d: run gc free_blocks:%d pfree:%d pallo:%d pdele:%d [%d] len:%d of %d\n", tries, fs->free_blocks, free_pages, fs->stats_p_allocated, fs->stats_p_deleted, (free_pages+fs->stats_p_allocated+fs->stats_p_deleted), len, free_pages*SPIFFS_DATA_PAGE_SIZE(fs)); @@ -151,13 +151,13 @@ s32_t spiffs_gc_check( #endif cand = cands[0]; fs->cleaning = 1; - //printf("gcing: cleaning block %i\n", cand); + //printf("gcing: cleaning block %d\n", cand); res = spiffs_gc_clean(fs, cand); fs->cleaning = 0; if (res < 0) { - SPIFFS_GC_DBG("gc_check: cleaning block %i, result %i\n", cand, res); + SPIFFS_GC_DBG("gc_check: cleaning block %d, result %d\n", cand, res); } else { - SPIFFS_GC_DBG("gc_check: cleaning block %i, result %i\n", cand, res); + SPIFFS_GC_DBG("gc_check: cleaning block %d, result %d\n", cand, res); } SPIFFS_CHECK_RES(res); @@ -175,7 +175,7 @@ s32_t spiffs_gc_check( len > free_pages*SPIFFS_DATA_PAGE_SIZE(fs))); SPIFFS_GC_DBG("gc_check: finished\n"); - //printf("gcing finished %i dirty, blocks %i free, %i pages free, %i tries, res %i\n", + //printf("gcing finished %d dirty, blocks %d free, %d pages free, %d tries, res %d\n", // fs->stats_p_allocated + fs->stats_p_deleted, // fs->free_blocks, free_pages, tries, res); @@ -213,7 +213,7 @@ s32_t spiffs_gc_erase_page_stats( } // per entry obj_lookup_page++; } // per object lookup page - SPIFFS_GC_DBG("gc_check: wipe pallo:%i pdele:%i\n", allo, dele); + SPIFFS_GC_DBG("gc_check: wipe pallo:%d pdele:%d\n", allo, dele); fs->stats_p_allocated -= allo; fs->stats_p_deleted -= dele; return res; @@ -249,7 +249,6 @@ s32_t spiffs_gc_find_candidate( while (res == SPIFFS_OK && blocks--) { u16_t deleted_pages_in_block = 0; u16_t used_pages_in_block = 0; - int obj_lookup_page = 0; // check each object lookup page while (res == SPIFFS_OK && obj_lookup_page < (int)SPIFFS_OBJ_LOOKUP_PAGES(fs)) { @@ -298,7 +297,7 @@ s32_t spiffs_gc_find_candidate( used_pages_in_block * SPIFFS_GC_HEUR_W_USED + erase_age * SPIFFS_GC_HEUR_W_ERASE_AGE; int cand_ix = 0; - SPIFFS_GC_DBG("gc_check: bix:%i del:%i use:%i score:%i\n", cur_block, deleted_pages_in_block, used_pages_in_block, score); + SPIFFS_GC_DBG("\ngc_check: bix:%d del:%d use:%d score:%d\n", cur_block, deleted_pages_in_block, used_pages_in_block, score); while (cand_ix < max_candidates) { if (cand_blocks[cand_ix] == (spiffs_block_ix)-1) { cand_blocks[cand_ix] = cur_block; @@ -367,7 +366,7 @@ s32_t spiffs_gc_clean(spiffs *fs, spiffs_block_ix bix) { spiffs_page_object_ix_header *objix_hdr = (spiffs_page_object_ix_header *)fs->work; spiffs_page_object_ix *objix = (spiffs_page_object_ix *)fs->work; - SPIFFS_GC_DBG("gc_clean: cleaning block %i\n", bix); + SPIFFS_GC_DBG("gc_clean: cleaning block %d\n", bix); c_memset(&gc, 0, sizeof(spiffs_gc)); gc.state = FIND_OBJ_DATA; @@ -376,11 +375,11 @@ s32_t spiffs_gc_clean(spiffs *fs, spiffs_block_ix bix) { // move free cursor to next block, cannot use free pages from the block we want to clean fs->free_cursor_block_ix = (bix+1)%fs->block_count; fs->free_cursor_obj_lu_entry = 0; - SPIFFS_GC_DBG("gc_clean: move free cursor to block %i\n", fs->free_cursor_block_ix); + SPIFFS_GC_DBG("gc_clean: move free cursor to block %d\n", fs->free_cursor_block_ix); } while (res == SPIFFS_OK && gc.state != FINISHED) { - SPIFFS_GC_DBG("gc_clean: state = %i entry:%i\n", gc.state, cur_entry); + SPIFFS_GC_DBG("gc_clean: state = %d entry:%d\n", gc.state, cur_entry); gc.obj_id_found = 0; // scan through lookup pages @@ -403,7 +402,7 @@ s32_t spiffs_gc_clean(spiffs *fs, spiffs_block_ix bix) { case FIND_OBJ_DATA: if (obj_id != SPIFFS_OBJ_ID_DELETED && obj_id != SPIFFS_OBJ_ID_FREE && ((obj_id & SPIFFS_OBJ_ID_IX_FLAG) == 0)) { - SPIFFS_GC_DBG("gc_clean: FIND_DATA state:%i - found obj id %04x\n", gc.state, obj_id); + SPIFFS_GC_DBG("gc_clean: FIND_DATA state:%d - found obj id %04x\n", gc.state, obj_id); gc.obj_id_found = 1; gc.cur_obj_id = obj_id; scan = 0; @@ -547,7 +546,7 @@ s32_t spiffs_gc_clean(spiffs *fs, spiffs_block_ix bix) { cur_entry = 0; break; } - SPIFFS_GC_DBG("gc_clean: state-> %i\n", gc.state); + SPIFFS_GC_DBG("gc_clean: state-> %d\n", gc.state); } // while state != FINISHED diff --git a/cores/esp8266/spiffs/spiffs_hydrogen.c b/cores/esp8266/spiffs/spiffs_hydrogen.c index 48a9e91fd..36bdcd274 100755 --- a/cores/esp8266/spiffs/spiffs_hydrogen.c +++ b/cores/esp8266/spiffs/spiffs_hydrogen.c @@ -68,14 +68,14 @@ s32_t SPIFFS_mount(spiffs *fs, spiffs_config *config, u8_t *work, s32_t res = spiffs_obj_lu_scan(fs); SPIFFS_API_CHECK_RES_UNLOCK(fs, res); - SPIFFS_DBG("page index byte len: %i\n", SPIFFS_CFG_LOG_PAGE_SZ(fs)); - SPIFFS_DBG("object lookup pages: %i\n", SPIFFS_OBJ_LOOKUP_PAGES(fs)); - SPIFFS_DBG("page pages per block: %i\n", SPIFFS_PAGES_PER_BLOCK(fs)); - SPIFFS_DBG("page header length: %i\n", sizeof(spiffs_page_header)); - SPIFFS_DBG("object header index entries: %i\n", SPIFFS_OBJ_HDR_IX_LEN(fs)); - SPIFFS_DBG("object index entries: %i\n", SPIFFS_OBJ_IX_LEN(fs)); - SPIFFS_DBG("available file descriptors: %i\n", fs->fd_count); - SPIFFS_DBG("free blocks: %i\n", fs->free_blocks); + SPIFFS_DBG("page index byte len: %d\n", SPIFFS_CFG_LOG_PAGE_SZ(fs)); + SPIFFS_DBG("object lookup pages: %d\n", SPIFFS_OBJ_LOOKUP_PAGES(fs)); + SPIFFS_DBG("page pages per block: %d\n", SPIFFS_PAGES_PER_BLOCK(fs)); + SPIFFS_DBG("page header length: %d\n", sizeof(spiffs_page_header)); + SPIFFS_DBG("object header index entries: %d\n", SPIFFS_OBJ_HDR_IX_LEN(fs)); + SPIFFS_DBG("object index entries: %d\n", SPIFFS_OBJ_IX_LEN(fs)); + SPIFFS_DBG("available file descriptors: %d\n", fs->fd_count); + SPIFFS_DBG("free blocks: %d\n", fs->free_blocks); fs->check_cb_f = check_cb_f; @@ -314,7 +314,7 @@ s32_t SPIFFS_write(spiffs *fs, spiffs_file fh, void *buf, u32_t len) { #endif } - SPIFFS_DBG("SPIFFS_write %i %04x offs:%i len %i\n", fh, fd->obj_id, offset, len); + SPIFFS_DBG("SPIFFS_write %d %04x offs:%d len %d\n", fh, fd->obj_id, offset, len); #if SPIFFS_CACHE_WR if ((fd->flags & SPIFFS_DIRECT) == 0) { @@ -328,7 +328,7 @@ s32_t SPIFFS_write(spiffs *fs, spiffs_file fh, void *buf, u32_t len) { offset + len > fd->cache_page->offset + SPIFFS_CFG_LOG_PAGE_SZ(fs)) // writing beyond cache page { // boundary violation, write back cache first and allocate new - SPIFFS_CACHE_DBG("CACHE_WR_DUMP: dumping cache page %i for fd %i:&04x, boundary viol, offs:%i size:%i\n", + SPIFFS_CACHE_DBG("CACHE_WR_DUMP: dumping cache page %d for fd %d:&04x, boundary viol, offs:%d size:%d\n", fd->cache_page->ix, fd->file_nbr, fd->obj_id, fd->cache_page->offset, fd->cache_page->size); res = spiffs_hydro_write(fs, fd, spiffs_get_cache_page(fs, spiffs_get_cache(fs), fd->cache_page->ix), @@ -345,14 +345,14 @@ s32_t SPIFFS_write(spiffs *fs, spiffs_file fh, void *buf, u32_t len) { if (fd->cache_page) { fd->cache_page->offset = offset; fd->cache_page->size = 0; - SPIFFS_CACHE_DBG("CACHE_WR_ALLO: allocating cache page %i for fd %i:%04x\n", + SPIFFS_CACHE_DBG("CACHE_WR_ALLO: allocating cache page %d for fd %d:%04x\n", fd->cache_page->ix, fd->file_nbr, fd->obj_id); } } if (fd->cache_page) { u32_t offset_in_cpage = offset - fd->cache_page->offset; - SPIFFS_CACHE_DBG("CACHE_WR_WRITE: storing to cache page %i for fd %i:%04x, offs %i:%i len %i\n", + SPIFFS_CACHE_DBG("CACHE_WR_WRITE: storing to cache page %d for fd %d:%04x, offs %d:%d len %d\n", fd->cache_page->ix, fd->file_nbr, fd->obj_id, offset, offset_in_cpage, len); spiffs_cache *cache = spiffs_get_cache(fs); @@ -373,7 +373,7 @@ s32_t SPIFFS_write(spiffs *fs, spiffs_file fh, void *buf, u32_t len) { // big write, no need to cache it - but first check if there is a cached write already if (fd->cache_page) { // write back cache first - SPIFFS_CACHE_DBG("CACHE_WR_DUMP: dumping cache page %i for fd %i:%04x, big write, offs:%i size:%i\n", + SPIFFS_CACHE_DBG("CACHE_WR_DUMP: dumping cache page %d for fd %d:%04x, big write, offs:%d size:%d\n", fd->cache_page->ix, fd->file_nbr, fd->obj_id, fd->cache_page->offset, fd->cache_page->size); res = spiffs_hydro_write(fs, fd, spiffs_get_cache_page(fs, spiffs_get_cache(fs), fd->cache_page->ix), @@ -574,7 +574,7 @@ static s32_t spiffs_fflush_cache(spiffs *fs, spiffs_file fh) { fd->cache_page = spiffs_cache_page_get_by_fd(fs, fd); } if (fd->cache_page) { - SPIFFS_CACHE_DBG("CACHE_WR_DUMP: dumping cache page %i for fd %i:%04x, flush, offs:%i size:%i\n", + SPIFFS_CACHE_DBG("CACHE_WR_DUMP: dumping cache page %d for fd %d:%04x, flush, offs:%d size:%d\n", fd->cache_page->ix, fd->file_nbr, fd->obj_id, fd->cache_page->offset, fd->cache_page->size); res = spiffs_hydro_write(fs, fd, spiffs_get_cache_page(fs, spiffs_get_cache(fs), fd->cache_page->ix), @@ -850,7 +850,7 @@ s32_t SPIFFS_vis(spiffs *fs) { SPIFFS_CHECK_RES(res); if (erase_count != (spiffs_obj_id)-1) { - spiffs_printf("\tera_cnt: %i\n", erase_count); + spiffs_printf("\tera_cnt: %d\n", erase_count); } else { spiffs_printf("\tera_cnt: N/A\n"); } @@ -858,12 +858,12 @@ s32_t SPIFFS_vis(spiffs *fs) { bix++; } // per block - spiffs_printf("era_cnt_max: %i\n", fs->max_erase_count); - spiffs_printf("last_errno: %i\n", fs->errno); - spiffs_printf("blocks: %i\n", fs->block_count); - spiffs_printf("free_blocks: %i\n", fs->free_blocks); - spiffs_printf("page_alloc: %i\n", fs->stats_p_allocated); - spiffs_printf("page_delet: %i\n", fs->stats_p_deleted); + spiffs_printf("era_cnt_max: %d\n", fs->max_erase_count); + spiffs_printf("last_errno: %d\n", fs->errno); + spiffs_printf("blocks: %d\n", fs->block_count); + spiffs_printf("free_blocks: %d\n", fs->free_blocks); + spiffs_printf("page_alloc: %d\n", fs->stats_p_allocated); + spiffs_printf("page_delet: %d\n", fs->stats_p_deleted); SPIFFS_UNLOCK(fs); return res; diff --git a/cores/esp8266/spiffs/spiffs_nucleus.c b/cores/esp8266/spiffs/spiffs_nucleus.c index 74217cd0a..e58a9775e 100755 --- a/cores/esp8266/spiffs/spiffs_nucleus.c +++ b/cores/esp8266/spiffs/spiffs_nucleus.c @@ -622,7 +622,7 @@ s32_t spiffs_object_create( // find free entry res = spiffs_obj_lu_find_free(fs, fs->free_cursor_block_ix, fs->free_cursor_obj_lu_entry, &bix, &entry); SPIFFS_CHECK_RES(res); - SPIFFS_DBG("create: found free page @ %04x bix:%i entry:%i\n", SPIFFS_OBJ_LOOKUP_ENTRY_TO_PIX(fs, bix, entry), bix, entry); + SPIFFS_DBG("create: found free page @ %04x bix:%d entry:%d\n", SPIFFS_OBJ_LOOKUP_ENTRY_TO_PIX(fs, bix, entry), bix, entry); // occupy page in object lookup res = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_LU | SPIFFS_OP_C_UPDT, @@ -727,7 +727,7 @@ void spiffs_cb_object_event( if (cur_fd->file_nbr == 0 || (cur_fd->obj_id & ~SPIFFS_OBJ_ID_IX_FLAG) != obj_id) continue; if (spix == 0) { if (ev == SPIFFS_EV_IX_NEW || ev == SPIFFS_EV_IX_UPD) { - SPIFFS_DBG(" callback: setting fd %i:%04x objix_hdr_pix to %04x, size:%i\n", cur_fd->file_nbr, cur_fd->obj_id, new_pix, new_size); + SPIFFS_DBG(" callback: setting fd %d:%04x objix_hdr_pix to %04x, size:%d\n", cur_fd->file_nbr, cur_fd->obj_id, new_pix, new_size); cur_fd->objix_hdr_pix = new_pix; if (new_size != 0) { cur_fd->size = new_size; @@ -739,7 +739,7 @@ void spiffs_cb_object_event( } if (cur_fd->cursor_objix_spix == spix) { if (ev == SPIFFS_EV_IX_NEW || ev == SPIFFS_EV_IX_UPD) { - SPIFFS_DBG(" callback: setting fd %i:%04x span:%04x objix_pix to %04x\n", cur_fd->file_nbr, cur_fd->obj_id, spix, new_pix); + SPIFFS_DBG(" callback: setting fd %d:%04x span:%04x objix_pix to %04x\n", cur_fd->file_nbr, cur_fd->obj_id, spix, new_pix); cur_fd->cursor_objix_pix = new_pix; } else { cur_fd->cursor_objix_pix = 0; @@ -799,7 +799,7 @@ s32_t spiffs_object_open_by_page( SPIFFS_VALIDATE_OBJIX(oix_hdr.p_hdr, fd->obj_id, 0); - SPIFFS_DBG("open: fd %i is obj id %04x\n", fd->file_nbr, fd->obj_id); + SPIFFS_DBG("open: fd %d is obj id %04x\n", fd->file_nbr, fd->obj_id); return res; } @@ -838,7 +838,7 @@ s32_t spiffs_object_append(spiffs_fd *fd, u32_t offset, u8_t *data, u32_t len) { // within this clause we return directly if something fails, object index mess-up if (written > 0) { // store previous object index page, unless first pass - SPIFFS_DBG("append: %04x store objix %04x:%04x, written %i\n", fd->obj_id, + SPIFFS_DBG("append: %04x store objix %04x:%04x, written %d\n", fd->obj_id, cur_objix_pix, prev_objix_spix, written); if (prev_objix_spix == 0) { // this is an update to object index header page @@ -855,7 +855,7 @@ s32_t spiffs_object_append(spiffs_fd *fd, u32_t offset, u8_t *data, u32_t len) { res = spiffs_object_update_index_hdr(fs, fd, fd->obj_id, fd->objix_hdr_pix, fs->work, 0, offset+written, &new_objix_hdr_page); SPIFFS_CHECK_RES(res); - SPIFFS_DBG("append: %04x store new objix_hdr, %04x:%04x, written %i\n", fd->obj_id, + SPIFFS_DBG("append: %04x store new objix_hdr, %04x:%04x, written %d\n", fd->obj_id, new_objix_hdr_page, 0, written); } } else { @@ -871,7 +871,7 @@ s32_t spiffs_object_append(spiffs_fd *fd, u32_t offset, u8_t *data, u32_t len) { res = spiffs_object_update_index_hdr(fs, fd, fd->obj_id, fd->objix_hdr_pix, 0, 0, offset+written, &new_objix_hdr_page); SPIFFS_CHECK_RES(res); - SPIFFS_DBG("append: %04x store new size I %i in objix_hdr, %04x:%04x, written %i\n", fd->obj_id, + SPIFFS_DBG("append: %04x store new size I %d in objix_hdr, %04x:%04x, written %d\n", fd->obj_id, offset+written, new_objix_hdr_page, 0, written); } fd->size = offset+written; @@ -900,7 +900,7 @@ s32_t spiffs_object_append(spiffs_fd *fd, u32_t offset, u8_t *data, u32_t len) { // quick "load" of new object index page c_memset(fs->work, 0xff, SPIFFS_CFG_LOG_PAGE_SZ(fs)); c_memcpy(fs->work, &p_hdr, sizeof(spiffs_page_header)); - SPIFFS_DBG("append: %04x create objix page, %04x:%04x, written %i\n", fd->obj_id + SPIFFS_DBG("append: %04x create objix page, %04x:%04x, written %d\n", fd->obj_id , cur_objix_pix, cur_objix_spix, written); } else { // on first pass, we load existing object index page @@ -936,7 +936,7 @@ s32_t spiffs_object_append(spiffs_fd *fd, u32_t offset, u8_t *data, u32_t len) { p_hdr.flags = 0xff & ~(SPIFFS_PH_FLAG_FINAL); // finalize immediately res = spiffs_page_allocate_data(fs, fd->obj_id & ~SPIFFS_OBJ_ID_IX_FLAG, &p_hdr, &data[written], to_write, page_offs, 1, &data_page); - SPIFFS_DBG("append: %04x store new data page, %04x:%04x offset:%i, len %i, written %i\n", fd->obj_id, + SPIFFS_DBG("append: %04x store new data page, %04x:%04x offset:%d, len %d, written %d\n", fd->obj_id, data_page, data_spix, page_offs, to_write, written); } else { // append to existing page, fill out free data in existing page @@ -953,7 +953,7 @@ s32_t spiffs_object_append(spiffs_fd *fd, u32_t offset, u8_t *data, u32_t len) { res = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_DA | SPIFFS_OP_C_UPDT, fd->file_nbr, SPIFFS_PAGE_TO_PADDR(fs, data_page) + sizeof(spiffs_page_header) + page_offs, to_write, &data[written]); - SPIFFS_DBG("append: %04x store to existing data page, %04x:%04x offset:%i, len %i, written %i\n", fd->obj_id + SPIFFS_DBG("append: %04x store to existing data page, %04x:%04x offset:%d, len %d, written %d\n", fd->obj_id , data_page, data_spix, page_offs, to_write, written); } @@ -989,7 +989,7 @@ s32_t spiffs_object_append(spiffs_fd *fd, u32_t offset, u8_t *data, u32_t len) { if (cur_objix_spix != 0) { // wrote beyond object index header page // write last modified object index page, unless object header index page - SPIFFS_DBG("append: %04x store objix page, %04x:%04x, written %i\n", fd->obj_id, + SPIFFS_DBG("append: %04x store objix page, %04x:%04x, written %d\n", fd->obj_id, cur_objix_pix, cur_objix_spix, written); res2 = spiffs_page_index_check(fs, fd, cur_objix_pix, cur_objix_spix); @@ -1003,7 +1003,7 @@ s32_t spiffs_object_append(spiffs_fd *fd, u32_t offset, u8_t *data, u32_t len) { // update size in object header index page res2 = spiffs_object_update_index_hdr(fs, fd, fd->obj_id, fd->objix_hdr_pix, 0, 0, offset+written, &new_objix_hdr_page); - SPIFFS_DBG("append: %04x store new size II %i in objix_hdr, %04x:%04x, written %i\n", fd->obj_id + SPIFFS_DBG("append: %04x store new size II %d in objix_hdr, %04x:%04x, written %d\n", fd->obj_id , offset+written, new_objix_hdr_page, 0, written); SPIFFS_CHECK_RES(res2); } else { @@ -1011,7 +1011,7 @@ s32_t spiffs_object_append(spiffs_fd *fd, u32_t offset, u8_t *data, u32_t len) { if (offset == 0) { // wrote to empty object - simply update size and write whole page objix_hdr->size = offset+written; - SPIFFS_DBG("append: %04x store fresh objix_hdr page, %04x:%04x, written %i\n", fd->obj_id + SPIFFS_DBG("append: %04x store fresh objix_hdr page, %04x:%04x, written %d\n", fd->obj_id , cur_objix_pix, cur_objix_spix, written); res2 = spiffs_page_index_check(fs, fd, cur_objix_pix, cur_objix_spix); @@ -1026,7 +1026,7 @@ s32_t spiffs_object_append(spiffs_fd *fd, u32_t offset, u8_t *data, u32_t len) { // modifying object index header page, update size and make new copy res2 = spiffs_object_update_index_hdr(fs, fd, fd->obj_id, fd->objix_hdr_pix, fs->work, 0, offset+written, &new_objix_hdr_page); - SPIFFS_DBG("append: %04x store modified objix_hdr page, %04x:%04x, written %i\n", fd->obj_id + SPIFFS_DBG("append: %04x store modified objix_hdr page, %04x:%04x, written %d\n", fd->obj_id , new_objix_hdr_page, 0, written); SPIFFS_CHECK_RES(res2); } @@ -1074,7 +1074,7 @@ s32_t spiffs_object_modify(spiffs_fd *fd, u32_t offset, u8_t *data, u32_t len) { // store previous object index header page res = spiffs_object_update_index_hdr(fs, fd, fd->obj_id, fd->objix_hdr_pix, fs->work, 0, 0, &new_objix_hdr_pix); - SPIFFS_DBG("modify: store modified objix_hdr page, %04x:%04x, written %i\n", new_objix_hdr_pix, 0, written); + SPIFFS_DBG("modify: store modified objix_hdr page, %04x:%04x, written %d\n", new_objix_hdr_pix, 0, written); SPIFFS_CHECK_RES(res); } else { // store new version of previous object index page @@ -1084,7 +1084,7 @@ s32_t spiffs_object_modify(spiffs_fd *fd, u32_t offset, u8_t *data, u32_t len) { SPIFFS_CHECK_RES(res); res = spiffs_page_move(fs, fd->file_nbr, (u8_t*)objix, fd->obj_id, 0, cur_objix_pix, &new_objix_pix); - SPIFFS_DBG("modify: store previous modified objix page, %04x:%04x, written %i\n", new_objix_pix, objix->p_hdr.span_ix, written); + SPIFFS_DBG("modify: store previous modified objix page, %04x:%04x, written %d\n", new_objix_pix, objix->p_hdr.span_ix, written); SPIFFS_CHECK_RES(res); spiffs_cb_object_event(fs, fd, SPIFFS_EV_IX_UPD, fd->obj_id, objix->p_hdr.span_ix, new_objix_pix, 0); } @@ -1139,7 +1139,7 @@ s32_t spiffs_object_modify(spiffs_fd *fd, u32_t offset, u8_t *data, u32_t len) { // a full page, allocate and write a new page of data res = spiffs_page_allocate_data(fs, fd->obj_id & ~SPIFFS_OBJ_ID_IX_FLAG, &p_hdr, &data[written], to_write, page_offs, 1, &data_pix); - SPIFFS_DBG("modify: store new data page, %04x:%04x offset:%i, len %i, written %i\n", data_pix, data_spix, page_offs, to_write, written); + SPIFFS_DBG("modify: store new data page, %04x:%04x offset:%d, len %d, written %d\n", data_pix, data_spix, page_offs, to_write, written); } else { // write to existing page, allocate new and copy unmodified data @@ -1180,7 +1180,7 @@ s32_t spiffs_object_modify(spiffs_fd *fd, u32_t offset, u8_t *data, u32_t len) { (u8_t *)&p_hdr.flags); if (res != SPIFFS_OK) break; - SPIFFS_DBG("modify: store to existing data page, src:%04x, dst:%04x:%04x offset:%i, len %i, written %i\n", orig_data_pix, data_pix, data_spix, page_offs, to_write, written); + SPIFFS_DBG("modify: store to existing data page, src:%04x, dst:%04x:%04x offset:%d, len %d, written %d\n", orig_data_pix, data_pix, data_spix, page_offs, to_write, written); } // delete original data page @@ -1219,7 +1219,7 @@ s32_t spiffs_object_modify(spiffs_fd *fd, u32_t offset, u8_t *data, u32_t len) { SPIFFS_CHECK_RES(res2); res2 = spiffs_page_move(fs, fd->file_nbr, (u8_t*)objix, fd->obj_id, 0, cur_objix_pix, &new_objix_pix); - SPIFFS_DBG("modify: store modified objix page, %04x:%04x, written %i\n", new_objix_pix, cur_objix_spix, written); + SPIFFS_DBG("modify: store modified objix page, %04x:%04x, written %d\n", new_objix_pix, cur_objix_spix, written); fd->cursor_objix_pix = new_objix_pix; fd->cursor_objix_spix = cur_objix_spix; SPIFFS_CHECK_RES(res2); @@ -1229,7 +1229,7 @@ s32_t spiffs_object_modify(spiffs_fd *fd, u32_t offset, u8_t *data, u32_t len) { // wrote within object index header page res2 = spiffs_object_update_index_hdr(fs, fd, fd->obj_id, fd->objix_hdr_pix, fs->work, 0, 0, &new_objix_hdr_pix); - SPIFFS_DBG("modify: store modified objix_hdr page, %04x:%04x, written %i\n", new_objix_hdr_pix, 0, written); + SPIFFS_DBG("modify: store modified objix_hdr page, %04x:%04x, written %d\n", new_objix_hdr_pix, 0, written); SPIFFS_CHECK_RES(res2); } @@ -1349,7 +1349,7 @@ s32_t spiffs_object_truncate( spiffs_cb_object_event(fs, fd, SPIFFS_EV_IX_DEL, fd->obj_id, objix->p_hdr.span_ix, objix_pix, 0); if (prev_objix_spix > 0) { // update object index header page - SPIFFS_DBG("truncate: update objix hdr page %04x:%04x to size %i\n", fd->objix_hdr_pix, prev_objix_spix, cur_size); + SPIFFS_DBG("truncate: update objix hdr page %04x:%04x to size %d\n", fd->objix_hdr_pix, prev_objix_spix, cur_size); res = spiffs_object_update_index_hdr(fs, fd, fd->obj_id, fd->objix_hdr_pix, 0, 0, cur_size, &new_objix_hdr_pix); SPIFFS_CHECK_RES(res); @@ -1401,13 +1401,13 @@ s32_t spiffs_object_truncate( } fd->size = cur_size; fd->offset = cur_size; - SPIFFS_DBG("truncate: delete data page %04x for data spix:%04x, cur_size:%i\n", data_pix, data_spix, cur_size); + SPIFFS_DBG("truncate: delete data page %04x for data spix:%04x, cur_size:%d\n", data_pix, data_spix, cur_size); } else { // delete last page, partially spiffs_page_header p_hdr; spiffs_page_ix new_data_pix; u32_t bytes_to_remove = SPIFFS_DATA_PAGE_SIZE(fs) - (new_size % SPIFFS_DATA_PAGE_SIZE(fs)); - SPIFFS_DBG("truncate: delete %i bytes from data page %04x for data spix:%04x, cur_size:%i\n", bytes_to_remove, data_pix, data_spix, cur_size); + SPIFFS_DBG("truncate: delete %d bytes from data page %04x for data spix:%04x, cur_size:%d\n", bytes_to_remove, data_pix, data_spix, cur_size); res = spiffs_page_data_check(fs, fd, data_pix, data_spix); if (res != SPIFFS_OK) break; @@ -1562,7 +1562,7 @@ s32_t spiffs_object_read( len_to_read = MIN(len_to_read, SPIFFS_DATA_PAGE_SIZE(fs) - (cur_offset % SPIFFS_DATA_PAGE_SIZE(fs))); // remaining data in file len_to_read = MIN(len_to_read, fd->size); - SPIFFS_DBG("read: offset:%i rd:%i data spix:%04x is data_pix:%04x addr:%08x\n", cur_offset, len_to_read, data_spix, data_pix, + SPIFFS_DBG("read: offset:%d rd:%d data spix:%04x is data_pix:%04x addr:%08x\n", cur_offset, len_to_read, data_spix, data_pix, SPIFFS_PAGE_TO_PADDR(fs, data_pix) + sizeof(spiffs_page_header) + (cur_offset % SPIFFS_DATA_PAGE_SIZE(fs))); if (len_to_read <= 0) { res = SPIFFS_ERR_END_OF_OBJECT; @@ -1648,7 +1648,7 @@ static s32_t spiffs_obj_lu_find_free_obj_id_compact_v(spiffs *fs, spiffs_obj_id if (id >= state->min_obj_id && id <= state->max_obj_id) { u8_t *map = (u8_t *)fs->work; int ix = (id - state->min_obj_id) / state->compaction; - //SPIFFS_DBG("free_obj_id: add ix %i for id %04x min:%04x max%04x comp:%i\n", ix, id, state->min_obj_id, state->max_obj_id, state->compaction); + //SPIFFS_DBG("free_obj_id: add ix %d for id %04x min:%04x max%04x comp:%d\n", ix, id, state->min_obj_id, state->max_obj_id, state->compaction); map[ix]++; } } @@ -1721,7 +1721,7 @@ s32_t spiffs_obj_lu_find_free_obj_id(spiffs *fs, spiffs_obj_id *obj_id, u8_t *co return SPIFFS_ERR_FULL; } - SPIFFS_DBG("free_obj_id: COMP select index:%i min_count:%i min:%04x max:%04x compact:%i\n", min_i, min_count, state.min_obj_id, state.max_obj_id, state.compaction); + SPIFFS_DBG("free_obj_id: COMP select index:%d min_count:%d min:%04x max:%04x compact:%d\n", min_i, min_count, state.min_obj_id, state.max_obj_id, state.compaction); if (min_count == 0) { // no id in this range, skip compacting and use directly @@ -1741,7 +1741,7 @@ s32_t spiffs_obj_lu_find_free_obj_id(spiffs *fs, spiffs_obj_id *obj_id, u8_t *co // in a work memory of log_page_size bytes, we may fit in log_page_size ids // todo what if compaction is > 255 - then we cannot fit it in a byte state.compaction = (state.max_obj_id-state.min_obj_id) / ((SPIFFS_CFG_LOG_PAGE_SZ(fs) / sizeof(u8_t))); - SPIFFS_DBG("free_obj_id: COMP min:%04x max:%04x compact:%i\n", state.min_obj_id, state.max_obj_id, state.compaction); + SPIFFS_DBG("free_obj_id: COMP min:%04x max:%04x compact:%d\n", state.min_obj_id, state.max_obj_id, state.compaction); c_memset(fs->work, 0, SPIFFS_CFG_LOG_PAGE_SZ(fs)); res = spiffs_obj_lu_find_entry_visitor(fs, 0, 0, 0, 0, spiffs_obj_lu_find_free_obj_id_compact_v, 0, &state, 0, 0); From 5d1ee7ace600fc6d56649f4084652f7cb3789e5e Mon Sep 17 00:00:00 2001 From: ficeto Date: Thu, 14 May 2015 00:53:55 +0300 Subject: [PATCH 14/78] disable automount --- cores/esp8266/core_esp8266_wiring.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/cores/esp8266/core_esp8266_wiring.c b/cores/esp8266/core_esp8266_wiring.c index 985db8310..994c8cb5c 100644 --- a/cores/esp8266/core_esp8266_wiring.c +++ b/cores/esp8266/core_esp8266_wiring.c @@ -76,7 +76,7 @@ void delayMicroseconds(unsigned int us) { void init() { initPins(); timer1_isr_init(); - spiffs_mount(); + //spiffs_mount(); os_timer_setfn(µs_overflow_timer, (os_timer_func_t*) µs_overflow_tick, 0); os_timer_arm(µs_overflow_timer, 60000, REPEAT); } From cfac2cacb19af85c3ca21d7981fbabc503dd9347 Mon Sep 17 00:00:00 2001 From: ficeto Date: Thu, 14 May 2015 01:06:55 +0300 Subject: [PATCH 15/78] fix missed edits --- cores/esp8266/spiffs/spiffs_config.h | 4 ++-- cores/esp8266/spiffs/spiffs_flashmem.c | 19 +++---------------- 2 files changed, 5 insertions(+), 18 deletions(-) diff --git a/cores/esp8266/spiffs/spiffs_config.h b/cores/esp8266/spiffs/spiffs_config.h index eaa219d98..3c55cf97f 100755 --- a/cores/esp8266/spiffs/spiffs_config.h +++ b/cores/esp8266/spiffs/spiffs_config.h @@ -25,8 +25,6 @@ #define IRAM_ATTR __attribute__((section(".iram.text"))) #define STORE_TYPEDEF_ATTR __attribute__((aligned(4),packed)) #define STORE_ATTR __attribute__((aligned(4))) -#define debugf(fmt, ...) os_printf(fmt"\r\n", ##__VA_ARGS__) -#define SYSTEM_ERROR(fmt, ...) os_printf("ERROR: " fmt "\r\n", ##__VA_ARGS__) #define SPIFFS_CHACHE 0 @@ -59,6 +57,8 @@ typedef uint8_t u8_t; #endif // compile time switches +#define debugf(fmt, ...) //os_printf(fmt"\r\n", ##__VA_ARGS__) +#define SYSTEM_ERROR(fmt, ...) //os_printf("ERROR: " fmt "\r\n", ##__VA_ARGS__) // Set generic spiffs debug output call. #ifndef SPIFFS_DGB diff --git a/cores/esp8266/spiffs/spiffs_flashmem.c b/cores/esp8266/spiffs/spiffs_flashmem.c index 16c51cbf4..d2ad74cc0 100755 --- a/cores/esp8266/spiffs/spiffs_flashmem.c +++ b/cores/esp8266/spiffs/spiffs_flashmem.c @@ -3,19 +3,10 @@ // Based on NodeMCU platform_flash // https://github.com/nodemcu/nodemcu-firmware -extern char _flash_code_end[]; extern uint32_t _SPIFFS_start; -extern uint32_t _SPIFFS_end; - -#define SPIFFS_PARTITION_SIZE() (uint32_t)(_SPIFFS_end - _SPIFFS_start) -#define CAN_FIT_ON_SPIFFS(a,l) (((a+l)-_SPIFFS_start) <= SPIFFS_PARTITION_SIZE()) uint32_t flashmem_write( const void *from, uint32_t toaddr, uint32_t size ) { - if(!CAN_FIT_ON_SPIFFS(toaddr,size)){ - os_printf("File Out Of Bounds\n"); - return 0; - } uint32_t temp, rest, ssize = size; unsigned i; char tmpdata[ INTERNAL_FLASH_WRITE_UNIT_SIZE ]; @@ -62,10 +53,6 @@ uint32_t flashmem_write( const void *from, uint32_t toaddr, uint32_t size ) uint32_t flashmem_read( void *to, uint32_t fromaddr, uint32_t size ) { - if(!CAN_FIT_ON_SPIFFS(fromaddr,size)){ - os_printf("File Out Of Bounds\n"); - return 0; - } uint32_t temp, rest, ssize = size; unsigned i; char tmpdata[ INTERNAL_FLASH_READ_UNIT_SIZE ]; @@ -224,13 +211,13 @@ uint32_t flashmem_read_internal( void *to, uint32_t fromaddr, uint32_t size ) } uint32_t flashmem_get_first_free_block_address(){ - if (_SPIFFS_start == 0){ - debugf("_SPIFFS_start:%08x\n", _SPIFFS_start); + if ((uint32_t)&_SPIFFS_start == 0){ return 0; } + debugf("_SPIFFS_start:%08x\n", (uint32_t)&_SPIFFS_start); // Round the total used flash size to the closest flash block address uint32_t end; - flashmem_find_sector( _SPIFFS_start - 1, NULL, &end); + flashmem_find_sector( (uint32_t)&_SPIFFS_start - 1, NULL, &end); return end + 1; } From ce73ac216bf87a084f006d694e722d4d6387c113 Mon Sep 17 00:00:00 2001 From: Ivan Grokhotkov Date: Thu, 14 May 2015 02:47:39 +0300 Subject: [PATCH 16/78] fix SDWebServer sample --- .../examples/SDWebServer/SDWebServer.ino | 18 ++++++++---------- 1 file changed, 8 insertions(+), 10 deletions(-) diff --git a/libraries/ESP8266WebServer/examples/SDWebServer/SDWebServer.ino b/libraries/ESP8266WebServer/examples/SDWebServer/SDWebServer.ino index d9e230c77..762e4fe0d 100644 --- a/libraries/ESP8266WebServer/examples/SDWebServer/SDWebServer.ino +++ b/libraries/ESP8266WebServer/examples/SDWebServer/SDWebServer.ino @@ -55,7 +55,6 @@ void returnOK(){ message += "Access-Control-Allow-Origin: *\r\n"; message += "\r\n"; client.print(message); - message = 0; client.stop(); } @@ -69,7 +68,6 @@ void returnFail(String msg){ message += msg; message += "\r\n"; client.print(message); - message = 0; client.stop(); } @@ -108,8 +106,8 @@ bool loadFromSdCard(String path){ head += "\r\nAccess-Control-Allow-Origin: *"; head += "\r\n\r\n"; client.print(head); - dataType = 0; - path = 0; + dataType = String(); + path = String(); uint8_t obuf[WWW_BUF_SIZE]; @@ -172,11 +170,11 @@ void deleteRecursive(String path){ entry.close(); SD.remove((char *)entryPath.c_str()); } - entryPath = 0; + entryPath = String(); yield(); } SD.rmdir((char *)path.c_str()); - path = 0; + path = String(); file.close(); } @@ -186,7 +184,7 @@ void handleDelete(){ if(path == "/" || !SD.exists((char *)path.c_str())) return returnFail("BAD PATH"); deleteRecursive(path); returnOK(); - path = 0; + path = String(); } void handleCreate(){ @@ -203,7 +201,7 @@ void handleCreate(){ SD.mkdir((char *)path.c_str()); } returnOK(); - path = 0; + path = String(); } void printDirectory() { @@ -211,7 +209,7 @@ void printDirectory() { String path = server.arg("dir"); if(path != "/" && !SD.exists((char *)path.c_str())) return returnFail("BAD PATH"); File dir = SD.open((char *)path.c_str()); - path = 0; + path = String(); if(!dir.isDirectory()){ dir.close(); return returnFail("NOT DIR"); @@ -242,7 +240,7 @@ void printDirectory() { output += "]"; client.write(output.c_str(), output.length()); client.stop(); - output = 0; + output = String(); } void handleNotFound(){ From eb37830238220714e97f263e52bb6326379494e7 Mon Sep 17 00:00:00 2001 From: Ivan Grokhotkov Date: Thu, 14 May 2015 02:48:30 +0300 Subject: [PATCH 17/78] move hexdump declaration to debug.h --- cores/esp8266/Arduino.h | 3 +-- cores/esp8266/debug.cpp | 24 +++++++++++++++++++----- cores/esp8266/debug.h | 5 ++++- 3 files changed, 24 insertions(+), 8 deletions(-) diff --git a/cores/esp8266/Arduino.h b/cores/esp8266/Arduino.h index 9cc4ad08b..6b306eb2f 100644 --- a/cores/esp8266/Arduino.h +++ b/cores/esp8266/Arduino.h @@ -212,6 +212,7 @@ void loop(void); #include "HardwareSerial.h" #include "Esp.h" +#include "debug.h" uint16_t makeWord(uint16_t w); uint16_t makeWord(byte h, byte l); @@ -229,8 +230,6 @@ long random(long, long); void randomSeed(unsigned int); long map(long, long, long, long, long); -// Debugging functions -void hexdump(uint8_t *mem, uint32_t len, uint8_t cols = 16); #endif diff --git a/cores/esp8266/debug.cpp b/cores/esp8266/debug.cpp index c42016b04..5e280122e 100644 --- a/cores/esp8266/debug.cpp +++ b/cores/esp8266/debug.cpp @@ -1,11 +1,25 @@ -/* - * debug.c - * - * Created on: 13.05.2015 - * Author: Markus Sattler +/* + debug.cpp - debug helper functions + Copyright (c) 2015 Markus Sattler. All rights reserved. + This file is part of the esp8266 core for Arduino environment. + + 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 "Arduino.h" +#include "debug.h" void ICACHE_RAM_ATTR hexdump(uint8_t *mem, uint32_t len, uint8_t cols) { os_printf("\n[HEXDUMP] Address: 0x%08X len: 0x%X (%d)", mem, len, len); diff --git a/cores/esp8266/debug.h b/cores/esp8266/debug.h index a312bfdfd..cf0830d3e 100644 --- a/cores/esp8266/debug.h +++ b/cores/esp8266/debug.h @@ -3,6 +3,9 @@ #include // #define DEBUGV(...) ets_printf(__VA_ARGS__) -#define DEBUGV(...) +#define DEBUGV(...) + +void hexdump(uint8_t *mem, uint32_t len, uint8_t cols = 16); + #endif//ARD_DEBUG_H From 53e8bd8f4d14ea90f196bf2a6cefc8da736a5cb5 Mon Sep 17 00:00:00 2001 From: ficeto Date: Thu, 14 May 2015 11:29:26 +0300 Subject: [PATCH 18/78] Rework SPIFFS API to be more Arduino like SD Style commands and Stream API --- cores/esp8266/FileSystem.cpp | 332 +++++++++++++++------------- cores/esp8266/FileSystem.h | 120 ++++++---- cores/esp8266/spiffs/spiffs.c | 125 ++++------- cores/esp8266/spiffs/spiffs.h | 8 +- cores/esp8266/spiffs/spiffs_cache.c | 8 +- 5 files changed, 306 insertions(+), 287 deletions(-) diff --git a/cores/esp8266/FileSystem.cpp b/cores/esp8266/FileSystem.cpp index e33dae38b..7e42af06b 100755 --- a/cores/esp8266/FileSystem.cpp +++ b/cores/esp8266/FileSystem.cpp @@ -1,178 +1,208 @@ -/**** - * Sming Framework Project - Open Source framework for high efficiency native ESP8266 development. - * Created 2015 by Skurydin Alexey - * http://github.com/anakod/Sming - * All files of the Sming Core are provided under the LGPL v3 license. - ****/ +/* + FileSystem.cpp - SPIFS implementation for esp8266 + Copyright (c) 2015 Hristo Gochkov. All rights reserved. + This file is part of the esp8266 core for Arduino environment. + + 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 "FileSystem.h" -#include "WString.h" +#include "Arduino.h" -file_t fileOpen(const String name, FileOpenFlags flags) -{ - int repeats = 0; - bool notExist; - bool canRecreate = (flags & eFO_CreateIfNotExist) == eFO_CreateIfNotExist; - int res; - - do - { - notExist = false; - res = SPIFFS_open(&_filesystemStorageHandle, name.c_str(), (spiffs_flags)flags, 0); - int code = SPIFFS_errno(&_filesystemStorageHandle); - if (res < 0) - { - debugf("open errno %d\n", code); - notExist = (code == SPIFFS_ERR_NOT_FOUND || code == SPIFFS_ERR_DELETED || code == SPIFFS_ERR_FILE_DELETED || code == SPIFFS_ERR_IS_FREE); - //debugf("recreate? %d %d %d", notExist, canRecreate, (repeats < 3)); - if (notExist && canRecreate) - fileDelete(name); // fix for deleted files - } - } while (notExist && canRecreate && repeats++ < 3); - - return res; +boolean FSClass::mount(){ + if(_mounted) return true; + _mounted = spiffs_mount(); + return _mounted; } -void fileClose(file_t file) -{ - SPIFFS_close(&_filesystemStorageHandle, file); +void FSClass::unmount(){ + if(!_mounted) return; + spiffs_unmount(); + _mounted = false; } -size_t fileWrite(file_t file, const void* data, size_t size) -{ - int res = SPIFFS_write(&_filesystemStorageHandle, file, (void *)data, size); - if (res < 0) - { - debugf("write errno %d\n", SPIFFS_errno(&_filesystemStorageHandle)); - return res; - } - return res; +boolean FSClass::format(){ + return spiffs_format(); } -size_t fileRead(file_t file, void* data, size_t size) -{ - int res = SPIFFS_read(&_filesystemStorageHandle, file, data, size); - if (res < 0) - { - debugf("read errno %d\n", SPIFFS_errno(&_filesystemStorageHandle)); - return res; - } - return res; -} - -int fileSeek(file_t file, int offset, SeekOriginFlags origin) -{ - return SPIFFS_lseek(&_filesystemStorageHandle, file, offset, origin); -} - -bool fileIsEOF(file_t file) -{ - return SPIFFS_eof(&_filesystemStorageHandle, file); -} - -int32_t fileTell(file_t file) -{ - return SPIFFS_tell(&_filesystemStorageHandle, file); -} - -int fileFlush(file_t file) -{ - return SPIFFS_fflush(&_filesystemStorageHandle, file); -} - -int fileStats(const String name, spiffs_stat *stat) -{ - return SPIFFS_stat(&_filesystemStorageHandle, name.c_str(), stat); -} - -int fileStats(file_t file, spiffs_stat *stat) -{ - return SPIFFS_fstat(&_filesystemStorageHandle, file, stat); -} - -void fileDelete(const String name) -{ - SPIFFS_remove(&_filesystemStorageHandle, name.c_str()); -} - -void fileDelete(file_t file) -{ - SPIFFS_fremove(&_filesystemStorageHandle, file); -} - -bool fileExist(const String name) -{ +boolean FSClass::exists(const char *filename){ spiffs_stat stat = {0}; - if (fileStats(name.c_str(), &stat) < 0) return false; + if (SPIFFS_stat(&_filesystemStorageHandle, filename, &stat) < 0) return false; return stat.name[0] != '\0'; } +boolean FSClass::create(const char *filepath){ + return SPIFFS_creat(&_filesystemStorageHandle, filepath, 0) == 0; +} -int fileLastError(file_t fd) -{ +boolean FSClass::remove(const char *filepath){ + return SPIFFS_remove(&_filesystemStorageHandle, filepath) == 0; +} + +boolean FSClass::rename(const char *filename, const char *newname){ + return SPIFFS_rename(&_filesystemStorageHandle, filename, newname) == 0; +} + +FSFile FSClass::open(const char *filename, uint8_t mode){ + int repeats = 0; + bool notExist; + bool canRecreate = (mode & SPIFFS_CREAT) == SPIFFS_CREAT; + int res; + + do{ + notExist = false; + res = SPIFFS_open(&_filesystemStorageHandle, filename, (spiffs_flags)mode, 0); + int code = SPIFFS_errno(&_filesystemStorageHandle); + if (res < 0){ + debugf("open errno %d\n", code); + notExist = (code == SPIFFS_ERR_NOT_FOUND || code == SPIFFS_ERR_DELETED || code == SPIFFS_ERR_FILE_DELETED || code == SPIFFS_ERR_IS_FREE); + if (notExist && canRecreate) + remove(filename); // fix for deleted files + } + } while (notExist && canRecreate && repeats++ < 3); + + if(res){ + return FSFile(res); + } + return FSFile(); +} + +FSClass FS; + +FSFile::FSFile(){ + _file = 0; + _stats = {0}; +} + +FSFile::FSFile(file_t f){ + _file = f; + if(SPIFFS_fstat(&_filesystemStorageHandle, _file, &_stats) != 0){ + debugf("mount errno %d\n", SPIFFS_errno(&_filesystemStorageHandle)); + } +} + +void FSFile::close(){ + if (! _file) return; + SPIFFS_close(&_filesystemStorageHandle, _file); + _file = 0; +} + +uint32_t FSFile::size(){ + if(! _file) return 0; + uint32_t pos = SPIFFS_tell(&_filesystemStorageHandle, _file); + SPIFFS_lseek(&_filesystemStorageHandle, _file, 0, SPIFFS_SEEK_END); + uint32_t size = SPIFFS_tell(&_filesystemStorageHandle, _file); + SPIFFS_lseek(&_filesystemStorageHandle, _file, pos, SPIFFS_SEEK_SET); + return size; +} + +uint32_t FSFile::seek(uint32_t pos){ + if (! _file) return 0; + return SPIFFS_lseek(&_filesystemStorageHandle, _file, pos, SPIFFS_SEEK_SET); +} + +uint32_t FSFile::position(){ + if (! _file) return 0; + return SPIFFS_tell(&_filesystemStorageHandle, _file); +} + +boolean FSFile::eof(){ + if (! _file) return 0; + return SPIFFS_eof(&_filesystemStorageHandle, _file); +} + +boolean FSFile::isDirectory(void){ + return false; +} + +int FSFile::read(void *buf, uint16_t nbyte){ + if (! _file) return -1; + return SPIFFS_read(&_filesystemStorageHandle, _file, buf, nbyte); +} + +int FSFile::read(){ + if (! _file) return -1; + int val; + if(SPIFFS_read(&_filesystemStorageHandle, _file, &val, 1) != 1) return -1; + return val; +} + +int FSFile::peek() { + if (! _file) return 0; + int c = read(); + SPIFFS_lseek(&_filesystemStorageHandle, _file, -1, SPIFFS_SEEK_CUR); + return c; +} + +int FSFile::available() { + if (! _file) return 0; + uint32_t pos = SPIFFS_tell(&_filesystemStorageHandle, _file); + SPIFFS_lseek(&_filesystemStorageHandle, _file, 0, SPIFFS_SEEK_END); + uint32_t size = SPIFFS_tell(&_filesystemStorageHandle, _file); + SPIFFS_lseek(&_filesystemStorageHandle, _file, pos, SPIFFS_SEEK_SET); + return size - pos; +} + +size_t FSFile::write(const uint8_t *buf, size_t size){ + if (! _file) return 0; + return SPIFFS_write(&_filesystemStorageHandle, _file, (uint8_t *)buf, size); +} + +size_t FSFile::write(uint8_t val) { + if (! _file) return 0; + return write(&val, 1); +} + +void FSFile::flush(){ + if (! _file) return; + SPIFFS_fflush(&_filesystemStorageHandle, _file); +} + +uint32_t FSFile::remove(){ + if (! _file) return 0; + return SPIFFS_fremove(&_filesystemStorageHandle, _file); + _file = 0; +} + +int FSFile::lastError(){ return SPIFFS_errno(&_filesystemStorageHandle); } -void fileClearLastError(file_t fd) -{ +void FSFile::clearError(){ _filesystemStorageHandle.errno = SPIFFS_OK; } -void fileSetContent(const String fileName, const char *content) -{ - file_t file = fileOpen(fileName.c_str(), eFO_CreateNewAlways | eFO_WriteOnly); - fileWrite(file, content, os_strlen(content)); - fileClose(file); +char * FSFile::name(){ + return 0; } -uint32_t fileGetSize(const String fileName) -{ - file_t file = fileOpen(fileName.c_str(), eFO_ReadOnly); - // Get size - fileSeek(file, 0, eSO_FileEnd); - int size = fileTell(file); - fileClose(file); - return size; + + + + + +/* +spiffs_DIR *dirOpen(spiffs_DIR *d){ + return SPIFFS_opendir(&_filesystemStorageHandle, 0, d); } -String fileGetContent(const String fileName) -{ - file_t file = fileOpen(fileName.c_str(), eFO_ReadOnly); - // Get size - fileSeek(file, 0, eSO_FileEnd); - int size = fileTell(file); - if (size <= 0) - { - fileClose(file); - return ""; - } - fileSeek(file, 0, eSO_FileStart); - char* buffer = new char[size + 1]; - buffer[size] = 0; - fileRead(file, buffer, size); - fileClose(file); - String res = buffer; - delete[] buffer; - return res; +int dirClose(spiffs_DIR *d){ + return SPIFFS_closedir(d); } -int fileGetContent(const String fileName, char* buffer, int bufSize) -{ - if (buffer == NULL || bufSize == 0) return 0; - *buffer = 0; - - file_t file = fileOpen(fileName.c_str(), eFO_ReadOnly); - // Get size - fileSeek(file, 0, eSO_FileEnd); - int size = fileTell(file); - if (size <= 0 || bufSize <= size) - { - fileClose(file); - return 0; - } - buffer[size] = 0; - fileSeek(file, 0, eSO_FileStart); - fileRead(file, buffer, size); - fileClose(file); - return size; +file_t dirOpenFile(spiffs_dirent* entry, uint8_t flags){ + return SPIFFS_open_by_dirent(&_filesystemStorageHandle, entry, (spiffs_flags)flags, 0); } +*/ diff --git a/cores/esp8266/FileSystem.h b/cores/esp8266/FileSystem.h index c9ddb81cf..f83a83d1a 100755 --- a/cores/esp8266/FileSystem.h +++ b/cores/esp8266/FileSystem.h @@ -1,59 +1,83 @@ -/**** - * Sming Framework Project - Open Source framework for high efficiency native ESP8266 development. - * Created 2015 by Skurydin Alexey - * http://github.com/anakod/Sming - * All files of the Sming Core are provided under the LGPL v3 license. - ****/ +/* + FileSystem.h - SPIFS implementation for esp8266 -#ifndef _SMING_CORE_FILESYSTEM_H_ -#define _SMING_CORE_FILESYSTEM_H_ + Copyright (c) 2015 Hristo Gochkov. All rights reserved. + This file is part of the esp8266 core for Arduino environment. + + 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 +*/ +#ifndef _SPIFFS_CORE_FILESYSTEM_H_ +#define _SPIFFS_CORE_FILESYSTEM_H_ #include "spiffs/spiffs.h" +#include "Arduino.h" class String; -enum FileOpenFlags -{ - eFO_ReadOnly = SPIFFS_RDONLY, - eFO_WriteOnly = SPIFFS_WRONLY, - eFO_ReadWrite = eFO_ReadOnly | eFO_WriteOnly, - eFO_CreateIfNotExist = SPIFFS_CREAT, - eFO_Append = SPIFFS_APPEND, - eFO_Truncate = SPIFFS_TRUNC, - eFO_CreateNewAlways = eFO_CreateIfNotExist | eFO_Truncate +#define FSFILE_READ SPIFFS_RDONLY +#define FSFILE_WRITE (SPIFFS_RDONLY | SPIFFS_WRONLY | SPIFFS_CREAT | SPIFFS_APPEND | SPIFFS_TRUNC) + +class FSFile : public Stream { + private: + spiffs_stat _stats; + file_t _file; + +public: + FSFile(file_t f); + FSFile(void); + virtual size_t write(uint8_t); + virtual size_t write(const uint8_t *buf, size_t size); + virtual int read(); + virtual int peek(); + virtual int available(); + virtual void flush(); + int read(void *buf, uint16_t nbyte); + uint32_t seek(uint32_t pos); + uint32_t remove(); + uint32_t position(); + uint32_t size(); + boolean eof(); + void close(); + int lastError(); + void clearError(); + operator bool(){ return _file > 0; } + char * name(); + boolean isDirectory(void); + + using Print::write; }; -static FileOpenFlags operator|(FileOpenFlags lhs, FileOpenFlags rhs) -{ - return (FileOpenFlags) ((int)lhs| (int)rhs); -} +class FSClass { -typedef enum -{ - eSO_FileStart = SPIFFS_SEEK_SET, - eSO_CurrentPos = SPIFFS_SEEK_CUR, - eSO_FileEnd = SPIFFS_SEEK_END -} SeekOriginFlags; +private: + boolean _mounted; + +public: + boolean mount(); + void unmount(); + boolean format(); + boolean exists(const char *filename); + boolean create(const char *filepath); + boolean remove(const char *filepath); + boolean rename(const char *filename, const char *newname); + + FSFile open(const char *filename, uint8_t mode = FSFILE_READ); -file_t fileOpen(const String name, FileOpenFlags flags); -void fileClose(file_t file); -size_t fileWrite(file_t file, const void* data, size_t size); -size_t fileRead(file_t file, void* data, size_t size); -int fileSeek(file_t file, int offset, SeekOriginFlags origin); -bool fileIsEOF(file_t file); -int32_t fileTell(file_t file); -int fileFlush(file_t file); -int fileLastError(file_t fd); -void fileClearLastError(file_t fd); -void fileSetContent(const String fileName, const char *content); -uint32_t fileGetSize(const String fileName); -String fileGetContent(const String fileName); -int fileGetContent(const String fileName, char* buffer, int bufSize); +private: + friend class FSFile; +}; +extern FSClass FS; -int fileStats(const String name, spiffs_stat *stat); -int fileStats(file_t file, spiffs_stat *stat); -void fileDelete(const String name); -void fileDelete(file_t file); -bool fileExist(const String name); - -#endif /* _SMING_CORE_FILESYSTEM_H_ */ +#endif diff --git a/cores/esp8266/spiffs/spiffs.c b/cores/esp8266/spiffs/spiffs.c index d739795ed..4cb5b4f1b 100755 --- a/cores/esp8266/spiffs/spiffs.c +++ b/cores/esp8266/spiffs/spiffs.c @@ -8,21 +8,17 @@ static u8_t spiffs_work_buf[LOG_PAGE_SIZE*2]; static u8_t spiffs_fds[32*4]; static u8_t spiffs_cache[(LOG_PAGE_SIZE+32)*4]; -static s32_t api_spiffs_read(u32_t addr, u32_t size, u8_t *dst) -{ +static s32_t api_spiffs_read(u32_t addr, u32_t size, u8_t *dst){ flashmem_read(dst, addr, size); return SPIFFS_OK; } -static s32_t api_spiffs_write(u32_t addr, u32_t size, u8_t *src) -{ - //debugf("api_spiffs_write"); +static s32_t api_spiffs_write(u32_t addr, u32_t size, u8_t *src){ flashmem_write(src, addr, size); return SPIFFS_OK; } -static s32_t api_spiffs_erase(u32_t addr, u32_t size) -{ +static s32_t api_spiffs_erase(u32_t addr, u32_t size){ debugf("api_spiffs_erase"); u32_t sect_first = flashmem_get_sector_of_address(addr); u32_t sect_last = sect_first; @@ -45,48 +41,40 @@ extern uint32_t _SPIFFS_end; spiffs_config spiffs_get_storage_config() { spiffs_config cfg = {0}; + if ((u32_t)&_SPIFFS_start == 0) return cfg; cfg.phys_addr = (u32_t)&_SPIFFS_start; - if (cfg.phys_addr == 0) - return cfg; cfg.phys_addr += 0x3000; cfg.phys_addr &= 0xFFFFC000; // align to 4 sector. cfg.phys_size = (u32_t)((u32_t)&_SPIFFS_end - (u32_t)&_SPIFFS_start); - /*cfg.phys_addr = INTERNAL_FLASH_SIZE - SPIFFS_WORK_SIZE + INTERNAL_FLASH_START_ADDRESS; - cfg.phys_addr += 0x3000; - cfg.phys_addr &= 0xFFFFC000; // align to 4 sector. - cfg.phys_size = SPIFFS_WORK_SIZE;*/ cfg.phys_erase_block = INTERNAL_FLASH_SECTOR_SIZE; // according to datasheet cfg.log_block_size = INTERNAL_FLASH_SECTOR_SIZE * 2; // Important to make large cfg.log_page_size = LOG_PAGE_SIZE; // as we said return cfg; } -bool spiffs_format_internal() -{ +bool spiffs_format_internal(){ spiffs_config cfg = spiffs_get_storage_config(); - if (cfg.phys_addr == 0) - { - SYSTEM_ERROR("Can't format file system, wrong address"); - return false; + if (cfg.phys_addr == 0){ + SYSTEM_ERROR("Can't format file system, wrong address"); + return false; } u32_t sect_first, sect_last; - sect_first = cfg.phys_addr; - sect_first = flashmem_get_sector_of_address((u32_t)&_SPIFFS_start); + sect_first = flashmem_get_first_free_block_address(); sect_last = flashmem_get_sector_of_address((u32_t)&_SPIFFS_end); debugf("sect_first: %x, sect_last: %x\n", sect_first, sect_last); - while( sect_first <= sect_last ) - if(!flashmem_erase_sector( sect_first ++ )) - return false; + while( sect_first <= sect_last ){ + if(!flashmem_erase_sector( sect_first ++ )) + return false; + } + return true; } -void spiffs_mount() -{ +bool spiffs_mount(){ spiffs_config cfg = spiffs_get_storage_config(); - if (cfg.phys_addr == 0) - { - SYSTEM_ERROR("Can't start file system, wrong address"); - return; + if (cfg.phys_addr == 0){ + SYSTEM_ERROR("Can't start file system, wrong address"); + return false; } debugf("fs.start:%x, size:%d Kb\n", cfg.phys_addr, cfg.phys_size / 1024); @@ -94,17 +82,18 @@ void spiffs_mount() cfg.hal_read_f = api_spiffs_read; cfg.hal_write_f = api_spiffs_write; cfg.hal_erase_f = api_spiffs_erase; - + uint32_t dat; bool writeFirst = false; flashmem_read(&dat, cfg.phys_addr, 4); - //debugf("%X", dat); - if (dat == UINT32_MAX) - { - debugf("First init file system"); - spiffs_format_internal(); - writeFirst = true; + if (dat == UINT32_MAX){ + debugf("First init file system"); + if(!spiffs_format_internal()){ + SYSTEM_ERROR("Can't format file system"); + return false; + } + writeFirst = true; } int res = SPIFFS_mount(&_filesystemStorageHandle, @@ -116,66 +105,44 @@ void spiffs_mount() sizeof(spiffs_cache), NULL); debugf("mount res: %d\n", res); - - if (writeFirst) - { - file_t fd = SPIFFS_open(&_filesystemStorageHandle, "initialize_fs_header.dat", SPIFFS_CREAT | SPIFFS_TRUNC | SPIFFS_RDWR, 0); - SPIFFS_write(&_filesystemStorageHandle, fd, (u8_t *)"1", 1); - SPIFFS_fremove(&_filesystemStorageHandle, fd); - SPIFFS_close(&_filesystemStorageHandle, fd); + + if(res != 0) return false; + + if (writeFirst){ + file_t fd = SPIFFS_open(&_filesystemStorageHandle, "initialize_fs_header.dat", SPIFFS_CREAT | SPIFFS_TRUNC | SPIFFS_RDWR, 0); + SPIFFS_write(&_filesystemStorageHandle, fd, (u8_t *)"1", 1); + SPIFFS_fremove(&_filesystemStorageHandle, fd); + SPIFFS_close(&_filesystemStorageHandle, fd); } - - //dat=0; - //flashmem_read(&dat, cfg.phys_addr, 4); - //debugf("%X", dat); + return true; } -void spiffs_unmount() -{ +void spiffs_unmount(){ SPIFFS_unmount(&_filesystemStorageHandle); } -// FS formatting function -bool spiffs_format() -{ +bool spiffs_format(){ spiffs_unmount(); - spiffs_format_internal(); + if(!spiffs_format_internal()) return false; spiffs_mount(); return true; } -//int spiffs_check( void ) -//{ - // ets_wdt_disable(); - // int res = (int)SPIFFS_check(&_filesystemStorageHandle); - // ets_wdt_enable(); - // return res; -//} - -void test_spiffs() -{ +void test_spiffs(){ char buf[12] = {0}; - - // Surely, I've mounted spiffs before entering here - spiffs_file fd; spiffs_stat st = {0}; SPIFFS_stat(&_filesystemStorageHandle, "my_file.txt", &st); - if (st.size <= 0) - { - fd = SPIFFS_open(&_filesystemStorageHandle, "my_file.txt", SPIFFS_CREAT | SPIFFS_TRUNC | SPIFFS_RDWR, 0); - if (SPIFFS_write(&_filesystemStorageHandle, fd, (u8_t *)"Hello world", 11) < 0) - debugf("errno %d\n", SPIFFS_errno(&_filesystemStorageHandle)); - SPIFFS_close(&_filesystemStorageHandle, fd); - debugf("file created"); - } - else - debugf("file %s exist :)", st.name); - + if (st.size <= 0){ + fd = SPIFFS_open(&_filesystemStorageHandle, "my_file.txt", SPIFFS_CREAT | SPIFFS_TRUNC | SPIFFS_RDWR, 0); + if (SPIFFS_write(&_filesystemStorageHandle, fd, (u8_t *)"Hello world", 11) < 0) + debugf("errno %d\n", SPIFFS_errno(&_filesystemStorageHandle)); + SPIFFS_close(&_filesystemStorageHandle, fd); + debugf("file created"); + } else debugf("file %s exist :)", st.name); fd = SPIFFS_open(&_filesystemStorageHandle, "my_file.txt", SPIFFS_RDWR, 0); if (SPIFFS_read(&_filesystemStorageHandle, fd, (u8_t *)buf, 11) < 0) debugf("errno %d\n", SPIFFS_errno(&_filesystemStorageHandle)); SPIFFS_close(&_filesystemStorageHandle, fd); - debugf("--> %s <--\n", buf); } diff --git a/cores/esp8266/spiffs/spiffs.h b/cores/esp8266/spiffs/spiffs.h index 85f7de7f1..ad922b4a8 100755 --- a/cores/esp8266/spiffs/spiffs.h +++ b/cores/esp8266/spiffs/spiffs.h @@ -83,12 +83,10 @@ typedef enum { } spiffs_check_report; /* file system check callback function */ -typedef void (*spiffs_check_callback)(spiffs_check_type type, spiffs_check_report report, - u32_t arg1, u32_t arg2); +typedef void (*spiffs_check_callback)(spiffs_check_type type, spiffs_check_report report, u32_t arg1, u32_t arg2); #ifndef SPIFFS_DBG -#define SPIFFS_DBG(...) \ - print(__VA_ARGS__) +#define SPIFFS_DBG(...) printf(__VA_ARGS__) #endif #ifndef SPIFFS_GC_DBG #define SPIFFS_GC_DBG(...) printf(__VA_ARGS__) @@ -456,7 +454,7 @@ u32_t SPIFFS_buffer_bytes_for_cache(spiffs *fs, u32_t num_pages); #endif -void spiffs_mount(); +bool spiffs_mount(); void spiffs_unmount(); bool spiffs_format(); spiffs_config spiffs_get_storage_config(); diff --git a/cores/esp8266/spiffs/spiffs_cache.c b/cores/esp8266/spiffs/spiffs_cache.c index a4fec5c2e..5bfe51e86 100755 --- a/cores/esp8266/spiffs/spiffs_cache.c +++ b/cores/esp8266/spiffs/spiffs_cache.c @@ -20,7 +20,7 @@ static spiffs_cache_page *spiffs_cache_page_get(spiffs *fs, spiffs_page_ix pix) if ((cache->cpage_use_map & (1<flags & SPIFFS_CACHE_FLAG_TYPE_WR) == 0 && cp->pix == pix ) { - SPIFFS_CACHE_DBG("CACHE_GET: have cache page %u for %04x\n", i, pix); + SPIFFS_CACHE_DBG("CACHE_GET: have cache page %d for %04x\n", i, pix); cp->last_access = cache->last_access; return cp; } @@ -46,9 +46,9 @@ static s32_t spiffs_cache_page_free(spiffs *fs, int ix, u8_t write_back) { cache->cpage_use_map &= ~(1 << ix); if (cp->flags & SPIFFS_CACHE_FLAG_TYPE_WR) { - SPIFFS_CACHE_DBG("CACHE_FREE: free cache page %u objid %04x\n", ix, cp->obj_id); + SPIFFS_CACHE_DBG("CACHE_FREE: free cache page %d objid %04x\n", ix, cp->obj_id); } else { - SPIFFS_CACHE_DBG("CACHE_FREE: free cache page %u pix %04x\n", ix, cp->pix); + SPIFFS_CACHE_DBG("CACHE_FREE: free cache page %d pix %04x\n", ix, cp->pix); } } @@ -98,7 +98,7 @@ static spiffs_cache_page *spiffs_cache_page_allocate(spiffs *fs) { spiffs_cache_page *cp = spiffs_get_cache_page_hdr(fs, cache, i); cache->cpage_use_map |= (1<last_access = cache->last_access; - SPIFFS_CACHE_DBG("CACHE_ALLO: allocated cache page %u\n", i); + SPIFFS_CACHE_DBG("CACHE_ALLO: allocated cache page %d\n", i); return cp; } } From 5181f907254e88622ab324ec26119b4db25de2ef Mon Sep 17 00:00:00 2001 From: ficeto Date: Thu, 14 May 2015 12:14:39 +0300 Subject: [PATCH 19/78] alignment not needed. we use fixed addresses --- cores/esp8266/spiffs/spiffs.c | 2 -- 1 file changed, 2 deletions(-) diff --git a/cores/esp8266/spiffs/spiffs.c b/cores/esp8266/spiffs/spiffs.c index 4cb5b4f1b..c07be839a 100755 --- a/cores/esp8266/spiffs/spiffs.c +++ b/cores/esp8266/spiffs/spiffs.c @@ -43,8 +43,6 @@ spiffs_config spiffs_get_storage_config() spiffs_config cfg = {0}; if ((u32_t)&_SPIFFS_start == 0) return cfg; cfg.phys_addr = (u32_t)&_SPIFFS_start; - cfg.phys_addr += 0x3000; - cfg.phys_addr &= 0xFFFFC000; // align to 4 sector. cfg.phys_size = (u32_t)((u32_t)&_SPIFFS_end - (u32_t)&_SPIFFS_start); cfg.phys_erase_block = INTERNAL_FLASH_SECTOR_SIZE; // according to datasheet cfg.log_block_size = INTERNAL_FLASH_SECTOR_SIZE * 2; // Important to make large From 2e9a038f684740004b68a6a6b7e4e8ab3799a664 Mon Sep 17 00:00:00 2001 From: ficeto Date: Thu, 14 May 2015 12:41:24 +0300 Subject: [PATCH 20/78] add template methods for stream to stream writes to SD and FS --- cores/esp8266/FileSystem.h | 22 ++++++++++++++++++++++ libraries/SD/src/SD.h | 22 ++++++++++++++++++++++ 2 files changed, 44 insertions(+) diff --git a/cores/esp8266/FileSystem.h b/cores/esp8266/FileSystem.h index f83a83d1a..8704f260c 100755 --- a/cores/esp8266/FileSystem.h +++ b/cores/esp8266/FileSystem.h @@ -54,6 +54,28 @@ public: operator bool(){ return _file > 0; } char * name(); boolean isDirectory(void); + + template size_t write(T &src){ + uint8_t obuf[64]; + size_t doneLen = 0; + size_t sentLen; + int i; + + while (src.available() > 64){ + src.read(obuf, 64); + sentLen = write(obuf, 64); + doneLen = doneLen + sentLen; + if(sentLen != 64){ + return doneLen; + } + } + + size_t leftLen = src.available(); + src.read(obuf, leftLen); + sentLen = write(obuf, leftLen); + doneLen = doneLen + sentLen; + return doneLen; + } using Print::write; }; diff --git a/libraries/SD/src/SD.h b/libraries/SD/src/SD.h index 449984219..93c79138b 100644 --- a/libraries/SD/src/SD.h +++ b/libraries/SD/src/SD.h @@ -48,6 +48,28 @@ public: boolean isDirectory(void); File openNextFile(uint8_t mode = O_RDONLY); void rewindDirectory(void); + + template size_t write(T &src){ + uint8_t obuf[512]; + size_t doneLen = 0; + size_t sentLen; + int i; + + while (src.available() > 512){ + src.read(obuf, 512); + sentLen = write(obuf, 512); + doneLen = doneLen + sentLen; + if(sentLen != 512){ + return doneLen; + } + } + + size_t leftLen = src.available(); + src.read(obuf, leftLen); + sentLen = write(obuf, leftLen); + doneLen = doneLen + sentLen; + return doneLen; + } using Print::write; }; From 36d0968ada0413dd74fc082d6aebd12e7a059ab7 Mon Sep 17 00:00:00 2001 From: Ivan Grokhotkov Date: Thu, 14 May 2015 13:33:12 +0300 Subject: [PATCH 21/78] Web server refactoring --- .../examples/SDWebServer/SDWebServer.ino | 160 +++---- .../ESP8266WebServer/src/ESP8266WebServer.cpp | 450 ++---------------- .../ESP8266WebServer/src/ESP8266WebServer.h | 19 +- libraries/ESP8266WebServer/src/Parsing.cpp | 428 +++++++++++++++++ libraries/ESP8266WiFi/src/WiFiClient.h | 24 + 5 files changed, 574 insertions(+), 507 deletions(-) create mode 100644 libraries/ESP8266WebServer/src/Parsing.cpp diff --git a/libraries/ESP8266WebServer/examples/SDWebServer/SDWebServer.ino b/libraries/ESP8266WebServer/examples/SDWebServer/SDWebServer.ino index 762e4fe0d..bd8ace28a 100644 --- a/libraries/ESP8266WebServer/examples/SDWebServer/SDWebServer.ino +++ b/libraries/ESP8266WebServer/examples/SDWebServer/SDWebServer.ino @@ -34,7 +34,6 @@ #include #include -#define WWW_BUF_SIZE 1460 #define DBG_OUTPUT_PORT Serial const char* ssid = "**********"; @@ -47,28 +46,17 @@ ESP8266WebServer server(80); static bool hasSD = false; File uploadFile; -void returnOK(){ - WiFiClient client = server.client(); - String message = "HTTP/1.1 200 OK\r\n"; - message += "Content-Type: text/plain\r\n"; - message += "Connection: close\r\n"; - message += "Access-Control-Allow-Origin: *\r\n"; - message += "\r\n"; - client.print(message); - client.stop(); + +void returnOK() { + server.sendHeader("Connection", "close"); + server.sendHeader("Access-Control-Allow-Origin", "*"); + server.send(200, "text/plain", ""); } -void returnFail(String msg){ - WiFiClient client = server.client(); - String message = "HTTP/1.1 500 Fail\r\n"; - message += "Content-Type: text/plain\r\n"; - message += "Connection: close\r\n"; - message += "Access-Control-Allow-Origin: *\r\n"; - message += "\r\n"; - message += msg; - message += "\r\n"; - client.print(message); - client.stop(); +void returnFail(String msg) { + server.sendHeader("Connection", "close"); + server.sendHeader("Access-Control-Allow-Origin", "*"); + server.send(500, "text/plain", msg + "\r\n"); } bool loadFromSdCard(String path){ @@ -93,59 +81,40 @@ bool loadFromSdCard(String path){ dataType = "text/html"; dataFile = SD.open(path.c_str()); } + + if (!dataFile) + return false; if(server.hasArg("download")) dataType = "application/octet-stream"; - if (dataFile) { - WiFiClient client = server.client(); - String head = "HTTP/1.1 200 OK\r\nContent-Type: "; - head += dataType; - head += "\r\nContent-Length: "; - head += dataFile.size(); - head += "\r\nConnection: close"; - head += "\r\nAccess-Control-Allow-Origin: *"; - head += "\r\n\r\n"; - client.print(head); - dataType = String(); - path = String(); - - uint8_t obuf[WWW_BUF_SIZE]; - - while (dataFile.available() > WWW_BUF_SIZE){ - dataFile.read(obuf, WWW_BUF_SIZE); - if(client.write(obuf, WWW_BUF_SIZE) != WWW_BUF_SIZE){ - DBG_OUTPUT_PORT.println("Sent less data than expected!"); - dataFile.close(); - return true; - } - } - uint16_t leftLen = dataFile.available(); - dataFile.read(obuf, leftLen); - if(client.write(obuf, leftLen) != leftLen){ - DBG_OUTPUT_PORT.println("Sent less data than expected!"); - dataFile.close(); - return true; - } - dataFile.close(); - client.stop(); - return true; + server.sendHeader("Content-Length", String(dataFile.size())); + server.sendHeader("Connection", "close"); + server.sendHeader("Access-Control-Allow-Origin", "*"); + server.send(200, dataType.c_str(), ""); + + WiFiClient client = server.client(); + size_t totalSize = dataFile.size(); + if (client.write(dataFile, PAYLOAD_UNIT_SIZE) != totalSize) { + DBG_OUTPUT_PORT.println("Sent less data than expected!"); } - return false; + + dataFile.close(); + return true; } void handleFileUpload(){ if(server.uri() != "/edit") return; - HTTPUpload upload = server.upload(); + HTTPUpload& upload = server.upload(); if(upload.status == UPLOAD_FILE_START){ if(SD.exists((char *)upload.filename.c_str())) SD.remove((char *)upload.filename.c_str()); uploadFile = SD.open(upload.filename.c_str(), FILE_WRITE); DBG_OUTPUT_PORT.print("Upload: START, filename: "); DBG_OUTPUT_PORT.println(upload.filename); } else if(upload.status == UPLOAD_FILE_WRITE){ - if(uploadFile) uploadFile.write(upload.buf, upload.buflen); - DBG_OUTPUT_PORT.print("Upload: WRITE, Bytes: "); DBG_OUTPUT_PORT.println(upload.buflen); + if(uploadFile) uploadFile.write(upload.buf, upload.currentSize); + DBG_OUTPUT_PORT.print("Upload: WRITE, Bytes: "); DBG_OUTPUT_PORT.println(upload.currentSize); } else if(upload.status == UPLOAD_FILE_END){ if(uploadFile) uploadFile.close(); - DBG_OUTPUT_PORT.print("Upload: END, Size: "); DBG_OUTPUT_PORT.println(upload.size); + DBG_OUTPUT_PORT.print("Upload: END, Size: "); DBG_OUTPUT_PORT.println(upload.totalSize); } } @@ -156,13 +125,12 @@ void deleteRecursive(String path){ SD.remove((char *)path.c_str()); return; } + file.rewindDirectory(); - File entry; - String entryPath; while(true) { - entry = file.openNextFile(); + File entry = file.openNextFile(); if (!entry) break; - entryPath = path + "/" +entry.name(); + String entryPath = path + "/" +entry.name(); if(entry.isDirectory()){ entry.close(); deleteRecursive(entryPath); @@ -170,27 +138,32 @@ void deleteRecursive(String path){ entry.close(); SD.remove((char *)entryPath.c_str()); } - entryPath = String(); yield(); } + SD.rmdir((char *)path.c_str()); - path = String(); file.close(); } void handleDelete(){ if(server.args() == 0) return returnFail("BAD ARGS"); String path = server.arg(0); - if(path == "/" || !SD.exists((char *)path.c_str())) return returnFail("BAD PATH"); + if(path == "/" || !SD.exists((char *)path.c_str())) { + returnFail("BAD PATH"); + return; + } deleteRecursive(path); returnOK(); - path = String(); } void handleCreate(){ if(server.args() == 0) return returnFail("BAD ARGS"); String path = server.arg(0); - if(path == "/" || SD.exists((char *)path.c_str())) return returnFail("BAD PATH"); + if(path == "/" || SD.exists((char *)path.c_str())) { + returnFail("BAD PATH"); + return; + } + if(path.indexOf('.') > 0){ File file = SD.open((char *)path.c_str(), FILE_WRITE); if(file){ @@ -201,7 +174,6 @@ void handleCreate(){ SD.mkdir((char *)path.c_str()); } returnOK(); - path = String(); } void printDirectory() { @@ -216,31 +188,31 @@ void printDirectory() { } dir.rewindDirectory(); - File entry; + server.send(200, "text/json", ""); WiFiClient client = server.client(); - client.print("HTTP/1.1 200 OK\r\nContent-Type: text/json\r\n\r\n"); - String output = "["; - while(true) { - entry = dir.openNextFile(); - if (!entry) break; - if(output != "[") output += ','; - output += "{\"type\":\""; - output += (entry.isDirectory())?"dir":"file"; - output += "\",\"name\":\""; - output += entry.name(); - output += "\""; - output += "}"; - entry.close(); - if(output.length() > 1460){ - client.write(output.substring(0, 1460).c_str(), 1460); - output = output.substring(1460); - } + + for (int cnt = 0; true; ++cnt) { + File entry = dir.openNextFile(); + if (!entry) + break; + + String output; + if (cnt == 0) + output = '['; + else + output = ','; + + output += "{\"type\":\""; + output += (entry.isDirectory()) ? "dir" : "file"; + output += "\",\"name\":\""; + output += entry.name(); + output += "\""; + output += "}"; + server.sendContent(output); + entry.close(); } + server.sendContent("]"); dir.close(); - output += "]"; - client.write(output.c_str(), output.length()); - client.stop(); - output = String(); } void handleNotFound(){ @@ -280,14 +252,14 @@ void setup(void){ } DBG_OUTPUT_PORT.print("Connected! IP address: "); DBG_OUTPUT_PORT.println(WiFi.localIP()); - /* + if (mdns.begin(hostname, WiFi.localIP())) { DBG_OUTPUT_PORT.println("MDNS responder started"); DBG_OUTPUT_PORT.print("You can now connect to http://"); DBG_OUTPUT_PORT.print(hostname); DBG_OUTPUT_PORT.println(".local"); } - */ + server.on("/list", HTTP_GET, printDirectory); server.on("/edit", HTTP_DELETE, handleDelete); @@ -304,7 +276,7 @@ void setup(void){ hasSD = true; } } - + void loop(void){ server.handleClient(); } diff --git a/libraries/ESP8266WebServer/src/ESP8266WebServer.cpp b/libraries/ESP8266WebServer/src/ESP8266WebServer.cpp index cc4fffcce..3ca68f563 100644 --- a/libraries/ESP8266WebServer/src/ESP8266WebServer.cpp +++ b/libraries/ESP8266WebServer/src/ESP8266WebServer.cpp @@ -26,8 +26,8 @@ #include "WiFiClient.h" #include "ESP8266WebServer.h" -//#define DEBUG -#define DEBUG_OUTPUT Serial1 +// #define DEBUG +#define DEBUG_OUTPUT Serial struct ESP8266WebServer::RequestHandler { RequestHandler(ESP8266WebServer::THandlerFunction fn, const char* uri, HTTPMethod method) @@ -99,110 +99,32 @@ void ESP8266WebServer::handleClient() #ifdef DEBUG DEBUG_OUTPUT.println("New client"); #endif + // Wait for data from client to become available while(client.connected() && !client.available()){ delay(1); } - // Read the first line of HTTP request - String req = client.readStringUntil('\r'); - client.readStringUntil('\n'); - - // First line of HTTP request looks like "GET /path HTTP/1.1" - // Retrieve the "/path" part by finding the spaces - int addr_start = req.indexOf(' '); - int addr_end = req.indexOf(' ', addr_start + 1); - if (addr_start == -1 || addr_end == -1) { -#ifdef DEBUG - DEBUG_OUTPUT.print("Invalid request: "); - DEBUG_OUTPUT.println(req); -#endif + if (!_parseRequest(client)) { return; } - - String methodStr = req.substring(0, addr_start); - String url = req.substring(addr_start + 1, addr_end); - String searchStr = ""; - int hasSearch = url.indexOf('?'); - if(hasSearch != -1){ - searchStr = url.substring(hasSearch + 1); - url = url.substring(0, hasSearch); - } - _currentUri = url; - - HTTPMethod method = HTTP_GET; - if (methodStr == "POST") { - method = HTTP_POST; - } else if (methodStr == "DELETE") { - method = HTTP_DELETE; - } else if (methodStr == "PUT") { - method = HTTP_PUT; - } else if (methodStr == "PATCH") { - method = HTTP_PATCH; - } - -#ifdef DEBUG - DEBUG_OUTPUT.print("method: "); - DEBUG_OUTPUT.print(methodStr); - DEBUG_OUTPUT.print(" url: "); - DEBUG_OUTPUT.print(url); - DEBUG_OUTPUT.print(" search: "); - DEBUG_OUTPUT.println(searchStr); -#endif - String formData; - //bellow is needed only when POST type request - if(method == HTTP_POST || method == HTTP_PUT || method == HTTP_PATCH || method == HTTP_DELETE){ - String boundaryStr; - String headerName; - String headerValue; - bool isForm = false; - uint32_t contentLength = 0; - //parse headers - while(1){ - req = client.readStringUntil('\r'); - client.readStringUntil('\n'); - if(req == "") break;//no moar headers - int headerDiv = req.indexOf(':'); - if(headerDiv == -1){ - break; - } - headerName = req.substring(0, headerDiv); - headerValue = req.substring(headerDiv + 2); - if(headerName == "Content-Type"){ - if(headerValue.startsWith("text/plain")){ - isForm = false; - } else if(headerValue.startsWith("multipart/form-data")){ - boundaryStr = headerValue.substring(headerValue.indexOf('=')+1); - isForm = true; - } - } else if(headerName == "Content-Length"){ - contentLength = headerValue.toInt(); - } - } - - if(!isForm){ - if(searchStr != "") searchStr += '&'; - searchStr += client.readStringUntil('\r'); - client.readStringUntil('\n'); - } - _parseArguments(searchStr); - if(isForm){ - _parseForm(client, boundaryStr, contentLength); - } - } else { - _parseArguments(searchStr); + _currentClient = client; + _handleRequest(); +} + +void ESP8266WebServer::sendHeader(String name, String value, bool first) { + String headerLine = name; + headerLine += ": "; + headerLine += value; + headerLine += "\r\n"; + + if (first) { + _responseHeaders = headerLine + _responseHeaders; + } + else { + _responseHeaders += headerLine; } - client.flush(); - -#ifdef DEBUG - DEBUG_OUTPUT.print("Request: "); - DEBUG_OUTPUT.println(url); - DEBUG_OUTPUT.print(" Arguments: "); - DEBUG_OUTPUT.println(searchStr); -#endif - - _handleRequest(client, url, method); } void ESP8266WebServer::send(int code, const char* content_type, String content) { @@ -214,11 +136,28 @@ void ESP8266WebServer::send(int code, const char* content_type, String content) if (!content_type) content_type = "text/html"; - _appendHeader(response, "Content-Type", content_type); + sendHeader("Content-Type", content_type, true); + response += _responseHeaders; response += "\r\n"; response += content; - _currentClient.print(response); + _responseHeaders = String(); + sendContent(response); +} + +void ESP8266WebServer::sendContent(String content) { + size_t size_to_send = content.length(); + size_t size_sent = 0; + while(size_to_send) { + const size_t unit_size = PAYLOAD_UNIT_SIZE; + size_t will_send = (size_to_send < unit_size) ? size_to_send : unit_size; + size_t sent = _currentClient.write(content.c_str() + size_sent, will_send); + size_to_send -= sent; + size_sent += sent; + if (sent == 0) { + break; + } + } } String ESP8266WebServer::arg(const char* name) { @@ -253,298 +192,6 @@ bool ESP8266WebServer::hasArg(const char* name) { return false; } -void ESP8266WebServer::_parseArguments(String data) { -#ifdef DEBUG - DEBUG_OUTPUT.print("args: "); - DEBUG_OUTPUT.println(data); -#endif - if (_currentArgs) - delete[] _currentArgs; - _currentArgs = 0; - if (data.length() == 0) { - _currentArgCount = 0; - return; - } - _currentArgCount = 1; - - for (int i = 0; i < data.length(); ) { - i = data.indexOf('&', i); - if (i == -1) - break; - ++i; - ++_currentArgCount; - } -#ifdef DEBUG - DEBUG_OUTPUT.print("args count: "); - DEBUG_OUTPUT.println(_currentArgCount); -#endif - - _currentArgs = new RequestArgument[_currentArgCount]; - int pos = 0; - int iarg; - for (iarg = 0; iarg < _currentArgCount;) { - int equal_sign_index = data.indexOf('=', pos); - int next_arg_index = data.indexOf('&', pos); -#ifdef DEBUG - DEBUG_OUTPUT.print("pos "); - DEBUG_OUTPUT.print(pos); - DEBUG_OUTPUT.print("=@ "); - DEBUG_OUTPUT.print(equal_sign_index); - DEBUG_OUTPUT.print(" &@ "); - DEBUG_OUTPUT.println(next_arg_index); -#endif - if ((equal_sign_index == -1) || ((equal_sign_index > next_arg_index) && (next_arg_index != -1))) { -#ifdef DEBUG - DEBUG_OUTPUT.print("arg missing value: "); - DEBUG_OUTPUT.println(iarg); -#endif - if (next_arg_index == -1) - break; - pos = next_arg_index + 1; - continue; - } - RequestArgument& arg = _currentArgs[iarg]; - arg.key = data.substring(pos, equal_sign_index); - arg.value = data.substring(equal_sign_index + 1, next_arg_index); -#ifdef DEBUG - DEBUG_OUTPUT.print("arg "); - DEBUG_OUTPUT.print(iarg); - DEBUG_OUTPUT.print(" key: "); - DEBUG_OUTPUT.print(arg.key); - DEBUG_OUTPUT.print(" value: "); - DEBUG_OUTPUT.println(arg.value); -#endif - ++iarg; - if (next_arg_index == -1) - break; - pos = next_arg_index + 1; - } - _currentArgCount = iarg; -#ifdef DEBUG - DEBUG_OUTPUT.print("args count: "); - DEBUG_OUTPUT.println(_currentArgCount); -#endif - -} - -void ESP8266WebServer::_parseForm(WiFiClient& client, String boundary, uint32_t len){ - -#ifdef DEBUG - DEBUG_OUTPUT.print("Parse Form: Boundary: "); - DEBUG_OUTPUT.print(boundary); - DEBUG_OUTPUT.print("Length: "); - DEBUG_OUTPUT.println(len); -#endif - String line; - line = client.readStringUntil('\r'); - client.readStringUntil('\n'); - //start reading the form - if(line == ("--"+boundary)){ - RequestArgument* postArgs = new RequestArgument[32]; - int postArgsLen = 0; - while(1){ - String argName; - String argValue; - String argType; - String argFilename; - bool argIsFile = false; - - line = client.readStringUntil('\r'); - client.readStringUntil('\n'); - if(line.startsWith("Content-Disposition")){ - int nameStart = line.indexOf('='); - if(nameStart != -1){ - argName = line.substring(nameStart+2); - nameStart = argName.indexOf('='); - if(nameStart == -1){ - argName = argName.substring(0, argName.length() - 1); - } else { - argFilename = argName.substring(nameStart+2, argName.length() - 1); - argName = argName.substring(0, argName.indexOf('"')); - argIsFile = true; - #ifdef DEBUG - DEBUG_OUTPUT.print("PostArg FileName: "); - DEBUG_OUTPUT.println(argFilename); - #endif - //use GET to set the filename if uploading using blob - if(argFilename == "blob" && hasArg("filename")) argFilename = arg("filename"); - } - #ifdef DEBUG - DEBUG_OUTPUT.print("PostArg Name: "); - DEBUG_OUTPUT.println(argName); - #endif - argType = "text/plain"; - line = client.readStringUntil('\r'); - client.readStringUntil('\n'); - if(line.startsWith("Content-Type")){ - argType = line.substring(line.indexOf(':')+2); - //skip next line - client.readStringUntil('\r'); - client.readStringUntil('\n'); - } - #ifdef DEBUG - DEBUG_OUTPUT.print("PostArg Type: "); - DEBUG_OUTPUT.println(argType); - #endif - if(!argIsFile){ - while(1){ - line = client.readStringUntil('\r'); - client.readStringUntil('\n'); - if(line.startsWith("--"+boundary)) break; - if(argValue.length() > 0) argValue += "\n"; - argValue += line; - } - #ifdef DEBUG - DEBUG_OUTPUT.print("PostArg Value: "); - DEBUG_OUTPUT.println(argValue); - DEBUG_OUTPUT.println(); - #endif - - RequestArgument& arg = postArgs[postArgsLen++]; - arg.key = argName; - arg.value = argValue; - - if(line == ("--"+boundary+"--")){ - #ifdef DEBUG - DEBUG_OUTPUT.println("Done Parsing POST"); - #endif - break; - } - } else { - _currentUpload.status = UPLOAD_FILE_START; - _currentUpload.name = argName; - _currentUpload.filename = argFilename; - _currentUpload.type = argType; - _currentUpload.size = 0; - _currentUpload.buflen = 0; -#ifdef DEBUG - DEBUG_OUTPUT.print("Start File: "); - DEBUG_OUTPUT.print(_currentUpload.filename); - DEBUG_OUTPUT.print(" Type: "); - DEBUG_OUTPUT.println(_currentUpload.type); -#endif - if(_fileUploadHandler) _fileUploadHandler(); - _currentUpload.status = UPLOAD_FILE_WRITE; - uint8_t argByte = client.read(); -readfile: - while(argByte != 0x0D){ - _currentUpload.buf[_currentUpload.buflen++] = argByte; - if(_currentUpload.buflen == 1460){ - #ifdef DEBUG - DEBUG_OUTPUT.println("Write File: 1460"); - #endif - if(_fileUploadHandler) _fileUploadHandler(); - _currentUpload.size += _currentUpload.buflen; - _currentUpload.buflen = 0; - } - argByte = client.read(); - } - - argByte = client.read(); - if(argByte == 0x0A){ -#ifdef DEBUG - DEBUG_OUTPUT.print("Write File: "); - DEBUG_OUTPUT.println(_currentUpload.buflen); -#endif - if(_fileUploadHandler) _fileUploadHandler(); - _currentUpload.size += _currentUpload.buflen; - _currentUpload.buflen = 0; - - argByte = client.read(); - if((char)argByte != '-'){ - //continue reading the file - _currentUpload.buf[_currentUpload.buflen++] = 0x0D; - _currentUpload.buf[_currentUpload.buflen++] = 0x0A; - goto readfile; - } else { - argByte = client.read(); - if((char)argByte != '-'){ - //continue reading the file - _currentUpload.buf[_currentUpload.buflen++] = 0x0D; - _currentUpload.buf[_currentUpload.buflen++] = 0x0A; - _currentUpload.buf[_currentUpload.buflen++] = (uint8_t)('-'); - goto readfile; - } - } - - uint8_t endBuf[boundary.length()]; - client.readBytes(endBuf, boundary.length()); - - if(strstr((const char*)endBuf, (const char*)(boundary.c_str())) != NULL){ - _currentUpload.status = UPLOAD_FILE_END; -#ifdef DEBUG - DEBUG_OUTPUT.print("End File: "); - DEBUG_OUTPUT.print(_currentUpload.filename); - DEBUG_OUTPUT.print(" Type: "); - DEBUG_OUTPUT.print(_currentUpload.type); - DEBUG_OUTPUT.print(" Size: "); - DEBUG_OUTPUT.println(_currentUpload.size); -#endif - if(_fileUploadHandler) _fileUploadHandler(); - line = client.readStringUntil(0x0D); - client.readStringUntil(0x0A); - if(line == "--"){ -#ifdef DEBUG - DEBUG_OUTPUT.println("Done Parsing POST"); -#endif - break; - } - continue; - } else { - _currentUpload.buf[_currentUpload.buflen++] = 0x0D; - _currentUpload.buf[_currentUpload.buflen++] = 0x0A; - uint32_t i = 0; - while(i < boundary.length()){ - _currentUpload.buf[_currentUpload.buflen++] = endBuf[i++]; - if(_currentUpload.buflen == 1460){ -#ifdef DEBUG - DEBUG_OUTPUT.println("Write File: 1460"); -#endif - if(_fileUploadHandler) _fileUploadHandler(); - _currentUpload.size += _currentUpload.buflen; - _currentUpload.buflen = 0; - } - } - argByte = client.read(); - goto readfile; - } - } else { - _currentUpload.buf[_currentUpload.buflen++] = 0x0D; - if(_currentUpload.buflen == 1460){ - #ifdef DEBUG - DEBUG_OUTPUT.println("Write File: 1460"); - #endif - if(_fileUploadHandler) _fileUploadHandler(); - _currentUpload.size += _currentUpload.buflen; - _currentUpload.buflen = 0; - } - goto readfile; - } - break; - } - } - } - } - - int iarg; - int totalArgs = ((32 - postArgsLen) < _currentArgCount)?(32 - postArgsLen):_currentArgCount; - for (iarg = 0; iarg < totalArgs; iarg++){ - RequestArgument& arg = postArgs[postArgsLen++]; - arg.key = _currentArgs[iarg].key; - arg.value = _currentArgs[iarg].value; - } - if (_currentArgs) delete[] _currentArgs; - _currentArgs = new RequestArgument[postArgsLen]; - for (iarg = 0; iarg < postArgsLen; iarg++){ - RequestArgument& arg = _currentArgs[iarg]; - arg.key = postArgs[iarg].key; - arg.value = postArgs[iarg].value; - } - _currentArgCount = iarg; - if (postArgs) delete[] postArgs; - } -} - void ESP8266WebServer::onFileUpload(THandlerFunction fn) { _fileUploadHandler = fn; } @@ -553,18 +200,14 @@ void ESP8266WebServer::onNotFound(THandlerFunction fn) { _notFoundHandler = fn; } -void ESP8266WebServer::_handleRequest(WiFiClient& client, String uri, HTTPMethod method) { - _currentClient = client; - _currentUri = uri; - _currentMethod = method; - +void ESP8266WebServer::_handleRequest() { RequestHandler* handler; for (handler = _firstHandler; handler; handler = handler->next) { - if (handler->method != HTTP_ANY && handler->method != method) + if (handler->method != HTTP_ANY && handler->method != _currentMethod) continue; - if (handler->uri != uri) + if (handler->uri != _currentUri) continue; handler->fn(); @@ -580,26 +223,19 @@ void ESP8266WebServer::_handleRequest(WiFiClient& client, String uri, HTTPMethod _notFoundHandler(); } else { - send(404, "text/plain", String("Not found: ") + uri); + send(404, "text/plain", String("Not found: ") + _currentUri); } } _currentClient = WiFiClient(); _currentUri = String(); - } const char* ESP8266WebServer::_responseCodeToString(int code) { switch (code) { case 200: return "OK"; case 404: return "Not found"; + case 500: return "Fail"; default: return ""; } } - -void ESP8266WebServer::_appendHeader(String& response, const char* name, const char* value) { - response += name; - response += ": "; - response += value; - response += "\r\n"; -} diff --git a/libraries/ESP8266WebServer/src/ESP8266WebServer.h b/libraries/ESP8266WebServer/src/ESP8266WebServer.h index 423fc6173..e16aa571f 100644 --- a/libraries/ESP8266WebServer/src/ESP8266WebServer.h +++ b/libraries/ESP8266WebServer/src/ESP8266WebServer.h @@ -29,14 +29,17 @@ enum HTTPMethod { HTTP_ANY, HTTP_GET, HTTP_POST, HTTP_PUT, HTTP_PATCH, HTTP_DELETE }; enum HTTPUploadStatus { UPLOAD_FILE_START, UPLOAD_FILE_WRITE, UPLOAD_FILE_END }; +#define PAYLOAD_UNIT_SIZE 1460 + typedef struct { HTTPUploadStatus status; String filename; String name; String type; - size_t size; - size_t buflen; - uint8_t buf[1460]; + size_t totalSize; // file size + size_t currentSize; // size of data currently in buf + uint8_t buf[PAYLOAD_UNIT_SIZE]; + } HTTPUpload; class ESP8266WebServer @@ -58,7 +61,7 @@ public: String uri() { return _currentUri; } HTTPMethod method() { return _currentMethod; } WiFiClient client() { return _currentClient; } - HTTPUpload upload() { return _currentUpload; } + HTTPUpload& upload() { return _currentUpload; } String arg(const char* name); // get request argument value by name String arg(int i); // get request argument value by number @@ -72,11 +75,13 @@ public: // content - actual content body void send(int code, const char* content_type = NULL, String content = String("")); + void sendHeader(String name, String value, bool first = false); + void sendContent(String content); protected: - void _handleRequest(WiFiClient& client, String uri, HTTPMethod method); + void _handleRequest(); + bool _parseRequest(WiFiClient& client); void _parseArguments(String data); static const char* _responseCodeToString(int code); - static void _appendHeader(String& response, const char* name, const char* value); void _parseForm(WiFiClient& client, String boundary, uint32_t len); struct RequestHandler; @@ -95,6 +100,8 @@ protected: RequestArgument* _currentArgs; HTTPUpload _currentUpload; + String _responseHeaders; + RequestHandler* _firstHandler; RequestHandler* _lastHandler; THandlerFunction _notFoundHandler; diff --git a/libraries/ESP8266WebServer/src/Parsing.cpp b/libraries/ESP8266WebServer/src/Parsing.cpp new file mode 100644 index 000000000..6c2bd5d22 --- /dev/null +++ b/libraries/ESP8266WebServer/src/Parsing.cpp @@ -0,0 +1,428 @@ +/* + Parsing.cpp - HTTP request parsing. + + Copyright (c) 2015 Ivan Grokhotkov. All rights reserved. + + 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 + Modified 8 May 2015 by Hristo Gochkov (proper post and file upload handling) +*/ + +#include +#include "WiFiServer.h" +#include "WiFiClient.h" +#include "ESP8266WebServer.h" + +// #define DEBUG +#define DEBUG_OUTPUT Serial1 + +bool ESP8266WebServer::_parseRequest(WiFiClient& client) { + // Read the first line of HTTP request + String req = client.readStringUntil('\r'); + client.readStringUntil('\n'); + + // First line of HTTP request looks like "GET /path HTTP/1.1" + // Retrieve the "/path" part by finding the spaces + int addr_start = req.indexOf(' '); + int addr_end = req.indexOf(' ', addr_start + 1); + if (addr_start == -1 || addr_end == -1) { +#ifdef DEBUG + DEBUG_OUTPUT.print("Invalid request: "); + DEBUG_OUTPUT.println(req); +#endif + return false; + } + + String methodStr = req.substring(0, addr_start); + String url = req.substring(addr_start + 1, addr_end); + String searchStr = ""; + int hasSearch = url.indexOf('?'); + if(hasSearch != -1){ + searchStr = url.substring(hasSearch + 1); + url = url.substring(0, hasSearch); + } + _currentUri = url; + + HTTPMethod method = HTTP_GET; + if (methodStr == "POST") { + method = HTTP_POST; + } else if (methodStr == "DELETE") { + method = HTTP_DELETE; + } else if (methodStr == "PUT") { + method = HTTP_PUT; + } else if (methodStr == "PATCH") { + method = HTTP_PATCH; + } + _currentMethod = method; + +#ifdef DEBUG + DEBUG_OUTPUT.print("method: "); + DEBUG_OUTPUT.print(methodStr); + DEBUG_OUTPUT.print(" url: "); + DEBUG_OUTPUT.print(url); + DEBUG_OUTPUT.print(" search: "); + DEBUG_OUTPUT.println(searchStr); +#endif + + String formData; + // below is needed only when POST type request + if(method == HTTP_POST || method == HTTP_PUT || method == HTTP_PATCH || method == HTTP_DELETE){ + String boundaryStr; + String headerName; + String headerValue; + bool isForm = false; + uint32_t contentLength = 0; + //parse headers + while(1){ + req = client.readStringUntil('\r'); + client.readStringUntil('\n'); + if(req == "") break;//no moar headers + int headerDiv = req.indexOf(':'); + if(headerDiv == -1){ + break; + } + headerName = req.substring(0, headerDiv); + headerValue = req.substring(headerDiv + 2); + if(headerName == "Content-Type"){ + if(headerValue.startsWith("text/plain")){ + isForm = false; + } else if(headerValue.startsWith("multipart/form-data")){ + boundaryStr = headerValue.substring(headerValue.indexOf('=')+1); + isForm = true; + } + } else if(headerName == "Content-Length"){ + contentLength = headerValue.toInt(); + } + } + + if(!isForm){ + if(searchStr != "") searchStr += '&'; + searchStr += client.readStringUntil('\r'); + client.readStringUntil('\n'); + } + _parseArguments(searchStr); + if(isForm){ + _parseForm(client, boundaryStr, contentLength); + } + } else { + _parseArguments(searchStr); + } + client.flush(); + +#ifdef DEBUG + DEBUG_OUTPUT.print("Request: "); + DEBUG_OUTPUT.println(url); + DEBUG_OUTPUT.print(" Arguments: "); + DEBUG_OUTPUT.println(searchStr); +#endif + + return true; +} + + +void ESP8266WebServer::_parseArguments(String data) { +#ifdef DEBUG + DEBUG_OUTPUT.print("args: "); + DEBUG_OUTPUT.println(data); +#endif + if (_currentArgs) + delete[] _currentArgs; + _currentArgs = 0; + if (data.length() == 0) { + _currentArgCount = 0; + return; + } + _currentArgCount = 1; + + for (int i = 0; i < data.length(); ) { + i = data.indexOf('&', i); + if (i == -1) + break; + ++i; + ++_currentArgCount; + } +#ifdef DEBUG + DEBUG_OUTPUT.print("args count: "); + DEBUG_OUTPUT.println(_currentArgCount); +#endif + + _currentArgs = new RequestArgument[_currentArgCount]; + int pos = 0; + int iarg; + for (iarg = 0; iarg < _currentArgCount;) { + int equal_sign_index = data.indexOf('=', pos); + int next_arg_index = data.indexOf('&', pos); +#ifdef DEBUG + DEBUG_OUTPUT.print("pos "); + DEBUG_OUTPUT.print(pos); + DEBUG_OUTPUT.print("=@ "); + DEBUG_OUTPUT.print(equal_sign_index); + DEBUG_OUTPUT.print(" &@ "); + DEBUG_OUTPUT.println(next_arg_index); +#endif + if ((equal_sign_index == -1) || ((equal_sign_index > next_arg_index) && (next_arg_index != -1))) { +#ifdef DEBUG + DEBUG_OUTPUT.print("arg missing value: "); + DEBUG_OUTPUT.println(iarg); +#endif + if (next_arg_index == -1) + break; + pos = next_arg_index + 1; + continue; + } + RequestArgument& arg = _currentArgs[iarg]; + arg.key = data.substring(pos, equal_sign_index); + arg.value = data.substring(equal_sign_index + 1, next_arg_index); +#ifdef DEBUG + DEBUG_OUTPUT.print("arg "); + DEBUG_OUTPUT.print(iarg); + DEBUG_OUTPUT.print(" key: "); + DEBUG_OUTPUT.print(arg.key); + DEBUG_OUTPUT.print(" value: "); + DEBUG_OUTPUT.println(arg.value); +#endif + ++iarg; + if (next_arg_index == -1) + break; + pos = next_arg_index + 1; + } + _currentArgCount = iarg; +#ifdef DEBUG + DEBUG_OUTPUT.print("args count: "); + DEBUG_OUTPUT.println(_currentArgCount); +#endif + +} + +void ESP8266WebServer::_parseForm(WiFiClient& client, String boundary, uint32_t len){ + +#ifdef DEBUG + DEBUG_OUTPUT.print("Parse Form: Boundary: "); + DEBUG_OUTPUT.print(boundary); + DEBUG_OUTPUT.print("Length: "); + DEBUG_OUTPUT.println(len); +#endif + String line; + line = client.readStringUntil('\r'); + client.readStringUntil('\n'); + //start reading the form + if(line == ("--"+boundary)){ + RequestArgument* postArgs = new RequestArgument[32]; + int postArgsLen = 0; + while(1){ + String argName; + String argValue; + String argType; + String argFilename; + bool argIsFile = false; + + line = client.readStringUntil('\r'); + client.readStringUntil('\n'); + if(line.startsWith("Content-Disposition")){ + int nameStart = line.indexOf('='); + if(nameStart != -1){ + argName = line.substring(nameStart+2); + nameStart = argName.indexOf('='); + if(nameStart == -1){ + argName = argName.substring(0, argName.length() - 1); + } else { + argFilename = argName.substring(nameStart+2, argName.length() - 1); + argName = argName.substring(0, argName.indexOf('"')); + argIsFile = true; + #ifdef DEBUG + DEBUG_OUTPUT.print("PostArg FileName: "); + DEBUG_OUTPUT.println(argFilename); + #endif + //use GET to set the filename if uploading using blob + if(argFilename == "blob" && hasArg("filename")) argFilename = arg("filename"); + } + #ifdef DEBUG + DEBUG_OUTPUT.print("PostArg Name: "); + DEBUG_OUTPUT.println(argName); + #endif + argType = "text/plain"; + line = client.readStringUntil('\r'); + client.readStringUntil('\n'); + if(line.startsWith("Content-Type")){ + argType = line.substring(line.indexOf(':')+2); + //skip next line + client.readStringUntil('\r'); + client.readStringUntil('\n'); + } + #ifdef DEBUG + DEBUG_OUTPUT.print("PostArg Type: "); + DEBUG_OUTPUT.println(argType); + #endif + if(!argIsFile){ + while(1){ + line = client.readStringUntil('\r'); + client.readStringUntil('\n'); + if(line.startsWith("--"+boundary)) break; + if(argValue.length() > 0) argValue += "\n"; + argValue += line; + } + #ifdef DEBUG + DEBUG_OUTPUT.print("PostArg Value: "); + DEBUG_OUTPUT.println(argValue); + DEBUG_OUTPUT.println(); + #endif + + RequestArgument& arg = postArgs[postArgsLen++]; + arg.key = argName; + arg.value = argValue; + + if(line == ("--"+boundary+"--")){ + #ifdef DEBUG + DEBUG_OUTPUT.println("Done Parsing POST"); + #endif + break; + } + } else { + _currentUpload.status = UPLOAD_FILE_START; + _currentUpload.name = argName; + _currentUpload.filename = argFilename; + _currentUpload.type = argType; + _currentUpload.totalSize = 0; + _currentUpload.currentSize = 0; +#ifdef DEBUG + DEBUG_OUTPUT.print("Start File: "); + DEBUG_OUTPUT.print(_currentUpload.filename); + DEBUG_OUTPUT.print(" Type: "); + DEBUG_OUTPUT.println(_currentUpload.type); +#endif + if(_fileUploadHandler) _fileUploadHandler(); + _currentUpload.status = UPLOAD_FILE_WRITE; + uint8_t argByte = client.read(); +readfile: + while(argByte != 0x0D){ + _currentUpload.buf[_currentUpload.currentSize++] = argByte; + if(_currentUpload.currentSize == PAYLOAD_UNIT_SIZE){ + #ifdef DEBUG + DEBUG_OUTPUT.print("Write File: "); + DEBUG_OUTPUT.println(PAYLOAD_UNIT_SIZE); + #endif + if(_fileUploadHandler) _fileUploadHandler(); + _currentUpload.totalSize += _currentUpload.currentSize; + _currentUpload.currentSize = 0; + } + argByte = client.read(); + } + + argByte = client.read(); + if(argByte == 0x0A){ +#ifdef DEBUG + DEBUG_OUTPUT.print("Write File: "); + DEBUG_OUTPUT.println(_currentUpload.currentSize); +#endif + if(_fileUploadHandler) _fileUploadHandler(); + _currentUpload.totalSize += _currentUpload.currentSize; + _currentUpload.currentSize = 0; + + argByte = client.read(); + if((char)argByte != '-'){ + //continue reading the file + _currentUpload.buf[_currentUpload.currentSize++] = 0x0D; + _currentUpload.buf[_currentUpload.currentSize++] = 0x0A; + goto readfile; + } else { + argByte = client.read(); + if((char)argByte != '-'){ + //continue reading the file + _currentUpload.buf[_currentUpload.currentSize++] = 0x0D; + _currentUpload.buf[_currentUpload.currentSize++] = 0x0A; + _currentUpload.buf[_currentUpload.currentSize++] = (uint8_t)('-'); + goto readfile; + } + } + + uint8_t endBuf[boundary.length()]; + client.readBytes(endBuf, boundary.length()); + + if(strstr((const char*)endBuf, (const char*)(boundary.c_str())) != NULL){ + _currentUpload.status = UPLOAD_FILE_END; +#ifdef DEBUG + DEBUG_OUTPUT.print("End File: "); + DEBUG_OUTPUT.print(_currentUpload.filename); + DEBUG_OUTPUT.print(" Type: "); + DEBUG_OUTPUT.print(_currentUpload.type); + DEBUG_OUTPUT.print(" Size: "); + DEBUG_OUTPUT.println(_currentUpload.totalSize); +#endif + if(_fileUploadHandler) _fileUploadHandler(); + line = client.readStringUntil(0x0D); + client.readStringUntil(0x0A); + if(line == "--"){ +#ifdef DEBUG + DEBUG_OUTPUT.println("Done Parsing POST"); +#endif + break; + } + continue; + } else { + _currentUpload.buf[_currentUpload.currentSize++] = 0x0D; + _currentUpload.buf[_currentUpload.currentSize++] = 0x0A; + uint32_t i = 0; + while(i < boundary.length()){ + _currentUpload.buf[_currentUpload.currentSize++] = endBuf[i++]; + if(_currentUpload.currentSize == PAYLOAD_UNIT_SIZE){ +#ifdef DEBUG + DEBUG_OUTPUT.print("Write File: "); + DEBUG_OUTPUT.println(PAYLOAD_UNIT_SIZE); +#endif + if(_fileUploadHandler) _fileUploadHandler(); + _currentUpload.totalSize += _currentUpload.currentSize; + _currentUpload.currentSize = 0; + } + } + argByte = client.read(); + goto readfile; + } + } else { + _currentUpload.buf[_currentUpload.currentSize++] = 0x0D; + if(_currentUpload.currentSize == PAYLOAD_UNIT_SIZE){ + #ifdef DEBUG + DEBUG_OUTPUT.print("Write File: "); + DEBUG_OUTPUT.println(PAYLOAD_UNIT_SIZE); + #endif + if(_fileUploadHandler) _fileUploadHandler(); + _currentUpload.totalSize += _currentUpload.currentSize; + _currentUpload.currentSize = 0; + } + goto readfile; + } + break; + } + } + } + } + + int iarg; + int totalArgs = ((32 - postArgsLen) < _currentArgCount)?(32 - postArgsLen):_currentArgCount; + for (iarg = 0; iarg < totalArgs; iarg++){ + RequestArgument& arg = postArgs[postArgsLen++]; + arg.key = _currentArgs[iarg].key; + arg.value = _currentArgs[iarg].value; + } + if (_currentArgs) delete[] _currentArgs; + _currentArgs = new RequestArgument[postArgsLen]; + for (iarg = 0; iarg < postArgsLen; iarg++){ + RequestArgument& arg = _currentArgs[iarg]; + arg.key = postArgs[iarg].key; + arg.value = postArgs[iarg].value; + } + _currentArgCount = iarg; + if (postArgs) delete[] postArgs; + } +} + diff --git a/libraries/ESP8266WiFi/src/WiFiClient.h b/libraries/ESP8266WiFi/src/WiFiClient.h index 251f2b3e3..d1bdb35df 100644 --- a/libraries/ESP8266WiFi/src/WiFiClient.h +++ b/libraries/ESP8266WiFi/src/WiFiClient.h @@ -25,6 +25,7 @@ #include "Print.h" #include "Client.h" #include "IPAddress.h" +#include class ClientContext; class WiFiServer; @@ -44,6 +45,9 @@ public: virtual int connect(const char *host, uint16_t port); virtual size_t write(uint8_t); virtual size_t write(const uint8_t *buf, size_t size); + template + size_t write(T& source, size_t unitSize); + virtual int available(); virtual int read(); virtual int read(uint8_t *buf, size_t size); @@ -72,4 +76,24 @@ private: }; + +template +inline size_t WiFiClient::write(T& source, size_t unitSize) { + std::unique_ptr buffer(new uint8_t[unitSize]); + size_t size_sent = 0; + while(true) { + size_t left = source.available(); + if (!left) + break; + size_t will_send = (left < unitSize) ? left : unitSize; + source.read(buffer.get(), will_send); + size_t cb = write(buffer.get(), will_send); + size_sent += cb; + if (cb != will_send) { + break; + } + } + return size_sent; +} + #endif From 4644c3bad02b96fdec28fb1cf85051c5d077df63 Mon Sep 17 00:00:00 2001 From: Ivan Grokhotkov Date: Thu, 14 May 2015 15:05:24 +0300 Subject: [PATCH 22/78] boolean -> bool --- cores/esp8266/FileSystem.cpp | 47 +++++++++++++++++--------------- cores/esp8266/FileSystem.h | 51 ++++++++++++++++------------------- cores/esp8266/spiffs/spiffs.h | 2 -- 3 files changed, 49 insertions(+), 51 deletions(-) diff --git a/cores/esp8266/FileSystem.cpp b/cores/esp8266/FileSystem.cpp index 7e42af06b..f2517cf98 100755 --- a/cores/esp8266/FileSystem.cpp +++ b/cores/esp8266/FileSystem.cpp @@ -21,41 +21,46 @@ #include "FileSystem.h" #include "Arduino.h" -boolean FSClass::mount(){ - if(_mounted) return true; +bool FSClass::mount() { + if (_mounted) + return true; + _mounted = spiffs_mount(); return _mounted; } -void FSClass::unmount(){ - if(!_mounted) return; +void FSClass::unmount() { + if (!_mounted) + return; + spiffs_unmount(); _mounted = false; } -boolean FSClass::format(){ +bool FSClass::format() { return spiffs_format(); } -boolean FSClass::exists(const char *filename){ +bool FSClass::exists(const char *filename) { spiffs_stat stat = {0}; - if (SPIFFS_stat(&_filesystemStorageHandle, filename, &stat) < 0) return false; + if (SPIFFS_stat(&_filesystemStorageHandle, filename, &stat) < 0) + return false; return stat.name[0] != '\0'; } -boolean FSClass::create(const char *filepath){ +bool FSClass::create(const char *filepath){ return SPIFFS_creat(&_filesystemStorageHandle, filepath, 0) == 0; } -boolean FSClass::remove(const char *filepath){ +bool FSClass::remove(const char *filepath){ return SPIFFS_remove(&_filesystemStorageHandle, filepath) == 0; } -boolean FSClass::rename(const char *filename, const char *newname){ +bool FSClass::rename(const char *filename, const char *newname) { return SPIFFS_rename(&_filesystemStorageHandle, filename, newname) == 0; } -FSFile FSClass::open(const char *filename, uint8_t mode){ +FSFile FSClass::open(const char *filename, uint8_t mode) { int repeats = 0; bool notExist; bool canRecreate = (mode & SPIFFS_CREAT) == SPIFFS_CREAT; @@ -81,25 +86,25 @@ FSFile FSClass::open(const char *filename, uint8_t mode){ FSClass FS; -FSFile::FSFile(){ +FSFile::FSFile() { _file = 0; _stats = {0}; } -FSFile::FSFile(file_t f){ +FSFile::FSFile(file_t f) { _file = f; if(SPIFFS_fstat(&_filesystemStorageHandle, _file, &_stats) != 0){ debugf("mount errno %d\n", SPIFFS_errno(&_filesystemStorageHandle)); } } -void FSFile::close(){ +void FSFile::close() { if (! _file) return; SPIFFS_close(&_filesystemStorageHandle, _file); _file = 0; } -uint32_t FSFile::size(){ +uint32_t FSFile::size() { if(! _file) return 0; uint32_t pos = SPIFFS_tell(&_filesystemStorageHandle, _file); SPIFFS_lseek(&_filesystemStorageHandle, _file, 0, SPIFFS_SEEK_END); @@ -108,31 +113,31 @@ uint32_t FSFile::size(){ return size; } -uint32_t FSFile::seek(uint32_t pos){ +uint32_t FSFile::seek(uint32_t pos) { if (! _file) return 0; return SPIFFS_lseek(&_filesystemStorageHandle, _file, pos, SPIFFS_SEEK_SET); } -uint32_t FSFile::position(){ +uint32_t FSFile::position() { if (! _file) return 0; return SPIFFS_tell(&_filesystemStorageHandle, _file); } -boolean FSFile::eof(){ +bool FSFile::eof() { if (! _file) return 0; return SPIFFS_eof(&_filesystemStorageHandle, _file); } -boolean FSFile::isDirectory(void){ +bool FSFile::isDirectory(void) { return false; } -int FSFile::read(void *buf, uint16_t nbyte){ +int FSFile::read(void *buf, uint16_t nbyte) { if (! _file) return -1; return SPIFFS_read(&_filesystemStorageHandle, _file, buf, nbyte); } -int FSFile::read(){ +int FSFile::read() { if (! _file) return -1; int val; if(SPIFFS_read(&_filesystemStorageHandle, _file, &val, 1) != 1) return -1; diff --git a/cores/esp8266/FileSystem.h b/cores/esp8266/FileSystem.h index 8704f260c..d675da114 100755 --- a/cores/esp8266/FileSystem.h +++ b/cores/esp8266/FileSystem.h @@ -29,7 +29,7 @@ class String; #define FSFILE_WRITE (SPIFFS_RDONLY | SPIFFS_WRONLY | SPIFFS_CREAT | SPIFFS_APPEND | SPIFFS_TRUNC) class FSFile : public Stream { - private: +private: spiffs_stat _stats; file_t _file; @@ -47,34 +47,29 @@ public: uint32_t remove(); uint32_t position(); uint32_t size(); - boolean eof(); + bool eof(); void close(); int lastError(); void clearError(); - operator bool(){ return _file > 0; } + operator bool() { return _file > 0; } char * name(); - boolean isDirectory(void); + bool isDirectory(void); template size_t write(T &src){ - uint8_t obuf[64]; - size_t doneLen = 0; - size_t sentLen; - int i; - - while (src.available() > 64){ - src.read(obuf, 64); - sentLen = write(obuf, 64); - doneLen = doneLen + sentLen; - if(sentLen != 64){ - return doneLen; + const size_t bufferSize = 64; + uint8_t obuf[bufferSize]; + size_t bytesWritten = 0; + while (true){ + size_t available = src.available(); + size_t willWrite = (available < bufferSize) ? available : bufferSize; + src.read(obuf, willWrite); + size_t cb = write(obuf, willWrite); + bytesWritten += cb; + if (cb != willWrite) { + return bytesWritten; } } - - size_t leftLen = src.available(); - src.read(obuf, leftLen); - sentLen = write(obuf, leftLen); - doneLen = doneLen + sentLen; - return doneLen; + return bytesWritten; } using Print::write; @@ -83,16 +78,16 @@ public: class FSClass { private: - boolean _mounted; + bool _mounted; public: - boolean mount(); + bool mount(); void unmount(); - boolean format(); - boolean exists(const char *filename); - boolean create(const char *filepath); - boolean remove(const char *filepath); - boolean rename(const char *filename, const char *newname); + bool format(); + bool exists(const char *filename); + bool create(const char *filepath); + bool remove(const char *filepath); + bool rename(const char *filename, const char *newname); FSFile open(const char *filename, uint8_t mode = FSFILE_READ); diff --git a/cores/esp8266/spiffs/spiffs.h b/cores/esp8266/spiffs/spiffs.h index ad922b4a8..6357b44a7 100755 --- a/cores/esp8266/spiffs/spiffs.h +++ b/cores/esp8266/spiffs/spiffs.h @@ -12,8 +12,6 @@ extern "C" { #endif -//#include "c_stdio.h" -#include #include "spiffs_config.h" #include "flashmem.h" From 44431bf9df95ba15930881f40fde5204090fe2ce Mon Sep 17 00:00:00 2001 From: ficeto Date: Thu, 14 May 2015 15:49:17 +0300 Subject: [PATCH 23/78] add toolchain to ignore --- .gitignore | 2 ++ 1 file changed, 2 insertions(+) diff --git a/.gitignore b/.gitignore index 4400c7eb4..44f4cda8b 100644 --- a/.gitignore +++ b/.gitignore @@ -58,3 +58,5 @@ avr-toolchain-*.zip /hardware/tools/listComPorts.exe build/macosx/esptool-*-osx.zip + +build/macosx/dist/osx-xtensa-lx106-elf.tgz From 261865cf6f2792316b2e3d0b46ff7573806b7402 Mon Sep 17 00:00:00 2001 From: ficeto Date: Thu, 14 May 2015 16:08:16 +0300 Subject: [PATCH 24/78] fix FSFile template --- cores/esp8266/FileSystem.h | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/cores/esp8266/FileSystem.h b/cores/esp8266/FileSystem.h index d675da114..7a4563357 100755 --- a/cores/esp8266/FileSystem.h +++ b/cores/esp8266/FileSystem.h @@ -61,13 +61,15 @@ public: size_t bytesWritten = 0; while (true){ size_t available = src.available(); + if(!available) + return bytesWritten; size_t willWrite = (available < bufferSize) ? available : bufferSize; src.read(obuf, willWrite); size_t cb = write(obuf, willWrite); - bytesWritten += cb; if (cb != willWrite) { return bytesWritten; } + bytesWritten += cb; } return bytesWritten; } From c25ca1785dfb8346692ede7fdaad16654bb1fa85 Mon Sep 17 00:00:00 2001 From: ficeto Date: Thu, 14 May 2015 16:28:55 +0300 Subject: [PATCH 25/78] make sure write return a positive or zero value --- cores/esp8266/FileSystem.cpp | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/cores/esp8266/FileSystem.cpp b/cores/esp8266/FileSystem.cpp index f2517cf98..d94af10ac 100755 --- a/cores/esp8266/FileSystem.cpp +++ b/cores/esp8266/FileSystem.cpp @@ -162,7 +162,8 @@ int FSFile::available() { size_t FSFile::write(const uint8_t *buf, size_t size){ if (! _file) return 0; - return SPIFFS_write(&_filesystemStorageHandle, _file, (uint8_t *)buf, size); + int res = SPIFFS_write(&_filesystemStorageHandle, _file, (uint8_t *)buf, size); + return (res > 0)?res:0; } size_t FSFile::write(uint8_t val) { From c660de2029d9e1824993bfb36368c958404291eb Mon Sep 17 00:00:00 2001 From: ficeto Date: Thu, 14 May 2015 16:31:34 +0300 Subject: [PATCH 26/78] cast it --- cores/esp8266/FileSystem.cpp | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/cores/esp8266/FileSystem.cpp b/cores/esp8266/FileSystem.cpp index d94af10ac..ce722e7ec 100755 --- a/cores/esp8266/FileSystem.cpp +++ b/cores/esp8266/FileSystem.cpp @@ -163,7 +163,7 @@ int FSFile::available() { size_t FSFile::write(const uint8_t *buf, size_t size){ if (! _file) return 0; int res = SPIFFS_write(&_filesystemStorageHandle, _file, (uint8_t *)buf, size); - return (res > 0)?res:0; + return (res > 0)?(size_t)res:0; } size_t FSFile::write(uint8_t val) { From d56e5691fce87741245bb209def9c0744b8cea7f Mon Sep 17 00:00:00 2001 From: ficeto Date: Thu, 14 May 2015 16:37:13 +0300 Subject: [PATCH 27/78] blah --- cores/esp8266/FileSystem.h | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/cores/esp8266/FileSystem.h b/cores/esp8266/FileSystem.h index 7a4563357..460595cf3 100755 --- a/cores/esp8266/FileSystem.h +++ b/cores/esp8266/FileSystem.h @@ -80,7 +80,7 @@ public: class FSClass { private: - bool _mounted; + bool _mounted = false; public: bool mount(); From 676193f47ec3e6de27bb681d00875ab5de3f0c04 Mon Sep 17 00:00:00 2001 From: ficeto Date: Thu, 14 May 2015 17:20:15 +0300 Subject: [PATCH 28/78] mount spiffs on boot --- cores/esp8266/core_esp8266_wiring.c | 1 + 1 file changed, 1 insertion(+) diff --git a/cores/esp8266/core_esp8266_wiring.c b/cores/esp8266/core_esp8266_wiring.c index 0170b4bcf..67c47514c 100644 --- a/cores/esp8266/core_esp8266_wiring.c +++ b/cores/esp8266/core_esp8266_wiring.c @@ -78,4 +78,5 @@ void init() { timer1_isr_init(); os_timer_setfn(µs_overflow_timer, (os_timer_func_t*) µs_overflow_tick, 0); os_timer_arm(µs_overflow_timer, 60000, REPEAT); + spiffs_mount(); } From a911438c53743387dd2f4e69a77caa8ee70a0530 Mon Sep 17 00:00:00 2001 From: ficeto Date: Thu, 14 May 2015 19:10:05 +0300 Subject: [PATCH 29/78] add flash frequency and mode options --- boards.txt | 33 ++++++++++++++++++++++++++++++++- 1 file changed, 32 insertions(+), 1 deletion(-) diff --git a/boards.txt b/boards.txt index 4190e6483..c95179c14 100644 --- a/boards.txt +++ b/boards.txt @@ -1,6 +1,8 @@ menu.UploadSpeed=Upload Speed menu.CpuFrequency=CPU Frequency -menu.FlashSize=Flash size +menu.FlashSize=Flash Size +menu.FlashFreq=Flash Frequency +menu.FlashMode=Flash Mode ############################################################## generic.name=Generic ESP8266 Module @@ -57,6 +59,35 @@ generic.menu.FlashSize.2M.build.flash_size=2M generic.menu.FlashSize.4M=4M generic.menu.FlashSize.4M.build.flash_size=4M +generic.menu.FlashSize.512K=512K +generic.menu.FlashSize.512K.build.flash_size=512K +generic.menu.FlashSize.256K=256K +generic.menu.FlashSize.256K.build.flash_size=256K +generic.menu.FlashSize.1M=1M +generic.menu.FlashSize.1M.build.flash_size=1M +generic.menu.FlashSize.2M=2M +generic.menu.FlashSize.2M.build.flash_size=2M +generic.menu.FlashSize.4M=4M +generic.menu.FlashSize.4M.build.flash_size=4M + +generic.menu.FlashFreq.40=40MHz +generic.menu.FlashFreq.40.build.flash_freq=40 +generic.menu.FlashFreq.20=20MHz +generic.menu.FlashFreq.20.build.flash_freq=20 +generic.menu.FlashFreq.26=26.7MHz +generic.menu.FlashFreq.26.build.flash_freq=26.7 +generic.menu.FlashFreq.80=80MHz +generic.menu.FlashFreq.80.build.flash_freq=80 + +generic.menu.FlashMode.qio=QIO +generic.menu.FlashMode.qio.build.flash_mode=qio +generic.menu.FlashMode.qout=QOUT +generic.menu.FlashMode.qout.build.flash_mode=qout +generic.menu.FlashMode.dio=DIO +generic.menu.FlashMode.dio.build.flash_mode=dio +generic.menu.FlashMode.dout=DOUT +generic.menu.FlashMode.dout.build.flash_mode=dout + ############################################################## modwifi.name=Olimex MOD-WIFI-ESP8266(-DEV) From 57c0d3e4bd549d8f03a532519a0cb0f7a737bd08 Mon Sep 17 00:00:00 2001 From: ficeto Date: Thu, 14 May 2015 19:17:53 +0300 Subject: [PATCH 30/78] double --- boards.txt | 11 ----------- 1 file changed, 11 deletions(-) diff --git a/boards.txt b/boards.txt index c95179c14..e598bb884 100644 --- a/boards.txt +++ b/boards.txt @@ -59,17 +59,6 @@ generic.menu.FlashSize.2M.build.flash_size=2M generic.menu.FlashSize.4M=4M generic.menu.FlashSize.4M.build.flash_size=4M -generic.menu.FlashSize.512K=512K -generic.menu.FlashSize.512K.build.flash_size=512K -generic.menu.FlashSize.256K=256K -generic.menu.FlashSize.256K.build.flash_size=256K -generic.menu.FlashSize.1M=1M -generic.menu.FlashSize.1M.build.flash_size=1M -generic.menu.FlashSize.2M=2M -generic.menu.FlashSize.2M.build.flash_size=2M -generic.menu.FlashSize.4M=4M -generic.menu.FlashSize.4M.build.flash_size=4M - generic.menu.FlashFreq.40=40MHz generic.menu.FlashFreq.40.build.flash_freq=40 generic.menu.FlashFreq.20=20MHz From b4a8bb0653311c8befebf2e011d310da11f32440 Mon Sep 17 00:00:00 2001 From: Markus Sattler Date: Thu, 14 May 2015 21:41:43 +0200 Subject: [PATCH 31/78] fix bug when TX buffer is full and os will write. in this case we hang endless or until wtd triggers. new: now we overdrive the data in FIFO --> no hang / crash but we loss chars. only happens by extensive use of os_printf! --- cores/esp8266/HardwareSerial.cpp | 36 ++++++++++++++++++-------------- 1 file changed, 20 insertions(+), 16 deletions(-) diff --git a/cores/esp8266/HardwareSerial.cpp b/cores/esp8266/HardwareSerial.cpp index 87fd6dfbb..bdcd45716 100644 --- a/cores/esp8266/HardwareSerial.cpp +++ b/cores/esp8266/HardwareSerial.cpp @@ -392,30 +392,34 @@ void uart_ignore_char(char c) { void uart0_write_char(char c) { if(&Serial != NULL && Serial.isTxEnabled()) { - if(c == '\n') { - Serial.write('\r'); + if(Serial.availableForWrite() > 0) { + if(c == '\n') { + Serial.write('\r'); + } + Serial.write(c); + return; } - Serial.write(c); - } else { - if(c == '\n') { - USF(0) = '\r'; - } - USF(0) = c; } + if(c == '\n') { + USF(0) = '\r'; + } + USF(0) = c; } void uart1_write_char(char c) { if(&Serial1 != NULL && Serial1.isTxEnabled()) { - if(c == '\n') { - Serial1.write('\r'); + if(Serial1.availableForWrite() > 0) { + if(c == '\n') { + Serial1.write('\r'); + } + Serial1.write(c); + return; } - Serial1.write(c); - } else { - if(c == '\n') { - USF(1) = '\r'; - } - USF(1) = c; } + if(c == '\n') { + USF(1) = '\r'; + } + USF(1) = c; } static int s_uart_debug_nr = UART0; From 0897f9e2e31dc61e54a9b25dd9f2cf0395aa8992 Mon Sep 17 00:00:00 2001 From: ficeto Date: Fri, 15 May 2015 02:22:00 +0300 Subject: [PATCH 32/78] fix reading bytes from incoming POST upload proper error and premature connection loss should be implemented to handle weird cases where we might not get the whole post content --- cores/esp8266/Arduino.h | 2 +- cores/esp8266/spiffs/spiffs_config.h | 1 - .../ESP8266WebServer/src/ESP8266WebServer.h | 1 + libraries/ESP8266WebServer/src/Parsing.cpp | 46 ++++++++++++------- 4 files changed, 31 insertions(+), 19 deletions(-) diff --git a/cores/esp8266/Arduino.h b/cores/esp8266/Arduino.h index bd5f79625..1170b6f4a 100644 --- a/cores/esp8266/Arduino.h +++ b/cores/esp8266/Arduino.h @@ -38,7 +38,7 @@ extern "C" { #include "pgmspace.h" #include "esp8266_peri.h" #include "twi.h" -#include "spiffs/spiffs.h" + //#include "spiffs/spiffs.h" void yield(void); diff --git a/cores/esp8266/spiffs/spiffs_config.h b/cores/esp8266/spiffs/spiffs_config.h index 3c55cf97f..095bef900 100755 --- a/cores/esp8266/spiffs/spiffs_config.h +++ b/cores/esp8266/spiffs/spiffs_config.h @@ -20,7 +20,6 @@ #include "stddef.h" #include "osapi.h" #include "ets_sys.h" -#include // ----------- >8 ------------ #define IRAM_ATTR __attribute__((section(".iram.text"))) #define STORE_TYPEDEF_ATTR __attribute__((aligned(4),packed)) diff --git a/libraries/ESP8266WebServer/src/ESP8266WebServer.h b/libraries/ESP8266WebServer/src/ESP8266WebServer.h index 8f70bd621..375d09600 100644 --- a/libraries/ESP8266WebServer/src/ESP8266WebServer.h +++ b/libraries/ESP8266WebServer/src/ESP8266WebServer.h @@ -83,6 +83,7 @@ protected: static const char* _responseCodeToString(int code); void _parseForm(WiFiClient& client, String boundary, uint32_t len); void _uploadWriteByte(uint8_t b); + uint8_t _uploadReadByte(WiFiClient& client); struct RequestHandler; struct RequestArgument { diff --git a/libraries/ESP8266WebServer/src/Parsing.cpp b/libraries/ESP8266WebServer/src/Parsing.cpp index d2f0ee762..40a58d24a 100644 --- a/libraries/ESP8266WebServer/src/Parsing.cpp +++ b/libraries/ESP8266WebServer/src/Parsing.cpp @@ -214,12 +214,22 @@ void ESP8266WebServer::_uploadWriteByte(uint8_t b){ _currentUpload.buf[_currentUpload.currentSize++] = b; } +uint8_t ESP8266WebServer::_uploadReadByte(WiFiClient& client){ + int res = client.read(); + if(res == -1){ + while(!client.available()) + yield(); + res = client.read(); + } + return (uint8_t)res; +} + void ESP8266WebServer::_parseForm(WiFiClient& client, String boundary, uint32_t len){ #ifdef DEBUG DEBUG_OUTPUT.print("Parse Form: Boundary: "); DEBUG_OUTPUT.print(boundary); - DEBUG_OUTPUT.print("Length: "); + DEBUG_OUTPUT.print(" Length: "); DEBUG_OUTPUT.println(len); #endif String line; @@ -249,17 +259,17 @@ void ESP8266WebServer::_parseForm(WiFiClient& client, String boundary, uint32_t argFilename = argName.substring(nameStart+2, argName.length() - 1); argName = argName.substring(0, argName.indexOf('"')); argIsFile = true; - #ifdef DEBUG +#ifdef DEBUG DEBUG_OUTPUT.print("PostArg FileName: "); DEBUG_OUTPUT.println(argFilename); - #endif +#endif //use GET to set the filename if uploading using blob if (argFilename == "blob" && hasArg("filename")) argFilename = arg("filename"); } - #ifdef DEBUG +#ifdef DEBUG DEBUG_OUTPUT.print("PostArg Name: "); DEBUG_OUTPUT.println(argName); - #endif +#endif argType = "text/plain"; line = client.readStringUntil('\r'); client.readStringUntil('\n'); @@ -269,10 +279,10 @@ void ESP8266WebServer::_parseForm(WiFiClient& client, String boundary, uint32_t client.readStringUntil('\r'); client.readStringUntil('\n'); } - #ifdef DEBUG +#ifdef DEBUG DEBUG_OUTPUT.print("PostArg Type: "); DEBUG_OUTPUT.println(argType); - #endif +#endif if (!argIsFile){ while(1){ line = client.readStringUntil('\r'); @@ -281,20 +291,20 @@ void ESP8266WebServer::_parseForm(WiFiClient& client, String boundary, uint32_t if (argValue.length() > 0) argValue += "\n"; argValue += line; } - #ifdef DEBUG +#ifdef DEBUG DEBUG_OUTPUT.print("PostArg Value: "); DEBUG_OUTPUT.println(argValue); DEBUG_OUTPUT.println(); - #endif +#endif RequestArgument& arg = postArgs[postArgsLen++]; arg.key = argName; arg.value = argValue; if (line == ("--"+boundary+"--")){ - #ifdef DEBUG +#ifdef DEBUG DEBUG_OUTPUT.println("Done Parsing POST"); - #endif +#endif break; } } else { @@ -312,23 +322,23 @@ void ESP8266WebServer::_parseForm(WiFiClient& client, String boundary, uint32_t #endif if (_fileUploadHandler) _fileUploadHandler(); _currentUpload.status = UPLOAD_FILE_WRITE; - uint8_t argByte = client.read(); + uint8_t argByte = _uploadReadByte(client); readfile: while(argByte != 0x0D){ _uploadWriteByte(argByte); - argByte = client.read(); + argByte = _uploadReadByte(client); } - argByte = client.read(); + argByte = _uploadReadByte(client); if (argByte == 0x0A){ - argByte = client.read(); + argByte = _uploadReadByte(client); if ((char)argByte != '-'){ //continue reading the file _uploadWriteByte(0x0D); _uploadWriteByte(0x0A); goto readfile; } else { - argByte = client.read(); + argByte = _uploadReadByte(client); if ((char)argByte != '-'){ //continue reading the file _uploadWriteByte(0x0D); @@ -366,11 +376,13 @@ readfile: } else { _uploadWriteByte(0x0D); _uploadWriteByte(0x0A); + _uploadWriteByte((uint8_t)('-')); + _uploadWriteByte((uint8_t)('-')); uint32_t i = 0; while(i < boundary.length()){ _uploadWriteByte(endBuf[i++]); } - argByte = client.read(); + argByte = _uploadReadByte(client); goto readfile; } } else { From 8153edb550fd5d631b17c4df764570f861b6a4a4 Mon Sep 17 00:00:00 2001 From: ficeto Date: Fri, 15 May 2015 13:54:42 +0300 Subject: [PATCH 33/78] use WDT_RESET macro in spiffs_flashmem methods --- cores/esp8266/spiffs/spiffs_flashmem.c | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/cores/esp8266/spiffs/spiffs_flashmem.c b/cores/esp8266/spiffs/spiffs_flashmem.c index d2ad74cc0..3caaaa99e 100755 --- a/cores/esp8266/spiffs/spiffs_flashmem.c +++ b/cores/esp8266/spiffs/spiffs_flashmem.c @@ -184,7 +184,7 @@ uint32_t flashmem_write_internal( const void *from, uint32_t toaddr, uint32_t si return 0; os_memcpy(apbuf, from, size); } - WRITE_PERI_REG(0x60000914, 0x73); + WDT_RESET(); r = spi_flash_write(toaddr, apbuf?(uint32 *)apbuf:(uint32 *)from, size); if(apbuf) os_free(apbuf); @@ -200,7 +200,7 @@ uint32_t flashmem_read_internal( void *to, uint32_t fromaddr, uint32_t size ) { fromaddr -= INTERNAL_FLASH_START_ADDRESS; SpiFlashOpResult r; - WRITE_PERI_REG(0x60000914, 0x73); + WDT_RESET(); r = spi_flash_read(fromaddr, (uint32 *)to, size); if(SPI_FLASH_RESULT_OK == r) return size; From 2eea25873dbc2bc57aa9f6ff6f2c74f2eff855f2 Mon Sep 17 00:00:00 2001 From: Markus Sattler Date: Fri, 15 May 2015 13:42:30 +0200 Subject: [PATCH 34/78] fix SPI speed calculation @160Mhz Clock --- libraries/SPI/SPI.cpp | 6 +++--- libraries/SPI/SPI.h | 2 ++ 2 files changed, 5 insertions(+), 3 deletions(-) diff --git a/libraries/SPI/SPI.cpp b/libraries/SPI/SPI.cpp index c96c4fcb8..7d52528ef 100644 --- a/libraries/SPI/SPI.cpp +++ b/libraries/SPI/SPI.cpp @@ -121,14 +121,14 @@ void SPIClass::setBitOrder(uint8_t bitOrder) { * @return */ static uint32_t ClkRegToFreq(spiClk_t * reg) { - return (F_CPU / ((reg->regPre + 1) * (reg->regN + 1))); + return (SPI_MAX_SPEED / ((reg->regPre + 1) * (reg->regN + 1))); } void SPIClass::setFrequency(uint32_t freq) { static uint32_t lastSetFrequency = 0; static uint32_t lastSetRegister = 0; - if(freq >= F_CPU) { + if(freq >= SPI_MAX_SPEED) { setClockDivider(0x80000000); return; } @@ -164,7 +164,7 @@ void SPIClass::setFrequency(uint32_t freq) { reg.regN = calN; while(calPreVari++ <= 1) { // test different variants for Pre (we calculate in int so we miss the decimals, testing is the easyest and fastest way) - calPre = (((F_CPU / (reg.regN + 1)) / freq) - 1) + calPreVari; + calPre = (((SPI_MAX_SPEED / (reg.regN + 1)) / freq) - 1) + calPreVari; if(calPre > 0x1FFF) { reg.regPre = 0x1FFF; // 8191 } else if(calPre <= 0) { diff --git a/libraries/SPI/SPI.h b/libraries/SPI/SPI.h index e67b5b0d5..68d2a3dc6 100644 --- a/libraries/SPI/SPI.h +++ b/libraries/SPI/SPI.h @@ -45,6 +45,8 @@ #define SPI_CLOCK_DIV64 0x04fc1001 //250 KHz #endif +#define SPI_MAX_SPEED (80000000L) + const uint8_t SPI_MODE0 = 0x00; ///< CPOL: 0 CPHA: 0 const uint8_t SPI_MODE1 = 0x01; ///< CPOL: 0 CPHA: 1 const uint8_t SPI_MODE2 = 0x10; ///< CPOL: 1 CPHA: 0 From 540fdb0f8c6e73df2aec8bfba4b190d64cda32e0 Mon Sep 17 00:00:00 2001 From: ficeto Date: Fri, 15 May 2015 15:36:09 +0300 Subject: [PATCH 35/78] add flash splits depending on the flash size --- boards.txt | 9 +++++++++ cores/esp8266/spiffs/spiffs_flashmem.c | 1 + platform.txt | 3 +-- 3 files changed, 11 insertions(+), 2 deletions(-) diff --git a/boards.txt b/boards.txt index e598bb884..4d6c41515 100644 --- a/boards.txt +++ b/boards.txt @@ -23,6 +23,7 @@ generic.build.variant=generic generic.build.flash_mode=qio generic.build.flash_size=512K generic.build.flash_freq=40 +generic.build.flash_ld=eagle.flash.512k.ld generic.menu.CpuFrequency.80=80 MHz generic.menu.CpuFrequency.80.build.f_cpu=80000000L @@ -50,14 +51,19 @@ generic.menu.UploadSpeed.921600.upload.speed=921600 generic.menu.FlashSize.512K=512K generic.menu.FlashSize.512K.build.flash_size=512K +generic.menu.FlashSize.512K.build.flash_ld=eagle.flash.512k.ld generic.menu.FlashSize.256K=256K generic.menu.FlashSize.256K.build.flash_size=256K +generic.menu.FlashSize.256K.build.flash_ld=eagle.flash.256k.ld generic.menu.FlashSize.1M=1M generic.menu.FlashSize.1M.build.flash_size=1M +generic.menu.FlashSize.1M.build.flash_ld=eagle.flash.1m.ld generic.menu.FlashSize.2M=2M generic.menu.FlashSize.2M.build.flash_size=2M +generic.menu.FlashSize.2M.build.flash_ld=eagle.flash.2m.ld generic.menu.FlashSize.4M=4M generic.menu.FlashSize.4M.build.flash_size=4M +generic.menu.FlashSize.4M.build.flash_ld=eagle.flash.4m.ld generic.menu.FlashFreq.40=40MHz generic.menu.FlashFreq.40.build.flash_freq=40 @@ -97,6 +103,7 @@ modwifi.build.variant=generic modwifi.build.flash_mode=qio modwifi.build.flash_size=2M modwifi.build.flash_freq=40 +modwifi.build.flash_ld=eagle.flash.2m.ld modwifi.menu.CpuFrequency.80=80 MHz modwifi.menu.CpuFrequency.80.build.f_cpu=80000000L @@ -142,6 +149,7 @@ nodemcu.build.variant=nodemcu nodemcu.build.flash_mode=qio nodemcu.build.flash_size=4M nodemcu.build.flash_freq=40 +nodemcu.build.flash_ld=eagle.flash.4m.ld nodemcu.menu.CpuFrequency.80=80 MHz nodemcu.menu.CpuFrequency.80.build.f_cpu=80000000L @@ -188,6 +196,7 @@ nodemcu.menu.FlashSize.4M.build.flash_size=4M # wifio.build.flash_mode=qio # wifio.build.flash_size=512K # wifio.build.flash_freq=40 +# wifio.build.flash_ld=eagle.flash.512k.ld # # wifio.menu.CpuFrequency.80=80MHz # wifio.menu.CpuFrequency.80.build.f_cpu=80000000L diff --git a/cores/esp8266/spiffs/spiffs_flashmem.c b/cores/esp8266/spiffs/spiffs_flashmem.c index 3caaaa99e..156e2fac2 100755 --- a/cores/esp8266/spiffs/spiffs_flashmem.c +++ b/cores/esp8266/spiffs/spiffs_flashmem.c @@ -1,4 +1,5 @@ #include "flashmem.h" +#include "esp8266_peri.h" // Based on NodeMCU platform_flash // https://github.com/nodemcu/nodemcu-firmware diff --git a/platform.txt b/platform.txt index cd09aff98..bc4b20927 100644 --- a/platform.txt +++ b/platform.txt @@ -20,8 +20,7 @@ compiler.c.flags=-c -Os -Wpointer-arith -Wno-implicit-function-declaration -Wl,- compiler.S.cmd=xtensa-lx106-elf-gcc compiler.S.flags=-c -g -x assembler-with-cpp -MMD -compiler.c.elf.ldscript=eagle.app.v6.ld -compiler.c.elf.flags=-nostdlib -Wl,--no-check-sections -u call_user_start -Wl,-static "-L{compiler.sdk.path}/lib" "-L{compiler.sdk.path}/ld" "-T{compiler.c.elf.ldscript}" +compiler.c.elf.flags=-nostdlib -Wl,--no-check-sections -u call_user_start -Wl,-static "-L{compiler.sdk.path}/lib" "-L{compiler.sdk.path}/ld" "-T{build.flash_ld}" compiler.c.elf.cmd=xtensa-lx106-elf-gcc compiler.c.elf.libs=-lm -lgcc -lhal -lphy -lnet80211 -llwip -lwpa -lmain -lpp -lsmartconfig From ea9368c88dadd6b16f2ef606d8ab6282de096a42 Mon Sep 17 00:00:00 2001 From: ficeto Date: Fri, 15 May 2015 20:06:13 +0300 Subject: [PATCH 36/78] enhance board flash handling and eeprom location --- boards.txt | 68 ++++++++++++++++++++++--------------- libraries/EEPROM/EEPROM.cpp | 3 +- 2 files changed, 43 insertions(+), 28 deletions(-) diff --git a/boards.txt b/boards.txt index 4d6c41515..77f263cc6 100644 --- a/boards.txt +++ b/boards.txt @@ -2,7 +2,6 @@ menu.UploadSpeed=Upload Speed menu.CpuFrequency=CPU Frequency menu.FlashSize=Flash Size menu.FlashFreq=Flash Frequency -menu.FlashMode=Flash Mode ############################################################## generic.name=Generic ESP8266 Module @@ -24,6 +23,8 @@ generic.build.flash_mode=qio generic.build.flash_size=512K generic.build.flash_freq=40 generic.build.flash_ld=eagle.flash.512k.ld +generic.build.spiffs_start=0x6B000 +generic.build.spiffs_end=0x7B000 generic.menu.CpuFrequency.80=80 MHz generic.menu.CpuFrequency.80.build.f_cpu=80000000L @@ -49,39 +50,46 @@ generic.menu.UploadSpeed.512000.upload.speed=512000 generic.menu.UploadSpeed.921600=921600 generic.menu.UploadSpeed.921600.upload.speed=921600 -generic.menu.FlashSize.512K=512K +generic.menu.FlashSize.512K=512K (64K SPIFFS) generic.menu.FlashSize.512K.build.flash_size=512K generic.menu.FlashSize.512K.build.flash_ld=eagle.flash.512k.ld -generic.menu.FlashSize.256K=256K -generic.menu.FlashSize.256K.build.flash_size=256K -generic.menu.FlashSize.256K.build.flash_ld=eagle.flash.256k.ld -generic.menu.FlashSize.1M=1M -generic.menu.FlashSize.1M.build.flash_size=1M -generic.menu.FlashSize.1M.build.flash_ld=eagle.flash.1m.ld -generic.menu.FlashSize.2M=2M +generic.menu.FlashSize.512K.build.spiffs_start=0x6B000 +generic.menu.FlashSize.512K.build.spiffs_end=0x7B000 +generic.menu.FlashSize.1M512=1M (512K SPIFFS) +generic.menu.FlashSize.1M512.build.flash_size=1M +generic.menu.FlashSize.1M512.build.flash_ld=eagle.flash.1m512.ld +generic.menu.FlashSize.1M512.build.spiffs_start=0x6B000 +generic.menu.FlashSize.1M512.build.spiffs_end=0xFB000 +generic.menu.FlashSize.1M256=1M (256K SPIFFS) +generic.menu.FlashSize.1M256.build.flash_size=1M +generic.menu.FlashSize.1M256.build.flash_ld=eagle.flash.1m256.ld +generic.menu.FlashSize.1M256.build.spiffs_start=0xAB000 +generic.menu.FlashSize.1M256.build.spiffs_end=0xFB000 +generic.menu.FlashSize.1M128=1M (128K SPIFFS) +generic.menu.FlashSize.1M128.build.flash_size=1M +generic.menu.FlashSize.1M128.build.flash_ld=eagle.flash.1m128.ld +generic.menu.FlashSize.1M128.build.spiffs_start=0xCB000 +generic.menu.FlashSize.1M128.build.spiffs_end=0xFB000 +generic.menu.FlashSize.1M64=1M (64K SPIFFS) +generic.menu.FlashSize.1M64.build.flash_size=1M +generic.menu.FlashSize.1M64.build.flash_ld=eagle.flash.1m64.ld +generic.menu.FlashSize.1M64.build.spiffs_start=0xEB000 +generic.menu.FlashSize.1M64.build.spiffs_end=0xFB000 +generic.menu.FlashSize.2M=2M (1M SPIFFS) generic.menu.FlashSize.2M.build.flash_size=2M generic.menu.FlashSize.2M.build.flash_ld=eagle.flash.2m.ld -generic.menu.FlashSize.4M=4M +generic.menu.FlashSize.2M.build.spiffs_start=0x100000 +generic.menu.FlashSize.2M.build.spiffs_end=0x1FB000 +generic.menu.FlashSize.4M=4M (3M SPIFFS) generic.menu.FlashSize.4M.build.flash_size=4M generic.menu.FlashSize.4M.build.flash_ld=eagle.flash.4m.ld +generic.menu.FlashSize.4M.build.spiffs_start=0x100000 +generic.menu.FlashSize.4M.build.spiffs_end=0x3FB000 -generic.menu.FlashFreq.40=40MHz -generic.menu.FlashFreq.40.build.flash_freq=40 -generic.menu.FlashFreq.20=20MHz -generic.menu.FlashFreq.20.build.flash_freq=20 -generic.menu.FlashFreq.26=26.7MHz -generic.menu.FlashFreq.26.build.flash_freq=26.7 -generic.menu.FlashFreq.80=80MHz -generic.menu.FlashFreq.80.build.flash_freq=80 - -generic.menu.FlashMode.qio=QIO -generic.menu.FlashMode.qio.build.flash_mode=qio -generic.menu.FlashMode.qout=QOUT -generic.menu.FlashMode.qout.build.flash_mode=qout -generic.menu.FlashMode.dio=DIO -generic.menu.FlashMode.dio.build.flash_mode=dio -generic.menu.FlashMode.dout=DOUT -generic.menu.FlashMode.dout.build.flash_mode=dout +# generic.menu.FlashFreq.40=40MHz +# generic.menu.FlashFreq.40.build.flash_freq=40 +# generic.menu.FlashFreq.80=80MHz +# generic.menu.FlashFreq.80.build.flash_freq=80 ############################################################## modwifi.name=Olimex MOD-WIFI-ESP8266(-DEV) @@ -104,6 +112,8 @@ modwifi.build.flash_mode=qio modwifi.build.flash_size=2M modwifi.build.flash_freq=40 modwifi.build.flash_ld=eagle.flash.2m.ld +modwifi.build.spiffs_start=0x100000 +modwifi.build.spiffs_end=0x1FB000 modwifi.menu.CpuFrequency.80=80 MHz modwifi.menu.CpuFrequency.80.build.f_cpu=80000000L @@ -150,6 +160,8 @@ nodemcu.build.flash_mode=qio nodemcu.build.flash_size=4M nodemcu.build.flash_freq=40 nodemcu.build.flash_ld=eagle.flash.4m.ld +nodemcu.build.spiffs_start=0x100000 +nodemcu.build.spiffs_end=0x3FB000 nodemcu.menu.CpuFrequency.80=80 MHz nodemcu.menu.CpuFrequency.80.build.f_cpu=80000000L @@ -197,6 +209,8 @@ nodemcu.menu.FlashSize.4M.build.flash_size=4M # wifio.build.flash_size=512K # wifio.build.flash_freq=40 # wifio.build.flash_ld=eagle.flash.512k.ld +# wifio.build.spiffs_start=0x6B000 +# wifio.build.spiffs_end=0x7B000 # # wifio.menu.CpuFrequency.80=80MHz # wifio.menu.CpuFrequency.80.build.f_cpu=80000000L diff --git a/libraries/EEPROM/EEPROM.cpp b/libraries/EEPROM/EEPROM.cpp index 74e7f3b0f..14c6201f5 100644 --- a/libraries/EEPROM/EEPROM.cpp +++ b/libraries/EEPROM/EEPROM.cpp @@ -28,9 +28,10 @@ #include "os_type.h" #include "osapi.h" #include "spi_flash.h" +extern uint32_t _SPIFFS_end; } -#define CONFIG_START_SECTOR 0x7b +#define CONFIG_START_SECTOR (((uint32_t)_SPIFFS_end - 0x40200000) / 4096) #define CONFIG_SECTOR (CONFIG_START_SECTOR + 0) #define CONFIG_ADDR (SPI_FLASH_SEC_SIZE * CONFIG_SECTOR) From 42f1da6b1f37d02d9bdc44a8f09935bf6f5dc558 Mon Sep 17 00:00:00 2001 From: ficeto Date: Fri, 15 May 2015 20:07:55 +0300 Subject: [PATCH 37/78] not needed menu item --- boards.txt | 3 --- 1 file changed, 3 deletions(-) diff --git a/boards.txt b/boards.txt index 77f263cc6..c1aad78e6 100644 --- a/boards.txt +++ b/boards.txt @@ -188,9 +188,6 @@ nodemcu.menu.UploadSpeed.512000.upload.speed=512000 nodemcu.menu.UploadSpeed.921600=921600 nodemcu.menu.UploadSpeed.921600.upload.speed=921600 -nodemcu.menu.FlashSize.4M=4M -nodemcu.menu.FlashSize.4M.build.flash_size=4M - ############################################################## # wifio.name=Wifio # From 1cd9cd312f36d63c7bedb811fb240d7b3cbecc2e Mon Sep 17 00:00:00 2001 From: ficeto Date: Sat, 16 May 2015 02:29:26 +0300 Subject: [PATCH 38/78] add folder api for SPIFFS --- cores/esp8266/FileSystem.cpp | 115 +++++++++++------- cores/esp8266/FileSystem.h | 9 +- .../ESP8266WebServer/src/ESP8266WebServer.h | 14 +++ 3 files changed, 95 insertions(+), 43 deletions(-) diff --git a/cores/esp8266/FileSystem.cpp b/cores/esp8266/FileSystem.cpp index ce722e7ec..1abd5dc9f 100755 --- a/cores/esp8266/FileSystem.cpp +++ b/cores/esp8266/FileSystem.cpp @@ -41,6 +41,10 @@ bool FSClass::format() { return spiffs_format(); } +bool FSClass::check() { + return SPIFFS_check(&_filesystemStorageHandle) == 0; +} + bool FSClass::exists(const char *filename) { spiffs_stat stat = {0}; if (SPIFFS_stat(&_filesystemStorageHandle, filename, &stat) < 0) @@ -61,6 +65,7 @@ bool FSClass::rename(const char *filename, const char *newname) { } FSFile FSClass::open(const char *filename, uint8_t mode) { + if(String(filename) == "" || String(filename) == "/") return FSFile("/"); int repeats = 0; bool notExist; bool canRecreate = (mode & SPIFFS_CREAT) == SPIFFS_CREAT; @@ -84,6 +89,14 @@ FSFile FSClass::open(const char *filename, uint8_t mode) { return FSFile(); } +FSFile FSClass::open(spiffs_dirent* entry, uint8_t mode){ + int res = SPIFFS_open_by_dirent(&_filesystemStorageHandle, entry, (spiffs_flags)mode, 0); + if(res){ + return FSFile(res); + } + return FSFile(); +} + FSClass FS; FSFile::FSFile() { @@ -91,88 +104,125 @@ FSFile::FSFile() { _stats = {0}; } +FSFile::FSFile(String path) { + if(path == "/"){ + _file = 0x1; + os_sprintf((char*)_stats.name, "%s", (char*)path.c_str()); + _stats.size = 0; + _stats.type = SPIFFS_TYPE_DIR; + SPIFFS_opendir(&_filesystemStorageHandle, (char*)_stats.name, &_dir); + } else { + _file = SPIFFS_open(&_filesystemStorageHandle, path.c_str(), (spiffs_flags)FSFILE_READ, 0); + if(SPIFFS_fstat(&_filesystemStorageHandle, _file, &_stats) != 0){ + debugf("stats errno %d\n", SPIFFS_errno(&_filesystemStorageHandle)); + } + debugf("FSFile name: %s, size: %d, type: %d\n", _stats.name, _stats.size, _stats.type); + if(_stats.type == SPIFFS_TYPE_DIR){ + SPIFFS_opendir(&_filesystemStorageHandle, (char*)_stats.name, &_dir); + } + } +} + FSFile::FSFile(file_t f) { _file = f; if(SPIFFS_fstat(&_filesystemStorageHandle, _file, &_stats) != 0){ - debugf("mount errno %d\n", SPIFFS_errno(&_filesystemStorageHandle)); + debugf("stats errno %d\n", SPIFFS_errno(&_filesystemStorageHandle)); + } + debugf("FSFile name: %s, size: %d, type: %d\n", _stats.name, _stats.size, _stats.type); + if(_stats.type == SPIFFS_TYPE_DIR){ + SPIFFS_opendir(&_filesystemStorageHandle, (char*)_stats.name, &_dir); } } void FSFile::close() { if (! _file) return; - SPIFFS_close(&_filesystemStorageHandle, _file); + if(_stats.type == SPIFFS_TYPE_DIR){ + SPIFFS_closedir(&_dir); + } + if(os_strlen((char*)_stats.name) > 1) + SPIFFS_close(&_filesystemStorageHandle, _file); _file = 0; } +void FSFile::rewindDirectory() { + if (! _file || !isDirectory()) return; + SPIFFS_closedir(&_dir); + SPIFFS_opendir(&_filesystemStorageHandle, (char*)_stats.name, &_dir); +} + +FSFile FSFile::openNextFile(){ + if (! _file || !isDirectory()) return FSFile(); + struct spiffs_dirent e; + struct spiffs_dirent *pe = &e; + if ((pe = SPIFFS_readdir(&_dir, pe))){ + return FS.open((char *)pe->name); + } + return FSFile(); +} + uint32_t FSFile::size() { if(! _file) return 0; - uint32_t pos = SPIFFS_tell(&_filesystemStorageHandle, _file); - SPIFFS_lseek(&_filesystemStorageHandle, _file, 0, SPIFFS_SEEK_END); - uint32_t size = SPIFFS_tell(&_filesystemStorageHandle, _file); - SPIFFS_lseek(&_filesystemStorageHandle, _file, pos, SPIFFS_SEEK_SET); - return size; + if(SPIFFS_fstat(&_filesystemStorageHandle, _file, &_stats) != 0) return 0; + return _stats.size; } uint32_t FSFile::seek(uint32_t pos) { - if (! _file) return 0; + if (! _file || isDirectory()) return 0; return SPIFFS_lseek(&_filesystemStorageHandle, _file, pos, SPIFFS_SEEK_SET); } uint32_t FSFile::position() { - if (! _file) return 0; + if (! _file || isDirectory()) return 0; return SPIFFS_tell(&_filesystemStorageHandle, _file); } bool FSFile::eof() { - if (! _file) return 0; + if (! _file || isDirectory()) return 0; return SPIFFS_eof(&_filesystemStorageHandle, _file); } bool FSFile::isDirectory(void) { - return false; + return _stats.type == SPIFFS_TYPE_DIR; } int FSFile::read(void *buf, uint16_t nbyte) { - if (! _file) return -1; + if (! _file || isDirectory()) return -1; return SPIFFS_read(&_filesystemStorageHandle, _file, buf, nbyte); } int FSFile::read() { - if (! _file) return -1; + if (! _file || isDirectory()) return -1; int val; if(SPIFFS_read(&_filesystemStorageHandle, _file, &val, 1) != 1) return -1; return val; } int FSFile::peek() { - if (! _file) return 0; + if (! _file || isDirectory()) return 0; int c = read(); SPIFFS_lseek(&_filesystemStorageHandle, _file, -1, SPIFFS_SEEK_CUR); return c; } int FSFile::available() { - if (! _file) return 0; + if (! _file || isDirectory()) return 0; uint32_t pos = SPIFFS_tell(&_filesystemStorageHandle, _file); - SPIFFS_lseek(&_filesystemStorageHandle, _file, 0, SPIFFS_SEEK_END); - uint32_t size = SPIFFS_tell(&_filesystemStorageHandle, _file); - SPIFFS_lseek(&_filesystemStorageHandle, _file, pos, SPIFFS_SEEK_SET); - return size - pos; + return _stats.size - pos; } size_t FSFile::write(const uint8_t *buf, size_t size){ - if (! _file) return 0; + if (! _file || isDirectory()) return 0; int res = SPIFFS_write(&_filesystemStorageHandle, _file, (uint8_t *)buf, size); return (res > 0)?(size_t)res:0; } size_t FSFile::write(uint8_t val) { - if (! _file) return 0; + if (! _file || isDirectory()) return 0; return write(&val, 1); } void FSFile::flush(){ - if (! _file) return; + if (! _file || isDirectory()) return; SPIFFS_fflush(&_filesystemStorageHandle, _file); } @@ -191,24 +241,5 @@ void FSFile::clearError(){ } char * FSFile::name(){ - return 0; + return (char*)_stats.name; } - - - - - - -/* -spiffs_DIR *dirOpen(spiffs_DIR *d){ - return SPIFFS_opendir(&_filesystemStorageHandle, 0, d); -} - -int dirClose(spiffs_DIR *d){ - return SPIFFS_closedir(d); -} - -file_t dirOpenFile(spiffs_dirent* entry, uint8_t flags){ - return SPIFFS_open_by_dirent(&_filesystemStorageHandle, entry, (spiffs_flags)flags, 0); -} -*/ diff --git a/cores/esp8266/FileSystem.h b/cores/esp8266/FileSystem.h index 460595cf3..8956300c1 100755 --- a/cores/esp8266/FileSystem.h +++ b/cores/esp8266/FileSystem.h @@ -26,14 +26,17 @@ class String; #define FSFILE_READ SPIFFS_RDONLY -#define FSFILE_WRITE (SPIFFS_RDONLY | SPIFFS_WRONLY | SPIFFS_CREAT | SPIFFS_APPEND | SPIFFS_TRUNC) +#define FSFILE_WRITE (SPIFFS_RDWR | SPIFFS_CREAT | SPIFFS_APPEND | SPIFFS_DIRECT) +#define FSFILE_OVERWRITE (SPIFFS_RDWR | SPIFFS_CREAT | SPIFFS_APPEND | SPIFFS_TRUNC | SPIFFS_DIRECT) class FSFile : public Stream { private: spiffs_stat _stats; file_t _file; + spiffs_DIR _dir; public: + FSFile(String path); FSFile(file_t f); FSFile(void); virtual size_t write(uint8_t); @@ -54,6 +57,8 @@ public: operator bool() { return _file > 0; } char * name(); bool isDirectory(void); + void rewindDirectory(void); + FSFile openNextFile(void); template size_t write(T &src){ const size_t bufferSize = 64; @@ -86,12 +91,14 @@ public: bool mount(); void unmount(); bool format(); + bool check(); bool exists(const char *filename); bool create(const char *filepath); bool remove(const char *filepath); bool rename(const char *filename, const char *newname); FSFile open(const char *filename, uint8_t mode = FSFILE_READ); + FSFile open(spiffs_dirent* entry, uint8_t mode = FSFILE_READ); private: friend class FSFile; diff --git a/libraries/ESP8266WebServer/src/ESP8266WebServer.h b/libraries/ESP8266WebServer/src/ESP8266WebServer.h index 375d09600..d957e15ba 100644 --- a/libraries/ESP8266WebServer/src/ESP8266WebServer.h +++ b/libraries/ESP8266WebServer/src/ESP8266WebServer.h @@ -76,6 +76,20 @@ public: void sendHeader(String name, String value, bool first = false); void sendContent(String content); + +template size_t streamFile(T &file, String contentType){ + String head = "HTTP/1.1 200 OK\r\nContent-Type: "; + head += contentType; + head += "\r\nContent-Length: "; + head += file.size(); + head += "\r\nConnection: close"; + head += "\r\nAccess-Control-Allow-Origin: *"; + head += "\r\n\r\n"; + _currentClient.print(head); + head = String(); + return _currentClient.write(file, HTTP_DOWNLOAD_UNIT_SIZE); +} + protected: void _handleRequest(); bool _parseRequest(WiFiClient& client); From 2c4307277699616d5ede927560ca3f4248d52034 Mon Sep 17 00:00:00 2001 From: ficeto Date: Sat, 16 May 2015 11:03:39 +0300 Subject: [PATCH 39/78] enhancements on the FS Api --- cores/esp8266/FileSystem.cpp | 52 +++++++++++++++++++----------------- cores/esp8266/FileSystem.h | 6 ++--- 2 files changed, 31 insertions(+), 27 deletions(-) diff --git a/cores/esp8266/FileSystem.cpp b/cores/esp8266/FileSystem.cpp index 1abd5dc9f..802029a8d 100755 --- a/cores/esp8266/FileSystem.cpp +++ b/cores/esp8266/FileSystem.cpp @@ -144,14 +144,22 @@ void FSFile::close() { _file = 0; } +char * FSFile::name(){ + return (char*)_stats.name; +} + +bool FSFile::isDirectory(void) { + return _stats.type == SPIFFS_TYPE_DIR; +} + void FSFile::rewindDirectory() { - if (! _file || !isDirectory()) return; + if (!_file || !isDirectory()) return; SPIFFS_closedir(&_dir); SPIFFS_opendir(&_filesystemStorageHandle, (char*)_stats.name, &_dir); } FSFile FSFile::openNextFile(){ - if (! _file || !isDirectory()) return FSFile(); + if (!_file || !isDirectory()) return FSFile(); struct spiffs_dirent e; struct spiffs_dirent *pe = &e; if ((pe = SPIFFS_readdir(&_dir, pe))){ @@ -161,30 +169,36 @@ FSFile FSFile::openNextFile(){ } uint32_t FSFile::size() { - if(! _file) return 0; - if(SPIFFS_fstat(&_filesystemStorageHandle, _file, &_stats) != 0) return 0; + if(!_file) return 0; + if(_stats.size) return _stats.size; + uint32_t pos = SPIFFS_tell(&_filesystemStorageHandle, _file); + SPIFFS_lseek(&_filesystemStorageHandle, _file, 0, SPIFFS_SEEK_END); + _stats.size = SPIFFS_tell(&_filesystemStorageHandle, _file); + SPIFFS_lseek(&_filesystemStorageHandle, _file, pos, SPIFFS_SEEK_SET); return _stats.size; } +int FSFile::available() { + if (!_file) return 0; + uint32_t pos = SPIFFS_tell(&_filesystemStorageHandle, _file); + return size() - pos; +} + uint32_t FSFile::seek(uint32_t pos) { - if (! _file || isDirectory()) return 0; + if (!_file) return 0; return SPIFFS_lseek(&_filesystemStorageHandle, _file, pos, SPIFFS_SEEK_SET); } uint32_t FSFile::position() { - if (! _file || isDirectory()) return 0; + if (!_file) return 0; return SPIFFS_tell(&_filesystemStorageHandle, _file); } bool FSFile::eof() { - if (! _file || isDirectory()) return 0; + if (!_file) return 0; return SPIFFS_eof(&_filesystemStorageHandle, _file); } -bool FSFile::isDirectory(void) { - return _stats.type == SPIFFS_TYPE_DIR; -} - int FSFile::read(void *buf, uint16_t nbyte) { if (! _file || isDirectory()) return -1; return SPIFFS_read(&_filesystemStorageHandle, _file, buf, nbyte); @@ -204,12 +218,6 @@ int FSFile::peek() { return c; } -int FSFile::available() { - if (! _file || isDirectory()) return 0; - uint32_t pos = SPIFFS_tell(&_filesystemStorageHandle, _file); - return _stats.size - pos; -} - size_t FSFile::write(const uint8_t *buf, size_t size){ if (! _file || isDirectory()) return 0; int res = SPIFFS_write(&_filesystemStorageHandle, _file, (uint8_t *)buf, size); @@ -226,10 +234,10 @@ void FSFile::flush(){ SPIFFS_fflush(&_filesystemStorageHandle, _file); } -uint32_t FSFile::remove(){ +bool FSFile::remove(){ if (! _file) return 0; - return SPIFFS_fremove(&_filesystemStorageHandle, _file); - _file = 0; + close(); + return SPIFFS_remove(&_filesystemStorageHandle, (const char *)_stats.name) == 0; } int FSFile::lastError(){ @@ -239,7 +247,3 @@ int FSFile::lastError(){ void FSFile::clearError(){ _filesystemStorageHandle.errno = SPIFFS_OK; } - -char * FSFile::name(){ - return (char*)_stats.name; -} diff --git a/cores/esp8266/FileSystem.h b/cores/esp8266/FileSystem.h index 8956300c1..29173cb4e 100755 --- a/cores/esp8266/FileSystem.h +++ b/cores/esp8266/FileSystem.h @@ -26,8 +26,8 @@ class String; #define FSFILE_READ SPIFFS_RDONLY -#define FSFILE_WRITE (SPIFFS_RDWR | SPIFFS_CREAT | SPIFFS_APPEND | SPIFFS_DIRECT) -#define FSFILE_OVERWRITE (SPIFFS_RDWR | SPIFFS_CREAT | SPIFFS_APPEND | SPIFFS_TRUNC | SPIFFS_DIRECT) +#define FSFILE_WRITE (SPIFFS_RDONLY | SPIFFS_WRONLY | SPIFFS_CREAT | SPIFFS_APPEND | SPIFFS_DIRECT) +#define FSFILE_OVERWRITE (SPIFFS_RDONLY | SPIFFS_WRONLY | SPIFFS_CREAT | SPIFFS_APPEND | SPIFFS_TRUNC | SPIFFS_DIRECT) class FSFile : public Stream { private: @@ -47,11 +47,11 @@ public: virtual void flush(); int read(void *buf, uint16_t nbyte); uint32_t seek(uint32_t pos); - uint32_t remove(); uint32_t position(); uint32_t size(); bool eof(); void close(); + bool remove(); int lastError(); void clearError(); operator bool() { return _file > 0; } From b5b783e508b7dd8502290e17b9114e18fb588810 Mon Sep 17 00:00:00 2001 From: ficeto Date: Sat, 16 May 2015 13:16:38 +0300 Subject: [PATCH 40/78] add access to SPIFFS properties --- cores/esp8266/FileSystem.h | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/cores/esp8266/FileSystem.h b/cores/esp8266/FileSystem.h index 29173cb4e..012bdc45b 100755 --- a/cores/esp8266/FileSystem.h +++ b/cores/esp8266/FileSystem.h @@ -96,6 +96,13 @@ public: bool create(const char *filepath); bool remove(const char *filepath); bool rename(const char *filename, const char *newname); + size_t size(){ return _filesystemStorageHandle.cfg.phys_size; } + size_t blockSize(){ return _filesystemStorageHandle.cfg.log_block_size; } + size_t totalBlocks(){ return _filesystemStorageHandle.block_count; } + size_t freeBlocks(){ return _filesystemStorageHandle.free_blocks; } + size_t pageSize(){ return _filesystemStorageHandle.cfg.log_page_size; } + size_t allocatedPages(){ return _filesystemStorageHandle.stats_p_allocated; } + size_t deletedPages(){ return _filesystemStorageHandle.stats_p_deleted; } FSFile open(const char *filename, uint8_t mode = FSFILE_READ); FSFile open(spiffs_dirent* entry, uint8_t mode = FSFILE_READ); From 5529188daeed70715ebf29e1799dcd13377301c3 Mon Sep 17 00:00:00 2001 From: ficeto Date: Sat, 16 May 2015 16:22:38 +0300 Subject: [PATCH 41/78] add info methods to SD class --- libraries/SD/src/SD.h | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/libraries/SD/src/SD.h b/libraries/SD/src/SD.h index 93c79138b..b0192dd2f 100644 --- a/libraries/SD/src/SD.h +++ b/libraries/SD/src/SD.h @@ -106,6 +106,14 @@ public: boolean rmdir(char *filepath); + size_t type(){ return card.type(); } + size_t fatType(){ return volume.fatType(); } + size_t blocksPerCluster(){ return volume.blocksPerCluster(); } + size_t totalClusters(){ return volume.clusterCount(); } + size_t blockSize(){ return (size_t)0x200; } + size_t totalBlocks(){ return (totalClusters() / blocksPerCluster()); } + size_t clusterSize(){ return blocksPerCluster() * blockSize(); } + size_t size(){ return (clusterSize() * totalClusters()); } private: // This is used to determine the mode used to open a file From 53cb1a014098dcf7cc3c109ebf8a980561058cb2 Mon Sep 17 00:00:00 2001 From: ficeto Date: Sat, 16 May 2015 16:29:10 +0300 Subject: [PATCH 42/78] fix data types --- libraries/SD/src/SD.h | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/libraries/SD/src/SD.h b/libraries/SD/src/SD.h index b0192dd2f..62276b4ee 100644 --- a/libraries/SD/src/SD.h +++ b/libraries/SD/src/SD.h @@ -106,8 +106,8 @@ public: boolean rmdir(char *filepath); - size_t type(){ return card.type(); } - size_t fatType(){ return volume.fatType(); } + uint8_t type(){ return card.type(); } + uint8_t fatType(){ return volume.fatType(); } size_t blocksPerCluster(){ return volume.blocksPerCluster(); } size_t totalClusters(){ return volume.clusterCount(); } size_t blockSize(){ return (size_t)0x200; } From 0b168fd1bff8b5762fd933be701ccdc191b2aac5 Mon Sep 17 00:00:00 2001 From: ficeto Date: Sat, 16 May 2015 18:25:22 +0300 Subject: [PATCH 43/78] add Print::printf --- cores/esp8266/Print.cpp | 11 +++++++++++ cores/esp8266/Print.h | 1 + 2 files changed, 12 insertions(+) diff --git a/cores/esp8266/Print.cpp b/cores/esp8266/Print.cpp index c1405c9f7..aa63cd290 100644 --- a/cores/esp8266/Print.cpp +++ b/cores/esp8266/Print.cpp @@ -30,6 +30,7 @@ #include "Print.h" extern "C" { #include "c_types.h" +#include "ets_sys.h" } // Public Methods ////////////////////////////////////////////////////////////// @@ -43,6 +44,16 @@ size_t ICACHE_FLASH_ATTR Print::write(const uint8_t *buffer, size_t size) { return n; } +size_t Print::printf(const char *format, ...) { + va_list arg; + va_start(arg, format); + char temp[256]; + size_t len = ets_vsnprintf(temp, 256, format, arg); + len = write((const char *)temp); + va_end(arg); + return len; +} + size_t ICACHE_FLASH_ATTR Print::print(const __FlashStringHelper *ifsh) { PGM_P p = reinterpret_cast(ifsh); diff --git a/cores/esp8266/Print.h b/cores/esp8266/Print.h index 79358f157..7366174f5 100644 --- a/cores/esp8266/Print.h +++ b/cores/esp8266/Print.h @@ -63,6 +63,7 @@ class Print { return write((const uint8_t *) buffer, size); } + size_t printf(const char * format, ...); size_t print(const __FlashStringHelper *); size_t print(const String &); size_t print(const char[]); From 66d9dbb070b6f6ecea89571b212b17e80c47081c Mon Sep 17 00:00:00 2001 From: ficeto Date: Sat, 16 May 2015 19:00:36 +0300 Subject: [PATCH 44/78] ESP8266WiFiClass::waitForConnectResult() waitForConnectResult() waits until wifi status is not disconnected, unless STA is disabled, in which case it returns WL_DISCONNECTED --- libraries/ESP8266WiFi/src/ESP8266WiFi.cpp | 8 ++++++++ libraries/ESP8266WiFi/src/ESP8266WiFi.h | 4 ++++ 2 files changed, 12 insertions(+) diff --git a/libraries/ESP8266WiFi/src/ESP8266WiFi.cpp b/libraries/ESP8266WiFi/src/ESP8266WiFi.cpp index caf63982c..85a7ac416 100644 --- a/libraries/ESP8266WiFi/src/ESP8266WiFi.cpp +++ b/libraries/ESP8266WiFi/src/ESP8266WiFi.cpp @@ -81,6 +81,14 @@ int ESP8266WiFiClass::begin(const char* ssid, const char *passphrase) return status(); } +uint8_t ESP8266WiFiClass::waitForConnectResult(){ + if ((wifi_get_opmode() & 1) == 0)//1 and 3 have STA enabled + return WL_DISCONNECTED; + while (status() == WL_DISCONNECTED) + delay(100); + return status(); +} + void ESP8266WiFiClass::config(IPAddress local_ip, IPAddress gateway, IPAddress subnet) { struct ip_info info; diff --git a/libraries/ESP8266WiFi/src/ESP8266WiFi.h b/libraries/ESP8266WiFi/src/ESP8266WiFi.h index c98f32b8b..889af27a5 100644 --- a/libraries/ESP8266WiFi/src/ESP8266WiFi.h +++ b/libraries/ESP8266WiFi/src/ESP8266WiFi.h @@ -58,6 +58,10 @@ public: */ int begin(const char* ssid, const char *passphrase); + /* Wait for Wifi connection to reach a result + * returns the status reached or disconnect if STA is off + */ + uint8_t waitForConnectResult(); /* Set up an open access point * From ab4629138331e004027a3b12c4d388f322856a21 Mon Sep 17 00:00:00 2001 From: ficeto Date: Sat, 16 May 2015 20:38:00 +0300 Subject: [PATCH 45/78] fix uart triggering reset when spi has been read/written --- cores/esp8266/spiffs/spiffs_flashmem.c | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/cores/esp8266/spiffs/spiffs_flashmem.c b/cores/esp8266/spiffs/spiffs_flashmem.c index 156e2fac2..fff3c2a86 100755 --- a/cores/esp8266/spiffs/spiffs_flashmem.c +++ b/cores/esp8266/spiffs/spiffs_flashmem.c @@ -97,7 +97,7 @@ uint32_t flashmem_read( void *to, uint32_t fromaddr, uint32_t size ) bool flashmem_erase_sector( uint32_t sector_id ) { - WRITE_PERI_REG(0x60000914, 0x73); + WDT_RESET(); return spi_flash_erase_sector( sector_id ) == SPI_FLASH_RESULT_OK; } @@ -186,7 +186,9 @@ uint32_t flashmem_write_internal( const void *from, uint32_t toaddr, uint32_t si os_memcpy(apbuf, from, size); } WDT_RESET(); + ETS_UART_INTR_DISABLE(); r = spi_flash_write(toaddr, apbuf?(uint32 *)apbuf:(uint32 *)from, size); + ETS_UART_INTR_ENABLE(); if(apbuf) os_free(apbuf); if(SPI_FLASH_RESULT_OK == r) @@ -202,7 +204,9 @@ uint32_t flashmem_read_internal( void *to, uint32_t fromaddr, uint32_t size ) fromaddr -= INTERNAL_FLASH_START_ADDRESS; SpiFlashOpResult r; WDT_RESET(); + ETS_UART_INTR_DISABLE(); r = spi_flash_read(fromaddr, (uint32 *)to, size); + ETS_UART_INTR_ENABLE(); if(SPI_FLASH_RESULT_OK == r) return size; else{ From 62a460f0b81259e810124fee673d10463faf3ea9 Mon Sep 17 00:00:00 2001 From: ficeto Date: Sat, 16 May 2015 20:39:23 +0300 Subject: [PATCH 46/78] printf to print instead of write --- cores/esp8266/Print.cpp | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/cores/esp8266/Print.cpp b/cores/esp8266/Print.cpp index aa63cd290..1f924248a 100644 --- a/cores/esp8266/Print.cpp +++ b/cores/esp8266/Print.cpp @@ -49,7 +49,7 @@ size_t Print::printf(const char *format, ...) { va_start(arg, format); char temp[256]; size_t len = ets_vsnprintf(temp, 256, format, arg); - len = write((const char *)temp); + len = print(temp); va_end(arg); return len; } From b902e86cb119020f959154fcaba498633cbb2a6e Mon Sep 17 00:00:00 2001 From: ficeto Date: Sat, 16 May 2015 21:01:51 +0300 Subject: [PATCH 47/78] disable all interrupts when reading from spiffs this fixes any possible resets caused by interrupt routines trying to read the flash while there is an ongoing spiffs operation --- cores/esp8266/Arduino.h | 2 +- cores/esp8266/spiffs/spiffs_flashmem.c | 14 +++++++++----- 2 files changed, 10 insertions(+), 6 deletions(-) diff --git a/cores/esp8266/Arduino.h b/cores/esp8266/Arduino.h index 1170b6f4a..4a2bd7144 100644 --- a/cores/esp8266/Arduino.h +++ b/cores/esp8266/Arduino.h @@ -135,7 +135,7 @@ void ets_intr_unlock(); extern uint32_t interruptsState; #define interrupts() xt_enable_interrupts(interruptsState) -#define noInterrupts() xt_disable_interrupts(interruptsState, 15) +#define noInterrupts() __asm__ __volatile__("rsil %0,15; esync; isync; dsync" : "=a" (interruptsState)) #define clockCyclesPerMicrosecond() ( F_CPU / 1000000L ) #define clockCyclesToMicroseconds(a) ( (a) / clockCyclesPerMicrosecond() ) diff --git a/cores/esp8266/spiffs/spiffs_flashmem.c b/cores/esp8266/spiffs/spiffs_flashmem.c index fff3c2a86..d7f182ee0 100755 --- a/cores/esp8266/spiffs/spiffs_flashmem.c +++ b/cores/esp8266/spiffs/spiffs_flashmem.c @@ -1,5 +1,6 @@ #include "flashmem.h" #include "esp8266_peri.h" +#include "Arduino.h" // Based on NodeMCU platform_flash // https://github.com/nodemcu/nodemcu-firmware @@ -98,7 +99,10 @@ uint32_t flashmem_read( void *to, uint32_t fromaddr, uint32_t size ) bool flashmem_erase_sector( uint32_t sector_id ) { WDT_RESET(); - return spi_flash_erase_sector( sector_id ) == SPI_FLASH_RESULT_OK; + noInterrupts(); + bool erased = spi_flash_erase_sector( sector_id ) == SPI_FLASH_RESULT_OK; + interrupts(); + return erased; } SPIFlashInfo flashmem_get_info() @@ -186,9 +190,9 @@ uint32_t flashmem_write_internal( const void *from, uint32_t toaddr, uint32_t si os_memcpy(apbuf, from, size); } WDT_RESET(); - ETS_UART_INTR_DISABLE(); + noInterrupts(); r = spi_flash_write(toaddr, apbuf?(uint32 *)apbuf:(uint32 *)from, size); - ETS_UART_INTR_ENABLE(); + interrupts(); if(apbuf) os_free(apbuf); if(SPI_FLASH_RESULT_OK == r) @@ -204,9 +208,9 @@ uint32_t flashmem_read_internal( void *to, uint32_t fromaddr, uint32_t size ) fromaddr -= INTERNAL_FLASH_START_ADDRESS; SpiFlashOpResult r; WDT_RESET(); - ETS_UART_INTR_DISABLE(); + noInterrupts(); r = spi_flash_read(fromaddr, (uint32 *)to, size); - ETS_UART_INTR_ENABLE(); + interrupts(); if(SPI_FLASH_RESULT_OK == r) return size; else{ From b6c196a49adb0d402a6cfae22d34c3f2ff3abdab Mon Sep 17 00:00:00 2001 From: ficeto Date: Sat, 16 May 2015 21:40:41 +0300 Subject: [PATCH 48/78] fix start address so erase works --- cores/esp8266/spiffs/spiffs.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/cores/esp8266/spiffs/spiffs.c b/cores/esp8266/spiffs/spiffs.c index c07be839a..71d00905c 100755 --- a/cores/esp8266/spiffs/spiffs.c +++ b/cores/esp8266/spiffs/spiffs.c @@ -58,7 +58,7 @@ bool spiffs_format_internal(){ } u32_t sect_first, sect_last; - sect_first = flashmem_get_first_free_block_address(); + sect_first = flashmem_get_sector_of_address((u32_t)&_SPIFFS_start); sect_last = flashmem_get_sector_of_address((u32_t)&_SPIFFS_end); debugf("sect_first: %x, sect_last: %x\n", sect_first, sect_last); while( sect_first <= sect_last ){ From 108a40acfd3af5fd703b049c9b28dc9dd1a7d131 Mon Sep 17 00:00:00 2001 From: Markus Sattler Date: Sat, 16 May 2015 22:40:53 +0200 Subject: [PATCH 49/78] add support for list of AP connections - auto select ssid with best signal - for debugging enable DEBUG_WIFI_MULTI macro and call Serial.setDebugOutput(true); change ESP8266WiFiClass::status() return type to wl_status_t --- libraries/ESP8266WiFi/src/ESP8266WiFi.cpp | 2 +- libraries/ESP8266WiFi/src/ESP8266WiFi.h | 2 +- .../ESP8266WiFi/src/ESP8266WiFiMulti.cpp | 167 ++++++++++++++++++ libraries/ESP8266WiFi/src/ESP8266WiFiMulti.h | 59 +++++++ .../ESP8266WiFi/src/include/wl_definitions.h | 16 +- 5 files changed, 236 insertions(+), 10 deletions(-) create mode 100644 libraries/ESP8266WiFi/src/ESP8266WiFiMulti.cpp create mode 100644 libraries/ESP8266WiFi/src/ESP8266WiFiMulti.h diff --git a/libraries/ESP8266WiFi/src/ESP8266WiFi.cpp b/libraries/ESP8266WiFi/src/ESP8266WiFi.cpp index caf63982c..9915d1bd6 100644 --- a/libraries/ESP8266WiFi/src/ESP8266WiFi.cpp +++ b/libraries/ESP8266WiFi/src/ESP8266WiFi.cpp @@ -336,7 +336,7 @@ uint8_t ESP8266WiFiClass::encryptionType(uint8_t i) return -1; } -uint8_t ESP8266WiFiClass::status() +wl_status_t ESP8266WiFiClass::status() { int status = wifi_station_get_connect_status(); diff --git a/libraries/ESP8266WiFi/src/ESP8266WiFi.h b/libraries/ESP8266WiFi/src/ESP8266WiFi.h index c98f32b8b..be257d152 100644 --- a/libraries/ESP8266WiFi/src/ESP8266WiFi.h +++ b/libraries/ESP8266WiFi/src/ESP8266WiFi.h @@ -195,7 +195,7 @@ public: * * return: one of the value defined in wl_status_t */ - uint8_t status(); + wl_status_t status(); /* * Resolve the given hostname to an IP address. diff --git a/libraries/ESP8266WiFi/src/ESP8266WiFiMulti.cpp b/libraries/ESP8266WiFi/src/ESP8266WiFiMulti.cpp new file mode 100644 index 000000000..a284be754 --- /dev/null +++ b/libraries/ESP8266WiFi/src/ESP8266WiFiMulti.cpp @@ -0,0 +1,167 @@ +/** + * + * @file ESP8266WiFiMulti.cpp + * @date 16.05.2015 + * @author Markus Sattler + * + * Copyright (c) 2015 Markus Sattler. All rights reserved. + * This file is part of the esp8266 core for Arduino environment. + * + * 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 "ESP8266WiFi.h" +#include "ESP8266WiFiMulti.h" +#include + +ESP8266WiFiMulti::ESP8266WiFiMulti() { +} + +ESP8266WiFiMulti::~ESP8266WiFiMulti() { + APlistClean(); +} + +bool ESP8266WiFiMulti::addAP(const char* ssid, const char *passphrase) { + return APlistAdd(ssid, passphrase); +} + +wl_status_t ESP8266WiFiMulti::run(void) { + + wl_status_t status = WiFi.status(); + if(status == WL_DISCONNECTED || status == WL_NO_SSID_AVAIL || status == WL_IDLE_STATUS || status == WL_CONNECT_FAILED) { + + WifiAPlist_t bestNetwork { NULL, NULL }; + int bestNetworkDb = INT_MIN; + + // WiFi.scanNetworks will return the number of networks found + int8_t n = WiFi.scanNetworks(); + + DEBUG_WIFI_MULTI("[WIFI] scan done\n"); + delay(0); + + if(n <= 0) { + DEBUG_WIFI_MULTI("[WIFI] no networks found\n"); + } else { + DEBUG_WIFI_MULTI("[WIFI] %d networks found\n", n); + for(int8_t i = 0; i < n; ++i) { + const char * ssid_scan = WiFi.SSID(i); + int32_t rssi_scan = WiFi.RSSI(i); + uint8_t sec_scan = WiFi.encryptionType(i); + + bool known = false; + for(uint32_t x = 0; x < APlist.size(); x++) { + WifiAPlist_t entry = APlist[x]; + + if(strcmp(entry.ssid, ssid_scan) == 0) { // SSID match + known = true; + if(rssi_scan > bestNetworkDb) { // best network + if(sec_scan == ENC_TYPE_NONE || entry.passphrase) { // check for passphrase if not open wlan + bestNetworkDb = rssi_scan; + memcpy((void*) &bestNetwork, (void*) &entry, sizeof(bestNetwork)); + } + } + break; + } + } + if(known) { + DEBUG_WIFI_MULTI(" ---> "); + } else { + DEBUG_WIFI_MULTI(" "); + } + + DEBUG_WIFI_MULTI(" %d: %s (%d) %c\n", i, ssid_scan, rssi_scan, (sec_scan == ENC_TYPE_NONE) ? ' ' : '*'); + delay(0); + } + } + + DEBUG_WIFI_MULTI("\n\n"); + delay(0); + + if(bestNetwork.ssid) { + DEBUG_WIFI_MULTI("[WIFI] Connecting SSID: %s (%d)\n", bestNetwork.ssid, bestNetworkDb); + + WiFi.begin(bestNetwork.ssid, bestNetwork.passphrase); + status = WiFi.status(); + + // wait for connection or fail + while(status != WL_CONNECTED && status != WL_NO_SSID_AVAIL && status != WL_CONNECT_FAILED) { + delay(10); + status = WiFi.status(); + } + + switch(status) { + case WL_CONNECTED: + DEBUG_WIFI_MULTI("[WIFI] Connecting Done.\n"); + break; + case WL_NO_SSID_AVAIL: + DEBUG_WIFI_MULTI("[WIFI] Connecting Faild AP not found.\n"); + break; + case WL_CONNECT_FAILED: + DEBUG_WIFI_MULTI("[WIFI] Connecting Faild.\n"); + break; + default: + DEBUG_WIFI_MULTI("[WIFI] Connecting Faild (%d).\n", status); + break; + } + } else { + DEBUG_WIFI_MULTI("[WIFI] no matching wifi found!\n"); + } + } + return status; +} + +// ################################################################################## + +bool ESP8266WiFiMulti::APlistAdd(const char* ssid, const char *passphrase) { + + WifiAPlist_t newAP; + + newAP.ssid = (char*) malloc(strlen(ssid)); + + if(!newAP.ssid) { + return false; + } + + strcpy(newAP.ssid, ssid); + + if(passphrase && *passphrase != 0x00) { + newAP.passphrase = (char*) malloc(strlen(passphrase)); + } + + if(!newAP.passphrase) { + free(newAP.ssid); + return false; + } + + strcpy(newAP.passphrase, passphrase); + + APlist.push_back(newAP); + return true; +} + +void ESP8266WiFiMulti::APlistClean(void) { + for(uint32_t i = 0; i < APlist.size(); i++) { + WifiAPlist_t entry = APlist[i]; + if(entry.ssid) { + free(entry.ssid); + } + if(entry.passphrase) { + free(entry.passphrase); + } + } + APlist.clear(); +} + diff --git a/libraries/ESP8266WiFi/src/ESP8266WiFiMulti.h b/libraries/ESP8266WiFi/src/ESP8266WiFiMulti.h new file mode 100644 index 000000000..285fca755 --- /dev/null +++ b/libraries/ESP8266WiFi/src/ESP8266WiFiMulti.h @@ -0,0 +1,59 @@ +/** + * + * @file ESP8266WiFiMulti.h + * @date 16.05.2015 + * @author Markus Sattler + * + * Copyright (c) 2015 Markus Sattler. All rights reserved. + * This file is part of the esp8266 core for Arduino environment. + * + * 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 + * + */ + + +#ifndef WIFICLIENTMULTI_H_ +#define WIFICLIENTMULTI_H_ + +#include + +//#define DEBUG_WIFI_MULTI(...) os_printf( __VA_ARGS__ ) + +#ifndef DEBUG_WIFI_MULTI +#define DEBUG_WIFI_MULTI(...) +#endif + +typedef struct { + char * ssid; + char * passphrase; +} WifiAPlist_t; + +class ESP8266WiFiMulti { + public: + ESP8266WiFiMulti(); + ~ESP8266WiFiMulti(); + + bool addAP(const char* ssid, const char *passphrase = NULL); + + wl_status_t run(void); + + private: + std::vector APlist; + bool APlistAdd(const char* ssid, const char *passphrase = NULL); + void APlistClean(void); + +}; + +#endif /* WIFICLIENTMULTI_H_ */ diff --git a/libraries/ESP8266WiFi/src/include/wl_definitions.h b/libraries/ESP8266WiFi/src/include/wl_definitions.h index a32ba45b2..45bee6764 100644 --- a/libraries/ESP8266WiFi/src/include/wl_definitions.h +++ b/libraries/ESP8266WiFi/src/include/wl_definitions.h @@ -48,14 +48,14 @@ #define WL_MAX_ATTEMPT_CONNECTION 10 typedef enum { - WL_NO_SHIELD = 255, // for compatibility with WiFi Shield library - WL_IDLE_STATUS = 0, - WL_NO_SSID_AVAIL, - WL_SCAN_COMPLETED, - WL_CONNECTED, - WL_CONNECT_FAILED, - WL_CONNECTION_LOST, - WL_DISCONNECTED + WL_NO_SHIELD = 255, // for compatibility with WiFi Shield library + WL_IDLE_STATUS = 0, + WL_NO_SSID_AVAIL = 1, + WL_SCAN_COMPLETED = 2, + WL_CONNECTED = 3, + WL_CONNECT_FAILED = 4, + WL_CONNECTION_LOST = 5, + WL_DISCONNECTED = 6 } wl_status_t; /* Encryption modes */ From 508f0802d5232929ccf88e542ae03a33c2928ce1 Mon Sep 17 00:00:00 2001 From: Markus Sattler Date: Sat, 16 May 2015 22:47:29 +0200 Subject: [PATCH 50/78] add examples/WiFiMulti/WiFiMulti.ino --- .../examples/WiFiMulti/WiFiMulti.ino | 33 +++++++++++++++++++ 1 file changed, 33 insertions(+) create mode 100644 libraries/ESP8266WiFi/examples/WiFiMulti/WiFiMulti.ino diff --git a/libraries/ESP8266WiFi/examples/WiFiMulti/WiFiMulti.ino b/libraries/ESP8266WiFi/examples/WiFiMulti/WiFiMulti.ino new file mode 100644 index 000000000..5a1057893 --- /dev/null +++ b/libraries/ESP8266WiFi/examples/WiFiMulti/WiFiMulti.ino @@ -0,0 +1,33 @@ +/* + * This sketch trys to Connect to the best AP based on a given list + * + */ + +#include +#include + +ESP8266WiFiMulti WiFiMulti = ESP8266WiFiMulti(); + +void setup() { + Serial.begin(115200); + delay(10); + + WiFiMulti.addAP("ssid_from_AP_1", "your_password_for_AP_1"); + WiFiMulti.addAP("ssid_from_AP_2", "your_password_for_AP_2"); + WiFiMulti.addAP("ssid_from_AP_3", "your_password_for_AP_3"); + + Serial.println("Connecting Wifi..."); + if(wifiMulti.run() == WL_CONNECTED) { + Serial.println(""); + Serial.println("WiFi connected"); + Serial.println("IP address: "); + Serial.println(WiFi.localIP()); + } +} + +void loop() { + if(wifiMulti.run() != WL_CONNECTED) { + Serial.println("WiFi not connected!"); + delay(1000); + } +} \ No newline at end of file From 03da6393d57c005af786fd7a16224694fcb614e3 Mon Sep 17 00:00:00 2001 From: Markus Sattler Date: Sat, 16 May 2015 22:56:15 +0200 Subject: [PATCH 51/78] improve includes add ssid and ip to debug out --- libraries/ESP8266WiFi/src/ESP8266WiFiMulti.cpp | 8 ++++++-- libraries/ESP8266WiFi/src/ESP8266WiFiMulti.h | 1 + 2 files changed, 7 insertions(+), 2 deletions(-) diff --git a/libraries/ESP8266WiFi/src/ESP8266WiFiMulti.cpp b/libraries/ESP8266WiFi/src/ESP8266WiFiMulti.cpp index a284be754..3b878020f 100644 --- a/libraries/ESP8266WiFi/src/ESP8266WiFiMulti.cpp +++ b/libraries/ESP8266WiFi/src/ESP8266WiFiMulti.cpp @@ -23,7 +23,6 @@ * */ -#include "ESP8266WiFi.h" #include "ESP8266WiFiMulti.h" #include @@ -76,6 +75,7 @@ wl_status_t ESP8266WiFiMulti::run(void) { break; } } + if(known) { DEBUG_WIFI_MULTI(" ---> "); } else { @@ -102,9 +102,13 @@ wl_status_t ESP8266WiFiMulti::run(void) { status = WiFi.status(); } + IPAddress ip; switch(status) { case WL_CONNECTED: - DEBUG_WIFI_MULTI("[WIFI] Connecting Done.\n"); + ip = WiFi.localIP(); + DEBUG_WIFI_MULTI("[WIFI] Connecting done.\n"); + DEBUG_WIFI_MULTI("[WIFI] SSID: %s\n", WiFi.SSID()); + DEBUG_WIFI_MULTI("[WIFI] IP: %d.%d.%d.%d\n", ip[0], ip[1], ip[2], ip[3]); break; case WL_NO_SSID_AVAIL: DEBUG_WIFI_MULTI("[WIFI] Connecting Faild AP not found.\n"); diff --git a/libraries/ESP8266WiFi/src/ESP8266WiFiMulti.h b/libraries/ESP8266WiFi/src/ESP8266WiFiMulti.h index 285fca755..a3926a406 100644 --- a/libraries/ESP8266WiFi/src/ESP8266WiFiMulti.h +++ b/libraries/ESP8266WiFi/src/ESP8266WiFiMulti.h @@ -27,6 +27,7 @@ #ifndef WIFICLIENTMULTI_H_ #define WIFICLIENTMULTI_H_ +#include "ESP8266WiFi.h" #include //#define DEBUG_WIFI_MULTI(...) os_printf( __VA_ARGS__ ) From 4c4e6b8ce935fdb583333728dbd2e59494a61079 Mon Sep 17 00:00:00 2001 From: ficeto Date: Sun, 17 May 2015 00:04:39 +0300 Subject: [PATCH 52/78] spiffs fixes --- cores/esp8266/FileSystem.h | 4 ++-- cores/esp8266/spiffs/spiffs.c | 14 ++++++++------ cores/esp8266/spiffs/spiffs_flashmem.c | 18 +++++++++--------- 3 files changed, 19 insertions(+), 17 deletions(-) diff --git a/cores/esp8266/FileSystem.h b/cores/esp8266/FileSystem.h index 012bdc45b..9d3a52eac 100755 --- a/cores/esp8266/FileSystem.h +++ b/cores/esp8266/FileSystem.h @@ -26,8 +26,8 @@ class String; #define FSFILE_READ SPIFFS_RDONLY -#define FSFILE_WRITE (SPIFFS_RDONLY | SPIFFS_WRONLY | SPIFFS_CREAT | SPIFFS_APPEND | SPIFFS_DIRECT) -#define FSFILE_OVERWRITE (SPIFFS_RDONLY | SPIFFS_WRONLY | SPIFFS_CREAT | SPIFFS_APPEND | SPIFFS_TRUNC | SPIFFS_DIRECT) +#define FSFILE_WRITE (SPIFFS_RDONLY | SPIFFS_WRONLY | SPIFFS_CREAT | SPIFFS_APPEND ) +#define FSFILE_OVERWRITE (SPIFFS_RDONLY | SPIFFS_WRONLY | SPIFFS_CREAT | SPIFFS_APPEND | SPIFFS_TRUNC ) class FSFile : public Stream { private: diff --git a/cores/esp8266/spiffs/spiffs.c b/cores/esp8266/spiffs/spiffs.c index 71d00905c..74a65e05d 100755 --- a/cores/esp8266/spiffs/spiffs.c +++ b/cores/esp8266/spiffs/spiffs.c @@ -21,7 +21,7 @@ static s32_t api_spiffs_write(u32_t addr, u32_t size, u8_t *src){ static s32_t api_spiffs_erase(u32_t addr, u32_t size){ debugf("api_spiffs_erase"); u32_t sect_first = flashmem_get_sector_of_address(addr); - u32_t sect_last = sect_first; + u32_t sect_last = flashmem_get_sector_of_address(addr+size); while( sect_first <= sect_last ) if( !flashmem_erase_sector( sect_first ++ ) ) return SPIFFS_ERR_INTERNAL; @@ -68,7 +68,7 @@ bool spiffs_format_internal(){ return true; } -bool spiffs_mount(){ +bool spiffs_mount_internal(bool wipe){ spiffs_config cfg = spiffs_get_storage_config(); if (cfg.phys_addr == 0){ SYSTEM_ERROR("Can't start file system, wrong address"); @@ -85,7 +85,7 @@ bool spiffs_mount(){ bool writeFirst = false; flashmem_read(&dat, cfg.phys_addr, 4); - if (dat == UINT32_MAX){ + if (dat == UINT32_MAX || wipe){ debugf("First init file system"); if(!spiffs_format_internal()){ SYSTEM_ERROR("Can't format file system"); @@ -115,15 +115,17 @@ bool spiffs_mount(){ return true; } +bool spiffs_mount(){ + return spiffs_mount_internal(false); +} + void spiffs_unmount(){ SPIFFS_unmount(&_filesystemStorageHandle); } bool spiffs_format(){ spiffs_unmount(); - if(!spiffs_format_internal()) return false; - spiffs_mount(); - return true; + return spiffs_mount_internal(true); } void test_spiffs(){ diff --git a/cores/esp8266/spiffs/spiffs_flashmem.c b/cores/esp8266/spiffs/spiffs_flashmem.c index d7f182ee0..dc875ff12 100755 --- a/cores/esp8266/spiffs/spiffs_flashmem.c +++ b/cores/esp8266/spiffs/spiffs_flashmem.c @@ -96,15 +96,6 @@ uint32_t flashmem_read( void *to, uint32_t fromaddr, uint32_t size ) return ssize; } -bool flashmem_erase_sector( uint32_t sector_id ) -{ - WDT_RESET(); - noInterrupts(); - bool erased = spi_flash_erase_sector( sector_id ) == SPI_FLASH_RESULT_OK; - interrupts(); - return erased; -} - SPIFlashInfo flashmem_get_info() { volatile SPIFlashInfo spi_flash_info STORE_ATTR; @@ -177,6 +168,15 @@ uint32_t flashmem_get_sector_of_address( uint32_t addr ) ///////////////////////////////////////////////////// +bool flashmem_erase_sector( uint32_t sector_id ) +{ + WDT_RESET(); + noInterrupts(); + bool erased = spi_flash_erase_sector( sector_id ) == SPI_FLASH_RESULT_OK; + interrupts(); + return erased; +} + uint32_t flashmem_write_internal( const void *from, uint32_t toaddr, uint32_t size ) { toaddr -= INTERNAL_FLASH_START_ADDRESS; From e50fc0fef8dd46e58483a66889f821c1d5fa3e7e Mon Sep 17 00:00:00 2001 From: Markus Sattler Date: Sat, 16 May 2015 23:10:06 +0200 Subject: [PATCH 53/78] fix possible problems in EEPROM regarding interrupt handling and SPI flash blocking --- libraries/EEPROM/EEPROM.cpp | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/libraries/EEPROM/EEPROM.cpp b/libraries/EEPROM/EEPROM.cpp index 74e7f3b0f..2e1eb4fca 100644 --- a/libraries/EEPROM/EEPROM.cpp +++ b/libraries/EEPROM/EEPROM.cpp @@ -49,7 +49,9 @@ void EEPROMClass::begin(size_t size) _data = new uint8_t[size]; _size = size; + noInterrupts(); spi_flash_read(CONFIG_ADDR, reinterpret_cast(_data), _size); + interrupts(); } void EEPROMClass::end() @@ -90,19 +92,21 @@ bool EEPROMClass::commit() if(!_dirty) return true; - ETS_UART_INTR_DISABLE(); + noInterrupts(); if(spi_flash_erase_sector(CONFIG_SECTOR) == SPI_FLASH_RESULT_OK) { if(spi_flash_write(CONFIG_ADDR, reinterpret_cast(_data), _size) == SPI_FLASH_RESULT_OK) { _dirty = false; ret = true; } } - ETS_UART_INTR_ENABLE(); + interrupts(); + return ret; } uint8_t * EEPROMClass::getDataPtr() { + _dirty = true; return &_data[0]; } From e0f9a4173eac7450758d02deac1d65857d2d2966 Mon Sep 17 00:00:00 2001 From: Markus Sattler Date: Sun, 17 May 2015 13:33:10 +0200 Subject: [PATCH 54/78] force all os_malloc calls to request a aligned size. - this fix Fatal exception (9) by unaligned class memory --- cores/esp8266/abi.cpp | 2 ++ cores/esp8266/libc_replacements.c | 2 ++ 2 files changed, 4 insertions(+) diff --git a/cores/esp8266/abi.cpp b/cores/esp8266/abi.cpp index add40bcb1..b863997a3 100644 --- a/cores/esp8266/abi.cpp +++ b/cores/esp8266/abi.cpp @@ -26,10 +26,12 @@ extern "C" { } void *operator new(size_t size) { + size = ((size + 3) & ~((size_t)0x3)); return os_malloc(size); } void *operator new[](size_t size) { + size = ((size + 3) & ~((size_t)0x3)); return os_malloc(size); } diff --git a/cores/esp8266/libc_replacements.c b/cores/esp8266/libc_replacements.c index 64efd94ab..519ea233a 100644 --- a/cores/esp8266/libc_replacements.c +++ b/cores/esp8266/libc_replacements.c @@ -38,6 +38,7 @@ #include "user_interface.h" void* malloc(size_t size) { + size = ((size + 3) & ~((size_t)0x3)); return os_malloc(size); } @@ -46,6 +47,7 @@ void free(void* ptr) { } void* realloc(void* ptr, size_t size) { + size = ((size + 3) & ~((size_t)0x3)); return os_realloc(ptr, size); } From 5b5deb5a7784702b0c71a5bea1cfa15bac9b7256 Mon Sep 17 00:00:00 2001 From: Markus Sattler Date: Sun, 17 May 2015 13:43:49 +0200 Subject: [PATCH 55/78] improve os_printf handling when buffer full. - wait for free buffer in hw fifo --- cores/esp8266/HardwareSerial.cpp | 46 +++++++++++++++++++++----------- 1 file changed, 31 insertions(+), 15 deletions(-) diff --git a/cores/esp8266/HardwareSerial.cpp b/cores/esp8266/HardwareSerial.cpp index bdcd45716..ac56919ca 100644 --- a/cores/esp8266/HardwareSerial.cpp +++ b/cores/esp8266/HardwareSerial.cpp @@ -42,12 +42,12 @@ extern "C" { #define UART_TX_FIFO_SIZE 0x80 struct uart_ { - int uart_nr; + int uart_nr; int baud_rate; bool rxEnabled; bool txEnabled; - uint8_t rxPin; - uint8_t txPin; + uint8_t rxPin; + uint8_t txPin; }; static const int UART0 = 0; @@ -120,7 +120,7 @@ void ICACHE_RAM_ATTR uart_interrupt_handler(uart_t* uart) { // -------------- UART 0 -------------- if(Serial.isRxEnabled()) { while(U0IS & (1 << UIFF)) { - Serial._rx_complete_irq((char)(U0F & 0xff)); + Serial._rx_complete_irq((char) (U0F & 0xff)); U0IC = (1 << UIFF); } } @@ -135,7 +135,7 @@ void ICACHE_RAM_ATTR uart_interrupt_handler(uart_t* uart) { if(Serial1.isRxEnabled()) { while(U1IS & (1 << UIFF)) { - Serial1._rx_complete_irq((char)(U1F & 0xff)); + Serial1._rx_complete_irq((char) (U1F & 0xff)); U1IC = (1 << UIFF); } } @@ -357,19 +357,19 @@ void uart_swap(uart_t* uart) { switch(uart->uart_nr) { case UART0: if(uart->txPin == 1 && uart->rxPin == 3) { - pinMode(15, FUNCTION_4);//TX - pinMode(13, FUNCTION_4);//RX + pinMode(15, FUNCTION_4); //TX + pinMode(13, FUNCTION_4); //RX USWAP |= (1 << USWAP0); - pinMode(1, INPUT);//TX - pinMode(3, INPUT);//RX + pinMode(1, INPUT); //TX + pinMode(3, INPUT); //RX uart->rxPin = 13; uart->txPin = 15; } else { - pinMode(1, SPECIAL);//TX - pinMode(3, SPECIAL);//RX + pinMode(1, SPECIAL); //TX + pinMode(3, SPECIAL); //RX USWAP &= ~(1 << USWAP0); - pinMode(15, INPUT);//TX - pinMode(13, INPUT);//RX + pinMode(15, INPUT); //TX + pinMode(13, INPUT); //RX uart->rxPin = 3; uart->txPin = 1; } @@ -400,6 +400,14 @@ void uart0_write_char(char c) { return; } } + + // wait for the Hardware FIFO + while(true) { + if(((USS(0) >> USTXC) & 0xff) <= (UART_TX_FIFO_SIZE - 2)) { + break; + } + } + if(c == '\n') { USF(0) = '\r'; } @@ -416,6 +424,14 @@ void uart1_write_char(char c) { return; } } + + // wait for the Hardware FIFO + while(true) { + if(((USS(1) >> USTXC) & 0xff) <= (UART_TX_FIFO_SIZE - 2)) { + break; + } + } + if(c == '\n') { USF(1) = '\r'; } @@ -469,11 +485,11 @@ void HardwareSerial::begin(unsigned long baud, byte config) { } if(_uart->rxEnabled) { - if (!_rx_buffer) + if(!_rx_buffer) _rx_buffer = new cbuf(SERIAL_RX_BUFFER_SIZE); } if(_uart->txEnabled) { - if (!_tx_buffer) + if(!_tx_buffer) _tx_buffer = new cbuf(SERIAL_TX_BUFFER_SIZE); } _written = false; From d15225430e0ecd419ee56c564e93381d58e7c80b Mon Sep 17 00:00:00 2001 From: Markus Sattler Date: Sun, 17 May 2015 13:53:31 +0200 Subject: [PATCH 56/78] Align the start of functions to the next power-of-two greater than 4, skipping up to 3 bytes. --- platform.txt | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/platform.txt b/platform.txt index cd09aff98..9c197a832 100644 --- a/platform.txt +++ b/platform.txt @@ -15,7 +15,7 @@ compiler.sdk.path={compiler.tools.path}sdk/ compiler.cpreprocessor.flags=-D__ets__ -DICACHE_FLASH -U__STRICT_ANSI__ "-I{compiler.sdk.path}/include" compiler.c.cmd=xtensa-lx106-elf-gcc -compiler.c.flags=-c -Os -Wpointer-arith -Wno-implicit-function-declaration -Wl,-EL -fno-inline-functions -nostdlib -mlongcalls -mtext-section-literals -MMD -std=c99 +compiler.c.flags=-c -Os -Wpointer-arith -Wno-implicit-function-declaration -Wl,-EL -fno-inline-functions -nostdlib -mlongcalls -mtext-section-literals -falign-functions=4 -MMD -std=c99 compiler.S.cmd=xtensa-lx106-elf-gcc compiler.S.flags=-c -g -x assembler-with-cpp -MMD @@ -26,7 +26,7 @@ compiler.c.elf.cmd=xtensa-lx106-elf-gcc compiler.c.elf.libs=-lm -lgcc -lhal -lphy -lnet80211 -llwip -lwpa -lmain -lpp -lsmartconfig compiler.cpp.cmd=xtensa-lx106-elf-g++ -compiler.cpp.flags=-c -Os -mlongcalls -mtext-section-literals -fno-exceptions -fno-rtti -std=c++11 -MMD +compiler.cpp.flags=-c -Os -mlongcalls -mtext-section-literals -fno-exceptions -fno-rtti -falign-functions=4 -std=c++11 -MMD compiler.as.cmd=xtensa-lx106-elf-as From a4adfab517a47eaa3e74f3ec28558eb5b2a40b9b Mon Sep 17 00:00:00 2001 From: Markus Sattler Date: Sun, 17 May 2015 13:54:03 +0200 Subject: [PATCH 57/78] fix possible null ptr in EEPROM.cpp --- libraries/EEPROM/EEPROM.cpp | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-) diff --git a/libraries/EEPROM/EEPROM.cpp b/libraries/EEPROM/EEPROM.cpp index 2e1eb4fca..d0699c92e 100644 --- a/libraries/EEPROM/EEPROM.cpp +++ b/libraries/EEPROM/EEPROM.cpp @@ -41,7 +41,7 @@ EEPROMClass::EEPROMClass() void EEPROMClass::begin(size_t size) { - if (size < 0) + if (size <= 0) return; if (size > SPI_FLASH_SEC_SIZE) size = SPI_FLASH_SEC_SIZE; @@ -60,8 +60,9 @@ void EEPROMClass::end() return; commit(); - - delete[] _data; + if(_data) { + delete[] _data; + } _data = 0; _size = 0; } @@ -71,6 +72,8 @@ uint8_t EEPROMClass::read(int address) { if (address < 0 || (size_t)address >= _size) return 0; + if(!_data) + return 0; return _data[address]; } @@ -79,6 +82,8 @@ void EEPROMClass::write(int address, uint8_t value) { if (address < 0 || (size_t)address >= _size) return; + if(!_data) + return; _data[address] = value; _dirty = true; @@ -91,6 +96,8 @@ bool EEPROMClass::commit() return false; if(!_dirty) return true; + if(!_data) + return false; noInterrupts(); if(spi_flash_erase_sector(CONFIG_SECTOR) == SPI_FLASH_RESULT_OK) { From 0be310f5b0b2042e0024e1ac500420c4efc08958 Mon Sep 17 00:00:00 2001 From: Markus Sattler Date: Sun, 17 May 2015 14:55:11 +0200 Subject: [PATCH 58/78] add Exception Causes (EXCCAUSE) docu --- doc/exception_causes.md | 38 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 38 insertions(+) create mode 100644 doc/exception_causes.md diff --git a/doc/exception_causes.md b/doc/exception_causes.md new file mode 100644 index 000000000..4b11bdb13 --- /dev/null +++ b/doc/exception_causes.md @@ -0,0 +1,38 @@ +Exception Causes (EXCCAUSE) +=========================================== + +| EXC-CAUSE Code | Cause Name | Cause Description | Required Option | EXC-VADDR Loaded | +|:--------------:|:---------------------------|:------------------------------------------------------------------------------------------------------------|:-------------------------|:----------------:| +| 0 | IllegalInstructionCause | Illegal instruction | Exception | No | +| 1 | SyscallCause | SYSCALL instruction | Exception | No | +| 2 | InstructionFetchErrorCause | Processor internal physical address or data error during instruction fetch | Exception | Yes | +| 3 | LoadStoreErrorCause | Processor internal physical address or data error during load or store | Exception | Yes | +| 4 | Level1InterruptCause | Level-1 interrupt as indicated by set level-1 bits in the INTERRUPT register | Interrupt | No | +| 5 | AllocaCause | MOVSP instruction, if caller’s registers are not in the register file | Windowed Register | No | +| 6 | IntegerDivideByZeroCause | QUOS, QUOU, REMS, or REMU divisor operand is zero | 32-bit Integer Divide | No | +| 7 | Reserved for Tensilica | | | | +| 8 | PrivilegedCause | Attempt to execute a privileged operation when CRING ? 0 | MMU | No | +| 9 | LoadStoreAlignmentCause | Load or store to an unaligned address | Unaligned Exception | Yes | +| 10..11 | Reserved for Tensilica | | | | +| 12 | InstrPIFDataErrorCause | PIF data error during instruction fetch | Processor Interface | Yes | +| 13 | LoadStorePIFDataErrorCause | Synchronous PIF data error during LoadStore access | Processor Interface | Yes | +| 14 | InstrPIFAddrErrorCause | PIF address error during instruction fetch | Processor Interface | Yes | +| 15 | LoadStorePIFAddrErrorCause | Synchronous PIF address error during LoadStore access | Processor Interface | Yes | +| 16 | InstTLBMissCause | Error during Instruction TLB refill | MMU | Yes | +| 17 | InstTLBMultiHitCause | Multiple instruction TLB entries matched | MMU | Yes | +| 18 | InstFetchPrivilegeCause | An instruction fetch referenced a virtual address at a ring level less than CRING | MMU | Yes | +| 19 | Reserved for Tensilica | | | | +| 20 | InstFetchProhibitedCause | An instruction fetch referenced a page mapped with an attribute that does not permit instruction fetch | Region Protection or MMU | Yes | +| 21..23 | Reserved for Tensilica | | | | +| 24 | LoadStoreTLBMissCause | Error during TLB refill for a load or store | MMU | Yes | +| 25 | LoadStoreTLBMultiHitCause | Multiple TLB entries matched for a load or store | MMU | Yes | +| 26 | LoadStorePrivilegeCause | A load or store referenced a virtual address at a ring level less than CRING | MMU | Yes | +| 27 | Reserved for Tensilica | | | | +| 28 | LoadProhibitedCause | A load referenced a page mapped with an attribute that does not permit loads | Region Protection or MMU | Yes | +| 29 | StoreProhibitedCause | A store referenced a page mapped with an attribute that does not permit stores | Region Protection or MMU | Yes | +| 30..31 | Reserved for Tensilica | | | | +| 32..39 | CoprocessornDisabled | Coprocessor n instruction when cpn disabled. n varies 0..7 as the cause varies 32..39 | Coprocessor | No | +| 40..63 | Reserved | | | | + + +Infos from Xtensa Instruction Set Architecture (ISA) Reference Manual \ No newline at end of file From 0ac29dcd09a844bc4b35658116444cba26c899f0 Mon Sep 17 00:00:00 2001 From: Matt Jenkins Date: Sun, 17 May 2015 19:59:25 +0100 Subject: [PATCH 59/78] Added access point example --- .../WiFiAccessPoint/WiFiAccessPoint.ino | 70 +++++++++++++++++++ 1 file changed, 70 insertions(+) create mode 100644 libraries/ESP8266WiFi/examples/WiFiAccessPoint/WiFiAccessPoint.ino diff --git a/libraries/ESP8266WiFi/examples/WiFiAccessPoint/WiFiAccessPoint.ino b/libraries/ESP8266WiFi/examples/WiFiAccessPoint/WiFiAccessPoint.ino new file mode 100644 index 000000000..c1d7515cd --- /dev/null +++ b/libraries/ESP8266WiFi/examples/WiFiAccessPoint/WiFiAccessPoint.ino @@ -0,0 +1,70 @@ +/* + * Copyright (c) 2015, Majenko Technologies + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * * Redistributions of source code must retain the above copyright notice, this + * list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright notice, this + * list of conditions and the following disclaimer in the documentation and/or + * other materials provided with the distribution. + * + * * Neither the name of Majenko Technologies nor the names of its + * contributors may be used to endorse or promote products derived from + * this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND + * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED + * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE + * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR + * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES + * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; + * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON + * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ + +/* Create a WiFi access point and provide a web server on it. */ + +#include +#include + +/* Set these to your desired credentials. */ +const char *ssid = "ESPap"; +const char *password = "thereisnospoon"; + +ESP8266WebServer server(80); + +/* Just a little test message. Go to http://192.168.4.1 in a web browser + * connected to this access point to see it. + */ +void handleRoot() { + server.send(200, "text/html", "

You are connected

"); +} + +void setup() { + delay(1000); + Serial.begin(115200); + Serial.println(); + Serial.print("Configuring access point..."); + /* You can remove the password parameter if you want the AP to be open. */ + WiFi.softAP(ssid, password); + + while (WiFi.status() != WL_CONNECTED) { delay(500); Serial.print("."); } + + Serial.println("done"); + IPAddress myIP = WiFi.softAPIP(); + Serial.print("AP IP address: "); + Serial.println(myIP); + server.on("/", handleRoot); + server.begin(); + Serial.println("HTTP server started"); +} + +void loop() { + server.handleClient(); +} From af533d6c5c396dee198e5e91d8cd281a7ab474d5 Mon Sep 17 00:00:00 2001 From: Matt Jenkins Date: Sun, 17 May 2015 20:01:42 +0100 Subject: [PATCH 60/78] Added missing include needed for Arduino IDE --- .../ESP8266WiFi/examples/WiFiAccessPoint/WiFiAccessPoint.ino | 1 + 1 file changed, 1 insertion(+) diff --git a/libraries/ESP8266WiFi/examples/WiFiAccessPoint/WiFiAccessPoint.ino b/libraries/ESP8266WiFi/examples/WiFiAccessPoint/WiFiAccessPoint.ino index c1d7515cd..9bd390064 100644 --- a/libraries/ESP8266WiFi/examples/WiFiAccessPoint/WiFiAccessPoint.ino +++ b/libraries/ESP8266WiFi/examples/WiFiAccessPoint/WiFiAccessPoint.ino @@ -31,6 +31,7 @@ /* Create a WiFi access point and provide a web server on it. */ #include +#include #include /* Set these to your desired credentials. */ From ca88cb2b67265d745b652711fb400c408d8da585 Mon Sep 17 00:00:00 2001 From: ficeto Date: Mon, 18 May 2015 04:54:27 +0300 Subject: [PATCH 61/78] Update to the latest SPIFFS git and cleanup Almost unmodified spiffs from github lots of NodeMCU leftovers are removed More proper names given to platform related files Adjusting the FS class for the changes --- cores/esp8266/FileSystem.cpp | 70 ++++-- cores/esp8266/FileSystem.h | 13 +- cores/esp8266/spiffs/{docs => }/INTEGRATION | 2 +- cores/esp8266/spiffs/Makefile | 44 ---- cores/esp8266/spiffs/README | 86 ++++++++ cores/esp8266/spiffs/{docs => }/TECH_SPEC | 0 cores/esp8266/spiffs/TODO | 15 ++ cores/esp8266/spiffs/flashmem.h | 73 ------ cores/esp8266/spiffs/spiffs.c | 148 ------------- cores/esp8266/spiffs/spiffs.h | 112 +++++++--- cores/esp8266/spiffs/spiffs_cache.c | 0 cores/esp8266/spiffs/spiffs_check.c | 4 +- cores/esp8266/spiffs/spiffs_config.h | 44 ++-- cores/esp8266/spiffs/spiffs_esp8266.c | 224 +++++++++++++++++++ cores/esp8266/spiffs/spiffs_esp8266.h | 40 ++++ cores/esp8266/spiffs/spiffs_flashmem.c | 232 -------------------- cores/esp8266/spiffs/spiffs_gc.c | 80 +++---- cores/esp8266/spiffs/spiffs_hydrogen.c | 166 +++++++++++--- cores/esp8266/spiffs/spiffs_nucleus.c | 170 +++++++++++--- cores/esp8266/spiffs/spiffs_nucleus.h | 49 ++++- 20 files changed, 877 insertions(+), 695 deletions(-) mode change 100755 => 100644 cores/esp8266/FileSystem.cpp mode change 100755 => 100644 cores/esp8266/FileSystem.h rename cores/esp8266/spiffs/{docs => }/INTEGRATION (99%) mode change 100755 => 100644 delete mode 100755 cores/esp8266/spiffs/Makefile create mode 100644 cores/esp8266/spiffs/README rename cores/esp8266/spiffs/{docs => }/TECH_SPEC (100%) mode change 100755 => 100644 create mode 100644 cores/esp8266/spiffs/TODO delete mode 100755 cores/esp8266/spiffs/flashmem.h delete mode 100755 cores/esp8266/spiffs/spiffs.c mode change 100755 => 100644 cores/esp8266/spiffs/spiffs.h mode change 100755 => 100644 cores/esp8266/spiffs/spiffs_cache.c mode change 100755 => 100644 cores/esp8266/spiffs/spiffs_check.c mode change 100755 => 100644 cores/esp8266/spiffs/spiffs_config.h create mode 100644 cores/esp8266/spiffs/spiffs_esp8266.c create mode 100644 cores/esp8266/spiffs/spiffs_esp8266.h delete mode 100755 cores/esp8266/spiffs/spiffs_flashmem.c mode change 100755 => 100644 cores/esp8266/spiffs/spiffs_gc.c mode change 100755 => 100644 cores/esp8266/spiffs/spiffs_hydrogen.c mode change 100755 => 100644 cores/esp8266/spiffs/spiffs_nucleus.c mode change 100755 => 100644 cores/esp8266/spiffs/spiffs_nucleus.h diff --git a/cores/esp8266/FileSystem.cpp b/cores/esp8266/FileSystem.cpp old mode 100755 new mode 100644 index 802029a8d..735bb7d4a --- a/cores/esp8266/FileSystem.cpp +++ b/cores/esp8266/FileSystem.cpp @@ -22,49 +22,71 @@ #include "Arduino.h" bool FSClass::mount() { - if (_mounted) - return true; - - _mounted = spiffs_mount(); - return _mounted; + if(SPIFFS_mounted(&_filesystemStorageHandle)) return true; + int res = spiffs_mount(); + if(res != 0){ + int formated = SPIFFS_format(&_filesystemStorageHandle); + if(formated != 0) return false; + res = spiffs_mount(); + } + return (res == 0); } void FSClass::unmount() { - if (!_mounted) - return; - - spiffs_unmount(); - _mounted = false; + if(SPIFFS_mounted(&_filesystemStorageHandle)) + SPIFFS_unmount(&_filesystemStorageHandle); } bool FSClass::format() { - return spiffs_format(); + if(!SPIFFS_mounted(&_filesystemStorageHandle)){ + spiffs_mount(); + } + SPIFFS_unmount(&_filesystemStorageHandle); + int formated = SPIFFS_format(&_filesystemStorageHandle); + if(formated != 0) return false; + return (spiffs_mount() == 0); } bool FSClass::check() { return SPIFFS_check(&_filesystemStorageHandle) == 0; } -bool FSClass::exists(const char *filename) { +bool FSClass::exists(char *filename) { spiffs_stat stat = {0}; if (SPIFFS_stat(&_filesystemStorageHandle, filename, &stat) < 0) return false; return stat.name[0] != '\0'; } -bool FSClass::create(const char *filepath){ +bool FSClass::create(char *filepath){ return SPIFFS_creat(&_filesystemStorageHandle, filepath, 0) == 0; } -bool FSClass::remove(const char *filepath){ +bool FSClass::remove(char *filepath){ return SPIFFS_remove(&_filesystemStorageHandle, filepath) == 0; } -bool FSClass::rename(const char *filename, const char *newname) { +bool FSClass::rename(char *filename, char *newname) { return SPIFFS_rename(&_filesystemStorageHandle, filename, newname) == 0; } -FSFile FSClass::open(const char *filename, uint8_t mode) { +size_t FSClass::totalBytes(){ + u32_t totalBytes; + u32_t usedBytes; + if(SPIFFS_info(&_filesystemStorageHandle, &totalBytes, &usedBytes) == 0) + return totalBytes; + return 0; +} + +size_t FSClass::usedBytes(){ + u32_t totalBytes; + u32_t usedBytes; + if(SPIFFS_info(&_filesystemStorageHandle, &totalBytes, &usedBytes) == 0) + return usedBytes; + return 0; +} + +FSFile FSClass::open(char *filename, uint8_t mode) { if(String(filename) == "" || String(filename) == "/") return FSFile("/"); int repeats = 0; bool notExist; @@ -76,7 +98,7 @@ FSFile FSClass::open(const char *filename, uint8_t mode) { res = SPIFFS_open(&_filesystemStorageHandle, filename, (spiffs_flags)mode, 0); int code = SPIFFS_errno(&_filesystemStorageHandle); if (res < 0){ - debugf("open errno %d\n", code); + SPIFFS_API_DBG_E("open errno %d\n", code); notExist = (code == SPIFFS_ERR_NOT_FOUND || code == SPIFFS_ERR_DELETED || code == SPIFFS_ERR_FILE_DELETED || code == SPIFFS_ERR_IS_FREE); if (notExist && canRecreate) remove(filename); // fix for deleted files @@ -112,11 +134,11 @@ FSFile::FSFile(String path) { _stats.type = SPIFFS_TYPE_DIR; SPIFFS_opendir(&_filesystemStorageHandle, (char*)_stats.name, &_dir); } else { - _file = SPIFFS_open(&_filesystemStorageHandle, path.c_str(), (spiffs_flags)FSFILE_READ, 0); + _file = SPIFFS_open(&_filesystemStorageHandle, (char *)path.c_str(), (spiffs_flags)FSFILE_READ, 0); if(SPIFFS_fstat(&_filesystemStorageHandle, _file, &_stats) != 0){ - debugf("stats errno %d\n", SPIFFS_errno(&_filesystemStorageHandle)); + SPIFFS_API_DBG_E("fstat errno %d\n", SPIFFS_errno(&_filesystemStorageHandle)); } - debugf("FSFile name: %s, size: %d, type: %d\n", _stats.name, _stats.size, _stats.type); + //debugf("FSFile name: %s, size: %d, type: %d\n", _stats.name, _stats.size, _stats.type); if(_stats.type == SPIFFS_TYPE_DIR){ SPIFFS_opendir(&_filesystemStorageHandle, (char*)_stats.name, &_dir); } @@ -126,9 +148,9 @@ FSFile::FSFile(String path) { FSFile::FSFile(file_t f) { _file = f; if(SPIFFS_fstat(&_filesystemStorageHandle, _file, &_stats) != 0){ - debugf("stats errno %d\n", SPIFFS_errno(&_filesystemStorageHandle)); + SPIFFS_API_DBG_E("fstat errno %d\n", SPIFFS_errno(&_filesystemStorageHandle)); } - debugf("FSFile name: %s, size: %d, type: %d\n", _stats.name, _stats.size, _stats.type); + //debugf("FSFile name: %s, size: %d, type: %d\n", _stats.name, _stats.size, _stats.type); if(_stats.type == SPIFFS_TYPE_DIR){ SPIFFS_opendir(&_filesystemStorageHandle, (char*)_stats.name, &_dir); } @@ -237,7 +259,7 @@ void FSFile::flush(){ bool FSFile::remove(){ if (! _file) return 0; close(); - return SPIFFS_remove(&_filesystemStorageHandle, (const char *)_stats.name) == 0; + return SPIFFS_remove(&_filesystemStorageHandle, (char *)_stats.name) == 0; } int FSFile::lastError(){ @@ -245,5 +267,5 @@ int FSFile::lastError(){ } void FSFile::clearError(){ - _filesystemStorageHandle.errno = SPIFFS_OK; + _filesystemStorageHandle.err_code = SPIFFS_OK; } diff --git a/cores/esp8266/FileSystem.h b/cores/esp8266/FileSystem.h old mode 100755 new mode 100644 index 9d3a52eac..41659da11 --- a/cores/esp8266/FileSystem.h +++ b/cores/esp8266/FileSystem.h @@ -85,17 +85,18 @@ public: class FSClass { private: - bool _mounted = false; public: bool mount(); void unmount(); bool format(); bool check(); - bool exists(const char *filename); - bool create(const char *filepath); - bool remove(const char *filepath); - bool rename(const char *filename, const char *newname); + bool exists(char *filename); + bool create(char *filepath); + bool remove(char *filepath); + bool rename(char *filename, char *newname); + size_t totalBytes(); + size_t usedBytes(); size_t size(){ return _filesystemStorageHandle.cfg.phys_size; } size_t blockSize(){ return _filesystemStorageHandle.cfg.log_block_size; } size_t totalBlocks(){ return _filesystemStorageHandle.block_count; } @@ -104,7 +105,7 @@ public: size_t allocatedPages(){ return _filesystemStorageHandle.stats_p_allocated; } size_t deletedPages(){ return _filesystemStorageHandle.stats_p_deleted; } - FSFile open(const char *filename, uint8_t mode = FSFILE_READ); + FSFile open(char *filename, uint8_t mode = FSFILE_READ); FSFile open(spiffs_dirent* entry, uint8_t mode = FSFILE_READ); private: diff --git a/cores/esp8266/spiffs/docs/INTEGRATION b/cores/esp8266/spiffs/INTEGRATION old mode 100755 new mode 100644 similarity index 99% rename from cores/esp8266/spiffs/docs/INTEGRATION rename to cores/esp8266/spiffs/INTEGRATION index 085ed8fc1..20ff70d05 --- a/cores/esp8266/spiffs/docs/INTEGRATION +++ b/cores/esp8266/spiffs/INTEGRATION @@ -303,4 +303,4 @@ Having these figures you can disable SPIFFS_BUFFER_HELP again to save flash. * HOW TO CONFIG -TODO \ No newline at end of file +TODO diff --git a/cores/esp8266/spiffs/Makefile b/cores/esp8266/spiffs/Makefile deleted file mode 100755 index 1c44e4ace..000000000 --- a/cores/esp8266/spiffs/Makefile +++ /dev/null @@ -1,44 +0,0 @@ - -############################################################# -# Required variables for each makefile -# Discard this section from all parent makefiles -# Expected variables (with automatic defaults): -# CSRCS (all "C" files in the dir) -# SUBDIRS (all subdirs with a Makefile) -# GEN_LIBS - list of libs to be generated () -# GEN_IMAGES - list of images to be generated () -# COMPONENTS_xxx - a list of libs/objs in the form -# subdir/lib to be extracted and rolled up into -# a generated lib/image xxx.a () -# -ifndef PDIR -GEN_LIBS = spiffs.a -endif - -############################################################# -# Configuration i.e. compile options etc. -# Target specific stuff (defines etc.) goes in here! -# Generally values applying to a tree are captured in the -# makefile at its root level - these are then overridden -# for a subtree within the makefile rooted therein -# -#DEFINES += - -############################################################# -# Recursion Magic - Don't touch this!! -# -# Each subtree potentially has an include directory -# corresponding to the common APIs applicable to modules -# rooted at that subtree. Accordingly, the INCLUDE PATH -# of a module can only contain the include directories up -# its parent path, and not its siblings -# -# Required for each makefile to inherit from the parent -# - -INCLUDES := $(INCLUDES) -I $(PDIR)include -INCLUDES += -I ./ -INCLUDES += -I ../libc -INCLUDES += -I ../platform -PDIR := ../$(PDIR) -sinclude $(PDIR)Makefile diff --git a/cores/esp8266/spiffs/README b/cores/esp8266/spiffs/README new file mode 100644 index 000000000..6efd656cb --- /dev/null +++ b/cores/esp8266/spiffs/README @@ -0,0 +1,86 @@ +SPIFFS (SPI Flash File System) +V0.3.0 + +Copyright (c) 2013-2015 Peter Andersson (pelleplutt1976gmail.com) + +For legal stuff, see LICENCE in this directory. Basically, you may do whatever +you want with the source. Use, modify, sell, print it out, roll it and smoke it + - as long as I won't be held responsible. + +Love to hear feedback though! + + +* INTRODUCTION + +Spiffs is a file system intended for SPI NOR flash devices on embedded targets. + +Spiffs is designed with following characteristics in mind: + - Small (embedded) targets, sparse RAM without heap + - Only big areas of data (blocks) can be erased + - An erase will reset all bits in block to ones + - Writing pulls one to zeroes + - Zeroes can only be pulled to ones by erase + - Wear leveling + + +* FEATURES + +What spiffs does: + - Specifically designed for low ram usage + - Uses statically sized ram buffers, independent of number of files + - Posix-like api: open, close, read, write, seek, stat, etc + - It can be run on any NOR flash, not only SPI flash - theoretically also on + embedded flash of an microprocessor + - Multiple spiffs configurations can be run on same target - and even on same + SPI flash device + - Implements static wear leveling + - Built in file system consistency checks + +What spiffs does not: + - Presently, spiffs does not support directories. It produces a flat + structure. Creating a file with path "tmp/myfile.txt" will create a file + called "tmp/myfile.txt" instead of a "myfile.txt" under directory "tmp". + - It is not a realtime stack. One write operation might take much longer than + another. + - Poor scalability. Spiffs is intended for small memory devices - the normal + sizes for SPI flashes. Going beyond ~128MB is probably a bad idea. This is + a side effect of the design goal to use as little ram as possible. + - Presently, it does not detect or handle bad blocks. + + +* MORE INFO + +For integration, see the docs/INTEGRATION file. + +For use and design, see the docs/TECH_SPEC file. + +For testing and contributions, see the docs/IMPLEMENTING file. + +* HISTORY + +0.3.0 + Added existing namecheck when creating files + Lots of static analysis bugs #6 + Added rename func + Fix SPIFFS_read length when reading beyond file size + Added reading beyond file length testcase + Made build a bit more configurable + Changed name in spiffs from "errno" to "err_code" due to conflicts compiling + in mingw + Improved GC checks, fixed an append bug, more robust truncate for very special + case + GC checks preempts GC, truncate even less picky + Struct alignment needed for some targets, define in spiffs config #10 + Spiffs filesystem magic, definable in config + + New config defines: + SPIFFS_USE_MAGIC - enable or disable magic check upon mount + SPIFFS_ALIGNED_OBJECT_INDEX_TABLES - alignment for certain targets + New API functions: + SPIFFS_rename - rename files + SPIFFS_clearerr - clears last errno + SPIFFS_info - returns info on used and total bytes in fs + SPIFFS_format - formats the filesystem + SPIFFS_mounted - checks if filesystem is mounted + + diff --git a/cores/esp8266/spiffs/docs/TECH_SPEC b/cores/esp8266/spiffs/TECH_SPEC old mode 100755 new mode 100644 similarity index 100% rename from cores/esp8266/spiffs/docs/TECH_SPEC rename to cores/esp8266/spiffs/TECH_SPEC diff --git a/cores/esp8266/spiffs/TODO b/cores/esp8266/spiffs/TODO new file mode 100644 index 000000000..c947316a8 --- /dev/null +++ b/cores/esp8266/spiffs/TODO @@ -0,0 +1,15 @@ +* When mending lost pages, also see if they fit into length specified in object index header + +SPIFFS2 thoughts + +* Instead of exact object id:s in the object lookup tables, use a hash of span index and object id. + Eg. object id xor:ed with bit-reversed span index. + This should decrease number of actual pages that needs to be visited when looking thru the obj lut. + +* Logical number of each block. When moving stuff in a garbage collected page, the free + page is assigned the same number as the garbage collected. Thus, object index pages do not have to + be rewritten. + +* Steal one page, use as a bit parity page. When starting an fs modification operation, write one bit + as zero. When ending, write another bit as zero. On mount, if number of zeroes in page is uneven, a + check is automatically run. \ No newline at end of file diff --git a/cores/esp8266/spiffs/flashmem.h b/cores/esp8266/spiffs/flashmem.h deleted file mode 100755 index c4f4252a1..000000000 --- a/cores/esp8266/spiffs/flashmem.h +++ /dev/null @@ -1,73 +0,0 @@ -// Based on NodeMCU platform_flash -// https://github.com/nodemcu/nodemcu-firmware - -#ifndef SYSTEM_FLASHMEM_H_ -#define SYSTEM_FLASHMEM_H_ - -#ifdef __cplusplus -extern "C" { -#endif - -#include "spiffs.h" -#include "spi_flash.h" - -#define INTERNAL_FLASH_WRITE_UNIT_SIZE 4 -#define INTERNAL_FLASH_READ_UNIT_SIZE 4 - -#define FLASH_TOTAL_SEC_COUNT (flashmem_get_size_sectors()) - -#define SYS_PARAM_SEC_COUNT 4 -#define FLASH_WORK_SEC_COUNT (FLASH_TOTAL_SEC_COUNT - SYS_PARAM_SEC_COUNT) - -#define INTERNAL_FLASH_SECTOR_SIZE SPI_FLASH_SEC_SIZE -#define INTERNAL_FLASH_SIZE ( (FLASH_WORK_SEC_COUNT) * INTERNAL_FLASH_SECTOR_SIZE ) -#define INTERNAL_FLASH_START_ADDRESS 0x40200000 - -typedef struct -{ - uint8_t unknown0; - uint8_t unknown1; - enum - { - MODE_QIO = 0, - MODE_QOUT = 1, - MODE_DIO = 2, - MODE_DOUT = 15, - } mode : 8; - enum - { - SPEED_40MHZ = 0, - SPEED_26MHZ = 1, - SPEED_20MHZ = 2, - SPEED_80MHZ = 15, - } speed : 4; - enum - { - SIZE_4MBIT = 0, - SIZE_2MBIT = 1, - SIZE_8MBIT = 2, - SIZE_16MBIT = 3, - SIZE_32MBIT = 4, - } size : 4; -} STORE_TYPEDEF_ATTR SPIFlashInfo; - -extern uint32_t flashmem_write( const void *from, uint32_t toaddr, uint32_t size ); -extern uint32_t flashmem_read( void *to, uint32_t fromaddr, uint32_t size ); -extern bool flashmem_erase_sector( uint32_t sector_id ); - -extern SPIFlashInfo flashmem_get_info(); -extern uint8_t flashmem_get_size_type(); -extern uint32_t flashmem_get_size_bytes(); -extern uint16_t flashmem_get_size_sectors(); -uint32_t flashmem_find_sector( uint32_t address, uint32_t *pstart, uint32_t *pend ); -uint32_t flashmem_get_sector_of_address( uint32_t addr ); - -extern uint32_t flashmem_write_internal( const void *from, uint32_t toaddr, uint32_t size ); -extern uint32_t flashmem_read_internal( void *to, uint32_t fromaddr, uint32_t size ); -extern uint32_t flashmem_get_first_free_block_address(); - -#ifdef __cplusplus -} -#endif - -#endif /* SYSTEM_FLASHMEM_H_ */ diff --git a/cores/esp8266/spiffs/spiffs.c b/cores/esp8266/spiffs/spiffs.c deleted file mode 100755 index 74a65e05d..000000000 --- a/cores/esp8266/spiffs/spiffs.c +++ /dev/null @@ -1,148 +0,0 @@ -#include "spiffs.h" - -#define LOG_PAGE_SIZE 256 - -spiffs _filesystemStorageHandle; - -static u8_t spiffs_work_buf[LOG_PAGE_SIZE*2]; -static u8_t spiffs_fds[32*4]; -static u8_t spiffs_cache[(LOG_PAGE_SIZE+32)*4]; - -static s32_t api_spiffs_read(u32_t addr, u32_t size, u8_t *dst){ - flashmem_read(dst, addr, size); - return SPIFFS_OK; -} - -static s32_t api_spiffs_write(u32_t addr, u32_t size, u8_t *src){ - flashmem_write(src, addr, size); - return SPIFFS_OK; -} - -static s32_t api_spiffs_erase(u32_t addr, u32_t size){ - debugf("api_spiffs_erase"); - u32_t sect_first = flashmem_get_sector_of_address(addr); - u32_t sect_last = flashmem_get_sector_of_address(addr+size); - while( sect_first <= sect_last ) - if( !flashmem_erase_sector( sect_first ++ ) ) - return SPIFFS_ERR_INTERNAL; - return SPIFFS_OK; -} - -/******************* -The W25Q32BV array is organized into 16,384 programmable pages of 256-bytes each. Up to 256 bytes can be programmed at a time. -Pages can be erased in groups of 16 (4KB sector erase), groups of 128 (32KB block erase), groups of 256 (64KB block erase) or -the entire chip (chip erase). The W25Q32BV has 1,024 erasable sectors and 64 erasable blocks respectively. -The small 4KB sectors allow for greater flexibility in applications that require data and parameter storage. -********************/ - -extern uint32_t _SPIFFS_start; -extern uint32_t _SPIFFS_end; - -spiffs_config spiffs_get_storage_config() -{ - spiffs_config cfg = {0}; - if ((u32_t)&_SPIFFS_start == 0) return cfg; - cfg.phys_addr = (u32_t)&_SPIFFS_start; - cfg.phys_size = (u32_t)((u32_t)&_SPIFFS_end - (u32_t)&_SPIFFS_start); - cfg.phys_erase_block = INTERNAL_FLASH_SECTOR_SIZE; // according to datasheet - cfg.log_block_size = INTERNAL_FLASH_SECTOR_SIZE * 2; // Important to make large - cfg.log_page_size = LOG_PAGE_SIZE; // as we said - return cfg; -} - -bool spiffs_format_internal(){ - spiffs_config cfg = spiffs_get_storage_config(); - if (cfg.phys_addr == 0){ - SYSTEM_ERROR("Can't format file system, wrong address"); - return false; - } - - u32_t sect_first, sect_last; - sect_first = flashmem_get_sector_of_address((u32_t)&_SPIFFS_start); - sect_last = flashmem_get_sector_of_address((u32_t)&_SPIFFS_end); - debugf("sect_first: %x, sect_last: %x\n", sect_first, sect_last); - while( sect_first <= sect_last ){ - if(!flashmem_erase_sector( sect_first ++ )) - return false; - } - return true; -} - -bool spiffs_mount_internal(bool wipe){ - spiffs_config cfg = spiffs_get_storage_config(); - if (cfg.phys_addr == 0){ - SYSTEM_ERROR("Can't start file system, wrong address"); - return false; - } - - debugf("fs.start:%x, size:%d Kb\n", cfg.phys_addr, cfg.phys_size / 1024); - - cfg.hal_read_f = api_spiffs_read; - cfg.hal_write_f = api_spiffs_write; - cfg.hal_erase_f = api_spiffs_erase; - - uint32_t dat; - bool writeFirst = false; - flashmem_read(&dat, cfg.phys_addr, 4); - - if (dat == UINT32_MAX || wipe){ - debugf("First init file system"); - if(!spiffs_format_internal()){ - SYSTEM_ERROR("Can't format file system"); - return false; - } - writeFirst = true; - } - - int res = SPIFFS_mount(&_filesystemStorageHandle, - &cfg, - spiffs_work_buf, - spiffs_fds, - sizeof(spiffs_fds), - spiffs_cache, - sizeof(spiffs_cache), - NULL); - debugf("mount res: %d\n", res); - - if(res != 0) return false; - - if (writeFirst){ - file_t fd = SPIFFS_open(&_filesystemStorageHandle, "initialize_fs_header.dat", SPIFFS_CREAT | SPIFFS_TRUNC | SPIFFS_RDWR, 0); - SPIFFS_write(&_filesystemStorageHandle, fd, (u8_t *)"1", 1); - SPIFFS_fremove(&_filesystemStorageHandle, fd); - SPIFFS_close(&_filesystemStorageHandle, fd); - } - return true; -} - -bool spiffs_mount(){ - return spiffs_mount_internal(false); -} - -void spiffs_unmount(){ - SPIFFS_unmount(&_filesystemStorageHandle); -} - -bool spiffs_format(){ - spiffs_unmount(); - return spiffs_mount_internal(true); -} - -void test_spiffs(){ - char buf[12] = {0}; - spiffs_file fd; - spiffs_stat st = {0}; - SPIFFS_stat(&_filesystemStorageHandle, "my_file.txt", &st); - if (st.size <= 0){ - fd = SPIFFS_open(&_filesystemStorageHandle, "my_file.txt", SPIFFS_CREAT | SPIFFS_TRUNC | SPIFFS_RDWR, 0); - if (SPIFFS_write(&_filesystemStorageHandle, fd, (u8_t *)"Hello world", 11) < 0) - debugf("errno %d\n", SPIFFS_errno(&_filesystemStorageHandle)); - SPIFFS_close(&_filesystemStorageHandle, fd); - debugf("file created"); - } else debugf("file %s exist :)", st.name); - - fd = SPIFFS_open(&_filesystemStorageHandle, "my_file.txt", SPIFFS_RDWR, 0); - if (SPIFFS_read(&_filesystemStorageHandle, fd, (u8_t *)buf, 11) < 0) debugf("errno %d\n", SPIFFS_errno(&_filesystemStorageHandle)); - SPIFFS_close(&_filesystemStorageHandle, fd); - debugf("--> %s <--\n", buf); -} diff --git a/cores/esp8266/spiffs/spiffs.h b/cores/esp8266/spiffs/spiffs.h old mode 100755 new mode 100644 index 6357b44a7..7df7ae049 --- a/cores/esp8266/spiffs/spiffs.h +++ b/cores/esp8266/spiffs/spiffs.h @@ -5,15 +5,15 @@ * Author: petera */ + + #ifndef SPIFFS_H_ #define SPIFFS_H_ - #ifdef __cplusplus extern "C" { #endif #include "spiffs_config.h" -#include "flashmem.h" #define SPIFFS_OK 0 #define SPIFFS_ERR_NOT_MOUNTED -10000 @@ -40,6 +40,13 @@ extern "C" { #define SPIFFS_ERR_NOT_WRITABLE -10021 #define SPIFFS_ERR_NOT_READABLE -10022 #define SPIFFS_ERR_CONFLICTING_NAME -10023 +#define SPIFFS_ERR_NOT_CONFIGURED -10024 + +#define SPIFFS_ERR_NOT_A_FS -10025 +#define SPIFFS_ERR_MOUNTED -10026 +#define SPIFFS_ERR_ERASE_FAIL -10027 +#define SPIFFS_ERR_MAGIC_NOT_POSSIBLE -10028 + #define SPIFFS_ERR_INTERNAL -10050 @@ -81,19 +88,21 @@ typedef enum { } spiffs_check_report; /* file system check callback function */ -typedef void (*spiffs_check_callback)(spiffs_check_type type, spiffs_check_report report, u32_t arg1, u32_t arg2); +typedef void (*spiffs_check_callback)(spiffs_check_type type, spiffs_check_report report, + u32_t arg1, u32_t arg2); #ifndef SPIFFS_DBG -#define SPIFFS_DBG(...) printf(__VA_ARGS__) +#define SPIFFS_DBG(...) \ + print(__VA_ARGS__) #endif #ifndef SPIFFS_GC_DBG -#define SPIFFS_GC_DBG(...) printf(__VA_ARGS__) +#define SPIFFS_GC_DBG(...) c_printf(__VA_ARGS__) #endif #ifndef SPIFFS_CACHE_DBG -#define SPIFFS_CACHE_DBG(...) printf(__VA_ARGS__) +#define SPIFFS_CACHE_DBG(...) c_printf(__VA_ARGS__) #endif #ifndef SPIFFS_CHECK_DBG -#define SPIFFS_CHECK_DBG(...) printf(__VA_ARGS__) +#define SPIFFS_CHECK_DBG(...) c_printf(__VA_ARGS__) #endif /* Any write to the filehandle is appended to end of the file */ @@ -182,7 +191,7 @@ typedef struct { u32_t fd_count; // last error - s32_t errno; + s32_t err_code; // current number of free blocks u32_t free_blocks; @@ -212,6 +221,11 @@ typedef struct { // check callback function spiffs_check_callback check_cb_f; + + // mounted flag + u8_t mounted; + // config magic + u32_t config_magic; } spiffs; /* spiffs file status struct */ @@ -239,7 +253,10 @@ typedef struct { // functions /** - * Initializes the file system dynamic parameters and mounts the filesystem + * Initializes the file system dynamic parameters and mounts the filesystem. + * If SPIFFS_USE_MAGIC is enabled the mounting may fail with SPIFFS_ERR_NOT_A_FS + * if the flash does not contain a recognizable file system. + * In this case, SPIFFS_format must be called prior to remounting. * @param fs the file system struct * @param config the physical and logical configuration of the file system * @param work a memory work buffer comprising 2*config->log_page_size @@ -268,7 +285,7 @@ void SPIFFS_unmount(spiffs *fs); * @param path the path of the new file * @param mode ignored, for posix compliance */ -s32_t SPIFFS_creat(spiffs *fs, const char *path, spiffs_mode mode); +s32_t SPIFFS_creat(spiffs *fs, char *path, spiffs_mode mode); /** * Opens/creates a file. @@ -279,7 +296,8 @@ s32_t SPIFFS_creat(spiffs *fs, const char *path, spiffs_mode mode); * SPIFFS_WR_ONLY, SPIFFS_RDWR, SPIFFS_DIRECT * @param mode ignored, for posix compliance */ -spiffs_file SPIFFS_open(spiffs *fs, const char *path, spiffs_flags flags, spiffs_mode mode); +spiffs_file SPIFFS_open(spiffs *fs, char *path, spiffs_flags flags, spiffs_mode mode); + /** * Opens a file by given dir entry. @@ -304,7 +322,7 @@ spiffs_file SPIFFS_open_by_dirent(spiffs *fs, struct spiffs_dirent *e, spiffs_fl * @param len how much to read * @returns number of bytes read, or -1 if error */ -s32_t SPIFFS_read(spiffs *fs, spiffs_file fh, void *buf, u32_t len); +s32_t SPIFFS_read(spiffs *fs, spiffs_file fh, void *buf, s32_t len); /** * Writes to given filehandle. @@ -314,7 +332,7 @@ s32_t SPIFFS_read(spiffs *fs, spiffs_file fh, void *buf, u32_t len); * @param len how much to write * @returns number of bytes written, or -1 if error */ -s32_t SPIFFS_write(spiffs *fs, spiffs_file fh, void *buf, u32_t len); +s32_t SPIFFS_write(spiffs *fs, spiffs_file fh, void *buf, s32_t len); /** * Moves the read/write file offset @@ -332,7 +350,7 @@ s32_t SPIFFS_lseek(spiffs *fs, spiffs_file fh, s32_t offs, int whence); * @param fs the file system struct * @param path the path of the file to remove */ -s32_t SPIFFS_remove(spiffs *fs, const char *path); +s32_t SPIFFS_remove(spiffs *fs, char *path); /** * Removes a file by filehandle @@ -347,7 +365,7 @@ s32_t SPIFFS_fremove(spiffs *fs, spiffs_file fh); * @param path the path of the file to stat * @param s the stat struct to populate */ -s32_t SPIFFS_stat(spiffs *fs, const char *path, spiffs_stat *s); +s32_t SPIFFS_stat(spiffs *fs, char *path, spiffs_stat *s); /** * Gets file status by filehandle @@ -375,9 +393,9 @@ void SPIFFS_close(spiffs *fs, spiffs_file fh); * Renames a file * @param fs the file system struct * @param old path of file to rename - * @param new new path of file + * @param newPath new path of file */ -s32_t SPIFFS_rename(spiffs *fs, const char *old, const char *newname); +s32_t SPIFFS_rename(spiffs *fs, char *old, char *newPath); /** * Returns last error of last file operation. @@ -385,6 +403,12 @@ s32_t SPIFFS_rename(spiffs *fs, const char *old, const char *newname); */ s32_t SPIFFS_errno(spiffs *fs); +/** + * Clears last error. + * @param fs the file system struct + */ +void SPIFFS_clearerr(spiffs *fs); + /** * Opens a directory stream corresponding to the given name. * The stream is positioned at the first entry in the directory. @@ -394,7 +418,7 @@ s32_t SPIFFS_errno(spiffs *fs); * @param name the name of the directory * @param d pointer the directory stream to be populated */ -spiffs_DIR *SPIFFS_opendir(spiffs *fs, const char *name, spiffs_DIR *d); +spiffs_DIR *SPIFFS_opendir(spiffs *fs, char *name, spiffs_DIR *d); /** * Closes a directory stream @@ -416,12 +440,51 @@ struct spiffs_dirent *SPIFFS_readdir(spiffs_DIR *d, struct spiffs_dirent *e); */ s32_t SPIFFS_check(spiffs *fs); + +/** + * Returns number of total bytes available and number of used bytes. + * This is an estimation, and depends on if there a many files with little + * data or few files with much data. + * NB: If used number of bytes exceeds total bytes, a SPIFFS_check should + * run. This indicates a power loss in midst of things. In worst case + * (repeated powerlosses in mending or gc) you might have to delete some files. + * + * @param fs the file system struct + * @param total total number of bytes in filesystem + * @param used used number of bytes in filesystem + */ +s32_t SPIFFS_info(spiffs *fs, u32_t *total, u32_t *used); + +/** + * Formats the entire file system. All data will be lost. + * The filesystem must not be mounted when calling this. + * + * NB: formatting is awkward. Due to backwards compatibility, SPIFFS_mount + * MUST be called prior to formatting in order to configure the filesystem. + * If SPIFFS_mount succeeds, SPIFFS_unmount must be called before calling + * SPIFFS_format. + * If SPIFFS_mount fails, SPIFFS_format can be called directly without calling + * SPIFFS_unmount first. + */ +s32_t SPIFFS_format(spiffs *fs); + +/** + * Returns nonzero if spiffs is mounted, or zero if unmounted. + */ +u8_t SPIFFS_mounted(spiffs *fs); + /** * Check if EOF reached. * @param fs the file system struct * @param fh the filehandle of the file to check */ s32_t SPIFFS_eof(spiffs *fs, spiffs_file fh); + +/** + * Get the current position of the data pointer. + * @param fs the file system struct + * @param fh the filehandle of the open file + */ s32_t SPIFFS_tell(spiffs *fs, spiffs_file fh); #if SPIFFS_TEST_VISUALISATION @@ -448,19 +511,10 @@ u32_t SPIFFS_buffer_bytes_for_cache(spiffs *fs, u32_t num_pages); #endif #endif -#if SPIFFS_CACHE -#endif - - -bool spiffs_mount(); -void spiffs_unmount(); -bool spiffs_format(); -spiffs_config spiffs_get_storage_config(); -extern void test_spiffs(); - -extern spiffs _filesystemStorageHandle; +#include "spiffs_esp8266.h" #ifdef __cplusplus } #endif + #endif /* SPIFFS_H_ */ diff --git a/cores/esp8266/spiffs/spiffs_cache.c b/cores/esp8266/spiffs/spiffs_cache.c old mode 100755 new mode 100644 diff --git a/cores/esp8266/spiffs/spiffs_check.c b/cores/esp8266/spiffs/spiffs_check.c old mode 100755 new mode 100644 index aad355122..50bbb5c89 --- a/cores/esp8266/spiffs/spiffs_check.c +++ b/cores/esp8266/spiffs/spiffs_check.c @@ -597,7 +597,7 @@ static s32_t spiffs_page_consistency_check_i(spiffs *fs) { data_spix_offset + i, data_pix, cur_pix); if (res <= _SPIFFS_ERR_CHECK_FIRST && res > _SPIFFS_ERR_CHECK_LAST) { // index bad also, cannot mend this file - SPIFFS_CHECK_DBG("PA: FIXUP: index bad %u, cannot mend - delete object\n", res); + SPIFFS_CHECK_DBG("PA: FIXUP: index bad %d, cannot mend - delete object\n", res); if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_PAGE, SPIFFS_CHECK_DELETE_BAD_FILE, objix_p_hdr->obj_id, 0); // delete file res = spiffs_page_delete(fs, cur_pix); @@ -763,7 +763,7 @@ static s32_t spiffs_page_consistency_check_i(spiffs *fs) { res = spiffs_rewrite_index(fs, p_hdr.obj_id, p_hdr.span_ix, cur_pix, objix_pix); if (res <= _SPIFFS_ERR_CHECK_FIRST && res > _SPIFFS_ERR_CHECK_LAST) { // index bad also, cannot mend this file - SPIFFS_CHECK_DBG("PA: FIXUP: index bad %u, cannot mend!\n", res); + SPIFFS_CHECK_DBG("PA: FIXUP: index bad %d, cannot mend!\n", res); if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_PAGE, SPIFFS_CHECK_DELETE_BAD_FILE, p_hdr.obj_id, 0); res = spiffs_page_delete(fs, cur_pix); SPIFFS_CHECK_RES(res); diff --git a/cores/esp8266/spiffs/spiffs_config.h b/cores/esp8266/spiffs/spiffs_config.h old mode 100755 new mode 100644 index 095bef900..d59ac80b1 --- a/cores/esp8266/spiffs/spiffs_config.h +++ b/cores/esp8266/spiffs/spiffs_config.h @@ -8,24 +8,11 @@ #ifndef SPIFFS_CONFIG_H_ #define SPIFFS_CONFIG_H_ -// ----------- 8< ------------ -// Following includes are for the linux test build of spiffs -// These may/should/must be removed/altered/replaced in your target -// #include "params_test.h" -//#include "c_stdio.h" -//#include "c_stdlib.h" -//#include "c_string.h" #include "mem.h" #include "c_types.h" #include "stddef.h" #include "osapi.h" #include "ets_sys.h" -// ----------- >8 ------------ -#define IRAM_ATTR __attribute__((section(".iram.text"))) -#define STORE_TYPEDEF_ATTR __attribute__((aligned(4),packed)) -#define STORE_ATTR __attribute__((aligned(4))) - -#define SPIFFS_CHACHE 0 #define c_memcpy os_memcpy #define c_printf os_printf @@ -56,24 +43,22 @@ typedef uint8_t u8_t; #endif // compile time switches -#define debugf(fmt, ...) //os_printf(fmt"\r\n", ##__VA_ARGS__) -#define SYSTEM_ERROR(fmt, ...) //os_printf("ERROR: " fmt "\r\n", ##__VA_ARGS__) // Set generic spiffs debug output call. #ifndef SPIFFS_DGB -#define SPIFFS_DBG(...) //os_printf(__VA_ARGS__) +#define SPIFFS_DBG(...) //c_printf(__VA_ARGS__) #endif // Set spiffs debug output call for garbage collecting. #ifndef SPIFFS_GC_DGB -#define SPIFFS_GC_DBG(...) //os_printf(__VA_ARGS__) +#define SPIFFS_GC_DBG(...) //c_printf(__VA_ARGS__) #endif // Set spiffs debug output call for caching. #ifndef SPIFFS_CACHE_DGB -#define SPIFFS_CACHE_DBG(...) //os_printf(__VA_ARGS__) +#define SPIFFS_CACHE_DBG(...) //c_printf(__VA_ARGS__) #endif // Set spiffs debug output call for system consistency checks. #ifndef SPIFFS_CHECK_DGB -#define SPIFFS_CHECK_DBG(...) //os_printf(__VA_ARGS__) +#define SPIFFS_CHECK_DBG(...) //c_printf(__VA_ARGS__) #endif // Enable/disable API functions to determine exact number of bytes @@ -108,7 +93,7 @@ typedef uint8_t u8_t; // Define maximum number of gc runs to perform to reach desired free pages. #ifndef SPIFFS_GC_MAX_RUNS -#define SPIFFS_GC_MAX_RUNS 3 +#define SPIFFS_GC_MAX_RUNS 5 #endif // Enable/disable statistics on gc. Debug/test purpose only. @@ -150,14 +135,22 @@ typedef uint8_t u8_t; #define SPIFFS_COPY_BUFFER_STACK (64) #endif +// Enable this to have an identifiable spiffs filesystem. This will look for +// a magic in all sectors to determine if this is a valid spiffs system or +// not on mount point. If not, SPIFFS_format must be called prior to mounting +// again. +#ifndef SPIFFS_USE_MAGIC +#define SPIFFS_USE_MAGIC (0) +#endif + // SPIFFS_LOCK and SPIFFS_UNLOCK protects spiffs from reentrancy on api level // These should be defined on a multithreaded system -// define this to entering a mutex if you're running on a multithreaded system +// define this to enter a mutex if you're running on a multithreaded system #ifndef SPIFFS_LOCK #define SPIFFS_LOCK(fs) #endif -// define this to exiting a mutex if you're running on a multithreaded system +// define this to exit a mutex if you're running on a multithreaded system #ifndef SPIFFS_UNLOCK #define SPIFFS_UNLOCK(fs) #endif @@ -190,7 +183,12 @@ typedef uint8_t u8_t; #endif #endif -// Set SPFIFS_TEST_VISUALISATION to non-zero to enable SPIFFS_vis function +// Enable this if your target needs aligned data for index tables +#ifndef SPIFFS_ALIGNED_OBJECT_INDEX_TABLES +#define SPIFFS_ALIGNED_OBJECT_INDEX_TABLES 1 +#endif + +// Set SPIFFS_TEST_VISUALISATION to non-zero to enable SPIFFS_vis function // in the api. This function will visualize all filesystem using given printf // function. #ifndef SPIFFS_TEST_VISUALISATION diff --git a/cores/esp8266/spiffs/spiffs_esp8266.c b/cores/esp8266/spiffs/spiffs_esp8266.c new file mode 100644 index 000000000..56cf3813c --- /dev/null +++ b/cores/esp8266/spiffs/spiffs_esp8266.c @@ -0,0 +1,224 @@ +#include "spiffs_esp8266.h" +#include "spi_flash.h" +#include "esp8266_peri.h" +#include "Arduino.h" + +/* + FLASH ACCESS FUNCTIONS +*/ + +//lowest level sector erase method +bool flashmem_erase_sector( uint32_t sector_id ){ + WDT_RESET(); + noInterrupts(); + bool erased = spi_flash_erase_sector( sector_id ) == SPI_FLASH_RESULT_OK; + interrupts(); + return erased; +} + +//lowest level data write method +uint32_t flashmem_write_internal( const void *from, uint32_t toaddr, uint32_t size ){ + toaddr -= INTERNAL_FLASH_START_ADDRESS; + SpiFlashOpResult r; + const uint32_t blkmask = INTERNAL_FLASH_WRITE_UNIT_SIZE - 1; + uint32_t *apbuf = NULL; + if(((uint32_t)from) & blkmask){ + apbuf = (uint32_t *)os_malloc(size); + if(!apbuf) + return 0; + os_memcpy(apbuf, from, size); + } + WDT_RESET(); + noInterrupts(); + r = spi_flash_write(toaddr, apbuf?(uint32 *)apbuf:(uint32 *)from, size); + interrupts(); + if(apbuf) + os_free(apbuf); + if(SPI_FLASH_RESULT_OK == r) + return size; + else{ + SPIFFS_API_DBG_E( "ERROR in flash_write: r=%d at %08X\n", ( int )r, ( unsigned )toaddr+INTERNAL_FLASH_START_ADDRESS ); + return 0; + } +} + +//lowest level data read method +uint32_t flashmem_read_internal( void *to, uint32_t fromaddr, uint32_t size ){ + fromaddr -= INTERNAL_FLASH_START_ADDRESS; + SpiFlashOpResult r; + WDT_RESET(); + noInterrupts(); + r = spi_flash_read(fromaddr, (uint32 *)to, size); + interrupts(); + if(SPI_FLASH_RESULT_OK == r) + return size; + else{ + SPIFFS_API_DBG_E( "ERROR in flash_read: r=%d at %08X\n", ( int )r, ( unsigned )fromaddr+INTERNAL_FLASH_START_ADDRESS ); + return 0; + } +} + +//mid level data write method +uint32_t flashmem_write( const void *from, uint32_t toaddr, uint32_t size ){ + uint32_t temp, rest, ssize = size; + unsigned i; + char tmpdata[ INTERNAL_FLASH_WRITE_UNIT_SIZE ]; + const uint8_t *pfrom = ( const uint8_t* )from; + const uint32_t blksize = INTERNAL_FLASH_WRITE_UNIT_SIZE; + const uint32_t blkmask = INTERNAL_FLASH_WRITE_UNIT_SIZE - 1; + + // Align the start + if(toaddr & blkmask){ + rest = toaddr & blkmask; + temp = toaddr & ~blkmask; // this is the actual aligned address + // c_memcpy( tmpdata, ( const void* )temp, blksize ); + flashmem_read_internal( tmpdata, temp, blksize ); + for( i = rest; size && ( i < blksize ); i ++, size --, pfrom ++ ) + tmpdata[ i ] = *pfrom; + flashmem_write_internal( tmpdata, temp, blksize ); + if( size == 0 ) + return ssize; + toaddr = temp + blksize; + } + // The start address is now a multiple of blksize + // Compute how many bytes we can write as multiples of blksize + rest = size & blkmask; + temp = size & ~blkmask; + // Program the blocks now + if(temp){ + flashmem_write_internal( pfrom, toaddr, temp ); + toaddr += temp; + pfrom += temp; + } + // And the final part of a block if needed + if(rest){ + // c_memcpy( tmpdata, ( const void* )toaddr, blksize ); + flashmem_read_internal( tmpdata, toaddr, blksize ); + for( i = 0; size && ( i < rest ); i ++, size --, pfrom ++ ) + tmpdata[ i ] = *pfrom; + flashmem_write_internal( tmpdata, toaddr, blksize ); + } + return ssize; +} + +//mid level data write method +uint32_t flashmem_read( void *to, uint32_t fromaddr, uint32_t size ){ + uint32_t temp, rest, ssize = size; + unsigned i; + char tmpdata[ INTERNAL_FLASH_READ_UNIT_SIZE ]; + uint8_t *pto = ( uint8_t* )to; + const uint32_t blksize = INTERNAL_FLASH_READ_UNIT_SIZE; + const uint32_t blkmask = INTERNAL_FLASH_READ_UNIT_SIZE - 1; + + // Align the start + if(fromaddr & blkmask){ + rest = fromaddr & blkmask; + temp = fromaddr & ~blkmask; // this is the actual aligned address + flashmem_read_internal( tmpdata, temp, blksize ); + for( i = rest; size && ( i < blksize ); i ++, size --, pto ++ ) + *pto = tmpdata[ i ]; + + if( size == 0 ) + return ssize; + fromaddr = temp + blksize; + } + // The start address is now a multiple of blksize + // Compute how many bytes we can read as multiples of blksize + rest = size & blkmask; + temp = size & ~blkmask; + // Program the blocks now + if(temp){ + flashmem_read_internal( pto, fromaddr, temp ); + fromaddr += temp; + pto += temp; + } + // And the final part of a block if needed + if(rest){ + flashmem_read_internal( tmpdata, fromaddr, blksize ); + for( i = 0; size && ( i < rest ); i ++, size --, pto ++ ) + *pto = tmpdata[ i ]; + } + return ssize; +} + +//shorthand when start and end addresses of the sector are not needed +uint32_t flashmem_get_sector_of_address( uint32_t addr ){ + return (addr - INTERNAL_FLASH_START_ADDRESS) / INTERNAL_FLASH_SECTOR_SIZE;; +} + +/* + SPIFFS BOOTSTRAP +*/ + +//SPIFFS Address Range (defined in eagle ld) +extern uint32_t _SPIFFS_start; +extern uint32_t _SPIFFS_end; + +//SPIFFS Storage Handle +spiffs _filesystemStorageHandle; + +//SPIFFS Buffers (INTERNAL_FLASH_PAGE_SIZE = 256) Total 1792 bytes +static u8_t spiffs_work_buf[INTERNAL_FLASH_PAGE_SIZE*2]; //512 bytes +static u8_t spiffs_fds[32*4]; //128 bytes +static u8_t spiffs_cache[(INTERNAL_FLASH_PAGE_SIZE+32)*4]; //1152 bytes + +//SPIFFS API Read CallBack +static s32_t api_spiffs_read(u32_t addr, u32_t size, u8_t *dst){ + SPIFFS_API_DBG_V("api_spiffs_read: 0x%08x len: %u\n", addr, size); + flashmem_read(dst, addr, size); + return SPIFFS_OK; +} + +//SPIFFS API Write CallBack +static s32_t api_spiffs_write(u32_t addr, u32_t size, u8_t *src){ + SPIFFS_API_DBG_V("api_spiffs_write: 0x%08x len: %u\n", addr, size); + flashmem_write(src, addr, size); + return SPIFFS_OK; +} + +//SPIFFS API Erase CallBack +static s32_t api_spiffs_erase(u32_t addr, u32_t size){ + SPIFFS_API_DBG_V("api_spiffs_erase: 0x%08x len: %u\n", addr, size); + u32_t sect_first = flashmem_get_sector_of_address(addr); + u32_t sect_last = flashmem_get_sector_of_address(addr+size); + while( sect_first <= sect_last ) + if( !flashmem_erase_sector( sect_first ++ ) ) + return SPIFFS_ERR_INTERNAL; + return SPIFFS_OK; +} + +// Our own SPIFFS Setup Method +// All of the above gets put in the configuration +// and a mount attempt is made, initializing the storage handle +// that is used in all further api calls +s32_t spiffs_mount(){ + u32_t start_address = (u32_t)&_SPIFFS_start; + u32_t end_address = (u32_t)&_SPIFFS_end; + if (start_address == 0 || start_address >= end_address){ + SPIFFS_API_DBG_E("Can't start file system, wrong address"); + return SPIFFS_ERR_NOT_CONFIGURED; + } + + spiffs_config cfg = {0}; + cfg.phys_addr = start_address; + cfg.phys_size = end_address - start_address; + cfg.phys_erase_block = INTERNAL_FLASH_SECTOR_SIZE; // according to datasheet + cfg.log_block_size = INTERNAL_FLASH_SECTOR_SIZE * 2; // Important to make large + cfg.log_page_size = INTERNAL_FLASH_PAGE_SIZE; // according to datasheet + cfg.hal_read_f = api_spiffs_read; + cfg.hal_write_f = api_spiffs_write; + cfg.hal_erase_f = api_spiffs_erase; + + SPIFFS_API_DBG_V("spiffs_mount: start:%x, size:%d Kb\n", cfg.phys_addr, cfg.phys_size / 1024); + + s32_t res = SPIFFS_mount(&_filesystemStorageHandle, + &cfg, + spiffs_work_buf, + spiffs_fds, + sizeof(spiffs_fds), + spiffs_cache, + sizeof(spiffs_cache), + NULL); + SPIFFS_API_DBG_V("spiffs_mount: %d\n", res); + return res; +} diff --git a/cores/esp8266/spiffs/spiffs_esp8266.h b/cores/esp8266/spiffs/spiffs_esp8266.h new file mode 100644 index 000000000..f36fbfbfe --- /dev/null +++ b/cores/esp8266/spiffs/spiffs_esp8266.h @@ -0,0 +1,40 @@ +#ifndef SYSTEM_FLASHMEM_H_ +#define SYSTEM_FLASHMEM_H_ + +#ifdef __cplusplus +extern "C" { +#endif + +#include "spiffs.h" + +/******************* +The W25Q32BV array is organized into 16,384 programmable pages of 256-bytes each. Up to 256 bytes can be programmed at a time. +Pages can be erased in groups of 16 (4KB sector erase), groups of 128 (32KB block erase), groups of 256 (64KB block erase) or +the entire chip (chip erase). The W25Q32BV has 1,024 erasable sectors and 64 erasable blocks respectively. +The small 4KB sectors allow for greater flexibility in applications that require data and parameter storage. +********************/ + +#define SPIFFS_API_DBG_V(fmt, ...) //os_printf(fmt, ##__VA_ARGS__) +#define SPIFFS_API_DBG_E(fmt, ...) //os_printf("ERROR: " fmt , ##__VA_ARGS__) + +#define INTERNAL_FLASH_PAGE_SIZE 256 +#define INTERNAL_FLASH_SECTOR_SIZE 4096 +#define INTERNAL_FLASH_START_ADDRESS 0x40200000 + +#define INTERNAL_FLASH_WRITE_UNIT_SIZE 4 +#define INTERNAL_FLASH_READ_UNIT_SIZE 4 + +extern spiffs _filesystemStorageHandle; + +extern uint32_t flashmem_write( const void *from, uint32_t toaddr, uint32_t size ); +extern uint32_t flashmem_read( void *to, uint32_t fromaddr, uint32_t size ); +extern bool flashmem_erase_sector( uint32_t sector_id ); +uint32_t flashmem_find_sector( uint32_t address, uint32_t *pstart, uint32_t *pend ); +uint32_t flashmem_get_sector_of_address( uint32_t addr ); +s32_t spiffs_mount(); + +#ifdef __cplusplus +} +#endif + +#endif /* SYSTEM_FLASHMEM_H_ */ diff --git a/cores/esp8266/spiffs/spiffs_flashmem.c b/cores/esp8266/spiffs/spiffs_flashmem.c deleted file mode 100755 index dc875ff12..000000000 --- a/cores/esp8266/spiffs/spiffs_flashmem.c +++ /dev/null @@ -1,232 +0,0 @@ -#include "flashmem.h" -#include "esp8266_peri.h" -#include "Arduino.h" - -// Based on NodeMCU platform_flash -// https://github.com/nodemcu/nodemcu-firmware - -extern uint32_t _SPIFFS_start; - -uint32_t flashmem_write( const void *from, uint32_t toaddr, uint32_t size ) -{ - uint32_t temp, rest, ssize = size; - unsigned i; - char tmpdata[ INTERNAL_FLASH_WRITE_UNIT_SIZE ]; - const uint8_t *pfrom = ( const uint8_t* )from; - const uint32_t blksize = INTERNAL_FLASH_WRITE_UNIT_SIZE; - const uint32_t blkmask = INTERNAL_FLASH_WRITE_UNIT_SIZE - 1; - - // Align the start - if( toaddr & blkmask ) - { - rest = toaddr & blkmask; - temp = toaddr & ~blkmask; // this is the actual aligned address - // c_memcpy( tmpdata, ( const void* )temp, blksize ); - flashmem_read_internal( tmpdata, temp, blksize ); - for( i = rest; size && ( i < blksize ); i ++, size --, pfrom ++ ) - tmpdata[ i ] = *pfrom; - flashmem_write_internal( tmpdata, temp, blksize ); - if( size == 0 ) - return ssize; - toaddr = temp + blksize; - } - // The start address is now a multiple of blksize - // Compute how many bytes we can write as multiples of blksize - rest = size & blkmask; - temp = size & ~blkmask; - // Program the blocks now - if( temp ) - { - flashmem_write_internal( pfrom, toaddr, temp ); - toaddr += temp; - pfrom += temp; - } - // And the final part of a block if needed - if( rest ) - { - // c_memcpy( tmpdata, ( const void* )toaddr, blksize ); - flashmem_read_internal( tmpdata, toaddr, blksize ); - for( i = 0; size && ( i < rest ); i ++, size --, pfrom ++ ) - tmpdata[ i ] = *pfrom; - flashmem_write_internal( tmpdata, toaddr, blksize ); - } - return ssize; -} - -uint32_t flashmem_read( void *to, uint32_t fromaddr, uint32_t size ) -{ - uint32_t temp, rest, ssize = size; - unsigned i; - char tmpdata[ INTERNAL_FLASH_READ_UNIT_SIZE ]; - uint8_t *pto = ( uint8_t* )to; - const uint32_t blksize = INTERNAL_FLASH_READ_UNIT_SIZE; - const uint32_t blkmask = INTERNAL_FLASH_READ_UNIT_SIZE - 1; - - // Align the start - if( fromaddr & blkmask ) - { - rest = fromaddr & blkmask; - temp = fromaddr & ~blkmask; // this is the actual aligned address - flashmem_read_internal( tmpdata, temp, blksize ); - for( i = rest; size && ( i < blksize ); i ++, size --, pto ++ ) - *pto = tmpdata[ i ]; - - if( size == 0 ) - return ssize; - fromaddr = temp + blksize; - } - // The start address is now a multiple of blksize - // Compute how many bytes we can read as multiples of blksize - rest = size & blkmask; - temp = size & ~blkmask; - // Program the blocks now - if( temp ) - { - flashmem_read_internal( pto, fromaddr, temp ); - fromaddr += temp; - pto += temp; - } - // And the final part of a block if needed - if( rest ) - { - flashmem_read_internal( tmpdata, fromaddr, blksize ); - for( i = 0; size && ( i < rest ); i ++, size --, pto ++ ) - *pto = tmpdata[ i ]; - } - return ssize; -} - -SPIFlashInfo flashmem_get_info() -{ - volatile SPIFlashInfo spi_flash_info STORE_ATTR; - spi_flash_info = *((SPIFlashInfo *)(INTERNAL_FLASH_START_ADDRESS)); - return spi_flash_info; -} - -uint8_t flashmem_get_size_type() -{ - return flashmem_get_info().size; -} - -uint32_t flashmem_get_size_bytes() -{ - uint32_t flash_size = 0; - switch (flashmem_get_info().size) - { - case SIZE_2MBIT: - // 2Mbit, 256kByte - flash_size = 256 * 1024; - break; - case SIZE_4MBIT: - // 4Mbit, 512kByte - flash_size = 512 * 1024; - break; - case SIZE_8MBIT: - // 8Mbit, 1MByte - flash_size = 1 * 1024 * 1024; - break; - case SIZE_16MBIT: - // 16Mbit, 2MByte - flash_size = 2 * 1024 * 1024; - break; - case SIZE_32MBIT: - // 32Mbit, 4MByte - flash_size = 4 * 1024 * 1024; - break; - default: - // Unknown flash size, fall back mode. - flash_size = 512 * 1024; - break; - } - return flash_size; -} - -uint16_t flashmem_get_size_sectors() -{ - return flashmem_get_size_bytes() / SPI_FLASH_SEC_SIZE; -} - -// Helper function: find the flash sector in which an address resides -// Return the sector number, as well as the start and end address of the sector -uint32_t flashmem_find_sector( uint32_t address, uint32_t *pstart, uint32_t *pend ) -{ - address -= INTERNAL_FLASH_START_ADDRESS; - // All the sectors in the flash have the same size, so just align the address - uint32_t sect_id = address / INTERNAL_FLASH_SECTOR_SIZE; - - if( pstart ) - *pstart = sect_id * INTERNAL_FLASH_SECTOR_SIZE + INTERNAL_FLASH_START_ADDRESS; - if( pend ) - *pend = ( sect_id + 1 ) * INTERNAL_FLASH_SECTOR_SIZE + INTERNAL_FLASH_START_ADDRESS - 1; - return sect_id; -} - -uint32_t flashmem_get_sector_of_address( uint32_t addr ) -{ - return flashmem_find_sector( addr, NULL, NULL ); -} - -///////////////////////////////////////////////////// - -bool flashmem_erase_sector( uint32_t sector_id ) -{ - WDT_RESET(); - noInterrupts(); - bool erased = spi_flash_erase_sector( sector_id ) == SPI_FLASH_RESULT_OK; - interrupts(); - return erased; -} - -uint32_t flashmem_write_internal( const void *from, uint32_t toaddr, uint32_t size ) -{ - toaddr -= INTERNAL_FLASH_START_ADDRESS; - SpiFlashOpResult r; - const uint32_t blkmask = INTERNAL_FLASH_WRITE_UNIT_SIZE - 1; - uint32_t *apbuf = NULL; - if( ((uint32_t)from) & blkmask ){ - apbuf = (uint32_t *)os_malloc(size); - if(!apbuf) - return 0; - os_memcpy(apbuf, from, size); - } - WDT_RESET(); - noInterrupts(); - r = spi_flash_write(toaddr, apbuf?(uint32 *)apbuf:(uint32 *)from, size); - interrupts(); - if(apbuf) - os_free(apbuf); - if(SPI_FLASH_RESULT_OK == r) - return size; - else{ - SYSTEM_ERROR( "ERROR in flash_write: r=%d at %08X\n", ( int )r, ( unsigned )toaddr+INTERNAL_FLASH_START_ADDRESS ); - return 0; - } -} - -uint32_t flashmem_read_internal( void *to, uint32_t fromaddr, uint32_t size ) -{ - fromaddr -= INTERNAL_FLASH_START_ADDRESS; - SpiFlashOpResult r; - WDT_RESET(); - noInterrupts(); - r = spi_flash_read(fromaddr, (uint32 *)to, size); - interrupts(); - if(SPI_FLASH_RESULT_OK == r) - return size; - else{ - SYSTEM_ERROR( "ERROR in flash_read: r=%d at %08X\n", ( int )r, ( unsigned )fromaddr+INTERNAL_FLASH_START_ADDRESS ); - return 0; - } -} - -uint32_t flashmem_get_first_free_block_address(){ - if ((uint32_t)&_SPIFFS_start == 0){ - return 0; - } - debugf("_SPIFFS_start:%08x\n", (uint32_t)&_SPIFFS_start); - - // Round the total used flash size to the closest flash block address - uint32_t end; - flashmem_find_sector( (uint32_t)&_SPIFFS_start - 1, NULL, &end); - return end + 1; -} diff --git a/cores/esp8266/spiffs/spiffs_gc.c b/cores/esp8266/spiffs/spiffs_gc.c old mode 100755 new mode 100644 index 6145084dc..87e4faf90 --- a/cores/esp8266/spiffs/spiffs_gc.c +++ b/cores/esp8266/spiffs/spiffs_gc.c @@ -8,31 +8,11 @@ static s32_t spiffs_gc_erase_block( spiffs *fs, spiffs_block_ix bix) { s32_t res; - u32_t addr = SPIFFS_BLOCK_TO_PADDR(fs, bix); - s32_t size = SPIFFS_CFG_LOG_BLOCK_SZ(fs); SPIFFS_GC_DBG("gc: erase block %d\n", bix); - - // here we ignore res, just try erasing the block - while (size > 0) { - SPIFFS_GC_DBG("gc: erase %08x:%08x\n", addr, SPIFFS_CFG_PHYS_ERASE_SZ(fs)); - (void)fs->cfg.hal_erase_f(addr, SPIFFS_CFG_PHYS_ERASE_SZ(fs)); - addr += SPIFFS_CFG_PHYS_ERASE_SZ(fs); - size -= SPIFFS_CFG_PHYS_ERASE_SZ(fs); - } - fs->free_blocks++; - - // register erase count for this block - res = _spiffs_wr(fs, SPIFFS_OP_C_WRTHRU | SPIFFS_OP_T_OBJ_LU2, 0, - SPIFFS_ERASE_COUNT_PADDR(fs, bix), - sizeof(spiffs_obj_id), (u8_t *)&fs->max_erase_count); + res = spiffs_erase_block(fs, bix); SPIFFS_CHECK_RES(res); - fs->max_erase_count++; - if (fs->max_erase_count == SPIFFS_OBJ_ID_IX_FLAG) { - fs->max_erase_count = 0; - } - #if SPIFFS_CACHE { u32_t i; @@ -119,17 +99,25 @@ s32_t spiffs_gc_check( spiffs *fs, u32_t len) { s32_t res; - u32_t free_pages = - (SPIFFS_PAGES_PER_BLOCK(fs) - SPIFFS_OBJ_LOOKUP_PAGES(fs)) * fs->block_count + s32_t free_pages = + (SPIFFS_PAGES_PER_BLOCK(fs) - SPIFFS_OBJ_LOOKUP_PAGES(fs)) * (fs->block_count-2) - fs->stats_p_allocated - fs->stats_p_deleted; int tries = 0; if (fs->free_blocks > 3 && - len < free_pages * SPIFFS_DATA_PAGE_SIZE(fs)) { + (s32_t)len < free_pages * (s32_t)SPIFFS_DATA_PAGE_SIZE(fs)) { return SPIFFS_OK; } - //printf("gcing started %d dirty, blocks %d free, want %d bytes\n", fs->stats_p_allocated + fs->stats_p_deleted, fs->free_blocks, len); + u32_t needed_pages = (len + SPIFFS_DATA_PAGE_SIZE(fs) - 1) / SPIFFS_DATA_PAGE_SIZE(fs); +// if (fs->free_blocks <= 2 && (s32_t)needed_pages > free_pages) { +// SPIFFS_GC_DBG("gc: full freeblk:%d needed:%d free:%d dele:%d\n", fs->free_blocks, needed_pages, free_pages, fs->stats_p_deleted); +// return SPIFFS_ERR_FULL; +// } + if ((s32_t)needed_pages > (s32_t)(free_pages + fs->stats_p_deleted)) { + SPIFFS_GC_DBG("gc_check: full freeblk:%d needed:%d free:%d dele:%d\n", fs->free_blocks, needed_pages, free_pages, fs->stats_p_deleted); + return SPIFFS_ERR_FULL; + } do { SPIFFS_GC_DBG("\ngc_check #%d: run gc free_blocks:%d pfree:%d pallo:%d pdele:%d [%d] len:%d of %d\n", @@ -140,18 +128,20 @@ s32_t spiffs_gc_check( spiffs_block_ix *cands; int count; spiffs_block_ix cand; - res = spiffs_gc_find_candidate(fs, &cands, &count); + s32_t prev_free_pages = free_pages; + // if the fs is crammed, ignore block age when selecting candidate - kind of a bad state + res = spiffs_gc_find_candidate(fs, &cands, &count, free_pages <= 0); SPIFFS_CHECK_RES(res); if (count == 0) { SPIFFS_GC_DBG("gc_check: no candidates, return\n"); - return res; + return (s32_t)needed_pages < free_pages ? SPIFFS_OK : SPIFFS_ERR_FULL; } #if SPIFFS_GC_STATS fs->stats_gc_runs++; #endif cand = cands[0]; fs->cleaning = 1; - //printf("gcing: cleaning block %d\n", cand); + //c_printf("gcing: cleaning block %d\n", cand); res = spiffs_gc_clean(fs, cand); fs->cleaning = 0; if (res < 0) { @@ -168,16 +158,28 @@ s32_t spiffs_gc_check( SPIFFS_CHECK_RES(res); free_pages = - (SPIFFS_PAGES_PER_BLOCK(fs) - SPIFFS_OBJ_LOOKUP_PAGES(fs)) * fs->block_count + (SPIFFS_PAGES_PER_BLOCK(fs) - SPIFFS_OBJ_LOOKUP_PAGES(fs)) * (fs->block_count - 2) - fs->stats_p_allocated - fs->stats_p_deleted; - } while (++tries < SPIFFS_GC_MAX_RUNS && (fs->free_blocks <= 2 || - len > free_pages*SPIFFS_DATA_PAGE_SIZE(fs))); - SPIFFS_GC_DBG("gc_check: finished\n"); + if (prev_free_pages <= 0 && prev_free_pages == free_pages) { + // abort early to reduce wear, at least tried once + SPIFFS_GC_DBG("gc_check: early abort, no result on gc when fs crammed\n"); + break; + } - //printf("gcing finished %d dirty, blocks %d free, %d pages free, %d tries, res %d\n", - // fs->stats_p_allocated + fs->stats_p_deleted, - // fs->free_blocks, free_pages, tries, res); + } while (++tries < SPIFFS_GC_MAX_RUNS && (fs->free_blocks <= 2 || + (s32_t)len > free_pages*(s32_t)SPIFFS_DATA_PAGE_SIZE(fs))); + + free_pages = + (SPIFFS_PAGES_PER_BLOCK(fs) - SPIFFS_OBJ_LOOKUP_PAGES(fs)) * (fs->block_count - 2) + - fs->stats_p_allocated - fs->stats_p_deleted; + if ((s32_t)len > free_pages*(s32_t)SPIFFS_DATA_PAGE_SIZE(fs)) { + res = SPIFFS_ERR_FULL; + } + + SPIFFS_GC_DBG("gc_check: finished, %d dirty, blocks %d free, %d pages free, %d tries, res %d\n", + fs->stats_p_allocated + fs->stats_p_deleted, + fs->free_blocks, free_pages, tries, res); return res; } @@ -223,7 +225,8 @@ s32_t spiffs_gc_erase_page_stats( s32_t spiffs_gc_find_candidate( spiffs *fs, spiffs_block_ix **block_candidates, - int *candidate_count) { + int *candidate_count, + char fs_crammed) { s32_t res = SPIFFS_OK; u32_t blocks = fs->block_count; spiffs_block_ix cur_block = 0; @@ -249,6 +252,7 @@ s32_t spiffs_gc_find_candidate( while (res == SPIFFS_OK && blocks--) { u16_t deleted_pages_in_block = 0; u16_t used_pages_in_block = 0; + int obj_lookup_page = 0; // check each object lookup page while (res == SPIFFS_OK && obj_lookup_page < (int)SPIFFS_OBJ_LOOKUP_PAGES(fs)) { @@ -295,9 +299,9 @@ s32_t spiffs_gc_find_candidate( s32_t score = deleted_pages_in_block * SPIFFS_GC_HEUR_W_DELET + used_pages_in_block * SPIFFS_GC_HEUR_W_USED + - erase_age * SPIFFS_GC_HEUR_W_ERASE_AGE; + erase_age * (fs_crammed ? 0 : SPIFFS_GC_HEUR_W_ERASE_AGE); int cand_ix = 0; - SPIFFS_GC_DBG("\ngc_check: bix:%d del:%d use:%d score:%d\n", cur_block, deleted_pages_in_block, used_pages_in_block, score); + SPIFFS_GC_DBG("gc_check: bix:%d del:%d use:%d score:%d\n", cur_block, deleted_pages_in_block, used_pages_in_block, score); while (cand_ix < max_candidates) { if (cand_blocks[cand_ix] == (spiffs_block_ix)-1) { cand_blocks[cand_ix] = cur_block; diff --git a/cores/esp8266/spiffs/spiffs_hydrogen.c b/cores/esp8266/spiffs/spiffs_hydrogen.c old mode 100755 new mode 100644 index 36bdcd274..6601b61ad --- a/cores/esp8266/spiffs/spiffs_hydrogen.c +++ b/cores/esp8266/spiffs/spiffs_hydrogen.c @@ -21,6 +21,36 @@ u32_t SPIFFS_buffer_bytes_for_cache(spiffs *fs, u32_t num_pages) { #endif #endif +u8_t SPIFFS_mounted(spiffs *fs) { + return SPIFFS_CHECK_MOUNT(fs); +} + +s32_t SPIFFS_format(spiffs *fs) { + SPIFFS_API_CHECK_CFG(fs); + if (SPIFFS_CHECK_MOUNT(fs)) { + fs->err_code = SPIFFS_ERR_MOUNTED; + return -1; + } + + s32_t res; + SPIFFS_LOCK(fs); + + spiffs_block_ix bix = 0; + while (bix < fs->block_count) { + fs->max_erase_count = 0; + res = spiffs_erase_block(fs, bix); + if (res != SPIFFS_OK) { + res = SPIFFS_ERR_ERASE_FAIL; + } + SPIFFS_API_CHECK_RES_UNLOCK(fs, res); + bix++; + } + + SPIFFS_UNLOCK(fs); + + return 0; +} + s32_t SPIFFS_mount(spiffs *fs, spiffs_config *config, u8_t *work, u8_t *fd_space, u32_t fd_space_size, void *cache, u32_t cache_size, @@ -34,10 +64,10 @@ s32_t SPIFFS_mount(spiffs *fs, spiffs_config *config, u8_t *work, c_memset(fd_space, 0, fd_space_size); // align fd_space pointer to pointer size byte boundary, below is safe u8_t ptr_size = sizeof(void*); -// #pragma GCC diagnostic push -// #pragma GCC diagnostic ignored "-Wpointer-to-int-cast" - u8_t addr_lsb = (u8_t)(((u32_t)fd_space) & (ptr_size-1)); -// #pragma GCC diagnostic pop +#pragma GCC diagnostic push +#pragma GCC diagnostic ignored "-Wpointer-to-int-cast" + u8_t addr_lsb = ((u8_t)fd_space) & (ptr_size-1); +#pragma GCC diagnostic pop if (addr_lsb) { fd_space += (ptr_size-addr_lsb); fd_space_size -= (ptr_size-addr_lsb); @@ -46,10 +76,10 @@ s32_t SPIFFS_mount(spiffs *fs, spiffs_config *config, u8_t *work, fs->fd_count = (fd_space_size/sizeof(spiffs_fd)); // align cache pointer to 4 byte boundary, below is safe -// #pragma GCC diagnostic push -// #pragma GCC diagnostic ignored "-Wpointer-to-int-cast" - addr_lsb = (u8_t)(((u32_t)cache) & (ptr_size-1)); -// #pragma GCC diagnostic pop +#pragma GCC diagnostic push +#pragma GCC diagnostic ignored "-Wpointer-to-int-cast" + addr_lsb = ((u8_t)cache) & (ptr_size-1); +#pragma GCC diagnostic pop if (addr_lsb) { u8_t *cache_8 = (u8_t *)cache; cache_8 += (ptr_size-addr_lsb); @@ -65,7 +95,16 @@ s32_t SPIFFS_mount(spiffs *fs, spiffs_config *config, u8_t *work, spiffs_cache_init(fs); #endif - s32_t res = spiffs_obj_lu_scan(fs); + s32_t res; + +#if SPIFFS_USE_MAGIC + res = SPIFFS_CHECK_MAGIC_POSSIBLE(fs) ? SPIFFS_OK : SPIFFS_ERR_MAGIC_NOT_POSSIBLE; + SPIFFS_API_CHECK_RES_UNLOCK(fs, res); +#endif + + fs->config_magic = SPIFFS_CONFIG_MAGIC; + + res = spiffs_obj_lu_scan(fs); SPIFFS_API_CHECK_RES_UNLOCK(fs, res); SPIFFS_DBG("page index byte len: %d\n", SPIFFS_CFG_LOG_PAGE_SZ(fs)); @@ -79,13 +118,15 @@ s32_t SPIFFS_mount(spiffs *fs, spiffs_config *config, u8_t *work, fs->check_cb_f = check_cb_f; + fs->mounted = 1; + SPIFFS_UNLOCK(fs); return 0; } void SPIFFS_unmount(spiffs *fs) { - if (!SPIFFS_CHECK_MOUNT(fs)) return; + if (!SPIFFS_CHECK_CFG(fs) || !SPIFFS_CHECK_MOUNT(fs)) return; SPIFFS_LOCK(fs); u32_t i; spiffs_fd *fds = (spiffs_fd *)fs->fd_space; @@ -98,16 +139,22 @@ void SPIFFS_unmount(spiffs *fs) { spiffs_fd_return(fs, cur_fd->file_nbr); } } - fs->block_count = 0; + fs->mounted = 0; + SPIFFS_UNLOCK(fs); } s32_t SPIFFS_errno(spiffs *fs) { - return fs->errno; + return fs->err_code; } -s32_t SPIFFS_creat(spiffs *fs, const char *path, spiffs_mode mode) { +void SPIFFS_clearerr(spiffs *fs) { + fs->err_code = SPIFFS_OK; +} + +s32_t SPIFFS_creat(spiffs *fs, char *path, spiffs_mode mode) { (void)mode; + SPIFFS_API_CHECK_CFG(fs); SPIFFS_API_CHECK_MOUNT(fs); SPIFFS_LOCK(fs); spiffs_obj_id obj_id; @@ -121,8 +168,9 @@ s32_t SPIFFS_creat(spiffs *fs, const char *path, spiffs_mode mode) { return 0; } -spiffs_file SPIFFS_open(spiffs *fs, const char *path, spiffs_flags flags, spiffs_mode mode) { +spiffs_file SPIFFS_open(spiffs *fs, char *path, spiffs_flags flags, spiffs_mode mode) { (void)mode; + SPIFFS_API_CHECK_CFG(fs); SPIFFS_API_CHECK_MOUNT(fs); SPIFFS_LOCK(fs); @@ -181,6 +229,7 @@ spiffs_file SPIFFS_open(spiffs *fs, const char *path, spiffs_flags flags, spiffs } spiffs_file SPIFFS_open_by_dirent(spiffs *fs, struct spiffs_dirent *e, spiffs_flags flags, spiffs_mode mode) { + SPIFFS_API_CHECK_CFG(fs); SPIFFS_API_CHECK_MOUNT(fs); SPIFFS_LOCK(fs); @@ -209,7 +258,8 @@ spiffs_file SPIFFS_open_by_dirent(spiffs *fs, struct spiffs_dirent *e, spiffs_fl return fd->file_nbr; } -s32_t SPIFFS_read(spiffs *fs, spiffs_file fh, void *buf, u32_t len) { +s32_t SPIFFS_read(spiffs *fs, spiffs_file fh, void *buf, s32_t len) { + SPIFFS_API_CHECK_CFG(fs); SPIFFS_API_CHECK_MOUNT(fs); SPIFFS_LOCK(fs); @@ -277,7 +327,8 @@ static s32_t spiffs_hydro_write(spiffs *fs, spiffs_fd *fd, void *buf, u32_t offs } -s32_t SPIFFS_write(spiffs *fs, spiffs_file fh, void *buf, u32_t len) { +s32_t SPIFFS_write(spiffs *fs, spiffs_file fh, void *buf, s32_t len) { + SPIFFS_API_CHECK_CFG(fs); SPIFFS_API_CHECK_MOUNT(fs); SPIFFS_LOCK(fs); @@ -314,8 +365,6 @@ s32_t SPIFFS_write(spiffs *fs, spiffs_file fh, void *buf, u32_t len) { #endif } - SPIFFS_DBG("SPIFFS_write %d %04x offs:%d len %d\n", fh, fd->obj_id, offset, len); - #if SPIFFS_CACHE_WR if ((fd->flags & SPIFFS_DIRECT) == 0) { if (len < (s32_t)SPIFFS_CFG_LOG_PAGE_SZ(fs)) { @@ -328,12 +377,13 @@ s32_t SPIFFS_write(spiffs *fs, spiffs_file fh, void *buf, u32_t len) { offset + len > fd->cache_page->offset + SPIFFS_CFG_LOG_PAGE_SZ(fs)) // writing beyond cache page { // boundary violation, write back cache first and allocate new - SPIFFS_CACHE_DBG("CACHE_WR_DUMP: dumping cache page %d for fd %d:&04x, boundary viol, offs:%d size:%d\n", + SPIFFS_CACHE_DBG("CACHE_WR_DUMP: dumping cache page %d for fd %d:%04x, boundary viol, offs:%d size:%d\n", fd->cache_page->ix, fd->file_nbr, fd->obj_id, fd->cache_page->offset, fd->cache_page->size); res = spiffs_hydro_write(fs, fd, spiffs_get_cache_page(fs, spiffs_get_cache(fs), fd->cache_page->ix), fd->cache_page->offset, fd->cache_page->size); spiffs_cache_fd_release(fs, fd->cache_page); + SPIFFS_API_CHECK_RES(fs, res); } else { // writing within cache alloc_cpage = 0; @@ -379,6 +429,7 @@ s32_t SPIFFS_write(spiffs *fs, spiffs_file fh, void *buf, u32_t len) { spiffs_get_cache_page(fs, spiffs_get_cache(fs), fd->cache_page->ix), fd->cache_page->offset, fd->cache_page->size); spiffs_cache_fd_release(fs, fd->cache_page); + SPIFFS_API_CHECK_RES(fs, res); res = spiffs_hydro_write(fs, fd, buf, offset, len); SPIFFS_API_CHECK_RES(fs, res); } @@ -396,6 +447,7 @@ s32_t SPIFFS_write(spiffs *fs, spiffs_file fh, void *buf, u32_t len) { } s32_t SPIFFS_lseek(spiffs *fs, spiffs_file fh, s32_t offs, int whence) { + SPIFFS_API_CHECK_CFG(fs); SPIFFS_API_CHECK_MOUNT(fs); SPIFFS_LOCK(fs); @@ -439,7 +491,8 @@ s32_t SPIFFS_lseek(spiffs *fs, spiffs_file fh, s32_t offs, int whence) { return 0; } -s32_t SPIFFS_remove(spiffs *fs, const char *path) { +s32_t SPIFFS_remove(spiffs *fs, char *path) { + SPIFFS_API_CHECK_CFG(fs); SPIFFS_API_CHECK_MOUNT(fs); SPIFFS_LOCK(fs); @@ -473,6 +526,7 @@ s32_t SPIFFS_remove(spiffs *fs, const char *path) { } s32_t SPIFFS_fremove(spiffs *fs, spiffs_file fh) { + SPIFFS_API_CHECK_CFG(fs); SPIFFS_API_CHECK_MOUNT(fs); SPIFFS_LOCK(fs); @@ -520,7 +574,8 @@ static s32_t spiffs_stat_pix(spiffs *fs, spiffs_page_ix pix, spiffs_file fh, spi return res; } -s32_t SPIFFS_stat(spiffs *fs, const char *path, spiffs_stat *s) { +s32_t SPIFFS_stat(spiffs *fs, char *path, spiffs_stat *s) { + SPIFFS_API_CHECK_CFG(fs); SPIFFS_API_CHECK_MOUNT(fs); SPIFFS_LOCK(fs); @@ -538,6 +593,7 @@ s32_t SPIFFS_stat(spiffs *fs, const char *path, spiffs_stat *s) { } s32_t SPIFFS_fstat(spiffs *fs, spiffs_file fh, spiffs_stat *s) { + SPIFFS_API_CHECK_CFG(fs); SPIFFS_API_CHECK_MOUNT(fs); SPIFFS_LOCK(fs); @@ -580,7 +636,7 @@ static s32_t spiffs_fflush_cache(spiffs *fs, spiffs_file fh) { spiffs_get_cache_page(fs, spiffs_get_cache(fs), fd->cache_page->ix), fd->cache_page->offset, fd->cache_page->size); if (res < SPIFFS_OK) { - fs->errno = res; + fs->err_code = res; } spiffs_cache_fd_release(fs, fd->cache_page); } @@ -591,6 +647,7 @@ static s32_t spiffs_fflush_cache(spiffs *fs, spiffs_file fh) { } s32_t SPIFFS_fflush(spiffs *fs, spiffs_file fh) { + SPIFFS_API_CHECK_CFG(fs); SPIFFS_API_CHECK_MOUNT(fs); s32_t res = SPIFFS_OK; #if SPIFFS_CACHE_WR @@ -604,8 +661,13 @@ s32_t SPIFFS_fflush(spiffs *fs, spiffs_file fh) { } void SPIFFS_close(spiffs *fs, spiffs_file fh) { + if (!SPIFFS_CHECK_CFG((fs))) { + (fs)->err_code = SPIFFS_ERR_NOT_CONFIGURED; + return; + } + if (!SPIFFS_CHECK_MOUNT(fs)) { - fs->errno = SPIFFS_ERR_NOT_MOUNTED; + fs->err_code = SPIFFS_ERR_NOT_MOUNTED; return; } SPIFFS_LOCK(fs); @@ -618,7 +680,8 @@ void SPIFFS_close(spiffs *fs, spiffs_file fh) { SPIFFS_UNLOCK(fs); } -s32_t SPIFFS_rename(spiffs *fs, const char *old, const char *newname) { +s32_t SPIFFS_rename(spiffs *fs, char *old, char *new) { + SPIFFS_API_CHECK_CFG(fs); SPIFFS_API_CHECK_MOUNT(fs); SPIFFS_LOCK(fs); @@ -628,7 +691,7 @@ s32_t SPIFFS_rename(spiffs *fs, const char *old, const char *newname) { s32_t res = spiffs_object_find_object_index_header_by_name(fs, (u8_t*)old, &pix_old); SPIFFS_API_CHECK_RES_UNLOCK(fs, res); - res = spiffs_object_find_object_index_header_by_name(fs, (u8_t*)newname, &pix_dummy); + res = spiffs_object_find_object_index_header_by_name(fs, (u8_t*)new, &pix_dummy); if (res == SPIFFS_ERR_NOT_FOUND) { res = SPIFFS_OK; } else if (res == SPIFFS_OK) { @@ -645,7 +708,7 @@ s32_t SPIFFS_rename(spiffs *fs, const char *old, const char *newname) { } SPIFFS_API_CHECK_RES_UNLOCK(fs, res); - res = spiffs_object_update_index_hdr(fs, fd, fd->obj_id, fd->objix_hdr_pix, 0, (u8_t*)newname, + res = spiffs_object_update_index_hdr(fs, fd, fd->obj_id, fd->objix_hdr_pix, 0, (u8_t*)new, 0, &pix_dummy); if (res != SPIFFS_OK) { @@ -658,12 +721,19 @@ s32_t SPIFFS_rename(spiffs *fs, const char *old, const char *newname) { return res; } -spiffs_DIR *SPIFFS_opendir(spiffs *fs, const char *name, spiffs_DIR *d) { +spiffs_DIR *SPIFFS_opendir(spiffs *fs, char *name, spiffs_DIR *d) { (void)name; - if (!SPIFFS_CHECK_MOUNT(fs)) { - fs->errno = SPIFFS_ERR_NOT_MOUNTED; + + if (!SPIFFS_CHECK_CFG((fs))) { + (fs)->err_code = SPIFFS_ERR_NOT_CONFIGURED; return 0; } + + if (!SPIFFS_CHECK_MOUNT(fs)) { + fs->err_code = SPIFFS_ERR_NOT_MOUNTED; + return 0; + } + d->fs = fs; d->block = 0; d->entry = 0; @@ -707,7 +777,7 @@ static s32_t spiffs_read_dir_v( struct spiffs_dirent *SPIFFS_readdir(spiffs_DIR *d, struct spiffs_dirent *e) { if (!SPIFFS_CHECK_MOUNT(d->fs)) { - d->fs->errno = SPIFFS_ERR_NOT_MOUNTED; + d->fs->err_code = SPIFFS_ERR_NOT_MOUNTED; return 0; } SPIFFS_LOCK(fs); @@ -732,19 +802,21 @@ struct spiffs_dirent *SPIFFS_readdir(spiffs_DIR *d, struct spiffs_dirent *e) { d->entry = entry + 1; ret = e; } else { - d->fs->errno = res; + d->fs->err_code = res; } SPIFFS_UNLOCK(fs); return ret; } s32_t SPIFFS_closedir(spiffs_DIR *d) { + SPIFFS_API_CHECK_CFG(d->fs); SPIFFS_API_CHECK_MOUNT(d->fs); return 0; } s32_t SPIFFS_check(spiffs *fs) { s32_t res; + SPIFFS_API_CHECK_CFG(fs); SPIFFS_API_CHECK_MOUNT(fs); SPIFFS_LOCK(fs); @@ -760,7 +832,32 @@ s32_t SPIFFS_check(spiffs *fs) { return res; } +s32_t SPIFFS_info(spiffs *fs, u32_t *total, u32_t *used) { + s32_t res = SPIFFS_OK; + SPIFFS_API_CHECK_CFG(fs); + SPIFFS_API_CHECK_MOUNT(fs); + SPIFFS_LOCK(fs); + + u32_t pages_per_block = SPIFFS_PAGES_PER_BLOCK(fs); + u32_t blocks = fs->block_count; + u32_t obj_lu_pages = SPIFFS_OBJ_LOOKUP_PAGES(fs); + u32_t data_page_size = SPIFFS_DATA_PAGE_SIZE(fs); + u32_t total_data_pages = (blocks - 2) * (pages_per_block - obj_lu_pages) + 1; // -2 for spare blocks, +1 for emergency page + + if (total) { + *total = total_data_pages * data_page_size; + } + + if (used) { + *used = fs->stats_p_allocated * data_page_size; + } + + SPIFFS_UNLOCK(fs); + return res; +} + s32_t SPIFFS_eof(spiffs *fs, spiffs_file fh) { + SPIFFS_API_CHECK_CFG(fs); SPIFFS_API_CHECK_MOUNT(fs); SPIFFS_LOCK(fs); @@ -780,6 +877,7 @@ s32_t SPIFFS_eof(spiffs *fs, spiffs_file fh) { } s32_t SPIFFS_tell(spiffs *fs, spiffs_file fh) { + SPIFFS_API_CHECK_CFG(fs); SPIFFS_API_CHECK_MOUNT(fs); SPIFFS_LOCK(fs); @@ -801,6 +899,7 @@ s32_t SPIFFS_tell(spiffs *fs, spiffs_file fh) { #if SPIFFS_TEST_VISUALISATION s32_t SPIFFS_vis(spiffs *fs) { s32_t res = SPIFFS_OK; + SPIFFS_API_CHECK_CFG(fs); SPIFFS_API_CHECK_MOUNT(fs); SPIFFS_LOCK(fs); @@ -859,11 +958,14 @@ s32_t SPIFFS_vis(spiffs *fs) { } // per block spiffs_printf("era_cnt_max: %d\n", fs->max_erase_count); - spiffs_printf("last_errno: %d\n", fs->errno); + spiffs_printf("last_errno: %d\n", fs->err_code); spiffs_printf("blocks: %d\n", fs->block_count); spiffs_printf("free_blocks: %d\n", fs->free_blocks); spiffs_printf("page_alloc: %d\n", fs->stats_p_allocated); spiffs_printf("page_delet: %d\n", fs->stats_p_deleted); + u32_t total, used; + SPIFFS_info(fs, &total, &used); + spiffs_printf("used: %d of %d\n", used, total); SPIFFS_UNLOCK(fs); return res; diff --git a/cores/esp8266/spiffs/spiffs_nucleus.c b/cores/esp8266/spiffs/spiffs_nucleus.c old mode 100755 new mode 100644 index e58a9775e..fa75fd8e9 --- a/cores/esp8266/spiffs/spiffs_nucleus.c +++ b/cores/esp8266/spiffs/spiffs_nucleus.c @@ -142,9 +142,13 @@ s32_t spiffs_obj_lu_find_entry_visitor( cur_block++; cur_block_addr = cur_block * SPIFFS_CFG_LOG_BLOCK_SZ(fs); if (cur_block >= fs->block_count) { - // block wrap - cur_block = 0; - cur_block_addr = 0; + if (flags & SPIFFS_VIS_NO_WRAP) { + return SPIFFS_VIS_END; + } else { + // block wrap + cur_block = 0; + cur_block_addr = 0; + } } } @@ -213,6 +217,45 @@ s32_t spiffs_obj_lu_find_entry_visitor( return SPIFFS_VIS_END; } +s32_t spiffs_erase_block( + spiffs *fs, + spiffs_block_ix bix) { + s32_t res; + u32_t addr = SPIFFS_BLOCK_TO_PADDR(fs, bix); + s32_t size = SPIFFS_CFG_LOG_BLOCK_SZ(fs); + + // here we ignore res, just try erasing the block + while (size > 0) { + SPIFFS_DBG("erase %08x:%08x\n", addr, SPIFFS_CFG_PHYS_ERASE_SZ(fs)); + (void)fs->cfg.hal_erase_f(addr, SPIFFS_CFG_PHYS_ERASE_SZ(fs)); + addr += SPIFFS_CFG_PHYS_ERASE_SZ(fs); + size -= SPIFFS_CFG_PHYS_ERASE_SZ(fs); + } + fs->free_blocks++; + + // register erase count for this block + res = _spiffs_wr(fs, SPIFFS_OP_C_WRTHRU | SPIFFS_OP_T_OBJ_LU2, 0, + SPIFFS_ERASE_COUNT_PADDR(fs, bix), + sizeof(spiffs_obj_id), (u8_t *)&fs->max_erase_count); + SPIFFS_CHECK_RES(res); + +#if SPIFFS_USE_MAGIC + // finally, write magic + spiffs_obj_id magic = SPIFFS_MAGIC(fs); + res = _spiffs_wr(fs, SPIFFS_OP_C_WRTHRU | SPIFFS_OP_T_OBJ_LU2, 0, + SPIFFS_MAGIC_PADDR(fs, bix), + sizeof(spiffs_obj_id), (u8_t *)&magic); + SPIFFS_CHECK_RES(res); +#endif + + fs->max_erase_count++; + if (fs->max_erase_count == SPIFFS_OBJ_ID_IX_FLAG) { + fs->max_erase_count = 0; + } + + return res; +} + static s32_t spiffs_obj_lu_scan_v( spiffs *fs, @@ -238,40 +281,44 @@ static s32_t spiffs_obj_lu_scan_v( return SPIFFS_VIS_COUNTINUE; } + // Scans thru all obj lu and counts free, deleted and used pages // Find the maximum block erase count +// Checks magic if enabled s32_t spiffs_obj_lu_scan( spiffs *fs) { s32_t res; spiffs_block_ix bix; int entry; +#if SPIFFS_USE_MAGIC + spiffs_block_ix unerased_bix = (spiffs_block_ix)-1; +#endif - fs->free_blocks = 0; - fs->stats_p_allocated = 0; - fs->stats_p_deleted = 0; - - res = spiffs_obj_lu_find_entry_visitor(fs, - 0, - 0, - 0, - 0, - spiffs_obj_lu_scan_v, - 0, - 0, - &bix, - &entry); - - if (res == SPIFFS_VIS_END) { - res = SPIFFS_OK; - } - - SPIFFS_CHECK_RES(res); - + // find out erase count + // if enabled, check magic bix = 0; spiffs_obj_id erase_count_final; spiffs_obj_id erase_count_min = SPIFFS_OBJ_ID_FREE; spiffs_obj_id erase_count_max = 0; while (bix < fs->block_count) { +#if SPIFFS_USE_MAGIC + spiffs_obj_id magic; + res = _spiffs_rd(fs, + SPIFFS_OP_T_OBJ_LU2 | SPIFFS_OP_C_READ, + 0, SPIFFS_MAGIC_PADDR(fs, bix) , + sizeof(spiffs_obj_id), (u8_t *)&magic); + + SPIFFS_CHECK_RES(res); + if (magic != SPIFFS_MAGIC(fs)) { + if (unerased_bix == (spiffs_block_ix)-1) { + // allow one unerased block as it might be powered down during an erase + unerased_bix = bix; + } else { + // more than one unerased block, bail out + SPIFFS_CHECK_RES(SPIFFS_ERR_NOT_A_FS); + } + } +#endif spiffs_obj_id erase_count; res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU2 | SPIFFS_OP_C_READ, @@ -297,6 +344,38 @@ s32_t spiffs_obj_lu_scan( fs->max_erase_count = erase_count_final; +#if SPIFFS_USE_MAGIC + if (unerased_bix != (spiffs_block_ix)-1) { + // found one unerased block, remedy + SPIFFS_DBG("mount: erase block %d\n", bix); + res = spiffs_erase_block(fs, unerased_bix); + SPIFFS_CHECK_RES(res); + } +#endif + + // count blocks + + fs->free_blocks = 0; + fs->stats_p_allocated = 0; + fs->stats_p_deleted = 0; + + res = spiffs_obj_lu_find_entry_visitor(fs, + 0, + 0, + 0, + 0, + spiffs_obj_lu_scan_v, + 0, + 0, + &bix, + &entry); + + if (res == SPIFFS_VIS_END) { + res = SPIFFS_OK; + } + + SPIFFS_CHECK_RES(res); + return res; } @@ -614,7 +693,7 @@ s32_t spiffs_object_create( spiffs_page_object_ix_header oix_hdr; int entry; - res = spiffs_gc_check(fs, 0); + res = spiffs_gc_check(fs, SPIFFS_DATA_PAGE_SIZE(fs)); SPIFFS_CHECK_RES(res); obj_id |= SPIFFS_OBJ_ID_IX_FLAG; @@ -811,7 +890,17 @@ s32_t spiffs_object_append(spiffs_fd *fd, u32_t offset, u8_t *data, u32_t len) { s32_t res = SPIFFS_OK; u32_t written = 0; - res = spiffs_gc_check(fs, len); + SPIFFS_DBG("append: %d bytes @ offs %d of size %d\n", len, offset, fd->size); + + if (offset > fd->size) { + SPIFFS_DBG("append: offset reversed to size\n"); + offset = fd->size; + } + + res = spiffs_gc_check(fs, len + SPIFFS_DATA_PAGE_SIZE(fs)); // add an extra page of data worth for meta + if (res != SPIFFS_OK) { + SPIFFS_DBG("append: gc check fail %d\n", res); + } SPIFFS_CHECK_RES(res); spiffs_page_object_ix_header *objix_hdr = (spiffs_page_object_ix_header *)fs->work; @@ -912,7 +1001,7 @@ s32_t spiffs_object_append(spiffs_fd *fd, u32_t offset, u8_t *data, u32_t len) { res = spiffs_obj_lu_find_id_and_span(fs, fd->obj_id | SPIFFS_OBJ_ID_IX_FLAG, cur_objix_spix, 0, &pix); SPIFFS_CHECK_RES(res); } - SPIFFS_DBG("append: %04x found object index at page %04x\n", fd->obj_id, pix); + SPIFFS_DBG("append: %04x found object index at page %04x [fd size %d]\n", fd->obj_id, pix, fd->size); res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_IX | SPIFFS_OP_C_READ, fd->file_nbr, SPIFFS_PAGE_TO_PADDR(fs, pix), SPIFFS_CFG_LOG_PAGE_SZ(fs), fs->work); SPIFFS_CHECK_RES(res); @@ -1003,8 +1092,8 @@ s32_t spiffs_object_append(spiffs_fd *fd, u32_t offset, u8_t *data, u32_t len) { // update size in object header index page res2 = spiffs_object_update_index_hdr(fs, fd, fd->obj_id, fd->objix_hdr_pix, 0, 0, offset+written, &new_objix_hdr_page); - SPIFFS_DBG("append: %04x store new size II %d in objix_hdr, %04x:%04x, written %d\n", fd->obj_id - , offset+written, new_objix_hdr_page, 0, written); + SPIFFS_DBG("append: %04x store new size II %d in objix_hdr, %04x:%04x, written %d, res %d\n", fd->obj_id + , offset+written, new_objix_hdr_page, 0, written, res2); SPIFFS_CHECK_RES(res2); } else { // wrote within object index header page @@ -1042,7 +1131,7 @@ s32_t spiffs_object_modify(spiffs_fd *fd, u32_t offset, u8_t *data, u32_t len) { s32_t res = SPIFFS_OK; u32_t written = 0; - res = spiffs_gc_check(fs, len); + res = spiffs_gc_check(fs, len + SPIFFS_DATA_PAGE_SIZE(fs)); SPIFFS_CHECK_RES(res); spiffs_page_object_ix_header *objix_hdr = (spiffs_page_object_ix_header *)fs->work; @@ -1308,7 +1397,7 @@ s32_t spiffs_object_truncate( s32_t res = SPIFFS_OK; spiffs *fs = fd->fs; - res = spiffs_gc_check(fs, 0); + res = spiffs_gc_check(fs, remove ? 0 : SPIFFS_DATA_PAGE_SIZE(fs)); SPIFFS_CHECK_RES(res); spiffs_page_ix objix_pix = fd->objix_hdr_pix; @@ -1386,13 +1475,26 @@ s32_t spiffs_object_truncate( ((spiffs_page_ix*)((u8_t *)objix + sizeof(spiffs_page_object_ix)))[SPIFFS_OBJ_IX_ENTRY(fs, data_spix)] = SPIFFS_OBJ_ID_FREE; } + SPIFFS_DBG("truncate: got data pix %04x\n", data_pix); + if (cur_size - SPIFFS_DATA_PAGE_SIZE(fs) >= new_size) { // delete full data page res = spiffs_page_data_check(fs, fd, data_pix, data_spix); - if (res != SPIFFS_OK) break; + if (res != SPIFFS_ERR_DELETED && res != SPIFFS_OK && res != SPIFFS_ERR_INDEX_REF_FREE) { + SPIFFS_DBG("truncate: err validating data pix %d\n", res); + break; + } + + if (res == SPIFFS_OK) { + res = spiffs_page_delete(fs, data_pix); + if (res != SPIFFS_OK) { + SPIFFS_DBG("truncate: err deleting data pix %d\n", res); + break; + } + } else if (res == SPIFFS_ERR_DELETED || res == SPIFFS_ERR_INDEX_REF_FREE) { + res = SPIFFS_OK; + } - res = spiffs_page_delete(fs, data_pix); - if (res != SPIFFS_OK) break; // update current size if (cur_size % SPIFFS_DATA_PAGE_SIZE(fs) == 0) { cur_size -= SPIFFS_DATA_PAGE_SIZE(fs); diff --git a/cores/esp8266/spiffs/spiffs_nucleus.h b/cores/esp8266/spiffs/spiffs_nucleus.h old mode 100755 new mode 100644 index 9b10d9181..5d905fe90 --- a/cores/esp8266/spiffs/spiffs_nucleus.h +++ b/cores/esp8266/spiffs/spiffs_nucleus.h @@ -131,6 +131,10 @@ #define SPIFFS_OBJ_ID_DELETED ((spiffs_obj_id)0) #define SPIFFS_OBJ_ID_FREE ((spiffs_obj_id)-1) +#define SPIFFS_MAGIC(fs) ((spiffs_obj_id)(0x20140529 ^ SPIFFS_CFG_LOG_PAGE_SZ(fs))) + +#define SPIFFS_CONFIG_MAGIC (0x20090315) + #if SPIFFS_SINGLETON == 0 #define SPIFFS_CFG_LOG_PAGE_SZ(fs) \ ((fs)->cfg.log_page_size) @@ -189,9 +193,18 @@ // returns data size in a data page #define SPIFFS_DATA_PAGE_SIZE(fs) \ ( SPIFFS_CFG_LOG_PAGE_SZ(fs) - sizeof(spiffs_page_header) ) -// returns physical address for block's erase count +// returns physical address for block's erase count, +// always in the physical last entry of the last object lookup page #define SPIFFS_ERASE_COUNT_PADDR(fs, bix) \ ( SPIFFS_BLOCK_TO_PADDR(fs, bix) + SPIFFS_OBJ_LOOKUP_PAGES(fs) * SPIFFS_CFG_LOG_PAGE_SZ(fs) - sizeof(spiffs_obj_id) ) +// returns physical address for block's magic, +// always in the physical second last entry of the last object lookup page +#define SPIFFS_MAGIC_PADDR(fs, bix) \ + ( SPIFFS_BLOCK_TO_PADDR(fs, bix) + SPIFFS_OBJ_LOOKUP_PAGES(fs) * SPIFFS_CFG_LOG_PAGE_SZ(fs) - sizeof(spiffs_obj_id)*2 ) +// checks if there is any room for magic in the object luts +#define SPIFFS_CHECK_MAGIC_POSSIBLE(fs) \ + ( (SPIFFS_OBJ_LOOKUP_MAX_ENTRIES(fs) % (SPIFFS_CFG_LOG_PAGE_SZ(fs)/sizeof(spiffs_obj_id))) * sizeof(spiffs_obj_id) \ + <= (SPIFFS_CFG_LOG_PAGE_SZ(fs)-sizeof(spiffs_obj_id)*2) ) // define helpers object @@ -238,7 +251,10 @@ #define SPIFFS_CHECK_MOUNT(fs) \ - ((fs)->block_count > 0) + ((fs)->mounted != 0) + +#define SPIFFS_CHECK_CFG(fs) \ + ((fs)->config_magic == SPIFFS_CONFIG_MAGIC) #define SPIFFS_CHECK_RES(res) \ do { \ @@ -247,19 +263,25 @@ #define SPIFFS_API_CHECK_MOUNT(fs) \ if (!SPIFFS_CHECK_MOUNT((fs))) { \ - (fs)->errno = SPIFFS_ERR_NOT_MOUNTED; \ + (fs)->err_code = SPIFFS_ERR_NOT_MOUNTED; \ + return -1; \ + } + +#define SPIFFS_API_CHECK_CFG(fs) \ + if (!SPIFFS_CHECK_CFG((fs))) { \ + (fs)->err_code = SPIFFS_ERR_NOT_CONFIGURED; \ return -1; \ } #define SPIFFS_API_CHECK_RES(fs, res) \ if ((res) < SPIFFS_OK) { \ - (fs)->errno = (res); \ + (fs)->err_code = (res); \ return -1; \ } #define SPIFFS_API_CHECK_RES_UNLOCK(fs, res) \ if ((res) < SPIFFS_OK) { \ - (fs)->errno = (res); \ + (fs)->err_code = (res); \ SPIFFS_UNLOCK(fs); \ return -1; \ } @@ -381,6 +403,8 @@ typedef struct { // object structs // page header, part of each page except object lookup pages +// NB: this is always aligned when the data page is an object index, +// as in this case struct spiffs_page_object_ix is used typedef struct __attribute(( packed )) { // object id spiffs_obj_id obj_id; @@ -391,7 +415,11 @@ typedef struct __attribute(( packed )) { } spiffs_page_header; // object index header page header -typedef struct __attribute(( packed )) { +typedef struct __attribute(( packed )) +#if SPIFFS_ALIGNED_OBJECT_INDEX_TABLES + __attribute(( aligned(sizeof(spiffs_page_ix)) )) +#endif +{ // common page header spiffs_page_header p_hdr; // alignment @@ -400,8 +428,6 @@ typedef struct __attribute(( packed )) { u32_t size; // type of object spiffs_obj_type type; - // alignment2 - u8_t _align2[4 - (sizeof(spiffs_obj_type)&3)==0 ? 4 : (sizeof(spiffs_obj_type)&3)]; // name of object u8_t name[SPIFFS_OBJ_NAME_LEN]; } spiffs_page_object_ix_header; @@ -480,6 +506,10 @@ s32_t spiffs_obj_lu_find_entry_visitor( spiffs_block_ix *block_ix, int *lu_entry); +s32_t spiffs_erase_block( + spiffs *fs, + spiffs_block_ix bix); + // --------------- s32_t spiffs_obj_lu_scan( @@ -627,7 +657,8 @@ s32_t spiffs_gc_erase_page_stats( s32_t spiffs_gc_find_candidate( spiffs *fs, spiffs_block_ix **block_candidate, - int *candidate_count); + int *candidate_count, + char fs_crammed); s32_t spiffs_gc_clean( spiffs *fs, From b5763e0e77b38224eb8a01073528bcf32b5e2c7c Mon Sep 17 00:00:00 2001 From: ficeto Date: Mon, 18 May 2015 04:57:34 +0300 Subject: [PATCH 62/78] leftovers --- cores/esp8266/spiffs/docs/IMPLEMENTING | 0 cores/esp8266/spiffs/docs/TODO | 1 - 2 files changed, 1 deletion(-) delete mode 100755 cores/esp8266/spiffs/docs/IMPLEMENTING delete mode 100755 cores/esp8266/spiffs/docs/TODO diff --git a/cores/esp8266/spiffs/docs/IMPLEMENTING b/cores/esp8266/spiffs/docs/IMPLEMENTING deleted file mode 100755 index e69de29bb..000000000 diff --git a/cores/esp8266/spiffs/docs/TODO b/cores/esp8266/spiffs/docs/TODO deleted file mode 100755 index 88709f022..000000000 --- a/cores/esp8266/spiffs/docs/TODO +++ /dev/null @@ -1 +0,0 @@ -* When mending lost pages, also see if they fit into length specified in object index header \ No newline at end of file From 1db2c8aa89818031576ab1f80e504faaeafc0951 Mon Sep 17 00:00:00 2001 From: Ivan Grokhotkov Date: Mon, 18 May 2015 13:45:34 +0300 Subject: [PATCH 63/78] Support for multiple FileSystem instances --- cores/esp8266/Arduino.h | 1 - cores/esp8266/FileSystem.cpp | 277 ++++++++++++++++++-------- cores/esp8266/FileSystem.h | 39 ++-- cores/esp8266/core_esp8266_wiring.c | 1 - cores/esp8266/spiffs/spiffs_esp8266.c | 76 ------- cores/esp8266/spiffs/spiffs_esp8266.h | 3 - 6 files changed, 222 insertions(+), 175 deletions(-) diff --git a/cores/esp8266/Arduino.h b/cores/esp8266/Arduino.h index 4a2bd7144..dbc003b1d 100644 --- a/cores/esp8266/Arduino.h +++ b/cores/esp8266/Arduino.h @@ -38,7 +38,6 @@ extern "C" { #include "pgmspace.h" #include "esp8266_peri.h" #include "twi.h" - //#include "spiffs/spiffs.h" void yield(void); diff --git a/cores/esp8266/FileSystem.cpp b/cores/esp8266/FileSystem.cpp index 735bb7d4a..0399e4fce 100644 --- a/cores/esp8266/FileSystem.cpp +++ b/cores/esp8266/FileSystem.cpp @@ -20,60 +20,126 @@ */ #include "FileSystem.h" #include "Arduino.h" +#include "spiffs/spiffs_esp8266.h" -bool FSClass::mount() { - if(SPIFFS_mounted(&_filesystemStorageHandle)) return true; - int res = spiffs_mount(); - if(res != 0){ - int formated = SPIFFS_format(&_filesystemStorageHandle); - if(formated != 0) return false; - res = spiffs_mount(); - } - return (res == 0); +#define LOGICAL_PAGE_SIZE 256 +#define LOGICAL_BLOCK_SIZE 512 + + +// These addresses are defined in the linker script. +// For each flash memory size there is a linker script variant +// which sets spiffs location and size. +extern "C" uint32_t _SPIFFS_start; +extern "C" uint32_t _SPIFFS_end; + +static s32_t api_spiffs_read(u32_t addr, u32_t size, u8_t *dst); +static s32_t api_spiffs_write(u32_t addr, u32_t size, u8_t *src); +static s32_t api_spiffs_erase(u32_t addr, u32_t size); + +FSClass FS((uint32_t) &_SPIFFS_start, (uint32_t) &_SPIFFS_end, 4); + +FSClass::FSClass(uint32_t beginAddress, uint32_t endAddress, uint32_t maxOpenFiles) +: _beginAddress(beginAddress) +, _endAddress(endAddress) +, _maxOpenFiles(maxOpenFiles) +, _fs({0}) +{ } +int FSClass::_mountInternal(){ + if (_beginAddress == 0 || _beginAddress >= _endAddress){ + SPIFFS_API_DBG_E("Can't start file system, wrong address\r\n"); + return SPIFFS_ERR_NOT_CONFIGURED; + } + + spiffs_config cfg = {0}; + cfg.phys_addr = _beginAddress; + cfg.phys_size = _endAddress - _beginAddress; + cfg.phys_erase_block = INTERNAL_FLASH_SECTOR_SIZE; + cfg.log_block_size = LOGICAL_BLOCK_SIZE; + cfg.log_page_size = LOGICAL_PAGE_SIZE; + cfg.hal_read_f = api_spiffs_read; + cfg.hal_write_f = api_spiffs_write; + cfg.hal_erase_f = api_spiffs_erase; + + SPIFFS_API_DBG_V("FSClass::_mountInternal: start:%x, size:%d Kb\n", cfg.phys_addr, cfg.phys_size / 1024); + + _work.reset(new uint8_t[LOGICAL_BLOCK_SIZE]); + _fdsSize = 32 * _maxOpenFiles; + _fds.reset(new uint8_t[_fdsSize]); + _cacheSize = (32 + LOGICAL_PAGE_SIZE) * _maxOpenFiles; + _cache.reset(new uint8_t[_cacheSize]); + + s32_t res = SPIFFS_mount(&_fs, + &cfg, + _work.get(), + _fds.get(), + _fdsSize, + _cache.get(), + _cacheSize, + NULL); + SPIFFS_API_DBG_V("FSClass::_mountInternal: %d\n", res); + return res; +} + +bool FSClass::mount() { + if(SPIFFS_mounted(&_fs)) + return true; + + int res = _mountInternal(); + if(res != SPIFFS_OK){ + int formated = SPIFFS_format(&_fs); + if(formated != SPIFFS_OK) + return false; + res = _mountInternal(); + } + return (res == SPIFFS_OK); +} + +// TODO: need to invalidate open file objects void FSClass::unmount() { - if(SPIFFS_mounted(&_filesystemStorageHandle)) - SPIFFS_unmount(&_filesystemStorageHandle); + if(SPIFFS_mounted(&_fs)) + SPIFFS_unmount(&_fs); } bool FSClass::format() { - if(!SPIFFS_mounted(&_filesystemStorageHandle)){ - spiffs_mount(); + if(!SPIFFS_mounted(&_fs)){ + _mountInternal(); } - SPIFFS_unmount(&_filesystemStorageHandle); - int formated = SPIFFS_format(&_filesystemStorageHandle); - if(formated != 0) return false; - return (spiffs_mount() == 0); + SPIFFS_unmount(&_fs); + int formated = SPIFFS_format(&_fs); + if(formated != SPIFFS_OK) + return false; + return (_mountInternal() == SPIFFS_OK); } bool FSClass::check() { - return SPIFFS_check(&_filesystemStorageHandle) == 0; + return SPIFFS_check(&_fs) == SPIFFS_OK; } bool FSClass::exists(char *filename) { spiffs_stat stat = {0}; - if (SPIFFS_stat(&_filesystemStorageHandle, filename, &stat) < 0) + if (SPIFFS_stat(&_fs, filename, &stat) < 0) return false; return stat.name[0] != '\0'; } bool FSClass::create(char *filepath){ - return SPIFFS_creat(&_filesystemStorageHandle, filepath, 0) == 0; + return SPIFFS_creat(&_fs, filepath, 0) == SPIFFS_OK; } bool FSClass::remove(char *filepath){ - return SPIFFS_remove(&_filesystemStorageHandle, filepath) == 0; + return SPIFFS_remove(&_fs, filepath) == SPIFFS_OK; } bool FSClass::rename(char *filename, char *newname) { - return SPIFFS_rename(&_filesystemStorageHandle, filename, newname) == 0; + return SPIFFS_rename(&_fs, filename, newname) == SPIFFS_OK; } size_t FSClass::totalBytes(){ u32_t totalBytes; u32_t usedBytes; - if(SPIFFS_info(&_filesystemStorageHandle, &totalBytes, &usedBytes) == 0) + if(SPIFFS_info(&_fs, &totalBytes, &usedBytes) == SPIFFS_OK) return totalBytes; return 0; } @@ -81,13 +147,16 @@ size_t FSClass::totalBytes(){ size_t FSClass::usedBytes(){ u32_t totalBytes; u32_t usedBytes; - if(SPIFFS_info(&_filesystemStorageHandle, &totalBytes, &usedBytes) == 0) + if(SPIFFS_info(&_fs, &totalBytes, &usedBytes) == SPIFFS_OK) return usedBytes; return 0; } FSFile FSClass::open(char *filename, uint8_t mode) { - if(String(filename) == "" || String(filename) == "/") return FSFile("/"); + if(strcmp(filename, "") == 0 || + strcmp(filename, "/") == 0) + return FSFile(&_fs, "/"); + int repeats = 0; bool notExist; bool canRecreate = (mode & SPIFFS_CREAT) == SPIFFS_CREAT; @@ -95,8 +164,8 @@ FSFile FSClass::open(char *filename, uint8_t mode) { do{ notExist = false; - res = SPIFFS_open(&_filesystemStorageHandle, filename, (spiffs_flags)mode, 0); - int code = SPIFFS_errno(&_filesystemStorageHandle); + res = SPIFFS_open(&_fs, filename, (spiffs_flags)mode, 0); + int code = SPIFFS_errno(&_fs); if (res < 0){ SPIFFS_API_DBG_E("open errno %d\n", code); notExist = (code == SPIFFS_ERR_NOT_FOUND || code == SPIFFS_ERR_DELETED || code == SPIFFS_ERR_FILE_DELETED || code == SPIFFS_ERR_IS_FREE); @@ -106,63 +175,68 @@ FSFile FSClass::open(char *filename, uint8_t mode) { } while (notExist && canRecreate && repeats++ < 3); if(res){ - return FSFile(res); + return FSFile(&_fs, res); } return FSFile(); } FSFile FSClass::open(spiffs_dirent* entry, uint8_t mode){ - int res = SPIFFS_open_by_dirent(&_filesystemStorageHandle, entry, (spiffs_flags)mode, 0); - if(res){ - return FSFile(res); + int res = SPIFFS_open_by_dirent(&_fs, entry, (spiffs_flags)mode, 0); + if (res){ + return FSFile(&_fs, res); } return FSFile(); } -FSClass FS; - -FSFile::FSFile() { - _file = 0; - _stats = {0}; +FSFile::FSFile() +: _file(0) +, _stats({0}) +, _fs(0) +{ } -FSFile::FSFile(String path) { +FSFile::FSFile(spiffs* fs, String path) +: _fs(fs) +{ if(path == "/"){ _file = 0x1; os_sprintf((char*)_stats.name, "%s", (char*)path.c_str()); _stats.size = 0; _stats.type = SPIFFS_TYPE_DIR; - SPIFFS_opendir(&_filesystemStorageHandle, (char*)_stats.name, &_dir); + SPIFFS_opendir(_fs, (char*)_stats.name, &_dir); } else { - _file = SPIFFS_open(&_filesystemStorageHandle, (char *)path.c_str(), (spiffs_flags)FSFILE_READ, 0); - if(SPIFFS_fstat(&_filesystemStorageHandle, _file, &_stats) != 0){ - SPIFFS_API_DBG_E("fstat errno %d\n", SPIFFS_errno(&_filesystemStorageHandle)); + _file = SPIFFS_open(_fs, (char *)path.c_str(), (spiffs_flags)FSFILE_READ, 0); + if(SPIFFS_fstat(_fs, _file, &_stats) != 0){ + SPIFFS_API_DBG_E("fstat errno %d\n", SPIFFS_errno(_fs)); } //debugf("FSFile name: %s, size: %d, type: %d\n", _stats.name, _stats.size, _stats.type); if(_stats.type == SPIFFS_TYPE_DIR){ - SPIFFS_opendir(&_filesystemStorageHandle, (char*)_stats.name, &_dir); + SPIFFS_opendir(_fs, (char*)_stats.name, &_dir); } } } -FSFile::FSFile(file_t f) { - _file = f; - if(SPIFFS_fstat(&_filesystemStorageHandle, _file, &_stats) != 0){ - SPIFFS_API_DBG_E("fstat errno %d\n", SPIFFS_errno(&_filesystemStorageHandle)); +FSFile::FSFile(spiffs* fs, file_t f) +: _file(f) +, _fs(fs) +{ + if(SPIFFS_fstat(_fs, _file, &_stats) != 0){ + SPIFFS_API_DBG_E("fstat errno %d\n", SPIFFS_errno(_fs)); } //debugf("FSFile name: %s, size: %d, type: %d\n", _stats.name, _stats.size, _stats.type); if(_stats.type == SPIFFS_TYPE_DIR){ - SPIFFS_opendir(&_filesystemStorageHandle, (char*)_stats.name, &_dir); + SPIFFS_opendir(_fs, (char*)_stats.name, &_dir); } } void FSFile::close() { - if (! _file) return; + if (!_file) + return; if(_stats.type == SPIFFS_TYPE_DIR){ SPIFFS_closedir(&_dir); } if(os_strlen((char*)_stats.name) > 1) - SPIFFS_close(&_filesystemStorageHandle, _file); + SPIFFS_close(_fs, _file); _file = 0; } @@ -175,97 +249,138 @@ bool FSFile::isDirectory(void) { } void FSFile::rewindDirectory() { - if (!_file || !isDirectory()) return; + if (!_file || !isDirectory()) + return; SPIFFS_closedir(&_dir); - SPIFFS_opendir(&_filesystemStorageHandle, (char*)_stats.name, &_dir); + SPIFFS_opendir(_fs, (char*)_stats.name, &_dir); } FSFile FSFile::openNextFile(){ - if (!_file || !isDirectory()) return FSFile(); + if (!_file || !isDirectory()) + return FSFile(); struct spiffs_dirent e; struct spiffs_dirent *pe = &e; if ((pe = SPIFFS_readdir(&_dir, pe))){ + // TODO: store actual FS pointer return FS.open((char *)pe->name); } return FSFile(); } uint32_t FSFile::size() { - if(!_file) return 0; - if(_stats.size) return _stats.size; - uint32_t pos = SPIFFS_tell(&_filesystemStorageHandle, _file); - SPIFFS_lseek(&_filesystemStorageHandle, _file, 0, SPIFFS_SEEK_END); - _stats.size = SPIFFS_tell(&_filesystemStorageHandle, _file); - SPIFFS_lseek(&_filesystemStorageHandle, _file, pos, SPIFFS_SEEK_SET); + if(!_file) + return 0; + if(_stats.size) + return _stats.size; + uint32_t pos = SPIFFS_tell(_fs, _file); + SPIFFS_lseek(_fs, _file, 0, SPIFFS_SEEK_END); + _stats.size = SPIFFS_tell(_fs, _file); + SPIFFS_lseek(_fs, _file, pos, SPIFFS_SEEK_SET); return _stats.size; } int FSFile::available() { - if (!_file) return 0; - uint32_t pos = SPIFFS_tell(&_filesystemStorageHandle, _file); + if (!_file) + return 0; + uint32_t pos = SPIFFS_tell(_fs, _file); return size() - pos; } uint32_t FSFile::seek(uint32_t pos) { - if (!_file) return 0; - return SPIFFS_lseek(&_filesystemStorageHandle, _file, pos, SPIFFS_SEEK_SET); + if (!_file) + return 0; + return SPIFFS_lseek(_fs, _file, pos, SPIFFS_SEEK_SET); } uint32_t FSFile::position() { - if (!_file) return 0; - return SPIFFS_tell(&_filesystemStorageHandle, _file); + if (!_file) + return 0; + return SPIFFS_tell(_fs, _file); } bool FSFile::eof() { - if (!_file) return 0; - return SPIFFS_eof(&_filesystemStorageHandle, _file); + if (!_file) + return 0; + return SPIFFS_eof(_fs, _file); } int FSFile::read(void *buf, uint16_t nbyte) { - if (! _file || isDirectory()) return -1; - return SPIFFS_read(&_filesystemStorageHandle, _file, buf, nbyte); + if (!_file || isDirectory()) + return -1; + return SPIFFS_read(_fs, _file, buf, nbyte); } int FSFile::read() { - if (! _file || isDirectory()) return -1; + if (! _file || isDirectory()) + return -1; int val; - if(SPIFFS_read(&_filesystemStorageHandle, _file, &val, 1) != 1) return -1; + if(SPIFFS_read(_fs, _file, &val, 1) != 1) return -1; return val; } int FSFile::peek() { - if (! _file || isDirectory()) return 0; + if (!_file || isDirectory()) + return 0; int c = read(); - SPIFFS_lseek(&_filesystemStorageHandle, _file, -1, SPIFFS_SEEK_CUR); + SPIFFS_lseek(_fs, _file, -1, SPIFFS_SEEK_CUR); return c; } size_t FSFile::write(const uint8_t *buf, size_t size){ - if (! _file || isDirectory()) return 0; - int res = SPIFFS_write(&_filesystemStorageHandle, _file, (uint8_t *)buf, size); + if (!_file || isDirectory()) + return 0; + int res = SPIFFS_write(_fs, _file, (uint8_t *)buf, size); return (res > 0)?(size_t)res:0; } size_t FSFile::write(uint8_t val) { - if (! _file || isDirectory()) return 0; + if (!_file || isDirectory()) + return 0; return write(&val, 1); } void FSFile::flush(){ - if (! _file || isDirectory()) return; - SPIFFS_fflush(&_filesystemStorageHandle, _file); + if (!_file || isDirectory()) + return; + SPIFFS_fflush(_fs, _file); } bool FSFile::remove(){ - if (! _file) return 0; + if (!_file) + return 0; close(); - return SPIFFS_remove(&_filesystemStorageHandle, (char *)_stats.name) == 0; + return SPIFFS_remove(_fs, (char *)_stats.name) == 0; } int FSFile::lastError(){ - return SPIFFS_errno(&_filesystemStorageHandle); + return SPIFFS_errno(_fs); } void FSFile::clearError(){ - _filesystemStorageHandle.err_code = SPIFFS_OK; + _fs->err_code = SPIFFS_OK; } + + +static s32_t api_spiffs_read(u32_t addr, u32_t size, u8_t *dst){ + SPIFFS_API_DBG_V("api_spiffs_read: 0x%08x len: %u\n", addr, size); + flashmem_read(dst, addr, size); + return SPIFFS_OK; +} + +static s32_t api_spiffs_write(u32_t addr, u32_t size, u8_t *src){ + SPIFFS_API_DBG_V("api_spiffs_write: 0x%08x len: %u\n", addr, size); + flashmem_write(src, addr, size); + return SPIFFS_OK; +} + +static s32_t api_spiffs_erase(u32_t addr, u32_t size){ + SPIFFS_API_DBG_V("api_spiffs_erase: 0x%08x len: %u\n", addr, size); + u32_t sect_first = flashmem_get_sector_of_address(addr); + u32_t sect_last = flashmem_get_sector_of_address(addr+size); + while( sect_first <= sect_last ) + if( !flashmem_erase_sector( sect_first ++ ) ) + return SPIFFS_ERR_INTERNAL; + return SPIFFS_OK; +} + + diff --git a/cores/esp8266/FileSystem.h b/cores/esp8266/FileSystem.h index 41659da11..7baf0769c 100644 --- a/cores/esp8266/FileSystem.h +++ b/cores/esp8266/FileSystem.h @@ -21,9 +21,9 @@ #ifndef _SPIFFS_CORE_FILESYSTEM_H_ #define _SPIFFS_CORE_FILESYSTEM_H_ +#include #include "spiffs/spiffs.h" #include "Arduino.h" -class String; #define FSFILE_READ SPIFFS_RDONLY #define FSFILE_WRITE (SPIFFS_RDONLY | SPIFFS_WRONLY | SPIFFS_CREAT | SPIFFS_APPEND ) @@ -34,10 +34,11 @@ private: spiffs_stat _stats; file_t _file; spiffs_DIR _dir; + spiffs * _fs; public: - FSFile(String path); - FSFile(file_t f); + FSFile(spiffs* fs, String path); + FSFile(spiffs* fs, file_t f); FSFile(void); virtual size_t write(uint8_t); virtual size_t write(const uint8_t *buf, size_t size); @@ -83,10 +84,9 @@ public: }; class FSClass { - -private: - public: + FSClass(uint32_t beginAddress, uint32_t endAddress, uint32_t maxOpenFiles); + bool mount(); void unmount(); bool format(); @@ -97,17 +97,30 @@ public: bool rename(char *filename, char *newname); size_t totalBytes(); size_t usedBytes(); - size_t size(){ return _filesystemStorageHandle.cfg.phys_size; } - size_t blockSize(){ return _filesystemStorageHandle.cfg.log_block_size; } - size_t totalBlocks(){ return _filesystemStorageHandle.block_count; } - size_t freeBlocks(){ return _filesystemStorageHandle.free_blocks; } - size_t pageSize(){ return _filesystemStorageHandle.cfg.log_page_size; } - size_t allocatedPages(){ return _filesystemStorageHandle.stats_p_allocated; } - size_t deletedPages(){ return _filesystemStorageHandle.stats_p_deleted; } + size_t size(){ return _fs.cfg.phys_size; } + size_t blockSize(){ return _fs.cfg.log_block_size; } + size_t totalBlocks(){ return _fs.block_count; } + size_t freeBlocks(){ return _fs.free_blocks; } + size_t pageSize(){ return _fs.cfg.log_page_size; } + size_t allocatedPages(){ return _fs.stats_p_allocated; } + size_t deletedPages(){ return _fs.stats_p_deleted; } FSFile open(char *filename, uint8_t mode = FSFILE_READ); FSFile open(spiffs_dirent* entry, uint8_t mode = FSFILE_READ); +protected: + int _mountInternal(); + std::unique_ptr _work; + std::unique_ptr _fds; + size_t _fdsSize; + std::unique_ptr _cache; + size_t _cacheSize; + uint32_t _beginAddress; + uint32_t _endAddress; + uint32_t _maxOpenFiles; + spiffs _fs; + + private: friend class FSFile; }; diff --git a/cores/esp8266/core_esp8266_wiring.c b/cores/esp8266/core_esp8266_wiring.c index 67c47514c..0170b4bcf 100644 --- a/cores/esp8266/core_esp8266_wiring.c +++ b/cores/esp8266/core_esp8266_wiring.c @@ -78,5 +78,4 @@ void init() { timer1_isr_init(); os_timer_setfn(µs_overflow_timer, (os_timer_func_t*) µs_overflow_tick, 0); os_timer_arm(µs_overflow_timer, 60000, REPEAT); - spiffs_mount(); } diff --git a/cores/esp8266/spiffs/spiffs_esp8266.c b/cores/esp8266/spiffs/spiffs_esp8266.c index 56cf3813c..0b0020de7 100644 --- a/cores/esp8266/spiffs/spiffs_esp8266.c +++ b/cores/esp8266/spiffs/spiffs_esp8266.c @@ -146,79 +146,3 @@ uint32_t flashmem_get_sector_of_address( uint32_t addr ){ return (addr - INTERNAL_FLASH_START_ADDRESS) / INTERNAL_FLASH_SECTOR_SIZE;; } -/* - SPIFFS BOOTSTRAP -*/ - -//SPIFFS Address Range (defined in eagle ld) -extern uint32_t _SPIFFS_start; -extern uint32_t _SPIFFS_end; - -//SPIFFS Storage Handle -spiffs _filesystemStorageHandle; - -//SPIFFS Buffers (INTERNAL_FLASH_PAGE_SIZE = 256) Total 1792 bytes -static u8_t spiffs_work_buf[INTERNAL_FLASH_PAGE_SIZE*2]; //512 bytes -static u8_t spiffs_fds[32*4]; //128 bytes -static u8_t spiffs_cache[(INTERNAL_FLASH_PAGE_SIZE+32)*4]; //1152 bytes - -//SPIFFS API Read CallBack -static s32_t api_spiffs_read(u32_t addr, u32_t size, u8_t *dst){ - SPIFFS_API_DBG_V("api_spiffs_read: 0x%08x len: %u\n", addr, size); - flashmem_read(dst, addr, size); - return SPIFFS_OK; -} - -//SPIFFS API Write CallBack -static s32_t api_spiffs_write(u32_t addr, u32_t size, u8_t *src){ - SPIFFS_API_DBG_V("api_spiffs_write: 0x%08x len: %u\n", addr, size); - flashmem_write(src, addr, size); - return SPIFFS_OK; -} - -//SPIFFS API Erase CallBack -static s32_t api_spiffs_erase(u32_t addr, u32_t size){ - SPIFFS_API_DBG_V("api_spiffs_erase: 0x%08x len: %u\n", addr, size); - u32_t sect_first = flashmem_get_sector_of_address(addr); - u32_t sect_last = flashmem_get_sector_of_address(addr+size); - while( sect_first <= sect_last ) - if( !flashmem_erase_sector( sect_first ++ ) ) - return SPIFFS_ERR_INTERNAL; - return SPIFFS_OK; -} - -// Our own SPIFFS Setup Method -// All of the above gets put in the configuration -// and a mount attempt is made, initializing the storage handle -// that is used in all further api calls -s32_t spiffs_mount(){ - u32_t start_address = (u32_t)&_SPIFFS_start; - u32_t end_address = (u32_t)&_SPIFFS_end; - if (start_address == 0 || start_address >= end_address){ - SPIFFS_API_DBG_E("Can't start file system, wrong address"); - return SPIFFS_ERR_NOT_CONFIGURED; - } - - spiffs_config cfg = {0}; - cfg.phys_addr = start_address; - cfg.phys_size = end_address - start_address; - cfg.phys_erase_block = INTERNAL_FLASH_SECTOR_SIZE; // according to datasheet - cfg.log_block_size = INTERNAL_FLASH_SECTOR_SIZE * 2; // Important to make large - cfg.log_page_size = INTERNAL_FLASH_PAGE_SIZE; // according to datasheet - cfg.hal_read_f = api_spiffs_read; - cfg.hal_write_f = api_spiffs_write; - cfg.hal_erase_f = api_spiffs_erase; - - SPIFFS_API_DBG_V("spiffs_mount: start:%x, size:%d Kb\n", cfg.phys_addr, cfg.phys_size / 1024); - - s32_t res = SPIFFS_mount(&_filesystemStorageHandle, - &cfg, - spiffs_work_buf, - spiffs_fds, - sizeof(spiffs_fds), - spiffs_cache, - sizeof(spiffs_cache), - NULL); - SPIFFS_API_DBG_V("spiffs_mount: %d\n", res); - return res; -} diff --git a/cores/esp8266/spiffs/spiffs_esp8266.h b/cores/esp8266/spiffs/spiffs_esp8266.h index f36fbfbfe..d97f3e3e0 100644 --- a/cores/esp8266/spiffs/spiffs_esp8266.h +++ b/cores/esp8266/spiffs/spiffs_esp8266.h @@ -24,14 +24,11 @@ The small 4KB sectors allow for greater flexibility in applications that require #define INTERNAL_FLASH_WRITE_UNIT_SIZE 4 #define INTERNAL_FLASH_READ_UNIT_SIZE 4 -extern spiffs _filesystemStorageHandle; - extern uint32_t flashmem_write( const void *from, uint32_t toaddr, uint32_t size ); extern uint32_t flashmem_read( void *to, uint32_t fromaddr, uint32_t size ); extern bool flashmem_erase_sector( uint32_t sector_id ); uint32_t flashmem_find_sector( uint32_t address, uint32_t *pstart, uint32_t *pend ); uint32_t flashmem_get_sector_of_address( uint32_t addr ); -s32_t spiffs_mount(); #ifdef __cplusplus } From 25107079114de15717efd59883c96f4eb15d5fb2 Mon Sep 17 00:00:00 2001 From: Ivan Grokhotkov Date: Mon, 18 May 2015 14:54:06 +0300 Subject: [PATCH 64/78] Merge branch 'master' into esp8266 * master: (414 commits) Don't export sketch if the underlying core does not support it. Fixes #3171 RSyntaxTextArea: using a modified version, tracked at https://github.com/arduino/RSyntaxTextArea. Fixes #3099 Updated keywords.txt New editor on MacOSX: since CMD+J is known as "jump to selection" and the editor has no such feature, CMD+J is disabled on mac. See #3098 Old Preferences class remains for backwards compatibility as a delegate for PreferencesData New Preferences window: renders fine on every OS and it's easier to adapt using NetBeans as visual editor. Fixes #3140 Remove spawn from exec command Removed redundant call to File.deleteIfExists() Removed buggy redundant check in FileUtils.deleteIfExists() Restored current line/current selected lines display on lower left of the IDE. Fixes #3134 Updated cursor.ino New editor on MacOSX: restored CMD+E for finding selected text New editor on MacOSX: CMD+UP/DOWN moves cursor to start or end of sketch. See #3098 New editor on MacOSX: CMD+BACKSPACE deletes current line until cursor position, ALT+BACKSPACE deletes previous word. See #3098 ArduinoIDE is in the default package. Removed Fixes #2969: Fix Uncategorized warning message New editor: ALT+ BACKSPACE deletes next word (OSX only). See #3098 New editor: ALT+ UP/DOWN move current line only if "editor.advanced" (hidden pref) is true. Fixes #3101 New editor: mark occurrences enable when "editor.advanced" (hidden pref) is true. Fixes #3102 ... Conflicts: .gitignore build/build.xml hardware/esp8266com/esp8266/libraries/ESP8266WiFi/keywords.txt hardware/esp8266com/esp8266/libraries/ESP8266WiFi/library.properties hardware/esp8266com/esp8266/libraries/ESP8266WiFi/src/ESP8266WiFi.h libraries/WiFi/README.adoc libraries/WiFi/src/WiFi.cpp libraries/WiFi/src/WiFiClient.cpp libraries/WiFi/src/WiFiClient.h libraries/WiFi/src/WiFiServer.cpp libraries/WiFi/src/WiFiUdp.cpp --- .gitignore | 20 +++++++++++++---- libraries/ESP8266WiFi/src/WiFiServer.h | 2 +- libraries/ESP8266WiFi/src/WiFiUdp.h | 2 +- libraries/SD/README.adoc | 22 +++++++++---------- libraries/SD/examples/CardInfo/CardInfo.ino | 10 ++------- .../SD/examples/Datalogger/Datalogger.ino | 7 ------ libraries/SD/examples/DumpFile/DumpFile.ino | 7 ------ libraries/SD/examples/Files/Files.ino | 5 ----- libraries/SD/examples/ReadWrite/ReadWrite.ino | 5 ----- libraries/SD/examples/listfiles/listfiles.ino | 5 ----- libraries/SD/keywords.txt | 4 ++-- libraries/SD/library.properties | 18 +++++++-------- libraries/SD/src/SD.cpp | 2 +- libraries/SD/src/utility/Sd2Card.cpp | 4 ++-- 14 files changed, 45 insertions(+), 68 deletions(-) diff --git a/.gitignore b/.gitignore index 44f4cda8b..3c8c0fe5c 100644 --- a/.gitignore +++ b/.gitignore @@ -21,32 +21,36 @@ build/windows/libastylej* build/windows/arduino-*.zip build/windows/dist/*.tar.gz build/windows/dist/*.tar.bz2 -build/windows/launch4j-* +build/windows/launch4j-*.tgz +build/windows/launch4j-*.zip build/windows/launcher/launch4j build/windows/WinAVR-*.zip build/macosx/arduino-*.zip build/macosx/dist/*.tar.gz build/macosx/dist/*.tar.bz2 +build/macosx/*.tar.bz2 build/macosx/libastylej* build/macosx/appbundler*.jar build/macosx/appbundler*.zip build/macosx/appbundler build/macosx/appbundler-1.0ea-arduino2 +build/macosx/appbundler-1.0ea-upstream1 build/linux/work/ build/linux/dist/*.tar.gz build/linux/dist/*.tar.bz2 build/linux/*.tgz +build/linux/*.tar.xz +build/linux/*.tar.bz2 build/linux/*.zip build/linux/libastylej* build/shared/reference*.zip +build/shared/Edison*.zip +build/shared/Galileo*.zip test-bin *.iml .idea .DS_Store .directory -build/windows/launch4j-* -build/windows/launcher/launch4j -build/windows/WinAVR-*.zip hardware/arduino/avr/libraries/Bridge/examples/XivelyClient/passwords.h avr-toolchain-*.zip /hardware/tools/esp8266/utils/ @@ -57,6 +61,14 @@ avr-toolchain-*.zip /hardware/tools/bossac.exe /hardware/tools/listComPorts.exe +/app/nbproject/private/ +/arduino-core/nbproject/private/ +/app/build/ +/arduino-core/build/ + +manifest.mf +nbbuild.xml +nbproject build/macosx/esptool-*-osx.zip build/macosx/dist/osx-xtensa-lx106-elf.tgz diff --git a/libraries/ESP8266WiFi/src/WiFiServer.h b/libraries/ESP8266WiFi/src/WiFiServer.h index 3dd02da7d..ef642762d 100644 --- a/libraries/ESP8266WiFi/src/WiFiServer.h +++ b/libraries/ESP8266WiFi/src/WiFiServer.h @@ -1,6 +1,6 @@ /* WiFiServer.h - Library for Arduino Wifi shield. - Copyright (c) 2011-2014 Arduino. All right reserved. + Copyright (c) 2011-2014 Arduino LLC. All right reserved. This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public diff --git a/libraries/ESP8266WiFi/src/WiFiUdp.h b/libraries/ESP8266WiFi/src/WiFiUdp.h index a6bdc00da..f8d76cd05 100644 --- a/libraries/ESP8266WiFi/src/WiFiUdp.h +++ b/libraries/ESP8266WiFi/src/WiFiUdp.h @@ -1,6 +1,6 @@ /* WiFiUdp.h - Library for Arduino Wifi shield. - Copyright (c) 2011-2014 Arduino. All right reserved. + Copyright (c) 2011-2014 Arduino LLC. All right reserved. This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public diff --git a/libraries/SD/README.adoc b/libraries/SD/README.adoc index ec57d15ce..4c6521ed3 100644 --- a/libraries/SD/README.adoc +++ b/libraries/SD/README.adoc @@ -7,18 +7,18 @@ http://arduino.cc/en/Reference/SD == License == -Copyright (c) Arduino LLC. All right reserved. + Copyright (C) 2009 by William Greiman +Copyright (c) 2010 SparkFun Electronics -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 program is free software: you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation, either version 3 of the License, or +(at your option) any later version. -This library is distributed in the hope that it will be useful, +This program 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. +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU 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 +You should have received a copy of the GNU General Public License +along with this program. If not, see . diff --git a/libraries/SD/examples/CardInfo/CardInfo.ino b/libraries/SD/examples/CardInfo/CardInfo.ino index 03bab2fd6..8d8a51ec9 100644 --- a/libraries/SD/examples/CardInfo/CardInfo.ino +++ b/libraries/SD/examples/CardInfo/CardInfo.ino @@ -44,19 +44,13 @@ void setup() Serial.print("\nInitializing SD card..."); - // On the Ethernet Shield, CS is pin 4. It's set as an output by default. - // Note that even if it's not used as the CS pin, the hardware SS pin - // (10 on most Arduino boards, 53 on the Mega) must be left as an output - // or the SD library functions will not work. - pinMode(10, OUTPUT); // change this to 53 on a mega - // we'll use the initialization code from the utility libraries // since we're just testing if the card is working! if (!card.init(SPI_HALF_SPEED, chipSelect)) { Serial.println("initialization failed. Things to check:"); - Serial.println("* is a card is inserted?"); - Serial.println("* Is your wiring correct?"); + Serial.println("* is a card inserted?"); + Serial.println("* is your wiring correct?"); Serial.println("* did you change the chipSelect pin to match your shield or module?"); return; } else { diff --git a/libraries/SD/examples/Datalogger/Datalogger.ino b/libraries/SD/examples/Datalogger/Datalogger.ino index 70e8f7051..e071b5282 100644 --- a/libraries/SD/examples/Datalogger/Datalogger.ino +++ b/libraries/SD/examples/Datalogger/Datalogger.ino @@ -23,10 +23,6 @@ #include #include -// On the Ethernet Shield, CS is pin 4. Note that even if it's not -// used as the CS pin, the hardware CS pin (10 on most Arduino boards, -// 53 on the Mega) must be left as an output or the SD library -// functions will not work. const int chipSelect = 4; void setup() @@ -39,9 +35,6 @@ void setup() Serial.print("Initializing SD card..."); - // make sure that the default chip select pin is set to - // output, even if you don't use it: - pinMode(10, OUTPUT); // see if the card is present and can be initialized: if (!SD.begin(chipSelect)) { diff --git a/libraries/SD/examples/DumpFile/DumpFile.ino b/libraries/SD/examples/DumpFile/DumpFile.ino index b2f510f58..e2eaf1c59 100644 --- a/libraries/SD/examples/DumpFile/DumpFile.ino +++ b/libraries/SD/examples/DumpFile/DumpFile.ino @@ -23,10 +23,6 @@ #include #include -// On the Ethernet Shield, CS is pin 4. Note that even if it's not -// used as the CS pin, the hardware CS pin (10 on most Arduino boards, -// 53 on the Mega) must be left as an output or the SD library -// functions will not work. const int chipSelect = 4; void setup() @@ -39,9 +35,6 @@ void setup() Serial.print("Initializing SD card..."); - // make sure that the default chip select pin is set to - // output, even if you don't use it: - pinMode(10, OUTPUT); // see if the card is present and can be initialized: if (!SD.begin(chipSelect)) { diff --git a/libraries/SD/examples/Files/Files.ino b/libraries/SD/examples/Files/Files.ino index d49539f38..f01db3828 100644 --- a/libraries/SD/examples/Files/Files.ino +++ b/libraries/SD/examples/Files/Files.ino @@ -32,11 +32,6 @@ void setup() Serial.print("Initializing SD card..."); - // On the Ethernet Shield, CS is pin 4. It's set as an output by default. - // Note that even if it's not used as the CS pin, the hardware SS pin - // (10 on most Arduino boards, 53 on the Mega) must be left as an output - // or the SD library functions will not work. - pinMode(10, OUTPUT); if (!SD.begin(4)) { Serial.println("initialization failed!"); diff --git a/libraries/SD/examples/ReadWrite/ReadWrite.ino b/libraries/SD/examples/ReadWrite/ReadWrite.ino index 42d1de388..055a0166b 100644 --- a/libraries/SD/examples/ReadWrite/ReadWrite.ino +++ b/libraries/SD/examples/ReadWrite/ReadWrite.ino @@ -33,11 +33,6 @@ void setup() Serial.print("Initializing SD card..."); - // On the Ethernet Shield, CS is pin 4. It's set as an output by default. - // Note that even if it's not used as the CS pin, the hardware SS pin - // (10 on most Arduino boards, 53 on the Mega) must be left as an output - // or the SD library functions will not work. - pinMode(10, OUTPUT); if (!SD.begin(4)) { Serial.println("initialization failed!"); diff --git a/libraries/SD/examples/listfiles/listfiles.ino b/libraries/SD/examples/listfiles/listfiles.ino index 22a79dd15..1500d74e0 100644 --- a/libraries/SD/examples/listfiles/listfiles.ino +++ b/libraries/SD/examples/listfiles/listfiles.ino @@ -35,11 +35,6 @@ void setup() } Serial.print("Initializing SD card..."); - // On the Ethernet Shield, CS is pin 4. It's set as an output by default. - // Note that even if it's not used as the CS pin, the hardware SS pin - // (10 on most Arduino boards, 53 on the Mega) must be left as an output - // or the SD library functions will not work. - pinMode(10, OUTPUT); if (!SD.begin(4)) { Serial.println("initialization failed!"); diff --git a/libraries/SD/keywords.txt b/libraries/SD/keywords.txt index 419fe04d5..9893cc91d 100644 --- a/libraries/SD/keywords.txt +++ b/libraries/SD/keywords.txt @@ -6,8 +6,8 @@ # Datatypes (KEYWORD1) ####################################### -SD KEYWORD1 -File KEYWORD1 +SD KEYWORD1 SD +File KEYWORD1 SD ####################################### # Methods and Functions (KEYWORD2) diff --git a/libraries/SD/library.properties b/libraries/SD/library.properties index ad4a6d686..4658054f8 100644 --- a/libraries/SD/library.properties +++ b/libraries/SD/library.properties @@ -1,9 +1,9 @@ -name=SD -version=1.0 -author=Arduino, SparkFun -maintainer=Arduino -sentence=Enables reading and writing on SD cards. For all Arduino boards. -paragraph=Once an SD memory card is connected to the SPI interfare of the Arduino board you are enabled to create files and read/write on them. You can also move through directories on the SD card. -category=Data Storage -url=http://arduino.cc/en/Reference/SD -architectures=* +name=SD +version=1.0.4 +author=Arduino, SparkFun +maintainer=Arduino +sentence=Enables reading and writing on SD cards. For all Arduino boards. +paragraph=Once an SD memory card is connected to the SPI interfare of the Arduino board you are enabled to create files and read/write on them. You can also move through directories on the SD card. +category=Data Storage +url=http://arduino.cc/en/Reference/SD +architectures=* diff --git a/libraries/SD/src/SD.cpp b/libraries/SD/src/SD.cpp index 6862daed8..28df356c8 100644 --- a/libraries/SD/src/SD.cpp +++ b/libraries/SD/src/SD.cpp @@ -448,7 +448,7 @@ File SDClass::open(const char *filepath, uint8_t mode) { // there is a special case for the Root directory since its a static dir if (parentdir.isRoot()) { - if ( ! file.open(SD.root, filepath, mode)) { + if ( ! file.open(root, filepath, mode)) { // failed to open the file :( return File(); } diff --git a/libraries/SD/src/utility/Sd2Card.cpp b/libraries/SD/src/utility/Sd2Card.cpp index 2d7618d65..98b6e4e84 100644 --- a/libraries/SD/src/utility/Sd2Card.cpp +++ b/libraries/SD/src/utility/Sd2Card.cpp @@ -297,7 +297,7 @@ uint8_t Sd2Card::init(uint8_t sckRateID, uint8_t chipSelectPin) { // command to go idle in SPI mode while ((status_ = cardCommand(CMD0, 0)) != R1_IDLE_STATE) { - if (((uint16_t)millis() - t0) > SD_INIT_TIMEOUT) { + if (((uint16_t)(millis() - t0)) > SD_INIT_TIMEOUT) { error(SD_CARD_ERROR_CMD0); goto fail; } @@ -319,7 +319,7 @@ uint8_t Sd2Card::init(uint8_t sckRateID, uint8_t chipSelectPin) { while ((status_ = cardAcmd(ACMD41, arg)) != R1_READY_STATE) { // check for timeout - if (((uint16_t)millis() - t0) > SD_INIT_TIMEOUT) { + if (((uint16_t)(millis() - t0)) > SD_INIT_TIMEOUT) { error(SD_CARD_ERROR_ACMD41); goto fail; } From 870b8b94782d848f3d795d8612722fe1d0a57769 Mon Sep 17 00:00:00 2001 From: Ivan Grokhotkov Date: Mon, 18 May 2015 16:04:30 +0300 Subject: [PATCH 65/78] Move tools to platform directory --- platform.txt | 4 +- tools/sdk/License | 68 ++++ tools/sdk/changelog.txt | 274 +++++++++++++ tools/sdk/include/c_types.h | 86 ++++ tools/sdk/include/eagle_soc.h | 312 +++++++++++++++ tools/sdk/include/espconn.h | 598 ++++++++++++++++++++++++++++ tools/sdk/include/ets_sys.h | 124 ++++++ tools/sdk/include/gpio.h | 100 +++++ tools/sdk/include/ip_addr.h | 68 ++++ tools/sdk/include/json/json.h | 70 ++++ tools/sdk/include/json/jsonparse.h | 94 +++++ tools/sdk/include/json/jsontree.h | 145 +++++++ tools/sdk/include/mem.h | 13 + tools/sdk/include/os_type.h | 19 + tools/sdk/include/osapi.h | 58 +++ tools/sdk/include/ping.h | 32 ++ tools/sdk/include/queue.h | 204 ++++++++++ tools/sdk/include/smartconfig.h | 30 ++ tools/sdk/include/sntp.h | 60 +++ tools/sdk/include/spi_flash.h | 31 ++ tools/sdk/include/uart_register.h | 128 ++++++ tools/sdk/include/upgrade.h | 51 +++ tools/sdk/include/user_interface.h | 390 ++++++++++++++++++ tools/sdk/ld/eagle.app.v6.common.ld | 185 +++++++++ tools/sdk/ld/eagle.flash.1m128.ld | 17 + tools/sdk/ld/eagle.flash.1m256.ld | 17 + tools/sdk/ld/eagle.flash.1m512.ld | 17 + tools/sdk/ld/eagle.flash.1m64.ld | 17 + tools/sdk/ld/eagle.flash.2m.ld | 17 + tools/sdk/ld/eagle.flash.4m.ld | 17 + tools/sdk/ld/eagle.flash.512k.ld | 17 + tools/sdk/ld/eagle.rom.addr.v6.ld | 347 ++++++++++++++++ tools/sdk/lib/libhal.a | Bin 0 -> 349408 bytes tools/sdk/lib/libjson.a | Bin 0 -> 12714 bytes tools/sdk/lib/liblwip.a | Bin 0 -> 299544 bytes tools/sdk/lib/libmain.a | Bin 0 -> 109456 bytes tools/sdk/lib/libnet80211.a | Bin 0 -> 186022 bytes tools/sdk/lib/libphy.a | Bin 0 -> 145068 bytes tools/sdk/lib/libpp.a | Bin 0 -> 180144 bytes tools/sdk/lib/libsmartconfig.a | Bin 0 -> 93184 bytes tools/sdk/lib/libssc.a | Bin 0 -> 10640 bytes tools/sdk/lib/libssl.a | Bin 0 -> 164570 bytes tools/sdk/lib/libupgrade.a | Bin 0 -> 16212 bytes tools/sdk/lib/libwpa.a | Bin 0 -> 124464 bytes tools/sdk/version | 1 + 45 files changed, 3609 insertions(+), 2 deletions(-) create mode 100644 tools/sdk/License create mode 100644 tools/sdk/changelog.txt create mode 100644 tools/sdk/include/c_types.h create mode 100644 tools/sdk/include/eagle_soc.h create mode 100644 tools/sdk/include/espconn.h create mode 100644 tools/sdk/include/ets_sys.h create mode 100644 tools/sdk/include/gpio.h create mode 100644 tools/sdk/include/ip_addr.h create mode 100755 tools/sdk/include/json/json.h create mode 100755 tools/sdk/include/json/jsonparse.h create mode 100755 tools/sdk/include/json/jsontree.h create mode 100644 tools/sdk/include/mem.h create mode 100644 tools/sdk/include/os_type.h create mode 100644 tools/sdk/include/osapi.h create mode 100644 tools/sdk/include/ping.h create mode 100644 tools/sdk/include/queue.h create mode 100644 tools/sdk/include/smartconfig.h create mode 100755 tools/sdk/include/sntp.h create mode 100644 tools/sdk/include/spi_flash.h create mode 100644 tools/sdk/include/uart_register.h create mode 100755 tools/sdk/include/upgrade.h create mode 100644 tools/sdk/include/user_interface.h create mode 100644 tools/sdk/ld/eagle.app.v6.common.ld create mode 100644 tools/sdk/ld/eagle.flash.1m128.ld create mode 100644 tools/sdk/ld/eagle.flash.1m256.ld create mode 100644 tools/sdk/ld/eagle.flash.1m512.ld create mode 100644 tools/sdk/ld/eagle.flash.1m64.ld create mode 100644 tools/sdk/ld/eagle.flash.2m.ld create mode 100644 tools/sdk/ld/eagle.flash.4m.ld create mode 100644 tools/sdk/ld/eagle.flash.512k.ld create mode 100644 tools/sdk/ld/eagle.rom.addr.v6.ld create mode 100644 tools/sdk/lib/libhal.a create mode 100755 tools/sdk/lib/libjson.a create mode 100644 tools/sdk/lib/liblwip.a create mode 100644 tools/sdk/lib/libmain.a create mode 100644 tools/sdk/lib/libnet80211.a create mode 100644 tools/sdk/lib/libphy.a create mode 100644 tools/sdk/lib/libpp.a create mode 100644 tools/sdk/lib/libsmartconfig.a create mode 100755 tools/sdk/lib/libssc.a create mode 100644 tools/sdk/lib/libssl.a create mode 100755 tools/sdk/lib/libupgrade.a create mode 100644 tools/sdk/lib/libwpa.a create mode 100644 tools/sdk/version diff --git a/platform.txt b/platform.txt index 2df70eb14..c7c1f7a7f 100644 --- a/platform.txt +++ b/platform.txt @@ -8,7 +8,7 @@ name=ESP8266 Modules version=1.6.1 -compiler.tools.path={runtime.ide.path}/hardware/tools/esp8266/ +compiler.tools.path={runtime.platform.path}/tools/ compiler.path={compiler.tools.path}xtensa-lx106-elf/bin/ compiler.sdk.path={compiler.tools.path}sdk/ @@ -85,7 +85,7 @@ recipe.size.regex=^(?:\.text|\.data|\.rodata|\.irom0\.text|)\s+([0-9]+).* tools.esptool.cmd=esptool tools.esptool.cmd.windows=esptool.exe -tools.esptool.path={runtime.ide.path}/hardware/tools/esp8266 +tools.esptool.path={compiler.tools.path} tools.esptool.upload.protocol=esp tools.esptool.upload.params.verbose=-vv diff --git a/tools/sdk/License b/tools/sdk/License new file mode 100644 index 000000000..38adccb1e --- /dev/null +++ b/tools/sdk/License @@ -0,0 +1,68 @@ +ESPRESSIF GENERAL PUBLIC LICENSE + +PREAMBLE + +The Espressif General Public License is a free, copyleft license for software and other kinds of works. +The Espressif General Public License is intended to guarantee your freedom to share and change all versions of a program released by ESPRESSIF SYSTEMS (SHANGHAI) PTE LTD, to make sure it remains free software for all its users. We use the Espressif General Public License for all of our open-source software. +When we speak of free software, we are referring to freedom, not price. Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software (and charge for them if you wish), that you receive source code or can get it if you want it, that you can change the software or use pieces of it in new free programs, and that you know you can do these things. +To protect your rights, we need to prevent others from denying you these rights or asking you to surrender the rights. Therefore, you have certain responsibilities if you distribute copies of the software, or if you modify it: responsibilities to respect the freedom of others. For example, if you distribute copies of such a program, whether gratis or for a fee, you must pass on to the recipients the same freedoms that you received. You must make sure that they, too, receive or can get the source code. And you must show them these terms so they know their rights. +Developers that use the Espressif GPL protect your rights with two steps: (1) assert copyright on the software, and (2) offer you this License giving you legal permission to copy, distribute and/or modify it. +For the developers' and authors' protection, the GPL clearly explains that there is no warranty for this free software. For both users' and authors' sake, the GPL requires that modified versions be marked as changed, so that their problems will not be attributed erroneously to authors of previous versions. + +TERMS AND CONDITIONS + +0. Definitions. +¡°This License¡± refers to the Espressif Public License. + +¡°The Program¡± refers to any copyrightable work licensed under this License. Each licensee is addressed as ¡°you¡±. ¡°Licensees¡± and ¡°recipients¡± may be individuals or organizations. +To ¡°modify¡± a work means to copy from or adapt all or part of the work in a fashion requiring copyright permission, other than the making of an exact copy. The resulting work is called a ¡°modified version¡± of the earlier work or a work ¡°based on¡± the earlier work. +A ¡°covered work¡± means either the unmodified Program or a work based on the Program. +To ¡°propagate¡± a work means to do anything with it that, without permission, would make you directly or secondarily liable for infringement under applicable copyright law, except executing it on a computer or modifying a private copy. Propagation includes copying, distribution (with or without modification), making available to the public, and in some countries other activities as well. +To ¡°convey¡± a work means any kind of propagation that enables other parties to make or receive copies. Mere interaction with a user through a computer network, with no transfer of a copy, is not conveying. +1. Basic Permissions. +All rights granted under this License are granted for the term of copyright on the Program, and are irrevocable provided the stated conditions are met. This License explicitly affirms your unlimited permission to run the unmodified Program. The output from running a covered work is covered by this License only if the output, given its content, constitutes a covered work. This License acknowledges your rights of fair use or other equivalent, as provided by copyright law. +You may make, run and propagate covered works that you do not convey, without conditions so long as your license otherwise remains in force. You may convey covered works to others for the sole purpose of having them make modifications exclusively for you, or provide you with facilities for running those works, provided that you comply with the terms of this License in conveying all material for which you do not control copyright. Those thus making or running the covered works for you must do so exclusively on your behalf, under your direction and control, on terms that prohibit them from making any copies of your copyrighted material outside their relationship with you. +Conveying under any other circumstances is permitted solely under the conditions stated below. + +2. Protecting Users' Legal Rights From Anti-Circumvention Law. +No covered work shall be deemed part of an effective technological measure under any applicable law prohibiting or restricting circumvention of such measures. +When you convey a covered work, you waive any legal power to forbid circumvention of technological measures to the extent such circumvention is effected by exercising rights under this License with respect to the covered work, and you disclaim any intention to limit operation or modification of the work as a means of enforcing, against the work's users, your or third parties' legal rights to forbid circumvention of technological measures. + +3. Conveying Verbatim Copies. +You may convey verbatim copies of the Program's source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice; keep intact all notices stating that this License applies to the code; keep intact all notices of the absence of any warranty; and give all recipients a copy of this License along with the Program. +You may charge any price or no price for each copy that you convey, and you may offer support or warranty protection for a fee. + +4. Conveying Modified Source Versions. +You may convey a work based on the Program, or the modifications to produce it from the Program, in the form of source code under the terms of section 3, provided that you also meet all of these conditions: +a) The work must carry prominent notices stating that you modified it, and giving a relevant date. +b) The work must carry prominent notices stating that it is released under this License. This requirement modifies the requirement in section 3 to ¡°keep intact all notices¡±. +c) You must license the entire work, as a whole, under this License to anyone who comes into possession of a copy. This License will therefore apply, to the whole of the work, and all its parts, regardless of how they are packaged. This License gives no permission to license the work in any other way, but it does not invalidate such permission if you have separately received it. + +5. Termination. +You may not propagate or modify a covered work except as expressly provided under this License. Any attempt otherwise to propagate or modify it is void, and will automatically terminate your rights under this License. +However, if you cease all violation of this License, then your license is reinstated (a) provisionally, unless and until the copyright holder explicitly and finally terminates your license. +Termination of your rights under this section does not terminate the licenses of parties who have received copies or rights from you under this License. If your rights have been terminated and not permanently reinstated, you do not qualify to receive new licenses for the same material under section 7. + +6. Acceptance Not Required for Having Copies. +You are not required to accept this License in order to receive or run a copy of the Program. Ancillary propagation of a covered work occurring solely as a consequence of using peer-to-peer transmission to receive a copy likewise does not require acceptance. However, nothing other than this License grants you permission to propagate or modify any covered work. These actions infringe copyright if you do not accept this License. Therefore, by modifying or propagating a covered work, you indicate your acceptance of this License to do so. + +7. Automatic Licensing of Downstream Recipients. +Each time you convey a covered work, the recipient automatically receives a license from the original licensors, to run, modify and propagate that work, subject to this License. You are not responsible for enforcing compliance by third parties with this License. + +8. No Surrender of Others' Freedom. +If conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions of this License, they do not excuse you from the conditions of this License. If you cannot convey a covered work so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not convey it at all. For example, if you agree to terms that obligate you to collect a royalty for further conveying from those to whom you convey the Program, the only way you could satisfy both those terms and this License would be to refrain entirely from conveying the Program. +9. Revised Versions of this License. +ESPRESSIF SYSTEMS (SHANGHAI) PTE LED may publish revised and/or new versions of the ESPRESSIF General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. +Each version is given a distinguishing version number. If the Program specifies that a certain numbered version of the Espressif General Public License ¡°or any later version¡± applies to it, you have the option of following the terms and conditions either of that numbered version or of any later version published by ESPRESSIF SYSTEMS (SHANGHAI) PTE LTD. If the Program does not specify a version number of the Espressif General Public License, you may choose any version ever published. + +10. Disclaimer of Warranty. +THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM ¡°AS IS¡± WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. + +11. Limitation of Liability. +IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. + + +12. Interpretation of Sections 10 and 11. +If the disclaimer of warranty and limitation of liability provided above cannot be given local legal effect according to their terms, reviewing courts shall apply local law that most closely approximates an absolute waiver of all civil liability in connection with the Program, unless a warranty or assumption of liability accompanies a copy of the Program in return for a fee. + +END OF TERMS AND CONDITIONS diff --git a/tools/sdk/changelog.txt b/tools/sdk/changelog.txt new file mode 100644 index 000000000..86bb16cee --- /dev/null +++ b/tools/sdk/changelog.txt @@ -0,0 +1,274 @@ +esp_iot_sdk_v1.0.1_15_05_04_p1 +------------------------------------------- +Here is a patch for station+softAP issue that users may have, based on SDK_v1.0.1, +solved problem that connect to ESP8266 softAP may fail in station+softAP mode. + +Sorry for the inconvenience. + +esp_iot_sdk_v1.0.1_15_04_24 Release Note +------------------------------------------- + +Resolved Issues(Bugs below are eligible for Bug Bounty Program): +1. SSL connection may fail if SSL packet size larger than 2kBytes [PeteW ] +2. UDP remote IP to be 0.0.0.0 may cause reset [Jerry S] +3. Optimize wifi_get_ip_info to fix loss of wireless connectivity problem +4. Air-Kiss restart [Orgmar] + +Optimization: +1. Optimized IOT_Espressif_EspTouch.APK (apply for access from Espressif) for improved compatibility. [???] +2. TCP server can not open again immediately with the same port [624908539] +3. Update UART driver for parity bit value may be incorrect [1062583993] +4. Add define of “ICACHE_RODATA_ATTR” for Symbol 'ICACHE_RODATA_ATTR' could not be resolved. [???] +5. Add API wifi_softap_dhcps_set_offer_option to enable/disable ESP8266 softAP DHCP server default gateway. [xyz769] +6. AT register_uart_rx_intr may enter callback twice. [???] +7.optimize document that WPA password length range : 8 ~ 64 bytes [785057041] +8. ESP8266 softAP DHCP server record 8 DHCP client's IP at most [ygjeon] +9. To set static IP (wifi_set_ip_info) has to disable DHCP first(wifi_softap_dhcps_stop or wifi_station_dhcpc_stop) +10.Add example of wifi_softap_set_dhcps_lease +11. smartconfig_start can only be called in ESP8266 station mode + +Added APIs: +1. Wi-Fi related APIs: +wifi_station_set_reconnect_policy: enable/disable reconnect when ESP8266 disconnect from router,default to be enable reconnect. +wifi_set_event_handler_cb: set event handler of ESP8266 softAP or station status change. +wifi_softap_dhcps_set_offer_option: enable/disable get router information from ESP8266 softAP, default to be enable. +2. SNTP APIs: +sntp_get_current_timestamp: get current timestamp from Jan 01, 1970, 00:00 (GMT) +sntp_get_real_time: char,get real time (GTM + 8 time zone) +sntp_init: initialize SNTP +sntp_stop: stop SNTP +sntp_setserver: set SNTP server by IP +sntp_getserver: get SNTP server IP +sntp_setservername: set SNTP server by domain name +sntp_getservername: get domain name of SNTP server set by sntp_setservername +3. MDNS APIs: +espconn_mdns_init: initialize mDNS +espconn_mdns_close: close mDNS +espconn_mdns_server_register: register mDNS server +espconn_mdns_server_unregister: unregister mDNS server +espconn_mdns_get_servername: get mDNS server name +espconn_mdns_set_servername: set mDNS server name +espconn_mdns_set_hostname: get mDNS host name +espconn_mdns_get_hostname: set mDNS host name +espconn_mdns_disable: disable mDNS +espconn_mdns_enable: endisable mDNS + +AT_v0.23 Release Note: +Optimized: +1.AT+CWJAP add parameter "bssid", for several APs may have the same SSID + +New AT commands: +1. AT+CIPSENDBUF: write data into TCP-send-buffer; non-blocking. Background task automatically handles transmission. Has much higher throughput. +2. AT+CIPBUFRESET: resets segment count in TCP-send-buffer +3. AT+CIPBUFSTATUS: checks status of TCP-send-buffer +4. AT+CIPCHECKSEGID: checks if a specific segment in TCP-send-buffer has sent successfully + + + +esp_iot_sdk_v1.0.1_b2_15_04_10 release note +------------------------------------------- + +Fix bugs: +1.Call espconn_sent to send UDP packet in user_init cause reset.[BBP#2 reporter (????)] +2.UART & FlowControl issue: send data to FIFO without CTS flag will cause WDT [BBP#11 reporter (pvxx)] +3.SSL issue,add an API (espconn_secure_set_size) to set SSL buffer size [BBP#29 reporter (PeteW)] +4.UDP broadcast issue in WEP + +Optimize: +1.Add more details about measure ADC & VDD3P3 in appendix of document“2C-SDK-Espressif IoT SDK Programming Guide”[BBP#15 reporter (DarkByte)] +2.Can not do any WiFi related operation if WiFi mode is in NULL_MODE [BBP#23 reporter (hao.wang)] +3.start_ip and end_ip won't change through API wifi_softap_set_dhcps_lease [BBP#37 reporter (glb)] +4.AT get into busy state [BBP#35 reporter (tommy_hk)] +5.ssid + password length limitation when using AirKiss [BBP#45 reporter (zhchbin)] + +Add APIs: +1.espconn_secure_set_size:set buffer size for SSL packet +2.espconn_secure_get_size:get SSL buffer size +3.at_register_uart_rx_intr:set UART0 to be used by user or AT commands + +Add AT command: +1.AT+SLEEP: set ESP8266 sleep mode + +esp_iot_sdk_v1.0.1_b1_15_04_02 Release note +------------------------------------------- + +Fix bugs: +1. Connect to ESP8266 softAP fail after SmartConfig; +2. SmartConfig loses one bit of SSID + +Optimize: +1. espconn_set_opt: set configuration of TCP connection,add parameter for TCP keep-alive + +Add APIs: +1. espconn_clear_opt: clear configuration of TCP connection +2. espconn_set_keepalive: set configuration of TCP keep-alive to detect if TCP connection broke +3. espconn_get_keepalive: get configuration of TCP keep-alive + +AT_v0.23_b1 release note +Note: AT added some functions so flash size need to be 1024KB or more than that. + +Fix bug: +1. Always "busy" if TCP connection abnormally broke during AT+CIPSEND + +Optimize: +1. Add UDP transparent transmission +2. Optimize the initial value of AT+CWDHCP? +3. Add TCP keep-alive function in AT+CIPSTART + +Add AT command: +1. Add AT+CIPSENDEX which support quit from sending mode by "\0" (so an useful "\0" need to be "\\0") + +esp_iot_sdk_v1.0.0_15_03_20 Release Note +---------------------------------------- + +Optimize: +1. Optimize smartconfig to version v1.0; Please don't call any other APIs during SmartConfig. +2. Optimize AT to version 0.22.0.0; +3. Optimize the protection of system parameters, and add error-check about it; +4. Optimize beacon delay of ESP8266 softAP; +5. Optimize boot to version 1.3(b3); + - Add API system_restart_enhance: for factory test, support to load and run program in any specific address; + - Add APIs to get boot version and start address of current user bin; + - Fix compatibility problem of dual flash; +6. Optimize sniffer, structure sniffer_buf changed, please refer to document; +7. Optimize espconn; +8. Optimize pwm; +9. Other optimize to make the software more reliable; + +Add APIs: +1. system_update_cpu_freq: change CPU frequency; +2. wifi_promiscuous_set_mac: set a mac address filter during sniffer; +3. wifi_set_broadcast_if : set which interface will UDP broadcast send from; + +Fix bugs: +1. Interrupt during flash erasing will cause wdt reset; +2. Read/write rtc memory; +3. If router disconnect to ESP8266, ESP8266 won't reconnect; +4. Connect to router which hid its SSID + +AT_v0.22 release note + +Fix bug: +1. Wrong return value of AT+CIPSTATUS; +2. wdt rest after "0,CONNECT FAIL"; + +Add AT commands: +1. Change AT commands of which configuration will store into flash to two kinds: + XXX_CUR: current, only set configuration won't save it into Flash; + XXX_DEF: default, set configuration and save it to Flash +2. Add SmartConfig in AT: + AT+CWSTARTSMART/AT+CWSTOPSMART: start / stop SmartConfig + Notice: please refer to the document, call "AT+CWSTOPSMART" to stop SmartConfig first since "AT+CWSTARTSMART", then call other AT commands. Don't call any other AT commands during SmartConfig. +2. AT+SAVETRANSLINK: save transparent transmission link to Flash; + Note:AT+CIPMODE=1 set to enter transparent transmission mode, won't save to Flash. + + +Add AT APIs +1. at_customLinkMax: set the max link that allowed, most can be 10; if you want to set it, please set it before at_init; if you didn't set it, the max link allowed is 5 by default. +2. at_enter_special_state/ at_leave_special_state:Enter/leave AT processing state. In processing state, AT core will return "busy" for any further AT commands. +3. at_set_custom_info:set custom version information of AT which can be got by AT+GMR; +4. at_get_version:get version information of AT lib . + +Optimize +1. Add UDP remote ip and remote port is allowed to be parameters of "AT+CIPSEND" +2. Move "AT+CIUPDATE" from lib to AT "demo\esp_iot_sdk\examples\at", AT demo shows how to upgrade AT firmware from a local server. Notice that AT upgrade the bin files name have to be "user1.bin" and "user2.bin". +3. Optimize "AT+CIPSTA", add gateway and netmask as parameters +4. Optimize transparent transmission. + +esp_iot_sdk_v0.9.5_15_01_22 Release Note +---------------------------------------- + +AT becomes a lib attached to esp_iot_sdk, programming guide in "document" shows APIs for user to define their own AT commands, AT bin files are in \esp_iot_sdk\bin\at + +Fix bugs: +1. Incorrect status got by API : wifi_station_get_connect_status; +2. Sniffer can not quit without restart; +3. wifi_station_ap_change always return true; +4. TCP connection issues + +Add APIs: +1. system_deep_sleep_set_option: set what the chip will do when deep-sleep wake up; +2. wifi_status_led_uninstall; +3. wifi_station_ap_get_info: get information of AP that ESP8266 station connected. +4. wifi_station_dhcpc_status & wifi_softap_dhcps_status : get DHCP status +5. smart config APIs, more details in documents. +6. add beacon_interval parameter in struct softap_config +7. espconn_recv_hold and espconn_recv_unhold to block TCP receiving data and unblock it. +8. AT APIs to let user define their own AT, more details in documents. + +Optimize: +1. light sleep, modem sleep, deep sleep +2. compile method: ./gen_misc.sh, then follow the tips and steps. +3. when no buffer for os_malloc, return NULL instead of malloc assert. +4. users can enable #define USE_OPTIMIZE_PRINTF in user_config.h to remove strings of os_printf from ram to irom +5. faster the re-connection of ESP8266 station to router after deep-sleep. +6. update to boot v1.2 to support new format user.bin; +7. update ARP +8. update SSL +9. revised system_deep_sleep,system_deep_sleep(0),set no wake up timer,connect a GPIO to pin RST, the chip will wake up by a falling-edge on pin RST + +esp_iot_sdk_v0.9.4_14_12_19 Release Note +---------------------------------------- + +1. Update sniffer to support capture HT20/HT40 packet; +2. Add APIs to set and get sleep type; +3. Add APIs to get version info of sdk, delete version.h; +4. RAW in LWIP is open source now, add API of function ping; +5. Update spi driver; +6. Optimize APIs related to espconn; +7. Fix some bugs to make the software more reliable; + +Known Issue: +1. exception of small probability occured while recving multi-client data in softap +2. restart of small probability occured while tcp client reconnecting + +So sorry that we have some known issues here, we will solve it ASAP. + +esp_iot_sdk_v0.9.3_14_11_21 Release Note +---------------------------------------- + +1. Add license documentation of ESPRESSIF SDK +2. Add APIs to read and write RTC memory, and APIs to get RTC time. +3. Add APIs to swap UART0 +4. Add API to read ADC, delete adc.c. +5. Add API to read spi flash id +6. Revise struct station_config, add bssid parameters to distinguish different AP with same ssid ; + Note: if station_config.bssid_set == 1 , station_config.bssid has to be set, or connection will fail. So in general, station_config.bssid_set need to be 0. +7. Revise struct scan_config, add scan_config.show_hidden to set whether scan APs which ssid is hidden or not; not scan, set scan_config.show_hidden to be 0. + Add bss_info.is_hidden in struct bss_info to show if this APTs ssid is hidden. +8. Revise struct softap_config, add softap_config.ssid_len. If softap_config.ssid_len == 0, check ssid till find a termination characters; otherwise it depends on softap_config.ssid_len. +9. Revise API "wifi_softap_set_config" to take effect immediately, needs not restart to make the configuration enable any more. +10. Add APIs to set and get physical layer mode(802.11b/g/n) +11. Add APIs to enable and disable DHCP server of ESP8266 softAP +12. Add APIs to enable and disable DHCP client of ESP8266 station +13. Add API to set range of ip address that get from DHCP server +14. Add APIs to set and get how many TCP connections allowed at max. +15. Add APIs to set and get how many TCP clients allowed at max to a TCP server. +16. Revise "wifi_set_ip_info" and "wifi_set_macaddr" to take effect immediately. +17. Fix some bugs to make the software more reliable. + +ESP8266EX: Fix A Potential Error For UART RX in esp_iot_sdk_v0.9.2_14_10_24 +--------------------------------------------------------------------------- + +The previously released SDK for ESP8266EX inadvertently introduced a bug that may cause a little packet loss when transferring packet by Uart RX. +So for now,I will release the patch for this bug.Please download the patch from the attachment,and refer to the following steps: +Following Commands: +1. REPLACE LIBPHY.A IN SDK/LIB +2. ADD LIBPP.A TO SDK/LIB +3. MODIFY SDK/APP/MAKEFILE +4. ADD "-lpp \" AS BELOW +-lgcc +-lhal +-lpp +-lphy +-lnet80211 +-llwip +-lwpa +-lmain +-lssc +-lssl + +esp_iot_sdk_v0.9.2_14_10_24 Release Note +---------------------------------------- + +Initial version for public, can be compiled on both windows and lubuntu. diff --git a/tools/sdk/include/c_types.h b/tools/sdk/include/c_types.h new file mode 100644 index 000000000..b5385126c --- /dev/null +++ b/tools/sdk/include/c_types.h @@ -0,0 +1,86 @@ +/* + * Copyright (c) 2010 - 2011 Espressif System + * + */ + +#ifndef _C_TYPES_H_ +#define _C_TYPES_H_ +#include +#include +#include + +typedef signed char sint8_t; +typedef signed short sint16_t; +typedef signed long sint32_t; +typedef signed long long sint64_t; +typedef unsigned long long u_int64_t; +typedef float real32_t; +typedef double real64_t; + +typedef unsigned char uint8; +typedef unsigned char u8; +typedef signed char sint8; +typedef signed char int8; +typedef signed char s8; +typedef unsigned short uint16; +typedef unsigned short u16; +typedef signed short sint16; +typedef signed short s16; +typedef unsigned int uint32; +typedef unsigned int u_int; +typedef unsigned int u32; +typedef signed int sint32; +typedef signed int s32; +typedef int int32; +typedef signed long long sint64; +typedef unsigned long long uint64; +typedef unsigned long long u64; +typedef float real32; +typedef double real64; + +#define __le16 u16 + +#define __packed __attribute__((packed)) + +#define LOCAL static + +#ifndef NULL +#define NULL (void *)0 +#endif /* NULL */ + +/* probably should not put STATUS here */ +typedef enum { + OK = 0, + FAIL, + PENDING, + BUSY, + CANCEL, +} STATUS; + +#define BIT(nr) (1UL << (nr)) + +#define REG_SET_BIT(_r, _b) (*(volatile uint32_t*)(_r) |= (_b)) +#define REG_CLR_BIT(_r, _b) (*(volatile uint32_t*)(_r) &= ~(_b)) + +#define DMEM_ATTR __attribute__((section(".bss"))) +#define SHMEM_ATTR + +#ifdef ICACHE_FLASH +#define ICACHE_FLASH_ATTR __attribute__((section(".irom0.text"))) +#define ICACHE_RAM_ATTR __attribute__((section(".text"))) +#define ICACHE_RODATA_ATTR __attribute__((section(".irom.text"))) +#else +#define ICACHE_FLASH_ATTR +#define ICACHE_RAM_ATTR +#define ICACHE_RODATA_ATTR +#endif /* ICACHE_FLASH */ + +#ifndef __cplusplus +#define BOOL bool +#define TRUE true +#define FALSE false + + +#endif /* !__cplusplus */ + +#endif /* _C_TYPES_H_ */ diff --git a/tools/sdk/include/eagle_soc.h b/tools/sdk/include/eagle_soc.h new file mode 100644 index 000000000..59214159e --- /dev/null +++ b/tools/sdk/include/eagle_soc.h @@ -0,0 +1,312 @@ +/* + * Copyright (c) Espressif System 2010 - 2012 + * + */ + +#ifndef _EAGLE_SOC_H_ +#define _EAGLE_SOC_H_ + +//Register Bits{{ +#define BIT31 0x80000000 +#define BIT30 0x40000000 +#define BIT29 0x20000000 +#define BIT28 0x10000000 +#define BIT27 0x08000000 +#define BIT26 0x04000000 +#define BIT25 0x02000000 +#define BIT24 0x01000000 +#define BIT23 0x00800000 +#define BIT22 0x00400000 +#define BIT21 0x00200000 +#define BIT20 0x00100000 +#define BIT19 0x00080000 +#define BIT18 0x00040000 +#define BIT17 0x00020000 +#define BIT16 0x00010000 +#define BIT15 0x00008000 +#define BIT14 0x00004000 +#define BIT13 0x00002000 +#define BIT12 0x00001000 +#define BIT11 0x00000800 +#define BIT10 0x00000400 +#define BIT9 0x00000200 +#define BIT8 0x00000100 +#define BIT7 0x00000080 +#define BIT6 0x00000040 +#define BIT5 0x00000020 +#define BIT4 0x00000010 +#define BIT3 0x00000008 +#define BIT2 0x00000004 +#define BIT1 0x00000002 +#define BIT0 0x00000001 +//}} + +//Registers Operation {{ +#define ETS_UNCACHED_ADDR(addr) (addr) +#define ETS_CACHED_ADDR(addr) (addr) + + +#define READ_PERI_REG(addr) (*((volatile uint32_t *)ETS_UNCACHED_ADDR(addr))) +#define WRITE_PERI_REG(addr, val) (*((volatile uint32_t *)ETS_UNCACHED_ADDR(addr))) = (uint32_t)(val) +#define CLEAR_PERI_REG_MASK(reg, mask) WRITE_PERI_REG((reg), (READ_PERI_REG(reg)&(~(mask)))) +#define SET_PERI_REG_MASK(reg, mask) WRITE_PERI_REG((reg), (READ_PERI_REG(reg)|(mask))) +#define GET_PERI_REG_BITS(reg, hipos,lowpos) ((READ_PERI_REG(reg)>>(lowpos))&((1<<((hipos)-(lowpos)+1))-1)) +#define SET_PERI_REG_BITS(reg,bit_map,value,shift) (WRITE_PERI_REG((reg),(READ_PERI_REG(reg)&(~((bit_map)<<(shift))))|((value)<<(shift)) )) +//}} + +//Periheral Clock {{ +#define CPU_CLK_FREQ 80*1000000 //unit: Hz +#define APB_CLK_FREQ CPU_CLK_FREQ +#define UART_CLK_FREQ APB_CLK_FREQ +#define TIMER_CLK_FREQ (APB_CLK_FREQ>>8) //divided by 256 +//}} + +//Peripheral device base address define{{ +#define PERIPHS_DPORT_BASEADDR 0x3ff00000 +#define PERIPHS_GPIO_BASEADDR 0x60000300 +#define PERIPHS_TIMER_BASEDDR 0x60000600 +#define PERIPHS_RTC_BASEADDR 0x60000700 +#define PERIPHS_IO_MUX 0x60000800 +//}} + +//Interrupt remap control registers define{{ +#define EDGE_INT_ENABLE_REG (PERIPHS_DPORT_BASEADDR+0x04) +#define TM1_EDGE_INT_ENABLE() SET_PERI_REG_MASK(EDGE_INT_ENABLE_REG, BIT1) +#define TM1_EDGE_INT_DISABLE() CLEAR_PERI_REG_MASK(EDGE_INT_ENABLE_REG, BIT1) +//}} + +//GPIO reg {{ +#define GPIO_REG_READ(reg) READ_PERI_REG(PERIPHS_GPIO_BASEADDR + reg) +#define GPIO_REG_WRITE(reg, val) WRITE_PERI_REG(PERIPHS_GPIO_BASEADDR + reg, val) +#define GPIO_OUT_ADDRESS 0x00 +#define GPIO_OUT_W1TS_ADDRESS 0x04 +#define GPIO_OUT_W1TC_ADDRESS 0x08 + +#define GPIO_ENABLE_ADDRESS 0x0c +#define GPIO_ENABLE_W1TS_ADDRESS 0x10 +#define GPIO_ENABLE_W1TC_ADDRESS 0x14 +#define GPIO_OUT_W1TC_DATA_MASK 0x0000ffff + +#define GPIO_IN_ADDRESS 0x18 + +#define GPIO_STATUS_ADDRESS 0x1c +#define GPIO_STATUS_W1TS_ADDRESS 0x20 +#define GPIO_STATUS_W1TC_ADDRESS 0x24 +#define GPIO_STATUS_INTERRUPT_MASK 0x0000ffff + +#define GPIO_RTC_CALIB_SYNC PERIPHS_GPIO_BASEADDR+0x6c +#define RTC_CALIB_START BIT31 //first write to zero, then to one to start +#define RTC_PERIOD_NUM_MASK 0x3ff //max 8ms +#define GPIO_RTC_CALIB_VALUE PERIPHS_GPIO_BASEADDR+0x70 +#define RTC_CALIB_RDY_S 31 //after measure, flag to one, when start from zero to one, turn to zero +#define RTC_CALIB_VALUE_MASK 0xfffff + +#define GPIO_PIN0_ADDRESS 0x28 + +#define GPIO_ID_PIN0 0 +#define GPIO_ID_PIN(n) (GPIO_ID_PIN0+(n)) +#define GPIO_LAST_REGISTER_ID GPIO_ID_PIN(15) +#define GPIO_ID_NONE 0xffffffff + +#define GPIO_PIN_COUNT 16 + +#define GPIO_PIN_CONFIG_MSB 12 +#define GPIO_PIN_CONFIG_LSB 11 +#define GPIO_PIN_CONFIG_MASK 0x00001800 +#define GPIO_PIN_CONFIG_GET(x) (((x) & GPIO_PIN_CONFIG_MASK) >> GPIO_PIN_CONFIG_LSB) +#define GPIO_PIN_CONFIG_SET(x) (((x) << GPIO_PIN_CONFIG_LSB) & GPIO_PIN_CONFIG_MASK) + +#define GPIO_WAKEUP_ENABLE 1 +#define GPIO_WAKEUP_DISABLE (~GPIO_WAKEUP_ENABLE) +#define GPIO_PIN_WAKEUP_ENABLE_MSB 10 +#define GPIO_PIN_WAKEUP_ENABLE_LSB 10 +#define GPIO_PIN_WAKEUP_ENABLE_MASK 0x00000400 +#define GPIO_PIN_WAKEUP_ENABLE_GET(x) (((x) & GPIO_PIN_WAKEUP_ENABLE_MASK) >> GPIO_PIN_WAKEUP_ENABLE_LSB) +#define GPIO_PIN_WAKEUP_ENABLE_SET(x) (((x) << GPIO_PIN_WAKEUP_ENABLE_LSB) & GPIO_PIN_WAKEUP_ENABLE_MASK) + +#define GPIO_PIN_INT_TYPE_MASK 0x380 +#define GPIO_PIN_INT_TYPE_MSB 9 +#define GPIO_PIN_INT_TYPE_LSB 7 +#define GPIO_PIN_INT_TYPE_GET(x) (((x) & GPIO_PIN_INT_TYPE_MASK) >> GPIO_PIN_INT_TYPE_LSB) +#define GPIO_PIN_INT_TYPE_SET(x) (((x) << GPIO_PIN_INT_TYPE_LSB) & GPIO_PIN_INT_TYPE_MASK) + +#define GPIO_PAD_DRIVER_ENABLE 1 +#define GPIO_PAD_DRIVER_DISABLE (~GPIO_PAD_DRIVER_ENABLE) +#define GPIO_PIN_PAD_DRIVER_MSB 2 +#define GPIO_PIN_PAD_DRIVER_LSB 2 +#define GPIO_PIN_PAD_DRIVER_MASK 0x00000004 +#define GPIO_PIN_PAD_DRIVER_GET(x) (((x) & GPIO_PIN_PAD_DRIVER_MASK) >> GPIO_PIN_PAD_DRIVER_LSB) +#define GPIO_PIN_PAD_DRIVER_SET(x) (((x) << GPIO_PIN_PAD_DRIVER_LSB) & GPIO_PIN_PAD_DRIVER_MASK) + +#define GPIO_AS_PIN_SOURCE 0 +#define SIGMA_AS_PIN_SOURCE (~GPIO_AS_PIN_SOURCE) +#define GPIO_PIN_SOURCE_MSB 0 +#define GPIO_PIN_SOURCE_LSB 0 +#define GPIO_PIN_SOURCE_MASK 0x00000001 +#define GPIO_PIN_SOURCE_GET(x) (((x) & GPIO_PIN_SOURCE_MASK) >> GPIO_PIN_SOURCE_LSB) +#define GPIO_PIN_SOURCE_SET(x) (((x) << GPIO_PIN_SOURCE_LSB) & GPIO_PIN_SOURCE_MASK) +// }} + +// TIMER reg {{ +#define RTC_REG_READ(addr) READ_PERI_REG(PERIPHS_TIMER_BASEDDR + addr) +#define RTC_REG_WRITE(addr, val) WRITE_PERI_REG(PERIPHS_TIMER_BASEDDR + addr, val) +#define RTC_CLR_REG_MASK(reg, mask) CLEAR_PERI_REG_MASK(PERIPHS_TIMER_BASEDDR +reg, mask) +/* Returns the current time according to the timer timer. */ +#define NOW() RTC_REG_READ(FRC2_COUNT_ADDRESS) + +//load initial_value to timer1 +#define FRC1_LOAD_ADDRESS 0x00 + +//timer1's counter value(count from initial_value to 0) +#define FRC1_COUNT_ADDRESS 0x04 + +#define FRC1_CTRL_ADDRESS 0x08 + +//clear timer1's interrupt when write this address +#define FRC1_INT_ADDRESS 0x0c +#define FRC1_INT_CLR_MASK 0x00000001 + +//timer2's counter value(count from initial_value to 0) +#define FRC2_COUNT_ADDRESS 0x24 +// }} + +//RTC reg {{ +#define REG_RTC_BASE PERIPHS_RTC_BASEADDR + +#define RTC_GPIO_OUT (REG_RTC_BASE + 0x068) +#define RTC_GPIO_ENABLE (REG_RTC_BASE + 0x074) +#define RTC_GPIO_IN_DATA (REG_RTC_BASE + 0x08C) +#define RTC_GPIO_CONF (REG_RTC_BASE + 0x090) +#define PAD_XPD_DCDC_CONF (REG_RTC_BASE + 0x0A0) +//}} + +//PIN Mux reg {{ +#define PERIPHS_IO_MUX_FUNC 0x13 +#define PERIPHS_IO_MUX_FUNC_S 4 +#define PERIPHS_IO_MUX_PULLUP BIT7 +#define PERIPHS_IO_MUX_PULLDWN BIT6 +#define PERIPHS_IO_MUX_SLEEP_PULLUP BIT3 +#define PERIPHS_IO_MUX_SLEEP_PULLDWN BIT2 +#define PERIPHS_IO_MUX_SLEEP_OE BIT1 +#define PERIPHS_IO_MUX_OE BIT0 + +#define PERIPHS_IO_MUX_CONF_U (PERIPHS_IO_MUX + 0x00) +#define SPI0_CLK_EQU_SYS_CLK BIT8 +#define SPI1_CLK_EQU_SYS_CLK BIT9 + +#define PERIPHS_IO_MUX_MTDI_U (PERIPHS_IO_MUX + 0x04) +#define FUNC_MTDI 0 +#define FUNC_I2SI_DATA 1 +#define FUNC_HSPIQ_MISO 2 +#define FUNC_GPIO12 3 +#define FUNC_UART0_DTR 4 + +#define PERIPHS_IO_MUX_MTCK_U (PERIPHS_IO_MUX + 0x08) +#define FUNC_MTCK 0 +#define FUNC_I2SI_BCK 1 +#define FUNC_HSPID_MOSI 2 +#define FUNC_GPIO13 3 +#define FUNC_UART0_CTS 4 + +#define PERIPHS_IO_MUX_MTMS_U (PERIPHS_IO_MUX + 0x0C) +#define FUNC_MTMS 0 +#define FUNC_I2SI_WS 1 +#define FUNC_HSPI_CLK 2 +#define FUNC_GPIO14 3 +#define FUNC_UART0_DSR 4 + +#define PERIPHS_IO_MUX_MTDO_U (PERIPHS_IO_MUX + 0x10) +#define FUNC_MTDO 0 +#define FUNC_I2SO_BCK 1 +#define FUNC_HSPI_CS0 2 +#define FUNC_GPIO15 3 +#define FUNC_U0RTS 4 +#define FUNC_UART0_RTS 4 + +#define PERIPHS_IO_MUX_U0RXD_U (PERIPHS_IO_MUX + 0x14) +#define FUNC_U0RXD 0 +#define FUNC_I2SO_DATA 1 +#define FUNC_GPIO3 3 +#define FUNC_CLK_XTAL_BK 4 + +#define PERIPHS_IO_MUX_U0TXD_U (PERIPHS_IO_MUX + 0x18) +#define FUNC_U0TXD 0 +#define FUNC_SPICS1 1 +#define FUNC_GPIO1 3 +#define FUNC_CLK_RTC_BK 4 + +#define PERIPHS_IO_MUX_SD_CLK_U (PERIPHS_IO_MUX + 0x1c) +#define FUNC_SDCLK 0 +#define FUNC_SPICLK 1 +#define FUNC_GPIO6 3 +#define UART1_CTS 4 + +#define PERIPHS_IO_MUX_SD_DATA0_U (PERIPHS_IO_MUX + 0x20) +#define FUNC_SDDATA0 0 +#define FUNC_SPIQ_MISO 1 +#define FUNC_SPIQ 1 +#define FUNC_GPIO7 3 +#define FUNC_U1TXD 4 +#define FUNC_UART1_TXD 4 + +#define PERIPHS_IO_MUX_SD_DATA1_U (PERIPHS_IO_MUX + 0x24) +#define FUNC_SDDATA1 0 +#define FUNC_SPID_MOSI 1 +#define FUNC_SPID 1 +#define FUNC_GPIO8 3 +#define FUNC_U1RXD 4 +#define FUNC_UART1_RXD 4 +#define FUNC_SDDATA1_U1RXD 7 + +#define PERIPHS_IO_MUX_SD_DATA2_U (PERIPHS_IO_MUX + 0x28) +#define FUNC_SDDATA2 0 +#define FUNC_SPIHD 1 +#define FUNC_GPIO9 3 +#define UFNC_HSPIHD 4 + +#define PERIPHS_IO_MUX_SD_DATA3_U (PERIPHS_IO_MUX + 0x2c) +#define FUNC_SDDATA3 0 +#define FUNC_SPIWP 1 +#define FUNC_GPIO10 3 +#define FUNC_HSPIWP 4 + +#define PERIPHS_IO_MUX_SD_CMD_U (PERIPHS_IO_MUX + 0x30) +#define FUNC_SDCMD 0 +#define FUNC_SPICS0 1 +#define FUNC_GPIO11 3 +#define U1RTS 4 +#define UART1_RTS 4 + +#define PERIPHS_IO_MUX_GPIO0_U (PERIPHS_IO_MUX + 0x34) +#define FUNC_GPIO0 0 +#define FUNC_SPICS2 1 +#define FUNC_CLK_OUT 4 + +#define PERIPHS_IO_MUX_GPIO2_U (PERIPHS_IO_MUX + 0x38) +#define FUNC_GPIO2 0 +#define FUNC_I2SO_WS 1 +#define FUNC_U1TXD_BK 2 +#define FUNC_UART1_TXD_BK 2 +#define FUNC_U0TXD_BK 4 +#define FUNC_UART0_TXD_BK 4 + +#define PERIPHS_IO_MUX_GPIO4_U (PERIPHS_IO_MUX + 0x3C) +#define FUNC_GPIO4 0 +#define FUNC_CLK_XTAL 1 + +#define PERIPHS_IO_MUX_GPIO5_U (PERIPHS_IO_MUX + 0x40) +#define FUNC_GPIO5 0 +#define FUNC_CLK_RTC 1 + +#define PIN_PULLUP_DIS(PIN_NAME) CLEAR_PERI_REG_MASK(PIN_NAME, PERIPHS_IO_MUX_PULLUP) +#define PIN_PULLUP_EN(PIN_NAME) SET_PERI_REG_MASK(PIN_NAME, PERIPHS_IO_MUX_PULLUP) +#define PIN_PULLDWN_DIS(PIN_NAME) CLEAR_PERI_REG_MASK(PIN_NAME, PERIPHS_IO_MUX_PULLDWN) +#define PIN_PULLDWN_EN(PIN_NAME) SET_PERI_REG_MASK(PIN_NAME, PERIPHS_IO_MUX_PULLDWN) +#define PIN_FUNC_SELECT(PIN_NAME, FUNC) do { \ + CLEAR_PERI_REG_MASK(PIN_NAME, (PERIPHS_IO_MUX_FUNC<= GPIO_ID_PIN0) && (reg_id <= GPIO_ID_PIN(GPIO_PIN_COUNT-1))) + +#define GPIO_REGID_TO_PINIDX(reg_id) ((reg_id) - GPIO_ID_PIN0) + +typedef enum { + GPIO_PIN_INTR_DISABLE = 0, + GPIO_PIN_INTR_POSEDGE = 1, + GPIO_PIN_INTR_NEGEDGE = 2, + GPIO_PIN_INTR_ANYEDGE = 3, + GPIO_PIN_INTR_LOLEVEL = 4, + GPIO_PIN_INTR_HILEVEL = 5 +} GPIO_INT_TYPE; + +#define GPIO_OUTPUT_SET(gpio_no, bit_value) \ + gpio_output_set(bit_value<>gpio_no)&BIT0) + +/* GPIO interrupt handler, registered through gpio_intr_handler_register */ +typedef void (* gpio_intr_handler_fn_t)(uint32 intr_mask, void *arg); + + +/* + * Initialize GPIO. This includes reading the GPIO Configuration DataSet + * to initialize "output enables" and pin configurations for each gpio pin. + * Must be called once during startup. + */ +void gpio_init(void); + +/* + * Change GPIO pin output by setting, clearing, or disabling pins. + * In general, it is expected that a bit will be set in at most one + * of these masks. If a bit is clear in all masks, the output state + * remains unchanged. + * + * There is no particular ordering guaranteed; so if the order of + * writes is significant, calling code should divide a single call + * into multiple calls. + */ +void gpio_output_set(uint32 set_mask, + uint32 clear_mask, + uint32 enable_mask, + uint32 disable_mask); + +/* + * Sample the value of GPIO input pins and returns a bitmask. + */ +uint32 gpio_input_get(void); + +/* + * Set the specified GPIO register to the specified value. + * This is a very general and powerful interface that is not + * expected to be used during normal operation. It is intended + * mainly for debug, or for unusual requirements. + */ +void gpio_register_set(uint32 reg_id, uint32 value); + +/* Get the current value of the specified GPIO register. */ +uint32 gpio_register_get(uint32 reg_id); + +/* + * Register an application-specific interrupt handler for GPIO pin + * interrupts. Once the interrupt handler is called, it will not + * be called again until after a call to gpio_intr_ack. Any GPIO + * interrupts that occur during the interim are masked. + * + * The application-specific handler is called with a mask of + * pending GPIO interrupts. After processing pin interrupts, the + * application-specific handler may wish to use gpio_intr_pending + * to check for any additional pending interrupts before it returns. + */ +void gpio_intr_handler_register(gpio_intr_handler_fn_t fn, void *arg); + +/* Determine which GPIO interrupts are pending. */ +uint32 gpio_intr_pending(void); + +/* + * Acknowledge GPIO interrupts. + * Intended to be called from the gpio_intr_handler_fn. + */ +void gpio_intr_ack(uint32 ack_mask); + +void gpio_pin_wakeup_enable(uint32 i, GPIO_INT_TYPE intr_state); + +void gpio_pin_wakeup_disable(); + +void gpio_pin_intr_state_set(uint32 i, GPIO_INT_TYPE intr_state); + +#endif // _GPIO_H_ diff --git a/tools/sdk/include/ip_addr.h b/tools/sdk/include/ip_addr.h new file mode 100644 index 000000000..fc488ea8f --- /dev/null +++ b/tools/sdk/include/ip_addr.h @@ -0,0 +1,68 @@ +#ifndef __IP_ADDR_H__ +#define __IP_ADDR_H__ + +#include "c_types.h" + +struct ip_addr { + uint32 addr; +}; + +typedef struct ip_addr ip_addr_t; + +struct ip_info { + struct ip_addr ip; + struct ip_addr netmask; + struct ip_addr gw; +}; + +#define IP4_ADDR(ipaddr, a,b,c,d) \ + (ipaddr)->addr = ((uint32)((d) & 0xff) << 24) | \ + ((uint32)((c) & 0xff) << 16) | \ + ((uint32)((b) & 0xff) << 8) | \ + (uint32)((a) & 0xff) + +/** + * Determine if two address are on the same network. + * + * @arg addr1 IP address 1 + * @arg addr2 IP address 2 + * @arg mask network identifier mask + * @return !0 if the network identifiers of both address match + */ +#define ip_addr_netcmp(addr1, addr2, mask) (((addr1)->addr & \ + (mask)->addr) == \ + ((addr2)->addr & \ + (mask)->addr)) + +/** Set an IP address given by the four byte-parts. + Little-endian version that prevents the use of htonl. */ +#define IP4_ADDR(ipaddr, a,b,c,d) \ + (ipaddr)->addr = ((uint32)((d) & 0xff) << 24) | \ + ((uint32)((c) & 0xff) << 16) | \ + ((uint32)((b) & 0xff) << 8) | \ + (uint32)((a) & 0xff) + +#define ip4_addr1(ipaddr) (((uint8*)(ipaddr))[0]) +#define ip4_addr2(ipaddr) (((uint8*)(ipaddr))[1]) +#define ip4_addr3(ipaddr) (((uint8*)(ipaddr))[2]) +#define ip4_addr4(ipaddr) (((uint8*)(ipaddr))[3]) + +#define ip4_addr1_16(ipaddr) ((uint16)ip4_addr1(ipaddr)) +#define ip4_addr2_16(ipaddr) ((uint16)ip4_addr2(ipaddr)) +#define ip4_addr3_16(ipaddr) ((uint16)ip4_addr3(ipaddr)) +#define ip4_addr4_16(ipaddr) ((uint16)ip4_addr4(ipaddr)) + + +/** 255.255.255.255 */ +#define IPADDR_NONE ((uint32)0xffffffffUL) +/** 0.0.0.0 */ +#define IPADDR_ANY ((uint32)0x00000000UL) +uint32 ipaddr_addr(const char *cp); + +#define IP2STR(addr) (uint8_t)(addr & 0xFF), (uint8_t)((addr >> 8) & 0xFF), (uint8_t)((addr >> 16) & 0xFF), (uint8_t)((addr >> 24) & 0xFF) +#define IPSTR "%d.%d.%d.%d" + +#define MAC2STR(mac) (uint8_t)mac[0], (uint8_t)mac[1], (uint8_t)mac[2], (uint8_t)mac[3], (uint8_t)mac[4], (uint8_t)mac[5] +#define MACSTR "%02x:%02x:%02x:%02x:%02x:%02x" + +#endif /* __IP_ADDR_H__ */ diff --git a/tools/sdk/include/json/json.h b/tools/sdk/include/json/json.h new file mode 100755 index 000000000..2308b5b7a --- /dev/null +++ b/tools/sdk/include/json/json.h @@ -0,0 +1,70 @@ +/* + * Copyright (c) 2011-2012, Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * 3. Neither the name of the Institute nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND + * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE + * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL + * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS + * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT + * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY + * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF + * SUCH DAMAGE. + * + * This file is part of the Contiki operating system. + */ + +/** + * \file + * A few JSON defines used for parsing and generating JSON. + * \author + * Niclas Finne + * Joakim Eriksson + */ + +#ifndef __JSON_H__ +#define __JSON_H__ + +#define JSON_TYPE_ARRAY '[' +#define JSON_TYPE_OBJECT '{' +#define JSON_TYPE_PAIR ':' +#define JSON_TYPE_PAIR_NAME 'N' /* for N:V pairs */ +#define JSON_TYPE_STRING '"' +#define JSON_TYPE_INT 'I' +#define JSON_TYPE_NUMBER '0' +#define JSON_TYPE_ERROR 0 + +/* how should we handle null vs false - both can be 0? */ +#define JSON_TYPE_NULL 'n' +#define JSON_TYPE_TRUE 't' +#define JSON_TYPE_FALSE 'f' + +#define JSON_TYPE_CALLBACK 'C' + +enum { + JSON_ERROR_OK, + JSON_ERROR_SYNTAX, + JSON_ERROR_UNEXPECTED_ARRAY, + JSON_ERROR_UNEXPECTED_END_OF_ARRAY, + JSON_ERROR_UNEXPECTED_OBJECT, + JSON_ERROR_UNEXPECTED_STRING +}; + +#define JSON_CONTENT_TYPE "application/json" + +#endif /* __JSON_H__ */ diff --git a/tools/sdk/include/json/jsonparse.h b/tools/sdk/include/json/jsonparse.h new file mode 100755 index 000000000..e1cb67a46 --- /dev/null +++ b/tools/sdk/include/json/jsonparse.h @@ -0,0 +1,94 @@ +/* + * Copyright (c) 2011-2012, Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * 3. Neither the name of the Institute nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND + * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE + * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL + * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS + * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT + * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY + * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF + * SUCH DAMAGE. + * + * This file is part of the Contiki operating system. + */ + +#ifndef __JSONPARSE_H__ +#define __JSONPARSE_H__ + +#include "c_types.h" +#include "json/json.h" + +#ifdef JSONPARSE_CONF_MAX_DEPTH +#define JSONPARSE_MAX_DEPTH JSONPARSE_CONF_MAX_DEPTH +#else +#define JSONPARSE_MAX_DEPTH 10 +#endif + +struct jsonparse_state { + const char *json; + int pos; + int len; + int depth; + /* for handling atomic values */ + int vstart; + int vlen; + char vtype; + char error; + char stack[JSONPARSE_MAX_DEPTH]; +}; + +/** + * \brief Initialize a JSON parser state. + * \param state A pointer to a JSON parser state + * \param json The string to parse as JSON + * \param len The length of the string to parse + * + * This function initializes a JSON parser state for + * parsing a string as JSON. + */ +void jsonparse_setup(struct jsonparse_state *state, const char *json, + int len); + +/* move to next JSON element */ +int jsonparse_next(struct jsonparse_state *state); + +/* copy the current JSON value into the specified buffer */ +int jsonparse_copy_value(struct jsonparse_state *state, char *buf, + int buf_size); + +/* get the current JSON value parsed as an int */ +int jsonparse_get_value_as_int(struct jsonparse_state *state); + +/* get the current JSON value parsed as a long */ +long jsonparse_get_value_as_long(struct jsonparse_state *state); + +/* get the current JSON value parsed as a unsigned long */ +unsigned long jsonparse_get_value_as_ulong(struct jsonparse_state *state); + +/* get the length of the current JSON value */ +int jsonparse_get_len(struct jsonparse_state *state); + +/* get the type of the current JSON value */ +int jsonparse_get_type(struct jsonparse_state *state); + +/* compare the JSON value with the specified string */ +int jsonparse_strcmp_value(struct jsonparse_state *state, const char *str); + +#endif /* __JSONPARSE_H__ */ diff --git a/tools/sdk/include/json/jsontree.h b/tools/sdk/include/json/jsontree.h new file mode 100755 index 000000000..0ffe9d154 --- /dev/null +++ b/tools/sdk/include/json/jsontree.h @@ -0,0 +1,145 @@ +/* + * Copyright (c) 2011-2012, Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * 3. Neither the name of the Institute nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND + * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE + * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL + * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS + * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT + * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY + * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF + * SUCH DAMAGE. + * + * This file is part of the Contiki operating system. + */ + +/** + * \file + * JSON output generation + * \author + * Niclas Finne + * Joakim Eriksson + */ + +#ifndef __JSONTREE_H__ +#define __JSONTREE_H__ + +#include "c_types.h" +#include "json/json.h" + +#ifdef JSONTREE_CONF_MAX_DEPTH +#define JSONTREE_MAX_DEPTH JSONTREE_CONF_MAX_DEPTH +#else +#define JSONTREE_MAX_DEPTH 10 +#endif /* JSONTREE_CONF_MAX_DEPTH */ + +struct jsontree_context { + struct jsontree_value *values[JSONTREE_MAX_DEPTH]; + uint16_t index[JSONTREE_MAX_DEPTH]; + int (* putchar)(int); + uint8_t depth; + uint8_t path; + int callback_state; +}; + +struct jsontree_value { + uint8_t type; + /* followed by a value */ +}; + +struct jsontree_string { + uint8_t type; + const char *value; +}; + +struct jsontree_int { + uint8_t type; + int value; +}; + +/* NOTE: the jsontree_callback set will receive a jsonparse state */ +struct jsonparse_state; +struct jsontree_callback { + uint8_t type; + int (* output)(struct jsontree_context *js_ctx); + int (* set)(struct jsontree_context *js_ctx, struct jsonparse_state *parser); +}; + +struct jsontree_pair { + const char *name; + struct jsontree_value *value; +}; + +struct jsontree_object { + uint8_t type; + uint8_t count; + struct jsontree_pair *pairs; +}; + +struct jsontree_array { + uint8_t type; + uint8_t count; + struct jsontree_value **values; +}; + +#define JSONTREE_STRING(text) {JSON_TYPE_STRING, (text)} +#define JSONTREE_PAIR(name, value) {(name), (struct jsontree_value *)(value)} +#define JSONTREE_CALLBACK(output, set) {JSON_TYPE_CALLBACK, (output), (set)} + +#define JSONTREE_OBJECT(name, ...) \ + static struct jsontree_pair jsontree_pair_##name[] = {__VA_ARGS__}; \ + static struct jsontree_object name = { \ + JSON_TYPE_OBJECT, \ + sizeof(jsontree_pair_##name)/sizeof(struct jsontree_pair), \ + jsontree_pair_##name } + +#define JSONTREE_PAIR_ARRAY(value) (struct jsontree_value *)(value) +#define JSONTREE_ARRAY(name, ...) \ + static struct jsontree_value* jsontree_value_##name[] = {__VA_ARGS__}; \ + static struct jsontree_array name = { \ + JSON_TYPE_ARRAY, \ + sizeof(jsontree_value_##name)/sizeof(struct jsontree_value*), \ + jsontree_value_##name } + +#define JSONTREE_OBJECT_EXT(name, ...) \ + static struct jsontree_pair jsontree_pair_##name[] = {__VA_ARGS__}; \ + struct jsontree_object name = { \ + JSON_TYPE_OBJECT, \ + sizeof(jsontree_pair_##name)/sizeof(struct jsontree_pair), \ + jsontree_pair_##name } + +void jsontree_setup(struct jsontree_context *js_ctx, + struct jsontree_value *root, int (* putchar)(int)); +void jsontree_reset(struct jsontree_context *js_ctx); + +const char *jsontree_path_name(const struct jsontree_context *js_ctx, + int depth); + +void jsontree_write_int(const struct jsontree_context *js_ctx, int value); +void jsontree_write_int_array(const struct jsontree_context *js_ctx, const int *text, uint32 length); + +void jsontree_write_atom(const struct jsontree_context *js_ctx, + const char *text); +void jsontree_write_string(const struct jsontree_context *js_ctx, + const char *text); +int jsontree_print_next(struct jsontree_context *js_ctx); +struct jsontree_value *jsontree_find_next(struct jsontree_context *js_ctx, + int type); + +#endif /* __JSONTREE_H__ */ diff --git a/tools/sdk/include/mem.h b/tools/sdk/include/mem.h new file mode 100644 index 000000000..ac92e74d0 --- /dev/null +++ b/tools/sdk/include/mem.h @@ -0,0 +1,13 @@ +#ifndef __MEM_H__ +#define __MEM_H__ + +//void *pvPortMalloc( size_t xWantedSize ); +//void vPortFree( void *pv ); +//void *pvPortZalloc(size_t size); + +#define os_malloc pvPortMalloc +#define os_free vPortFree +#define os_zalloc pvPortZalloc +#define os_realloc pvPortRealloc + +#endif diff --git a/tools/sdk/include/os_type.h b/tools/sdk/include/os_type.h new file mode 100644 index 000000000..a9901061a --- /dev/null +++ b/tools/sdk/include/os_type.h @@ -0,0 +1,19 @@ +/* + * copyright (c) Espressif System 2010 + * + * mapping to ETS structures + * + */ +#ifndef _OS_TYPES_H_ +#define _OS_TYPES_H_ + +#include "ets_sys.h" + +#define os_signal_t ETSSignal +#define os_param_t ETSParam +#define os_event_t ETSEvent +#define os_task_t ETSTask +#define os_timer_t ETSTimer +#define os_timer_func_t ETSTimerFunc + +#endif diff --git a/tools/sdk/include/osapi.h b/tools/sdk/include/osapi.h new file mode 100644 index 000000000..11e03803f --- /dev/null +++ b/tools/sdk/include/osapi.h @@ -0,0 +1,58 @@ +/* + * Copyright (c) 2010 Espressif System + */ + +#ifndef _OSAPI_H_ +#define _OSAPI_H_ + +#include +#include "user_config.h" + +#define os_bzero ets_bzero +#define os_delay_us ets_delay_us +#define os_install_putc1 ets_install_putc1 +#define os_install_putc2 ets_install_putc2 +#define os_intr_lock ets_intr_lock +#define os_intr_unlock ets_intr_unlock +#define os_isr_attach ets_isr_attach +#define os_isr_mask ets_isr_mask +#define os_isr_unmask ets_isr_unmask +#define os_memcmp ets_memcmp +#define os_memcpy ets_memcpy +#define os_memmove ets_memmove +#define os_memset ets_memset +#define os_putc ets_putc +#define os_str2macaddr ets_str2macaddr +#define os_strcat strcat +#define os_strchr strchr +#define os_strcmp ets_strcmp +#define os_strcpy ets_strcpy +#define os_strlen ets_strlen +#define os_strncmp ets_strncmp +#define os_strncpy ets_strncpy +#define os_strstr ets_strstr +#ifdef USE_US_TIMER +#define os_timer_arm_us(a, b, c) ets_timer_arm_new(a, b, c, 0) +#endif +#define os_timer_arm(a, b, c) ets_timer_arm_new(a, b, c, 1) +#define os_timer_disarm ets_timer_disarm +#define os_timer_done ets_timer_done +#define os_timer_handler_isr ets_timer_handler_isr +#define os_timer_init ets_timer_init +#define os_timer_setfn ets_timer_setfn + +#define os_sprintf ets_sprintf +#define os_update_cpu_frequency ets_update_cpu_frequency + +#ifdef USE_OPTIMIZE_PRINTF +#define os_printf(fmt, ...) do { \ + static const char flash_str[] ICACHE_RODATA_ATTR = fmt; \ + os_printf_plus(flash_str, ##__VA_ARGS__); \ + } while(0) +#else +extern int os_printf_plus(const char * format, ...) __attribute__ ((format (printf, 1, 2))); +#define os_printf os_printf_plus +#endif + +#endif + diff --git a/tools/sdk/include/ping.h b/tools/sdk/include/ping.h new file mode 100644 index 000000000..4ecd032b8 --- /dev/null +++ b/tools/sdk/include/ping.h @@ -0,0 +1,32 @@ +#ifndef __PING_H__ +#define __PING_H__ + + +typedef void (* ping_recv_function)(void* arg, void *pdata); +typedef void (* ping_sent_function)(void* arg, void *pdata); + +struct ping_option{ + uint32 count; + uint32 ip; + uint32 coarse_time; + ping_recv_function recv_function; + ping_sent_function sent_function; + void* reverse; +}; + +struct ping_resp{ + uint32 total_count; + uint32 resp_time; + uint32 seqno; + uint32 timeout_count; + uint32 bytes; + uint32 total_bytes; + uint32 total_time; + sint8 ping_err; +}; + +bool ping_start(struct ping_option *ping_opt); +bool ping_regist_recv(struct ping_option *ping_opt, ping_recv_function ping_recv); +bool ping_regist_sent(struct ping_option *ping_opt, ping_sent_function ping_sent); + +#endif /* __PING_H__ */ diff --git a/tools/sdk/include/queue.h b/tools/sdk/include/queue.h new file mode 100644 index 000000000..a760c8db1 --- /dev/null +++ b/tools/sdk/include/queue.h @@ -0,0 +1,204 @@ +#ifndef _SYS_QUEUE_H_ +#define _SYS_QUEUE_H_ + +#define QMD_SAVELINK(name, link) +#define TRASHIT(x) + +/* + * Singly-linked List declarations. + */ +#define SLIST_HEAD(name, type) \ +struct name { \ + struct type *slh_first; /* first element */ \ +} + +#define SLIST_HEAD_INITIALIZER(head) \ + { NULL } + +#define SLIST_ENTRY(type) \ +struct { \ + struct type *sle_next; /* next element */ \ +} + +/* + * Singly-linked List functions. + */ +#define SLIST_EMPTY(head) ((head)->slh_first == NULL) + +#define SLIST_FIRST(head) ((head)->slh_first) + +#define SLIST_FOREACH(var, head, field) \ + for ((var) = SLIST_FIRST((head)); \ + (var); \ + (var) = SLIST_NEXT((var), field)) + +#define SLIST_FOREACH_SAFE(var, head, field, tvar) \ + for ((var) = SLIST_FIRST((head)); \ + (var) && ((tvar) = SLIST_NEXT((var), field), 1); \ + (var) = (tvar)) + +#define SLIST_FOREACH_PREVPTR(var, varp, head, field) \ + for ((varp) = &SLIST_FIRST((head)); \ + ((var) = *(varp)) != NULL; \ + (varp) = &SLIST_NEXT((var), field)) + +#define SLIST_INIT(head) do { \ + SLIST_FIRST((head)) = NULL; \ +} while (0) + +#define SLIST_INSERT_AFTER(slistelm, elm, field) do { \ + SLIST_NEXT((elm), field) = SLIST_NEXT((slistelm), field); \ + SLIST_NEXT((slistelm), field) = (elm); \ +} while (0) + +#define SLIST_INSERT_HEAD(head, elm, field) do { \ + SLIST_NEXT((elm), field) = SLIST_FIRST((head)); \ + SLIST_FIRST((head)) = (elm); \ +} while (0) + +#define SLIST_NEXT(elm, field) ((elm)->field.sle_next) + +#define SLIST_REMOVE(head, elm, type, field) do { \ + QMD_SAVELINK(oldnext, (elm)->field.sle_next); \ + if (SLIST_FIRST((head)) == (elm)) { \ + SLIST_REMOVE_HEAD((head), field); \ + } \ + else { \ + struct type *curelm = SLIST_FIRST((head)); \ + while (SLIST_NEXT(curelm, field) != (elm)) \ + curelm = SLIST_NEXT(curelm, field); \ + SLIST_REMOVE_AFTER(curelm, field); \ + } \ + TRASHIT(*oldnext); \ +} while (0) + +#define SLIST_REMOVE_AFTER(elm, field) do { \ + SLIST_NEXT(elm, field) = \ + SLIST_NEXT(SLIST_NEXT(elm, field), field); \ +} while (0) + +#define SLIST_REMOVE_HEAD(head, field) do { \ + SLIST_FIRST((head)) = SLIST_NEXT(SLIST_FIRST((head)), field); \ +} while (0) + +/* + * Singly-linked Tail queue declarations. + */ +#define STAILQ_HEAD(name, type) \ + struct name { \ + struct type *stqh_first;/* first element */ \ + struct type **stqh_last;/* addr of last next element */ \ + } + +#define STAILQ_HEAD_INITIALIZER(head) \ + { NULL, &(head).stqh_first } + +#define STAILQ_ENTRY(type) \ + struct { \ + struct type *stqe_next; /* next element */ \ + } + +/* + * Singly-linked Tail queue functions. + */ +#define STAILQ_CONCAT(head1, head2) do { \ + if (!STAILQ_EMPTY((head2))) { \ + *(head1)->stqh_last = (head2)->stqh_first; \ + (head1)->stqh_last = (head2)->stqh_last; \ + STAILQ_INIT((head2)); \ + } \ + } while (0) + +#define STAILQ_EMPTY(head) ((head)->stqh_first == NULL) + +#define STAILQ_FIRST(head) ((head)->stqh_first) + +#define STAILQ_FOREACH(var, head, field) \ + for((var) = STAILQ_FIRST((head)); \ + (var); \ + (var) = STAILQ_NEXT((var), field)) + + +#define STAILQ_FOREACH_SAFE(var, head, field, tvar) \ + for ((var) = STAILQ_FIRST((head)); \ + (var) && ((tvar) = STAILQ_NEXT((var), field), 1); \ + (var) = (tvar)) + +#define STAILQ_INIT(head) do { \ + STAILQ_FIRST((head)) = NULL; \ + (head)->stqh_last = &STAILQ_FIRST((head)); \ + } while (0) + +#define STAILQ_INSERT_AFTER(head, tqelm, elm, field) do { \ + if ((STAILQ_NEXT((elm), field) = STAILQ_NEXT((tqelm), field)) == NULL)\ + (head)->stqh_last = &STAILQ_NEXT((elm), field); \ + STAILQ_NEXT((tqelm), field) = (elm); \ + } while (0) + +#define STAILQ_INSERT_HEAD(head, elm, field) do { \ + if ((STAILQ_NEXT((elm), field) = STAILQ_FIRST((head))) == NULL) \ + (head)->stqh_last = &STAILQ_NEXT((elm), field); \ + STAILQ_FIRST((head)) = (elm); \ + } while (0) + +#define STAILQ_INSERT_TAIL(head, elm, field) do { \ + STAILQ_NEXT((elm), field) = NULL; \ + *(head)->stqh_last = (elm); \ + (head)->stqh_last = &STAILQ_NEXT((elm), field); \ + } while (0) + +#define STAILQ_LAST(head, type, field) \ + (STAILQ_EMPTY((head)) ? \ + NULL : \ + ((struct type *)(void *) \ + ((char *)((head)->stqh_last) - __offsetof(struct type, field)))) + +#define STAILQ_NEXT(elm, field) ((elm)->field.stqe_next) + +#define STAILQ_REMOVE(head, elm, type, field) do { \ + QMD_SAVELINK(oldnext, (elm)->field.stqe_next); \ + if (STAILQ_FIRST((head)) == (elm)) { \ + STAILQ_REMOVE_HEAD((head), field); \ + } \ + else { \ + struct type *curelm = STAILQ_FIRST((head)); \ + while (STAILQ_NEXT(curelm, field) != (elm)) \ + curelm = STAILQ_NEXT(curelm, field); \ + STAILQ_REMOVE_AFTER(head, curelm, field); \ + } \ + TRASHIT(*oldnext); \ + } while (0) + +#define STAILQ_REMOVE_HEAD(head, field) do { \ + if ((STAILQ_FIRST((head)) = \ + STAILQ_NEXT(STAILQ_FIRST((head)), field)) == NULL) \ + (head)->stqh_last = &STAILQ_FIRST((head)); \ + } while (0) + +#define STAILQ_REMOVE_AFTER(head, elm, field) do { \ + if ((STAILQ_NEXT(elm, field) = \ + STAILQ_NEXT(STAILQ_NEXT(elm, field), field)) == NULL) \ + (head)->stqh_last = &STAILQ_NEXT((elm), field); \ + } while (0) + +#define STAILQ_SWAP(head1, head2, type) do { \ + struct type *swap_first = STAILQ_FIRST(head1); \ + struct type **swap_last = (head1)->stqh_last; \ + STAILQ_FIRST(head1) = STAILQ_FIRST(head2); \ + (head1)->stqh_last = (head2)->stqh_last; \ + STAILQ_FIRST(head2) = swap_first; \ + (head2)->stqh_last = swap_last; \ + if (STAILQ_EMPTY(head1)) \ + (head1)->stqh_last = &STAILQ_FIRST(head1); \ + if (STAILQ_EMPTY(head2)) \ + (head2)->stqh_last = &STAILQ_FIRST(head2); \ + } while (0) + +#define STAILQ_INSERT_CHAIN_HEAD(head, elm_chead, elm_ctail, field) do { \ + if ((STAILQ_NEXT(elm_ctail, field) = STAILQ_FIRST(head)) == NULL ) { \ + (head)->stqh_last = &STAILQ_NEXT(elm_ctail, field); \ + } \ + STAILQ_FIRST(head) = (elm_chead); \ + } while (0) + +#endif /* !_SYS_QUEUE_H_ */ diff --git a/tools/sdk/include/smartconfig.h b/tools/sdk/include/smartconfig.h new file mode 100644 index 000000000..22b04ff1b --- /dev/null +++ b/tools/sdk/include/smartconfig.h @@ -0,0 +1,30 @@ +/* + * Copyright (C) 2015 -2018 Espressif System + * + */ + +#ifndef __SMARTCONFIG_H__ +#define __SMARTCONFIG_H__ + +typedef void (*sc_callback_t)(void *data); + +typedef enum { + SC_STATUS_WAIT = 0, + SC_STATUS_FIND_CHANNEL, + SC_STATUS_GETTING_SSID_PSWD, + SC_STATUS_GOT_SSID_PSWD, + SC_STATUS_LINK, + SC_STATUS_LINK_OVER, +} sc_status; + +typedef enum { + SC_TYPE_ESPTOUCH = 0, + SC_TYPE_AIRKISS, +} sc_type; + +sc_status smartconfig_get_status(void); +const char *smartconfig_get_version(void); +bool smartconfig_start(sc_type type, sc_callback_t cb, ...); +bool smartconfig_stop(void); + +#endif diff --git a/tools/sdk/include/sntp.h b/tools/sdk/include/sntp.h new file mode 100755 index 000000000..2d2749a34 --- /dev/null +++ b/tools/sdk/include/sntp.h @@ -0,0 +1,60 @@ +#ifndef __SNTP_H__ +#define __SNTP_H__ + +#include "os_type.h" +#ifdef LWIP_OPEN_SRC +#include "lwip/ip_addr.h" +#else +#include "ip_addr.h" +#endif +/** + * get the seconds since Jan 01, 1970, 00:00 (GMT) + */ +uint32 sntp_get_current_timestamp(); +/** + * get real time (GTM + 8 time zone) + */ +char* sntp_get_real_time(long t); +/** + * Initialize this module. + * Send out request instantly or after SNTP_STARTUP_DELAY(_FUNC). + */ +void sntp_init(void); +/** + * Stop this module. + */ +void sntp_stop(void); +/** + * Initialize one of the NTP servers by IP address + * + * @param numdns the index of the NTP server to set must be < SNTP_MAX_SERVERS + * @param dnsserver IP address of the NTP server to set + */ +void sntp_setserver(unsigned char idx, ip_addr_t *addr); +/** + * Obtain one of the currently configured by IP address (or DHCP) NTP servers + * + * @param numdns the index of the NTP server + * @return IP address of the indexed NTP server or "ip_addr_any" if the NTP + * server has not been configured by address (or at all). + */ +ip_addr_t sntp_getserver(unsigned char idx); +/** + * Initialize one of the NTP servers by name + * + * @param numdns the index of the NTP server to set must be < SNTP_MAX_SERVERS,now sdk support SNTP_MAX_SERVERS = 3 + * @param dnsserver DNS name of the NTP server to set, to be resolved at contact time + */ +void sntp_setservername(unsigned char idx, char *server); +/** + * Obtain one of the currently configured by name NTP servers. + * + * @param numdns the index of the NTP server + * @return IP address of the indexed NTP server or NULL if the NTP + * server has not been configured by name (or at all) + */ +char *sntp_getservername(unsigned char idx); + +#define sntp_servermode_dhcp(x) + +#endif diff --git a/tools/sdk/include/spi_flash.h b/tools/sdk/include/spi_flash.h new file mode 100644 index 000000000..12dd6e174 --- /dev/null +++ b/tools/sdk/include/spi_flash.h @@ -0,0 +1,31 @@ +/* + * copyright (c) Espressif System 2010 + * + */ + +#ifndef SPI_FLASH_H +#define SPI_FLASH_H + +typedef enum { + SPI_FLASH_RESULT_OK, + SPI_FLASH_RESULT_ERR, + SPI_FLASH_RESULT_TIMEOUT +} SpiFlashOpResult; + +typedef struct{ + uint32 deviceId; + uint32 chip_size; // chip size in byte + uint32 block_size; + uint32 sector_size; + uint32 page_size; + uint32 status_mask; +} SpiFlashChip; + +#define SPI_FLASH_SEC_SIZE 4096 + +uint32 spi_flash_get_id(void); +SpiFlashOpResult spi_flash_erase_sector(uint16 sec); +SpiFlashOpResult spi_flash_write(uint32 des_addr, uint32 *src_addr, uint32 size); +SpiFlashOpResult spi_flash_read(uint32 src_addr, uint32 *des_addr, uint32 size); + +#endif diff --git a/tools/sdk/include/uart_register.h b/tools/sdk/include/uart_register.h new file mode 100644 index 000000000..6398879ee --- /dev/null +++ b/tools/sdk/include/uart_register.h @@ -0,0 +1,128 @@ +//Generated at 2012-07-03 18:44:06 +/* + * Copyright (c) 2010 - 2011 Espressif System + * + */ + +#ifndef UART_REGISTER_H_INCLUDED +#define UART_REGISTER_H_INCLUDED +#define REG_UART_BASE( i ) (0x60000000+(i)*0xf00) +//version value:32'h062000 + +#define UART_FIFO( i ) (REG_UART_BASE( i ) + 0x0) +#define UART_RXFIFO_RD_BYTE 0x000000FF +#define UART_RXFIFO_RD_BYTE_S 0 + +#define UART_INT_RAW( i ) (REG_UART_BASE( i ) + 0x4) +#define UART_RXFIFO_TOUT_INT_RAW (BIT(8)) +#define UART_BRK_DET_INT_RAW (BIT(7)) +#define UART_CTS_CHG_INT_RAW (BIT(6)) +#define UART_DSR_CHG_INT_RAW (BIT(5)) +#define UART_RXFIFO_OVF_INT_RAW (BIT(4)) +#define UART_FRM_ERR_INT_RAW (BIT(3)) +#define UART_PARITY_ERR_INT_RAW (BIT(2)) +#define UART_TXFIFO_EMPTY_INT_RAW (BIT(1)) +#define UART_RXFIFO_FULL_INT_RAW (BIT(0)) + +#define UART_INT_ST( i ) (REG_UART_BASE( i ) + 0x8) +#define UART_RXFIFO_TOUT_INT_ST (BIT(8)) +#define UART_BRK_DET_INT_ST (BIT(7)) +#define UART_CTS_CHG_INT_ST (BIT(6)) +#define UART_DSR_CHG_INT_ST (BIT(5)) +#define UART_RXFIFO_OVF_INT_ST (BIT(4)) +#define UART_FRM_ERR_INT_ST (BIT(3)) +#define UART_PARITY_ERR_INT_ST (BIT(2)) +#define UART_TXFIFO_EMPTY_INT_ST (BIT(1)) +#define UART_RXFIFO_FULL_INT_ST (BIT(0)) + +#define UART_INT_ENA( i ) (REG_UART_BASE( i ) + 0xC) +#define UART_RXFIFO_TOUT_INT_ENA (BIT(8)) +#define UART_BRK_DET_INT_ENA (BIT(7)) +#define UART_CTS_CHG_INT_ENA (BIT(6)) +#define UART_DSR_CHG_INT_ENA (BIT(5)) +#define UART_RXFIFO_OVF_INT_ENA (BIT(4)) +#define UART_FRM_ERR_INT_ENA (BIT(3)) +#define UART_PARITY_ERR_INT_ENA (BIT(2)) +#define UART_TXFIFO_EMPTY_INT_ENA (BIT(1)) +#define UART_RXFIFO_FULL_INT_ENA (BIT(0)) + +#define UART_INT_CLR( i ) (REG_UART_BASE( i ) + 0x10) +#define UART_RXFIFO_TOUT_INT_CLR (BIT(8)) +#define UART_BRK_DET_INT_CLR (BIT(7)) +#define UART_CTS_CHG_INT_CLR (BIT(6)) +#define UART_DSR_CHG_INT_CLR (BIT(5)) +#define UART_RXFIFO_OVF_INT_CLR (BIT(4)) +#define UART_FRM_ERR_INT_CLR (BIT(3)) +#define UART_PARITY_ERR_INT_CLR (BIT(2)) +#define UART_TXFIFO_EMPTY_INT_CLR (BIT(1)) +#define UART_RXFIFO_FULL_INT_CLR (BIT(0)) + +#define UART_CLKDIV( i ) (REG_UART_BASE( i ) + 0x14) +#define UART_CLKDIV_CNT 0x000FFFFF +#define UART_CLKDIV_S 0 + +#define UART_AUTOBAUD( i ) (REG_UART_BASE( i ) + 0x18) +#define UART_GLITCH_FILT 0x000000FF +#define UART_GLITCH_FILT_S 8 +#define UART_AUTOBAUD_EN (BIT(0)) + +#define UART_STATUS( i ) (REG_UART_BASE( i ) + 0x1C) +#define UART_TXD (BIT(31)) +#define UART_RTSN (BIT(30)) +#define UART_DTRN (BIT(29)) +#define UART_TXFIFO_CNT 0x000000FF +#define UART_TXFIFO_CNT_S 16 +#define UART_RXD (BIT(15)) +#define UART_CTSN (BIT(14)) +#define UART_DSRN (BIT(13)) +#define UART_RXFIFO_CNT 0x000000FF +#define UART_RXFIFO_CNT_S 0 + +#define UART_CONF0( i ) (REG_UART_BASE( i ) + 0x20) +#define UART_TXFIFO_RST (BIT(18)) +#define UART_RXFIFO_RST (BIT(17)) +#define UART_IRDA_EN (BIT(16)) +#define UART_TX_FLOW_EN (BIT(15)) +#define UART_LOOPBACK (BIT(14)) +#define UART_IRDA_RX_INV (BIT(13)) +#define UART_IRDA_TX_INV (BIT(12)) +#define UART_IRDA_WCTL (BIT(11)) +#define UART_IRDA_TX_EN (BIT(10)) +#define UART_IRDA_DPLX (BIT(9)) +#define UART_TXD_BRK (BIT(8)) +#define UART_SW_DTR (BIT(7)) +#define UART_SW_RTS (BIT(6)) +#define UART_STOP_BIT_NUM 0x00000003 +#define UART_STOP_BIT_NUM_S 4 +#define UART_BIT_NUM 0x00000003 +#define UART_BIT_NUM_S 2 +#define UART_PARITY_EN (BIT(1)) +#define UART_PARITY (BIT(0)) + +#define UART_CONF1( i ) (REG_UART_BASE( i ) + 0x24) +#define UART_RX_TOUT_EN (BIT(31)) +#define UART_RX_TOUT_THRHD 0x0000007F +#define UART_RX_TOUT_THRHD_S 24 +#define UART_RX_FLOW_EN (BIT(23)) +#define UART_RX_FLOW_THRHD 0x0000007F +#define UART_RX_FLOW_THRHD_S 16 +#define UART_TXFIFO_EMPTY_THRHD 0x0000007F +#define UART_TXFIFO_EMPTY_THRHD_S 8 +#define UART_RXFIFO_FULL_THRHD 0x0000007F +#define UART_RXFIFO_FULL_THRHD_S 0 + +#define UART_LOWPULSE( i ) (REG_UART_BASE( i ) + 0x28) +#define UART_LOWPULSE_MIN_CNT 0x000FFFFF +#define UART_LOWPULSE_MIN_CNT_S 0 + +#define UART_HIGHPULSE( i ) (REG_UART_BASE( i ) + 0x2C) +#define UART_HIGHPULSE_MIN_CNT 0x000FFFFF +#define UART_HIGHPULSE_MIN_CNT_S 0 + +#define UART_PULSE_NUM( i ) (REG_UART_BASE( i ) + 0x30) +#define UART_PULSE_NUM_CNT 0x0003FF +#define UART_PULSE_NUM_CNT_S 0 + +#define UART_DATE( i ) (REG_UART_BASE( i ) + 0x78) +#define UART_ID( i ) (REG_UART_BASE( i ) + 0x7C) +#endif // UART_REGISTER_H_INCLUDED diff --git a/tools/sdk/include/upgrade.h b/tools/sdk/include/upgrade.h new file mode 100755 index 000000000..3b6bb70ff --- /dev/null +++ b/tools/sdk/include/upgrade.h @@ -0,0 +1,51 @@ +#ifndef __UPGRADE_H__ +#define __UPGRADE_H__ + +#define SPI_FLASH_SEC_SIZE 4096 + +#define USER_BIN1 0x00 +#define USER_BIN2 0x01 + +#define UPGRADE_FLAG_IDLE 0x00 +#define UPGRADE_FLAG_START 0x01 +#define UPGRADE_FLAG_FINISH 0x02 + +#define UPGRADE_FW_BIN1 0x00 +#define UPGRADE_FW_BIN2 0x01 + +typedef void (*upgrade_states_check_callback)(void * arg); + +//#define UPGRADE_SSL_ENABLE + +struct upgrade_server_info { + uint8 ip[4]; + uint16 port; + + uint8 upgrade_flag; + + uint8 pre_version[16]; + uint8 upgrade_version[16]; + + uint32 check_times; + uint8 *url; + + upgrade_states_check_callback check_cb; + struct espconn *pespconn; +}; + +#define UPGRADE_FLAG_IDLE 0x00 +#define UPGRADE_FLAG_START 0x01 +#define UPGRADE_FLAG_FINISH 0x02 + +//bool system_upgrade_start(struct upgrade_server_info *server); +bool system_upgrade_start_ssl(struct upgrade_server_info *server); +void system_upgrade_init(); +void system_upgrade_deinit(); +bool system_upgrade(uint8 *data, uint16 len); + +#ifdef UPGRADE_SSL_ENABLE +bool system_upgrade_start_ssl(struct upgrade_server_info *server); +#else +bool system_upgrade_start(struct upgrade_server_info *server); +#endif +#endif diff --git a/tools/sdk/include/user_interface.h b/tools/sdk/include/user_interface.h new file mode 100644 index 000000000..1fa01edd9 --- /dev/null +++ b/tools/sdk/include/user_interface.h @@ -0,0 +1,390 @@ +/* + * Copyright (C) 2013 -2014 Espressif System + * + */ + +#ifndef __USER_INTERFACE_H__ +#define __USER_INTERFACE_H__ + +#include "os_type.h" +#ifdef LWIP_OPEN_SRC +#include "lwip/ip_addr.h" +#else +#include "ip_addr.h" +#endif + +#include "queue.h" +#include "user_config.h" +#include "spi_flash.h" + +#ifndef MAC2STR +#define MAC2STR(a) (a)[0], (a)[1], (a)[2], (a)[3], (a)[4], (a)[5] +#define MACSTR "%02x:%02x:%02x:%02x:%02x:%02x" +#endif + +enum rst_reason { + DEFAULT_RST_FLAG = 0, + WDT_RST_FLAG = 1, + EXP_RST_FLAG = 2 +}; + +struct rst_info{ + uint32 flag; + uint32 exccause; + uint32 epc1; + uint32 epc2; + uint32 epc3; + uint32 excvaddr; + uint32 depc; +}; + +#define UPGRADE_FW_BIN1 0x00 +#define UPGRADE_FW_BIN2 0x01 + +void system_restore(void); +void system_restart(void); + +bool system_deep_sleep_set_option(uint8 option); +void system_deep_sleep(uint32 time_in_us); + +uint8 system_upgrade_userbin_check(void); +void system_upgrade_reboot(void); +uint8 system_upgrade_flag_check(); +void system_upgrade_flag_set(uint8 flag); + +void system_timer_reinit(void); +uint32 system_get_time(void); + +/* user task's prio must be 0/1/2 !!!*/ +enum { + USER_TASK_PRIO_0 = 0, + USER_TASK_PRIO_1, + USER_TASK_PRIO_2, + USER_TASK_PRIO_MAX +}; + +bool system_os_task(os_task_t task, uint8 prio, os_event_t *queue, uint8 qlen); +bool system_os_post(uint8 prio, os_signal_t sig, os_param_t par); + +void system_print_meminfo(void); +uint32 system_get_free_heap_size(void); + +void system_set_os_print(uint8 onoff); +uint8 system_get_os_print(); + +uint64 system_mktime(uint32 year, uint32 mon, uint32 day, uint32 hour, uint32 min, uint32 sec); + +uint32 system_get_chip_id(void); + +typedef void (* init_done_cb_t)(void); + +void system_init_done_cb(init_done_cb_t cb); + +uint32 system_rtc_clock_cali_proc(void); +uint32 system_get_rtc_time(void); + +bool system_rtc_mem_read(uint8 src_addr, void *des_addr, uint16 load_size); +bool system_rtc_mem_write(uint8 des_addr, const void *src_addr, uint16 save_size); + +void system_uart_swap(void); + +uint16 system_adc_read(void); +uint16 system_get_vdd33(void); + +const char *system_get_sdk_version(void); + +#define SYS_BOOT_ENHANCE_MODE 0 +#define SYS_BOOT_NORMAL_MODE 1 + +#define SYS_BOOT_NORMAL_BIN 0 +#define SYS_BOOT_TEST_BIN 1 + +uint8 system_get_boot_version(void); +uint32 system_get_userbin_addr(void); +uint8 system_get_boot_mode(void); +bool system_restart_enhance(uint8 bin_type, uint32 bin_addr); + +#define SYS_CPU_80MHZ 80 +#define SYS_CPU_160MHZ 160 + +bool system_update_cpu_freq(uint8 freq); +uint8 system_get_cpu_freq(void); + +#define NULL_MODE 0x00 +#define STATION_MODE 0x01 +#define SOFTAP_MODE 0x02 +#define STATIONAP_MODE 0x03 + +typedef enum _auth_mode { + AUTH_OPEN = 0, + AUTH_WEP, + AUTH_WPA_PSK, + AUTH_WPA2_PSK, + AUTH_WPA_WPA2_PSK, + AUTH_MAX +} AUTH_MODE; + +uint8 wifi_get_opmode(void); +uint8 wifi_get_opmode_default(void); +bool wifi_set_opmode(uint8 opmode); +bool wifi_set_opmode_current(uint8 opmode); +uint8 wifi_get_broadcast_if(void); +bool wifi_set_broadcast_if(uint8 interface); + +struct bss_info { + STAILQ_ENTRY(bss_info) next; + + uint8 bssid[6]; + uint8 ssid[32]; + uint8 channel; + sint8 rssi; + AUTH_MODE authmode; + uint8 is_hidden; +}; + +typedef struct _scaninfo { + STAILQ_HEAD(, bss_info) *pbss; + struct espconn *pespconn; + uint8 totalpage; + uint8 pagenum; + uint8 page_sn; + uint8 data_cnt; +} scaninfo; + +typedef void (* scan_done_cb_t)(void *arg, STATUS status); + +struct station_config { + uint8 ssid[32]; + uint8 password[64]; + uint8 bssid_set; // Note: If bssid_set is 1, station will just connect to the router + // with both ssid[] and bssid[] matched. Please check about this. + uint8 bssid[6]; +}; + +bool wifi_station_get_config(struct station_config *config); +bool wifi_station_get_config_default(struct station_config *config); +bool wifi_station_set_config(struct station_config *config); +bool wifi_station_set_config_current(struct station_config *config); + +bool wifi_station_connect(void); +bool wifi_station_disconnect(void); + +struct scan_config { + uint8 *ssid; // Note: ssid == NULL, don't filter ssid. + uint8 *bssid; // Note: bssid == NULL, don't filter bssid. + uint8 channel; // Note: channel == 0, scan all channels, otherwise scan set channel. + uint8 show_hidden; // Note: show_hidden == 1, can get hidden ssid routers' info. +}; + +bool wifi_station_scan(struct scan_config *config, scan_done_cb_t cb); + +uint8 wifi_station_get_auto_connect(void); +bool wifi_station_set_auto_connect(uint8 set); + +bool wifi_station_set_reconnect_policy(bool set); + +enum { + STATION_IDLE = 0, + STATION_CONNECTING, + STATION_WRONG_PASSWORD, + STATION_NO_AP_FOUND, + STATION_CONNECT_FAIL, + STATION_GOT_IP +}; + +enum dhcp_status { + DHCP_STOPPED, + DHCP_STARTED +}; + +uint8 wifi_station_get_connect_status(void); + +uint8 wifi_station_get_current_ap_id(void); +bool wifi_station_ap_change(uint8 current_ap_id); +bool wifi_station_ap_number_set(uint8 ap_number); + +bool wifi_station_dhcpc_start(void); +bool wifi_station_dhcpc_stop(void); +enum dhcp_status wifi_station_dhcpc_status(void); + +struct softap_config { + uint8 ssid[32]; + uint8 password[64]; + uint8 ssid_len; // Note: Recommend to set it according to your ssid + uint8 channel; // Note: support 1 ~ 13 + AUTH_MODE authmode; // Note: Don't support AUTH_WEP in softAP mode. + uint8 ssid_hidden; // Note: default 0 + uint8 max_connection; // Note: default 4, max 4 + uint16 beacon_interval; // Note: support 100 ~ 60000 ms, default 100 +}; + +bool wifi_softap_get_config(struct softap_config *config); +bool wifi_softap_get_config_default(struct softap_config *config); +bool wifi_softap_set_config(struct softap_config *config); +bool wifi_softap_set_config_current(struct softap_config *config); + +struct station_info { + STAILQ_ENTRY(station_info) next; + + uint8 bssid[6]; + struct ip_addr ip; +}; + +struct dhcps_lease { + struct ip_addr start_ip; + struct ip_addr end_ip; +}; + +enum dhcps_offer_option{ + OFFER_START = 0x00, + OFFER_ROUTER = 0x01, + OFFER_END +}; + +struct station_info * wifi_softap_get_station_info(void); +void wifi_softap_free_station_info(void); +uint8 wifi_station_get_ap_info(struct station_config config[]); + +bool wifi_softap_dhcps_start(void); +bool wifi_softap_dhcps_stop(void); +bool wifi_softap_set_dhcps_lease(struct dhcps_lease *please); +enum dhcp_status wifi_softap_dhcps_status(void); +bool wifi_softap_dhcps_set_offer_option(uint8 level, void* optarg); + +#define STATION_IF 0x00 +#define SOFTAP_IF 0x01 + +bool wifi_get_ip_info(uint8 if_index, struct ip_info *info); +bool wifi_set_ip_info(uint8 if_index, struct ip_info *info); +bool wifi_get_macaddr(uint8 if_index, uint8 *macaddr); +bool wifi_set_macaddr(uint8 if_index, uint8 *macaddr); + +uint8 wifi_get_channel(void); +bool wifi_set_channel(uint8 channel); + +void wifi_status_led_install(uint8 gpio_id, uint32 gpio_name, uint8 gpio_func); +void wifi_status_led_uninstall(); + +/** Get the absolute difference between 2 u32_t values (correcting overflows) + * 'a' is expected to be 'higher' (without overflow) than 'b'. */ +#define ESP_U32_DIFF(a, b) (((a) >= (b)) ? ((a) - (b)) : (((a) + ((b) ^ 0xFFFFFFFF) + 1))) + +void wifi_promiscuous_enable(uint8 promiscuous); + +typedef void (* wifi_promiscuous_cb_t)(uint8 *buf, uint16 len); + +void wifi_set_promiscuous_rx_cb(wifi_promiscuous_cb_t cb); + +void wifi_promiscuous_set_mac(const uint8_t *address); + +enum phy_mode { + PHY_MODE_11B = 1, + PHY_MODE_11G = 2, + PHY_MODE_11N = 3 +}; + +enum phy_mode wifi_get_phy_mode(void); +bool wifi_set_phy_mode(enum phy_mode mode); + +enum sleep_type { + NONE_SLEEP_T = 0, + LIGHT_SLEEP_T, + MODEM_SLEEP_T +}; + +bool wifi_set_sleep_type(enum sleep_type type); +enum sleep_type wifi_get_sleep_type(void); + +enum { + EVENT_STAMODE_CONNECTED = 0, + EVENT_STAMODE_DISCONNECTED, + EVENT_STAMODE_AUTHMODE_CHANGE, + EVENT_STAMODE_GOT_IP, + EVENT_SOFTAPMODE_STACONNECTED, + EVENT_SOFTAPMODE_STADISCONNECTED, + EVENT_MAX +}; + +enum { + REASON_UNSPECIFIED = 1, + REASON_AUTH_EXPIRE = 2, + REASON_AUTH_LEAVE = 3, + REASON_ASSOC_EXPIRE = 4, + REASON_ASSOC_TOOMANY = 5, + REASON_NOT_AUTHED = 6, + REASON_NOT_ASSOCED = 7, + REASON_ASSOC_LEAVE = 8, + REASON_ASSOC_NOT_AUTHED = 9, + REASON_DISASSOC_PWRCAP_BAD = 10, /* 11h */ + REASON_DISASSOC_SUPCHAN_BAD = 11, /* 11h */ + REASON_IE_INVALID = 13, /* 11i */ + REASON_MIC_FAILURE = 14, /* 11i */ + REASON_4WAY_HANDSHAKE_TIMEOUT = 15, /* 11i */ + REASON_GROUP_KEY_UPDATE_TIMEOUT = 16, /* 11i */ + REASON_IE_IN_4WAY_DIFFERS = 17, /* 11i */ + REASON_GROUP_CIPHER_INVALID = 18, /* 11i */ + REASON_PAIRWISE_CIPHER_INVALID = 19, /* 11i */ + REASON_AKMP_INVALID = 20, /* 11i */ + REASON_UNSUPP_RSN_IE_VERSION = 21, /* 11i */ + REASON_INVALID_RSN_IE_CAP = 22, /* 11i */ + REASON_802_1X_AUTH_FAILED = 23, /* 11i */ + REASON_CIPHER_SUITE_REJECTED = 24, /* 11i */ + + REASON_BEACON_TIMEOUT = 200, + REASON_NO_AP_FOUND = 201, +}; + +typedef struct { + uint8 ssid[32]; + uint8 ssid_len; + uint8 bssid[6]; + uint8 channel; +} Event_StaMode_Connected_t; + +typedef struct { + uint8 ssid[32]; + uint8 ssid_len; + uint8 bssid[6]; + uint8 reason; +} Event_StaMode_Disconnected_t; + +typedef struct { + uint8 old_mode; + uint8 new_mode; +} Event_StaMode_AuthMode_Change_t; + +typedef struct { + struct ip_addr ip; + struct ip_addr mask; + struct ip_addr gw; +} Event_StaMode_Got_IP_t; + +typedef struct { + uint8 mac[6]; + uint8 aid; +} Event_SoftAPMode_StaConnected_t; + +typedef struct { + uint8 mac[6]; + uint8 aid; +} Event_SoftAPMode_StaDisconnected_t; + +typedef union { + Event_StaMode_Connected_t connected; + Event_StaMode_Disconnected_t disconnected; + Event_StaMode_AuthMode_Change_t auth_change; + Event_StaMode_Got_IP_t got_ip; + Event_SoftAPMode_StaConnected_t sta_connected; + Event_SoftAPMode_StaDisconnected_t sta_disconnected; +} Event_Info_u; + +typedef struct _esp_event { + uint32 event; + Event_Info_u event_info; +} System_Event_t; + +typedef void (* wifi_event_handler_cb_t)(System_Event_t *event); + +void wifi_set_event_handler_cb(wifi_event_handler_cb_t cb); + +#endif diff --git a/tools/sdk/ld/eagle.app.v6.common.ld b/tools/sdk/ld/eagle.app.v6.common.ld new file mode 100644 index 000000000..986b441ff --- /dev/null +++ b/tools/sdk/ld/eagle.app.v6.common.ld @@ -0,0 +1,185 @@ +/* This linker script generated from xt-genldscripts.tpp for LSP . */ +/* Linker Script for ld -N */ + +PHDRS +{ + dport0_0_phdr PT_LOAD; + dram0_0_phdr PT_LOAD; + dram0_0_bss_phdr PT_LOAD; + iram1_0_phdr PT_LOAD; + irom0_0_phdr PT_LOAD; +} + + +/* Default entry point: */ +ENTRY(call_user_start) +PROVIDE(_memmap_vecbase_reset = 0x40000000); +/* Various memory-map dependent cache attribute settings: */ +_memmap_cacheattr_wb_base = 0x00000110; +_memmap_cacheattr_wt_base = 0x00000110; +_memmap_cacheattr_bp_base = 0x00000220; +_memmap_cacheattr_unused_mask = 0xFFFFF00F; +_memmap_cacheattr_wb_trapnull = 0x2222211F; +_memmap_cacheattr_wba_trapnull = 0x2222211F; +_memmap_cacheattr_wbna_trapnull = 0x2222211F; +_memmap_cacheattr_wt_trapnull = 0x2222211F; +_memmap_cacheattr_bp_trapnull = 0x2222222F; +_memmap_cacheattr_wb_strict = 0xFFFFF11F; +_memmap_cacheattr_wt_strict = 0xFFFFF11F; +_memmap_cacheattr_bp_strict = 0xFFFFF22F; +_memmap_cacheattr_wb_allvalid = 0x22222112; +_memmap_cacheattr_wt_allvalid = 0x22222112; +_memmap_cacheattr_bp_allvalid = 0x22222222; +PROVIDE(_memmap_cacheattr_reset = _memmap_cacheattr_wb_trapnull); + +SECTIONS +{ + + .dport0.rodata : ALIGN(4) + { + _dport0_rodata_start = ABSOLUTE(.); + *(.dport0.rodata) + *(.dport.rodata) + _dport0_rodata_end = ABSOLUTE(.); + } >dport0_0_seg :dport0_0_phdr + + .dport0.literal : ALIGN(4) + { + _dport0_literal_start = ABSOLUTE(.); + *(.dport0.literal) + *(.dport.literal) + _dport0_literal_end = ABSOLUTE(.); + } >dport0_0_seg :dport0_0_phdr + + .dport0.data : ALIGN(4) + { + _dport0_data_start = ABSOLUTE(.); + *(.dport0.data) + *(.dport.data) + _dport0_data_end = ABSOLUTE(.); + } >dport0_0_seg :dport0_0_phdr + + .data : ALIGN(4) + { + _data_start = ABSOLUTE(.); + *(.data) + *(.data.*) + *(.gnu.linkonce.d.*) + *(.data1) + *(.sdata) + *(.sdata.*) + *(.gnu.linkonce.s.*) + *(.sdata2) + *(.sdata2.*) + *(.gnu.linkonce.s2.*) + *(.jcr) + _data_end = ABSOLUTE(.); + } >dram0_0_seg :dram0_0_phdr + + .rodata : ALIGN(4) + { + _rodata_start = ABSOLUTE(.); + *(.rodata) + *(.rodata.*) + *(.gnu.linkonce.r.*) + *(.rodata1) + __XT_EXCEPTION_TABLE__ = ABSOLUTE(.); + *(.xt_except_table) + *(.gcc_except_table) + *(.gnu.linkonce.e.*) + *(.gnu.version_r) + *(.eh_frame) + . = (. + 3) & ~ 3; + /* C++ constructor and destructor tables, properly ordered: */ + __init_array_start = ABSOLUTE(.); + KEEP (*crtbegin.o(.ctors)) + KEEP (*(EXCLUDE_FILE (*crtend.o) .ctors)) + KEEP (*(SORT(.ctors.*))) + KEEP (*(.ctors)) + __init_array_end = ABSOLUTE(.); + KEEP (*crtbegin.o(.dtors)) + KEEP (*(EXCLUDE_FILE (*crtend.o) .dtors)) + KEEP (*(SORT(.dtors.*))) + KEEP (*(.dtors)) + /* C++ exception handlers table: */ + __XT_EXCEPTION_DESCS__ = ABSOLUTE(.); + *(.xt_except_desc) + *(.gnu.linkonce.h.*) + __XT_EXCEPTION_DESCS_END__ = ABSOLUTE(.); + *(.xt_except_desc_end) + *(.dynamic) + *(.gnu.version_d) + . = ALIGN(4); /* this table MUST be 4-byte aligned */ + _bss_table_start = ABSOLUTE(.); + LONG(_bss_start) + LONG(_bss_end) + _bss_table_end = ABSOLUTE(.); + _rodata_end = ABSOLUTE(.); + } >dram0_0_seg :dram0_0_phdr + + .bss ALIGN(8) (NOLOAD) : ALIGN(4) + { + . = ALIGN (8); + _bss_start = ABSOLUTE(.); + *(.dynsbss) + *(.sbss) + *(.sbss.*) + *(.gnu.linkonce.sb.*) + *(.scommon) + *(.sbss2) + *(.sbss2.*) + *(.gnu.linkonce.sb2.*) + *(.dynbss) + *(.bss) + *(.bss.*) + *(.gnu.linkonce.b.*) + *(COMMON) + . = ALIGN (8); + _bss_end = ABSOLUTE(.); + _heap_start = ABSOLUTE(.); +/* _stack_sentry = ALIGN(0x8); */ + } >dram0_0_seg :dram0_0_bss_phdr +/* __stack = 0x3ffc8000; */ + + .irom0.text : ALIGN(4) + { + _irom0_text_start = ABSOLUTE(.); + *core_esp8266_*.o(.literal*, .text*) + *spiffs*.o(.literal*, .text*) + *.cpp.o(.literal*, .text*) + *libm.a:(.literal .text .literal.* .text.*) + *libsmartconfig.a:(.literal .text .literal.* .text.*) + *(.irom0.literal .irom.literal .irom.text.literal .irom0.text .irom.text) + _irom0_text_end = ABSOLUTE(.); + _flash_code_end = ABSOLUTE(.); + } >irom0_0_seg :irom0_0_phdr + + .text : ALIGN(4) + { + _stext = .; + _text_start = ABSOLUTE(.); + *(.entry.text) + *(.init.literal) + *(.init) + *(.literal .text .literal.* .text.* .stub .gnu.warning .gnu.linkonce.literal.* .gnu.linkonce.t.*.literal .gnu.linkonce.t.*) + *(.fini.literal) + *(.fini) + *(.gnu.version) + _text_end = ABSOLUTE(.); + _etext = .; + } >iram1_0_seg :iram1_0_phdr + + .lit4 : ALIGN(4) + { + _lit4_start = ABSOLUTE(.); + *(*.lit4) + *(.lit4.*) + *(.gnu.linkonce.lit4.*) + _lit4_end = ABSOLUTE(.); + } >iram1_0_seg :iram1_0_phdr + + +} + +/* get ROM code address */ +INCLUDE "../ld/eagle.rom.addr.v6.ld" diff --git a/tools/sdk/ld/eagle.flash.1m128.ld b/tools/sdk/ld/eagle.flash.1m128.ld new file mode 100644 index 000000000..ddd57a57b --- /dev/null +++ b/tools/sdk/ld/eagle.flash.1m128.ld @@ -0,0 +1,17 @@ +/* Flash Split for 1M chips */ +/* irom0 812KB */ +/* spiffs 128KB */ +/* eeprom 20KB */ + +MEMORY +{ + dport0_0_seg : org = 0x3FF00000, len = 0x10 + dram0_0_seg : org = 0x3FFE8000, len = 0x14000 + iram1_0_seg : org = 0x40100000, len = 0x8000 + irom0_0_seg : org = 0x40210000, len = 0xCB000 +} + +PROVIDE ( _SPIFFS_start = 0x402DB000 ); +PROVIDE ( _SPIFFS_end = 0x402FB000 ); + +INCLUDE "../ld/eagle.app.v6.common.ld" diff --git a/tools/sdk/ld/eagle.flash.1m256.ld b/tools/sdk/ld/eagle.flash.1m256.ld new file mode 100644 index 000000000..57b6a33fb --- /dev/null +++ b/tools/sdk/ld/eagle.flash.1m256.ld @@ -0,0 +1,17 @@ +/* Flash Split for 1M chips */ +/* irom0 684KB */ +/* spiffs 256KB */ +/* eeprom 20KB */ + +MEMORY +{ + dport0_0_seg : org = 0x3FF00000, len = 0x10 + dram0_0_seg : org = 0x3FFE8000, len = 0x14000 + iram1_0_seg : org = 0x40100000, len = 0x8000 + irom0_0_seg : org = 0x40210000, len = 0xAB000 +} + +PROVIDE ( _SPIFFS_start = 0x402BB000 ); +PROVIDE ( _SPIFFS_end = 0x402FB000 ); + +INCLUDE "../ld/eagle.app.v6.common.ld" diff --git a/tools/sdk/ld/eagle.flash.1m512.ld b/tools/sdk/ld/eagle.flash.1m512.ld new file mode 100644 index 000000000..1ffd7e678 --- /dev/null +++ b/tools/sdk/ld/eagle.flash.1m512.ld @@ -0,0 +1,17 @@ +/* Flash Split for 1M chips */ +/* irom0 428KB */ +/* spiffs 512KB */ +/* eeprom 20KB */ + +MEMORY +{ + dport0_0_seg : org = 0x3FF00000, len = 0x10 + dram0_0_seg : org = 0x3FFE8000, len = 0x14000 + iram1_0_seg : org = 0x40100000, len = 0x8000 + irom0_0_seg : org = 0x40210000, len = 0x6B000 +} + +PROVIDE ( _SPIFFS_start = 0x4027B000 ); +PROVIDE ( _SPIFFS_end = 0x402FB000 ); + +INCLUDE "../ld/eagle.app.v6.common.ld" diff --git a/tools/sdk/ld/eagle.flash.1m64.ld b/tools/sdk/ld/eagle.flash.1m64.ld new file mode 100644 index 000000000..ca3d64c67 --- /dev/null +++ b/tools/sdk/ld/eagle.flash.1m64.ld @@ -0,0 +1,17 @@ +/* Flash Split for 1M chips */ +/* irom0 876KB */ +/* spiffs 64KB */ +/* eeprom 20KB */ + +MEMORY +{ + dport0_0_seg : org = 0x3FF00000, len = 0x10 + dram0_0_seg : org = 0x3FFE8000, len = 0x14000 + iram1_0_seg : org = 0x40100000, len = 0x8000 + irom0_0_seg : org = 0x40210000, len = 0xDB000 +} + +PROVIDE ( _SPIFFS_start = 0x402EB000 ); +PROVIDE ( _SPIFFS_end = 0x402FB000 ); + +INCLUDE "../ld/eagle.app.v6.common.ld" diff --git a/tools/sdk/ld/eagle.flash.2m.ld b/tools/sdk/ld/eagle.flash.2m.ld new file mode 100644 index 000000000..cd6af2770 --- /dev/null +++ b/tools/sdk/ld/eagle.flash.2m.ld @@ -0,0 +1,17 @@ +/* Flash Split for 2M chips */ +/* irom0 960KB */ +/* spiffs 1004KB */ +/* eeprom 20KB */ + +MEMORY +{ + dport0_0_seg : org = 0x3FF00000, len = 0x10 + dram0_0_seg : org = 0x3FFE8000, len = 0x14000 + iram1_0_seg : org = 0x40100000, len = 0x8000 + irom0_0_seg : org = 0x40210000, len = 0xF0000 +} + +PROVIDE ( _SPIFFS_start = 0x40300000 ); +PROVIDE ( _SPIFFS_end = 0x403FB000 ); + +INCLUDE "../ld/eagle.app.v6.common.ld" diff --git a/tools/sdk/ld/eagle.flash.4m.ld b/tools/sdk/ld/eagle.flash.4m.ld new file mode 100644 index 000000000..7df2fa8ad --- /dev/null +++ b/tools/sdk/ld/eagle.flash.4m.ld @@ -0,0 +1,17 @@ +/* Flash Split for 4M chips */ +/* irom0 960KB */ +/* spiffs 3052KB */ +/* eeprom 20KB */ + +MEMORY +{ + dport0_0_seg : org = 0x3FF00000, len = 0x10 + dram0_0_seg : org = 0x3FFE8000, len = 0x14000 + iram1_0_seg : org = 0x40100000, len = 0x8000 + irom0_0_seg : org = 0x40210000, len = 0xF0000 +} + +PROVIDE ( _SPIFFS_start = 0x40300000 ); +PROVIDE ( _SPIFFS_end = 0x405FB000 ); + +INCLUDE "../ld/eagle.app.v6.common.ld" diff --git a/tools/sdk/ld/eagle.flash.512k.ld b/tools/sdk/ld/eagle.flash.512k.ld new file mode 100644 index 000000000..05160fe95 --- /dev/null +++ b/tools/sdk/ld/eagle.flash.512k.ld @@ -0,0 +1,17 @@ +/* Flash Split for 512K chips */ +/* irom0 364KB */ +/* spiffs 64KB */ +/* eeprom 20KB */ + +MEMORY +{ + dport0_0_seg : org = 0x3FF00000, len = 0x10 + dram0_0_seg : org = 0x3FFE8000, len = 0x14000 + iram1_0_seg : org = 0x40100000, len = 0x8000 + irom0_0_seg : org = 0x40210000, len = 0x5B000 +} + +PROVIDE ( _SPIFFS_start = 0x4026B000 ); +PROVIDE ( _SPIFFS_end = 0x4027B000 ); + +INCLUDE "../ld/eagle.app.v6.common.ld" diff --git a/tools/sdk/ld/eagle.rom.addr.v6.ld b/tools/sdk/ld/eagle.rom.addr.v6.ld new file mode 100644 index 000000000..076a240dd --- /dev/null +++ b/tools/sdk/ld/eagle.rom.addr.v6.ld @@ -0,0 +1,347 @@ +PROVIDE ( Cache_Read_Disable = 0x400047f0 ); +PROVIDE ( Cache_Read_Enable = 0x40004678 ); +PROVIDE ( FilePacketSendReqMsgProc = 0x400035a0 ); +PROVIDE ( FlashDwnLdParamCfgMsgProc = 0x4000368c ); +PROVIDE ( FlashDwnLdStartMsgProc = 0x40003538 ); +PROVIDE ( FlashDwnLdStopReqMsgProc = 0x40003658 ); +PROVIDE ( GetUartDevice = 0x40003f4c ); +PROVIDE ( MD5Final = 0x40009900 ); +PROVIDE ( MD5Init = 0x40009818 ); +PROVIDE ( MD5Update = 0x40009834 ); +PROVIDE ( MemDwnLdStartMsgProc = 0x400036c4 ); +PROVIDE ( MemDwnLdStopReqMsgProc = 0x4000377c ); +PROVIDE ( MemPacketSendReqMsgProc = 0x400036f0 ); +PROVIDE ( RcvMsg = 0x40003eac ); +PROVIDE ( SHA1Final = 0x4000b648 ); +PROVIDE ( SHA1Init = 0x4000b584 ); +PROVIDE ( SHA1Transform = 0x4000a364 ); +PROVIDE ( SHA1Update = 0x4000b5a8 ); +PROVIDE ( SPI_read_status = 0x400043c8 ); +PROVIDE ( SPI_write_status = 0x40004400 ); +PROVIDE ( SPI_write_enable = 0x4000443c ); +PROVIDE ( Wait_SPI_Idle = 0x4000448c ); +PROVIDE ( SPIEraseArea = 0x40004b44 ); +PROVIDE ( SPIEraseBlock = 0x400049b4 ); +PROVIDE ( SPIEraseChip = 0x40004984 ); +PROVIDE ( SPIEraseSector = 0x40004a00 ); +PROVIDE ( SPILock = 0x400048a8 ); +PROVIDE ( SPIParamCfg = 0x40004c2c ); +PROVIDE ( SPIRead = 0x40004b1c ); +PROVIDE ( SPIReadModeCnfig = 0x400048ec ); +PROVIDE ( SPIUnlock = 0x40004878 ); +PROVIDE ( SPIWrite = 0x40004a4c ); +PROVIDE ( SelectSpiFunction = 0x40003f58 ); +PROVIDE ( SendMsg = 0x40003cf4 ); +PROVIDE ( UartConnCheck = 0x40003230 ); +PROVIDE ( UartConnectProc = 0x400037a0 ); +PROVIDE ( UartDwnLdProc = 0x40003368 ); +PROVIDE ( UartGetCmdLn = 0x40003ef4 ); +PROVIDE ( UartRegReadProc = 0x4000381c ); +PROVIDE ( UartRegWriteProc = 0x400037ac ); +PROVIDE ( UartRxString = 0x40003c30 ); +PROVIDE ( Uart_Init = 0x40003a14 ); +PROVIDE ( _DebugExceptionVector = 0x40000010 ); +PROVIDE ( _DoubleExceptionVector = 0x40000070 ); +PROVIDE ( _KernelExceptionVector = 0x40000030 ); +PROVIDE ( _NMIExceptionVector = 0x40000020 ); +PROVIDE ( _ResetHandler = 0x400000a4 ); +PROVIDE ( _ResetVector = 0x40000080 ); +PROVIDE ( _UserExceptionVector = 0x40000050 ); +PROVIDE ( __adddf3 = 0x4000c538 ); +PROVIDE ( __addsf3 = 0x4000c180 ); +PROVIDE ( __divdf3 = 0x4000cb94 ); +PROVIDE ( __divdi3 = 0x4000ce60 ); +PROVIDE ( __divsi3 = 0x4000dc88 ); +PROVIDE ( __extendsfdf2 = 0x4000cdfc ); +PROVIDE ( __fixdfsi = 0x4000ccb8 ); +PROVIDE ( __fixunsdfsi = 0x4000cd00 ); +PROVIDE ( __fixunssfsi = 0x4000c4c4 ); +PROVIDE ( __floatsidf = 0x4000e2f0 ); +PROVIDE ( __floatsisf = 0x4000e2ac ); +PROVIDE ( __floatunsidf = 0x4000e2e8 ); +PROVIDE ( __floatunsisf = 0x4000e2a4 ); +PROVIDE ( __muldf3 = 0x4000c8f0 ); +PROVIDE ( __muldi3 = 0x40000650 ); +PROVIDE ( __mulsf3 = 0x4000c3dc ); +PROVIDE ( __subdf3 = 0x4000c688 ); +PROVIDE ( __subsf3 = 0x4000c268 ); +PROVIDE ( __truncdfsf2 = 0x4000cd5c ); +PROVIDE ( __udivdi3 = 0x4000d310 ); +PROVIDE ( __udivsi3 = 0x4000e21c ); +PROVIDE ( __umoddi3 = 0x4000d770 ); +PROVIDE ( __umodsi3 = 0x4000e268 ); +PROVIDE ( __umulsidi3 = 0x4000dcf0 ); +PROVIDE ( _rom_store = 0x4000e388 ); +PROVIDE ( _rom_store_table = 0x4000e328 ); +PROVIDE ( _start = 0x4000042c ); +PROVIDE ( _xtos_alloca_handler = 0x4000dbe0 ); +PROVIDE ( _xtos_c_wrapper_handler = 0x40000598 ); +PROVIDE ( _xtos_cause3_handler = 0x40000590 ); +PROVIDE ( _xtos_ints_off = 0x4000bda4 ); +PROVIDE ( _xtos_ints_on = 0x4000bd84 ); +PROVIDE ( _xtos_l1int_handler = 0x4000048c ); +PROVIDE ( _xtos_p_none = 0x4000dbf8 ); +PROVIDE ( _xtos_restore_intlevel = 0x4000056c ); +PROVIDE ( _xtos_return_from_exc = 0x4000dc54 ); +PROVIDE ( _xtos_set_exception_handler = 0x40000454 ); +PROVIDE ( _xtos_set_interrupt_handler = 0x4000bd70 ); +PROVIDE ( _xtos_set_interrupt_handler_arg = 0x4000bd28 ); +PROVIDE ( _xtos_set_intlevel = 0x4000dbfc ); +PROVIDE ( _xtos_set_min_intlevel = 0x4000dc18 ); +PROVIDE ( _xtos_set_vpri = 0x40000574 ); +PROVIDE ( _xtos_syscall_handler = 0x4000dbe4 ); +PROVIDE ( _xtos_unhandled_exception = 0x4000dc44 ); +PROVIDE ( _xtos_unhandled_interrupt = 0x4000dc3c ); +PROVIDE ( aes_decrypt = 0x400092d4 ); +PROVIDE ( aes_decrypt_deinit = 0x400092e4 ); +PROVIDE ( aes_decrypt_init = 0x40008ea4 ); +PROVIDE ( aes_unwrap = 0x40009410 ); +PROVIDE ( base64_decode = 0x40009648 ); +PROVIDE ( base64_encode = 0x400094fc ); +PROVIDE ( bzero = 0x4000de84 ); +PROVIDE ( cmd_parse = 0x40000814 ); +PROVIDE ( conv_str_decimal = 0x40000b24 ); +PROVIDE ( conv_str_hex = 0x40000cb8 ); +PROVIDE ( convert_para_str = 0x40000a60 ); +PROVIDE ( dtm_get_intr_mask = 0x400026d0 ); +PROVIDE ( dtm_params_init = 0x4000269c ); +PROVIDE ( dtm_set_intr_mask = 0x400026c8 ); +PROVIDE ( dtm_set_params = 0x400026dc ); +PROVIDE ( eprintf = 0x40001d14 ); +PROVIDE ( eprintf_init_buf = 0x40001cb8 ); +PROVIDE ( eprintf_to_host = 0x40001d48 ); +PROVIDE ( est_get_printf_buf_remain_len = 0x40002494 ); +PROVIDE ( est_reset_printf_buf_len = 0x4000249c ); +PROVIDE ( ets_bzero = 0x40002ae8 ); +PROVIDE ( ets_char2xdigit = 0x40002b74 ); +PROVIDE ( ets_delay_us = 0x40002ecc ); +PROVIDE ( ets_enter_sleep = 0x400027b8 ); +PROVIDE ( ets_external_printf = 0x40002578 ); +PROVIDE ( ets_get_cpu_frequency = 0x40002f0c ); +PROVIDE ( ets_getc = 0x40002bcc ); +PROVIDE ( ets_install_external_printf = 0x40002450 ); +PROVIDE ( ets_install_putc1 = 0x4000242c ); +PROVIDE ( ets_install_putc2 = 0x4000248c ); +PROVIDE ( ets_install_uart_printf = 0x40002438 ); +PROVIDE ( ets_intr_lock = 0x40000f74 ); +PROVIDE ( ets_intr_unlock = 0x40000f80 ); +PROVIDE ( ets_isr_attach = 0x40000f88 ); +PROVIDE ( ets_isr_mask = 0x40000f98 ); +PROVIDE ( ets_isr_unmask = 0x40000fa8 ); +PROVIDE ( ets_memcmp = 0x400018d4 ); +PROVIDE ( ets_memcpy = 0x400018b4 ); +PROVIDE ( ets_memmove = 0x400018c4 ); +PROVIDE ( ets_memset = 0x400018a4 ); +PROVIDE ( ets_post = 0x40000e24 ); +PROVIDE ( ets_printf = 0x400024cc ); +PROVIDE ( ets_putc = 0x40002be8 ); +PROVIDE ( ets_rtc_int_register = 0x40002a40 ); +PROVIDE ( ets_run = 0x40000e04 ); +PROVIDE ( ets_set_idle_cb = 0x40000dc0 ); +PROVIDE ( ets_set_user_start = 0x40000fbc ); +PROVIDE ( ets_str2macaddr = 0x40002af8 ); +PROVIDE ( ets_strcmp = 0x40002aa8 ); +PROVIDE ( ets_strcpy = 0x40002a88 ); +PROVIDE ( ets_strlen = 0x40002ac8 ); +PROVIDE ( ets_strncmp = 0x40002ab8 ); +PROVIDE ( ets_strncpy = 0x40002a98 ); +PROVIDE ( ets_strstr = 0x40002ad8 ); +PROVIDE ( ets_task = 0x40000dd0 ); +PROVIDE ( ets_timer_arm = 0x40002cc4 ); +PROVIDE ( ets_timer_disarm = 0x40002d40 ); +PROVIDE ( ets_timer_done = 0x40002d80 ); +PROVIDE ( ets_timer_handler_isr = 0x40002da8 ); +PROVIDE ( ets_timer_init = 0x40002e68 ); +PROVIDE ( ets_timer_setfn = 0x40002c48 ); +PROVIDE ( ets_uart_printf = 0x40002544 ); +PROVIDE ( ets_update_cpu_frequency = 0x40002f04 ); +PROVIDE ( ets_vprintf = 0x40001f00 ); +PROVIDE ( ets_wdt_disable = 0x400030f0 ); +PROVIDE ( ets_wdt_enable = 0x40002fa0 ); +PROVIDE ( ets_wdt_get_mode = 0x40002f34 ); +PROVIDE ( ets_wdt_init = 0x40003170 ); +PROVIDE ( ets_wdt_restore = 0x40003158 ); +PROVIDE ( ets_write_char = 0x40001da0 ); +PROVIDE ( get_first_seg = 0x4000091c ); +PROVIDE ( gpio_init = 0x40004c50 ); +PROVIDE ( gpio_input_get = 0x40004cf0 ); +PROVIDE ( gpio_intr_ack = 0x40004dcc ); +PROVIDE ( gpio_intr_handler_register = 0x40004e28 ); +PROVIDE ( gpio_intr_pending = 0x40004d88 ); +PROVIDE ( gpio_intr_test = 0x40004efc ); +PROVIDE ( gpio_output_set = 0x40004cd0 ); +PROVIDE ( gpio_pin_intr_state_set = 0x40004d90 ); +PROVIDE ( gpio_pin_wakeup_disable = 0x40004ed4 ); +PROVIDE ( gpio_pin_wakeup_enable = 0x40004e90 ); +PROVIDE ( gpio_register_get = 0x40004d5c ); +PROVIDE ( gpio_register_set = 0x40004d04 ); +PROVIDE ( hmac_md5 = 0x4000a2cc ); +PROVIDE ( hmac_md5_vector = 0x4000a160 ); +PROVIDE ( hmac_sha1 = 0x4000ba28 ); +PROVIDE ( hmac_sha1_vector = 0x4000b8b4 ); +PROVIDE ( lldesc_build_chain = 0x40004f40 ); +PROVIDE ( lldesc_num2link = 0x40005050 ); +PROVIDE ( lldesc_set_owner = 0x4000507c ); +PROVIDE ( main = 0x40000fec ); +PROVIDE ( md5_vector = 0x400097ac ); +PROVIDE ( mem_calloc = 0x40001c2c ); +PROVIDE ( mem_free = 0x400019e0 ); +PROVIDE ( mem_init = 0x40001998 ); +PROVIDE ( mem_malloc = 0x40001b40 ); +PROVIDE ( mem_realloc = 0x40001c6c ); +PROVIDE ( mem_trim = 0x40001a14 ); +PROVIDE ( mem_zalloc = 0x40001c58 ); +PROVIDE ( memcmp = 0x4000dea8 ); +PROVIDE ( memcpy = 0x4000df48 ); +PROVIDE ( memmove = 0x4000e04c ); +PROVIDE ( memset = 0x4000e190 ); +PROVIDE ( multofup = 0x400031c0 ); +PROVIDE ( pbkdf2_sha1 = 0x4000b840 ); +PROVIDE ( phy_get_romfuncs = 0x40006b08 ); +PROVIDE ( rand = 0x40000600 ); +PROVIDE ( rc4_skip = 0x4000dd68 ); +PROVIDE ( recv_packet = 0x40003d08 ); +PROVIDE ( remove_head_space = 0x40000a04 ); +PROVIDE ( rijndaelKeySetupDec = 0x40008dd0 ); +PROVIDE ( rijndaelKeySetupEnc = 0x40009300 ); +PROVIDE ( rom_abs_temp = 0x400060c0 ); +PROVIDE ( rom_ana_inf_gating_en = 0x40006b10 ); +PROVIDE ( rom_cal_tos_v50 = 0x40007a28 ); +PROVIDE ( rom_chip_50_set_channel = 0x40006f84 ); +PROVIDE ( rom_chip_v5_disable_cca = 0x400060d0 ); +PROVIDE ( rom_chip_v5_enable_cca = 0x400060ec ); +PROVIDE ( rom_chip_v5_rx_init = 0x4000711c ); +PROVIDE ( rom_chip_v5_sense_backoff = 0x4000610c ); +PROVIDE ( rom_chip_v5_tx_init = 0x4000718c ); +PROVIDE ( rom_dc_iq_est = 0x4000615c ); +PROVIDE ( rom_en_pwdet = 0x400061b8 ); +PROVIDE ( rom_get_bb_atten = 0x40006238 ); +PROVIDE ( rom_get_corr_power = 0x40006260 ); +PROVIDE ( rom_get_fm_sar_dout = 0x400062dc ); +PROVIDE ( rom_get_noisefloor = 0x40006394 ); +PROVIDE ( rom_get_power_db = 0x400063b0 ); +PROVIDE ( rom_i2c_readReg = 0x40007268 ); +PROVIDE ( rom_i2c_readReg_Mask = 0x4000729c ); +PROVIDE ( rom_i2c_writeReg = 0x400072d8 ); +PROVIDE ( rom_i2c_writeReg_Mask = 0x4000730c ); +PROVIDE ( rom_iq_est_disable = 0x40006400 ); +PROVIDE ( rom_iq_est_enable = 0x40006430 ); +PROVIDE ( rom_linear_to_db = 0x40006484 ); +PROVIDE ( rom_mhz2ieee = 0x400065a4 ); +PROVIDE ( rom_pbus_dco___SA2 = 0x40007bf0 ); +PROVIDE ( rom_pbus_debugmode = 0x4000737c ); +PROVIDE ( rom_pbus_enter_debugmode = 0x40007410 ); +PROVIDE ( rom_pbus_exit_debugmode = 0x40007448 ); +PROVIDE ( rom_pbus_force_test = 0x4000747c ); +PROVIDE ( rom_pbus_rd = 0x400074d8 ); +PROVIDE ( rom_pbus_set_rxgain = 0x4000754c ); +PROVIDE ( rom_pbus_set_txgain = 0x40007610 ); +PROVIDE ( rom_pbus_workmode = 0x40007648 ); +PROVIDE ( rom_pbus_xpd_rx_off = 0x40007688 ); +PROVIDE ( rom_pbus_xpd_rx_on = 0x400076cc ); +PROVIDE ( rom_pbus_xpd_tx_off = 0x400076fc ); +PROVIDE ( rom_pbus_xpd_tx_on = 0x40007740 ); +PROVIDE ( rom_pbus_xpd_tx_on__low_gain = 0x400077a0 ); +PROVIDE ( rom_phy_reset_req = 0x40007804 ); +PROVIDE ( rom_restart_cal = 0x4000781c ); +PROVIDE ( rom_rfcal_pwrctrl = 0x40007eb4 ); +PROVIDE ( rom_rfcal_rxiq = 0x4000804c ); +PROVIDE ( rom_rfcal_rxiq_set_reg = 0x40008264 ); +PROVIDE ( rom_rfcal_txcap = 0x40008388 ); +PROVIDE ( rom_rfcal_txiq = 0x40008610 ); +PROVIDE ( rom_rfcal_txiq_cover = 0x400088b8 ); +PROVIDE ( rom_rfcal_txiq_set_reg = 0x40008a70 ); +PROVIDE ( rom_rfpll_reset = 0x40007868 ); +PROVIDE ( rom_rfpll_set_freq = 0x40007968 ); +PROVIDE ( rom_rxiq_cover_mg_mp = 0x40008b6c ); +PROVIDE ( rom_rxiq_get_mis = 0x40006628 ); +PROVIDE ( rom_sar_init = 0x40006738 ); +PROVIDE ( rom_set_ana_inf_tx_scale = 0x4000678c ); +PROVIDE ( rom_set_channel_freq = 0x40006c50 ); +PROVIDE ( rom_set_loopback_gain = 0x400067c8 ); +PROVIDE ( rom_set_noise_floor = 0x40006830 ); +PROVIDE ( rom_set_rxclk_en = 0x40006550 ); +PROVIDE ( rom_set_txbb_atten = 0x40008c6c ); +PROVIDE ( rom_set_txclk_en = 0x4000650c ); +PROVIDE ( rom_set_txiq_cal = 0x40008d34 ); +PROVIDE ( rom_start_noisefloor = 0x40006874 ); +PROVIDE ( rom_start_tx_tone = 0x400068b4 ); +PROVIDE ( rom_stop_tx_tone = 0x4000698c ); +PROVIDE ( rom_tx_mac_disable = 0x40006a98 ); +PROVIDE ( rom_tx_mac_enable = 0x40006ad4 ); +PROVIDE ( rom_txtone_linear_pwr = 0x40006a1c ); +PROVIDE ( rom_write_rfpll_sdm = 0x400078dc ); +PROVIDE ( roundup2 = 0x400031b4 ); +PROVIDE ( rtc_enter_sleep = 0x40002870 ); +PROVIDE ( rtc_get_reset_reason = 0x400025e0 ); +PROVIDE ( rtc_intr_handler = 0x400029ec ); +PROVIDE ( rtc_set_sleep_mode = 0x40002668 ); +PROVIDE ( save_rxbcn_mactime = 0x400027a4 ); +PROVIDE ( save_tsf_us = 0x400027ac ); +PROVIDE ( send_packet = 0x40003c80 ); +PROVIDE ( sha1_prf = 0x4000ba48 ); +PROVIDE ( sha1_vector = 0x4000a2ec ); +PROVIDE ( sip_alloc_to_host_evt = 0x40005180 ); +PROVIDE ( sip_get_ptr = 0x400058a8 ); +PROVIDE ( sip_get_state = 0x40005668 ); +PROVIDE ( sip_init_attach = 0x4000567c ); +PROVIDE ( sip_install_rx_ctrl_cb = 0x4000544c ); +PROVIDE ( sip_install_rx_data_cb = 0x4000545c ); +PROVIDE ( sip_post = 0x400050fc ); +PROVIDE ( sip_post_init = 0x400056c4 ); +PROVIDE ( sip_reclaim_from_host_cmd = 0x4000534c ); +PROVIDE ( sip_reclaim_tx_data_pkt = 0x400052c0 ); +PROVIDE ( sip_send = 0x40005808 ); +PROVIDE ( sip_to_host_chain_append = 0x40005864 ); +PROVIDE ( sip_to_host_evt_send_done = 0x40005234 ); +PROVIDE ( slc_add_credits = 0x400060ac ); +PROVIDE ( slc_enable = 0x40005d90 ); +PROVIDE ( slc_from_host_chain_fetch = 0x40005f24 ); +PROVIDE ( slc_from_host_chain_recycle = 0x40005e94 ); +PROVIDE ( slc_init_attach = 0x40005c50 ); +PROVIDE ( slc_init_credit = 0x4000608c ); +PROVIDE ( slc_pause_from_host = 0x40006014 ); +PROVIDE ( slc_reattach = 0x40005c1c ); +PROVIDE ( slc_resume_from_host = 0x4000603c ); +PROVIDE ( slc_select_tohost_gpio = 0x40005dc0 ); +PROVIDE ( slc_select_tohost_gpio_mode = 0x40005db8 ); +PROVIDE ( slc_send_to_host_chain = 0x40005de4 ); +PROVIDE ( slc_set_host_io_max_window = 0x40006068 ); +PROVIDE ( slc_to_host_chain_recycle = 0x40005f10 ); +PROVIDE ( software_reset = 0x4000264c ); +PROVIDE ( spi_flash_attach = 0x40004644 ); +PROVIDE ( srand = 0x400005f0 ); +PROVIDE ( strcmp = 0x4000bdc8 ); +PROVIDE ( strcpy = 0x4000bec8 ); +PROVIDE ( strlen = 0x4000bf4c ); +PROVIDE ( strncmp = 0x4000bfa8 ); +PROVIDE ( strncpy = 0x4000c0a0 ); +PROVIDE ( strstr = 0x4000e1e0 ); +PROVIDE ( timer_insert = 0x40002c64 ); +PROVIDE ( uartAttach = 0x4000383c ); +PROVIDE ( uart_baudrate_detect = 0x40003924 ); +PROVIDE ( uart_buff_switch = 0x400038a4 ); +PROVIDE ( uart_div_modify = 0x400039d8 ); +PROVIDE ( uart_rx_intr_handler = 0x40003bbc ); +PROVIDE ( uart_rx_one_char = 0x40003b8c ); +PROVIDE ( uart_rx_one_char_block = 0x40003b64 ); +PROVIDE ( uart_rx_readbuff = 0x40003ec8 ); +PROVIDE ( uart_tx_one_char = 0x40003b30 ); +PROVIDE ( wepkey_128 = 0x4000bc40 ); +PROVIDE ( wepkey_64 = 0x4000bb3c ); +PROVIDE ( xthal_bcopy = 0x40000688 ); +PROVIDE ( xthal_copy123 = 0x4000074c ); +PROVIDE ( xthal_get_ccompare = 0x4000dd4c ); +PROVIDE ( xthal_get_ccount = 0x4000dd38 ); +PROVIDE ( xthal_get_interrupt = 0x4000dd58 ); +PROVIDE ( xthal_get_intread = 0x4000dd58 ); +PROVIDE ( xthal_memcpy = 0x400006c4 ); +PROVIDE ( xthal_set_ccompare = 0x4000dd40 ); +PROVIDE ( xthal_set_intclear = 0x4000dd60 ); +PROVIDE ( xthal_spill_registers_into_stack_nw = 0x4000e320 ); +PROVIDE ( xthal_window_spill = 0x4000e324 ); +PROVIDE ( xthal_window_spill_nw = 0x4000e320 ); + +PROVIDE ( Te0 = 0x3fffccf0 ); +PROVIDE ( UartDev = 0x3fffde10 ); +PROVIDE ( flashchip = 0x3fffc714); diff --git a/tools/sdk/lib/libhal.a b/tools/sdk/lib/libhal.a new file mode 100644 index 0000000000000000000000000000000000000000..b7a43bdfffc7cb133eca0b5aeaf9b2ec421d613a GIT binary patch literal 349408 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�X-dHH1SThn_%3VS{ZpGGYGu|jSHnGpQO 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 QslLa;yDYrd!V?z$8&E_!@&Et; literal 0 HcmV?d00001 diff --git a/tools/sdk/lib/libjson.a b/tools/sdk/lib/libjson.a new file mode 100755 index 0000000000000000000000000000000000000000..cc7c69abda3c8f260da0cb8cdcfff842bd2440a2 GIT binary patch literal 12714 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 literal 0 HcmV?d00001 diff --git a/tools/sdk/lib/liblwip.a b/tools/sdk/lib/liblwip.a new file mode 100644 index 0000000000000000000000000000000000000000..d3c356dcea2ced111f77ce3ae5263792c3cd2754 GIT binary patch literal 299544 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 PKeFYVs`$U_Yvca{XuzZ# literal 0 HcmV?d00001 diff --git a/tools/sdk/lib/libmain.a b/tools/sdk/lib/libmain.a new file mode 100644 index 0000000000000000000000000000000000000000..265466dc110b467c732a066884fc2013f49074ef GIT binary patch literal 109456 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%0A6zK@D0Ux zXEVq4HBK!#Hb2%B;7rQ#E~7HGn^Dn`S^HMhPHY}nyKc#DPsNE01?;Pg<<83D&{5|@Bz-TIW-R@%(0QPfQDQmz0E%!71DiVc%>|Fb!hKoor=yKJ9>cH4 z`cN#ic?b&~ZOGlQv|&-zbn0Zb>{4foD<2uiFJYmh%^@saEDYZ;V^tl7e<7HTHe?kJ z9~bDTlhuRr7)>YhR?cJHpy}kViN0Rb$*H1m0<(I}eV@>5c-x_4JjpyR^>UWhQ`%i9fI?0yqt{xV_F1+n}+JNeJ&eLm;@$|*b6t9T*Rv);MKRd(k- zpVLmAV1}vU$LA@<)S2S$vcCBFd;o0ttfibf?j#5aN`$`0Rje9S^jITi?f*6N1^m)+UU z^ralPGhM2JllvEAy&em%3)jB^Upd-Ws}=ZM=kowh77I$+-@$cp-2P*=0-x&-VqxKP zDSX;%Ps=q6Yh#b)v+EbmoIiX1*r0jQ_`0U_Osfdq8+U z{B6QaYZ=&18-DX9Pq-OAzY#?J5Ntx4{&kHjg^$2yoiJ}QzZHH9KAp)-1jqI*hDk?G z7X2D9^*Qiw7k&snZ<;1A7~EY13&e6*oPR?o!$Av)8?E@9qCpC>bu z)5m^X7=KJI=rC`9N3l(f4d$3;+E62_vBA!>IM#V1Jw|)U00Xg3dun9WCz#<<=Z*9@ z?d3l@Z55)C)qgxm8=f$@DbTquHM07T^F`;4_Y}6NFzZC8Mpj`u&#w~Z60xC1R$<;F z`g-`!2=nIrN3xu^!=m$AA0?+F5OM1H+kJ7Hw`$z3afikSG-f_g;T+f4xfVEgbWU4>Ft4++_iCK0 zvD20y_M)k{;}tVaHV`Ub3hz!Ni;ci!+iJ4{-OIddCls*_bkB z!n$4$SAFY`oI%EmNH~YY1Vv9Cw-dKu#vHU7+@JRFiaL+cao4>8%Y{=_XX1Jwpm86b*-)S4~_V(il$MYaL*s&KZ;_GS10sm@P|74 z2iV;l?edM`9X^wz8!w^Lq2^Mq?sq9Ew9>r zLy^sShWQ?~<(Rr_XdXVcmK$fg%f_t1v^G%XO@3#%ymz~?u*haNb>>m#P3FV%IZTys zmh86N$y)dJv$magT|Fu+D_eaIVLafTayf1s1-RCojUnxRGzcLdS5( z+?P7zO-Eh*2Zp}_>la~Z#zH$bN7DZ}7Cyj`w_)J}CHZ$)R2=vsf{tO5l|5fd&{03) zQ0)Jbd7p2_^1kS_IVH^akd+Nzq|njE7N!l^g2r(8kr+DKq-r)~Ws|PisO!dXvZ3<< zfZ?zLM8|N*JSS~f_@PHS>U5b{c&)u$f%_+XzxSW@+Mbt?|K^|7CQzV-4eUH+ESGuu z)YIOT+^9J@!_Kpp9={-L)aj?Wn?G>8WQw^y5_# ztq^(MSgbHSGPAuN9wwtU@>L+%rXkkO@4oomzJBI;yt6}fofT7V*UtpkRR)e7|MTzm z*&1@jVJ6|uBQU?DAq2h7!2f*-7M{<6SorK-2wypFpN2&h@!VdA^%Bvz{yp#!EW93E zZ-cLjKd%20>#C^ZI*VRata1GvtSiUky@!QG+9degu8Kz5a66wTmE*eBK!6X1*3GP# zRlZPvr+>b0t>U|(_*iOreSP_?YNMtmJbTXEh4r)RrZilI?}}EG&$>wql;tQ3^&`MO73B-(&N}xitBBxv^~LzcEc-6hl-HHdU#K0N z8y3~zi?Fk0(>a|U=Fj8TX>VSzVD_x~nH38cp8q4X3+u~gE||S|Cj9!@JY_v`4%N6> z=b5NG)z~dn_2(|ex?*lq{Th%Ro%iQVnY_L5T{<1p37PxdBfJd$A>m!{nV)FGV-^WB zE>0T=^cpZzxXFXS4ZuQsYUE_muN8d}d{!rDL%va%RfhSR&NNG#3i!7QbH7$$rpY$p zpTp-ud&c=U!mJwX6{am;7SLuJ{I`Txz>jL2iT|U<`Ud6yQX{KzvlB$;?b?gQ?1=#2 zrif0BoGf}j&E`h2p+;6V++V#zcFrf_Nyq%6bOxuG+thP0%L1kAHvKf+ud&lsAmJBj z`V@`JG@hq%gT_oN>bSfvik-Fs34f!eZ`HV6;|`4vXnaKD;~G0{1rol8=T_Ls7sAeU z5zf_YoVEhdM{9bC#!g#-*i>tJy~d3iw`lCN70A91X!>T2pVWAl#``rsr13Gb+~`he zJS1@GaIGoA`$cULf&5FQ!@w7}MU3o&6OLo@KEl@1ZqD7pS#f^&M4pEJ0zPA6LPd`| zF(>*D`hoyqjpOTMWTTX)!|430*nnD$a+7TlR16g z^ur@gghKb_zZbRLn2Yx$1J61h&3_l`rt?PLW7_d`8`{6Mq+(u8-Mrde@`^iltjW=+ z(`ex9pA(4N80tSL+&>p}w9ZC_Z7}0fBR==yy5l~3_iOXqYULmEkKlIB|B1c@);zoXfJz_09#+GnCG3J=do-`%5mPFlsdiO(KOx0Cm6Fn*S>I_bW> zFQ)FjZ_Vnfi?=@+HJ{}^NA06sdMrr54E4`&mHjT*KY^#0y%YHV(JXcQB%>vCyJajl zVPU(*3^;TCVd6NBTjm&II%gjwqxn{L>g122ZyZi79aD6u^gj#shM)PQWZ2TNXuLU| z7hm{Zbn<)AI%A@}q7gHe1}CcIppPf9`-LMPmVX*c1cCU8o(#-O8yGt=IMj>ZHx8vY zSogeiRwCJhmK1dOk|0Jb(m|HM>>W6 zBslEvxw0$kK)%YCP40}1ANV4lF8@RHo(tdr4L{?B?ZYC0WxI`f^{*YT0h&JFXd?dPm8Z+#h;^#(5c zp%G?c+QIxc3wLL|awNL_NOa%ev|YuqJT~vWEOf;28kX-qOm$DFxX*l*F^~P?^j1VZ z4tJSoyT|t_!_=qOOvF^W*lc?mo@`!_R&`yE!rw)0Uy<8(h4#mX`t>#c;G8YXN$1E| z`?;F&Be!pGdV$%VV!W_R=F9a=w2X}dQZdDOUV(XR>4X>aQcPq{RIZ9Uw&tbe|AyIe z7lpi(K%~;S#!eP9pQcz9$c#;&8~d%@8m&uMxj3B}@i*MQ;>ng>=C4UDA@f)CdAW}k z@`5`VbG>oK*_BR9Y1SvvMAJM?W3(gNsaB}%?8}uOWp|{j+EjZh)_qsquhwGWIcZ^c z+QF6eUft`aeWo^b>+(lwJ5S_NFx@H+Qo7)#h ztbyIumnf^A70*uju4&ZN$GUH=w(sq=Zgug!yC!=IRdFZL!p)fpx)CX5pY3XnEUW!E z8jeKEKV&)dWpd;KpTUwt7PRqCy=#rL$nte3tRdDfEo zht-E#`rPx{pL+QNV~gWYNft)idhKV?CBL^{>$NO6thHun#Md{gG5G)3dmr#Bs&jpG zX0ns)kO}MrjHr?By+KGM!DNFPT4<9^2tk5|2oXJ4vhxq90YZoZEp0$wdPw*mDsDdI&{ODZkDurALBP_BkhtkcsMuZ4C;y%Klyu?B~}izA54tv ztH18|_>7VZ?yE`8f7Y$H?$G-9pPZ+w&~cI@k)j9GUB!2QnV42^BXR!IaSA_m@|!|u zo!6^A4b|6OxmfstGX;|bO-B#qz3-qA%FPXoZt@x+ z^h-t}QSs;lB$!57S@6at)d(6@mTAYYOTQ@+iL)-5);gF|9%W@sH~i==&Ul=Q?;oMS zKRWpZ=U9e$+d5>-GvFm+#Jh!~BiZi`k?`N$E49AQ{c-QM*%jFNXMr>;ZIsry=UH^-cLh0{) z8tQcN3o$wJOu&0H_(K&N&PFrLNc+hPPaF(A>)8I50=uOkxuu{_qqV)IAgQ5YRL7m} zKH<^r*wDKG=M$$Ny=%&jE7w2eY`P}LUi)T7GImXqW;-v5n=}2jjKqd%!5d#g z7J9b4-t)X;|6x(vFYM;xzo_TR5a&KSTuZw16X)Q^PB^=AU7Fvr>MJ_~hw5YA8*$G^ z&Sx7wTrbxiJmc(3J(N?4P0Z(xwI}7+HQpN)`-P{W7j-11;@h8kkNf#er%J--`e{42 zTCu>PSlX^w>hW0r{c&$w$9!X=-qhElU$txAw$Nof>6Qp9+E_eNb^YVR*XH7Zw&TmM z%`Ittbj0vcQJ?88Z>_S8s%tMlbnWoWPCI2?IAWQT&EX@xuE`P8pNEc`ZDbx@7r~k6 z&LB=5rSg(x{>Kg+4(@0k8obK3y{^f=zOe%ib{{WK|Cg3wu}h}C;XghrR$lQh<{@6O zE0lUDly*GS-wFlNc9x-Sdwb}m7Y@z2sBY}jc0tmwSG>*oF=0+$JFw>y#}2Oe*s*hq z@e(sstH<}9{?6-NK>z4mZ`uDzIBjQp*1OSIsufE+9=qUBY{0Hq|5LH_{c-OeagMZf zM~~zj?`v579&CQc?CQ?z?C{?nHq3}&rI)9r4^Bhp;6;{0)HdFDWkQ;7>8U;AjP7^4 z2bEuu+C3<}Hqp8wE!{|bbVSz9XJ2wEsuIHe@N=xv+~rjDyFc71S5ud z^_m>?A8_#l6gqk;n&P*|mlXx0ll``}E7bo`Xu$E%1*bykRwylPXC*$Wey6Lescyvf z6@PP>foO;}#?#aKm9*xVUMbv7O^aL0Ll#$M#JXxE_JU3{38eOUByfZ48XHkB0(C zL{49GA;a(+=@+LNIq`>T2Qdb79+`0HLc7`?VAiVu6@G&O|BTiH+d>x}H>~56F56(l zZJ2~aUFhb`ta1guWc2Z+cl`x*z#f+y4u-FroUp}-hAvFs_-2mJyooY<9(Kx69i~;( z9uF0I_kSAsifzX~d!xtiaP};B>e4$^%_((7t*+0CKKn~2;hTDUxUf1luV((dTGeHr zIPbPt{hXTM4dcs#x702PUbe80Q8f!^|2uQsRQkVD-2cZ-aT{<0an$4BuuB_`N*w%_ zW&r$p_~dD)Yz+Jz7?+~FA7l;um3X#o__WR%2Y$Pse;Qo%E;RU^+RENXN9* z<6xOkrU5>O1u63b9CVaX_lq(o5#}|N;W#R8ft%l$#7B8z+ya;9_jxk~a~~9@V*`$t zf%^%58<>vQo)qlH1snj!xYRTpWr#WLKs|kd>By`4#A}Cu9}KPq#{^A=I1FwB4z)ig zuT^!B*K*8i6u1@~8-dk5eH56E@~W;-#B67I?cJKpy_yU$>m+5?YdkUMQOQ37%q~;U*V$CTD_D8pD6gJz>ZBdF5IE}m zxhA8Yf6D9t&oZIR9!*BI4V38wPu-MZTS3RLYBwm;1wIEHWl~USDYgMe8nC(-m$EX$ z@mkf^@LJk;O9#hmzYJ`_=e2By=qRt+B+8e8zYrYdX927GwNR5MR`GrZ7?-&^AJSxq znP$fI0^m2f*Z;-^V%uEDlYC5qMpZFc+=sihgg+KgNAPf z=6UM*wkF>U%xb`Rmjg3xjQ9J%7s01I_Zp$&^=htw^2AI7<$s~csP>yO9D5%kGToXC zG3UFf|07`ayu>jQIC`r6ryf5DRe#bn8TD?U%s}vrg6ZM@Cv^0J_(z{IwC|?csC-}x zJk#)H3c%4DgMX?Wo(lYBaMa2D^yugjtNQS-8oy33<04k+c@Q`S*DIs7H53U6V_W~rQo?=a&Se4r(V0ACpSD>R#)o-BArQlg6)cH$IhWKi5)PGXri8%yF zJ{g6h;tBvO`3WpEIL1ZHW$BdXUL$nmiK&)+jm8rzopUsvSn=~To>=hfpY}k2&~$!`M`A4L(Duf zUhdaHN1pg6@TvbIHY{-DiP_I2KMh#b;U$_3v1(85)_CGvx%O8YPdpqv)9`1FN6@Xe z?2oaXp!;tw?Q5*9kBw-mUEE}ha5o|z!Br(ATy{?5{JFVuj#yyhd>7;n0x^$#_mhK^s)U`>0^If*H?)O zGK3e1Q}u<<1?Bkrf^IoZsJIv==J{L1hv&MLkSkRI_>`e*!ohSXcNlV9zo49gD?ljB zbIVb{N0g9uZW-`->6z%+VB!71W8IVA)!H?H#tby9Mbefttm66su&%G<8c&Y;_-OGQ z?=PQEbXM_wRh{lZVx=J6*n(qr;-_oHNIMEWK^g-bss#(K`hxvhmBK0nsau1936e9pzWEukJ}Nu6_XZjSYEzn*g62s#x{Da&L# z4#vzd`>gzp$ueY^eR=hJG7U9}&zW*8M?NPfah%1$^JVar~DdxdZ473Obd<#_#fdxcl`3P02<%#YF4Zz$&fH@(jP4q^5CiRWKOSp8OFm}`)_ zP_4!yZia2#c>dPmJ!g2Z_AoJh`Mttr2(#}W7Wo>4Rezh;--@v6TQht+!t6)$`DXav z5N1EQSi)NoR*vy;zi#Ci-iI*z#_ap?`j-%9ANQBY2gC35lK-ezI7NHtsV~$koZTy2 z)GK^#ukiF<;o4r|1--&8y~1t1!tDsNZ}m3P&HQZZb^h1A!kxXsf9w^0yH}XM=apmr zFYXo2>J=W_D_qhmY|OeI1G(2XHQrj?WW;W5n(Z3)GB~nGKC|<~7yLY{0kCq7WZm zFO)`<#@c!CB?;$js*#B> z=v}*TeqB?nVP;J&?+J^eZhm8Rtyd_w&O4WLtcm8z}E|ltl+}G4D z9EWUr1dD@4fyc;7C^W01?pB{sJ z)WISz5`!~6Wi+=zTP2RQ;kb{D3+H`?ThtJ9FG1(L9#t1X){MG2vu1kNfS)sOmMc>A z&DzHK#%*O->0Zol>l<8n6BfkJuU0zdRX3n!K#6xX(Ht)is9KF)b!Lv-kbaXr`KsC& zVn3%0nW#oxZLG#q7;CJa?S@bnW_ppzIdAwb!D(RdKB$MrRS<(;97pd9GD(H{#&Fp6VO=KfI+)iPR1uEQ3EP3og z|3qPqeJYtE;#{vB3N)VMvPwRv@kfv@buGt<73R3I!W@TI*j>0IWx_FR#b=^islOTL zh7gCmGz5ibC_}>oiA7I9<86)Sds^ME-FSy9`3?c6Aqu;8?x2@$AbG+3))=emtef8!Tm%2dg82jd7lNthMZv7s?6*=6>-&d-`5bT#iaei> zrGoj~d{;1^rymL)0RLx#`OF;<%xCe>g1OhdyT?6r@_8MG=bHNY99IbD^ZkHeKKBm^ zW_!TjR&IXb^LG_7+mDli*{<|Kn?s)MO_pG`L!2Wb&-Upi!3FRe1UJK9DVS~BgMxnx z|8Ii3;GY%Dws08QN$NZSe7WGafUgkT4g5{PUx&X!Fx%JX1hd`!v*0uE`FoB!**5dH z95LH${*EJNTb?6$2>e>XZ0~0aE`dK^Z~=T6m~gM<`{8?nSHlnCw;Xly9WqWZ-z_Ty z+js}A5xg6`yT3W)_X2kb&-c}bg83f12-i?2-)~n4=6mld!5=}kQ1DUkUl-g3JV)>e zU@UWS^>7|#iQq)|cMI-@%x1xSCvO$ZclBPuls_c+cKB}#=6n96V7}-1{VUV_9`G>1 z>=%p^JQ@BIg7?FJTkt9P7o*YQwd`M9DwzF?3c;LLhzXtwzfQxqXt+VcsTe4tPWE58 zXE5=hJTx2&L!Nb;Z=g!zx#z?rscSX1875)EuyahQztoMWjAPmCNo)N z$Pp`<<>Wc20k;E(>X#-+`%I2l^-DV_!;UQ+`>l+(L$K1h8)5aG=*1#Kj#%xl8Wf)I zkiC@WqzRmB!wEXc5i4UQSt8GM8=W|(zK?WmWkH@CvHCvp0A-k2xU1w^a>ObxhY?nN z>8Cl$q`eYbJ!mU z&$)Syw=pgbuzoCf2(S+adA{F93g-HiAPy5_-E=dACr7OIkN$!18{x0k@Or^~&wMPH zYe%?lg>mtH-T_{vpJQX>$q_UCOwUEabN$M0%1eE?M0j$<>K^UYbmoZ+Ibx;rYr?OG z->K=03Qvw$={!Ig{;-4NK9Wo)IpSpD4^w8KCv$_ykRw+0aF+1wZ_E?SwKzw3EeE^d z770&|I9d3kltGwoxyX%zf(Zy?}+%^hNj#%aK--U06e}eLoug8QZ zN38PuC*iqvXD<#jh=jqtE<8Ena3)ErY9d0o*Z$q@N6gx zTrdE4i}2)#)w^$jCO@0qD4jNRC)tJ4AS{533Q(bzR)klk!~e^)10%6V@!4>$<)tnCrdVeM0lRbpD(0xelxYhmwC! zcyh!_o^nhZXcyh!_&qJF0e`xq+!CW79hI+<$>ERxlEN61W$--Xe$HUo1R1;$-3dlws!`ZmP(TBTg26hVbrMG|J06t6F#) z9I<+reMfk%OAAoGz*TSjP#qsVb#Entxi+p6hZ*(K zyjpm2#L2?fP-eI%vmTh~AxEt8zL~t#?X4oiwQ;j?nB%-_pA()OakB7#6rOA5>T#Gw zp8TuAlOs+Ro_jeS1^AIkJRuw$eF{uG~^3U zj##~y#|h81dQ%1SckxXcjtLGT{WTi@4Gk|A%yn|jg1I)XooOiX(r~x%O&VIu4+JSqjpt80e|&ugy~%=M0=HT+c#Z`X7d z3r~(%>7@NOrk{G61aqC`GGZ=HhFdN?*Fio>o#Q;dO?Yy|>KXj0@LXHDgYwsS@{b5l zjyPHP4$2gGGEayMIpSpDcT;APCv#9_$Pp(Czn3zlp3KW4LykCE_)f}9_GJDdGUSMp zg+D-U8PAE8W{Cle4Ea>U8PAEk_>KP)ojh*iG2 zC{ya`xk6;f5vzQipp2w{jL489R{1Itp6gt@DSw@(^Jd}65v%mi7M}HUsfOR;wNt!n zmkCdfI9d1~3eR=DCn>L?SlFIvb|v0vJH8kdZc~WEj&45)o%Po zci$8G|VI_p0`=y=^C!o@N5k? zXn3)Pn>D;r!)+Q~tKoJHZ_@Bq4L_;j4h`?s@Bs}2_LL!ty$27}@DL5>5?lBO$L^iN zB^sWp;YtnHYuGIZ(X(9R-MkCGPUH3bZYPiWL)U>r;Z6-7(eMckpVaUf4ZC*8L?_2) zl}?VeD(u=J6PbLCFVb+ChB?ltu66B@$+aBARD83BT{~nVvsU9bYMA4e>e?L|cI}YK zwTCsnOT&N94w(<-t#k%7oT1@N4Uf`rfrd*pJYB;z8g9_=QVp-v@EQ%bYnXGBDxI8b zRCu?B-7!Nc2Yu|WTa$TT!vm=<0U8c!*c}7JHFWM6onU>e%pIE& z-W@Lz?2gq4Zqjr%Yq(XzYc;%4!&^1HL&JMDd|1O>8h%T|r#0;3IFF<)py3P+XKHwq zh6^-Ys^RGxuF-IVhL>vCU0Wh);M!i59*$EfyhX$A8WoY>t?>sm?2ccFOt;3ruVDjY zL`uJ{;ei_F7?+aC)v&w9M)bSmSAwT%GL;(Un3&SDSi{RT+@|4m8s4Pg?HcaTaHock zX!wMNIUl3aa7M#^j1eh*fQEw_&em|ghKn>@reTh?DV?)5+@#@V4Yz7|t%f&hc&mop zu`((1y&8X5!(AGFOT(u%?DL;XXF$Ul8qU=4C=C~A*d0%k^i0?I8VxsSc&UatZl=m= zjfUGbyhX!LYM5&R)U^jRd{o1nr&luW7@DM$V^50b7?8s5SdGXG(fC{qkI`_6hNo({ zQp5EcUaVn`$EkSRG`vp3n>4&#!yOv#)bJ4vpV0704WH4lpJPgr-vJs9YB-x1?WWuQ zYxvw^Un~zDG5?A$vSXTe^{CwZAl(<+F)ighG14{4jrH8Vr>?!F)(3}<^S`#*dac^3 zd%RDieJc#FxK>O*Yh20p=bd$6PclDldU5OOmhqcQio->Z6vMc7{H6`@n}=T5e^FWh z^x|TBKy<<*D~rP=n_!0KkqzTFPcL2-zj<9bD@mOHr zD=)sgH+sz1Z51ALj=!9+c*p1+$43lKADK`$*hmUziQyB=gy`lT{QFtt8US;1MN-8kEDOx_uy7% zQnvlQZH2?lUr}SYbD;T4f*d>2-fk~9f5AX;zVYF(ex!J3A9tzO9E8H{9bN)f6c}|k z+!<|eKVURX2=r}?rRJ7(q))qKSisuz5-dF8O-I!~<)xFdvmP@y5_z_Y>e4RBd@S#W zG}!1_6MHQ3V7F`d&NV1Dwl9ic9mQjJIWjdwD*u z*_jl|_L-|02z}czzvG0%OTvXi{8&~2s`!_V9gVc_jT8!`Tn^&I;^ ze(2f#PVocSVW{fbfyMVbi%S|4H#OpRJp5-nibSkf18Z!@e3AAJdz5FMXx)z|Wt+1Z z0Sj!F7b{Ajj%Z~{`oQBo$r^26yxClZ+*k5kUa^<^n;8fdou9ZB-$XpwaVX*&czVxm z2-4!9IhDbLg$xcc%iVMHonwjKy&hs-OXkHLd%mGRa4UacoagwC>Fr`4pze3PvFxLJ zlBVp7y||z%Vd^n!f1JN`tPggqa^ee$3p<;v0Dcv1UlC`N2jZgm#S@=eU<3_+VO_eF zFvLhd=0BA)$Y^{2!(Uo^hQWTTKM=)$V!Kn&Freawq|td=y|t=+WvMSe z6q&qs*gIv7hA;8;Yg#b5v@%e+vZG>e66}WsgD|&wwxX(U*ch}Y-@yK4t@XGSuBES> zzI$Uw7IZH=eUE=i+RlQMlSmk>WbOITIS_7ZDIb!tJmWYP$~R(^YGk0HVL;<^XB&pB zp0(N>9uCjw6P(x)-F+rHBRPFU!q96s)&1b7Ifkzv6hpo?}ji)e=a~e>?pO-{LC@76lqc21ma=>(%8j@rBs0e%0FZ zvJ*`k(p=P$zWseXfE72rpK#T=5&H@jw2vVPs&>J1{^y zFc=)QqTAV&kyW_z;^5Zzf3@%*w!L)@*KVVIAmE4^);d-lXqI{%&zo05&GX-T1dd9Z)E-?9%4yKjIrgmz|2L9=K4 zFCooX`<7)iPnZ)ww4iusaNMRHb(dcmdegD{+e7e}C-k9R#5b6!b%#n)!`Z2x@if;q zaSm)JBJGzHc}8>h=5fC)Sar1hm(<+w#J~+cv*6y2;g39=wRxM**!J6#TbJK{v%eU_ ziGC|J@LECgLqUJ~?@mYJ&AM0bEZI>vvGut8X# zTJhXRq1|p#AYpr6MFE$`nHfztjEY-&D&=HjoWI4op`mirthI5p-}&gss^|@?+MBC( z4Q#tFuqtXd#=(HAuQ58kJPzhRN0mo!jK-M-1*4+To3_Q7w}iKDAGIwyZ9|;3AzCqM zC-;MS;O7T=cD}I&?V%mMjQHn%`iEViiw}h^IUdS56}mLs z-fV>~x;!=IkVy(E+=$hYAwWs@`x`S1NQmjFCfUcz-b;g{gY5ElSSn0~89-Ku z4(L0Om|Z}9Pdn3}hRN`X58gp3g$9{x8DmA-J1U0*%{6Ws9(O7_-opDc1xE79L+Q^x z>)<)J+B=N;j*6@P()Hbr#^<_ULoa2sv-0Vdy`NN^egiEBBDM!3Uc-xbgZ`xZuvg!o zKm^bppTZ~+TwCc#9Ha0%xzcg|ikL2|}+j-!P*hdSJ^7a+JIOUkND`!wn ze8o~51|YMI%OXV^CnL2=RLH{+Zdl`PJS$I zuV+;J;P0GpMnC_zgVTKJ&xQ&QIeCX1yugya4J)mYjRyQk0J5(2cq@C5--xz%OepY& zH#QF|u=Xr6A{nW3A*6DvlasF3Wz&?t|+M zyPw^+CCQxAS?lr5%gSN3`2F0XjvF>w zE0#FfA56B!vaxPp&CXvoJ5-(%Se)88qhHmGl+JsXp{o@%R<3QC8%Tfkr5qb~=touX zBb_&F%3k`?)<*)Hvpp-43Eyx+74B^f6yN0(PIdC8qH+XSIf8o@>6QJw>dSXqDs0v6 z3+*kitu{zlk-6z`t8G#^aY_A~PBB=hKllaWO9q;|h!x?4D8*`aqF^RG-Yc5|@s z)`_Cr+4Hlsh(eadjlWx+Yc^>!a~` z;PZ0xBUM+`UDYQ#ZDMKB%xTw7oHA|v%!x%fm7AOEohpn@9Gll?+V$gS7DlhXu5{Ye z@iR*&P90xfSbF`~Tq>*>Uw-|>>#iLeE}cGdMDB>ZFv-aiuT>{zPAG(n<>Dt1{%jCt`ydzWUdPLnL2U&%yA{-$4$C^+T@ui$MXpk;Q2(PH!+e#(WIGWg;Pt$ zhQsns=deUJ4*n!qien=Vj&+lpo#3|U#%}mQgtH+;z6{rLu4)YC6*=G40iXAtj{3|@ z&&S)qKo8xuJ&9>k*RD_)K8Da-oCTkbajP`&T8>#k#z99JVrA#38d&N11~46E zh`Eex0}kegj=ahn^#@I?(*Q^P%Yo@ALyVyv_uB6RGf&iWKQQw`yjhbc9w$8Ki0G(? zn4j=b-qCnsOvAc-U&}Bq5zKGVxP*)Hb->Ig@#DaB)Jgnx_~cV@f9S{)b16Uh;TliO z^W;ZrJh4h!vBneg9#9^yogO<-TxU&3UBpa(3y!BXo>=9Jb18I`Cq~t9b@F>PI`YH= z;4>~|bAi07cV?#d4d@7PjO!X!DmcmzKLnrGp450^MnV2PU{-J9v%sl>`=a%yqaI>Z zYgcA~#uF<&7iv7Q;x7i~a&79*2OcN*Tbexa6~aHF@xCQsZf zd;!+3sAuhVS;xXO5Dyobe+RA+%=LzJlp!vFPyOW@Ps}CDHAYsUq_!a9D7V4=EhePs}X0;25s)#HzmWeN0Dr^=@W4bKN5E z5wD%4$q=jO?pBQ_R%y5ocqp#hfa7URrURH+p#Dx^rTAZjmfMc4C z5et{hZHiUFZ))`X*$R0U{p#mn@5@;IKQ{RH|CCuj_kGRRxioJwx59*b4zC*572y9r zlH)nL%W)9%y+X(5OLs~x7bMH)i{!XOv3IfMwu)k5U1jzZz&RfCpvNs zxR8AyHeJ+*q_}C-^^N(GVSH61ls<_5T^Hxxk#ncNcpqLZ0$ldleR=ge#q(N$x$@HJ zOO&*mr>B$ol246X35MC9QI6rkI9QiUaByE-46FAzo@c!ZLg{`KBG0p5s~pcSPyzT1 zFY6Uv)hoQcS9o`?@b7ztPxK1^wO9BPgfnmxX#;}ki`NQ(>ESGhatwc|SD4@XD#!E1 zy~6y~S2>=a+beu$ukbwxvma6gS*GXFUgv+_E8N*D%x`a%V|@I^Ryl@~waUzJxL0^g zukh4f;l^HJeq*Z~^{wv}{zb3wp# zg$w6b&%rjvFc%h^1+!SL#W(H^;+mE6Y`TffHrIq1ZA8tPKhHH~)>x~eYw(Pmoip3! znSnbOR%YB(ys!s$n-|60+PSoXrCXh2!sg6tfSENapa3jeaa-x?CDrw{FsTL;ZRavp z-MFLyyHD5DR>yQBUS60cwHD5u*|>OSZ48OjE~}}npK}`w*11-B&uMc_WzkYuJq&!! zs?`j5os$u3U31kY(oCgi?yI+qSm<)imYrv_tG8gRnx(2G4`qAX%+Ij1n`X{~^*DEP zYfTvRdAnMl(~kRaYs1XhO}%%{_IP*m?9V^jdynpF+KofJb@L@EEqYH`?=UoKq*Z%6Q*oKk+#ZjQ|$Yh z>>$7uX}Ewm*LxqZ|EXkV3~xONNDp>%E%+zo!C#EDS4JhyI_{nR>6$x zw}M%g#{{dnldzH2ixFzo}vN z0VvP<{iO&p8BAVK^cy(1O@Y% zyIkX!3SI{PmxB3>KBLLB`#n8ZqASUDh1ALMi5!F#=Gr}lI|TE&KdkXwTc>0$(ePIU zv&|^g_@@Q)TSNDIP{hkNhMj!sVcXMJ@O0o*!TiQ`qTotkK8uvE0md|xi}~A~V+iEg zo)rkL2X?@$q?axO2YEVTHQrPJOnx%_>ji%U zeuai_6I=~H3R%i?oPNCEN$^VqbDW-G%5d!eTET2{rfAr;(}OVitU9m1>>eX=N#DgSNLwh9A9q}%rW>MX?TlZj_Yp|%&~m_ zCZHbLyna$J)88SO^9fHfZ5(Wc+b=vh;$-1>AgpA5FEZqal}ra^G%it4Ur*7tZZ4iHVdV!x^Pa}vbtO3$q_4CRwp!>`$UEu zv66X;yp&-#<)schEAr%s)jfTSGLlaI=3_aKBUb7Bqwu^(Cn?W{0uHOSTzPWDDh=-= ztYl7$3^`&Yb0O*hPm|Lz6i!GUSMr%-3*psGIYC?0XT< zgwJoJh&k`au)_Raig+IUTLg2i?^}Y|FIz2`-$6a7VfVW(v5U4vcyh$bUfQpOXCG{z z;7g(Nzcl=kV9o))E|~LpZod#|Tt!R+5|6wI_S-6}o*A^7L;w`silEgjN8_n*R(BTfd-xiXt+zSNWXtH_WeRyN)~ z5}xt;rGLx0(7u8>{}~ianE-XlAZCv6;lFGqANwd}I1ml@3k`oj3>nU~ z9spK4ebR3yN33+F3D5c13j}k1b)beX70llY!-yr`!_*%{0^nR*s)&~yadOb5jVrZl zk5FFPu0r9-5vz8I_F7e%`K=i9LXKFaxmtM6_s$c{^e-38x!*fAe79iAv}yQW!OYh> z!JL2oiN-%Hm~+ToOk2py*Jk0#5hn{zIi{I9JBX#M_6yJXBB;a_VwAJ~K*y59&-j+oCT z=W-bbq+F8JE1j9u=M(v3h?! zrpftmrGEZVc+Te^6Z|UtF2PJ&w}#7@hM`{Bo)n%Ov9gEf+8dU8F_rSe zJb4RoFfZhYl?@)=dzHt5f)}F>4AJ-;!6V`4YJ9$iClX7(o)n&I2l%_1`uU^vw;Fyy z!^?rqOfQ{BgeOOwEc{B!WO*_tM1~x(va8ohnae$ylfaCZ9C5PnZNTPmPv&D_%8(;g zcA;q7iadY!uc3UlCqGnpa>U8Pj}pEB{+Bg8RxrmEXv2y+iDSf4R%@w0$J0-nQIsJ^ zoGkoZ!gC$RzY1=L|8Ii1#=*70jB9s*qYW$Sq5Q7}bFIW~!CX)A8^K(2aX>KFWxObu z<0>x;rY))j9Mnnd+NJ{Ln9V@pDeu~N27e9kc;Sh8@LH}1nJRc0{G}RZm@?F}UNFaO zHVWq26OP@eeEmvr2mGfsewX0G@SoT4K}}{I%Y1}a=CpxBo#cpd)Foq3*SziS9tt|!jmIT7QRY&t_^YRRpVN&2U#LK*MrcewHfjBEEk>}akB8G zlo{#C{7_`b5hn{@MwwBb%zBX_N1QCYYo`in;98R7BE$6~yK$ITdDs3;cyh$a!tbSw z=t;yN6w84evC>Zs>b-_$rw0c#JW#_y4fC;A*XC+CU&93&F3~Vx&$YO9Jy?&6ue8t8 zKStwqol`ZwQp5EcUaaBe8gA3@It_2q@OBM%Xt-0uM>Kpw!~ET@@^VJQ?(bII7dqY_ zB@@(ewubXHT%_SL4bRZf=Vg>0*M5x1)Mz~CYm|&@KSpF$YP@SdM)-D(-=bmH zevHWM*7yS&cJ0TAOt;3n_G5&{!jqo#*cx{2$B2w;KSnU;eN_6#Xt+efQ#D+vVUC%o zYhC*>qSLh>Be+eIS*PJm8s->?($k^gP7S;EV??KGKSuCLO~xH(5MKYy>;A43KIl6a zSGI=pHC&|OG7WQVM5UACAqqEXxLL!k8eXg6jT+vnVUC+9oqIKWSi@Z!eoMorHSELh zbfw3&A0v5p?Z*ht)MQ3!xIn|M{TPv-uJJV*cJ0TAjB7te@JdZ)jfUGb?AnhJ`6o4g zw}xH&F(TvIj}hFh$-J*&1N~Q(cU!{)H9SPaxf&j$;Svo`)o`VT-8ped5Btq3-sKu@ z)9^YCZ_@B~4R>gm^M6Vwf43{l-)Rb;)bJS%`|4e!t}*JY`A`5Rv0E)Bc(V??KGKSr?6e@;H2 z;S3FDYM8(Im3}Pea2I#LY)Fvqi)@GF=Z|vb{u$dLGtg$UefGLenMNWj>p$_Cm`c+B zejz3weDT9G_meX9b=Uvzz7QL+uxADKXLefu+;!G&r{$mcho4FY9|P1Z*GV^BLf$zB zIA2UTR7cnSJvj~^;_>)GISy;f(?zZ0m>PYx?t==B`9`qc`w<>b}$@bH8PN;^g?E zMt-?5dRN?)nKRFR#icM&v&G*qCCg3t*nJv z)!}jZ;c=r=*q`t1Tssfu$4+KoT{OoC?+SWGh3qK4kL^IQf8b27Y@KG0%WUX~$Aned z&cHb}ZaR0Kagxkk*_^wu(yVZXH7o$jCf?QOC&vgmPUfL=mm5JOW{oOrEn#`5Vb|p3 zzPzN+ersP`=mW<#B35PikQuhVpFA=-91J$)TC0;x^AwX4MN}PTp%YeB+vi@GL)QnLxZ=8Juwz2U`DTM-oh9ybs?oOJ=hI6APAo z=-gPg(my)5(myBn!r6ZsZy5=H^FA*|*T~HWyw5o3eKBue=-`J=QtIBx{;^2$hfLX6 zEA!Gwe=C}1P3Rx*WukRPrfJ7v(4i!!b9d-3PR2Md6A1~%&Tbfvkj6mS=N z-DE9S_~h9KDX(sZ(=4y5^i-662fXZ^ch~Ls*r$&D`s{?VJK8E&wzmu{8n!krCm!ae zrj?a7ExPyhaJ!>biJsU(XIKZ4Qp4fvQ9F^_EK`rpjw>;8{<*P*_!AuYwhC$R=c0LLaAfP-&3zSW2);h>|8N+0!h9lmDgO1k{)91BY;fHYW+JiVSi0{h(5k4K|RJl;T3t{S{ z{OdUAD5D%#Fwg~YP@aA*4$9wwgO2hm#ivXgu*&0lU^>bWv%H!9pW&b*Ps~XW^3UO* zBfl3%5C?U3!yk@=@%A^*<%_EiIHAL9M*!3DTH+z_$(L)qy64nc2|fqssgoKBW0`M7EyoG;olqbeur^}~l zysD4XGXy+)D=j!GG@1X#mw1h}^|2A3=^MJN_syPn?sGefBV4h?O(XDKpV1S*HsTFP z&p+qz>6O7k`g{FI^~8q$NjW}gz4fV@j8i==0H0K)oBSD!DL2WTV1JP3SUdTx9rdX` z;w21dP6hEvntRuj9BbkjO-{u%9vrVx`K6q?a}-x{1sW#bfGWcABGwevOqISVz$y)Z z?zjI%1me`Wn-J!8$~}REeqMjL9s=qb%GRM5P)Q(8otuTQN-IxoAK*RdOdne)mA)mw z>KZ@;9aeX*U1BLf^B zuhK`|dPLRq(rTuuk&)Bk+}@{_QFNpW$bFh5vwXB{J#7 zmuMVEcq-tsLdO&&cqT&- zRoB+fM4QPFTGZOuLhZEsA&@#d>+eM3ePVU)n=<(omZpuHR2nn#(6Vm z&!1b%54+q%H_Tq*;#ub?CakWpc0pv$yqem@ZaS-H*H+&$b74%o@Z6_WR25;+>s^@g zAZ|jjs&8Xv6ANFXVfKy`&u3m?z#hyxH9+pyFu_syoB}1!>&gUEAKM`EjAylA#{YA{ zOjnm+_J%S9vu=e2vtIE~dz^hoc=pKLHj`aFIM#E{{X1!+)9>Z6Mtq9F#u@e+v#%9^T&yPmVZQc=ixfIkVTH%8dFGmd4bt@$P+ud^6&qQ~HCz14N!v;>47lCzv`G2&V3P1vAbc3w{Xx zV}hBk-GVp5|Eu7=@Pmk(`a6M#3uZgdo*{YWo8JHsvpjAW%yK#`nC175V3sS}56buS z$nfrwWi%3^`)8-q)RDmV5oY$dDsebznQNssk^I3^`&|2R;>^ zzX1A39pkTrfxv2=>lMP2BUbBH-MMFJH?9^La>VLB27#5Hu_8l`Sm|MznuwFmk3(VB zX@yzz3I{cuNsRkNmy1K;d<_?9xJ1Kc8lJ9Uz@E6=c1F^sr(uXDI54OZcf8 zU#a1G4KLR4at*g>c%6nfX?VMaJ2cETNR`_W4ZHPO(sokg&k*C@(D`v*mFEBrvwc&1 zwubXH?5?+v`%jWyFxzgWzg5F)HSDgp5Iyd*Ab5u+!{4Zo$~ z(;D`n4AiymdJEC-)_KA1dJDm$H2DGzyX!4P#$9hAxJHw4*INj`RO8+C7Q(O5_;w9* zXmQ@+e}1kYlAj;R4bpw_T)|PUPelBq+}efUdJ15lTx=G;@7R~+`{w$}Mh533T2W)PFZ8Zs$9aR$pEsBcyQpzfys=m_9A8}? zUlpwMRgSvdxS+rYuZL~UqV>ke^_V8;z;EY)cEW;Fj^A9BSdDSnwl-he?Axm*RIBk_ z&I9wHbNx@>{hEOX%uRZSOaH@v$kdA=jy_{xf4>zrV#ng@(uPNj%DVoSh2C&H8=0Zk zoxE-i_q&q-82leI7U{*64X5qwKuQx*S+XVQBUk(ZNH`3VZ_f(|%J9I@9B02c5*)_{w9!J#j{)GZ3|D zPWA%x1xn_m+;M@iH}y#9Go$Lw#{bx*?dhc`t^N%ws-e?d>?rn7rRgtV}^U zWJbf*rtq#$(i@Y{w8AhcO^9CRS<^L7Fj2PUS;3YpzC!Nil*xU=>-*Uwy}a%jWMtaw zs?4K2mv09Pn(PbgH1kCU@u^~u*58xJ%xG;if9IYu4KLqe+i$q z#MqpX&^a<%@Q8o>lns!8I9Z&uCd{F zICR8Z>)HYRc^{)5A(FWks@!SpuuxU`UC;3Ox+*(O>WEls4T~<*wH2El`4n-uwqjSD zb|;FcueZZ}Oqv44`(plr{g&TID)i=3V8=Kyt^ZtX9#DA7vEy?LFAi*FeY2foPquA; zeqrow2PUT*_pEJ9thtL1LRQukY#(IhjxiwkwuHRiWQ;`-I~PqMGK zeIQnt#?lvTep?m4$Y`yyMLFmlZSD&trS3%G7*^?bc4e38 z6Em$#^G!b<04C@2&EPr?j5t*)ee|IdvsE8DXr%lFC~9}UC)3Q_*19e99$F`un|J5U zro8Lqp?HHvbnw}-qCi2x2f&fRXG3p0xw%bs18n>ES3l7o8Ntv8GD2UPG-g*CvCjVS ziR#AdiO_JM2b=f+>HM^=)ykqr>OvL%82YoLy7izRymdW0n^VH(%pjofOLZqm%9P9@%it67vsExNwMUw~;?N z68Ff^!5MbMdsMyub!o|=|8nyF%kduADbG7G>}A5%?yTuPv2|&eP3pv~qT5F0?d8rC zKJy@BgPCR77{uNE#I{!SHJvPw>7} zKkQMhJDIrZQuBSr9?2dwY;|hvFPQe8p3u0y0B!t@3479v^m?CN(o)*(y#&^ua8_jx zTJ??o-i+{LX#awS`HJ)81HUx9W)ctJu)v_aV~!n}Y~u`6uRCO?6{G1qXQ~-x7U$U= zx5Ilra^~9M>_K=R*m0BNy+SVj$eSW&l6xH2Y|#yo_n;U0pZ&L&!}5C4vVHfAUa;TF z`?J$yt>4S1e?dhTY>s=mv>Q!#(%5eCEUeqByxN5tlJ_z;rMSy7?jD-97`u9S`3?Qf z8EboQzoqX*O5cc-z8NX~OQiIzNa@>NuCd{P-&ofX#!cS^bKgf7Mh)xeka8og^LJH- zuX9DC5#M>W?PH-0$a}^~U(;vVGfs=&NcZSnzEygha7Xt?x^gcqG?$LWd_ zAK2y4 zjJxEX@h(l1W)ZES>{zt5{Ve5>CgPp820P9x2=6sCX9V_56UI}#wmNJ_)WeqbL`WFdoi8QHvs#DQyix}-bk#yIBG4d zvKpF;%z~1<3u`l)>&(j8d6h*6Vb=Y^+T^G@#arbYR-4pX(`YRiUei##`s!N$D(kkB z%TwD*R_FNCi*D=ddbPOUQbKO>3hdXCx6P- z+v1M(&6;vaXGcdFf10TaRNal1n;ahYe8<8}pxbUnciRD5vk~ zLP;a-yfA+H*q*CA!AP!y9he25IJ15}`ks%ShAZ16FPQGah;W<}jr+7YoLUeL;(s*m zY$WbX`9#AD=7xhU;Xy0?_s#ary7yUbA>!6Y>TZy_89U=Z_4-eoC+gfiN1hmJ6<=lq z7ZT-aFhsr%naxEOV*{f_oa?wz%{c>Oz0`xEVvm(1k4%F3o~ zFIkOVdKRS?ED9nq*r@;jNdm}S6l|PiP{}0I{cpMd<7Q<&6BXn*_*LOSh&^(|+~!5~RBFLf!RDtV>mJU1D!6U< zpth$v(!ceATTHX={Y~+q^X{v9E~k9L^&_mFtekiZ4*tzak591e18=oAzHC+{IxUHx zHrJ&#*9GyvCGl)y;u#NP&xK(>%8slLnD4LwSbz;?5?Wq1?W9#DpROu7yQ<_&Rf$uc zXe4t1OZfyNAm?kSd0hAzG272DK9$*?Dp^h>yl2^A1f|mS*SU=?*t>3$tq+S zz+R0yUT~(XyYP6yS@-{^?tkZaJZsVGW1jRn!qOE(h9c2MZ~2X7HFS>3iQAK4G?$sV z)oq^?mrc(ryR5CU`0;|GP+7SBny@kW_AL!YW5+6cLGxB~>yvqHceQWb*0J@ewv$h# ze)8znM;~wB7;0bH*0y+cW9fo$X+zLx>MTRkH}2UoY>2R6QB?v0x5t<1ok2ePJluD1 z-GBg^mTSf}`^;!`q2bS4;WIjGn&ZsLaS5L|mbI|iFu_hiC+_{hb!**##6BZ)jV3F4 zYiF+Ae|+(0dUBLaWe+v7JAkc(YP`;5xN|~@X@8Kvreve6QBr+V)t0#p+W$@eru>Dy zy^r4Aw=?OnH(q)1pxyUaoYg;WzcoERoYuEvT8G`g?A6;7(=2O7-=j_WH?JGn`gLq` zG0@1rxiQXaEWNBMF0QI{NVqd#FVCOba;eoaBh`Bqhc_D5rRJ)Pe(%2E829HsJf~ml z^TFIePCxSq>nhIWzirLvw{A81c8AG4l=h`{&%0Y^c-=evMBQfJ(E32Q^M;Jo-UfI1 z$KKuPv_5F{YaUuKcxYL0Xv3xX`w?0fcf8}%^bsl1jRQaFctoRjG@pm*Esg*_$|EuDcm&f1k;W8t5 zbweQZQ~XLT&mL4>HQfAnD#+X56mD=Lag*_WOMLaZ0%KG`(Wt}$#d$x*E{3fS=9pHY z&mJ<-#Lp*E)Mk-EOJ7rCpAlcQ1eU{~Pt4>y|#iAiJU6ubh5Yx}xXjz}?Dj z#q$nYBBRH#pZ3qz4gQWRd@;6f${P#zv;^vLY)1L5{?xW;?+MQm(te_&+0Rb3O#scBth zb}?J{0X7%mT7=zk3ELN)TPwfn|44z@evJ3rm|)on7gna{*h^R20~*`UHZ%kpOB3*X zE!*Sl^V=!z7AyY3$96kwvzNZvet+P_1)-1JwR)y` z#!XaQ=tD+VO!Jy}W$?Zm19DSC;!KgqGvU)B`w zCwbhQXUhJJ-( z1R4IaEYmpJ9?l8Al@`WJ#QkAn*L-VCcy4gN6^VA|n>gns1cMRYtK&zV_)(vlV;{-e z8*-Ops%ZYMA9L5pasX&wDpIiDVhW~UpkR8LomO_Jy)h?vN%*<@t_f$4_J$<#-e#T3 z_3D&6HipK%f9wsX997F#IjucfTjSL}v>mUzH!`ttZcrP$!m`_8KYDP_$DjFCErV$LT%z<9y9=%1{z*f44NwKY!Sgq= zBmIRw(TtQbU*HB`DD;NYX!|e#Qf^yO+l<&oiyeO#Mo+zZkYE|1R~)ZMR%N8D|C5vc z%Y;pRw)6?_9KfDBeuxx$k7GC^1wW_4g%|q`{1ofJxS_i(725&56}UM8?LeA0U}pQ5 zp0qDn--%7GQdV8u9Sjy3X$8hp>y4*!x85IEbyIiC4Da#W6-u>20e7cSH?v#yEF-D| z2(z4Y`hSXh%I{Dt?Rc#JF|=v>eK{DK$U`~2$*OVm&{#XCZ^i(xR6@rb@5kg=biX;& zGSyghX^I`FSdzH!-Pj+TDZh8}Ucyh2wn$v_CDUHJ%vyo|MSAysqocXV@D~Id9!q@P zN+@-!!28eL+g&`-$os8hr{#_bMs7~A(z|nWi;VspZw|svSVgxtcsSR-85I~s>6>Uy zOtsS{r~rzsg8F^Ii< z^CZTNLLpVr8+8u~&r^v1mgY0B$MAo($Dd}y#%*y<<9pl0|qrEp+ zctqCNl*}q~i>rC===4Lru~u|MR(Z^T{X)xl7IFmItqsjFe*sx}5gvOzJT+{X~3 z$6pR!mK$08<-hkY=o&T74i-)<3XTn4R&!46+}L95M}>tau9e@=xf2rQ7oGnng90Oc5YzCNtnHrgC7-ek9omkq)uqC6y!UYXmPT@wo ztWt}Gg@rY`oWc{EoNZcJn>y6ab~r^Ft^0mG&-*ic`r7{bWA8c7_rC7?c|Z5L&+q&E zxZgWX8hQRQd0?vE4`>*}4z0kn@t&D!;R~cO?VRL+W4?=$4zsV4XKT{q7$Z-fVO`=p zw~6^y7eB`zfilFgi2tB;MMW8g#C%hR|Ft?!3HV|5Vf0B!hjkbidPC^S4CbP=PQ&G5 z4jHDM6CQD#2Pnf%>F<(;|4e1rtQh}tF_XY;%t(Rqz?UgTzhBJfLoomGOuz%j{_ypr z$9aeOo|HaS-gO!-_HoU$@U_-gCmq&lsF>HCNrz(}zB}nKpA}KI2a+D=Jjy^}dlgZJ zUNPGaKmTDC%g%q85r|-pLHyqo$M)?{9{6gFC!cdMC@>lh{pO^@u@3nkF9QBJC)ZBY z|J+EwSQ_(vNPL50^8XJps~4_gqbo2i9QsSeu`T#dYXY7)*OUJ^=@X=p|J>w(W8E%D zIvnSL?xe?cgFO4BbABdI{=12DG3Dfcr{a7yk`1ardEh7m*Bt_ST!YASwsgMxCeK^M zvlWvk|M_%=d7C(vm+KaReBv5LKD;BxLq1Q6FIP-HFVTS(`J9!Q|8^pfPh11ZXRLJ2 z3FI?5d0>`>JR6e^$9}a)On!K75zjUAKTj8#4~hx+;P4+3&y>crT#E^ei|cajM3qhY z7-^JkhIpZ3{2xhvm{o+nIq7iBYpXc++h@ht@DBkBv@(LZrZBG;`@2x4hhy5ei(_9} zB9468#oCRFJiEmNrj5D<%d%E_EXya82WI!9Jlm2Ev+tolB3AXI;3vd!PWY$fha;cC z&^2F}GP7L27Dt)uB)-IX#fwI)`uIw5gY~P#7ntA6hESk9Q8z5|l>QcJ%=hu+fnOz!{C|}6s82F2 zm4}szn06%<2?g?RGvk5JkcQ_y$rJTaJZq)Lx#eE*CGs-g1IZ7QH+sJ~w%0Ss6Lnki zJS9Ey9HUCbjh?oX3WfrC!Lk2SA10tj-I#nfNFOha@_$hr>*Vp|hnbGDJ(>7vF`E+o zx#W*JH~Ej&K@r=uodZOHyx=&`+%LXL8u|Q09Otp);y8!=T1;TtsLPZ8V(obBla&9n z?1Tz<;0qO#=VRhnu4j@5o^8*o^?mg=^H;?js!V%O9Qpi09LxK>n83W?af=l9i|NEyAc)8;m{8is`PmVJo5h^ zT0$1x9bKxveB6{VH-CiPO0v7NH2#0Jh%DT$93ikrLNMc6RB0Uw zQySMPj%8{I)DFedNcrGu9u+Kx{K% zP204CmP6VQOwa7ekG#*)kn`I*P50w$Fo(!5(tjv^VZVhb15NP4 zHj%OQ%H00vHj=r7G4wcT|nPt1A6KRr*U+>2E7NTL)5? z^Ltup>XhT1{)y7mZ9AMkBkk;z|5a6K`VirnL7V+oRE>W}ReD8Ly0a=B&zF>4u|IsM zYCP=)B2b=(tI`Lm(ub?k&s3#{s?uksLxTKYUX>nKm8Q>(2>9b!6B_9S8qa;_ZZX?$ zsnXmB9d^2tv`!rCXN-Tp(%ieObNX(jqu$PV{+BTV`R}Ppe@$uX@Q-La;{RUN_+M0| zM{uAzkl*;K^jnmse*LV*k>7Py>tNtxA8SD*cJ7^nIjNM_uXp@t=#-gPWZG zdX>LlY3j6`=PBROs_{I-ioo(cuQYYncZ>0#tz(P2=8v3?=UhyKpZ+JPD{|c6k7rgf zeo;Cl<6l{orvHlwjOS%flU~*|6@6c-g*07O>faugwKjDxZ|Z1YtrpPBioQ18KjG=# zAL*iUr3|gz3wy6r2a?N{E`P6^Si8GTzXWRPXl*I;C$E)V?VU}XxAmyQ%i(@JT?pP7 zH7&nYopY*b_V0DZd0Hr2U7t=zE9f`RGHN?w))XLoo_i` zXVcx&q?xvKu2@m5QnkN+LA&uk)E1nE+FC!FTFuE%x5qAeNi8;%8gUmJNZV_5>(cJ! zZILQF$!uD>vb9R#1zW3n8tv(BU+xy_FKjdZ!j|jWsbPxn zE}nL)Rjq4^4qMgpX>{buc2f_h+6cuqc5kR`e#+#YU4O5aOIFG7JItok^Xh-yblss%4o0|IHQA1CgT8I_xE7|BP+B;ga#En9+jhSoD9bK(yiEiznU3~dklO0N3 zv|h7HrS9lZ=EF;)u3OpM8t<+>Nx2Z+TG>jm!x^>7ypg)KI~8M{W(Ij<)30gK<*3$N z(P?c_IZ{v2yL(o5boQ{tQjXP~x}Kib3p+AZqyL!=)22>U*QvkX z@hY=t+m+qhp3Z{58=!o2n_J@!P35au)!L)~$SjV)&NZuQTH2Otp~^o;C=;uDw2$B3 zs3Kq0t$!Mb{8P8RNJXEpTJN39Yq|>a&1GVET)DoB4O^@$%GlD{zDoaS)3v61wff?1 zTA|&wtvqgu?9!1_q^lQ68?C!(+47~U%Z`T&4=`y?tn!fmS~Gd_{3Y~3UGpOUV~Gb6^V}!=T}kH|Q|JSF zh868%*TS0b5nbzg&CIt4<^j1vSJHW27Ugf&bhVm}uq5%~#5}W$GPkIXQaicyH^Ul7 zSOR-pEr#co`a;-cXoT&bZ~lnpJum4z(~R=;sy-XcGu&YMHw&&$JTfuQufszh3c;fi z*C*y#e0cV%o*ld=G0*)&pP88cDMIHRLvXL^kHNgp2tV%zBP(yh zVLhCQeeV$LJP*R;sq}%Q^R6yDJ*rm)cO~wCCl}e*v?X2wE6+jYS^Ph?kGqBFuP^6)_$bdV*z1IM$>E<5+s}PP zcuvS$dwyAF?q9;gJMx%zuciy;9e*4<2Q^vv_a)v7>v$&Y(GZ^9iFd(TUbg9y#ETPa z_a81NPa`59E&4DEhnd9~rE(K4(Eu~uG&9q^%}n0hXX0U=o6VHvH)hH>Qsu)#*zFj%^VYl z%p5DvnmLAs%zG5mFCBUARXjq+9n3NJYV&x-Qxbo{%rW|~nPc~$nPYm;%(4C}Gv|P@ zI=7HN=Z5ploHHhxo5h!yTf|qJ+r+Kr&naGG<~;OCGv_Dzr6YgNTl>u06#vf5x$Td1 z&cwqx??Ur!ir-}Byr@RYg{NQ4b2j{(JL#7W=A7DPX4;~EH|g*_);R|k{kTcrAnj#3 z;Fy;4^jtIN@2kyR6Bd{`$1gE+?!VK_HQ_u*s`X;aMK5npHK`n=f8b^9;OT+exz&$L|UzisCF&wG7z>IFRWfvGQ? zZ>ApccJo&h-)yF?K^i}GkQb>=0@F_u&yry3DO1eUUs}!7YyRB)Da9X8e6N{$(3z?i zkF=;&1p`J2Rw|d6>W5qms!bAP*w`S^PZ_vXJ^s5xlGgEi#G2f;5 zt7htV-!)V3d&*3G@L4nU#OKY_AM15pB7f?Y^UdVR`(SkHp6BcO22&@UW2UZpy_q^J zZ6xqex7}i<&ikO5y6{djb>wfDk0|~JGxg}pRmUbD>en}zkBNDfRphUDlbO2tW9Fw6 z^E?X=_4k*n&R^sso?@oHf2EoGfZNP1ia%}UUg0xl?jgQm{()lN%aSMe88dXx0`uB(1X6}35r~4!P+z)LqbDy-u%=^#>&D>Y*H1jdQ z7tP$09WmFA);?w)p_q5B_LO0Kip>P?^k>n|G3h>%sLuevCh3mEF<@9EIS$;%Xl<- z*4cvwho|TRU1`4E9l-y(a=shwM}sTYkKyrpV;bg*2FH5aZvD%OA4tqSSnL}QT1SIp z-+072?{kjh_xdmTTek+s`X5T3Z+TiYI6Notc>N!?2Mvz(e~#<4)Tt+$`Ih*kJTdL1 z*3saY_7olsgrYBXF&bP^OdY&YL+$v|(<5fRp~2CQE$@KPH!EJKA@cl?bu^ef`M!5? z@-Pk4qQQ8mk9@}Z2Nf^T5P5F1jt1l3uXvA!+6iSjd51)vXmIo=`;7HpD&DK1mJ_PN zPpzZD73=%(Tv&Qus&bPj8XWziPC~z^^h~jbdy461zJ-1>JhAksYl)gs7nh8$$WzP9 zdn%Z3q^~!#Tt)xs(phgE8fqt%({8W_4UT?DyYO66dOl_k8XWzQZnn<%)%!KnPAUCA zu#N^tKcPRi&b`h74bjKt&#a@t(Z?liz*rXEO`U7zTkFv<7cPZyi5VCA3|Q0h-SwNy zI~9M!%y+zxoB59VNi*MF_lj#9%KQhcqrnyHML%LwOV7{kL4zySM<_4Kz`azT^xA2q z|7F(E;OIAVJ)Sp|o^$O%gQMTfG1kd*1Aedb^R1)7vCcQ9Jg3`(21lNkTjx9TP54!3 zAO+cs#EK_MpL02Kqi@zI=y&9RK(-&lT3u z;5grQSm*ovA^e(_u+BOf%(;<=Qz!6TP*`g2wFeE3bKL=P?HfzaxtfOZpuxj^v*Pi& zWsE%srNMD-d7X9ci~I4vsm$|2>u7Mr`k~~x)E+cAJcpC#jrO3y;W?5#Z?y*v4i9}= zvs|<=gu|AYMFVZwj ziw1}1mDXAA6Ujf#IvO1QlgV>~J!o)vPT_Hx-)#>X9Lw@)>vbycM-v}Q{G6G#Bx^O)UQw>ApIJwPE7s3ZSt-Bz)aha=gqYB;CU7v+IlQ7)7IlAGvDDinQ8a2 zBIzGA)24%gd}znLw8dx> zM;VS=M}wmbJVznVQHtvlcQEZ$W!ZS9f(H$*SRZ4Zb|qc-uP*(sv5p2;tdFu7N7d)HaNNpYi@b}kDN-aLsdOf8r3Dtpl2 zSXV9L+UrWsz4oBN73*zy=9iwovj+{XSnt5|_R{mHJ!o*n`nRm}ytzw5?K?{Ucdetr z73)2Ct}i{`w+9WbSntKtSbF}&9yGXO{WsQW>$FxJ{@+?hgTsH8d~6rmL-i$p#X1@s z{`GkLTx+a7XmC8&nrxkRRd0naF3Wr^>~me8IPTFlp{opNaNMJ<$8%{p?S1y3!ErCV z+dA#Ao`!w@J1CBA&9hkYM}uQqAIIZudXYV7aBS-#Jl=<=*@FhhK70a?_u(t-L4#u- zKAG~l#vU{{@;Qaa`}tyf(BRn5@3v0cu5D)8eD!FkT~My89oEs{iuGP`93y`(W}TqH zag01+o%UsCYhB{uJ;LkEv;{k^akY!ed0k{34X#)p!sC7NGJDYA*q2V=xv|XW27A!p ziuIEzpPTGKgCn1A>tht}Fw>^&%Vye|t=ABBq(`iy!BIzg)H?4&zGtQ_8x1mJADAR& zouI+7?cQviwr2FRg@^YfbsAznZ?=vG$9_H{c{=PtgTvEnopx;>FyF6uq=wk0cUeb+ zW1H6F@%fEuC>t6a#{&K0#If+GJ!o(o3qM6)SZ=Se+TUY+_K3+74UYBse(SWM8>gZ6 zUFEdvtfRpd>l5%yDLo&x2Mvz(@JaN=rDwZ6y#IOFyif60%(SQbj`@({C(WF{o;E+G zc%p__KPRoD!LfcO|%M}sTYpG^Kn{9bQAw2lVHdOK6wmF;qt;uo8F zPq>h2y*|&jjt0m29D}~NEDyi&%tyD|!(5+O_F;Wo;)#jbJdw}L#IqAq^$ZWE%V3HU z+?=>AaaZEr#C?f3B;J&GOXBT`cP8GQcyHqUi4P_|l=w*Efy9G}g~Q){jZ8c`F^~3Q zJv1cd(Mjm@5_5VAy*Y75;@-sT6X*4_HR*Ys>`D6m#Qll$vL8$OP~uaGNAMm>`z>Kq z;&F+2pBtW;iRUJ6OuQsni+S}XUY~eV;;o7K<}ao#-UDhG z2>X-XpZG}PV~K|npGrKU?sWd65|2wfIq}TIa}zfv=3B!kb6aBG^M&4*cw^!%iFYL4 zow)ec*X!Y6(hnydNPIl;$;5TMmvKJziN_|Mn0R{P*@^j)9fpT@a>2#> zGMAxvhh;9_E17pC|K7w05+6!@H1S~K6NzhhZ{qw%CLW!5LgI$Rvl7osyfATd;*P|< ziPtCIlz406or(7(-k-QXG2c_haux5eyo~u>(y8R(om%)uB_5Y}a^jhZ=O%7Uyd-g3 z;-18Pi8m(Rl6Xhr-HG=lKA8A$;(^4)dl0XO;@yO~Zp7(juTMNS@x;W_6VFaOKk?$k zEs47luT9K5qgel&6K_wvEAigM2NEAjd^GW3;uDE!ULW%vnRs;K35gpL&q_Qm@xsK- ziHr6fUgt%75Hs)lqYRr8Z%w>2@t(x{6Za=Rl9+czk^fNQQ;GQ=H$0;f^Zq0B$%$ts z=G{g#QH1kj-BJ literal 0 HcmV?d00001 diff --git a/tools/sdk/lib/libphy.a b/tools/sdk/lib/libphy.a new file mode 100644 index 0000000000000000000000000000000000000000..cb026f941c6180bc2572e7741d85457cfdeb95a6 GIT binary patch literal 145068 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 literal 0 HcmV?d00001 diff --git a/tools/sdk/lib/libsmartconfig.a b/tools/sdk/lib/libsmartconfig.a new file mode 100644 index 0000000000000000000000000000000000000000..39bfe39d2fc132584c7b28a2ac80bfafcf095c5c GIT binary patch literal 93184 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

ewi0#uA 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 Tr{uY)r60zCQ9X`yhW91+jgF+fOeTHz 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 z zTPIk7Wxi?!KLReX%$JWc*V;Po6f)$9or3389esg@Yfyj zPb;`x!JP`W_Ue&O8f!0IU~7L{;0ua;q~l`R;uY*xF!$$W`qLGhqhRjEOPN~~T&3Vf z1ve{rm4eqPn0xF}=Qag%k6rS+70f+$$#XAW;u8wC_Si)^SbN$6TYJj_TYI(wTl=2^ zkHfyF)S0E==?X4VaJho(6ueZytqNYN;5G$sRWSFOWg4DW@ID29w{KC562dzw;@ zso=p19-&~rf+s0BSHZIsT%zC_1ve>pxq??Kc!PqsDA?L77Io3C@SO@isNkat<{q-l z?*#=%axYQnj90K*!DAGhuHYO6bN^TBxkbTM3g(`#lxbG5wJ$2tuukDOD|nlNxu-1k z>{jrr3hq|$2?cY%SB7;&Uc}tjm3*RteF`3@;4B4m-&KY!QgFF~xd$s{mMXYa!94#Y zW!e;M?O}@Y*`e^yD|nxR-&XK31)o(ge{3P+G8H^n!6OvxSMVeS=PG!Xf=d)!qu?e5 zFITX2Zd2sZ+Rqetiz35)QJLm;1$Po-Os6@h;G+sYrQiz+j>P@B3~TLA3O#OxxAyb| zpRVvZ3eHzBPw@sT8m#x3x?#TV`ymr2q}Z=C#aHaU?)xF>JcNm~jI(lUzti+oz_qwE zDsj7egx~FMj6Rj@nEH9hx~^$%xU|y5b?n>Y;hR6t7v$+tuB7|6uBaR^$o!FcGU>jl zk$8JhqQlsDw6E8GxrzE>6+gb!afA5_-+jiDjsu0-nL_=s%Wmkq%l)IazO6^_@}e+f zdstX=muug%?gL2RN3P~B9j|YJcY96qny@~b!XmbZg*QLp(w=qUt!kUX9N$lCenQ{& zgq!bJtGWC8o!_1Go34IG;xu!z|D(3!3;%kRG4-ub(tSyHXYUQU|J2sEGcR~#%(CR@ z%zolUf2oe{szu%Ti@I|gn}Xf`Mx&3Guy{%E@N=PNO}~ET&ELBEn$$3@FkA~bwC35m zmg8zpbKUmQkr*v2&7J>|+y9YU`^Z17v+_q1D+A-Yn;W~=HFo|5VH?b&DU?ta3*sb<-n z>Q8+4P2I{m_yPvsgV7UUnqjQ>oAFI|Mx5r|72mD7-p@CtdbI5Gp@L6C!B0XP{}ys; z=|*gBR@QT|{x`C({#Dzvu_axx`#Rh6J7e3Q^=JJgcH2wYzx#e$YitRK_3ioVV^_EO zo4@VP+8x{cM)vpCwXIhItoQpf{Qg$I|5^XGXYby&-XEKl)!cgb>cxI7H>-KE-=B7O zU7A0`nC7j_TA{qsi48_JBEaRCJEh_KESq-)2NVVqj9~nk;NT;{K?i~Z>w}4WMdX={ zM?X80=t$O4P1Y;Yyq<&~=tf6upd+^9!%%wUv{rxBqUIa*_J&ydt#SVJ?Dn+S5>!c= zJHs(8r_Z`WXM)3w;P3;%A%R_|0>PmVuI+oqlX#%R?d@=9_Dgiw@76l=C+aNha2p-| zrtm7qwAs^g>eel4{;uBsvsg5=wpMptQ+E5}*wu^O&5PZ2mHujNn)b%p176RN)DFM> zk|Jn8@WPI)R$RN+(Y#J?-(m$`@1B;^yk${yYj%5UEL5TH?+u?e`;E1)CC8+8WFZmO zTZy)Nh93E2?DkhqZ4VB8{liZT&+s#zVL#BJ_8_vd&$p=gq~4wxi-w2Rw(nqedsnQx z%Z-k42nB(hCilxkpVOZRwc`hVo&g6u1CMwHo$(Czwly1`_|Y!D3RtNJKjtrK>f2V= zx!QLHhnxu}76#o$aBynyvID`PcR7v(6A~TuLC=wmN4ty2M$D@S{3XJ(nT*)_Xfq6M+st2%{q_^|@FirWFO&T%|WREoxqu-Hvv; z*p0$$Zgn+RqB`8wTD4=EHZA9k2VV1fhM`dP-7E$q4tk)Zup@t6=jI zEZeMo0Hx{Mf_qvl%HpqN(j8#3G?dlnF0JZH& zKwI>-tu{P^?dox(Lgu4SwC!1V=jU}#FoB3qp6SEy{N9Kv2Dwul9I;Ts-D<#XH$J2 zZBt*ZG(xL>YE#g)WdG<^3}n93_Z}Yg^KZ94m44Xkajo0$_xe|_@nhs@3C6zglTiBp zLQibKuXs^MVM3tfr?|rI1m{1xV>J1K=m}Ep`Yw1s6 zbVbQ09md-(3q3<~pGrE7+6V+=lN~F*gO=n<^$hWPhC*b;U2IsEmmyXxg%_3M3IvDw zPJ4s#sG=#~1~(wp6UW{d9LO5IGn8p~gM+=E0p8#s5aCNu#hz5p;Cj!XQcvs}&yd{1 z7y=7D@tZse?%946&g$j<)s_B|dH!uVepJxv`~4-e{aI;#%)mb|(1S}o!!|w=LUVwW z*VBKE$BnmzHhUrEF7+_d=1M=t>gGzG~it+gE_1 zJ-0t$eN_hz3qn%cfySh7o9&)@CWI=&GQnuSa8QGS?k@j<%H~lI9*fF8b-vxKn{&ha zvSpwTM+WUKj2>(o-Ec(4y0e-SCe$4K`HUZ5^{t&{FFrK>wpV|3*JmHUa37ue?Y+|r52g%o zyma|ei_r?TCNpTh6z-Q?Kru7ct_NU4PzMdfx*_m;812#Q8sXZRX=O zbIyKHap#kfziYZ;Y~o{2zj&;x@v>>Z|Ni&tuK9IkZrI;rg5z&`W@X2)M-HD`=c+#R z!?iyd{@vq$obCI|s*U$X|Ka^WRrdPie%od}JFqb7w%7a<{w@6vSwDT`?!Ue9kEQQs zwEX0%(09lEaB|M`?;L++*0Mr^<1o160He}DfK z_2>RxzOriFz*jfl(s^seZ`Rb*<>r5W@|ickHDKyZKl{PM%U2)#xwdNOpZk7#v?zSX zuck!o8#DYzFJIfw==kOD!}R{&yZ!3>T-i6wd;5cj&iv_*r=EVl;lZtq-oO50{E8#z zCmu^&^p^$KogTVySkepk*8a9M=83`oo^WB#HPc=^u*Ci2x7xpG+I#ca%euCtwf1=_ z<*B&Xxucp-6qgh%dwj^Rua8cC@6Jc>-?QQ4w(f7tcyjb7+jf8W?4)~cTpt{CrQ

`e4?16$JpTcN`Dz?2;WrSruRHGVf_rfo`>rzk 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 literal 0 HcmV?d00001 diff --git a/tools/sdk/lib/libpp.a b/tools/sdk/lib/libpp.a new file mode 100644 index 0000000000000000000000000000000000000000..d28457b1e721833487e8ae6328f2707fc577bfac GIT binary patch literal 180144 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