Buffalo ARM9 Kernel Port
- 1 Preparation
- 2 Stock GPL Release Kernel
- 3 Mainline and Debian Kernel
If compilation is done on the embedded device itself (or another device with the same architecture), then a native toolchain is sufficient. But as embedded devices are not very powerful, this is normally not the case.
Compilation for the embedded device is normally done on a fast PC. This is called "Cross Compiling".
When cross-compiling the architecture to build for and the prefix of the cross-compiler have to be stated when calling commands. Typing can be reduced by exporting the environment variables ARCH and CROSS_COMPILE with the correct values. All commands listed in this article will explicitly state these parameters.
There are several cross compiler for ARM available:
- Codesourcery's ARM toolchain is recommended as it is also used by Buffalo (see NAS-Central Wiki Page for more info).
- If the cross compile machine runs Debian, Ubuntu, or similar, you can also use the cross compilation toolchain repository supplied by Emdebian.
- Gentoo users may use sys-devel/crossdev.
- Download mkimage to somewhere in your path.
- Gentoo users may get it by emerging dev-embedded/u-boot-tools
- Debian has a package named uboot-mkimage.
- Ensure you have the devio command installed (sys-block/devio in Gentoo and devio in Debian).
Stock GPL Release Kernel
Linux version 22.214.171.124-arm1 (root@I.You) (gcc version 3.4.4 (release) (CodeSourcery ARM 2005q3-2)) #69 Wed Oct 1 10:59:37 JST 2008
How to Get GPL Build Kernel Run Under Linkstation Live Stock Environment
Before You Begin: You don't need the below patch if you don't use your custom build kernel with the Stock environment - especially ture while need to use together with the Stock initrd.buffalo. Product ID below only applicable to Linkstation Live, no need to modify if your box is Linkstation Pro.
In the current release GPL Kernel Soruce above, Buffalo did not provide any means to setup correct Product ID for Linkstation Live in the Makefile. Without the correct Product ID in kernel, Linkstation will enter EM Mode upon reboot. We have to patch one of the source file directly in order to get the kernel work with the Stock initrd and root filesystem.
Code Modification - buffalocore.c
Change directory to top of the source tree and modify buffalo/drivers/buffalocore.c like below:
Search and change the line from: len += sprintf(buf+len,"PRODUCTNAME=LS-GL(IESADA)\n"); to: len += sprintf(buf+len,"PRODUCTNAME=HS-DHGL(JINMU)\n");
Search and change the line from: len += sprintf(buf+len,"PRODUCTID=0x00000009\n"); to len += sprintf(buf+len,"PRODUCTID=0x0000000A\n");
After that you can 'make menuconfig' to add/remove kernel options as usual and build the kernel.
Stock File System Modification
When you reboot the Linkstation with the new build kernel it will enter EM Mode, use acp_commander to reset root password and enable telnet access. Logon to the Linkstation and enter:
grep BUILDDATE /proc/buffalo/firmware
Replace the above grep output line with the same line in /etc/linkstation_release and reboot. Your Linkstation should now resume to normal mode.
Mainline and Debian Kernel
jonli447 and lb_worm were trying to create a patch for the vanilla kernel  so we could use the kernel.org sources for the arm9-buffalo-boxes easily. But the guys from Marvell have done a great job in doing that so the nas-central community have stopped efforts in doing that to focus on helping with the Marvell's git. Marvell's code was merged into 2.6.25 with the latest development going into the Orion repository which has been merged into mainline.
At this time (12/21/2008) the kernel (2.6.28-rc9) supports:
- Buffalo Terastation Pro II/Live
- Buffalo Linkstation Pro/Live
- Buffalo Linkstation Mini
- Linksys WRT350N v2
- Technologic Systems TS-78xx
- LaCie Ethernet Disk mini V2
- Maxtor Shared Storage II
- Netgear WNR854T
- Marvell Orion-VoIP GE Reference Design
- Marvell Orion-VoIP FXO Reference Design
- Marvell Orion-1-90 AP GE Reference Design
- The Buffalo Linkstation Pro/Revogear Kurobox Pro support (MV88F5182)
- The Marvell Orion-2 (MV88F5281) Development Board
- The OrionNAS Reference Design board (MV88F5182)
- The D-Link DNS-323 board (MV88F5181)
- The QNAP TS109/209/409 boards (MV88F5182 & MV88F5281)
- The HP Media Vault mv2120
Containing support for devices:
- The NAND Flash controller
- The SATA controller
- The Ethernet controller
- The USB controller
- The PCI controller
- The GPIO controller
- The Serial Port controller
- The I2C controller
The things that are not yet supported :
- The CESA hardware engine is not yet supported (usefull for cryptographic and security operations)
- The XOR hardware engine is not yet supported (usefull for iSCSI or RAID5 operations)
- OABI rootfs & applications when using a 88F5281-D0 (other SoC are OK)
If you want to talk about this kernel, please do it here
Note: By using the kernels from svn/git, users are still subject to the LinkstationWiki BetaTesters ToS and Disclaimer (Not trying to scare people, just warning newbies).
Prepare Mainline kernel source
This describes how to prepare a vanilla kernel build.
- Obtain the kernel sources, this can either be 2.6.25 or greater from kernel.org or you can use the Orion development repository:
git clone git://git.marvell.com/orion.git
- Change to your sources directory and create the kernel config:
Note that the default kernel configuration for Orion 5x may not work with the intended NAS/device and therefore has to be changed to fit.
make ARCH=arm mrproper make ARCH=arm orion5x_defconfig
Prepare Debian kernel source
- Find out what kernel version is currently used by Debian.
uname -a Linux debian5 2.6.26-2-686 #1 SMP Tue Mar 9 17:35:51 UTC 2010 i686 GNU/Linux
Here it is version 2.6.26 on a Debian 5.0 Lenny system.
- Install the corresponding Debian kernel source package.
aptitude install linux-source-2.6.26
The source archive will be placed in /usr/src.
- Extract the source into the build directory (normally current directory).
tar xjf /usr/src/linux-source-2.6.26.tar.bz2
It will be available in the sub-directory ./linux-source-2.6.26. At this point this is the same as for the Mainline kernel, except for the included Debian patches.
- Additionally the config used by the Debian team for their official kernel is available in the kernel binary package.
The kernel package for the ARM architecture can be downloaded to and extracted on any system.
wget -N http://http.us.debian.org/debian/pool/main/l/linux-2.6/linux-image-2.6.26-2-orion5x_2.6.26-21_armel.deb dpkg-deb -x linux-image-2.6.26-2-orion5x_2.6.26-21_armel.deb linux-image-2.6.26-2-orion5x
The config is available in the sub-directory ./linux-image-2.6.26-2-orion5x/boot. There's a list of other Debian mirrors.
- Clean the build directory and copy the Debian config.
cd linux-source-2.6.26 make ARCH=arm mrproper cp ../linux-image-2.6.26-2-orion5x/boot/config-2.6.26-2-orion5x .config
Note that the default Debian configuration for Orion 5x may not work with the intended NAS/device and therefore has to be changed to fit.
Extra: To find out the 100% correct kernel binary package and version, and not just by browsing the download directory and using uname on another Debian system, a little more investigation has to be done:
- Download the package list for ARM and extract it.
wget -N http://http.us.debian.org/debian/dists/lenny/main/binary-armel/Packages.bz2 bunzip Packages.bz2
- Search the Packages file for the package "linux-image-orion5x", get the value from its "Depends" line, search that package and use its "Filename" value to download from a Debian mirror.
nano Packages # CTRL+W, "Package: linux-image-orion5x" # Copy value from "Depends:" line, e.g. "linux-image-2.6.26-2-orion5x" # CTRL+W, "Package: " + value copied, e.g. "Package: linux-image-2.6.26-2-orion5x" # Copy value from "Filename:" line, e.g. "pool/main/l/linux-2.6/linux-image-2.6.26-2-orion5x_2.6.26-21_armel.deb"
- Run the following command to make any changes to the config file (including any ReiserFS or JFS support).
Setting the Local Version under General Version with a recognizable string is recommended (e.g. -freelink-<your nick>).
make ARCH=arm menuconfig
make ARCH=arm CROSS_COMPILE=/path/to/toolchain/bin/arm-none-linux-gnueabi- zImage
Prepare zImage for embedded device
- After kernel has finished compiling, you need to force it to use the correct mach-type for your device:
# The version number at the end of each line is the kernel version that first # supported that device. Run only the line that corresponds to your device. # This will set the machine type of the kernel, which cannot be autodetected. # Last 2 characters of wl-command form the machine types. So '0631' for the Linkstation Pro. devio > foo 'wl 0xe3a01c06,4' 'wl 0xe3811031,4' # Linkstation Pro/Live (2.6.26) devio > foo 'wl 0xe3a01c05,4' 'wl 0xe38110e5,4' # Kurobox Pro (2.6.25) devio > foo 'wl 0xe3a01c06,4' 'wl 0xe381101d,4' # QNAP TS-109/TS-209 (2.6.25) devio > foo 'wl 0xe3a01c06,4' 'wl 0xe3811041,4' # QNAP TS-409 (2.6.27?) devio > foo 'wl 0xe3a01c06,4' 'wl 0xe3811006,4' # D-Link DNS-323 (2.6.25) devio > foo 'wl 0xe3a01c06,4' 'wl 0xe381109d,4' # HP Media Vault MV2120 (2.6.27?) devio > foo 'wl 0xe3a01c06,4' 'wl 0xe3811074,4' # Technologic Systems TS-78xx SBC (2.6.27?) devio > foo 'wl 0xe3a01c06,4' 'wl 0xe38110e6,4' # Maxtor Shared Storage II (2.6.27) devio > foo 'wl 0xe3a01c06,4' 'wl 0xe3811061,4' # Linksys WRT350N v2 (2.6.27?) devio > foo 'wl 0xe3a01c07,4' 'wl 0xe3811027,4' # Buffalo Linkstation Pro Duo (Is this right?) devio > foo 'wl 0xe3a01c07,4' 'wl 0xe3811042,4' # Buffalo Linkstation Mini devio > foo 'wl 0xe3a01c06,4' 'wl 0xe3811030,4' # Buffalo TS Pro V2 (not yet supported in Vanilla 2.6.26 as of Aug. 10th, 2008) devio > foo 'wl 0xe3a01c07,4' 'wl 0xe3811065,4' # Netronix NH-233 # Run all of the following: cat foo arch/arm/boot/zImage > zImage.new mkimage -A arm -O linux -T kernel -C none -a 0x00008000 -e 0x00008000 -n 'linux' -d zImage.new uImage.new rm foo zImage.new
- The new uImage will be called uImage.new, copy this to its destination. For a Linkstation/Kuro this is the /boot/uImage.buffalo.
- If necessary, compile modules and be sure if you are cross compiling not to set the install path to the hosts root:
make ARCH=arm CROSS_COMPILE=/path/to/toolchain/bin/arm-none-linux-gnueabi- modules make ARCH=arm CROSS_COMPILE=/path/to/toolchain/bin/arm-none-linux-gnueabi- modules_install INSTALL_MOD_PATH=/<absolute/dir/loc/not/root/dir>
- copy lib/ directory that is created to / of linkstation