{"id":4139,"date":"2018-10-08T10:37:08","date_gmt":"2018-10-08T17:37:08","guid":{"rendered":"https:\/\/visualgdb.com\/w\/?p=4139"},"modified":"2018-10-08T10:37:08","modified_gmt":"2018-10-08T17:37:08","slug":"developing-esp32-arduino-projects-with-visual-studio","status":"publish","type":"post","link":"https:\/\/visualgdb.com\/tutorials\/arduino\/esp32\/","title":{"rendered":"Developing ESP32 Arduino Projects with Visual Studio"},"content":{"rendered":"

This tutorial shows how to develop and debug Arduino projects for the ESP32-based boards using Visual Studio and the Advanced Arduino Project Subsystem of VisualGDB.\u00a0We will create a basic “Blinking LED” project for the SparkFun ESP32 Thing board and will show how\u00a0to navigate the code and debug the project.<\/p>\n

Before you begin, install VisualGDB 5.4 Preview 4 or later.<\/p>\n

    \n
  1. Start Visual Studio and open the VisualGDB Arduino Project Wizard:\"01-newprj\"<\/a><\/li>\n
  2. Proceed with the default “Blinking LED” project:
    \n    \"02-blink\"<\/a><\/li>\n
  3. On the next page select your ESP32 board. If you don’t see your board in the list, select any other ESP32-based board and click “Install” to automatically get the ESP32 Arduino core along with an up-to-date board list:\"03-sparkfun\"<\/a><\/li>\n
  4. Once you selected your board, connect it to the USB port and pick the COM\u00a0corresponding to it below:\"04-comport\"<\/a><\/li>\n
  5. Debugging ESP32 boards requires a JTAG debugger (e.g. Olimex ARM-USB-OCD-H or Segger J-Link). You can find detailed board-specific wiring instructions in our ESP32 tutorials <\/a>\u00a0(see\u00a0 this tutorial<\/a> for SparkFun ESP32 Thing instructions).\u00a0Connect your debugger to the board and plug it into the USB port. Select it in the “USB Devices” view to automatically configure it for debugging:
    \n    \"05-jlink\"<\/a><\/li>\n
  6. Press “Finish” to generate the project. VisualGDB will generate an Advanced Arduino Project including both a basic sketch and the ESP32 Arduino core. Build it via Ctrl-Shift-B:\"06-build\"<\/a>Note that the build is done using the Arduino builder tool, so the result will be the same as\u00a0when using the Arduino IDE. VisualGDB also queries the\u00a0detailed code model from the Arduino builder that allows\u00a0displaying the precise list of source files used by the project and various libraries, and also configures IntelliSense to see the code exactly as the compiler does.<\/li>\n
  7. Once the project is built, press F5 to start debugging it:\"07-program\"<\/a>VisualGDB will automatically program the\u00a0FLASH memory and begin running the project. The on-board LED will start blinking as expected.<\/li>\n
  8. Set a breakpoint inside the loop() function and wait for it to trigger:\"08-stop\"<\/a>Once the breakpoint triggers, you will be able to debug\u00a0the code as any other Visual Studio project.<\/li>\n
  9. VisualGDB will automatically disable optimization when compiling the sketch (but not the platform or the libraries) when building the debug configuration, to ensure the best debugging experience.\u00a0You can alter this behavior via the first page of VisualGDB Project Properties:\"optim\"<\/a><\/li>\n
  10. As VisualGDB indexes all the source files used by the project, you can use commands like Go To Definition, Peek Definition, Code Map, etc. to easily explore the\u00a0code of your sketches, the Arduino core and the related libraries:\"09-def\"<\/a><\/li>\n
  11. Now we will show how to use the Arduino API for the serial port. Include the <HardwareSerial.h> file from your sketch:\"10-serial\"<\/a>Note how VisualGDB shows the header files of available libraries with a special package icon. Including those header\u00a0files will automatically reference the corresponding libraries once you save the sketch file.<\/li>\n
  12. Replace the contents of your sketch file with the following code:\n
    #include <HardwareSerial.h>\r\n\r\nvoid setup()\r\n{\r\n    pinMode(LED_BUILTIN, OUTPUT);\r\n    Serial.begin(115200);\r\n}\r\n\r\nint g_Iter = 0;\r\n\r\nvoid loop()\r\n{\r\n    digitalWrite(LED_BUILTIN, HIGH);\r\n    delay(1000);\r\n    digitalWrite(LED_BUILTIN, LOW);\r\n    delay(1000);\r\n \r\n    char tmp[32];\r\n    sprintf(tmp, \"Iteration %d\\r\\n\", g_Iter++);\r\n    Serial.write(tmp);\r\n}<\/pre>\n
    Then build your project by pressing Ctrl-Shift-B:\"11-build\"<\/a><\/li>\n
  13. Open VisualGDB Project Properties and go to the Arduino Serial Terminal page. Enable the serial terminal and ensure that the baud rate matches the\u00a0one\u00a0configured in the sketch file:\"12-terminal\"<\/a><\/li>\n
  14. Press F5 to begin debugging. Now you will see the\u00a0output from the Serial<\/strong> API\u00a0in the terminal pane inside Visual Studio:\"13-output\"<\/a><\/li>\n
  15. You can set breakpoints and step through your code as usual. Since the debugging is done via the JTAG interface, it will not interfere with the serial port output:\"14-bkpt\"<\/a><\/li>\n
  16. You can also program the FLASH memory without debugging and open the serial terminal via the context menu in Solution Explorer:\"15-program\"<\/a><\/li>\n
  17. If you encounter problems programming the FLASH memory using OpenOCD, select “Program FLASH using Arduino tools” on the Debug Settings page of VisualGDB Project Properties.\u00a0This will configure VisualGDB to\u00a0program the FLASH memory using esptool.py and the ESP32 bootloader instead of the OpenOCD FLASH programming logic:\"16-tools\"<\/a><\/li>\n
  18. Run the View->Embedded Memory Explorer command to see an overview of memory utilization for your ESP32 board:\"17-eme\"<\/a><\/li>\n
  19. Click “explore details” to view the detailed information about each function, method and global variable and also highlight their sizes and the memory type where they are placed directly in the code: \"18-memories\"<\/a><\/li>\n<\/ol>\n","protected":false},"excerpt":{"rendered":"
    This tutorial shows how to develop and debug Arduino projects for the ESP32-based boards using Visual Studio and the Advanced<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[169],"tags":[170,138],"_links":{"self":[{"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts\/4139"}],"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=4139"}],"version-history":[{"count":3,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts\/4139\/revisions"}],"predecessor-version":[{"id":8915,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts\/4139\/revisions\/8915"}],"wp:attachment":[{"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/media?parent=4139"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/categories?post=4139"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/tags?post=4139"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}