Difference between revisions of "AXIOM Beta Firmware Version 2.0"

Revision as of 13:43, 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 (from old firmware) need to be converted to *.bin files (for new firmware) with:/opt/axiom-firmware/makefiles/in_chroot/to_raw_bitstream.py -f input_file.bit output_file.bin
make sure to load new bitstreams as root (sudo su) and not with sudo or use echo axiom-fpga-main.bin | sudo tee /sys/class/fpga_manager/fpga0/firmware

Further documentation:

@@ Line 32: / Line 32: @@
 * FPGA bitstreams are located in <code>/usr/lib/firmware</code> and softlinked to from <code>/opt/bitstreams/</code>
 * *.bit files (from old firmware) need to be converted to *.bin files (for new firmware) with:<code>/opt/axiom-firmware/makefiles/in_chroot/to_raw_bitstream.py -f input_file.bit output_file.bin</code>
+* make sure to load new bitstreams as root (<code>sudo su</code>) and not with <code>sudo</code> or  use <code>echo axiom-fpga-main.bin | sudo tee /sys/class/fpga_manager/fpga0/firmware</code>
 '''Further documentation:'''