[libre-testing]: barebox: Add installation instructions

The barebox binaries built with this package were tested
with a beaglebone green, with an already configured
barebox environment. The system booted fine.

TODO before migrating to libre:
- Package the utilities
- Make sure that Parabola can fully boot once barebox is
  installed, without having to mess with the environment
  through the serial port.

TODO:
- Add an installation script to install barebox in a way that is
  similar to what people are used with GRUB.
- Enable USB console at boot
- Add support for other architectures (i686, x86_64)

Signed-off-by: Denis 'GNUtoo' Carikli <GNUtoo@cyberdimension.org>

2 files changed, 35 insertions, 1 deletions

diff --git a/libre-testing/barebox/PKGBUILD b/libre-testing/barebox/PKGBUILD
index 133cbd700..47dd21280 100644
--- a/libre-testing/barebox/PKGBUILD
+++ b/libre-testing/barebox/PKGBUILD
@@ -4,12 +4,13 @@
 _pkgname=barebox
 pkgname=barebox-am335x
 pkgver=2018.12.0
-pkgrel=1
+pkgrel=2
 pkgdesc="Barebox for devices with an am335x system on a chip"
 arch=('armv7h')
 makedepends=('lzop')
 url="http://barebox.org/"
 license=('GPL2')
+install=${_pkgname}.install
 source=("http://barebox.org/download/${_pkgname}-${pkgver}.tar.bz2")
 sha512sums=('3f83c1057e16fac1ee3afac849e5f0a1e2353b767754e6f206178c99d709bc4b22127be9c340be471592c4c650f25e91fcc5a5ad28a8375a049a41a417c08dd1')
 
diff --git a/libre-testing/barebox/barebox.install b/libre-testing/barebox/barebox.install
new file mode 100644
index 000000000..dfe689b82
--- /dev/null
+++ b/libre-testing/barebox/barebox.install
@@ -0,0 +1,33 @@
+install_barebox() {
+  echo "To install barebox on supported am335x computers , you need to first make sure that:"
+  echo "- Your board is capable of booting from microSD or eMMC"
+  echo "  For that it's best to consult your board documentation to see:"
+  echo "  - which boot media it supports"
+  echo "  - in which order it tries to boot on them"
+  echo "- The boot media(the microSD or eMMC) is partitioned with MBR"
+  echo "- The boot partition has the bootable flag set. It can be set with fdisk."
+  echo "- Your boot partition is formatted in FAT12, FAT16 or FAT32"
+  echo ""
+  echo "Note that in some case it may not work if your boot media that is smaller than 4GB"
+  echo ""
+  echo "You can then install and update barebox on the Beaglebone green computer by running:"
+  echo "  # cp -f /boot/barebox/barebox-am33xx-beaglebone-mlo.img /boot/MLO"
+  echo "  # cp -f /boot/barebox/barebox-am33xx-beaglebone.img /boot/barebox.bin"
+  echo ""
+  echo "This package also supports other am33xx computers."
+  echo "You can also install barebox on them in a very similar way."
+  echo "You just need to change the filenames to the one that corresponds to your computer."
+  echo ""
+  echo "The installation procedure may change in the future, to make it more easy."
+}
+
+## arg 1:  the new package version
+post_install() {
+  install_barebox
+}
+
+## arg 1:  the new package version
+## arg 2:  the old package version
+post_upgrade() {
+  install_barebox
+}