{"id":1191,"date":"2018-10-01T21:19:42","date_gmt":"2018-10-01T20:19:42","guid":{"rendered":"http:\/\/EvertDekker.com\/?p=1191"},"modified":"2023-01-08T21:09:09","modified_gmt":"2023-01-08T20:09:09","slug":"esp32-jtag-debugger-with-sloeber","status":"publish","type":"post","link":"https:\/\/evertdekker.com\/wp\/?p=1191","title":{"rendered":"Esp32 jtag debugger with Sloeber"},"content":{"rendered":"
\n

This is a step by step instruction to setup\u00a0Sloeber<\/a> “The Eclipse Arduino Ide” with OpenOcd and a FTDI 2232HL as debugger. With this you can debug your Arduino sketch real time on an Espressif<\/a> ESP32 in circuit with jtag.<\/p>\n

As hardware for the debugger I used 2232HL board from Ali-express<\/a> , this one was around $14. However every board with a FTDI 2232hl will work.
\nThe 2232HL is a 3.3V device so don’t connect to 5V hardware or else the smoke will escape and the 2232HL will stop working.<\/p>\n

You need to connect it like this to your hardware:
\nAD0 – TCK (Gpio13)
\nAD1 – TDI (Gpio12)
\nAD2 – TDO (Gpio15)
\nAD3 – TMS (Gpio14)
\nGND – GND
\nOptional serial port:
\nCD0 – TXD (Gpio3)
\nCD1 – RXD (Gpio1)<\/p>\n

\"\"<\/a><\/p>\n

 <\/p>\n

Installing Sloeber \u201cThe Eclipse Arduino Ide”<\/h4>\n
    \n
  1. Download Sloeber<\/a><\/li>\n
  2. Extract the gz to the directory of your choice, in this tutorial we use c:\\sloeber<\/strong><\/li>\n
  3. Let\u2019s setup some basic stuff for Sloeber.<\/li>\n
  4. Arduino<\/strong> -> Preference<\/strong> -> platform and boards<\/strong><\/li>\n
  5. Check Arduino AVR boards<\/strong> and esp8266 2.4.2<\/strong> (or newer) both are not really necessary for the esp32, but it\u2019s nice to have some samples and libraries.<\/li>\n<\/ol>\n

     <\/p>\n

    Installing Esp32 Arduino and Sdk<\/h4>\n
      \n
    1. In Sloeber File<\/strong> -> Import<\/strong> -> Projects from git<\/strong> -> Clone URI<\/strong> and copy the url\u00a0 https:\/\/github.com\/espressif\/arduino-esp32.git<\/strong> in the URI field.<\/li>\n
    2. Press next<\/strong> and uncheck<\/strong> all the branches except master<\/strong>, press next<\/strong> again.<\/li>\n
    3. Change the directory to C:\\sloeber\\arduino-esp32<\/strong> and press next<\/strong> again.<\/li>\n
    4. Choose Import as general project<\/strong> and press next<\/strong> again.<\/li>\n
    5. Let\u2019s add it to the ide, Arduino<\/strong> -> Preferences<\/strong> -> Platforms and boards<\/strong><\/li>\n
    6. Press the new<\/strong> button next to the Private hardware path<\/em> and enter C:\\sloeber\\arduino-esp32<\/strong> in the path box.<\/li>\n
    7. Press Apply and close<\/strong><\/li>\n
    8. Now we need to download the Esp32 sdk, browse with windows to C:\\sloeber\\arduino-esp32\\tools<\/strong> and click on get.exe<\/strong><\/li>\n
    9. Done<\/li>\n<\/ol>\n

       <\/p>\n

      Replace the FTDI by Winusb driver<\/h4>\n
        \n
      1. Download Zadig<\/a> , no need to install just run it.<\/li>\n
      2. Click Options<\/strong> -> List All devices<\/strong><\/li>\n
      3. Choose in the dropdownbox USB <-> Serial Convertor (interface 0<\/span>)<\/strong>.Be careful here that you select the correct device.
        \n<\/strong><\/li>\n
      4. Choose the WinUSB (V6.1.xxxx.xxxxx)<\/strong> driver and press the Install driver<\/strong> button
        \nNote: <\/em>For some reason sometimes (win update?, other usb port) windows will roll back to the original FTDI driver and you have to do this again.<\/li>\n<\/ol>\n

         <\/p>\n

        Installing OpenOcd<\/h4>\n
          \n
        1. Download OpenOcd for the Esp32 from Github<\/a> (I have used 0.10.0 20180920 version)<\/li>\n
        2. Extract the content to C:\\Sloeber\\Openocd<\/strong><\/li>\n
        3. Download the cfg file<\/a> for the debugger and place it in C:\\sloeber\\openocd-esp32\\share\\openocd\\scripts\\interface\\ftdi
          \n<\/strong>Note: <\/em>this file is for the Ftdi 2232HL based debugger that I have. For other debugger look in the C:\\sloeber\\openocd-esp32\\share\\openocd\\scripts\\interface directory. This cfg file can work with other Ftdi based hardware, but I can\u2019t guaranty nor support that.
          \n          \"\"<\/a>
          \n<\/strong><\/li>\n
        4. Connect your debugger to the Esp32 hardware and let\u2019s see if it works by typing on the command line: C:\\sloeber\\openocd-esp32\\bin\\openocd.exe \u2013f c:\\sloeber\\openocd-esp32\\share\\openocd\\scripts\\interface\\ftdi\\quantum.cfg
          \n<\/strong><\/strong>          \"\"<\/a><\/li>\n
        5. If you get something as in the picture above with the \u201cdevice found \u2026..Tensilica<\/strong>\u201d in it you rock. The hardware and OpenOcd are working<\/li>\n<\/ol>\n

           <\/p>\n

          Setting up a new sketch<\/h4>\n
            \n
          1. Lets start a new project, Arduino<\/strong> -> new sketch<\/strong>, give the project a name and press next<\/strong><\/li>\n
          2. Platform holder c:\/sloeber\/arduino-esp32<\/strong> , fill in the rest with the board etc you have. Port is the comport your board is connected to, not the jtag. Press next
            \n<\/strong>            \"\"<\/a><\/li>\n
          3. Choose Sample sketch<\/strong> -> example<\/strong> -> 01.basics<\/strong> and check blink<\/strong>. Press finish
            \n<\/strong><\/li>\n
          4. We need to set some build options for the debugger, right click<\/strong> on your project map, Arduino<\/strong> -> tab compile options<\/strong> and enter in the append to C and C++<\/strong> field -ggdb -Og<\/strong>. These compiler options are not needed for a production version.<\/li>\n
          5. Let\u2019s compile, press Arduino<\/strong> -> verify<\/strong><\/li>\n
          6. And upload it to your board Arduino<\/strong> -> upload sketch<\/strong>. If you have a led connected to the pin as defined in the sketch is should blink now.<\/li>\n<\/ol>\n

             <\/p>\n

            Setting up the debugger in Sloeber<\/h4>\n
              \n
            1. Right click in the project explorer window on your project and choose Debug as<\/strong> -> Debug configurations.<\/strong><\/li>\n
            2. Choose GDB openOCD debugging<\/strong> and add a new configuration by clicking on the +<\/strong> at the left upper corner.<\/li>\n
            3. On the debugger tab check Start OpenOCD locally<\/strong><\/li>\n
            4. Executable path will be C:\\sloeber\\openocd-esp32\\bin\\openocd.exe<\/strong><\/li>\n
            5. GDB port: 3333<\/strong><\/li>\n
            6. Add to Config options\u00a0-s C:\\sloeber\\openocd-esp32\\share\\openocd\\scripts -f interface\\ftdi\\quantum.cfg -f target\\esp32.cfg -c “adapter_khz 3000”<\/strong><\/li>\n
            7. Check Start GDB session<\/strong><\/li>\n
            8. Executable name for the GDB client will be C:\\sloeber\\arduino-esp32\\tools\\xtensa-esp32-elf\\bin\\xtensa-esp32-elf-gdb.exe
              \n<\/strong>
              \n<\/strong><\/li>\n
            9. Select the Startup<\/strong> tab and set these settings<\/li>\n
            10. Check Initial reset<\/strong>, Type: init<\/strong><\/li>\n
            11. In the command box enter:
              \ntarget remote:3333<\/strong>
              \nmon reset halt<\/strong>
              \nx $a1=0<\/strong><\/li>\n
            12. Uncheck Enable ARM semihosting<\/strong><\/li>\n
            13. Check load symbols<\/strong>, use project binary should be already have your project name<\/li>\n
            14. Uncheck Load executable<\/strong>, debug in ram<\/strong>, Pre-run<\/strong>, Set program counter at (hex)<\/strong><\/li>\n
            15. Set the checkbox Set breakpoint<\/strong> at and fill in textbox loop<\/strong><\/li>\n
            16. Check Continue
              \n<\/strong>              \"\"<\/a>
              \n<\/strong><\/li>\n
            17. Press the Debug button and there you go<\/li>\n<\/ol>\n

              You can also program the ESP32 automatic with the jtag before debugging, add in the command box as described in step 61. below the target remote:3333 line
              \nmonitor program_esp32 c:\/users\/evert\/Documents\/sloeber-workspace\/Testesp32\/release\/Testesp32.bin 0x10000 verify <\/strong>
              \n<\/strong>Note<\/em>: <\/strong>It was not possible to use in the command box Eclipse variable like {project_loc}, this would be handy so you don’t have to change every project the hard coded path. These variable like {project_loc} contains backslash “\\” and GDB expects forward slash”\/”. I did\u00a0 a lot of Google reading but couldn’t find a solution, if you have one let me know.<\/p>\n

               <\/p>\n

              How to use it?<\/h4>\n

              It’s a bit out of scope of this tutorial how to describe full the debug function in Sloeber. Because Sloeber is based on Eclipse there is enough videos etc available to help you out.
              \nTo start a debug session you have to Right click your project<\/strong> -> Debug As<\/strong> -> Debug configuration<\/strong> and press debug<\/strong>. Sloeber will then switch to the debug perspective
              \nAs a quick reference have a look at this:<\/p>\n

                \n
              1. Program code window, program is paused at loop(), this because we set this in step 65.<\/li>\n
              2. Thread window, here you can see all the threads that are running on the Esp32.<\/li>\n
              3. Control buttons, with these you can start, pause, stop and step in various ways trough your code.<\/li>\n
              4. Perspective view, you can switch between code and debug perspective<\/li>\n
              5. Various windows to see and influence variable, breakpoints etc. Peripherals is unfortunately not working yet.<\/li>\n
              6. Some more windows here, cpu registers and Serial monitor view are the most used.<\/li>\n<\/ol>\n

                \"\"<\/a><\/p>\n

                 <\/p>\n

                Note:<\/strong> If you copy the settings direct from this page watch out that punctuation marks\u00a0 like “<\/strong> and ‘<\/strong> are not copied correct (they have an other, wrong ascii value) and will give problems or error’s. Just retype them and it should work fine.<\/p>\n","protected":false},"excerpt":{"rendered":"

                This is a step by step instruction to setup\u00a0Sloeber “The Eclipse Arduino Ide” with OpenOcd and a FTDI 2232HL as debugger. With this you can debug your Arduino sketch real time on an Espressif ESP32 in circuit with jtag. As hardware for the debugger I used 2232HL board from Ali-express , this one was around […]<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[192],"tags":[196,157,197,194,195,193],"class_list":["post-1191","post","type-post","status-publish","format-standard","hentry","category-arduino","tag-eclipse","tag-esp32","tag-ftdi-2232hl","tag-jtag-debugger","tag-openocd","tag-sloeber"],"_links":{"self":[{"href":"https:\/\/evertdekker.com\/wp\/index.php?rest_route=\/wp\/v2\/posts\/1191","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/evertdekker.com\/wp\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/evertdekker.com\/wp\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/evertdekker.com\/wp\/index.php?rest_route=\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/evertdekker.com\/wp\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=1191"}],"version-history":[{"count":84,"href":"https:\/\/evertdekker.com\/wp\/index.php?rest_route=\/wp\/v2\/posts\/1191\/revisions"}],"predecessor-version":[{"id":1917,"href":"https:\/\/evertdekker.com\/wp\/index.php?rest_route=\/wp\/v2\/posts\/1191\/revisions\/1917"}],"wp:attachment":[{"href":"https:\/\/evertdekker.com\/wp\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=1191"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/evertdekker.com\/wp\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=1191"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/evertdekker.com\/wp\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=1191"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}