Difference between revisions of "BeagleBoneBlack Rebuild Debian Image Using image-builder"

From eLinux.org
Jump to: navigation, search
(As a simple guide and reference for how to build BBB bebian image using image-builder)
 
(One intermediate revision by the same user not shown)
Line 89: Line 89:
 
Here, the modified build script was created to build 'debian-x.x-lxde-4gb-armhf' target image only:
 
Here, the modified build script was created to build 'debian-x.x-lxde-4gb-armhf' target image only:
 
[[File:5 Rebuild Debian Image Using image-builder build.png|framed|none]]
 
[[File:5 Rebuild Debian Image Using image-builder build.png|framed|none]]
 +
 +
Build script run finished:
 +
[[File:6 Rebuild Debian Image Using image-builder build finish.png|framed|none]]
 +
 +
=== Image Generation ===
 +
Next is to generate the final images.
 +
 +
==== Preparation ====
 +
Make sure there's no missing dependencies, otherwise you may get below warning and errors, and generated images will not be usable.
 +
<syntaxhighlight lang="bash">-----------------------------
 +
Debug: ARM rootfs: armhf-rootfs-debian-wheezy.tar
 +
Debug: image has post-uEnv.txt file
 +
You're missing command partprobe (consider installing package parted)
 +
You're missing command kpartx (consider installing package kpartx)
 +
 +
Your system is missing some dependencies
 +
Debian/Ubuntu: sudo apt-get install dosfstools git-core kpartx wget parted
 +
Fedora: yum install dosfstools dosfstools git-core wget
 +
Gentoo: emerge dosfstools git wget</syntaxhighlight>
 +
[[File:7 Rebuild Debian Image Using image-builder image generation prepare.png|framed|none]]
 +
 +
To install dependencies, as the debug messages indicated:
 +
<syntaxhighlight lang="bash">Debian/Ubuntu: sudo apt-get install dosfstools git-core kpartx wget parted
 +
Fedora: yum install dosfstools dosfstools git-core wget
 +
Gentoo: emerge dosfstools git wget</syntaxhighlight>
 +
 +
==== Generate Images ====
 +
Navigate to the ''deploy'' directory and run the ''gift_wrap_final_images.sh'':
 +
[[File:8 Rebuild Debian Image Using image-builder image generation.png|framed|none]]
 +
 +
==== Images Generated ====
 +
The final images will be generated:
 +
[[File:9 Rebuild Debian Image Using image-builder image generation finish.png|framed|none]]
 +
You may find out "bone-debian-7.8-lxde-4gb-armhf-2015-06-24-4gb.img.xz" looks familiar :) Checkout latest BBB Debian images at: http://beagleboard.org/latest-images
 +
 +
=== Generated Image Testing ===
 +
Extract the generated image, burn it to SD card, boot and test it:
 +
[[File:10 Rebuild Debian Image Using image-builder test.png|framed|none]]
 +
 +
=== Misc ===
 +
 +
==== BBB CPU Frequency ====
 +
You may check your BBB CPU frequency before doing the build task.
 +
To check the frequency:
 +
<syntaxhighlight lang="bash">cpufreq-info</syntaxhighlight>
 +
To set to 1GHZ for example:
 +
<syntaxhighlight lang="bash">sudo cpufreq-set -f 1000MHZ</syntaxhighlight>
 +
[[File:11 Rebuild Debian Image Using image-builder cpufreq.png|framed|none]]

Latest revision as of 23:31, 25 June 2015

Debian Build Instructions

Brief Build Instructions

You'll want a fairly beefy ARM system to run this script. Pickup up any beefy armv7-a system, Dual Core+ / 512Mb+ / sata (or usb-sata), running Ubuntu or Debian.

git clone git://github.com/beagleboard/image-builder.git && cd image-builder
./beagleboard.org_image.sh

Problem with Cross Build

Why you want a ARM system to build the Debian, the reason is cross build have problem currently. qemu is just not reliable enough to run this build script on x86. Building on x86 through qemu 'sometimes' work, lots of random things can happen. ;) The usual failure point for qemu is:

Generating locales (this might take a while)...
  en_US.UTF-8... done
Generation complete.
Log: (chroot): manual_deborphan
Log: (chroot): add_user
i2c:x:114:
kmem:x:15:
netdev:x:108:
Log: (chroot) adding admin group to /etc/sudoers
debian:x:1000:1000:Demo User:/home/debian:/bin/bash
Enter new UNIX password: Retype new UNIX password: passwd: password updated successfully
Log: (chroot): startup_script
Log: (chroot): debian_startup_script
Log: (chroot) Warning, qemu can fail here... (run on real armv7l hardware for production images)
Log: (chroot): [git clone https://github.com/RobertCNelson/boot-scripts /opt/scripts/ --depth 1]
Cloning into '/opt/scripts'...
POST git-upload-pack (189 bytes)
POST git-upload-pack (198 bytes)
remote: Counting objects: 90, done.
remote: Compressing objects: 100% (74/74), done.

Using BBB to Build

Well if you do not have a fairly beefy ARM system to run this build script. You can use your BeagleBoneBlack to build debian images for the BeagleBoneBlack ;) , Although building speed using BBB board will be very slow (It takes up to several hours depending on you network speed and your SD card speed etc.).

Prepare Build Environment

Prepare BBB Board

First thing is to get the official debian image flashed into eMMC of your BeagleBoneBlack board. And after that boot from the eMMC. Beagleboard:BeagleBoneBlack_Debian#Flashing_eMMC

Make Sure System Time is Correct

If BBB system time is incorrect, it may result in building failure, so before start building, make sure system time is correct.

Prepare SD Card

Image building requires storage space, so external storage is needed. USB Storage Device may also work, but haven't been tested yet. Build inside SD card tested working. You may need 64GB SD card to perform full build. 16GB SD card may possible if you modify the build scripts to build one single target only. (The full build will build 'debian-x.x-lxde-armhf', 'debian-x.x-lxde-4gb-armhf' and 'debian-x.x-console-armhf', if you are interested in building image for BBB Rev C only for example, you can build 4gb image alone by modifying the build script).

Prepare SD card as ext4 file system. Make sure there's enough free space.

Normally when SD card inserted, it will be mounted automatically by the debian system under /media. However normally you will not be able to run the build, unmount and remount with exec and dev flags is needed.

debian@beaglebone:/media$ ls
32G  BEAGLEBONE
debian@beaglebone:/media$ ls 32G/
backup  build_install  test  Trash
debian@beaglebone:/media$ sudo umount 32G/
debian@beaglebone:/media$ ls
BEAGLEBONE
debian@beaglebone:/media$ sudo mkdir SD32
debian@beaglebone:/media$ ls
BEAGLEBONE  SD32
debian@beaglebone:/media$ lsblk
NAME         MAJ:MIN RM   SIZE RO TYPE MOUNTPOINT
mmcblk0boot0 179:8    0     1M  1 disk 
mmcblk0boot1 179:16   0     1M  1 disk 
mmcblk0      179:0    0   3.7G  0 disk 
├─mmcblk0p1  179:1    0    96M  0 part /media/BEAGLEBONE
└─mmcblk0p2  179:2    0   3.6G  0 part /
mmcblk1      179:24   0  29.5G  0 disk 
└─mmcblk1p1  179:25   0  29.5G  0 part 
debian@beaglebone:/media$ sudo mount -o rw,exec,dev /dev/mmcblk1p1 ./SD32/
debian@beaglebone:/media$ ls SD32/
backup  build_install  test  Trash
debian@beaglebone:/media$
2 Rebuild Debian Image Using image-builder Prepare SD Card.png

Build

git clone git://github.com/beagleboard/image-builder.git && cd image-builder
./beagleboard.org_image.sh
3 Rebuild Debian Image Using image-builder git.png

You may checkout a stable release revision for your build:

4 Rebuild Debian Image Using image-builder git 2.png

Here, the modified build script was created to build 'debian-x.x-lxde-4gb-armhf' target image only:

5 Rebuild Debian Image Using image-builder build.png

Build script run finished:

6 Rebuild Debian Image Using image-builder build finish.png

Image Generation

Next is to generate the final images.

Preparation

Make sure there's no missing dependencies, otherwise you may get below warning and errors, and generated images will not be usable.

-----------------------------
Debug: ARM rootfs: armhf-rootfs-debian-wheezy.tar
Debug: image has post-uEnv.txt file
You're missing command partprobe (consider installing package parted)
You're missing command kpartx (consider installing package kpartx)

Your system is missing some dependencies
Debian/Ubuntu: sudo apt-get install dosfstools git-core kpartx wget parted
Fedora: yum install dosfstools dosfstools git-core wget
Gentoo: emerge dosfstools git wget
7 Rebuild Debian Image Using image-builder image generation prepare.png

To install dependencies, as the debug messages indicated:

Debian/Ubuntu: sudo apt-get install dosfstools git-core kpartx wget parted
Fedora: yum install dosfstools dosfstools git-core wget
Gentoo: emerge dosfstools git wget

Generate Images

Navigate to the deploy directory and run the gift_wrap_final_images.sh:

8 Rebuild Debian Image Using image-builder image generation.png

Images Generated

The final images will be generated:

9 Rebuild Debian Image Using image-builder image generation finish.png

You may find out "bone-debian-7.8-lxde-4gb-armhf-2015-06-24-4gb.img.xz" looks familiar :) Checkout latest BBB Debian images at: http://beagleboard.org/latest-images

Generated Image Testing

Extract the generated image, burn it to SD card, boot and test it:

10 Rebuild Debian Image Using image-builder test.png

Misc

BBB CPU Frequency

You may check your BBB CPU frequency before doing the build task. To check the frequency:

cpufreq-info

To set to 1GHZ for example:

sudo cpufreq-set -f 1000MHZ
11 Rebuild Debian Image Using image-builder cpufreq.png