git: ab5b8e2ce0 - main - Website - Archetypes: Upgrade hardware template for FreeBSD 14

From: Sergio Carlavilla Delgado <carlavilla_at_FreeBSD.org>
Date: Sun, 12 Nov 2023 09:20:05 UTC
The branch main has been updated by carlavilla:

URL: https://cgit.FreeBSD.org/doc/commit/?id=ab5b8e2ce0917a5881a3d7f11f863c00da8438d5

commit ab5b8e2ce0917a5881a3d7f11f863c00da8438d5
Author:     Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
AuthorDate: 2023-11-12 09:18:38 +0000
Commit:     Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
CommitDate: 2023-11-12 09:18:38 +0000

    Website - Archetypes: Upgrade hardware template for FreeBSD 14
    
    Reviewed by:            emaste@, jhb@, karels@, jhibbits@, mhorne@
    Differential Revision:  https://reviews.freebsd.org/D42117
---
 website/archetypes/release/hardware.adoc | 331 ++++++++++++++++++++++---------
 1 file changed, 240 insertions(+), 91 deletions(-)

diff --git a/website/archetypes/release/hardware.adoc b/website/archetypes/release/hardware.adoc
index 75c5e3edae..5346168d54 100644
--- a/website/archetypes/release/hardware.adoc
+++ b/website/archetypes/release/hardware.adoc
@@ -12,7 +12,7 @@ sidenav: download
 :source-highlighter: rouge
 :experimental:
 
-:release: 13.0
+:release: X.0
 
 toc::[]
 
@@ -28,93 +28,133 @@ It lists the hardware platforms supported by FreeBSD, as well as the various typ
 This section provides some architecture-specific information about the specific processors and systems that are supported by each architecture.
 
 [[proc-amd64]]
-=== amd64
+=== AMD Architecture Support (64-bit x86 (amd64))
 
-Since mid-2003 FreeBSD/amd64 has supported the AMD64 ("Hammer") and Intel(R) EM64T architecture, and is now one of the Tier-1 platforms (fully supported architecture), which are expected to be Production Quality with respects to all aspects of the FreeBSD operating system, including installation and development environments.
-
-Note that there are two names for this architecture, AMD64 (AMD) and Intel EM64T (Extended Memory 64-bit Technology).
-64-bit mode of the two architectures are almost compatible with each other, and FreeBSD/amd64 supports them both.
-
-As of this writing, the following processors are supported:
-
-* AMD Athlon(TM)64 ("Clawhammer").
-* AMD Opteron(TM) ("Sledgehammer").
-* AMD Sempron(TM).
-* AMD Turion(TM).
-* AMD Phenom(TM).
-* All multi-core Intel(R) Xeon(TM) processors except Sossaman have EM64T support.
-* The single-core Intel(R) Xeon(TM) processors "Nocona", "Irwindale", "Potomac", and "Cranford" have EM64T support.
-* All Intel(R) Core(TM) 2 (not Core(TM) Duo) and later processors
-* All Intel(R) Core(TM) i range of processors
-* All Intel(R) Pentium(R) D processors
-* All Intel(R) Centrino(R) Duo and Centrino(R) Pro platforms
-* Intel(R) Pentium(R) 4s and Celeron(R) Ds using the "Cedar Mill" core have EM64T support.
-* Some Intel(R) Pentium(R) 4s and Celeron(R) Ds using the "Prescott" core have EM64T support. See the http://processorfinder.intel.com[Intel Processor Spec Finder] for the definitive answer about EM64T support in Intel processors.
-
-Intel(R) EM64T is an extended version of IA-32 (x86) and different from Intel(R) IA-64 (Itanium) architecture.
-Some of Intel(R)'s old documentation refers to Intel(R) EM64T as "64-bit extension technology" or "IA-32e".
-
-Both Uniprocessor (UP) and Symmetric Multi-processor (SMP) configurations are supported.
-
-In many respects, FreeBSD/amd64 is similar to FreeBSD/i386, in terms of drivers supported.
-Generally, drivers that already function correctly on other 64-bit platforms should work.
+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.
+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]]
-=== i386
-
-FreeBSD/i386 runs on a wide variety of "IBM PC compatible" machines.
-Due to the wide range of hardware available for this architecture, it is impossible to exhaustively list all combinations of equipment supported by FreeBSD.
-Nevertheless, some general guidelines are presented here.
-
-Almost all i386(TM)-compatible processors with a floating point unit are supported.
-All Intel(R) processors beginning with the 80486 are supported, including the 80486, Pentium(R), Pentium(R) Pro, Pentium(R) II, Pentium(R) III, Pentium(R) 4, and variants thereof, such as the Xeon(TM) and Celeron(R) processors.
-All i386(TM)-compatible AMD processors are also supported, including the Am486(R), Am5x86(R), K5, AMD-K6(R) (and variants), AMD Athlon(TM) (including Athlon-MP, Athlon-XP, Athlon-4, and Athlon Thunderbird), and AMD Duron(TM) processors.
-The AMD &Eacute;lan SC520 embedded processor is supported.
-The Transmeta Crusoe is recognized and supported, as are i386(TM)-compatible processors from Cyrix and NexGen.
-
-There is a wide variety of motherboards available for this architecture.
-Motherboards using the ISA, VLB, EISA, AGP, and PCI expansion buses are well-supported.
-There is some limited support for the MCA ("MicroChannel") expansion bus used in the IBM PS/2 line of PCs.
-
-Symmetric multi-processor (SMP) systems are generally supported by FreeBSD, although in some cases, BIOS or motherboard bugs may generate some problems.
-Perusal of the archives of the link:{freebsd-smp} may yield some clues.
-
-FreeBSD will take advantage of SMT (Symmetric MultiThreading, also known as HyperThreading on Intel(R) CPUs) on the supported CPUs.
-The `GENERIC` kernel which is installed by default will automatically detect the additional logical processors.
-The default FreeBSD scheduler recognizes processor topology on the system and selects logical and physical processors to obtain optimal performance.
-The man:smp[4] manual page has more details.
-
-FreeBSD will take advantage of Physical Address Extensions (PAE) support on CPUs that support this feature.
-A kernel with the `PAE` feature enabled will detect memory above 4 gigabytes and allow it to be used by the system.
-This feature places constraints on the device drivers and other features of FreeBSD which may be used; consult the man:pae[4] manual page for more details.
-
-FreeBSD will generally run on i386-based laptops, albeit with varying levels of support for certain hardware features such as sound, graphics, power management, and PCCARD expansion slots.
-These features tend to vary in idiosyncratic ways between machines, and frequently require special-case support in FreeBSD to work around hardware bugs or other oddities.
-
-Most modern laptops (as well as many desktops) use the Advanced Configuration and Power Management (ACPI) standard.
-FreeBSD supports ACPI via the ACPI Component Architecture reference implementation from Intel(R), as described in the man:acpi[4] manual page.
-The use of ACPI causes instabilities on some machines and it may be necessary to disable the ACPI driver, which is normally loaded via a kernel module. 
-This may be accomplished by adding the following line to `/boot/device.hints`:
-
-[.programlisting]
-....
-hint.acpi.0.disabled="1"
-....
-
-Users debugging ACPI-related problems may find it useful to disable portions of the ACPI functionality.
-The man:acpi[4] manual page has more information on how to do this via loader tunables.
-
-ACPI depends on a Differentiated System Descriptor Table (DSDT) provided by each machine's BIOS.
-Some machines have bad or incomplete DSDTs, which prevents ACPI from functioning correctly.
-Replacement DSDTs for some machines can be found at the http://acpi.sourceforge.net/dsdt/index.php[DSDT] section of the http://acpi.sourceforge.net/[ACPI4Linux] project Web site.
-FreeBSD can use these DSDTs to override the DSDT provided by the BIOS; see the man:acpi[4] manual page for more information.
+=== 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]]
+=== ARM Architecture Support
+
+FreeBSD features robust ARM architecture support, enhancing compatibility and performance across a diverse array of ARM-based devices.
+
+[[proc-arm-64]]
+=== 64-bit ARM (aarch64)
+
+FreeBSD currently supports the following devices:
+
+Allwinner (64-bit), more info about the support at the link:https://wiki.freebsd.org/arm/Allwinner[Wiki page]:
+
+* Allwinner A64 SoC
+* A64-Olinuxino
+* Orange Pi PC2
+* Pine A64
+* Pine A64+
+* Pine A64+ 2GB
+* Pine A64-LTS
+* SOPINE
+* NanoPi A64
+* OrangePi PC2
+* NanoPI K1 Plus
+* Pine H64
+* Orange Pi 3 LTS
+
+Raspberry Pi, more info about the support at the link:https://wiki.freebsd.org/arm/Raspberry%20Pi[Wiki page]:
+
+* Raspberry Pi 3
+* Raspberry Pi 4
+
+RockChip (64-bit), more info about the support at the link:https://wiki.freebsd.org/arm/RockChip[Wiki page]:
+
+* RK3328 SoC
+* RK3399 SoC
+* NanoPC-T4
+* NanoPi R4S
+* Radxa
+* Pinebook Pro
+* Rock64
+* RockPro64
+
+Zedboard Zynq 7000 SoC
+
+[[proc-arm-32]]
+=== 32-bit ARM (armv6, armv7)
+
+FreeBSD currently supports the following devices:
+
+Allwinner (32-bit), more info about the support at the link:https://wiki.freebsd.org/arm/Allwinner[Wiki page]:
+
+* Allwinner A10 SoC
+* Allwinner A13/R8 SoC
+* Allwinner A20 SoC
+* Allwinner A31 & A31s SoC
+* Allwinner A83T SoC
+* Allwinner H3 & H2+ SoC
+* Allwinner H5 SoC
+* Allwinner H6 SoC
+* Cubieboard
+* A10-OlinuXino-Lime
+* A13-OLinuXino
+* Banana Pi
+* CubieBoard 2
+* Lamobo R1
+* Olimex A20 SOM
+* PCDuino3
+* BananaPi M3
+* Orange Pi +2E
+* OrangePi One
+* Orange Pi One Lite
+* Orange Pi PC
+* Orange Pi Zero
+* NanoPI NEO
+
+NXP i.MX6 (32-bit), more info about the support at the link:https://wiki.freebsd.org/arm/imx6[Wiki page]:
+
+* Wandboard
+* CuBox i
+* HummingBoard
+
+Raspberry Pi, more info about the support at the link:https://wiki.freebsd.org/arm/Raspberry%20Pi[Wiki page]:
+
+* Raspberry Pi 1
+* Raspberry Pi 2
+* Raspberry Pi Zero
+* RPi Zero W
+
+[[proc-risc-v]]
+=== RISC-V Architecture Support
+
+RISC-V support in FreeBSD 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:
+
+* HiFive Unleashed (SiFive FU540)
+* HiFive Unmatched (SiFive FU740)
+* Spike
+* QEMU
+
+More information about the support at the link:https://wiki.freebsd.org/riscv[Wiki page].
 
 [[proc-powerpc]]
-=== powerpc
+=== PowerPC Architecture Support
 
-All Apple PowerPC machines with built-in USB are supported, as well a limited selection of non-Apple machines, including KVM on POWER7
+Many PowerPC platforms are supported, including but not limited to:
 
-SMP is supported on all systems with more than 1 processor.
+* 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
@@ -166,6 +206,8 @@ This means that some devices, which are supported by multiple drivers, may appea
 
 &hwlist.aac;
 
+&hwlist.aacraid;
+
 &hwlist.adv;
 
 &hwlist.adw;
@@ -184,6 +226,8 @@ This means that some devices, which are supported by multiple drivers, may appea
 
 &hwlist.arcmsr;
 
+&hwlist.ata;
+
 &hwlist.bt;
 
 &hwlist.ciss;
@@ -204,6 +248,8 @@ EISA adapters are not supported.
 
 &hwlist.hptmv;
 
+&hwlist.hptnr;
+
 &hwlist.hptrr;
 
 &hwlist.ida;
@@ -228,6 +274,8 @@ EISA adapters are not supported.
 
 &hwlist.mly;
 
+&hwlist.mpi3mr;
+
 &hwlist.mpr;
 
 &hwlist.mps;
@@ -252,6 +300,8 @@ EISA adapters are not supported.
 
 &hwlist.siis;
 
+&hwlist.smartpqi;
+
 &hwlist.stg;
 
 &hwlist.sym;
@@ -282,8 +332,12 @@ The following CD-ROM type systems are supported at this time:
 
 &hwlist.age;
 
+&hwlist.alc;
+
 &hwlist.ale;
 
+&hwlist.altera_atse;
+
 &hwlist.aue;
 
 &hwlist.axe;
@@ -312,14 +366,22 @@ ASIX Electronics AX88178A/AX88179 USB Gigabit Ethernet adapters (man:axge[4] dri
 
 &hwlist.cxgbe;
 
+&hwlist.cxgbev;
+
 &hwlist.dc;
 
 &hwlist.de;
 
+&hwlist.man4.powerpc/dtsec;
+
 &hwlist.ed;
 
 &hwlist.em;
 
+FreeBSD kernel driver for Elastic Network Adapter (ENA) family (man:ena[4] driver)
+
+&hwlist.enic;
+
 &hwlist.man4.i386/ep;
 
 Agere ET1310 Gigabit Ethernet adapters (man:et[4] driver)
@@ -332,8 +394,14 @@ Agere ET1310 Gigabit Ethernet adapters (man:et[4] driver)
 
 &hwlist.gem;
 
+&hwlist.genet;
+
+Ethernet driver for Google Virtual NIC (gVNIC) (man:gve[4] driver)
+
 &hwlist.hme;
 
+&hwlist.igc;
+
 &hwlist.ipheth;
 
 &hwlist.ixgbe;
@@ -346,12 +414,24 @@ Agere ET1310 Gigabit Ethernet adapters (man:et[4] driver)
 
 &hwlist.lge;
 
+&hwlist.liquidio;
+
+&hwlist.mgb;
+
 &hwlist.mlx4en;
 
+&hwlist.mlx4ib;
+
 &hwlist.mlx5en;
 
+&hwlist.mlx5ib;
+
+&hwlist.mos;
+
 &hwlist.msk;
 
+&hwlist.muge;
+
 &hwlist.mxge;
 
 &hwlist.my;
@@ -364,6 +444,8 @@ Agere ET1310 Gigabit Ethernet adapters (man:et[4] driver)
 
 &hwlist.pcn;
 
+&hwlist.qlnxe;
+
 &hwlist.qlxgb;
 
 &hwlist.qlxgbe;
@@ -374,6 +456,8 @@ Agere ET1310 Gigabit Ethernet adapters (man:et[4] driver)
 
 &hwlist.rl;
 
+&hwlist.rtwn_usb;
+
 &hwlist.rue;
 
 &hwlist.sf;
@@ -398,12 +482,20 @@ Agere ET1310 Gigabit Ethernet adapters (man:et[4] driver)
 
 &hwlist.tl;
 
+&hwlist.man4.powerpc/tsec;
+
 [amd64, i386] SMC 83c17x (EPIC)-based Ethernet NICs (man:tx[4] driver)
 
 &hwlist.txp;
 
+&hwlist.u3g;
+
 &hwlist.udav;
 
+&hwlist.ufoma;
+
+&hwlist.uhso;
+
 &hwlist.urndis;
 
 &hwlist.vge;
@@ -420,13 +512,6 @@ Agere ET1310 Gigabit Ethernet adapters (man:et[4] driver)
 
 &hwlist.xl;
 
-[[fddi]]
-=== FDDI Interfaces
-
-[i386] DEC DEFPA PCI (man:fpa[4] driver)
-
-[i386] DEC DEFEA EISA (man:fpa[4] driver)
-
 [[wlan]]
 === Wireless Network Interfaces
 
@@ -434,6 +519,8 @@ Agere ET1310 Gigabit Ethernet adapters (man:et[4] driver)
 
 &hwlist.ath;
 
+&hwlist.ath_hal;
+
 &hwlist.bwi;
 
 &hwlist.bwn;
@@ -442,6 +529,8 @@ Agere ET1310 Gigabit Ethernet adapters (man:et[4] driver)
 
 [i386, amd64] Intel PRO/Wireless 2200BG/2915ABG MiniPCI and 2225BG PCI network adapters (man:iwi[4] driver)
 
+&hwlist.iwlwifi;
+
 [i386, amd64] Intel Dual Band Wireless AC 3160/7260/7265 IEEE 802.11ac network adapters (man:iwm[4] driver)
 
 [i386, amd64] Intel Wireless WiFi Link 4965AGN IEEE 802.11n PCI network adapters (man:iwn[4] driver)
@@ -456,6 +545,8 @@ Marvell 88W8363 IEEE 802.11n wireless network adapters (man:mwl[4] driver)
 
 &hwlist.rsu;
 
+&hwlist.rtw88;
+
 Realtek RTL8192C, RTL8188E, RTL8812A and RTL8821A based PCIe IEEE 802.11b/g/n wireless network adapters (man:rtwn[4] driver)
 
 &hwlist.rum;
@@ -541,6 +632,12 @@ Realtek RTL8192C, RTL8188E, RTL8812A and RTL8821A based PCIe IEEE 802.11b/g/n wi
 
 &hwlist.rc;
 
+&hwlist.uark;
+
+&hwlist.uchcom;
+
+&hwlist.ucycom;
+
 [[sound]]
 === Sound Devices
 
@@ -625,10 +722,26 @@ Owing to the generic nature of most USB devices, with some exceptions any device
 [amd64, i386] USB Bluetooth adapters can be found in <<bluetooth,Bluetooth>> section.
 ====
 
+Altera University Program Secure Data Card IP Core (man:altera_sdcard[4] driver)
+
+&hwlist.atp;
+
+&hwlist.atopcase;
+
+&hwlist.man4.powerpc/abtn;
+
+&hwlist.man4.powerpc/akbd;
+
+&hwlist.man4.powerpc/ams;
+
 &hwlist.ohci;
 
+&hwlist.ugold;
+
 &hwlist.uhci;
 
+&hwlist.uipaq;
+
 [amd64, i386] USB 2.0 controllers using the EHCI interface (man:ehci[4] driver)
 
 [amd64, i386] Hubs
@@ -649,6 +762,8 @@ Owing to the generic nature of most USB devices, with some exceptions any device
 
 [amd64, i386] Mice (man:ums[4] driver)
 
+&hwlist.rtsx;
+
 &hwlist.ulpt;
 
 &hwlist.ubsa;
@@ -659,12 +774,20 @@ Owing to the generic nature of most USB devices, with some exceptions any device
 
 &hwlist.uplcom;
 
+&hwlist.umcs;
+
 &hwlist.umct;
 
 [amd64, i386] Audio Devices (man:uaudio[4] driver)
 
+&hwlist.uslcom;
+
 &hwlist.uvisor;
 
+&hwlist.uvscom;
+
+&hwlist.xhci;
+
 [[firewire]]
 === IEEE 1394 (Firewire) Devices
 
@@ -682,6 +805,8 @@ Owing to the generic nature of most USB devices, with some exceptions any device
 [[crypto-accel]]
 === Cryptographic Accelerators
 
+&hwlist.ccr;
+
 &hwlist.hifn;
 
 &hwlist.safe;
@@ -702,7 +827,7 @@ Owing to the generic nature of most USB devices, with some exceptions any device
 
 [NOTE]
 ====
-Information regarding specific video cards and compatibility with Xorg can be found at http://www.x.org/[http://www.x.org/].
+Information regarding specific video cards and compatibility with Xorg can be found at link:http://www.x.org/[http://www.x.org/].
 ====
 
 [amd64, i386] Keyboards including:
@@ -721,7 +846,7 @@ Information regarding specific video cards and compatibility with Xorg can be fo
 [NOTE]
 ====
 man:moused[8] has more information on using pointing devices with FreeBSD.
-Information on using pointing devices with Xorg can be found at http://www.x.org/[http://www.x.org/].
+Information on using pointing devices with Xorg can be found at link:http://www.x.org/[http://www.x.org/].
 ====
 
 [amd64, i386] "PC standard" parallel ports (man:ppc[4] driver)
@@ -734,4 +859,28 @@ Information on using pointing devices with Xorg can be found at http://www.x.org
 * Panasonic KX-PH405
 * SII MC-P200
 
-[i386] Xilinx XC6200-based reconfigurable hardware cards compatible with the HOT1 from http://www.vcc.com/[Virtual Computers] (xrpu driver).
+[i386] Xilinx XC6200-based reconfigurable hardware cards compatible with the HOT1 from link:http://www.vcc.com/[Virtual Computers] (xrpu driver).
+
+&hwlist.ads111x;
+
+&hwlist.amdsbwd;
+
+&hwlist.at45d;
+
+&hwlist.gpioths;
+
+&hwlist.ig4;
+
+&hwlist.intpm;
+
+&hwlist.mx25l;
+
+&hwlist.netfpga10g_nf10bmac;
+
+&hwlist.ntb_hw_plx;
+
+&hwlist.ow_temp;
+
+&hwlist.sdhci;
+
+&hwlist.superio;