From 29827484e4cd5c1142e6c774258f4c4c9e0dab5a Mon Sep 17 00:00:00 2001 From: rigor Date: Thu, 18 Jun 2026 23:23:25 -0500 Subject: [PATCH] initial commit --- README.md | 42 ++ docs/.gitignore | 1 + docs/book.toml | 4 + docs/src/SUMMARY.md | 3 + docs/src/part_numbers.md | 0 docs/src/todo.md | 1 + sims/alu_0.sim1 | 1505 ++++++++++++++++++++++++++++++++++++++ 7 files changed, 1556 insertions(+) create mode 100644 README.md create mode 100644 docs/.gitignore create mode 100644 docs/book.toml create mode 100644 docs/src/SUMMARY.md create mode 100644 docs/src/part_numbers.md create mode 100644 docs/src/todo.md create mode 100644 sims/alu_0.sim1 diff --git a/README.md b/README.md new file mode 100644 index 0000000..591a13a --- /dev/null +++ b/README.md @@ -0,0 +1,42 @@ +# ORGComp Hardware + +## Overview + +This project is one that I started a long time ago. I started off designing it +with BJTs, and then decided to swap to FETs and got bored. + +This project is a fully custom design for a computer, designed from the +transistor level up. I am making this because I find computing *fascinating*, +and because I think it would be a cool project to show off at opensauce +sometime. + +Documentation once made will be available in the `docs` directory and may be +rendered using `mdbook`. + +Files in the `sims` directory are save files for `SimulIDE` (available in +several Linux package repositories). I will try to have some 'train of thought' +notes in text boxes in these files, and I intend to keep them as a record of +how decisions were made so I can go back and see my growth and the project's +history better. + +## Part Names + +Since I want this project to be somewhat modular to aide in abstraction, +maintenance, and debugging, I have decided to make a naming scheme that will +guarantee that parts are named in a way that is easy to find and easy to expand +and modify. + +The naming scheme I plan on using is two-fold: each part will be assigned a +name in the form `component_subcomponent_...bottom_component_vrevision` and a +5 digit part number in the form `01234` (or `01234_vrevision` if a revision is +needed). + +Examples: +- `CPU_ALU_1BitPlane_v0.1.0` +- `CPU_ALU_v1.2.5` (this would be a fully assembled set of boards making up the + ALU) +- `53281_v6.2.5` (this is a static pointer in case the naming convention + changes) + +Files will be stored using the part number as the file name, but a list of +components may be found in the docs in the file `part_numbers.md`. diff --git a/docs/.gitignore b/docs/.gitignore new file mode 100644 index 0000000..e9c0728 --- /dev/null +++ b/docs/.gitignore @@ -0,0 +1 @@ +book \ No newline at end of file diff --git a/docs/book.toml b/docs/book.toml new file mode 100644 index 0000000..8ea92ab --- /dev/null +++ b/docs/book.toml @@ -0,0 +1,4 @@ +[book] +title = "ORG Comp" +authors = ["rigor"] +language = "en" diff --git a/docs/src/SUMMARY.md b/docs/src/SUMMARY.md new file mode 100644 index 0000000..7390c82 --- /dev/null +++ b/docs/src/SUMMARY.md @@ -0,0 +1,3 @@ +# Summary + +- [Chapter 1](./chapter_1.md) diff --git a/docs/src/part_numbers.md b/docs/src/part_numbers.md new file mode 100644 index 0000000..e69de29 diff --git a/docs/src/todo.md b/docs/src/todo.md new file mode 100644 index 0000000..3e93c7c --- /dev/null +++ b/docs/src/todo.md @@ -0,0 +1 @@ +add a part number for the 1 bit alu diff --git a/sims/alu_0.sim1 b/sims/alu_0.sim1 new file mode 100644 index 0000000..74e3f60 --- /dev/null +++ b/sims/alu_0.sim1 @@ -0,0 +1,1505 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file