Ixp425

Jungo Software Technologies

OpenRG Version 4.1

Intel IXP425-based Platforms Installation Guide

1

Product names mentioned in this document are trademarks of their respective manufacturers and are used here onlyfor identification purposes.

© Copyright 2001-2007, Jungo Ltd. All Rights Reserved.

Information in this document is subject to change without notice. The software described in this document isfurnished under a license agreement. The software may be used, copied or distributed only in accordance with thatagreement. No part of this publication may be reproduced, stored in a retrieval system, or transmitted in any form orany means, electronically or mechanically, including photocopying and recording for any purpose without the writtenpermission of Jungo Ltd.

This document is available for download at:http://www.jungo.com/openrg/manuals.html#4.1

DOC-INST-419-3-2007

March, 2007

Jungo Intellectual Property

Contents

1 What You Need to Get Started 3

2 Physical Connection 42.1 Monte Jade Board . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52.2 Coyote Board . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72.3 Supported Cards . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82.4 Connecting the Boards . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

3 Setting up RGLoader 103.1 Replacing RedBoot with RGLoader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

3.1.1 Network Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103.1.2 Uploading RGLoader to RAM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113.1.3 Burning a Complete Image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

3.2 Compiling the RGLoader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123.3 Updating to a New RGLoader Version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

4 Burning an Image using RGLoader 144.1 Burning a Full Flash Image using RGLoader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144.2 Burning the Image and the Factory Settings Using RGLoader . . . . . . . . . . . . . . . . . . . 15

4.2.1 Compiling an Image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154.2.2 The Burning Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

5 Troubleshooting 165.1 I Receive a TFTP Error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165.2 The ST ATM Card on my Board is not Working . . . . . . . . . . . . . . . . . . . . . . . . . . . 165.3 The Monte Jade ATM Image is Stuck after Soft Reboot . . . . . . . . . . . . . . . . . . . . . . . 165.4 I was Asked for the Factory Settings File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165.5 OpenRG Halts in RGLoader instead of Running Image . . . . . . . . . . . . . . . . . . . . . . . 17

Jungo Intellectual Property

1What You Need to Get Started

This guide will help you to quickly load an OpenRG image to your Intel IXP425-based development plat-form. To do so, you must have the following:

• An OpenRG image. Obtain the image in one of the following ways:

– You can download a pre-built image for your chosen platform fromhttp://www.jungo.com/openrg/download_v41.html .

– You can download and install the OpenRG Software Development Kit (SDK) fromhttp://www.jungo.com/openrg/download_v41.html . After installing the SDK and compiling animage, the created openrg.img and openrg.rmt files can be found under the rg/build subdirec-tory.

• An Intel IXDPG425 (Monte Jade) or IXP425 (Coyote) board.

• An installed bootloader.

• A PC with a network interface card.

• Network and serial cables (one of each).

• A terminal application, e.g. Minicom (Linux), HyperTerminal (Windows).

Jungo Intellectual Property

2Physical Connection

The following images present the Intel IXP425-based boards, detailing their relevant components. Pleasereview them prior to installation.

Jungo Intellectual Property

2.1 Monte Jade Board 5

2.1 Monte Jade Board

Figure 2.1: Monte Jade Board

Jungo Intellectual Property

2.1 Monte Jade Board 6

The following image presents the connected board:

Figure 2.2: Connected Monte Jade Board

Jungo Intellectual Property

2.2 Coyote Board 7

2.2 Coyote Board

Figure 2.3: Coyote Board

Jungo Intellectual Property

2.3 Supported Cards 8

The following image presents the connected board:

Figure 2.4: Connected Coyote Board

2.3 Supported Cards

• IEEE 802.11b/g 54M MiniPCI 54M Ralink RT2560 Wireless LAN card – supported by OpenRG onCoyote and Monte Jade boards (see figure 2.5).

Figure 2.5: Ralink Card

• ST MicroElectronics Mt. Ararat ADSL2+ ATM card – supported by OpenRG on Monte Jade boards(see figure 2.6).

Jungo Intellectual Property

2.4 Connecting the Boards 9

Figure 2.6: Mt. Ararat Card

2.4 Connecting the Boards

1. Connect the board to a power output. Make sure to connect each board to its correct power output,according to the following table:

Board Voltage CurrentMonteJade

12V DC 2.5A

Coyote 12V DC 1.5A

2. Connect the board’s WAN socket to the PC’s network card. Configure the card’s IP address with192.168.1.10.

3. Connect the ’UART0’ serial port to your PC using a serial cable. For all platforms, the terminal appli-cation should be configured to the following settings:

• Speed: 115200

• Data bits: 8

• Parity: None

• Stop bits: 1

• HW Flow Control: None

• SW Flow Control: None

In order to configure these settings on Minicom, follow these instructions:

(a) On your console screen, run ’Minicom -s’.

(b) Select ”Serial port setup”.

(c) Change the relevant settings.

(d) Select ”Save setup as dfl”.

4. Switch the board on.

Jungo Intellectual Property

3Setting up RGLoader

RGLoader must be up and running on your board in order to burn an OpenRG image.

3.1 Replacing RedBoot with RGLoader

Note: If RGLoader is already installed on your board, skip this section. If you are using a Monte Jadeimage, starting from OpenRG version 4.1, you need to update to a new RGLoader (refer to section 3.3).

If you are using a RedBoot version that supports the on-board Ethernet MACs, connect one of the switchports to your PC using a cross Ethernet cable. Otherwise connect the EEPRO100 Ethernet PCI card.

3.1.1 Network Setup

1. If this is the first time RedBoot is run on the board, you must perform an initialization by executing:

Redboot> fis init -f

The initialization process may take about 2 minutes.

2. Reboot the board.

3. The RedBoot greeting will appear on the serial modem console screen. When RedBoot comes up,press ’CTRL-C’ to prevent it from loading an existing image.

4. Set up an appropriate network configuration by executing:

Redboot> fconfig

Note: If the below configuration options are not shown, use thefconfig -i option to erase the old Redboot configuration.

The following configuration options will appear:

(a) Type ’FALSE’ on the run script at boot option.

(b) Type ’FALSE’ on the BOOTP option type in order to be able to set the local and remote IPs.

Jungo Intellectual Property

3.1 Replacing RedBoot with RGLoader 11

(c) Specify the IP of the computer connected with the board’s LAN in ’Gateway IP’ (suggested192.168.1.10).

(d) Specify the board’s LAN IP address in ’Local IP’ (suggested 192.168.1.1).

(e) Specify the local mask settings in ’Local IP address mask’ (suggested 255.255.255.0).

(f) Specify the TFTP server host IP in ’Default server IP’ (suggested 192.168.1.10 - same as the Gate-way IP).

(g) Leave the following entries in ’Default Network Device’ with their default settings (press ’En-ter’):

• Baud rate

• DNS server IP

• GDB connection port

• Force console for special debug messages

• Network debug at boot time

(h) Specify npe eth0 as the default network device.

(i) Leave the MAC addresses as they are (press ’Enter’).

(j) Type ’y’ to apply the configuration changes.

(k) Reboot the board.

5. If RedBoot comes up with a notice that the network card has not been found, reboot the board until itfinds it.

3.1.2 Uploading RGLoader to RAM

1. Configure your PC’s IP address to 192.168.1.10 (or the IP you chose as the default server IP).

2. Make sure you have a working TFTP server on your PC. Note that the Windows TFTP server requiresto set up a TFTP directory.

3. Download the appropriate RAM RGLoader image file to your PC:

• Monte Jadehttp://www.jungo.com/openrg/download/ixdpg425_ram_rgloader.img

• Coyotehttp://www.jungo.com/openrg/download/coyote_ram_rgloader.img

4. Place the image to be burnt in the TFTP server directory, usually the /tftpboot directory on the PC (orany directory with which you set the server). Make sure the directory has reading permissions for allusers.

5. Load the RAM RGLoader image into the memory, by executing:

Redboot> load r <platform>_ram_rgloader.img b 0x20000

6. Run the RGLoader, by executing:

Redboot> go 0x20000

3.1.3 Burning a Complete Image

1. Download the appropriate OpenRG image file to your PC:

• Monte Jadehttp://www.jungo.com/openrg/download/ixdpg425_opensmb_flash_41.img

Jungo Intellectual Property

3.2 Compiling the RGLoader 12

• Coyotehttp://www.jungo.com/openrg/download/coyote_opensmb_flash_41.img

2. Place the image to be burnt in the TFTP server directory, usually the /tftpboot directory on the PC (orany directory with which you set the server). Make sure the directory has reading permissions for allusers.

3. In order to release the Flash memory and allow burning a new boot loader, execute:

OpenRG Boot> unlock 0x0 0x800000

4. After RGLoader is up, execute the following command to burn the new image:

OpenRG Boot> load -u tftp://<TFTP Server IP>/<Image-Name> -r 0

<TFTP Server IP> should be replaced with the host’s IP address on which your TFTP Server is in-stalled. <Image-Name> should be replaced with the file you have just downloaded.

Wait for the ”Download completed successfully” message on the serial console, indicating that thedownload process has completed.

Note: If you encounter the following error message ”No route found by OpenRG to ip <TFTP ServerIP>” – disregard it.

5. Reboot the board.

3.2 Compiling the RGLoader

1. Change the directory to where you installed the OpenRG development tree, for example:

$ cd ˜/rg.4_0_11/rg

2. Execute the following command to configure and build the development tree:

make config DIST=RGLOADER_<platform-specific distribution> LIC=<license file path> && make

The platform-specific distribution is according to the board you choose:

• Coyote – ’DIST=RGLOADER COYOTE’

• Monte Jade – ’DIST=RGLOADER MONTEJADE’

The license is provided with your distribution.

3. The compilation process will produce rgloader.img. You can find the image under the OpenRG devel-opment tree directory, under the build.RGLOADER <platform-specific distribution> subdirectory(i.e. rg.4 0 11/rg/build.RGLOADER COYOTE/).

3.3 Updating to a New RGLoader Version

Note: Monte Jade images, starting from OpenRG version 4.1, require a new RGLoader, compiled from theSDK, before loading the new OpenRG image. You can download the SDK fromhttp://www.jungo.com/openrg/download_v41.html .

Use your old RGLoader in order to burn the new version of the supplied RGLoader.

1. Download the new RGLoader into the board’s memory from the PC by executing:

OpenRG boot> load -u tftp://192.168.1.10/rgloader.img

Jungo Intellectual Property

3.3 Updating to a New RGLoader Version 13

2. Reboot the board and make sure the RGLoader is running. You will see the Kernel extraction (’Linux..........’)repeating itself, press the ’ESC’ key on the second extraction and make sure you get an RGLoaderprompt (OpenRG boot>).

3. Burn the new RGLoader into section 0 by executing:

OpenRG boot> load -u tftp://192.168.1.10/rgloader.img -s 0

Wait until a ”Download completed successfully” message appears.

Jungo Intellectual Property

4Burning an Image using RGLoader

You can burn OpenRG to the Flash using one of two methods:

• Burning a full Flash image (refer to section 4.1). The whole Flash is burnt using a single image(flash.img). Refer to the ”Building a Complete Flash Image” section in the OpenRG Programmer’sGuide.

• Burn OpenRG using several component images – openrg.img, located in rg/build and rg factory,located in rg/build/pkg/main (refer to section 4.2).

4.1 Burning a Full Flash Image using RGLoader

1. Turn on the board. The RGLoader greeting will appear on the serial modem console screen. WhenRGLoader comes up press ’ESC’ to stop it from loading an existing image.

2. Configure your PC’s IP address to 192.168.1.10. The LAN IP address is 192.168.1.1.

3. Make sure you have a working TFTP server on your PC. Note that the Windows TFTP server requiresto set up a TFTP directory.

4. Place the image to be burnt (flash.img) in the TFTP server directory, usually /tftpboot (or any directorywith which you set the server) on the PC.

5. Download the new image into the board’s flash from the PC, by executing:

OpenRG boot> load -u tftp://192.168.1.10/flash.img -r 0

Wait until a ”Download completed successfully” message appears. Note that the process takes a fewminutes.

6. Hard reset the board and allow RGLoader to load the OpenRG image.

Note: It is important to hard reset the board and not call the ’reboot’ command because it mightcorrupt the new burnt image by overwriting it with current OpenRG configuration.

Jungo Intellectual Property

4.2 Burning the Image and the Factory Settings Using RGLoader 15

4.2 Burning the Image and the Factory Settings Using RGLoader

In order to separately burn an OpenRG image and the factory settings, you must have openrg.img (locatedin rg/build) and rg factory (located in rg/build/pkg/main). If you do, proceed directly to the burningprocess (section 4.2.2). Otherwise compile an image first, following the instructions in the next section(4.2.1).

4.2.1 Compiling an Image

1. Change the directory to where you installed the OpenRG development tree, for example:

$ cd ˜/rg.4_0_11/rg

2. Execute the following command to automatically configure the development tree:

make config DIST=<platform-specific distribution> LIC=<license file path>

The platform-specific distribution is according to the board you choose. The license is provided withyour distribution.

3. To build the image files, execute:

make

4. The compilation process will produce openrg.img, which is a binary that can be downloaded andburnt using the OpenRG ’load’ CLI command. You can find the image under the OpenRG develop-ment tree directory, under the build subdirectory (i.e. rg.4 0 11/rg/build). The factory settings can befound under rg.4 0 11/rg/build/pkg/main/rg factory.

4.2.2 The Burning Process

1. Turn on the board. The RGLoader greeting will appear on the serial modem console screen. WhenRGLoader comes up press ’ESC’ to stop it from loading an existing image.

2. Configure your PC’s IP address to 192.168.1.10. The LAN IP address is 192.168.1.1.

3. Make sure you have a working TFTP server on your PC. Note that the Windows TFTP server requiresto set up a TFTP directory.

4. Place the image to be burnt (openrg.img) in the TFTP server directory, usually the /tftpboot directory(or any directory with which you set the server) on the PC.

5. Download the new image into the board’s memory from the PC, by executing:

OpenRG boot> load -u tftp://192.168.1.10/openrg.img

Wait until a ”Download completed successfully” message appears. Note that the process takes a fewminutes.

6. Verify that the new image has been created, by executing:

OpenRG boot> flash_layout

In the IMAGE section details, verify that the counter is higher than the counter of the second IMAGEsection.

7. Copy the factory settings file (rg factory) to the TFTP directory.

8. Identify the proper factory settings section by executing ’flash layout’ and locating the section typeFACTORY. Then execute:

OpenRG boot> load -u tftp://192.168.1.10/rg_factory -s <factory section>

9. Verify that the factory settings section has been initialized, by executing ’flash layout’.

10. Hard reset the board and allow RGLoader to load the OpenRG image.

Jungo Intellectual Property

5Troubleshooting

5.1 I Receive a TFTP Error

If you receive the following TFTP error when you try to burn the Flash with an OpenRG image:

OpenRG boot> TFTP Error. Bad 0ACK response

1. Disable the ’negotiation’ option in your TFTP setup.

2. Verify the Flash image file has READ permission.

5.2 The ST ATM Card on my Board is not Working

If your ST MicroElectronics Mt. Ararat ADSL2+ ATM card is not working after loading the OpenRG image,make sure you are using an ATM image:

1. If you compiled an image from the SDK, the specified distribution in the ’make config’ commandshould be MONTEJADE ATM:

make config DIST=MONTEJADE_ATM LIC=<license file path>

2. If you downloaded a pre-built image from http://www.jungo.com/openrg/download_v41.html , thedownloaded image should be the Monte Jade OpenRG ATM image.

5.3 The Monte Jade ATM Image is Stuck after Soft Reboot

When executing reboot from the CLI, if your image is stuck after the ATM card is up, perform a hard reset.This is a known issue of ST, the Monte Jade ATM can only be hard reset.

5.4 I was Asked for the Factory Settings File

After burning an image, the boot process may stop to ask for the factory settings file. The factory settingscan be found under /rg/build/pkg/main/rg factory. Please refer to section 4.2.

Jungo Intellectual Property

5.5 OpenRG Halts in RGLoader instead of Running Image 17

5.5 OpenRG Halts in RGLoader instead of Running Image

In the case where after burning an image from RGLoader, you reboot, and OpenRG halts in RGLoaderinstead of running the image you have just loaded, you should restore the defaults in the RGLoader.

The reason for this is a problem in consistency of the counters of each section on the Flash.

Jungo Intellectual Property