Source-Changes-HG archive

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]

[src/netbsd-9]: src/distrib/notes/evbarm Pull up following revision(s) (reque...



details:   https://anonhg.NetBSD.org/src/rev/bdcfbb88a4b4
branches:  netbsd-9
changeset: 964030:bdcfbb88a4b4
user:      martin <martin%NetBSD.org@localhost>
date:      Mon Jul 20 18:32:55 2020 +0000

description:
Pull up following revision(s) (requested by nia in ticket #1022):

        distrib/notes/evbarm/install: revision 1.14
        distrib/notes/evbarm/hardware: revision 1.11
        distrib/notes/evbarm/hardware: revision 1.12
        distrib/notes/evbarm/hardware: revision 1.13
        distrib/notes/evbarm/hardware: revision 1.14
        distrib/notes/evbarm/Makefile: revision 1.3
        distrib/notes/evbarm/xfer: revision 1.3
        distrib/notes/evbarm/xfer: revision 1.4
        distrib/notes/evbarm/prep: revision 1.12
        distrib/notes/evbarm/contents: revision 1.9
        distrib/notes/evbarm/contents: revision 1.10
        distrib/notes/evbarm/install: revision 1.11
        distrib/notes/evbarm/install: revision 1.12
        distrib/notes/evbarm/install: revision 1.13

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
s/boards/devices/

Briefly explain how to pkgsrc u-boot. Pointed out by maya.

more modernization of evbarm install instructions

safe estimation of required storage

more contents

more hardware

missing e.g.

diffstat:

 distrib/notes/evbarm/Makefile |    4 +-
 distrib/notes/evbarm/contents |  119 ++++++-------
 distrib/notes/evbarm/hardware |  234 +++------------------------
 distrib/notes/evbarm/install  |  262 +++++-------------------------
 distrib/notes/evbarm/prep     |  356 +-----------------------------------------
 distrib/notes/evbarm/xfer     |   33 ++-
 6 files changed, 168 insertions(+), 840 deletions(-)

diffs (truncated from 1185 to 300 lines):

diff -r f8d5eeb01e19 -r bdcfbb88a4b4 distrib/notes/evbarm/Makefile
--- a/distrib/notes/evbarm/Makefile     Mon Jul 20 18:15:43 2020 +0000
+++ b/distrib/notes/evbarm/Makefile     Mon Jul 20 18:32:55 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.2.102.1 2020/07/20 18:32:55 martin Exp $
 
 .include <bsd.man.mk>
diff -r f8d5eeb01e19 -r bdcfbb88a4b4 distrib/notes/evbarm/contents
--- a/distrib/notes/evbarm/contents     Mon Jul 20 18:15:43 2020 +0000
+++ b/distrib/notes/evbarm/contents     Mon Jul 20 18:32:55 2020 +0000
@@ -1,6 +1,6 @@
-.\"    $NetBSD: contents,v 1.4.4.2 2019/11/25 05:50:20 msaitoh Exp $
+.\"    $NetBSD: contents,v 1.4.4.3 2020/07/20 18:32:55 martin 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,66 +45,81 @@
 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).
+.                      It Pa *.dtb.gz
+Gzipped board-specific device trees.
+.              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 misc/
+.              It Pa miniroot/
+.
+\*M kernel modules providing memory disk
+root file systems for expert usage.
 .
-Miscellaneous \*M installation utilities; see
-installation section below.
+.              It Pa misc/
+.              (tag bootaa64.efi -compact \" misc/bootaa64.efi
+.                      It Pa bootaa64.efi
+.                      (tag bootaa64.efi -compact \" misc/bootaa64.efi
+AArch64 EFI bootloader
+.                      tag) \" misc/bootaa64.efi
+.              tag) \" misc/bootaa64.efi
 .
 .      tag) \" installation/
 .
 .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 +169,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 +213,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,22 +248,22 @@
 .
 .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 gzipped tar files
 named with the extension
-.Sy .\*[setsuffix] ,
-e.g.
-.Pa base.\*[setsuffix] .
+.Sy .\*[setsuffix]
+.Pq e.g., Pa base.\*[setsuffix] .
 .
 .
 .Pp
@@ -272,7 +272,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 (
@@ -280,7 +280,6 @@
 ) of your system.
 .
 .
-.\" MD DISCUSSION ----------------------------------------------------
+.\" ---------------------------- MD DISCUSSION
 .
 .\" XXX: should be written
-.
diff -r f8d5eeb01e19 -r bdcfbb88a4b4 distrib/notes/evbarm/hardware
--- a/distrib/notes/evbarm/hardware     Mon Jul 20 18:15:43 2020 +0000
+++ b/distrib/notes/evbarm/hardware     Mon Jul 20 18:32:55 2020 +0000
@@ -1,6 +1,6 @@
-.\"    $NetBSD: hardware,v 1.10 2008/04/30 13:10:48 martin Exp $
+.\"    $NetBSD: hardware,v 1.10.66.1 2020/07/20 18:32:55 martin 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
@@ -24,217 +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 evaluation boards:
-.(bullet -offset indent
-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")
+.Ss2 32-bit SoCs supported by GENERIC kernels (ARMv7-A)
+.Pp
+.Lk "https://wiki.netbsd.org/ports/evbarm/qemu_arm/"; "QEMU"
+is also supported.
+.Bl -bullet -offset indent -compact
 .It
-Arcom Viper
-.bullet)
-.
-.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"
-.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
-.It
-Text-mode HD44780 LCD display header



Home | Main Index | Thread Index | Old Index