Building VIBE2 Boot Image

From Yantrr Wiki
Revision as of 02:34, 11 May 2017 by Vaibhav (Talk | contribs) (→‎VIBE2-RevA)

Jump to: navigation, search

Note : All steps are executed on the Ubuntu 16.04.2 LTS and as a root user. Most of the steps are similar Robert C Nelson BBB Wiki.

Basic Requirements

ARM Cross Compiler: GCC

Download and extract the ARM Cross compiler linaro gcc. 

~/

wget -c https://releases.linaro.org/components/toolchain/binaries/5.4-2017.01/arm-linux-gnueabihf/gcc-linaro-5.4.1-2017.01-x86_64_arm-linux-gnueabihf.tar.xz
tar xf gcc-linaro-5.4.1-2017.01-x86_64_arm-linux-gnueabihf.tar.xz
export CC=`pwd`/gcc-linaro-5.4.1-2017.01-x86_64_arm-linux-gnueabihf/bin/arm-linux-gnueabihf-

Test: 

~/

${CC}gcc --version
arm-linux-gnueabihf-gcc (Linaro GCC 5.4-2017.01) 5.4.1 20161213
Copyright (C) 2015 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.

Bootloader: U-Boot

Download : 

~/

git clone https://github.com/u-boot/u-boot
cd u-boot/
git checkout v2017.03 -b tmp

Patches : 

wget -c https://rcn-ee.com/repos/git/u-boot-patches/v2017.03/0001-am335x_evm-uEnv.txt-bootz-n-fixes.patch
wget -c https://rcn-ee.com/repos/git/u-boot-patches/v2017.03/0002-U-Boot-BeagleBone-Cape-Manager.patch
 
patch -p1 < 0001-am335x_evm-uEnv.txt-bootz-n-fixes.patch
patch -p1 < 0002-U-Boot-BeagleBone-Cape-Manager.patch

Configure and Build : 

~/u-boot

make ARCH=arm CROSS_COMPILE=${CC} distclean
make ARCH=arm CROSS_COMPILE=${CC} am335x_evm_defconfig
make ARCH=arm CROSS_COMPILE=${CC}

Linux Kernel

TI BSP

Download

~/

git clone https://github.com/RobertCNelson/ti-linux-kernel-dev.git
cd ti-linux-kernel-dev/

For TI v4.4.x: 

~/ti-linux-kernel-dev

git checkout origin/ti-linux-4.4.y -b ti-linux-4.4.y

Update GCC cross compiler path in system.sh 

cp system.sh.sample system.sh

Update CC variable with path with GCC compiler path set above 

nano system.sh
CC=/home/yantrr/gcc-linaro-5.4.1-2017.01-x86_64_arm-linux-gnueabihf/bin/arm-linux-gnueabihf-

Build

~/ti-linux-kernel-dev/

./build_kernel.sh

Update LINUX_GIT variable in system.sh 

nano system.sh
LINUX_GIT=/home/yantrr/ti-linux-kernel-dev/ignore/linux-src/

Change USB0 Mode :

For VIBE/VIBE2, very first you need to change the USB0 dr_mode from peripheral to host in Beaglebone Black kernel source file KERNEL/arch/arm/boot/dts/am335x-bone-common.dtsi while rebuilding the kernel 

&usb0 {
       status = "okay";
       dr_mode = "host";
};

ZTE and Telit modems driver are already in Beaglebone Black kernel source version 4.4, so no need of any patch for it.

USB Driver configuration for SEW modems:

Only needed for SEW modems. 

nano KERNEL/drivers/usb/serial/option.c
/* Yantrr Strongrising products */
#define YANTRR_VENDOR_ID        0x21f5
#define YANTRR_PRODUCT_VAYU3GH    0x2012
#define YANTRR_PRODUCT_VAYU3GC    0x2009
#define YANTRR_DONGLE_ID        0x20a6
#define YANTRR_DONGLE_PRODUCT    0x1105

/*Also, add entries in struct usb_device_id option_ids[]*/
{ USB_DEVICE(YANTRR_VENDOR_ID, YANTRR_PRODUCT_VAYU3GH) },
{ USB_DEVICE(YANTRR_VENDOR_ID, YANTRR_PRODUCT_VAYU3GC) },
{ USB_DEVICE(YANTRR_DONGLE_ID, YANTRR_DONGLE_PRODUCT) },

Rebuild Kernel

~/ti-linux-kernel-dev

./tools/rebuild.sh
VIBE2 Kernel 4.4

Check for PPS support under Device Drivers ---> PPS Support

VIBE2 PPS Support


Final output on terminal : 

-----------------------------
'arch/arm/boot/zImage' -> '/home/yantrr/ti-linux-kernel-dev/deploy/4.4.62-ti-r99.zImage'
'.config' -> '/home/yantrr/ti-linux-kernel-dev/deploy/config-4.4.62-ti-r99'
-rwxr-xr-x 1 root root 8.3M May  2 14:58 /home/yantrr/ti-linux-kernel-dev/deploy/4.4.62-ti-r99.zImage
-----------------------------
Building modules archive...
Compressing 4.4.62-ti-r99-modules.tar.gz...
-rw-r--r-- 1 root root 22M May  2 14:58 /home/yantrr/ti-linux-kernel-dev/deploy/4.4.62-ti-r99-modules.tar.gz
-----------------------------
Building firmware archive...
Compressing 4.4.62-ti-r99-firmware.tar.gz...
-rw-r--r-- 1 root root 1.2M May  2 14:58 /home/yantrr/ti-linux-kernel-dev/deploy/4.4.62-ti-r99-firmware.tar.gz
-----------------------------
Building dtbs archive...
Compressing 4.4.62-ti-r99-dtbs.tar.gz...
-rw-r--r-- 1 root root 1.4M May  2 14:58 /home/yantrr/ti-linux-kernel-dev/deploy/4.4.62-ti-r99-dtbs.tar.gz
-----------------------------
Script Complete
eewiki.net: [user@localhost:~$ export kernel_version=4.4.62-ti-r99]
-----------------------------

Setup microSD card

We are assuming the DISK=/dev/sdc, Please check the device id of SD-Card with lsblk 

export DISK=/dev/sdc

Erase partition table/labels on microSD card: 

dd if=/dev/zero of=${DISK} bs=1M

Install Bootloader: 

~/

dd if=./u-boot/MLO of=${DISK} count=1 seek=1 bs=128k
dd if=./u-boot/u-boot.img of=${DISK} count=2 seek=1 bs=384k

Create Partition Layout:

With util-linux v2.26, sfdisk was rewritten and is now based on libfdisk. 

sfdisk --version
sfdisk from util-linux 2.27.1

For sfdisk >= 2.26.x 

sfdisk ${DISK} <<-__EOF__
4M,,L,*
__EOF__

For sfdisk <= 2.25.x 

sfdisk --unit M ${DISK} <<-__EOF__
4,,L,*
__EOF__

Format Partition:

With mkfs.ext4 1.43, we need to make sure metadata_csum and 64bit are disabled.

As U-Boot CAN NOT currently handle reading files with these newer ext4 options and so Debian 8 (armel/armhf) and Ubuntu 16.04 (armhf) fsck tools will operate correctly. 

mkfs.ext4 -V
mke2fs 1.42.13 (17-May-2015)
	Using EXT2FS Library version 1.42.13

For mkfs.ext4 >= 1.43 

for: DISK=/dev/mmcblk0
mkfs.ext4 -L rootfs -O ^metadata_csum,^64bit ${DISK}p1
  
for: DISK=/dev/sdX
mkfs.ext4 -L rootfs -O ^metadata_csum,^64bit ${DISK}1

For mkfs.ext4 <= 1.42 

for: DISK=/dev/mmcblk0
mkfs.ext4 -L rootfs ${DISK}p1

for: DISK=/dev/sdX
mkfs.ext4 -L rootfs ${DISK}1

Mount Partition:

Normally these partitions will be auto-mounted. 

mkdir -p /media/rootfs/

for: DISK=/dev/mmcblk0
mount ${DISK}p1 /media/rootfs/
  
for: DISK=/dev/sdX
mount ${DISK}1 /media/rootfs/

Backup Bootloader

This version of MLO/u-boot.img will be used on the "eMMC" flasher script on this page. 

~/

sudo mkdir -p /media/rootfs/opt/backup/uboot/
sudo cp -v ./u-boot/MLO /media/rootfs/opt/backup/uboot/
sudo cp -v ./u-boot/u-boot.img /media/rootfs/opt/backup/uboot/

Dealing with old Bootloader in eMMC

If you don't want to clear out the old Bootloader in eMMC add this uEnv.txt to /media/rootfs/ 

~/uEnv.txt

##This will work with: Angstrom's 2013.06.20 u-boot.
  
loadaddr=0x82000000
fdtaddr=0x88000000
rdaddr=0x88080000
  
initrd_high=0xffffffff
fdt_high=0xffffffff
  
#for single partitions:
mmcroot=/dev/mmcblk0p1
  
loadximage=load mmc 0:1 ${loadaddr} /boot/vmlinuz-${uname_r}
loadxfdt=load mmc 0:1 ${fdtaddr} /boot/dtbs/${uname_r}/${fdtfile}
loadxrd=load mmc 0:1 ${rdaddr} /boot/initrd.img-${uname_r}; setenv rdsize ${filesize}
loaduEnvtxt=load mmc 0:1 ${loadaddr} /boot/uEnv.txt ; env import -t ${loadaddr} ${filesize};
loadall=run loaduEnvtxt; run loadximage; run loadxfdt;
  
mmcargs=setenv bootargs console=tty0 console=${console} ${optargs} ${cape_disable} ${cape_enable} root=${mmcroot} rootfstype=${mmcrootfstype} ${cmdline}
  
uenvcmd=run loadall; run mmcargs; bootz ${loadaddr} - ${fdtaddr};

~/

sudo cp -v ./uEnv.txt /media/rootfs/

Root File System

Debian 8

User Password
debian temppwd
root root

Download: 

~/

wget -c https://rcn-ee.com/rootfs/eewiki/minfs/debian-8.7-minimal-armhf-2017-03-02.tar.xz

Verify: 

~/

sha256sum debian-8.7-minimal-armhf-2017-03-02.tar.xz
1ef9c2620ff3f26f7fab839e0a430426110de7dbc7a818d6d89d9abb239d4d23  debian-8.7-minimal-armhf-2017-03-02.tar.xz

Extract: 

~/

tar xf debian-8.7-minimal-armhf-2017-03-02.tar.xz

Ubuntu 16.04 LTS

User Password
ubuntu temppwd

Download: 

~/

wget -c https://rcn-ee.com/rootfs/eewiki/minfs/ubuntu-16.04.2-minimal-armhf-2017-03-02.tar.xz

Verify: 

~/

sha256sum ubuntu-16.04.2-minimal-armhf-2017-03-02.tar.xz
294b2156f71f03a7a297cfaa3edcb6e63b6ad95d46969210e0af231e4e5dd098  ubuntu-16.04.2-minimal-armhf-2017-03-02.tar.xz

Extract: 

~/

tar xf ubuntu-16.04.2-minimal-armhf-2017-03-02.tar.xz

Copy Root File System

~/

tar xfvp ./*-*-*-armhf-*/armhf-rootfs-*.tar -C /media/rootfs/
sync
chown root:root /media/rootfs/
chmod 755 /media/rootfs/

Install Kernel

The kernel building/rebuilding scripts listed on this page will give you a hint of what kernel version was built. 

-----------------------------
Script Complete
eewiki.net: [user@localhost:~$ export kernel_version=4.4.62-ti-r99]
-----------------------------

4.4.62-ti-r99 is built kernel version, change according to your built version .

Copy and paste that "export kernel_version=4.4.62-ti-r99" exactly as shown in your own build/desktop environment and hit enter to create an environment variable to be used later. 

export kernel_version=4.4.62-ti-r99

Set uname_r in /boot/uEnv.txt

~/

sh -c "echo 'uname_r=${kernel_version}' >> /media/rootfs/boot/uEnv.txt"

Copy Kernel Image

~/

cp -v ./ti-linux-kernel-dev/deploy/${kernel_version}.zImage /media/rootfs/boot/vmlinuz-${kernel_version}

Copy Kernel Device Tree Binaries

~/

mkdir -p /media/rootfs/boot/dtbs/${kernel_version}/
tar xfv ./ti-linux-kernel-dev/deploy/${kernel_version}-dtbs.tar.gz -C /media/rootfs/boot/dtbs/${kernel_version}/

Copy Kernel Modules

~/

tar xfv ./ti-linux-kernel-dev/deploy/${kernel_version}-modules.tar.gz -C /media/rootfs/

Networking

Edit: /etc/network/interfaces 

sudo nano /media/rootfs/etc/network/interfaces

Add: /etc/network/interfaces 

auto lo
iface lo inet loopback
  
auto eth0
allow-hotplug eth0
#iface eth0 inet dhcp
iface eth0 inet static
    address 192.168.1.150
    netmask 255.255.255.0
    network 192.168.1.0
    gateway 192.168.1.1

# WiFi Setup Client on wlan0
#allow-hotplug wlan0
#iface wlan0 inet dhcp
#    wpa-conf /etc/wpa_supplicant/wpa_supplicant.conf

# WiFi Setup AP on wlan0
allow-hotplug wlan0
iface wlan0 inet static
    address 192.168.12.1
    netmask 255.255.255.0
    post-up service isc-dhcp-server start; sleep 2; service hostapd start

Networking: Using a shared SD card with Multiple VIBE2 boards

To always enable the Ethernet interface as eth0 and WiFi interface as wlan0.

Edit: /etc/udev/rules.d/70-persistent-net.rules 

sudo nano /media/rootfs/etc/udev/rules.d/70-persistent-net.rules

Add: /etc/udev/rules.d/70-persistent-net.rules 

# VIBE2: net device ()
SUBSYSTEM=="net", ACTION=="add", DRIVERS=="?*", ATTR{dev_id}=="0x0", ATTR{type}=="1", KERNEL=="eth*", NAME="eth0"

# Wifi Device
SUBSYSTEM=="net", ACTION=="add", DRIVERS=="?*", ATTR{dev_id}=="0x0", ATTR{type}=="1", KERNEL=="wlan*", NAME="wlan0"

Remove microSD/SD card

Check the device id of SD card using lsblk and use below steps for safely removal of microSD/SD card 

sync
umount /dev/sdc1
eject /dev/sdc

Boot with microSD card

Now after safely removal of microSD card from Desktop/Laptop, insert it in VIBE2's microSD card slot.

Connect Ethernet cable to VIBE2 board.

Additionally you can connect USB-To-UART connector (supplied with VIBE2-RevA) with UART0 of VIBE2-RevA or microUSB cable with Diagnostic Port of VIBE2-RevB, for monitoring the boot up activities.

Hold down the Boot Switch S2 (which is on top of microSD card slot) and while holding S2 switch connect the power adapter. Keep holding S2 switch until Blue User LEDs starts glowing.

Device Tree Overlays

This is just to ensure that all the correct overlays should in rebuild image.

Installation Steps

  • Clone the repo
cd /root/
git clone https://github.com/beagleboard/bb.org-overlays
cd ./bb.org-overlays
  • Verify the dtc version should be latest one
dtc --version
Version: DTC 1.4.1-gXYZXYZXYZ
  • Upgrade the dtc
./dtc-overlay.sh
  • Install *.dtbo
cd /root/bb.org-overlays
./install.sh

Note: This will copies all the dtbo files after compilation automatically in directory /lib/firmware/

capemgr: enable/disable capes on kernel cmdline

Comma delimited list of PART-NUMBER[:REV] of [enabled/disabled] capes 

bone_capemgr.enable_partno=
bone_capemgr.disable_partno=

capemgr: enable/disable capes with slots

  • Slots :
root@beaglebone:~# cat /sys/devices/platform/bone_capemgr/slots
0: PF----  -1
1: PF----  -1
2: PF----  -1
3: PF----  -1
  • Add Device :
root@beaglebone:~# sh -c "echo 'BB-UART4' > /sys/devices/platform/bone_capemgr/slots"
root@beaglebone:~# cat /sys/devices/platform/bone_capemgr/slots
 0: PF----  -1
 1: PF----  -1
 2: PF----  -1
 3: PF----  -1
 4: P-O-L-   0 Override Board Name,00A0,Override Manuf,BB-UART4
  • Remove Device:
root@beaglebone:~# sh -c "echo '-4' > /sys/devices/platform/bone_capemgr/slots"
root@beaglebone:~# cat /sys/devices/platform/bone_capemgr/slots
 0: PF----  -1
 1: PF----  -1
 2: PF----  -1
 3: PF----  -1

Install Basic Packages

apt-get update
apt-get -y install usbutils wvdial minicom ntp ntpdate i2c-tools git

WiFi Driver

VIBE2-RevB

VIBE2-RevB has Realtek RTL8723BU chipset for WiFi+BLE.

Hardware ID 0bda:b720

Driver Link : https://github.com/lwfinger/rtl8723bu

  • Install Dependency Packages
apt-get install --reinstall linux-headers-$(uname -r) build-essential git
  • Clone Driver Repository
cd /root/
git clone https://github.com/lwfinger/rtl8723bu.git
  • Set Non-Concurrent Mode for WiFi
cd rtl8723bu
nano Makefile

Find the line that contains EXTRA_CFLAGS += -DCONFIG_CONCURRENT_MODE and insert a # symbol at the beginning of that line. This comments that line and disables concurrent mode. 

cd /root/rtl8723bu
make
make install
modprobe -v 8723bu
  • For Bluetooth tools/utilities
apt-get install bluetooth

Flash eMMC

  • Login into VIBE2
ssh root@192.168.1.150
password: root
  • Execute eMMC Flashing script
cd /opt/scripts/tools/eMMC/
./init-eMMC-flasher-v3.sh

On successful eMMC flashing, the VIBE2's User LEDs glow fully and board gets power down afterwards.

Retrieved from "http://wiki.yantrr.com/index.php?title=Building_VIBE2_Boot_Image&oldid=1090"