Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Wiki Markup
This is a page about TI's Cortex-A15 based; BeagleBone-AI.
{hide-comments}
{toc:indent=20px|style=disc}
 
h1h2. Availability
Boards:
[BeagleBone-AI|https://www.digikey.com/product-detail/en/beagleboard-org/BBONE-AI/BBONE-AI-ND/10671097] at Digi-Key
[BeagleBone-AI|https://www.digikey.com/product-detail/en/seeed-technology-co-ltd/102110362/1597-102110362-ND/10492208] at Digi-Key
 
Adapters:
[Debug Cable Adapter for FTDI|https://www.digikey.com/product-search/en?keywords=BBCAI-ND] at Digi-Key
[Debug Cable (usb-serial)|https://www.digikey.com/products/en?keywords=768-1015-ND] at Digi-Key
[Replacement HeatSink|https://www.digikey.com/products/en?keywords=294-1098-ND] at Digi-Key
 
h1h2. Vendor Documentation
 
official BeagleBone-AI Support Page: [https://github.com/beagleboard/beaglebone-ai/wiki/System-Reference-Manual]
 
h1h2. Basic Requirements
* Running a recent supported release of Debian, Fedora or Ubuntu on a x86 64bit based PC; without OS Virtualization Software.
* Many of the listed commands assume /bin/bash as the default shell.
* ARM Cross Compiler -- Linaro: [https://www.linaro.org]
** Linaro Toolchain Binaries: [https://www.linaro.org/downloads/]
* Bootloader
** Das U-Boot -- the Universal Boot Loader: [http://www.denx.de/wiki/U-Boot]
** Source: [https://github.com/u-boot/u-boot/]
* Linux Kernel
** Linus's Mainline tree: [https://git.kernel.org/cgitpub/scm/linux/kernel/git/torvalds/linux.git]
* ARM based rootfs
** Debian: [https://www.debian.org]
** Ubuntu: [https://www.ubuntu.com]
 
h1h2. ARM Cross Compiler: GCC
This is a pre-built (64bit) version of Linaro GCC that runs on generic linux, sorry (32bit) x86 users, it's time to upgrade...
Download/Extract:
{code:title=user@localhost:~$}
wget -c https://releases.linaro.org/components/toolchain/binaries/6.5-2018.12/arm-linux-gnueabihf/gcc-linaro-6.5.0-2018.12-x86_64_arm-linux-gnueabihf.tar.xz
tar xf gcc-linaro-6.5.0-2018.12-x86_64_arm-linux-gnueabihf.tar.xz
export CC=`pwd`/gcc-linaro-6.5.0-2018.12-x86_64_arm-linux-gnueabihf/bin/arm-linux-gnueabihf-
{code}
Test Cross Compiler:
{code:title=user@localhost:~$}
${CC}gcc --version
{code}
{code:title=Test Output:}
arm-linux-gnueabihf-gcc (Linaro GCC 6.5-2018.12) 6.5.0
Copyright (C) 2017 Free Software Foundation, Inc.
This is free software; see the source for copying conditions.  There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
{code}
 
h1h2. Bootloader: U-Boot
Das U-Boot -- the Universal Boot Loader: [http://www.denx.de/wiki/U-Boot]
eewiki.net patch archive: [https://github.com/eewiki/u-boot-patches]
Download:
{code:title=user@localhost:~$}
git clone https://github.com/u-boot/u-boot
cd u-boot/
git checkout v2019.07-rc4 -b tmp
{code}
Patches:
{code:title=user@localhost:~/u-boot$}
wget -c https://github.com/eewiki/u-boot-patches/raw/master/v2019.07-rc4/0001-am57xx_evm-fixes.patch
 
patch -p1 < 0001-am57xx_evm-fixes.patch
{code}
Configure and Build:
{code:title=user@localhost:~/u-boot$}
make ARCH=arm CROSS_COMPILE=${CC} distclean
make ARCH=arm CROSS_COMPILE=${CC} am57xx_evm_defconfig
make ARCH=arm CROSS_COMPILE=${CC}
{code}
 
h1h2. Linux Kernel
This script will build the kernel, modules, device tree binaries and copy them to the deploy directory.
h3. TI BSP
Download:
{code:title=~/}
git clone https://github.com/RobertCNelson/ti-linux-kernel-dev.git
cd ti-linux-kernel-dev/
{code}
For TI v4.14.x:
{code:title=~/ti-linux-kernel-dev/}
git checkout origin/ti-linux-4.14.y -b tmp
{code}
For TI v4.14.x: Real-Time
{code:title=~/ti-linux-kernel-dev/}
git checkout origin/ti-linux-rt-4.14.y -b tmp
{code}
Build:
{code:title=user@localhost:~/ti-linux-kernel-dev$}
./build_kernel.sh
{code}
 
h1h2. Root File System
h4h3. Debian 10
|| User || Password ||
| debian | temppwd |
| root | root |
Download:
{code:title=user@localhost:~$}
wget -c https://rcn-ee.com/rootfs/eewiki/minfs/debian-10.23-minimal-armhf-20192020-1102-2310.tar.xz
{code}
 
Verify:
{code:title=user@localhost:~$}
sha256sum debian-10.23-minimal-armhf-20192020-1102-2310.tar.xz
{code}
{code:title=sha256sum output:}
2b2c9f44a8823c772105840725ccc340fafc59545b710f5a0e0a909d6dc4c798a6645dfb49795bbe809dfc3c2b7dff53ad4daab24a654edd29bab29ae007cc40  debian-10.23-minimal-armhf-20192020-1102-2310.tar.xz
{code}
 
Extract:
{code:title=user@localhost:~$}
tar xf debian-10.23-minimal-armhf-20192020-1102-2310.tar.xz
{code}
 
h4h3. Ubuntu 18.04 LTS
|| User || Password ||
| ubuntu | temppwd |
Download:
{code:title=user@localhost:~$}
wget -c https://rcn-ee.com/rootfs/eewiki/minfs/ubuntu-18.04.3-minimal-armhf-20192020-1102-2310.tar.xz
{code}
 
Verify:
{code:title=user@localhost:~$}
sha256sum ubuntu-18.04.3-minimal-armhf-20192020-1102-2310.tar.xz
{code}
{code:title=sha256sum output:}
7135e04fbecb5af40ab8baac368816c59af701facbd622c4505f5cdd127e3e27b28b356d75153bfb3beb5c96bf8eabe92025cf5e665e1a564b469bc70e5a363b  ubuntu-18.04.3-minimal-armhf-20192020-1102-2310.tar.xz
{code}
 
Extract:
{code:title=user@localhost:~$}
tar xf ubuntu-18.04.3-minimal-armhf-20192020-1102-2310.tar.xz
{code}
 
h1h2. Setup microSD card
*We need to access the External Drive to be utilized by the target device. Run lsblk to help figure out what linux device has been reserved for your External Drive.*
{code:title=Example: for DISK=/dev/sdX}
lsblk
NAME   MAJ:MIN RM   SIZE RO TYPE MOUNTPOINT
sda      8:0    0 465.8G  0 disk
├─sda1   8:1    0   512M  0 part /boot/efi
└─sda2   8:2    0 465.3G  0 part /                <- Development Machine Root Partition
sdb      8:16   1   962M  0 disk                  <- microSD/USB Storage Device
└─sdb1   8:17   1   961M  0 part                  <- microSD/USB Storage Partition
{code}
{code:title=Thus you would use:}
export DISK=/dev/sdb
{code}
{code:title=Example: for DISK=/dev/mmcblkX}
lsblk
NAME      MAJ:MIN   RM   SIZE RO TYPE MOUNTPOINT
sda         8:0      0 465.8G  0 disk
├─sda1      8:1      0   512M  0 part /boot/efi
└─sda2      8:2      0 465.3G  0 part /                <- Development Machine Root Partition
mmcblk0     179:0    0   962M  0 disk                  <- microSD/USB Storage Device
└─mmcblk0p1 179:1    0   961M  0 part                  <- microSD/USB Storage Partition
{code}
{code:title=Thus you would use:}
export DISK=/dev/mmcblk0
{code}
 
Erase partition table/labels on microSD card:
{code}
sudo dd if=/dev/zero of=${DISK} bs=1M count=10
{code}
 
Install Bootloader:
{code:title=user@localhost:~$}
sudo dd if=./u-boot/MLO of=${DISK} count=2 seek=1 bs=128k
sudo dd if=./u-boot/u-boot.img of=${DISK} count=4 seek=1 bs=384k
{code}
Create Partition Layout:
*With util-linux v2.26, sfdisk was rewritten and is now based on libfdisk.*
{code:title=Check the version of sfdisk installed on your pc}
sudo sfdisk --version
{code}
{code:title=Example Output}
sfdisk from util-linux 2.27.1
{code}
{code:title=sfdisk >= 2.26.x}
sudo sfdisk ${DISK} <<-__EOF__
4M,,L,*
__EOF__
{code}
{code:title=sfdisk <= 2.25.x}
sudo sfdisk --unit M ${DISK} <<-__EOF__
4,,L,*
__EOF__
{code}
 
Format Partition:
{code}
for: DISK=/dev/mmcblkX
sudo mkfs.ext4 -L rootfs ${DISK}p1
 
for: DISK=/dev/sdX
sudo mkfs.ext4 -L rootfs ${DISK}1
{code}
Mount Partition:
*On most systems these partitions may will be auto-mounted...*
{code}
sudo mkdir -p /media/rootfs/
 
for: DISK=/dev/mmcblkX
sudo mount ${DISK}p1 /media/rootfs/
 
for: DISK=/dev/sdX
sudo mount ${DISK}1 /media/rootfs/
{code}
 
h1h2. Install Kernel and Root File System
To help new users, since the kernel version can change on a daily basis. The kernel building scripts listed on this page will now give you a hint of what kernel version was built.
{code}
-----------------------------
Script Complete
eewiki.net: [user@localhost:~$ export kernel_version=45.X.Y-Z]
-----------------------------
{code}
 
Copy and paste that "export kernel_version=45.X.Y-Z" exactly as shown in your own build/desktop environment and hit enter to create an environment variable to be used later.
{code}
export kernel_version=45.X.Y-Z
{code}
 
h3. Copy Root File System
{code:title=user@localhost:~$}
sudo tar xfvp ./*-*-*-armhf-*/armhf-rootfs-*.tar -C /media/rootfs/
sync
sudo chown root:root /media/rootfs/
sudo chmod 755 /media/rootfs/
{code}
 
h3. Set uname_r in /boot/uEnv.txt
{code:title=user@localhost:~$}
sudo sh -c "echo 'uname_r=${kernel_version}' >> /media/rootfs/boot/uEnv.txt"
{code}
 
h3. Copy Kernel Image
Kernel Image:
{code:title=user@localhost:~$}
sudo cp -v ./ti-linux-kernel-dev/deploy/${kernel_version}.zImage /media/rootfs/boot/vmlinuz-${kernel_version}
{code}
 
h3. Copy Kernel Device Tree Binaries
{code:title=user@localhost:~$}
sudo mkdir -p /media/rootfs/boot/dtbs/${kernel_version}/
sudo tar xfv ./ti-linux-kernel-dev/deploy/${kernel_version}-dtbs.tar.gz -C /media/rootfs/boot/dtbs/${kernel_version}/
{code}
 
h3. Copy Kernel Modules
{code:title=user@localhost:~$}
sudo tar xfv ./ti-linux-kernel-dev/deploy/${kernel_version}-modules.tar.gz -C /media/rootfs/
{code}
 
h3. File Systems Table (/etc/fstab)
{code}
sudo sh -c "echo '/dev/mmcblk0p1  /  auto  errors=remount-ro  0  1' >> /media/rootfs/etc/fstab"
{code}
 
h3. Remove microSD/SD card
{code}
sync
sudo umount /media/rootfs
{code}
 
h1h2. Comments
Any questions or comments please go to our TechForum: [TechForum|https://forum.digikey.com/c/linux-on-arm/]

...