Module Name: src
Committed By: nia
Date: Wed May 27 12:45:07 UTC 2020
Modified Files:
src/distrib/notes/evbarm: hardware install
Log Message:
First attempt at modernising the evbarm install guide and hardware lists
- Install instructions mostly based on wiki pages
- Supported hardware lists mostly based on GENERIC and GENERIC64 kernels
To generate a diff of this commit:
cvs rdiff -u -r1.10 -r1.11 src/distrib/notes/evbarm/hardware \
src/distrib/notes/evbarm/install
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/distrib/notes/evbarm/hardware
diff -u src/distrib/notes/evbarm/hardware:1.10 src/distrib/notes/evbarm/hardware:1.11
--- src/distrib/notes/evbarm/hardware:1.10 Wed Apr 30 13:10:48 2008
+++ src/distrib/notes/evbarm/hardware Wed May 27 12:45:07 2020
@@ -1,6 +1,6 @@
-.\" $NetBSD: hardware,v 1.10 2008/04/30 13:10:48 martin Exp $
+.\" $NetBSD: hardware,v 1.11 2020/05/27 12:45:07 nia Exp $
.\"
-.\" Copyright (c) 2001-2003 The NetBSD Foundation, Inc.
+.\" Copyright (c) 2001-2020 The NetBSD Foundation, Inc.
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
@@ -25,8 +25,23 @@
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
.Nx \*V
-runs on the following ARM architecture evaluation boards:
-.(bullet -offset indent
+runs on the following ARM architecture devices:
+.Bl -bullet -offset indent -compact
+.It
+ARM ServerReady (SBSA) devices
+.It
+Allwinner Technology SoCs (e.g. PINE64, Orange Pi...)
+.It
+RockChip RK3328, RK3399 (e.g. RockPro64, Pinebook Pro)
+.It
+BeagleBoard, BeagleBoard-xM, BeagleBone, BeagleBone Black
+.It
+ODROID C1 and C1+
+.It
+Raspberry Pi 1, 2, 3
+.It
+NVIDIA Tegra K1, X1
+.It
Technologic Systems TS-7200
.It
ARM, Ltd. Integrator
@@ -44,33 +59,114 @@ Samsung SMDK2800
ADI Engineering, Inc. BRH ("Big Red Head")
.It
Arcom Viper
-.bullet)
+.El
+.
+.Ss2 Supported devices (Allwinner Systems-on-a-Chip)
+The following Allwinner SoCs are known to be supported by GENERIC
+kernels (ARMv7-A):
+A10, A13, A20, A32, A80, A83T, H3
+.Pp
+The following Allwinner SoCs are known to be supported by GENERIC64
+kernels (AArch64):
+H5, H6, A64
+.Pp
+This is not an exhaustive list and only includes on-chip devices:
+.Bl -bullet -offset indent -compact
+.It
+Allwinner DRM framebuffer
+.It
+Allwinner audio codec
+.It
+Allwinner GPIO controller
+.It
+Allwinner SPI controller
+.It
+Allwinner RSB/TWI I2C controllers
+.It
+Allwinner SD/MMC
+.It
+Synopsys DesignWare SATA
+.It
+Synopsys DesignWare Ethernet MAC 10/100/1000 Universal
+.It
+USB 2.0/3.0 host controller
+.El
+.
+.Ss2 Supported devices (RockChip Systems-on-a-Chip)
+The following RockChip SoCs are known to be supported by GENERIC64
+kernels (AArch64): RK3328, RK3328
+.Pp
+Other systems may work, but they have not been tested.
+.Pp
+This is not an exhaustive list and only includes on-chip devices:
+.Bl -bullet -offset indent -compact
+.It
+RockChip DRM framebuffer
+.It
+RockChip I2S/PCM audio
+.It
+RockChip GPIO controller
+.It
+RockChip SPI controller
+.It
+RockChip I2C controller
+.It
+RockChip AXI PCI-E
+.It
+RockChip Power Management IC
+.It
+RockChip eMMC PHY
+.It
+Synopsys DesignWare Ethernet MAC 10/100/1000 Universal
+.It
+USB 2.0/3.0 host controller
+.El
+.
+.Ss2 Supported devices (Broadcom Systems-on-a-Chip)
+The following Broadcom SoCs are known to be supported by GENERIC
+kernels (ARMv7-A): BCM2836 (Raspberry Pi 2)
+.Pp
+The following Broadcom SoCs are known to be supported by GENERIC64
+kernels (AArch64): BCM2837 (Raspberry Pi 3)
+.Pp
+This is not an exhaustive list and only includes on-chip devices:
+.Bl -bullet -offset indent -compact
+.It
+Broadcom BCM283x ICU controller
+.It
+Broadcom VideoCore IV mailbox
+.It
+Broadcom BCM283x GPIO controller
+.It
+Broadcom GENET v5 ethernet
+.It
+Broadcom BCM283x SD Host Interface
+.It
+Broadcom BCM43xxx WiFi Interface
+.It
+Broadcom BCM283x SPI controller
+.It
+Synopsys DesignWare USB DRD controller
+.El
.
.Ss2 Supported devices (Technologic Systems TS-7200)
For devices that have machine-independent drivers,
this is not an exhaustive list, but merely reflects the
devices that have been tested on this platform.
-.(bullet -offset indent
-.Te 2 "TS-5620 Real Time Clock"
+.Bl -bullet -offset indent -compact
+.It
+TS-5620 Real Time Clock
.It
-.Te 2 "Serial ports"
-.(bullet -compact
On-chip EP9302 UARTs
.It
TS-SER1, TS-SER2, TS-SER4 PC/104 serial adapters
.It
TS-MODEM, TS-MODEM2 PC/104 land-line/cellular modems
-.bullet)
.It
-.Te 2 "Ethernet adapters"
-.(bullet -compact
On-chip EP9302 10/100 ethernet
.It
TS-ETH10 PC/104 expansion ethernet adapters
-.bullet)
.It
-.Te 2 "Other on-board functions"
-.(bullet -compact
CompactFlash socket
.It
USB OHCI host
@@ -80,24 +176,19 @@ Text-mode HD44780 LCD display header
Matrix keypad/GPIO header
.It
Board temperature sensor and watchdog timer
-.bullet)
-.bullet)
+.El
.
.Ss2 Supported devices (ARM, Ltd. Integrator)
For devices that have machine-independent drivers,
this is not an exhaustive list, but merely reflects the
devices that have been tested on this platform.
-.(bullet -offset indent
-.Te 2 "PrimeCell PL030 Real Time Clock"
+.Bl -bullet -offset indent -compact
+.It
+PrimeCell PL030 Real Time Clock
.It
-.Te 2 "Serial ports"
-.(bullet -compact
PrimeCell PL010 UART
-.bullet)
.It
-.Te 2 "SCSI host adapters"
-.(bullet -compact
-Adaptec AHA-2910, 2915, 2920, and 2930C adapters.
+Adaptec AHA-2910, 2915, 2920, and 2930C SCSI host adapters.
.It
Adaptec AHA-2x4x[U][2][W] cards and onboard PCI designs using the AIC-7770,
AIC-7850, AIC-7860, AIC-7870, AIC-7880 and AIC-789x chipsets.
@@ -107,134 +198,90 @@ Adaptec AHA-394x[U][W] cards [b]
Adaptec AHA-3950U2 cards
.It
Adaptec AHA-3960, 19160 and 29160 Ultra-160 adapters
-.bullet)
.It
-.Te 2 "Ethernet adapters"
-.(bullet -compact
-Intel i82557, i82558, i82559, i82550
-.bullet)
-.bullet)
+Intel i82557, i82558, i82559, i82550 ethernet adapters
+.El
.
.Ss2 Supported devices (Intel IQ80310)
For devices that have machine-independent drivers,
this is not an exhaustive list, but merely reflects the
devices that have been tested on this platform.
-.(bullet -offset indent
-.Te 2 "Serial ports"
-.(bullet -compact
+.Bl -bullet -offset indent -compact
+.It
On-board ST16c550 UARTs
-.bullet)
.It
-.Te 2 "Ethernet adapters"
-.(bullet -compact
-Intel i82557, i82558, i82559, i82550
-.bullet)
+Intel i82557, i82558, i82559, i82550 ethernet adapters
.It
-.Te 2 "i80312 Companion I/O functions"
-.(bullet -compact
General Purpose I/O unit
-.bullet)
-.bullet)
+.El
.
.Ss2 Supported devices (Intel IQ80321)
For devices that have machine-independent drivers,
this is not an exhaustive list, but merely reflects the
devices that have been tested on this platform.
-.(bullet -offset indent
-.Te 2 "Serial ports"
-.(bullet -compact
+.Bl -bullet -offset indent -compact
+.It
On-board TI 16550 UART
-.bullet)
.It
-.Te 2 "Ethernet adapters"
-.(bullet -compact
Intel i82542, i82543, i85244 Gigabit Ethernet
-.bullet)
.It
-.Te 2 "i80321 I/O Processor functions"
-.(bullet -compact
Application Accelerator Unit
.It
Watchdog timer
-.bullet)
-.bullet)
+.El
.
.Ss2 Supported devices (Team ASA Npwr)
The Npwr is a storage appliance based on the Intel IOP310
I/O processor chipset. This is an exhaustive list of devices
supported on the Npwr as the Npwr has no expansion capability.
-.(bullet
-.Te 2 "Serial ports"
-.(bullet -compact
+.Bl -bullet -offset indent -compact
+.It
On-board TI 16550 UART
-.bullet)
.It
-.Te 2 "SCSI host adapters"
-.(bullet
On-board LSI Logic 53c1010 Ultra160 SCSI adapter
-.bullet)
.It
-.Te 2 "Ethernet adapters"
-.(bullet
On-board Intel i82544 Gigabit Ethernet
-.bullet)
-.bullet)
+.El
.
.Ss2 Supported devices (Intel IXM1200)
For devices that have machine-independent drivers,
this is not an exhaustive list, but merely reflects the
devices that have been tested on this platform.
-.(bullet -offset indent
-.Te 2 "Serial ports"
-.(bullet -compact
+.Bl -bullet -offset indent -compact
+.It
IXP1200 on-chip serial port
-.bullet)
.It
-.Te 2 "Ethernet adapters"
-.(bullet -compact
-Intel i82557, i82558, i82559, i82550
-.bullet)
-.bullet)
+Intel i82557, i82558, i82559, i82550 ethernet adapters
+.El
.
.Ss2 Supported devices (Samsung SMDK2800)
For devices that have machine-independent drivers,
this is not an exhaustive list, but merely reflects the
devices that have been tested on this platform.
-.(bullet -offset indent
-.Te 2 "Serial ports"
-.(bullet -compact
+.Bl -bullet -offset indent -compact
+.It
S3C2800 on-chip serial ports
-.bullet)
-.bullet)
+.El
.
.Ss2 Supported devices (ADI BRH)
For devices that have machine-independent drivers,
this is not an exhaustive list, but merely reflects the
devices that have been tested on this platform.
-.(bullet -offset indent
-.Te 2 "Serial ports"
-.(bullet -compact
+.Bl -bullet -offset indent -compact
+.It
On-board TI 16752 DUART
-.bullet)
.It
-.Te 2 "Ethernet adapters"
-.(bullet -compact
-Intel i82557, i82558, i82559, i82550
-.It
-Intel i82544, i82546 Gigabit Ethernet
-.bullet)
-.bullet)
+Intel i82557, i82558, i82559, i82550 ethernet adapters
+.It
+Intel i82544, i82546 Gigabit Ethernet adapters
+.El
.
.Ss2 Supported devices (Arcom Viper)
Current this is an exhaustive list, since expansion ports such as
PC/104 and USB are not yet supported.
-.(bullet -offset indent
-.Te 2 "Serial ports"
-.(bullet -compact
+.Bl -bullet -offset indent -compact
+.It
On-chip PXA255 UARTs
-.bullet)
-.Te 2 "Ethernet adapters"
-.(bullet -compact
-On-board SMC91C111
-.bullet)
-.bullet)
+.It
+On-board SMC91C111 ethernet adapter
+.El
Index: src/distrib/notes/evbarm/install
diff -u src/distrib/notes/evbarm/install:1.10 src/distrib/notes/evbarm/install:1.11
--- src/distrib/notes/evbarm/install:1.10 Thu Nov 21 19:23:18 2019
+++ src/distrib/notes/evbarm/install Wed May 27 12:45:07 2020
@@ -1,6 +1,6 @@
-.\" $NetBSD: install,v 1.10 2019/11/21 19:23:18 martin Exp $
+.\" $NetBSD: install,v 1.11 2020/05/27 12:45:07 nia Exp $
.\"
-.\" Copyright (c) 2001-2002 The NetBSD Foundation, Inc.
+.\" Copyright (c) 2001-2020 The NetBSD Foundation, Inc.
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
@@ -24,6 +24,78 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
+.Ss2 Installation for ARMv7 and AArch64 boards using U-Boot (example: Allwinner SoCs)
+.Bl -bullet -offset indent -compact
+.It
+Download or build armv7.img (32-bit) or arm64.img (64-bit)
+.It
+Write the image to disk:
+.Bd -literal
+# dd if=armv7.img of=/dev/rld0d bs=1m conv=sync
+.Ed
+.It
+Install a board-specific U-Boot from pkgsrc to the SD card (the u-boot-sunxi-with-spl.bin-s are provided by sysutils/u-boot-<boardname> packages):
+.Bd -literal
+# dd if=/usr/pkg/share/u-boot/[boardname]/u-boot-sunxi-with-spl.bin of=/dev/rld0d bs=1k seek=8 conv=sync
+.Ed
+.El
+.Pp
+If you do not want to prepare a SD card image manually, NetBSD developer
+Jared McNeill provides pre-prepared images on his website
+.Lk http://www.armbsd.org/arm/ "armbsd.org" .
+.Ss2 Installation for AArch64 boards using U-Boot (example: Rockchip SoCs)
+.Bl -bullet -offset indent -compact
+.It
+Download or build arm64.img (64-bit)
+.It
+Write the image to disk:
+.Bd -literal
+# dd if=arm64.img of=/dev/rld0d bs=1m conv=sync
+.Ed
+.It
+Install a board-specific U-Boot from pkgsrc to the SD card:
+.Bd -literal
+# dd if=/usr/pkg/share/u-boot/[boardname]/rksd_loader.img of=/dev/rld0d seek=64 conv=sync
+.Ed
+.El
+.Pp
+If you do not want to prepare a SD card image manually, NetBSD developer
+Jared McNeill provides pre-prepared images on his website
+.Lk http://www.armbsd.org/arm/ "armbsd.org" .
+.Ss2 Installation for ODROID C1, C1+
+.Bl -bullet -offset indent -compact
+.It
+Download or build armv7.img (32-bit)
+.It
+.Lk https://github.com/hardkernel/u-boot/tree/odroidc-v2011.03 "Build"
+or
+.Lk http://ftp.netbsd.org/pub/NetBSD/misc/jmcneill/odroidc1/u-boot-odroidc-v2011.03-20150308.tar.gz "download a prebuilt"
+U-Boot
+.It
+Write the bootloader to the empty space at the start of the base image:
+.Pp
+.Bd -literal
+# dd if=bl1.bin.hardkernel of=armv7.img bs=1 count=442 conv=notrunc
+# dd if=bl1.bin.hardkernel of=armv7.img bs=512 skip=1 seek=1 conv=notrunc
+# dd if=u-boot.bin of=armv7.img bs=512 seek=64 conv=notrunc
+.Ed
+.It
+Write the image to an SD card.
+.It
+Edit boot.ini on the MS-DOS partition. Note that the default boot.ini has console=fb in bootargs, which you should remove if you want serial console:
+.Pp
+.Bd -literal
+ODROIDC-UBOOT-CONFIG
+
+setenv bootargs "root=ld0a awge0.mac-address=${ethaddr} console=fb"
+setenv bootcmd "fatload mmc 0:1 0x21000000 netbsd-ODROID-C1.ub; bootm 0x21000000"
+run bootcmd
+.Ed
+.El
+.Pp
+If you do not want to prepare a SD card image manually, NetBSD developer
+Jared McNeill provides pre-prepared images on his website
+.Lk http://www.armbsd.org/arm/ "armbsd.org" .
.Ss2 Installation for the Technologic Systems TS-7200
The following steps describe how to set up a CompactFlash card for
the TS-7200. The TS-7200 can use the interactive
