[{"_1":2,"_155":-5,"_156":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_134":135},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11,"_20":11},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_23":24,"_25":-5,"_26":11,"_27":11,"_28":29,"_30":31,"_32":-5,"_33":11,"_34":35,"_84":-5,"_85":86,"_125":-5,"_126":11,"_127":17,"_128":11,"_129":-5,"_130":11,"_131":-5,"_132":133},"canonicalUrl","https://hub.docker.com/r/zfields/particle-dbg/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","zfields","reponame","particle-dbg","cloudBuildSource","isAutobuildsAvailable","repo",{"_36":37,"_38":39,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":51,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":70,"_75":11,"_76":77,"_81":29,"_82":83},"categories",[],"content_types",[40],"image","date_registered","2019-01-08T04:16:35.979857Z","description","A container supporting Particle firmware debugging.","is_private","last_updated","2019-05-08T14:16:30.309125Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[52],"application/vnd.docker.container.image.v1+json","name","pull_count",1060,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","## Docker debug container\n\nThe Docker debug container will execute `arm-none-eabi-gdb`, and any parameters you pass behind it will be passed directly to `arm-none-eabi-gdb`. Before a device can be debugged, it will need to be in DFU mode _(blinking yellow)_.\n\n> _**NOTE:** The configuration shown below will allow you to debug Particle firmware using the [Particle Debugger](https://store.particle.io/products/particle-debugger) or [Programmer Shield](https://store.particle.io/products/prog-shield)._\n\n### Debugging Particle firmware\n\n```bash\ndocker run --interactive --mount type=bind,source=,target=/particle-iot/device-os --mount type=bind,source=,target=/particle-iot/app --privileged --rm --tty zfields/particle-dbg --directory /usr/local/lib/gcc-arm-none-eabi-5_3-2016q1/arm-none-eabi/include/c++/5.3.1/bits --directory /particle-iot/device-os/third_party/freertos --directory /particle-iot/device-os/third_party/nrf5_sdk --directory /particle-iot/device-os/communication --directory /particle-iot/device-os/hal --directory /particle-iot/device-os/system --directory /particle-iot/device-os/wiring -ex 'target remote | openocd -f interface/.cfg -f target/.cfg -c \".cpu configure -rtos FreeRTOS; gdb_port pipe; log_output openocd.log;\"' .elf\n```\n\n> _**NOTE:** This process runs inside a container, where the file locations are no longer relative to where they were originally compiled. To compensate for this, we must supply the `--directory`parameter to `gdb`._\n\n#### Option breakdown\n\n##### Filepath Configuration\n\n- `` - This is the path to the firmware folder on your local machine.\n- `` - This is the path to the user application folder on your local machine.\n- `` - This will be the name of the resulting binary (i.e. `my_app.elf`).\n\n##### OpenOCD Configuration\n\n`gdb` pipes into `openocd`, and you can configure OpenOCD using the following parameters...\n\n- ``\n - `-f interface/particle-ftdi.cfg` --> [Programmer Shield](https://store.particle.io/products/prog-shield)\n - `-f interface/cmsis-dap.cfg` --> [Particle Debugger](https://store.particle.io/collections/accessories/products/particle-debugger)\n\n- ``\n - `-f target/stm32f1x.cfg` --> [Spark Core](https://docs.particle.io/datasheets/discontinued/core-datasheet/)\n - `-f target/stm32f2x.cfg` --> Gen2: Photon/Electron\n - `-f target/particle.cfg` --> [Gen3: Argon/Boron/Xenon](https://store.particle.io/pages/bluetooth)\n\n- ``\n - `stm32f2x.cpu configure -rtos FreeRTOS;` --> Gen2: Photon/Electron\n - `nrf52.cpu configure -rtos FreeRTOS;` --> [Gen3: Argon/Boron/Xenon](https://store.particle.io/pages/bluetooth)\n\n### Engage the target device\n\nOnce you have launched the container, you will be prompted with a GDB shell. Use the follow commands to engage the target device and start debugging.\n\n```bash\n(gdb) monitor reset halt\ntarget halted due to debug-request, current mode: Thread\nxPSR: 0x01000000 pc: 0x08003700 msp: 0x20020000\n(gdb) break setup\nBreakpoint 1 at 0x80373e0: file /particle-iot/app//src/blinky.cpp, line 12.\n(gdb) continue\nContinuing.\nNote: automatically using hardware breakpoints for read-only addresses.\n...\n```\n","has_starred","hub_user","immutable_tags_settings",{"_71":11,"_72":73},"enabled","rules",[74],".*","is_automated","permissions",{"_78":17,"_79":11,"_80":11},"read","write","admin","user","storage_size",553685394,"orgData","recentTags",[87],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":96,"_46":114,"_115":90,"_116":29,"_117":52,"_53":118,"_119":120,"_121":105,"_122":114,"_123":62,"_124":17},"content_type","creator",1644472,"full_size",128087782,"id",43664050,"images",[97],{"_98":99,"_100":101,"_102":103,"_104":105,"_106":107,"_108":109,"_110":103,"_111":-5,"_112":92,"_59":62,"_113":-5},"architecture","amd64","digest","sha256:1d871fbe0112a53abe1fe45d18851b405455a636d015adcbcca51c0aa9b6ed4d","features","","last_pulled","2026-09-23T11:10:32.07346754Z","last_pushed","2019-05-08T14:16:30Z","os","linux","os_features","os_version","size","variant","2019-05-08T14:16:29.922428Z","last_updater","last_updater_username","media_type","latest","repository",6518361,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_34":136,"_143":144,"_132":153,"_154":11},{"_36":137,"_38":138,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":139,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":140,"_75":11,"_76":142,"_81":29,"_82":83},[],[40],[52],{"_71":11,"_72":141},[74],{"_78":17,"_79":11,"_80":11},"tags",{"_145":60,"_146":-5,"_147":-5,"_148":149},"count","next","previous","results",[150],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":151,"_46":114,"_115":90,"_116":29,"_117":52,"_53":118,"_119":120,"_121":105,"_122":114,"_123":62,"_124":17},[152],{"_98":99,"_100":101,"_102":103,"_104":105,"_106":107,"_108":109,"_110":103,"_111":-5,"_112":92,"_59":62,"_113":-5},[],"canDeleteTags","actionData","errors"]

zfields/particle-dbg

Tags for zfields/particle-dbg