summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorRoland Hieber <r.hieber@pengutronix.de>2018-04-09 10:59:33 +0200
committerSascha Hauer <s.hauer@pengutronix.de>2018-04-10 09:07:37 +0200
commitaa5d8192ab530e7e83dff4a3c03bfb46e5e660c3 (patch)
tree33bbb90383e92e5168bb7e618d484e183aa9f04a
parent5d4047e777f896d1390bb79cd6fb60a845831aa8 (diff)
downloadbarebox-aa5d8192ab530e7e83dff4a3c03bfb46e5e660c3.tar.gz
barebox-aa5d8192ab530e7e83dff4a3c03bfb46e5e660c3.tar.xz
doc: bcm283x: update documentation for Raspberry Pi
The old way does not seem to work for RPi 3, as the UART pins are mapped differently and the NOOBS bootcode does not seem to read a config.txt. Signed-off-by: Roland Hieber <r.hieber@pengutronix.de> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
-rw-r--r--Documentation/boards/bcm2835.rst34
1 files changed, 26 insertions, 8 deletions
diff --git a/Documentation/boards/bcm2835.rst b/Documentation/boards/bcm2835.rst
index 13cebb01c4..79ea0ff7a7 100644
--- a/Documentation/boards/bcm2835.rst
+++ b/Documentation/boards/bcm2835.rst
@@ -1,17 +1,35 @@
-Broadcom BCM2835
+Broadcom BCM283x
================
Raspberry Pi
------------
- 1. Prepare a card with a FAT filesystem. Download a tiny NOOBS LITE
- zip archive and unpack it into FAT partition.
- See http://www.raspberrypi.org/help/noobs-setup/ for details.
+ 1. Prepare an SD or microSD card with a FAT filesystem of at least 30 MB in size.
- 2. Compile ``barebox.bin`` image (use ``rpi_defconfig``).
- Copy it to the SD/microSD card and name it ``recovery.img``.
+ 2. Download the `Raspberry Pi firmware`_ (120 MB), unzip it, and copy the
+ contents of the ``boot/`` folder to your card.
- 3. Connect to board's UART (115200 8N1);
+ 3. Use ``make rpi_defconfig; make`` to build barebox. This will create the following images:
+
+ - ``images/barebox-raspberry-pi-1.img`` for the BCM2835/ARM1176JZF-S (Raspberry Pi 1)
+ - ``images/barebox-raspberry-pi-2.img`` for the BCM2836/CORTEX-A7 (Raspberry Pi 2)
+ - ``images/barebox-raspberry-pi-3.img`` for the BCM2837/CORTEX-A53 (Raspberry Pi 3, Raspberry Pi Zero)
+
+ Copy the respective image for your model to your SD card and name it
+ ``barebox.img``.
+
+ 4. Create a text file ``config.txt`` on the SD card with the following content::
+
+ kernel=barebox.img
+ enable_uart=1
+ dtoverlay=pi3-miniuart-bt
+
+ (For more information, refer to the `documentation for config.txt`_.)
+
+ 5. Connect to board's UART (115200 8N1);
Use PIN6 (GND), PIN8 (UART_TX), PIN10 (UART_RX) pins.
- 4. Turn board's power on.
+ 6. Turn board's power on.
+
+.. _Raspberry Pi firmware: https://codeload.github.com/raspberrypi/firmware/zip/80e1fbeb78f9df06701d28c0ed3a3060a3f557ef
+.. _documentation for config.txt: https://www.raspberrypi.org/documentation/configuration/config-txt/