Merge branch 'bbb-stretch' of jwgarber/libreboot into master

1 files changed, 41 insertions, 72 deletions

diff --git a/docs/install/bbb_setup.md b/docs/install/bbb_setup.md
index 5d684a7f..352344a4 100644
--- a/docs/install/bbb_setup.md
+++ b/docs/install/bbb_setup.md
@@ -18,15 +18,10 @@ Lastly SBC is an example of self-contained device that is capable of flashing,
 but it's possible to use smaller device like stm32 bluepill
 with another computer to achieve similar result.*
 
-*NOTE: this documentation may be outdated, and discusses configuring
-SPI flashing on the default Debian system that the BBB sometimes comes
-with. If you want an easier time, just use [BBB
-ScrewDriver](https://www.coreboot.org/BBB_screwdriver) which comes
-pre-configured.*
-
-*This guide is written for Debian Wheezy 7.5, which is what came on the
-BBB at the time this guide was written. This one:
-<https://debian.beagleboard.org/images/bone-debian-7.8-lxde-4gb-armhf-2015-03-01-4gb.img.xz>*
+*Note: This guide was written for Debian Stretch 9.5, which is the latest
+operating system for the BeagleBone Black as of June 2019. It is possible that
+these instructions may be outdated if newer operating systems versions
+have been released since then.*
 
 There was no justification for a further section for the Teensy. Simply
 refer to [this page on
@@ -146,10 +141,14 @@ Here is an example set up:\
 Accessing the operating system on the BBB
 =========================================
 
-The operating system on your BBB will probably have an SSH daemon
-running where the root account has no password. Use SSH to access the
-operating system and set a root password. By default, the OS on your BBB
-will most likely use DHCP, so it should already have an IP address.
+Follow the [Getting Started](https://beagleboard.org/getting-started)
+instructions to install the latest version of Debian onto the BBB.
+It is recommended to download the eMMC IoT Flasher edition, which will
+write its image to the on-board eMMC.
+
+The operating system on the BBB can be accessed over SSH, with username
+'debian' and password 'temppwd'. Follow the instructions on the Getting
+Started page for complete details.
 
 You will also be using the OS on your BBB for programming an SPI flash
 chip.
@@ -176,76 +175,46 @@ of SSH.
 Setting up spidev on the BBB
 ============================
 
-Log on as root on the BBB, using either SSH or a serial console as
-defined in [\#bbb\_access](#bbb_access). Make sure that you have
-internet access on your BBB.
-
-Follow the instructions at
-<http://elinux.org/BeagleBone_Black_Enable_SPIDEV#SPI0> up to (and
-excluding) the point where it tells you to modify uEnv.txt
-
-You need to update the software on the BBB first. If you have an
-element14 brand BBB (sold by Premier Farnell plc. stores like Farnell
-element14, Newark element14, and Embest), you may need to [work around a
-bug](https://groups.google.com/forum/?_escaped_fragment_=msg/beagleboard/LPjCn4LEY2I/alozBGsbTJMJ#!msg/beagleboard/LPjCn4LEY2I/alozBGsbTJMJ)
-in the LED aging init script before you can update your software. If you
-don't have a file named /etc/init.d/led\_aging.sh, you can skip this
-step and update your software as described below. Otherwise, replace the
-contents of this file with:
-
-    #!/bin/sh -e
-    ### BEGIN INIT INFO
-    # Provides:          led_aging.sh
-    # Required-Start:    $local_fs
-    # Required-Stop:     $local_fs
-    # Default-Start:     2 3 4 5
-    # Default-Stop:      0 1 6
-    # Short-Description: Start LED aging
-    # Description:       Starts LED aging (whatever that is)
-    ### END INIT INFO
-
-    x=$(/bin/ps -ef | /bin/grep "[l]ed_acc")
-    if [ ! -n "$x" -a -x /usr/bin/led_acc ]; then
-        /usr/bin/led_acc &
-    fi
-
-Run `apt-get update` and `apt-get upgrade` then reboot the BBB,
-before continuing.
-Check that the firmware exists:
-
-    # ls /lib/firmware/BB-SPI0-01-00A0.
+Log in to the BBB using either SSH or a serial console as
+described in [\#bbb\_access](#bbb_access).
 
-Output:
+*Note: The following commands are run as root. To run them from a normal user
+account, add yourself to the `gpio` group to configure the pins and the `spi`
+group to access spidev.*
 
-    /lib/firmware/BB-SPI0-01-00A0.dtbo
+Run the following commands to enable spidev:
 
-Then:
+    # config-pin P9.17 spi_cs
+    # config-pin P9.18 spi
+    # config-pin P9.21 spi
+    # config-pin P9.22 spi_sclk
 
-    # echo BB-SPI0-01 > /sys/devices/bone_capemgr./slots
-    # cat /sys/devices/bone_capemgr./slots
+Verify that the spidev devices now exist:
 
-Output:
+    # ls /dev/spidev*
 
-     0: 54:PF--- 
-     1: 55:PF--- 
-     2: 56:PF--- 
-     3: 57:PF--- 
-     4: ff:P-O-L Bone-LT-eMMC-2G,00A0,Texas Instrument,BB-BONE-EMMC-2G
-     5: ff:P-O-L Bone-Black-HDMI,00A0,Texas Instrument,BB-BONELT-HDMI
-     7: ff:P-O-L Override Board Name,00A0,Override Manuf,BB-SPI0-01
+Output:
 
-Verify that the spidev device now exists:
+    /dev/spidev1.0  /dev/spidev1.1  /dev/spidev2.0  /dev/spidev2.1
 
-    # ls -al /dev/spid*
+Now the BBB is ready to be used for flashing. The following systemd service
+file can optionally be enabled to make this persistent across reboots.
 
-Output:
+```
+[Unit]
+Description=Enable SPI function on pins
 
-    crw-rw---T 1 root spi 153, 0 Nov 19 21:07 /dev/spidev1.0
+[Service]
+Type=oneshot
+ExecStart=config-pin P9.17 spi_cs
+ExecStart=config-pin P9.18 spi
+ExecStart=config-pin P9.21 spi
+ExecStart=config-pin P9.22 spi_sclk
+RemainAfterExit=yes
 
-Now the BBB is ready to be used for flashing. Make this persist across
-reboots:\
-In /etc/default/capemgr add `CAPE=BB-SPI0-01` at the end (or change
-the existing `CAPE=` entry to say that, if an entry already exists.
+[Install]
+WantedBy=multi-user.target
+```
 
 Get flashrom from the libreboot\_util release archive, or build it from
 libreboot\_src/git if you need to. An ARM binary (statically compiled)