This is the external Buildroot repository used to build system images and updates for the MynaPlayer project.
A changelog is available so that users and developers can quickly check what changed between releases.
Building MynaPlayer is an easy process, though it requires decent hardware.
First install Buildroot's required dependencies. See: The buildroot user manual, chapter 2: System requirements
Then set up the required source code:
mkdir MYNA && cd MYNA
tar -xf EasyRSA-3.0.7.tgz
tar -xf buildroot-2020.05.1.tar.gz
mv EasyRSA-3.0.7 easy-rsa
mv buildroot-2020.05.1 buildroot
git clone 'https://git.lumina-sensum.com/git/LuminaSensum/buildroot-MynaPlayer.git'
for p in ../buildroot-MynaPlayer/buildroot-patches/*.patch; do patch -p1 < $p; done
Create keys for RAUC updates:
sed -i "s/extendedKeyUsage/#extendedKeyUsage/g" x509-types/code-signing
./easyrsa gen-req rauc
./easyrsa sign-req code-signing rauc
cat >buildroot-MynaPlayer/scripts/certs.sh <<EOF
Build the image:
make O=output_build myna_player_odyssey_defconfig
make O=output_build -j8
Installing via dd
For the initial install of Buildroot you'll need to write a full system image to your board's storage.
To flash to eMMC, first boot Linux from an SD card on the board. See Seeed's ODYSSEY STM32MP157C Wiki page for instructions on how to do this.
First, copy the image to the board from your build server. In this case I'll use SFTP over SSH:
sftp build-server:/home/jookia/MYNA/buildroot/output_build/images/MynaPlayer.img .
Now write it to the eMMC:
dd if=MynaPlayer.img of=/dev/mmcblk0
Switch to eMMC boot and reboot.
You can use this method to install updates, but it's much slower compared to RAUC.
Updating via RAUC
To update using RAUC you'll need a server to host the files.
In this example I'll be using a web server (www.jookia.org) which serves contents from /var/www/www.jookia.org/.
First, copy RAUC bundles and keys to your server:
# Find the file ending in *.raucb
# You can also just flash MynaPlayer.img using dd but it takes a long time
mv buildroot/output_build/images/bundle-MynaPlayer.2020-09-06.raucb /var/www/www.jookia.org/
cp $PWD/easy-rsa/pki/ca.crt /var/www/www.jookia.org/
chmod a+r /var/www/www.jookia.org/ca.crt
Install the update on the device from the server:
mv ca.crt /etc/rauc/keyring.pem
rauc install https://www.jookia.org/bundle-MynaPlayer.2020-09-06.raucb
- The bundle file name is derived from git describe, and might differ slightly if you use a branch with committed but not yet released work. E.g: bundle-MynaPlayer.2020-09-06-18-g3d0589f.raucb.
- If you have uncommitted work present in your branch, then the file name will have a 'dirty' tag added.
- If your git index and cache become corrupted for any reason, your bundle will have a 'broken' tag added. This doesn't indicate by any means that your image is broken!
Future updates won't need to copy the keyring, a single 'rauc install' invocation should download and install the image without trouble.
You should now be running a system you've just built (check the kernel build date):
# Linux MynaPlayer 5.8.0 #3 SMP PREEMPT Thu Aug 6 03:21:30 EDT 2020 armv7l GNU/Linux