Add debug article

This commit is contained in:
lupyuen 2020-12-12 23:00:04 +08:00
parent b8e4398640
commit f405b53eda
5 changed files with 139 additions and 4 deletions

2
.vscode/tasks.json vendored
View file

@ -48,7 +48,7 @@
"args": [
"-c",
"-l",
" article=openocd ; set -e -x ; git pull ; cat scripts/articles/$article-header.html scripts/rustdoc-header.html >article-rustdoc-header.html ; rustdoc --output articles --html-in-header article-rustdoc-header.html --html-before-content scripts/rustdoc-before.html src/$article.md ; echo ✅ ◾ Done! "
" article=debug ; set -e -x ; git pull ; cat scripts/articles/$article-header.html scripts/rustdoc-header.html >article-rustdoc-header.html ; rustdoc --output articles --html-in-header article-rustdoc-header.html --html-before-content scripts/rustdoc-before.html src/$article.md ; echo ✅ ◾ Done! "
]
},
"linux": {

View file

@ -1,12 +1,12 @@
<!-- Begin scripts/articles/*-header.html: Article Header for Custom Markdown files processed by rustdoc, like chip8.md -->
<meta property="og:title"
content="Connect PineCone BL602 to OpenOCD"
content="Debug Rust on PineCone BL602 with VSCode and GDB"
data-rh="true">
<meta property="og:description"
content="How we connect PineCone BL602 Evaluation Board to OpenOCD... For flashing and debugging RISC-V firmware"
content="Debug Rust on PineCone BL602 with VSCode and GDB"
data-rh="true">
<meta property="og:image"
content="https://lupyuen.github.io/images/openocd-title.jpg">
content="https://lupyuen.github.io/images/debug-title.jpg">
<meta property="og:type"
content="article" data-rh="true">
<!-- End scripts/articles/*-header.html -->

90
articles/debug.html Normal file
View file

@ -0,0 +1,90 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="generator" content="rustdoc">
<title>Debug Rust on PineCone BL602 with VSCode and GDB</title>
<!-- Begin scripts/articles/*-header.html: Article Header for Custom Markdown files processed by rustdoc, like chip8.md -->
<meta property="og:title"
content="Debug Rust on PineCone BL602 with VSCode and GDB"
data-rh="true">
<meta property="og:description"
content="Debug Rust on PineCone BL602 with VSCode and GDB"
data-rh="true">
<meta property="og:image"
content="https://lupyuen.github.io/images/debug-title.jpg">
<meta property="og:type"
content="article" data-rh="true">
<!-- End scripts/articles/*-header.html -->
<!-- Begin scripts/rustdoc-header.html: Header for Custom Markdown files processed by rustdoc, like chip8.md -->
<link rel="alternate" type="application/rss+xml" title="RSS Feed for lupyuen" href="/rss.xml" />
<link rel="stylesheet" type="text/css" href="../normalize.css">
<link rel="stylesheet" type="text/css" href="../rustdoc.css" id="mainThemeStyle">
<link rel="stylesheet" type="text/css" href="../dark.css">
<link rel="stylesheet" type="text/css" href="../light.css" id="themeStyle">
<link rel="stylesheet" type="text/css" href="../prism.css">
<script src="../storage.js"></script><noscript>
<link rel="stylesheet" href="../noscript.css"></noscript>
<link rel="shortcut icon" href="../favicon.ico">
<style type="text/css">
#crate-search {
background-image: url("../down-arrow.svg");
}
a {
color: #77d;
}
</style>
<!-- End scripts/rustdoc-header.html -->
</head>
<body class="rustdoc">
<!--[if lte IE 8]>
<div class="warning">
This old browser is unsupported and will most likely display funky
things.
</div>
<![endif]-->
<!-- Begin scripts/rustdoc-before.html: Pre-HTML for Custom Markdown files processed by rustdoc, like chip8.md -->
<!-- Begin Theme Picker -->
<div class="theme-picker" style="left: 0"><button id="theme-picker" aria-label="Pick another theme!"><img src="../brush.svg"
width="18" alt="Pick another theme!"></button>
<div id="theme-choices"></div>
</div>
<script src="../theme.js"></script>
<script src="../prism.js"></script>
<!-- Theme Picker -->
<!-- End scripts/rustdoc-before.html -->
<h1 class="title">Debug Rust on PineCone BL602 with VSCode and GDB</h1>
<nav id="TOC"><ul>
<li><a href="#openocd">1 OpenOCD</a><ul></ul></li>
<li><a href="#gdb">2 GDB</a><ul></ul></li>
<li><a href="#vscode">3 VSCode</a><ul></ul></li>
<li><a href="#whats-next">4 What's Next</a><ul></ul></li></ul></nav><p><img src="https://lupyuen.github.io/images/debug-title.jpg" alt="PineCone BL602 RISC-V Evaluation Board connected to Sipeed JTAG Debugger" /></p>
<p><em>PineCone BL602 RISC-V Evaluation Board connected to Sipeed JTAG Debugger</em></p>
<p>Today we'll learn to debug Rust Firmware for <a href="https://lupyuen.github.io/articles/pinecone"><strong>PineCone BL602 RISC-V Evaluation Board</strong></a> with VSCode and GDB.</p>
<h1 id="openocd" class="section-header"><a href="#openocd">1 OpenOCD</a></h1>
<p>TODO</p>
<h1 id="gdb" class="section-header"><a href="#gdb">2 GDB</a></h1>
<p>TODO</p>
<h1 id="vscode" class="section-header"><a href="#vscode">3 VSCode</a></h1>
<p>TODO</p>
<h1 id="whats-next" class="section-header"><a href="#whats-next">4 What's Next</a></h1>
<p>TODO</p>
<p><a href="https://lupyuen.github.io">Check out my articles</a></p>
<p><a href="https://lupyuen.github.io/rss.xml">RSS Feed</a></p>
<p><a href="https://github.com/sponsors/lupyuen">Sponsor me a coffee</a></p>
<p><em>Got a question, comment or suggestion? Create an Issue or submit a Pull Request here...</em></p>
<p><a href="https://github.com/lupyuen/lupyuen.github.io/blob/master/src/debug.md"><code>github.com/lupyuen/lupyuen.github.io/src/debug.md</code></a></p>
</body>
</html>

View file

@ -0,0 +1,12 @@
<!-- Begin scripts/articles/*-header.html: Article Header for Custom Markdown files processed by rustdoc, like chip8.md -->
<meta property="og:title"
content="Debug Rust on PineCone BL602 with VSCode and GDB"
data-rh="true">
<meta property="og:description"
content="Debug Rust on PineCone BL602 with VSCode and GDB"
data-rh="true">
<meta property="og:image"
content="https://lupyuen.github.io/images/debug-title.jpg">
<meta property="og:type"
content="article" data-rh="true">
<!-- End scripts/articles/*-header.html -->

33
src/debug.md Normal file
View file

@ -0,0 +1,33 @@
# Debug Rust on PineCone BL602 with VSCode and GDB
![PineCone BL602 RISC-V Evaluation Board connected to Sipeed JTAG Debugger](https://lupyuen.github.io/images/debug-title.jpg)
_PineCone BL602 RISC-V Evaluation Board connected to Sipeed JTAG Debugger_
Today we'll learn to debug Rust Firmware for [__PineCone BL602 RISC-V Evaluation Board__](https://lupyuen.github.io/articles/pinecone) with VSCode and GDB.
# OpenOCD
TODO
# GDB
TODO
# VSCode
TODO
# What's Next
TODO
[Check out my articles](https://lupyuen.github.io)
[RSS Feed](https://lupyuen.github.io/rss.xml)
[Sponsor me a coffee](https://github.com/sponsors/lupyuen)
_Got a question, comment or suggestion? Create an Issue or submit a Pull Request here..._
[`github.com/lupyuen/lupyuen.github.io/src/debug.md`](https://github.com/lupyuen/lupyuen.github.io/blob/master/src/debug.md)