Files
RedBear-OS/local/docs/HARDWARE-VALIDATION-MATRIX.md
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

3.3 KiB

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)

# 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)

# 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.