Difference between revisions of "AXIOM Beta Firmware Version 2.0"

Revision as of 13:14, 10 October 2019

Get a new Micro SD card (4GB is enough, bigger is fine as well, but the partitions are not yet automatically resized when a bigger SD card is detected).
Acquire the latest automatically built firmware image from: https://github.com/apertus-open-source-cinema/axiom-beta-firmware/releases - don't be alarmed by the name "Unstable Development Snapshot" it just means the firmware has been automatically built without human interaction.
Download, install and start Etcher: https://www.balena.io/etcher/
Flash the acquired image to a new Micro SD card with Etcher (we highly recommend not overwriting the Micro SD card you currently use in your AXIOM Beta).
After flashing put the Micro SD card into the AXIOM Beta Microzed SD card slot and power up the Beta.

This new firmware is still in development so expect issues and bugs.

If you find a new bug or have ideas for improvement please add it as github issue (please first check it has not been reported yet).

Sudo is required to change system/camera settings (like running the various scripts)
All camera related programs and scripts are now prefixed with axiom- (for example to run set_gain.sh use run axiom-set_gain.sh)
kick_manual.sh was renamed to start.sh
halt_manual.sh was renamed to stop.sh
Image build log is located in each image under: /var/build.log
Devicetree source can be found at /boot/devicetree.dts. To recompile it after any changes use dtc -O dtb -o /boot/devicetree.dtb /boot/devicetree.dts
To interrupt the autoboot from u-boot send Ctrl-C over serial quickly after a boot / reboot (try holding it down)
axiom-file-check.sh does an integrity check of /usr, /etc and /opt
Binaries are linked in: /usr/axiom/bin
Scripts are linked in: /usr/axiom/script
/opt/axiom-firmware contains scripts and binaries
Every AXIOM Beta currently has the same MAC address - a random one should be generated on the first boot, but this is not implemented yet.

FPGA bitstreams are located in /usr/lib/firmware and softlinked to from /opt/bitstreams/
*.bit files need to be converted to *.bin files with: /opt/axiom-firmware/makefiles/in_chroot/to_raw_bitstream.py -f input_file.bit output_file.bin

Further documentation:

@@ Line 25: / Line 25: @@
 * <code>axiom-file-check.sh</code> does an integrity check of /usr, /etc and /opt
 * Binaries are linked in: <code>/usr/axiom/bin</code>
-* FPGA bitstreams are located in <code>/usr/lib/firmware</code> and softlinked to from <code>/opt/bitstreams/</code>
 * Scripts are linked in: <code>/usr/axiom/script</code>
 * <code>/opt/axiom-firmware</code> contains scripts and binaries
 * Every AXIOM Beta currently has the same MAC address - a random one should be generated on the first boot, but this is not implemented yet.
+===FPGA Bitstreams===
+* FPGA bitstreams are located in <code>/usr/lib/firmware</code> and softlinked to from <code>/opt/bitstreams/</code>
+* *.bit files need to be converted to *.bin files with: /opt/axiom-firmware/makefiles/in_chroot/to_raw_bitstream.py -f input_file.bit output_file.bin
 '''Further documentation:'''