De ESP8266<\/h2>\n\n\n\n
De ESP8266 is een goedkope microprocessor met Wi-Fi mogelijkheid en een volledige TCP\/IP stack. De ESP8266 is ontwikkeld en wordt geproduceerd door de Chinese fabrikant Espressif Systems<\/a><\/em> uit Shanghai. Vanwege de early adoption door de Arduino community lag het voor de hand om deze krachtige microprocessor met de Arduino IDE te willen programmeren. In deze post probeer ik, stap voor stap, uit te leggen wat je moet doen om dit mogelijk te maken.<\/p>\n\n\n\n Download<\/a> en installeer de Arduino Integrated Development Environment (IDE) voor het Operating Systeem (OS) waar jouw DeskTop of LapTop computer (er zijn versies voor Windows, Linux en Mac) mee werkt. In onderstaand plaatje staat versie 1.8.7 maar over het algemeen kun je het beste de nieuwste (laatste) versie downloaden en installeren (ik heb geen ervaring met de Web Editor van Arduino, behalve dat hij de laatste keer dat ik ermee probeerde te werken geen ESP8266 (of ESP32) sketches kon compileren).<\/p>\n\n\n\n In de Arduino IDE moet bij \u201cInstellingen<\/em>\u201d de volgende URL worden ingevoerd achter \u201cAdditional Boards Manager URL\u2019s:<\/em>\u201d (zie rood omlijnde kader) [update: 28-07-2020] Lees vooral de uitleg in het README.md<\/a> bestand en de uitgebreide documentatie<\/a>!<\/p>\n\n\n\n Er kunnen meer additional board manager URL\u2019s worden ingevuld. Je moet ze dan achter elkaar zetten en scheiden door een komma (,). Ga nu naar [Tools] > [Board] > [Boards Manager]. Voer bij filter “esp8266<\/em>” in en selecteer de versie van de core die je wilt gaan gebruiken. De nieuwste versie is op dit moment 2.7.3<\/em>.<\/p>\n\n\n\n <\/p>\n\n\n\n E\u00e9n van de mooie eigenschappen van de ESP8266 is dat er flash geheugen in zit. Flash geheugen is geheugen dat zijn inhoud ook zonder spanning behoud. Vergelijk het met een SD-kaart. De flash geheugen is, afhankelijk van het bordje, 512kB tot 16MB(!) groot. Een deel van dit flash geheugen wordt gebruikt om jouw programma in op te slaan. Wat er over blijft kan als bestand-systeem worden ingericht (het zgn. SPI Flash File Systeem<\/em> \u2011SPIFFS\u2011).<\/p>\n\n\n\n Let op! SPIFFS is “depreciated” wat zoveel wil zeggen als: Wordt niet meer ondersteund en zal binnenkort niet meer beschikbaar zijn<\/em>! De plug-in haal je hier<\/a> vandaan. Ga naar deze github pagina en download het nieuwste bestand met de naam ESP8266FS-w.x.y.zip (op het moment van schrijven was dit versie 0.4.0).<\/p>\n\n\n\n .. en bewaar dit bestand op een plek die je straks weer terug kunt vinden.<\/p>\n\n\n\n Ga nu naar je \u201cSketch Location<\/em>\u201d map en maak daarin een nieuwe map \u201c Start de Arduino IDE opnieuw op. SPIFFS is “depreciated” en zal op enig moment niet meer beschikbaar zijn voor de ESP8266. Voor SPIFFS in de plaats komt het LittleFS dat wat meer mogelijkheden heeft. Om het LittleFS te kunnen gebruiken moet je een plugin installeren.<\/p>\n\n\n\n De plugin voor LittleFS kun je hier<\/a> downloaden (download de nieuwste versie die beschikbaar is).<\/p>\n\n\n\n Bewaar het zip bestand op een plek waar je hem straks terug kunt vinden en ga naar je \u201cSketch Location<\/em>\u201d map en maak daarin een nieuwe map \u201c Start de Arduino IDE opnieuw op. Met “LittleFS Data Upload<\/em>” kun je de bestanden die in de map “data<\/em>” staan naar het LittleFS van de ESP8266 uploaden (niet vergeten de Serial Monitor<\/em> eerst af te sluiten, anders krijg je een fout melding!).<\/p>\n\n\n\n Nu je een Arduino IDE hebt waarmee je ESP8266\u2019s kunt programmeren (flashen<\/em>) zul je ontdekken dat er door briljante mensen software is ontwikkeld die je kunt gebruiken om complexe projecten te realiseren, zonder dat je zelf het wiel hoeft uit te vinden.
Door de ge\u00efntegreerde WiFi mogelijkheid is deze microprocessor in korte tijd razend populair geworden. In eerste instantie omdat de chip werd gezien als een goedkope mogelijkheid om een Arduino bordje van WiFi te voorzien, maar al snel kwamen de echte nerds (and I say nerds<\/em> with the utmost respect) erachter dat de ingebouwde microprocessor en de hoeveelheid beschikbare (flash) geheugen de capaciteit en mogelijkheden van de Arduino bordjes verre overtrof.<\/p>\n\n\n\n
Even wat gegevens op een rij:<\/p>\n\n\n\n\n
\n
\f1) Download en installeer de Arduino IDE<\/h2>\n\n\n\n
![\"\"](\"https:\/\/willem.aandewiel.nl\/wp-content\/uploads\/2018\/09\/DownloadIDE.png\")
<\/a><\/figure><\/div>\n\n\n\n
Na het downloaden moet je het ontvangen bestand uitpakken (unzip of untar) en installeren. Dat installeren is per OS anders maar staat duidelijk op de website van Arduino aangegeven. Eenmaal ge\u00efnstalleerd kun je direct met de Arduino IDE aan de slag.<\/p>\n\n\n\n![\"\"](\"https:\/\/willem.aandewiel.nl\/wp-content\/uploads\/2018\/09\/FirstStartIDE.png\")
<\/a><\/figure><\/div>\n\n\n\n
Om de IDE met de ESP8266 microprocessor te kunnen gebruiken moeten we nog wat stappen uitvoeren.
<\/p>\n\n\n\n\n\n\n\n2) Installeer de \u201cArduino core for ESP8266 WiFi chip\u201d<\/h2>\n\n\n\n
http:\/\/arduino.esp8266.com\/stable\/package_esp8266com_index.json<\/s><\/code><\/p>\n\n\n\n
De URL werkt tegenwoordig alleen met een secure protocol!!
Verander “http:\/\/” in “https<\/strong>:\/\/”
https:\/\/arduino.esp8266.com\/stable\/package_esp8266com_index.json<\/strong><\/p>\n\n\n\n![\"\"](\"https:\/\/willem.aandewiel.nl\/wp-content\/uploads\/2018\/09\/Preferences.png\")
<\/a><\/figure><\/div>\n\n\n\n
Eventueel kun je ook het pad waar je projecten staan (de Sketchbook Location<\/em>) aanpassen. Standaard verwijst deze naar je \u201cDocumenten<\/em>\u201d map:C:\\Users\\<LogInNaam>\\Documents\\arduino\\<\/code>
.. en dat is een prima plek!
De andere instellingen kun je naar behoefte aanpassen. Hierboven staan de instellingen die ik prettig vind. Na het maken van aanpassingen klik je op [OK].<\/p>\n\n\n\n![\"\"](\"https:\/\/willem.aandewiel.nl\/wp-content\/uploads\/2018\/09\/BoardsManager_CoreESP8266.png\")
<\/a><\/figure><\/div>\n\n\n\n3) Een bestand-systeem op een chip<\/h2>\n\n\n\n
Het wordt vervangen door “LittleFS<\/em>“. Lees meer hierover aan het eind van dit hoofdstuk.<\/p>\n\n\n\n
Je kunt in je programma dit bestand-systeem niet alleen gebruiken om (bijvoorbeeld meet-) gegevens maar ook om de inhoud van, bijvoorbeeld, een web-pagina of een configuratie-bestand in op te slaan (index.html<\/code>).
Een index.html<\/code> maakt dan natuurlijk onderdeel uit van je programma maar deze ontwikkel je buiten de Arduino\u00a0IDE. Om het SPI File Systeem voor dit soort bestanden te kunnen gebruiken moet je een \u201cplug-in<\/em>\u201d in je Arduino Projecten map installeren.<\/p>\n\n\n\n![\"\"](\"https:\/\/willem.aandewiel.nl\/wp-content\/uploads\/2018\/09\/ESP8266FSDownload-1.png\")
<\/a><\/figure><\/div>\n\n\n\n![\"\"](\"https:\/\/willem.aandewiel.nl\/wp-content\/uploads\/2018\/09\/ESP8266FS_Save.png\")
<\/a><\/figure><\/div>\n\n\n\ntools<\/code>\u201d aan (als deze nog niet bestaat). Pak het zojuist ge-download-de zip bestand uit in deze tools map. Er wordt nu een aantal nieuwe mappen aangemaakt waar de plug-in wordt neergezet. Het pad ziet er ongeveer zo uit: <sketchbook location>\/tools\/ESP8266FS\/tool\/esp8266fs.jar<\/code><\/p>\n\n\n\n![\"\"](\"https:\/\/willem.aandewiel.nl\/wp-content\/uploads\/2018\/09\/Tools_Tree.png\")
<\/a><\/figure><\/div>\n\n\n\n
Onder [Tools] zie je nu een nieuwe optie: \u201cESP8266 Sketch Data Upload<\/em>\u201d<\/p>\n\n\n\n![\"\"](\"https:\/\/willem.aandewiel.nl\/wp-content\/uploads\/2018\/09\/ESP8266DownloadTool.png\")
<\/a><\/figure><\/div>\n\n\n\n
Je kunt nu in de map waar je programma staat een nieuwe map met de naam \u201cdata<\/code>\u201d maken. Alle bestanden die je vervolgens in deze map zet zullen met \u201cESP8266 Sketch Data Upload<\/em>\u201d op het SPIFFS bestand-systeem van je ESP8266 geplaatst worden (mits er voldoende ruimte is natuurlijk). In de selectie van je board moet je, behalve het juiste type board ook aangeven hoeveel ruimte van je Flash geheugen je wilt gebruiken voor het bestand-systeem (v\u00f3\u00f3rdat je je programma naar de ESP8266 upload!<\/em>). Normaliter zou je dit zo groot mogelijk willen maken, maar als je \u201cOver The Air<\/em>\u201d programma\u2019s op je ESP8266 wilt zetten (dus zonder fysieke verbinding maar via WiFi) dan moet je er rekening mee houden dat je twee maal<\/em> de grootte van je programma nodig hebt om dit te kunnen doen. Wat er overblijft kun je als bestand-systeem gebruiken.<\/p>\n\n\n\n![\"\"](\"https:\/\/willem.aandewiel.nl\/wp-content\/uploads\/2018\/09\/Board-Selectie.png\")
<\/a><\/figure><\/div>\n\n\n\n\f<\/h2>\n\n\n\n
Update (SPIFFS is “depreciated”)!<\/h2>\n\n\n\n
![\"\"](\"https:\/\/willem.aandewiel.nl\/wp-content\/uploads\/2021\/04\/DownloadLittFSUploadTool-1024x746.png\")
<\/a><\/figure><\/div>\n\n\n\ntools<\/code>\u201d aan (als deze nog niet bestaat). Pak het zojuist ge-download-de zip bestand uit in deze tools map. Er wordt nu een aantal nieuwe mappen aangemaakt waar de plug-in wordt neergezet. Het pad ziet er ongeveer zo uit:<\/p>\n\n\n\n<sketchbook location>\/tools\/ESP8266FS\/tool\/esp8266littlefs.jar<\/code><\/p>\n\n\n\n![\"\"](\"https:\/\/willem.aandewiel.nl\/wp-content\/uploads\/2021\/04\/toolsMap.png\")
<\/figure><\/div>\n\n\n\n
Onder [Tools] zie je nu een nieuwe optie: \u201cESP8266 LittleFS Data Upload<\/em>\u201d<\/p>\n\n\n\n![\"\"](\"https:\/\/willem.aandewiel.nl\/wp-content\/uploads\/2021\/04\/toolsMenu.png\")
<\/figure><\/div>\n\n\n\n4) Aanvullende Bibliotheken installeren<\/h2>\n\n\n\n
Deze software wordt veelal in de vorm van een bibliotheek aangeboden en je hoeft zo\u2019n bibliotheek alleen maar te installeren om er gebruik van te kunnen maken.
Bijvoorbeeld een bibliotheek om je ESP8266 van een telnet server<\/em> te voorzien (met een telnet server kun je via een telnet-client<\/em> op je DeskTop of LapTop inloggen op je ESP8266). Er blijken hier een aantal bibliotheken voor te bestaan. Als voorbeeld nemen we TelnetStream<\/em> van Juraj Andr\u00e1ssy. Na wat Googelen<\/em> vinden we de software op deze<\/a> github pagina. Juraj is erg summier met zijn uitleg maar gelukkig is er een map met voorbeelden (nou ja, \u00e9\u00e9n voorbeeld). Om de bibliotheek te installeren klik je op de groene download knop en selecteer je \u201cDownload ZIP\u201d.<\/p>\n\n\n\n![\"\"](\"https:\/\/willem.aandewiel.nl\/wp-content\/uploads\/2018\/09\/DownloadTelnet.png\")
<\/a><\/figure><\/div>\n\n\n\n
Onthou waar je het zip-file bewaard.
Ga nu naar de Arduino IDE en selecteer [Sketch > Include Library > Add .ZIP Library<\/em>]<\/p>\n\n\n\n![\"\"](\"https:\/\/willem.aandewiel.nl\/wp-content\/uploads\/2018\/09\/Add-ZIP-lib.png\")
<\/a><\/figure><\/div>\n\n\n\n
Er verschijnt een selectie window waar je het zojuist ge-download-de bestand selecteert.<\/p>\n\n\n\n
![\"\"](\"https:\/\/willem.aandewiel.nl\/wp-content\/uploads\/2018\/09\/Select-ZIP.png\")
<\/a><\/figure><\/div>\n\n\n\n![\"\"](\"https:\/\/willem.aandewiel.nl\/wp-content\/uploads\/2018\/09\/TelnetExample.png\")
<\/a><\/figure><\/div>\n\n\n\n![\"\"](\"https:\/\/willem.aandewiel.nl\/wp-content\/uploads\/2018\/09\/TelnetTestProg.png\")
<\/a>