MakerFabs WiFi Flashing for DCC-EX.md

Intro

Out of the box, the MakerFabs ESP8266 shield appears to be shipping with a broken firmware that is unstable when used with DCC-EX. I needed to flash version 1.7.4 onto the board. Here's how I did it - hopefully it works for you.

Requirements

• The WiFi Shield itself - https://www.makerfabs.com/esp8266-wifi-shield.html
• USB to TTL adapter - https://www.amazon.com/gp/product/B07D6LLX19/
• 4x female to female jumper wires
• 1x male to male jumper wire
• The flash download tool and firmware files from DCC-EX - https://dcc-ex.com/download/esp8266.html
• A Windows PC

How To

Step 1 - Set up the download tool

1. Extract both the download tool and firmware files zips
2. Open the download tool, select "Developer Mode", then "ESP8266 DownloadTool".
3. Ensure all these settings in the screenshow are set. Take special note of the files and the offset number next to them.
4. Ensure all five files are green - enable the checkbox next to each file after setting it.
5. Ensure the COM port is set to that of your adapter (You can find this in device manager after plugging it in and installing drivers).
6. Leave the window open, but DO NOT PRESS START YET.

Step 2 - Connect the Jumper Wires

Assuming you're using a similar adapter to the one I linked to above:

1. Connect one jumper wire from the "+5V" pin on the adapter to the underside of the "5V" pin on the WiFi shield
2. Connect one jumper wire from the "GND" pin on the adapter to the underside of the "GND" pin on the WiFi shield
3. Connect one jumper wire from the "RXD" pin on the adapter to one of the "ESP_TX" pins on the top of the WiFi shield
4. Connect one jumper wire from the "TXD" pin on the adapter to one of the "ESP_RX" pins on the top of the WiFi shield

Your connections should look like this:

Step 3 - Plug in the adapter.

The adapter should be unplugged from the USB port at this stage.

1. Connect one end of the the male-to-male jumper to the top of the "GND" pin on the WiFi shield.
2. Hold the other end of the male-to-male jumper onto the GPIO0 pin on the ESP-12F. (Note: The GPIO0 pin is the fourth pin from the bottom on the right, next to the "P" in "ESP-12F". See picture below.
3. KEEP HOLDING THE JUMPER ON THE PIN
4. Plug the adapter into a free USB port on your PC
5. KEEP HOLDING THE JUMPER ON THE PIN

Step 4 - Start the flashing

1. KEEP HOLDING THE JUMPER ON THE PIN
2. Return to the download tool.
3. Press start.
4. KEEP HOLDING THE JUMPER ON THE PIN
5. Wait until the green box in the tool says "FINISH".
6. You can let go of the jumper now. :)

If you get an error, unplug the adapter, plug it back in, and press Start again. It can take a couple of tries. BUT KEEP HOLDING THE JUMPER ON THE PIN.

If at any point you let go of the jumper, unplug the adapter from the USB port, place the jumper back on the pin, and plug it back in, then click Start again. Remember to keep holding it.

When finished, it should look like this.

Step 5 - Use the WiFi shield

You should now be able to unplug the WiFi shield, place it onto your DCC-EX setup, and if all went well it should work.

Had no luck with version 3.8.5 of the tool at all and kept failing with an EFUSE. Downloaded version 2.3. (link in DCC EX article). Deleted the config file that came with it (this caught me out) and to be on the safe side copied the files into the same directory I ran the tool from.

Prefect.. ran straight trough no problems, had a second board so repeated the process and again success. Happy as I had spent several hours with version 3 of the tool going no where.

Installed back on Arduino stack and checked.. Back leveled to 1.7.4.

Final part or the console output below.

Hope this helps

Panel1\blank.bin
offset : 2088960
Erasing flash...
head: 1 ;total: 1
erase size : 4096
Writing at 0x00000c00... (0 %)
Leaving...
Erasing flash...
head: 15 ;total: 101
erase size : 352256
Writing at 0x00065c00... (97 %)
Leaving...
Erasing flash...
head: 1 ;total: 1
erase size : 4096
Writing at 0x000fec00... (98 %)
Leaving...
Erasing flash...
head: 1 ;total: 1
erase size : 4096
Writing at 0x001fc000... (98 %)
Leaving...
Erasing flash...
head: 1 ;total: 1
erase size : 4096
Writing at 0x001fec00... (99 %)
Leaving...
com closed

I have downloaded the download tool and firmware. I can also see the four .bin files that dem368 describes in his comments, but I'm lost in the details and explanation on attaching the files to the download tool.

Right click on the 3 dots (•••) to the left of @.
then chose the file. You need to do each on individually.
add the correct addressing nest to each file and then tick each box on the right. They should go greening the paths correct.

I was able to attach all of the bin files and correct addressing nests. I did a couple of starts but finally got a "Finish". I reinstalled the installer and device monitor shows AT Version:1.7.4.0 May 11 2020 19:13. Setup Wi-Fi as stand along network. Before updating firmware, network ID was showing DCEX_433bd3 and connected fine on my Android phone, but now shows DCCEX_f343b4 and shows a connected without internet message. Any suggestions?

If your running in AP mode then there will be no internet connection as you connect your phone directly to the WiFi of the stack. I must be honest I didn’t notice if the MAC address of the WiFi changed after flashing but if it has the default password to connect will also have changed as it is made up of the last 6 characters of the MAC address. Check the he SCC EX documentation I think it tells you there. Also prior to back levelling the firmware I could not get it to connect to my own WiFi network. The IP address would not change. It will now and it all works fine. Check example.config.h or config.h if you have one as these affect how the WiFi connects. Sorry if I’m teaching you how to suck eggs.

I had trouble getting this to work. Tried both versions of the installer and seemed to have more luck with version 2.3. I wasn't able to get anything to work with the adapter until I found a driver and installed it for the adapter, afterwards the adapter would light up while running the installer, but still popped up with an error. Pictures on the setup are attached below.