Merge pull request #8 from markjdb/main

Initial test of Framework 2nd Gen Event Platforms

Author: JohnAZoidberg

README.md

@@ -1,19 +1,22 @@
-# FreeBSD on Framework
+# FreeBSD on Framewok
 
 FreeBSD is not currently an officially supported Operating System on Framework
 Computer systems. This repository documents the current state of how well
 FreeBSD works on our systems and helps you set it up.
 
 ## Systems
 
-| System       | Mainboard                 | Status                              |
-|--------------| --------------------------|-------------------------------------|
-| Framework 13 | Intel 11th Gen            | Working well                        |
-| Framework 13 | Intel 12th Gen            | Working well                        |
-| Framework 13 | Intel 13th Gen            | Working well                        |
-| Framework 13 | Intel Core Ultra Series 1 | Working with DRM 6.6 (FreeBSD 15)   |
-| Framework 13 | AMD 7040 Series           | Working with DRM 6.2 (FreeBSD 14.2) |
-| Framework 16 | AMD 7040 Series           | Working with DRM 6.2 (FreeBSD 14.2) |
+| System            | Mainboard                 | Status                              |
+|-------------------| --------------------------|-------------------------------------|
+| Framework 12      | Intel 13th Gen            | Working well                        |
+| Framework 13      | Intel 11th Gen            | Working well                        |
+| Framework 13      | Intel 12th Gen            | Working well                        |
+| Framework 13      | Intel 13th Gen            | Working well                        |
+| Framework 13      | Intel Core Ultra Series 1 | Working with DRM 6.6 (FreeBSD 15)   |
+| Framework 13      | AMD 7040 Series           | Working with DRM 6.2 (FreeBSD 14.2) |
+| Framework 13      | AMD AI 300 Series         | Working, no GUI yet                 |
+| Framework 16      | AMD 7040 Series           | Working with DRM 6.2 (FreeBSD 14.2) |
+| Framework Desktop | AMD AI Max 300 Series     | Working, no GUI yet                 |
 
 ## Preparation
 
@@ -40,6 +43,9 @@ TODO: KDE on Wayland
 
 ### Generic
 
+- [ ] Framework 12 Touchpad
+- [x] Framework 13 Touchpad
+- [x] Framework 16 Touchpad
 - [x] Fingerprint Reader ([Fixes contributed by Framework](fingerprint-reader.md))
 - [ ] Ambient Light Sensor (I2C HID)
   - Work-in-progress by Framework
@@ -49,10 +55,14 @@ TODO: KDE on Wayland
 - [x] Built-in Microphone
 - [x] Headset Speaker
 - [ ] Headset Microphone
-  - [ ] AMD 13in/16in (Realtek ALC295)
+  - [ ] AMD Ryzen 7040 13in/16in (Realtek ALC295)
   - [ ] Intel 11th Gen (Realtek ALC295)
   - [x] Intel 11th-13th Gen (Tempo 92HD95B)
   - [ ] Intel Core Ultra Series 1 (Realtek ALC285)
+  - [ ] AMD Ryzen AI 300 (Realtek ALC295)
+  - [ ] Framework 12 Intel 13th Gen (Realtek ALC295)
+  - [ ] Framework Desktop - Back (Realtek ALC ALC623)
+  - [ ] Framework Desktop - Front (Realtek ALC ALC623)
 
 ### Intel Mainboards
 
@@ -79,8 +89,6 @@ TODO: KDE on Wayland
   - Working with `drm-61-kmod`
 - [ ] Suspend (S0ix)
   - Not supported yet by FreeBSD, see below
-- [x] Framework 13 Touchpad
-- [x] Framework 16 Touchpad
 
 ### Expansion Cards
 
@@ -90,18 +98,59 @@ TODO: KDE on Wayland
 - [x] SD
 - [x] SSD
 - [x] Audio
-- [x] Ethernet
-  - Currently with `cdce` driver, soon better support with `ure` driver
+- [x] Ethernet (`ure` by default and `cdce` driver)
 - [x] HDMI
   - Works with Intel GPU driver, does not work with SCFB
 - [x] DisplayPort
   - Works with Intel GPU driver, does not work with SCFB
 
-### Framework 13 Intel Core Ultra Series 1
+### Framework 13 - Intel Core Ultra Series 1
 
 The graphics driver in FreeBSD 14.1 does not work on this Intel CPU generation.
 At least DRM 6.6 is needed, which can be built with FreeBSD 15-CURRENT and [drm-kmod PR #283](https://github.com/freebsd/drm-kmod/pull/283).
 
+### Framework Desktop (AMD Ryzen AI Max 300)
+- [x] USB-A
+- [x] USB-C
+- [x] SSD
+- [ ] Ethernet (RealTek NIC, RTL8126)
+  - In-tree driver does not attach
+  - The realtek-re-kmod driver attaches, but doesn't appear to work
+- [ ] AMD GPU
+  - amdgpu 6.6 fails to attach, "Fatal error during GPU init"
+- [ ] RZ717 MediaTek WiFi
+- [ ] AMD HDA audio controller
+  - Driver attaches, untested
+- [ ] SOC Serial Console
+  - Can work with userspace (`cu`)
+  - Can't boot if trying to make kernel print to id
+
+```
+uart2: <16950 or compatible> iomem 0xfedc9000-0xfedc9fff,0xfedc7000-0xfedc7fff irq11 on acpi0
+```
+
+### Framework 12 - Intel 13th Gen
+
+- [x] Touchscreen
+- [x] Touchscreen - Stylus
+- [ ] G-Sensor (Screen Rotation)
+  - No driver yet
+- [ ] Tablet Mode
+  - No driver yet - WIP by Framework
+- [ ] Suspend
+  - Can suspend
+  - But won't wake from keyboard, touchpad or touchscreen, only power button
+  - And then after resume, immediately powers off
+- [x] Built-in Speaker
+- [x] Built-in Mic
+- [x] Audio jack speaker
+- [ ] Audio jack mic -> not showing up
+- [x] DRM driver (6.1, 6.6)
+- [ ] AX211 WiFi
+  - [x] Can scan with iwlwifi
+  - [ ] Not able to connect to networks
+- [ ] AX211 Bluetooth
+
 ## Interacting with the hardware
 
 Please refer to [Hardware Interaction](hardware-interaction.md) for details.
@@ -115,7 +164,7 @@ The commands there are especially useful for Linux users coming to FreeBSD.
   - [Workaround](https://github.com/pgj/freebsd-wifibox) by using a Linux virtual machine
 - AX210 Bluetooth not supported yet
   - https://reviews.freebsd.org/D44861
-- RZ616 not supported yet
+- RZ616, RZ717 not supported yet
   - https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=264300
 - S0ix and s2idle not supported yet
     - https://reviews.freebsd.org/D17675

installation-instructions.md

@@ -2,8 +2,11 @@
 
 ## Download and burn ISO
 
-For Framework 13 Intel Core Ultra Series 1 systems (released  Summer 2024)
-please use the latest development snapshot: [FreeBSD 15-CURRENT](https://download.freebsd.org/snapshots/amd64/amd64/ISO-IMAGES/15.0/).
+For the following systems, please use the latest development snapshot: [FreeBSD 15-CURRENT](https://download.freebsd.org/snapshots/amd64/amd64/ISO-IMAGES/15.0/).
+
+- Framework 13 - Intel Core Ultra Series 1 (Released  Summer 2024)
+- Framework 13 - AMD Ryzen AI 300 (Released Spring 2025)
+- Framework Desktop - AMD Ryzen AI Max 300 (Released Spring 2025)
 
 All other systems can use the latest stable release
 [FreeBSD 14.1](https://download.freebsd.org/ftp/releases/ISO-IMAGES/14.1/FreeBSD-14.1-RELEASE-amd64-dvd1.iso).