Skip to content

Commit

Permalink
Merge pull request #631 from brianesquilona/dev_no_target_flash_algo_…
Browse files Browse the repository at this point in the history
…bind

Brief documentation added in USERS-GUIDE for No MSD builds support.
  • Loading branch information
brianesquilona authored May 15, 2019
2 parents 5f8d1bc + 8b2cca4 commit e7ed849
Showing 1 changed file with 4 additions and 0 deletions.
4 changes: 4 additions & 0 deletions docs/USERS-GUIDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,3 +39,7 @@ You can debug with any IDE that supports the CMSIS-DAP protocol. Some tools capa
## Firmware update

To update the firmware on a device, hold the reset button while attaching USB. The device boots into bootloader mode. From there, copy the appropriate firmware onto the drive. If successful, the device leaves bootloader mode and starts running the new firmware. Otherwise, the bootloader displays `FAIL.TXT` with an explanation of what went wrong.

## No MSD builds

MSD or drag-and-drop support is automatically detected and enabled when the target flash algorithm is in the DAPLink build. But there are builds that does not have a particular target and can retarget any families which have DAPLink support by using a debugger or pyocd without the MSD DAPLink drive. The script `tools/post_build_script.py` can take a board id, family id, flm elf or axf file as flash algo bin and bind it to a DAPLink binary build. The ram boundaries also needed to be specified as parameters. This is useful in all-family builds which has no board target originally but can target all existing families and retarget a particular target. The DAPLink MSD drive will be automatically enabled when there is a flash algoritm embedded in the binary file. The reverse use case of disabling the MSD even with a target support can also be done, please see `docs/MSD_COMMANDS.md` for details.

0 comments on commit e7ed849

Please sign in to comment.