From 0b3f9f4703034888e84ff596fb9023135b95e210 Mon Sep 17 00:00:00 2001
From: Amber Zeller <amberisvibin@users.noreply.github.com>
Date: Fri, 7 May 2021 23:02:02 -0400
Subject: [PATCH] add more detail to tech specs

---
 docs/chibi_pc-09_technical_specification.html | 37 ++++++++++++++++---
 docs/chibi_pc-09_technical_specification.md   | 24 ++++++++----
 2 files changed, 47 insertions(+), 14 deletions(-)

diff --git a/docs/chibi_pc-09_technical_specification.html b/docs/chibi_pc-09_technical_specification.html
index 71b6554..221ef8a 100644
--- a/docs/chibi_pc-09_technical_specification.html
+++ b/docs/chibi_pc-09_technical_specification.html
@@ -55,7 +55,7 @@
 <tbody>
 <tr>
 <td>0000 - 07FF</td>
-<td>First Kernel Block</td>
+<td>Kernal Root Block</td>
 </tr>
 <tr>
 <td>0800 - EFFE</td>
@@ -67,7 +67,7 @@
 </tr>
 <tr>
 <td>F7FF - FFFF</td>
-<td>Reset Vectors</td>
+<td>Vector Block</td>
 </tr>
 </tbody>
 </table>
@@ -93,7 +93,22 @@
 </tbody>
 </table>
 <h2 id="expansion-card-description">Expansion Card Description</h2>
-<p>Byte 0 of every card should contain a &#39;type&#39; descriptor.</p>
+<p>Byte 0 of every card should contain a descriptor. The structure of the descriptor is described in the following table.</p>
+<table>
+<thead>
+<tr>
+<th>Bits</th>
+<th>Descriptor</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>0-2</td>
+<td>Type</td>
+</tr>
+</tbody>
+</table>
+<h3 id="type-descriptor-table">Type Descriptor Table</h3>
 <table>
 <thead>
 <tr>
@@ -104,20 +119,30 @@
 </thead>
 <tbody>
 <tr>
-<td>00</td>
+<td>000</td>
 <td>Block Storage</td>
 <td>SD Card</td>
 </tr>
 <tr>
-<td>01</td>
+<td>001</td>
 <td>ANSI I/O Stream</td>
 <td>UART</td>
 </tr>
 <tr>
-<td>02</td>
+<td>010</td>
 <td>ANSI Compatible Graphics Device</td>
 <td>VGA64</td>
 </tr>
+<tr>
+<td>011</td>
+<td>Input Device</td>
+<td>Keyboard</td>
+</tr>
+<tr>
+<td>1xx</td>
+<td>Other</td>
+<td>Other</td>
+</tr>
 </tbody>
 </table>
 
diff --git a/docs/chibi_pc-09_technical_specification.md b/docs/chibi_pc-09_technical_specification.md
index f3dfa9a..b408148 100644
--- a/docs/chibi_pc-09_technical_specification.md
+++ b/docs/chibi_pc-09_technical_specification.md
@@ -20,10 +20,10 @@
 
 | Address Range | Description            |
 | ------------- | ---------------------- |
-| 0000 - 07FF   | First Kernel Block     |
+| 0000 - 07FF   | Kernal Root Block      |
 | 0800 - EFFE   | Standard Memory Blocks |
 | EFFF - F7FE   | I/O Block              |
-| F7FF - FFFF   | Reset Vectors          |
+| F7FF - FFFF   | Vector Block           |
 
 ## I/O Block Description
 
@@ -38,10 +38,18 @@
 
 ## Expansion Card Description
 
-Byte 0 of every card should contain a 'type' descriptor.
+Byte 0 of every card should contain a descriptor. The structure of the descriptor is described in the following table.
 
-| Type Descriptor | Description                     | Example |
-| --------------- | ------------------------------- | ------- |
-| 00              | Block Storage                   | SD Card |
-| 01              | ANSI I/O Stream                 | UART    |
-| 02              | ANSI Compatible Graphics Device | VGA64   |
+| Bits | Descriptor |
+| ---- | ---------- |
+| 0-2  | Type       |
+
+### Type Descriptor Table
+
+| Type Descriptor | Description                     | Example  |
+| --------------- | ------------------------------- | -------- |
+| 000             | Block Storage                   | SD Card  |
+| 001             | ANSI I/O Stream                 | UART     |
+| 010             | ANSI Compatible Graphics Device | VGA64    |
+| 011             | Input Device                    | Keyboard |
+| 1xx             | Other                           | Other    |