{"id":3418,"date":"2017-10-17T19:52:45","date_gmt":"2017-10-18T02:52:45","guid":{"rendered":"https:\/\/visualgdb.com\/w\/?p=3418"},"modified":"2020-04-03T11:45:17","modified_gmt":"2020-04-03T18:45:17","slug":"developing-firmware-for-the-esp-wroom-32-module","status":"publish","type":"post","link":"https:\/\/visualgdb.com\/tutorials\/esp32\/wroom\/","title":{"rendered":"Developing Firmware for the ESP-WROOM-32 Module"},"content":{"rendered":"

This tutorial shows how to develop and debug a simple WiFi HTTP server for the ESP-WROOM-32 module using Visual Studio and VisualGDB. Before you begin, install VisualGDB 5.3 or later.<\/p>\n

Warning: The MSBuild-based ESP32 projects are deprecated since VisualGDB 5.4. Please use the Advanced ESP-IDF Project Subsystem<\/a>\u00a0instead. The rest of the steps shown in this tutorial will still work.<\/strong><\/p>\n

In order to debug the ESP-WROOM-32 module over JTAG, you will need to use an external stabilized 3.3V power supply and a JTAG debugger (e.g. Olimex ARM-USB-OCD-H) and connect it to certain pins of the ESP-WROOM-32 module. The table below shows the relevant pins:<\/p>\n\n\n\n\n\n\n\n\n\n\n
ESP32 signal<\/td>\nESP-WROOM-32 signal<\/td>\nJTAG signal<\/td>\nJTAG20 pin<\/td>\n<\/tr>\n
+3.3V<\/td>\n3V3<\/td>\nVCC<\/td>\n1<\/td>\n<\/tr>\n
CHIP_PU<\/td>\nEN<\/td>\nSRST<\/td>\n3<\/td>\n<\/tr>\n
GND<\/td>\nGND<\/td>\nGND<\/td>\n4<\/td>\n<\/tr>\n
MTDI<\/td>\nGPIO12<\/td>\nTDI<\/td>\n5<\/td>\n<\/tr>\n
MTMS<\/td>\nGPIO14<\/td>\nTMS<\/td>\n7<\/td>\n<\/tr>\n
MTCK<\/td>\nGPIO13<\/td>\nTCK<\/td>\n9<\/td>\n<\/tr>\n
MTDO<\/td>\nGPIO15<\/td>\nTDO<\/td>\n13<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

See ESP-WROOM-32 schematics<\/a> for more details.<\/p>\n

You can use a breadboard to easily connect the relevant signals to a JTAG cable as shown below:\"wroom\"<\/a><\/p>\n

Warning! Be careful not to short-circuit nearby signals and double-check everything with a multimeter. Also note that confusing +3.3V and ground may instantly burn your ESP-WROOM-32!<\/strong><\/p>\n

The final setup of the ESP-WROOM-32 and a JTAG debugger would look as shown below:\"2boards\"<\/a><\/p>\n

Once the wiring is configured, you can proceed with creating and testing out a basic project.<\/p>\n

Note:\u00a0VisualGDB 5.4 supports the new advanced ESP-IDF project subsystem that\u00a0delivers better development experience than MSBuild-projects shown in this tutorial. Once you get basic debugging to work, follow this tutorial<\/a> to get started with the new advanced ESP-IDF project subsystem.<\/p>\n

    \n
  1. Start Visual Studio and open the VisualGDB Embedded Project Wizard:\"01-newprj\"<\/a><\/li>\n
  2. Proceed with the default “New Project->MSBuild” setting:\"02-msbuild\"<\/a><\/li>\n
  3. Select the ESP32 toolchain and the regular ESP32 device:\"03-esp32\"<\/a><\/li>\n
  4. As we have not soldered any LEDs on the board, we will proceed directly with the Wi-Fi example. Select “HTTP Server” and proceed with the default configuration:\"04-server\"<\/a><\/li>\n
  5. Connect your JTAG debugger to USB and select it in the “Debug Using” field. VisualGDB should automatically detect supported JTAG programmers and install the necessary drivers:\"05-dbgconf\"<\/a><\/li>\n
  6. Click “Test” to check the connection. If you see errors like “scan chain interrogation failed”, double-check your wiring and power:\"06-test\"<\/a><\/li>\n
  7. Press “Finish” to create the project and build it via Ctrl-Shift-B:\"07-build\"<\/a><\/li>\n
  8. Set a breakpoint in the ServerTask() function and press F5 to begin debugging:\"08-flash\"<\/a><\/li>\n
  9. VisualGDB will program the FLASH memory in the ESP-WROOM-32 module and start debugging. The breakpoint will hit: \"09-hit\"<\/a><\/li>\n
  10. \u00a0Press F5 to continue debugging. Then locate the ESP32_VisualGDB Wi-Fi network from your device:\"09-wifi\"<\/a><\/li>\n
  11. Once the connection is successful, open 192.168.<subnet>.1<\/strong> in your browser:\"10-page\"<\/a><\/li>\n<\/ol>\n

    Congratulations! Now you customize the example to add your custom logic on top of it or explore one of the advanced samples provided by the ESP-IDF project subsystem<\/a>. You can use all other GPIO pins on the ESP-WROOM-32 module to control your peripherals as long as you reserve the MTDI, MTDO, MTMS and MTCK pins for JTAG.<\/p>\n","protected":false},"excerpt":{"rendered":"

    This tutorial shows how to develop and debug a simple WiFi HTTP server for the ESP-WROOM-32 module using Visual Studio<\/p>\n","protected":false},"author":1,"featured_media":3433,"comment_status":"closed","ping_status":"closed","sticky":true,"template":"","format":"standard","meta":{"footnotes":""},"categories":[142],"tags":[138,101],"_links":{"self":[{"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts\/3418"}],"collection":[{"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/comments?post=3418"}],"version-history":[{"count":4,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts\/3418\/revisions"}],"predecessor-version":[{"id":5885,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts\/3418\/revisions\/5885"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/media\/3433"}],"wp:attachment":[{"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/media?parent=3418"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/categories?post=3418"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/tags?post=3418"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}