progress: new assembler works, instruction set fully implemented with call/ret and push/pop, bf.dsa works which means the dsa assembly language works reliably. still a few bugs to fix. might be able to squeeze out a tiny bit more performance

2026-03-09 03:24:20 +00:00
parent fc972b9b7b
commit e01a9f2808
63 changed files with 4975 additions and 1579 deletions
@@ -0,0 +1,17 @@
+The DSA libraries form the foundation of the entire project, acting as a bridge between high‑level software and the specialized DSA hardware. Their primary responsibilities are:
+
+1. **Instruction Set Core Library**
+   - Encapsulates all architectural primitives: opcodes, operand formats, and execution semantics.
+   - Supplies utility functions to build, validate, and serialize instruction streams.
+
+2. **Assembler Support**
+   - Translates DSA assembly language into binary instruction packets that the hardware can execute.
+   - Implements directives for sectioning, alignment, and relocation handling.
+
+3. **High‑Level Language Compiler (DSC) Runtime**
+   - Generates DSA bytecode from DSC source files, leveraging the core library for instruction encoding.
+   - Offers debugging hooks, profiling counters, and exception handling mechanisms.
+
+4. **Testing & Verification Utilities**
+   - Contains unit tests that run against both emulated and real hardware to ensure correctness.
+   - Provides logging facilities for low‑level bus transactions and performance metrics.