From 810a8f665c1225897eed82c9383d6c794948ed4b Mon Sep 17 00:00:00 2001 From: Ribbon Date: Thu, 10 Oct 2024 14:17:00 +0000 Subject: [PATCH] Improve the HARDWARE.md document --- HARDWARE.md | 419 +++++++--------------------------------------------- 1 file changed, 57 insertions(+), 362 deletions(-) diff --git a/HARDWARE.md b/HARDWARE.md index cb860d3..d3e4939 100644 --- a/HARDWARE.md +++ b/HARDWARE.md @@ -2,27 +2,28 @@ This document tracks the current hardware compatibility of Redox. +- [Why hardware reports are needed?](#why-hardware-reports-are-needed) +- [What if my computer is customized?](#what-if-my-computer-is-customized) - [Status](#status) - [General](#general) - [Template](#template) -- [x86-64](#x86-64) - - [System76](#system76) - - [Dell](#dell) - - [HP](#hp) - - [ASUS](#asus) - - [Lenovo](#lenovo) - - [Toshiba](#toshiba) - - [Framework](#framework) - - [Custom](#custom) -- [i686](#i686) - - [Dell](#dell-1) - - [ASUS](#asus-1) - - [Lenovo](#lenovo-1) - - [Toshiba](#toshiba-1) - - [Panasonic](#panasonic) - - [Custom](#custom-1) -- [ARM64](#arm64) - - [Custom](#custom-2) +- [Recommended](#recommended) +- [Booting](#booting) +- [Broken](#broken) + +## Why hardware reports are needed? + +Each computer model have different hardware interface/firmware implementations and devices, which can cause the following problems: + +- Boot bugs +- Lack of device support +- Performance degradation + +These reports helps us to fix the problems above. + +## What if my computer is customized? + +You can use the "Custom" word on the "Vendor" and "Model" categories, we also recommend to add your `pciutils` log on [this](https://gitlab.redox-os.org/redox-os/drivers/-/blob/master/COMMUNITY-HW.md?ref_type=heads) document to help us with probable porting. ## Status @@ -42,351 +43,45 @@ This section cover things to consider. ## Template -You will use this template to insert your computer. - -- **Computer model** +You will use this template to insert your computer on the table. ``` -Status - (Broken, Booting or Recommended) -Redox version - 0.0.0 -Variant - (server-minimal, desktop-minimal, server, desktop, demo, dev or customized) -Image date - day-month-year - -- Additional details goes here as items +| | | | | | | | | ``` -## x86-64 - -Computers using a 64 bits Intel/AMD CPU. - -### System76 - -- **System76 Galago Pro (galp5)** - -``` -Status - Recommended -Redox version - 0.8.0 -Variant - desktop -Image date - 11-11-2022 - -- Booted using UEFI -- Boots to desktop -``` - -- **System76 Lemur Pro (lemp9)** - -``` -Status - Recommended -Redox version - 0.8.0 -Variant - desktop -Image date - 11-11-2022 - -- Booted using UEFI -- Boots to desktop -``` - -- **System76 Oryx Pro (oryp10)** - -``` -Status - Booting -Redox version - 0.8.0 -Variant - desktop -Image date - 11-11-2022 - -- Booted using UEFI -- Boots to desktop -- No touchpad support, though it should be working -``` - -- **System76 Pangolin (pang12)** - -``` -Status - Booting -Redox version - 0.8.0 -Variant - desktop -Image date - 11-11-2022 - -- Booted using UEFI -- Boots to desktop -- No touchpad support, requires I2C HID -``` - -### Dell - -- **Dell XPS 13 (9350)** - -``` -Status - Booting -Redox version - 0.8.0 -Variant - desktop -Image date - 11-11-2022 - -- Booted using both BIOS and UEFI -- Boots to desktop -- NVMe driver livelocks -``` - -### HP - -- **HP Dev One** - -``` -Status - Booting -Redox version - 0.8.0 -Variant - desktop -Image date - 11-11-2022 - -- Booted using UEFI -- Boots to desktop -- No touchpad support, requires I2C HID -``` - -- **HP EliteBook 2570p** - -``` -Status - Broken -Redox version - 0.8.0 -Variant - demo -Image date - 2022-11-23 - -- UEFI Hybrid & Native boot don't work -- Booted using 'legacy' -- Gets to resolution selection -- Fails assert in `src/os/bios/mod.rs:77` after selecting resolution -``` - -### BEELINK - -- **BEELINK U59** - -``` -Status - Broken -Redox version - 0.8.x -Variant - server -Image date - 30-05-2024 - -- Aborts after panic in xhcid -``` - -### ASUS - -- **ASUS PN41** - -``` -Status - Broken -Redox version - 0.8.x -Variant - server -Image date - 30-05-2024 - -- Aborts after panic in xhcid -``` - -- **ASUS X554L** - -``` -Status - Booting -Redox version - 0.8.0 -Variant - desktop -Image date - 11-11-2022 - -- Booted using BIOS -- Boots to desktop -- No audio, HDA driver cannot find output pins -``` - -- **ASUS ROG g55vw** - -``` -Status - Booting -Redox version - 0.8.0 -Variant - desktop -Image date - 11-11-2023 - -- Booted using BIOS -- Boots to desktop -- UEFI panic in SETUP -``` - -### Lenovo - -- **Lenovo IdeaPad Y510P** - -``` -Status - Recommended -Redox version - 0.8.0 -Variant - desktop -Image date - 11-11-2022 - -- Booted using both BIOS and UEFI -- Boots to desktop -``` - -- **Lenovo G570** - -``` -Status - Broken -Redox version - 0.8.0 -Variant - desktop -Image date - 11-11-2022 - -- Booted using BIOS -- Correct video mode not offered, this is a firmware issue -- Bootloader panics in alloc_zeroed_page_aligned -``` - -### Toshiba - -- **Toshiba Satellite L500** - -``` -Status - Booting -Redox version - 0.8.0 -Variant - desktop -Image date - 11-11-2022 - -- Booted using BIOS -- Correct video mode not offered, this is a firmware issue -- Boots to desktop -- No ethernet driver -``` - -### Framework - -- **Framework Laptop 16 (AMD Ryzen 7040 Series)** - -``` -Status - Broken -Redox version - 0.9.0 -Variant - demo, server -Image date - 07-09-2024 - -- Bootloader loaded using UEFI -- Black screen and unresponsive after the bootloader and resolution selection -``` - -### Custom - -If you have a customized computer, put it here. - -- **ASUS PRIME B350M-E** - -``` -Status - Booting -Redox version - 0.9.0 -Variant - desktop -Image date - 20-09-2024 - -- UEFI Firmware: 6203 -- Boot: UEFI, Secure Boot Off/OtherOS, USB 2.0 Flash -- PS/2 Keyboard: Partial -- PS/2 Mouse: Broken -``` - -## i686 - -Computers with a 32 bits Intel/AMD CPU. - -### Dell - -- **Dell XPS 13 (9350)** - -``` -Status - Booting -Redox version - 0.8.0 -Variant - desktop -Image date - 11-11-2022 - -- Booted using BIOS -- Boots to desktop -- NVMe driver livelocks -``` - -### ASUS - -- **ASUS Eee PC 900** - -``` -Status - Booting -Redox version - 0.8.0 -Variant - desktop -Image date - 11-11-2022 - -- Booted using BIOS -- Correct video mode not offered, this is a firmware issue -- Boots to desktop -- No ethernet driver -``` - -### Lenovo - -- **Lenovo IdeaPad Y510P** - -``` -Status - Broken -Redox version - 0.8.0 -Variant - desktop -Image date - 11-11-2022 - -- Booted using BIOS -- Panics on phys_to_virt overflow, probably having invalid mappings for 32-bit -``` - -### Toshiba - -- **Toshiba Satellite L500** - -``` -Status - Broken -Redox version - 0.8.0 -Variant - desktop -Image date - 11-11-2022 - -- Booted using BIOS -- Correct video mode not offered, this is a firmware issue -- Panics on phys_to_virt overflow, probably having invalid mappings for 32-bit -``` - -### Panasonic - -- **Panasonic Toughbook CF-18** - -``` -Status - Broken -Redox version - 0.8.0 -Variant - desktop -Image date - 11-11-2022 - -- Booted using BIOS -- Hangs after PIT initialization -``` - -### Custom - -If you have a customized computer, put it here. - - - -## ARM64 - -Computers using a 64 bits ARM CPU. - -### Raspberry Pi - -- **Raspberry Pi 3 Model B+** - -``` -Status - Booting -Redox version - 0.8.0 -Variant - server -Image date - None - -- Booted using Uboot -- Boots to UART serial console -- a bcm2835-sdhci/mmc driver -- pl011 UART -``` - -### Custom - -If you have a customized ARM board, put it here. - +## Recommended + +| **Vendor** | **Model** | **Redox Version** | **Image Date** | **Variant** | **CPU Architecture** | **Motherboard Firmware** | **Report** | +|------------|-----------|-------------------|----------------|-------------|----------------------|--------------------------|------------| +| System76 | Galago Pro (galp5) | 0.8.0 | 11-11-2022 | desktop | x86-64 | UEFI | Boots to Orbital | +| System76 | Lemur Pro (lemp9) | 0.8.0 | 11-11-2022 | desktop | x86-64 | UEFI | Boots to Orbital | +| Lenovo | IdeaPad Y510P | 0.8.0 | 11-11-2022 | desktop | x86-64 | BIOS, UEFI | Boots to Orbital | + +## Booting + +| **Vendor** | **Model** | **Redox Version** | **Image Date** | **Variant** | **CPU Architecture** | **Motherboard Firmware** | **Report** | +|------------|-----------|-------------------|----------------|-------------|----------------------|--------------------------|------------| +| System76 | Oryx Pro (oryp10) | 0.8.0 | 11-11-2022 | desktop | x86-64 | UEFI | Boots to Orbital, No touchpad support, though it should be working | +| System76 | Pangolin (pang12) | 0.8.0 | 11-11-2022 | desktop | x86-64 | UEFI | Boots to Orbital, No touchpad support, requires I2C HID | +| Dell | XPS 13 (9350) | 0.8.0 | 11-11-2022 | desktop | x86-64 | BIOS, UEFI | Boots to Orbital, NVMe driver livelocks | +| Dell | XPS 13 (9350) | 0.8.0 | 11-11-2022 | desktop | i686 | BIOS | Boots to Orbital, NVMe driver livelocks | +| HP | Dev One | 0.8.0 | 11-11-2022 | desktop | x86-64 | UEFI | Boots to Orbital, No touchpad support, requires I2C HID | +| ASUS | X554L | 0.8.0 | 11-11-2022 | desktop | x86-64 | BIOS | Boots to Orbital, No audio, HDA driver cannot find output pins | +| ASUS | ROG g55vw | 0.8.0 | 11-11-2023 | desktop | x86-64 | BIOS | Boots to Orbital, UEFI panic in SETUP | +| ASUS | PRIME B350M-E (custom) | 0.9.0 | 20-09-2024 | desktop | x86-64 | UEFI | Partial support for the PS/2 keyboard, PS/2 mouse is broken | +| ASUS | Eee PC 900 | 0.8.0 | 11-11-2022 | desktop | i686 | BIOS | Boots to Orbital, No ethernet driver, Correct video mode not offered (firmware issue) | +| Toshiba | Satellite L500 | 0.8.0 | 11-11-2022 | desktop | x86-64 | BIOS | Boots to Orbital, No ethernet driver, Correct video mode not offered (firmware issue) | +| Raspberry Pi | 3 Model B+ | 0.8.0 | Unknown | server | ARM64 | U-Boot | Boots to UART serial console (pl011) | + +## Broken + +| **Vendor** | **Model** | **Redox Version** | **Image Date** | **Variant** | **CPU Architecture** | **Motherboard Firmware** | **Report** | +|------------|-----------|-------------------|----------------|-------------|----------------------|--------------------------|------------| +| HP | EliteBook 2570p | 0.8.0 | 23-11-2022 | demo | x86-64 | BIOS (CSM mode?) | Gets to resolution selection, Fails assert in `src/os/bios/mod.rs:77` after selecting resolution | +| BEELINK | U59 | 0.8.0 | 30-05-2024 | server | x86-64 | Unknown | Aborts after panic in xhcid | +| ASUS | PN41 | 0.8.0 | 30-05-2024 | server | x86-64 | Unknown | Aborts after panic in xhcid | +| Lenovo | G570 | 0.8.0 | 11-11-2022 | desktop | x86-64 | BIOS | Bootloader panics in `alloc_zeroed_page_aligned`, Correct video mode not offered (firmware issue) | +| Lenovo | IdeaPad Y510P | 0.8.0 | 11-11-2022 | desktop | i686 | BIOS | Panics on `phys_to_virt overflow`, probably having invalid mappings for 32-bit | +| Framework | Laptop 16 (AMD Ryzen 7040 Series) | 0.9.0 | 07-09-2024 | server, demo | x86-64 | UEFI | Black screen and unresponsive after the bootloader and resolution selection | +| Toshiba | Satellite L500 | 0.8.0 | 11-11-2022 | desktop | i686 | BIOS | Correct video mode not offered (firmware issue), Panics on `phys_to_virt overflow`, probably having invalid mappings for 32-bit | +| Panasonic | Toughbook CF-18 | 0.8.0 | 11-11-2022 | desktop | i686 | BIOS | Hangs after PIT initialization |