Ixp425
Upcoming SlideShare
Loading in...5
×

Like this? Share it with your network

Share
  • Full Name Full Name Comment goes here.
    Are you sure you want to
    Your message goes here
    Be the first to comment
    Be the first to like this
No Downloads

Views

Total Views
1,474
On Slideshare
1,474
From Embeds
0
Number of Embeds
0

Actions

Shares
Downloads
11
Comments
0
Likes
0

Embeds 0

No embeds

Report content

Flagged as inappropriate Flag as inappropriate
Flag as inappropriate

Select your reason for flagging this presentation as inappropriate.

Cancel
    No notes for slide

Transcript

  • 1. Jungo Software Technologies OpenRG Version 4.1 Intel IXP425-based Platforms Installation Guide
  • 2. 1 Product names mentioned in this document are trademarks of their respective manufacturers and are used here only for 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 is furnished under a license agreement. The software may be used, copied or distributed only in accordance with that agreement. No part of this publication may be reproduced, stored in a retrieval system, or transmitted in any form or any means, electronically or mechanically, including photocopying and recording for any purpose without the written permission 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
  • 3. Contents 1 What You Need to Get Started 3 2 Physical Connection 4 2.1 Monte Jade Board . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 2.2 Coyote Board . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 2.3 Supported Cards . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 2.4 Connecting the Boards . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 3 Setting up RGLoader 10 3.1 Replacing RedBoot with RGLoader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 3.1.1 Network Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 3.1.2 Uploading RGLoader to RAM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 3.1.3 Burning a Complete Image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 3.2 Compiling the RGLoader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 3.3 Updating to a New RGLoader Version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 4 Burning an Image using RGLoader 14 4.1 Burning a Full Flash Image using RGLoader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 4.2 Burning the Image and the Factory Settings Using RGLoader . . . . . . . . . . . . . . . . . . . 15 4.2.1 Compiling an Image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 4.2.2 The Burning Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 5 Troubleshooting 16 5.1 I Receive a TFTP Error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 5.2 The ST ATM Card on my Board is not Working . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 5.3 The Monte Jade ATM Image is Stuck after Soft Reboot . . . . . . . . . . . . . . . . . . . . . . . 16 5.4 I was Asked for the Factory Settings File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 5.5 OpenRG Halts in RGLoader instead of Running Image . . . . . . . . . . . . . . . . . . . . . . . 17 Jungo Intellectual Property
  • 4. What You Need to Get Started 1 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 from http://www.jungo.com/openrg/download_v41.html. – You can download and install the OpenRG Software Development Kit (SDK) from http://www.jungo.com/openrg/download_v41.html. After installing the SDK and compiling an image, 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
  • 5. Physical Connection 2 The following images present the Intel IXP425-based boards, detailing their relevant components. Please review them prior to installation. Jungo Intellectual Property
  • 6. 2.1 Monte Jade Board 5 2.1 Monte Jade Board Figure 2.1: Monte Jade Board Jungo Intellectual Property
  • 7. 2.1 Monte Jade Board 6 The following image presents the connected board: Figure 2.2: Connected Monte Jade Board Jungo Intellectual Property
  • 8. 2.2 Coyote Board 7 2.2 Coyote Board Figure 2.3: Coyote Board Jungo Intellectual Property
  • 9. 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 on Coyote 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
  • 10. 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 Current Monte 12V DC 2.5A Jade Coyote 12V DC 1.5A 2. Connect the board’s WAN socket to the PC’s network card. Configure the card’s IP address with 192.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
  • 11. Setting up RGLoader 3 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 Jade image, 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 switch ports 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 the fconfig -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
  • 12. 3.1 Replacing RedBoot with RGLoader 11 (c) Specify the IP of the computer connected with the board’s LAN in ’Gateway IP’ (suggested 192.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 it finds 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 requires to set up a TFTP directory. 3. Download the appropriate RAM RGLoader image file to your PC: • Monte Jade http://www.jungo.com/openrg/download/ixdpg425_ram_rgloader.img • Coyote http://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 (or any directory with which you set the server). Make sure the directory has reading permissions for all users. 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 Jade http://www.jungo.com/openrg/download/ixdpg425_opensmb_flash_41.img Jungo Intellectual Property
  • 13. 3.2 Compiling the RGLoader 12 • Coyote http://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 (or any directory with which you set the server). Make sure the directory has reading permissions for all users. 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 the download process has completed. Note: If you encounter the following error message ”No route found by OpenRG to ip <TFTP Server IP>” – 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 the SDK, before loading the new OpenRG image. You can download the SDK from http://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
  • 14. 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 RGLoader prompt (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
  • 15. Burning an Image using RGLoader 4 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’s Guide. • 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. When RGLoader 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 requires to set up a TFTP directory. 4. Place the image to be burnt (flash.img) in the TFTP server directory, usually /tftpboot (or any directory with 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 few minutes. 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 might corrupt the new burnt image by overwriting it with current OpenRG configuration. Jungo Intellectual Property
  • 16. 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 (located in rg/build) and rg factory (located in rg/build/pkg/main). If you do, proceed directly to the burning process (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 with your 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 and burnt 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 be found 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. When RGLoader 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 requires to 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 few minutes. 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 IMAGE section. 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 type FACTORY. 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
  • 17. Troubleshooting 5 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’ command should 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, the downloaded 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 settings can be found under /rg/build/pkg/main/rg factory. Please refer to section 4.2. Jungo Intellectual Property
  • 18. 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 RGLoader instead 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