mirror of
https://github.com/DarkFlippers/unleashed-firmware
synced 2024-12-20 17:53:20 +00:00
53435579b3
* fbt, faploader: minimal app module implementation * faploader, libs: moved API hashtable core to flipper_application * example: compound api * lib: flipper_application: naming fixes, doxygen comments * fbt: changed `requires` manifest field behavior for app extensions * examples: refactored plugin apps; faploader: changed new API naming; fbt: changed PLUGIN app type meaning * loader: dropped support for debug apps & plugin menus * moved applications/plugins -> applications/external * Restored x bit on chiplist_convert.py * git: fixed free-dap submodule path * pvs: updated submodule paths * examples: example_advanced_plugins.c: removed potential memory leak on errors * examples: example_plugins: refined requires * fbt: not deploying app modules for debug/sample apps; extra validation for .PLUGIN-type apps * apps: removed cdefines for external apps * fbt: moved ext app path definition * fbt: reworked fap_dist handling; f18: synced api_symbols.csv * fbt: removed resources_paths for extapps * scripts: reworked storage * scripts: reworked runfap.py & selfupdate.py to use new api * wip: fal runner * fbt: moved file packaging into separate module * scripts: storage: fixes * scripts: storage: minor fixes for new api * fbt: changed internal artifact storage details for external apps * scripts: storage: additional fixes and better error reporting; examples: using APP_DATA_PATH() * fbt, scripts: reworked launch_app to deploy plugins; moved old runfap.py to distfap.py * fbt: extra check for plugins descriptors * fbt: additional checks in emitter * fbt: better info message on SDK rebuild * scripts: removed requirements.txt * loader: removed remnants of plugins & debug menus * post-review fixes
105 lines
2.9 KiB
Markdown
105 lines
2.9 KiB
Markdown
# Flipper Zero as CMSIS DAP/DAP Link
|
|
Flipper Zero as a [Free-DAP](https://github.com/ataradov/free-dap) based SWD\JTAG debugger. Free-DAP is a free and open source firmware implementation of the [CMSIS-DAP](https://www.keil.com/pack/doc/CMSIS_Dev/DAP/html/index.html) debugger.
|
|
|
|
## Protocols
|
|
SWD, JTAG , CMSIS-DAP v1 (18 KiB/s), CMSIS-DAP v2 (46 KiB/s), VCP (USB-UART).
|
|
|
|
WinUSB for driverless installation for Windows 8 and above.
|
|
|
|
## Usage
|
|
|
|
### VSCode + Cortex-Debug
|
|
Set `"device": "cmsis-dap"`
|
|
|
|
<details>
|
|
<summary>BluePill configuration example</summary>
|
|
|
|
```json
|
|
{
|
|
"name": "Attach (DAP)",
|
|
"cwd": "${workspaceFolder}",
|
|
"executable": "./build/firmware.elf",
|
|
"request": "attach",
|
|
"type": "cortex-debug",
|
|
"servertype": "openocd",
|
|
"device": "cmsis-dap",
|
|
"configFiles": [
|
|
"interface/cmsis-dap.cfg",
|
|
"target/stm32f1x.cfg",
|
|
],
|
|
},
|
|
```
|
|
</details>
|
|
|
|
<details>
|
|
<summary>Flipper Zero configuration example</summary>
|
|
|
|
```json
|
|
{
|
|
"name": "Attach (DAP)",
|
|
"cwd": "${workspaceFolder}",
|
|
"executable": "./build/latest/firmware.elf",
|
|
"request": "attach",
|
|
"type": "cortex-debug",
|
|
"servertype": "openocd",
|
|
"device": "cmsis-dap",
|
|
"svdFile": "./debug/STM32WB55_CM4.svd",
|
|
"rtos": "FreeRTOS",
|
|
"configFiles": [
|
|
"interface/cmsis-dap.cfg",
|
|
"./debug/stm32wbx.cfg",
|
|
],
|
|
"postAttachCommands": [
|
|
"source debug/flipperapps.py",
|
|
],
|
|
},
|
|
```
|
|
</details>
|
|
|
|
### OpenOCD
|
|
Use `interface/cmsis-dap.cfg`. You will need OpenOCD v0.11.0.
|
|
|
|
Additional commands:
|
|
* `cmsis_dap_backend hid` for CMSIS-DAP v1 protocol.
|
|
* `cmsis_dap_backend usb_bulk` for CMSIS-DAP v2 protocol.
|
|
* `cmsis_dap_serial DAP_Oyevoxo` use DAP-Link running on Flipper named `Oyevoxo`.
|
|
* `cmsis-dap cmd 81` - reboot connected DAP-Link.
|
|
|
|
<details>
|
|
<summary>Flash BluePill</summary>
|
|
|
|
```
|
|
openocd -f interface/cmsis-dap.cfg -f target/stm32f1x.cfg -c init -c "program build/firmware.bin reset exit 0x8000000"
|
|
```
|
|
</details>
|
|
|
|
<details>
|
|
<summary>Flash Flipper Zero using DAP v2 protocol</summary>
|
|
|
|
```
|
|
openocd -f interface/cmsis-dap.cfg -c "cmsis_dap_backend usb_bulk" -f debug/stm32wbx.cfg -c init -c "program build/latest/firmware.bin reset exit 0x8000000"
|
|
```
|
|
</details>
|
|
|
|
<details>
|
|
<summary>Reboot connected DAP-Link on Flipper named Oyevoxo</summary>
|
|
|
|
```
|
|
openocd -f interface/cmsis-dap.cfg -c "cmsis_dap_serial DAP_Oyevoxo" -c "transport select swd" -c "adapter speed 4000000" -c init -c "cmsis-dap cmd 81" -c "exit"
|
|
```
|
|
</details>
|
|
|
|
### PlatformIO
|
|
Use `debug_tool = cmsis-dap` and `upload_protocol = cmsis-dap`. [Documentation](https://docs.platformio.org/en/latest/plus/debug-tools/cmsis-dap.html#debugging-tool-cmsis-dap). Remember that Windows 8 and above do not require drivers.
|
|
|
|
<details>
|
|
<summary>BluePill platformio.ini example</summary>
|
|
|
|
```
|
|
[env:bluepill_f103c8]
|
|
platform = ststm32
|
|
board = bluepill_f103c8
|
|
debug_tool = cmsis-dap
|
|
upload_protocol = cmsis-dap
|
|
```
|
|
</details>
|