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
|
||||
Reference in New Issue
Block a user