Files
RedBear-OS/local/docs/HARDWARE-VALIDATION-MATRIX.md
T
vasilito 80c9bccc09 docs: Add hardware validation matrix template
Define 4 hardware target classes (AMD/Intel desktop/laptop),
per-target checklist, negative-result capture format, and
quick/full test procedures. Ready for bare-metal evidence.
2026-05-20 18:56:32 +03:00

113 lines
3.3 KiB
Markdown

# Red Bear OS — Hardware Validation Matrix
**Version**: 1.0 (2026-05-20)
**Target**: 4 hardware classes minimum
**Evidence model**: Source-visible → Build-visible → QEMU-validated → Runtime-validated → Hardware-validated
---
## 1. Validation Targets
| Class | CPU | Platform | GPU | Priority |
|-------|-----|----------|-----|----------|
| A1 | AMD Desktop | Ryzen 5000/7000 | Discrete AMD/Intel | P0 |
| A2 | Intel Desktop | Core 12th-14th Gen | Integrated Intel | P0 |
| A3 | AMD Laptop | Ryzen Mobile 5000/7000 | Integrated AMD | P1 |
| A4 | Intel Laptop | Core Mobile 12th-14th Gen | Integrated Intel | P1 |
---
## 2. Per-Target Checklist
### Boot & Runtime
| Check | Validation Method | Pass Criteria |
|-------|------------------|---------------|
| Boots to login prompt | Bare metal boot | Login prompt visible within 60s |
| All CPU cores online | `dmesg` / `sys:cpu` scheme | `SMP: N CPUs online` matches physical core count |
| USB keyboard at boot | Physical test | Keyboard works in bootloader and login |
| USB storage mounts | `mount` / `df` | Mass storage device appears and mounts |
| Wired network DHCP | `ifconfig` / `dhcpd` logs | Obtains IPv4 lease within 10s |
| Temperature readable | `redbear-info` / `coretemp` scheme | Per-core temps displayed |
| Clean shutdown | `shutdown -h now` | Powers off without panic |
| Clean reboot | `reboot` | Restarts successfully |
### Subsystem Validation
| Subsystem | Check | Evidence |
|-----------|-------|----------|
| ACPI | Thermal zones readable | `/scheme/acpi/thermal/` has entries |
| ACPI | Fan status readable | `/scheme/acpi/fan/` has entries (if fans present) |
| C-states | Idle power reduction | Temperature drops 5-10C at idle vs load |
| MSI-X | Network IRQ type | `dmesg` shows "MSI-X interrupt on CPU N" |
| IOMMU | AMD-Vi initialized | `iommu` daemon logs "AMD-Vi unit N initialized" |
| Logging | Per-service logs | `/var/log/*.log` files exist and rotate |
---
## 3. Negative-Result Capture
When a target fails, record:
```
Target: <class>
Component: <subsystem>
Failure: <description>
Evidence: <log excerpt or dmesg>
Bisect: <last known good commit / config>
Workaround: <if any>
```
---
## 4. Current Status
| Target | Status | Last Tested | Blocker |
|--------|--------|-------------|---------|
| A1 | Not tested | — | No hardware |
| A2 | Not tested | — | No hardware |
| A3 | Not tested | — | No hardware |
| A4 | Not tested | — | No hardware |
**QEMU baseline**: All checklist items pass in QEMU except temperature (no MSR emulation), IOMMU (QEMU proof only), and USB storage (validated with host-seeded patterns).
---
## 5. Test Procedures
### Quick Validation (15 minutes)
```bash
# On target hardware, boot from live ISO
make live CONFIG_NAME=redbear-full
# Write ISO to USB, boot
# Check CPU cores
cat /scheme/sys/cpu
# Check temperatures
cat /scheme/coretemp/cpu0/temperature
# Check ACPI thermal zones
ls /scheme/acpi/thermal/
# Check network
ping 8.8.8.8
# Check logs
ls /var/log/
```
### Full Validation (1 hour)
```bash
# Run all quick checks
# Test USB hotplug (keyboard, storage)
# Test shutdown/reboot cycle
# Capture dmesg to external storage
```
---
*This matrix is updated as validation evidence is collected. See `COMPREHENSIVE-SYSTEM-ASSESSMENT-AND-IMPROVEMENT-PLAN.md` for the full improvement plan.*