[src/trunk]: src/distrib/notes/evbarm more modernization of evbarm install in...

[nia <nia%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/a142ec565da2
branches:  trunk
changeset: 1011967:a142ec565da2
user:      nia <nia%NetBSD.org@localhost>
date:      Sat Jul 18 16:41:14 2020 +0000

description:
more modernization of evbarm install instructions

diffstat:

 distrib/notes/evbarm/Makefile |    4 +-
 distrib/notes/evbarm/contents |  109 ++++++------
 distrib/notes/evbarm/hardware |  267 ++-----------------------------
 distrib/notes/evbarm/install  |  320 +++----------------------------------
 distrib/notes/evbarm/prep     |  356 +-----------------------------------------
 distrib/notes/evbarm/xfer     |   32 ++-
 6 files changed, 134 insertions(+), 954 deletions(-)

diffs (truncated from 1286 to 300 lines):

diff -r 6bbd0e9d9567 -r a142ec565da2 distrib/notes/evbarm/Makefile
--- a/distrib/notes/evbarm/Makefile     Sat Jul 18 16:12:09 2020 +0000
+++ b/distrib/notes/evbarm/Makefile     Sat Jul 18 16:41:14 2020 +0000
@@ -1,5 +1,3 @@
-#      $NetBSD: Makefile,v 1.2 2002/07/21 08:14:48 lukem Exp $
-
-MERGED_SRCS+=  ${COMMON}/xfer
+#      $NetBSD: Makefile,v 1.3 2020/07/18 16:41:14 nia Exp $
 
 .include <bsd.man.mk>
diff -r 6bbd0e9d9567 -r a142ec565da2 distrib/notes/evbarm/contents
--- a/distrib/notes/evbarm/contents     Sat Jul 18 16:12:09 2020 +0000
+++ b/distrib/notes/evbarm/contents     Sat Jul 18 16:41:14 2020 +0000
@@ -1,6 +1,6 @@
-.\"    $NetBSD: contents,v 1.8 2020/06/23 06:28:02 martin Exp $
+.\"    $NetBSD: contents,v 1.9 2020/07/18 16:41:14 nia Exp $
 .\"
-.\" Copyright (c) 1999-2005 The NetBSD Foundation, Inc.
+.\" Copyright (c) 1999-2020 The NetBSD Foundation, Inc.
 .\" All rights reserved.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
@@ -45,34 +45,51 @@
 file contains underlined text using the
 .Xr more 1
 conventions for indicating italic and bold display.
-.
-.\" MD binary and installation directories ---------------------------
-.
 .      It Pa binary/
-.
 .      (tag kernel/ -compact \" binary/
-.
+.              It Pa gzimg/
+.              (tag armv7.img.gz -compact \" binary/gzimg
+.                      It Pa armv7.img.gz
+A gzipped writable image containing the complete
+.Nx
+operating system for a range of 32-bit devices (includes a GENERIC kernel).
+.                      It Pa arm64.img.gz
+A gzipped writable image containing the complete
+.Nx
+operating system for a range of 64-bit devices (includes a GENERIC64 kernel).
+.                      It Pa rpi.img.gz
+A gzipped writable image containing the complete 32-bit
+.Nx
+operating system for Raspberry Pi variants only (includes RPI kernels).
+.              tag) \" binary/gzimg/
 .              It Pa kernel/
-.
 .              (tag netbsd.gz -compact \" binary/kernel
 .                      It Pa netbsd-GENERIC.gz
-A gzipped
-.Nx
-kernel containing code for everything supported in this release.
-.
+A gzipped ARMv7 kernel which supports a range of 32-bit devices that
+do not need board-specific kernels.
+.                      It Pa netbsd-GENERIC64.gz
+A gzipped AArch64 kernel which supports a range of 64-bit devices that
+do not need board-specific kernels.
+.                      It Pa netbsd-RPI.gz
+A gzipped ARMv6 kernel which supports the Raspberry Pi 1 only.
+.                      It Pa netbsd-RPI2.gz
+A gzipped ARMv6 kernel which supports the Raspberry Pi 2 only.
 .              tag) \" binary/kernel/
 .
 .              It Pa sets/
-.
 \*M binary distribution sets;
 see below.
 .
 .      tag) \" binary/
-.
 .      It Pa installation/
 .
 .      (tag miniroot/ -compact \" installation/
 .
+.              It Pa miniroot/
+.
+\*M kernel modules providing memory disk
+root file systems for expert usage.
+.
 .              It Pa misc/
 .
 Miscellaneous \*M installation utilities; see
@@ -82,29 +99,22 @@
 .
 .tag) \" top level
 .
-.\" ------------------------------------------------------------------
-.
 .
 .Ss2 Binary distribution sets
-.\"
-.\" ------------------------------------------------------------------
-.\" XXX: most sets except kern and xserver should be in notes/common
-.\"
 The
 .Nx
-\*M
-binary distribution sets contain the binaries which
-comprise the
-.Nx
-\*V release for \*M.
-The binary distribution sets can be found in the
+\*V release for \*M is comprised of the following binary sets, which
+can be found in the
 .Pa \*M/binary/sets
 subdirectory
 of the
 .Nx
 \*V
-distribution tree, and are as follows:
+distribution tree:
 .(tag xserver \" sets
+.\"
+.\" XXX: most sets except kern and xserver should be shared
+.\"
 .
 .It Sy base
 The
@@ -154,31 +164,18 @@
 .It Sy games
 This set includes the games and their manual pages.
 .
-.\" MD kernel set(s) -------------------------------------------------
+.\" Kernel set(s)
 .
-.It Sy kern-INTEGRATOR
-(see below)
-.It Sy kern-IQ80310
-(see below)
-.It Sy kern-IQ80321
-(see below)
-.It Sy kern-TEAMASA_NPWR
-.Pp
-These sets contain a
+.It Sy kern-GENERIC
+This set contains a
 .Nx*M
 \*V
+.Li GENERIC
 kernel, named
 .Pa /netbsd .
-Some of these sets also contain a binary format kernel named
-.Pa /netbsd.bin
-and an S-record format kernel named
-.Pa /netbsd.srec
-that your firmware may need to boot.
 You
 .Em must
-install the kernel that matches your hardware.
-.
-.\" ------------------------------------------------------------------
+install this distribution set.
 .
 .It Sy man
 This set includes all of the manual pages for the
@@ -211,9 +208,7 @@
 .tag) \" sets
 .
 .
-.\" X sets -----------------------------------------------------------
-.\" XXX: XOrg vs XFree
-.\" XXX: ports without xserver
+.\" ---------------------------- X SETS
 .Pp
 .Nx
 maintains its own set of sources for the X Window System in order to
@@ -248,24 +243,23 @@
 .
 .It Sy xserver
 The X server.
+This includes the modular X.Org server.
 .
 .tag) \" x sets
 .
 .
-.\" ------------------------------------------------------------------
-.
-.
-.\" MI DISCUSSION OF BINARY SETS -------------------------------------
+.\" ---------------------------- MI DISCUSSION OF BINARY SETS
+.\"
 .\" XXX: should be in notes/common
+.\"
 .
 .Pp
 The \*M binary distribution sets are distributed as tar files
 compressed with
 .Sy \*[compressor]
 named with the extension
-.Sy .\*[setsuffix] ,
-e.g.
-.Pa base.\*[setsuffix] .
+.Sy .\*[setsuffix]
+.Pq e.g., Pa base.\*[setsuffix] .
 .
 .
 .Pp
@@ -274,7 +268,7 @@
 method, the filenames stored in the sets are relative and therefore
 the files are extracted
 .Em below the current directory .
-Therefore, if you want to extract the binaries into your system, i.e.
+Therefore, if you want to extract the binaries into your system, i.e.,
 replace the system binaries with them, you have to run the
 .Ic "tar -xzpf"
 command from the root directory (
@@ -282,7 +276,6 @@
 ) of your system.
 .
 .
-.\" MD DISCUSSION ----------------------------------------------------
+.\" ---------------------------- MD DISCUSSION
 .
 .\" XXX: should be written
-.
diff -r 6bbd0e9d9567 -r a142ec565da2 distrib/notes/evbarm/hardware
--- a/distrib/notes/evbarm/hardware     Sat Jul 18 16:12:09 2020 +0000
+++ b/distrib/notes/evbarm/hardware     Sat Jul 18 16:41:14 2020 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: hardware,v 1.11 2020/05/27 12:45:07 nia Exp $
+.\"    $NetBSD: hardware,v 1.12 2020/07/18 16:41:14 nia Exp $
 .\"
 .\" Copyright (c) 2001-2020 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -24,264 +24,39 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Nx \*V
-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
-.It
-Intel IQ80310
-.It
-Intel IQ80321
-.It
-Team ASA, Inc. Npwr
-.It
-Intel IXM1200
-.It
-Samsung SMDK2800
-.It
-ADI Engineering, Inc. BRH ("Big Red Head")
-.It
-Arcom Viper
-.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
+.Ss2 32-bit SoCs supported by GENERIC kernels (ARMv7-A)
 .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