ESP8266 File System

-

While I still try to get my head around the two different DNS servers I thought it was about time to write another tutorial. In this tutorial I'm going to discuss the use of the Serial Peripheral Interface Flash File System (SPIFFS). This handy library lets you store files on the flash memory of the device. So instead of having to construct a HTML string as a response to a request we can serve up a standard web page.

To use SPIFFS you need to include the file "fs.h" at the top of the program and in the setup function you need to start the SPIFFS library using the 'begin' function. This initialises the library and allows you to access any files that are contained within the flash memory. For the purpose of debugging I tend to loop through the file system to list all the files contained on the device. The following lines of code retrieve a reference to the directory structure and then outputs all the files names to the serial port.
Finally we need to put this file system to use. The web server library is able to serve web pages directly from the file system rather than having to construct a new response each time. In this case we instruct the web server to respond to a root request with the index.html page directly from SPIFFS. Using this method you can write a web page in sensible editor, test it in your browser all without ever having to connect to the ESP device.
Here the complete code for a simple web page server, the next issue is how to get the files onto the device in the first place.
ESP8266FS is a tool that can be used to create file system images and upload them to the ESP device. It integrates with the Arduino IDE so it's easy to use. To install the tool you simply create a folder called 'Tools' in your arduino sketchbook directory, and unpack the zipped file into it.


Now when you open the Arduino IDE there should be an additional option in the 'Tools' menu system. ESP8266 Sketch Data Upload. If you create a folder called 'Data' next to your arduino sketch, then the tool will convert any files in that folder, into an image and send them to the file system on the device.


Popular posts from this blog

Wiring the Ruida Controller

-
Image
The RDC6442G controller from Ruida This is going to be quite an image heavy post describing the rewiring needed to convert between the Leetro controller and the Ruida controller. It is also pretty straight forward on the old Just Add Sharks laser cutters because all of the wires are clearly labelled. The controller was prepared in the previous step in order to make this conversion process as smooth as possible. The Leetro (Pad03) panel on the left and the Ruida panel on the right The view from inside the laser looking up at the control panel The control panel is an easy place to start, both panels have just a single cable that runs down to the controller, both panels are a very similar size, with the Ruida panel being slightly smaller underneath so it will fit in the hole left behind easily. The Pad03 panel clips into place so you'll need to reach up inside the machine to work the clips loose. The cable runs down the inside of the laser and is cable tied onto mounti
Read more

Rainbow Puzzle Box

-
Image
This is a binary sequence puzzle box built from 3mm birch plywood, it uses a Gray code pattern to ultimately align all the dials into a rainbow pattern before the lid can be removed. It's actually a redesign of a puzzle inside Loki's box of Tricks  because I thought it would make a cool stand alone puzzle box. The files are available for sale in my Etsy store . ( svg here ) The puzzle consists of five interlocking disks that can only rotate when the disks either side of it are in the correct position to allow it. The large wheel in the middle and the disks on the underside of the lid further restrict the rotation of the disks. The large wheel must be pointed to the disk that is being rotated and the large wheel is in turn restricted from pointing to the smaller disks depending on alignment. Once all the disks are aligned into the full rainbow the large wheel is completely free to rotate and can be turned to the edge of the box and allows the lid to be removed. There is a very
Read more

Laser Cut Cryptex

-
Image
This is my laser cut cryptex. It features 28 different characters and 9 rings, giving a total possible 10.5 Trillion different combinations. I took a bit of time developing the design so that I could add some nice features. This cryptex file is laid out so that you can have any number of rings in your own design. The best feature is that the codeword is changeable, each locking ring has an outer letter ring that can be placed in any one of the 28 different positions. Once the rings are back in place the ring locking bars can added and they prevent the rings from being modified until the box is open again. It's a bit hard to explain so I made a video showing how it all work ( svg here ) It took a long time to assemble this so I lived with my initial design choices but if I were to remake it I would adjust the file to make the ring locking bars out of 6mm ply and maybe put some blind holes onto the code rings to prevent the code being brute forced.
Read more