From nobody Wed Oct 1 17:42:19 2025 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4ccMgv3knWz6931l for ; Wed, 01 Oct 2025 17:42:19 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4ccMgv3Jrcz3fWt; Wed, 01 Oct 2025 17:42:19 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1759340539; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=hEUhm026ZqjdaAItlfl9miyW04Fa0SQRqrnH4SH0+/Y=; b=vjzXWP6BfUijcroZ/4tPD5ObEJY4yiEXwwezRvhj8ImnqqJpg8Yq4Bcu8tv/HTEy/L82lv C6ufN3a7/wmzBk343s9cB2A5VqdoyIEMWukS54ESqTwPGCAUvLlkFVDgiVM37HGph3yaqY tSHDvRvZZaQ9kbgWy1j0VyhHQcQ3xlQsq34BpJr06lBsPjzli/JTmgqtTMExjiL6J/ZHKe AjhOVk+BuA7VCRKussfMJe/2bMj6QxA6mtrBNdlT9UsjlrcDl4DoLn4G/6Ocd+Dk/6lHY9 uWPicHErtHdqgC5xxvUElwFFpjUDlnLkdZJS61WQ6koXv8jc49WpQl6RV9bf3A== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1759340539; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=hEUhm026ZqjdaAItlfl9miyW04Fa0SQRqrnH4SH0+/Y=; b=CpmzbKbQNEvv+Ot9ibv7rpzVMBlFZp2SEjjrblh1lvIUIKd+VybtEDMbArZH3USomC8L9S nwp5W4jVIeTRFPNFtp9rGXVWBVF9PoDTALXiXSimIeIqhIF3MzdiPoBzWFcvwgzgluwZZm gz2VjpBXJJ2drQ4c7gjm4APBWHw3CaTquh+ptEhNYLLfeIwMI2wMsxKsBMa+5sr1Vv4H6Q A8jM6jPqBFmueiH0x+rH38Sz8exrHZY8tJSE/OL5hLFZ7IKcG4z2z8o9iS6foNmUBz4Vf3 IIaYr4OxZbOtcE9cwRJoFYWkUb3XtvNm5lALJzjsySBevszqAT+UeC5+TZt+6Q== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1759340539; a=rsa-sha256; cv=none; b=lM6zCMx2+VOwP3KHSm3trWJTGVu/R7Vd/jIZobyd110JCLLBBFoMBxO72uFpHsPaoUEcPH MiFA5rm58nVwL/w0MbDxPf2V1J1POOGYb7Mx9iy7HeCAkRdGE3OMiQ2TVNePaZUH7lsEfQ 2WElUjr64le/RWZgZ/qaayB9nwCNU7JCWMvTkveIoFlADV+U0sG1qNoX46hnhxYpa5rKaC 8hO+P4frzs/IhxmN4XQt6zZvhLQQ0Cnz2rKT7JO81MmPhVEC2yj2mgJwMZX7UOVs9n0aqd 2gnuUSrNc6UQn0unErFNFkKd/RX4hCyagkNfbu5FIyssqfRxoQoi0SoeJw/2vA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4ccMgv2wcSzXfy; Wed, 01 Oct 2025 17:42:19 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 591HgJSf044559; Wed, 1 Oct 2025 17:42:19 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 591HgJpk044556; Wed, 1 Oct 2025 17:42:19 GMT (envelope-from git) Date: Wed, 1 Oct 2025 17:42:19 GMT Message-Id: <202510011742.591HgJpk044556@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Alexander Ziaee Subject: git: b7fec93c52 - main - HW Relnotes template: Rework platforms for 15.0 List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: ziaee X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: b7fec93c5223610000f2e8c72be93a41903951c7 Auto-Submitted: auto-generated The branch main has been updated by ziaee: URL: https://cgit.FreeBSD.org/doc/commit/?id=b7fec93c5223610000f2e8c72be93a41903951c7 commit b7fec93c5223610000f2e8c72be93a41903951c7 Author: Alexander Ziaee AuthorDate: 2025-10-01 15:19:10 +0000 Commit: Alexander Ziaee CommitDate: 2025-10-01 17:39:15 +0000 HW Relnotes template: Rework platforms for 15.0 Increase utility of the hardware release note by using the official trade name of the architecture for it's subsection heading, followed by the hyperlinked name of the freebsd project for that architecture. In this hardware release note, I am also claiming a minimum RAM req. This rewrite removes platforms which are no longer shipping in 15.0, reorganizes the platforms subsections alpheabetically by project, rewrites the introductory paragraps for each section to accomidate for this (and past, really) reflow(s), and refreshes the powerpc subsection with information from ppc@ and the platforms page. I wish people using niche architectures to clean up their platforms pages over the next two months. There is good information in there drowning in a sea of stale info. This looks bad upon the project and is subject to getting lost in a website rewrite. Discussed with: antranigv, cperciva, dch, emaste, michaeldexter --- website/archetypes/release/hardware.adoc | 119 +++++++++++++++++-------------- 1 file changed, 67 insertions(+), 52 deletions(-) diff --git a/website/archetypes/release/hardware.adoc b/website/archetypes/release/hardware.adoc index 0de46b5649..e024c5a593 100644 --- a/website/archetypes/release/hardware.adoc +++ b/website/archetypes/release/hardware.adoc @@ -19,34 +19,28 @@ toc::[] [[intro]] == Introduction -This document contains the hardware compatibility notes for FreeBSD {localRel}. -It lists the hardware platforms supported by FreeBSD, as well as the various types of hardware devices (storage controllers, network interfaces, and so on), along with known working instances of these devices. +This hardware compatibility note describes all hardware known to work with FreeBSD {localRel}. +Other configurations may also work, but simply have not been tested yet. +Feedback, updates, and corrections to this list are encouraged! [[proc]] -== Supported Processors and System Boards +== Supported Platforms -This section provides some architecture-specific information about the specific processors and systems that are supported by each architecture. +This section describes the CPU architectures currently supported by the FreeBSD Platform projects, their support tiers, and the systems that are supported by each Platform. [[proc-amd64]] -=== 64-bit x86 (amd64) Architecture Support +=== x86-64 -FreeBSD supports the AMD64 ("Hammer") and Intel(R) EM64T architectures. -AMD64 (also known as x86-64) is a fully-supported Tier 1 architecture. -AMD64 supports all modern x86 processors. +crossref:platforms[amd64,FreeBSD/amd64] supports x86-64 as a fully-supported, crossref:committers-guide[archs,Tier-1] architecture. +Release media is expected to work on all x86-64 machines with at least 256 MiB of RAM. This release incorporates optimizations and enhancements to leverage the full capabilities of FreeBSD/amd64-based systems, delivering improved performance across a wide range of workloads. -[[proc-i386]] -=== 32-bit x86 (i386) Architecture Support - -While FreeBSD continues to evolve and optimize for modern architectures, we are committed to maintaining support for the venerable i386 (x86) architecture in this release. -Although i386 hardware is becoming less common, FreeBSD remains a reliable and versatile choice for those who still rely on it, whether for legacy systems or specific use cases. - [[proc-arm-64]] -=== 64-bit ARM (aarch64) Architecture Support +=== AArch64 -FreeBSD supports 64-bit ARM (known as arm64 or AArch64) as a Tier-1 architecture. +crossref:platforms[arm64,FreeBSD/aarch64] supports 64-bit ARM (ARMv9 and ARMv8) as a crossref:committers-guide[archs,Tier-1] architecture. -FreeBSD currently supports the following devices: +The following devices are currently supported: Ampere Computing: @@ -54,7 +48,7 @@ Ampere Computing: * Altra * eMAG -Allwinner (64-bit), more info about the support at the link:https://wiki.freebsd.org/arm/Allwinner[Allwinner Wiki page]: +link:https://wiki.freebsd.org/arm/Allwinner[Allwinner]: * Allwinner A64 SoC * A64-Olinuxino @@ -90,13 +84,13 @@ NXP Semiconductors: * SolidRun HoneyComb LX2 * Traverse Technologies Ten64 -Raspberry Pi, more info about the support at the link:https://wiki.freebsd.org/arm/Raspberry%20Pi[Raspberry Pi Wiki page]: +link:https://wiki.freebsd.org/arm/Raspberry%20Pi[Raspberry Pi]: * Raspberry Pi Zero 2 W * Raspberry Pi 3 * Raspberry Pi 4 -RockChip (64-bit), more info about the support at the link:https://wiki.freebsd.org/arm/RockChip[RockChip Wiki page]: +link:https://wiki.freebsd.org/arm/RockChip[RockChip]: * RK3328 SoC * RK3399 SoC @@ -111,14 +105,18 @@ RockChip (64-bit), more info about the support at the link:https://wiki.freebsd. * Rock64 * RockPro64 -Zedboard Zynq 7000 SoC +Zedboard: + +* Zynq 7000 SoC [[proc-arm-32]] -=== 32-bit ARM (armv6, armv7) Architecture Support +=== AArch32 -FreeBSD currently supports the following devices: +crossref:platforms[armv7,FreeBSD/armv7] supports 32-bit ARM (ARM-v7 and up) as a crossref:committers-guide[archs,Tier-2] architecture. -Allwinner (32-bit), more info about the support at the link:https://wiki.freebsd.org/arm/Allwinner[Allwinner Wiki page]: +The following devices are currently supported: + +link:https://wiki.freebsd.org/arm/Allwinner[Allwinner]: * Allwinner A10 SoC * Allwinner A13/R8 SoC @@ -144,23 +142,58 @@ Allwinner (32-bit), more info about the support at the link:https://wiki.freebsd * Orange Pi Zero * NanoPI NEO -NXP i.MX6 (32-bit), more info about the support at the link:https://wiki.freebsd.org/arm/imx6[NXP i.MX6 Wiki page]: +link:https://wiki.freebsd.org/arm/imx6[NXP i.MX6]: * Wandboard * CuBox i * HummingBoard -Raspberry Pi, more info about the support at the link:https://wiki.freebsd.org/arm/Raspberry%20Pi[Raspberry Pi Wiki page]: +link:https://wiki.freebsd.org/arm/Raspberry%20Pi[Raspberry Pi]: + +* Raspberry Pi 2 (pre v1.2) + +[[proc-powerpc]] +=== POWER + +FreeBSD supports 64-bit POWER as a crossref:committers-guide[archs,Tier-2] architecture. + +crossref:platforms[powerpc,FreeBSD/powerpc64le] supports 64-bit, bi-endian POWER9 and POWER8, including: + +IBM: + +* Power System LC922 (POWER9) +* Power System IC922 (POWER8) + +QEMU + +* PowerNV + +Raptor CS: -* Raspberry Pi 1 -* Raspberry Pi 2 -* Raspberry Pi Zero -* RPi Zero W +* Talos II (POWER9) +* Blackbird (POWER9) + +crossref:platforms[powerpc,FreeBSD/powerpc64] supports 64-bit, big-endian POWER7 through POWER4, including: + +A-EON: + +* AmigaONE X5000 (NXP QorIQ P5) + +Apple: + +* Power Mac G5 (PowerPC 970) +* Xserve G5 (PowerPC 970) + +IBM: + +* pSeries VM [[proc-risc-v]] -=== RISC-V Architecture Support +=== RISC-V + +link:https://wiki.freebsd.org/riscv[FreeBSD/riscv64] supports 64-bit RISC-V as a crossref:committers-guide[archs,Tier-2] architecture. -RISC-V support in FreeBSD represents a significant milestone in the evolution of this open-source operating system. +RISC-V support represents a significant milestone in the evolution of this open-source operating system. FreeBSD was the first operating system to have bootable in-tree support for RISC-V, underscoring its commitment to embracing emerging hardware architectures. FreeBSD currently supports the following platforms: @@ -171,20 +204,6 @@ FreeBSD currently supports the following platforms: * Spike * QEMU -More information about the support at the link:https://wiki.freebsd.org/riscv[RISC-V Wiki page]. - -[[proc-powerpc]] -=== PowerPC Architecture Support - -Many PowerPC platforms are supported, including but not limited to: - -* Apple PowerMac G4 and later. -* IBM POWER4 and later using pseries VM platform. -* IBM POWER8 and later bare metal powernv -** Most development done using Raptor TALOS-II -* Embedded NXP QorIQ and PowerQUICC III (MPC85XX, Pxxx) -** Tested on AmigaOne X5000 and AmigaOne A1222 - // The "Supported Devices" section of the release notes. // Generally processor-independent, with conditional text // inclusion handling any architecture-dependent text. @@ -214,13 +233,9 @@ Many PowerPC platforms are supported, including but not limited to: [[support]] == Supported Devices -This section describes the devices currently known to be supported by FreeBSD. -Other configurations may also work, but simply have not been tested yet. -Feedback, updates, and corrections to this list are encouraged. - -Where possible, the drivers applicable to each device or class of devices is listed. +This section describes the devices currently known to be supported by each device driver in FreeBSD. If the driver in question has a manual page in the FreeBSD base distribution (most should), it is referenced here. -Information on specific models of supported devices, controllers, etc. can be found in the manual pages. +Information on usage, configuration, and specific models of supported devices, controllers, etc. can be found in the manual pages. [NOTE] ====