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

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

details:   https://anonhg.NetBSD.org/src/rev/1d8b0dacb133
branches:  netbsd-9
changeset: 936369:1d8b0dacb133
user:      martin <martin%NetBSD.org@localhost>
date:      Sun Jul 26 11:05:57 2020 +0000

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

        distrib/notes/evbarm/upgrade: revision 1.3
        distrib/notes/evbarm/upgrade: revision 1.4
        distrib/notes/evbarm/upgrade: revision 1.5

Initial evbarm upgrade instructions - need work

clarify

upgrades to upgrade instructions

diffstat:

 distrib/notes/evbarm/upgrade |  87 ++++++++++++++++++++++++++++++++++++++++++-
 1 files changed, 85 insertions(+), 2 deletions(-)

diffs (92 lines):

diff -r 20fb2d968915 -r 1d8b0dacb133 distrib/notes/evbarm/upgrade
--- a/distrib/notes/evbarm/upgrade      Sun Jul 26 10:59:47 2020 +0000
+++ b/distrib/notes/evbarm/upgrade      Sun Jul 26 11:05:57 2020 +0000
@@ -1,3 +1,86 @@
-.\"    $NetBSD: upgrade,v 1.2 2009/04/23 01:56:49 snj Exp $
+.\"    $NetBSD: upgrade,v 1.2.50.1 2020/07/26 11:05:57 martin Exp $
+.\"
+.\" Copyright (c) 2020 The NetBSD Foundation, Inc.
+.\" All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
+.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
+.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+.\" POSSIBILITY OF SUCH DAMAGE.
+.\"
 .
-.so ../common/upgrade
+.Pp
+The easiest way to upgrade to
+.Nx
+\*M
+\*V
+is by using the sysutils/sysupgrade package from pkgsrc.
+.Pp
+First, edit
+.Pa /usr/pkg/etc/sysupgrade.conf .
+Make sure RELEASEDIR and ARCHIVE_EXTENSION are correct:
+.Bd -literal
+# Replace evbarm-aarch64 with evbarm-earmv7hf on a 32-bit system, evbarm-earmv6hf on the original RPI
+RELEASEDIR="https://cdn.netbsd.org/pub/NetBSD/NetBSD-\*V/evbarm-aarch64/";
+ARCHIVE_EXTENSION=tar.xz
+.Ed
+.Pp
+Make sure
+.Pa /boot
+is mounted, and copy the new board-specific
+.Pa *.dts
+device tree file into place.
+Note that the device tree files are sorted into SoC-type subdirectories in
+.Pa /boot/dtb ,
+e.g. allwinner, amlogic, broadcom, freescale, nvidia, rockchip.
+.Pp
+For example, for the Allwinner-based PINE A64 LTS:
+.Bd -literal
+$ ftp https://cdn.netbsd.org/pub/NetBSD/NetBSD-\*V/evbarm-aarch64/binary/kernel/sun50i-a64-pine64-lts.dtb.gz
+$ gunzip sun50i-a64-pine64-lts.dtb.gz
+# cp sun50i-a64-pine64-lts.dtb /boot/dtb/allwinner/
+.Ed
+Also copy
+.Pa bootaa64.efi
+if applicable:
+.Bd -literal
+$ ftp https://cdn.netbsd.org/pub/NetBSD/NetBSD-\*V/evbarm-aarch64/installation/misc/bootaa64.efi
+# cp bootaa64.efi /boot/EFI/BOOT/bootaa64.efi
+.Ed
+.Pp
+Finally:
+.Bd -literal
+# sysupgrade fetch
+# sysupgrade kernel
+# sysupgrade modules
+# reboot
+# sysupgrade sets
+# sysupgrade etcupdate
+# sysupgrade postinstall
+# reboot
+.Ed
+.Pp
+This is the most careful possible path with sysupgrade that makes sure
+the kernel and userland are always fully compatible, by making sure the
+kernel and boot files are newer than the userland.
+It is also possible to:
+.Bd -literal
+# sysupgrade auto
+# reboot
+.Ed