Updates README.md with example

README.md

@@ -1,17 +1,48 @@
 # Especially Flasher
 
-__Especially Flasher_ is a tool to get JavaScript running natively on 
-the Internet of Things device, ESP8266. This application runs on 
+__Especially Flasher_ is a tool to get JavaScript running natively on
+the Internet of Things device, ESP8266. This application runs on
 Windows, Mac OS X and Linux.
 
 This tool flashes (installs) the Espruino JavaScript run time on ESP8266
 EP-12 devices like the Adafruit Huzzah and Adadfruit Feather Huzzah.
 
+
+## ROM Communication
+The ESP8266 is notoriously finicky about being flashed, we've done our best to abstract that for you.
+
+Here is an example of flashing the ESP8266 with the latest Espruino build.
+
+```javascript
+const log = require("./logger");
+
+const esp = new RomComm({
+    portName: "/dev/cu.SLAB_USBtoUART",
+    baudRate: 115200,
+});
+
+esp.open().then((result) => {
+    log.info("ESP is open", result);
+    esp.flashAddressFromFile(0x0000, "/path/to/binaries/boot_v1.4(b1).bin")
+        .then((result) => esp.flashAddressFromFile(0x1000, "/path/to/binaries/espruino_esp8266_user1.bin"))
+        .then((result) => esp.flashAddressFromFile(0x3FC000, "/path/to/binaries/esp_init_data_default.bin"))
+        .then((result) => esp.flashAddressFromFile(0x3FE000, "/path/to/binaries/blank.bin"))
+        .then((result) => esp.close())
+        .then((result) => log.info("Flashed to latest Espruino build!", result));
+}).catch((error) => {
+    log.error("Damnit!", error);
+});
+```
+
+See also `RomComm.flashAddress` for passing just a buffer representation of the file.
+
+We are using [Bunyan](https://github.com/trentm/node-bunyan) for logging, make sure to pipe it through the parser.
+
 -------
 
-## Contributing 
+## Contributing
 
-If you want to contribute to the Especially Flasher clone this repo and 
+If you want to contribute to the Especially Flasher clone this repo and
  run the following commands.
 
 ```bash

back-end/rom_comm.js

@@ -119,8 +119,11 @@ class RomComm {
     }
 
     close() {
-        // TODO: Remove from boot loader
-        this._port.close();
+        return this.flashAddress(0, 0)
+            .then((result) => this.flashFinish(false))
+            .then((result) => this._port.close((err) => {
+                this.isInBootLoader = false;
+            }));
     }
 
     calculateChecksum(data) {
@@ -336,7 +339,7 @@ class RomComm {
                         resolve(response);
                     });
                 } else {
-                    log.info("Someone is already awaiting", commandName);
+                    log.warn("Someone is already awaiting for %s", commandName);
                 }
             }
         });