EasyFlash -Download - EasyFlash -Quellcode -Download

EasyFlash

FLASH-Quellcode

Easy

Herunterladen

Easyflash

1. Einführung (Englisch)

Tipp : Nach EasyFlash V4.1 wurde das neu gestaltete und entwickelte FlashDB -Open -Source -Projekt offiziell gestartet. Es verfügt über neu integrierte Funktionen wie Zeitablaufdatenbank, Multi-Partition-Management und mehrere Datenbankinstanzen, was auch die Gesamtleistung in gewissem Maße verbessert hat. Willkommen bei Follow: https://github.com/armink/flashdb. Gleichzeitig wird der vorhandene EasyFlash weiterhin beibehalten.

EasyFlash ist eine leichte Open -Source -Bibliothek für eingebettete Flash -Speicher, die es den Entwicklern erleichtert, eine gemeinsame Anwendungsentwicklung basierend auf dem Flash -Speicher zu implementieren. Es ist sehr geeignet für Smart Home, tragbare, industrielle Kontrolle, medizinische Versorgung, Internet der Dinge und andere Produkte, die Stromversorgungsfunktionen erfordern. Es hat einen extrem geringen Ressourcenverbrauch und unterstützt verschiedene MCU-On-Chip-Speicher. Diese Bibliothek enthält hauptsächlich drei praktische Funktionen :

ENV spart schnell Produktparameter, unterstützt Schreibbilanz (Verschleißbilanz) und Stromversorgungsfunktionen

EasyFlash kann nicht nur die Funktion der Power-Down-Speicher von Informationen wie das Festlegen von Parametern oder das Ausführen von Produktprotokollen von Produkten erkennen, sondern auch einfache Methoden zum Hinzufügen, Löschen, Ändern und Abfragen einschließen, wodurch die Schwierigkeit von Entwicklern bei der Verarbeitung von Produktparametern verringert und in späteren Upgrades eine bessere Skalierbarkeit des Produkts gewährleistet ist. Machen Sie Flash eine kleine Schlüsselwertdatenbank, die Flash in ein NoSQL-Modell (nicht-relationaler Datenbank) verwandelt.

IAP Online -Upgrade ist nicht mehr schwierig

Diese Bibliothek fasst die häufig verwendete Schnittstelle der IAP-Funktion (In-Application-Programmierung) zusammen, unterstützt die CRC32-Überprüfung und unterstützt Bootloader- und Anwendungs-Upgrades.

Protokoll ist kein Dateisystem erforderlich, Protokolle können direkt auf Flash gespeichert werden

Es ist ideal für kleine Produkte ohne Dateisysteme und erleichtert den Entwicklern es, die Ursachen für Systemabfälle oder -Abstürze schnell zu lokalisieren und zu finden. Gleichzeitig wird es mit EasyLogger verwendet (meine Open-Source-Bibliothek mit Hochleistungs-C-Protokollbibliothek, die eine nahtlose Schnittstelle mit EasyFlash bietet) und implementiert die Flash-Speicherfunktion von C-Protokollen einfach.

1.1 Zwei Env -Modi

Derzeit gibt es zwei Hauptmodi der Env -Funktion. Einer ist der NG -Modus, der auf V4.0 gebracht wurde, und der andere ist der Legacy -Modus, der V3.0 fortsetzt

1.1.1, NG -Modus in v4.0 eingeführt

Die entsprechende Quellcode -Datei lautet: ef_env.c

Seit dem Spring Festival im Jahr 2019 hat EasyFlash nach mehr als 4 Jahren Iteration endlich die V4.0 -Version veröffentlicht und mit den Bedürfnissen und Vorschlägen vieler Entwickler kombiniert. Die Env -Funktion in dieser Version heißt NG (Next Generation) -Modus. Dies ist eine komplett refaktorierte neue Version mit den folgenden neuen Funktionen:

Kleinere Ressourcenverbrauch, fast 0 Speicherverbrauch; (Frühere Versionen von v4.0 würden zusätzlichen RAM für Cache verwenden)
Der Werttyp von Env unterstützt jede Art und jede Länge, was einer direkten Memcpy -Variablen in Flash entspricht. (Vor V4.0 wurden nur Saiten unterstützt)
Die Effizienz des Env -Betriebs ist höher als die der früheren Modi, wodurch die verbleibenden Leerlaufbereiche voll ausgebildet werden, und die Anzahl der Verlöste und Betriebszeiten wird erheblich verringert.
Native Unterstützung für Verschleißbilanz und Stromversorgungsschutz (zusätzliche Blitzsektoren sind vor V4.0 erforderlich);
Env unterstützt inkrementelle Upgrades und Env unterstützt auch Upgrades nach Firmware -Upgrades.
Unterstützt den Big -Data -Speichermodus, die unbegrenzte Länge und die Daten können nacheinander in mehreren Flash -Sektoren gespeichert werden. Ressourcen wie Skriptprogramme und Audio, die mehr als einen Flash -Sektor belegen, können ebenfalls in Env gespeichert werden (sie werden bald in V4.2 unterstützt).
Unterstützt die Datenverschlüsselung , verbessert die Speichersicherheit und ist eine erforderliche Funktion im Internet der Dinge (wird bald in V4.3 unterstützt).
Unterstützt die Datenkomprimierung und reduziert die Flash -Nutzung (sie wird bald in V4.4 unterstützt).

V4.0 Design- und intern

Hinweis : Einige Blitze können nicht in umgekehrter Reihenfolge geschrieben werden, wie z. B. STM32L4 On-Chip-Blitz, sodass der NG-Modus nicht verwendet werden kann. In diesem Fall wird empfohlen, den Legacy -Modus von V3.0 zu verwenden.

1.1.2. Setzen Sie den Legacy -Modus von V3.0 fort

Die entsprechenden Quellcode -Dateien sind: ef_env_legacy.c und ef_env_legacy_wl.c

Der Legacy -Modus hat auch Verschleiß- und Power-Down-Schutzfunktionen. Im Vergleich zum V 4,0 -NG -Modus erfordert die Verwendung des Legacy -Modus einen zusätzlichen RAM -Speicherplatz, um jede Umgebung vorübergehend zu leiten, und rufen Sie schließlich die Speichernschnittstelle auf, löschen Sie die Sektoren einheitlich und speichern Sie sie dann auf Flash.

1.1.3 Env -Modusvergleich

	V4.0 ng Modus	V3.0 Legacy -Modus
Ressourcennutzung	Niedrig	hoch
Unterstützung von Flash umfassend	Einige Blitz sind eingeschränkt: zum Beispiel STM32L4-In-Chip	Umfassender
Ist die GC -Müllsammlung erforderlich?	GC ist erforderlich, wodurch die Schreibgeschwindigkeit verlangsamt, wenn GC ausgelöst wird	unnötig
Werttyplimit	Unbegrenzt	Es unterstützt bessere String -Typen
Schutzschutz	Unterstützung	Unterstützung
Verschleißbalance	Unterstützung	Unterstützung
Inkrementelles Upgrade	Unterstützung	Unterstützung

1.2. Ressourcenbeschäftigung

最低要求： ROM: 6K bytes     RAM: 0.1K bytes

1.3. Support -Plattform

Derzeit wurden die Hardware-Plattformen transplantiert, umfassen stm32f10x und stm32f4xx -Serie On-Chip-Flash und Off-Chip-SPI-Flash (basierend auf SFUD), die auch die Plattformen sind, die von den Produkten des Autors verwendet werden. Das Portieren anderer Plattformen ist nicht schwierig. Zu Beginn des Projektdesigns wurden Anpassungsfähigkeitsprobleme für alle Plattformen berücksichtigt (außer 64-Bit), sodass alle Portierungsschnittstellen reserviert wurden. Zum Port müssen Sie nur eine Datei easyflashportef_port.c ändern, um die Funktionen des Löschens, Schreibens, Lesens und Drucks zu verwirklichen.

Willkommen bei Fork and Pull Request (Github | Oschina | Codierung). Wenn Sie der Meinung sind, dass dieses Open -Source -Projekt großartig ist, können Sie in der oberen rechten Ecke der Projekt -Homepage auf Stern klicken und es mehr Freunden in Not empfehlen.

2. Prozess

2.1. Env: Umgebungsvariablen (KV -Datenbank)

Die folgende Abbildung ist eine gemeinsame Schnittstelle zum Aufrufen von Umgebungsvariablen über die Konsole (Terminal). Es zeigt den folgenden Vorgang, der alle direkten Aufrufe der Anwendungsschicht unterstützen.

1. Erstellen Sie eine Umgebungsvariable von "temp" mit dem Namen temp und weisen Sie einen Wert von 123 zu.
2. Speichern Sie die "Temperatur" in Blitz und starten Sie neu (jeder Betrieb in V4.0 wird automatisch gespeichert, nachdem sie abgeschlossen ist, und es ist kein zusätzlicher Einsparung erforderlich).
3.. Überprüfen Sie, ob die "Temperatur" erfolgreich gespeichert wurde;
4. Ändern Sie den "Temperatur" -Wert auf 456 und speichern und starten Sie sie neu;
5. Überprüfen Sie, ob die "Temperatur" erfolgreich geändert wurde;
6. Löschen Sie die Umgebungsvariable von "Temperatur".

easy_flash_env

2.2. IAP: Online -Upgrade

Die folgende Abbildung zeigt den Prozess der Aktualisierung der IAP -Software über die Konsole. Es verwendet die IAP -Funktionsschnittstelle, die mit der Bibliothek geliefert wird, und die Demonstration verwendet das serielle Port + -Modem -Protokoll. Sie können auch Remote -Netzwerk -Updates über CAN, 485, Ethernet und andere Busse realisieren.

easy_flash_iap

2.3. Protokoll: Protokollspeicher

Der folgende Vorgang besteht darin, das Protokoll über die Konsole auszugeben und das Ausgangsprotokoll in Flash zu speichern. Starten Sie das letzte gespeicherte Protokoll neu und löschen Sie das Flash -Protokoll schließlich.

easy_flash_log

3. Dokumentation

API -Dokumentation: docszhapi.md
Migrationsdokumentation: docszhport.md
V4.0 Migrationshandbuch: docszhv4_migrate.md
V4.0 Env -Funktion Design und Implementierung: docszhdesign.md

Verwenden Sie es unbedingt, nachdem Sie das Dokument gelesen haben .

4. Unterstützung

Unterstützung

Wenn EasyFlash Ihr Problem löst, können Sie den obigen QR -Code genauso gut scannen, um mich einzuladen , eine Tasse Kaffee zu trinken ~

5. Lizenz

Verwenden Sie das MIT Open Source -Protokoll. Bitte lesen Sie den Inhalt der Lizenzdatei im Projekt für Details.

1 Einführung

EasyFlash ist eine leichte Open -Source -Bibliothek für eingebettete Flash -Speicher. Es bietet eine bequeme Anwendungsschnittstelle für MCU (Micro -Steuereinheit). Die Entwickler können eine effizientere und gemeinsame Anwendungsentwicklung basierend auf dem Flash -Speicher erzielen. Die Bibliothek bietet derzeit drei nützliche Funktionen :

Env (Umgebungsvariablen) speichert schnell Produktparameter. Unterstützen Sie den Schreibbalance -Modus (Verschleiß -Leveling) und den Sicherungsschutz .

EasyFlash kann Einstellparameter oder Ausführungsprotokolle und andere Informationen speichern, die Sie nach dem Stromverbrauch aufbewahren möchten. Es enthält Methoden hinzufügen, löschen, ändern und abfragen. Es hilft Entwickler, die Produktparameter zu verarbeiten und sicherzustellen, dass das Produkt nach dem Upgrade eine bessere Skalierbarkeit hat. Verwandelt den Blitz in ein kleines NoSQL-Modell (nicht-relationale Datenbanken) und die Schlüsselwerbungspeicherdatenbank.

IAP : Online -Upgrade ist keine schwierige Sache mehr.

Die Bibliothek verkauft die gemeinsame Schnittstelle zwischen IAP (In-Application-Programmierung). Unterstützung von CRC32 -Prüfsumme. Unterstützung des Bootloader- und Anwendungs -Upgrades.

Protokoll : Die Protokolle können auf Product's Flash speichern, das kein Dateisystem enthält.

Es ist sehr geeignet für kleine ohne Dateisystemprodukte. Der Entwickler kann problemlos Probleme finden und abfragen, wenn das System abstürzt oder einfriert. Sie können EasyLogger (eine Super-Light-Gewicht-Hochleistungs-C-Protokollbibliothek, die Open Source von mir, verwenden. Sie bietet gleichzeitig eine nahtlose Schnittstelle mit EasyFlash). Es ist also so einfach, die Protokolle zum Blinken zu speichern.

1.1 Ressourcenverbrauch

 Minimum : ROM: 6K bytes     RAM: 0.2K bytes

1.2 unterstützte Plattformen

Die Hardware-Plattform wurde von SPI Flash, stm32f10x und stm32f4xx Serie von On-Chip-Flash-Serien portiert. Dies sind meine Produktplattformen. Die verbleibende Schwierigkeitsgrad der Plattformportierung ist gering. So ändern Sie es einfach easyflashportef_port.c -Datei. Implementieren Sie ERASE, Schreiben, Lesen, Druckfunktionen.

Begrüßen Sie alle, um eine Anfrage zu geben und zu ziehen (Github | Oschina | Codierung). Wenn Sie der Meinung sind, dass dieses Open -Source -Projekt fantastisch ist. Sie können den Stern in der oberen rechten Ecke der Projekt -Homepage drücken und weitere Freunde empfehlen.

2 Fluss

2.1 env (KV -Datenbank)

Die folgende Abbildung zeigt, dass die gemeinsame Schnittstelle eines Env von der Konsole (Terminal) aufgerufen wird. Diese Schnittstellen werden von der aufgerufenen Anwendungsschicht unterstützt.

1. Umgebungsvariable der Temperatur. Der Name ist temp und Wert ist 123 ;
2. Temperatur zum Blinken und Neustart;
3. Überprüfen Sie die Temperatur erfolgreich;
4. Wechseln Sie den Temperaturwert auf 456 und sparen Sie, starten Sie neu;
5. Überprüfen Sie die Temperatur erfolgreich;
6. Umgebungsvariable der Temperatur.

easy_flash_env

2.2 IAP

Die folgende Abbildung zeigt den Prozess der Upgrade von Software über die Konsole durch IAP. Diese Bibliothek wird mit der IAP -Funktionschnittstelle geliefert. Es verwendet einen seriellen Port + Ymodem -Protokollmodus. Sie können auch über CAN, 485, Ethernet -Bus zum Online -Upgrade erreicht werden.

easy_flash_iap

2.3 Protokoll

Die folgende Abbildung ist die Ausgabe des Protokollprozesses über die Konsole. Die Protokolle werden in Echtzeit auf Flash gespeichert. Dann wird das Board neu gestartet und die Protokolle zurück werden von Flash zurückgelesen. Endlich werden Protokolle gelöscht.

easy_flash_log