Kiwi BBAI-64 software installation instructions [OBSOLETE 28-Jan-24]
These instructions are no longer valid due to changes at beagleboard.org. Wait for us to finalize a Kiwi-specific Debian 12 release image you can use to re-flash your BBAI-64.
Part 1 of 3
It is very important that you read and understand these instructions before proceeding. If at any time you get an unexpected result STOP and ask for help on the Kiwi forum.
If you subsequently update the Beagle software on your AI via the instructions on https://docs.beagleboard.org/boards/beaglebone/ai-64/update.html, or via the
pkug command, and that update installs a new kernel, then you will have to reinstall the kernel-related Kiwi changes manually as follows. First, make sure you are running the latest Kiwi update. Then type:
reboot (not just a server restart, a full Beagle reboot)
1) Export restrictions. Mouser will likely not ship an AI64 outside of the USA due to export controls on the TI TDA4VM CPU chip. However check the distributor okdo.com for deliveries within Europe. Distributors are listed here: beagleboard.org/ai-64
2) The Beagle P9 cape header connector has been changed on the AI64. It has extra power pins you MUST NOT accidentally use. It is now easier than ever to incorrectly install, and thus instantly destroy, the Kiwi board due to incorrect voltages being applied. Carefully check the installation step below (do NOT install the Kiwi board until instructed to below).
3) DO NOT power the Kiwi+AI64 combo through the Kiwi 5V DC barrel connector. Too much current is required and the Kiwi's common-mode choke will likely burn up. Unlike the AI, the AI64 has both a 2.1/5.5 mm DC barrel connector (same as the Kiwi) and a USB-C power input. Use these instead. The AI64 manual recommends 3A minimum and the Kiwi needs about 1.5A peak. So use a 4.5A minimum supply to avoid problems.
4) If you brick your AI64 (e.g. due to an incorrect sequence of software update steps) then recovery is especially difficult. As of this writing users are reporting problems using many brands of micro SD cards which are necessary to hold a bootable recovery image (see: forum.beagleboard.org/t/sdcard-guaranteed-to-work-with-ai-64/32480)
Also, if a failure causes the AI64 to stop in the bootloader (U-boot), before Debian is even loaded, then you can only recover using the BBAI serial port. You must purchase a USB-to-3.3V serial cable (e.g. uk.farnell.com/ftdi/ttl-232r-3v3/cable-usb-to-ttl-level-serial/dp/1329311) and also an adapter cable from the header of the serial cable to the AI64's tiny JST ZH connector (e.g. uk.farnell.com/element14/1103004000156/beaglebone-ai-serials-cable/dp/3291081)
5) On the plus side, the excellent heat sink of the AI64 is a vast improvement over the AI. A modest fan is all that is required. We use a 5V 120 mm fan spinning at a slow 1500 RPM to reduce noise. It can be powered from the AI64 fan connector (Molex 4-pin PicoBlade, see: forum.beagleboard.org/t/ai-64-fan-header-compatible-male-connector/32231/6) or from one of the USB-A connectors.
6) Do not attempt to make SD card backups on the AI64 using the admin page, backup tab. A different procedure is going to have to be developed.