Annotation of www/arm64.html, Revision 1.59
1.23 bentley 1: <!doctype html>
2: <html lang=en id=platform>
3: <meta charset=utf-8>
4:
1.1 patrick 5: <title>OpenBSD/arm64</title>
6: <meta name="description" content="the OpenBSD/arm64 page">
7: <meta name="viewport" content="width=device-width, initial-scale=1">
8: <link rel="stylesheet" type="text/css" href="openbsd.css">
9: <link rel="canonical" href="https://www.openbsd.org/arm64.html">
10:
11:
1.23 bentley 12: <h2 id=OpenBSD>
1.1 patrick 13: <a href="index.html">
1.23 bentley 14: <i>Open</i><b>BSD</b></a>
15: arm64
1.1 patrick 16: </h2>
17: <hr>
18:
1.23 bentley 19: <table><tr><td>
1.1 patrick 20: <p>
21: OpenBSD/arm64 is a port of OpenBSD to various 64-bit ARM based systems.
22:
1.3 tb 23: <p>
1.1 patrick 24: A mailing list for ARM-based ports is available at
1.23 bentley 25: <a href="mailto:arm@openbsd.org">arm@openbsd.org</a>.
1.1 patrick 26: To join the OpenBSD/arm mailing list, send a message body of
27: <b>"subscribe arm"</b> to
28: <a href="mailto:majordomo@openbsd.org">majordomo@openbsd.org</a>.
29: Please be sure to check our <a href="mail.html">mailing list policy</a> before
30: subscribing.
1.23 bentley 31: </table>
1.1 patrick 32:
33: <hr>
34:
1.23 bentley 35: <h3 id="status"><strong>Current status</strong></h3>
1.1 patrick 36:
37: <p>
1.57 kettenis 38: The current target platforms are Allwinner A64/H5/H6, Amlogic
39: G12B/SM1, AMD Opteron A1100, Ampere eMAG, Apple M1/M2, Marvell ARMADA
40: 3K/7K/8K, Rockchip RK3328/RK3399(pro), Broadcom BCM2837/BCM2711
41: (Raspberry Pi 3/4) and Socionext SCA11.
1.1 patrick 42:
1.6 jsg 43: <p>
1.40 sthen 44: The install media includes firmware required to boot the Pine 64/64+,
45: Raspberry Pi 3 and Raspberry Pi 4.
1.6 jsg 46:
47: <p>
1.40 sthen 48: The Raspberry Pi boards require closed but redistributable files on the
49: system disk to load into the VC4 GPU which starts the ARM cores.
50: By default the boot ROM on Raspberry Pi 3 and older versions on
51: Raspberry Pi 4 will only try to load these files off an SD card.
1.33 jsg 52: To load the firmware off the SD card and have the root disk on USB after
1.40 sthen 53: installing OpenBSD, reboot and interrupt U-Boot before the timeout
1.7 jsg 54: expires and instruct U-Boot to prefer USB over the SD card:
55:
1.20 tj 56: <pre class="cmdbox">
1.7 jsg 57: Hit any key to stop autoboot: 0
58: U-Boot> setenv boot_targets usb0 mmc0 pxe dhcp
59: U-Boot> saveenv
60: U-Boot> boot
1.20 tj 61: </pre>
1.6 jsg 62:
63: <p>
1.40 sthen 64: Some Raspberry Pi models that do not work with the included U-Boot
65: (e.g. Raspberry Pi 400) can instead be booted using
66: <a href="https://github.com/pftf/RPi4">EDK2-based UEFI firmware</a>.
67: The simplest way to use this is to install the firmware on an SD
68: card and install the OS on USB.
1.30 kettenis 69:
70: <p>
1.50 tj 71: Apple systems need to have a UEFI environment installed before
72: OpenBSD can be booted. This can be done by running the
1.49 kettenis 73: <a href="https://asahilinux.org/2022/03/asahi-linux-alpha-release">
1.50 tj 74: Asahi Linux installer</a>. Afterwards you can boot the installer from
1.49 kettenis 75: a USB device connected to one of the type-C USB ports on the machine.
76:
77: <p>
1.25 kettenis 78: Ampere eMAG and AMD Opteron systems come with a UEFI firmware in ROM
79: and can boot off SATA or USB devices without board specific boot files
80: on the system disk.
1.12 kettenis 81:
1.6 jsg 82: <p>
1.25 kettenis 83: Most other machines load their firmware from the boot media and
84: require additional steps to create bootable install media. See the
1.21 tj 85: <a href="https://ftp.openbsd.org/pub/OpenBSD/snapshots/arm64/INSTALL.arm64">
1.12 kettenis 86: OpenBSD/arm64 snapshot installation instructions</a> for further details.
1.6 jsg 87:
1.23 bentley 88: <h3 id="hardware"><strong>Supported hardware</strong></h3>
1.1 patrick 89:
90: <p>
1.18 kettenis 91: OpenBSD/arm64 runs on the following hardware:
1.1 patrick 92:
93: <ul>
1.52 kevlo 94: <li>Allwinner A64/H5/H6
1.4 jsg 95: <ul>
1.18 kettenis 96: <li>Pine64 Pine 64/64+
1.52 kevlo 97: <li><a href="https://www.pine64.org/pine-h64-ver-b/">Pine64 H64</a>
1.36 sthen 98: <li><a href="https://www.pine64.org/pinebook/">Pine64 Pinebook</a>
99: <li><a href="https://wiki.friendlyarm.com/wiki/index.php/NanoPi_A64">NanoPi A64</a>
100: <li><a href="http://www.orangepi.org/orangepipc2/">Orange Pi PC2</a>
1.37 dtucker 101: <li><a href="http://www.orangepi.org/OrangePiZeroPlus/">Orange Pi Zero Plus</a>
1.4 jsg 102: </ul>
103: <li>AMD Opteron A1100 (Seattle)
104: <ul>
105: <li>AMD Seattle Development Board
1.5 jsg 106: <li>SoftIron OverDrive 1000
1.19 kettenis 107: <li>SoftIron OverDrive 3000
1.4 jsg 108: </ul>
1.38 kettenis 109: <li>Amlogic G12B/SM1
1.25 kettenis 110: <ul>
1.36 sthen 111: <li><a href="https://www.hardkernel.com/shop/odroid-n2-with-4gbyte-ram/">Hardkernel ODROID-N2</a>
1.38 kettenis 112: <li><a href="https://www.hardkernel.com/shop/odroid-c4/">Hardkernel ODROID-C4</a>
113: <li><a href="https://www.hardkernel.com/shop/odroid-hc4/">Hardkernel ODROID-HC4</a>
1.25 kettenis 114: </ul>
115: <li>Ampere eMAG
116: <ul>
117: <li>Lenovo ThinkSystem HR330A
118: <li>Lenovo ThinkSystem HR350A
119: </ul>
1.55 kettenis 120: <li>Ampere Altra
121: <ul>
122: <li>GIGABYTE R152-P30/31/32
123: <li>GIGABYTE E252-P30/31
124: <li>GIGABYTE R272-P30/31/32/33
125: </ul>
1.57 kettenis 126: <li>Apple M1/M2
1.48 kettenis 127: <ul>
128: <li>Apple Mac mini (M1, 2020)
1.57 kettenis 129: <li>Apple MacBook Air (M1, 2020)
1.48 kettenis 130: <li>Apple MacBook Pro (13-inch, M1, 2020)
131: <li>Apple iMac (24-inch, M1, 2021)
132: <li>Apple MacBook Pro (14-inch, M1 Pro/Max, 2021)
133: <li>Apple MacBook Pro (16-inch, M1 Pro/Max, 2021)
1.56 kettenis 134: <li>Apple Studio (M1 Max/Ultra, 2022)
1.57 kettenis 135: <li>Apple MacBook Air (M2, 2022)
136: <li>Apple MacBook Pro (13-inch, M2, 2022)
1.48 kettenis 137: </ul>
1.30 kettenis 138: <li>Broadcom BCM2837/BCM2711
1.4 jsg 139: <ul>
1.36 sthen 140: <li><a href="https://www.raspberrypi.org/products/raspberry-pi-3-model-b/">Raspberry Pi 3</a>
1.40 sthen 141: <li><a href="https://www.raspberrypi.org/products/raspberry-pi-3-model-b-plus/">Raspberry Pi 3 Model B+</a>
1.36 sthen 142: <li><a href="https://www.raspberrypi.org/products/raspberry-pi-4-model-b/specifications/">Raspberry Pi 4</a>
1.40 sthen 143: <li><a href="https://www.raspberrypi.org/products/raspberry-pi-400-unit/">Raspberry Pi 400</a>
1.46 kettenis 144: <li><a href="https://www.raspberrypi.com/products/compute-module-4/">Raspberry Pi Compute Module 4</a>
1.4 jsg 145: </ul>
1.43 kettenis 146: <li>Marvell ARMADA 3K
147: <ul>
148: <li><a href="https://www.turris.com/en/mox/">Turris MOX</a>
1.54 kettenis 149: <li><a href="https://espressobin.net/">Marvell ESPRESSObin</a>
150: <li><a href="https://www.gl-inet.com/products/gl-mv1000/">GL.iNet Brume</a>
1.43 kettenis 151: </ul>
1.19 kettenis 152: <li>Marvell ARMADA 7K/8K
153: <ul>
1.36 sthen 154: <li><a href="https://www.solid-run.com/marvell-armada-family/macchiatobin/">SolidRun/Marvell MACCHIATObin</a>
1.19 kettenis 155: </ul>
1.59 ! jsg 156: <li>Qualcomm Snapdragon 8cx Gen 3 (SC8280XP)
1.58 kettenis 157: <ul>
1.59 ! jsg 158: <li>Lenovo ThinkPad X13s Gen 1</a>
1.58 kettenis 159: </ul>
1.42 kurt 160: <li>Rockchip RK3328/RK3399(pro)
1.9 kettenis 161: <ul>
1.36 sthen 162: <li><a href="https://www.pine64.org/devices/single-board-computers/rock64/">Pine64 ROCK64</a>
163: <li><a href="https://www.pine64.org/rockpro64/">Pine64 ROCKPro64</a>
164: <li><a href="https://www.pine64.org/pinebook-pro/">Pinebook Pro</a>
165: <li><a href="https://en.t-firefly.com/product/rk3399.html">Firefly-RK3399</a>
166: <li><a href="http://wiki.friendlyarm.com/wiki/index.php/NanoPC-T4">FriendlyElec NanoPC-T4</a>
167: <li><a href="https://www.theobroma-systems.com/som-product/rk3399-q7/">Theobroma Systems RK3399-Q7</a>
1.42 kurt 168: <li><a href="https://wiki.radxa.com/RockpiN10">Radxa Rock Pi N10</a>
1.19 kettenis 169: </ul>
170: <li>Socionext SC2A11
171: <ul>
1.36 sthen 172: <li><a href="https://www.socionext.com/en/products/assp/SynQuacer/Edge/">Socionext SynQuacer-E Developerbox</a>
1.9 kettenis 173: </ul>
1.1 patrick 174: </ul>
1.48 kettenis 175:
176: <p>
1.26 tj 177: In general, other boards/machines that use one of the SoCs listed above
178: will work as well, as long as UEFI firmware (e.g. U-Boot or EDK II
179: firmware) is available. Both device trees and ACPI are supported.
180: An updated device tree may have to be supplied to make OpenBSD usable.
1.55 kettenis 181:
182: <p>
1.58 kettenis 183: Support for Ampere Altra, Apple M2 and Qualcomm SC8280XP systems was
184: added after OpenBSD 7.1 was released. On these systems, you'll need a
185: recent snapshot until OpenBSD 7.2 is available.
1.26 tj 186:
1.1 patrick 187: <h4>Ethernet</h4>
188: <ul>
1.30 kettenis 189: <li><a href="https://man.openbsd.org/arm64/bse.4">bse(4)</a>
190: integrated Broadcom GENET 10/100/Gigabit Ethernet on Raspberry Pi 4
1.23 bentley 191: <li><a href="https://man.openbsd.org/arm64/dwge.4">dwge(4)</a>
1.24 deraadt 192: integrated Synopsys DesignWare GMAC 10/100/Gigabit Ethernet on Rockchip RK3399
1.23 bentley 193: <li><a href="https://man.openbsd.org/arm64/dwxe.4">dwxe(4)</a>
1.52 kevlo 194: integrated Allwinner EMAC 10/100/Gigabit Ethernet on Allwinner A64/H5/H6
1.23 bentley 195: <li><a href="https://man.openbsd.org/arm64/msk.4">msk(4)</a>
1.24 deraadt 196: integrated Marvell Yukon-2 10/100/Gigabit Ethernet on OverDrive 1000
1.44 mglocker 197: <li><a href="https://man.openbsd.org/arm64/mue.4">mue(4)</a>
198: integrated Microchip LAN75xx/LAN78xx 10/100/Gigabit USB Ethernet on Raspberry Pi 3 Model B+
1.43 kettenis 199: <li><a href="https://man.openbsd.org/arm64/mvneta.4">mvneta(4)</a>
200: integrated Marvell ARMADA Ethernet on Marvell ARMADA 3K
1.23 bentley 201: <li><a href="https://man.openbsd.org/arm64/smsc.4">smsc(4)</a>
1.24 deraadt 202: integrated SMSC LAN95xx 10/100 USB Ethernet on Raspberry Pi 3
1.1 patrick 203: </ul>
204:
1.34 stsp 205: <h4>802.11 wireless</h4>
206: <ul>
207: <li><a href="https://man.openbsd.org/arm64/bwfm.4">bwfm(4)</a>
1.57 kettenis 208: on Raspberry Pi 3/4/400, Pinebook Pro, and Apple M1/M2
1.34 stsp 209: </ul>
210:
1.1 patrick 211: <h4>Storage</h4>
1.4 jsg 212: <ul>
1.23 bentley 213: <li><a href="https://man.openbsd.org/arm64/ahci.4">ahci(4)</a>
1.25 kettenis 214: on AMD Opteron A1100, Ampere eMAG, Marvell 7K/8K and SynQuacer-E
1.33 jsg 215: <li><a href="https://man.openbsd.org/arm64/bcmsdhost.4">bcmsdhost(4)</a>
216: on Raspberry Pi 3
1.23 bentley 217: <li><a href="https://man.openbsd.org/arm64/dwmmc.4">dwmmc(4)</a>
1.24 deraadt 218: on Rockchip RK3328/RK3399
1.42 kurt 219: <li><a href="https://man.openbsd.org/arm64/rkpcie.4">rkpcie(4)</a>
220: on Rockchip RK3399
1.25 kettenis 221: <li><a href="https://man.openbsd.org/arm64/sdhc.4">sdhc(4)</a>
1.43 kettenis 222: on Marvell ARMADA 3K/7K/8K, Rockchip RK3399 and Raspberry Pi 4
1.25 kettenis 223: <li><a href="https://man.openbsd.org/arm64/sximmc.4">sximmc(4)</a>
1.52 kevlo 224: on Allwinner A64/H5/H6
1.4 jsg 225: </ul>
1.1 patrick 226:
227: <h4>USB</h4>
228: <ul>
1.23 bentley 229: <li><a href="https://man.openbsd.org/arm64/dwctwo.4">dwctwo(4)</a>
1.24 deraadt 230: on Raspberry Pi 3
1.23 bentley 231: <li><a href="https://man.openbsd.org/arm64/ehci.4">ehci(4)</a>
1.52 kevlo 232: on Allwinner A64/H5/H6 and Rockchip RK3328/RK3399
1.23 bentley 233: <li><a href="https://man.openbsd.org/arm64/xhci.4">xhci(4)</a>
1.58 kettenis 234: on Amlogic G12A/B, Ampere eMAG, Apple M1/M2, Marvell ARMADA
235: 3K/7K/8K, Overdrive 1000, Raspberry Pi 4, Qualcomm SC8280XP,
236: Rockchip RK3399 and SynQuacer-E
1.1 patrick 237: </ul>
238:
1.23 bentley 239: <strong>No real time clock:</strong> Many of the arm64 devices do not have a
1.27 deraadt 240: battery-backed real time clock, but <a href="https://man.openbsd.org/ntpd">ntpd(8)</a>
241: should be able to compensate.
1.1 patrick 242:
1.23 bentley 243: <h3 id="install">
1.17 tj 244: <strong>Getting and installing OpenBSD/arm64:</strong>
1.23 bentley 245: </h3>
1.17 tj 246:
247: <p>
248: The latest supported OpenBSD/arm64 release is
1.53 tj 249: <a href="71.html">OpenBSD 7.1</a>.
1.17 tj 250: Here are the
1.53 tj 251: <a href="https://ftp.openbsd.org/pub/OpenBSD/7.1/arm64/INSTALL.arm64">
1.17 tj 252: OpenBSD/arm64 installation instructions</a>.
1.1 patrick 253:
254: <p>
255: Snapshots are made available from time to time, in
1.21 tj 256: <a href="https://cdn.openbsd.org/pub/OpenBSD/snapshots/arm64">this location</a>
257: as well as on a few
1.1 patrick 258: <a href="ftp.html">mirrors</a>.
259: Here are the
1.21 tj 260: <a href="https://ftp.openbsd.org/pub/OpenBSD/snapshots/arm64/INSTALL.arm64">
1.2 tb 261: OpenBSD/arm64 snapshot installation instructions</a> as well.