mirror of
https://github.com/portapack-mayhem/mayhem-firmware.git
synced 2025-02-17 12:38:31 +00:00
Created Debug via SWD (markdown)
Bernd Herzog
parent
f5e2dd9fdd
commit
4afbeb3b87
115
Debug-via-SWD.md
Normal file
115
Debug-via-SWD.md
Normal file
@ -0,0 +1,115 @@
|
||||
Coding without the possibility of debugging can be quite time consuming because you are mostly blind. The portapack is an embedded system and requires some work for the comfort.
|
||||
|
||||
## What you need
|
||||
* Black Magic Probe
|
||||
* Or something similar. [HackRF](https://hackrf.readthedocs.io/en/latest/LPC43XX_Debugging.html) has a list of hardware that should work. In this example we will be using the [Jeff Probe](https://flirc.tv/products/flirc-jeffprobe?variant=43085036585192) with the portapack H2+ in an aluminium case.
|
||||
|
||||
|
||||
|
||||
* Tools. Lots of tools. I think I used all tools there are:
|
||||
* Solder Iron
|
||||
* Tweezers
|
||||
* Screwdrivers
|
||||
* A drill
|
||||
* [Vise](https://en.wikipedia.org/wiki/Vise)
|
||||
* Multimeter
|
||||
* A [file](https://en.wikipedia.org/wiki/File_(tool))
|
||||
* Good eyes
|
||||
* Steady hands
|
||||
* exacto knife
|
||||
* Your portapack
|
||||
* [Pin header](https://en.wikipedia.org/wiki/Pin_header) 2x5 1.27mm
|
||||
|
||||
|
||||
|
||||
## The things arrived. What now?
|
||||
First we need to disassemble the portapack. Lots of screws. You probably already know how to do it. Then locate the debug port LPC_JTAG.
|
||||
|
||||
|
||||
|
||||
> Note: The arrow points to PIN 1. Always ensure that you connect your cable correctly, typically by matching PIN 1 marked on the board to the red stripe on the cable.
|
||||
|
||||
You now have two options:
|
||||
1. Solder the pin header and never be able to close the portapack again.
|
||||
|
||||
|
||||
|
||||
2. Solder it to the backside.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
## The pins are now backwards. What now?
|
||||
|
||||
> Note: Now that the pin header is on the back side it is never possible to correctly connect your cable, because the pins are reversed. Instead of 1,2,3,4,5,6,7,8,9,10 it is now 2,1,4,3,6,5,8,7,10,9.
|
||||
|
||||
|
||||
|
||||
|
||||
Now we disassemble the ribbon cable to correct the back-'wardity'.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Keep pairs of wires together. Insert them back but twist every pair.
|
||||
|
||||
|
||||
|
||||
|
||||
Now press it back together with a vice, but careful. Do a [continuity test](https://www.fluke.com/en-us/learn/blog/digital-multimeters/how-to-test-for-continuity) with a multimeter to check if they are all connected. You can use the 'not yet? soldered' pin header to help reach inside. The ends of the wire are easy reachable.
|
||||
|
||||
|
||||
|
||||
|
||||
## First test
|
||||
|
||||
With the pin header in place and the ribbon cable ready you can run a first test. Attach the hackrf and the battery to the portapack and power on the portapack. The Jeff Probe will also be powered on with some LEDs.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Now you can put your portapack back together with the exception of the back plate.
|
||||
|
||||
|
||||
|
||||
## Finishing touch
|
||||
|
||||
You now have two options:
|
||||
1. Leave the backplate off while you are debugging. The backplate will fit, but you should place something non-conductive like [insulating tape](https://en.wikipedia.org/wiki/Electrical_tape) between the plate and the pins.
|
||||
|
||||
2. Make the debug port always accessible by drilling a hole in the backplate.
|
||||
|
||||
|
||||
|
||||
|
||||
> Congratulation. The value of your portapack has now increased by whatever you spend on tools and hardware and of course by the time you spend ;)
|
||||
|
||||
## Use gdb
|
||||
|
||||
Now that everything is set up you can connect gdb to the LPC4320.
|
||||
1. Start arm-none-eabi-gdb
|
||||
2. depending on your system connect to the probe by running the command:
|
||||
* (gdb) target extended-remote \\.\COM4
|
||||
* (on windows check device manager for the right COM port)
|
||||
* (gdb) target extended-remote /dev/ttyACM0
|
||||
* (on linux dmesg or lsusb will help)
|
||||
3. now check the version of the probe
|
||||
* (gdb) monitor version
|
||||
4. scan for devices
|
||||
* (gdb) monitor swdp_scan
|
||||
5. attach to the device
|
||||
* (gdb) attach 1
|
||||
6. load the symbols
|
||||
* (gdb) file firmware/application/application.elf
|
||||
7. look around
|
||||
* (gdb) info threads
|
||||
* (gdb) info registers
|
||||
|
||||
## Integration into VSCode
|
||||
- tbd
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user