docs: the 12 duplicates deleted; README rewritten to the system as it is
Captain Bob's rulings, 2026-10-14: "delete" -- the duplicates listed in DELETE-CANDIDATES.md are removed (the list stays as the record; the formal tier's provenance comments repointed at the maintained copies) -- and "rewrite" the README: v2.1.0, the Tripod as Hera/Artemis/Hestia, kernel-Hermes, identities on thumbdrives, the corrected ACL overhead, 1052-test POST and the current parity line, keyboards and storage, board images carrying both systems and how to switch, and docs/README.md as the way in. The book is left as it is, to be reworked later. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
co-authored by
Claude Opus 5.5
parent
776c89457e
commit
f8fbc37698
@@ -1,84 +0,0 @@
|
||||
# LithosAnanke Hardware Abstraction Layer (HAL)
|
||||
|
||||
This directory contains HAL documentation for the LithosAnanke kernel branch.
|
||||
|
||||
> **HISTORICAL — L4Re/Fiasco.OC**: L4Re references throughout this directory's docs describe a target that was a supported platform through mid-2026. L4Re support has since been removed as an active target — `src/platform/l4re/time.c` and related `#ifdef __l4__` code are retained for reference but no longer wired into any build.
|
||||
|
||||
---
|
||||
|
||||
## Document Overview
|
||||
|
||||
| Document | Purpose |
|
||||
|----------|---------|
|
||||
| [overview.md](overview.md) | HAL architecture and design principles |
|
||||
| [interfaces.md](interfaces.md) | HAL function specifications and contracts |
|
||||
| [lithosananke-integration.md](lithosananke-integration.md) | Kernel-specific HAL implementation |
|
||||
| [platform-implementations.md](platform-implementations.md) | How to implement HAL for a platform |
|
||||
| [migration-plan.md](migration-plan.md) | Migration from hosted to kernel |
|
||||
|
||||
---
|
||||
|
||||
## Reading Order
|
||||
|
||||
1. **overview.md** — Understand why HAL exists
|
||||
2. **interfaces.md** — Learn the contracts
|
||||
3. **lithosananke-integration.md** — See kernel implementation
|
||||
4. **platform-implementations.md** — Reference implementations
|
||||
|
||||
---
|
||||
|
||||
## HAL Subsystems
|
||||
|
||||
```
|
||||
hal_time.h — Monotonic time, timers
|
||||
hal_interrupt.h — IRQ management, ISR registration
|
||||
hal_memory.h — Allocation, page mapping
|
||||
hal_console.h — Character I/O (UART, framebuffer)
|
||||
hal_cpu.h — CPU ID, relax/halt, SMP
|
||||
hal_panic.h — Fatal error handling
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Current State (lithosananke branch)
|
||||
|
||||
The HAL is **partially implemented** in LithosAnanke:
|
||||
|
||||
| Subsystem | Status | Location |
|
||||
|-----------|--------|----------|
|
||||
| Time | Implemented | `src/starkernel/arch/amd64/timer.c` |
|
||||
| Interrupts | Implemented | `src/starkernel/arch/amd64/interrupts.c` |
|
||||
| Memory | Implemented | `src/starkernel/memory/` |
|
||||
| Console | Implemented | `src/starkernel/hal/console.c` |
|
||||
| CPU | Partial | `src/starkernel/arch/amd64/apic.c` |
|
||||
| Panic | Implemented | `src/starkernel/hal/hal.c` |
|
||||
|
||||
---
|
||||
|
||||
## Relationship to Hosted StarForth
|
||||
|
||||
The HAL enables the same VM code to run on:
|
||||
|
||||
- **Linux** (hosted, POSIX)
|
||||
- **LithosAnanke** (freestanding, bare metal)
|
||||
- **L4Re** (microkernel, optional)
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────┐
|
||||
│ StarForth VM + Physics Subsystems │
|
||||
│ (platform-agnostic) │
|
||||
├─────────────────────────────────────┤
|
||||
│ HAL Layer │
|
||||
├──────────┬──────────┬───────────────┤
|
||||
│ Linux │ L4Re │ LithosAnanke │
|
||||
│ (POSIX) │ (micro) │ (kernel) │
|
||||
└──────────┴──────────┴───────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## See Also
|
||||
|
||||
- [../README.md](../README.md) — LithosAnanke overview
|
||||
- [../ROADMAP.md](../ROADMAP.md) — Milestone roadmap
|
||||
- [../M7.1.md](../M7.1.md) — Init Capsule Architecture
|
||||
File diff suppressed because it is too large
Load Diff
File diff suppressed because it is too large
Load Diff
File diff suppressed because it is too large
Load Diff
File diff suppressed because it is too large
Load Diff
File diff suppressed because it is too large
Load Diff
Reference in New Issue
Block a user