Intrinsyc Software, Inc.CerfBoard - MontaVista

MontaVista Linux® Preview Kit 

for Professional Edition 2.1 for the 

Intrinsyc CerfBoard 

Cross-Development Quick Start Guide 

1237 E. Arques Ave. 

Sunnyvale, CA 94085

Copyright 

Copyright © 2002 MontaVista Software, Inc. All Rights Reserved. This product and related documentation are 

protected by copyright and distributed under licenses controlling its use, copying, and distribution. No part of this 

product or its related documentation may be reproduced in any form or by any means except under such licenses and 

this copyright notice. 

MontaVista Software, Inc. makes no representations or warranties with respect to the contents or use of this manual, 

and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. 

MontaVista Software, Inc. makes no representations or warranties with respect to MontaVista Linux® (“MVL”), 

and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. 

MontaVista Linux®, MVL, MontaVista and MontaVista Software are trademarks of MontaVista Software, Inc. 

Linux is a registered trademark of Linus Torvalds. All other names mentioned herein are trademarks, registered 

trademarks, and service marks are the property of their respective owners. 

Revision History 

This document was prepared by MontaVista Software, Inc. 

MontaVista Linux® 

Preview Kit for 

Professional Edition 

Documentation 

Release Date 

Notes 

Version 2.1 August 20, 2002 First Release 

Acknowledgements 

Thank you to the Linux community for the kernel work. Thank you to Free Software Foundation and all of the GNU 

Developers. Thank you to the Debian team for their excellent efforts with user-space applications and distribution 

packaging. And thank you to everyone who has been committed to open-source by releasing your code to the public. 

Contact 

You are welcome to contact us at: sales@mvista.com

Contents 

Chapter 1 Overview .................................................................................................1 

MontaVista Linux® Preview Kit for Professional Edition 2.1.................. 1 

What is Preview Kit for Pro?................................................................... 1 

Support..................................................................................................... 2 

About This Guide .................................................................................... 2 

Requirements................................................................................................. 3 

Target ....................................................................................................... 3 

Host.......................................................................................................... 3 

Chapter 2 Installation ..............................................................................................5 

Overview ....................................................................................................... 5 

Installation..................................................................................................... 6 

Remove Preview Kit for Pro 2.1.................................................................... 9 

Chapter 3 

Chapter 4 

Target Configuration and Boot.............................................................11 

Intrinsyc Software, Inc. CerfBoard ............................................................... 11 

Connect the Target Board ........................................................................ 11 

Set Up Minicom....................................................................................... 11 

Obtain the Target’s MAC (Ethernet) Address.......................................... 13 

Configure the Host................................................................................... 13 

Configure and Boot the Target................................................................. 14 

Host Configuration.................................................................................15 

Overview ....................................................................................................... 15 

Configure DHCP ........................................................................................... 16 

Configure TFTP............................................................................................. 18 

Red Hat 7.2.............................................................................................. 18 

Configure NFS............................................................................................... 19 

MontaVista Linux® Preview Kit for Professional Edition 2.1 

i

Chapter 5 Preview Kit for Pro 2.1 Demo Page ......................................................21 

Running the Preview Kit for Pro 2.1 Demo Page.......................................... 21 

Appendix A 

Usage Notes.............................................................................................23 

Names, Paths, and Versions ........................................................................... 23 

ii MontaVista Linux® Preview Kit for Professional Edition 2.1

Chapter 1: 

Overview 


Welcome to MontaVista Linux® Preview Kit for Professional Edition 2.1 (Preview 

Kit for Pro 2.1) for the Intrinsyc CerfBoard! 

What is Preview 

Kit for Pro? 

The Preview Kit for Pro 2.1 includes kernel packages, user space packages, and crossdevelopment 

packages for evaluation purposes. The Preview Kit for Pro provides an 

easy to use evaluation for all types of developers. Designed to showcase the features 

and performance of MontaVista Linux Professional Edition 2.1, the kit: 

• exhibits MontaVista Linux on a wide variety of hardware 

architectures providing a complete Linux runtime environment 

• assists in quick target bring-up 

• provides a demonstration of an embedded solution comprised of 

selected Linux applications (busybox, tinylogin, thttpd, telnetd, 

inetd, glibc shared library, and Preview Kit config/init scripts) from 

MontaVista Linux Professional Edition 

• enables a user with the means to evaluate and benchmark 

performance of target hardware platform as powered by MontaVista 

Linux 

• demonstrates a sampling of MontaVista Linux’s capabilities 

• provides two kernel images: a default kernel image and a 

preemptible kernel image – the preemptible kernel image has 

kernel preemption enabled, the default image does not 

Note: Additional information about the Preemptible Kernel and 

MontaVista Linux Real-Time performance can be found at 

http://www.mvista.com/dswp/realtime.pdf 

MontaVista Linux® Preview Kit for Professional Edition 2.1 1

Chapter 1: Overview 


Support 

About This Guide 

The Preview Kit for Pro 2.1 is unsupported. Direct customer support for MontaVista 

Linux Professional Edition is provided through subscription and consulting services. 

Additional documentation is also available through subscription. For more 

information, please contact Sales at sales@mvista.com or 408-328-9200. 

This quick start guide provides: 

• instructions for installing Preview Kit for Pro 2.1 on a Red Hat® 

host for the first time 

• instructions for booting Preview Kit for Pro 2.1 in a cross-hosted 

development environment 

• instructions for running the Preview Kit for Pro 2.1 demo page 

• usage notes, including the file and path names used for your target 

board 

For this guide, the host system is assumed to be a Red Hat® Linux (version 7.2) host. 

This quick start guide assumes that the target board uses out-of-the-box default 

hardware and software configurations as specified by the hardware manufacturer. This 

guide also assumes that you know how to use Linux. If you are unfamiliar with Linux, 

there are many books available to help you get started using and understanding Linux. 

Note: MontaVista Software does not endorse the book listed below. The following 

example is provided for your convenience only. 

Running Linux, Matt Welsh, Matthias Kalle Dalheimer, and Lar Kaufman. 

Sebastopol, California: O'Reilly & Associates [1999]. (ISBN: 156592469X) 

2 MontaVista Linux® Preview Kit for Professional Edition 2.1

Chapter 1: Overview 

Requirements 

Requirements 

Before you begin, make sure your host and target machines meet the requirements 

listed below. 

Target 

This manual provides instruction for the following target: 

• Intrinsyc CerfBoard 

Host 

Your host machine must meet the following requirements: 

You also need to have: 

• It must be an x86 machine running Red Hat® 7.2. 

• If you are using a standard Workstation install (all versions of Red 

Hat) with X windows and NFS server package groups or Gnome or 

KDE and Software Development package groups installed, you 

need to install the following individual package from the Red Hat 

installation CD-ROMs: dhcp 

• For a basic installation, a single architecture, and a single LSP, it 

must have a minimum of 300 MB available. 

• It must have a supported Ethernet interface. 

• It must have a serial port. 

• It must have an Internet connection. 

• The firewall on your host must be configured to allow NFS 

mounting. For Red Hat 7.2, for a default installation, the firewall is 

configured to prevent NFS mounting (i.e. set to “High”). Removing 

the firewall (i.e. setting the firewall to “None”) will allow NFS 

mounting; however, because of the numerous security issues 

involved in changing firewall configurations, please contact your 

systems administrator for information about how to configure your 

host’s firewall at your site. 

• Root access on your host machine 


Chapter 2: 

Installation 

Overview 

To use Preview Kit for Pro 2.1 for cross-hosted development, you first need to install 

Preview Kit for Pro 2.1 on your host machine. Before you begin, make sure your host 

machine meets the requirements listed in “Requirements” on page 3. 

To install Preview Kit for Pro 2.1 on your host machine, see: 

• “Installation” on page 6 

Note: These instructions assume that you have root access on your host machine. 

Please contact your system administrator if you do not have these permissions. 


Chapter 2: Installation 

Installation 

Installation 

Installation is performed by the script install_previewkit. To install Preview 

Kit for Pro 2.1 on your Linux host machine, complete the following steps: 

1. Installation of Preview Kit for Pro 2.1 requires a password. Obtain the 

required password from the following Web site: 

• http://www.mvista.com/previewkit/index.html 

2. Insert the Preview Kit for Pro 2.1 CD into your host machine’s CD- 

ROM drive. 

3. If the CD does not automount, mount the CD-ROM. Use the command: 

mount /mnt/cdrom 

Note: If this command fails to mount the CD-ROM, you must specify 

all of the parameters to the mount command. See your system 

administrator if you need assistance. 

4. Change to the directory on the CD where the installer is located: 

cd /mnt/cdrom 

5. Install Preview Kit for Pro 2.1. Installation of Preview Kit for Pro 2.1 is 

performed by the script install_previewkit. Enter the 

command: 

./install_previewkit 

Welcome to the MontaVista Linux Preview Kit Install! 

Where should the Preview Kit be installed? [ /opt ] 

Note: To view a list of the script’s options, enter the command: 

./install_previewkit --help 

6. To install Preview Kit for Pro 2.1 in the default location (/opt), press 

the Enter key. 

To install Preview Kit for Pro 2.1 in an alternate location, enter the name 

of the alternate path, for example: 

Where should the Preview Kit be installed? [ /opt ] /group1 



Installation 

In the above example, Preview Kit for Pro 2.1 is installed in the 

following directory: /group1/hardhat/previewkit. 

7. When prompted to enter a password, enter the Preview Kit for Pro CD 

password that you obtained in step1 from the Web site at: 

• http://www.mvista.com/previewkit/index.html 

You are given three attempts to enter the correct password before the 

installation process fails. 

Please enter the MontaVista Linux Preview Kit password. 

Password: 

8. To choose an LSP to install, enter the appropriate number. 

For example, if you were to install the Generic x86 LSP, you would 

enter the number 1, for example: 

Architecture Linux Support Package 

------------ --------------------- 

1. x86_586 Generic X86 

2. mips_fp_le Malta (little endian) 

3. mips_fp_be Malta (big endian) 

4. ppc_8xx Embedded Planet Linux Planet 

5. ppc_7xx Motorola Sandpoint 750 



8. arm_sa_le ADS Graphics Client Plus / Intrinsyc Cerfboard 

9. arm_920t_le ARM Integrator 920t 

10. arm_720t_le ARM Integrator 720t 

11. sh_sh4_le Hitachi Solution Engine 7751 

Choose the Target Architecture (by number): 1 

9. When prompted to confirm that the LSP you chose to install is correct, 

enter y to confirm. If the LSP name that appears is not correct, enter n to 

decline. 

If you chose to install the Generic x86 LSP, then you would enter y 

when prompted, for example: 

Install the 'x86_586' Preview Kit ? (y/n) y 

10. Wait for the configuration and installation to complete. Once complete, 

you should see output similar to the following: 

Finished Installing the MontaVista Linux Preview Kit! 



Installation 

Once Preview Kit for Pro 2.1 has been successfully installed, you can boot your 

target. See the instructions in the next chapter. 

If you accidently installed the incorrect LSP for your target, see “Remove Preview Kit 

for Pro 2.1” on page 9 for information about how to remove Preview Kit for Pro 2.1 

from your host system. 



Remove Preview Kit for Pro 2.1 


If you would like to remove your installation of Preview Kit for Pro 2.1, you need to 

use the install_previewkit script to remove it. 

Note: For removals, the Preview Kit for Pro 2.1 CD-ROM is NOT REQUIRED to be 

available. (If you installed in a location other than the default, replace /opt in the 

path below with the directory you used.) 

1. To remove all of Preview Kit for Pro 2.1, enter the command: 

/opt/hardhat/previewkit/install_previewkit --uninstall 

• To remove Preview Kit for Pro 2.1 from the default location 

(/opt), press the Enter key. 

Welcome to the MontaVista Linux Preview Kit Uninstall! 

Where is the Preview Kit installed? [ /opt ] 

• To remove Preview Kit for Pro 2.1 from an alternate location, enter 

the name of the alternate path, for example: 

Where is the Preview Kit installed? [ /opt ] /group1 

In the above example, Preview Kit for Pro 2.1 is removed from the 

following directory: /group1/hardhat/previewkit. 

2. To choose an LSP to remove, enter the appropriate number. 

For example, if you were to remove the Generic x86 LSP, you would 

enter the number 1, for example: 

Architecture Linux Support Package 

------------ --------------------- 

1. x86_586 Generic X86 

Choose the Target Architecture (by number): 1 

3. When prompted to confirm that the LSP you chose to remove is correct, 

enter y to confirm. If the LSP name that appears is not correct, enter n to 

decline. 




If you chose to remove the Generic x86 LSP, then you would enter y 

when prompted, for example: 

Uninstall the 'x86_586' Preview Kit ? (y/n) y 

4. Wait for the removal process to complete. You should see output similar 

to the following: 

This may take a few minutes... 

Finished Uninstalling the MontaVista Linux Preview Kit! 

5. To unmount the Preview Kit for Pro 2.1 CD-ROM, use the following 

commands: 

umount /mnt/cdrom/RPMS 

umount /mnt/cdrom 

Preview Kit for Pro 2.1 has been removed. 


Chapter 3: 

Target Configuration and Boot 

Intrinsyc Software, Inc. CerfBoard 

To configure and boot an Intrinsyc CerfBoard target, complete the following steps: 

1. Connect your target board to the host. 

2. Set up Minicom. 

3. Obtain the target’s MAC (Ethernet) address. 

4. Configure the host. 

5. Configure and boot the target. 

Details on these steps are provided in the sections below. 

Note: If you want to boot the target using the preemptible kernel image, replace the 

default kernel image in all of the commands below with the preemptible kernel image 

name listed in appendix A. 

Connect the Target 

Board 

Before you begin to configure the target, you need to connect your target board to 

your host machine. To connect the target board to the host, connect a serial cable to 

serial port three on the CerfBoard-break-out-board with the CerfBoard mounted per 

manufacturer’s instructions. 

For additional information about your board, see the board manufacturer’s 

instructions. 

Set Up Minicom 

Minicom is a terminal emulation and modem interface program included in most 

Linux distributions. Minicom is used with Preview Kit for Pro 2.1 to communicate 

with target boards. 


Chapter 3: Target Configuration and Boot 


To configure Minicom, complete the following steps: 

1. Log in as root, and run: 

minicom -s 

The Minicom configuration menu appears: 

Filenames and paths 

File transfer protocols 

Serial port setup 

Modem and dialing 

Screen and keyboard 

Save setup as dfl 

Save setup as.. 

Exit 

Exit from Minicom 

2. Select Serial port setup and set the options for your target. 

For the Intrinsyc CerfBoard target, configure Minicom to use the tty port 

that is connected to the target, e.g. /dev/ttyS0 (com1), 38400 baud, 8 

data bits, no parity, 1 stop bit, and no hardware flow control. 

Note: The Serial Device values are typical. They can change depending 

which port you have connected your device. 

3. Press Enter to return to the main configuration menu. 

4. Select Modem and dialing. Set the options as indicated in the figure 

below. 

Note: Be sure to erase the values for A - Init string, B - Reset string, 

and K - Hang-up string. 

A - Init string ......... 

B - Reset string ........ 

C - Dialing prefix #1.... ATDT 

D - Dialing suffix #1.... ^M 

E - Dialing prefix #2.... ATDP 

F - Dialing suffix #2.... ^M 

G - Dialing prefix #3.... ATX1DT 

H - Dialing suffix #3.... ;X4D^M 

I - Connect string ...... CONNECT 

J - No connect strings .. NO CARRIER 

K - Hang-up string ...... 

L - Dial cancel string .. ^M 

M - Dial time ........... 45 

N - Delay before redial . 2 

O - Number of tries ..... 10 

P - DTR drop time (0=no). 1 

NO DIALTONE 

BUSY 

VOICE 

Q - Auto bps detect ..... No 

R - Modem has DCD line .. Yes 

S - Status line shows ... DTE speed 

T - Multi-line untag .... No 

Change which setting? 

(Return or Esc to exit) 

5. Press Enter to return to the main configuration menu. 

6. Select Save as dfl to save these as the default settings. 




7. Select Exit from Minicom. 

When you enter Minicom again, you are able to communicate with your target by 

using the command: 

minicom 

Note: You may need to initiate a board hardware reset after restarting Minicom to 

successfully communicate with your target. 

Exit Minicom 

To exit Minicom: 

1. Use the command: control-A X 

You are prompted to confirm that you want to exit Minicom. 

2. Press Enter to exit. 

Help 

For help using Minicom: 

Use the following command: control-A Z 

Obtain the Target’s 

MAC (Ethernet) 

Address 

The MAC address is displayed, and BOOTP attempted, only when the tftp 

command is used at the Cerf> firmware prompt. Therefore, to obtain the MAC 

address, a sample tftp command should be entered, for example: 

Cerf>tftp sample c0800000 

MAC addr=0xd000:0xf1ca:0x22c1 are written 

crystal: hardware address 00:D0:CA:F1:C1:22 

Sending BOOTP requests... 

In the above example, the MAC address is: 

00:D0:CA:F1:C1:22 

Make a note of the MAC address for use in the next section. 

Configure the Host 

This board uses a network boot and the target’s root filesystem is booted via NFS. To 

configure the host system, perform the following tasks: 

• Configure DHCP. 

• Configure TFTP. 




• Configure NFS. 

For more information about how to set up the host see “Host Configuration” on 

page 15. 

Configure and 

Boot the Target 

Once the host is properly configured, you can configure and boot the target. To 

configure and boot the target, complete the following steps: 

1. On the host, in the location that TFTP is exporting, create a script called 

boot.script, with the following format: 

tftp vmlinuz-intrinsyc-cerfboard-previewkit c0000000 

flash 00200000 c0000000 200000 

&memcpy c0008000 00200000 200000 

&boot c0008000 0 1f 

Note: Lines with “&” are executed on every boot; whereas, lines with 

out “&” are only run when you run the script. 

2. Power on the target. 

3. Press the space bar on the serial console. 

4. On the target, run the following commands: 

tftp boot.script c0000000 

flash 20000 c0000000 200 

If DHCP and TFTP have been properly configured, the script has now 

been loaded to the flash location 20000. 

5. To load a kernel, execute the script using following command: 

exec 20000 

The above command downloads and flashes the kernel. 

6. Reboot the target. 

7. Once Linux boots, you are placed at a login prompt: 

Login: 

8. At this point, you can login as root with no password. You are placed at 

a bash shell prompt. 

Note: We recommend that you change this password as soon as 

possible. To change your password, use the passwd command. 

Now that you have successfully booted your target, you can proceed to “Preview Kit 

for Pro 2.1 Demo Page” on page 21. 


Chapter 4: 

Host Configuration 

Overview 

These instructions are for the following Linux host: Red Hat 7.2. The following 

sections provide instructions on how to configure the different components of the host 

system: 

• “Configure DHCP” on page 16 

• “Configure TFTP” on page 18 

• “Configure NFS” on page 19 

Before you begin, make sure your host machine meets the requirements listed in 

“Requirements” on page 3. 


Chapter 4: Host Configuration 

Configure DHCP 


Warning! If the DHCP server is configured incorrectly, it may cause problems for 

other machines on your network. If you have questions about how to install and 

configure the DHCP server on your machine, see your systems administrator for 

assistance. 

To configure DHCP, as root, complete the following steps: 

1. Make sure a DHCP server is installed and that the following file exists: 

• For Red Hat 7.2, the file is: 

/var/lib/dhcp/dhcpd.leases 

If the file does not exist, create an empty one using the touch 

command. 

• On Red Hat 7.2, use the command: 

touch /var/lib/dhcp/dhcpd.leases 

2. Edit the DHCP daemon configuration file. To do so, add the following 

configuration into your /etc/dhcpd.conf file: 

allow bootp; 

subnet a.b.c.d netmask e.f.g.h { 

default-lease-time 1209600; # two weeks 

max-lease-time 31557600; # one year 

option routers i.j.k.l; 

group { 

host name.your.domain { 

hardware ethernet xx:xx:xx:xx:xx:xx; 

fixed-address m.n.o.p; 

filename "vmlinuz-intrinsyc-cerfboard-previewkit"; 

option root-path 

"/opt/hardhat/previewkit/arm/sa_le/target"; 

} 

} 

} 

3. Make the following changes: 

• Replace a.b.c.d with your subnet address. 

• Replace e.f.g.h with your netmask address. 

• Replace i.j.k.l with your router or gateway address. 

• Replace name.your.domain with your target name (for 

example test1.mvista.com). This name must be consistent with the 

host name used for DNS or host file look-up. 




• Replace xx:xx:xx:xx:xx:xx with your target Ethernet (MAC) 

address. 

• Replace m.n.o.p with your target’s IP address. 

Note: There is a size limit to the request. If you add options other than 

those listed above, your root file system may fail to mount. 

4. Restart dhcpd. Use the command: 

/etc/rc.d/init.d/dhcpd restart 

The DHCP daemon is required at boot-up to run BOOTP. BOOTP uses 

DHCP to obtain IP addresses. To run the DHCP daemon on every boot, 

use the command: 

DHCP is now set up. 

/sbin/chkconfig dhcpd on 



Configure TFTP 

Configure TFTP 

To configure TFTP, follow the instructions for the host you are using. 

Red Hat 7.2 

To configure TFTP on a Red Hat 7.2 host, complete the following steps: 

1. Create (or edit) the file /etc/xinetd.d/tftp. Use the following 

format: 

#/etc/xinetd.d/tftp 

service tftp 

{ 

socket_type 

wait 

user 

log_on_success 

log_on_failure 

server 

server_args 

disable 

} 

= dgram 

= yes 

= root 

+= USERID 

+= USERID 

= /usr/sbin/in.tftpd 

= /tftpboot 

= no 

2. Create the directory /tftpboot. Use the command: 

mkdir /tftpboot 

3. Create a symbolic link to the boot file in the directory /tftpboot. 

Use the commands: 

cd /tftpboot 

ln -s /opt/hardhat/previewkit/arm/sa_le/target/boot/ 

vmlinuz-intrinsyc-cerfboard-previewkit vmlinuz-intrinsyccerfboard-previewkit 

(ENTER THE PRECEDING STRING AS A SINGLE LINE.) 

4. Use the following command to have xinetd reread its configuration 

file: 

/etc/rc.d/init.d/xinetd restart 

TFTP is now set up. You can now proceed with setting up NFS on the next page. 



Configure NFS 

Configure NFS 

To configure NFS, as root, complete the following steps: 

1. Add the following line in /etc/exports: 

/opt/hardhat/previewkit/arm/sa_le/target 

*(rw,no_root_squash,no_all_squash) 

(ENTER THE PRECEDING STRING AS A SINGLE LINE.) 

2. Restart the NFS daemon. Use the command: 

/etc/rc.d/init.d/nfs restart 

Note: If restart fails, you may need to stop and then start NFS. 

3. Set the NFS daemon to run on every boot. Use the command: 

/sbin/chkconfig nfs on 

4. Sync the NFS daemon. Use the command: 

NFS is now set up. 

/usr/sbin/exportfs -ra 



Configure NFS 


Chapter 5: 

Preview Kit for Pro 2.1 Demo 

Page 

Running the Preview Kit for Pro 2.1 Demo Page 

Now that you have installed Preview Kit for Pro 2.1 and booted your target, you can 

run the Preview Kit for Pro 2.1 demo page. To run the Preview Kit for Pro 2.1 demo 

page on your target, complete the following steps: 

1. Launch an Internet browser on your host machine. 

2. Enter the IP address of your target as the URL in the browser window. 

The Preview Kit for Pro 2.1 demo page displays. 

Congratulations! You have successfully booted your target and launched the Preview 

Kit for Pro 2.1 demo page. Navigate this page for more information about Preview 

Kit for Pro 2.1. 


Appendix A: Usage Notes 

Names, Paths, and Versions 

Preview Kit for Pro 2.1 is an embedded Linux development kit containing Linux 

kernel source for the supported target CPU. The charts below provide information 

about names, paths, and versions used for the Intrinsyc CerfBoard target board. 

Installation paths and names 

LSP Name 

Installation 

Paths 

intrinsyc-cerfboard-previewkit 

LSP 

/opt/hardhat/previewkit/lsp/intrinsyc-cerfboardpreviewkit 

Toolchains 

/opt/hardhat/previewkit/arm/sa_le/ 

Kernel version and kernel image names 

Kernel Version 2.4.17 

Default Kernel 

Image Name 

(Preemption NOT enabled) 

Preemptible Kernel 

Image Name 

(Preemption enabled) 

vmlinuz-intrinsyc-cerfboard-previewkit 

vmlinuz-intrinsyc-cerfboard-previewkit-prek

Intrinsyc Software, Inc.CerfBoard - MontaVista

Create successful ePaper yourself

Delete template?

Save as template?