diff options
| -rw-r--r-- | docs/install/bbb_setup.html | 152 |
1 files changed, 74 insertions, 78 deletions
diff --git a/docs/install/bbb_setup.html b/docs/install/bbb_setup.html index eebc8900..c2637180 100644 --- a/docs/install/bbb_setup.html +++ b/docs/install/bbb_setup.html @@ -15,13 +15,18 @@ <div class="section"> <h1 id="pagetop">How to programme an SPI flash chip with the BeagleBone Black</h1> - <p>This section documents how to use the BBB as an external flashrom programmer, for reading and writing an SPI flash chip.</p> + <p> + This document exists as a guide for reading from or writing to an SPI flash chip with the BeagleBone Black, + using the <a href="http://flashrom.org/Flashrom">flashrom</a> software. + BeagleBone Black rev. C was used when creating this guide, but earlier revisions + may also work. + </p> <p><a href="index.html">Back to previous index</a></p> </div> - <div class="section"> + <div class="section" id="hardware_requirements"> - <h1 id="hardware_requirements">Hardware requirements</h1> + <h1>Hardware requirements</h1> <p> Shopping list (pictures of this hardware is shown later): @@ -30,6 +35,7 @@ <li> External SPI programmer: <b>BeagleBone Black</b> (rev. C) is highly recommended. Sometimes referred to as 'BBB'. + <a href="http://beagleboard.org/black">This page</a> contains a list of distributors. </li> <li> Clip for connecting to the flash chip: if you have a SOIC-16 @@ -40,11 +46,16 @@ (they break easily). </li> <li> - <b>External 3.3V DC power supply</b>. + <b>External 3.3V DC power supply</b>, for powering the flash chip. An ATX power supply / PSU (common on Intel/AMD desktop computers) will work for this. </li> <li> - <b>jumper cables</b> (2.54mm / 0.1" headers) + <b>External 5V DC power supply</b>, for powering the BBB. + The BeagleBone can have power supplied via USB, but a + dedicated power supply is recommended. + </li> + <li> + <b>Pin header / jumper cables</b> (2.54mm / 0.1" headers) You should get male-male, male-female and female-female cables in 10cm and 20cm sizes. Just get a load of them. </li> @@ -53,13 +64,9 @@ with one.) </li> <li> - <b>FTDI serial board</b>, for unbricking the BeagleBone if - necessary. - </li> - <li> - <b>5V DC power supply</b> (from wall outlet to the BeagleBone). - The BeagleBone can have power supplied via USB, but a - dedicated power supply is recommended. + <b>FTDI TTL cable or debug board</b>, for accessing the serial console on your BBB. + <a href="http://elinux.org/Beagleboard:BeagleBone_Black_Serial">This page</a> contains + a list. </li> </ul> @@ -69,7 +76,7 @@ </div> - <div class="section"> + <div class="section" id="psu33"> <h1>Setting up the 3.3V DC PSU</h1> @@ -91,46 +98,63 @@ </p> <p> + The male end of a 0.1" or 2.54mm header cable is not thick enough to remain permanently + connected to the ATX PSU on its own. + When connecting header cables to the connector on the ATX PSU, use a female end attached to + a thicker piece of wire (you could use a paper clip), or wedge the male end of the jumper cable + into the sides of the hole in the connector, instead of going through the centre. + </p> + + <p> Here is an example set up:<br/> <img src="images/x200/psu33.jpg" alt="" title="Copyright © 2015 Patrick "P. J." McDermott <pj@pehjota.net> CC BY-SA 3.0 or later" /> </p> </div> - <div class="section"> + <div class="section" id="bbb_access"> + + <h1>Accessing the operating system on the BBB</h1> + <p> + 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. + </p> + <p> + You will also be using the OS on your BBB for programming an SPI flash chip. + </p> + <h2>Alternatives to SSH (in case SSH fails)</h2> + <p> + You can also use a serial FTDI debug board with GNU Screen, to access the serial console.<br/> + # <b>screen /dev/ttyUSB0 115200</b><br/> + Here are some example photos:<br/> + <img src="images/x200/ftdi.jpg" alt="" /> + <img src="images/x200/ftdi_port.jpg" alt="" /><br/> + </p> + <p> + You can also connect the USB cable from the BBB to another computer and a new network interface will appear, + with its own IP address. This is directly accessible from SSH, or screen:<br/> + # <b>screen /dev/ttyACM0 115200</b> + </p> + <p> + You can also access the uboot console, using the serial method + instead of SSH. + </p> + + </div> + + <div class="section" id="spidev"> + + <h1>Setting up spidev on the BBB</h1> - <h1>Setting up the BBB</h1> - <p> - Your BBB will have an sshd with no password on root. Find it's IP address - (it will use DHCP by default) and set a root password. The steps below - are done while SSH'd into a BBB. - </p> - <p> - You can also use a serial FTDI debug board, with GNU Screen (example):<br/> - # <b>screen /dev/ttyUSB0 115200</b><br/> - <img src="images/x200/ftdi.jpg" alt="" /> - <img src="images/x200/ftdi_port.jpg" alt="" /><br/> - show an FTDI debug board in use. With screen you can then login as root, like you would using SSH.<br/> - Using this, you can also see text output (from kernel, etc) when booting the machine. - </p> - <p> - You can also simply connect the USB cable from the BBB to another computer and a new network interface will appear, - with it's own IP address: this is the BBB. You can SSH into that. Or, you can (example):<br/> - # <b>screen /dev/ttyACM0 115200</b> - </p> - <p> - These instructions may or may not work for you. They are simply the steps that this author took. - </p> - <p> - setting up SPIDEV on the BBB: <a href="http://elinux.org/BeagleBone_Black_Enable_SPIDEV#SPI0">http://elinux.org/BeagleBone_Black_Enable_SPIDEV#SPI0</a> - - If you only setup SPI0, you don't have to disable the HDMI out. (you only need one). - That guide is for seting up the device overlay for SPIDEV, last part is to make it persist across reboots. - Needed to turn the BBB into an SPI flasher. - </p> <p> - Don't bother modifying uEnv.txt. it won't work; - use the workaround here instead: <a href="http://elinux.org/Beagleboard:BeagleBoneBlack_Debian#Loading_custom_capes">http://elinux.org/Beagleboard:BeagleBoneBlack_Debian#Loading_custom_capes</a>. + Log on as root on the BBB, using either SSH or a serial console as defined in + <a href="#bbb_access">#bbb_access</a>. Make sure that you have internet access + on your BBB. </p> + <p> Follow the instructions at <a href="http://elinux.org/BeagleBone_Black_Enable_SPIDEV#SPI0">http://elinux.org/BeagleBone_Black_Enable_SPIDEV#SPI0</a> up to (and excluding) the point where it tells you to modify uEnv.txt @@ -166,26 +190,9 @@ fi </p> Run <b>apt-get update</b> and <b>apt-get upgrade</b> then reboot the BBB, before continuing. </p> + <p> - Run those commands:<br/> - # <b>echo BB-SPI0-01 > /sys/devices/bone_capemgr.*/slots</b><br/> - Then I did:<br/> - # <b>ls -al /dev/spidev0.*</b><br/> - <i>ls: cannot access /dev/spidev0.*: No such file or directory</i><br/> - Then I rebooted and did:<br/> - # <b>cat /sys/devices/bone_capemgr.*/slots</b><br/> - Output: - </p> -<pre> - 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 -</pre> - <p> - And then:<br/> + Check that the firmware exists:<br/> # <b>ls /lib/firmware/BB-SPI0-01-00A0.*</b><br/> Output: </p> @@ -207,16 +214,9 @@ fi 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 </pre> + <p> - Then check if the device exists:<br/> - # <b>ls -al /dev/spidev0.*</b><br/> - Output: - </p> -<pre> -ls: cannot access /dev/spidev0.*: No such file or directory -</pre> - <p> - It didn't exist under that name, but I then did:<br/> + Verify that the spidev device now exists:<br/> # <b>ls -al /dev/spid*</b><br/> Output: </p> @@ -231,7 +231,7 @@ crw-rw---T 1 root spi 153, 0 Nov 19 21:07 /dev/spidev1.0 entry already exists. </p> <p> - Get flashrom from libreboot_util release archive, or build it from libreboot_src/git if you need to. + Get flashrom from the libreboot_util release archive, or build it from libreboot_src/git if you need to. An ARM binary (statically compiled) for flashrom exists in libreboot_util releases. </p> @@ -253,7 +253,7 @@ Note: flashrom can never write if the flash chip isn't found automatically. </div> - <div class="section"> + <div class="section" id="clip"> <h1> Connecting the Pomona 5250/5252 @@ -310,10 +310,6 @@ Note: flashrom can never write if the flash chip isn't found automatically. </p> <p> - That's basically it. Now refer back to the <a href="index.html">installation</a> page for how to use this on your board. - </p> - - <p> <a href="#pagetop">Back to top of page.</a> </p> |