Table of Contents
Advertisement
Quick Links
Advertisement
Table of Contents
Summary of Contents for Z-World RabbitLink EG2100
- Page 1 RabbitLink (EG2100) Network Programming Gateway User’s Manual 019–0090 • 020222–B...
- Page 2 Specifications are based on characterization of tested sample units rather than testing over temperature and voltage of each unit. Z-World may qualify compo- nents to operate within a range of parameters that is different from the manufac- turer’s recommended range.
-
Page 3: Table Of Contents
ABLE OF ONTENTS Chapter 1. Introduction 1.1 RabbitLink Features..........................1 1.2 Development and Evaluation Tools......................2 1.2.1 Manual Conventions ........................3 1.3 Software ..............................3 1.3.1 Upgrading to Dynamic C 7.20 ......................3 1.3.2 Remote Downloading and Debugging ..................3 1.3.3 Passphrase Protection........................3 Chapter 2. Getting Started 2.1 RabbitLink Connections ........................5 2.2 Configuring RabbitLink Network Parameters from Your PC ..............8 2.2.1 Dynamically Assigned Network Parameters ................8... - Page 4 C.1 RabbitLink Hardware Subsystems ....................24 C.1.1 Pinouts ............................24 C.2 Serial Communication ........................25 C.2.1 Serial Programming Ports......................25 C.2.2 Ethernet Port ..........................25 C.3 Memory ............................. 26 C.3.1 SRAM ............................26 3.3.2 Flash EPROM..........................26 3.3.3 Dynamic C Premier BIOS Source Files ..................26 C.4 Power Supplies ..........................
-
Page 5: Chapter 1. Introduction
1. I NTRODUCTION 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 a Rabbit-based embedded system. The RabbitLink provides an indirect connection between the two for remote downloading and debugging. -
Page 6: Development And Evaluation Tools
1.2 Development and Evaluation Tools The RabbitLink board comes with a program download cable. This cable connects a Rabbit-based controller to the RabbitLink board. 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: •... -
Page 7: Manual Conventions
Version 2.20 1.3.1 Upgrading to Dynamic C 7.20 Z-World recommends upgrading to Dynamic C 7.20 as soon as possible. This requires upgrading the firmware for older RabbitLink boards (boards shipped in the 2nd quarter of 2002 have version 2.00 firmware). The simplified structure of the new RabbitLink firmware is more flexible and is also more stable and robust. - Page 8 RabbitLink (EG2100)
-
Page 9: Chapter 2. Getting Started
2. G ETTING TARTED This chapter shows how to make the necessary hardware connections and how to configure the network parameters for the RabbitLink. 2.1 RabbitLink 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 3. Attach the RabbitLink board to the base at the top left and bottom right positions using the two 4-40 ×... - Page 10 2. Connect the programming cable to configure network parameters from your PC. Connect the 10-pin connector of the programming cable to header J8, which is labeled DIAG , on the RabbitLink. Ensure that the colored edge lines up with pin 1 as shown. Connect PROG IN the other end of the programming cable to a COM port on your PC.
- Page 11 3. Connect the power supply. Two options are available for powering the RabbitLink—via an AC adapter to power supply jack J4, or through a screw terminal header at J5/J6. Option 1 is most convenient in a desktop environ- ment, and Option 2 can be used to connect the RabbitLink to an existing power supply in a field installation.
-
Page 12: Configuring Rabbitlink Network Parameters From Your Pc
2.2 Configuring RabbitLink Network Parameters from Your PC There are two ways to set the basic network parameters for the RabbitLink. The basic network parameters are: • the IP address of the RabbitLink • the IP address of the gateway •... -
Page 13: Target System Connections To The Rabbitlink
The RabbitLink boots up whenever the power cycles, and then displays the message, RabbitLink Serial Console Version X.XX The RabbitLink serial console will respond OK after each command, or, “ERROR <errnum>” if something went wrong. 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 6. -
Page 14: 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... -
Page 15: Chapter 3. Rabbitlink Software
3. R ABBIT OFTWARE 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. -
Page 16: Password Protect The Embedded Target
3.1.3 Password Protect the Embedded Target 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”... -
Page 17: Rabbitlink Firmware
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 may be used immediately to download a program to the local or remote Rabbit-based system. -
Page 18: Firmware Upgrades
Rabbit-based target. 3.3.1 Using DeviceMate Features Z-World offers DeviceMate as a better-fit solution for those who wish to use Internet services. The DeviceMate feature set has more options, such as watchdogs and message logging, and also an interface that is easier to use than what is available on the RabbitLink. -
Page 19: Appendix A. Specifications
A. S PPENDIX PECIFICATIONS Appendix A provides the specifications for the RabbitLink and describes the conformal coating. User’s Manual... -
Page 20: Electrical And Mechanical Specifications
A.1 Electrical and Mechanical Specifications Figure A-1 shows the mechanical dimensions for the RabbitLink. Figure A-1. RabbitLink Dimensions All measurements are in inches followed by millimeters enclosed in parentheses. RabbitLink (EG2100) - Page 21 Table A-1 lists the electrical, mechanical, and environmental specifications for the Rab- bitLink. Table A-1. RabbitLink Specifications Parameter Specification 3.43" × 4.15" × 0.80" Board Size (87 mm × 105 mm × 20 mm) one RJ-45 (Ethernet) two 2 × 5, 2 mm pitch (serial programming) Connectors one contact power jack for AC adpater one 2-terminal screw connector (18 to 26 AWG wire ) for...
-
Page 22: Conformal Coating
A.2 Conformal Coating The areas around the crystal oscillator and the battery backup circuit on the RabbitLink have had the Dow Corning silicone-based 1-2620 conformal coating applied. The confor- mally coated areas are shown in Figure A-2. The conformal coating protects these high- impedance circuits from the effects of moisture and contaiminants over time. -
Page 23: Appendix B. Plastic Enclosure
B. P PPENDIX LASTIC NCLOSURE The plastic enclosure provides a secure way to enclose your RabbitLink board. The enclosure itself may be mounted on any flat surface. Appendix B describes how to mount the RabbitLink board inside the plastic enclosure, how to install the optional light pipes, and provides details on mounting the assembly. -
Page 24: Assembly
B.1 Assembly 1. Attach the RabbitLink board to the plastic enclosure base. Position the RabbitLink board over the plastic enclosure base as shown below in Figure B-1. Attach the RabbitLink board to the base using the two 4-40 × ¼ screws supplied. Figure B-1. - Page 25 cyanoacrylate or contact cement to the inside of the enclosure around each light pipe to hold it in place. NOTE: Once the glue is applied, it will not be possible to change the alignment of the light pipes without damaging the plastic enclosure. 3.
-
Page 26: Dimensions
B.2 Dimensions Figure B-4 shows the dimensions for the plastic enclosure. Figure B-4. Plastic Enclosure Dimensions When fully assembled with the RabbitLink installed, the total height of the plastic enclosure will be 1.1" (28 mm). RabbitLink (EG2100) -
Page 27: Appendix C. Subsystems
C. S PPENDIX UBSYSTEMS Appendix D describes the principal subsystems for the RabbitLink. • RabbitLink Subsystems • Serial Communication • Memory • Power Supplies User’s Manual... -
Page 28: Rabbitlink Hardware Subsystems
C.1 RabbitLink Hardware Subsystems Figure D-1 shows the Rabbit-based subsystems designed into the RabbitLink and shows the paral- lel ports and signal lines they use on the Rabbit 2000 microprocessor. Figure D-1. RabbitLink Subsystems C.1.1 Pinouts Figure D-2 shows the pinouts for the RJ-45 Ethernet jack and the two programming headers on the RabbitLink board. -
Page 29: Serial Communication
C.2 Serial Communication C.2.1 Serial Programming Ports The RabbitLink board has two 10-pin programming headers labeled J8 and J9. The PROG IN port uses the Rabbit 2000’s serial port A for communication, and the PROG OUT port uses serial port B. The Rabbit 2000 startup-mode pins (SMODE0, SMODE1) are presented to the PROG IN port so that an externally connected device can force a start-up in an external bootstrap mode when the PROG connector on either the programming cable or the program download cable is used. -
Page 30: Memory
The RabbitLink is designed to accept 128K or 512K of SRAM packaged in an SOIC case. The standard models sold by Z-World and by Rabbit Semiconductor come with 128K of SRAM. Figure D-3 shows the locations and the jumper settings for the jumpers at JP4 used to set the SRAM size. -
Page 31: Power Supplies
C.4 Power Supplies Power is supplied to the RabbitLink board from an external source either through jack J4 or through screw terminal connector J5/J6. The connection through jack J4 is protected against reverse polarity by a Sshottky diode at D1 as shown in Figure D-4, but the alternative connection through J5/J6 is not protected against reverse polarity. - Page 32 RabbitLink (EG2100)
-
Page 33: Appendix D. Programming Cable
D. P PPENDIX ROGRAMMING ABLE ™ Appendix E provides additional information for the Rabbit 2000 microprocessor when using the DIAG and PROG connectors on the programming cable with the RabbitLink board. The PROG connector is used only when the programming cable is attached to the PROG IN connector (header J8) on the RabbitLink to download new firmware. - Page 34 The programming port, which is shown in Figure E-1, can serve as a convenient communications port for field setup or other occasional communication need (for example, as a diagnostic port). If the port is simply to perform a setup function, that is, write setup information to flash memory, then the controller can be reset through the programming port and a cold boot performed to start execution of a special program dedicated to this functionality.
-
Page 35: Appendix E. Serial Console Commands
It is pos- sible to use these commands programatically from the target, though it is not recommended. If Internet services are desired, Z-World suggests the DeviceMate software, which may be run on the RabbitLink board. -
Page 36: Configuration Commands
E.1 Configuration Commands These commands are used to set network parameters and to password protect the RabbitLink. set gateway <IP address> This command sets the IP address for the gateway. The IP address for the gateway in dotted decimal format. The factory IP address default is 10.10.6.1. -
Page 37: Variables Commands
set port x This command sets the TCP port number. If the RabbitLink is being used behind a firewall, it may be necessary to punch a hole in the firewall to allow remote access. The port number. The factory default is 4244. set dhcp <on | off>... -
Page 38: File Commands
getv <varname> This command gets the value of the specified variable. The value is printed using the format specifier given in the createv command. The variable whose value is requested. varname putv <varname> <value> This command assigns the specified value to the specified variable. The variable whose value is being changed. - Page 39 list files This command lists all the files in the flash file system on the RabbitLink. put <filename> <body of file> <ctrl-D> This command sends an ASCII file to the flash file system on the RabbitLink. There is a time-out for this command: the data transfer begins no later than 60 seconds after the Rab- bitLink senses there is no activity.
-
Page 40: E-Mail Commands
E.4 E-Mail Commands mail <e-mail address> <subject> <body> <ctrl-D> The mail command sends an e-mail via the RabbitLink to the specified address. The address to which the e-mail is sent; e.g. rabbit@warren.com. e-mail address After receiving the mail command, the RabbitLink will accept the next subject string as the subject of the e-mail After receiving the subject of the e-mail, the RabbitLink will accept... -
Page 41: Other Console Commands
E.5 Other Console Commands echo <on | off> This command toggles the echoing of characters. help [filename] This command displays the online help. This optional parameter limits the help information to that which is as- filename sociated with the specified file. reset This command resets the basic network parameters (the netmask and the IP addresses of the RabbitLink and its gateway) to factory defaults. -
Page 42: Rabbitlink Console Api (Prior To Dynamic C 7.20)
E.6 RabbitLink Console API (prior to Dynamic C 7.20) The RabbitLink serial console may be accessed via the serial port using the PROG IN connector on the RabbitLink, as was done in Chapter 2 to configure the RabbitLink. If RabbitLink firmware version 1.00 is being used, the API functions described in this section will be recognized by the RabbitLink. -
Page 43: Example Using The Rabbitlink Console Api
int ConsoleFinish(long timeout); int ConsoleFinish(long timeout); This function finishes receiving data from the RabbitLink serial console by blocking for an optional amount of time to do it. If the timeout is set to 0, the function will not receive data to receive. any data, but will poll to determine whether there are more PARAMETERS The length of time to time out, in milliseconds, and is 0 for... - Page 44 RabbitLink (EG2100)
- Page 45 NDEX firmware ........3 CLEAR_PARAM.BIN binary AC adapter ......7 Rabbit Field Utility (RFU) ... 10 image ......13 reset ........25 download ......13 reset generator ....27 DOWNLOAD.BIN binary im- RJ-45 Ethernet jack ....10 age ......... 13 configuration ......
- Page 46 RabbitLink (EG2100)
-
Page 47: Schematics
CHEMATICS 090-0112 RabbitLink (EG2100) Schematic www.rabbitsemiconductor.com/documentation/schemat/090-0112.pdf 090-0085 Programming Cable Schematic www.rabbitsemiconductor.com/documentation/schemat/090-0085.pdf The schematics included with the printed manual were the latest revisions available at the time the manual was last revised. The online versions of the manual contain links to the latest revised sche- matic on the Web site.
Need help?
Do you have a question about the RabbitLink EG2100 and is the answer not in the manual?
Questions and answers