commit 8b4d6e1c945d7fb5390a4132419daae6b2e65cde
parent aef22d094a08762cd59c8f1c19fc778d0cde053e
Author: Christian Ermann <christianermann@gmail.com>
Date: Mon, 16 Nov 2026 19:32:33 -0800
built site
Diffstat:
40 files changed, 7615 insertions(+), 0 deletions(-)
diff --git a/404.html b/404.html
@@ -0,0 +1,92 @@
+<!DOCTYPE html>
+<html lang="en-US">
+
+<head>
+ <meta http-equiv="X-Clacks-Overhead" content="GNU Terry Pratchett" />
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+<link rel="shortcut icon" href="https://electrosoup.com/favicon.png" />
+<title>404</title>
+<meta name="title" content="404 Page not found" />
+<meta name="description" content="Stuff I'm working on." />
+<meta name="author" content="" />
+<meta name="keywords" content="arm,assembly,c,forth,g-code,graphics,lasers,matrices,opengl,risc-v," />
+
+
+
+
+
+
+
+ <meta property="og:url" content="https://electrosoup.com/404.html">
+ <meta property="og:site_name" content="Electrosoup">
+ <meta property="og:title" content="404 Page not found">
+ <meta property="og:description" content="Stuff I'm working on.">
+ <meta property="og:locale" content="en_US">
+ <meta property="og:type" content="website">
+
+
+
+
+ <meta name="twitter:card" content="summary">
+ <meta name="twitter:title" content="404 Page not found">
+ <meta name="twitter:description" content="Stuff I'm working on.">
+
+
+
+
+ <meta itemprop="name" content="404 Page not found">
+ <meta itemprop="description" content="Stuff I'm working on.">
+
+
+ <link href="/herman.min.css" rel="stylesheet">
+
+
+
+
+
+
+</head>
+
+<body>
+ <header><a class="skip-link" href="#main-content">Skip to main content</a>
+
+<nav>
+ <a href="/">Main</a>
+
+ <a href="/posts/">Posts</a>
+
+ <a href="https://git.electrosoup.com">Code</a>
+
+ <a href="https://christianermann.dev">Resume</a>
+
+
+
+
+
+
+
+
+
+</nav>
+</header>
+ <main id="main-content">
+<h1>404</h1>
+<h2>ʕノ•ᴥ•ʔノ ︵ ┻━┻</h2>
+
+ </main>
+ <footer><footer>
+
+ <a href="https://git.electrosoup.com">Code</a>.
+
+ <a href="https://christianermann.dev">Resume</a>.
+
+ <a href='https://electrosoup.com/index.xml'>RSS</a>.
+ <p>Copyright © 2026 Christian Ermann. | Made with <a href="https://github.com/clente/hugo-bearcub">Bear Cub</a></p>
+</footer>
+</footer>
+
+
+</body>
+
+</html>
diff --git a/categories/index.html b/categories/index.html
@@ -0,0 +1,104 @@
+<!DOCTYPE html>
+<html lang="en-US">
+
+<head>
+ <meta http-equiv="X-Clacks-Overhead" content="GNU Terry Pratchett" />
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+<link rel="shortcut icon" href="https://electrosoup.com/favicon.png" />
+<title>Categories | Electrosoup</title>
+<meta name="title" content="Categories" />
+<meta name="description" content="Stuff I'm working on." />
+<meta name="author" content="" />
+<meta name="keywords" content="arm,assembly,c,forth,g-code,graphics,lasers,matrices,opengl,risc-v," />
+
+
+
+
+
+
+
+ <meta property="og:url" content="https://electrosoup.com/categories/">
+ <meta property="og:site_name" content="Electrosoup">
+ <meta property="og:title" content="Categories">
+ <meta property="og:description" content="Stuff I'm working on.">
+ <meta property="og:locale" content="en_US">
+ <meta property="og:type" content="website">
+
+
+
+
+ <meta name="twitter:card" content="summary">
+ <meta name="twitter:title" content="Categories">
+ <meta name="twitter:description" content="Stuff I'm working on.">
+
+
+
+
+ <meta itemprop="name" content="Categories">
+ <meta itemprop="description" content="Stuff I'm working on.">
+
+
+ <link href="/herman.min.css" rel="stylesheet">
+
+
+
+
+
+ <link rel="alternate" type="application/rss+xml" href="https://electrosoup.com/categories/index.xml" title="Electrosoup" />
+
+</head>
+
+<body>
+ <header><a class="skip-link" href="#main-content">Skip to main content</a>
+
+<nav>
+ <a href="/">Main</a>
+
+ <a href="/posts/">Posts</a>
+
+ <a href="https://git.electrosoup.com">Code</a>
+
+ <a href="https://christianermann.dev">Resume</a>
+
+
+
+
+
+
+
+
+
+</nav>
+</header>
+ <main id="main-content">
+<content>
+
+ <h3 class="blog-filter">Filtering for "Categories"</h3>
+
+ <ul class="blog-posts">
+
+ <li>
+ No posts yet
+ </li>
+
+ </ul>
+
+</content>
+
+ </main>
+ <footer><footer>
+
+ <a href="https://git.electrosoup.com">Code</a>.
+
+ <a href="https://christianermann.dev">Resume</a>.
+
+ <a href='https://electrosoup.com/index.xml'>RSS</a>.
+ <p>Copyright © 2026 Christian Ermann. | Made with <a href="https://github.com/clente/hugo-bearcub">Bear Cub</a></p>
+</footer>
+</footer>
+
+
+</body>
+
+</html>
diff --git a/categories/index.xml b/categories/index.xml
@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="utf-8" standalone="yes"?>
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/">
+ <channel>
+ <title>Categories on Electrosoup</title>
+ <link>https://electrosoup.com/categories/</link>
+ <description>Recent content in Categories on Electrosoup</description>
+ <generator>Hugo -- gohugo.io</generator>
+ <language>en-US</language>
+ <managingEditor>christianermann@gmail.com (Christian Ermann)</managingEditor>
+ <webMaster>christianermann@gmail.com (Christian Ermann)</webMaster>
+ <atom:link href="https://electrosoup.com/categories/index.xml" rel="self" type="application/rss+xml" />
+ </channel>
+</rss>
diff --git a/favicon.png b/favicon.png
Binary files differ.
diff --git a/herman.min.css b/herman.min.css
@@ -0,0 +1 @@
+:root{font-size:62.5%;--color-dark:#181a20;--color-light:#fafafa;--color-primary:#1a8fe3;--size:1rem;--spacing:calc(var(--size) * 2.4)}body{background:var(--color-dark);color:var(--color-light);padding:4rem;font-family:Avenir,avenir next lt pro,Montserrat,Corbel,urw gothic,source-sans-pro,sans-serif,apple color emoji,segoe ui emoji,segoe ui symbol,noto color emoji;font-size:calc(var(--size) * 1.8);line-height:1.5;min-height:80vh;max-width:1600px;margin:0 auto;word-wrap:break-word}header,main,footer{max-width:70ch;margin-inline:auto}header{padding-bottom:var(--spacing)}nav a,a.blog-tags{margin-right:calc(var(--spacing)/2)}a.blog-tags{line-height:2}main{padding-bottom:var(--spacing)}footer{text-align:center;padding-top:var(--spacing)}a{color:currentColor;text-decoration-color:var(--color-primary);text-decoration-thickness:.3ex;text-underline-offset:.3ex}a:hover{text-decoration-thickness:.4ex}img{display:block;max-width:100%;height:auto}h1,h2,h3,h4{font-weight:700;line-height:1.3}h1{font-size:calc(var(--size) * 4.2)}h2{font-size:calc(var(--size) * 3.4)}h3{font-size:calc(var(--size) * 2.6)}h4{font-size:calc(var(--size) * 1.8)}ul,ol{padding-inline-start:var(--spacing)}li{margin-block-start:var(--spacing)}blockquote{padding-inline-start:var(--spacing);border-inline-start:.2em solid;font-style:italic;max-width:50ch}:is(h1,h2,h3,h4,blockquote){margin-block-end:calc(var(--spacing)/2)}:is(h1,h2,h3,h4)+*{margin-block-start:calc(var(--spacing)/3)}:is(h1,h2,h3,h4)+:where(h2,h3,h4){margin-block-start:calc(var(--spacing) * 2)}.title{text-decoration:none}.title h1{font-size:calc(var(--size) * 3.4);margin-top:calc(var(--spacing)/2)}ul.blog-posts{list-style-type:none;padding:unset}ul.blog-posts li{display:flex;flex-direction:column}ul.blog-posts li span{min-width:11ch}p.byline{opacity:.5}code{font-family:ui-monospace,cascadia code,source code pro,Menlo,Consolas,dejavu sans mono,monospace;padding:2px calc(var(--spacing)/4);background-color:#282a36;font-size:calc(var(--size) * 1.4)}pre code{display:block;padding:var(--spacing);overflow-x:auto;-webkit-text-size-adjust:100%;-moz-text-size-adjust:100%}table{width:100%}table,th,td{border:1px solid;border-collapse:collapse;border-color:var(--color-light);padding:calc(var(--spacing)/2)}.disabled{color:currentColor;cursor:not-allowed;opacity:.5}@media screen and (min-width:600px){ul.blog-posts li{flex-direction:row;gap:calc(var(--spacing)/2)}}.skip-link{position:absolute;top:5;transform:translateY(-600%);transition:transform .5s;background-color:#181a20;padding:6px}.skip-link:focus{transform:translateY(0%)}figure{margin-inline-start:0;margin-inline-end:0}figcaption>p{margin-block-start:9px;text-align:center;font-style:italic}
+\ No newline at end of file
diff --git a/index.html b/index.html
@@ -0,0 +1,148 @@
+<!DOCTYPE html>
+<html lang="en-US">
+
+<head>
+ <meta name="generator" content="Hugo 0.138.0">
+ <meta http-equiv="X-Clacks-Overhead" content="GNU Terry Pratchett" />
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+<link rel="shortcut icon" href="https://electrosoup.com/favicon.png" />
+<title>Main | Electrosoup</title>
+<meta name="title" content="Main" />
+<meta name="description" content="Stuff I'm working on." />
+<meta name="author" content="" />
+<meta name="keywords" content="arm,assembly,c,forth,g-code,graphics,lasers,matrices,opengl,risc-v," />
+
+
+
+
+
+
+
+ <meta property="og:url" content="https://electrosoup.com/">
+ <meta property="og:site_name" content="Electrosoup">
+ <meta property="og:title" content="Main">
+ <meta property="og:description" content="Stuff I'm working on.">
+ <meta property="og:locale" content="en_US">
+ <meta property="og:type" content="website">
+
+
+
+
+ <meta name="twitter:card" content="summary">
+ <meta name="twitter:title" content="Main">
+ <meta name="twitter:description" content="Stuff I'm working on.">
+
+
+
+
+ <meta itemprop="name" content="Main">
+ <meta itemprop="description" content="Stuff I'm working on.">
+ <meta itemprop="datePublished" content="2021-08-25T00:00:00+00:00">
+ <meta itemprop="dateModified" content="2021-08-25T00:00:00+00:00">
+
+
+ <link href="/herman.min.css" rel="stylesheet">
+
+
+
+
+
+ <link rel="alternate" type="application/rss+xml" href="https://electrosoup.com/index.xml" title="Electrosoup" />
+
+</head>
+
+<body>
+ <header><a class="skip-link" href="#main-content">Skip to main content</a>
+
+<nav>
+ <a href="/">Main</a>
+
+ <a href="/posts/">Posts</a>
+
+ <a href="https://git.electrosoup.com">Code</a>
+
+ <a href="https://christianermann.dev">Resume</a>
+
+
+
+
+
+
+
+
+
+</nav>
+</header>
+ <main id="main-content">
+
+
+ <div class="summary">
+ <h2><a href="https://electrosoup.com/posts/forth-rv32i-assembler/">Forth RV32I Assembler</a></h2>
+ <div class="summary_metadata">
+ <time>2024-11-13</time>
+
+ <a href="/tags/forth">Forth</a>.
+
+ <a href="/tags/assembly">Assembly</a>.
+
+ <a href="/tags/risc-v">RISC-V</a>.
+
+ </div>
+ <div class="summary_body">
+ <p>Here’s an assembler for RV32I that I wrote in Forth. I find the definitions of
+the instructions and instruction types especially elegant, and I find it to be
+a great demonstration of how concise and powerful Forth can be.</p>
+ </div>
+
+ <a href="https://electrosoup.com/posts/forth-rv32i-assembler/">Read more...</a>
+
+</div>
+
+
+ <div class="summary">
+ <h2><a href="https://electrosoup.com/posts/the-infamous-link-macro/">The Infamous 'link' Macro</a></h2>
+ <div class="summary_metadata">
+ <time>2024-11-12</time>
+
+ <a href="/tags/forth">Forth</a>.
+
+ <a href="/tags/assembly">Assembly</a>.
+
+ <a href="/tags/risc-v">RISC-V</a>.
+
+ <a href="/tags/arm">ARM</a>.
+
+ </div>
+ <div class="summary_body">
+ <p>Each word (or function, in other languages) in Forth is stored as an entry in
+a linked list known as the dictionary. When bootstrapping a Forth from
+assembly, it is your responsibility to create and maintain this linked list
+structure. This is a tedious process and is the source of many errors when
+re-arranging words or defining new words; it’s incredibly easy to turn your
+list into a graph by mistake.</p>
+ </div>
+
+ <a href="https://electrosoup.com/posts/the-infamous-link-macro/">Read more...</a>
+
+</div>
+
+
+ <h2><a href='https://electrosoup.com/posts/'>View Older Posts</a></h2>
+
+ </main>
+ <footer><footer>
+
+ <a href="https://git.electrosoup.com">Code</a>.
+
+ <a href="https://christianermann.dev">Resume</a>.
+
+ <a href='https://electrosoup.com/index.xml'>RSS</a>.
+ <p>Copyright © 2026 Christian Ermann. | Made with <a href="https://github.com/clente/hugo-bearcub">Bear Cub</a></p>
+</footer>
+</footer>
+
+
+</body>
+
+</html>
diff --git a/index.xml b/index.xml
@@ -0,0 +1,753 @@
+<?xml version="1.0" encoding="utf-8" standalone="yes"?>
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/">
+ <channel>
+ <title>Electrosoup</title>
+ <link>https://electrosoup.com/</link>
+ <description>Recent content on Electrosoup</description>
+ <generator>Hugo -- gohugo.io</generator>
+ <language>en-US</language>
+ <managingEditor>christianermann@gmail.com (Christian Ermann)</managingEditor>
+ <webMaster>christianermann@gmail.com (Christian Ermann)</webMaster>
+ <lastBuildDate>Wed, 25 Aug 2021 00:00:00 +0000</lastBuildDate>
+ <atom:link href="https://electrosoup.com/index.xml" rel="self" type="application/rss+xml" />
+ <item>
+ <title>Forth RV32I Assembler</title>
+ <link>https://electrosoup.com/posts/forth-rv32i-assembler/</link>
+ <pubDate>Wed, 13 Nov 2024 17:33:47 -0800</pubDate><author>christianermann@gmail.com (Christian Ermann)</author>
+ <guid>https://electrosoup.com/posts/forth-rv32i-assembler/</guid>
+ <description><p>Here&rsquo;s an assembler for RV32I that I wrote in Forth. I find the definitions of
the instructions and instruction types especially elegant, and I find it to be
a great demonstration of how concise and powerful Forth can be.</p></description>
+ <content:encoded><![CDATA[<p>Here’s an assembler for RV32I that I wrote in Forth. I find the definitions of
+the instructions and instruction types especially elegant, and I find it to be
+a great demonstration of how concise and powerful Forth can be.</p>
+<p>All code in this post is licensed under the
+<a href="https://www.gnu.org/licenses/agpl-3.0.en.html#license-text">AGPLv3</a>.</p>
+
+
+
+
+
+<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-forth" data-lang="forth"><span class="line"><span class="ln"> 1</span><span class="cl"><span class="c1">\ encode stack values into proper instruction locations. all
+</span></span></span><span class="line"><span class="ln"> 2</span><span class="cl"><span class="c1">\ encoding sequences must begin with 'opcode'.
+</span></span></span><span class="line"><span class="ln"> 3</span><span class="cl"><span class="c1"></span><span class="kn">:</span> <span class="nc">opcode</span> <span class="k">hex </span> <span class="mi">7</span><span class="nf">F</span> <span class="k">and </span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 4</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">funct3</span> <span class="k">swap hex </span> <span class="mi">7</span> <span class="k">and decimal </span><span class="mi">12</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 5</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">funct7</span> <span class="k">swap hex </span> <span class="mi">7</span><span class="nf">F</span> <span class="k">and decimal </span><span class="mi">25</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 6</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">i-immed</span> <span class="k">swap hex </span> <span class="nf">FFF</span> <span class="k">and decimal </span><span class="mi">20</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 7</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">i-immed-shamt</span> <span class="k">swap hex </span> <span class="mi">1</span><span class="nf">F</span> <span class="k">and decimal </span><span class="mi">20</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 8</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">u-immed</span> <span class="k">swap hex </span> <span class="nf">FFFFF</span> <span class="k">and decimal </span><span class="mi">12</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 9</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">s-immed</span> <span class="k">over hex </span> <span class="nf">FE0</span> <span class="k">and decimal </span><span class="mi">20</span> <span class="k">lshift +
+</span></span></span><span class="line"><span class="ln"> 10</span><span class="cl"><span class="k"></span> <span class="k">swap hex </span> <span class="mi">1</span><span class="nf">F</span> <span class="k">and decimal </span> <span class="mi">7</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 11</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">j-immed</span> <span class="k">over hex </span><span class="mi">100000</span> <span class="k">and decimal </span><span class="mi">11</span> <span class="k">lshift +
+</span></span></span><span class="line"><span class="ln"> 12</span><span class="cl"><span class="k"></span> <span class="k">over hex </span> <span class="nf">FF000</span> <span class="k">and </span> <span class="k">+
+</span></span></span><span class="line"><span class="ln"> 13</span><span class="cl"><span class="k"></span> <span class="k">over hex </span> <span class="mi">800</span> <span class="k">and decimal </span> <span class="mi">9</span> <span class="k">lshift +
+</span></span></span><span class="line"><span class="ln"> 14</span><span class="cl"><span class="k"></span> <span class="k">swap hex </span> <span class="mi">7</span><span class="nf">FE</span> <span class="k">and decimal </span><span class="mi">20</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 15</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">b-immed</span> <span class="k">over hex </span> <span class="mi">1000</span> <span class="k">and decimal </span><span class="mi">19</span> <span class="k">lshift +
+</span></span></span><span class="line"><span class="ln"> 16</span><span class="cl"><span class="k"></span> <span class="k">over hex </span> <span class="mi">800</span> <span class="k">and decimal </span> <span class="mi">4</span> <span class="k">rshift +
+</span></span></span><span class="line"><span class="ln"> 17</span><span class="cl"><span class="k"></span> <span class="k">over hex </span> <span class="mi">7</span><span class="nf">E0</span> <span class="k">and decimal </span><span class="mi">20</span> <span class="k">lshift +
+</span></span></span><span class="line"><span class="ln"> 18</span><span class="cl"><span class="k"></span> <span class="k">swap hex </span> <span class="mi">1</span><span class="nf">E</span> <span class="k">and decimal </span> <span class="mi">7</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 19</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">rd</span> <span class="k">swap hex </span> <span class="mi">1</span><span class="nf">F</span> <span class="k">and decimal </span> <span class="mi">7</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 20</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">rs1</span> <span class="k">swap hex </span> <span class="mi">1</span><span class="nf">F</span> <span class="k">and decimal </span><span class="mi">15</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 21</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">rs2</span> <span class="k">swap hex </span> <span class="mi">1</span><span class="nf">F</span> <span class="k">and decimal </span><span class="mi">20</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 22</span><span class="cl"><span class="k"></span>
+</span></span><span class="line"><span class="ln"> 23</span><span class="cl"><span class="c1">\ instruction types. all instruction values should be pushed on the
+</span></span></span><span class="line"><span class="ln"> 24</span><span class="cl"><span class="c1">\ stack with the opcode last before calling.
+</span></span></span><span class="line"><span class="ln"> 25</span><span class="cl"><span class="c1"></span><span class="kn">:</span> <span class="nc">r-type</span> <span class="nf">opcode</span> <span class="nf">funct3</span> <span class="nf">funct7</span> <span class="nf">rs2</span> <span class="nf">rs1</span> <span class="nf">rd</span> <span class="k">, ;
+</span></span></span><span class="line"><span class="ln"> 26</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">i-type</span> <span class="nf">opcode</span> <span class="nf">funct3</span> <span class="nf">i-immed</span> <span class="nf">rs1</span> <span class="nf">rd</span> <span class="k">, ;
+</span></span></span><span class="line"><span class="ln"> 27</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">i-type-shamt</span> <span class="nf">opcode</span> <span class="nf">funct3</span> <span class="nf">funct7</span> <span class="nf">i-immed-shamt</span> <span class="nf">rs1</span> <span class="nf">rd</span> <span class="k">, ;
+</span></span></span><span class="line"><span class="ln"> 28</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">s-type</span> <span class="nf">opcode</span> <span class="nf">funct3</span> <span class="nf">s-immed</span> <span class="nf">rs2</span> <span class="nf">rs1</span> <span class="k">, ;
+</span></span></span><span class="line"><span class="ln"> 29</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">b-type</span> <span class="nf">opcode</span> <span class="nf">funct3</span> <span class="nf">b-immed</span> <span class="nf">rs2</span> <span class="nf">rs1</span> <span class="k">, ;
+</span></span></span><span class="line"><span class="ln"> 30</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">u-type</span> <span class="nf">opcode</span> <span class="nf">u-immed</span> <span class="nf">rd</span> <span class="k">, ;
+</span></span></span><span class="line"><span class="ln"> 31</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">j-type</span> <span class="nf">opcode</span> <span class="nf">j-immed</span> <span class="nf">rd</span> <span class="k">, ;
+</span></span></span><span class="line"><span class="ln"> 32</span><span class="cl"><span class="k"></span>
+</span></span><span class="line"><span class="ln"> 33</span><span class="cl"><span class="c1">\ instructions. these are just simple encodings, no assembler
+</span></span></span><span class="line"><span class="ln"> 34</span><span class="cl"><span class="c1">\ niceties yet.
+</span></span></span><span class="line"><span class="ln"> 35</span><span class="cl"><span class="c1">\ funct7 funct3 opcode encoding
+</span></span></span><span class="line"><span class="ln"> 36</span><span class="cl"><span class="c1"></span><span class="kn">:</span> <span class="nc">addi,</span> <span class="k">hex </span> <span class="mi">0</span> <span class="mi">13</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 37</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">andi,</span> <span class="k">hex </span> <span class="mi">7</span> <span class="mi">13</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 38</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">ori,</span> <span class="k">hex </span> <span class="mi">6</span> <span class="mi">13</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 39</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">xori,</span> <span class="k">hex </span> <span class="mi">4</span> <span class="mi">13</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 40</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">slli,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">1</span> <span class="mi">13</span> <span class="nf">i-type-shamt</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 41</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">srli,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">5</span> <span class="mi">13</span> <span class="nf">i-type-shamt</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 42</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">srai,</span> <span class="k">hex </span> <span class="mi">20</span> <span class="mi">5</span> <span class="mi">13</span> <span class="nf">i-type-shamt</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 43</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">slti,</span> <span class="k">hex </span> <span class="mi">2</span> <span class="mi">13</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 44</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sltiu,</span> <span class="k">hex </span> <span class="mi">3</span> <span class="mi">13</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 45</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">lui,</span> <span class="k">hex </span> <span class="mi">37</span> <span class="nf">u-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 46</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">auipc,</span> <span class="k">hex </span> <span class="mi">17</span> <span class="nf">u-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 47</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">add,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">0</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 48</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sub,</span> <span class="k">hex </span> <span class="mi">20</span> <span class="mi">0</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 49</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">and,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">7</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 50</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">or,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">6</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 51</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">xor,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">4</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 52</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sll,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">1</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 53</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">srl,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">5</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 54</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sra,</span> <span class="k">hex </span> <span class="mi">20</span> <span class="mi">5</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 55</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">slt,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">2</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 56</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sltu,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">3</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 57</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">jal,</span> <span class="k">hex </span> <span class="mi">6</span><span class="nf">F</span> <span class="nf">j-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 58</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">jalr,</span> <span class="k">hex </span> <span class="mi">0</span> <span class="mi">67</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 59</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">beq,</span> <span class="k">hex </span> <span class="mi">0</span> <span class="mi">63</span> <span class="nf">b-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 60</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">bne,</span> <span class="k">hex </span> <span class="mi">1</span> <span class="mi">63</span> <span class="nf">b-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 61</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">blt,</span> <span class="k">hex </span> <span class="mi">4</span> <span class="mi">63</span> <span class="nf">b-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 62</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">bltu,</span> <span class="k">hex </span> <span class="mi">6</span> <span class="mi">63</span> <span class="nf">b-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 63</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">bge,</span> <span class="k">hex </span> <span class="mi">5</span> <span class="mi">63</span> <span class="nf">b-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 64</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">bgeu,</span> <span class="k">hex </span> <span class="mi">7</span> <span class="mi">63</span> <span class="nf">b-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 65</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">lw,</span> <span class="k">hex </span> <span class="mi">2</span> <span class="mi">03</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 66</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">lh,</span> <span class="k">hex </span> <span class="mi">1</span> <span class="mi">03</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 67</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">lhu,</span> <span class="k">hex </span> <span class="mi">5</span> <span class="mi">03</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 68</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">lb,</span> <span class="k">hex </span> <span class="mi">0</span> <span class="mi">03</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 69</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sw,</span> <span class="k">hex </span> <span class="mi">2</span> <span class="mi">23</span> <span class="nf">s-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 70</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sh,</span> <span class="k">hex </span> <span class="mi">1</span> <span class="mi">23</span> <span class="nf">s-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 71</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sb,</span> <span class="k">hex </span> <span class="mi">0</span> <span class="mi">23</span> <span class="nf">s-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 72</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">fence,</span> <span class="k">hex </span> <span class="mi">0</span> <span class="mi">0</span><span class="nf">F</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 73</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">ecall,</span> <span class="k">hex </span> <span class="mi">0</span> <span class="mi">73</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 74</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">ebreak,</span> <span class="k">hex </span> <span class="mi">0</span> <span class="mi">73</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 75</span><span class="cl"><span class="k"></span>
+</span></span><span class="line"><span class="ln"> 76</span><span class="cl"><span class="c1">\ some instructions, now with nicer usage.
+</span></span></span><span class="line"><span class="ln"> 77</span><span class="cl"><span class="c1"></span><span class="kn">:</span> <span class="nc">sw,</span> <span class="k">>r swap r> </span><span class="nf">sw,</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 78</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sh,</span> <span class="k">>r swap r> </span><span class="nf">sh,</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 79</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sb,</span> <span class="k">>r swap r> </span><span class="nf">sb,</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 80</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">ecall,</span> <span class="mi">0</span> <span class="mi">0</span> <span class="mi">0</span> <span class="nf">ecall,</span> <span class="k">; </span> <span class="c1">\ usage: ecall,
+</span></span></span><span class="line"><span class="ln"> 81</span><span class="cl"><span class="c1"></span><span class="kn">:</span> <span class="nc">ebreak,</span> <span class="mi">0</span> <span class="mi">0</span> <span class="mi">1</span> <span class="nf">ebreak,</span> <span class="k">; </span> <span class="c1">\ usage: ebreak,
+</span></span></span><span class="line"><span class="ln"> 82</span><span class="cl"><span class="c1"></span><span class="kn">:</span> <span class="nc">fence,</span> <span class="k">>r </span><span class="mi">0</span> <span class="mi">0</span> <span class="k">r> </span><span class="nf">fence,</span> <span class="k">; </span><span class="c1">\ usage: imm fence,
+</span></span></span><span class="line"><span class="ln"> 83</span><span class="cl"><span class="c1"></span>
+</span></span><span class="line"><span class="ln"> 84</span><span class="cl"><span class="c1">\ registers
+</span></span></span><span class="line"><span class="ln"> 85</span><span class="cl"><span class="c1"></span><span class="k">decimal
+</span></span></span><span class="line"><span class="ln"> 86</span><span class="cl"><span class="k"></span> <span class="mi">0</span> <span class="kn">constant</span> <span class="nc">x0</span> <span class="mi">1</span> <span class="kn">constant</span> <span class="nc">x1</span> <span class="mi">2</span> <span class="kn">constant</span> <span class="nc">x2</span> <span class="mi">3</span> <span class="kn">constant</span> <span class="nc">x3</span>
+</span></span><span class="line"><span class="ln"> 87</span><span class="cl"> <span class="mi">4</span> <span class="kn">constant</span> <span class="nc">x4</span> <span class="mi">5</span> <span class="kn">constant</span> <span class="nc">x5</span> <span class="mi">6</span> <span class="kn">constant</span> <span class="nc">x6</span> <span class="mi">7</span> <span class="kn">constant</span> <span class="nc">x7</span>
+</span></span><span class="line"><span class="ln"> 88</span><span class="cl"> <span class="mi">8</span> <span class="kn">constant</span> <span class="nc">x8</span> <span class="mi">9</span> <span class="kn">constant</span> <span class="nc">x9</span> <span class="mi">10</span> <span class="kn">constant</span> <span class="nc">x10</span> <span class="mi">11</span> <span class="kn">constant</span> <span class="nc">x11</span>
+</span></span><span class="line"><span class="ln"> 89</span><span class="cl"><span class="mi">12</span> <span class="kn">constant</span> <span class="nc">x12</span> <span class="mi">13</span> <span class="kn">constant</span> <span class="nc">x13</span> <span class="mi">14</span> <span class="kn">constant</span> <span class="nc">x14</span> <span class="mi">15</span> <span class="kn">constant</span> <span class="nc">x15</span>
+</span></span><span class="line"><span class="ln"> 90</span><span class="cl"><span class="mi">16</span> <span class="kn">constant</span> <span class="nc">x16</span> <span class="mi">17</span> <span class="kn">constant</span> <span class="nc">x17</span> <span class="mi">18</span> <span class="kn">constant</span> <span class="nc">x18</span> <span class="mi">19</span> <span class="kn">constant</span> <span class="nc">x19</span>
+</span></span><span class="line"><span class="ln"> 91</span><span class="cl"><span class="mi">20</span> <span class="kn">constant</span> <span class="nc">x20</span> <span class="mi">21</span> <span class="kn">constant</span> <span class="nc">x21</span> <span class="mi">22</span> <span class="kn">constant</span> <span class="nc">x22</span> <span class="mi">23</span> <span class="kn">constant</span> <span class="nc">x23</span>
+</span></span><span class="line"><span class="ln"> 92</span><span class="cl"><span class="mi">24</span> <span class="kn">constant</span> <span class="nc">x24</span> <span class="mi">25</span> <span class="kn">constant</span> <span class="nc">x25</span> <span class="mi">26</span> <span class="kn">constant</span> <span class="nc">x26</span> <span class="mi">27</span> <span class="kn">constant</span> <span class="nc">x27</span>
+</span></span><span class="line"><span class="ln"> 93</span><span class="cl"><span class="mi">28</span> <span class="kn">constant</span> <span class="nc">x28</span> <span class="mi">29</span> <span class="kn">constant</span> <span class="nc">x29</span> <span class="mi">30</span> <span class="kn">constant</span> <span class="nc">x30</span> <span class="mi">31</span> <span class="kn">constant</span> <span class="nc">x31</span>
+</span></span><span class="line"><span class="ln"> 94</span><span class="cl">
+</span></span><span class="line"><span class="ln"> 95</span><span class="cl"><span class="c1">\ registers (calling convention)
+</span></span></span><span class="line"><span class="ln"> 96</span><span class="cl"><span class="c1"></span><span class="nf">x0</span> <span class="kn">constant</span> <span class="nc">zero</span> <span class="c1">\ zero constant
+</span></span></span><span class="line"><span class="ln"> 97</span><span class="cl"><span class="c1"></span><span class="nf">x1</span> <span class="kn">constant</span> <span class="nc">ra</span> <span class="c1">\ return address
+</span></span></span><span class="line"><span class="ln"> 98</span><span class="cl"><span class="c1"></span><span class="nf">x2</span> <span class="kn">constant</span> <span class="nc">sp</span> <span class="c1">\ stack pointer
+</span></span></span><span class="line"><span class="ln"> 99</span><span class="cl"><span class="c1"></span><span class="nf">x3</span> <span class="kn">constant</span> <span class="nc">gp</span> <span class="c1">\ global pointer
+</span></span></span><span class="line"><span class="ln">100</span><span class="cl"><span class="c1"></span><span class="nf">x4</span> <span class="kn">constant</span> <span class="nc">tp</span> <span class="c1">\ thread pointer
+</span></span></span><span class="line"><span class="ln">101</span><span class="cl"><span class="c1"></span><span class="nf">x8</span> <span class="kn">constant</span> <span class="nc">fp</span> <span class="c1">\ frame pointer
+</span></span></span><span class="line"><span class="ln">102</span><span class="cl"><span class="c1">\ function arguments / return values (a0, a1)
+</span></span></span><span class="line"><span class="ln">103</span><span class="cl"><span class="c1"></span><span class="nf">x10</span> <span class="kn">constant</span> <span class="nc">a0</span> <span class="nf">x11</span> <span class="kn">constant</span> <span class="nc">a1</span> <span class="nf">x12</span> <span class="kn">constant</span> <span class="nc">a2</span> <span class="nf">x13</span> <span class="kn">constant</span> <span class="nc">a3</span>
+</span></span><span class="line"><span class="ln">104</span><span class="cl"><span class="nf">x14</span> <span class="kn">constant</span> <span class="nc">a4</span> <span class="nf">x15</span> <span class="kn">constant</span> <span class="nc">a5</span> <span class="nf">x16</span> <span class="kn">constant</span> <span class="nc">a6</span> <span class="nf">x17</span> <span class="kn">constant</span> <span class="nc">a7</span>
+</span></span><span class="line"><span class="ln">105</span><span class="cl"><span class="c1">\ saved registers
+</span></span></span><span class="line"><span class="ln">106</span><span class="cl"><span class="c1"></span><span class="nf">x8</span> <span class="kn">constant</span> <span class="nc">s0</span> <span class="nf">x9</span> <span class="kn">constant</span> <span class="nc">s1</span> <span class="nf">x18</span> <span class="kn">constant</span> <span class="nc">s2</span> <span class="nf">x19</span> <span class="kn">constant</span> <span class="nc">s3</span>
+</span></span><span class="line"><span class="ln">107</span><span class="cl"><span class="nf">x20</span> <span class="kn">constant</span> <span class="nc">s4</span> <span class="nf">x21</span> <span class="kn">constant</span> <span class="nc">s5</span> <span class="nf">x22</span> <span class="kn">constant</span> <span class="nc">s6</span> <span class="nf">x23</span> <span class="kn">constant</span> <span class="nc">s7</span>
+</span></span><span class="line"><span class="ln">108</span><span class="cl"><span class="nf">x24</span> <span class="kn">constant</span> <span class="nc">s8</span> <span class="nf">x25</span> <span class="kn">constant</span> <span class="nc">s9</span> <span class="nf">x26</span> <span class="kn">constant</span> <span class="nc">s10</span> <span class="nf">x27</span> <span class="kn">constant</span> <span class="nc">s11</span>
+</span></span><span class="line"><span class="ln">109</span><span class="cl"><span class="c1">\ temporaries
+</span></span></span><span class="line"><span class="ln">110</span><span class="cl"><span class="c1"></span><span class="nf">x5</span> <span class="kn">constant</span> <span class="nc">t0</span> <span class="nf">x6</span> <span class="kn">constant</span> <span class="nc">t1</span> <span class="nf">x7</span> <span class="kn">constant</span> <span class="nc">t2</span> <span class="nf">x28</span> <span class="kn">constant</span> <span class="nc">t3</span>
+</span></span><span class="line"><span class="ln">111</span><span class="cl"><span class="nf">x29</span> <span class="kn">constant</span> <span class="nc">t4</span> <span class="nf">x30</span> <span class="kn">constant</span> <span class="nc">t5</span> <span class="nf">x31</span> <span class="kn">constant</span> <span class="nc">t6</span></span></span></code></pre></div><p>And here’s some tests to verify the instruction encodings are generated
+correctly:</p>
+
+
+
+
+
+<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-forth" data-lang="forth"><span class="line"><span class="ln"> 1</span><span class="cl"><span class="kn">:</span> <span class="nc">undo,</span> <span class="mi">-1</span> <span class="k">cells allot here @ ; </span><span class="c1">\ undoes the last ','
+</span></span></span><span class="line"><span class="ln"> 2</span><span class="cl"><span class="c1"></span><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">FF</span> <span class="nf">addi,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FF58513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln"> 3</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">FF</span> <span class="nf">andi,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FF5F513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln"> 4</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">FF</span> <span class="nf">ori,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FF5E513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln"> 5</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">FF</span> <span class="nf">xori,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FF5C513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln"> 6</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">slli,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">F59513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln"> 7</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">srli,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">F5D513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln"> 8</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">srai,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">40</span><span class="nf">F5D513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln"> 9</span><span class="cl"><span class="nf">t{</span> <span class="nf">t0</span> <span class="k">hex </span><span class="nf">FFFF</span> <span class="nf">lui,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FFFF2B7</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">10</span><span class="cl"><span class="nf">t{</span> <span class="nf">t0</span> <span class="k">hex </span><span class="nf">FFFF</span> <span class="nf">auipc,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FFFF297</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">11</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">FF</span> <span class="nf">slti,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FF5A513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">12</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">FF</span> <span class="nf">sltiu,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FF5B513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">13</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">add,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">C58533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">14</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">sub,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">40</span><span class="nf">C58533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">15</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">and,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">C5F533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">16</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">or,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">C5E533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">17</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">xor,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">C5C533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">18</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">sll,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">C59533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">19</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">srl,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">C5D533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">20</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">sra,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">40</span><span class="nf">C5D533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">21</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">slt,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">C5A533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">22</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">sltu,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">C5B533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">23</span><span class="cl"><span class="nf">t{</span> <span class="nf">ra</span> <span class="k">hex </span><span class="nf">FFFF</span> <span class="nf">jal,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">7</span><span class="nf">FF0F0EF</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">24</span><span class="cl"><span class="nf">t{</span> <span class="nf">ra</span> <span class="nf">a0</span> <span class="k">hex </span> <span class="nf">FF</span> <span class="nf">jalr,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FF500E7</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">25</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">beq,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">B50763</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">26</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">bne,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">B51763</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">27</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">blt,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">B54763</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">28</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">bltu,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">B56763</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">29</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">bge,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">B55763</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">30</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">bgeu,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">B57763</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">31</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">lw,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">F5A503</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">32</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">lh,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">F59503</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">33</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">lhu,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">F5D503</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">34</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">lb,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">F58503</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">35</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">sw,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">A5A7A3</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">36</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">sh,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">A597A3</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">37</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">sb,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">A587A3</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">38</span><span class="cl"><span class="nf">t{</span> <span class="k">hex </span> <span class="mi">0</span><span class="nf">FF</span> <span class="nf">fence,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FF0000F</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">39</span><span class="cl"><span class="nf">t{</span> <span class="nf">ecall,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00000073</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">40</span><span class="cl"><span class="nf">t{</span> <span class="nf">ebreak,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00100073</span> <span class="err">}t</span></span></span></code></pre></div>]]></content:encoded>
+ </item>
+ <item>
+ <title>The Infamous 'link' Macro</title>
+ <link>https://electrosoup.com/posts/the-infamous-link-macro/</link>
+ <pubDate>Tue, 12 Nov 2024 13:01:09 -0800</pubDate><author>christianermann@gmail.com (Christian Ermann)</author>
+ <guid>https://electrosoup.com/posts/the-infamous-link-macro/</guid>
+ <description><p>Each word (or function, in other languages) in Forth is stored as an entry in
a linked list known as the dictionary. When bootstrapping a Forth from
assembly, it is your responsibility to create and maintain this linked list
structure. This is a tedious process and is the source of many errors when
re-arranging words or defining new words; it&rsquo;s incredibly easy to turn your
list into a graph by mistake.</p></description>
+ <content:encoded><![CDATA[<p>Each word (or function, in other languages) in Forth is stored as an entry in
+a linked list known as the dictionary. When bootstrapping a Forth from
+assembly, it is your responsibility to create and maintain this linked list
+structure. This is a tedious process and is the source of many errors when
+re-arranging words or defining new words; it’s incredibly easy to turn your
+list into a graph by mistake.</p>
+<p>In
+<a href="https://rwmj.wordpress.com/2010/08/07/jonesforth-git-repository/">jonesforth</a>,
+an x86 implementation of Forth, the assembler supports re-assigning new values
+to assembler variables. This means an assember variable can be used to store
+the memory address of the previous entry, and we have the ability to update it
+or use it whenever we need to. I used this exact strategy in my
+<a href="https://git.christianermann.dev/forth/log.html">incomplete x86 Forth</a> although
+I used <a href="https://flatassembler.net/">FASM</a> instead of
+<a href="https://wiki.osdev.org/GAS">GAS</a>. Unfortunately, GAS doesn’t support this
+feature for ARM or RISC-V targets. It may be possible to pull this off on ARM
+with the right set of relocation and/or relaxation parameters, but I was unable
+to find success with RISC-V.</p>
+<p>I did come up with an alternative set of macros that achieves the same goal
+and should be more portable than the <code>jonesforth</code> solution:</p>
+
+
+
+
+
+<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-GAS" data-lang="GAS"><span class="line"><span class="ln"> 1</span><span class="cl"><span class="na">.macro</span> <span class="no">this_link</span>
+</span></span><span class="line"><span class="ln"> 2</span><span class="cl"> <span class="na">.globl</span> <span class="no">link_</span><span class="err">\+</span>
+</span></span><span class="line"><span class="ln"> 3</span><span class="cl"><span class="nf">link_</span><span class="err">\+</span><span class="p">:</span>
+</span></span><span class="line"><span class="ln"> 4</span><span class="cl"><span class="na">.endm</span>
+</span></span><span class="line"><span class="ln"> 5</span><span class="cl">
+</span></span><span class="line"><span class="ln"> 6</span><span class="cl"><span class="na">.macro</span> <span class="no">prev_link</span>
+</span></span><span class="line"><span class="ln"> 7</span><span class="cl"> <span class="na">.int</span> <span class="no">link_</span><span class="err">\+</span>
+</span></span><span class="line"><span class="ln"> 8</span><span class="cl"><span class="na">.endm</span>
+</span></span><span class="line"><span class="ln"> 9</span><span class="cl">
+</span></span><span class="line"><span class="ln">10</span><span class="cl"><span class="na">.macro</span> <span class="no">link</span>
+</span></span><span class="line"><span class="ln">11</span><span class="cl"> <span class="nf">this_link</span>
+</span></span><span class="line"><span class="ln">12</span><span class="cl"> <span class="nf">prev_link</span>
+</span></span><span class="line"><span class="ln">13</span><span class="cl"><span class="na">.endm</span>
+</span></span><span class="line"><span class="ln">14</span><span class="cl">
+</span></span><span class="line"><span class="ln">15</span><span class="cl"><span class="nf">this_link</span></span></span></code></pre></div><p>These macros depend on the special value
+
+
+
+
+<code class="code-inline language-GAS"><span class="err">\+</span></code>.
+This value is replaced by the invocation count of the current macro during
+assembly. Since we want to
+
+
+
+
+<code class="code-inline language-GAS"><span class="nf">link</span></code>
+back to the previous word in the dictionary, we need
+
+
+
+
+<code class="code-inline language-GAS"><span class="nf">prev_link</span></code>
+to resolve to 1 word before
+
+
+
+
+<code class="code-inline language-GAS"><span class="nf">this_link</span></code>,
+which is why we call
+
+
+
+
+<code class="code-inline language-GAS"><span class="nf">this_link</span></code>
+once before defining any words.</p>
+<p>You’ll also need to add this to your linker script to null-terminate your
+dictionary, otherwise the start of your dictionary will be marked by the
+address where the
+
+
+
+
+<code class="code-inline language-GAS"><span class="nf">link_0</span></code>
+label created by
+
+
+
+
+<code class="code-inline language-GAS"><span class="nf">this_link</span></code> was stored:</p>
+
+
+
+
+
+<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-GAS" data-lang="GAS"><span class="line"><span class="ln">1</span><span class="cl"><span class="nf">link_0</span> <span class="err">=</span> <span class="mi">0</span><span class="err">;</span></span></span></code></pre></div>]]></content:encoded>
+ </item>
+ <item>
+ <title>Writing a G-code Interpreter</title>
+ <link>https://electrosoup.com/posts/gcode-interpreter/</link>
+ <pubDate>Wed, 23 Oct 2024 16:29:40 -0700</pubDate><author>christianermann@gmail.com (Christian Ermann)</author>
+ <guid>https://electrosoup.com/posts/gcode-interpreter/</guid>
+ <description><p>I&rsquo;m currently working on a control system for a laser galvanometer (galvo) that
I want to use in a stereolithography (SLA) resin printer. I don&rsquo;t want to write
a custom slicer, as I feel like model slicing can be incredibly complicated and
existing free software (Cura, Slic3r, etc.) has many advanced features I don&rsquo;t
want to reimplement. However, this means my control system needs to understand
G-code, the language that these slicers output.</p></description>
+ <content:encoded><![CDATA[<p>I’m currently working on a control system for a laser galvanometer (galvo) that
+I want to use in a stereolithography (SLA) resin printer. I don’t want to write
+a custom slicer, as I feel like model slicing can be incredibly complicated and
+existing free software (Cura, Slic3r, etc.) has many advanced features I don’t
+want to reimplement. However, this means my control system needs to understand
+G-code, the language that these slicers output.</p>
+<p>As stated on the <a href="https://reprap.org/wiki/G-code">reprap wiki</a>, “G-code is a
+list of fields that are separated by white spaces or line breaks. A field can
+be interpreted as a command, parameter, or for any other special purpose.” For
+now, we’ll ignore any special purposes. Here is an example of G-code that
+describes a movement of the tool/hotend/laser to a specific location:</p>
+
+
+
+
+
+<pre tabindex="0"><code class="language-gcode" data-lang="gcode"> G1 X10.4 Y7.4 Z8.3</code></pre><p>I was able to parse commands with parameters using a two-stage procedure:</p>
+<pre><code>1. Retrieve the next white-space delimited token.
+2. Accumulate tokens until two separate command tokens are found.
+</code></pre>
+<p>This second step is important because we can’t begin executing a command until
+we’ve found all of its parameters and we don’t know if we’ve found all of its
+parameters until we find the next command.</p>
+<p>Once a command and all of its parameters have been parsed, it is passed to the
+controller which updates the state of the machine. For each command that the
+controller receives, it has to update its internal state, and in the case of
+physical movement commands, send the proper signal to the laser galvo. Most
+physical movement commands utilize interpolation so a timed control loop is
+utilized to ensure the laser follows as close to the intended path as possible.</p>
+<h2 id="system-diagram">System Diagram</h2>
+
+
+
+<div class="goat svg-container ">
+
+ <svg
+ xmlns="http://www.w3.org/2000/svg"
+ font-family="Menlo,Lucida Console,monospace"
+
+ viewBox="0 0 384 249"
+ >
+ <g transform='translate(8,16)'>
+<path d='M 80,16 L 296,16' fill='none' stroke='currentColor'></path>
+<path d='M 16,64 L 112,64' fill='none' stroke='currentColor'></path>
+<path d='M 256,64 L 368,64' fill='none' stroke='currentColor'></path>
+<path d='M 128,80 L 240,80' fill='none' stroke='currentColor'></path>
+<path d='M 16,96 L 112,96' fill='none' stroke='currentColor'></path>
+<path d='M 256,96 L 368,96' fill='none' stroke='currentColor'></path>
+<path d='M 80,144 L 296,144' fill='none' stroke='currentColor'></path>
+<path d='M 0,192 L 120,192' fill='none' stroke='currentColor'></path>
+<path d='M 256,192 L 368,192' fill='none' stroke='currentColor'></path>
+<path d='M 136,208 L 240,208' fill='none' stroke='currentColor'></path>
+<path d='M 0,224 L 120,224' fill='none' stroke='currentColor'></path>
+<path d='M 256,224 L 368,224' fill='none' stroke='currentColor'></path>
+<path d='M 0,192 L 0,224' fill='none' stroke='currentColor'></path>
+<path d='M 16,64 L 16,96' fill='none' stroke='currentColor'></path>
+<path d='M 64,32 L 64,48' fill='none' stroke='currentColor'></path>
+<path d='M 64,160 L 64,176' fill='none' stroke='currentColor'></path>
+<path d='M 112,64 L 112,96' fill='none' stroke='currentColor'></path>
+<path d='M 120,192 L 120,224' fill='none' stroke='currentColor'></path>
+<path d='M 256,64 L 256,96' fill='none' stroke='currentColor'></path>
+<path d='M 256,192 L 256,224' fill='none' stroke='currentColor'></path>
+<path d='M 312,32 L 312,48' fill='none' stroke='currentColor'></path>
+<path d='M 312,112 L 312,128' fill='none' stroke='currentColor'></path>
+<path d='M 368,64 L 368,96' fill='none' stroke='currentColor'></path>
+<path d='M 368,192 L 368,224' fill='none' stroke='currentColor'></path>
+<path d='M 312,48 L 312,56' fill='none' stroke='currentColor'></path>
+<path d='M 312,104 L 312,112' fill='none' stroke='currentColor'></path>
+<path d='M 64,48 L 64,56' fill='none' stroke='currentColor'></path>
+<polygon points='80.000000,48.000000 68.000000,42.400002 68.000000,53.599998' fill='currentColor' transform='rotate(90.000000, 64.000000, 48.000000)'></polygon>
+<path d='M 64,176 L 64,184' fill='none' stroke='currentColor'></path>
+<polygon points='80.000000,176.000000 68.000000,170.399994 68.000000,181.600006' fill='currentColor' transform='rotate(90.000000, 64.000000, 176.000000)'></polygon>
+<polygon points='248.000000,80.000000 236.000000,74.400002 236.000000,85.599998' fill='currentColor' transform='rotate(0.000000, 240.000000, 80.000000)'></polygon>
+<polygon points='248.000000,208.000000 236.000000,202.399994 236.000000,213.600006' fill='currentColor' transform='rotate(0.000000, 240.000000, 208.000000)'></polygon>
+<path d='M 80,16 A 16,16 0 0,0 64,32' fill='none' stroke='currentColor'></path>
+<path d='M 296,16 A 16,16 0 0,1 312,32' fill='none' stroke='currentColor'></path>
+<path d='M 80,144 A 16,16 0 0,0 64,160' fill='none' stroke='currentColor'></path>
+<path d='M 312,128 A 16,16 0 0,1 296,144' fill='none' stroke='currentColor'></path>
+<text text-anchor='middle' x='24' y='212' fill='currentColor' style='font-size:1em'>c</text>
+<text text-anchor='middle' x='32' y='84' fill='currentColor' style='font-size:1em'>t</text>
+<text text-anchor='middle' x='32' y='212' fill='currentColor' style='font-size:1em'>o</text>
+<text text-anchor='middle' x='40' y='84' fill='currentColor' style='font-size:1em'>o</text>
+<text text-anchor='middle' x='40' y='212' fill='currentColor' style='font-size:1em'>n</text>
+<text text-anchor='middle' x='48' y='84' fill='currentColor' style='font-size:1em'>k</text>
+<text text-anchor='middle' x='48' y='212' fill='currentColor' style='font-size:1em'>t</text>
+<text text-anchor='middle' x='56' y='84' fill='currentColor' style='font-size:1em'>e</text>
+<text text-anchor='middle' x='56' y='212' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='64' y='84' fill='currentColor' style='font-size:1em'>n</text>
+<text text-anchor='middle' x='64' y='212' fill='currentColor' style='font-size:1em'>o</text>
+<text text-anchor='middle' x='72' y='84' fill='currentColor' style='font-size:1em'>i</text>
+<text text-anchor='middle' x='72' y='212' fill='currentColor' style='font-size:1em'>l</text>
+<text text-anchor='middle' x='80' y='84' fill='currentColor' style='font-size:1em'>z</text>
+<text text-anchor='middle' x='80' y='212' fill='currentColor' style='font-size:1em'>l</text>
+<text text-anchor='middle' x='88' y='84' fill='currentColor' style='font-size:1em'>e</text>
+<text text-anchor='middle' x='88' y='212' fill='currentColor' style='font-size:1em'>e</text>
+<text text-anchor='middle' x='96' y='84' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='96' y='212' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='128' y='132' fill='currentColor' style='font-size:1em'>c</text>
+<text text-anchor='middle' x='136' y='132' fill='currentColor' style='font-size:1em'>o</text>
+<text text-anchor='middle' x='144' y='4' fill='currentColor' style='font-size:1em'>m</text>
+<text text-anchor='middle' x='144' y='132' fill='currentColor' style='font-size:1em'>m</text>
+<text text-anchor='middle' x='144' y='196' fill='currentColor' style='font-size:1em'>c</text>
+<text text-anchor='middle' x='152' y='4' fill='currentColor' style='font-size:1em'>o</text>
+<text text-anchor='middle' x='152' y='132' fill='currentColor' style='font-size:1em'>m</text>
+<text text-anchor='middle' x='152' y='196' fill='currentColor' style='font-size:1em'>t</text>
+<text text-anchor='middle' x='160' y='4' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='160' y='132' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='160' y='196' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='168' y='4' fill='currentColor' style='font-size:1em'>e</text>
+<text text-anchor='middle' x='168' y='68' fill='currentColor' style='font-size:1em'>t</text>
+<text text-anchor='middle' x='168' y='132' fill='currentColor' style='font-size:1em'>n</text>
+<text text-anchor='middle' x='168' y='196' fill='currentColor' style='font-size:1em'>l</text>
+<text text-anchor='middle' x='176' y='68' fill='currentColor' style='font-size:1em'>o</text>
+<text text-anchor='middle' x='176' y='132' fill='currentColor' style='font-size:1em'>d</text>
+<text text-anchor='middle' x='184' y='4' fill='currentColor' style='font-size:1em'>p</text>
+<text text-anchor='middle' x='184' y='68' fill='currentColor' style='font-size:1em'>k</text>
+<text text-anchor='middle' x='184' y='196' fill='currentColor' style='font-size:1em'>s</text>
+<text text-anchor='middle' x='192' y='4' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='192' y='68' fill='currentColor' style='font-size:1em'>e</text>
+<text text-anchor='middle' x='192' y='132' fill='currentColor' style='font-size:1em'>w</text>
+<text text-anchor='middle' x='192' y='196' fill='currentColor' style='font-size:1em'>i</text>
+<text text-anchor='middle' x='200' y='4' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='200' y='68' fill='currentColor' style='font-size:1em'>n</text>
+<text text-anchor='middle' x='200' y='132' fill='currentColor' style='font-size:1em'>/</text>
+<text text-anchor='middle' x='200' y='196' fill='currentColor' style='font-size:1em'>g</text>
+<text text-anchor='middle' x='208' y='4' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='208' y='196' fill='currentColor' style='font-size:1em'>n</text>
+<text text-anchor='middle' x='216' y='4' fill='currentColor' style='font-size:1em'>m</text>
+<text text-anchor='middle' x='216' y='132' fill='currentColor' style='font-size:1em'>p</text>
+<text text-anchor='middle' x='216' y='196' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='224' y='4' fill='currentColor' style='font-size:1em'>s</text>
+<text text-anchor='middle' x='224' y='132' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='224' y='196' fill='currentColor' style='font-size:1em'>l</text>
+<text text-anchor='middle' x='232' y='4' fill='currentColor' style='font-size:1em'>?</text>
+<text text-anchor='middle' x='232' y='132' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='240' y='132' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='248' y='132' fill='currentColor' style='font-size:1em'>m</text>
+<text text-anchor='middle' x='256' y='132' fill='currentColor' style='font-size:1em'>s</text>
+<text text-anchor='middle' x='272' y='84' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='272' y='212' fill='currentColor' style='font-size:1em'>l</text>
+<text text-anchor='middle' x='280' y='84' fill='currentColor' style='font-size:1em'>c</text>
+<text text-anchor='middle' x='280' y='212' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='288' y='84' fill='currentColor' style='font-size:1em'>c</text>
+<text text-anchor='middle' x='288' y='212' fill='currentColor' style='font-size:1em'>s</text>
+<text text-anchor='middle' x='296' y='84' fill='currentColor' style='font-size:1em'>u</text>
+<text text-anchor='middle' x='296' y='212' fill='currentColor' style='font-size:1em'>e</text>
+<text text-anchor='middle' x='304' y='84' fill='currentColor' style='font-size:1em'>m</text>
+<text text-anchor='middle' x='304' y='212' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='312' y='84' fill='currentColor' style='font-size:1em'>u</text>
+<text text-anchor='middle' x='320' y='84' fill='currentColor' style='font-size:1em'>l</text>
+<text text-anchor='middle' x='320' y='212' fill='currentColor' style='font-size:1em'>g</text>
+<text text-anchor='middle' x='328' y='84' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='328' y='212' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='336' y='84' fill='currentColor' style='font-size:1em'>t</text>
+<text text-anchor='middle' x='336' y='212' fill='currentColor' style='font-size:1em'>l</text>
+<text text-anchor='middle' x='344' y='84' fill='currentColor' style='font-size:1em'>o</text>
+<text text-anchor='middle' x='344' y='212' fill='currentColor' style='font-size:1em'>v</text>
+<text text-anchor='middle' x='352' y='84' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='352' y='212' fill='currentColor' style='font-size:1em'>o</text>
+</g>
+
+ </svg>
+
+</div>
+<h2 id="source-code">Source Code</h2>
+<p>The source code for the G-code interpreter can be found
+<a href="https://git.christianermann.dev/gcode-interpreter">here</a>. You may have issues
+accessing the link if your ISP doesn’t support IPv6 yet.</p>
+<p>Also, the names in the code are different than what’s shown in the diagram, so
+here’s the mapping to help out with understanding the code:</p>
+<table>
+ <thead>
+ <tr>
+ <th style="text-align: left">Diagram</th>
+ <th style="text-align: left">Source File</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td style="text-align: left">tokenizer</td>
+ <td style="text-align: left">token.c</td>
+ </tr>
+ <tr>
+ <td style="text-align: left">accumulator</td>
+ <td style="text-align: left">command.c</td>
+ </tr>
+ <tr>
+ <td style="text-align: left">controller</td>
+ <td style="text-align: left">machine.c</td>
+ </tr>
+ </tbody>
+</table>
+<p>I’ll try to keep this updated if the mapping changes as I continue to work on
+this project.</p>
+]]></content:encoded>
+ </item>
+ <item>
+ <title>Understanding Camera Look-At.</title>
+ <link>https://electrosoup.com/posts/look-at/</link>
+ <pubDate>Mon, 10 Oct 2022 00:31:00 -0400</pubDate><author>christianermann@gmail.com (Christian Ermann)</author>
+ <guid>https://electrosoup.com/posts/look-at/</guid>
+ <description><p>Often times, we want to position the camera in our scene at a particular point,
such as the head of the character in a first-person shooter or the cockpit of a
plane in a flight simulator. We also want the camera to look in the direction
that the player is trying to move.</p></description>
+ <content:encoded><![CDATA[<p>Often times, we want to position the camera in our scene at a particular point,
+such as the head of the character in a first-person shooter or the cockpit of a
+plane in a flight simulator. We also want the camera to look in the direction
+that the player is trying to move.</p>
+<p>To do this, we need to find the forward, right, and up vectors that correspond
+to the desired view.</p>
+<p>If we let $\vec{p}$ be the camera’s position and $\vec{t}$ be the position of
+what we want to look at, the camera’s look direction is
+$$\vec{l}=\vec{t}-\vec{p}\,.$$
+Conventionally, the camera looks down the negative forward axis so
+$$\vec{f}=-\vec{l}\,.$$</p>
+<p>In order to determine the right vector, we need a reference up direction,
+$\vec{up}$ (which isn’t necessarily orthogonal to $\vec{f}$). This enables us
+to calculate
+$$\vec{r} = \vec{f} \times \vec{up}$$
+and
+$$\vec{u} = \vec{r} \times \vec{f}\,.$$</p>
+<p>Now we can use the camera position $\vec{p}$ and normalized forms of $\vec{f}$,
+$\vec{r}$, and $\vec{u}$ to fill in our
+<a href="/posts/view-matrix/">view matrix</a>:</p>
+<p>$$
+V
+=
+\begin{bmatrix}
+r_{x} & r_{y} & r_{z} & -(\vec{r} \cdot \vec{p}) \\
+u_{x} & u_{y} & u_{z} & -(\vec{u} \cdot \vec{p}) \\
+f_{x} & f_{y} & f_{z} & -(\vec{f} \cdot \vec{p}) \\
+0 & 0 & 0 & 1
+\end{bmatrix}
+$$</p>
+]]></content:encoded>
+ </item>
+ <item>
+ <title>Deriving the View Matrix</title>
+ <link>https://electrosoup.com/posts/view-matrix/</link>
+ <pubDate>Sun, 21 Nov 2021 13:34:08 -0800</pubDate><author>christianermann@gmail.com (Christian Ermann)</author>
+ <guid>https://electrosoup.com/posts/view-matrix/</guid>
+ <description><p>In computer graphics, the view matrix is used to transform points from
world space into camera space. Below is an explanation of how to derive this
matrix.</p></description>
+ <content:encoded><![CDATA[<p>In computer graphics, the view matrix is used to transform points from
+world space into camera space. Below is an explanation of how to derive this
+matrix.</p>
+<p>Let $V$ be the view matrix.
+If $\vec{r}$, $\vec{u}$, and $\vec{f}$ denote the right, up, and forward
+vectors of the camera and $\vec{p}$ is the camera’s position, $V$ should
+satisfy the following properties:
+$$
+\begin{matrix}
+V_{1*} \times
+\begin{bmatrix}
+r_{x} \\
+r_{y} \\
+r_{z} \\
+0
+\end{bmatrix}
+=
+\begin{bmatrix}
+1 \\
+0 \\
+0 \\
+0
+\end{bmatrix},&
+V_{2*} \times
+\begin{bmatrix}
+u_{x} \\
+u_{y} \\
+u_{z} \\
+0
+\end{bmatrix}
+=
+\begin{bmatrix}
+0 \\
+1 \\
+0 \\
+0
+\end{bmatrix},&
+V_{3*} \times
+\begin{bmatrix}
+f_{x} \\
+f_{y} \\
+f_{z} \\
+0
+\end{bmatrix}
+=
+\begin{bmatrix}
+0 \\
+0 \\
+1 \\
+0
+\end{bmatrix},&
+V_{4*} \times
+\begin{bmatrix}
+p_{x} \\
+p_{y} \\
+p_{z} \\
+1
+\end{bmatrix}
+=
+\begin{bmatrix}
+0 \\
+0 \\
+0 \\
+1
+\end{bmatrix}
+\end{matrix}
+$$
+In words, the view matrix should translate the camera to the origin and rotate
+it to align with the $\vec{x}$, $\vec{y}$, and $\vec{z}$ axes.</p>
+<p>This can be expressed more concisely as the product of two matrices:
+$$
+V \times
+\begin{bmatrix}
+r_{x} & u_{x} & f_{x} & p_{x} \\
+r_{y} & u_{y} & f_{y} & p_{y} \\
+r_{z} & u_{z} & f_{z} & p_{z} \\
+0 & 0 & 0 & 1
+\end{bmatrix}
+=
+\begin{bmatrix}
+1 & 0 & 0 & 0 \\
+0 & 1 & 0 & 0 \\
+0 & 0 & 1 & 0 \\
+0 & 0 & 0 & 1
+\end{bmatrix}
+$$</p>
+<p>To make this equation easier to solve, we can split the matrix containing our
+camera parameters into the product of a translation matrix $T$ and a rotation
+matrix $R$:
+$$
+V \times (T \times R) = I
+$$
+where
+$$
+\begin{matrix}
+T =
+\begin{bmatrix}
+1 & 0 & 0 & p_{x} \\
+0 & 1 & 0 & p_{y} \\
+0 & 0 & 1 & p_{z} \\
+0 & 0 & 0 & 1
+\end{bmatrix},&
+R =
+\begin{bmatrix}
+r_{x} & u_{x} & f_{x} & 0 \\
+r_{y} & u_{y} & f_{y} & 0 \\
+r_{z} & u_{z} & f_{z} & 0 \\
+0 & 0 & 0 & 1
+\end{bmatrix}
+\end{matrix}
+$$</p>
+<p>Solving for $V$ reveals that $V=R^{-1} \times T^{-1}$:
+$$
+V =
+\begin{bmatrix}
+r_{x} & r_{y} & r_{z} & 0 \\
+u_{x} & u_{y} & u_{z} & 0 \\
+f_{x} & f_{y} & f_{z} & 0 \\
+0 & 0 & 0 & 1
+\end{bmatrix}
+\times
+\begin{bmatrix}
+1 & 0 & 0 & -p_{x} \\
+0 & 1 & 0 & -p_{y} \\
+0 & 0 & 1 & -p_{z} \\
+0 & 0 & 0 & 1
+\end{bmatrix}
+$$</p>
+<p>And with some minor simplification,
+$$
+V
+=
+\begin{bmatrix}
+r_{x} & r_{y} & r_{z} & -(\vec{r} \cdot \vec{p}) \\
+u_{x} & u_{y} & u_{z} & -(\vec{u} \cdot \vec{p}) \\
+f_{x} & f_{y} & f_{z} & -(\vec{f} \cdot \vec{p}) \\
+0 & 0 & 0 & 1
+\end{bmatrix}
+$$</p>
+<p>When we’re ready to render our scene, we can apply $V$ to each vertex $\vec{q}$
+by calculating
+$$
+V \times \vec{q}
+$$
+in our vertex shader.</p>
+]]></content:encoded>
+ </item>
+ <item>
+ <title>Unbind Your Vertex Array Objects.</title>
+ <link>https://electrosoup.com/posts/unbind/</link>
+ <pubDate>Wed, 25 Aug 2021 14:33:02 -0500</pubDate><author>christianermann@gmail.com (Christian Ermann)</author>
+ <guid>https://electrosoup.com/posts/unbind/</guid>
+ <description><p>When I first started learning about OpenGL, I always made sure to unbind each resource as soon as I was done using it. Over time I became more lenient with unbinding, as in many cases leaving resources bound is okay and leads to fewer API calls.</p></description>
+ <content:encoded><![CDATA[<p>When I first started learning about OpenGL, I always made sure to unbind each resource as soon as I was done using it. Over time I became more lenient with unbinding, as in many cases leaving resources bound is okay and leads to fewer API calls.</p>
+<p>In addition, when I’m developing on my PC I have access to the newer Direct State Access (DSA) functions, so binding resources isn’t something I have to worry about as much. However, I do a fair amount of programming on my macbook which means I don’t always have access to the DSA functions.</p>
+<p>I was working on a project recently that involved the vertex and index data for a mesh frequently changing. The actual mesh struct has a bit more going on, but we can think of it like this for now:</p>
+
+
+
+
+<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-c" data-lang="c"><span class="line"><span class="ln">1</span><span class="cl"><span class="k">typedef</span> <span class="k">struct</span> <span class="p">{</span>
+</span></span><span class="line"><span class="ln">2</span><span class="cl"> <span class="n">Vec3</span> <span class="o">*</span><span class="n">vertices</span><span class="p">;</span>
+</span></span><span class="line"><span class="ln">3</span><span class="cl"> <span class="n">GLuint</span> <span class="o">*</span><span class="n">indices</span><span class="p">;</span>
+</span></span><span class="line"><span class="ln">4</span><span class="cl"> <span class="n">GLuint</span> <span class="n">vao</span><span class="p">;</span>
+</span></span><span class="line"><span class="ln">5</span><span class="cl"> <span class="n">GLuint</span> <span class="n">vbo</span><span class="p">;</span>
+</span></span><span class="line"><span class="ln">6</span><span class="cl"> <span class="n">GLuint</span> <span class="n">ebo</span><span class="p">;</span>
+</span></span><span class="line"><span class="ln">7</span><span class="cl"><span class="p">}</span> <span class="n">Mesh</span><span class="p">;</span></span></span></code></pre></div>
+<p>So when it comes time to update the vertex or index data, we map the vertex buffer object to the vertices pointer and the element buffer object to the indices pointer. Then we can write all of our vertex and index data directly to the buffers, and then unmap them when we’re all done and need to draw.</p>
+
+
+
+
+<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-c" data-lang="c"><span class="line"><span class="ln"> 1</span><span class="cl"><span class="p">...</span>
+</span></span><span class="line"><span class="ln"> 2</span><span class="cl">
+</span></span><span class="line"><span class="ln"> 3</span><span class="cl"><span class="nf">glBindBuffer</span><span class="p">(</span><span class="n">GL_ARRAY_BUFFER</span><span class="p">,</span> <span class="n">mesh</span><span class="o">-></span><span class="n">vbo</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln"> 4</span><span class="cl"><span class="n">mesh</span><span class="o">-></span><span class="n">vertices</span> <span class="o">=</span> <span class="nf">glMapBuffer</span><span class="p">(</span><span class="n">GL_ARRAY_BUFFER</span><span class="p">,</span> <span class="n">GL_WRITE_ONLY</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln"> 5</span><span class="cl">
+</span></span><span class="line"><span class="ln"> 6</span><span class="cl"><span class="nf">glBindBuffer</span><span class="p">(</span><span class="n">GL_ELEMENT_ARRAY_BUFFER</span><span class="p">,</span> <span class="n">mesh</span><span class="o">-></span><span class="n">ebo</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln"> 7</span><span class="cl"><span class="n">mesh</span><span class="o">-></span><span class="n">indices</span> <span class="o">=</span> <span class="nf">glMapBuffer</span><span class="p">(</span><span class="n">GL_ELEMENT_ARRAY_BUFFER</span><span class="p">,</span> <span class="n">GL_WRITE_ONLY</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln"> 8</span><span class="cl">
+</span></span><span class="line"><span class="ln"> 9</span><span class="cl"><span class="c1">// While we have the buffers mapped, we can write data directly to
+</span></span></span><span class="line"><span class="ln">10</span><span class="cl"><span class="c1">// mesh->vertices and mesh->indices.
+</span></span></span><span class="line"><span class="ln">11</span><span class="cl"><span class="c1"></span>
+</span></span><span class="line"><span class="ln">12</span><span class="cl"><span class="nf">glBindBuffer</span><span class="p">(</span><span class="n">GL_ARRAY_BUFFER</span><span class="p">,</span> <span class="n">mesh</span><span class="o">-></span><span class="n">vbo</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln">13</span><span class="cl"><span class="nf">glUnmapBuffer</span><span class="p">(</span><span class="n">GL_ARRAY_BUFFER</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln">14</span><span class="cl"><span class="n">mesh</span><span class="o">-></span><span class="n">vertices</span> <span class="o">=</span> <span class="nb">NULL</span>
+</span></span><span class="line"><span class="ln">15</span><span class="cl">
+</span></span><span class="line"><span class="ln">16</span><span class="cl"><span class="nf">glBindBuffer</span><span class="p">(</span><span class="n">GL_ELEMENT_ARRAY_BUFFER</span><span class="p">,</span> <span class="n">mesh</span><span class="o">-></span><span class="n">ebo</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln">17</span><span class="cl"><span class="nf">glUnmapBuffer</span><span class="p">(</span><span class="n">GL_ELEMENT_ARRAY_BUFFER</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln">18</span><span class="cl"><span class="n">mesh</span><span class="o">-></span><span class="n">indices</span> <span class="o">=</span> <span class="nb">NULL</span>
+</span></span><span class="line"><span class="ln">19</span><span class="cl">
+</span></span><span class="line"><span class="ln">20</span><span class="cl"><span class="c1">// Now that the buffers are unmapped, we can draw the mesh again.
+</span></span></span><span class="line"><span class="ln">21</span><span class="cl"><span class="c1"></span>
+</span></span><span class="line"><span class="ln">22</span><span class="cl"><span class="p">...</span></span></span></code></pre></div>
+<p>Leaving the buffers bound in the above snippet didn’t cause problems and seemed a reasonable thing to do to reduce unnecessary OpenGL calls.
+The issues I was running into were actually caused by how I was drawing each mesh:</p>
+
+
+
+
+<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-c" data-lang="c"><span class="line"><span class="ln">1</span><span class="cl"><span class="p">...</span>
+</span></span><span class="line"><span class="ln">2</span><span class="cl">
+</span></span><span class="line"><span class="ln">3</span><span class="cl"><span class="nf">glBindVertexArray</span><span class="p">(</span><span class="n">mesh</span><span class="o">-></span><span class="n">vao</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln">4</span><span class="cl"><span class="nf">glDrawElements</span><span class="p">(...);</span>
+</span></span><span class="line"><span class="ln">5</span><span class="cl">
+</span></span><span class="line"><span class="ln">6</span><span class="cl"><span class="p">...</span></span></span></code></pre></div>
+<p>Since I wasn’t unbinding the mesh’s vertex array object when I finished drawing it, when I updated another mesh’s vertex or index data and bound that mesh’s buffer objects, the vertex array object I forgot to unbind would now be using the incorrect buffers to draw with.</p>
+<p>Luckily, there was a simple fix, and now I know to be more careful with unbinding vertex array objects:</p>
+
+
+
+
+<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-c" data-lang="c"><span class="line"><span class="ln">1</span><span class="cl"><span class="p">...</span>
+</span></span><span class="line"><span class="ln">2</span><span class="cl">
+</span></span><span class="line"><span class="ln">3</span><span class="cl"><span class="nf">glBindVertexArray</span><span class="p">(</span><span class="n">mesh</span><span class="o">-></span><span class="n">vao</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln">4</span><span class="cl"><span class="nf">glDrawElements</span><span class="p">(...);</span>
+</span></span><span class="line"><span class="ln">5</span><span class="cl"><span class="nf">glBindVertexArray</span><span class="p">(</span><span class="mi">0</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln">6</span><span class="cl">
+</span></span><span class="line"><span class="ln">7</span><span class="cl"><span class="p">...</span></span></span></code></pre></div>
+]]></content:encoded>
+ </item>
+ </channel>
+</rss>
diff --git a/posts/forth-rv32i-assembler/index.html b/posts/forth-rv32i-assembler/index.html
@@ -0,0 +1,302 @@
+<!DOCTYPE html>
+<html lang="en-US">
+
+<head>
+ <meta http-equiv="X-Clacks-Overhead" content="GNU Terry Pratchett" />
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+<link rel="shortcut icon" href="https://electrosoup.com/favicon.png" />
+<title>Forth RV32I Assembler | Electrosoup</title>
+<meta name="title" content="Forth RV32I Assembler" />
+<meta name="description" content="Here’s an assembler for RV32I that I wrote in Forth. I find the definitions of
+the instructions and instruction types especially elegant, and I find it to be
+a great demonstration of how concise and powerful Forth can be." />
+<meta name="author" content="" />
+<meta name="keywords" content="Forth,Assembly,RISC-V," />
+
+
+
+
+
+
+
+ <meta property="og:url" content="https://electrosoup.com/posts/forth-rv32i-assembler/">
+ <meta property="og:site_name" content="Electrosoup">
+ <meta property="og:title" content="Forth RV32I Assembler">
+ <meta property="og:description" content="Here’s an assembler for RV32I that I wrote in Forth. I find the definitions of the instructions and instruction types especially elegant, and I find it to be a great demonstration of how concise and powerful Forth can be.">
+ <meta property="og:locale" content="en_US">
+ <meta property="og:type" content="article">
+ <meta property="article:section" content="posts">
+ <meta property="article:published_time" content="2024-11-13T17:33:47-08:00">
+ <meta property="article:modified_time" content="2024-11-13T17:33:47-08:00">
+ <meta property="article:tag" content="Forth">
+ <meta property="article:tag" content="Assembly">
+ <meta property="article:tag" content="RISC-V">
+
+
+
+
+ <meta name="twitter:card" content="summary">
+ <meta name="twitter:title" content="Forth RV32I Assembler">
+ <meta name="twitter:description" content="Here’s an assembler for RV32I that I wrote in Forth. I find the definitions of the instructions and instruction types especially elegant, and I find it to be a great demonstration of how concise and powerful Forth can be.">
+
+
+
+
+ <meta itemprop="name" content="Forth RV32I Assembler">
+ <meta itemprop="description" content="Here’s an assembler for RV32I that I wrote in Forth. I find the definitions of the instructions and instruction types especially elegant, and I find it to be a great demonstration of how concise and powerful Forth can be.">
+ <meta itemprop="datePublished" content="2024-11-13T17:33:47-08:00">
+ <meta itemprop="dateModified" content="2024-11-13T17:33:47-08:00">
+ <meta itemprop="wordCount" content="1363">
+ <meta itemprop="keywords" content="Forth,Assembly,RISC-V">
+
+
+ <link href="/herman.min.css" rel="stylesheet">
+
+
+
+ <link href="/syntax.min.css" rel="stylesheet">
+
+
+
+
+
+</head>
+
+<body>
+ <header><a class="skip-link" href="#main-content">Skip to main content</a>
+
+<nav>
+ <a href="/">Main</a>
+
+ <a href="/posts/">Posts</a>
+
+ <a href="https://git.electrosoup.com">Code</a>
+
+ <a href="https://christianermann.dev">Resume</a>
+
+
+
+
+
+
+
+
+
+</nav>
+</header>
+ <main id="main-content">
+
+<h1>Forth RV32I Assembler</h1>
+<p class="byline">
+
+ <time datetime='2024-11-13' pubdate>
+ 2024-11-13
+ </time>
+
+</p>
+
+<content>
+ <p>Here’s an assembler for RV32I that I wrote in Forth. I find the definitions of
+the instructions and instruction types especially elegant, and I find it to be
+a great demonstration of how concise and powerful Forth can be.</p>
+<p>All code in this post is licensed under the
+<a href="https://www.gnu.org/licenses/agpl-3.0.en.html#license-text">AGPLv3</a>.</p>
+
+
+
+
+
+<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-forth" data-lang="forth"><span class="line"><span class="ln"> 1</span><span class="cl"><span class="c1">\ encode stack values into proper instruction locations. all
+</span></span></span><span class="line"><span class="ln"> 2</span><span class="cl"><span class="c1">\ encoding sequences must begin with 'opcode'.
+</span></span></span><span class="line"><span class="ln"> 3</span><span class="cl"><span class="c1"></span><span class="kn">:</span> <span class="nc">opcode</span> <span class="k">hex </span> <span class="mi">7</span><span class="nf">F</span> <span class="k">and </span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 4</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">funct3</span> <span class="k">swap hex </span> <span class="mi">7</span> <span class="k">and decimal </span><span class="mi">12</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 5</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">funct7</span> <span class="k">swap hex </span> <span class="mi">7</span><span class="nf">F</span> <span class="k">and decimal </span><span class="mi">25</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 6</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">i-immed</span> <span class="k">swap hex </span> <span class="nf">FFF</span> <span class="k">and decimal </span><span class="mi">20</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 7</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">i-immed-shamt</span> <span class="k">swap hex </span> <span class="mi">1</span><span class="nf">F</span> <span class="k">and decimal </span><span class="mi">20</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 8</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">u-immed</span> <span class="k">swap hex </span> <span class="nf">FFFFF</span> <span class="k">and decimal </span><span class="mi">12</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 9</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">s-immed</span> <span class="k">over hex </span> <span class="nf">FE0</span> <span class="k">and decimal </span><span class="mi">20</span> <span class="k">lshift +
+</span></span></span><span class="line"><span class="ln"> 10</span><span class="cl"><span class="k"></span> <span class="k">swap hex </span> <span class="mi">1</span><span class="nf">F</span> <span class="k">and decimal </span> <span class="mi">7</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 11</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">j-immed</span> <span class="k">over hex </span><span class="mi">100000</span> <span class="k">and decimal </span><span class="mi">11</span> <span class="k">lshift +
+</span></span></span><span class="line"><span class="ln"> 12</span><span class="cl"><span class="k"></span> <span class="k">over hex </span> <span class="nf">FF000</span> <span class="k">and </span> <span class="k">+
+</span></span></span><span class="line"><span class="ln"> 13</span><span class="cl"><span class="k"></span> <span class="k">over hex </span> <span class="mi">800</span> <span class="k">and decimal </span> <span class="mi">9</span> <span class="k">lshift +
+</span></span></span><span class="line"><span class="ln"> 14</span><span class="cl"><span class="k"></span> <span class="k">swap hex </span> <span class="mi">7</span><span class="nf">FE</span> <span class="k">and decimal </span><span class="mi">20</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 15</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">b-immed</span> <span class="k">over hex </span> <span class="mi">1000</span> <span class="k">and decimal </span><span class="mi">19</span> <span class="k">lshift +
+</span></span></span><span class="line"><span class="ln"> 16</span><span class="cl"><span class="k"></span> <span class="k">over hex </span> <span class="mi">800</span> <span class="k">and decimal </span> <span class="mi">4</span> <span class="k">rshift +
+</span></span></span><span class="line"><span class="ln"> 17</span><span class="cl"><span class="k"></span> <span class="k">over hex </span> <span class="mi">7</span><span class="nf">E0</span> <span class="k">and decimal </span><span class="mi">20</span> <span class="k">lshift +
+</span></span></span><span class="line"><span class="ln"> 18</span><span class="cl"><span class="k"></span> <span class="k">swap hex </span> <span class="mi">1</span><span class="nf">E</span> <span class="k">and decimal </span> <span class="mi">7</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 19</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">rd</span> <span class="k">swap hex </span> <span class="mi">1</span><span class="nf">F</span> <span class="k">and decimal </span> <span class="mi">7</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 20</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">rs1</span> <span class="k">swap hex </span> <span class="mi">1</span><span class="nf">F</span> <span class="k">and decimal </span><span class="mi">15</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 21</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">rs2</span> <span class="k">swap hex </span> <span class="mi">1</span><span class="nf">F</span> <span class="k">and decimal </span><span class="mi">20</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 22</span><span class="cl"><span class="k"></span>
+</span></span><span class="line"><span class="ln"> 23</span><span class="cl"><span class="c1">\ instruction types. all instruction values should be pushed on the
+</span></span></span><span class="line"><span class="ln"> 24</span><span class="cl"><span class="c1">\ stack with the opcode last before calling.
+</span></span></span><span class="line"><span class="ln"> 25</span><span class="cl"><span class="c1"></span><span class="kn">:</span> <span class="nc">r-type</span> <span class="nf">opcode</span> <span class="nf">funct3</span> <span class="nf">funct7</span> <span class="nf">rs2</span> <span class="nf">rs1</span> <span class="nf">rd</span> <span class="k">, ;
+</span></span></span><span class="line"><span class="ln"> 26</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">i-type</span> <span class="nf">opcode</span> <span class="nf">funct3</span> <span class="nf">i-immed</span> <span class="nf">rs1</span> <span class="nf">rd</span> <span class="k">, ;
+</span></span></span><span class="line"><span class="ln"> 27</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">i-type-shamt</span> <span class="nf">opcode</span> <span class="nf">funct3</span> <span class="nf">funct7</span> <span class="nf">i-immed-shamt</span> <span class="nf">rs1</span> <span class="nf">rd</span> <span class="k">, ;
+</span></span></span><span class="line"><span class="ln"> 28</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">s-type</span> <span class="nf">opcode</span> <span class="nf">funct3</span> <span class="nf">s-immed</span> <span class="nf">rs2</span> <span class="nf">rs1</span> <span class="k">, ;
+</span></span></span><span class="line"><span class="ln"> 29</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">b-type</span> <span class="nf">opcode</span> <span class="nf">funct3</span> <span class="nf">b-immed</span> <span class="nf">rs2</span> <span class="nf">rs1</span> <span class="k">, ;
+</span></span></span><span class="line"><span class="ln"> 30</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">u-type</span> <span class="nf">opcode</span> <span class="nf">u-immed</span> <span class="nf">rd</span> <span class="k">, ;
+</span></span></span><span class="line"><span class="ln"> 31</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">j-type</span> <span class="nf">opcode</span> <span class="nf">j-immed</span> <span class="nf">rd</span> <span class="k">, ;
+</span></span></span><span class="line"><span class="ln"> 32</span><span class="cl"><span class="k"></span>
+</span></span><span class="line"><span class="ln"> 33</span><span class="cl"><span class="c1">\ instructions. these are just simple encodings, no assembler
+</span></span></span><span class="line"><span class="ln"> 34</span><span class="cl"><span class="c1">\ niceties yet.
+</span></span></span><span class="line"><span class="ln"> 35</span><span class="cl"><span class="c1">\ funct7 funct3 opcode encoding
+</span></span></span><span class="line"><span class="ln"> 36</span><span class="cl"><span class="c1"></span><span class="kn">:</span> <span class="nc">addi,</span> <span class="k">hex </span> <span class="mi">0</span> <span class="mi">13</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 37</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">andi,</span> <span class="k">hex </span> <span class="mi">7</span> <span class="mi">13</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 38</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">ori,</span> <span class="k">hex </span> <span class="mi">6</span> <span class="mi">13</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 39</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">xori,</span> <span class="k">hex </span> <span class="mi">4</span> <span class="mi">13</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 40</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">slli,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">1</span> <span class="mi">13</span> <span class="nf">i-type-shamt</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 41</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">srli,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">5</span> <span class="mi">13</span> <span class="nf">i-type-shamt</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 42</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">srai,</span> <span class="k">hex </span> <span class="mi">20</span> <span class="mi">5</span> <span class="mi">13</span> <span class="nf">i-type-shamt</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 43</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">slti,</span> <span class="k">hex </span> <span class="mi">2</span> <span class="mi">13</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 44</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sltiu,</span> <span class="k">hex </span> <span class="mi">3</span> <span class="mi">13</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 45</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">lui,</span> <span class="k">hex </span> <span class="mi">37</span> <span class="nf">u-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 46</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">auipc,</span> <span class="k">hex </span> <span class="mi">17</span> <span class="nf">u-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 47</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">add,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">0</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 48</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sub,</span> <span class="k">hex </span> <span class="mi">20</span> <span class="mi">0</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 49</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">and,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">7</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 50</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">or,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">6</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 51</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">xor,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">4</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 52</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sll,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">1</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 53</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">srl,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">5</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 54</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sra,</span> <span class="k">hex </span> <span class="mi">20</span> <span class="mi">5</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 55</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">slt,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">2</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 56</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sltu,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">3</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 57</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">jal,</span> <span class="k">hex </span> <span class="mi">6</span><span class="nf">F</span> <span class="nf">j-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 58</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">jalr,</span> <span class="k">hex </span> <span class="mi">0</span> <span class="mi">67</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 59</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">beq,</span> <span class="k">hex </span> <span class="mi">0</span> <span class="mi">63</span> <span class="nf">b-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 60</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">bne,</span> <span class="k">hex </span> <span class="mi">1</span> <span class="mi">63</span> <span class="nf">b-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 61</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">blt,</span> <span class="k">hex </span> <span class="mi">4</span> <span class="mi">63</span> <span class="nf">b-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 62</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">bltu,</span> <span class="k">hex </span> <span class="mi">6</span> <span class="mi">63</span> <span class="nf">b-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 63</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">bge,</span> <span class="k">hex </span> <span class="mi">5</span> <span class="mi">63</span> <span class="nf">b-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 64</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">bgeu,</span> <span class="k">hex </span> <span class="mi">7</span> <span class="mi">63</span> <span class="nf">b-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 65</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">lw,</span> <span class="k">hex </span> <span class="mi">2</span> <span class="mi">03</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 66</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">lh,</span> <span class="k">hex </span> <span class="mi">1</span> <span class="mi">03</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 67</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">lhu,</span> <span class="k">hex </span> <span class="mi">5</span> <span class="mi">03</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 68</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">lb,</span> <span class="k">hex </span> <span class="mi">0</span> <span class="mi">03</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 69</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sw,</span> <span class="k">hex </span> <span class="mi">2</span> <span class="mi">23</span> <span class="nf">s-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 70</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sh,</span> <span class="k">hex </span> <span class="mi">1</span> <span class="mi">23</span> <span class="nf">s-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 71</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sb,</span> <span class="k">hex </span> <span class="mi">0</span> <span class="mi">23</span> <span class="nf">s-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 72</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">fence,</span> <span class="k">hex </span> <span class="mi">0</span> <span class="mi">0</span><span class="nf">F</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 73</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">ecall,</span> <span class="k">hex </span> <span class="mi">0</span> <span class="mi">73</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 74</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">ebreak,</span> <span class="k">hex </span> <span class="mi">0</span> <span class="mi">73</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 75</span><span class="cl"><span class="k"></span>
+</span></span><span class="line"><span class="ln"> 76</span><span class="cl"><span class="c1">\ some instructions, now with nicer usage.
+</span></span></span><span class="line"><span class="ln"> 77</span><span class="cl"><span class="c1"></span><span class="kn">:</span> <span class="nc">sw,</span> <span class="k">>r swap r> </span><span class="nf">sw,</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 78</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sh,</span> <span class="k">>r swap r> </span><span class="nf">sh,</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 79</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sb,</span> <span class="k">>r swap r> </span><span class="nf">sb,</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 80</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">ecall,</span> <span class="mi">0</span> <span class="mi">0</span> <span class="mi">0</span> <span class="nf">ecall,</span> <span class="k">; </span> <span class="c1">\ usage: ecall,
+</span></span></span><span class="line"><span class="ln"> 81</span><span class="cl"><span class="c1"></span><span class="kn">:</span> <span class="nc">ebreak,</span> <span class="mi">0</span> <span class="mi">0</span> <span class="mi">1</span> <span class="nf">ebreak,</span> <span class="k">; </span> <span class="c1">\ usage: ebreak,
+</span></span></span><span class="line"><span class="ln"> 82</span><span class="cl"><span class="c1"></span><span class="kn">:</span> <span class="nc">fence,</span> <span class="k">>r </span><span class="mi">0</span> <span class="mi">0</span> <span class="k">r> </span><span class="nf">fence,</span> <span class="k">; </span><span class="c1">\ usage: imm fence,
+</span></span></span><span class="line"><span class="ln"> 83</span><span class="cl"><span class="c1"></span>
+</span></span><span class="line"><span class="ln"> 84</span><span class="cl"><span class="c1">\ registers
+</span></span></span><span class="line"><span class="ln"> 85</span><span class="cl"><span class="c1"></span><span class="k">decimal
+</span></span></span><span class="line"><span class="ln"> 86</span><span class="cl"><span class="k"></span> <span class="mi">0</span> <span class="kn">constant</span> <span class="nc">x0</span> <span class="mi">1</span> <span class="kn">constant</span> <span class="nc">x1</span> <span class="mi">2</span> <span class="kn">constant</span> <span class="nc">x2</span> <span class="mi">3</span> <span class="kn">constant</span> <span class="nc">x3</span>
+</span></span><span class="line"><span class="ln"> 87</span><span class="cl"> <span class="mi">4</span> <span class="kn">constant</span> <span class="nc">x4</span> <span class="mi">5</span> <span class="kn">constant</span> <span class="nc">x5</span> <span class="mi">6</span> <span class="kn">constant</span> <span class="nc">x6</span> <span class="mi">7</span> <span class="kn">constant</span> <span class="nc">x7</span>
+</span></span><span class="line"><span class="ln"> 88</span><span class="cl"> <span class="mi">8</span> <span class="kn">constant</span> <span class="nc">x8</span> <span class="mi">9</span> <span class="kn">constant</span> <span class="nc">x9</span> <span class="mi">10</span> <span class="kn">constant</span> <span class="nc">x10</span> <span class="mi">11</span> <span class="kn">constant</span> <span class="nc">x11</span>
+</span></span><span class="line"><span class="ln"> 89</span><span class="cl"><span class="mi">12</span> <span class="kn">constant</span> <span class="nc">x12</span> <span class="mi">13</span> <span class="kn">constant</span> <span class="nc">x13</span> <span class="mi">14</span> <span class="kn">constant</span> <span class="nc">x14</span> <span class="mi">15</span> <span class="kn">constant</span> <span class="nc">x15</span>
+</span></span><span class="line"><span class="ln"> 90</span><span class="cl"><span class="mi">16</span> <span class="kn">constant</span> <span class="nc">x16</span> <span class="mi">17</span> <span class="kn">constant</span> <span class="nc">x17</span> <span class="mi">18</span> <span class="kn">constant</span> <span class="nc">x18</span> <span class="mi">19</span> <span class="kn">constant</span> <span class="nc">x19</span>
+</span></span><span class="line"><span class="ln"> 91</span><span class="cl"><span class="mi">20</span> <span class="kn">constant</span> <span class="nc">x20</span> <span class="mi">21</span> <span class="kn">constant</span> <span class="nc">x21</span> <span class="mi">22</span> <span class="kn">constant</span> <span class="nc">x22</span> <span class="mi">23</span> <span class="kn">constant</span> <span class="nc">x23</span>
+</span></span><span class="line"><span class="ln"> 92</span><span class="cl"><span class="mi">24</span> <span class="kn">constant</span> <span class="nc">x24</span> <span class="mi">25</span> <span class="kn">constant</span> <span class="nc">x25</span> <span class="mi">26</span> <span class="kn">constant</span> <span class="nc">x26</span> <span class="mi">27</span> <span class="kn">constant</span> <span class="nc">x27</span>
+</span></span><span class="line"><span class="ln"> 93</span><span class="cl"><span class="mi">28</span> <span class="kn">constant</span> <span class="nc">x28</span> <span class="mi">29</span> <span class="kn">constant</span> <span class="nc">x29</span> <span class="mi">30</span> <span class="kn">constant</span> <span class="nc">x30</span> <span class="mi">31</span> <span class="kn">constant</span> <span class="nc">x31</span>
+</span></span><span class="line"><span class="ln"> 94</span><span class="cl">
+</span></span><span class="line"><span class="ln"> 95</span><span class="cl"><span class="c1">\ registers (calling convention)
+</span></span></span><span class="line"><span class="ln"> 96</span><span class="cl"><span class="c1"></span><span class="nf">x0</span> <span class="kn">constant</span> <span class="nc">zero</span> <span class="c1">\ zero constant
+</span></span></span><span class="line"><span class="ln"> 97</span><span class="cl"><span class="c1"></span><span class="nf">x1</span> <span class="kn">constant</span> <span class="nc">ra</span> <span class="c1">\ return address
+</span></span></span><span class="line"><span class="ln"> 98</span><span class="cl"><span class="c1"></span><span class="nf">x2</span> <span class="kn">constant</span> <span class="nc">sp</span> <span class="c1">\ stack pointer
+</span></span></span><span class="line"><span class="ln"> 99</span><span class="cl"><span class="c1"></span><span class="nf">x3</span> <span class="kn">constant</span> <span class="nc">gp</span> <span class="c1">\ global pointer
+</span></span></span><span class="line"><span class="ln">100</span><span class="cl"><span class="c1"></span><span class="nf">x4</span> <span class="kn">constant</span> <span class="nc">tp</span> <span class="c1">\ thread pointer
+</span></span></span><span class="line"><span class="ln">101</span><span class="cl"><span class="c1"></span><span class="nf">x8</span> <span class="kn">constant</span> <span class="nc">fp</span> <span class="c1">\ frame pointer
+</span></span></span><span class="line"><span class="ln">102</span><span class="cl"><span class="c1">\ function arguments / return values (a0, a1)
+</span></span></span><span class="line"><span class="ln">103</span><span class="cl"><span class="c1"></span><span class="nf">x10</span> <span class="kn">constant</span> <span class="nc">a0</span> <span class="nf">x11</span> <span class="kn">constant</span> <span class="nc">a1</span> <span class="nf">x12</span> <span class="kn">constant</span> <span class="nc">a2</span> <span class="nf">x13</span> <span class="kn">constant</span> <span class="nc">a3</span>
+</span></span><span class="line"><span class="ln">104</span><span class="cl"><span class="nf">x14</span> <span class="kn">constant</span> <span class="nc">a4</span> <span class="nf">x15</span> <span class="kn">constant</span> <span class="nc">a5</span> <span class="nf">x16</span> <span class="kn">constant</span> <span class="nc">a6</span> <span class="nf">x17</span> <span class="kn">constant</span> <span class="nc">a7</span>
+</span></span><span class="line"><span class="ln">105</span><span class="cl"><span class="c1">\ saved registers
+</span></span></span><span class="line"><span class="ln">106</span><span class="cl"><span class="c1"></span><span class="nf">x8</span> <span class="kn">constant</span> <span class="nc">s0</span> <span class="nf">x9</span> <span class="kn">constant</span> <span class="nc">s1</span> <span class="nf">x18</span> <span class="kn">constant</span> <span class="nc">s2</span> <span class="nf">x19</span> <span class="kn">constant</span> <span class="nc">s3</span>
+</span></span><span class="line"><span class="ln">107</span><span class="cl"><span class="nf">x20</span> <span class="kn">constant</span> <span class="nc">s4</span> <span class="nf">x21</span> <span class="kn">constant</span> <span class="nc">s5</span> <span class="nf">x22</span> <span class="kn">constant</span> <span class="nc">s6</span> <span class="nf">x23</span> <span class="kn">constant</span> <span class="nc">s7</span>
+</span></span><span class="line"><span class="ln">108</span><span class="cl"><span class="nf">x24</span> <span class="kn">constant</span> <span class="nc">s8</span> <span class="nf">x25</span> <span class="kn">constant</span> <span class="nc">s9</span> <span class="nf">x26</span> <span class="kn">constant</span> <span class="nc">s10</span> <span class="nf">x27</span> <span class="kn">constant</span> <span class="nc">s11</span>
+</span></span><span class="line"><span class="ln">109</span><span class="cl"><span class="c1">\ temporaries
+</span></span></span><span class="line"><span class="ln">110</span><span class="cl"><span class="c1"></span><span class="nf">x5</span> <span class="kn">constant</span> <span class="nc">t0</span> <span class="nf">x6</span> <span class="kn">constant</span> <span class="nc">t1</span> <span class="nf">x7</span> <span class="kn">constant</span> <span class="nc">t2</span> <span class="nf">x28</span> <span class="kn">constant</span> <span class="nc">t3</span>
+</span></span><span class="line"><span class="ln">111</span><span class="cl"><span class="nf">x29</span> <span class="kn">constant</span> <span class="nc">t4</span> <span class="nf">x30</span> <span class="kn">constant</span> <span class="nc">t5</span> <span class="nf">x31</span> <span class="kn">constant</span> <span class="nc">t6</span></span></span></code></pre></div><p>And here’s some tests to verify the instruction encodings are generated
+correctly:</p>
+
+
+
+
+
+<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-forth" data-lang="forth"><span class="line"><span class="ln"> 1</span><span class="cl"><span class="kn">:</span> <span class="nc">undo,</span> <span class="mi">-1</span> <span class="k">cells allot here @ ; </span><span class="c1">\ undoes the last ','
+</span></span></span><span class="line"><span class="ln"> 2</span><span class="cl"><span class="c1"></span><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">FF</span> <span class="nf">addi,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FF58513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln"> 3</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">FF</span> <span class="nf">andi,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FF5F513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln"> 4</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">FF</span> <span class="nf">ori,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FF5E513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln"> 5</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">FF</span> <span class="nf">xori,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FF5C513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln"> 6</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">slli,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">F59513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln"> 7</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">srli,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">F5D513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln"> 8</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">srai,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">40</span><span class="nf">F5D513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln"> 9</span><span class="cl"><span class="nf">t{</span> <span class="nf">t0</span> <span class="k">hex </span><span class="nf">FFFF</span> <span class="nf">lui,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FFFF2B7</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">10</span><span class="cl"><span class="nf">t{</span> <span class="nf">t0</span> <span class="k">hex </span><span class="nf">FFFF</span> <span class="nf">auipc,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FFFF297</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">11</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">FF</span> <span class="nf">slti,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FF5A513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">12</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">FF</span> <span class="nf">sltiu,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FF5B513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">13</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">add,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">C58533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">14</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">sub,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">40</span><span class="nf">C58533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">15</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">and,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">C5F533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">16</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">or,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">C5E533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">17</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">xor,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">C5C533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">18</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">sll,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">C59533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">19</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">srl,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">C5D533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">20</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">sra,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">40</span><span class="nf">C5D533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">21</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">slt,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">C5A533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">22</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">sltu,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">C5B533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">23</span><span class="cl"><span class="nf">t{</span> <span class="nf">ra</span> <span class="k">hex </span><span class="nf">FFFF</span> <span class="nf">jal,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">7</span><span class="nf">FF0F0EF</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">24</span><span class="cl"><span class="nf">t{</span> <span class="nf">ra</span> <span class="nf">a0</span> <span class="k">hex </span> <span class="nf">FF</span> <span class="nf">jalr,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FF500E7</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">25</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">beq,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">B50763</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">26</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">bne,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">B51763</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">27</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">blt,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">B54763</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">28</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">bltu,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">B56763</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">29</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">bge,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">B55763</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">30</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">bgeu,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">B57763</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">31</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">lw,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">F5A503</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">32</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">lh,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">F59503</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">33</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">lhu,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">F5D503</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">34</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">lb,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">F58503</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">35</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">sw,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">A5A7A3</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">36</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">sh,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">A597A3</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">37</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">sb,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">A587A3</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">38</span><span class="cl"><span class="nf">t{</span> <span class="k">hex </span> <span class="mi">0</span><span class="nf">FF</span> <span class="nf">fence,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FF0000F</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">39</span><span class="cl"><span class="nf">t{</span> <span class="nf">ecall,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00000073</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">40</span><span class="cl"><span class="nf">t{</span> <span class="nf">ebreak,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00100073</span> <span class="err">}t</span></span></span></code></pre></div>
+</content>
+<p>
+
+ <a class="blog-tags" href="/tags/forth/">#forth</a>
+
+ <a class="blog-tags" href="/tags/assembly/">#assembly</a>
+
+ <a class="blog-tags" href="/tags/risc-v/">#risc-v</a>
+
+</p>
+
+
+ <p>
+ <a href='mailto:christianermann@gmail.com?subject=Reply%20to%20"Forth%20RV32I%20Assembler"'>
+ Reply to this post by email ↪
+ </a>
+ </p>
+
+
+
+ </main>
+ <footer><footer>
+
+ <a href="https://git.electrosoup.com">Code</a>.
+
+ <a href="https://christianermann.dev">Resume</a>.
+
+ <a href='https://electrosoup.com/index.xml'>RSS</a>.
+ <p>Copyright © 2026 Christian Ermann. | Made with <a href="https://github.com/clente/hugo-bearcub">Bear Cub</a></p>
+</footer>
+</footer>
+
+
+</body>
+
+</html>
diff --git a/posts/gcode-interpreter/index.html b/posts/gcode-interpreter/index.html
@@ -0,0 +1,333 @@
+<!DOCTYPE html>
+<html lang="en-US">
+
+<head>
+ <meta http-equiv="X-Clacks-Overhead" content="GNU Terry Pratchett" />
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+<link rel="shortcut icon" href="https://electrosoup.com/favicon.png" />
+<title>Writing a G-code Interpreter | Electrosoup</title>
+<meta name="title" content="Writing a G-code Interpreter" />
+<meta name="description" content="I’m currently working on a control system for a laser galvanometer (galvo) that
+I want to use in a stereolithography (SLA) resin printer. I don’t want to write
+a custom slicer, as I feel like model slicing can be incredibly complicated and
+existing free software (Cura, Slic3r, etc.) has many advanced features I don’t
+want to reimplement. However, this means my control system needs to understand
+G-code, the language that these slicers output." />
+<meta name="author" content="" />
+<meta name="keywords" content="G-Code,Lasers,C," />
+
+
+
+
+
+
+
+ <meta property="og:url" content="https://electrosoup.com/posts/gcode-interpreter/">
+ <meta property="og:site_name" content="Electrosoup">
+ <meta property="og:title" content="Writing a G-code Interpreter">
+ <meta property="og:description" content="I’m currently working on a control system for a laser galvanometer (galvo) that I want to use in a stereolithography (SLA) resin printer. I don’t want to write a custom slicer, as I feel like model slicing can be incredibly complicated and existing free software (Cura, Slic3r, etc.) has many advanced features I don’t want to reimplement. However, this means my control system needs to understand G-code, the language that these slicers output.">
+ <meta property="og:locale" content="en_US">
+ <meta property="og:type" content="article">
+ <meta property="article:section" content="posts">
+ <meta property="article:published_time" content="2024-10-23T16:29:40-07:00">
+ <meta property="article:modified_time" content="2024-10-23T16:29:40-07:00">
+ <meta property="article:tag" content="G-Code">
+ <meta property="article:tag" content="Lasers">
+ <meta property="article:tag" content="C">
+
+
+
+
+ <meta name="twitter:card" content="summary">
+ <meta name="twitter:title" content="Writing a G-code Interpreter">
+ <meta name="twitter:description" content="I’m currently working on a control system for a laser galvanometer (galvo) that I want to use in a stereolithography (SLA) resin printer. I don’t want to write a custom slicer, as I feel like model slicing can be incredibly complicated and existing free software (Cura, Slic3r, etc.) has many advanced features I don’t want to reimplement. However, this means my control system needs to understand G-code, the language that these slicers output.">
+
+
+
+
+ <meta itemprop="name" content="Writing a G-code Interpreter">
+ <meta itemprop="description" content="I’m currently working on a control system for a laser galvanometer (galvo) that I want to use in a stereolithography (SLA) resin printer. I don’t want to write a custom slicer, as I feel like model slicing can be incredibly complicated and existing free software (Cura, Slic3r, etc.) has many advanced features I don’t want to reimplement. However, this means my control system needs to understand G-code, the language that these slicers output.">
+ <meta itemprop="datePublished" content="2024-10-23T16:29:40-07:00">
+ <meta itemprop="dateModified" content="2024-10-23T16:29:40-07:00">
+ <meta itemprop="wordCount" content="443">
+ <meta itemprop="keywords" content="G-Code,Lasers,C">
+
+
+ <link href="/herman.min.css" rel="stylesheet">
+
+
+
+ <link href="/syntax.min.css" rel="stylesheet">
+
+
+
+
+
+</head>
+
+<body>
+ <header><a class="skip-link" href="#main-content">Skip to main content</a>
+
+<nav>
+ <a href="/">Main</a>
+
+ <a href="/posts/">Posts</a>
+
+ <a href="https://git.electrosoup.com">Code</a>
+
+ <a href="https://christianermann.dev">Resume</a>
+
+
+
+
+
+
+
+
+
+</nav>
+</header>
+ <main id="main-content">
+
+<h1>Writing a G-code Interpreter</h1>
+<p class="byline">
+
+ <time datetime='2024-10-23' pubdate>
+ 2024-10-23
+ </time>
+
+</p>
+
+<content>
+ <p>I’m currently working on a control system for a laser galvanometer (galvo) that
+I want to use in a stereolithography (SLA) resin printer. I don’t want to write
+a custom slicer, as I feel like model slicing can be incredibly complicated and
+existing free software (Cura, Slic3r, etc.) has many advanced features I don’t
+want to reimplement. However, this means my control system needs to understand
+G-code, the language that these slicers output.</p>
+<p>As stated on the <a href="https://reprap.org/wiki/G-code">reprap wiki</a>, “G-code is a
+list of fields that are separated by white spaces or line breaks. A field can
+be interpreted as a command, parameter, or for any other special purpose.” For
+now, we’ll ignore any special purposes. Here is an example of G-code that
+describes a movement of the tool/hotend/laser to a specific location:</p>
+
+
+
+
+
+<pre tabindex="0"><code class="language-gcode" data-lang="gcode"> G1 X10.4 Y7.4 Z8.3</code></pre><p>I was able to parse commands with parameters using a two-stage procedure:</p>
+<pre><code>1. Retrieve the next white-space delimited token.
+2. Accumulate tokens until two separate command tokens are found.
+</code></pre>
+<p>This second step is important because we can’t begin executing a command until
+we’ve found all of its parameters and we don’t know if we’ve found all of its
+parameters until we find the next command.</p>
+<p>Once a command and all of its parameters have been parsed, it is passed to the
+controller which updates the state of the machine. For each command that the
+controller receives, it has to update its internal state, and in the case of
+physical movement commands, send the proper signal to the laser galvo. Most
+physical movement commands utilize interpolation so a timed control loop is
+utilized to ensure the laser follows as close to the intended path as possible.</p>
+<h2 id="system-diagram">System Diagram</h2>
+
+
+
+<div class="goat svg-container ">
+
+ <svg
+ xmlns="http://www.w3.org/2000/svg"
+ font-family="Menlo,Lucida Console,monospace"
+
+ viewBox="0 0 384 249"
+ >
+ <g transform='translate(8,16)'>
+<path d='M 80,16 L 296,16' fill='none' stroke='currentColor'></path>
+<path d='M 16,64 L 112,64' fill='none' stroke='currentColor'></path>
+<path d='M 256,64 L 368,64' fill='none' stroke='currentColor'></path>
+<path d='M 128,80 L 240,80' fill='none' stroke='currentColor'></path>
+<path d='M 16,96 L 112,96' fill='none' stroke='currentColor'></path>
+<path d='M 256,96 L 368,96' fill='none' stroke='currentColor'></path>
+<path d='M 80,144 L 296,144' fill='none' stroke='currentColor'></path>
+<path d='M 0,192 L 120,192' fill='none' stroke='currentColor'></path>
+<path d='M 256,192 L 368,192' fill='none' stroke='currentColor'></path>
+<path d='M 136,208 L 240,208' fill='none' stroke='currentColor'></path>
+<path d='M 0,224 L 120,224' fill='none' stroke='currentColor'></path>
+<path d='M 256,224 L 368,224' fill='none' stroke='currentColor'></path>
+<path d='M 0,192 L 0,224' fill='none' stroke='currentColor'></path>
+<path d='M 16,64 L 16,96' fill='none' stroke='currentColor'></path>
+<path d='M 64,32 L 64,48' fill='none' stroke='currentColor'></path>
+<path d='M 64,160 L 64,176' fill='none' stroke='currentColor'></path>
+<path d='M 112,64 L 112,96' fill='none' stroke='currentColor'></path>
+<path d='M 120,192 L 120,224' fill='none' stroke='currentColor'></path>
+<path d='M 256,64 L 256,96' fill='none' stroke='currentColor'></path>
+<path d='M 256,192 L 256,224' fill='none' stroke='currentColor'></path>
+<path d='M 312,32 L 312,48' fill='none' stroke='currentColor'></path>
+<path d='M 312,112 L 312,128' fill='none' stroke='currentColor'></path>
+<path d='M 368,64 L 368,96' fill='none' stroke='currentColor'></path>
+<path d='M 368,192 L 368,224' fill='none' stroke='currentColor'></path>
+<path d='M 312,48 L 312,56' fill='none' stroke='currentColor'></path>
+<path d='M 312,104 L 312,112' fill='none' stroke='currentColor'></path>
+<path d='M 64,48 L 64,56' fill='none' stroke='currentColor'></path>
+<polygon points='80.000000,48.000000 68.000000,42.400002 68.000000,53.599998' fill='currentColor' transform='rotate(90.000000, 64.000000, 48.000000)'></polygon>
+<path d='M 64,176 L 64,184' fill='none' stroke='currentColor'></path>
+<polygon points='80.000000,176.000000 68.000000,170.399994 68.000000,181.600006' fill='currentColor' transform='rotate(90.000000, 64.000000, 176.000000)'></polygon>
+<polygon points='248.000000,80.000000 236.000000,74.400002 236.000000,85.599998' fill='currentColor' transform='rotate(0.000000, 240.000000, 80.000000)'></polygon>
+<polygon points='248.000000,208.000000 236.000000,202.399994 236.000000,213.600006' fill='currentColor' transform='rotate(0.000000, 240.000000, 208.000000)'></polygon>
+<path d='M 80,16 A 16,16 0 0,0 64,32' fill='none' stroke='currentColor'></path>
+<path d='M 296,16 A 16,16 0 0,1 312,32' fill='none' stroke='currentColor'></path>
+<path d='M 80,144 A 16,16 0 0,0 64,160' fill='none' stroke='currentColor'></path>
+<path d='M 312,128 A 16,16 0 0,1 296,144' fill='none' stroke='currentColor'></path>
+<text text-anchor='middle' x='24' y='212' fill='currentColor' style='font-size:1em'>c</text>
+<text text-anchor='middle' x='32' y='84' fill='currentColor' style='font-size:1em'>t</text>
+<text text-anchor='middle' x='32' y='212' fill='currentColor' style='font-size:1em'>o</text>
+<text text-anchor='middle' x='40' y='84' fill='currentColor' style='font-size:1em'>o</text>
+<text text-anchor='middle' x='40' y='212' fill='currentColor' style='font-size:1em'>n</text>
+<text text-anchor='middle' x='48' y='84' fill='currentColor' style='font-size:1em'>k</text>
+<text text-anchor='middle' x='48' y='212' fill='currentColor' style='font-size:1em'>t</text>
+<text text-anchor='middle' x='56' y='84' fill='currentColor' style='font-size:1em'>e</text>
+<text text-anchor='middle' x='56' y='212' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='64' y='84' fill='currentColor' style='font-size:1em'>n</text>
+<text text-anchor='middle' x='64' y='212' fill='currentColor' style='font-size:1em'>o</text>
+<text text-anchor='middle' x='72' y='84' fill='currentColor' style='font-size:1em'>i</text>
+<text text-anchor='middle' x='72' y='212' fill='currentColor' style='font-size:1em'>l</text>
+<text text-anchor='middle' x='80' y='84' fill='currentColor' style='font-size:1em'>z</text>
+<text text-anchor='middle' x='80' y='212' fill='currentColor' style='font-size:1em'>l</text>
+<text text-anchor='middle' x='88' y='84' fill='currentColor' style='font-size:1em'>e</text>
+<text text-anchor='middle' x='88' y='212' fill='currentColor' style='font-size:1em'>e</text>
+<text text-anchor='middle' x='96' y='84' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='96' y='212' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='128' y='132' fill='currentColor' style='font-size:1em'>c</text>
+<text text-anchor='middle' x='136' y='132' fill='currentColor' style='font-size:1em'>o</text>
+<text text-anchor='middle' x='144' y='4' fill='currentColor' style='font-size:1em'>m</text>
+<text text-anchor='middle' x='144' y='132' fill='currentColor' style='font-size:1em'>m</text>
+<text text-anchor='middle' x='144' y='196' fill='currentColor' style='font-size:1em'>c</text>
+<text text-anchor='middle' x='152' y='4' fill='currentColor' style='font-size:1em'>o</text>
+<text text-anchor='middle' x='152' y='132' fill='currentColor' style='font-size:1em'>m</text>
+<text text-anchor='middle' x='152' y='196' fill='currentColor' style='font-size:1em'>t</text>
+<text text-anchor='middle' x='160' y='4' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='160' y='132' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='160' y='196' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='168' y='4' fill='currentColor' style='font-size:1em'>e</text>
+<text text-anchor='middle' x='168' y='68' fill='currentColor' style='font-size:1em'>t</text>
+<text text-anchor='middle' x='168' y='132' fill='currentColor' style='font-size:1em'>n</text>
+<text text-anchor='middle' x='168' y='196' fill='currentColor' style='font-size:1em'>l</text>
+<text text-anchor='middle' x='176' y='68' fill='currentColor' style='font-size:1em'>o</text>
+<text text-anchor='middle' x='176' y='132' fill='currentColor' style='font-size:1em'>d</text>
+<text text-anchor='middle' x='184' y='4' fill='currentColor' style='font-size:1em'>p</text>
+<text text-anchor='middle' x='184' y='68' fill='currentColor' style='font-size:1em'>k</text>
+<text text-anchor='middle' x='184' y='196' fill='currentColor' style='font-size:1em'>s</text>
+<text text-anchor='middle' x='192' y='4' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='192' y='68' fill='currentColor' style='font-size:1em'>e</text>
+<text text-anchor='middle' x='192' y='132' fill='currentColor' style='font-size:1em'>w</text>
+<text text-anchor='middle' x='192' y='196' fill='currentColor' style='font-size:1em'>i</text>
+<text text-anchor='middle' x='200' y='4' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='200' y='68' fill='currentColor' style='font-size:1em'>n</text>
+<text text-anchor='middle' x='200' y='132' fill='currentColor' style='font-size:1em'>/</text>
+<text text-anchor='middle' x='200' y='196' fill='currentColor' style='font-size:1em'>g</text>
+<text text-anchor='middle' x='208' y='4' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='208' y='196' fill='currentColor' style='font-size:1em'>n</text>
+<text text-anchor='middle' x='216' y='4' fill='currentColor' style='font-size:1em'>m</text>
+<text text-anchor='middle' x='216' y='132' fill='currentColor' style='font-size:1em'>p</text>
+<text text-anchor='middle' x='216' y='196' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='224' y='4' fill='currentColor' style='font-size:1em'>s</text>
+<text text-anchor='middle' x='224' y='132' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='224' y='196' fill='currentColor' style='font-size:1em'>l</text>
+<text text-anchor='middle' x='232' y='4' fill='currentColor' style='font-size:1em'>?</text>
+<text text-anchor='middle' x='232' y='132' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='240' y='132' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='248' y='132' fill='currentColor' style='font-size:1em'>m</text>
+<text text-anchor='middle' x='256' y='132' fill='currentColor' style='font-size:1em'>s</text>
+<text text-anchor='middle' x='272' y='84' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='272' y='212' fill='currentColor' style='font-size:1em'>l</text>
+<text text-anchor='middle' x='280' y='84' fill='currentColor' style='font-size:1em'>c</text>
+<text text-anchor='middle' x='280' y='212' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='288' y='84' fill='currentColor' style='font-size:1em'>c</text>
+<text text-anchor='middle' x='288' y='212' fill='currentColor' style='font-size:1em'>s</text>
+<text text-anchor='middle' x='296' y='84' fill='currentColor' style='font-size:1em'>u</text>
+<text text-anchor='middle' x='296' y='212' fill='currentColor' style='font-size:1em'>e</text>
+<text text-anchor='middle' x='304' y='84' fill='currentColor' style='font-size:1em'>m</text>
+<text text-anchor='middle' x='304' y='212' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='312' y='84' fill='currentColor' style='font-size:1em'>u</text>
+<text text-anchor='middle' x='320' y='84' fill='currentColor' style='font-size:1em'>l</text>
+<text text-anchor='middle' x='320' y='212' fill='currentColor' style='font-size:1em'>g</text>
+<text text-anchor='middle' x='328' y='84' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='328' y='212' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='336' y='84' fill='currentColor' style='font-size:1em'>t</text>
+<text text-anchor='middle' x='336' y='212' fill='currentColor' style='font-size:1em'>l</text>
+<text text-anchor='middle' x='344' y='84' fill='currentColor' style='font-size:1em'>o</text>
+<text text-anchor='middle' x='344' y='212' fill='currentColor' style='font-size:1em'>v</text>
+<text text-anchor='middle' x='352' y='84' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='352' y='212' fill='currentColor' style='font-size:1em'>o</text>
+</g>
+
+ </svg>
+
+</div>
+<h2 id="source-code">Source Code</h2>
+<p>The source code for the G-code interpreter can be found
+<a href="https://git.christianermann.dev/gcode-interpreter">here</a>. You may have issues
+accessing the link if your ISP doesn’t support IPv6 yet.</p>
+<p>Also, the names in the code are different than what’s shown in the diagram, so
+here’s the mapping to help out with understanding the code:</p>
+<table>
+ <thead>
+ <tr>
+ <th style="text-align: left">Diagram</th>
+ <th style="text-align: left">Source File</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td style="text-align: left">tokenizer</td>
+ <td style="text-align: left">token.c</td>
+ </tr>
+ <tr>
+ <td style="text-align: left">accumulator</td>
+ <td style="text-align: left">command.c</td>
+ </tr>
+ <tr>
+ <td style="text-align: left">controller</td>
+ <td style="text-align: left">machine.c</td>
+ </tr>
+ </tbody>
+</table>
+<p>I’ll try to keep this updated if the mapping changes as I continue to work on
+this project.</p>
+
+</content>
+<p>
+
+ <a class="blog-tags" href="/tags/g-code/">#g-code</a>
+
+ <a class="blog-tags" href="/tags/lasers/">#lasers</a>
+
+ <a class="blog-tags" href="/tags/c/">#c</a>
+
+</p>
+
+
+ <p>
+ <a href='mailto:christianermann@gmail.com?subject=Reply%20to%20"Writing%20a%20G-code%20Interpreter"'>
+ Reply to this post by email ↪
+ </a>
+ </p>
+
+
+
+ </main>
+ <footer><footer>
+
+ <a href="https://git.electrosoup.com">Code</a>.
+
+ <a href="https://christianermann.dev">Resume</a>.
+
+ <a href='https://electrosoup.com/index.xml'>RSS</a>.
+ <p>Copyright © 2026 Christian Ermann. | Made with <a href="https://github.com/clente/hugo-bearcub">Bear Cub</a></p>
+</footer>
+</footer>
+
+
+</body>
+
+</html>
diff --git a/posts/index.html b/posts/index.html
@@ -0,0 +1,202 @@
+<!DOCTYPE html>
+<html lang="en-US">
+
+<head>
+ <meta http-equiv="X-Clacks-Overhead" content="GNU Terry Pratchett" />
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+<link rel="shortcut icon" href="https://electrosoup.com/favicon.png" />
+<title>Posts | Electrosoup</title>
+<meta name="title" content="Posts" />
+<meta name="description" content="Stuff I'm working on." />
+<meta name="author" content="" />
+<meta name="keywords" content="arm,assembly,c,forth,g-code,graphics,lasers,matrices,opengl,risc-v," />
+
+
+
+
+
+
+
+ <meta property="og:url" content="https://electrosoup.com/posts/">
+ <meta property="og:site_name" content="Electrosoup">
+ <meta property="og:title" content="Posts">
+ <meta property="og:description" content="Stuff I'm working on.">
+ <meta property="og:locale" content="en_US">
+ <meta property="og:type" content="website">
+
+
+
+
+ <meta name="twitter:card" content="summary">
+ <meta name="twitter:title" content="Posts">
+ <meta name="twitter:description" content="Stuff I'm working on.">
+
+
+
+
+ <meta itemprop="name" content="Posts">
+ <meta itemprop="description" content="Stuff I'm working on.">
+ <meta itemprop="datePublished" content="2026-10-03T17:07:00-05:00">
+ <meta itemprop="dateModified" content="2026-10-03T17:07:00-05:00">
+
+
+ <link href="/herman.min.css" rel="stylesheet">
+
+
+
+
+
+ <link rel="alternate" type="application/rss+xml" href="https://electrosoup.com/posts/index.xml" title="Electrosoup" />
+
+</head>
+
+<body>
+ <header><a class="skip-link" href="#main-content">Skip to main content</a>
+
+<nav>
+ <a href="/">Main</a>
+
+ <a href="/posts/">Posts</a>
+
+ <a href="https://git.electrosoup.com">Code</a>
+
+ <a href="https://christianermann.dev">Resume</a>
+
+
+
+
+
+
+
+
+
+</nav>
+</header>
+ <main id="main-content">
+<content>
+
+ <ul class="blog-posts">
+
+ <li>
+ <span>
+ <i>
+ <time datetime='2024-11-13' pubdate>
+ 2024-11-13
+ </time>
+ </i>
+ </span>
+
+ <a href="/posts/forth-rv32i-assembler/">Forth RV32I Assembler</a>
+
+ </li>
+
+ <li>
+ <span>
+ <i>
+ <time datetime='2024-11-12' pubdate>
+ 2024-11-12
+ </time>
+ </i>
+ </span>
+
+ <a href="/posts/the-infamous-link-macro/">The Infamous 'link' Macro</a>
+
+ </li>
+
+ <li>
+ <span>
+ <i>
+ <time datetime='2024-10-23' pubdate>
+ 2024-10-23
+ </time>
+ </i>
+ </span>
+
+ <a href="/posts/gcode-interpreter/">Writing a G-code Interpreter</a>
+
+ </li>
+
+ <li>
+ <span>
+ <i>
+ <time datetime='2022-10-10' pubdate>
+ 2022-10-10
+ </time>
+ </i>
+ </span>
+
+ <a href="/posts/look-at/">Understanding Camera Look-At.</a>
+
+ </li>
+
+ <li>
+ <span>
+ <i>
+ <time datetime='2021-11-21' pubdate>
+ 2021-11-21
+ </time>
+ </i>
+ </span>
+
+ <a href="/posts/view-matrix/">Deriving the View Matrix</a>
+
+ </li>
+
+ <li>
+ <span>
+ <i>
+ <time datetime='2021-08-25' pubdate>
+ 2021-08-25
+ </time>
+ </i>
+ </span>
+
+ <a href="/posts/unbind/">Unbind Your Vertex Array Objects.</a>
+
+ </li>
+
+ </ul>
+
+ <div>
+
+ <a class="blog-tags" href="/tags/arm/">#arm</a>
+
+ <a class="blog-tags" href="/tags/assembly/">#assembly</a>
+
+ <a class="blog-tags" href="/tags/c/">#c</a>
+
+ <a class="blog-tags" href="/tags/forth/">#forth</a>
+
+ <a class="blog-tags" href="/tags/g-code/">#g-code</a>
+
+ <a class="blog-tags" href="/tags/graphics/">#graphics</a>
+
+ <a class="blog-tags" href="/tags/lasers/">#lasers</a>
+
+ <a class="blog-tags" href="/tags/matrices/">#matrices</a>
+
+ <a class="blog-tags" href="/tags/opengl/">#opengl</a>
+
+ <a class="blog-tags" href="/tags/risc-v/">#risc-v</a>
+
+ </div>
+
+</content>
+
+ </main>
+ <footer><footer>
+
+ <a href="https://git.electrosoup.com">Code</a>.
+
+ <a href="https://christianermann.dev">Resume</a>.
+
+ <a href='https://electrosoup.com/index.xml'>RSS</a>.
+ <p>Copyright © 2026 Christian Ermann. | Made with <a href="https://github.com/clente/hugo-bearcub">Bear Cub</a></p>
+</footer>
+</footer>
+
+
+</body>
+
+</html>
diff --git a/posts/index.xml b/posts/index.xml
@@ -0,0 +1,753 @@
+<?xml version="1.0" encoding="utf-8" standalone="yes"?>
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/">
+ <channel>
+ <title>Posts on Electrosoup</title>
+ <link>https://electrosoup.com/posts/</link>
+ <description>Recent content in Posts on Electrosoup</description>
+ <generator>Hugo -- gohugo.io</generator>
+ <language>en-US</language>
+ <managingEditor>christianermann@gmail.com (Christian Ermann)</managingEditor>
+ <webMaster>christianermann@gmail.com (Christian Ermann)</webMaster>
+ <lastBuildDate>Sat, 03 Oct 2026 17:07:00 -0500</lastBuildDate>
+ <atom:link href="https://electrosoup.com/posts/index.xml" rel="self" type="application/rss+xml" />
+ <item>
+ <title>Forth RV32I Assembler</title>
+ <link>https://electrosoup.com/posts/forth-rv32i-assembler/</link>
+ <pubDate>Wed, 13 Nov 2024 17:33:47 -0800</pubDate><author>christianermann@gmail.com (Christian Ermann)</author>
+ <guid>https://electrosoup.com/posts/forth-rv32i-assembler/</guid>
+ <description><p>Here&rsquo;s an assembler for RV32I that I wrote in Forth. I find the definitions of
the instructions and instruction types especially elegant, and I find it to be
a great demonstration of how concise and powerful Forth can be.</p></description>
+ <content:encoded><![CDATA[<p>Here’s an assembler for RV32I that I wrote in Forth. I find the definitions of
+the instructions and instruction types especially elegant, and I find it to be
+a great demonstration of how concise and powerful Forth can be.</p>
+<p>All code in this post is licensed under the
+<a href="https://www.gnu.org/licenses/agpl-3.0.en.html#license-text">AGPLv3</a>.</p>
+
+
+
+
+
+<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-forth" data-lang="forth"><span class="line"><span class="ln"> 1</span><span class="cl"><span class="c1">\ encode stack values into proper instruction locations. all
+</span></span></span><span class="line"><span class="ln"> 2</span><span class="cl"><span class="c1">\ encoding sequences must begin with 'opcode'.
+</span></span></span><span class="line"><span class="ln"> 3</span><span class="cl"><span class="c1"></span><span class="kn">:</span> <span class="nc">opcode</span> <span class="k">hex </span> <span class="mi">7</span><span class="nf">F</span> <span class="k">and </span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 4</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">funct3</span> <span class="k">swap hex </span> <span class="mi">7</span> <span class="k">and decimal </span><span class="mi">12</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 5</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">funct7</span> <span class="k">swap hex </span> <span class="mi">7</span><span class="nf">F</span> <span class="k">and decimal </span><span class="mi">25</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 6</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">i-immed</span> <span class="k">swap hex </span> <span class="nf">FFF</span> <span class="k">and decimal </span><span class="mi">20</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 7</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">i-immed-shamt</span> <span class="k">swap hex </span> <span class="mi">1</span><span class="nf">F</span> <span class="k">and decimal </span><span class="mi">20</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 8</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">u-immed</span> <span class="k">swap hex </span> <span class="nf">FFFFF</span> <span class="k">and decimal </span><span class="mi">12</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 9</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">s-immed</span> <span class="k">over hex </span> <span class="nf">FE0</span> <span class="k">and decimal </span><span class="mi">20</span> <span class="k">lshift +
+</span></span></span><span class="line"><span class="ln"> 10</span><span class="cl"><span class="k"></span> <span class="k">swap hex </span> <span class="mi">1</span><span class="nf">F</span> <span class="k">and decimal </span> <span class="mi">7</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 11</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">j-immed</span> <span class="k">over hex </span><span class="mi">100000</span> <span class="k">and decimal </span><span class="mi">11</span> <span class="k">lshift +
+</span></span></span><span class="line"><span class="ln"> 12</span><span class="cl"><span class="k"></span> <span class="k">over hex </span> <span class="nf">FF000</span> <span class="k">and </span> <span class="k">+
+</span></span></span><span class="line"><span class="ln"> 13</span><span class="cl"><span class="k"></span> <span class="k">over hex </span> <span class="mi">800</span> <span class="k">and decimal </span> <span class="mi">9</span> <span class="k">lshift +
+</span></span></span><span class="line"><span class="ln"> 14</span><span class="cl"><span class="k"></span> <span class="k">swap hex </span> <span class="mi">7</span><span class="nf">FE</span> <span class="k">and decimal </span><span class="mi">20</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 15</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">b-immed</span> <span class="k">over hex </span> <span class="mi">1000</span> <span class="k">and decimal </span><span class="mi">19</span> <span class="k">lshift +
+</span></span></span><span class="line"><span class="ln"> 16</span><span class="cl"><span class="k"></span> <span class="k">over hex </span> <span class="mi">800</span> <span class="k">and decimal </span> <span class="mi">4</span> <span class="k">rshift +
+</span></span></span><span class="line"><span class="ln"> 17</span><span class="cl"><span class="k"></span> <span class="k">over hex </span> <span class="mi">7</span><span class="nf">E0</span> <span class="k">and decimal </span><span class="mi">20</span> <span class="k">lshift +
+</span></span></span><span class="line"><span class="ln"> 18</span><span class="cl"><span class="k"></span> <span class="k">swap hex </span> <span class="mi">1</span><span class="nf">E</span> <span class="k">and decimal </span> <span class="mi">7</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 19</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">rd</span> <span class="k">swap hex </span> <span class="mi">1</span><span class="nf">F</span> <span class="k">and decimal </span> <span class="mi">7</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 20</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">rs1</span> <span class="k">swap hex </span> <span class="mi">1</span><span class="nf">F</span> <span class="k">and decimal </span><span class="mi">15</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 21</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">rs2</span> <span class="k">swap hex </span> <span class="mi">1</span><span class="nf">F</span> <span class="k">and decimal </span><span class="mi">20</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 22</span><span class="cl"><span class="k"></span>
+</span></span><span class="line"><span class="ln"> 23</span><span class="cl"><span class="c1">\ instruction types. all instruction values should be pushed on the
+</span></span></span><span class="line"><span class="ln"> 24</span><span class="cl"><span class="c1">\ stack with the opcode last before calling.
+</span></span></span><span class="line"><span class="ln"> 25</span><span class="cl"><span class="c1"></span><span class="kn">:</span> <span class="nc">r-type</span> <span class="nf">opcode</span> <span class="nf">funct3</span> <span class="nf">funct7</span> <span class="nf">rs2</span> <span class="nf">rs1</span> <span class="nf">rd</span> <span class="k">, ;
+</span></span></span><span class="line"><span class="ln"> 26</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">i-type</span> <span class="nf">opcode</span> <span class="nf">funct3</span> <span class="nf">i-immed</span> <span class="nf">rs1</span> <span class="nf">rd</span> <span class="k">, ;
+</span></span></span><span class="line"><span class="ln"> 27</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">i-type-shamt</span> <span class="nf">opcode</span> <span class="nf">funct3</span> <span class="nf">funct7</span> <span class="nf">i-immed-shamt</span> <span class="nf">rs1</span> <span class="nf">rd</span> <span class="k">, ;
+</span></span></span><span class="line"><span class="ln"> 28</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">s-type</span> <span class="nf">opcode</span> <span class="nf">funct3</span> <span class="nf">s-immed</span> <span class="nf">rs2</span> <span class="nf">rs1</span> <span class="k">, ;
+</span></span></span><span class="line"><span class="ln"> 29</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">b-type</span> <span class="nf">opcode</span> <span class="nf">funct3</span> <span class="nf">b-immed</span> <span class="nf">rs2</span> <span class="nf">rs1</span> <span class="k">, ;
+</span></span></span><span class="line"><span class="ln"> 30</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">u-type</span> <span class="nf">opcode</span> <span class="nf">u-immed</span> <span class="nf">rd</span> <span class="k">, ;
+</span></span></span><span class="line"><span class="ln"> 31</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">j-type</span> <span class="nf">opcode</span> <span class="nf">j-immed</span> <span class="nf">rd</span> <span class="k">, ;
+</span></span></span><span class="line"><span class="ln"> 32</span><span class="cl"><span class="k"></span>
+</span></span><span class="line"><span class="ln"> 33</span><span class="cl"><span class="c1">\ instructions. these are just simple encodings, no assembler
+</span></span></span><span class="line"><span class="ln"> 34</span><span class="cl"><span class="c1">\ niceties yet.
+</span></span></span><span class="line"><span class="ln"> 35</span><span class="cl"><span class="c1">\ funct7 funct3 opcode encoding
+</span></span></span><span class="line"><span class="ln"> 36</span><span class="cl"><span class="c1"></span><span class="kn">:</span> <span class="nc">addi,</span> <span class="k">hex </span> <span class="mi">0</span> <span class="mi">13</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 37</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">andi,</span> <span class="k">hex </span> <span class="mi">7</span> <span class="mi">13</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 38</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">ori,</span> <span class="k">hex </span> <span class="mi">6</span> <span class="mi">13</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 39</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">xori,</span> <span class="k">hex </span> <span class="mi">4</span> <span class="mi">13</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 40</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">slli,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">1</span> <span class="mi">13</span> <span class="nf">i-type-shamt</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 41</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">srli,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">5</span> <span class="mi">13</span> <span class="nf">i-type-shamt</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 42</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">srai,</span> <span class="k">hex </span> <span class="mi">20</span> <span class="mi">5</span> <span class="mi">13</span> <span class="nf">i-type-shamt</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 43</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">slti,</span> <span class="k">hex </span> <span class="mi">2</span> <span class="mi">13</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 44</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sltiu,</span> <span class="k">hex </span> <span class="mi">3</span> <span class="mi">13</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 45</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">lui,</span> <span class="k">hex </span> <span class="mi">37</span> <span class="nf">u-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 46</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">auipc,</span> <span class="k">hex </span> <span class="mi">17</span> <span class="nf">u-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 47</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">add,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">0</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 48</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sub,</span> <span class="k">hex </span> <span class="mi">20</span> <span class="mi">0</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 49</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">and,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">7</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 50</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">or,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">6</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 51</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">xor,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">4</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 52</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sll,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">1</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 53</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">srl,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">5</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 54</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sra,</span> <span class="k">hex </span> <span class="mi">20</span> <span class="mi">5</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 55</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">slt,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">2</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 56</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sltu,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">3</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 57</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">jal,</span> <span class="k">hex </span> <span class="mi">6</span><span class="nf">F</span> <span class="nf">j-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 58</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">jalr,</span> <span class="k">hex </span> <span class="mi">0</span> <span class="mi">67</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 59</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">beq,</span> <span class="k">hex </span> <span class="mi">0</span> <span class="mi">63</span> <span class="nf">b-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 60</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">bne,</span> <span class="k">hex </span> <span class="mi">1</span> <span class="mi">63</span> <span class="nf">b-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 61</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">blt,</span> <span class="k">hex </span> <span class="mi">4</span> <span class="mi">63</span> <span class="nf">b-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 62</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">bltu,</span> <span class="k">hex </span> <span class="mi">6</span> <span class="mi">63</span> <span class="nf">b-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 63</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">bge,</span> <span class="k">hex </span> <span class="mi">5</span> <span class="mi">63</span> <span class="nf">b-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 64</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">bgeu,</span> <span class="k">hex </span> <span class="mi">7</span> <span class="mi">63</span> <span class="nf">b-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 65</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">lw,</span> <span class="k">hex </span> <span class="mi">2</span> <span class="mi">03</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 66</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">lh,</span> <span class="k">hex </span> <span class="mi">1</span> <span class="mi">03</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 67</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">lhu,</span> <span class="k">hex </span> <span class="mi">5</span> <span class="mi">03</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 68</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">lb,</span> <span class="k">hex </span> <span class="mi">0</span> <span class="mi">03</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 69</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sw,</span> <span class="k">hex </span> <span class="mi">2</span> <span class="mi">23</span> <span class="nf">s-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 70</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sh,</span> <span class="k">hex </span> <span class="mi">1</span> <span class="mi">23</span> <span class="nf">s-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 71</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sb,</span> <span class="k">hex </span> <span class="mi">0</span> <span class="mi">23</span> <span class="nf">s-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 72</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">fence,</span> <span class="k">hex </span> <span class="mi">0</span> <span class="mi">0</span><span class="nf">F</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 73</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">ecall,</span> <span class="k">hex </span> <span class="mi">0</span> <span class="mi">73</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 74</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">ebreak,</span> <span class="k">hex </span> <span class="mi">0</span> <span class="mi">73</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 75</span><span class="cl"><span class="k"></span>
+</span></span><span class="line"><span class="ln"> 76</span><span class="cl"><span class="c1">\ some instructions, now with nicer usage.
+</span></span></span><span class="line"><span class="ln"> 77</span><span class="cl"><span class="c1"></span><span class="kn">:</span> <span class="nc">sw,</span> <span class="k">>r swap r> </span><span class="nf">sw,</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 78</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sh,</span> <span class="k">>r swap r> </span><span class="nf">sh,</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 79</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sb,</span> <span class="k">>r swap r> </span><span class="nf">sb,</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 80</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">ecall,</span> <span class="mi">0</span> <span class="mi">0</span> <span class="mi">0</span> <span class="nf">ecall,</span> <span class="k">; </span> <span class="c1">\ usage: ecall,
+</span></span></span><span class="line"><span class="ln"> 81</span><span class="cl"><span class="c1"></span><span class="kn">:</span> <span class="nc">ebreak,</span> <span class="mi">0</span> <span class="mi">0</span> <span class="mi">1</span> <span class="nf">ebreak,</span> <span class="k">; </span> <span class="c1">\ usage: ebreak,
+</span></span></span><span class="line"><span class="ln"> 82</span><span class="cl"><span class="c1"></span><span class="kn">:</span> <span class="nc">fence,</span> <span class="k">>r </span><span class="mi">0</span> <span class="mi">0</span> <span class="k">r> </span><span class="nf">fence,</span> <span class="k">; </span><span class="c1">\ usage: imm fence,
+</span></span></span><span class="line"><span class="ln"> 83</span><span class="cl"><span class="c1"></span>
+</span></span><span class="line"><span class="ln"> 84</span><span class="cl"><span class="c1">\ registers
+</span></span></span><span class="line"><span class="ln"> 85</span><span class="cl"><span class="c1"></span><span class="k">decimal
+</span></span></span><span class="line"><span class="ln"> 86</span><span class="cl"><span class="k"></span> <span class="mi">0</span> <span class="kn">constant</span> <span class="nc">x0</span> <span class="mi">1</span> <span class="kn">constant</span> <span class="nc">x1</span> <span class="mi">2</span> <span class="kn">constant</span> <span class="nc">x2</span> <span class="mi">3</span> <span class="kn">constant</span> <span class="nc">x3</span>
+</span></span><span class="line"><span class="ln"> 87</span><span class="cl"> <span class="mi">4</span> <span class="kn">constant</span> <span class="nc">x4</span> <span class="mi">5</span> <span class="kn">constant</span> <span class="nc">x5</span> <span class="mi">6</span> <span class="kn">constant</span> <span class="nc">x6</span> <span class="mi">7</span> <span class="kn">constant</span> <span class="nc">x7</span>
+</span></span><span class="line"><span class="ln"> 88</span><span class="cl"> <span class="mi">8</span> <span class="kn">constant</span> <span class="nc">x8</span> <span class="mi">9</span> <span class="kn">constant</span> <span class="nc">x9</span> <span class="mi">10</span> <span class="kn">constant</span> <span class="nc">x10</span> <span class="mi">11</span> <span class="kn">constant</span> <span class="nc">x11</span>
+</span></span><span class="line"><span class="ln"> 89</span><span class="cl"><span class="mi">12</span> <span class="kn">constant</span> <span class="nc">x12</span> <span class="mi">13</span> <span class="kn">constant</span> <span class="nc">x13</span> <span class="mi">14</span> <span class="kn">constant</span> <span class="nc">x14</span> <span class="mi">15</span> <span class="kn">constant</span> <span class="nc">x15</span>
+</span></span><span class="line"><span class="ln"> 90</span><span class="cl"><span class="mi">16</span> <span class="kn">constant</span> <span class="nc">x16</span> <span class="mi">17</span> <span class="kn">constant</span> <span class="nc">x17</span> <span class="mi">18</span> <span class="kn">constant</span> <span class="nc">x18</span> <span class="mi">19</span> <span class="kn">constant</span> <span class="nc">x19</span>
+</span></span><span class="line"><span class="ln"> 91</span><span class="cl"><span class="mi">20</span> <span class="kn">constant</span> <span class="nc">x20</span> <span class="mi">21</span> <span class="kn">constant</span> <span class="nc">x21</span> <span class="mi">22</span> <span class="kn">constant</span> <span class="nc">x22</span> <span class="mi">23</span> <span class="kn">constant</span> <span class="nc">x23</span>
+</span></span><span class="line"><span class="ln"> 92</span><span class="cl"><span class="mi">24</span> <span class="kn">constant</span> <span class="nc">x24</span> <span class="mi">25</span> <span class="kn">constant</span> <span class="nc">x25</span> <span class="mi">26</span> <span class="kn">constant</span> <span class="nc">x26</span> <span class="mi">27</span> <span class="kn">constant</span> <span class="nc">x27</span>
+</span></span><span class="line"><span class="ln"> 93</span><span class="cl"><span class="mi">28</span> <span class="kn">constant</span> <span class="nc">x28</span> <span class="mi">29</span> <span class="kn">constant</span> <span class="nc">x29</span> <span class="mi">30</span> <span class="kn">constant</span> <span class="nc">x30</span> <span class="mi">31</span> <span class="kn">constant</span> <span class="nc">x31</span>
+</span></span><span class="line"><span class="ln"> 94</span><span class="cl">
+</span></span><span class="line"><span class="ln"> 95</span><span class="cl"><span class="c1">\ registers (calling convention)
+</span></span></span><span class="line"><span class="ln"> 96</span><span class="cl"><span class="c1"></span><span class="nf">x0</span> <span class="kn">constant</span> <span class="nc">zero</span> <span class="c1">\ zero constant
+</span></span></span><span class="line"><span class="ln"> 97</span><span class="cl"><span class="c1"></span><span class="nf">x1</span> <span class="kn">constant</span> <span class="nc">ra</span> <span class="c1">\ return address
+</span></span></span><span class="line"><span class="ln"> 98</span><span class="cl"><span class="c1"></span><span class="nf">x2</span> <span class="kn">constant</span> <span class="nc">sp</span> <span class="c1">\ stack pointer
+</span></span></span><span class="line"><span class="ln"> 99</span><span class="cl"><span class="c1"></span><span class="nf">x3</span> <span class="kn">constant</span> <span class="nc">gp</span> <span class="c1">\ global pointer
+</span></span></span><span class="line"><span class="ln">100</span><span class="cl"><span class="c1"></span><span class="nf">x4</span> <span class="kn">constant</span> <span class="nc">tp</span> <span class="c1">\ thread pointer
+</span></span></span><span class="line"><span class="ln">101</span><span class="cl"><span class="c1"></span><span class="nf">x8</span> <span class="kn">constant</span> <span class="nc">fp</span> <span class="c1">\ frame pointer
+</span></span></span><span class="line"><span class="ln">102</span><span class="cl"><span class="c1">\ function arguments / return values (a0, a1)
+</span></span></span><span class="line"><span class="ln">103</span><span class="cl"><span class="c1"></span><span class="nf">x10</span> <span class="kn">constant</span> <span class="nc">a0</span> <span class="nf">x11</span> <span class="kn">constant</span> <span class="nc">a1</span> <span class="nf">x12</span> <span class="kn">constant</span> <span class="nc">a2</span> <span class="nf">x13</span> <span class="kn">constant</span> <span class="nc">a3</span>
+</span></span><span class="line"><span class="ln">104</span><span class="cl"><span class="nf">x14</span> <span class="kn">constant</span> <span class="nc">a4</span> <span class="nf">x15</span> <span class="kn">constant</span> <span class="nc">a5</span> <span class="nf">x16</span> <span class="kn">constant</span> <span class="nc">a6</span> <span class="nf">x17</span> <span class="kn">constant</span> <span class="nc">a7</span>
+</span></span><span class="line"><span class="ln">105</span><span class="cl"><span class="c1">\ saved registers
+</span></span></span><span class="line"><span class="ln">106</span><span class="cl"><span class="c1"></span><span class="nf">x8</span> <span class="kn">constant</span> <span class="nc">s0</span> <span class="nf">x9</span> <span class="kn">constant</span> <span class="nc">s1</span> <span class="nf">x18</span> <span class="kn">constant</span> <span class="nc">s2</span> <span class="nf">x19</span> <span class="kn">constant</span> <span class="nc">s3</span>
+</span></span><span class="line"><span class="ln">107</span><span class="cl"><span class="nf">x20</span> <span class="kn">constant</span> <span class="nc">s4</span> <span class="nf">x21</span> <span class="kn">constant</span> <span class="nc">s5</span> <span class="nf">x22</span> <span class="kn">constant</span> <span class="nc">s6</span> <span class="nf">x23</span> <span class="kn">constant</span> <span class="nc">s7</span>
+</span></span><span class="line"><span class="ln">108</span><span class="cl"><span class="nf">x24</span> <span class="kn">constant</span> <span class="nc">s8</span> <span class="nf">x25</span> <span class="kn">constant</span> <span class="nc">s9</span> <span class="nf">x26</span> <span class="kn">constant</span> <span class="nc">s10</span> <span class="nf">x27</span> <span class="kn">constant</span> <span class="nc">s11</span>
+</span></span><span class="line"><span class="ln">109</span><span class="cl"><span class="c1">\ temporaries
+</span></span></span><span class="line"><span class="ln">110</span><span class="cl"><span class="c1"></span><span class="nf">x5</span> <span class="kn">constant</span> <span class="nc">t0</span> <span class="nf">x6</span> <span class="kn">constant</span> <span class="nc">t1</span> <span class="nf">x7</span> <span class="kn">constant</span> <span class="nc">t2</span> <span class="nf">x28</span> <span class="kn">constant</span> <span class="nc">t3</span>
+</span></span><span class="line"><span class="ln">111</span><span class="cl"><span class="nf">x29</span> <span class="kn">constant</span> <span class="nc">t4</span> <span class="nf">x30</span> <span class="kn">constant</span> <span class="nc">t5</span> <span class="nf">x31</span> <span class="kn">constant</span> <span class="nc">t6</span></span></span></code></pre></div><p>And here’s some tests to verify the instruction encodings are generated
+correctly:</p>
+
+
+
+
+
+<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-forth" data-lang="forth"><span class="line"><span class="ln"> 1</span><span class="cl"><span class="kn">:</span> <span class="nc">undo,</span> <span class="mi">-1</span> <span class="k">cells allot here @ ; </span><span class="c1">\ undoes the last ','
+</span></span></span><span class="line"><span class="ln"> 2</span><span class="cl"><span class="c1"></span><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">FF</span> <span class="nf">addi,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FF58513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln"> 3</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">FF</span> <span class="nf">andi,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FF5F513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln"> 4</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">FF</span> <span class="nf">ori,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FF5E513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln"> 5</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">FF</span> <span class="nf">xori,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FF5C513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln"> 6</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">slli,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">F59513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln"> 7</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">srli,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">F5D513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln"> 8</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">srai,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">40</span><span class="nf">F5D513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln"> 9</span><span class="cl"><span class="nf">t{</span> <span class="nf">t0</span> <span class="k">hex </span><span class="nf">FFFF</span> <span class="nf">lui,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FFFF2B7</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">10</span><span class="cl"><span class="nf">t{</span> <span class="nf">t0</span> <span class="k">hex </span><span class="nf">FFFF</span> <span class="nf">auipc,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FFFF297</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">11</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">FF</span> <span class="nf">slti,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FF5A513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">12</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">FF</span> <span class="nf">sltiu,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FF5B513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">13</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">add,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">C58533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">14</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">sub,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">40</span><span class="nf">C58533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">15</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">and,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">C5F533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">16</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">or,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">C5E533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">17</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">xor,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">C5C533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">18</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">sll,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">C59533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">19</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">srl,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">C5D533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">20</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">sra,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">40</span><span class="nf">C5D533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">21</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">slt,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">C5A533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">22</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">sltu,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">C5B533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">23</span><span class="cl"><span class="nf">t{</span> <span class="nf">ra</span> <span class="k">hex </span><span class="nf">FFFF</span> <span class="nf">jal,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">7</span><span class="nf">FF0F0EF</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">24</span><span class="cl"><span class="nf">t{</span> <span class="nf">ra</span> <span class="nf">a0</span> <span class="k">hex </span> <span class="nf">FF</span> <span class="nf">jalr,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FF500E7</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">25</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">beq,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">B50763</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">26</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">bne,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">B51763</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">27</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">blt,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">B54763</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">28</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">bltu,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">B56763</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">29</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">bge,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">B55763</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">30</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">bgeu,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">B57763</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">31</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">lw,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">F5A503</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">32</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">lh,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">F59503</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">33</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">lhu,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">F5D503</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">34</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">lb,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">F58503</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">35</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">sw,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">A5A7A3</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">36</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">sh,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">A597A3</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">37</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">sb,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">A587A3</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">38</span><span class="cl"><span class="nf">t{</span> <span class="k">hex </span> <span class="mi">0</span><span class="nf">FF</span> <span class="nf">fence,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FF0000F</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">39</span><span class="cl"><span class="nf">t{</span> <span class="nf">ecall,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00000073</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">40</span><span class="cl"><span class="nf">t{</span> <span class="nf">ebreak,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00100073</span> <span class="err">}t</span></span></span></code></pre></div>]]></content:encoded>
+ </item>
+ <item>
+ <title>The Infamous 'link' Macro</title>
+ <link>https://electrosoup.com/posts/the-infamous-link-macro/</link>
+ <pubDate>Tue, 12 Nov 2024 13:01:09 -0800</pubDate><author>christianermann@gmail.com (Christian Ermann)</author>
+ <guid>https://electrosoup.com/posts/the-infamous-link-macro/</guid>
+ <description><p>Each word (or function, in other languages) in Forth is stored as an entry in
a linked list known as the dictionary. When bootstrapping a Forth from
assembly, it is your responsibility to create and maintain this linked list
structure. This is a tedious process and is the source of many errors when
re-arranging words or defining new words; it&rsquo;s incredibly easy to turn your
list into a graph by mistake.</p></description>
+ <content:encoded><![CDATA[<p>Each word (or function, in other languages) in Forth is stored as an entry in
+a linked list known as the dictionary. When bootstrapping a Forth from
+assembly, it is your responsibility to create and maintain this linked list
+structure. This is a tedious process and is the source of many errors when
+re-arranging words or defining new words; it’s incredibly easy to turn your
+list into a graph by mistake.</p>
+<p>In
+<a href="https://rwmj.wordpress.com/2010/08/07/jonesforth-git-repository/">jonesforth</a>,
+an x86 implementation of Forth, the assembler supports re-assigning new values
+to assembler variables. This means an assember variable can be used to store
+the memory address of the previous entry, and we have the ability to update it
+or use it whenever we need to. I used this exact strategy in my
+<a href="https://git.christianermann.dev/forth/log.html">incomplete x86 Forth</a> although
+I used <a href="https://flatassembler.net/">FASM</a> instead of
+<a href="https://wiki.osdev.org/GAS">GAS</a>. Unfortunately, GAS doesn’t support this
+feature for ARM or RISC-V targets. It may be possible to pull this off on ARM
+with the right set of relocation and/or relaxation parameters, but I was unable
+to find success with RISC-V.</p>
+<p>I did come up with an alternative set of macros that achieves the same goal
+and should be more portable than the <code>jonesforth</code> solution:</p>
+
+
+
+
+
+<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-GAS" data-lang="GAS"><span class="line"><span class="ln"> 1</span><span class="cl"><span class="na">.macro</span> <span class="no">this_link</span>
+</span></span><span class="line"><span class="ln"> 2</span><span class="cl"> <span class="na">.globl</span> <span class="no">link_</span><span class="err">\+</span>
+</span></span><span class="line"><span class="ln"> 3</span><span class="cl"><span class="nf">link_</span><span class="err">\+</span><span class="p">:</span>
+</span></span><span class="line"><span class="ln"> 4</span><span class="cl"><span class="na">.endm</span>
+</span></span><span class="line"><span class="ln"> 5</span><span class="cl">
+</span></span><span class="line"><span class="ln"> 6</span><span class="cl"><span class="na">.macro</span> <span class="no">prev_link</span>
+</span></span><span class="line"><span class="ln"> 7</span><span class="cl"> <span class="na">.int</span> <span class="no">link_</span><span class="err">\+</span>
+</span></span><span class="line"><span class="ln"> 8</span><span class="cl"><span class="na">.endm</span>
+</span></span><span class="line"><span class="ln"> 9</span><span class="cl">
+</span></span><span class="line"><span class="ln">10</span><span class="cl"><span class="na">.macro</span> <span class="no">link</span>
+</span></span><span class="line"><span class="ln">11</span><span class="cl"> <span class="nf">this_link</span>
+</span></span><span class="line"><span class="ln">12</span><span class="cl"> <span class="nf">prev_link</span>
+</span></span><span class="line"><span class="ln">13</span><span class="cl"><span class="na">.endm</span>
+</span></span><span class="line"><span class="ln">14</span><span class="cl">
+</span></span><span class="line"><span class="ln">15</span><span class="cl"><span class="nf">this_link</span></span></span></code></pre></div><p>These macros depend on the special value
+
+
+
+
+<code class="code-inline language-GAS"><span class="err">\+</span></code>.
+This value is replaced by the invocation count of the current macro during
+assembly. Since we want to
+
+
+
+
+<code class="code-inline language-GAS"><span class="nf">link</span></code>
+back to the previous word in the dictionary, we need
+
+
+
+
+<code class="code-inline language-GAS"><span class="nf">prev_link</span></code>
+to resolve to 1 word before
+
+
+
+
+<code class="code-inline language-GAS"><span class="nf">this_link</span></code>,
+which is why we call
+
+
+
+
+<code class="code-inline language-GAS"><span class="nf">this_link</span></code>
+once before defining any words.</p>
+<p>You’ll also need to add this to your linker script to null-terminate your
+dictionary, otherwise the start of your dictionary will be marked by the
+address where the
+
+
+
+
+<code class="code-inline language-GAS"><span class="nf">link_0</span></code>
+label created by
+
+
+
+
+<code class="code-inline language-GAS"><span class="nf">this_link</span></code> was stored:</p>
+
+
+
+
+
+<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-GAS" data-lang="GAS"><span class="line"><span class="ln">1</span><span class="cl"><span class="nf">link_0</span> <span class="err">=</span> <span class="mi">0</span><span class="err">;</span></span></span></code></pre></div>]]></content:encoded>
+ </item>
+ <item>
+ <title>Writing a G-code Interpreter</title>
+ <link>https://electrosoup.com/posts/gcode-interpreter/</link>
+ <pubDate>Wed, 23 Oct 2024 16:29:40 -0700</pubDate><author>christianermann@gmail.com (Christian Ermann)</author>
+ <guid>https://electrosoup.com/posts/gcode-interpreter/</guid>
+ <description><p>I&rsquo;m currently working on a control system for a laser galvanometer (galvo) that
I want to use in a stereolithography (SLA) resin printer. I don&rsquo;t want to write
a custom slicer, as I feel like model slicing can be incredibly complicated and
existing free software (Cura, Slic3r, etc.) has many advanced features I don&rsquo;t
want to reimplement. However, this means my control system needs to understand
G-code, the language that these slicers output.</p></description>
+ <content:encoded><![CDATA[<p>I’m currently working on a control system for a laser galvanometer (galvo) that
+I want to use in a stereolithography (SLA) resin printer. I don’t want to write
+a custom slicer, as I feel like model slicing can be incredibly complicated and
+existing free software (Cura, Slic3r, etc.) has many advanced features I don’t
+want to reimplement. However, this means my control system needs to understand
+G-code, the language that these slicers output.</p>
+<p>As stated on the <a href="https://reprap.org/wiki/G-code">reprap wiki</a>, “G-code is a
+list of fields that are separated by white spaces or line breaks. A field can
+be interpreted as a command, parameter, or for any other special purpose.” For
+now, we’ll ignore any special purposes. Here is an example of G-code that
+describes a movement of the tool/hotend/laser to a specific location:</p>
+
+
+
+
+
+<pre tabindex="0"><code class="language-gcode" data-lang="gcode"> G1 X10.4 Y7.4 Z8.3</code></pre><p>I was able to parse commands with parameters using a two-stage procedure:</p>
+<pre><code>1. Retrieve the next white-space delimited token.
+2. Accumulate tokens until two separate command tokens are found.
+</code></pre>
+<p>This second step is important because we can’t begin executing a command until
+we’ve found all of its parameters and we don’t know if we’ve found all of its
+parameters until we find the next command.</p>
+<p>Once a command and all of its parameters have been parsed, it is passed to the
+controller which updates the state of the machine. For each command that the
+controller receives, it has to update its internal state, and in the case of
+physical movement commands, send the proper signal to the laser galvo. Most
+physical movement commands utilize interpolation so a timed control loop is
+utilized to ensure the laser follows as close to the intended path as possible.</p>
+<h2 id="system-diagram">System Diagram</h2>
+
+
+
+<div class="goat svg-container ">
+
+ <svg
+ xmlns="http://www.w3.org/2000/svg"
+ font-family="Menlo,Lucida Console,monospace"
+
+ viewBox="0 0 384 249"
+ >
+ <g transform='translate(8,16)'>
+<path d='M 80,16 L 296,16' fill='none' stroke='currentColor'></path>
+<path d='M 16,64 L 112,64' fill='none' stroke='currentColor'></path>
+<path d='M 256,64 L 368,64' fill='none' stroke='currentColor'></path>
+<path d='M 128,80 L 240,80' fill='none' stroke='currentColor'></path>
+<path d='M 16,96 L 112,96' fill='none' stroke='currentColor'></path>
+<path d='M 256,96 L 368,96' fill='none' stroke='currentColor'></path>
+<path d='M 80,144 L 296,144' fill='none' stroke='currentColor'></path>
+<path d='M 0,192 L 120,192' fill='none' stroke='currentColor'></path>
+<path d='M 256,192 L 368,192' fill='none' stroke='currentColor'></path>
+<path d='M 136,208 L 240,208' fill='none' stroke='currentColor'></path>
+<path d='M 0,224 L 120,224' fill='none' stroke='currentColor'></path>
+<path d='M 256,224 L 368,224' fill='none' stroke='currentColor'></path>
+<path d='M 0,192 L 0,224' fill='none' stroke='currentColor'></path>
+<path d='M 16,64 L 16,96' fill='none' stroke='currentColor'></path>
+<path d='M 64,32 L 64,48' fill='none' stroke='currentColor'></path>
+<path d='M 64,160 L 64,176' fill='none' stroke='currentColor'></path>
+<path d='M 112,64 L 112,96' fill='none' stroke='currentColor'></path>
+<path d='M 120,192 L 120,224' fill='none' stroke='currentColor'></path>
+<path d='M 256,64 L 256,96' fill='none' stroke='currentColor'></path>
+<path d='M 256,192 L 256,224' fill='none' stroke='currentColor'></path>
+<path d='M 312,32 L 312,48' fill='none' stroke='currentColor'></path>
+<path d='M 312,112 L 312,128' fill='none' stroke='currentColor'></path>
+<path d='M 368,64 L 368,96' fill='none' stroke='currentColor'></path>
+<path d='M 368,192 L 368,224' fill='none' stroke='currentColor'></path>
+<path d='M 312,48 L 312,56' fill='none' stroke='currentColor'></path>
+<path d='M 312,104 L 312,112' fill='none' stroke='currentColor'></path>
+<path d='M 64,48 L 64,56' fill='none' stroke='currentColor'></path>
+<polygon points='80.000000,48.000000 68.000000,42.400002 68.000000,53.599998' fill='currentColor' transform='rotate(90.000000, 64.000000, 48.000000)'></polygon>
+<path d='M 64,176 L 64,184' fill='none' stroke='currentColor'></path>
+<polygon points='80.000000,176.000000 68.000000,170.399994 68.000000,181.600006' fill='currentColor' transform='rotate(90.000000, 64.000000, 176.000000)'></polygon>
+<polygon points='248.000000,80.000000 236.000000,74.400002 236.000000,85.599998' fill='currentColor' transform='rotate(0.000000, 240.000000, 80.000000)'></polygon>
+<polygon points='248.000000,208.000000 236.000000,202.399994 236.000000,213.600006' fill='currentColor' transform='rotate(0.000000, 240.000000, 208.000000)'></polygon>
+<path d='M 80,16 A 16,16 0 0,0 64,32' fill='none' stroke='currentColor'></path>
+<path d='M 296,16 A 16,16 0 0,1 312,32' fill='none' stroke='currentColor'></path>
+<path d='M 80,144 A 16,16 0 0,0 64,160' fill='none' stroke='currentColor'></path>
+<path d='M 312,128 A 16,16 0 0,1 296,144' fill='none' stroke='currentColor'></path>
+<text text-anchor='middle' x='24' y='212' fill='currentColor' style='font-size:1em'>c</text>
+<text text-anchor='middle' x='32' y='84' fill='currentColor' style='font-size:1em'>t</text>
+<text text-anchor='middle' x='32' y='212' fill='currentColor' style='font-size:1em'>o</text>
+<text text-anchor='middle' x='40' y='84' fill='currentColor' style='font-size:1em'>o</text>
+<text text-anchor='middle' x='40' y='212' fill='currentColor' style='font-size:1em'>n</text>
+<text text-anchor='middle' x='48' y='84' fill='currentColor' style='font-size:1em'>k</text>
+<text text-anchor='middle' x='48' y='212' fill='currentColor' style='font-size:1em'>t</text>
+<text text-anchor='middle' x='56' y='84' fill='currentColor' style='font-size:1em'>e</text>
+<text text-anchor='middle' x='56' y='212' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='64' y='84' fill='currentColor' style='font-size:1em'>n</text>
+<text text-anchor='middle' x='64' y='212' fill='currentColor' style='font-size:1em'>o</text>
+<text text-anchor='middle' x='72' y='84' fill='currentColor' style='font-size:1em'>i</text>
+<text text-anchor='middle' x='72' y='212' fill='currentColor' style='font-size:1em'>l</text>
+<text text-anchor='middle' x='80' y='84' fill='currentColor' style='font-size:1em'>z</text>
+<text text-anchor='middle' x='80' y='212' fill='currentColor' style='font-size:1em'>l</text>
+<text text-anchor='middle' x='88' y='84' fill='currentColor' style='font-size:1em'>e</text>
+<text text-anchor='middle' x='88' y='212' fill='currentColor' style='font-size:1em'>e</text>
+<text text-anchor='middle' x='96' y='84' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='96' y='212' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='128' y='132' fill='currentColor' style='font-size:1em'>c</text>
+<text text-anchor='middle' x='136' y='132' fill='currentColor' style='font-size:1em'>o</text>
+<text text-anchor='middle' x='144' y='4' fill='currentColor' style='font-size:1em'>m</text>
+<text text-anchor='middle' x='144' y='132' fill='currentColor' style='font-size:1em'>m</text>
+<text text-anchor='middle' x='144' y='196' fill='currentColor' style='font-size:1em'>c</text>
+<text text-anchor='middle' x='152' y='4' fill='currentColor' style='font-size:1em'>o</text>
+<text text-anchor='middle' x='152' y='132' fill='currentColor' style='font-size:1em'>m</text>
+<text text-anchor='middle' x='152' y='196' fill='currentColor' style='font-size:1em'>t</text>
+<text text-anchor='middle' x='160' y='4' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='160' y='132' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='160' y='196' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='168' y='4' fill='currentColor' style='font-size:1em'>e</text>
+<text text-anchor='middle' x='168' y='68' fill='currentColor' style='font-size:1em'>t</text>
+<text text-anchor='middle' x='168' y='132' fill='currentColor' style='font-size:1em'>n</text>
+<text text-anchor='middle' x='168' y='196' fill='currentColor' style='font-size:1em'>l</text>
+<text text-anchor='middle' x='176' y='68' fill='currentColor' style='font-size:1em'>o</text>
+<text text-anchor='middle' x='176' y='132' fill='currentColor' style='font-size:1em'>d</text>
+<text text-anchor='middle' x='184' y='4' fill='currentColor' style='font-size:1em'>p</text>
+<text text-anchor='middle' x='184' y='68' fill='currentColor' style='font-size:1em'>k</text>
+<text text-anchor='middle' x='184' y='196' fill='currentColor' style='font-size:1em'>s</text>
+<text text-anchor='middle' x='192' y='4' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='192' y='68' fill='currentColor' style='font-size:1em'>e</text>
+<text text-anchor='middle' x='192' y='132' fill='currentColor' style='font-size:1em'>w</text>
+<text text-anchor='middle' x='192' y='196' fill='currentColor' style='font-size:1em'>i</text>
+<text text-anchor='middle' x='200' y='4' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='200' y='68' fill='currentColor' style='font-size:1em'>n</text>
+<text text-anchor='middle' x='200' y='132' fill='currentColor' style='font-size:1em'>/</text>
+<text text-anchor='middle' x='200' y='196' fill='currentColor' style='font-size:1em'>g</text>
+<text text-anchor='middle' x='208' y='4' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='208' y='196' fill='currentColor' style='font-size:1em'>n</text>
+<text text-anchor='middle' x='216' y='4' fill='currentColor' style='font-size:1em'>m</text>
+<text text-anchor='middle' x='216' y='132' fill='currentColor' style='font-size:1em'>p</text>
+<text text-anchor='middle' x='216' y='196' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='224' y='4' fill='currentColor' style='font-size:1em'>s</text>
+<text text-anchor='middle' x='224' y='132' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='224' y='196' fill='currentColor' style='font-size:1em'>l</text>
+<text text-anchor='middle' x='232' y='4' fill='currentColor' style='font-size:1em'>?</text>
+<text text-anchor='middle' x='232' y='132' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='240' y='132' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='248' y='132' fill='currentColor' style='font-size:1em'>m</text>
+<text text-anchor='middle' x='256' y='132' fill='currentColor' style='font-size:1em'>s</text>
+<text text-anchor='middle' x='272' y='84' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='272' y='212' fill='currentColor' style='font-size:1em'>l</text>
+<text text-anchor='middle' x='280' y='84' fill='currentColor' style='font-size:1em'>c</text>
+<text text-anchor='middle' x='280' y='212' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='288' y='84' fill='currentColor' style='font-size:1em'>c</text>
+<text text-anchor='middle' x='288' y='212' fill='currentColor' style='font-size:1em'>s</text>
+<text text-anchor='middle' x='296' y='84' fill='currentColor' style='font-size:1em'>u</text>
+<text text-anchor='middle' x='296' y='212' fill='currentColor' style='font-size:1em'>e</text>
+<text text-anchor='middle' x='304' y='84' fill='currentColor' style='font-size:1em'>m</text>
+<text text-anchor='middle' x='304' y='212' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='312' y='84' fill='currentColor' style='font-size:1em'>u</text>
+<text text-anchor='middle' x='320' y='84' fill='currentColor' style='font-size:1em'>l</text>
+<text text-anchor='middle' x='320' y='212' fill='currentColor' style='font-size:1em'>g</text>
+<text text-anchor='middle' x='328' y='84' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='328' y='212' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='336' y='84' fill='currentColor' style='font-size:1em'>t</text>
+<text text-anchor='middle' x='336' y='212' fill='currentColor' style='font-size:1em'>l</text>
+<text text-anchor='middle' x='344' y='84' fill='currentColor' style='font-size:1em'>o</text>
+<text text-anchor='middle' x='344' y='212' fill='currentColor' style='font-size:1em'>v</text>
+<text text-anchor='middle' x='352' y='84' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='352' y='212' fill='currentColor' style='font-size:1em'>o</text>
+</g>
+
+ </svg>
+
+</div>
+<h2 id="source-code">Source Code</h2>
+<p>The source code for the G-code interpreter can be found
+<a href="https://git.christianermann.dev/gcode-interpreter">here</a>. You may have issues
+accessing the link if your ISP doesn’t support IPv6 yet.</p>
+<p>Also, the names in the code are different than what’s shown in the diagram, so
+here’s the mapping to help out with understanding the code:</p>
+<table>
+ <thead>
+ <tr>
+ <th style="text-align: left">Diagram</th>
+ <th style="text-align: left">Source File</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td style="text-align: left">tokenizer</td>
+ <td style="text-align: left">token.c</td>
+ </tr>
+ <tr>
+ <td style="text-align: left">accumulator</td>
+ <td style="text-align: left">command.c</td>
+ </tr>
+ <tr>
+ <td style="text-align: left">controller</td>
+ <td style="text-align: left">machine.c</td>
+ </tr>
+ </tbody>
+</table>
+<p>I’ll try to keep this updated if the mapping changes as I continue to work on
+this project.</p>
+]]></content:encoded>
+ </item>
+ <item>
+ <title>Understanding Camera Look-At.</title>
+ <link>https://electrosoup.com/posts/look-at/</link>
+ <pubDate>Mon, 10 Oct 2022 00:31:00 -0400</pubDate><author>christianermann@gmail.com (Christian Ermann)</author>
+ <guid>https://electrosoup.com/posts/look-at/</guid>
+ <description><p>Often times, we want to position the camera in our scene at a particular point,
such as the head of the character in a first-person shooter or the cockpit of a
plane in a flight simulator. We also want the camera to look in the direction
that the player is trying to move.</p></description>
+ <content:encoded><![CDATA[<p>Often times, we want to position the camera in our scene at a particular point,
+such as the head of the character in a first-person shooter or the cockpit of a
+plane in a flight simulator. We also want the camera to look in the direction
+that the player is trying to move.</p>
+<p>To do this, we need to find the forward, right, and up vectors that correspond
+to the desired view.</p>
+<p>If we let $\vec{p}$ be the camera’s position and $\vec{t}$ be the position of
+what we want to look at, the camera’s look direction is
+$$\vec{l}=\vec{t}-\vec{p}\,.$$
+Conventionally, the camera looks down the negative forward axis so
+$$\vec{f}=-\vec{l}\,.$$</p>
+<p>In order to determine the right vector, we need a reference up direction,
+$\vec{up}$ (which isn’t necessarily orthogonal to $\vec{f}$). This enables us
+to calculate
+$$\vec{r} = \vec{f} \times \vec{up}$$
+and
+$$\vec{u} = \vec{r} \times \vec{f}\,.$$</p>
+<p>Now we can use the camera position $\vec{p}$ and normalized forms of $\vec{f}$,
+$\vec{r}$, and $\vec{u}$ to fill in our
+<a href="/posts/view-matrix/">view matrix</a>:</p>
+<p>$$
+V
+=
+\begin{bmatrix}
+r_{x} & r_{y} & r_{z} & -(\vec{r} \cdot \vec{p}) \\
+u_{x} & u_{y} & u_{z} & -(\vec{u} \cdot \vec{p}) \\
+f_{x} & f_{y} & f_{z} & -(\vec{f} \cdot \vec{p}) \\
+0 & 0 & 0 & 1
+\end{bmatrix}
+$$</p>
+]]></content:encoded>
+ </item>
+ <item>
+ <title>Deriving the View Matrix</title>
+ <link>https://electrosoup.com/posts/view-matrix/</link>
+ <pubDate>Sun, 21 Nov 2021 13:34:08 -0800</pubDate><author>christianermann@gmail.com (Christian Ermann)</author>
+ <guid>https://electrosoup.com/posts/view-matrix/</guid>
+ <description><p>In computer graphics, the view matrix is used to transform points from
world space into camera space. Below is an explanation of how to derive this
matrix.</p></description>
+ <content:encoded><![CDATA[<p>In computer graphics, the view matrix is used to transform points from
+world space into camera space. Below is an explanation of how to derive this
+matrix.</p>
+<p>Let $V$ be the view matrix.
+If $\vec{r}$, $\vec{u}$, and $\vec{f}$ denote the right, up, and forward
+vectors of the camera and $\vec{p}$ is the camera’s position, $V$ should
+satisfy the following properties:
+$$
+\begin{matrix}
+V_{1*} \times
+\begin{bmatrix}
+r_{x} \\
+r_{y} \\
+r_{z} \\
+0
+\end{bmatrix}
+=
+\begin{bmatrix}
+1 \\
+0 \\
+0 \\
+0
+\end{bmatrix},&
+V_{2*} \times
+\begin{bmatrix}
+u_{x} \\
+u_{y} \\
+u_{z} \\
+0
+\end{bmatrix}
+=
+\begin{bmatrix}
+0 \\
+1 \\
+0 \\
+0
+\end{bmatrix},&
+V_{3*} \times
+\begin{bmatrix}
+f_{x} \\
+f_{y} \\
+f_{z} \\
+0
+\end{bmatrix}
+=
+\begin{bmatrix}
+0 \\
+0 \\
+1 \\
+0
+\end{bmatrix},&
+V_{4*} \times
+\begin{bmatrix}
+p_{x} \\
+p_{y} \\
+p_{z} \\
+1
+\end{bmatrix}
+=
+\begin{bmatrix}
+0 \\
+0 \\
+0 \\
+1
+\end{bmatrix}
+\end{matrix}
+$$
+In words, the view matrix should translate the camera to the origin and rotate
+it to align with the $\vec{x}$, $\vec{y}$, and $\vec{z}$ axes.</p>
+<p>This can be expressed more concisely as the product of two matrices:
+$$
+V \times
+\begin{bmatrix}
+r_{x} & u_{x} & f_{x} & p_{x} \\
+r_{y} & u_{y} & f_{y} & p_{y} \\
+r_{z} & u_{z} & f_{z} & p_{z} \\
+0 & 0 & 0 & 1
+\end{bmatrix}
+=
+\begin{bmatrix}
+1 & 0 & 0 & 0 \\
+0 & 1 & 0 & 0 \\
+0 & 0 & 1 & 0 \\
+0 & 0 & 0 & 1
+\end{bmatrix}
+$$</p>
+<p>To make this equation easier to solve, we can split the matrix containing our
+camera parameters into the product of a translation matrix $T$ and a rotation
+matrix $R$:
+$$
+V \times (T \times R) = I
+$$
+where
+$$
+\begin{matrix}
+T =
+\begin{bmatrix}
+1 & 0 & 0 & p_{x} \\
+0 & 1 & 0 & p_{y} \\
+0 & 0 & 1 & p_{z} \\
+0 & 0 & 0 & 1
+\end{bmatrix},&
+R =
+\begin{bmatrix}
+r_{x} & u_{x} & f_{x} & 0 \\
+r_{y} & u_{y} & f_{y} & 0 \\
+r_{z} & u_{z} & f_{z} & 0 \\
+0 & 0 & 0 & 1
+\end{bmatrix}
+\end{matrix}
+$$</p>
+<p>Solving for $V$ reveals that $V=R^{-1} \times T^{-1}$:
+$$
+V =
+\begin{bmatrix}
+r_{x} & r_{y} & r_{z} & 0 \\
+u_{x} & u_{y} & u_{z} & 0 \\
+f_{x} & f_{y} & f_{z} & 0 \\
+0 & 0 & 0 & 1
+\end{bmatrix}
+\times
+\begin{bmatrix}
+1 & 0 & 0 & -p_{x} \\
+0 & 1 & 0 & -p_{y} \\
+0 & 0 & 1 & -p_{z} \\
+0 & 0 & 0 & 1
+\end{bmatrix}
+$$</p>
+<p>And with some minor simplification,
+$$
+V
+=
+\begin{bmatrix}
+r_{x} & r_{y} & r_{z} & -(\vec{r} \cdot \vec{p}) \\
+u_{x} & u_{y} & u_{z} & -(\vec{u} \cdot \vec{p}) \\
+f_{x} & f_{y} & f_{z} & -(\vec{f} \cdot \vec{p}) \\
+0 & 0 & 0 & 1
+\end{bmatrix}
+$$</p>
+<p>When we’re ready to render our scene, we can apply $V$ to each vertex $\vec{q}$
+by calculating
+$$
+V \times \vec{q}
+$$
+in our vertex shader.</p>
+]]></content:encoded>
+ </item>
+ <item>
+ <title>Unbind Your Vertex Array Objects.</title>
+ <link>https://electrosoup.com/posts/unbind/</link>
+ <pubDate>Wed, 25 Aug 2021 14:33:02 -0500</pubDate><author>christianermann@gmail.com (Christian Ermann)</author>
+ <guid>https://electrosoup.com/posts/unbind/</guid>
+ <description><p>When I first started learning about OpenGL, I always made sure to unbind each resource as soon as I was done using it. Over time I became more lenient with unbinding, as in many cases leaving resources bound is okay and leads to fewer API calls.</p></description>
+ <content:encoded><![CDATA[<p>When I first started learning about OpenGL, I always made sure to unbind each resource as soon as I was done using it. Over time I became more lenient with unbinding, as in many cases leaving resources bound is okay and leads to fewer API calls.</p>
+<p>In addition, when I’m developing on my PC I have access to the newer Direct State Access (DSA) functions, so binding resources isn’t something I have to worry about as much. However, I do a fair amount of programming on my macbook which means I don’t always have access to the DSA functions.</p>
+<p>I was working on a project recently that involved the vertex and index data for a mesh frequently changing. The actual mesh struct has a bit more going on, but we can think of it like this for now:</p>
+
+
+
+
+<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-c" data-lang="c"><span class="line"><span class="ln">1</span><span class="cl"><span class="k">typedef</span> <span class="k">struct</span> <span class="p">{</span>
+</span></span><span class="line"><span class="ln">2</span><span class="cl"> <span class="n">Vec3</span> <span class="o">*</span><span class="n">vertices</span><span class="p">;</span>
+</span></span><span class="line"><span class="ln">3</span><span class="cl"> <span class="n">GLuint</span> <span class="o">*</span><span class="n">indices</span><span class="p">;</span>
+</span></span><span class="line"><span class="ln">4</span><span class="cl"> <span class="n">GLuint</span> <span class="n">vao</span><span class="p">;</span>
+</span></span><span class="line"><span class="ln">5</span><span class="cl"> <span class="n">GLuint</span> <span class="n">vbo</span><span class="p">;</span>
+</span></span><span class="line"><span class="ln">6</span><span class="cl"> <span class="n">GLuint</span> <span class="n">ebo</span><span class="p">;</span>
+</span></span><span class="line"><span class="ln">7</span><span class="cl"><span class="p">}</span> <span class="n">Mesh</span><span class="p">;</span></span></span></code></pre></div>
+<p>So when it comes time to update the vertex or index data, we map the vertex buffer object to the vertices pointer and the element buffer object to the indices pointer. Then we can write all of our vertex and index data directly to the buffers, and then unmap them when we’re all done and need to draw.</p>
+
+
+
+
+<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-c" data-lang="c"><span class="line"><span class="ln"> 1</span><span class="cl"><span class="p">...</span>
+</span></span><span class="line"><span class="ln"> 2</span><span class="cl">
+</span></span><span class="line"><span class="ln"> 3</span><span class="cl"><span class="nf">glBindBuffer</span><span class="p">(</span><span class="n">GL_ARRAY_BUFFER</span><span class="p">,</span> <span class="n">mesh</span><span class="o">-></span><span class="n">vbo</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln"> 4</span><span class="cl"><span class="n">mesh</span><span class="o">-></span><span class="n">vertices</span> <span class="o">=</span> <span class="nf">glMapBuffer</span><span class="p">(</span><span class="n">GL_ARRAY_BUFFER</span><span class="p">,</span> <span class="n">GL_WRITE_ONLY</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln"> 5</span><span class="cl">
+</span></span><span class="line"><span class="ln"> 6</span><span class="cl"><span class="nf">glBindBuffer</span><span class="p">(</span><span class="n">GL_ELEMENT_ARRAY_BUFFER</span><span class="p">,</span> <span class="n">mesh</span><span class="o">-></span><span class="n">ebo</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln"> 7</span><span class="cl"><span class="n">mesh</span><span class="o">-></span><span class="n">indices</span> <span class="o">=</span> <span class="nf">glMapBuffer</span><span class="p">(</span><span class="n">GL_ELEMENT_ARRAY_BUFFER</span><span class="p">,</span> <span class="n">GL_WRITE_ONLY</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln"> 8</span><span class="cl">
+</span></span><span class="line"><span class="ln"> 9</span><span class="cl"><span class="c1">// While we have the buffers mapped, we can write data directly to
+</span></span></span><span class="line"><span class="ln">10</span><span class="cl"><span class="c1">// mesh->vertices and mesh->indices.
+</span></span></span><span class="line"><span class="ln">11</span><span class="cl"><span class="c1"></span>
+</span></span><span class="line"><span class="ln">12</span><span class="cl"><span class="nf">glBindBuffer</span><span class="p">(</span><span class="n">GL_ARRAY_BUFFER</span><span class="p">,</span> <span class="n">mesh</span><span class="o">-></span><span class="n">vbo</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln">13</span><span class="cl"><span class="nf">glUnmapBuffer</span><span class="p">(</span><span class="n">GL_ARRAY_BUFFER</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln">14</span><span class="cl"><span class="n">mesh</span><span class="o">-></span><span class="n">vertices</span> <span class="o">=</span> <span class="nb">NULL</span>
+</span></span><span class="line"><span class="ln">15</span><span class="cl">
+</span></span><span class="line"><span class="ln">16</span><span class="cl"><span class="nf">glBindBuffer</span><span class="p">(</span><span class="n">GL_ELEMENT_ARRAY_BUFFER</span><span class="p">,</span> <span class="n">mesh</span><span class="o">-></span><span class="n">ebo</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln">17</span><span class="cl"><span class="nf">glUnmapBuffer</span><span class="p">(</span><span class="n">GL_ELEMENT_ARRAY_BUFFER</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln">18</span><span class="cl"><span class="n">mesh</span><span class="o">-></span><span class="n">indices</span> <span class="o">=</span> <span class="nb">NULL</span>
+</span></span><span class="line"><span class="ln">19</span><span class="cl">
+</span></span><span class="line"><span class="ln">20</span><span class="cl"><span class="c1">// Now that the buffers are unmapped, we can draw the mesh again.
+</span></span></span><span class="line"><span class="ln">21</span><span class="cl"><span class="c1"></span>
+</span></span><span class="line"><span class="ln">22</span><span class="cl"><span class="p">...</span></span></span></code></pre></div>
+<p>Leaving the buffers bound in the above snippet didn’t cause problems and seemed a reasonable thing to do to reduce unnecessary OpenGL calls.
+The issues I was running into were actually caused by how I was drawing each mesh:</p>
+
+
+
+
+<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-c" data-lang="c"><span class="line"><span class="ln">1</span><span class="cl"><span class="p">...</span>
+</span></span><span class="line"><span class="ln">2</span><span class="cl">
+</span></span><span class="line"><span class="ln">3</span><span class="cl"><span class="nf">glBindVertexArray</span><span class="p">(</span><span class="n">mesh</span><span class="o">-></span><span class="n">vao</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln">4</span><span class="cl"><span class="nf">glDrawElements</span><span class="p">(...);</span>
+</span></span><span class="line"><span class="ln">5</span><span class="cl">
+</span></span><span class="line"><span class="ln">6</span><span class="cl"><span class="p">...</span></span></span></code></pre></div>
+<p>Since I wasn’t unbinding the mesh’s vertex array object when I finished drawing it, when I updated another mesh’s vertex or index data and bound that mesh’s buffer objects, the vertex array object I forgot to unbind would now be using the incorrect buffers to draw with.</p>
+<p>Luckily, there was a simple fix, and now I know to be more careful with unbinding vertex array objects:</p>
+
+
+
+
+<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-c" data-lang="c"><span class="line"><span class="ln">1</span><span class="cl"><span class="p">...</span>
+</span></span><span class="line"><span class="ln">2</span><span class="cl">
+</span></span><span class="line"><span class="ln">3</span><span class="cl"><span class="nf">glBindVertexArray</span><span class="p">(</span><span class="n">mesh</span><span class="o">-></span><span class="n">vao</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln">4</span><span class="cl"><span class="nf">glDrawElements</span><span class="p">(...);</span>
+</span></span><span class="line"><span class="ln">5</span><span class="cl"><span class="nf">glBindVertexArray</span><span class="p">(</span><span class="mi">0</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln">6</span><span class="cl">
+</span></span><span class="line"><span class="ln">7</span><span class="cl"><span class="p">...</span></span></span></code></pre></div>
+]]></content:encoded>
+ </item>
+ </channel>
+</rss>
diff --git a/posts/look-at/index.html b/posts/look-at/index.html
@@ -0,0 +1,170 @@
+<!DOCTYPE html>
+<html lang="en-US">
+
+<head>
+ <meta http-equiv="X-Clacks-Overhead" content="GNU Terry Pratchett" />
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+<link rel="shortcut icon" href="https://electrosoup.com/favicon.png" />
+<title>Understanding Camera Look-At. | Electrosoup</title>
+<meta name="title" content="Understanding Camera Look-At." />
+<meta name="description" content="Often times, we want to position the camera in our scene at a particular point,
+such as the head of the character in a first-person shooter or the cockpit of a
+plane in a flight simulator. We also want the camera to look in the direction
+that the player is trying to move." />
+<meta name="author" content="" />
+<meta name="keywords" content="Graphics,Matrices,OpenGL," />
+
+
+
+
+
+
+
+ <meta property="og:url" content="https://electrosoup.com/posts/look-at/">
+ <meta property="og:site_name" content="Electrosoup">
+ <meta property="og:title" content="Understanding Camera Look-At.">
+ <meta property="og:description" content="Often times, we want to position the camera in our scene at a particular point, such as the head of the character in a first-person shooter or the cockpit of a plane in a flight simulator. We also want the camera to look in the direction that the player is trying to move.">
+ <meta property="og:locale" content="en_US">
+ <meta property="og:type" content="article">
+ <meta property="article:section" content="posts">
+ <meta property="article:published_time" content="2022-10-10T00:31:00-04:00">
+ <meta property="article:modified_time" content="2022-10-10T00:31:00-04:00">
+ <meta property="article:tag" content="Graphics">
+ <meta property="article:tag" content="Matrices">
+ <meta property="article:tag" content="OpenGL">
+
+
+
+
+ <meta name="twitter:card" content="summary">
+ <meta name="twitter:title" content="Understanding Camera Look-At.">
+ <meta name="twitter:description" content="Often times, we want to position the camera in our scene at a particular point, such as the head of the character in a first-person shooter or the cockpit of a plane in a flight simulator. We also want the camera to look in the direction that the player is trying to move.">
+
+
+
+
+ <meta itemprop="name" content="Understanding Camera Look-At.">
+ <meta itemprop="description" content="Often times, we want to position the camera in our scene at a particular point, such as the head of the character in a first-person shooter or the cockpit of a plane in a flight simulator. We also want the camera to look in the direction that the player is trying to move.">
+ <meta itemprop="datePublished" content="2022-10-10T00:31:00-04:00">
+ <meta itemprop="dateModified" content="2022-10-10T00:31:00-04:00">
+ <meta itemprop="wordCount" content="210">
+ <meta itemprop="keywords" content="Graphics,Matrices,OpenGL">
+
+
+ <link href="/herman.min.css" rel="stylesheet">
+
+
+
+
+
+
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/katex@0.16.11/dist/katex.min.css" integrity="sha384-nB0miv6/jRmo5UMMR1wu3Gz6NLsoTkbqJghGIsx//Rlm+ZU03BU6SQNC66uf4l5+" crossorigin="anonymous">
+<script defer src="https://cdn.jsdelivr.net/npm/katex@0.16.11/dist/katex.min.js" integrity="sha384-7zkQWkzuo3B5mTepMUcHkMB5jZaolc2xDwL6VFqjFALcbeS9Ggm/Yr2r3Dy4lfFg" crossorigin="anonymous"></script>
+<script defer src="https://cdn.jsdelivr.net/npm/katex@0.16.11/dist/contrib/auto-render.min.js" integrity="sha384-43gviWU0YVjaDtb/GhzOouOXtZMP/7XUzwPTstBeZFe/+rCMvRwr4yROQP43s0Xk" crossorigin="anonymous"
+ onload="renderMathInElement(document.body);"></script>
+
+
+</head>
+
+<body>
+ <header><a class="skip-link" href="#main-content">Skip to main content</a>
+
+<nav>
+ <a href="/">Main</a>
+
+ <a href="/posts/">Posts</a>
+
+ <a href="https://git.electrosoup.com">Code</a>
+
+ <a href="https://christianermann.dev">Resume</a>
+
+
+
+
+
+
+
+
+
+</nav>
+</header>
+ <main id="main-content">
+
+<h1>Understanding Camera Look-At.</h1>
+<p class="byline">
+
+ <time datetime='2022-10-10' pubdate>
+ 2022-10-10
+ </time>
+
+</p>
+
+<content>
+ <p>Often times, we want to position the camera in our scene at a particular point,
+such as the head of the character in a first-person shooter or the cockpit of a
+plane in a flight simulator. We also want the camera to look in the direction
+that the player is trying to move.</p>
+<p>To do this, we need to find the forward, right, and up vectors that correspond
+to the desired view.</p>
+<p>If we let $\vec{p}$ be the camera’s position and $\vec{t}$ be the position of
+what we want to look at, the camera’s look direction is
+$$\vec{l}=\vec{t}-\vec{p}\,.$$
+Conventionally, the camera looks down the negative forward axis so
+$$\vec{f}=-\vec{l}\,.$$</p>
+<p>In order to determine the right vector, we need a reference up direction,
+$\vec{up}$ (which isn’t necessarily orthogonal to $\vec{f}$). This enables us
+to calculate
+$$\vec{r} = \vec{f} \times \vec{up}$$
+and
+$$\vec{u} = \vec{r} \times \vec{f}\,.$$</p>
+<p>Now we can use the camera position $\vec{p}$ and normalized forms of $\vec{f}$,
+$\vec{r}$, and $\vec{u}$ to fill in our
+<a href="/posts/view-matrix/">view matrix</a>:</p>
+<p>$$
+V
+=
+\begin{bmatrix}
+r_{x} & r_{y} & r_{z} & -(\vec{r} \cdot \vec{p}) \\
+u_{x} & u_{y} & u_{z} & -(\vec{u} \cdot \vec{p}) \\
+f_{x} & f_{y} & f_{z} & -(\vec{f} \cdot \vec{p}) \\
+0 & 0 & 0 & 1
+\end{bmatrix}
+$$</p>
+
+</content>
+<p>
+
+ <a class="blog-tags" href="/tags/graphics/">#graphics</a>
+
+ <a class="blog-tags" href="/tags/matrices/">#matrices</a>
+
+ <a class="blog-tags" href="/tags/opengl/">#opengl</a>
+
+</p>
+
+
+ <p>
+ <a href='mailto:christianermann@gmail.com?subject=Reply%20to%20"Understanding%20Camera%20Look-At."'>
+ Reply to this post by email ↪
+ </a>
+ </p>
+
+
+
+ </main>
+ <footer><footer>
+
+ <a href="https://git.electrosoup.com">Code</a>.
+
+ <a href="https://christianermann.dev">Resume</a>.
+
+ <a href='https://electrosoup.com/index.xml'>RSS</a>.
+ <p>Copyright © 2026 Christian Ermann. | Made with <a href="https://github.com/clente/hugo-bearcub">Bear Cub</a></p>
+</footer>
+</footer>
+
+
+</body>
+
+</html>
diff --git a/posts/the-infamous-link-macro/index.html b/posts/the-infamous-link-macro/index.html
@@ -0,0 +1,232 @@
+<!DOCTYPE html>
+<html lang="en-US">
+
+<head>
+ <meta http-equiv="X-Clacks-Overhead" content="GNU Terry Pratchett" />
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+<link rel="shortcut icon" href="https://electrosoup.com/favicon.png" />
+<title>The Infamous 'link' Macro | Electrosoup</title>
+<meta name="title" content="The Infamous 'link' Macro" />
+<meta name="description" content="Each word (or function, in other languages) in Forth is stored as an entry in
+a linked list known as the dictionary. When bootstrapping a Forth from
+assembly, it is your responsibility to create and maintain this linked list
+structure. This is a tedious process and is the source of many errors when
+re-arranging words or defining new words; it’s incredibly easy to turn your
+list into a graph by mistake." />
+<meta name="author" content="" />
+<meta name="keywords" content="Forth,Assembly,RISC-V,ARM," />
+
+
+
+
+
+
+
+ <meta property="og:url" content="https://electrosoup.com/posts/the-infamous-link-macro/">
+ <meta property="og:site_name" content="Electrosoup">
+ <meta property="og:title" content="The Infamous 'link' Macro">
+ <meta property="og:description" content="Each word (or function, in other languages) in Forth is stored as an entry in a linked list known as the dictionary. When bootstrapping a Forth from assembly, it is your responsibility to create and maintain this linked list structure. This is a tedious process and is the source of many errors when re-arranging words or defining new words; it’s incredibly easy to turn your list into a graph by mistake.">
+ <meta property="og:locale" content="en_US">
+ <meta property="og:type" content="article">
+ <meta property="article:section" content="posts">
+ <meta property="article:published_time" content="2024-11-12T13:01:09-08:00">
+ <meta property="article:modified_time" content="2024-11-12T13:01:09-08:00">
+ <meta property="article:tag" content="Forth">
+ <meta property="article:tag" content="Assembly">
+ <meta property="article:tag" content="RISC-V">
+ <meta property="article:tag" content="ARM">
+
+
+
+
+ <meta name="twitter:card" content="summary">
+ <meta name="twitter:title" content="The Infamous 'link' Macro">
+ <meta name="twitter:description" content="Each word (or function, in other languages) in Forth is stored as an entry in a linked list known as the dictionary. When bootstrapping a Forth from assembly, it is your responsibility to create and maintain this linked list structure. This is a tedious process and is the source of many errors when re-arranging words or defining new words; it’s incredibly easy to turn your list into a graph by mistake.">
+
+
+
+
+ <meta itemprop="name" content="The Infamous 'link' Macro">
+ <meta itemprop="description" content="Each word (or function, in other languages) in Forth is stored as an entry in a linked list known as the dictionary. When bootstrapping a Forth from assembly, it is your responsibility to create and maintain this linked list structure. This is a tedious process and is the source of many errors when re-arranging words or defining new words; it’s incredibly easy to turn your list into a graph by mistake.">
+ <meta itemprop="datePublished" content="2024-11-12T13:01:09-08:00">
+ <meta itemprop="dateModified" content="2024-11-12T13:01:09-08:00">
+ <meta itemprop="wordCount" content="316">
+ <meta itemprop="keywords" content="Forth,Assembly,RISC-V,ARM">
+
+
+ <link href="/herman.min.css" rel="stylesheet">
+
+
+
+ <link href="/syntax.min.css" rel="stylesheet">
+
+
+
+
+
+</head>
+
+<body>
+ <header><a class="skip-link" href="#main-content">Skip to main content</a>
+
+<nav>
+ <a href="/">Main</a>
+
+ <a href="/posts/">Posts</a>
+
+ <a href="https://git.electrosoup.com">Code</a>
+
+ <a href="https://christianermann.dev">Resume</a>
+
+
+
+
+
+
+
+
+
+</nav>
+</header>
+ <main id="main-content">
+
+<h1>The Infamous 'link' Macro</h1>
+<p class="byline">
+
+ <time datetime='2024-11-12' pubdate>
+ 2024-11-12
+ </time>
+
+</p>
+
+<content>
+ <p>Each word (or function, in other languages) in Forth is stored as an entry in
+a linked list known as the dictionary. When bootstrapping a Forth from
+assembly, it is your responsibility to create and maintain this linked list
+structure. This is a tedious process and is the source of many errors when
+re-arranging words or defining new words; it’s incredibly easy to turn your
+list into a graph by mistake.</p>
+<p>In
+<a href="https://rwmj.wordpress.com/2010/08/07/jonesforth-git-repository/">jonesforth</a>,
+an x86 implementation of Forth, the assembler supports re-assigning new values
+to assembler variables. This means an assember variable can be used to store
+the memory address of the previous entry, and we have the ability to update it
+or use it whenever we need to. I used this exact strategy in my
+<a href="https://git.christianermann.dev/forth/log.html">incomplete x86 Forth</a> although
+I used <a href="https://flatassembler.net/">FASM</a> instead of
+<a href="https://wiki.osdev.org/GAS">GAS</a>. Unfortunately, GAS doesn’t support this
+feature for ARM or RISC-V targets. It may be possible to pull this off on ARM
+with the right set of relocation and/or relaxation parameters, but I was unable
+to find success with RISC-V.</p>
+<p>I did come up with an alternative set of macros that achieves the same goal
+and should be more portable than the <code>jonesforth</code> solution:</p>
+
+
+
+
+
+<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-GAS" data-lang="GAS"><span class="line"><span class="ln"> 1</span><span class="cl"><span class="na">.macro</span> <span class="no">this_link</span>
+</span></span><span class="line"><span class="ln"> 2</span><span class="cl"> <span class="na">.globl</span> <span class="no">link_</span><span class="err">\+</span>
+</span></span><span class="line"><span class="ln"> 3</span><span class="cl"><span class="nf">link_</span><span class="err">\+</span><span class="p">:</span>
+</span></span><span class="line"><span class="ln"> 4</span><span class="cl"><span class="na">.endm</span>
+</span></span><span class="line"><span class="ln"> 5</span><span class="cl">
+</span></span><span class="line"><span class="ln"> 6</span><span class="cl"><span class="na">.macro</span> <span class="no">prev_link</span>
+</span></span><span class="line"><span class="ln"> 7</span><span class="cl"> <span class="na">.int</span> <span class="no">link_</span><span class="err">\+</span>
+</span></span><span class="line"><span class="ln"> 8</span><span class="cl"><span class="na">.endm</span>
+</span></span><span class="line"><span class="ln"> 9</span><span class="cl">
+</span></span><span class="line"><span class="ln">10</span><span class="cl"><span class="na">.macro</span> <span class="no">link</span>
+</span></span><span class="line"><span class="ln">11</span><span class="cl"> <span class="nf">this_link</span>
+</span></span><span class="line"><span class="ln">12</span><span class="cl"> <span class="nf">prev_link</span>
+</span></span><span class="line"><span class="ln">13</span><span class="cl"><span class="na">.endm</span>
+</span></span><span class="line"><span class="ln">14</span><span class="cl">
+</span></span><span class="line"><span class="ln">15</span><span class="cl"><span class="nf">this_link</span></span></span></code></pre></div><p>These macros depend on the special value
+
+
+
+
+<code class="code-inline language-GAS"><span class="err">\+</span></code>.
+This value is replaced by the invocation count of the current macro during
+assembly. Since we want to
+
+
+
+
+<code class="code-inline language-GAS"><span class="nf">link</span></code>
+back to the previous word in the dictionary, we need
+
+
+
+
+<code class="code-inline language-GAS"><span class="nf">prev_link</span></code>
+to resolve to 1 word before
+
+
+
+
+<code class="code-inline language-GAS"><span class="nf">this_link</span></code>,
+which is why we call
+
+
+
+
+<code class="code-inline language-GAS"><span class="nf">this_link</span></code>
+once before defining any words.</p>
+<p>You’ll also need to add this to your linker script to null-terminate your
+dictionary, otherwise the start of your dictionary will be marked by the
+address where the
+
+
+
+
+<code class="code-inline language-GAS"><span class="nf">link_0</span></code>
+label created by
+
+
+
+
+<code class="code-inline language-GAS"><span class="nf">this_link</span></code> was stored:</p>
+
+
+
+
+
+<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-GAS" data-lang="GAS"><span class="line"><span class="ln">1</span><span class="cl"><span class="nf">link_0</span> <span class="err">=</span> <span class="mi">0</span><span class="err">;</span></span></span></code></pre></div>
+</content>
+<p>
+
+ <a class="blog-tags" href="/tags/forth/">#forth</a>
+
+ <a class="blog-tags" href="/tags/assembly/">#assembly</a>
+
+ <a class="blog-tags" href="/tags/risc-v/">#risc-v</a>
+
+ <a class="blog-tags" href="/tags/arm/">#arm</a>
+
+</p>
+
+
+ <p>
+ <a href='mailto:christianermann@gmail.com?subject=Reply%20to%20"The%20Infamous%20%27link%27%20Macro"'>
+ Reply to this post by email ↪
+ </a>
+ </p>
+
+
+
+ </main>
+ <footer><footer>
+
+ <a href="https://git.electrosoup.com">Code</a>.
+
+ <a href="https://christianermann.dev">Resume</a>.
+
+ <a href='https://electrosoup.com/index.xml'>RSS</a>.
+ <p>Copyright © 2026 Christian Ermann. | Made with <a href="https://github.com/clente/hugo-bearcub">Bear Cub</a></p>
+</footer>
+</footer>
+
+
+</body>
+
+</html>
diff --git a/posts/unbind/index.html b/posts/unbind/index.html
@@ -0,0 +1,197 @@
+<!DOCTYPE html>
+<html lang="en-US">
+
+<head>
+ <meta http-equiv="X-Clacks-Overhead" content="GNU Terry Pratchett" />
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+<link rel="shortcut icon" href="https://electrosoup.com/favicon.png" />
+<title>Unbind Your Vertex Array Objects. | Electrosoup</title>
+<meta name="title" content="Unbind Your Vertex Array Objects." />
+<meta name="description" content="When I first started learning about OpenGL, I always made sure to unbind each resource as soon as I was done using it. Over time I became more lenient with unbinding, as in many cases leaving resources bound is okay and leads to fewer API calls." />
+<meta name="author" content="" />
+<meta name="keywords" content="OpenGL,C," />
+
+
+
+
+
+
+
+ <meta property="og:url" content="https://electrosoup.com/posts/unbind/">
+ <meta property="og:site_name" content="Electrosoup">
+ <meta property="og:title" content="Unbind Your Vertex Array Objects.">
+ <meta property="og:description" content="When I first started learning about OpenGL, I always made sure to unbind each resource as soon as I was done using it. Over time I became more lenient with unbinding, as in many cases leaving resources bound is okay and leads to fewer API calls.">
+ <meta property="og:locale" content="en_US">
+ <meta property="og:type" content="article">
+ <meta property="article:section" content="posts">
+ <meta property="article:published_time" content="2021-08-25T14:33:02-05:00">
+ <meta property="article:modified_time" content="2021-08-25T14:33:02-05:00">
+ <meta property="article:tag" content="OpenGL">
+ <meta property="article:tag" content="C">
+
+
+
+
+ <meta name="twitter:card" content="summary">
+ <meta name="twitter:title" content="Unbind Your Vertex Array Objects.">
+ <meta name="twitter:description" content="When I first started learning about OpenGL, I always made sure to unbind each resource as soon as I was done using it. Over time I became more lenient with unbinding, as in many cases leaving resources bound is okay and leads to fewer API calls.">
+
+
+
+
+ <meta itemprop="name" content="Unbind Your Vertex Array Objects.">
+ <meta itemprop="description" content="When I first started learning about OpenGL, I always made sure to unbind each resource as soon as I was done using it. Over time I became more lenient with unbinding, as in many cases leaving resources bound is okay and leads to fewer API calls.">
+ <meta itemprop="datePublished" content="2021-08-25T14:33:02-05:00">
+ <meta itemprop="dateModified" content="2021-08-25T14:33:02-05:00">
+ <meta itemprop="wordCount" content="397">
+ <meta itemprop="keywords" content="OpenGL,C">
+
+
+ <link href="/herman.min.css" rel="stylesheet">
+
+
+
+ <link href="/syntax.min.css" rel="stylesheet">
+
+
+
+
+
+</head>
+
+<body>
+ <header><a class="skip-link" href="#main-content">Skip to main content</a>
+
+<nav>
+ <a href="/">Main</a>
+
+ <a href="/posts/">Posts</a>
+
+ <a href="https://git.electrosoup.com">Code</a>
+
+ <a href="https://christianermann.dev">Resume</a>
+
+
+
+
+
+
+
+
+
+</nav>
+</header>
+ <main id="main-content">
+
+<h1>Unbind Your Vertex Array Objects.</h1>
+<p class="byline">
+
+ <time datetime='2021-08-25' pubdate>
+ 2021-08-25
+ </time>
+
+</p>
+
+<content>
+ <p>When I first started learning about OpenGL, I always made sure to unbind each resource as soon as I was done using it. Over time I became more lenient with unbinding, as in many cases leaving resources bound is okay and leads to fewer API calls.</p>
+<p>In addition, when I’m developing on my PC I have access to the newer Direct State Access (DSA) functions, so binding resources isn’t something I have to worry about as much. However, I do a fair amount of programming on my macbook which means I don’t always have access to the DSA functions.</p>
+<p>I was working on a project recently that involved the vertex and index data for a mesh frequently changing. The actual mesh struct has a bit more going on, but we can think of it like this for now:</p>
+
+
+
+
+<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-c" data-lang="c"><span class="line"><span class="ln">1</span><span class="cl"><span class="k">typedef</span> <span class="k">struct</span> <span class="p">{</span>
+</span></span><span class="line"><span class="ln">2</span><span class="cl"> <span class="n">Vec3</span> <span class="o">*</span><span class="n">vertices</span><span class="p">;</span>
+</span></span><span class="line"><span class="ln">3</span><span class="cl"> <span class="n">GLuint</span> <span class="o">*</span><span class="n">indices</span><span class="p">;</span>
+</span></span><span class="line"><span class="ln">4</span><span class="cl"> <span class="n">GLuint</span> <span class="n">vao</span><span class="p">;</span>
+</span></span><span class="line"><span class="ln">5</span><span class="cl"> <span class="n">GLuint</span> <span class="n">vbo</span><span class="p">;</span>
+</span></span><span class="line"><span class="ln">6</span><span class="cl"> <span class="n">GLuint</span> <span class="n">ebo</span><span class="p">;</span>
+</span></span><span class="line"><span class="ln">7</span><span class="cl"><span class="p">}</span> <span class="n">Mesh</span><span class="p">;</span></span></span></code></pre></div>
+<p>So when it comes time to update the vertex or index data, we map the vertex buffer object to the vertices pointer and the element buffer object to the indices pointer. Then we can write all of our vertex and index data directly to the buffers, and then unmap them when we’re all done and need to draw.</p>
+
+
+
+
+<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-c" data-lang="c"><span class="line"><span class="ln"> 1</span><span class="cl"><span class="p">...</span>
+</span></span><span class="line"><span class="ln"> 2</span><span class="cl">
+</span></span><span class="line"><span class="ln"> 3</span><span class="cl"><span class="nf">glBindBuffer</span><span class="p">(</span><span class="n">GL_ARRAY_BUFFER</span><span class="p">,</span> <span class="n">mesh</span><span class="o">-></span><span class="n">vbo</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln"> 4</span><span class="cl"><span class="n">mesh</span><span class="o">-></span><span class="n">vertices</span> <span class="o">=</span> <span class="nf">glMapBuffer</span><span class="p">(</span><span class="n">GL_ARRAY_BUFFER</span><span class="p">,</span> <span class="n">GL_WRITE_ONLY</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln"> 5</span><span class="cl">
+</span></span><span class="line"><span class="ln"> 6</span><span class="cl"><span class="nf">glBindBuffer</span><span class="p">(</span><span class="n">GL_ELEMENT_ARRAY_BUFFER</span><span class="p">,</span> <span class="n">mesh</span><span class="o">-></span><span class="n">ebo</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln"> 7</span><span class="cl"><span class="n">mesh</span><span class="o">-></span><span class="n">indices</span> <span class="o">=</span> <span class="nf">glMapBuffer</span><span class="p">(</span><span class="n">GL_ELEMENT_ARRAY_BUFFER</span><span class="p">,</span> <span class="n">GL_WRITE_ONLY</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln"> 8</span><span class="cl">
+</span></span><span class="line"><span class="ln"> 9</span><span class="cl"><span class="c1">// While we have the buffers mapped, we can write data directly to
+</span></span></span><span class="line"><span class="ln">10</span><span class="cl"><span class="c1">// mesh->vertices and mesh->indices.
+</span></span></span><span class="line"><span class="ln">11</span><span class="cl"><span class="c1"></span>
+</span></span><span class="line"><span class="ln">12</span><span class="cl"><span class="nf">glBindBuffer</span><span class="p">(</span><span class="n">GL_ARRAY_BUFFER</span><span class="p">,</span> <span class="n">mesh</span><span class="o">-></span><span class="n">vbo</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln">13</span><span class="cl"><span class="nf">glUnmapBuffer</span><span class="p">(</span><span class="n">GL_ARRAY_BUFFER</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln">14</span><span class="cl"><span class="n">mesh</span><span class="o">-></span><span class="n">vertices</span> <span class="o">=</span> <span class="nb">NULL</span>
+</span></span><span class="line"><span class="ln">15</span><span class="cl">
+</span></span><span class="line"><span class="ln">16</span><span class="cl"><span class="nf">glBindBuffer</span><span class="p">(</span><span class="n">GL_ELEMENT_ARRAY_BUFFER</span><span class="p">,</span> <span class="n">mesh</span><span class="o">-></span><span class="n">ebo</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln">17</span><span class="cl"><span class="nf">glUnmapBuffer</span><span class="p">(</span><span class="n">GL_ELEMENT_ARRAY_BUFFER</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln">18</span><span class="cl"><span class="n">mesh</span><span class="o">-></span><span class="n">indices</span> <span class="o">=</span> <span class="nb">NULL</span>
+</span></span><span class="line"><span class="ln">19</span><span class="cl">
+</span></span><span class="line"><span class="ln">20</span><span class="cl"><span class="c1">// Now that the buffers are unmapped, we can draw the mesh again.
+</span></span></span><span class="line"><span class="ln">21</span><span class="cl"><span class="c1"></span>
+</span></span><span class="line"><span class="ln">22</span><span class="cl"><span class="p">...</span></span></span></code></pre></div>
+<p>Leaving the buffers bound in the above snippet didn’t cause problems and seemed a reasonable thing to do to reduce unnecessary OpenGL calls.
+The issues I was running into were actually caused by how I was drawing each mesh:</p>
+
+
+
+
+<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-c" data-lang="c"><span class="line"><span class="ln">1</span><span class="cl"><span class="p">...</span>
+</span></span><span class="line"><span class="ln">2</span><span class="cl">
+</span></span><span class="line"><span class="ln">3</span><span class="cl"><span class="nf">glBindVertexArray</span><span class="p">(</span><span class="n">mesh</span><span class="o">-></span><span class="n">vao</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln">4</span><span class="cl"><span class="nf">glDrawElements</span><span class="p">(...);</span>
+</span></span><span class="line"><span class="ln">5</span><span class="cl">
+</span></span><span class="line"><span class="ln">6</span><span class="cl"><span class="p">...</span></span></span></code></pre></div>
+<p>Since I wasn’t unbinding the mesh’s vertex array object when I finished drawing it, when I updated another mesh’s vertex or index data and bound that mesh’s buffer objects, the vertex array object I forgot to unbind would now be using the incorrect buffers to draw with.</p>
+<p>Luckily, there was a simple fix, and now I know to be more careful with unbinding vertex array objects:</p>
+
+
+
+
+<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-c" data-lang="c"><span class="line"><span class="ln">1</span><span class="cl"><span class="p">...</span>
+</span></span><span class="line"><span class="ln">2</span><span class="cl">
+</span></span><span class="line"><span class="ln">3</span><span class="cl"><span class="nf">glBindVertexArray</span><span class="p">(</span><span class="n">mesh</span><span class="o">-></span><span class="n">vao</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln">4</span><span class="cl"><span class="nf">glDrawElements</span><span class="p">(...);</span>
+</span></span><span class="line"><span class="ln">5</span><span class="cl"><span class="nf">glBindVertexArray</span><span class="p">(</span><span class="mi">0</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln">6</span><span class="cl">
+</span></span><span class="line"><span class="ln">7</span><span class="cl"><span class="p">...</span></span></span></code></pre></div>
+
+</content>
+<p>
+
+ <a class="blog-tags" href="/tags/opengl/">#opengl</a>
+
+ <a class="blog-tags" href="/tags/c/">#c</a>
+
+</p>
+
+
+ <p>
+ <a href='mailto:christianermann@gmail.com?subject=Reply%20to%20"Unbind%20Your%20Vertex%20Array%20Objects."'>
+ Reply to this post by email ↪
+ </a>
+ </p>
+
+
+
+ </main>
+ <footer><footer>
+
+ <a href="https://git.electrosoup.com">Code</a>.
+
+ <a href="https://christianermann.dev">Resume</a>.
+
+ <a href='https://electrosoup.com/index.xml'>RSS</a>.
+ <p>Copyright © 2026 Christian Ermann. | Made with <a href="https://github.com/clente/hugo-bearcub">Bear Cub</a></p>
+</footer>
+</footer>
+
+
+</body>
+
+</html>
diff --git a/posts/view-matrix/index.html b/posts/view-matrix/index.html
@@ -0,0 +1,284 @@
+<!DOCTYPE html>
+<html lang="en-US">
+
+<head>
+ <meta http-equiv="X-Clacks-Overhead" content="GNU Terry Pratchett" />
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+<link rel="shortcut icon" href="https://electrosoup.com/favicon.png" />
+<title>Deriving the View Matrix | Electrosoup</title>
+<meta name="title" content="Deriving the View Matrix" />
+<meta name="description" content="In computer graphics, the view matrix is used to transform points from
+world space into camera space. Below is an explanation of how to derive this
+matrix." />
+<meta name="author" content="" />
+<meta name="keywords" content="Graphics,Matrices,OpenGL," />
+
+
+
+
+
+
+
+ <meta property="og:url" content="https://electrosoup.com/posts/view-matrix/">
+ <meta property="og:site_name" content="Electrosoup">
+ <meta property="og:title" content="Deriving the View Matrix">
+ <meta property="og:description" content="In computer graphics, the view matrix is used to transform points from world space into camera space. Below is an explanation of how to derive this matrix.">
+ <meta property="og:locale" content="en_US">
+ <meta property="og:type" content="article">
+ <meta property="article:section" content="posts">
+ <meta property="article:published_time" content="2021-11-21T13:34:08-08:00">
+ <meta property="article:modified_time" content="2021-11-21T13:34:08-08:00">
+ <meta property="article:tag" content="Graphics">
+ <meta property="article:tag" content="Matrices">
+ <meta property="article:tag" content="OpenGL">
+
+
+
+
+ <meta name="twitter:card" content="summary">
+ <meta name="twitter:title" content="Deriving the View Matrix">
+ <meta name="twitter:description" content="In computer graphics, the view matrix is used to transform points from world space into camera space. Below is an explanation of how to derive this matrix.">
+
+
+
+
+ <meta itemprop="name" content="Deriving the View Matrix">
+ <meta itemprop="description" content="In computer graphics, the view matrix is used to transform points from world space into camera space. Below is an explanation of how to derive this matrix.">
+ <meta itemprop="datePublished" content="2021-11-21T13:34:08-08:00">
+ <meta itemprop="dateModified" content="2021-11-21T13:34:08-08:00">
+ <meta itemprop="wordCount" content="521">
+ <meta itemprop="keywords" content="Graphics,Matrices,OpenGL">
+
+
+ <link href="/herman.min.css" rel="stylesheet">
+
+
+
+
+
+
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/katex@0.16.11/dist/katex.min.css" integrity="sha384-nB0miv6/jRmo5UMMR1wu3Gz6NLsoTkbqJghGIsx//Rlm+ZU03BU6SQNC66uf4l5+" crossorigin="anonymous">
+<script defer src="https://cdn.jsdelivr.net/npm/katex@0.16.11/dist/katex.min.js" integrity="sha384-7zkQWkzuo3B5mTepMUcHkMB5jZaolc2xDwL6VFqjFALcbeS9Ggm/Yr2r3Dy4lfFg" crossorigin="anonymous"></script>
+<script defer src="https://cdn.jsdelivr.net/npm/katex@0.16.11/dist/contrib/auto-render.min.js" integrity="sha384-43gviWU0YVjaDtb/GhzOouOXtZMP/7XUzwPTstBeZFe/+rCMvRwr4yROQP43s0Xk" crossorigin="anonymous"
+ onload="renderMathInElement(document.body);"></script>
+
+
+</head>
+
+<body>
+ <header><a class="skip-link" href="#main-content">Skip to main content</a>
+
+<nav>
+ <a href="/">Main</a>
+
+ <a href="/posts/">Posts</a>
+
+ <a href="https://git.electrosoup.com">Code</a>
+
+ <a href="https://christianermann.dev">Resume</a>
+
+
+
+
+
+
+
+
+
+</nav>
+</header>
+ <main id="main-content">
+
+<h1>Deriving the View Matrix</h1>
+<p class="byline">
+
+ <time datetime='2021-11-21' pubdate>
+ 2021-11-21
+ </time>
+
+</p>
+
+<content>
+ <p>In computer graphics, the view matrix is used to transform points from
+world space into camera space. Below is an explanation of how to derive this
+matrix.</p>
+<p>Let $V$ be the view matrix.
+If $\vec{r}$, $\vec{u}$, and $\vec{f}$ denote the right, up, and forward
+vectors of the camera and $\vec{p}$ is the camera’s position, $V$ should
+satisfy the following properties:
+$$
+\begin{matrix}
+V_{1*} \times
+\begin{bmatrix}
+r_{x} \\
+r_{y} \\
+r_{z} \\
+0
+\end{bmatrix}
+=
+\begin{bmatrix}
+1 \\
+0 \\
+0 \\
+0
+\end{bmatrix},&
+V_{2*} \times
+\begin{bmatrix}
+u_{x} \\
+u_{y} \\
+u_{z} \\
+0
+\end{bmatrix}
+=
+\begin{bmatrix}
+0 \\
+1 \\
+0 \\
+0
+\end{bmatrix},&
+V_{3*} \times
+\begin{bmatrix}
+f_{x} \\
+f_{y} \\
+f_{z} \\
+0
+\end{bmatrix}
+=
+\begin{bmatrix}
+0 \\
+0 \\
+1 \\
+0
+\end{bmatrix},&
+V_{4*} \times
+\begin{bmatrix}
+p_{x} \\
+p_{y} \\
+p_{z} \\
+1
+\end{bmatrix}
+=
+\begin{bmatrix}
+0 \\
+0 \\
+0 \\
+1
+\end{bmatrix}
+\end{matrix}
+$$
+In words, the view matrix should translate the camera to the origin and rotate
+it to align with the $\vec{x}$, $\vec{y}$, and $\vec{z}$ axes.</p>
+<p>This can be expressed more concisely as the product of two matrices:
+$$
+V \times
+\begin{bmatrix}
+r_{x} & u_{x} & f_{x} & p_{x} \\
+r_{y} & u_{y} & f_{y} & p_{y} \\
+r_{z} & u_{z} & f_{z} & p_{z} \\
+0 & 0 & 0 & 1
+\end{bmatrix}
+=
+\begin{bmatrix}
+1 & 0 & 0 & 0 \\
+0 & 1 & 0 & 0 \\
+0 & 0 & 1 & 0 \\
+0 & 0 & 0 & 1
+\end{bmatrix}
+$$</p>
+<p>To make this equation easier to solve, we can split the matrix containing our
+camera parameters into the product of a translation matrix $T$ and a rotation
+matrix $R$:
+$$
+V \times (T \times R) = I
+$$
+where
+$$
+\begin{matrix}
+T =
+\begin{bmatrix}
+1 & 0 & 0 & p_{x} \\
+0 & 1 & 0 & p_{y} \\
+0 & 0 & 1 & p_{z} \\
+0 & 0 & 0 & 1
+\end{bmatrix},&
+R =
+\begin{bmatrix}
+r_{x} & u_{x} & f_{x} & 0 \\
+r_{y} & u_{y} & f_{y} & 0 \\
+r_{z} & u_{z} & f_{z} & 0 \\
+0 & 0 & 0 & 1
+\end{bmatrix}
+\end{matrix}
+$$</p>
+<p>Solving for $V$ reveals that $V=R^{-1} \times T^{-1}$:
+$$
+V =
+\begin{bmatrix}
+r_{x} & r_{y} & r_{z} & 0 \\
+u_{x} & u_{y} & u_{z} & 0 \\
+f_{x} & f_{y} & f_{z} & 0 \\
+0 & 0 & 0 & 1
+\end{bmatrix}
+\times
+\begin{bmatrix}
+1 & 0 & 0 & -p_{x} \\
+0 & 1 & 0 & -p_{y} \\
+0 & 0 & 1 & -p_{z} \\
+0 & 0 & 0 & 1
+\end{bmatrix}
+$$</p>
+<p>And with some minor simplification,
+$$
+V
+=
+\begin{bmatrix}
+r_{x} & r_{y} & r_{z} & -(\vec{r} \cdot \vec{p}) \\
+u_{x} & u_{y} & u_{z} & -(\vec{u} \cdot \vec{p}) \\
+f_{x} & f_{y} & f_{z} & -(\vec{f} \cdot \vec{p}) \\
+0 & 0 & 0 & 1
+\end{bmatrix}
+$$</p>
+<p>When we’re ready to render our scene, we can apply $V$ to each vertex $\vec{q}$
+by calculating
+$$
+V \times \vec{q}
+$$
+in our vertex shader.</p>
+
+</content>
+<p>
+
+ <a class="blog-tags" href="/tags/graphics/">#graphics</a>
+
+ <a class="blog-tags" href="/tags/matrices/">#matrices</a>
+
+ <a class="blog-tags" href="/tags/opengl/">#opengl</a>
+
+</p>
+
+
+ <p>
+ <a href='mailto:christianermann@gmail.com?subject=Reply%20to%20"Deriving%20the%20View%20Matrix"'>
+ Reply to this post by email ↪
+ </a>
+ </p>
+
+
+
+ </main>
+ <footer><footer>
+
+ <a href="https://git.electrosoup.com">Code</a>.
+
+ <a href="https://christianermann.dev">Resume</a>.
+
+ <a href='https://electrosoup.com/index.xml'>RSS</a>.
+ <p>Copyright © 2026 Christian Ermann. | Made with <a href="https://github.com/clente/hugo-bearcub">Bear Cub</a></p>
+</footer>
+</footer>
+
+
+</body>
+
+</html>
diff --git a/robots.txt b/robots.txt
@@ -0,0 +1,3 @@
+User-agent: *
+Allow: /
+Sitemap: https://electrosoup.com/sitemap.xml
diff --git a/sitemap.xml b/sitemap.xml
@@ -0,0 +1,64 @@
+<?xml version="1.0" encoding="utf-8" standalone="yes"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
+ xmlns:xhtml="http://www.w3.org/1999/xhtml">
+ <url>
+ <loc>https://electrosoup.com/posts/</loc>
+ <lastmod>2026-10-03T17:07:00-05:00</lastmod>
+ </url><url>
+ <loc>https://electrosoup.com/tags/assembly/</loc>
+ <lastmod>2024-11-13T17:33:47-08:00</lastmod>
+ </url><url>
+ <loc>https://electrosoup.com/tags/forth/</loc>
+ <lastmod>2024-11-13T17:33:47-08:00</lastmod>
+ </url><url>
+ <loc>https://electrosoup.com/posts/forth-rv32i-assembler/</loc>
+ <lastmod>2024-11-13T17:33:47-08:00</lastmod>
+ </url><url>
+ <loc>https://electrosoup.com/tags/risc-v/</loc>
+ <lastmod>2024-11-13T17:33:47-08:00</lastmod>
+ </url><url>
+ <loc>https://electrosoup.com/tags/</loc>
+ <lastmod>2024-11-13T17:33:47-08:00</lastmod>
+ </url><url>
+ <loc>https://electrosoup.com/tags/arm/</loc>
+ <lastmod>2024-11-12T13:01:09-08:00</lastmod>
+ </url><url>
+ <loc>https://electrosoup.com/posts/the-infamous-link-macro/</loc>
+ <lastmod>2024-11-12T13:01:09-08:00</lastmod>
+ </url><url>
+ <loc>https://electrosoup.com/tags/c/</loc>
+ <lastmod>2024-10-23T16:29:40-07:00</lastmod>
+ </url><url>
+ <loc>https://electrosoup.com/tags/g-code/</loc>
+ <lastmod>2024-10-23T16:29:40-07:00</lastmod>
+ </url><url>
+ <loc>https://electrosoup.com/tags/lasers/</loc>
+ <lastmod>2024-10-23T16:29:40-07:00</lastmod>
+ </url><url>
+ <loc>https://electrosoup.com/posts/gcode-interpreter/</loc>
+ <lastmod>2024-10-23T16:29:40-07:00</lastmod>
+ </url><url>
+ <loc>https://electrosoup.com/tags/graphics/</loc>
+ <lastmod>2022-10-10T00:31:00-04:00</lastmod>
+ </url><url>
+ <loc>https://electrosoup.com/tags/matrices/</loc>
+ <lastmod>2022-10-10T00:31:00-04:00</lastmod>
+ </url><url>
+ <loc>https://electrosoup.com/tags/opengl/</loc>
+ <lastmod>2022-10-10T00:31:00-04:00</lastmod>
+ </url><url>
+ <loc>https://electrosoup.com/posts/look-at/</loc>
+ <lastmod>2022-10-10T00:31:00-04:00</lastmod>
+ </url><url>
+ <loc>https://electrosoup.com/posts/view-matrix/</loc>
+ <lastmod>2021-11-21T13:34:08-08:00</lastmod>
+ </url><url>
+ <loc>https://electrosoup.com/posts/unbind/</loc>
+ <lastmod>2021-08-25T14:33:02-05:00</lastmod>
+ </url><url>
+ <loc>https://electrosoup.com/</loc>
+ <lastmod>2021-08-25T00:00:00+00:00</lastmod>
+ </url><url>
+ <loc>https://electrosoup.com/categories/</loc>
+ </url>
+</urlset>
diff --git a/syntax.min.css b/syntax.min.css
@@ -0,0 +1 @@
+.bg{color:#f8f8f2;background-color:#282a36}.chroma{color:#f8f8f2;background-color:#282a36}.chroma .lnlinks{outline:none;text-decoration:none;color:inherit}.chroma .lntd{vertical-align:top;padding:0;margin:0;border:0}.chroma .lntable{border-spacing:0;padding:0;margin:0;border:0}.chroma .hl{background-color:#ffc}.chroma .lnt{white-space:pre;user-select:none;margin-right:.4em;padding:0 .4em;color:#929292}.chroma .ln{white-space:pre;user-select:none;margin-right:.4em;padding:0 .4em;color:#929292}.chroma .line{display:flex}.chroma .k{color:#ff79c6}.chroma .kc{color:#ff79c6}.chroma .kd{color:#8be9fd;font-style:italic}.chroma .kn{color:#ff79c6}.chroma .kp{color:#ff79c6}.chroma .kr{color:#ff79c6}.chroma .kt{color:#8be9fd}.chroma .na{color:#50fa7b}.chroma .nb{color:#8be9fd;font-style:italic}.chroma .nc{color:#50fa7b}.chroma .nf{color:#50fa7b}.chroma .nl{color:#8be9fd;font-style:italic}.chroma .nt{color:#ff79c6}.chroma .nv{color:#8be9fd;font-style:italic}.chroma .vc{color:#8be9fd;font-style:italic}.chroma .vg{color:#8be9fd;font-style:italic}.chroma .vi{color:#8be9fd;font-style:italic}.chroma .s{color:#f1fa8c}.chroma .sa{color:#f1fa8c}.chroma .sb{color:#f1fa8c}.chroma .sc{color:#f1fa8c}.chroma .dl{color:#f1fa8c}.chroma .sd{color:#f1fa8c}.chroma .s2{color:#f1fa8c}.chroma .se{color:#f1fa8c}.chroma .sh{color:#f1fa8c}.chroma .si{color:#f1fa8c}.chroma .sx{color:#f1fa8c}.chroma .sr{color:#f1fa8c}.chroma .s1{color:#f1fa8c}.chroma .ss{color:#f1fa8c}.chroma .m{color:#bd93f9}.chroma .mb{color:#bd93f9}.chroma .mf{color:#bd93f9}.chroma .mh{color:#bd93f9}.chroma .mi{color:#bd93f9}.chroma .il{color:#bd93f9}.chroma .mo{color:#bd93f9}.chroma .o{color:#ff79c6}.chroma .ow{color:#ff79c6}.chroma .c{color:#8491b8}.chroma .ch{color:#8491b8}.chroma .cm{color:#8491b8}.chroma .c1{color:#8491b8}.chroma .cs{color:#8491b8}.chroma .cp{color:#ff79c6}.chroma .cpf{color:#ff79c6}.chroma .gd{color:#f55}.chroma .ge{text-decoration:underline}.chroma .gh{font-weight:700}.chroma .gi{color:#50fa7b;font-weight:700}.chroma .go{color:#44475a}.chroma .gu{font-weight:700}.chroma .gl{text-decoration:underline}
+\ No newline at end of file
diff --git a/tags/arm/index.html b/tags/arm/index.html
@@ -0,0 +1,115 @@
+<!DOCTYPE html>
+<html lang="en-US">
+
+<head>
+ <meta http-equiv="X-Clacks-Overhead" content="GNU Terry Pratchett" />
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+<link rel="shortcut icon" href="https://electrosoup.com/favicon.png" />
+<title>ARM | Electrosoup</title>
+<meta name="title" content="ARM" />
+<meta name="description" content="Stuff I'm working on." />
+<meta name="author" content="" />
+<meta name="keywords" content="arm,assembly,c,forth,g-code,graphics,lasers,matrices,opengl,risc-v," />
+
+
+
+
+
+
+
+ <meta property="og:url" content="https://electrosoup.com/tags/arm/">
+ <meta property="og:site_name" content="Electrosoup">
+ <meta property="og:title" content="ARM">
+ <meta property="og:description" content="Stuff I'm working on.">
+ <meta property="og:locale" content="en_US">
+ <meta property="og:type" content="website">
+
+
+
+
+ <meta name="twitter:card" content="summary">
+ <meta name="twitter:title" content="ARM">
+ <meta name="twitter:description" content="Stuff I'm working on.">
+
+
+
+
+ <meta itemprop="name" content="ARM">
+ <meta itemprop="description" content="Stuff I'm working on.">
+ <meta itemprop="datePublished" content="2024-11-12T13:01:09-08:00">
+ <meta itemprop="dateModified" content="2024-11-12T13:01:09-08:00">
+
+
+ <link href="/herman.min.css" rel="stylesheet">
+
+
+
+
+
+ <link rel="alternate" type="application/rss+xml" href="https://electrosoup.com/tags/arm/index.xml" title="Electrosoup" />
+
+</head>
+
+<body>
+ <header><a class="skip-link" href="#main-content">Skip to main content</a>
+
+<nav>
+ <a href="/">Main</a>
+
+ <a href="/posts/">Posts</a>
+
+ <a href="https://git.electrosoup.com">Code</a>
+
+ <a href="https://christianermann.dev">Resume</a>
+
+
+
+
+
+
+
+
+
+</nav>
+</header>
+ <main id="main-content">
+<content>
+
+ <h3 class="blog-filter">Filtering for "ARM"</h3>
+
+ <ul class="blog-posts">
+
+ <li>
+ <span>
+ <i>
+ <time datetime='2024-11-12' pubdate>
+ 2024-11-12
+ </time>
+ </i>
+ </span>
+
+ <a href="/posts/the-infamous-link-macro/">The Infamous 'link' Macro</a>
+
+ </li>
+
+ </ul>
+
+</content>
+
+ </main>
+ <footer><footer>
+
+ <a href="https://git.electrosoup.com">Code</a>.
+
+ <a href="https://christianermann.dev">Resume</a>.
+
+ <a href='https://electrosoup.com/index.xml'>RSS</a>.
+ <p>Copyright © 2026 Christian Ermann. | Made with <a href="https://github.com/clente/hugo-bearcub">Bear Cub</a></p>
+</footer>
+</footer>
+
+
+</body>
+
+</html>
diff --git a/tags/arm/index.xml b/tags/arm/index.xml
@@ -0,0 +1,112 @@
+<?xml version="1.0" encoding="utf-8" standalone="yes"?>
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/">
+ <channel>
+ <title>ARM on Electrosoup</title>
+ <link>https://electrosoup.com/tags/arm/</link>
+ <description>Recent content in ARM on Electrosoup</description>
+ <generator>Hugo -- gohugo.io</generator>
+ <language>en-US</language>
+ <managingEditor>christianermann@gmail.com (Christian Ermann)</managingEditor>
+ <webMaster>christianermann@gmail.com (Christian Ermann)</webMaster>
+ <lastBuildDate>Tue, 12 Nov 2024 13:01:09 -0800</lastBuildDate>
+ <atom:link href="https://electrosoup.com/tags/arm/index.xml" rel="self" type="application/rss+xml" />
+ <item>
+ <title>The Infamous 'link' Macro</title>
+ <link>https://electrosoup.com/posts/the-infamous-link-macro/</link>
+ <pubDate>Tue, 12 Nov 2024 13:01:09 -0800</pubDate><author>christianermann@gmail.com (Christian Ermann)</author>
+ <guid>https://electrosoup.com/posts/the-infamous-link-macro/</guid>
+ <description><p>Each word (or function, in other languages) in Forth is stored as an entry in
a linked list known as the dictionary. When bootstrapping a Forth from
assembly, it is your responsibility to create and maintain this linked list
structure. This is a tedious process and is the source of many errors when
re-arranging words or defining new words; it&rsquo;s incredibly easy to turn your
list into a graph by mistake.</p></description>
+ <content:encoded><![CDATA[<p>Each word (or function, in other languages) in Forth is stored as an entry in
+a linked list known as the dictionary. When bootstrapping a Forth from
+assembly, it is your responsibility to create and maintain this linked list
+structure. This is a tedious process and is the source of many errors when
+re-arranging words or defining new words; it’s incredibly easy to turn your
+list into a graph by mistake.</p>
+<p>In
+<a href="https://rwmj.wordpress.com/2010/08/07/jonesforth-git-repository/">jonesforth</a>,
+an x86 implementation of Forth, the assembler supports re-assigning new values
+to assembler variables. This means an assember variable can be used to store
+the memory address of the previous entry, and we have the ability to update it
+or use it whenever we need to. I used this exact strategy in my
+<a href="https://git.christianermann.dev/forth/log.html">incomplete x86 Forth</a> although
+I used <a href="https://flatassembler.net/">FASM</a> instead of
+<a href="https://wiki.osdev.org/GAS">GAS</a>. Unfortunately, GAS doesn’t support this
+feature for ARM or RISC-V targets. It may be possible to pull this off on ARM
+with the right set of relocation and/or relaxation parameters, but I was unable
+to find success with RISC-V.</p>
+<p>I did come up with an alternative set of macros that achieves the same goal
+and should be more portable than the <code>jonesforth</code> solution:</p>
+
+
+
+
+
+<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-GAS" data-lang="GAS"><span class="line"><span class="ln"> 1</span><span class="cl"><span class="na">.macro</span> <span class="no">this_link</span>
+</span></span><span class="line"><span class="ln"> 2</span><span class="cl"> <span class="na">.globl</span> <span class="no">link_</span><span class="err">\+</span>
+</span></span><span class="line"><span class="ln"> 3</span><span class="cl"><span class="nf">link_</span><span class="err">\+</span><span class="p">:</span>
+</span></span><span class="line"><span class="ln"> 4</span><span class="cl"><span class="na">.endm</span>
+</span></span><span class="line"><span class="ln"> 5</span><span class="cl">
+</span></span><span class="line"><span class="ln"> 6</span><span class="cl"><span class="na">.macro</span> <span class="no">prev_link</span>
+</span></span><span class="line"><span class="ln"> 7</span><span class="cl"> <span class="na">.int</span> <span class="no">link_</span><span class="err">\+</span>
+</span></span><span class="line"><span class="ln"> 8</span><span class="cl"><span class="na">.endm</span>
+</span></span><span class="line"><span class="ln"> 9</span><span class="cl">
+</span></span><span class="line"><span class="ln">10</span><span class="cl"><span class="na">.macro</span> <span class="no">link</span>
+</span></span><span class="line"><span class="ln">11</span><span class="cl"> <span class="nf">this_link</span>
+</span></span><span class="line"><span class="ln">12</span><span class="cl"> <span class="nf">prev_link</span>
+</span></span><span class="line"><span class="ln">13</span><span class="cl"><span class="na">.endm</span>
+</span></span><span class="line"><span class="ln">14</span><span class="cl">
+</span></span><span class="line"><span class="ln">15</span><span class="cl"><span class="nf">this_link</span></span></span></code></pre></div><p>These macros depend on the special value
+
+
+
+
+<code class="code-inline language-GAS"><span class="err">\+</span></code>.
+This value is replaced by the invocation count of the current macro during
+assembly. Since we want to
+
+
+
+
+<code class="code-inline language-GAS"><span class="nf">link</span></code>
+back to the previous word in the dictionary, we need
+
+
+
+
+<code class="code-inline language-GAS"><span class="nf">prev_link</span></code>
+to resolve to 1 word before
+
+
+
+
+<code class="code-inline language-GAS"><span class="nf">this_link</span></code>,
+which is why we call
+
+
+
+
+<code class="code-inline language-GAS"><span class="nf">this_link</span></code>
+once before defining any words.</p>
+<p>You’ll also need to add this to your linker script to null-terminate your
+dictionary, otherwise the start of your dictionary will be marked by the
+address where the
+
+
+
+
+<code class="code-inline language-GAS"><span class="nf">link_0</span></code>
+label created by
+
+
+
+
+<code class="code-inline language-GAS"><span class="nf">this_link</span></code> was stored:</p>
+
+
+
+
+
+<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-GAS" data-lang="GAS"><span class="line"><span class="ln">1</span><span class="cl"><span class="nf">link_0</span> <span class="err">=</span> <span class="mi">0</span><span class="err">;</span></span></span></code></pre></div>]]></content:encoded>
+ </item>
+ </channel>
+</rss>
diff --git a/tags/assembly/index.html b/tags/assembly/index.html
@@ -0,0 +1,128 @@
+<!DOCTYPE html>
+<html lang="en-US">
+
+<head>
+ <meta http-equiv="X-Clacks-Overhead" content="GNU Terry Pratchett" />
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+<link rel="shortcut icon" href="https://electrosoup.com/favicon.png" />
+<title>Assembly | Electrosoup</title>
+<meta name="title" content="Assembly" />
+<meta name="description" content="Stuff I'm working on." />
+<meta name="author" content="" />
+<meta name="keywords" content="arm,assembly,c,forth,g-code,graphics,lasers,matrices,opengl,risc-v," />
+
+
+
+
+
+
+
+ <meta property="og:url" content="https://electrosoup.com/tags/assembly/">
+ <meta property="og:site_name" content="Electrosoup">
+ <meta property="og:title" content="Assembly">
+ <meta property="og:description" content="Stuff I'm working on.">
+ <meta property="og:locale" content="en_US">
+ <meta property="og:type" content="website">
+
+
+
+
+ <meta name="twitter:card" content="summary">
+ <meta name="twitter:title" content="Assembly">
+ <meta name="twitter:description" content="Stuff I'm working on.">
+
+
+
+
+ <meta itemprop="name" content="Assembly">
+ <meta itemprop="description" content="Stuff I'm working on.">
+ <meta itemprop="datePublished" content="2024-11-13T17:33:47-08:00">
+ <meta itemprop="dateModified" content="2024-11-13T17:33:47-08:00">
+
+
+ <link href="/herman.min.css" rel="stylesheet">
+
+
+
+
+
+ <link rel="alternate" type="application/rss+xml" href="https://electrosoup.com/tags/assembly/index.xml" title="Electrosoup" />
+
+</head>
+
+<body>
+ <header><a class="skip-link" href="#main-content">Skip to main content</a>
+
+<nav>
+ <a href="/">Main</a>
+
+ <a href="/posts/">Posts</a>
+
+ <a href="https://git.electrosoup.com">Code</a>
+
+ <a href="https://christianermann.dev">Resume</a>
+
+
+
+
+
+
+
+
+
+</nav>
+</header>
+ <main id="main-content">
+<content>
+
+ <h3 class="blog-filter">Filtering for "Assembly"</h3>
+
+ <ul class="blog-posts">
+
+ <li>
+ <span>
+ <i>
+ <time datetime='2024-11-13' pubdate>
+ 2024-11-13
+ </time>
+ </i>
+ </span>
+
+ <a href="/posts/forth-rv32i-assembler/">Forth RV32I Assembler</a>
+
+ </li>
+
+ <li>
+ <span>
+ <i>
+ <time datetime='2024-11-12' pubdate>
+ 2024-11-12
+ </time>
+ </i>
+ </span>
+
+ <a href="/posts/the-infamous-link-macro/">The Infamous 'link' Macro</a>
+
+ </li>
+
+ </ul>
+
+</content>
+
+ </main>
+ <footer><footer>
+
+ <a href="https://git.electrosoup.com">Code</a>.
+
+ <a href="https://christianermann.dev">Resume</a>.
+
+ <a href='https://electrosoup.com/index.xml'>RSS</a>.
+ <p>Copyright © 2026 Christian Ermann. | Made with <a href="https://github.com/clente/hugo-bearcub">Bear Cub</a></p>
+</footer>
+</footer>
+
+
+</body>
+
+</html>
diff --git a/tags/assembly/index.xml b/tags/assembly/index.xml
@@ -0,0 +1,286 @@
+<?xml version="1.0" encoding="utf-8" standalone="yes"?>
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/">
+ <channel>
+ <title>Assembly on Electrosoup</title>
+ <link>https://electrosoup.com/tags/assembly/</link>
+ <description>Recent content in Assembly on Electrosoup</description>
+ <generator>Hugo -- gohugo.io</generator>
+ <language>en-US</language>
+ <managingEditor>christianermann@gmail.com (Christian Ermann)</managingEditor>
+ <webMaster>christianermann@gmail.com (Christian Ermann)</webMaster>
+ <lastBuildDate>Wed, 13 Nov 2024 17:33:47 -0800</lastBuildDate>
+ <atom:link href="https://electrosoup.com/tags/assembly/index.xml" rel="self" type="application/rss+xml" />
+ <item>
+ <title>Forth RV32I Assembler</title>
+ <link>https://electrosoup.com/posts/forth-rv32i-assembler/</link>
+ <pubDate>Wed, 13 Nov 2024 17:33:47 -0800</pubDate><author>christianermann@gmail.com (Christian Ermann)</author>
+ <guid>https://electrosoup.com/posts/forth-rv32i-assembler/</guid>
+ <description><p>Here&rsquo;s an assembler for RV32I that I wrote in Forth. I find the definitions of
the instructions and instruction types especially elegant, and I find it to be
a great demonstration of how concise and powerful Forth can be.</p></description>
+ <content:encoded><![CDATA[<p>Here’s an assembler for RV32I that I wrote in Forth. I find the definitions of
+the instructions and instruction types especially elegant, and I find it to be
+a great demonstration of how concise and powerful Forth can be.</p>
+<p>All code in this post is licensed under the
+<a href="https://www.gnu.org/licenses/agpl-3.0.en.html#license-text">AGPLv3</a>.</p>
+
+
+
+
+
+<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-forth" data-lang="forth"><span class="line"><span class="ln"> 1</span><span class="cl"><span class="c1">\ encode stack values into proper instruction locations. all
+</span></span></span><span class="line"><span class="ln"> 2</span><span class="cl"><span class="c1">\ encoding sequences must begin with 'opcode'.
+</span></span></span><span class="line"><span class="ln"> 3</span><span class="cl"><span class="c1"></span><span class="kn">:</span> <span class="nc">opcode</span> <span class="k">hex </span> <span class="mi">7</span><span class="nf">F</span> <span class="k">and </span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 4</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">funct3</span> <span class="k">swap hex </span> <span class="mi">7</span> <span class="k">and decimal </span><span class="mi">12</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 5</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">funct7</span> <span class="k">swap hex </span> <span class="mi">7</span><span class="nf">F</span> <span class="k">and decimal </span><span class="mi">25</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 6</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">i-immed</span> <span class="k">swap hex </span> <span class="nf">FFF</span> <span class="k">and decimal </span><span class="mi">20</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 7</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">i-immed-shamt</span> <span class="k">swap hex </span> <span class="mi">1</span><span class="nf">F</span> <span class="k">and decimal </span><span class="mi">20</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 8</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">u-immed</span> <span class="k">swap hex </span> <span class="nf">FFFFF</span> <span class="k">and decimal </span><span class="mi">12</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 9</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">s-immed</span> <span class="k">over hex </span> <span class="nf">FE0</span> <span class="k">and decimal </span><span class="mi">20</span> <span class="k">lshift +
+</span></span></span><span class="line"><span class="ln"> 10</span><span class="cl"><span class="k"></span> <span class="k">swap hex </span> <span class="mi">1</span><span class="nf">F</span> <span class="k">and decimal </span> <span class="mi">7</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 11</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">j-immed</span> <span class="k">over hex </span><span class="mi">100000</span> <span class="k">and decimal </span><span class="mi">11</span> <span class="k">lshift +
+</span></span></span><span class="line"><span class="ln"> 12</span><span class="cl"><span class="k"></span> <span class="k">over hex </span> <span class="nf">FF000</span> <span class="k">and </span> <span class="k">+
+</span></span></span><span class="line"><span class="ln"> 13</span><span class="cl"><span class="k"></span> <span class="k">over hex </span> <span class="mi">800</span> <span class="k">and decimal </span> <span class="mi">9</span> <span class="k">lshift +
+</span></span></span><span class="line"><span class="ln"> 14</span><span class="cl"><span class="k"></span> <span class="k">swap hex </span> <span class="mi">7</span><span class="nf">FE</span> <span class="k">and decimal </span><span class="mi">20</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 15</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">b-immed</span> <span class="k">over hex </span> <span class="mi">1000</span> <span class="k">and decimal </span><span class="mi">19</span> <span class="k">lshift +
+</span></span></span><span class="line"><span class="ln"> 16</span><span class="cl"><span class="k"></span> <span class="k">over hex </span> <span class="mi">800</span> <span class="k">and decimal </span> <span class="mi">4</span> <span class="k">rshift +
+</span></span></span><span class="line"><span class="ln"> 17</span><span class="cl"><span class="k"></span> <span class="k">over hex </span> <span class="mi">7</span><span class="nf">E0</span> <span class="k">and decimal </span><span class="mi">20</span> <span class="k">lshift +
+</span></span></span><span class="line"><span class="ln"> 18</span><span class="cl"><span class="k"></span> <span class="k">swap hex </span> <span class="mi">1</span><span class="nf">E</span> <span class="k">and decimal </span> <span class="mi">7</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 19</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">rd</span> <span class="k">swap hex </span> <span class="mi">1</span><span class="nf">F</span> <span class="k">and decimal </span> <span class="mi">7</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 20</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">rs1</span> <span class="k">swap hex </span> <span class="mi">1</span><span class="nf">F</span> <span class="k">and decimal </span><span class="mi">15</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 21</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">rs2</span> <span class="k">swap hex </span> <span class="mi">1</span><span class="nf">F</span> <span class="k">and decimal </span><span class="mi">20</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 22</span><span class="cl"><span class="k"></span>
+</span></span><span class="line"><span class="ln"> 23</span><span class="cl"><span class="c1">\ instruction types. all instruction values should be pushed on the
+</span></span></span><span class="line"><span class="ln"> 24</span><span class="cl"><span class="c1">\ stack with the opcode last before calling.
+</span></span></span><span class="line"><span class="ln"> 25</span><span class="cl"><span class="c1"></span><span class="kn">:</span> <span class="nc">r-type</span> <span class="nf">opcode</span> <span class="nf">funct3</span> <span class="nf">funct7</span> <span class="nf">rs2</span> <span class="nf">rs1</span> <span class="nf">rd</span> <span class="k">, ;
+</span></span></span><span class="line"><span class="ln"> 26</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">i-type</span> <span class="nf">opcode</span> <span class="nf">funct3</span> <span class="nf">i-immed</span> <span class="nf">rs1</span> <span class="nf">rd</span> <span class="k">, ;
+</span></span></span><span class="line"><span class="ln"> 27</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">i-type-shamt</span> <span class="nf">opcode</span> <span class="nf">funct3</span> <span class="nf">funct7</span> <span class="nf">i-immed-shamt</span> <span class="nf">rs1</span> <span class="nf">rd</span> <span class="k">, ;
+</span></span></span><span class="line"><span class="ln"> 28</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">s-type</span> <span class="nf">opcode</span> <span class="nf">funct3</span> <span class="nf">s-immed</span> <span class="nf">rs2</span> <span class="nf">rs1</span> <span class="k">, ;
+</span></span></span><span class="line"><span class="ln"> 29</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">b-type</span> <span class="nf">opcode</span> <span class="nf">funct3</span> <span class="nf">b-immed</span> <span class="nf">rs2</span> <span class="nf">rs1</span> <span class="k">, ;
+</span></span></span><span class="line"><span class="ln"> 30</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">u-type</span> <span class="nf">opcode</span> <span class="nf">u-immed</span> <span class="nf">rd</span> <span class="k">, ;
+</span></span></span><span class="line"><span class="ln"> 31</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">j-type</span> <span class="nf">opcode</span> <span class="nf">j-immed</span> <span class="nf">rd</span> <span class="k">, ;
+</span></span></span><span class="line"><span class="ln"> 32</span><span class="cl"><span class="k"></span>
+</span></span><span class="line"><span class="ln"> 33</span><span class="cl"><span class="c1">\ instructions. these are just simple encodings, no assembler
+</span></span></span><span class="line"><span class="ln"> 34</span><span class="cl"><span class="c1">\ niceties yet.
+</span></span></span><span class="line"><span class="ln"> 35</span><span class="cl"><span class="c1">\ funct7 funct3 opcode encoding
+</span></span></span><span class="line"><span class="ln"> 36</span><span class="cl"><span class="c1"></span><span class="kn">:</span> <span class="nc">addi,</span> <span class="k">hex </span> <span class="mi">0</span> <span class="mi">13</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 37</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">andi,</span> <span class="k">hex </span> <span class="mi">7</span> <span class="mi">13</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 38</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">ori,</span> <span class="k">hex </span> <span class="mi">6</span> <span class="mi">13</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 39</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">xori,</span> <span class="k">hex </span> <span class="mi">4</span> <span class="mi">13</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 40</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">slli,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">1</span> <span class="mi">13</span> <span class="nf">i-type-shamt</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 41</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">srli,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">5</span> <span class="mi">13</span> <span class="nf">i-type-shamt</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 42</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">srai,</span> <span class="k">hex </span> <span class="mi">20</span> <span class="mi">5</span> <span class="mi">13</span> <span class="nf">i-type-shamt</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 43</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">slti,</span> <span class="k">hex </span> <span class="mi">2</span> <span class="mi">13</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 44</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sltiu,</span> <span class="k">hex </span> <span class="mi">3</span> <span class="mi">13</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 45</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">lui,</span> <span class="k">hex </span> <span class="mi">37</span> <span class="nf">u-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 46</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">auipc,</span> <span class="k">hex </span> <span class="mi">17</span> <span class="nf">u-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 47</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">add,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">0</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 48</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sub,</span> <span class="k">hex </span> <span class="mi">20</span> <span class="mi">0</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 49</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">and,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">7</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 50</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">or,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">6</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 51</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">xor,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">4</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 52</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sll,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">1</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 53</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">srl,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">5</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 54</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sra,</span> <span class="k">hex </span> <span class="mi">20</span> <span class="mi">5</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 55</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">slt,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">2</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 56</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sltu,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">3</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 57</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">jal,</span> <span class="k">hex </span> <span class="mi">6</span><span class="nf">F</span> <span class="nf">j-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 58</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">jalr,</span> <span class="k">hex </span> <span class="mi">0</span> <span class="mi">67</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 59</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">beq,</span> <span class="k">hex </span> <span class="mi">0</span> <span class="mi">63</span> <span class="nf">b-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 60</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">bne,</span> <span class="k">hex </span> <span class="mi">1</span> <span class="mi">63</span> <span class="nf">b-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 61</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">blt,</span> <span class="k">hex </span> <span class="mi">4</span> <span class="mi">63</span> <span class="nf">b-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 62</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">bltu,</span> <span class="k">hex </span> <span class="mi">6</span> <span class="mi">63</span> <span class="nf">b-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 63</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">bge,</span> <span class="k">hex </span> <span class="mi">5</span> <span class="mi">63</span> <span class="nf">b-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 64</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">bgeu,</span> <span class="k">hex </span> <span class="mi">7</span> <span class="mi">63</span> <span class="nf">b-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 65</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">lw,</span> <span class="k">hex </span> <span class="mi">2</span> <span class="mi">03</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 66</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">lh,</span> <span class="k">hex </span> <span class="mi">1</span> <span class="mi">03</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 67</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">lhu,</span> <span class="k">hex </span> <span class="mi">5</span> <span class="mi">03</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 68</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">lb,</span> <span class="k">hex </span> <span class="mi">0</span> <span class="mi">03</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 69</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sw,</span> <span class="k">hex </span> <span class="mi">2</span> <span class="mi">23</span> <span class="nf">s-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 70</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sh,</span> <span class="k">hex </span> <span class="mi">1</span> <span class="mi">23</span> <span class="nf">s-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 71</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sb,</span> <span class="k">hex </span> <span class="mi">0</span> <span class="mi">23</span> <span class="nf">s-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 72</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">fence,</span> <span class="k">hex </span> <span class="mi">0</span> <span class="mi">0</span><span class="nf">F</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 73</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">ecall,</span> <span class="k">hex </span> <span class="mi">0</span> <span class="mi">73</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 74</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">ebreak,</span> <span class="k">hex </span> <span class="mi">0</span> <span class="mi">73</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 75</span><span class="cl"><span class="k"></span>
+</span></span><span class="line"><span class="ln"> 76</span><span class="cl"><span class="c1">\ some instructions, now with nicer usage.
+</span></span></span><span class="line"><span class="ln"> 77</span><span class="cl"><span class="c1"></span><span class="kn">:</span> <span class="nc">sw,</span> <span class="k">>r swap r> </span><span class="nf">sw,</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 78</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sh,</span> <span class="k">>r swap r> </span><span class="nf">sh,</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 79</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sb,</span> <span class="k">>r swap r> </span><span class="nf">sb,</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 80</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">ecall,</span> <span class="mi">0</span> <span class="mi">0</span> <span class="mi">0</span> <span class="nf">ecall,</span> <span class="k">; </span> <span class="c1">\ usage: ecall,
+</span></span></span><span class="line"><span class="ln"> 81</span><span class="cl"><span class="c1"></span><span class="kn">:</span> <span class="nc">ebreak,</span> <span class="mi">0</span> <span class="mi">0</span> <span class="mi">1</span> <span class="nf">ebreak,</span> <span class="k">; </span> <span class="c1">\ usage: ebreak,
+</span></span></span><span class="line"><span class="ln"> 82</span><span class="cl"><span class="c1"></span><span class="kn">:</span> <span class="nc">fence,</span> <span class="k">>r </span><span class="mi">0</span> <span class="mi">0</span> <span class="k">r> </span><span class="nf">fence,</span> <span class="k">; </span><span class="c1">\ usage: imm fence,
+</span></span></span><span class="line"><span class="ln"> 83</span><span class="cl"><span class="c1"></span>
+</span></span><span class="line"><span class="ln"> 84</span><span class="cl"><span class="c1">\ registers
+</span></span></span><span class="line"><span class="ln"> 85</span><span class="cl"><span class="c1"></span><span class="k">decimal
+</span></span></span><span class="line"><span class="ln"> 86</span><span class="cl"><span class="k"></span> <span class="mi">0</span> <span class="kn">constant</span> <span class="nc">x0</span> <span class="mi">1</span> <span class="kn">constant</span> <span class="nc">x1</span> <span class="mi">2</span> <span class="kn">constant</span> <span class="nc">x2</span> <span class="mi">3</span> <span class="kn">constant</span> <span class="nc">x3</span>
+</span></span><span class="line"><span class="ln"> 87</span><span class="cl"> <span class="mi">4</span> <span class="kn">constant</span> <span class="nc">x4</span> <span class="mi">5</span> <span class="kn">constant</span> <span class="nc">x5</span> <span class="mi">6</span> <span class="kn">constant</span> <span class="nc">x6</span> <span class="mi">7</span> <span class="kn">constant</span> <span class="nc">x7</span>
+</span></span><span class="line"><span class="ln"> 88</span><span class="cl"> <span class="mi">8</span> <span class="kn">constant</span> <span class="nc">x8</span> <span class="mi">9</span> <span class="kn">constant</span> <span class="nc">x9</span> <span class="mi">10</span> <span class="kn">constant</span> <span class="nc">x10</span> <span class="mi">11</span> <span class="kn">constant</span> <span class="nc">x11</span>
+</span></span><span class="line"><span class="ln"> 89</span><span class="cl"><span class="mi">12</span> <span class="kn">constant</span> <span class="nc">x12</span> <span class="mi">13</span> <span class="kn">constant</span> <span class="nc">x13</span> <span class="mi">14</span> <span class="kn">constant</span> <span class="nc">x14</span> <span class="mi">15</span> <span class="kn">constant</span> <span class="nc">x15</span>
+</span></span><span class="line"><span class="ln"> 90</span><span class="cl"><span class="mi">16</span> <span class="kn">constant</span> <span class="nc">x16</span> <span class="mi">17</span> <span class="kn">constant</span> <span class="nc">x17</span> <span class="mi">18</span> <span class="kn">constant</span> <span class="nc">x18</span> <span class="mi">19</span> <span class="kn">constant</span> <span class="nc">x19</span>
+</span></span><span class="line"><span class="ln"> 91</span><span class="cl"><span class="mi">20</span> <span class="kn">constant</span> <span class="nc">x20</span> <span class="mi">21</span> <span class="kn">constant</span> <span class="nc">x21</span> <span class="mi">22</span> <span class="kn">constant</span> <span class="nc">x22</span> <span class="mi">23</span> <span class="kn">constant</span> <span class="nc">x23</span>
+</span></span><span class="line"><span class="ln"> 92</span><span class="cl"><span class="mi">24</span> <span class="kn">constant</span> <span class="nc">x24</span> <span class="mi">25</span> <span class="kn">constant</span> <span class="nc">x25</span> <span class="mi">26</span> <span class="kn">constant</span> <span class="nc">x26</span> <span class="mi">27</span> <span class="kn">constant</span> <span class="nc">x27</span>
+</span></span><span class="line"><span class="ln"> 93</span><span class="cl"><span class="mi">28</span> <span class="kn">constant</span> <span class="nc">x28</span> <span class="mi">29</span> <span class="kn">constant</span> <span class="nc">x29</span> <span class="mi">30</span> <span class="kn">constant</span> <span class="nc">x30</span> <span class="mi">31</span> <span class="kn">constant</span> <span class="nc">x31</span>
+</span></span><span class="line"><span class="ln"> 94</span><span class="cl">
+</span></span><span class="line"><span class="ln"> 95</span><span class="cl"><span class="c1">\ registers (calling convention)
+</span></span></span><span class="line"><span class="ln"> 96</span><span class="cl"><span class="c1"></span><span class="nf">x0</span> <span class="kn">constant</span> <span class="nc">zero</span> <span class="c1">\ zero constant
+</span></span></span><span class="line"><span class="ln"> 97</span><span class="cl"><span class="c1"></span><span class="nf">x1</span> <span class="kn">constant</span> <span class="nc">ra</span> <span class="c1">\ return address
+</span></span></span><span class="line"><span class="ln"> 98</span><span class="cl"><span class="c1"></span><span class="nf">x2</span> <span class="kn">constant</span> <span class="nc">sp</span> <span class="c1">\ stack pointer
+</span></span></span><span class="line"><span class="ln"> 99</span><span class="cl"><span class="c1"></span><span class="nf">x3</span> <span class="kn">constant</span> <span class="nc">gp</span> <span class="c1">\ global pointer
+</span></span></span><span class="line"><span class="ln">100</span><span class="cl"><span class="c1"></span><span class="nf">x4</span> <span class="kn">constant</span> <span class="nc">tp</span> <span class="c1">\ thread pointer
+</span></span></span><span class="line"><span class="ln">101</span><span class="cl"><span class="c1"></span><span class="nf">x8</span> <span class="kn">constant</span> <span class="nc">fp</span> <span class="c1">\ frame pointer
+</span></span></span><span class="line"><span class="ln">102</span><span class="cl"><span class="c1">\ function arguments / return values (a0, a1)
+</span></span></span><span class="line"><span class="ln">103</span><span class="cl"><span class="c1"></span><span class="nf">x10</span> <span class="kn">constant</span> <span class="nc">a0</span> <span class="nf">x11</span> <span class="kn">constant</span> <span class="nc">a1</span> <span class="nf">x12</span> <span class="kn">constant</span> <span class="nc">a2</span> <span class="nf">x13</span> <span class="kn">constant</span> <span class="nc">a3</span>
+</span></span><span class="line"><span class="ln">104</span><span class="cl"><span class="nf">x14</span> <span class="kn">constant</span> <span class="nc">a4</span> <span class="nf">x15</span> <span class="kn">constant</span> <span class="nc">a5</span> <span class="nf">x16</span> <span class="kn">constant</span> <span class="nc">a6</span> <span class="nf">x17</span> <span class="kn">constant</span> <span class="nc">a7</span>
+</span></span><span class="line"><span class="ln">105</span><span class="cl"><span class="c1">\ saved registers
+</span></span></span><span class="line"><span class="ln">106</span><span class="cl"><span class="c1"></span><span class="nf">x8</span> <span class="kn">constant</span> <span class="nc">s0</span> <span class="nf">x9</span> <span class="kn">constant</span> <span class="nc">s1</span> <span class="nf">x18</span> <span class="kn">constant</span> <span class="nc">s2</span> <span class="nf">x19</span> <span class="kn">constant</span> <span class="nc">s3</span>
+</span></span><span class="line"><span class="ln">107</span><span class="cl"><span class="nf">x20</span> <span class="kn">constant</span> <span class="nc">s4</span> <span class="nf">x21</span> <span class="kn">constant</span> <span class="nc">s5</span> <span class="nf">x22</span> <span class="kn">constant</span> <span class="nc">s6</span> <span class="nf">x23</span> <span class="kn">constant</span> <span class="nc">s7</span>
+</span></span><span class="line"><span class="ln">108</span><span class="cl"><span class="nf">x24</span> <span class="kn">constant</span> <span class="nc">s8</span> <span class="nf">x25</span> <span class="kn">constant</span> <span class="nc">s9</span> <span class="nf">x26</span> <span class="kn">constant</span> <span class="nc">s10</span> <span class="nf">x27</span> <span class="kn">constant</span> <span class="nc">s11</span>
+</span></span><span class="line"><span class="ln">109</span><span class="cl"><span class="c1">\ temporaries
+</span></span></span><span class="line"><span class="ln">110</span><span class="cl"><span class="c1"></span><span class="nf">x5</span> <span class="kn">constant</span> <span class="nc">t0</span> <span class="nf">x6</span> <span class="kn">constant</span> <span class="nc">t1</span> <span class="nf">x7</span> <span class="kn">constant</span> <span class="nc">t2</span> <span class="nf">x28</span> <span class="kn">constant</span> <span class="nc">t3</span>
+</span></span><span class="line"><span class="ln">111</span><span class="cl"><span class="nf">x29</span> <span class="kn">constant</span> <span class="nc">t4</span> <span class="nf">x30</span> <span class="kn">constant</span> <span class="nc">t5</span> <span class="nf">x31</span> <span class="kn">constant</span> <span class="nc">t6</span></span></span></code></pre></div><p>And here’s some tests to verify the instruction encodings are generated
+correctly:</p>
+
+
+
+
+
+<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-forth" data-lang="forth"><span class="line"><span class="ln"> 1</span><span class="cl"><span class="kn">:</span> <span class="nc">undo,</span> <span class="mi">-1</span> <span class="k">cells allot here @ ; </span><span class="c1">\ undoes the last ','
+</span></span></span><span class="line"><span class="ln"> 2</span><span class="cl"><span class="c1"></span><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">FF</span> <span class="nf">addi,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FF58513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln"> 3</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">FF</span> <span class="nf">andi,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FF5F513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln"> 4</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">FF</span> <span class="nf">ori,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FF5E513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln"> 5</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">FF</span> <span class="nf">xori,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FF5C513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln"> 6</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">slli,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">F59513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln"> 7</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">srli,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">F5D513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln"> 8</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">srai,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">40</span><span class="nf">F5D513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln"> 9</span><span class="cl"><span class="nf">t{</span> <span class="nf">t0</span> <span class="k">hex </span><span class="nf">FFFF</span> <span class="nf">lui,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FFFF2B7</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">10</span><span class="cl"><span class="nf">t{</span> <span class="nf">t0</span> <span class="k">hex </span><span class="nf">FFFF</span> <span class="nf">auipc,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FFFF297</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">11</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">FF</span> <span class="nf">slti,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FF5A513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">12</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">FF</span> <span class="nf">sltiu,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FF5B513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">13</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">add,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">C58533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">14</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">sub,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">40</span><span class="nf">C58533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">15</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">and,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">C5F533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">16</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">or,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">C5E533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">17</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">xor,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">C5C533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">18</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">sll,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">C59533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">19</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">srl,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">C5D533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">20</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">sra,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">40</span><span class="nf">C5D533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">21</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">slt,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">C5A533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">22</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">sltu,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">C5B533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">23</span><span class="cl"><span class="nf">t{</span> <span class="nf">ra</span> <span class="k">hex </span><span class="nf">FFFF</span> <span class="nf">jal,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">7</span><span class="nf">FF0F0EF</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">24</span><span class="cl"><span class="nf">t{</span> <span class="nf">ra</span> <span class="nf">a0</span> <span class="k">hex </span> <span class="nf">FF</span> <span class="nf">jalr,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FF500E7</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">25</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">beq,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">B50763</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">26</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">bne,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">B51763</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">27</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">blt,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">B54763</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">28</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">bltu,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">B56763</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">29</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">bge,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">B55763</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">30</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">bgeu,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">B57763</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">31</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">lw,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">F5A503</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">32</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">lh,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">F59503</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">33</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">lhu,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">F5D503</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">34</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">lb,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">F58503</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">35</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">sw,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">A5A7A3</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">36</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">sh,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">A597A3</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">37</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">sb,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">A587A3</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">38</span><span class="cl"><span class="nf">t{</span> <span class="k">hex </span> <span class="mi">0</span><span class="nf">FF</span> <span class="nf">fence,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FF0000F</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">39</span><span class="cl"><span class="nf">t{</span> <span class="nf">ecall,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00000073</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">40</span><span class="cl"><span class="nf">t{</span> <span class="nf">ebreak,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00100073</span> <span class="err">}t</span></span></span></code></pre></div>]]></content:encoded>
+ </item>
+ <item>
+ <title>The Infamous 'link' Macro</title>
+ <link>https://electrosoup.com/posts/the-infamous-link-macro/</link>
+ <pubDate>Tue, 12 Nov 2024 13:01:09 -0800</pubDate><author>christianermann@gmail.com (Christian Ermann)</author>
+ <guid>https://electrosoup.com/posts/the-infamous-link-macro/</guid>
+ <description><p>Each word (or function, in other languages) in Forth is stored as an entry in
a linked list known as the dictionary. When bootstrapping a Forth from
assembly, it is your responsibility to create and maintain this linked list
structure. This is a tedious process and is the source of many errors when
re-arranging words or defining new words; it&rsquo;s incredibly easy to turn your
list into a graph by mistake.</p></description>
+ <content:encoded><![CDATA[<p>Each word (or function, in other languages) in Forth is stored as an entry in
+a linked list known as the dictionary. When bootstrapping a Forth from
+assembly, it is your responsibility to create and maintain this linked list
+structure. This is a tedious process and is the source of many errors when
+re-arranging words or defining new words; it’s incredibly easy to turn your
+list into a graph by mistake.</p>
+<p>In
+<a href="https://rwmj.wordpress.com/2010/08/07/jonesforth-git-repository/">jonesforth</a>,
+an x86 implementation of Forth, the assembler supports re-assigning new values
+to assembler variables. This means an assember variable can be used to store
+the memory address of the previous entry, and we have the ability to update it
+or use it whenever we need to. I used this exact strategy in my
+<a href="https://git.christianermann.dev/forth/log.html">incomplete x86 Forth</a> although
+I used <a href="https://flatassembler.net/">FASM</a> instead of
+<a href="https://wiki.osdev.org/GAS">GAS</a>. Unfortunately, GAS doesn’t support this
+feature for ARM or RISC-V targets. It may be possible to pull this off on ARM
+with the right set of relocation and/or relaxation parameters, but I was unable
+to find success with RISC-V.</p>
+<p>I did come up with an alternative set of macros that achieves the same goal
+and should be more portable than the <code>jonesforth</code> solution:</p>
+
+
+
+
+
+<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-GAS" data-lang="GAS"><span class="line"><span class="ln"> 1</span><span class="cl"><span class="na">.macro</span> <span class="no">this_link</span>
+</span></span><span class="line"><span class="ln"> 2</span><span class="cl"> <span class="na">.globl</span> <span class="no">link_</span><span class="err">\+</span>
+</span></span><span class="line"><span class="ln"> 3</span><span class="cl"><span class="nf">link_</span><span class="err">\+</span><span class="p">:</span>
+</span></span><span class="line"><span class="ln"> 4</span><span class="cl"><span class="na">.endm</span>
+</span></span><span class="line"><span class="ln"> 5</span><span class="cl">
+</span></span><span class="line"><span class="ln"> 6</span><span class="cl"><span class="na">.macro</span> <span class="no">prev_link</span>
+</span></span><span class="line"><span class="ln"> 7</span><span class="cl"> <span class="na">.int</span> <span class="no">link_</span><span class="err">\+</span>
+</span></span><span class="line"><span class="ln"> 8</span><span class="cl"><span class="na">.endm</span>
+</span></span><span class="line"><span class="ln"> 9</span><span class="cl">
+</span></span><span class="line"><span class="ln">10</span><span class="cl"><span class="na">.macro</span> <span class="no">link</span>
+</span></span><span class="line"><span class="ln">11</span><span class="cl"> <span class="nf">this_link</span>
+</span></span><span class="line"><span class="ln">12</span><span class="cl"> <span class="nf">prev_link</span>
+</span></span><span class="line"><span class="ln">13</span><span class="cl"><span class="na">.endm</span>
+</span></span><span class="line"><span class="ln">14</span><span class="cl">
+</span></span><span class="line"><span class="ln">15</span><span class="cl"><span class="nf">this_link</span></span></span></code></pre></div><p>These macros depend on the special value
+
+
+
+
+<code class="code-inline language-GAS"><span class="err">\+</span></code>.
+This value is replaced by the invocation count of the current macro during
+assembly. Since we want to
+
+
+
+
+<code class="code-inline language-GAS"><span class="nf">link</span></code>
+back to the previous word in the dictionary, we need
+
+
+
+
+<code class="code-inline language-GAS"><span class="nf">prev_link</span></code>
+to resolve to 1 word before
+
+
+
+
+<code class="code-inline language-GAS"><span class="nf">this_link</span></code>,
+which is why we call
+
+
+
+
+<code class="code-inline language-GAS"><span class="nf">this_link</span></code>
+once before defining any words.</p>
+<p>You’ll also need to add this to your linker script to null-terminate your
+dictionary, otherwise the start of your dictionary will be marked by the
+address where the
+
+
+
+
+<code class="code-inline language-GAS"><span class="nf">link_0</span></code>
+label created by
+
+
+
+
+<code class="code-inline language-GAS"><span class="nf">this_link</span></code> was stored:</p>
+
+
+
+
+
+<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-GAS" data-lang="GAS"><span class="line"><span class="ln">1</span><span class="cl"><span class="nf">link_0</span> <span class="err">=</span> <span class="mi">0</span><span class="err">;</span></span></span></code></pre></div>]]></content:encoded>
+ </item>
+ </channel>
+</rss>
diff --git a/tags/c/index.html b/tags/c/index.html
@@ -0,0 +1,128 @@
+<!DOCTYPE html>
+<html lang="en-US">
+
+<head>
+ <meta http-equiv="X-Clacks-Overhead" content="GNU Terry Pratchett" />
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+<link rel="shortcut icon" href="https://electrosoup.com/favicon.png" />
+<title>C | Electrosoup</title>
+<meta name="title" content="C" />
+<meta name="description" content="Stuff I'm working on." />
+<meta name="author" content="" />
+<meta name="keywords" content="arm,assembly,c,forth,g-code,graphics,lasers,matrices,opengl,risc-v," />
+
+
+
+
+
+
+
+ <meta property="og:url" content="https://electrosoup.com/tags/c/">
+ <meta property="og:site_name" content="Electrosoup">
+ <meta property="og:title" content="C">
+ <meta property="og:description" content="Stuff I'm working on.">
+ <meta property="og:locale" content="en_US">
+ <meta property="og:type" content="website">
+
+
+
+
+ <meta name="twitter:card" content="summary">
+ <meta name="twitter:title" content="C">
+ <meta name="twitter:description" content="Stuff I'm working on.">
+
+
+
+
+ <meta itemprop="name" content="C">
+ <meta itemprop="description" content="Stuff I'm working on.">
+ <meta itemprop="datePublished" content="2024-10-23T16:29:40-07:00">
+ <meta itemprop="dateModified" content="2024-10-23T16:29:40-07:00">
+
+
+ <link href="/herman.min.css" rel="stylesheet">
+
+
+
+
+
+ <link rel="alternate" type="application/rss+xml" href="https://electrosoup.com/tags/c/index.xml" title="Electrosoup" />
+
+</head>
+
+<body>
+ <header><a class="skip-link" href="#main-content">Skip to main content</a>
+
+<nav>
+ <a href="/">Main</a>
+
+ <a href="/posts/">Posts</a>
+
+ <a href="https://git.electrosoup.com">Code</a>
+
+ <a href="https://christianermann.dev">Resume</a>
+
+
+
+
+
+
+
+
+
+</nav>
+</header>
+ <main id="main-content">
+<content>
+
+ <h3 class="blog-filter">Filtering for "C"</h3>
+
+ <ul class="blog-posts">
+
+ <li>
+ <span>
+ <i>
+ <time datetime='2024-10-23' pubdate>
+ 2024-10-23
+ </time>
+ </i>
+ </span>
+
+ <a href="/posts/gcode-interpreter/">Writing a G-code Interpreter</a>
+
+ </li>
+
+ <li>
+ <span>
+ <i>
+ <time datetime='2021-08-25' pubdate>
+ 2021-08-25
+ </time>
+ </i>
+ </span>
+
+ <a href="/posts/unbind/">Unbind Your Vertex Array Objects.</a>
+
+ </li>
+
+ </ul>
+
+</content>
+
+ </main>
+ <footer><footer>
+
+ <a href="https://git.electrosoup.com">Code</a>.
+
+ <a href="https://christianermann.dev">Resume</a>.
+
+ <a href='https://electrosoup.com/index.xml'>RSS</a>.
+ <p>Copyright © 2026 Christian Ermann. | Made with <a href="https://github.com/clente/hugo-bearcub">Bear Cub</a></p>
+</footer>
+</footer>
+
+
+</body>
+
+</html>
diff --git a/tags/c/index.xml b/tags/c/index.xml
@@ -0,0 +1,290 @@
+<?xml version="1.0" encoding="utf-8" standalone="yes"?>
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/">
+ <channel>
+ <title>C on Electrosoup</title>
+ <link>https://electrosoup.com/tags/c/</link>
+ <description>Recent content in C on Electrosoup</description>
+ <generator>Hugo -- gohugo.io</generator>
+ <language>en-US</language>
+ <managingEditor>christianermann@gmail.com (Christian Ermann)</managingEditor>
+ <webMaster>christianermann@gmail.com (Christian Ermann)</webMaster>
+ <lastBuildDate>Wed, 23 Oct 2024 16:29:40 -0700</lastBuildDate>
+ <atom:link href="https://electrosoup.com/tags/c/index.xml" rel="self" type="application/rss+xml" />
+ <item>
+ <title>Writing a G-code Interpreter</title>
+ <link>https://electrosoup.com/posts/gcode-interpreter/</link>
+ <pubDate>Wed, 23 Oct 2024 16:29:40 -0700</pubDate><author>christianermann@gmail.com (Christian Ermann)</author>
+ <guid>https://electrosoup.com/posts/gcode-interpreter/</guid>
+ <description><p>I&rsquo;m currently working on a control system for a laser galvanometer (galvo) that
I want to use in a stereolithography (SLA) resin printer. I don&rsquo;t want to write
a custom slicer, as I feel like model slicing can be incredibly complicated and
existing free software (Cura, Slic3r, etc.) has many advanced features I don&rsquo;t
want to reimplement. However, this means my control system needs to understand
G-code, the language that these slicers output.</p></description>
+ <content:encoded><![CDATA[<p>I’m currently working on a control system for a laser galvanometer (galvo) that
+I want to use in a stereolithography (SLA) resin printer. I don’t want to write
+a custom slicer, as I feel like model slicing can be incredibly complicated and
+existing free software (Cura, Slic3r, etc.) has many advanced features I don’t
+want to reimplement. However, this means my control system needs to understand
+G-code, the language that these slicers output.</p>
+<p>As stated on the <a href="https://reprap.org/wiki/G-code">reprap wiki</a>, “G-code is a
+list of fields that are separated by white spaces or line breaks. A field can
+be interpreted as a command, parameter, or for any other special purpose.” For
+now, we’ll ignore any special purposes. Here is an example of G-code that
+describes a movement of the tool/hotend/laser to a specific location:</p>
+
+
+
+
+
+<pre tabindex="0"><code class="language-gcode" data-lang="gcode"> G1 X10.4 Y7.4 Z8.3</code></pre><p>I was able to parse commands with parameters using a two-stage procedure:</p>
+<pre><code>1. Retrieve the next white-space delimited token.
+2. Accumulate tokens until two separate command tokens are found.
+</code></pre>
+<p>This second step is important because we can’t begin executing a command until
+we’ve found all of its parameters and we don’t know if we’ve found all of its
+parameters until we find the next command.</p>
+<p>Once a command and all of its parameters have been parsed, it is passed to the
+controller which updates the state of the machine. For each command that the
+controller receives, it has to update its internal state, and in the case of
+physical movement commands, send the proper signal to the laser galvo. Most
+physical movement commands utilize interpolation so a timed control loop is
+utilized to ensure the laser follows as close to the intended path as possible.</p>
+<h2 id="system-diagram">System Diagram</h2>
+
+
+
+<div class="goat svg-container ">
+
+ <svg
+ xmlns="http://www.w3.org/2000/svg"
+ font-family="Menlo,Lucida Console,monospace"
+
+ viewBox="0 0 384 249"
+ >
+ <g transform='translate(8,16)'>
+<path d='M 80,16 L 296,16' fill='none' stroke='currentColor'></path>
+<path d='M 16,64 L 112,64' fill='none' stroke='currentColor'></path>
+<path d='M 256,64 L 368,64' fill='none' stroke='currentColor'></path>
+<path d='M 128,80 L 240,80' fill='none' stroke='currentColor'></path>
+<path d='M 16,96 L 112,96' fill='none' stroke='currentColor'></path>
+<path d='M 256,96 L 368,96' fill='none' stroke='currentColor'></path>
+<path d='M 80,144 L 296,144' fill='none' stroke='currentColor'></path>
+<path d='M 0,192 L 120,192' fill='none' stroke='currentColor'></path>
+<path d='M 256,192 L 368,192' fill='none' stroke='currentColor'></path>
+<path d='M 136,208 L 240,208' fill='none' stroke='currentColor'></path>
+<path d='M 0,224 L 120,224' fill='none' stroke='currentColor'></path>
+<path d='M 256,224 L 368,224' fill='none' stroke='currentColor'></path>
+<path d='M 0,192 L 0,224' fill='none' stroke='currentColor'></path>
+<path d='M 16,64 L 16,96' fill='none' stroke='currentColor'></path>
+<path d='M 64,32 L 64,48' fill='none' stroke='currentColor'></path>
+<path d='M 64,160 L 64,176' fill='none' stroke='currentColor'></path>
+<path d='M 112,64 L 112,96' fill='none' stroke='currentColor'></path>
+<path d='M 120,192 L 120,224' fill='none' stroke='currentColor'></path>
+<path d='M 256,64 L 256,96' fill='none' stroke='currentColor'></path>
+<path d='M 256,192 L 256,224' fill='none' stroke='currentColor'></path>
+<path d='M 312,32 L 312,48' fill='none' stroke='currentColor'></path>
+<path d='M 312,112 L 312,128' fill='none' stroke='currentColor'></path>
+<path d='M 368,64 L 368,96' fill='none' stroke='currentColor'></path>
+<path d='M 368,192 L 368,224' fill='none' stroke='currentColor'></path>
+<path d='M 312,48 L 312,56' fill='none' stroke='currentColor'></path>
+<path d='M 312,104 L 312,112' fill='none' stroke='currentColor'></path>
+<path d='M 64,48 L 64,56' fill='none' stroke='currentColor'></path>
+<polygon points='80.000000,48.000000 68.000000,42.400002 68.000000,53.599998' fill='currentColor' transform='rotate(90.000000, 64.000000, 48.000000)'></polygon>
+<path d='M 64,176 L 64,184' fill='none' stroke='currentColor'></path>
+<polygon points='80.000000,176.000000 68.000000,170.399994 68.000000,181.600006' fill='currentColor' transform='rotate(90.000000, 64.000000, 176.000000)'></polygon>
+<polygon points='248.000000,80.000000 236.000000,74.400002 236.000000,85.599998' fill='currentColor' transform='rotate(0.000000, 240.000000, 80.000000)'></polygon>
+<polygon points='248.000000,208.000000 236.000000,202.399994 236.000000,213.600006' fill='currentColor' transform='rotate(0.000000, 240.000000, 208.000000)'></polygon>
+<path d='M 80,16 A 16,16 0 0,0 64,32' fill='none' stroke='currentColor'></path>
+<path d='M 296,16 A 16,16 0 0,1 312,32' fill='none' stroke='currentColor'></path>
+<path d='M 80,144 A 16,16 0 0,0 64,160' fill='none' stroke='currentColor'></path>
+<path d='M 312,128 A 16,16 0 0,1 296,144' fill='none' stroke='currentColor'></path>
+<text text-anchor='middle' x='24' y='212' fill='currentColor' style='font-size:1em'>c</text>
+<text text-anchor='middle' x='32' y='84' fill='currentColor' style='font-size:1em'>t</text>
+<text text-anchor='middle' x='32' y='212' fill='currentColor' style='font-size:1em'>o</text>
+<text text-anchor='middle' x='40' y='84' fill='currentColor' style='font-size:1em'>o</text>
+<text text-anchor='middle' x='40' y='212' fill='currentColor' style='font-size:1em'>n</text>
+<text text-anchor='middle' x='48' y='84' fill='currentColor' style='font-size:1em'>k</text>
+<text text-anchor='middle' x='48' y='212' fill='currentColor' style='font-size:1em'>t</text>
+<text text-anchor='middle' x='56' y='84' fill='currentColor' style='font-size:1em'>e</text>
+<text text-anchor='middle' x='56' y='212' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='64' y='84' fill='currentColor' style='font-size:1em'>n</text>
+<text text-anchor='middle' x='64' y='212' fill='currentColor' style='font-size:1em'>o</text>
+<text text-anchor='middle' x='72' y='84' fill='currentColor' style='font-size:1em'>i</text>
+<text text-anchor='middle' x='72' y='212' fill='currentColor' style='font-size:1em'>l</text>
+<text text-anchor='middle' x='80' y='84' fill='currentColor' style='font-size:1em'>z</text>
+<text text-anchor='middle' x='80' y='212' fill='currentColor' style='font-size:1em'>l</text>
+<text text-anchor='middle' x='88' y='84' fill='currentColor' style='font-size:1em'>e</text>
+<text text-anchor='middle' x='88' y='212' fill='currentColor' style='font-size:1em'>e</text>
+<text text-anchor='middle' x='96' y='84' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='96' y='212' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='128' y='132' fill='currentColor' style='font-size:1em'>c</text>
+<text text-anchor='middle' x='136' y='132' fill='currentColor' style='font-size:1em'>o</text>
+<text text-anchor='middle' x='144' y='4' fill='currentColor' style='font-size:1em'>m</text>
+<text text-anchor='middle' x='144' y='132' fill='currentColor' style='font-size:1em'>m</text>
+<text text-anchor='middle' x='144' y='196' fill='currentColor' style='font-size:1em'>c</text>
+<text text-anchor='middle' x='152' y='4' fill='currentColor' style='font-size:1em'>o</text>
+<text text-anchor='middle' x='152' y='132' fill='currentColor' style='font-size:1em'>m</text>
+<text text-anchor='middle' x='152' y='196' fill='currentColor' style='font-size:1em'>t</text>
+<text text-anchor='middle' x='160' y='4' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='160' y='132' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='160' y='196' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='168' y='4' fill='currentColor' style='font-size:1em'>e</text>
+<text text-anchor='middle' x='168' y='68' fill='currentColor' style='font-size:1em'>t</text>
+<text text-anchor='middle' x='168' y='132' fill='currentColor' style='font-size:1em'>n</text>
+<text text-anchor='middle' x='168' y='196' fill='currentColor' style='font-size:1em'>l</text>
+<text text-anchor='middle' x='176' y='68' fill='currentColor' style='font-size:1em'>o</text>
+<text text-anchor='middle' x='176' y='132' fill='currentColor' style='font-size:1em'>d</text>
+<text text-anchor='middle' x='184' y='4' fill='currentColor' style='font-size:1em'>p</text>
+<text text-anchor='middle' x='184' y='68' fill='currentColor' style='font-size:1em'>k</text>
+<text text-anchor='middle' x='184' y='196' fill='currentColor' style='font-size:1em'>s</text>
+<text text-anchor='middle' x='192' y='4' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='192' y='68' fill='currentColor' style='font-size:1em'>e</text>
+<text text-anchor='middle' x='192' y='132' fill='currentColor' style='font-size:1em'>w</text>
+<text text-anchor='middle' x='192' y='196' fill='currentColor' style='font-size:1em'>i</text>
+<text text-anchor='middle' x='200' y='4' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='200' y='68' fill='currentColor' style='font-size:1em'>n</text>
+<text text-anchor='middle' x='200' y='132' fill='currentColor' style='font-size:1em'>/</text>
+<text text-anchor='middle' x='200' y='196' fill='currentColor' style='font-size:1em'>g</text>
+<text text-anchor='middle' x='208' y='4' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='208' y='196' fill='currentColor' style='font-size:1em'>n</text>
+<text text-anchor='middle' x='216' y='4' fill='currentColor' style='font-size:1em'>m</text>
+<text text-anchor='middle' x='216' y='132' fill='currentColor' style='font-size:1em'>p</text>
+<text text-anchor='middle' x='216' y='196' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='224' y='4' fill='currentColor' style='font-size:1em'>s</text>
+<text text-anchor='middle' x='224' y='132' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='224' y='196' fill='currentColor' style='font-size:1em'>l</text>
+<text text-anchor='middle' x='232' y='4' fill='currentColor' style='font-size:1em'>?</text>
+<text text-anchor='middle' x='232' y='132' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='240' y='132' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='248' y='132' fill='currentColor' style='font-size:1em'>m</text>
+<text text-anchor='middle' x='256' y='132' fill='currentColor' style='font-size:1em'>s</text>
+<text text-anchor='middle' x='272' y='84' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='272' y='212' fill='currentColor' style='font-size:1em'>l</text>
+<text text-anchor='middle' x='280' y='84' fill='currentColor' style='font-size:1em'>c</text>
+<text text-anchor='middle' x='280' y='212' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='288' y='84' fill='currentColor' style='font-size:1em'>c</text>
+<text text-anchor='middle' x='288' y='212' fill='currentColor' style='font-size:1em'>s</text>
+<text text-anchor='middle' x='296' y='84' fill='currentColor' style='font-size:1em'>u</text>
+<text text-anchor='middle' x='296' y='212' fill='currentColor' style='font-size:1em'>e</text>
+<text text-anchor='middle' x='304' y='84' fill='currentColor' style='font-size:1em'>m</text>
+<text text-anchor='middle' x='304' y='212' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='312' y='84' fill='currentColor' style='font-size:1em'>u</text>
+<text text-anchor='middle' x='320' y='84' fill='currentColor' style='font-size:1em'>l</text>
+<text text-anchor='middle' x='320' y='212' fill='currentColor' style='font-size:1em'>g</text>
+<text text-anchor='middle' x='328' y='84' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='328' y='212' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='336' y='84' fill='currentColor' style='font-size:1em'>t</text>
+<text text-anchor='middle' x='336' y='212' fill='currentColor' style='font-size:1em'>l</text>
+<text text-anchor='middle' x='344' y='84' fill='currentColor' style='font-size:1em'>o</text>
+<text text-anchor='middle' x='344' y='212' fill='currentColor' style='font-size:1em'>v</text>
+<text text-anchor='middle' x='352' y='84' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='352' y='212' fill='currentColor' style='font-size:1em'>o</text>
+</g>
+
+ </svg>
+
+</div>
+<h2 id="source-code">Source Code</h2>
+<p>The source code for the G-code interpreter can be found
+<a href="https://git.christianermann.dev/gcode-interpreter">here</a>. You may have issues
+accessing the link if your ISP doesn’t support IPv6 yet.</p>
+<p>Also, the names in the code are different than what’s shown in the diagram, so
+here’s the mapping to help out with understanding the code:</p>
+<table>
+ <thead>
+ <tr>
+ <th style="text-align: left">Diagram</th>
+ <th style="text-align: left">Source File</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td style="text-align: left">tokenizer</td>
+ <td style="text-align: left">token.c</td>
+ </tr>
+ <tr>
+ <td style="text-align: left">accumulator</td>
+ <td style="text-align: left">command.c</td>
+ </tr>
+ <tr>
+ <td style="text-align: left">controller</td>
+ <td style="text-align: left">machine.c</td>
+ </tr>
+ </tbody>
+</table>
+<p>I’ll try to keep this updated if the mapping changes as I continue to work on
+this project.</p>
+]]></content:encoded>
+ </item>
+ <item>
+ <title>Unbind Your Vertex Array Objects.</title>
+ <link>https://electrosoup.com/posts/unbind/</link>
+ <pubDate>Wed, 25 Aug 2021 14:33:02 -0500</pubDate><author>christianermann@gmail.com (Christian Ermann)</author>
+ <guid>https://electrosoup.com/posts/unbind/</guid>
+ <description><p>When I first started learning about OpenGL, I always made sure to unbind each resource as soon as I was done using it. Over time I became more lenient with unbinding, as in many cases leaving resources bound is okay and leads to fewer API calls.</p></description>
+ <content:encoded><![CDATA[<p>When I first started learning about OpenGL, I always made sure to unbind each resource as soon as I was done using it. Over time I became more lenient with unbinding, as in many cases leaving resources bound is okay and leads to fewer API calls.</p>
+<p>In addition, when I’m developing on my PC I have access to the newer Direct State Access (DSA) functions, so binding resources isn’t something I have to worry about as much. However, I do a fair amount of programming on my macbook which means I don’t always have access to the DSA functions.</p>
+<p>I was working on a project recently that involved the vertex and index data for a mesh frequently changing. The actual mesh struct has a bit more going on, but we can think of it like this for now:</p>
+
+
+
+
+<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-c" data-lang="c"><span class="line"><span class="ln">1</span><span class="cl"><span class="k">typedef</span> <span class="k">struct</span> <span class="p">{</span>
+</span></span><span class="line"><span class="ln">2</span><span class="cl"> <span class="n">Vec3</span> <span class="o">*</span><span class="n">vertices</span><span class="p">;</span>
+</span></span><span class="line"><span class="ln">3</span><span class="cl"> <span class="n">GLuint</span> <span class="o">*</span><span class="n">indices</span><span class="p">;</span>
+</span></span><span class="line"><span class="ln">4</span><span class="cl"> <span class="n">GLuint</span> <span class="n">vao</span><span class="p">;</span>
+</span></span><span class="line"><span class="ln">5</span><span class="cl"> <span class="n">GLuint</span> <span class="n">vbo</span><span class="p">;</span>
+</span></span><span class="line"><span class="ln">6</span><span class="cl"> <span class="n">GLuint</span> <span class="n">ebo</span><span class="p">;</span>
+</span></span><span class="line"><span class="ln">7</span><span class="cl"><span class="p">}</span> <span class="n">Mesh</span><span class="p">;</span></span></span></code></pre></div>
+<p>So when it comes time to update the vertex or index data, we map the vertex buffer object to the vertices pointer and the element buffer object to the indices pointer. Then we can write all of our vertex and index data directly to the buffers, and then unmap them when we’re all done and need to draw.</p>
+
+
+
+
+<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-c" data-lang="c"><span class="line"><span class="ln"> 1</span><span class="cl"><span class="p">...</span>
+</span></span><span class="line"><span class="ln"> 2</span><span class="cl">
+</span></span><span class="line"><span class="ln"> 3</span><span class="cl"><span class="nf">glBindBuffer</span><span class="p">(</span><span class="n">GL_ARRAY_BUFFER</span><span class="p">,</span> <span class="n">mesh</span><span class="o">-></span><span class="n">vbo</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln"> 4</span><span class="cl"><span class="n">mesh</span><span class="o">-></span><span class="n">vertices</span> <span class="o">=</span> <span class="nf">glMapBuffer</span><span class="p">(</span><span class="n">GL_ARRAY_BUFFER</span><span class="p">,</span> <span class="n">GL_WRITE_ONLY</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln"> 5</span><span class="cl">
+</span></span><span class="line"><span class="ln"> 6</span><span class="cl"><span class="nf">glBindBuffer</span><span class="p">(</span><span class="n">GL_ELEMENT_ARRAY_BUFFER</span><span class="p">,</span> <span class="n">mesh</span><span class="o">-></span><span class="n">ebo</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln"> 7</span><span class="cl"><span class="n">mesh</span><span class="o">-></span><span class="n">indices</span> <span class="o">=</span> <span class="nf">glMapBuffer</span><span class="p">(</span><span class="n">GL_ELEMENT_ARRAY_BUFFER</span><span class="p">,</span> <span class="n">GL_WRITE_ONLY</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln"> 8</span><span class="cl">
+</span></span><span class="line"><span class="ln"> 9</span><span class="cl"><span class="c1">// While we have the buffers mapped, we can write data directly to
+</span></span></span><span class="line"><span class="ln">10</span><span class="cl"><span class="c1">// mesh->vertices and mesh->indices.
+</span></span></span><span class="line"><span class="ln">11</span><span class="cl"><span class="c1"></span>
+</span></span><span class="line"><span class="ln">12</span><span class="cl"><span class="nf">glBindBuffer</span><span class="p">(</span><span class="n">GL_ARRAY_BUFFER</span><span class="p">,</span> <span class="n">mesh</span><span class="o">-></span><span class="n">vbo</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln">13</span><span class="cl"><span class="nf">glUnmapBuffer</span><span class="p">(</span><span class="n">GL_ARRAY_BUFFER</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln">14</span><span class="cl"><span class="n">mesh</span><span class="o">-></span><span class="n">vertices</span> <span class="o">=</span> <span class="nb">NULL</span>
+</span></span><span class="line"><span class="ln">15</span><span class="cl">
+</span></span><span class="line"><span class="ln">16</span><span class="cl"><span class="nf">glBindBuffer</span><span class="p">(</span><span class="n">GL_ELEMENT_ARRAY_BUFFER</span><span class="p">,</span> <span class="n">mesh</span><span class="o">-></span><span class="n">ebo</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln">17</span><span class="cl"><span class="nf">glUnmapBuffer</span><span class="p">(</span><span class="n">GL_ELEMENT_ARRAY_BUFFER</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln">18</span><span class="cl"><span class="n">mesh</span><span class="o">-></span><span class="n">indices</span> <span class="o">=</span> <span class="nb">NULL</span>
+</span></span><span class="line"><span class="ln">19</span><span class="cl">
+</span></span><span class="line"><span class="ln">20</span><span class="cl"><span class="c1">// Now that the buffers are unmapped, we can draw the mesh again.
+</span></span></span><span class="line"><span class="ln">21</span><span class="cl"><span class="c1"></span>
+</span></span><span class="line"><span class="ln">22</span><span class="cl"><span class="p">...</span></span></span></code></pre></div>
+<p>Leaving the buffers bound in the above snippet didn’t cause problems and seemed a reasonable thing to do to reduce unnecessary OpenGL calls.
+The issues I was running into were actually caused by how I was drawing each mesh:</p>
+
+
+
+
+<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-c" data-lang="c"><span class="line"><span class="ln">1</span><span class="cl"><span class="p">...</span>
+</span></span><span class="line"><span class="ln">2</span><span class="cl">
+</span></span><span class="line"><span class="ln">3</span><span class="cl"><span class="nf">glBindVertexArray</span><span class="p">(</span><span class="n">mesh</span><span class="o">-></span><span class="n">vao</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln">4</span><span class="cl"><span class="nf">glDrawElements</span><span class="p">(...);</span>
+</span></span><span class="line"><span class="ln">5</span><span class="cl">
+</span></span><span class="line"><span class="ln">6</span><span class="cl"><span class="p">...</span></span></span></code></pre></div>
+<p>Since I wasn’t unbinding the mesh’s vertex array object when I finished drawing it, when I updated another mesh’s vertex or index data and bound that mesh’s buffer objects, the vertex array object I forgot to unbind would now be using the incorrect buffers to draw with.</p>
+<p>Luckily, there was a simple fix, and now I know to be more careful with unbinding vertex array objects:</p>
+
+
+
+
+<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-c" data-lang="c"><span class="line"><span class="ln">1</span><span class="cl"><span class="p">...</span>
+</span></span><span class="line"><span class="ln">2</span><span class="cl">
+</span></span><span class="line"><span class="ln">3</span><span class="cl"><span class="nf">glBindVertexArray</span><span class="p">(</span><span class="n">mesh</span><span class="o">-></span><span class="n">vao</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln">4</span><span class="cl"><span class="nf">glDrawElements</span><span class="p">(...);</span>
+</span></span><span class="line"><span class="ln">5</span><span class="cl"><span class="nf">glBindVertexArray</span><span class="p">(</span><span class="mi">0</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln">6</span><span class="cl">
+</span></span><span class="line"><span class="ln">7</span><span class="cl"><span class="p">...</span></span></span></code></pre></div>
+]]></content:encoded>
+ </item>
+ </channel>
+</rss>
diff --git a/tags/forth/index.html b/tags/forth/index.html
@@ -0,0 +1,128 @@
+<!DOCTYPE html>
+<html lang="en-US">
+
+<head>
+ <meta http-equiv="X-Clacks-Overhead" content="GNU Terry Pratchett" />
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+<link rel="shortcut icon" href="https://electrosoup.com/favicon.png" />
+<title>Forth | Electrosoup</title>
+<meta name="title" content="Forth" />
+<meta name="description" content="Stuff I'm working on." />
+<meta name="author" content="" />
+<meta name="keywords" content="arm,assembly,c,forth,g-code,graphics,lasers,matrices,opengl,risc-v," />
+
+
+
+
+
+
+
+ <meta property="og:url" content="https://electrosoup.com/tags/forth/">
+ <meta property="og:site_name" content="Electrosoup">
+ <meta property="og:title" content="Forth">
+ <meta property="og:description" content="Stuff I'm working on.">
+ <meta property="og:locale" content="en_US">
+ <meta property="og:type" content="website">
+
+
+
+
+ <meta name="twitter:card" content="summary">
+ <meta name="twitter:title" content="Forth">
+ <meta name="twitter:description" content="Stuff I'm working on.">
+
+
+
+
+ <meta itemprop="name" content="Forth">
+ <meta itemprop="description" content="Stuff I'm working on.">
+ <meta itemprop="datePublished" content="2024-11-13T17:33:47-08:00">
+ <meta itemprop="dateModified" content="2024-11-13T17:33:47-08:00">
+
+
+ <link href="/herman.min.css" rel="stylesheet">
+
+
+
+
+
+ <link rel="alternate" type="application/rss+xml" href="https://electrosoup.com/tags/forth/index.xml" title="Electrosoup" />
+
+</head>
+
+<body>
+ <header><a class="skip-link" href="#main-content">Skip to main content</a>
+
+<nav>
+ <a href="/">Main</a>
+
+ <a href="/posts/">Posts</a>
+
+ <a href="https://git.electrosoup.com">Code</a>
+
+ <a href="https://christianermann.dev">Resume</a>
+
+
+
+
+
+
+
+
+
+</nav>
+</header>
+ <main id="main-content">
+<content>
+
+ <h3 class="blog-filter">Filtering for "Forth"</h3>
+
+ <ul class="blog-posts">
+
+ <li>
+ <span>
+ <i>
+ <time datetime='2024-11-13' pubdate>
+ 2024-11-13
+ </time>
+ </i>
+ </span>
+
+ <a href="/posts/forth-rv32i-assembler/">Forth RV32I Assembler</a>
+
+ </li>
+
+ <li>
+ <span>
+ <i>
+ <time datetime='2024-11-12' pubdate>
+ 2024-11-12
+ </time>
+ </i>
+ </span>
+
+ <a href="/posts/the-infamous-link-macro/">The Infamous 'link' Macro</a>
+
+ </li>
+
+ </ul>
+
+</content>
+
+ </main>
+ <footer><footer>
+
+ <a href="https://git.electrosoup.com">Code</a>.
+
+ <a href="https://christianermann.dev">Resume</a>.
+
+ <a href='https://electrosoup.com/index.xml'>RSS</a>.
+ <p>Copyright © 2026 Christian Ermann. | Made with <a href="https://github.com/clente/hugo-bearcub">Bear Cub</a></p>
+</footer>
+</footer>
+
+
+</body>
+
+</html>
diff --git a/tags/forth/index.xml b/tags/forth/index.xml
@@ -0,0 +1,286 @@
+<?xml version="1.0" encoding="utf-8" standalone="yes"?>
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/">
+ <channel>
+ <title>Forth on Electrosoup</title>
+ <link>https://electrosoup.com/tags/forth/</link>
+ <description>Recent content in Forth on Electrosoup</description>
+ <generator>Hugo -- gohugo.io</generator>
+ <language>en-US</language>
+ <managingEditor>christianermann@gmail.com (Christian Ermann)</managingEditor>
+ <webMaster>christianermann@gmail.com (Christian Ermann)</webMaster>
+ <lastBuildDate>Wed, 13 Nov 2024 17:33:47 -0800</lastBuildDate>
+ <atom:link href="https://electrosoup.com/tags/forth/index.xml" rel="self" type="application/rss+xml" />
+ <item>
+ <title>Forth RV32I Assembler</title>
+ <link>https://electrosoup.com/posts/forth-rv32i-assembler/</link>
+ <pubDate>Wed, 13 Nov 2024 17:33:47 -0800</pubDate><author>christianermann@gmail.com (Christian Ermann)</author>
+ <guid>https://electrosoup.com/posts/forth-rv32i-assembler/</guid>
+ <description><p>Here&rsquo;s an assembler for RV32I that I wrote in Forth. I find the definitions of
the instructions and instruction types especially elegant, and I find it to be
a great demonstration of how concise and powerful Forth can be.</p></description>
+ <content:encoded><![CDATA[<p>Here’s an assembler for RV32I that I wrote in Forth. I find the definitions of
+the instructions and instruction types especially elegant, and I find it to be
+a great demonstration of how concise and powerful Forth can be.</p>
+<p>All code in this post is licensed under the
+<a href="https://www.gnu.org/licenses/agpl-3.0.en.html#license-text">AGPLv3</a>.</p>
+
+
+
+
+
+<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-forth" data-lang="forth"><span class="line"><span class="ln"> 1</span><span class="cl"><span class="c1">\ encode stack values into proper instruction locations. all
+</span></span></span><span class="line"><span class="ln"> 2</span><span class="cl"><span class="c1">\ encoding sequences must begin with 'opcode'.
+</span></span></span><span class="line"><span class="ln"> 3</span><span class="cl"><span class="c1"></span><span class="kn">:</span> <span class="nc">opcode</span> <span class="k">hex </span> <span class="mi">7</span><span class="nf">F</span> <span class="k">and </span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 4</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">funct3</span> <span class="k">swap hex </span> <span class="mi">7</span> <span class="k">and decimal </span><span class="mi">12</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 5</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">funct7</span> <span class="k">swap hex </span> <span class="mi">7</span><span class="nf">F</span> <span class="k">and decimal </span><span class="mi">25</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 6</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">i-immed</span> <span class="k">swap hex </span> <span class="nf">FFF</span> <span class="k">and decimal </span><span class="mi">20</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 7</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">i-immed-shamt</span> <span class="k">swap hex </span> <span class="mi">1</span><span class="nf">F</span> <span class="k">and decimal </span><span class="mi">20</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 8</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">u-immed</span> <span class="k">swap hex </span> <span class="nf">FFFFF</span> <span class="k">and decimal </span><span class="mi">12</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 9</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">s-immed</span> <span class="k">over hex </span> <span class="nf">FE0</span> <span class="k">and decimal </span><span class="mi">20</span> <span class="k">lshift +
+</span></span></span><span class="line"><span class="ln"> 10</span><span class="cl"><span class="k"></span> <span class="k">swap hex </span> <span class="mi">1</span><span class="nf">F</span> <span class="k">and decimal </span> <span class="mi">7</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 11</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">j-immed</span> <span class="k">over hex </span><span class="mi">100000</span> <span class="k">and decimal </span><span class="mi">11</span> <span class="k">lshift +
+</span></span></span><span class="line"><span class="ln"> 12</span><span class="cl"><span class="k"></span> <span class="k">over hex </span> <span class="nf">FF000</span> <span class="k">and </span> <span class="k">+
+</span></span></span><span class="line"><span class="ln"> 13</span><span class="cl"><span class="k"></span> <span class="k">over hex </span> <span class="mi">800</span> <span class="k">and decimal </span> <span class="mi">9</span> <span class="k">lshift +
+</span></span></span><span class="line"><span class="ln"> 14</span><span class="cl"><span class="k"></span> <span class="k">swap hex </span> <span class="mi">7</span><span class="nf">FE</span> <span class="k">and decimal </span><span class="mi">20</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 15</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">b-immed</span> <span class="k">over hex </span> <span class="mi">1000</span> <span class="k">and decimal </span><span class="mi">19</span> <span class="k">lshift +
+</span></span></span><span class="line"><span class="ln"> 16</span><span class="cl"><span class="k"></span> <span class="k">over hex </span> <span class="mi">800</span> <span class="k">and decimal </span> <span class="mi">4</span> <span class="k">rshift +
+</span></span></span><span class="line"><span class="ln"> 17</span><span class="cl"><span class="k"></span> <span class="k">over hex </span> <span class="mi">7</span><span class="nf">E0</span> <span class="k">and decimal </span><span class="mi">20</span> <span class="k">lshift +
+</span></span></span><span class="line"><span class="ln"> 18</span><span class="cl"><span class="k"></span> <span class="k">swap hex </span> <span class="mi">1</span><span class="nf">E</span> <span class="k">and decimal </span> <span class="mi">7</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 19</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">rd</span> <span class="k">swap hex </span> <span class="mi">1</span><span class="nf">F</span> <span class="k">and decimal </span> <span class="mi">7</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 20</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">rs1</span> <span class="k">swap hex </span> <span class="mi">1</span><span class="nf">F</span> <span class="k">and decimal </span><span class="mi">15</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 21</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">rs2</span> <span class="k">swap hex </span> <span class="mi">1</span><span class="nf">F</span> <span class="k">and decimal </span><span class="mi">20</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 22</span><span class="cl"><span class="k"></span>
+</span></span><span class="line"><span class="ln"> 23</span><span class="cl"><span class="c1">\ instruction types. all instruction values should be pushed on the
+</span></span></span><span class="line"><span class="ln"> 24</span><span class="cl"><span class="c1">\ stack with the opcode last before calling.
+</span></span></span><span class="line"><span class="ln"> 25</span><span class="cl"><span class="c1"></span><span class="kn">:</span> <span class="nc">r-type</span> <span class="nf">opcode</span> <span class="nf">funct3</span> <span class="nf">funct7</span> <span class="nf">rs2</span> <span class="nf">rs1</span> <span class="nf">rd</span> <span class="k">, ;
+</span></span></span><span class="line"><span class="ln"> 26</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">i-type</span> <span class="nf">opcode</span> <span class="nf">funct3</span> <span class="nf">i-immed</span> <span class="nf">rs1</span> <span class="nf">rd</span> <span class="k">, ;
+</span></span></span><span class="line"><span class="ln"> 27</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">i-type-shamt</span> <span class="nf">opcode</span> <span class="nf">funct3</span> <span class="nf">funct7</span> <span class="nf">i-immed-shamt</span> <span class="nf">rs1</span> <span class="nf">rd</span> <span class="k">, ;
+</span></span></span><span class="line"><span class="ln"> 28</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">s-type</span> <span class="nf">opcode</span> <span class="nf">funct3</span> <span class="nf">s-immed</span> <span class="nf">rs2</span> <span class="nf">rs1</span> <span class="k">, ;
+</span></span></span><span class="line"><span class="ln"> 29</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">b-type</span> <span class="nf">opcode</span> <span class="nf">funct3</span> <span class="nf">b-immed</span> <span class="nf">rs2</span> <span class="nf">rs1</span> <span class="k">, ;
+</span></span></span><span class="line"><span class="ln"> 30</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">u-type</span> <span class="nf">opcode</span> <span class="nf">u-immed</span> <span class="nf">rd</span> <span class="k">, ;
+</span></span></span><span class="line"><span class="ln"> 31</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">j-type</span> <span class="nf">opcode</span> <span class="nf">j-immed</span> <span class="nf">rd</span> <span class="k">, ;
+</span></span></span><span class="line"><span class="ln"> 32</span><span class="cl"><span class="k"></span>
+</span></span><span class="line"><span class="ln"> 33</span><span class="cl"><span class="c1">\ instructions. these are just simple encodings, no assembler
+</span></span></span><span class="line"><span class="ln"> 34</span><span class="cl"><span class="c1">\ niceties yet.
+</span></span></span><span class="line"><span class="ln"> 35</span><span class="cl"><span class="c1">\ funct7 funct3 opcode encoding
+</span></span></span><span class="line"><span class="ln"> 36</span><span class="cl"><span class="c1"></span><span class="kn">:</span> <span class="nc">addi,</span> <span class="k">hex </span> <span class="mi">0</span> <span class="mi">13</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 37</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">andi,</span> <span class="k">hex </span> <span class="mi">7</span> <span class="mi">13</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 38</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">ori,</span> <span class="k">hex </span> <span class="mi">6</span> <span class="mi">13</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 39</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">xori,</span> <span class="k">hex </span> <span class="mi">4</span> <span class="mi">13</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 40</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">slli,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">1</span> <span class="mi">13</span> <span class="nf">i-type-shamt</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 41</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">srli,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">5</span> <span class="mi">13</span> <span class="nf">i-type-shamt</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 42</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">srai,</span> <span class="k">hex </span> <span class="mi">20</span> <span class="mi">5</span> <span class="mi">13</span> <span class="nf">i-type-shamt</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 43</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">slti,</span> <span class="k">hex </span> <span class="mi">2</span> <span class="mi">13</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 44</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sltiu,</span> <span class="k">hex </span> <span class="mi">3</span> <span class="mi">13</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 45</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">lui,</span> <span class="k">hex </span> <span class="mi">37</span> <span class="nf">u-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 46</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">auipc,</span> <span class="k">hex </span> <span class="mi">17</span> <span class="nf">u-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 47</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">add,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">0</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 48</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sub,</span> <span class="k">hex </span> <span class="mi">20</span> <span class="mi">0</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 49</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">and,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">7</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 50</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">or,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">6</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 51</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">xor,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">4</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 52</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sll,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">1</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 53</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">srl,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">5</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 54</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sra,</span> <span class="k">hex </span> <span class="mi">20</span> <span class="mi">5</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 55</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">slt,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">2</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 56</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sltu,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">3</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 57</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">jal,</span> <span class="k">hex </span> <span class="mi">6</span><span class="nf">F</span> <span class="nf">j-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 58</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">jalr,</span> <span class="k">hex </span> <span class="mi">0</span> <span class="mi">67</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 59</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">beq,</span> <span class="k">hex </span> <span class="mi">0</span> <span class="mi">63</span> <span class="nf">b-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 60</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">bne,</span> <span class="k">hex </span> <span class="mi">1</span> <span class="mi">63</span> <span class="nf">b-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 61</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">blt,</span> <span class="k">hex </span> <span class="mi">4</span> <span class="mi">63</span> <span class="nf">b-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 62</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">bltu,</span> <span class="k">hex </span> <span class="mi">6</span> <span class="mi">63</span> <span class="nf">b-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 63</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">bge,</span> <span class="k">hex </span> <span class="mi">5</span> <span class="mi">63</span> <span class="nf">b-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 64</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">bgeu,</span> <span class="k">hex </span> <span class="mi">7</span> <span class="mi">63</span> <span class="nf">b-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 65</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">lw,</span> <span class="k">hex </span> <span class="mi">2</span> <span class="mi">03</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 66</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">lh,</span> <span class="k">hex </span> <span class="mi">1</span> <span class="mi">03</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 67</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">lhu,</span> <span class="k">hex </span> <span class="mi">5</span> <span class="mi">03</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 68</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">lb,</span> <span class="k">hex </span> <span class="mi">0</span> <span class="mi">03</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 69</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sw,</span> <span class="k">hex </span> <span class="mi">2</span> <span class="mi">23</span> <span class="nf">s-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 70</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sh,</span> <span class="k">hex </span> <span class="mi">1</span> <span class="mi">23</span> <span class="nf">s-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 71</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sb,</span> <span class="k">hex </span> <span class="mi">0</span> <span class="mi">23</span> <span class="nf">s-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 72</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">fence,</span> <span class="k">hex </span> <span class="mi">0</span> <span class="mi">0</span><span class="nf">F</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 73</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">ecall,</span> <span class="k">hex </span> <span class="mi">0</span> <span class="mi">73</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 74</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">ebreak,</span> <span class="k">hex </span> <span class="mi">0</span> <span class="mi">73</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 75</span><span class="cl"><span class="k"></span>
+</span></span><span class="line"><span class="ln"> 76</span><span class="cl"><span class="c1">\ some instructions, now with nicer usage.
+</span></span></span><span class="line"><span class="ln"> 77</span><span class="cl"><span class="c1"></span><span class="kn">:</span> <span class="nc">sw,</span> <span class="k">>r swap r> </span><span class="nf">sw,</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 78</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sh,</span> <span class="k">>r swap r> </span><span class="nf">sh,</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 79</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sb,</span> <span class="k">>r swap r> </span><span class="nf">sb,</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 80</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">ecall,</span> <span class="mi">0</span> <span class="mi">0</span> <span class="mi">0</span> <span class="nf">ecall,</span> <span class="k">; </span> <span class="c1">\ usage: ecall,
+</span></span></span><span class="line"><span class="ln"> 81</span><span class="cl"><span class="c1"></span><span class="kn">:</span> <span class="nc">ebreak,</span> <span class="mi">0</span> <span class="mi">0</span> <span class="mi">1</span> <span class="nf">ebreak,</span> <span class="k">; </span> <span class="c1">\ usage: ebreak,
+</span></span></span><span class="line"><span class="ln"> 82</span><span class="cl"><span class="c1"></span><span class="kn">:</span> <span class="nc">fence,</span> <span class="k">>r </span><span class="mi">0</span> <span class="mi">0</span> <span class="k">r> </span><span class="nf">fence,</span> <span class="k">; </span><span class="c1">\ usage: imm fence,
+</span></span></span><span class="line"><span class="ln"> 83</span><span class="cl"><span class="c1"></span>
+</span></span><span class="line"><span class="ln"> 84</span><span class="cl"><span class="c1">\ registers
+</span></span></span><span class="line"><span class="ln"> 85</span><span class="cl"><span class="c1"></span><span class="k">decimal
+</span></span></span><span class="line"><span class="ln"> 86</span><span class="cl"><span class="k"></span> <span class="mi">0</span> <span class="kn">constant</span> <span class="nc">x0</span> <span class="mi">1</span> <span class="kn">constant</span> <span class="nc">x1</span> <span class="mi">2</span> <span class="kn">constant</span> <span class="nc">x2</span> <span class="mi">3</span> <span class="kn">constant</span> <span class="nc">x3</span>
+</span></span><span class="line"><span class="ln"> 87</span><span class="cl"> <span class="mi">4</span> <span class="kn">constant</span> <span class="nc">x4</span> <span class="mi">5</span> <span class="kn">constant</span> <span class="nc">x5</span> <span class="mi">6</span> <span class="kn">constant</span> <span class="nc">x6</span> <span class="mi">7</span> <span class="kn">constant</span> <span class="nc">x7</span>
+</span></span><span class="line"><span class="ln"> 88</span><span class="cl"> <span class="mi">8</span> <span class="kn">constant</span> <span class="nc">x8</span> <span class="mi">9</span> <span class="kn">constant</span> <span class="nc">x9</span> <span class="mi">10</span> <span class="kn">constant</span> <span class="nc">x10</span> <span class="mi">11</span> <span class="kn">constant</span> <span class="nc">x11</span>
+</span></span><span class="line"><span class="ln"> 89</span><span class="cl"><span class="mi">12</span> <span class="kn">constant</span> <span class="nc">x12</span> <span class="mi">13</span> <span class="kn">constant</span> <span class="nc">x13</span> <span class="mi">14</span> <span class="kn">constant</span> <span class="nc">x14</span> <span class="mi">15</span> <span class="kn">constant</span> <span class="nc">x15</span>
+</span></span><span class="line"><span class="ln"> 90</span><span class="cl"><span class="mi">16</span> <span class="kn">constant</span> <span class="nc">x16</span> <span class="mi">17</span> <span class="kn">constant</span> <span class="nc">x17</span> <span class="mi">18</span> <span class="kn">constant</span> <span class="nc">x18</span> <span class="mi">19</span> <span class="kn">constant</span> <span class="nc">x19</span>
+</span></span><span class="line"><span class="ln"> 91</span><span class="cl"><span class="mi">20</span> <span class="kn">constant</span> <span class="nc">x20</span> <span class="mi">21</span> <span class="kn">constant</span> <span class="nc">x21</span> <span class="mi">22</span> <span class="kn">constant</span> <span class="nc">x22</span> <span class="mi">23</span> <span class="kn">constant</span> <span class="nc">x23</span>
+</span></span><span class="line"><span class="ln"> 92</span><span class="cl"><span class="mi">24</span> <span class="kn">constant</span> <span class="nc">x24</span> <span class="mi">25</span> <span class="kn">constant</span> <span class="nc">x25</span> <span class="mi">26</span> <span class="kn">constant</span> <span class="nc">x26</span> <span class="mi">27</span> <span class="kn">constant</span> <span class="nc">x27</span>
+</span></span><span class="line"><span class="ln"> 93</span><span class="cl"><span class="mi">28</span> <span class="kn">constant</span> <span class="nc">x28</span> <span class="mi">29</span> <span class="kn">constant</span> <span class="nc">x29</span> <span class="mi">30</span> <span class="kn">constant</span> <span class="nc">x30</span> <span class="mi">31</span> <span class="kn">constant</span> <span class="nc">x31</span>
+</span></span><span class="line"><span class="ln"> 94</span><span class="cl">
+</span></span><span class="line"><span class="ln"> 95</span><span class="cl"><span class="c1">\ registers (calling convention)
+</span></span></span><span class="line"><span class="ln"> 96</span><span class="cl"><span class="c1"></span><span class="nf">x0</span> <span class="kn">constant</span> <span class="nc">zero</span> <span class="c1">\ zero constant
+</span></span></span><span class="line"><span class="ln"> 97</span><span class="cl"><span class="c1"></span><span class="nf">x1</span> <span class="kn">constant</span> <span class="nc">ra</span> <span class="c1">\ return address
+</span></span></span><span class="line"><span class="ln"> 98</span><span class="cl"><span class="c1"></span><span class="nf">x2</span> <span class="kn">constant</span> <span class="nc">sp</span> <span class="c1">\ stack pointer
+</span></span></span><span class="line"><span class="ln"> 99</span><span class="cl"><span class="c1"></span><span class="nf">x3</span> <span class="kn">constant</span> <span class="nc">gp</span> <span class="c1">\ global pointer
+</span></span></span><span class="line"><span class="ln">100</span><span class="cl"><span class="c1"></span><span class="nf">x4</span> <span class="kn">constant</span> <span class="nc">tp</span> <span class="c1">\ thread pointer
+</span></span></span><span class="line"><span class="ln">101</span><span class="cl"><span class="c1"></span><span class="nf">x8</span> <span class="kn">constant</span> <span class="nc">fp</span> <span class="c1">\ frame pointer
+</span></span></span><span class="line"><span class="ln">102</span><span class="cl"><span class="c1">\ function arguments / return values (a0, a1)
+</span></span></span><span class="line"><span class="ln">103</span><span class="cl"><span class="c1"></span><span class="nf">x10</span> <span class="kn">constant</span> <span class="nc">a0</span> <span class="nf">x11</span> <span class="kn">constant</span> <span class="nc">a1</span> <span class="nf">x12</span> <span class="kn">constant</span> <span class="nc">a2</span> <span class="nf">x13</span> <span class="kn">constant</span> <span class="nc">a3</span>
+</span></span><span class="line"><span class="ln">104</span><span class="cl"><span class="nf">x14</span> <span class="kn">constant</span> <span class="nc">a4</span> <span class="nf">x15</span> <span class="kn">constant</span> <span class="nc">a5</span> <span class="nf">x16</span> <span class="kn">constant</span> <span class="nc">a6</span> <span class="nf">x17</span> <span class="kn">constant</span> <span class="nc">a7</span>
+</span></span><span class="line"><span class="ln">105</span><span class="cl"><span class="c1">\ saved registers
+</span></span></span><span class="line"><span class="ln">106</span><span class="cl"><span class="c1"></span><span class="nf">x8</span> <span class="kn">constant</span> <span class="nc">s0</span> <span class="nf">x9</span> <span class="kn">constant</span> <span class="nc">s1</span> <span class="nf">x18</span> <span class="kn">constant</span> <span class="nc">s2</span> <span class="nf">x19</span> <span class="kn">constant</span> <span class="nc">s3</span>
+</span></span><span class="line"><span class="ln">107</span><span class="cl"><span class="nf">x20</span> <span class="kn">constant</span> <span class="nc">s4</span> <span class="nf">x21</span> <span class="kn">constant</span> <span class="nc">s5</span> <span class="nf">x22</span> <span class="kn">constant</span> <span class="nc">s6</span> <span class="nf">x23</span> <span class="kn">constant</span> <span class="nc">s7</span>
+</span></span><span class="line"><span class="ln">108</span><span class="cl"><span class="nf">x24</span> <span class="kn">constant</span> <span class="nc">s8</span> <span class="nf">x25</span> <span class="kn">constant</span> <span class="nc">s9</span> <span class="nf">x26</span> <span class="kn">constant</span> <span class="nc">s10</span> <span class="nf">x27</span> <span class="kn">constant</span> <span class="nc">s11</span>
+</span></span><span class="line"><span class="ln">109</span><span class="cl"><span class="c1">\ temporaries
+</span></span></span><span class="line"><span class="ln">110</span><span class="cl"><span class="c1"></span><span class="nf">x5</span> <span class="kn">constant</span> <span class="nc">t0</span> <span class="nf">x6</span> <span class="kn">constant</span> <span class="nc">t1</span> <span class="nf">x7</span> <span class="kn">constant</span> <span class="nc">t2</span> <span class="nf">x28</span> <span class="kn">constant</span> <span class="nc">t3</span>
+</span></span><span class="line"><span class="ln">111</span><span class="cl"><span class="nf">x29</span> <span class="kn">constant</span> <span class="nc">t4</span> <span class="nf">x30</span> <span class="kn">constant</span> <span class="nc">t5</span> <span class="nf">x31</span> <span class="kn">constant</span> <span class="nc">t6</span></span></span></code></pre></div><p>And here’s some tests to verify the instruction encodings are generated
+correctly:</p>
+
+
+
+
+
+<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-forth" data-lang="forth"><span class="line"><span class="ln"> 1</span><span class="cl"><span class="kn">:</span> <span class="nc">undo,</span> <span class="mi">-1</span> <span class="k">cells allot here @ ; </span><span class="c1">\ undoes the last ','
+</span></span></span><span class="line"><span class="ln"> 2</span><span class="cl"><span class="c1"></span><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">FF</span> <span class="nf">addi,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FF58513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln"> 3</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">FF</span> <span class="nf">andi,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FF5F513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln"> 4</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">FF</span> <span class="nf">ori,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FF5E513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln"> 5</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">FF</span> <span class="nf">xori,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FF5C513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln"> 6</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">slli,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">F59513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln"> 7</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">srli,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">F5D513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln"> 8</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">srai,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">40</span><span class="nf">F5D513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln"> 9</span><span class="cl"><span class="nf">t{</span> <span class="nf">t0</span> <span class="k">hex </span><span class="nf">FFFF</span> <span class="nf">lui,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FFFF2B7</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">10</span><span class="cl"><span class="nf">t{</span> <span class="nf">t0</span> <span class="k">hex </span><span class="nf">FFFF</span> <span class="nf">auipc,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FFFF297</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">11</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">FF</span> <span class="nf">slti,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FF5A513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">12</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">FF</span> <span class="nf">sltiu,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FF5B513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">13</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">add,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">C58533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">14</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">sub,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">40</span><span class="nf">C58533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">15</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">and,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">C5F533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">16</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">or,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">C5E533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">17</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">xor,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">C5C533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">18</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">sll,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">C59533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">19</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">srl,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">C5D533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">20</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">sra,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">40</span><span class="nf">C5D533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">21</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">slt,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">C5A533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">22</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">sltu,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">C5B533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">23</span><span class="cl"><span class="nf">t{</span> <span class="nf">ra</span> <span class="k">hex </span><span class="nf">FFFF</span> <span class="nf">jal,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">7</span><span class="nf">FF0F0EF</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">24</span><span class="cl"><span class="nf">t{</span> <span class="nf">ra</span> <span class="nf">a0</span> <span class="k">hex </span> <span class="nf">FF</span> <span class="nf">jalr,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FF500E7</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">25</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">beq,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">B50763</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">26</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">bne,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">B51763</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">27</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">blt,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">B54763</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">28</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">bltu,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">B56763</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">29</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">bge,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">B55763</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">30</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">bgeu,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">B57763</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">31</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">lw,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">F5A503</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">32</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">lh,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">F59503</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">33</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">lhu,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">F5D503</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">34</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">lb,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">F58503</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">35</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">sw,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">A5A7A3</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">36</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">sh,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">A597A3</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">37</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">sb,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">A587A3</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">38</span><span class="cl"><span class="nf">t{</span> <span class="k">hex </span> <span class="mi">0</span><span class="nf">FF</span> <span class="nf">fence,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FF0000F</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">39</span><span class="cl"><span class="nf">t{</span> <span class="nf">ecall,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00000073</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">40</span><span class="cl"><span class="nf">t{</span> <span class="nf">ebreak,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00100073</span> <span class="err">}t</span></span></span></code></pre></div>]]></content:encoded>
+ </item>
+ <item>
+ <title>The Infamous 'link' Macro</title>
+ <link>https://electrosoup.com/posts/the-infamous-link-macro/</link>
+ <pubDate>Tue, 12 Nov 2024 13:01:09 -0800</pubDate><author>christianermann@gmail.com (Christian Ermann)</author>
+ <guid>https://electrosoup.com/posts/the-infamous-link-macro/</guid>
+ <description><p>Each word (or function, in other languages) in Forth is stored as an entry in
a linked list known as the dictionary. When bootstrapping a Forth from
assembly, it is your responsibility to create and maintain this linked list
structure. This is a tedious process and is the source of many errors when
re-arranging words or defining new words; it&rsquo;s incredibly easy to turn your
list into a graph by mistake.</p></description>
+ <content:encoded><![CDATA[<p>Each word (or function, in other languages) in Forth is stored as an entry in
+a linked list known as the dictionary. When bootstrapping a Forth from
+assembly, it is your responsibility to create and maintain this linked list
+structure. This is a tedious process and is the source of many errors when
+re-arranging words or defining new words; it’s incredibly easy to turn your
+list into a graph by mistake.</p>
+<p>In
+<a href="https://rwmj.wordpress.com/2010/08/07/jonesforth-git-repository/">jonesforth</a>,
+an x86 implementation of Forth, the assembler supports re-assigning new values
+to assembler variables. This means an assember variable can be used to store
+the memory address of the previous entry, and we have the ability to update it
+or use it whenever we need to. I used this exact strategy in my
+<a href="https://git.christianermann.dev/forth/log.html">incomplete x86 Forth</a> although
+I used <a href="https://flatassembler.net/">FASM</a> instead of
+<a href="https://wiki.osdev.org/GAS">GAS</a>. Unfortunately, GAS doesn’t support this
+feature for ARM or RISC-V targets. It may be possible to pull this off on ARM
+with the right set of relocation and/or relaxation parameters, but I was unable
+to find success with RISC-V.</p>
+<p>I did come up with an alternative set of macros that achieves the same goal
+and should be more portable than the <code>jonesforth</code> solution:</p>
+
+
+
+
+
+<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-GAS" data-lang="GAS"><span class="line"><span class="ln"> 1</span><span class="cl"><span class="na">.macro</span> <span class="no">this_link</span>
+</span></span><span class="line"><span class="ln"> 2</span><span class="cl"> <span class="na">.globl</span> <span class="no">link_</span><span class="err">\+</span>
+</span></span><span class="line"><span class="ln"> 3</span><span class="cl"><span class="nf">link_</span><span class="err">\+</span><span class="p">:</span>
+</span></span><span class="line"><span class="ln"> 4</span><span class="cl"><span class="na">.endm</span>
+</span></span><span class="line"><span class="ln"> 5</span><span class="cl">
+</span></span><span class="line"><span class="ln"> 6</span><span class="cl"><span class="na">.macro</span> <span class="no">prev_link</span>
+</span></span><span class="line"><span class="ln"> 7</span><span class="cl"> <span class="na">.int</span> <span class="no">link_</span><span class="err">\+</span>
+</span></span><span class="line"><span class="ln"> 8</span><span class="cl"><span class="na">.endm</span>
+</span></span><span class="line"><span class="ln"> 9</span><span class="cl">
+</span></span><span class="line"><span class="ln">10</span><span class="cl"><span class="na">.macro</span> <span class="no">link</span>
+</span></span><span class="line"><span class="ln">11</span><span class="cl"> <span class="nf">this_link</span>
+</span></span><span class="line"><span class="ln">12</span><span class="cl"> <span class="nf">prev_link</span>
+</span></span><span class="line"><span class="ln">13</span><span class="cl"><span class="na">.endm</span>
+</span></span><span class="line"><span class="ln">14</span><span class="cl">
+</span></span><span class="line"><span class="ln">15</span><span class="cl"><span class="nf">this_link</span></span></span></code></pre></div><p>These macros depend on the special value
+
+
+
+
+<code class="code-inline language-GAS"><span class="err">\+</span></code>.
+This value is replaced by the invocation count of the current macro during
+assembly. Since we want to
+
+
+
+
+<code class="code-inline language-GAS"><span class="nf">link</span></code>
+back to the previous word in the dictionary, we need
+
+
+
+
+<code class="code-inline language-GAS"><span class="nf">prev_link</span></code>
+to resolve to 1 word before
+
+
+
+
+<code class="code-inline language-GAS"><span class="nf">this_link</span></code>,
+which is why we call
+
+
+
+
+<code class="code-inline language-GAS"><span class="nf">this_link</span></code>
+once before defining any words.</p>
+<p>You’ll also need to add this to your linker script to null-terminate your
+dictionary, otherwise the start of your dictionary will be marked by the
+address where the
+
+
+
+
+<code class="code-inline language-GAS"><span class="nf">link_0</span></code>
+label created by
+
+
+
+
+<code class="code-inline language-GAS"><span class="nf">this_link</span></code> was stored:</p>
+
+
+
+
+
+<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-GAS" data-lang="GAS"><span class="line"><span class="ln">1</span><span class="cl"><span class="nf">link_0</span> <span class="err">=</span> <span class="mi">0</span><span class="err">;</span></span></span></code></pre></div>]]></content:encoded>
+ </item>
+ </channel>
+</rss>
diff --git a/tags/g-code/index.html b/tags/g-code/index.html
@@ -0,0 +1,115 @@
+<!DOCTYPE html>
+<html lang="en-US">
+
+<head>
+ <meta http-equiv="X-Clacks-Overhead" content="GNU Terry Pratchett" />
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+<link rel="shortcut icon" href="https://electrosoup.com/favicon.png" />
+<title>G-Code | Electrosoup</title>
+<meta name="title" content="G-Code" />
+<meta name="description" content="Stuff I'm working on." />
+<meta name="author" content="" />
+<meta name="keywords" content="arm,assembly,c,forth,g-code,graphics,lasers,matrices,opengl,risc-v," />
+
+
+
+
+
+
+
+ <meta property="og:url" content="https://electrosoup.com/tags/g-code/">
+ <meta property="og:site_name" content="Electrosoup">
+ <meta property="og:title" content="G-Code">
+ <meta property="og:description" content="Stuff I'm working on.">
+ <meta property="og:locale" content="en_US">
+ <meta property="og:type" content="website">
+
+
+
+
+ <meta name="twitter:card" content="summary">
+ <meta name="twitter:title" content="G-Code">
+ <meta name="twitter:description" content="Stuff I'm working on.">
+
+
+
+
+ <meta itemprop="name" content="G-Code">
+ <meta itemprop="description" content="Stuff I'm working on.">
+ <meta itemprop="datePublished" content="2024-10-23T16:29:40-07:00">
+ <meta itemprop="dateModified" content="2024-10-23T16:29:40-07:00">
+
+
+ <link href="/herman.min.css" rel="stylesheet">
+
+
+
+
+
+ <link rel="alternate" type="application/rss+xml" href="https://electrosoup.com/tags/g-code/index.xml" title="Electrosoup" />
+
+</head>
+
+<body>
+ <header><a class="skip-link" href="#main-content">Skip to main content</a>
+
+<nav>
+ <a href="/">Main</a>
+
+ <a href="/posts/">Posts</a>
+
+ <a href="https://git.electrosoup.com">Code</a>
+
+ <a href="https://christianermann.dev">Resume</a>
+
+
+
+
+
+
+
+
+
+</nav>
+</header>
+ <main id="main-content">
+<content>
+
+ <h3 class="blog-filter">Filtering for "G-Code"</h3>
+
+ <ul class="blog-posts">
+
+ <li>
+ <span>
+ <i>
+ <time datetime='2024-10-23' pubdate>
+ 2024-10-23
+ </time>
+ </i>
+ </span>
+
+ <a href="/posts/gcode-interpreter/">Writing a G-code Interpreter</a>
+
+ </li>
+
+ </ul>
+
+</content>
+
+ </main>
+ <footer><footer>
+
+ <a href="https://git.electrosoup.com">Code</a>.
+
+ <a href="https://christianermann.dev">Resume</a>.
+
+ <a href='https://electrosoup.com/index.xml'>RSS</a>.
+ <p>Copyright © 2026 Christian Ermann. | Made with <a href="https://github.com/clente/hugo-bearcub">Bear Cub</a></p>
+</footer>
+</footer>
+
+
+</body>
+
+</html>
diff --git a/tags/g-code/index.xml b/tags/g-code/index.xml
@@ -0,0 +1,216 @@
+<?xml version="1.0" encoding="utf-8" standalone="yes"?>
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/">
+ <channel>
+ <title>G-Code on Electrosoup</title>
+ <link>https://electrosoup.com/tags/g-code/</link>
+ <description>Recent content in G-Code on Electrosoup</description>
+ <generator>Hugo -- gohugo.io</generator>
+ <language>en-US</language>
+ <managingEditor>christianermann@gmail.com (Christian Ermann)</managingEditor>
+ <webMaster>christianermann@gmail.com (Christian Ermann)</webMaster>
+ <lastBuildDate>Wed, 23 Oct 2024 16:29:40 -0700</lastBuildDate>
+ <atom:link href="https://electrosoup.com/tags/g-code/index.xml" rel="self" type="application/rss+xml" />
+ <item>
+ <title>Writing a G-code Interpreter</title>
+ <link>https://electrosoup.com/posts/gcode-interpreter/</link>
+ <pubDate>Wed, 23 Oct 2024 16:29:40 -0700</pubDate><author>christianermann@gmail.com (Christian Ermann)</author>
+ <guid>https://electrosoup.com/posts/gcode-interpreter/</guid>
+ <description><p>I&rsquo;m currently working on a control system for a laser galvanometer (galvo) that
I want to use in a stereolithography (SLA) resin printer. I don&rsquo;t want to write
a custom slicer, as I feel like model slicing can be incredibly complicated and
existing free software (Cura, Slic3r, etc.) has many advanced features I don&rsquo;t
want to reimplement. However, this means my control system needs to understand
G-code, the language that these slicers output.</p></description>
+ <content:encoded><![CDATA[<p>I’m currently working on a control system for a laser galvanometer (galvo) that
+I want to use in a stereolithography (SLA) resin printer. I don’t want to write
+a custom slicer, as I feel like model slicing can be incredibly complicated and
+existing free software (Cura, Slic3r, etc.) has many advanced features I don’t
+want to reimplement. However, this means my control system needs to understand
+G-code, the language that these slicers output.</p>
+<p>As stated on the <a href="https://reprap.org/wiki/G-code">reprap wiki</a>, “G-code is a
+list of fields that are separated by white spaces or line breaks. A field can
+be interpreted as a command, parameter, or for any other special purpose.” For
+now, we’ll ignore any special purposes. Here is an example of G-code that
+describes a movement of the tool/hotend/laser to a specific location:</p>
+
+
+
+
+
+<pre tabindex="0"><code class="language-gcode" data-lang="gcode"> G1 X10.4 Y7.4 Z8.3</code></pre><p>I was able to parse commands with parameters using a two-stage procedure:</p>
+<pre><code>1. Retrieve the next white-space delimited token.
+2. Accumulate tokens until two separate command tokens are found.
+</code></pre>
+<p>This second step is important because we can’t begin executing a command until
+we’ve found all of its parameters and we don’t know if we’ve found all of its
+parameters until we find the next command.</p>
+<p>Once a command and all of its parameters have been parsed, it is passed to the
+controller which updates the state of the machine. For each command that the
+controller receives, it has to update its internal state, and in the case of
+physical movement commands, send the proper signal to the laser galvo. Most
+physical movement commands utilize interpolation so a timed control loop is
+utilized to ensure the laser follows as close to the intended path as possible.</p>
+<h2 id="system-diagram">System Diagram</h2>
+
+
+
+<div class="goat svg-container ">
+
+ <svg
+ xmlns="http://www.w3.org/2000/svg"
+ font-family="Menlo,Lucida Console,monospace"
+
+ viewBox="0 0 384 249"
+ >
+ <g transform='translate(8,16)'>
+<path d='M 80,16 L 296,16' fill='none' stroke='currentColor'></path>
+<path d='M 16,64 L 112,64' fill='none' stroke='currentColor'></path>
+<path d='M 256,64 L 368,64' fill='none' stroke='currentColor'></path>
+<path d='M 128,80 L 240,80' fill='none' stroke='currentColor'></path>
+<path d='M 16,96 L 112,96' fill='none' stroke='currentColor'></path>
+<path d='M 256,96 L 368,96' fill='none' stroke='currentColor'></path>
+<path d='M 80,144 L 296,144' fill='none' stroke='currentColor'></path>
+<path d='M 0,192 L 120,192' fill='none' stroke='currentColor'></path>
+<path d='M 256,192 L 368,192' fill='none' stroke='currentColor'></path>
+<path d='M 136,208 L 240,208' fill='none' stroke='currentColor'></path>
+<path d='M 0,224 L 120,224' fill='none' stroke='currentColor'></path>
+<path d='M 256,224 L 368,224' fill='none' stroke='currentColor'></path>
+<path d='M 0,192 L 0,224' fill='none' stroke='currentColor'></path>
+<path d='M 16,64 L 16,96' fill='none' stroke='currentColor'></path>
+<path d='M 64,32 L 64,48' fill='none' stroke='currentColor'></path>
+<path d='M 64,160 L 64,176' fill='none' stroke='currentColor'></path>
+<path d='M 112,64 L 112,96' fill='none' stroke='currentColor'></path>
+<path d='M 120,192 L 120,224' fill='none' stroke='currentColor'></path>
+<path d='M 256,64 L 256,96' fill='none' stroke='currentColor'></path>
+<path d='M 256,192 L 256,224' fill='none' stroke='currentColor'></path>
+<path d='M 312,32 L 312,48' fill='none' stroke='currentColor'></path>
+<path d='M 312,112 L 312,128' fill='none' stroke='currentColor'></path>
+<path d='M 368,64 L 368,96' fill='none' stroke='currentColor'></path>
+<path d='M 368,192 L 368,224' fill='none' stroke='currentColor'></path>
+<path d='M 312,48 L 312,56' fill='none' stroke='currentColor'></path>
+<path d='M 312,104 L 312,112' fill='none' stroke='currentColor'></path>
+<path d='M 64,48 L 64,56' fill='none' stroke='currentColor'></path>
+<polygon points='80.000000,48.000000 68.000000,42.400002 68.000000,53.599998' fill='currentColor' transform='rotate(90.000000, 64.000000, 48.000000)'></polygon>
+<path d='M 64,176 L 64,184' fill='none' stroke='currentColor'></path>
+<polygon points='80.000000,176.000000 68.000000,170.399994 68.000000,181.600006' fill='currentColor' transform='rotate(90.000000, 64.000000, 176.000000)'></polygon>
+<polygon points='248.000000,80.000000 236.000000,74.400002 236.000000,85.599998' fill='currentColor' transform='rotate(0.000000, 240.000000, 80.000000)'></polygon>
+<polygon points='248.000000,208.000000 236.000000,202.399994 236.000000,213.600006' fill='currentColor' transform='rotate(0.000000, 240.000000, 208.000000)'></polygon>
+<path d='M 80,16 A 16,16 0 0,0 64,32' fill='none' stroke='currentColor'></path>
+<path d='M 296,16 A 16,16 0 0,1 312,32' fill='none' stroke='currentColor'></path>
+<path d='M 80,144 A 16,16 0 0,0 64,160' fill='none' stroke='currentColor'></path>
+<path d='M 312,128 A 16,16 0 0,1 296,144' fill='none' stroke='currentColor'></path>
+<text text-anchor='middle' x='24' y='212' fill='currentColor' style='font-size:1em'>c</text>
+<text text-anchor='middle' x='32' y='84' fill='currentColor' style='font-size:1em'>t</text>
+<text text-anchor='middle' x='32' y='212' fill='currentColor' style='font-size:1em'>o</text>
+<text text-anchor='middle' x='40' y='84' fill='currentColor' style='font-size:1em'>o</text>
+<text text-anchor='middle' x='40' y='212' fill='currentColor' style='font-size:1em'>n</text>
+<text text-anchor='middle' x='48' y='84' fill='currentColor' style='font-size:1em'>k</text>
+<text text-anchor='middle' x='48' y='212' fill='currentColor' style='font-size:1em'>t</text>
+<text text-anchor='middle' x='56' y='84' fill='currentColor' style='font-size:1em'>e</text>
+<text text-anchor='middle' x='56' y='212' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='64' y='84' fill='currentColor' style='font-size:1em'>n</text>
+<text text-anchor='middle' x='64' y='212' fill='currentColor' style='font-size:1em'>o</text>
+<text text-anchor='middle' x='72' y='84' fill='currentColor' style='font-size:1em'>i</text>
+<text text-anchor='middle' x='72' y='212' fill='currentColor' style='font-size:1em'>l</text>
+<text text-anchor='middle' x='80' y='84' fill='currentColor' style='font-size:1em'>z</text>
+<text text-anchor='middle' x='80' y='212' fill='currentColor' style='font-size:1em'>l</text>
+<text text-anchor='middle' x='88' y='84' fill='currentColor' style='font-size:1em'>e</text>
+<text text-anchor='middle' x='88' y='212' fill='currentColor' style='font-size:1em'>e</text>
+<text text-anchor='middle' x='96' y='84' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='96' y='212' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='128' y='132' fill='currentColor' style='font-size:1em'>c</text>
+<text text-anchor='middle' x='136' y='132' fill='currentColor' style='font-size:1em'>o</text>
+<text text-anchor='middle' x='144' y='4' fill='currentColor' style='font-size:1em'>m</text>
+<text text-anchor='middle' x='144' y='132' fill='currentColor' style='font-size:1em'>m</text>
+<text text-anchor='middle' x='144' y='196' fill='currentColor' style='font-size:1em'>c</text>
+<text text-anchor='middle' x='152' y='4' fill='currentColor' style='font-size:1em'>o</text>
+<text text-anchor='middle' x='152' y='132' fill='currentColor' style='font-size:1em'>m</text>
+<text text-anchor='middle' x='152' y='196' fill='currentColor' style='font-size:1em'>t</text>
+<text text-anchor='middle' x='160' y='4' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='160' y='132' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='160' y='196' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='168' y='4' fill='currentColor' style='font-size:1em'>e</text>
+<text text-anchor='middle' x='168' y='68' fill='currentColor' style='font-size:1em'>t</text>
+<text text-anchor='middle' x='168' y='132' fill='currentColor' style='font-size:1em'>n</text>
+<text text-anchor='middle' x='168' y='196' fill='currentColor' style='font-size:1em'>l</text>
+<text text-anchor='middle' x='176' y='68' fill='currentColor' style='font-size:1em'>o</text>
+<text text-anchor='middle' x='176' y='132' fill='currentColor' style='font-size:1em'>d</text>
+<text text-anchor='middle' x='184' y='4' fill='currentColor' style='font-size:1em'>p</text>
+<text text-anchor='middle' x='184' y='68' fill='currentColor' style='font-size:1em'>k</text>
+<text text-anchor='middle' x='184' y='196' fill='currentColor' style='font-size:1em'>s</text>
+<text text-anchor='middle' x='192' y='4' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='192' y='68' fill='currentColor' style='font-size:1em'>e</text>
+<text text-anchor='middle' x='192' y='132' fill='currentColor' style='font-size:1em'>w</text>
+<text text-anchor='middle' x='192' y='196' fill='currentColor' style='font-size:1em'>i</text>
+<text text-anchor='middle' x='200' y='4' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='200' y='68' fill='currentColor' style='font-size:1em'>n</text>
+<text text-anchor='middle' x='200' y='132' fill='currentColor' style='font-size:1em'>/</text>
+<text text-anchor='middle' x='200' y='196' fill='currentColor' style='font-size:1em'>g</text>
+<text text-anchor='middle' x='208' y='4' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='208' y='196' fill='currentColor' style='font-size:1em'>n</text>
+<text text-anchor='middle' x='216' y='4' fill='currentColor' style='font-size:1em'>m</text>
+<text text-anchor='middle' x='216' y='132' fill='currentColor' style='font-size:1em'>p</text>
+<text text-anchor='middle' x='216' y='196' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='224' y='4' fill='currentColor' style='font-size:1em'>s</text>
+<text text-anchor='middle' x='224' y='132' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='224' y='196' fill='currentColor' style='font-size:1em'>l</text>
+<text text-anchor='middle' x='232' y='4' fill='currentColor' style='font-size:1em'>?</text>
+<text text-anchor='middle' x='232' y='132' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='240' y='132' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='248' y='132' fill='currentColor' style='font-size:1em'>m</text>
+<text text-anchor='middle' x='256' y='132' fill='currentColor' style='font-size:1em'>s</text>
+<text text-anchor='middle' x='272' y='84' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='272' y='212' fill='currentColor' style='font-size:1em'>l</text>
+<text text-anchor='middle' x='280' y='84' fill='currentColor' style='font-size:1em'>c</text>
+<text text-anchor='middle' x='280' y='212' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='288' y='84' fill='currentColor' style='font-size:1em'>c</text>
+<text text-anchor='middle' x='288' y='212' fill='currentColor' style='font-size:1em'>s</text>
+<text text-anchor='middle' x='296' y='84' fill='currentColor' style='font-size:1em'>u</text>
+<text text-anchor='middle' x='296' y='212' fill='currentColor' style='font-size:1em'>e</text>
+<text text-anchor='middle' x='304' y='84' fill='currentColor' style='font-size:1em'>m</text>
+<text text-anchor='middle' x='304' y='212' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='312' y='84' fill='currentColor' style='font-size:1em'>u</text>
+<text text-anchor='middle' x='320' y='84' fill='currentColor' style='font-size:1em'>l</text>
+<text text-anchor='middle' x='320' y='212' fill='currentColor' style='font-size:1em'>g</text>
+<text text-anchor='middle' x='328' y='84' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='328' y='212' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='336' y='84' fill='currentColor' style='font-size:1em'>t</text>
+<text text-anchor='middle' x='336' y='212' fill='currentColor' style='font-size:1em'>l</text>
+<text text-anchor='middle' x='344' y='84' fill='currentColor' style='font-size:1em'>o</text>
+<text text-anchor='middle' x='344' y='212' fill='currentColor' style='font-size:1em'>v</text>
+<text text-anchor='middle' x='352' y='84' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='352' y='212' fill='currentColor' style='font-size:1em'>o</text>
+</g>
+
+ </svg>
+
+</div>
+<h2 id="source-code">Source Code</h2>
+<p>The source code for the G-code interpreter can be found
+<a href="https://git.christianermann.dev/gcode-interpreter">here</a>. You may have issues
+accessing the link if your ISP doesn’t support IPv6 yet.</p>
+<p>Also, the names in the code are different than what’s shown in the diagram, so
+here’s the mapping to help out with understanding the code:</p>
+<table>
+ <thead>
+ <tr>
+ <th style="text-align: left">Diagram</th>
+ <th style="text-align: left">Source File</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td style="text-align: left">tokenizer</td>
+ <td style="text-align: left">token.c</td>
+ </tr>
+ <tr>
+ <td style="text-align: left">accumulator</td>
+ <td style="text-align: left">command.c</td>
+ </tr>
+ <tr>
+ <td style="text-align: left">controller</td>
+ <td style="text-align: left">machine.c</td>
+ </tr>
+ </tbody>
+</table>
+<p>I’ll try to keep this updated if the mapping changes as I continue to work on
+this project.</p>
+]]></content:encoded>
+ </item>
+ </channel>
+</rss>
diff --git a/tags/graphics/index.html b/tags/graphics/index.html
@@ -0,0 +1,128 @@
+<!DOCTYPE html>
+<html lang="en-US">
+
+<head>
+ <meta http-equiv="X-Clacks-Overhead" content="GNU Terry Pratchett" />
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+<link rel="shortcut icon" href="https://electrosoup.com/favicon.png" />
+<title>Graphics | Electrosoup</title>
+<meta name="title" content="Graphics" />
+<meta name="description" content="Stuff I'm working on." />
+<meta name="author" content="" />
+<meta name="keywords" content="arm,assembly,c,forth,g-code,graphics,lasers,matrices,opengl,risc-v," />
+
+
+
+
+
+
+
+ <meta property="og:url" content="https://electrosoup.com/tags/graphics/">
+ <meta property="og:site_name" content="Electrosoup">
+ <meta property="og:title" content="Graphics">
+ <meta property="og:description" content="Stuff I'm working on.">
+ <meta property="og:locale" content="en_US">
+ <meta property="og:type" content="website">
+
+
+
+
+ <meta name="twitter:card" content="summary">
+ <meta name="twitter:title" content="Graphics">
+ <meta name="twitter:description" content="Stuff I'm working on.">
+
+
+
+
+ <meta itemprop="name" content="Graphics">
+ <meta itemprop="description" content="Stuff I'm working on.">
+ <meta itemprop="datePublished" content="2022-10-10T00:31:00-04:00">
+ <meta itemprop="dateModified" content="2022-10-10T00:31:00-04:00">
+
+
+ <link href="/herman.min.css" rel="stylesheet">
+
+
+
+
+
+ <link rel="alternate" type="application/rss+xml" href="https://electrosoup.com/tags/graphics/index.xml" title="Electrosoup" />
+
+</head>
+
+<body>
+ <header><a class="skip-link" href="#main-content">Skip to main content</a>
+
+<nav>
+ <a href="/">Main</a>
+
+ <a href="/posts/">Posts</a>
+
+ <a href="https://git.electrosoup.com">Code</a>
+
+ <a href="https://christianermann.dev">Resume</a>
+
+
+
+
+
+
+
+
+
+</nav>
+</header>
+ <main id="main-content">
+<content>
+
+ <h3 class="blog-filter">Filtering for "Graphics"</h3>
+
+ <ul class="blog-posts">
+
+ <li>
+ <span>
+ <i>
+ <time datetime='2022-10-10' pubdate>
+ 2022-10-10
+ </time>
+ </i>
+ </span>
+
+ <a href="/posts/look-at/">Understanding Camera Look-At.</a>
+
+ </li>
+
+ <li>
+ <span>
+ <i>
+ <time datetime='2021-11-21' pubdate>
+ 2021-11-21
+ </time>
+ </i>
+ </span>
+
+ <a href="/posts/view-matrix/">Deriving the View Matrix</a>
+
+ </li>
+
+ </ul>
+
+</content>
+
+ </main>
+ <footer><footer>
+
+ <a href="https://git.electrosoup.com">Code</a>.
+
+ <a href="https://christianermann.dev">Resume</a>.
+
+ <a href='https://electrosoup.com/index.xml'>RSS</a>.
+ <p>Copyright © 2026 Christian Ermann. | Made with <a href="https://github.com/clente/hugo-bearcub">Bear Cub</a></p>
+</footer>
+</footer>
+
+
+</body>
+
+</html>
diff --git a/tags/graphics/index.xml b/tags/graphics/index.xml
@@ -0,0 +1,205 @@
+<?xml version="1.0" encoding="utf-8" standalone="yes"?>
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/">
+ <channel>
+ <title>Graphics on Electrosoup</title>
+ <link>https://electrosoup.com/tags/graphics/</link>
+ <description>Recent content in Graphics on Electrosoup</description>
+ <generator>Hugo -- gohugo.io</generator>
+ <language>en-US</language>
+ <managingEditor>christianermann@gmail.com (Christian Ermann)</managingEditor>
+ <webMaster>christianermann@gmail.com (Christian Ermann)</webMaster>
+ <lastBuildDate>Mon, 10 Oct 2022 00:31:00 -0400</lastBuildDate>
+ <atom:link href="https://electrosoup.com/tags/graphics/index.xml" rel="self" type="application/rss+xml" />
+ <item>
+ <title>Understanding Camera Look-At.</title>
+ <link>https://electrosoup.com/posts/look-at/</link>
+ <pubDate>Mon, 10 Oct 2022 00:31:00 -0400</pubDate><author>christianermann@gmail.com (Christian Ermann)</author>
+ <guid>https://electrosoup.com/posts/look-at/</guid>
+ <description><p>Often times, we want to position the camera in our scene at a particular point,
such as the head of the character in a first-person shooter or the cockpit of a
plane in a flight simulator. We also want the camera to look in the direction
that the player is trying to move.</p></description>
+ <content:encoded><![CDATA[<p>Often times, we want to position the camera in our scene at a particular point,
+such as the head of the character in a first-person shooter or the cockpit of a
+plane in a flight simulator. We also want the camera to look in the direction
+that the player is trying to move.</p>
+<p>To do this, we need to find the forward, right, and up vectors that correspond
+to the desired view.</p>
+<p>If we let $\vec{p}$ be the camera’s position and $\vec{t}$ be the position of
+what we want to look at, the camera’s look direction is
+$$\vec{l}=\vec{t}-\vec{p}\,.$$
+Conventionally, the camera looks down the negative forward axis so
+$$\vec{f}=-\vec{l}\,.$$</p>
+<p>In order to determine the right vector, we need a reference up direction,
+$\vec{up}$ (which isn’t necessarily orthogonal to $\vec{f}$). This enables us
+to calculate
+$$\vec{r} = \vec{f} \times \vec{up}$$
+and
+$$\vec{u} = \vec{r} \times \vec{f}\,.$$</p>
+<p>Now we can use the camera position $\vec{p}$ and normalized forms of $\vec{f}$,
+$\vec{r}$, and $\vec{u}$ to fill in our
+<a href="/posts/view-matrix/">view matrix</a>:</p>
+<p>$$
+V
+=
+\begin{bmatrix}
+r_{x} & r_{y} & r_{z} & -(\vec{r} \cdot \vec{p}) \\
+u_{x} & u_{y} & u_{z} & -(\vec{u} \cdot \vec{p}) \\
+f_{x} & f_{y} & f_{z} & -(\vec{f} \cdot \vec{p}) \\
+0 & 0 & 0 & 1
+\end{bmatrix}
+$$</p>
+]]></content:encoded>
+ </item>
+ <item>
+ <title>Deriving the View Matrix</title>
+ <link>https://electrosoup.com/posts/view-matrix/</link>
+ <pubDate>Sun, 21 Nov 2021 13:34:08 -0800</pubDate><author>christianermann@gmail.com (Christian Ermann)</author>
+ <guid>https://electrosoup.com/posts/view-matrix/</guid>
+ <description><p>In computer graphics, the view matrix is used to transform points from
world space into camera space. Below is an explanation of how to derive this
matrix.</p></description>
+ <content:encoded><![CDATA[<p>In computer graphics, the view matrix is used to transform points from
+world space into camera space. Below is an explanation of how to derive this
+matrix.</p>
+<p>Let $V$ be the view matrix.
+If $\vec{r}$, $\vec{u}$, and $\vec{f}$ denote the right, up, and forward
+vectors of the camera and $\vec{p}$ is the camera’s position, $V$ should
+satisfy the following properties:
+$$
+\begin{matrix}
+V_{1*} \times
+\begin{bmatrix}
+r_{x} \\
+r_{y} \\
+r_{z} \\
+0
+\end{bmatrix}
+=
+\begin{bmatrix}
+1 \\
+0 \\
+0 \\
+0
+\end{bmatrix},&
+V_{2*} \times
+\begin{bmatrix}
+u_{x} \\
+u_{y} \\
+u_{z} \\
+0
+\end{bmatrix}
+=
+\begin{bmatrix}
+0 \\
+1 \\
+0 \\
+0
+\end{bmatrix},&
+V_{3*} \times
+\begin{bmatrix}
+f_{x} \\
+f_{y} \\
+f_{z} \\
+0
+\end{bmatrix}
+=
+\begin{bmatrix}
+0 \\
+0 \\
+1 \\
+0
+\end{bmatrix},&
+V_{4*} \times
+\begin{bmatrix}
+p_{x} \\
+p_{y} \\
+p_{z} \\
+1
+\end{bmatrix}
+=
+\begin{bmatrix}
+0 \\
+0 \\
+0 \\
+1
+\end{bmatrix}
+\end{matrix}
+$$
+In words, the view matrix should translate the camera to the origin and rotate
+it to align with the $\vec{x}$, $\vec{y}$, and $\vec{z}$ axes.</p>
+<p>This can be expressed more concisely as the product of two matrices:
+$$
+V \times
+\begin{bmatrix}
+r_{x} & u_{x} & f_{x} & p_{x} \\
+r_{y} & u_{y} & f_{y} & p_{y} \\
+r_{z} & u_{z} & f_{z} & p_{z} \\
+0 & 0 & 0 & 1
+\end{bmatrix}
+=
+\begin{bmatrix}
+1 & 0 & 0 & 0 \\
+0 & 1 & 0 & 0 \\
+0 & 0 & 1 & 0 \\
+0 & 0 & 0 & 1
+\end{bmatrix}
+$$</p>
+<p>To make this equation easier to solve, we can split the matrix containing our
+camera parameters into the product of a translation matrix $T$ and a rotation
+matrix $R$:
+$$
+V \times (T \times R) = I
+$$
+where
+$$
+\begin{matrix}
+T =
+\begin{bmatrix}
+1 & 0 & 0 & p_{x} \\
+0 & 1 & 0 & p_{y} \\
+0 & 0 & 1 & p_{z} \\
+0 & 0 & 0 & 1
+\end{bmatrix},&
+R =
+\begin{bmatrix}
+r_{x} & u_{x} & f_{x} & 0 \\
+r_{y} & u_{y} & f_{y} & 0 \\
+r_{z} & u_{z} & f_{z} & 0 \\
+0 & 0 & 0 & 1
+\end{bmatrix}
+\end{matrix}
+$$</p>
+<p>Solving for $V$ reveals that $V=R^{-1} \times T^{-1}$:
+$$
+V =
+\begin{bmatrix}
+r_{x} & r_{y} & r_{z} & 0 \\
+u_{x} & u_{y} & u_{z} & 0 \\
+f_{x} & f_{y} & f_{z} & 0 \\
+0 & 0 & 0 & 1
+\end{bmatrix}
+\times
+\begin{bmatrix}
+1 & 0 & 0 & -p_{x} \\
+0 & 1 & 0 & -p_{y} \\
+0 & 0 & 1 & -p_{z} \\
+0 & 0 & 0 & 1
+\end{bmatrix}
+$$</p>
+<p>And with some minor simplification,
+$$
+V
+=
+\begin{bmatrix}
+r_{x} & r_{y} & r_{z} & -(\vec{r} \cdot \vec{p}) \\
+u_{x} & u_{y} & u_{z} & -(\vec{u} \cdot \vec{p}) \\
+f_{x} & f_{y} & f_{z} & -(\vec{f} \cdot \vec{p}) \\
+0 & 0 & 0 & 1
+\end{bmatrix}
+$$</p>
+<p>When we’re ready to render our scene, we can apply $V$ to each vertex $\vec{q}$
+by calculating
+$$
+V \times \vec{q}
+$$
+in our vertex shader.</p>
+]]></content:encoded>
+ </item>
+ </channel>
+</rss>
diff --git a/tags/index.html b/tags/index.html
@@ -0,0 +1,232 @@
+<!DOCTYPE html>
+<html lang="en-US">
+
+<head>
+ <meta http-equiv="X-Clacks-Overhead" content="GNU Terry Pratchett" />
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+<link rel="shortcut icon" href="https://electrosoup.com/favicon.png" />
+<title>Tags | Electrosoup</title>
+<meta name="title" content="Tags" />
+<meta name="description" content="Stuff I'm working on." />
+<meta name="author" content="" />
+<meta name="keywords" content="arm,assembly,c,forth,g-code,graphics,lasers,matrices,opengl,risc-v," />
+
+
+
+
+
+
+
+ <meta property="og:url" content="https://electrosoup.com/tags/">
+ <meta property="og:site_name" content="Electrosoup">
+ <meta property="og:title" content="Tags">
+ <meta property="og:description" content="Stuff I'm working on.">
+ <meta property="og:locale" content="en_US">
+ <meta property="og:type" content="website">
+
+
+
+
+ <meta name="twitter:card" content="summary">
+ <meta name="twitter:title" content="Tags">
+ <meta name="twitter:description" content="Stuff I'm working on.">
+
+
+
+
+ <meta itemprop="name" content="Tags">
+ <meta itemprop="description" content="Stuff I'm working on.">
+ <meta itemprop="datePublished" content="2024-11-13T17:33:47-08:00">
+ <meta itemprop="dateModified" content="2024-11-13T17:33:47-08:00">
+
+
+ <link href="/herman.min.css" rel="stylesheet">
+
+
+
+
+
+ <link rel="alternate" type="application/rss+xml" href="https://electrosoup.com/tags/index.xml" title="Electrosoup" />
+
+</head>
+
+<body>
+ <header><a class="skip-link" href="#main-content">Skip to main content</a>
+
+<nav>
+ <a href="/">Main</a>
+
+ <a href="/posts/">Posts</a>
+
+ <a href="https://git.electrosoup.com">Code</a>
+
+ <a href="https://christianermann.dev">Resume</a>
+
+
+
+
+
+
+
+
+
+</nav>
+</header>
+ <main id="main-content">
+<content>
+
+ <h3 class="blog-filter">Filtering for "Tags"</h3>
+
+ <ul class="blog-posts">
+
+ <li>
+ <span>
+ <i>
+ <time datetime='2024-11-13' pubdate>
+ 2024-11-13
+ </time>
+ </i>
+ </span>
+
+ <a href="/tags/assembly/">Assembly</a>
+
+ </li>
+
+ <li>
+ <span>
+ <i>
+ <time datetime='2024-11-13' pubdate>
+ 2024-11-13
+ </time>
+ </i>
+ </span>
+
+ <a href="/tags/forth/">Forth</a>
+
+ </li>
+
+ <li>
+ <span>
+ <i>
+ <time datetime='2024-11-13' pubdate>
+ 2024-11-13
+ </time>
+ </i>
+ </span>
+
+ <a href="/tags/risc-v/">RISC-V</a>
+
+ </li>
+
+ <li>
+ <span>
+ <i>
+ <time datetime='2024-11-12' pubdate>
+ 2024-11-12
+ </time>
+ </i>
+ </span>
+
+ <a href="/tags/arm/">ARM</a>
+
+ </li>
+
+ <li>
+ <span>
+ <i>
+ <time datetime='2024-10-23' pubdate>
+ 2024-10-23
+ </time>
+ </i>
+ </span>
+
+ <a href="/tags/c/">C</a>
+
+ </li>
+
+ <li>
+ <span>
+ <i>
+ <time datetime='2024-10-23' pubdate>
+ 2024-10-23
+ </time>
+ </i>
+ </span>
+
+ <a href="/tags/g-code/">G-Code</a>
+
+ </li>
+
+ <li>
+ <span>
+ <i>
+ <time datetime='2024-10-23' pubdate>
+ 2024-10-23
+ </time>
+ </i>
+ </span>
+
+ <a href="/tags/lasers/">Lasers</a>
+
+ </li>
+
+ <li>
+ <span>
+ <i>
+ <time datetime='2022-10-10' pubdate>
+ 2022-10-10
+ </time>
+ </i>
+ </span>
+
+ <a href="/tags/graphics/">Graphics</a>
+
+ </li>
+
+ <li>
+ <span>
+ <i>
+ <time datetime='2022-10-10' pubdate>
+ 2022-10-10
+ </time>
+ </i>
+ </span>
+
+ <a href="/tags/matrices/">Matrices</a>
+
+ </li>
+
+ <li>
+ <span>
+ <i>
+ <time datetime='2022-10-10' pubdate>
+ 2022-10-10
+ </time>
+ </i>
+ </span>
+
+ <a href="/tags/opengl/">OpenGL</a>
+
+ </li>
+
+ </ul>
+
+</content>
+
+ </main>
+ <footer><footer>
+
+ <a href="https://git.electrosoup.com">Code</a>.
+
+ <a href="https://christianermann.dev">Resume</a>.
+
+ <a href='https://electrosoup.com/index.xml'>RSS</a>.
+ <p>Copyright © 2026 Christian Ermann. | Made with <a href="https://github.com/clente/hugo-bearcub">Bear Cub</a></p>
+</footer>
+</footer>
+
+
+</body>
+
+</html>
diff --git a/tags/index.xml b/tags/index.xml
@@ -0,0 +1,94 @@
+<?xml version="1.0" encoding="utf-8" standalone="yes"?>
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/">
+ <channel>
+ <title>Tags on Electrosoup</title>
+ <link>https://electrosoup.com/tags/</link>
+ <description>Recent content in Tags on Electrosoup</description>
+ <generator>Hugo -- gohugo.io</generator>
+ <language>en-US</language>
+ <managingEditor>christianermann@gmail.com (Christian Ermann)</managingEditor>
+ <webMaster>christianermann@gmail.com (Christian Ermann)</webMaster>
+ <lastBuildDate>Wed, 13 Nov 2024 17:33:47 -0800</lastBuildDate>
+ <atom:link href="https://electrosoup.com/tags/index.xml" rel="self" type="application/rss+xml" />
+ <item>
+ <title>Assembly</title>
+ <link>https://electrosoup.com/tags/assembly/</link>
+ <pubDate>Wed, 13 Nov 2024 17:33:47 -0800</pubDate><author>christianermann@gmail.com (Christian Ermann)</author>
+ <guid>https://electrosoup.com/tags/assembly/</guid>
+ <description></description>
+ <content:encoded><![CDATA[]]></content:encoded>
+ </item>
+ <item>
+ <title>Forth</title>
+ <link>https://electrosoup.com/tags/forth/</link>
+ <pubDate>Wed, 13 Nov 2024 17:33:47 -0800</pubDate><author>christianermann@gmail.com (Christian Ermann)</author>
+ <guid>https://electrosoup.com/tags/forth/</guid>
+ <description></description>
+ <content:encoded><![CDATA[]]></content:encoded>
+ </item>
+ <item>
+ <title>RISC-V</title>
+ <link>https://electrosoup.com/tags/risc-v/</link>
+ <pubDate>Wed, 13 Nov 2024 17:33:47 -0800</pubDate><author>christianermann@gmail.com (Christian Ermann)</author>
+ <guid>https://electrosoup.com/tags/risc-v/</guid>
+ <description></description>
+ <content:encoded><![CDATA[]]></content:encoded>
+ </item>
+ <item>
+ <title>ARM</title>
+ <link>https://electrosoup.com/tags/arm/</link>
+ <pubDate>Tue, 12 Nov 2024 13:01:09 -0800</pubDate><author>christianermann@gmail.com (Christian Ermann)</author>
+ <guid>https://electrosoup.com/tags/arm/</guid>
+ <description></description>
+ <content:encoded><![CDATA[]]></content:encoded>
+ </item>
+ <item>
+ <title>C</title>
+ <link>https://electrosoup.com/tags/c/</link>
+ <pubDate>Wed, 23 Oct 2024 16:29:40 -0700</pubDate><author>christianermann@gmail.com (Christian Ermann)</author>
+ <guid>https://electrosoup.com/tags/c/</guid>
+ <description></description>
+ <content:encoded><![CDATA[]]></content:encoded>
+ </item>
+ <item>
+ <title>G-Code</title>
+ <link>https://electrosoup.com/tags/g-code/</link>
+ <pubDate>Wed, 23 Oct 2024 16:29:40 -0700</pubDate><author>christianermann@gmail.com (Christian Ermann)</author>
+ <guid>https://electrosoup.com/tags/g-code/</guid>
+ <description></description>
+ <content:encoded><![CDATA[]]></content:encoded>
+ </item>
+ <item>
+ <title>Lasers</title>
+ <link>https://electrosoup.com/tags/lasers/</link>
+ <pubDate>Wed, 23 Oct 2024 16:29:40 -0700</pubDate><author>christianermann@gmail.com (Christian Ermann)</author>
+ <guid>https://electrosoup.com/tags/lasers/</guid>
+ <description></description>
+ <content:encoded><![CDATA[]]></content:encoded>
+ </item>
+ <item>
+ <title>Graphics</title>
+ <link>https://electrosoup.com/tags/graphics/</link>
+ <pubDate>Mon, 10 Oct 2022 00:31:00 -0400</pubDate><author>christianermann@gmail.com (Christian Ermann)</author>
+ <guid>https://electrosoup.com/tags/graphics/</guid>
+ <description></description>
+ <content:encoded><![CDATA[]]></content:encoded>
+ </item>
+ <item>
+ <title>Matrices</title>
+ <link>https://electrosoup.com/tags/matrices/</link>
+ <pubDate>Mon, 10 Oct 2022 00:31:00 -0400</pubDate><author>christianermann@gmail.com (Christian Ermann)</author>
+ <guid>https://electrosoup.com/tags/matrices/</guid>
+ <description></description>
+ <content:encoded><![CDATA[]]></content:encoded>
+ </item>
+ <item>
+ <title>OpenGL</title>
+ <link>https://electrosoup.com/tags/opengl/</link>
+ <pubDate>Mon, 10 Oct 2022 00:31:00 -0400</pubDate><author>christianermann@gmail.com (Christian Ermann)</author>
+ <guid>https://electrosoup.com/tags/opengl/</guid>
+ <description></description>
+ <content:encoded><![CDATA[]]></content:encoded>
+ </item>
+ </channel>
+</rss>
diff --git a/tags/lasers/index.html b/tags/lasers/index.html
@@ -0,0 +1,115 @@
+<!DOCTYPE html>
+<html lang="en-US">
+
+<head>
+ <meta http-equiv="X-Clacks-Overhead" content="GNU Terry Pratchett" />
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+<link rel="shortcut icon" href="https://electrosoup.com/favicon.png" />
+<title>Lasers | Electrosoup</title>
+<meta name="title" content="Lasers" />
+<meta name="description" content="Stuff I'm working on." />
+<meta name="author" content="" />
+<meta name="keywords" content="arm,assembly,c,forth,g-code,graphics,lasers,matrices,opengl,risc-v," />
+
+
+
+
+
+
+
+ <meta property="og:url" content="https://electrosoup.com/tags/lasers/">
+ <meta property="og:site_name" content="Electrosoup">
+ <meta property="og:title" content="Lasers">
+ <meta property="og:description" content="Stuff I'm working on.">
+ <meta property="og:locale" content="en_US">
+ <meta property="og:type" content="website">
+
+
+
+
+ <meta name="twitter:card" content="summary">
+ <meta name="twitter:title" content="Lasers">
+ <meta name="twitter:description" content="Stuff I'm working on.">
+
+
+
+
+ <meta itemprop="name" content="Lasers">
+ <meta itemprop="description" content="Stuff I'm working on.">
+ <meta itemprop="datePublished" content="2024-10-23T16:29:40-07:00">
+ <meta itemprop="dateModified" content="2024-10-23T16:29:40-07:00">
+
+
+ <link href="/herman.min.css" rel="stylesheet">
+
+
+
+
+
+ <link rel="alternate" type="application/rss+xml" href="https://electrosoup.com/tags/lasers/index.xml" title="Electrosoup" />
+
+</head>
+
+<body>
+ <header><a class="skip-link" href="#main-content">Skip to main content</a>
+
+<nav>
+ <a href="/">Main</a>
+
+ <a href="/posts/">Posts</a>
+
+ <a href="https://git.electrosoup.com">Code</a>
+
+ <a href="https://christianermann.dev">Resume</a>
+
+
+
+
+
+
+
+
+
+</nav>
+</header>
+ <main id="main-content">
+<content>
+
+ <h3 class="blog-filter">Filtering for "Lasers"</h3>
+
+ <ul class="blog-posts">
+
+ <li>
+ <span>
+ <i>
+ <time datetime='2024-10-23' pubdate>
+ 2024-10-23
+ </time>
+ </i>
+ </span>
+
+ <a href="/posts/gcode-interpreter/">Writing a G-code Interpreter</a>
+
+ </li>
+
+ </ul>
+
+</content>
+
+ </main>
+ <footer><footer>
+
+ <a href="https://git.electrosoup.com">Code</a>.
+
+ <a href="https://christianermann.dev">Resume</a>.
+
+ <a href='https://electrosoup.com/index.xml'>RSS</a>.
+ <p>Copyright © 2026 Christian Ermann. | Made with <a href="https://github.com/clente/hugo-bearcub">Bear Cub</a></p>
+</footer>
+</footer>
+
+
+</body>
+
+</html>
diff --git a/tags/lasers/index.xml b/tags/lasers/index.xml
@@ -0,0 +1,216 @@
+<?xml version="1.0" encoding="utf-8" standalone="yes"?>
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/">
+ <channel>
+ <title>Lasers on Electrosoup</title>
+ <link>https://electrosoup.com/tags/lasers/</link>
+ <description>Recent content in Lasers on Electrosoup</description>
+ <generator>Hugo -- gohugo.io</generator>
+ <language>en-US</language>
+ <managingEditor>christianermann@gmail.com (Christian Ermann)</managingEditor>
+ <webMaster>christianermann@gmail.com (Christian Ermann)</webMaster>
+ <lastBuildDate>Wed, 23 Oct 2024 16:29:40 -0700</lastBuildDate>
+ <atom:link href="https://electrosoup.com/tags/lasers/index.xml" rel="self" type="application/rss+xml" />
+ <item>
+ <title>Writing a G-code Interpreter</title>
+ <link>https://electrosoup.com/posts/gcode-interpreter/</link>
+ <pubDate>Wed, 23 Oct 2024 16:29:40 -0700</pubDate><author>christianermann@gmail.com (Christian Ermann)</author>
+ <guid>https://electrosoup.com/posts/gcode-interpreter/</guid>
+ <description><p>I&rsquo;m currently working on a control system for a laser galvanometer (galvo) that
I want to use in a stereolithography (SLA) resin printer. I don&rsquo;t want to write
a custom slicer, as I feel like model slicing can be incredibly complicated and
existing free software (Cura, Slic3r, etc.) has many advanced features I don&rsquo;t
want to reimplement. However, this means my control system needs to understand
G-code, the language that these slicers output.</p></description>
+ <content:encoded><![CDATA[<p>I’m currently working on a control system for a laser galvanometer (galvo) that
+I want to use in a stereolithography (SLA) resin printer. I don’t want to write
+a custom slicer, as I feel like model slicing can be incredibly complicated and
+existing free software (Cura, Slic3r, etc.) has many advanced features I don’t
+want to reimplement. However, this means my control system needs to understand
+G-code, the language that these slicers output.</p>
+<p>As stated on the <a href="https://reprap.org/wiki/G-code">reprap wiki</a>, “G-code is a
+list of fields that are separated by white spaces or line breaks. A field can
+be interpreted as a command, parameter, or for any other special purpose.” For
+now, we’ll ignore any special purposes. Here is an example of G-code that
+describes a movement of the tool/hotend/laser to a specific location:</p>
+
+
+
+
+
+<pre tabindex="0"><code class="language-gcode" data-lang="gcode"> G1 X10.4 Y7.4 Z8.3</code></pre><p>I was able to parse commands with parameters using a two-stage procedure:</p>
+<pre><code>1. Retrieve the next white-space delimited token.
+2. Accumulate tokens until two separate command tokens are found.
+</code></pre>
+<p>This second step is important because we can’t begin executing a command until
+we’ve found all of its parameters and we don’t know if we’ve found all of its
+parameters until we find the next command.</p>
+<p>Once a command and all of its parameters have been parsed, it is passed to the
+controller which updates the state of the machine. For each command that the
+controller receives, it has to update its internal state, and in the case of
+physical movement commands, send the proper signal to the laser galvo. Most
+physical movement commands utilize interpolation so a timed control loop is
+utilized to ensure the laser follows as close to the intended path as possible.</p>
+<h2 id="system-diagram">System Diagram</h2>
+
+
+
+<div class="goat svg-container ">
+
+ <svg
+ xmlns="http://www.w3.org/2000/svg"
+ font-family="Menlo,Lucida Console,monospace"
+
+ viewBox="0 0 384 249"
+ >
+ <g transform='translate(8,16)'>
+<path d='M 80,16 L 296,16' fill='none' stroke='currentColor'></path>
+<path d='M 16,64 L 112,64' fill='none' stroke='currentColor'></path>
+<path d='M 256,64 L 368,64' fill='none' stroke='currentColor'></path>
+<path d='M 128,80 L 240,80' fill='none' stroke='currentColor'></path>
+<path d='M 16,96 L 112,96' fill='none' stroke='currentColor'></path>
+<path d='M 256,96 L 368,96' fill='none' stroke='currentColor'></path>
+<path d='M 80,144 L 296,144' fill='none' stroke='currentColor'></path>
+<path d='M 0,192 L 120,192' fill='none' stroke='currentColor'></path>
+<path d='M 256,192 L 368,192' fill='none' stroke='currentColor'></path>
+<path d='M 136,208 L 240,208' fill='none' stroke='currentColor'></path>
+<path d='M 0,224 L 120,224' fill='none' stroke='currentColor'></path>
+<path d='M 256,224 L 368,224' fill='none' stroke='currentColor'></path>
+<path d='M 0,192 L 0,224' fill='none' stroke='currentColor'></path>
+<path d='M 16,64 L 16,96' fill='none' stroke='currentColor'></path>
+<path d='M 64,32 L 64,48' fill='none' stroke='currentColor'></path>
+<path d='M 64,160 L 64,176' fill='none' stroke='currentColor'></path>
+<path d='M 112,64 L 112,96' fill='none' stroke='currentColor'></path>
+<path d='M 120,192 L 120,224' fill='none' stroke='currentColor'></path>
+<path d='M 256,64 L 256,96' fill='none' stroke='currentColor'></path>
+<path d='M 256,192 L 256,224' fill='none' stroke='currentColor'></path>
+<path d='M 312,32 L 312,48' fill='none' stroke='currentColor'></path>
+<path d='M 312,112 L 312,128' fill='none' stroke='currentColor'></path>
+<path d='M 368,64 L 368,96' fill='none' stroke='currentColor'></path>
+<path d='M 368,192 L 368,224' fill='none' stroke='currentColor'></path>
+<path d='M 312,48 L 312,56' fill='none' stroke='currentColor'></path>
+<path d='M 312,104 L 312,112' fill='none' stroke='currentColor'></path>
+<path d='M 64,48 L 64,56' fill='none' stroke='currentColor'></path>
+<polygon points='80.000000,48.000000 68.000000,42.400002 68.000000,53.599998' fill='currentColor' transform='rotate(90.000000, 64.000000, 48.000000)'></polygon>
+<path d='M 64,176 L 64,184' fill='none' stroke='currentColor'></path>
+<polygon points='80.000000,176.000000 68.000000,170.399994 68.000000,181.600006' fill='currentColor' transform='rotate(90.000000, 64.000000, 176.000000)'></polygon>
+<polygon points='248.000000,80.000000 236.000000,74.400002 236.000000,85.599998' fill='currentColor' transform='rotate(0.000000, 240.000000, 80.000000)'></polygon>
+<polygon points='248.000000,208.000000 236.000000,202.399994 236.000000,213.600006' fill='currentColor' transform='rotate(0.000000, 240.000000, 208.000000)'></polygon>
+<path d='M 80,16 A 16,16 0 0,0 64,32' fill='none' stroke='currentColor'></path>
+<path d='M 296,16 A 16,16 0 0,1 312,32' fill='none' stroke='currentColor'></path>
+<path d='M 80,144 A 16,16 0 0,0 64,160' fill='none' stroke='currentColor'></path>
+<path d='M 312,128 A 16,16 0 0,1 296,144' fill='none' stroke='currentColor'></path>
+<text text-anchor='middle' x='24' y='212' fill='currentColor' style='font-size:1em'>c</text>
+<text text-anchor='middle' x='32' y='84' fill='currentColor' style='font-size:1em'>t</text>
+<text text-anchor='middle' x='32' y='212' fill='currentColor' style='font-size:1em'>o</text>
+<text text-anchor='middle' x='40' y='84' fill='currentColor' style='font-size:1em'>o</text>
+<text text-anchor='middle' x='40' y='212' fill='currentColor' style='font-size:1em'>n</text>
+<text text-anchor='middle' x='48' y='84' fill='currentColor' style='font-size:1em'>k</text>
+<text text-anchor='middle' x='48' y='212' fill='currentColor' style='font-size:1em'>t</text>
+<text text-anchor='middle' x='56' y='84' fill='currentColor' style='font-size:1em'>e</text>
+<text text-anchor='middle' x='56' y='212' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='64' y='84' fill='currentColor' style='font-size:1em'>n</text>
+<text text-anchor='middle' x='64' y='212' fill='currentColor' style='font-size:1em'>o</text>
+<text text-anchor='middle' x='72' y='84' fill='currentColor' style='font-size:1em'>i</text>
+<text text-anchor='middle' x='72' y='212' fill='currentColor' style='font-size:1em'>l</text>
+<text text-anchor='middle' x='80' y='84' fill='currentColor' style='font-size:1em'>z</text>
+<text text-anchor='middle' x='80' y='212' fill='currentColor' style='font-size:1em'>l</text>
+<text text-anchor='middle' x='88' y='84' fill='currentColor' style='font-size:1em'>e</text>
+<text text-anchor='middle' x='88' y='212' fill='currentColor' style='font-size:1em'>e</text>
+<text text-anchor='middle' x='96' y='84' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='96' y='212' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='128' y='132' fill='currentColor' style='font-size:1em'>c</text>
+<text text-anchor='middle' x='136' y='132' fill='currentColor' style='font-size:1em'>o</text>
+<text text-anchor='middle' x='144' y='4' fill='currentColor' style='font-size:1em'>m</text>
+<text text-anchor='middle' x='144' y='132' fill='currentColor' style='font-size:1em'>m</text>
+<text text-anchor='middle' x='144' y='196' fill='currentColor' style='font-size:1em'>c</text>
+<text text-anchor='middle' x='152' y='4' fill='currentColor' style='font-size:1em'>o</text>
+<text text-anchor='middle' x='152' y='132' fill='currentColor' style='font-size:1em'>m</text>
+<text text-anchor='middle' x='152' y='196' fill='currentColor' style='font-size:1em'>t</text>
+<text text-anchor='middle' x='160' y='4' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='160' y='132' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='160' y='196' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='168' y='4' fill='currentColor' style='font-size:1em'>e</text>
+<text text-anchor='middle' x='168' y='68' fill='currentColor' style='font-size:1em'>t</text>
+<text text-anchor='middle' x='168' y='132' fill='currentColor' style='font-size:1em'>n</text>
+<text text-anchor='middle' x='168' y='196' fill='currentColor' style='font-size:1em'>l</text>
+<text text-anchor='middle' x='176' y='68' fill='currentColor' style='font-size:1em'>o</text>
+<text text-anchor='middle' x='176' y='132' fill='currentColor' style='font-size:1em'>d</text>
+<text text-anchor='middle' x='184' y='4' fill='currentColor' style='font-size:1em'>p</text>
+<text text-anchor='middle' x='184' y='68' fill='currentColor' style='font-size:1em'>k</text>
+<text text-anchor='middle' x='184' y='196' fill='currentColor' style='font-size:1em'>s</text>
+<text text-anchor='middle' x='192' y='4' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='192' y='68' fill='currentColor' style='font-size:1em'>e</text>
+<text text-anchor='middle' x='192' y='132' fill='currentColor' style='font-size:1em'>w</text>
+<text text-anchor='middle' x='192' y='196' fill='currentColor' style='font-size:1em'>i</text>
+<text text-anchor='middle' x='200' y='4' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='200' y='68' fill='currentColor' style='font-size:1em'>n</text>
+<text text-anchor='middle' x='200' y='132' fill='currentColor' style='font-size:1em'>/</text>
+<text text-anchor='middle' x='200' y='196' fill='currentColor' style='font-size:1em'>g</text>
+<text text-anchor='middle' x='208' y='4' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='208' y='196' fill='currentColor' style='font-size:1em'>n</text>
+<text text-anchor='middle' x='216' y='4' fill='currentColor' style='font-size:1em'>m</text>
+<text text-anchor='middle' x='216' y='132' fill='currentColor' style='font-size:1em'>p</text>
+<text text-anchor='middle' x='216' y='196' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='224' y='4' fill='currentColor' style='font-size:1em'>s</text>
+<text text-anchor='middle' x='224' y='132' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='224' y='196' fill='currentColor' style='font-size:1em'>l</text>
+<text text-anchor='middle' x='232' y='4' fill='currentColor' style='font-size:1em'>?</text>
+<text text-anchor='middle' x='232' y='132' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='240' y='132' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='248' y='132' fill='currentColor' style='font-size:1em'>m</text>
+<text text-anchor='middle' x='256' y='132' fill='currentColor' style='font-size:1em'>s</text>
+<text text-anchor='middle' x='272' y='84' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='272' y='212' fill='currentColor' style='font-size:1em'>l</text>
+<text text-anchor='middle' x='280' y='84' fill='currentColor' style='font-size:1em'>c</text>
+<text text-anchor='middle' x='280' y='212' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='288' y='84' fill='currentColor' style='font-size:1em'>c</text>
+<text text-anchor='middle' x='288' y='212' fill='currentColor' style='font-size:1em'>s</text>
+<text text-anchor='middle' x='296' y='84' fill='currentColor' style='font-size:1em'>u</text>
+<text text-anchor='middle' x='296' y='212' fill='currentColor' style='font-size:1em'>e</text>
+<text text-anchor='middle' x='304' y='84' fill='currentColor' style='font-size:1em'>m</text>
+<text text-anchor='middle' x='304' y='212' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='312' y='84' fill='currentColor' style='font-size:1em'>u</text>
+<text text-anchor='middle' x='320' y='84' fill='currentColor' style='font-size:1em'>l</text>
+<text text-anchor='middle' x='320' y='212' fill='currentColor' style='font-size:1em'>g</text>
+<text text-anchor='middle' x='328' y='84' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='328' y='212' fill='currentColor' style='font-size:1em'>a</text>
+<text text-anchor='middle' x='336' y='84' fill='currentColor' style='font-size:1em'>t</text>
+<text text-anchor='middle' x='336' y='212' fill='currentColor' style='font-size:1em'>l</text>
+<text text-anchor='middle' x='344' y='84' fill='currentColor' style='font-size:1em'>o</text>
+<text text-anchor='middle' x='344' y='212' fill='currentColor' style='font-size:1em'>v</text>
+<text text-anchor='middle' x='352' y='84' fill='currentColor' style='font-size:1em'>r</text>
+<text text-anchor='middle' x='352' y='212' fill='currentColor' style='font-size:1em'>o</text>
+</g>
+
+ </svg>
+
+</div>
+<h2 id="source-code">Source Code</h2>
+<p>The source code for the G-code interpreter can be found
+<a href="https://git.christianermann.dev/gcode-interpreter">here</a>. You may have issues
+accessing the link if your ISP doesn’t support IPv6 yet.</p>
+<p>Also, the names in the code are different than what’s shown in the diagram, so
+here’s the mapping to help out with understanding the code:</p>
+<table>
+ <thead>
+ <tr>
+ <th style="text-align: left">Diagram</th>
+ <th style="text-align: left">Source File</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td style="text-align: left">tokenizer</td>
+ <td style="text-align: left">token.c</td>
+ </tr>
+ <tr>
+ <td style="text-align: left">accumulator</td>
+ <td style="text-align: left">command.c</td>
+ </tr>
+ <tr>
+ <td style="text-align: left">controller</td>
+ <td style="text-align: left">machine.c</td>
+ </tr>
+ </tbody>
+</table>
+<p>I’ll try to keep this updated if the mapping changes as I continue to work on
+this project.</p>
+]]></content:encoded>
+ </item>
+ </channel>
+</rss>
diff --git a/tags/matrices/index.html b/tags/matrices/index.html
@@ -0,0 +1,128 @@
+<!DOCTYPE html>
+<html lang="en-US">
+
+<head>
+ <meta http-equiv="X-Clacks-Overhead" content="GNU Terry Pratchett" />
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+<link rel="shortcut icon" href="https://electrosoup.com/favicon.png" />
+<title>Matrices | Electrosoup</title>
+<meta name="title" content="Matrices" />
+<meta name="description" content="Stuff I'm working on." />
+<meta name="author" content="" />
+<meta name="keywords" content="arm,assembly,c,forth,g-code,graphics,lasers,matrices,opengl,risc-v," />
+
+
+
+
+
+
+
+ <meta property="og:url" content="https://electrosoup.com/tags/matrices/">
+ <meta property="og:site_name" content="Electrosoup">
+ <meta property="og:title" content="Matrices">
+ <meta property="og:description" content="Stuff I'm working on.">
+ <meta property="og:locale" content="en_US">
+ <meta property="og:type" content="website">
+
+
+
+
+ <meta name="twitter:card" content="summary">
+ <meta name="twitter:title" content="Matrices">
+ <meta name="twitter:description" content="Stuff I'm working on.">
+
+
+
+
+ <meta itemprop="name" content="Matrices">
+ <meta itemprop="description" content="Stuff I'm working on.">
+ <meta itemprop="datePublished" content="2022-10-10T00:31:00-04:00">
+ <meta itemprop="dateModified" content="2022-10-10T00:31:00-04:00">
+
+
+ <link href="/herman.min.css" rel="stylesheet">
+
+
+
+
+
+ <link rel="alternate" type="application/rss+xml" href="https://electrosoup.com/tags/matrices/index.xml" title="Electrosoup" />
+
+</head>
+
+<body>
+ <header><a class="skip-link" href="#main-content">Skip to main content</a>
+
+<nav>
+ <a href="/">Main</a>
+
+ <a href="/posts/">Posts</a>
+
+ <a href="https://git.electrosoup.com">Code</a>
+
+ <a href="https://christianermann.dev">Resume</a>
+
+
+
+
+
+
+
+
+
+</nav>
+</header>
+ <main id="main-content">
+<content>
+
+ <h3 class="blog-filter">Filtering for "Matrices"</h3>
+
+ <ul class="blog-posts">
+
+ <li>
+ <span>
+ <i>
+ <time datetime='2022-10-10' pubdate>
+ 2022-10-10
+ </time>
+ </i>
+ </span>
+
+ <a href="/posts/look-at/">Understanding Camera Look-At.</a>
+
+ </li>
+
+ <li>
+ <span>
+ <i>
+ <time datetime='2021-11-21' pubdate>
+ 2021-11-21
+ </time>
+ </i>
+ </span>
+
+ <a href="/posts/view-matrix/">Deriving the View Matrix</a>
+
+ </li>
+
+ </ul>
+
+</content>
+
+ </main>
+ <footer><footer>
+
+ <a href="https://git.electrosoup.com">Code</a>.
+
+ <a href="https://christianermann.dev">Resume</a>.
+
+ <a href='https://electrosoup.com/index.xml'>RSS</a>.
+ <p>Copyright © 2026 Christian Ermann. | Made with <a href="https://github.com/clente/hugo-bearcub">Bear Cub</a></p>
+</footer>
+</footer>
+
+
+</body>
+
+</html>
diff --git a/tags/matrices/index.xml b/tags/matrices/index.xml
@@ -0,0 +1,205 @@
+<?xml version="1.0" encoding="utf-8" standalone="yes"?>
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/">
+ <channel>
+ <title>Matrices on Electrosoup</title>
+ <link>https://electrosoup.com/tags/matrices/</link>
+ <description>Recent content in Matrices on Electrosoup</description>
+ <generator>Hugo -- gohugo.io</generator>
+ <language>en-US</language>
+ <managingEditor>christianermann@gmail.com (Christian Ermann)</managingEditor>
+ <webMaster>christianermann@gmail.com (Christian Ermann)</webMaster>
+ <lastBuildDate>Mon, 10 Oct 2022 00:31:00 -0400</lastBuildDate>
+ <atom:link href="https://electrosoup.com/tags/matrices/index.xml" rel="self" type="application/rss+xml" />
+ <item>
+ <title>Understanding Camera Look-At.</title>
+ <link>https://electrosoup.com/posts/look-at/</link>
+ <pubDate>Mon, 10 Oct 2022 00:31:00 -0400</pubDate><author>christianermann@gmail.com (Christian Ermann)</author>
+ <guid>https://electrosoup.com/posts/look-at/</guid>
+ <description><p>Often times, we want to position the camera in our scene at a particular point,
such as the head of the character in a first-person shooter or the cockpit of a
plane in a flight simulator. We also want the camera to look in the direction
that the player is trying to move.</p></description>
+ <content:encoded><![CDATA[<p>Often times, we want to position the camera in our scene at a particular point,
+such as the head of the character in a first-person shooter or the cockpit of a
+plane in a flight simulator. We also want the camera to look in the direction
+that the player is trying to move.</p>
+<p>To do this, we need to find the forward, right, and up vectors that correspond
+to the desired view.</p>
+<p>If we let $\vec{p}$ be the camera’s position and $\vec{t}$ be the position of
+what we want to look at, the camera’s look direction is
+$$\vec{l}=\vec{t}-\vec{p}\,.$$
+Conventionally, the camera looks down the negative forward axis so
+$$\vec{f}=-\vec{l}\,.$$</p>
+<p>In order to determine the right vector, we need a reference up direction,
+$\vec{up}$ (which isn’t necessarily orthogonal to $\vec{f}$). This enables us
+to calculate
+$$\vec{r} = \vec{f} \times \vec{up}$$
+and
+$$\vec{u} = \vec{r} \times \vec{f}\,.$$</p>
+<p>Now we can use the camera position $\vec{p}$ and normalized forms of $\vec{f}$,
+$\vec{r}$, and $\vec{u}$ to fill in our
+<a href="/posts/view-matrix/">view matrix</a>:</p>
+<p>$$
+V
+=
+\begin{bmatrix}
+r_{x} & r_{y} & r_{z} & -(\vec{r} \cdot \vec{p}) \\
+u_{x} & u_{y} & u_{z} & -(\vec{u} \cdot \vec{p}) \\
+f_{x} & f_{y} & f_{z} & -(\vec{f} \cdot \vec{p}) \\
+0 & 0 & 0 & 1
+\end{bmatrix}
+$$</p>
+]]></content:encoded>
+ </item>
+ <item>
+ <title>Deriving the View Matrix</title>
+ <link>https://electrosoup.com/posts/view-matrix/</link>
+ <pubDate>Sun, 21 Nov 2021 13:34:08 -0800</pubDate><author>christianermann@gmail.com (Christian Ermann)</author>
+ <guid>https://electrosoup.com/posts/view-matrix/</guid>
+ <description><p>In computer graphics, the view matrix is used to transform points from
world space into camera space. Below is an explanation of how to derive this
matrix.</p></description>
+ <content:encoded><![CDATA[<p>In computer graphics, the view matrix is used to transform points from
+world space into camera space. Below is an explanation of how to derive this
+matrix.</p>
+<p>Let $V$ be the view matrix.
+If $\vec{r}$, $\vec{u}$, and $\vec{f}$ denote the right, up, and forward
+vectors of the camera and $\vec{p}$ is the camera’s position, $V$ should
+satisfy the following properties:
+$$
+\begin{matrix}
+V_{1*} \times
+\begin{bmatrix}
+r_{x} \\
+r_{y} \\
+r_{z} \\
+0
+\end{bmatrix}
+=
+\begin{bmatrix}
+1 \\
+0 \\
+0 \\
+0
+\end{bmatrix},&
+V_{2*} \times
+\begin{bmatrix}
+u_{x} \\
+u_{y} \\
+u_{z} \\
+0
+\end{bmatrix}
+=
+\begin{bmatrix}
+0 \\
+1 \\
+0 \\
+0
+\end{bmatrix},&
+V_{3*} \times
+\begin{bmatrix}
+f_{x} \\
+f_{y} \\
+f_{z} \\
+0
+\end{bmatrix}
+=
+\begin{bmatrix}
+0 \\
+0 \\
+1 \\
+0
+\end{bmatrix},&
+V_{4*} \times
+\begin{bmatrix}
+p_{x} \\
+p_{y} \\
+p_{z} \\
+1
+\end{bmatrix}
+=
+\begin{bmatrix}
+0 \\
+0 \\
+0 \\
+1
+\end{bmatrix}
+\end{matrix}
+$$
+In words, the view matrix should translate the camera to the origin and rotate
+it to align with the $\vec{x}$, $\vec{y}$, and $\vec{z}$ axes.</p>
+<p>This can be expressed more concisely as the product of two matrices:
+$$
+V \times
+\begin{bmatrix}
+r_{x} & u_{x} & f_{x} & p_{x} \\
+r_{y} & u_{y} & f_{y} & p_{y} \\
+r_{z} & u_{z} & f_{z} & p_{z} \\
+0 & 0 & 0 & 1
+\end{bmatrix}
+=
+\begin{bmatrix}
+1 & 0 & 0 & 0 \\
+0 & 1 & 0 & 0 \\
+0 & 0 & 1 & 0 \\
+0 & 0 & 0 & 1
+\end{bmatrix}
+$$</p>
+<p>To make this equation easier to solve, we can split the matrix containing our
+camera parameters into the product of a translation matrix $T$ and a rotation
+matrix $R$:
+$$
+V \times (T \times R) = I
+$$
+where
+$$
+\begin{matrix}
+T =
+\begin{bmatrix}
+1 & 0 & 0 & p_{x} \\
+0 & 1 & 0 & p_{y} \\
+0 & 0 & 1 & p_{z} \\
+0 & 0 & 0 & 1
+\end{bmatrix},&
+R =
+\begin{bmatrix}
+r_{x} & u_{x} & f_{x} & 0 \\
+r_{y} & u_{y} & f_{y} & 0 \\
+r_{z} & u_{z} & f_{z} & 0 \\
+0 & 0 & 0 & 1
+\end{bmatrix}
+\end{matrix}
+$$</p>
+<p>Solving for $V$ reveals that $V=R^{-1} \times T^{-1}$:
+$$
+V =
+\begin{bmatrix}
+r_{x} & r_{y} & r_{z} & 0 \\
+u_{x} & u_{y} & u_{z} & 0 \\
+f_{x} & f_{y} & f_{z} & 0 \\
+0 & 0 & 0 & 1
+\end{bmatrix}
+\times
+\begin{bmatrix}
+1 & 0 & 0 & -p_{x} \\
+0 & 1 & 0 & -p_{y} \\
+0 & 0 & 1 & -p_{z} \\
+0 & 0 & 0 & 1
+\end{bmatrix}
+$$</p>
+<p>And with some minor simplification,
+$$
+V
+=
+\begin{bmatrix}
+r_{x} & r_{y} & r_{z} & -(\vec{r} \cdot \vec{p}) \\
+u_{x} & u_{y} & u_{z} & -(\vec{u} \cdot \vec{p}) \\
+f_{x} & f_{y} & f_{z} & -(\vec{f} \cdot \vec{p}) \\
+0 & 0 & 0 & 1
+\end{bmatrix}
+$$</p>
+<p>When we’re ready to render our scene, we can apply $V$ to each vertex $\vec{q}$
+by calculating
+$$
+V \times \vec{q}
+$$
+in our vertex shader.</p>
+]]></content:encoded>
+ </item>
+ </channel>
+</rss>
diff --git a/tags/opengl/index.html b/tags/opengl/index.html
@@ -0,0 +1,141 @@
+<!DOCTYPE html>
+<html lang="en-US">
+
+<head>
+ <meta http-equiv="X-Clacks-Overhead" content="GNU Terry Pratchett" />
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+<link rel="shortcut icon" href="https://electrosoup.com/favicon.png" />
+<title>OpenGL | Electrosoup</title>
+<meta name="title" content="OpenGL" />
+<meta name="description" content="Stuff I'm working on." />
+<meta name="author" content="" />
+<meta name="keywords" content="arm,assembly,c,forth,g-code,graphics,lasers,matrices,opengl,risc-v," />
+
+
+
+
+
+
+
+ <meta property="og:url" content="https://electrosoup.com/tags/opengl/">
+ <meta property="og:site_name" content="Electrosoup">
+ <meta property="og:title" content="OpenGL">
+ <meta property="og:description" content="Stuff I'm working on.">
+ <meta property="og:locale" content="en_US">
+ <meta property="og:type" content="website">
+
+
+
+
+ <meta name="twitter:card" content="summary">
+ <meta name="twitter:title" content="OpenGL">
+ <meta name="twitter:description" content="Stuff I'm working on.">
+
+
+
+
+ <meta itemprop="name" content="OpenGL">
+ <meta itemprop="description" content="Stuff I'm working on.">
+ <meta itemprop="datePublished" content="2022-10-10T00:31:00-04:00">
+ <meta itemprop="dateModified" content="2022-10-10T00:31:00-04:00">
+
+
+ <link href="/herman.min.css" rel="stylesheet">
+
+
+
+
+
+ <link rel="alternate" type="application/rss+xml" href="https://electrosoup.com/tags/opengl/index.xml" title="Electrosoup" />
+
+</head>
+
+<body>
+ <header><a class="skip-link" href="#main-content">Skip to main content</a>
+
+<nav>
+ <a href="/">Main</a>
+
+ <a href="/posts/">Posts</a>
+
+ <a href="https://git.electrosoup.com">Code</a>
+
+ <a href="https://christianermann.dev">Resume</a>
+
+
+
+
+
+
+
+
+
+</nav>
+</header>
+ <main id="main-content">
+<content>
+
+ <h3 class="blog-filter">Filtering for "OpenGL"</h3>
+
+ <ul class="blog-posts">
+
+ <li>
+ <span>
+ <i>
+ <time datetime='2022-10-10' pubdate>
+ 2022-10-10
+ </time>
+ </i>
+ </span>
+
+ <a href="/posts/look-at/">Understanding Camera Look-At.</a>
+
+ </li>
+
+ <li>
+ <span>
+ <i>
+ <time datetime='2021-11-21' pubdate>
+ 2021-11-21
+ </time>
+ </i>
+ </span>
+
+ <a href="/posts/view-matrix/">Deriving the View Matrix</a>
+
+ </li>
+
+ <li>
+ <span>
+ <i>
+ <time datetime='2021-08-25' pubdate>
+ 2021-08-25
+ </time>
+ </i>
+ </span>
+
+ <a href="/posts/unbind/">Unbind Your Vertex Array Objects.</a>
+
+ </li>
+
+ </ul>
+
+</content>
+
+ </main>
+ <footer><footer>
+
+ <a href="https://git.electrosoup.com">Code</a>.
+
+ <a href="https://christianermann.dev">Resume</a>.
+
+ <a href='https://electrosoup.com/index.xml'>RSS</a>.
+ <p>Copyright © 2026 Christian Ermann. | Made with <a href="https://github.com/clente/hugo-bearcub">Bear Cub</a></p>
+</footer>
+</footer>
+
+
+</body>
+
+</html>
diff --git a/tags/opengl/index.xml b/tags/opengl/index.xml
@@ -0,0 +1,279 @@
+<?xml version="1.0" encoding="utf-8" standalone="yes"?>
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/">
+ <channel>
+ <title>OpenGL on Electrosoup</title>
+ <link>https://electrosoup.com/tags/opengl/</link>
+ <description>Recent content in OpenGL on Electrosoup</description>
+ <generator>Hugo -- gohugo.io</generator>
+ <language>en-US</language>
+ <managingEditor>christianermann@gmail.com (Christian Ermann)</managingEditor>
+ <webMaster>christianermann@gmail.com (Christian Ermann)</webMaster>
+ <lastBuildDate>Mon, 10 Oct 2022 00:31:00 -0400</lastBuildDate>
+ <atom:link href="https://electrosoup.com/tags/opengl/index.xml" rel="self" type="application/rss+xml" />
+ <item>
+ <title>Understanding Camera Look-At.</title>
+ <link>https://electrosoup.com/posts/look-at/</link>
+ <pubDate>Mon, 10 Oct 2022 00:31:00 -0400</pubDate><author>christianermann@gmail.com (Christian Ermann)</author>
+ <guid>https://electrosoup.com/posts/look-at/</guid>
+ <description><p>Often times, we want to position the camera in our scene at a particular point,
such as the head of the character in a first-person shooter or the cockpit of a
plane in a flight simulator. We also want the camera to look in the direction
that the player is trying to move.</p></description>
+ <content:encoded><![CDATA[<p>Often times, we want to position the camera in our scene at a particular point,
+such as the head of the character in a first-person shooter or the cockpit of a
+plane in a flight simulator. We also want the camera to look in the direction
+that the player is trying to move.</p>
+<p>To do this, we need to find the forward, right, and up vectors that correspond
+to the desired view.</p>
+<p>If we let $\vec{p}$ be the camera’s position and $\vec{t}$ be the position of
+what we want to look at, the camera’s look direction is
+$$\vec{l}=\vec{t}-\vec{p}\,.$$
+Conventionally, the camera looks down the negative forward axis so
+$$\vec{f}=-\vec{l}\,.$$</p>
+<p>In order to determine the right vector, we need a reference up direction,
+$\vec{up}$ (which isn’t necessarily orthogonal to $\vec{f}$). This enables us
+to calculate
+$$\vec{r} = \vec{f} \times \vec{up}$$
+and
+$$\vec{u} = \vec{r} \times \vec{f}\,.$$</p>
+<p>Now we can use the camera position $\vec{p}$ and normalized forms of $\vec{f}$,
+$\vec{r}$, and $\vec{u}$ to fill in our
+<a href="/posts/view-matrix/">view matrix</a>:</p>
+<p>$$
+V
+=
+\begin{bmatrix}
+r_{x} & r_{y} & r_{z} & -(\vec{r} \cdot \vec{p}) \\
+u_{x} & u_{y} & u_{z} & -(\vec{u} \cdot \vec{p}) \\
+f_{x} & f_{y} & f_{z} & -(\vec{f} \cdot \vec{p}) \\
+0 & 0 & 0 & 1
+\end{bmatrix}
+$$</p>
+]]></content:encoded>
+ </item>
+ <item>
+ <title>Deriving the View Matrix</title>
+ <link>https://electrosoup.com/posts/view-matrix/</link>
+ <pubDate>Sun, 21 Nov 2021 13:34:08 -0800</pubDate><author>christianermann@gmail.com (Christian Ermann)</author>
+ <guid>https://electrosoup.com/posts/view-matrix/</guid>
+ <description><p>In computer graphics, the view matrix is used to transform points from
world space into camera space. Below is an explanation of how to derive this
matrix.</p></description>
+ <content:encoded><![CDATA[<p>In computer graphics, the view matrix is used to transform points from
+world space into camera space. Below is an explanation of how to derive this
+matrix.</p>
+<p>Let $V$ be the view matrix.
+If $\vec{r}$, $\vec{u}$, and $\vec{f}$ denote the right, up, and forward
+vectors of the camera and $\vec{p}$ is the camera’s position, $V$ should
+satisfy the following properties:
+$$
+\begin{matrix}
+V_{1*} \times
+\begin{bmatrix}
+r_{x} \\
+r_{y} \\
+r_{z} \\
+0
+\end{bmatrix}
+=
+\begin{bmatrix}
+1 \\
+0 \\
+0 \\
+0
+\end{bmatrix},&
+V_{2*} \times
+\begin{bmatrix}
+u_{x} \\
+u_{y} \\
+u_{z} \\
+0
+\end{bmatrix}
+=
+\begin{bmatrix}
+0 \\
+1 \\
+0 \\
+0
+\end{bmatrix},&
+V_{3*} \times
+\begin{bmatrix}
+f_{x} \\
+f_{y} \\
+f_{z} \\
+0
+\end{bmatrix}
+=
+\begin{bmatrix}
+0 \\
+0 \\
+1 \\
+0
+\end{bmatrix},&
+V_{4*} \times
+\begin{bmatrix}
+p_{x} \\
+p_{y} \\
+p_{z} \\
+1
+\end{bmatrix}
+=
+\begin{bmatrix}
+0 \\
+0 \\
+0 \\
+1
+\end{bmatrix}
+\end{matrix}
+$$
+In words, the view matrix should translate the camera to the origin and rotate
+it to align with the $\vec{x}$, $\vec{y}$, and $\vec{z}$ axes.</p>
+<p>This can be expressed more concisely as the product of two matrices:
+$$
+V \times
+\begin{bmatrix}
+r_{x} & u_{x} & f_{x} & p_{x} \\
+r_{y} & u_{y} & f_{y} & p_{y} \\
+r_{z} & u_{z} & f_{z} & p_{z} \\
+0 & 0 & 0 & 1
+\end{bmatrix}
+=
+\begin{bmatrix}
+1 & 0 & 0 & 0 \\
+0 & 1 & 0 & 0 \\
+0 & 0 & 1 & 0 \\
+0 & 0 & 0 & 1
+\end{bmatrix}
+$$</p>
+<p>To make this equation easier to solve, we can split the matrix containing our
+camera parameters into the product of a translation matrix $T$ and a rotation
+matrix $R$:
+$$
+V \times (T \times R) = I
+$$
+where
+$$
+\begin{matrix}
+T =
+\begin{bmatrix}
+1 & 0 & 0 & p_{x} \\
+0 & 1 & 0 & p_{y} \\
+0 & 0 & 1 & p_{z} \\
+0 & 0 & 0 & 1
+\end{bmatrix},&
+R =
+\begin{bmatrix}
+r_{x} & u_{x} & f_{x} & 0 \\
+r_{y} & u_{y} & f_{y} & 0 \\
+r_{z} & u_{z} & f_{z} & 0 \\
+0 & 0 & 0 & 1
+\end{bmatrix}
+\end{matrix}
+$$</p>
+<p>Solving for $V$ reveals that $V=R^{-1} \times T^{-1}$:
+$$
+V =
+\begin{bmatrix}
+r_{x} & r_{y} & r_{z} & 0 \\
+u_{x} & u_{y} & u_{z} & 0 \\
+f_{x} & f_{y} & f_{z} & 0 \\
+0 & 0 & 0 & 1
+\end{bmatrix}
+\times
+\begin{bmatrix}
+1 & 0 & 0 & -p_{x} \\
+0 & 1 & 0 & -p_{y} \\
+0 & 0 & 1 & -p_{z} \\
+0 & 0 & 0 & 1
+\end{bmatrix}
+$$</p>
+<p>And with some minor simplification,
+$$
+V
+=
+\begin{bmatrix}
+r_{x} & r_{y} & r_{z} & -(\vec{r} \cdot \vec{p}) \\
+u_{x} & u_{y} & u_{z} & -(\vec{u} \cdot \vec{p}) \\
+f_{x} & f_{y} & f_{z} & -(\vec{f} \cdot \vec{p}) \\
+0 & 0 & 0 & 1
+\end{bmatrix}
+$$</p>
+<p>When we’re ready to render our scene, we can apply $V$ to each vertex $\vec{q}$
+by calculating
+$$
+V \times \vec{q}
+$$
+in our vertex shader.</p>
+]]></content:encoded>
+ </item>
+ <item>
+ <title>Unbind Your Vertex Array Objects.</title>
+ <link>https://electrosoup.com/posts/unbind/</link>
+ <pubDate>Wed, 25 Aug 2021 14:33:02 -0500</pubDate><author>christianermann@gmail.com (Christian Ermann)</author>
+ <guid>https://electrosoup.com/posts/unbind/</guid>
+ <description><p>When I first started learning about OpenGL, I always made sure to unbind each resource as soon as I was done using it. Over time I became more lenient with unbinding, as in many cases leaving resources bound is okay and leads to fewer API calls.</p></description>
+ <content:encoded><![CDATA[<p>When I first started learning about OpenGL, I always made sure to unbind each resource as soon as I was done using it. Over time I became more lenient with unbinding, as in many cases leaving resources bound is okay and leads to fewer API calls.</p>
+<p>In addition, when I’m developing on my PC I have access to the newer Direct State Access (DSA) functions, so binding resources isn’t something I have to worry about as much. However, I do a fair amount of programming on my macbook which means I don’t always have access to the DSA functions.</p>
+<p>I was working on a project recently that involved the vertex and index data for a mesh frequently changing. The actual mesh struct has a bit more going on, but we can think of it like this for now:</p>
+
+
+
+
+<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-c" data-lang="c"><span class="line"><span class="ln">1</span><span class="cl"><span class="k">typedef</span> <span class="k">struct</span> <span class="p">{</span>
+</span></span><span class="line"><span class="ln">2</span><span class="cl"> <span class="n">Vec3</span> <span class="o">*</span><span class="n">vertices</span><span class="p">;</span>
+</span></span><span class="line"><span class="ln">3</span><span class="cl"> <span class="n">GLuint</span> <span class="o">*</span><span class="n">indices</span><span class="p">;</span>
+</span></span><span class="line"><span class="ln">4</span><span class="cl"> <span class="n">GLuint</span> <span class="n">vao</span><span class="p">;</span>
+</span></span><span class="line"><span class="ln">5</span><span class="cl"> <span class="n">GLuint</span> <span class="n">vbo</span><span class="p">;</span>
+</span></span><span class="line"><span class="ln">6</span><span class="cl"> <span class="n">GLuint</span> <span class="n">ebo</span><span class="p">;</span>
+</span></span><span class="line"><span class="ln">7</span><span class="cl"><span class="p">}</span> <span class="n">Mesh</span><span class="p">;</span></span></span></code></pre></div>
+<p>So when it comes time to update the vertex or index data, we map the vertex buffer object to the vertices pointer and the element buffer object to the indices pointer. Then we can write all of our vertex and index data directly to the buffers, and then unmap them when we’re all done and need to draw.</p>
+
+
+
+
+<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-c" data-lang="c"><span class="line"><span class="ln"> 1</span><span class="cl"><span class="p">...</span>
+</span></span><span class="line"><span class="ln"> 2</span><span class="cl">
+</span></span><span class="line"><span class="ln"> 3</span><span class="cl"><span class="nf">glBindBuffer</span><span class="p">(</span><span class="n">GL_ARRAY_BUFFER</span><span class="p">,</span> <span class="n">mesh</span><span class="o">-></span><span class="n">vbo</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln"> 4</span><span class="cl"><span class="n">mesh</span><span class="o">-></span><span class="n">vertices</span> <span class="o">=</span> <span class="nf">glMapBuffer</span><span class="p">(</span><span class="n">GL_ARRAY_BUFFER</span><span class="p">,</span> <span class="n">GL_WRITE_ONLY</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln"> 5</span><span class="cl">
+</span></span><span class="line"><span class="ln"> 6</span><span class="cl"><span class="nf">glBindBuffer</span><span class="p">(</span><span class="n">GL_ELEMENT_ARRAY_BUFFER</span><span class="p">,</span> <span class="n">mesh</span><span class="o">-></span><span class="n">ebo</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln"> 7</span><span class="cl"><span class="n">mesh</span><span class="o">-></span><span class="n">indices</span> <span class="o">=</span> <span class="nf">glMapBuffer</span><span class="p">(</span><span class="n">GL_ELEMENT_ARRAY_BUFFER</span><span class="p">,</span> <span class="n">GL_WRITE_ONLY</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln"> 8</span><span class="cl">
+</span></span><span class="line"><span class="ln"> 9</span><span class="cl"><span class="c1">// While we have the buffers mapped, we can write data directly to
+</span></span></span><span class="line"><span class="ln">10</span><span class="cl"><span class="c1">// mesh->vertices and mesh->indices.
+</span></span></span><span class="line"><span class="ln">11</span><span class="cl"><span class="c1"></span>
+</span></span><span class="line"><span class="ln">12</span><span class="cl"><span class="nf">glBindBuffer</span><span class="p">(</span><span class="n">GL_ARRAY_BUFFER</span><span class="p">,</span> <span class="n">mesh</span><span class="o">-></span><span class="n">vbo</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln">13</span><span class="cl"><span class="nf">glUnmapBuffer</span><span class="p">(</span><span class="n">GL_ARRAY_BUFFER</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln">14</span><span class="cl"><span class="n">mesh</span><span class="o">-></span><span class="n">vertices</span> <span class="o">=</span> <span class="nb">NULL</span>
+</span></span><span class="line"><span class="ln">15</span><span class="cl">
+</span></span><span class="line"><span class="ln">16</span><span class="cl"><span class="nf">glBindBuffer</span><span class="p">(</span><span class="n">GL_ELEMENT_ARRAY_BUFFER</span><span class="p">,</span> <span class="n">mesh</span><span class="o">-></span><span class="n">ebo</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln">17</span><span class="cl"><span class="nf">glUnmapBuffer</span><span class="p">(</span><span class="n">GL_ELEMENT_ARRAY_BUFFER</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln">18</span><span class="cl"><span class="n">mesh</span><span class="o">-></span><span class="n">indices</span> <span class="o">=</span> <span class="nb">NULL</span>
+</span></span><span class="line"><span class="ln">19</span><span class="cl">
+</span></span><span class="line"><span class="ln">20</span><span class="cl"><span class="c1">// Now that the buffers are unmapped, we can draw the mesh again.
+</span></span></span><span class="line"><span class="ln">21</span><span class="cl"><span class="c1"></span>
+</span></span><span class="line"><span class="ln">22</span><span class="cl"><span class="p">...</span></span></span></code></pre></div>
+<p>Leaving the buffers bound in the above snippet didn’t cause problems and seemed a reasonable thing to do to reduce unnecessary OpenGL calls.
+The issues I was running into were actually caused by how I was drawing each mesh:</p>
+
+
+
+
+<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-c" data-lang="c"><span class="line"><span class="ln">1</span><span class="cl"><span class="p">...</span>
+</span></span><span class="line"><span class="ln">2</span><span class="cl">
+</span></span><span class="line"><span class="ln">3</span><span class="cl"><span class="nf">glBindVertexArray</span><span class="p">(</span><span class="n">mesh</span><span class="o">-></span><span class="n">vao</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln">4</span><span class="cl"><span class="nf">glDrawElements</span><span class="p">(...);</span>
+</span></span><span class="line"><span class="ln">5</span><span class="cl">
+</span></span><span class="line"><span class="ln">6</span><span class="cl"><span class="p">...</span></span></span></code></pre></div>
+<p>Since I wasn’t unbinding the mesh’s vertex array object when I finished drawing it, when I updated another mesh’s vertex or index data and bound that mesh’s buffer objects, the vertex array object I forgot to unbind would now be using the incorrect buffers to draw with.</p>
+<p>Luckily, there was a simple fix, and now I know to be more careful with unbinding vertex array objects:</p>
+
+
+
+
+<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-c" data-lang="c"><span class="line"><span class="ln">1</span><span class="cl"><span class="p">...</span>
+</span></span><span class="line"><span class="ln">2</span><span class="cl">
+</span></span><span class="line"><span class="ln">3</span><span class="cl"><span class="nf">glBindVertexArray</span><span class="p">(</span><span class="n">mesh</span><span class="o">-></span><span class="n">vao</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln">4</span><span class="cl"><span class="nf">glDrawElements</span><span class="p">(...);</span>
+</span></span><span class="line"><span class="ln">5</span><span class="cl"><span class="nf">glBindVertexArray</span><span class="p">(</span><span class="mi">0</span><span class="p">);</span>
+</span></span><span class="line"><span class="ln">6</span><span class="cl">
+</span></span><span class="line"><span class="ln">7</span><span class="cl"><span class="p">...</span></span></span></code></pre></div>
+]]></content:encoded>
+ </item>
+ </channel>
+</rss>
diff --git a/tags/risc-v/index.html b/tags/risc-v/index.html
@@ -0,0 +1,128 @@
+<!DOCTYPE html>
+<html lang="en-US">
+
+<head>
+ <meta http-equiv="X-Clacks-Overhead" content="GNU Terry Pratchett" />
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+<link rel="shortcut icon" href="https://electrosoup.com/favicon.png" />
+<title>RISC-V | Electrosoup</title>
+<meta name="title" content="RISC-V" />
+<meta name="description" content="Stuff I'm working on." />
+<meta name="author" content="" />
+<meta name="keywords" content="arm,assembly,c,forth,g-code,graphics,lasers,matrices,opengl,risc-v," />
+
+
+
+
+
+
+
+ <meta property="og:url" content="https://electrosoup.com/tags/risc-v/">
+ <meta property="og:site_name" content="Electrosoup">
+ <meta property="og:title" content="RISC-V">
+ <meta property="og:description" content="Stuff I'm working on.">
+ <meta property="og:locale" content="en_US">
+ <meta property="og:type" content="website">
+
+
+
+
+ <meta name="twitter:card" content="summary">
+ <meta name="twitter:title" content="RISC-V">
+ <meta name="twitter:description" content="Stuff I'm working on.">
+
+
+
+
+ <meta itemprop="name" content="RISC-V">
+ <meta itemprop="description" content="Stuff I'm working on.">
+ <meta itemprop="datePublished" content="2024-11-13T17:33:47-08:00">
+ <meta itemprop="dateModified" content="2024-11-13T17:33:47-08:00">
+
+
+ <link href="/herman.min.css" rel="stylesheet">
+
+
+
+
+
+ <link rel="alternate" type="application/rss+xml" href="https://electrosoup.com/tags/risc-v/index.xml" title="Electrosoup" />
+
+</head>
+
+<body>
+ <header><a class="skip-link" href="#main-content">Skip to main content</a>
+
+<nav>
+ <a href="/">Main</a>
+
+ <a href="/posts/">Posts</a>
+
+ <a href="https://git.electrosoup.com">Code</a>
+
+ <a href="https://christianermann.dev">Resume</a>
+
+
+
+
+
+
+
+
+
+</nav>
+</header>
+ <main id="main-content">
+<content>
+
+ <h3 class="blog-filter">Filtering for "RISC-V"</h3>
+
+ <ul class="blog-posts">
+
+ <li>
+ <span>
+ <i>
+ <time datetime='2024-11-13' pubdate>
+ 2024-11-13
+ </time>
+ </i>
+ </span>
+
+ <a href="/posts/forth-rv32i-assembler/">Forth RV32I Assembler</a>
+
+ </li>
+
+ <li>
+ <span>
+ <i>
+ <time datetime='2024-11-12' pubdate>
+ 2024-11-12
+ </time>
+ </i>
+ </span>
+
+ <a href="/posts/the-infamous-link-macro/">The Infamous 'link' Macro</a>
+
+ </li>
+
+ </ul>
+
+</content>
+
+ </main>
+ <footer><footer>
+
+ <a href="https://git.electrosoup.com">Code</a>.
+
+ <a href="https://christianermann.dev">Resume</a>.
+
+ <a href='https://electrosoup.com/index.xml'>RSS</a>.
+ <p>Copyright © 2026 Christian Ermann. | Made with <a href="https://github.com/clente/hugo-bearcub">Bear Cub</a></p>
+</footer>
+</footer>
+
+
+</body>
+
+</html>
diff --git a/tags/risc-v/index.xml b/tags/risc-v/index.xml
@@ -0,0 +1,286 @@
+<?xml version="1.0" encoding="utf-8" standalone="yes"?>
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/">
+ <channel>
+ <title>RISC-V on Electrosoup</title>
+ <link>https://electrosoup.com/tags/risc-v/</link>
+ <description>Recent content in RISC-V on Electrosoup</description>
+ <generator>Hugo -- gohugo.io</generator>
+ <language>en-US</language>
+ <managingEditor>christianermann@gmail.com (Christian Ermann)</managingEditor>
+ <webMaster>christianermann@gmail.com (Christian Ermann)</webMaster>
+ <lastBuildDate>Wed, 13 Nov 2024 17:33:47 -0800</lastBuildDate>
+ <atom:link href="https://electrosoup.com/tags/risc-v/index.xml" rel="self" type="application/rss+xml" />
+ <item>
+ <title>Forth RV32I Assembler</title>
+ <link>https://electrosoup.com/posts/forth-rv32i-assembler/</link>
+ <pubDate>Wed, 13 Nov 2024 17:33:47 -0800</pubDate><author>christianermann@gmail.com (Christian Ermann)</author>
+ <guid>https://electrosoup.com/posts/forth-rv32i-assembler/</guid>
+ <description><p>Here&rsquo;s an assembler for RV32I that I wrote in Forth. I find the definitions of
the instructions and instruction types especially elegant, and I find it to be
a great demonstration of how concise and powerful Forth can be.</p></description>
+ <content:encoded><![CDATA[<p>Here’s an assembler for RV32I that I wrote in Forth. I find the definitions of
+the instructions and instruction types especially elegant, and I find it to be
+a great demonstration of how concise and powerful Forth can be.</p>
+<p>All code in this post is licensed under the
+<a href="https://www.gnu.org/licenses/agpl-3.0.en.html#license-text">AGPLv3</a>.</p>
+
+
+
+
+
+<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-forth" data-lang="forth"><span class="line"><span class="ln"> 1</span><span class="cl"><span class="c1">\ encode stack values into proper instruction locations. all
+</span></span></span><span class="line"><span class="ln"> 2</span><span class="cl"><span class="c1">\ encoding sequences must begin with 'opcode'.
+</span></span></span><span class="line"><span class="ln"> 3</span><span class="cl"><span class="c1"></span><span class="kn">:</span> <span class="nc">opcode</span> <span class="k">hex </span> <span class="mi">7</span><span class="nf">F</span> <span class="k">and </span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 4</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">funct3</span> <span class="k">swap hex </span> <span class="mi">7</span> <span class="k">and decimal </span><span class="mi">12</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 5</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">funct7</span> <span class="k">swap hex </span> <span class="mi">7</span><span class="nf">F</span> <span class="k">and decimal </span><span class="mi">25</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 6</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">i-immed</span> <span class="k">swap hex </span> <span class="nf">FFF</span> <span class="k">and decimal </span><span class="mi">20</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 7</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">i-immed-shamt</span> <span class="k">swap hex </span> <span class="mi">1</span><span class="nf">F</span> <span class="k">and decimal </span><span class="mi">20</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 8</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">u-immed</span> <span class="k">swap hex </span> <span class="nf">FFFFF</span> <span class="k">and decimal </span><span class="mi">12</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 9</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">s-immed</span> <span class="k">over hex </span> <span class="nf">FE0</span> <span class="k">and decimal </span><span class="mi">20</span> <span class="k">lshift +
+</span></span></span><span class="line"><span class="ln"> 10</span><span class="cl"><span class="k"></span> <span class="k">swap hex </span> <span class="mi">1</span><span class="nf">F</span> <span class="k">and decimal </span> <span class="mi">7</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 11</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">j-immed</span> <span class="k">over hex </span><span class="mi">100000</span> <span class="k">and decimal </span><span class="mi">11</span> <span class="k">lshift +
+</span></span></span><span class="line"><span class="ln"> 12</span><span class="cl"><span class="k"></span> <span class="k">over hex </span> <span class="nf">FF000</span> <span class="k">and </span> <span class="k">+
+</span></span></span><span class="line"><span class="ln"> 13</span><span class="cl"><span class="k"></span> <span class="k">over hex </span> <span class="mi">800</span> <span class="k">and decimal </span> <span class="mi">9</span> <span class="k">lshift +
+</span></span></span><span class="line"><span class="ln"> 14</span><span class="cl"><span class="k"></span> <span class="k">swap hex </span> <span class="mi">7</span><span class="nf">FE</span> <span class="k">and decimal </span><span class="mi">20</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 15</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">b-immed</span> <span class="k">over hex </span> <span class="mi">1000</span> <span class="k">and decimal </span><span class="mi">19</span> <span class="k">lshift +
+</span></span></span><span class="line"><span class="ln"> 16</span><span class="cl"><span class="k"></span> <span class="k">over hex </span> <span class="mi">800</span> <span class="k">and decimal </span> <span class="mi">4</span> <span class="k">rshift +
+</span></span></span><span class="line"><span class="ln"> 17</span><span class="cl"><span class="k"></span> <span class="k">over hex </span> <span class="mi">7</span><span class="nf">E0</span> <span class="k">and decimal </span><span class="mi">20</span> <span class="k">lshift +
+</span></span></span><span class="line"><span class="ln"> 18</span><span class="cl"><span class="k"></span> <span class="k">swap hex </span> <span class="mi">1</span><span class="nf">E</span> <span class="k">and decimal </span> <span class="mi">7</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 19</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">rd</span> <span class="k">swap hex </span> <span class="mi">1</span><span class="nf">F</span> <span class="k">and decimal </span> <span class="mi">7</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 20</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">rs1</span> <span class="k">swap hex </span> <span class="mi">1</span><span class="nf">F</span> <span class="k">and decimal </span><span class="mi">15</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 21</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">rs2</span> <span class="k">swap hex </span> <span class="mi">1</span><span class="nf">F</span> <span class="k">and decimal </span><span class="mi">20</span> <span class="k">lshift + ;
+</span></span></span><span class="line"><span class="ln"> 22</span><span class="cl"><span class="k"></span>
+</span></span><span class="line"><span class="ln"> 23</span><span class="cl"><span class="c1">\ instruction types. all instruction values should be pushed on the
+</span></span></span><span class="line"><span class="ln"> 24</span><span class="cl"><span class="c1">\ stack with the opcode last before calling.
+</span></span></span><span class="line"><span class="ln"> 25</span><span class="cl"><span class="c1"></span><span class="kn">:</span> <span class="nc">r-type</span> <span class="nf">opcode</span> <span class="nf">funct3</span> <span class="nf">funct7</span> <span class="nf">rs2</span> <span class="nf">rs1</span> <span class="nf">rd</span> <span class="k">, ;
+</span></span></span><span class="line"><span class="ln"> 26</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">i-type</span> <span class="nf">opcode</span> <span class="nf">funct3</span> <span class="nf">i-immed</span> <span class="nf">rs1</span> <span class="nf">rd</span> <span class="k">, ;
+</span></span></span><span class="line"><span class="ln"> 27</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">i-type-shamt</span> <span class="nf">opcode</span> <span class="nf">funct3</span> <span class="nf">funct7</span> <span class="nf">i-immed-shamt</span> <span class="nf">rs1</span> <span class="nf">rd</span> <span class="k">, ;
+</span></span></span><span class="line"><span class="ln"> 28</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">s-type</span> <span class="nf">opcode</span> <span class="nf">funct3</span> <span class="nf">s-immed</span> <span class="nf">rs2</span> <span class="nf">rs1</span> <span class="k">, ;
+</span></span></span><span class="line"><span class="ln"> 29</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">b-type</span> <span class="nf">opcode</span> <span class="nf">funct3</span> <span class="nf">b-immed</span> <span class="nf">rs2</span> <span class="nf">rs1</span> <span class="k">, ;
+</span></span></span><span class="line"><span class="ln"> 30</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">u-type</span> <span class="nf">opcode</span> <span class="nf">u-immed</span> <span class="nf">rd</span> <span class="k">, ;
+</span></span></span><span class="line"><span class="ln"> 31</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">j-type</span> <span class="nf">opcode</span> <span class="nf">j-immed</span> <span class="nf">rd</span> <span class="k">, ;
+</span></span></span><span class="line"><span class="ln"> 32</span><span class="cl"><span class="k"></span>
+</span></span><span class="line"><span class="ln"> 33</span><span class="cl"><span class="c1">\ instructions. these are just simple encodings, no assembler
+</span></span></span><span class="line"><span class="ln"> 34</span><span class="cl"><span class="c1">\ niceties yet.
+</span></span></span><span class="line"><span class="ln"> 35</span><span class="cl"><span class="c1">\ funct7 funct3 opcode encoding
+</span></span></span><span class="line"><span class="ln"> 36</span><span class="cl"><span class="c1"></span><span class="kn">:</span> <span class="nc">addi,</span> <span class="k">hex </span> <span class="mi">0</span> <span class="mi">13</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 37</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">andi,</span> <span class="k">hex </span> <span class="mi">7</span> <span class="mi">13</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 38</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">ori,</span> <span class="k">hex </span> <span class="mi">6</span> <span class="mi">13</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 39</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">xori,</span> <span class="k">hex </span> <span class="mi">4</span> <span class="mi">13</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 40</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">slli,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">1</span> <span class="mi">13</span> <span class="nf">i-type-shamt</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 41</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">srli,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">5</span> <span class="mi">13</span> <span class="nf">i-type-shamt</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 42</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">srai,</span> <span class="k">hex </span> <span class="mi">20</span> <span class="mi">5</span> <span class="mi">13</span> <span class="nf">i-type-shamt</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 43</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">slti,</span> <span class="k">hex </span> <span class="mi">2</span> <span class="mi">13</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 44</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sltiu,</span> <span class="k">hex </span> <span class="mi">3</span> <span class="mi">13</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 45</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">lui,</span> <span class="k">hex </span> <span class="mi">37</span> <span class="nf">u-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 46</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">auipc,</span> <span class="k">hex </span> <span class="mi">17</span> <span class="nf">u-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 47</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">add,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">0</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 48</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sub,</span> <span class="k">hex </span> <span class="mi">20</span> <span class="mi">0</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 49</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">and,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">7</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 50</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">or,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">6</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 51</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">xor,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">4</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 52</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sll,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">1</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 53</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">srl,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">5</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 54</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sra,</span> <span class="k">hex </span> <span class="mi">20</span> <span class="mi">5</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 55</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">slt,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">2</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 56</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sltu,</span> <span class="k">hex </span> <span class="mi">00</span> <span class="mi">3</span> <span class="mi">33</span> <span class="nf">r-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 57</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">jal,</span> <span class="k">hex </span> <span class="mi">6</span><span class="nf">F</span> <span class="nf">j-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 58</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">jalr,</span> <span class="k">hex </span> <span class="mi">0</span> <span class="mi">67</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 59</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">beq,</span> <span class="k">hex </span> <span class="mi">0</span> <span class="mi">63</span> <span class="nf">b-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 60</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">bne,</span> <span class="k">hex </span> <span class="mi">1</span> <span class="mi">63</span> <span class="nf">b-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 61</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">blt,</span> <span class="k">hex </span> <span class="mi">4</span> <span class="mi">63</span> <span class="nf">b-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 62</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">bltu,</span> <span class="k">hex </span> <span class="mi">6</span> <span class="mi">63</span> <span class="nf">b-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 63</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">bge,</span> <span class="k">hex </span> <span class="mi">5</span> <span class="mi">63</span> <span class="nf">b-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 64</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">bgeu,</span> <span class="k">hex </span> <span class="mi">7</span> <span class="mi">63</span> <span class="nf">b-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 65</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">lw,</span> <span class="k">hex </span> <span class="mi">2</span> <span class="mi">03</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 66</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">lh,</span> <span class="k">hex </span> <span class="mi">1</span> <span class="mi">03</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 67</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">lhu,</span> <span class="k">hex </span> <span class="mi">5</span> <span class="mi">03</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 68</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">lb,</span> <span class="k">hex </span> <span class="mi">0</span> <span class="mi">03</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 69</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sw,</span> <span class="k">hex </span> <span class="mi">2</span> <span class="mi">23</span> <span class="nf">s-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 70</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sh,</span> <span class="k">hex </span> <span class="mi">1</span> <span class="mi">23</span> <span class="nf">s-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 71</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sb,</span> <span class="k">hex </span> <span class="mi">0</span> <span class="mi">23</span> <span class="nf">s-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 72</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">fence,</span> <span class="k">hex </span> <span class="mi">0</span> <span class="mi">0</span><span class="nf">F</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 73</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">ecall,</span> <span class="k">hex </span> <span class="mi">0</span> <span class="mi">73</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 74</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">ebreak,</span> <span class="k">hex </span> <span class="mi">0</span> <span class="mi">73</span> <span class="nf">i-type</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 75</span><span class="cl"><span class="k"></span>
+</span></span><span class="line"><span class="ln"> 76</span><span class="cl"><span class="c1">\ some instructions, now with nicer usage.
+</span></span></span><span class="line"><span class="ln"> 77</span><span class="cl"><span class="c1"></span><span class="kn">:</span> <span class="nc">sw,</span> <span class="k">>r swap r> </span><span class="nf">sw,</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 78</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sh,</span> <span class="k">>r swap r> </span><span class="nf">sh,</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 79</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">sb,</span> <span class="k">>r swap r> </span><span class="nf">sb,</span> <span class="k">;
+</span></span></span><span class="line"><span class="ln"> 80</span><span class="cl"><span class="k"></span><span class="kn">:</span> <span class="nc">ecall,</span> <span class="mi">0</span> <span class="mi">0</span> <span class="mi">0</span> <span class="nf">ecall,</span> <span class="k">; </span> <span class="c1">\ usage: ecall,
+</span></span></span><span class="line"><span class="ln"> 81</span><span class="cl"><span class="c1"></span><span class="kn">:</span> <span class="nc">ebreak,</span> <span class="mi">0</span> <span class="mi">0</span> <span class="mi">1</span> <span class="nf">ebreak,</span> <span class="k">; </span> <span class="c1">\ usage: ebreak,
+</span></span></span><span class="line"><span class="ln"> 82</span><span class="cl"><span class="c1"></span><span class="kn">:</span> <span class="nc">fence,</span> <span class="k">>r </span><span class="mi">0</span> <span class="mi">0</span> <span class="k">r> </span><span class="nf">fence,</span> <span class="k">; </span><span class="c1">\ usage: imm fence,
+</span></span></span><span class="line"><span class="ln"> 83</span><span class="cl"><span class="c1"></span>
+</span></span><span class="line"><span class="ln"> 84</span><span class="cl"><span class="c1">\ registers
+</span></span></span><span class="line"><span class="ln"> 85</span><span class="cl"><span class="c1"></span><span class="k">decimal
+</span></span></span><span class="line"><span class="ln"> 86</span><span class="cl"><span class="k"></span> <span class="mi">0</span> <span class="kn">constant</span> <span class="nc">x0</span> <span class="mi">1</span> <span class="kn">constant</span> <span class="nc">x1</span> <span class="mi">2</span> <span class="kn">constant</span> <span class="nc">x2</span> <span class="mi">3</span> <span class="kn">constant</span> <span class="nc">x3</span>
+</span></span><span class="line"><span class="ln"> 87</span><span class="cl"> <span class="mi">4</span> <span class="kn">constant</span> <span class="nc">x4</span> <span class="mi">5</span> <span class="kn">constant</span> <span class="nc">x5</span> <span class="mi">6</span> <span class="kn">constant</span> <span class="nc">x6</span> <span class="mi">7</span> <span class="kn">constant</span> <span class="nc">x7</span>
+</span></span><span class="line"><span class="ln"> 88</span><span class="cl"> <span class="mi">8</span> <span class="kn">constant</span> <span class="nc">x8</span> <span class="mi">9</span> <span class="kn">constant</span> <span class="nc">x9</span> <span class="mi">10</span> <span class="kn">constant</span> <span class="nc">x10</span> <span class="mi">11</span> <span class="kn">constant</span> <span class="nc">x11</span>
+</span></span><span class="line"><span class="ln"> 89</span><span class="cl"><span class="mi">12</span> <span class="kn">constant</span> <span class="nc">x12</span> <span class="mi">13</span> <span class="kn">constant</span> <span class="nc">x13</span> <span class="mi">14</span> <span class="kn">constant</span> <span class="nc">x14</span> <span class="mi">15</span> <span class="kn">constant</span> <span class="nc">x15</span>
+</span></span><span class="line"><span class="ln"> 90</span><span class="cl"><span class="mi">16</span> <span class="kn">constant</span> <span class="nc">x16</span> <span class="mi">17</span> <span class="kn">constant</span> <span class="nc">x17</span> <span class="mi">18</span> <span class="kn">constant</span> <span class="nc">x18</span> <span class="mi">19</span> <span class="kn">constant</span> <span class="nc">x19</span>
+</span></span><span class="line"><span class="ln"> 91</span><span class="cl"><span class="mi">20</span> <span class="kn">constant</span> <span class="nc">x20</span> <span class="mi">21</span> <span class="kn">constant</span> <span class="nc">x21</span> <span class="mi">22</span> <span class="kn">constant</span> <span class="nc">x22</span> <span class="mi">23</span> <span class="kn">constant</span> <span class="nc">x23</span>
+</span></span><span class="line"><span class="ln"> 92</span><span class="cl"><span class="mi">24</span> <span class="kn">constant</span> <span class="nc">x24</span> <span class="mi">25</span> <span class="kn">constant</span> <span class="nc">x25</span> <span class="mi">26</span> <span class="kn">constant</span> <span class="nc">x26</span> <span class="mi">27</span> <span class="kn">constant</span> <span class="nc">x27</span>
+</span></span><span class="line"><span class="ln"> 93</span><span class="cl"><span class="mi">28</span> <span class="kn">constant</span> <span class="nc">x28</span> <span class="mi">29</span> <span class="kn">constant</span> <span class="nc">x29</span> <span class="mi">30</span> <span class="kn">constant</span> <span class="nc">x30</span> <span class="mi">31</span> <span class="kn">constant</span> <span class="nc">x31</span>
+</span></span><span class="line"><span class="ln"> 94</span><span class="cl">
+</span></span><span class="line"><span class="ln"> 95</span><span class="cl"><span class="c1">\ registers (calling convention)
+</span></span></span><span class="line"><span class="ln"> 96</span><span class="cl"><span class="c1"></span><span class="nf">x0</span> <span class="kn">constant</span> <span class="nc">zero</span> <span class="c1">\ zero constant
+</span></span></span><span class="line"><span class="ln"> 97</span><span class="cl"><span class="c1"></span><span class="nf">x1</span> <span class="kn">constant</span> <span class="nc">ra</span> <span class="c1">\ return address
+</span></span></span><span class="line"><span class="ln"> 98</span><span class="cl"><span class="c1"></span><span class="nf">x2</span> <span class="kn">constant</span> <span class="nc">sp</span> <span class="c1">\ stack pointer
+</span></span></span><span class="line"><span class="ln"> 99</span><span class="cl"><span class="c1"></span><span class="nf">x3</span> <span class="kn">constant</span> <span class="nc">gp</span> <span class="c1">\ global pointer
+</span></span></span><span class="line"><span class="ln">100</span><span class="cl"><span class="c1"></span><span class="nf">x4</span> <span class="kn">constant</span> <span class="nc">tp</span> <span class="c1">\ thread pointer
+</span></span></span><span class="line"><span class="ln">101</span><span class="cl"><span class="c1"></span><span class="nf">x8</span> <span class="kn">constant</span> <span class="nc">fp</span> <span class="c1">\ frame pointer
+</span></span></span><span class="line"><span class="ln">102</span><span class="cl"><span class="c1">\ function arguments / return values (a0, a1)
+</span></span></span><span class="line"><span class="ln">103</span><span class="cl"><span class="c1"></span><span class="nf">x10</span> <span class="kn">constant</span> <span class="nc">a0</span> <span class="nf">x11</span> <span class="kn">constant</span> <span class="nc">a1</span> <span class="nf">x12</span> <span class="kn">constant</span> <span class="nc">a2</span> <span class="nf">x13</span> <span class="kn">constant</span> <span class="nc">a3</span>
+</span></span><span class="line"><span class="ln">104</span><span class="cl"><span class="nf">x14</span> <span class="kn">constant</span> <span class="nc">a4</span> <span class="nf">x15</span> <span class="kn">constant</span> <span class="nc">a5</span> <span class="nf">x16</span> <span class="kn">constant</span> <span class="nc">a6</span> <span class="nf">x17</span> <span class="kn">constant</span> <span class="nc">a7</span>
+</span></span><span class="line"><span class="ln">105</span><span class="cl"><span class="c1">\ saved registers
+</span></span></span><span class="line"><span class="ln">106</span><span class="cl"><span class="c1"></span><span class="nf">x8</span> <span class="kn">constant</span> <span class="nc">s0</span> <span class="nf">x9</span> <span class="kn">constant</span> <span class="nc">s1</span> <span class="nf">x18</span> <span class="kn">constant</span> <span class="nc">s2</span> <span class="nf">x19</span> <span class="kn">constant</span> <span class="nc">s3</span>
+</span></span><span class="line"><span class="ln">107</span><span class="cl"><span class="nf">x20</span> <span class="kn">constant</span> <span class="nc">s4</span> <span class="nf">x21</span> <span class="kn">constant</span> <span class="nc">s5</span> <span class="nf">x22</span> <span class="kn">constant</span> <span class="nc">s6</span> <span class="nf">x23</span> <span class="kn">constant</span> <span class="nc">s7</span>
+</span></span><span class="line"><span class="ln">108</span><span class="cl"><span class="nf">x24</span> <span class="kn">constant</span> <span class="nc">s8</span> <span class="nf">x25</span> <span class="kn">constant</span> <span class="nc">s9</span> <span class="nf">x26</span> <span class="kn">constant</span> <span class="nc">s10</span> <span class="nf">x27</span> <span class="kn">constant</span> <span class="nc">s11</span>
+</span></span><span class="line"><span class="ln">109</span><span class="cl"><span class="c1">\ temporaries
+</span></span></span><span class="line"><span class="ln">110</span><span class="cl"><span class="c1"></span><span class="nf">x5</span> <span class="kn">constant</span> <span class="nc">t0</span> <span class="nf">x6</span> <span class="kn">constant</span> <span class="nc">t1</span> <span class="nf">x7</span> <span class="kn">constant</span> <span class="nc">t2</span> <span class="nf">x28</span> <span class="kn">constant</span> <span class="nc">t3</span>
+</span></span><span class="line"><span class="ln">111</span><span class="cl"><span class="nf">x29</span> <span class="kn">constant</span> <span class="nc">t4</span> <span class="nf">x30</span> <span class="kn">constant</span> <span class="nc">t5</span> <span class="nf">x31</span> <span class="kn">constant</span> <span class="nc">t6</span></span></span></code></pre></div><p>And here’s some tests to verify the instruction encodings are generated
+correctly:</p>
+
+
+
+
+
+<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-forth" data-lang="forth"><span class="line"><span class="ln"> 1</span><span class="cl"><span class="kn">:</span> <span class="nc">undo,</span> <span class="mi">-1</span> <span class="k">cells allot here @ ; </span><span class="c1">\ undoes the last ','
+</span></span></span><span class="line"><span class="ln"> 2</span><span class="cl"><span class="c1"></span><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">FF</span> <span class="nf">addi,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FF58513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln"> 3</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">FF</span> <span class="nf">andi,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FF5F513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln"> 4</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">FF</span> <span class="nf">ori,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FF5E513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln"> 5</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">FF</span> <span class="nf">xori,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FF5C513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln"> 6</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">slli,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">F59513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln"> 7</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">srli,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">F5D513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln"> 8</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">srai,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">40</span><span class="nf">F5D513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln"> 9</span><span class="cl"><span class="nf">t{</span> <span class="nf">t0</span> <span class="k">hex </span><span class="nf">FFFF</span> <span class="nf">lui,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FFFF2B7</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">10</span><span class="cl"><span class="nf">t{</span> <span class="nf">t0</span> <span class="k">hex </span><span class="nf">FFFF</span> <span class="nf">auipc,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FFFF297</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">11</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">FF</span> <span class="nf">slti,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FF5A513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">12</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">FF</span> <span class="nf">sltiu,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FF5B513</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">13</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">add,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">C58533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">14</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">sub,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">40</span><span class="nf">C58533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">15</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">and,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">C5F533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">16</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">or,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">C5E533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">17</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">xor,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">C5C533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">18</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">sll,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">C59533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">19</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">srl,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">C5D533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">20</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">sra,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">40</span><span class="nf">C5D533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">21</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">slt,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">C5A533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">22</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="nf">a2</span> <span class="nf">sltu,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">C5B533</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">23</span><span class="cl"><span class="nf">t{</span> <span class="nf">ra</span> <span class="k">hex </span><span class="nf">FFFF</span> <span class="nf">jal,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">7</span><span class="nf">FF0F0EF</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">24</span><span class="cl"><span class="nf">t{</span> <span class="nf">ra</span> <span class="nf">a0</span> <span class="k">hex </span> <span class="nf">FF</span> <span class="nf">jalr,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FF500E7</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">25</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">beq,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">B50763</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">26</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">bne,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">B51763</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">27</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">blt,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">B54763</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">28</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">bltu,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">B56763</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">29</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">bge,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">B55763</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">30</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">bgeu,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">B57763</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">31</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">lw,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">F5A503</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">32</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">lh,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">F59503</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">33</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">lhu,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">F5D503</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">34</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">lb,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">F58503</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">35</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">sw,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">A5A7A3</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">36</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">sh,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">A597A3</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">37</span><span class="cl"><span class="nf">t{</span> <span class="nf">a0</span> <span class="nf">a1</span> <span class="k">hex </span> <span class="nf">F</span> <span class="nf">sb,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00</span><span class="nf">A587A3</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">38</span><span class="cl"><span class="nf">t{</span> <span class="k">hex </span> <span class="mi">0</span><span class="nf">FF</span> <span class="nf">fence,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">0</span><span class="nf">FF0000F</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">39</span><span class="cl"><span class="nf">t{</span> <span class="nf">ecall,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00000073</span> <span class="nf">}t</span>
+</span></span><span class="line"><span class="ln">40</span><span class="cl"><span class="nf">t{</span> <span class="nf">ebreak,</span> <span class="nf">undo,</span> <span class="nf">-></span> <span class="k">hex </span><span class="mi">00100073</span> <span class="err">}t</span></span></span></code></pre></div>]]></content:encoded>
+ </item>
+ <item>
+ <title>The Infamous 'link' Macro</title>
+ <link>https://electrosoup.com/posts/the-infamous-link-macro/</link>
+ <pubDate>Tue, 12 Nov 2024 13:01:09 -0800</pubDate><author>christianermann@gmail.com (Christian Ermann)</author>
+ <guid>https://electrosoup.com/posts/the-infamous-link-macro/</guid>
+ <description><p>Each word (or function, in other languages) in Forth is stored as an entry in
a linked list known as the dictionary. When bootstrapping a Forth from
assembly, it is your responsibility to create and maintain this linked list
structure. This is a tedious process and is the source of many errors when
re-arranging words or defining new words; it&rsquo;s incredibly easy to turn your
list into a graph by mistake.</p></description>
+ <content:encoded><![CDATA[<p>Each word (or function, in other languages) in Forth is stored as an entry in
+a linked list known as the dictionary. When bootstrapping a Forth from
+assembly, it is your responsibility to create and maintain this linked list
+structure. This is a tedious process and is the source of many errors when
+re-arranging words or defining new words; it’s incredibly easy to turn your
+list into a graph by mistake.</p>
+<p>In
+<a href="https://rwmj.wordpress.com/2010/08/07/jonesforth-git-repository/">jonesforth</a>,
+an x86 implementation of Forth, the assembler supports re-assigning new values
+to assembler variables. This means an assember variable can be used to store
+the memory address of the previous entry, and we have the ability to update it
+or use it whenever we need to. I used this exact strategy in my
+<a href="https://git.christianermann.dev/forth/log.html">incomplete x86 Forth</a> although
+I used <a href="https://flatassembler.net/">FASM</a> instead of
+<a href="https://wiki.osdev.org/GAS">GAS</a>. Unfortunately, GAS doesn’t support this
+feature for ARM or RISC-V targets. It may be possible to pull this off on ARM
+with the right set of relocation and/or relaxation parameters, but I was unable
+to find success with RISC-V.</p>
+<p>I did come up with an alternative set of macros that achieves the same goal
+and should be more portable than the <code>jonesforth</code> solution:</p>
+
+
+
+
+
+<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-GAS" data-lang="GAS"><span class="line"><span class="ln"> 1</span><span class="cl"><span class="na">.macro</span> <span class="no">this_link</span>
+</span></span><span class="line"><span class="ln"> 2</span><span class="cl"> <span class="na">.globl</span> <span class="no">link_</span><span class="err">\+</span>
+</span></span><span class="line"><span class="ln"> 3</span><span class="cl"><span class="nf">link_</span><span class="err">\+</span><span class="p">:</span>
+</span></span><span class="line"><span class="ln"> 4</span><span class="cl"><span class="na">.endm</span>
+</span></span><span class="line"><span class="ln"> 5</span><span class="cl">
+</span></span><span class="line"><span class="ln"> 6</span><span class="cl"><span class="na">.macro</span> <span class="no">prev_link</span>
+</span></span><span class="line"><span class="ln"> 7</span><span class="cl"> <span class="na">.int</span> <span class="no">link_</span><span class="err">\+</span>
+</span></span><span class="line"><span class="ln"> 8</span><span class="cl"><span class="na">.endm</span>
+</span></span><span class="line"><span class="ln"> 9</span><span class="cl">
+</span></span><span class="line"><span class="ln">10</span><span class="cl"><span class="na">.macro</span> <span class="no">link</span>
+</span></span><span class="line"><span class="ln">11</span><span class="cl"> <span class="nf">this_link</span>
+</span></span><span class="line"><span class="ln">12</span><span class="cl"> <span class="nf">prev_link</span>
+</span></span><span class="line"><span class="ln">13</span><span class="cl"><span class="na">.endm</span>
+</span></span><span class="line"><span class="ln">14</span><span class="cl">
+</span></span><span class="line"><span class="ln">15</span><span class="cl"><span class="nf">this_link</span></span></span></code></pre></div><p>These macros depend on the special value
+
+
+
+
+<code class="code-inline language-GAS"><span class="err">\+</span></code>.
+This value is replaced by the invocation count of the current macro during
+assembly. Since we want to
+
+
+
+
+<code class="code-inline language-GAS"><span class="nf">link</span></code>
+back to the previous word in the dictionary, we need
+
+
+
+
+<code class="code-inline language-GAS"><span class="nf">prev_link</span></code>
+to resolve to 1 word before
+
+
+
+
+<code class="code-inline language-GAS"><span class="nf">this_link</span></code>,
+which is why we call
+
+
+
+
+<code class="code-inline language-GAS"><span class="nf">this_link</span></code>
+once before defining any words.</p>
+<p>You’ll also need to add this to your linker script to null-terminate your
+dictionary, otherwise the start of your dictionary will be marked by the
+address where the
+
+
+
+
+<code class="code-inline language-GAS"><span class="nf">link_0</span></code>
+label created by
+
+
+
+
+<code class="code-inline language-GAS"><span class="nf">this_link</span></code> was stored:</p>
+
+
+
+
+
+<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-GAS" data-lang="GAS"><span class="line"><span class="ln">1</span><span class="cl"><span class="nf">link_0</span> <span class="err">=</span> <span class="mi">0</span><span class="err">;</span></span></span></code></pre></div>]]></content:encoded>
+ </item>
+ </channel>
+</rss>