Espressif2Arduino

Used for bootstrapping the replacement of the default Espressif ESP8266 bootloader, replacing it with the Arduino bootloader and a custom rom.

This was designed specifically to replace the stock sonoff itead firmware by intercepting firmware update requests and serving these binary images. More info on how to intercept and stream this firmware to a device is here and here

The process works like this:

1. If Rom 1 is requested by the OTA update process Rom 1 is streamed back to the Espressif SDK which will flash to 0x1000 and reboot into this image. This image only has one job which is to simply request the Rom 2 image, save it into flash at 0x81000 and reboot into it.
2. If Rom 2 is requested by the OTA update process Rom 2 is streamed back to the Espressif SDK and will be saved into flash at 0x81000 and will then reboot.
3. Now both irrespective of route taken we will now be running Rom 2 at 0x81000. This allows us to replace all contents at 0x0->0x7FFF which includes the bootloader and the booted arduino image. Rom 2 simply requests the final image, saves it to 0x0 and then restarts.

Current Limitations:

• Currently only supports the ESP8266 with 1MB of flash and QIO Flash mode.
• To download the subsequent images WIFI is needed - currently this process tries to find the wifi credentials that the itead firmware has stored - alternatively hard-code your SSID and password.
• Could do with smarter logic before blowing away the bootloader on slot 1. Ideally it would only do this at the end of the process assuming everything flashed correctly (and checksums match). Currently it blows these away as soon as a valid HTTP response code and magic byte is received.

This is very much alpha quality at the moment, don't use this process on any devices you don't/can't manually flash if they don't boot.

Prereqs

1. Arduino IDE with Arduino SDK 2.3.0
2. Python 2.7 / 3.4
3. ESP Tool (pip install esptool)

Building

1. From the Arduino Folder replace boards.txt and the additional ld scripts into the appropriate place for your instance of Arduino.

2. Update OTA URLs:

   1. Espressif OTA Rom 1: Not needed
   2. URL_QIO_ROM_2*: Espressif2Arduino OTA Rom 2 (http://x.x.x.x/Espressif2Arduino.ino-0x81000.bin)
   3. URL_QIO_ROM_3*: Your new Arduino Build (http://x.x.x.x/sonoff.bin)

3. In Arduino IDE first select the Flash Size "1M (Espressif OTA Rom 1)" and build.

4. From your build directory run the following command and save the resulting output

   esptool.py elf2image --version 2  Espressif2Arduino.ino.elf

5. Repeat for Flash Size "1M (Espressif OTA Rom 2)"

You should now have three files ready for serving over HTTP:

• Rom 1 (Espressif2Arduino.ino-0x01000.bin)
• Rom 2 (Espressif2Arduino.ino-0x81000.bin)
• Arduino Build

Note there are also DIO URLs for the ESP8285, these can be left blank if only flashing ESP8266 devices

Flashing / Running

Although it is intended you would flash these images OTA you can simulate the process by directly flashing Espressif2Arduino onto the currently active Espressif rom slot.

1. First take a backup image of your flash by running

   esptool.py -p COM5 read_flash 0x0 0x100000 backup-0x00000.bin (note this is slow ~2 mins)

2. If rom 1 is active

   esptool.py -p COM5 -b 921600 write_flash 0x01000 Espressif2Arduino.ino-0x01000.bin

3. If rom 2 is active

   esptool.py -p COM5 -b 921600 write_flash 0x01000 Espressif2Arduino.ino-0x81000.bin

4. To restore your backup

   esptool.py -p COM5 -b 921600 write_flash 0x0 backup-0x00000.bin

Note - there is a bug with the ESP8266 that it will stay in flash mode the first reboot after flashing by serial. Best thing to do is to flash, then immediately pull power when finished and reboot it - with this code as standard you have 5 seconds before it will try update so you can pull power in this window without an issue.

Troubleshooting

GPIO 13 is used by default as a status indicator

• Slow flashing indicates waiting for 5 seconds at startup before completing actions (so you can connect a terminal)
• Slower Flashing indicates attempting to connecting to wifi
• Fast Flashing = Erasing/Flashing image

If you connect the serial port you should also see output like this:

Current rom: 2
Rom 1 magic byte: 0xEA
Reflashing rom: 1
Attemping to read Sonoff Wifi credentials... Done
    SSID: xxx
    Password: xxx
Connecting to Wifi..................Done
    192.168.1.19
Flash Mode: 3
Flashing rom 1 (retry:0): http://sunlocker.khc.net.nz/static/8266/sonoff-1024.bin
HTTP response Code: 200
HTTP response length: 483088
Magic byte from stream: 0xE9
Downloading 4096 byte bootloader..Done
Erasing flash sectors 1-128................................................Done
Downloading rom to 0x001000-0x075F10 in 1024 byte blocks...................Done
Erasing bootloader sector 0..Done
Writing bootloader to 0x000000-0x001000..Done