Difference between revisions of "Building VIBE2 Boot Image"

From Yantrr Wiki
Jump to: navigation, search
(→‎Setup microSD card)
(→‎Debian 8)
 
(49 intermediate revisions by the same user not shown)
Line 15: Line 15:
  
 
= ARM Cross Compiler: GCC =
 
= ARM Cross Compiler: GCC =
−
Download and extract the ARM Cross compiler linaro gcc.
+
Download and extract the ARM Cross compiler linaro gcc. From now on consider '''~/''' is the root directory of compilation setup.
 
  '''~/'''
 
  '''~/'''
  
Line 65: Line 65:
  
 
  git checkout origin/ti-linux-4.4.y -b ti-linux-4.4.y
 
  git checkout origin/ti-linux-4.4.y -b ti-linux-4.4.y
 +
 +
'''For TI v4.9.x:'''
 +
'''~/ti-linux-kernel-dev'''
 +
 +
git checkout origin/ti-linux-4.9.y -b ti-linux-4.9.y
  
 
Update GCC cross compiler path in system.sh
 
Update GCC cross compiler path in system.sh
Line 140: Line 145:
 
  eewiki.net: [user@localhost:~$ export kernel_version=4.4.62-ti-r99]
 
  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=
 
=Root File System=
 
==Debian 8==
 
==Debian 8==
Line 168: Line 278:
  
 
  tar xf debian-8.7-minimal-armhf-2017-03-02.tar.xz
 
  tar xf debian-8.7-minimal-armhf-2017-03-02.tar.xz
 +
 +
 +
==Debian 9==
 +
{| class="wikitable" style="text-align: center;"
 +
! User
 +
! Password
 +
|-
 +
|debian
 +
|temppwd
 +
|-
 +
|root
 +
|root
 +
|-
 +
|}
 +
 +
'''Download:'''
 +
'''~/'''
 +
 +
wget -c https://rcn-ee.com/rootfs/eewiki/minfs/debian-9.1-minimal-armhf-2017-08-08.tar.xz
 +
'''Verify:'''
 +
'''~/'''
 +
sha256sum debian-9.1-minimal-armhf-2017-08-08.tar.xz
 +
ba8f801ee1907f362c61b1c10e7fa1a4c59d766eecfe32803588f33f29f69dd4  debian-9.1-minimal-armhf-2017-08-08.tar.xz
 +
 +
'''Extract:'''
 +
'''~/'''
 +
 +
tar xf debian-9.1-minimal-armhf-2017-08-08.tar.xz
  
 
==Ubuntu 16.04 LTS==
 
==Ubuntu 16.04 LTS==
Line 192: Line 330:
 
  tar xf ubuntu-16.04.2-minimal-armhf-2017-03-02.tar.xz
 
  tar xf ubuntu-16.04.2-minimal-armhf-2017-03-02.tar.xz
  
−
=Setup microSD card=
+
==Copy Root File System==
−
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:
+
tar xfvp ./*-*-*-armhf-*/armhf-rootfs-*.tar -C /media/rootfs/
−
  dd if=/dev/zero of=${DISK} bs=1M
+
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]
 +
-----------------------------
 +
 
 +
{{Box-Info|text=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
  
−
Install Bootloader:
+
==Set uname_r in /boot/uEnv.txt==
 
  '''~/'''
 
  '''~/'''
  
−
  dd if=./u-boot/MLO of=${DISK} count=1 seek=1 bs=128k
+
  sh -c "echo 'uname_r=${kernel_version}' >> /media/rootfs/boot/uEnv.txt"
−
dd if=./u-boot/u-boot.img of=${DISK} count=2 seek=1 bs=384k
+
  
−
Create Partition Layout:
+
==Copy Kernel Image==
−
With util-linux v2.26, sfdisk was rewritten and is now based on libfdisk.
+
  '''~/'''
−
sfdisk --version
+
−
  sfdisk from util-linux 2.27.1
+
  
−
  sfdisk >= 2.26.x
+
  cp -v ./ti-linux-kernel-dev/deploy/${kernel_version}.zImage /media/rootfs/boot/vmlinuz-${kernel_version}
  
−
sfdisk ${DISK} <<-__EOF__
+
==Copy Kernel Device Tree Binaries==
−
4M,,L,*
+
  '''~/'''
−
  __EOF__
+
  
−
=Install Kernel=
+
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 compiled kernel files to already bootable SD-card
+
==Copy Kernel Modules==
 +
'''~/'''
  
−
  '''~/ti-linux-kernel-dev'''
+
  tar xfv ./ti-linux-kernel-dev/deploy/${kernel_version}-modules.tar.gz -C /media/rootfs/
  
−
export kernel_version=4.4.62-ti-r99
+
=Networking=
−
cp -v deploy/${kernel_version}.zImage /media/yantrr/rootfs/boot/vmlinuz-${kernel_version}
+
'''Edit: /etc/network/interfaces'''
−
  mkdir -p /media/yantrr/rootfs/boot/dtbs/${kernel_version}/
+
  sudo nano /media/rootfs/etc/network/interfaces
−
  tar xfv deploy/${kernel_version}-dtbs.tar.gz -C /media/yantrr/rootfs/boot/dtbs/${kernel_version}/
+
 
−
  tar xfv deploy/${kernel_version}-firmware.tar.gz -C /media/yantrr/rootfs/lib/firmware/
+
'''Add:
−
tar xfv deploy/${kernel_version}-modules.tar.gz -C /media/yantrr/rootfs/
+
/etc/network/interfaces'''
−
  nano /media/yantrr/rootfs/boot/uEnv.txt
+
 
 +
  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
 +
 
 +
'''Networking: Using a shared SD card with Multiple VIBE2 boards'''
 +
 
 +
{{Box-Info|text=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
 
  sync
−
lsblk
+
  umount /dev/sdc1
−
  umount /dev/sdb1
+
  eject /dev/sdc
−
  eject /dev/sdb
+
 
 +
=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=
 +
{{Box-Notice|text=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.git
 +
cd ./bb.org-overlays
 +
 
 +
*Verify the dtc version should be latest one
 +
dtc --version
 +
Version: DTC 1.4.1-gXYZXYZXYZ
 +
*Upgrade the dtc
 +
<pre>./dtc-overlay.sh</pre>
 +
*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 :
 +
<pre>
 +
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
 +
</pre>
 +
*Remove Device:
 +
<pre>
 +
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
 +
</pre>
 +
 
 +
=Install Basic Packages=
 +
 
 +
apt-get update
 +
apt-get -y install usbutils wvdial minicom ntp ntpdate i2c-tools git
 +
 
 +
=WiFi Driver=
 +
==VIBE2-RevA==
 +
VIBE2-RevA has Realtek RTL8188CUS chipset for WiFi.
 +
 
 +
Hardware ID ''0bda:8176''
 +
 
 +
If gets any WiFi driver issue, see driver from link https://github.com/pvaret/rtl8192cu-fixes
 +
 
 +
{{Box-Info | text=The RTL8192CU chip as well as other RTL81xx chips uses same drivers.}}
 +
 
 +
==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
 +
 
 +
{{Box-Notice|text=Now configure WiFi network as per needed.}}
 +
 
 +
=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
 +
 
 +
{{Box-Notice|text=On successful eMMC flashing, the VIBE2's User LEDs glow fully and board gets power down afterwards.}}

Latest revision as of 00:46, 23 August 2017

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. From now on consider ~/ is the root directory of compilation setup. 

~/

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

For TI v4.9.x: 

~/ti-linux-kernel-dev

git checkout origin/ti-linux-4.9.y -b ti-linux-4.9.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


Debian 9

User Password
debian temppwd
root root

Download: 

~/

wget -c https://rcn-ee.com/rootfs/eewiki/minfs/debian-9.1-minimal-armhf-2017-08-08.tar.xz

Verify: 

~/
sha256sum debian-9.1-minimal-armhf-2017-08-08.tar.xz
ba8f801ee1907f362c61b1c10e7fa1a4c59d766eecfe32803588f33f29f69dd4  debian-9.1-minimal-armhf-2017-08-08.tar.xz

Extract: 

~/

tar xf debian-9.1-minimal-armhf-2017-08-08.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

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.git
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-RevA

VIBE2-RevA has Realtek RTL8188CUS chipset for WiFi.

Hardware ID 0bda:8176

If gets any WiFi driver issue, see driver from link https://github.com/pvaret/rtl8192cu-fixes

The RTL8192CU chip as well as other RTL81xx chips uses same drivers.

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

Now configure WiFi network as per needed.

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=1218"