MontaVista Linux Preview Kit for Professional Edition 2.1 for the MIPS Technologies, Inc. Malta 4KC and 5KC (Big-Endian)

Transcription

1 MontaVista Linux Preview Kit for Professional Edition 2.1 for the MIPS Technologies, Inc. Malta 4KC and 5KC (Big-Endian) Cross-Development Quick Start Guide 1237 E. Arques Ave. Sunnyvale, CA 94085

2 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

3 Contents Chapter 1 Overview...1 MontaVista Linux Preview Kit for Professional Edition 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 Chapter 3 Chapter 4 Target Configuration and Boot...11 MIPS Technologies, Inc. Malta 4KC and 5KC (Big-Endian) Connect the Target Board Set Up Minicom Configure the Target Configure the Host Boot the Target Host Configuration...17 Overview Configure DHCP Configure TFTP Red Hat Configure NFS MontaVista Linux Preview Kit for Professional Edition 2.1 i

4 Chapter 5 Preview Kit for Pro 2.1 Demo Page...23 Running the Preview Kit for Pro 2.1 Demo Page Appendix A Usage Notes...25 Names, Versions, and Paths ii MontaVista Linux Preview Kit for Professional Edition 2.1

5 Chapter 1: Overview MontaVista Linux Preview Kit for Professional Edition 2.1 Welcome to MontaVista Linux Preview Kit for Professional Edition 2.1 (Preview Kit for Pro 2.1) for the MIPS Technologies, Inc. Malta 4KC and 5KC (Big-Endian)! 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 MontaVista Linux Preview Kit for Professional Edition 2.1 1

6 Chapter 1: Overview MontaVista Linux Preview Kit for Professional Edition 2.1 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 or 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: X) 2 MontaVista Linux Preview Kit for Professional Edition 2.1

7 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: MIPS Technologies, Inc. Malta 4KC and 5KC (Big-Endian) 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 MontaVista Linux Preview Kit for Professional Edition 2.1 3

8

9 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. MontaVista Linux Preview Kit for Professional Edition 2.1 5

10 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: 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 6 MontaVista Linux Preview Kit for Professional Edition 2.1

11 Chapter 2: Installation 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: 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 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 ppc_74xx Motorola Sandpoint ppc_82xx Motorola Sandpoint 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! MontaVista Linux Preview Kit for Professional Edition 2.1 7

12 Chapter 2: Installation 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. 8 MontaVista Linux Preview Kit for Professional Edition 2.1

13 Chapter 2: Installation Remove Preview Kit for Pro 2.1 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 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. MontaVista Linux Preview Kit for Professional Edition 2.1 9

14 Chapter 2: Installation Remove Preview Kit for Pro 2.1 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. 10 MontaVista Linux Preview Kit for Professional Edition 2.1

15 Chapter 3: Target Configuration and Boot MIPS Technologies, Inc. Malta 4KC and 5KC (Big-Endian) To configure and boot a MIPS Malta target with the default kernel, complete the following steps: 1. Connect your target board to the host. 2. Set up Minicom (or other terminal emulation program). 3. Configure the target. 4. Configure the host. 5. 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 name in all of the commands below with the preemptible kernel image name listed in appendix A. Connect the Target Board Before you can configure the target, you need to connect your target board to your host machine. To connect your target board, complete the following steps: 1. Make a serial connection between the host and the target. 2. Connect the target to the local network. 3. Connect the target s power supply. For additional information about these connections, see the instructions provided by the board manufacturer. MontaVista Linux Preview Kit for Professional Edition

16 Chapter 3: Target Configuration and Boot MIPS Technologies, Inc. Malta 4KC and 5KC (Big-Endian) 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. 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 MIPS Technologies, Inc. Malta 4KC and 5KC (Big-Endian) target, configure Minicom to use the tty port that is connected to the target, e.g. /dev/ttys0 (com1), baud, 8 data bits, no parity, and 1 stop bit. 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. 12 MontaVista Linux Preview Kit for Professional Edition 2.1

17 Chapter 3: Target Configuration and Boot MIPS Technologies, Inc. Malta 4KC and 5KC (Big-Endian) 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 N - Delay before redial. 2 O - Number of tries 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: 1. Use the following command: control-a Z MontaVista Linux Preview Kit for Professional Edition

18 Chapter 3: Target Configuration and Boot MIPS Technologies, Inc. Malta 4KC and 5KC (Big-Endian) Configure the Target To configure the target, complete the following steps: 1. Ensure that the board is configured to run in big-endian mode. For bigendian mode, ensure that switch S5-2 is ON. 2. Power on the target. You are placed at a YAMON prompt. Note: On bootup, the YAMON ROM monitor prints the target s MAC address. Make a note of this address as it will be used in later configurations. 3. Enter the following commands: set ipaddr <targetipaddr> set subnetmask set bootserver <hostipaddr> set bootfile /tftpboot/vmlinux.srec-mips-malta-mips_fp_bepreviewkit (ENTER THE ABOVE COMMAND AS A SINGLE LINE.) In the command above, replace <targetipaddr> with the target machine s IP address and <hostipaddr> with the host machine s IP address. You may now proceed to setting up the host. Configure the Host This target uses a network boot. The kernel is configured to mount its file system root using the Network File System (NFS). To configure a host, perform the following tasks: Configure DHCP. Configure TFTP. Configure NFS. For more information about how to configure the host see Host Configuration on page 17. Note: To configure DHCP, you need the target s MAC address (Ethernet address). On bootup, the YAMON ROM monitor prints the target s MAC address. Boot the Target Once the host and target are properly set up, you can boot the target. To boot the target, complete the following steps: 1. At the YAMON prompt, enter the following commands: 14 MontaVista Linux Preview Kit for Professional Edition 2.1

19 Chapter 3: Target Configuration and Boot MIPS Technologies, Inc. Malta 4KC and 5KC (Big-Endian) load go You then see booting messages in your terminal emulation window. 2. Once Linux boots, you are placed at a login prompt: <targetipaddress or name> login: 3. 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 Running the Preview Kit for Pro 2.1 Demo Page on page 23. MontaVista Linux Preview Kit for Professional Edition

20

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 18 Configure TFTP on page 20 Configure NFS on page 21 Before you begin, make sure your host machine meets the requirements listed in Requirements on page 3. MontaVista Linux Preview Kit for Professional Edition

22 Chapter 4: Host Configuration Configure DHCP 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 ; # two weeks max-lease-time ; # 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 "vmlinux.srec-mips-malta-mips_fp_be-previewkit"; option root-path "/opt/hardhat/previewkit/mips/fp_be/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. 18 MontaVista Linux Preview Kit for Professional Edition 2.1

23 Chapter 4: Host Configuration Configure DHCP 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 MontaVista Linux Preview Kit for Professional Edition

24 Chapter 4: Host Configuration 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/mips/fp_be/target/boot/ vmlinux.srec-mips-malta-mips_fp_be-previewkit vmlinux.srecmips-malta-mips_fp_be-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. 20 MontaVista Linux Preview Kit for Professional Edition 2.1

25 Chapter 4: Host Configuration Configure NFS Configure NFS To configure NFS, as root, complete the following steps: 1. Add the following line in /etc/exports: /opt/hardhat/previewkit/mips/fp_be/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 MontaVista Linux Preview Kit for Professional Edition

26

27 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. MontaVista Linux Preview Kit for Professional Edition

28

29 Appendix A: Usage Notes Names, Versions, and Paths 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 MIPS Technologies, Inc. Malta 4KC and 5KC (Big-Endian) target board. Installation paths and names LSP Name Installation Paths mips-malta-mips_fp_be-previewkit LSP /opt/hardhat/previewkit/lsp/mips-malta-mips_fp_bepreviewkit Toolchains /opt/hardhat/previewkit/mips/fp_be/ Kernel Sources /opt/hardhat/previewkit/mips/fp_be/target/boot/ Kernel version and default image Kernel Version Default Kernel Image Name (Preemption NOT enabled) Preemptible Kernel Image Name (Preemption enabled) vmlinux.srec-mips-malta-mips_fp_be-previewkit vmlinux.srec-mips-malta-mips_fp_be-previewkit-prek MontaVista Linux Preview Kit for Professional Edition

30