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
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