1. Manuals
  2. Brands
  3. Z-World Manuals
  4. Modem
  5. EG2110
  6. User manual

Z-World EG2110 User Manual

Network programming gateway
Hide thumbs
Table of Contents

Advertisement

Quick Links

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

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the EG2110 and is the answer not in the manual?

Questions and answers

Summary of Contents for Z-World EG2110

  • Page 1 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...
  • Page 2 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.

  • Page 3: Table Of Contents

    1.5.2 Interfacing the RabbitLink to Other Devices ................6 Chapter 2. Getting Started 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...
  • Page 4 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 Schematics...

  • Page 5: Chapter 1. Introduction

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

  • Page 6: Rabbitlink Features

    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: •...

  • Page 7: Development And Evaluation Tools

    • 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 V DC at 120 mA is recommended.

  • Page 8: Software

    • 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,"...

  • Page 9: Passphrase Protection

    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.

  • Page 10: Design Guidelines

    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.

  • Page 11: Chapter 2. Getting Started

    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.
  • Page 12 DIAG 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...
  • Page 13 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.

  • Page 14: Configuring Rabbitlink Network Parameters From Your Pc

    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.

  • Page 15: Target System Connections To The Rabbitlink

    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.

  • Page 16: Ethernet Connections

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

  • Page 17: Chapter 3. Rabbitlink Software

    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 18: Password Protection

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

  • Page 19: Rabbitlink Firmware

    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.

  • Page 20: Firmware Upgrades

    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.

  • Page 21: Notice To Users

    Notice to Users Z-WORLD PRODUCTS ARE NOT AUTHORIZED FOR USE AS CRITICAL COMPONENTS IN LIFE-SUPPORT DEVICES OR SYS- TEMS UNLESS A SPECIFIC WRITTEN AGREEMENT REGARD- ING SUCH INTENDED USE IS ENTERED INTO BETWEEN THE CUSTOMER AND Z-WORLD PRIOR TO USE. Life-support devices or systems are devices or systems intended for surgical implantation into the body or to sustain life, and whose failure to perform, when properly used in accordance with instructions for use provided in the labeling and user’s...
  • Page 22 User’s Manual...

  • Page 23: Appendix A. Specifications

    A. S PPENDIX PECIFICATIONS Appendix A provides the specifications for the RabbitLink and describes the conformal coating. A.1 Electrical and Mechanical Specifications Figure A.1-1 shows the mechanical dimensions for the RabbitLink. All measurements are in inches followed by millimeters enclosed in parentheses.
  • Page 24 Table A.1-1 lists the electrical, mechanical, and environmental specifications for the RabbitLink. Table A.1-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) one 2 ×...

  • Page 25: Conformal Coating

    A.2 Conformal Coating The area around the crystal oscillator and the battery backup circuit on the RabbitLink has had the Dow Corning silicone-based 1-2620 conformal coating applied. The conformally coated area is shown in Figure A.2-1. The conformal coating protects these high-impedance circuits from the effects of moisture and contaminants over time.
  • Page 26 RabbitLink (EG2110)

  • Page 27: Appendix B. Plastic Enclosure

    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 28 2. Install light pipes (optional). Light pipes are included in the tool kit so you can see the LEDs on the RabbitLink board once the enclosure is assembled. Figure B.1-2 Install Light Pipes in Enclosure Top With the enclosure top positioned as shown in Figure B.1-2, insert three light pipes into the slots identified in Figure B.1-2.
  • Page 29 4. Mount plastic enclosure (optional). Use four #10 screws to attach the assembled plastic enclosure to the surface on which it will be mounted. This step applies to production versions of RabbitLink boards once development has been completed. User’s Manual...

  • Page 30: Dimensions

    B.2 Dimensions Figure B.2-1 shows the dimensions for the plastic enclosure. Figure B.2-1 Plastic Enclosure Dimensions When fully assembled with the RabbitLink installed, the total height of the plastic enclosure will be 1.1" (28 mm). RabbitLink (EG2110)

  • Page 31: Appendix C. Subsystems

    • Reset Generator C.1 RabbitLink Hardware Subsystems Figure C.1.0-1 shows the Rabbit-based subsystems designed into the RabbitLink and shows the parallel ports and signal lines they use on the Rabbit 2000 microprocessor. Figure C.1.0-1 RabbitLink Subsystems NOTE: PB0 is an output by default, but can be an input by removing jumper R58 and adding jumpers R59 and R60.

  • Page 32: Pinouts

    PROG IN DIAG work addresses for the RabbitLink. This connection transmits information to and from a PC run- ning a terminal emulation program. The header is also used with the connector on...

  • Page 33: Ethernet Port

    RAM and flash memory sizes automatically. C.3.1 SRAM The RabbitLink is designed to accept 128K or 512K of SRAM packaged in an SOIC case. It comes standard with 128K of SRAM. Figure C.3.1-1 shows the locations and the jumper settings for the jumpers at JP4 used to set the SRAM size.

  • Page 34: Flash Eprom

    C.3.2 Flash EPROM The RabbitLink is designed to accept 128K to 512K of flash memory packaged in a TSOP case. It comes with two 256K flash memories, one for the firmware and one for data. Figure C.3.1-1 shows the locations and the jumper settings for the jumpers at JP2 and JP3 used to set the flash memory size.

  • Page 35: Appendix D. Programming Cable

    Rabbit to enter cold boot mode after a reset. The reset occurs when the RFU opens the serial port of the PC with the DTR line high, then changes it to low. This pulses the reset line on the RabbitLink.
  • Page 36 RabbitLink (EG2110)

  • Page 37: Appendix E. Serial Console Commands

    The IP address for the gateway in dotted decimal format. The factory IP address default is 10.10.1.1. set hostname <name> This command allows the RabbitLink to be identified with a unique name, that may be up to 40 characters long. User-chosen string. The factory default is RabbitLink. name set ip <IP address>...
  • Page 38 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.

  • Page 39: Variables Commands

    SSI tags must have the file extension .shtml. createv <varname> <vartype> <format> <value> [strlen] This command creates a variable and stores it in the flash file system on the RabbitLink. The variable can be referenced in HTML files using SSI; e.g. <!--#echo var="var1"-->).

  • Page 40: File Commands

    <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 41: E-Mail Commands

    <filename><size> This command sends a binary 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 RabbitLink senses there is no activity.

  • Page 42: Other Console Commands

    This command resets the basic network parameters (the netmask and the IP addresses of the RabbitLink and its gateway) to factory defaults. show [filename] This command lists all assignable variables and their settings, except for the passphrase.

  • Page 43: Rabbitlink Console Api (Prior To Dynamic C 7.20)

    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. Prior to Dynamic C 7.20 these functions were in STDIO.LIB.
  • Page 44 ConsoleFinish 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 any data, but will poll to determine whether there are more data to receive.

  • Page 45: Example Using The Rabbitlink Console Api

    E.7 Example Using the RabbitLink Console API main() { // first method SendToConsole("set ip 10.10.2.102\n", 19); // second method PrintToConsole(1); printf("set gateway 10.10.2.1\n"); PrintToConsole(0); User’s Manual...
  • Page 46 RabbitLink (EG2110)

  • Page 47: Index

    ....14 plastic enclosure ....23 dimensions dimensions ......26 plastic enclosure ....26 port number ......13 RabbitLink board ....19 power supply ......3 voltage ......6, 20 DOWNLOAD.BIN ....15 PrintToConsole() ....39 voltage regulator ....30 downloading program download cable ..
  • Page 48 RabbitLink (EG2110)

  • Page 49: Schematics

    CHEMATICS 090-0168 RabbitLink (EG2110) Schematic www.rabbitsemiconductor.com/documentation/schemat/090-0168.pdf 090-0128 Programming Cable Schematic www.rabbitsemiconductor.com/documentation/schemat/090-0128.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.

This manual is also suitable for:

Rabbitlink

Table of Contents