Z-World EG2110 User manual

RabbitLink (EG2110)
Network Programming Gateway
User’s Manual
030109 • 019–0123-A
This manual (or an even more up-to-date revision) is available for free
download at the Z-World website: www.zworld.com

ii RabbitLink (EG2110)
RabbitLink (EG2110) User’s Manual
Part Number 019-0123–A • 030109 • Printed in U.S.A.
©2003 Z-World Inc. • All rights reserved.
Z-World reserves the right to make changes and
improvements to its products without providing notice.
Trademarks
Rabbit 2000 is a trademark of Rabbit Semiconductor.
Dynamic C is a registered trademark of Z-World Inc.
Z-World, Inc.
2900 Spafford Street
Davis, California 95616-6800
USA
Telephone: [phone]
Fax: [phone]
www.zworld.com
Rabbit Semiconductor
2932 Spafford Street
Davis, California 95616-6800
USA
Telephone: [phone]
Fax: [phone]
www.rabbitsemiconductor.com

User’s Manual iii
TABLE OF CONTENTS
Chapter 1. Introduction 1
1.1 Overview...............................................................................................................................................1
1.2 RabbitLink Features..............................................................................................................................2
1.3 Development and Evaluation Tools......................................................................................................3
1.4 Software................................................................................................................................................4
1.4.1 Upgrading Dynamic C ..................................................................................................................4
1.4.2 Remote Downloading and Debugging..........................................................................................4
1.4.3 Passphrase Protection....................................................................................................................5
1.5 RabbitLink CE Compliance..................................................................................................................5
1.5.1 Design Guidelines.........................................................................................................................6
1.5.2 Interfacing the RabbitLink to Other Devices................................................................................6
Chapter 2. Getting Started 7
2.1 RabbitLink Physical Connections.........................................................................................................7
2.2 Configuring RabbitLink Network Parameters from your PC.............................................................10
2.2.1 Dynamically Assigned Network Parameters ..............................................................................10
2.2.2 Statically Assigned Network Parameters....................................................................................10
2.3 Target System Connections to the RabbitLink...................................................................................11
2.4 Ethernet Connections..........................................................................................................................12
2.5 Ready to Go ........................................................................................................................................12
Chapter 3. RabbitLink Software 13
3.1 Downloading and Debugging via the RabbitLink..............................................................................13
3.1.1 RabbitLink Network Parameters.................................................................................................13
3.1.2 More RabbitLink Network Parameters.......................................................................................13
3.1.3 Password Protection....................................................................................................................14
3.1.4 Using Dynamic C or the RFU to Download...............................................................................14
3.1.5 Remote Debugging with Dynamic C..........................................................................................14
3.1.6 Troubleshooting Tips..................................................................................................................14
3.2 RabbitLink Firmware..........................................................................................................................15
3.2.1 Downloading Firmware to the RabbitLink.................................................................................15
3.2.2 Firmware Upgrades.....................................................................................................................16
3.3 Serving Web Pages and Sending E-Mail............................................................................................16
3.3.1 Using DeviceMate Features........................................................................................................16
3.3.2 Using RabbitLink Features .........................................................................................................16
Notice to Users 17

iv RabbitLink (EG2100)
Appendix A. Specifications 19
A.1 Electrical and Mechanical Specifications..........................................................................................19
A.2 Conformal Coating............................................................................................................................21
Appendix B. Plastic Enclosure 23
B.1 Assembly........................................................................................................................................... 23
B.2 Dimensions........................................................................................................................................26
Appendix C. Subsystems 27
C.1 RabbitLink Hardware Subsystems .................................................................................................... 27
C.1.1 Pinouts .......................................................................................................................................28
C.2 Serial Communication.......................................................................................................................28
C.2.1 Serial Programming Ports..........................................................................................................28
C.2.2 Ethernet Port..............................................................................................................................29
C.3 Memory .............................................................................................................................................29
C.3.1 SRAM........................................................................................................................................29
C.3.2 Flash EPROM............................................................................................................................ 30
C.4 Power Supplies..................................................................................................................................30
C.5 Reset Generator .................................................................................................................................30
Appendix D. Programming Cable 31
Appendix E. Serial Console Commands 33
E.1 Configuration Commands..................................................................................................................33
E.2 Variables Commands.........................................................................................................................35
E.3 File Commands..................................................................................................................................36
E.4 E-Mail Commands.............................................................................................................................37
E.5 Other Console Commands.................................................................................................................38
E.6 RabbitLink Console API (prior to Dynamic C 7.20).........................................................................39
E.7 Example Using the RabbitLink Console API....................................................................................41
Index 43
Schematics 45

User’s Manual 1
1. INTRODUCTION
This chapter introduces the RabbitLink Network Programming Gateway and describes its features.
Rabbit-based embedded systems are normally programmed using a direct connection between a
PC and the programming port of the Rabbit-based system. The RabbitLink provides an indirect
connection between the two for remote downloading and debugging.
Figure 1.0.0-1 Remote Network Access via RabbitLink Network Gateway
1.1 Overview
Microprocessor boards with a Rabbit microprocessor use a standardized programming connector.
Using this connector it is possible to load new software as well as perform the various testing and
debugging operations that are part of normal software development. The target can be initialized
completely via the programming port without the need for preexisting code stored on the flash
memory of the target board. The programming port is a 10 pin 2 millimeter header (Rabbit 2000-
based boards) or a 10 pin 1.27 millimeter header (Rabbit 3000-based boards). It is connected to a
serial port that is a part of the Rabbit processor chip. High speed data transmission is possible via
this port. The programming port is described in detail in both the Rabbit 2000 and the Rabbit 3000
user manuals. If you develop your own Rabbit-based microprocessor board be sure to include this
standardized programming port.
Before the RabbitLink board was introduced the only way to program a Rabbit-based system was
via a special serial cable that connects a PC serial port to the Rabbit programming port. This cable,
called the programming cable, includes a level translator to convert the RS-232 signal levels on
the PC serial port to CMOS logic levels accepted by the Rabbit programming port.
The RabbitLink makes it possible to load and debug programs on a Rabbit-based target via a net-
work, including the Internet. The RabbitLink has an Ethernet port that can be connected to a net-
work or directly to an Ethernet adapter on your PC (using a crossover cable). A programming port
out connector on the RabbitLink is connected to the programming port on the Rabbit-based target
using the program download cable provided. This connection is shown in Figure 2.3.0-1.

2RabbitLink (EG2110)
When the RabbitLink is used to connect a target system to a network, communication between the
programmer’s PC and the RabbitLink is via TCP/IP. Windows-based PCs already support the
TCP/IP protocol and Ethernet adapters. There are two separate programs that run on the PC and
communicate with the RabbitLink:
• Dynamic C (version 7.03 or later)
• Rabbit Field Utility (version 2.0 or later)
NOTE: The firmware shipped with the RabbitLink model EG2110 is
version 2.05. This version of the firmware requires Dynamic C version 7.10
or later and/or version 2.20 or later of the Rabbit Field Utility.
Dynamic C is a complete interactive development environment that allows the user to create, load
and test programs on the target system. The Rabbit Field Utility (RFU) is a program that can be
used to download .bin program files to the target. The RFU provides a convenient means of updat-
ing software on a remote target.
1.2 RabbitLink Features
The following is a list of RabbitLink hardware and software features.
• Rabbit 2000
™
microprocessor operating at 22.1 MHz.
• RJ-45 Ethernet port compliant with IEEE 802.3 standard for 10Base-T Ethernet protocol.
• 2 serial ports.
• 3 status LEDs, labeled USER, ACT and LINK.
• 128K static RAM and 512K flash memory (two 256K flash chips).
• Optional plastic enclosure and LED light pipes (enclosure and light pipes are included with the
tool kit, and are also sold separately).
• Firmware installed, ready to run.
• Downloadable firmware upgrades.
• Easy setup with DHCP or simple console commands.
• Password protection.
• Remote program downloading and debugging.

User’s Manual 3
1.3 Development and Evaluation Tools
The RabbitLink board comes with two program download cables. These cables connect a Rabbit-
based controller to the RabbitLink board. They are functionally identical, differing in physical size
to accommodate different Rabbit-based controllers. The RabbitLink Tool Kit (sold separately from
the RabbitLink board) contains other hardware that may be used with the RabbitLink.
The tool kit contents are:
• RabbitLink (EG2100) User’s Manual with schematics (this document). A black square indicates
pin 1 of all headers shown in the manual.
• The programming cable. Connects a PC serial port to the RabbitLink to set up the network
parameters
and to download firmware.
• AC adapter. Supplies power to the RabbitLink . An AC adapter is supplied with tool kits sold in
the North American market. If you are using another power supply, a minimum of 9-24
VDC
at 120 mA is recommended.
• Plastic enclosure with 4 customer-installable light pipes.
• Screwdriver.
• The companion CD. Contains RabbitLink firmware and the RFU.
Figure 1.3.0-1 RabbitLink Development Tools
J1
Pin 1
PROG
DIAG
Programming
Cable
Program Download
Cables
Companion CD
AC Adapter
(North American
kits only)
Screwdriver
Plastic Enclosure
User's Manual
LED Light Pipes

4RabbitLink (EG2110)
1.4 Software
The RabbitLink board is shipped with firmware already installed in the flash memory. The rows in
the following table show which versions of Dynamic C and the RFU are compatible with which
versions of the RabbitLink firmware. The firmware version is the same as its serial console; the
version number is displayed in the console’s startup message.
1.4.1 Upgrading Dynamic C
Z-World recommends upgrading to the latest version of Dynamic C as soon as possible. To use
version 2.05 or later of the RabbitLink firmware you need, at minimum, Dynamic C version 7.30.
The simplified structure of version 2.00 and later of the RabbitLink firmware is more flexible and
is also more stable and robust than version 1.00. The EG2110 model of RabbitLink is shipped with
version 2.05 of the firmware. RabbitLinks (model EG2100) shipped in the 2nd quarter of 2002
have firmware version 2.00. RabbitLinks shipped before the 2nd quarter of 2002 require an
upgrade of the firmware to be compatible with Dynamic C 7.10 or later.
Please see Section 3.2.1, “Downloading Firmware to the RabbitLink,”on page 15 for complete
instructions for downloading the firmware.
1.4.2 Remote Downloading and Debugging
Attaching the RabbitLink to the Ethernet and a Rabbit-based target allows a user to compile, run,
and debug programs on the remote board from a network-connected PC running Dynamic C. All
the standard features of Dynamic C are available over the remote interface, including the Dynamic
C STDIO window, watch expressions, and the ability to step through C and assembly code.
Dynamic C can be used exactly the same way as it is for a board connected to the PC’s serial port.
To use the RabbitLink, a network address (i.e., IP address) must be assigned to the RabbitLink and
the software that runs on the PC must be made aware of this address. Default IP values are set in
the firmware and are given here:
• IP address is "10.10.1.100"
• Gateway is “10.10.1.1"
• Netmask is "255.255.255.0"
By default, the RabbitLink will try to get an IP address using DHCP. (DHCP is a protocol to auto-
matically assign IP addresses to computers when they are booted.) The network addresses may be
changed using the RabbitLink serial console. Please see Section 2.2, "Configuring RabbitLink
Network Parameters from your PC," for more information.
If your PC is not connected to a network you may create a network using a hub or you may use a
crossover Ethernet cable to make the connection directly from you PC’s Ethernet adapter to the
Table 1. Compatibility Between Dynamic C and the RabbitLink Firmware
RabbitLink Firmware Dynamic C Rabbit Field Utility
Version 1.00 Versions 7.03 thru 7.06 Version 2.0
Version 2.00 Versions 7.10 thru 7.26 Version 2.20 and later
Version 2.05 Versions 7.30 and later Version 2.20 and later

User’s Manual 5
RabbitLink card. If you are already connected to a network it may be necessary for the network
administrator to assign an IP address to be used by the RabbitLink.
1.4.3 Passphrase Protection
Every time Dynamic C initiates a new RabbitLink session, the RabbitLink requests a passphrase
from the user to ensure the security of the programs and data on the remote boards. This pass-
phrase is stored by Dynamic C during that session so it only needs to be entered the first time
Dynamic C contacts the RabbitLink gateway. For security reasons, Dynamic C does not store the
passphrase on the hard disk of the PC.
1.5 RabbitLink CE Compliance
This section describes the immunity and emissions standards met by the RabbitLink. Design
guidelines are given to help developers incorporate the RabbitLink into an application while stay-
ing CE compliant.
Equipment is generally divided into two classes.
These limits apply over the range of 30–230 MHz. The limits are 7 dB higher for frequencies
above 230 MHz. Although the test range goes to 1 GHz, the emissions from Rabbit-based systems
at frequencies above 300 MHz are generally well below background noise levels.
The RabbitLink has been tested and was found to be in conformity with the following applicable
immunity and emission standards. Boards that are CE-compliant have the CE mark.
Immunity
The RabbitLink meets the following EN55024/1998 immunity standards.
• EN61000-4-3 (Radiated Immunity)
• EN61000-4-4 (EFT)
• EN61000-4-6 (Conducted Immunity)
Additional shielding or filtering may be required for a heavy industrial environment.
CLASS A CLASS B
Digital equipment meant for light industrial use Digital equipment meant for home use
Less restrictive emissions requirement:
less than 40 dB µV/m at 10 m
(40 dB relative to 1 µV/m) or 300 µV/m
More restrictive emissions requirement:
30 dB µV/m at 10 m or 100 µV/m

6RabbitLink (EG2110)
Emissions
The RabbitLink meets the following emission standards with the Rabbit 2000 spectrum spreader
turned on and set to the normal mode. The spectrum spreader is only available with revision C or
higher of the Rabbit 2000 microprocessor. This microprocessor is used in all RabbitLink boards
that carry the CE mark.
• EN55022:1998 Class A
• FCC Part 15 Class A
NOTE: The RabbitLink satisfied the Class A limits but not the Class B lim-
its. Such equipment need not be restricted in its sale, but the following warn-
ing must be included in the instructions for its use.
Additional shielding or filtering may be needed to meet Class B emissions standards.
1.5.1 Design Guidelines
Note the following requirements for incorporating a RabbitLink into your application to comply
with CE requirements.
General
• The power supply provided with the Tool Kit is for development purposes only. It is the cus-
tomer’s responsibility to provide a CE-compliant power supply for the end-product application.
• When connecting the RabbitLink to outdoor cables, the customer is responsible for providing
CE-approved surge/lighting protection.
• Z-World recommends placing digital I/O or analog cables that are 3 m or longer in a metal con-
duit to assist in maintaining CE compliance and to conform to good cable design practices.
• When installing or servicing the RabbitLink, it is the responsibility of the end-user to use proper
ESD precautions to prevent ESD damage to the RabbitLink.
Safety
• All inputs and outputs to and from the RabbitLink must not be connected to voltages exceeding
SELV levels (42.4 V AC peak, or 60 V DC).
1.5.2 Interfacing the RabbitLink to Other Devices
Since the RabbitLink is designed to connect to other devices, follow good EMC practices to
ensure compliance. CE compliance is ultimately the responsibility of the integrator. Additional
information, tips, and technical assistance are available from your authorized Z-World distributor,
and are also available on our Web site at www.zworld.com.
Warning
This is a class A product. In a domestic environment this product may cause radio
interference, in which case the user may be required to take adequate measures.

User’s Manual 7
2. GETTING STARTED
This chapter shows how to make the necessary hardware connections and how to configure the
network parameters for the RabbitLink.
2.1 RabbitLink Physical Connections
1. Attach the RabbitLink board to the plastic enclosure base.
Position the RabbitLink board over the plastic enclosure base as shown below in Figure 2.1.0-
1. Attach the RabbitLink board to the base at the top left and bottom right positions using the
two 4-40 ×¼screws supplied.
Figure 2.1.0-1 Attach RabbitLink Board to Plastic Enclosure Base
The plastic enclosure base facilitates handling the RabbitLink during development. It is avail-
able in the RabbitLink Tool Kit.
NOTE: Appendix B, “Plastic Enclosure,”provides additional information and
specifications for the plastic enclosure.
Flash
EPROM
Flash
EPROM
90
15 65
SRAM

8RabbitLink (EG2110)
2. Connect the programming cable
You must connect the programming cable to configure network parameters from your PC.
Connect the 10-pin DIAG connector of the programming cable to header J8, which is labeled
PROG IN, on the RabbitLink. Ensure that the colored edge lines up with pin 1 as shown. Con-
nect the other end of the programming cable to a COM port on your PC.
Figure 2.1.0-2 Programming Cable Connections
Flash
EPROM
Flash
EPROM
90
15 65
SRAM
Colore e ge
own
DIAG
PROG
Programming Cable
J9
PROG OUT IN PROG
J8
To
PC COM port
DIAG

User’s Manual 9
3. Connect the power supply.
Two options are available for powering the RabbitLink. Option 1 is an AC adapter to power
supply jack J4; option 2 is
a screw terminal header at J5. Option 1 is most convenient in a desk-
top environment, and
Option 2 can be used to connect the RabbitLink to an existing power sup-
ply in a field installation. The LED labeled USER comes on for several seconds after power is
applied.
Option 1 - Via AC Adapter
Plug the DC end of the power supply into jack J4, which is labeled POWER IN, as shown
in Figure 2.1.0-3.
Option 2 - Via Screw Terminal Header J5
Connect the +lead (red) to +RAW on header J5 and connect the –lead (black) to GND as
shown in Figure 2.1.0-3.
Figure 2.1.0-3 Alternative Power Supply Connections
NOTE: The RabbitLink (2110) has reverse polarity protection through header J5.
4. Apply power.
Once the RabbitLink is powered up and connected to your PC, you are ready to configure the
network parameters.
Do not do this hookup if you have already connected the AC adapter
(Option 1).
+

Option 
Via Screw Terminal
Header J5
Option 1
Via AC Adapter

10 RabbitLink (EG2110)
2.2 Configuring RabbitLink Network Parameters from your PC
There are two ways to set the basic network parameters for the RabbitLink: dynamically (DHCP)
or statically (RabbitLink serial console) . The basic network parameters are:
•the IP address of the RabbitLink
•the IP address of the gateway
•the netmask
2.2.1 Dynamically Assigned Network Parameters
The easiest way to set network parameters is to use a DHCP server. This method is available start-
ing with RabbitLink firmware version 2.00. It removes the need to connect to a PC to configure
the RabbitLink, which may be desirable on PCs without a COM port. The RabbitLink tries to use
the services of a DHCP server by default.
If there is not a DHCP server on the network, or it is desired to set the parameters by hand, the sec-
ond method may be used.
2.2.2 Statically Assigned Network Parameters
This method is required for setting anything beyond the basic network parameters. A terminal
emulator is used to communicate with the RabbitLink serial console.
1. Open a terminal emulator such as Tera Term or Windows Hypertermal on your PC. Configure
the terminal emulator as follows.
TIP: If no characters appear when you type, press return, then type echo on to turn
on the echoing of characters.
2. Cycle power on the RabbitLink. The RabbitLink boots up whenever the power cycles, and then
displays the message,
RabbitLink Serial Console Version X.XX
This may take several seconds, so be patient. The RabbitLink serial console will respond OK
after each command, or,
“ERROR <errnum>”
if something went wrong.
Parameter Setting
COM port (COM1 or COM2) to which programming cable is connected
Baud Rate 57,600 bps
Data Bits 8
Parity None
Stop Bits 1
Flow Control None

User’s Manual 11
3. Configure the RabbitLink network parameters. This is done using the serial console commands.
Typing the command “show”results in a listing of the current network addresses.
Please refer to Appendix E, “Serial Console Commands,”for a description of all the commands.
If a DHCP server was not used , the following serial console commands are required:
set ip x.x.x.x // factory default is 10.10.1.100
set gateway x.x.x.x // factory default is 10.10.1.1
set netmask x.x.x.x // factory default is 255.255.255.0
An alternative for setting the required network addresses is to change the default values in the
RabbitLink firmware, download.c.
2.3 Target System Connections to the RabbitLink
After network addresses have been set, put aside the programming cable and connect the program
download cable as shown in Figure 2.3.0-1. One end of the program download cable connects to
the programming header of the Rabbit-based target system. The other end connects to the PROG
OUT header of the RabbitLink board.
Figure 2.3.0-1 Connect Rabbit-Based Target System to RabbitLink
Programming Port
Flash
EPROM
Flash
EPROM
SRAM
Colore e ge
lines up with
pin 1
Colore e ge
Rabbit-Based
Embedded System
Program
Download
Cable
90
15 65
3
J9
PROG OUT

12 RabbitLink (EG2110)
2.4 Ethernet Connections
Before proceeding, you will need to have either two straight-through Ethernet cables and an Ether-
net hub or one Ethernet crossover cable. The Ethernet cables and Ethernet hub are available from
Rabbit Semiconductor or Z-World in a TCP/IP tool kit. More information is available at
www.rabbitsemiconductor.com or at www.zworld.com
Your PC must have an RJ-45 Ethernet jack. You can identify the RJ-45 Ethernet jack by looking
for an 8-connector (as opposed to a 6-connector RJ-11 phone jack) jack labeled ETHERNET or
<···>that will probably have an LED or two on it. If your PC does not have Ethernet access, you
will need to install a 10BaseT Ethernet card.
Connect your PC and the RabbitLink board to an Ethernet hub as shown in Figure 2.4.0-1. The
Ethernet hub may also be connected to your network.
Figure 2.4.0-1 Overview of physical connections.
Alternatively, you may use the crossover Ethernet cable to connect the RabbitLink directly to a PC
RJ-45 Ethernet jack. This is useful when using RabbitLink as a high speed local programming
interface.
2.5 Ready to Go
The green LED labeled LINK should light up once all the connections have been made correctly.
Dynamic C or the Rabbit Field Utility may now be used to download a program to the Rabbit-
based target system from your PC. The red LED labeled USER on the RabbitLink blinks while a
download or a debug session is in progress.
Ethernet-based
network
181818
Ethernet Hub
RJ-45 Jack
Embedded
Target
RabbitLink
Board

User’s Manual 13
3. RABBITLINK SOFTWARE
This chapter describes the software functionality available when using a RabbitLink.
3.1 Downloading and Debugging via the RabbitLink
Downloading a program to an embedded target via the RabbitLink is done using Dynamic C or the
Rabbit Field Utility (RFU). The rows in the following table show which versions of Dynamic C
and the RFU are compatible with which versions of the RabbitLink firmware. The firmware ver-
sion is the same as its serial console; the version number is displayed in the console’s startup mes-
sage.
Before a program can be downloaded to a Rabbit-based target, the RabbitLink must be visible on
the network. It must also be visible to Dynamic C or the Rabbit Field Utility (RFU). This is
accomplished by setting the network parameters on the RabbitLink board and giving this informa-
tion to Dynamic C or the RFU.
3.1.1 RabbitLink Network Parameters
Follow the steps in Section 2.2, “Configuring RabbitLink Network Parameters from your PC,”on
page 10 if you have not already done so. The RabbitLink requires an IP address, a gateway
address, a netmask and a port number to communicate across a network.
3.1.2 More RabbitLink Network Parameters
Enter the RabbitLink addresses in the Communications dialog box. Depending on your version of
Dynamic C, the Communications dialog box is accessed by choosing it directly from the Options
menu or by choosing Project Options from the Options menu and then selecting the Communica-
tions tab. From the RFU, the Communications dialog box is accessed from the Setup menu.
•The Network Address field should contain the IP address of the RabbitLink.
•The Control Port field should be set to the TCP port number that the RabbitLink uses to
accept control commands from Dynamic C—the default value is 4244. If the RabbitLink is
behind a firewall, the Control Port field should be set to the port on the firewall that is being
forwarded to the RabbitLink.
If a RabbitLink or multiple RabbitLinks are attached to a local network, press the Discover button in
the Communications dialog box to have Dynamic C or the RFU send a broadcast message to each
RabbitLink attached to the network. The default UDP port for discovery is 4242. Each RabbitLink
will respond with its IP address, name, control port, current status,
and MAC address. Selecting any
Table 2. Compatibility Between Dynamic C and the RabbitLink Firmware
RabbitLink Firmware Dynamic C Rabbit Field Utility
Version 1.00 Versions 7.03 thru 7.06 Version 2.0
Version 2.00 Versions 7.10 thru 7.26 Version 2.20 and later
Version 2.05 Versions 7.30 and later Version 2.20 and later

14 RabbitLink (EG2100)
line in the Discover window will cause the information for that RabbitLink to be placed into the
appropriate fields in the
Communications dialog box.
3.1.3 Password Protection
Though not required, it is highly recommended that the passphrase security feature be activated
before the RabbitLink is deployed. This gives some protection to the embedded target system from
unauthorized communication. The passphrase may be up to 256 characters long. The serial con-
sole command “set passphrase”will prompt twice for a passphrase and will store the
hashed value of it on the RabbitLink. When a session starts, the RabbitLink will ask for the pass-
phrase, allowing access to the embedded system only after receiving the correct value. If no pass-
phrase is set, just press <ENTER> when asked for it. If you forget the passphrase, the only way to
recover is to use the RabbitLink serial console to set a new passphrase. This will require the hard-
ware connections shown in Figure 2.1.0-2 on page 8 and the software setup described in “Stati-
cally Assigned Network Parameters”on page 10.
3.1.4 Using Dynamic C or the RFU to Download
Regardless of whether you use the RFU or Dynamic C, downloading across an Ethernet connec-
tion is essentially the same as across a serial connection.
The RFU downloads bin files that were previously created using Dynamic C. Dynamic C starts
with a source code file and compiles it down to the target.
3.1.5 Remote Debugging with Dynamic C
Once a program is successfully downloaded to the target controller attached to the RabbitLink,
Dynamic C may be used to debug the program as if the PC running Dynamic C was directly con-
nected to the target. Refer to the Dynamic C User’s Manual for detailed information on download-
ing and debugging.
3.1.6 Troubleshooting Tips
•If Dynamic C is unable to establish communication with the RabbitLink, make sure that the
RabbitLink is powered on, and make sure that the Ethernet cable is firmly connected to the
RabbitLink and that the LED labeled LINK is on.
•If Dynamic C is still unable to establish communication with the RabbitLink, make sure that
Dynamic C has the correct IP address and control port information. Look in the
Communications dialog box.
•If Dynamic C is able to establish communication with the RabbitLink, but midway through the
download process displays either "Error receiving Flash ID from target"or
"Target Communication Error,”check to make sure that the program download cable is
plugged in correctly from the RabbitLink to the controller being programmed, and that the con-
troller is powered on.

User’s Manual 15
3.2 RabbitLink Firmware
The firmware necessary to operate the RabbitLink with a Rabbit-based target system is loaded at
the factory. This means that after the hardware connections have been made and the network
parameters configured, the RabbitLink is ready to download a program to the local or remote Rab-
bit-based system.
If it is necessary to reload or replace the firmware, the following .bin files are available for
download from the RabbitLink directory that was created when Dynamic C installed. The .bin
files are downloaded to the Rabbitlink using the RFU. The corresponding source files are in the
same directory and may be used instead by compiling them to the RabbitLink using Dynamic C.
•CLEAR_PARAM.BIN—Binary image to reset the network configuration parameters of the
RabbitLink board (stored on the second flash) to default values. This binary file is used to
reset the serial port if its operation has become undefined.
•DOWNLOAD.BIN—RabbitLink firmware binary image.
The RabbitLink firmware version must be compatible with the version of Dynamic C that is used
to download applications to the target that is connected to the RabbitLink (see Table 2). The com-
panion CD in the RabbitLink Tool Kit contains versions 1.00, 2.00 and 2.05 of the firmware.
3.2.1 Downloading Firmware to the RabbitLink
Follow these steps to reload the firmware or to reset the RabbitLink serial port.
1. Connect the RabbitLink board to your PC as shown in Figure 3.2.1-1 with the PROG connector
on the programming cable connected to the PROG IN header of the RabbitLink board.
Figure 3.2.1-1 RabbitLink Connections for Downloading Firmware
2. Use the RFU version 2.0 or later to load the DOWNLOAD.BIN firmware or the
CLEAR_PARAM.BIN binary image onto the RabbitLink board.
3. Disconnect the programming cable.
4. Unplug the power supply, then plug the power supply back in. This resets the RabbitLink from
Program Mode to Run Mode.
Flash
EPROM
Flash
EPROM
DIAG
90
15 65
SRAM
Colore e ge
own
PROG
Programming Cable
J9
PROG OUT IN PROG
J8
To
PC COM port
PROG

16 RabbitLink (EG2100)
3.2.2 Firmware Upgrades
Follow the above steps to install a firmware upgrade. Just substitute the name of the firmware
upgrade for the firmware binary image file (DOWNLOAD.BIN ). Firmware upgrades will be avail-
able at
www.rabbitsemiconductor.com or at www.zworld.com
3.3 Serving Web Pages and Sending E-Mail
The RabbitLink is intended for downloading and debugging across an Ethernet-based network
with a Rabbit-based target. However, it is possible to use the RabbitLink to send e-mail and serve
web pages from the Rabbit-based target. This isn’t recommended. Z-World offers DeviceMate as a
better-fit solution for those who wish to use Internet services.
3.3.1 Using DeviceMate Features
The DeviceMate feature set has many options, such as watchdogs and message logging, and also
an interface that is easier to use than what is available on the RabbitLink. For more information
about DeviceMate, please visit the Zworld website:
http://www.zworld.com
The DeviceMate software may be downloaded to the RabbitLink to replace the RabbitLink firm-
ware.
3.3.2 Using RabbitLink Features
RabbitLink console commands may be used to send e-mail and serve web pages. A complete list
of the available commands are in Appendix E, “Serial Console Commands.”
Prior to Dynamic C 7.20, a console API existed for target applications to send console commands
to the RabbitLink. Please see Appendix E.6, starting on page 39 for API function descriptions.
Starting with Dynamic C 7.20, the console commands are sent to the RabbitLink through the serial
port interface.