User manual

3 Software Configuration
3. Software Configuration
The OnRISC comes with a preinstalled Debian GNU/Linux on ARM
5
operating system. The com-
plete system image (see Section 3.7) provides necessary tools and services to start with application
development, various services such as web and mail server, Samba server, etc. For office tasks it
provides an X-Server with graphical desktop manager and some office software.
This image can be downloaded from our FTP server and can be copied to the CF/microSD card
via vsimgtool utility or Win32 Disk Imager (see Appendix E.1) under MS Windows or via dd (see
Appendix E.2).
Alternatively Buildroot (Section Section 10) can be used to create the root file system.
3.1. Booting from CF/microSD
3.1.1. KS8695 based Devices
There are two files placed under /boot directory on the complete image:
zImage - kernel to boot
kparam - kernel parameter
The OnRISC BIOS (refer to Section 8) is searching for these files to boot the system from an
external medium (Mass storage devices, network etc.). Due to the fact that USB devices need
more time to be detected it is recommended to increase the Start-Timeout value to at least 5
seconds (refer to 8.5). The kernel parameter will be described below:
root= parameter tells kernel from where to take the root filesystem. If this parameter is not
supplied BIOS
6
defines it using the device name containing zImage. So if root filesystem is on the
same device/partition as the kernel it is recommended not to define root= parameter.
Example:
Specifying root=/dev/hda1 will mount /dev/hda1 as root filesystem
Specifying root=/dev/sda1 will mount /dev/sda1 as root filesystem
If CF card is inserted into the internal CF-Slot and kparam doesn’t supply root= parameter,
/dev/hda1 will be mounted as root filesystem
rootwait parameter tells kernel to wait till root device appears. This is important for booting
from USB devices, because they will be detected much later than CF. This parameter is integrated
into BIOS since version 2.0.
mem= parameter defines the amount of RAM that kernel can use. This parameter is integrated
into BIOS since version 2.1, but it can be overridden in the kparam.
5
http://www.debian.org/ports/arm/
6
since BIOS version 2.1
May 2014 OnRISC User Manual 16