Skip to content

Add JTAG tutorial #17

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Merged
merged 7 commits into from
Mar 10, 2019
Merged

Add JTAG tutorial #17

merged 7 commits into from
Mar 10, 2019

Conversation

andre-richter
Copy link
Member

@andre-richter andre-richter commented Mar 9, 2019 •
edited
Loading

@naotaco

Could you please review? This branch contains your changes and my extensions.

You can check out the JTAG branch of the repository for this.

naotaco and others added 5 commits March 9, 2019 16:08
@naotaco @andre-richter
Add a tutorial for using debuggers
a9ec756 
Add an instruction for openocd insallation

Update tutorial to use openocd on Docker

Fix RTCK pin

Add wiring diagram for JTAG connection
@andre-richter
Add minimal JTAG boot
8d0129b
@andre-richter
Add container for openocd and gdb
3e9087e
@andre-richter
Extend JTAG tutorial
d9371ea
@andre-richter
tutorials++ to account for JTAG tutorial
043e55c
@andre-richter andre-richter mentioned this pull request Mar 9, 2019
Closed
@naotaco
Copy link
Contributor

naotaco commented Mar 10, 2019

@andre-richter

Wow, it's really nice tutorial. Great job! 👏 Honestly, I had no Idea to provide simple way to load another image to debug after enable/connect JTAG debugger.

Anyway, I'll follow the tutorial. Give me few days for that. At least, I'll provide improved wiring photo and fritzing image as requested at #18 .

berkus
berkus reviewed Mar 10, 2019
View reviewed changes
0B_hw_debug_JTAG/src/power.rs Outdated
compiler_fence(Ordering::Release);

if mbox.call(mbox::channel::PROP).is_err() {
return Err(PowerError::MailboxError); // Abort if UART clocks couldn't be set
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Invalid comment - we turn off POWER, not set UART clocks.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good catch, thanks. Corrected it.

@berkus
Copy link
Member

berkus commented Mar 10, 2019 •
edited
Loading

Thank you @andre-richter and @naotaco for this; my journey with JTAG debugging my Pi was bumpy up to this point, hopefully, it will become a smoother ride now!

I will play with the 0B tutorial and write up if anything is not working. I have a JLink not olimex, so things might be slightly different.

Feel free to pull anything from these documents if you want/need: JTAG notes, config.txt that enables JTAG on boot without additional software, JTAG wait helper.

berkus added a commit to metta-systems/vesper that referenced this pull request Mar 10, 2019
@berkus
Add another JTAG config found in andre-richter tutorials
bf6d3f7 
* See rust-embedded/rust-raspberrypi-OS-tutorials#17
* See https://github.com/rust-embedded/rust-raspi3-OS-tutorials/tree/JTAG

However, https://github.com/rust-embedded/rust-raspi3-OS-tutorials/blob/JTAG/docker/raspi3-openocd/rpi3.cfg is actually a SUSE version.
@andre-richter
Copy link
Member Author

@berkus Using config.txt to set the GPIOs is something I was ignorant about, it can definitely be an alternative. Thanks for sharing.

For the tutorials, since we have our chain-loading infrastructure with raspboot in place anyways, I'll stick with the current solution. It has the advantage that the pins are only set on demand when needed, and not on every boot regardless.

@andre-richter
Copy link
Member Author

@naotaco @berkus
I think my exit criteria for merging this one to master is that one of you guys could run and step with gdb successfully.

All points raised in #18 and other findings can be addressed in master then.

@naotaco
Copy link
Contributor

naotaco commented Mar 10, 2019

@andre-richter

I agree. Actually, gdb is working here perfectly! I can break the CPU and see registers/source code in cool gdb window. Thanks again for your great work ❤️

@andre-richter
Copy link
Member Author

Perfect, thanks.

@andre-richter andre-richter merged commit 76b86a4 into master Mar 10, 2019
@andre-richter andre-richter deleted the JTAG branch March 10, 2019 16:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Reviewers

@berkus berkus berkus left review comments

Assignees
No one assigned
Labels
None yet
Projects
None yet
Milestone
No milestone
Development

Successfully merging this pull request may close these issues.
3 participants
@andre-richter @naotaco @berkus