Building FlashROM image for the SL-5600 romimage 1.00
This page no longer exists, as the zaurus.com site no longer is around.
Kernel Update: Building FlashROM image for the SL-5600 romimage 1.00
ABOUT THIS DOCUMENT
This document describes the development environment for the PC-Linux required to re-build the Linux environment for the SL-5600, together with the descriptions on how to use the given development environment. The following are the items descibed in this document:
- Image(s) that are to be built
- Required Development Environment
- Building kernel image
- Building root file system (console mode)
- Over-writing the image to FlashROM
Check HERE for how to over-write your kernel to the SL-5600 FlashROM.
RELEASE NOTE Note that this release DOES NOT INCLUDE the following modules due to the copyright and/or License restrictions.
- Root File System:
Qt/Embedded Qtopia (applications including PIM) Opera (Web browser) Jeode (Java Virtual Machine) The root file system in this release invokes getty to the console at the system boot.
IMPORTANT NOTICE (WARNING) SHARP ASSUMES NO RESPONSIBILITY to any confLIct, fault, or damage affecting the unit caused by any attempt by the process given below, and one must acknowledge that SHARP's warranty shall not cover such damages arising from your attempt on re-building the Linux environment for the SL-5600.
IMAGE(S) THAT ARE TO BE BUILT
The following 2 (two) image files are to be built. You may also choose only build one of the following.
- zImage (Linux kernel)
- initrd.bin (root file system)
REQUIRED DEVELOPMENT ENVIRONMENT
The following are the hardware and software requirements to re-build the Linux environment for the SL-5600:
- Host PC
Required HDD Space: approx. 320MB (Total) (for cross development tools): 100MB (for LInux kernel): 200MB (for root file system): 20MB OS: Linux (RedHat6.1, 6.2, 7.1)
- CF Memory Card (32MB or larger)
- CF Memory Card Dock that can be used with the Host PC
(CF Memory card and its dock is needed to over-write the built image to the SL-5600.)
- Cross Development Tools
The following cross-development tools must be installed to the Host PC. Cross Compiler (gcc) Libraries (glibc) Utility Tools (other than gcc)
BUILDING KERNEL IMAGE
The following are the instructions on how to re-build the Linux environment for the SL-5600: Obtaining and Extracting the Kernel Source
- Obtain either one of the following kernel source from the Source Download page on this website:
linux-sl5600-20030509-rom1_00.tar.bz2 (approx. 24MB) Note that the entire source requires the extraction on your host PC as it contains all of the source.
Extracting linux-sl5600-20030509-rom1_00.tar.bz2 Execute the following commands from the console on your host PC:
$ bzcat linux-sl5600-20030509-rom1_00.tar.bz2 | tar xvf -
- Kernel Configuration
Load the kernel configuration file for the SL-5600, and save the kernel configuration as follows:
$ cd Linux $ make menuconfig --> Load an Alternate Configuration File input "arch/arm/def-configs/poodle" select "ok" select "Exit" Do you wish to save your kernel configuration? -> Yes
- Building Kernel Image (zImage)
By executing the following command from the console of your host PC, the kernel image (zImage) will be built under /arch/arm/boot directory within several minutes to several hours. (depending on your host PC processing performance):
$ make dep; make clean; make zImage IMPORTANT NOTICE Make sure to name the kernel image "zImage" (capital "I"), as the following FlashROM update process is case sensitive for the kernel image file name.
BUILDING ROOT FILE SYSTEM (console mode)
The following are the instructions how to re-build the root file system for the SL-5600:
- Obtaining and Extracting the Tarball for the Root File System
You must obtain the Tarball for the root file system ( rootfs-sl5600-20030509-rom1_00.tar.bz2 , approx. 3.8MB) and extract the tar ball on your host PC. In order to extract the tar ball of the root file system, execute following command from the console of your host PC:
$ bzcat rootfs-sl5600-20030509-rom1_00.tar.bz2 | tar xvf - Note that you need to be "root" in order to extract the tar ball.
- Being root under the Extracted Directory
Become root under the directory where the tar ball for the root file system is extracted:
$ cd rootfs su (password)
- Placing Files on the root_cramfs Directory Path
Place the files that you wish to put in the file system for the SL-5600 in the following path of the root_jffs2 directory:
Adding files/directories that are both read/write accessible: In case of adding device nodes: extract root_jffs2/root/.dev_default.tar, and re-archive after adding the device nodes under the extracted dev/. In case of adding file(s)/directorie(s) under /var/: extract root_jffs2/root/.var_default.tar, and re-archive after adding file(s) under the extracted var/. In case of adding file(s)/directorie(s) under /home/: extract root_jffs2/root/.home_default.tar and re-archive after adding file(s) under the extracted home/. Adding files/directories that are read only accessible: The files and directories will be extracted to the FlashROM on the SL-5600 if the file(s) and directorie(s) are placed under root_jffs2.
- Build ROM Image
Execute the following image from the console of your host PC, and build the ROM image for the SL-5600:
- Build Complete
You will get the following files when the above process is executed: initrd.bin
- The built image under this environment DOES NOT include Qt/Embedded and Qtopia.
- The initrd.bin MUST BE MADE TO FIT within the size of 32MB.
- Once you add read/write accessible files, the device will consume the respective size of RAM at the system boot.
- Once you add read/write accessible files, you need to delete all data from the device memory to reflect your changes.