background image

4

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

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

Summary of Contents for 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: ...roducts 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 530 757 3737 Fax 530 757 3792 www zworld com Rabbit Semiconductor 2932 Spafford Street Davis California 95616 6800 USA Telephone 530 757 8400 Fax 530 757 8402 www rabbitsemiconduc...

Page 3: ... 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 t...

Page 4: ...nication 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 D...

Page 5: ...sed 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 t...

Page 6: ...r 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 co...

Page 7: ...e 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 V DC at 120 mA is recommended Plastic enclosure ...

Page 8: ...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 RabbitLi...

Page 9: ...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 conformit...

Page 10: ...roduct 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...

Page 11: ...re 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 additio...

Page 12: ... 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 Colored edge down DIAG PROG Programming Cable J9 PROG OUT IN PROG J8 To PC COM port DIAG ...

Page 13: ...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 ...

Page 14: ... 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 ch...

Page 15: ...ernative 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 t...

Page 16: ...eed 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 ...

Page 17: ...abbitLink 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 a...

Page 18: ...oading 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 de...

Page 19: ... 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 t...

Page 20: ... 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 Rabb...

Page 21: ... is perfect Bugs are always present in a system of any size In order to prevent danger to life or prop erty it is the responsibility of the system designer to incorporate redun dant protective mechanisms appropriate to the risk involved All Z World products are 100 percent functionally tested Additional test ing may include visual quality control inspections or mechanical defects analyzer inspecti...

Page 22: ...User s Manual 18 ...

Page 23: ... Mechanical Specifications Figure A 1 1 shows the mechanical dimensions for the RabbitLink All measurements are in inches followed by millimeters enclosed in parentheses Figure A 1 1 RabbitLink Dimensions Flash EPROM Flash EPROM 2 13 54 3 43 87 2 85 72 0 65 16 5 4 15 105 0 65 16 5 Jacks extend 0 16 4 0 mm past edge of board 90 15 65 SRAM 0 80 20 4 15 105 ...

Page 24: ...d in power supply Ethernet Interface Direct connection to 10BaseT Ethernet networks via RJ 45 connection Temperature 40 C to 70 C Humidity 5 to 95 noncondensing External Input Voltage 9 V to 40 V DC Current 44 mA at 24 V 84 mA at 12 V typical Onboard Voltage Regulator Surface mount switching regulator sources 5 V at 1 A Microprocessor Rabbit 2000 Clock 22 1 MHz SRAM 128K surface mount Flash EPROM ...

Page 25: ... of moisture and contaminants over time Figure A 2 1 RabbitLink Areas Receiving Conformal Coating Any component in the conformally coated area may be replaced using standard soldering proce dures for surface mount components Apply a new conformal coating afterwards for continued protection against the effects of moisture and contaminants NOTE For more information on conformal coatings refer to Rab...

Page 26: ...22 RabbitLink EG2110 ...

Page 27: ...astic enclosure how to install the optional light pipes and provides details on mounting the 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 1 Attach the board to the base using the two 4 40 screws supplied Figure B 1 1 Attach RabbitLink Board to Plastic Enclosure Base F la ...

Page 28: ...ition the light pipes snugly against the enclosure top since there is little clearance between the light pipes and the LEDs on the RabbitLink board The light pipes snap in place Verify that the light pipes are aligned over the LEDs then apply a drop of 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...

Page 29: ...If you installed the light pipes be sure they are aligned over the LEDs as shown Figure B 1 3 Attach Enclosure Top 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 SRAM Notched side 9 0 1 5 6 5 F la s h E P R O M...

Page 30: ...e 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 5 60 142 2 85 72 1 375 35 0 25 6 4 4 35 110 5 00 127 0 70 18 0 375 9 5 mm is cut off each corner 2 13 54 4 875 124 1 375 35 4 25 108 3 62 92 ...

Page 31: ...nes 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 Port A Port B Port D Port E PA0 PB2 PB0 PB1 PB6 PB7 PC4 PC5 PE5 A0 A4 BUFEN RESET Data Lines RAM Flash PC6 PC7 PD0 PD1 PD2 PE1 PE6 PE7 DA0 DA7 RabbitLink CPU RABBIT 2000 Watchdog Clock Doubler Real Time Clock ...

Page 32: ...N header is used with the DIAG connector on the programming cable to configure net work addresses for the RabbitLink This connection transmits information to and from a PC run ning a terminal emulation program The PROG IN header is also used with the PROG connector on the programming cable With this connection you can download firmware to the RabbitLink and also reset default network addresses The...

Page 33: ...gure C 1 1 1 The transmit and receive data signals on each pair of a 10Base T segment are polarized with one wire of each signal pair carrying the positive signal and the other carrying the negative signal C 3 Memory The RabbitLink has SRAM and flash memory devices The Dynamic C BIOS handles different standard RAM and flash memory sizes automatically C 3 1 SRAM The RabbitLink is designed to accept...

Page 34: ...igure C 4 0 1 Figure C 4 0 1 RabbitLink Power Supply Schematic The power supply connection through jack J4 is handy for the AC adapter included with the Rab bitLink tool kit for desktop demonstration and development The power supply connection through screw terminal connector J5 enables you to connect the RabbitLink directly to a power supply in the production system Capacitor C8 provides noise an...

Page 35: ...ine on the RabbitLink In cold boot mode the processor runs a small program contained in an internal ROM This program receives triplets sent by the PC It is through this mechanism that the RFU sends firmware to the RabbitLink Please see the Rabbit 2000 Designer s Handbook for a detailed description of triplets and the cold boot mode The DIAG Connector The DIAG connector is used to configure network...

Page 36: ...32 RabbitLink EG2110 ...

Page 37: ... 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 IP address The IP address for the gateway in dotted decimal format The factory 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 chara...

Page 38: ...ever a new session starts with Dynamic C or the RFU the user will be asked for the passphrase It should be as long as possible to increase security up to the maximum length of 255 charac ters 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 x The port number The factory defa...

Page 39: ...riable vartype Type of the variable int8 int16 int32 float32 or string format The printf style format specifier such as d for outputting the variable value The value to assign to the variable strlen Maximum length of the string for variables of type string EXAMPLES createv var1 float32 2f 3 14 createv var2 string s This is a test 50 getv varname This command gets the value of the specified variabl...

Page 40: ...les 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 NOTE It is faster and more efficient to transfer all files including ASCII...

Page 41: ... e mail via the RabbitLink to the specified address e mail address The address to which the e mail is sent e g rabbit warren com subject After receiving the mail command the RabbitLink will accept the next string as the subject of the e mail body After receiving the subject of the e mail the RabbitLink will accept strings that follow as the body of the e mail ctrl D ctrl D 0x04 is the end of the e...

Page 42: ...splays the online help filename This optional parameter limits the help information to that which is as 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 show filename This command lists all assignable variables and their settings except for the passphrase filename This opti...

Page 43: ...ols whether Stdio commands such as printf go to the RabbitLink serial console in addition to the Dynamic C Stdio window PARAMETER flag 0 printf and related commands work as normal 1 printf and related commands go to the RabbitLink serial console as well RETURN VALUE 0 if successful 1 if not SendToConsole int SendToConsole char data int length This function writes a binary buffer of a specified len...

Page 44: ...e timeout is set to 0 the function will not receive any data but will poll to determine whether there are more data to receive PARAMETERS timeout The length of time to time out in milliseconds and is 0 for ConsoleFinish to determine whether there are more data to receive RETURN VALUE 0 if there are more data on the serial console and non zero if all the data have been re ceived LIBRARY STDIO LIB ...

Page 45: ...User s Manual 41 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 ...

Page 46: ...42 RabbitLink EG2110 ...

Page 47: ...nternet services 16 M memory devices 29 P passphrase protection 5 password 14 pinout Ethernet jack and program ming headers 28 programming port 31 plastic enclosure 23 dimensions 26 port number 13 power supply 3 PrintToConsole 39 program download cable 11 programming cable 3 DIAG connector 31 programming cable connections 8 programming port 28 pinout 31 used as diagnostic port 31 R Rabbit Field Ut...

Page 48: ...44 RabbitLink EG2110 ...

Page 49: ...abbitsemiconductor 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 You may also use the URL information provided above to access the latest schematics directly ...

Page 50: ......

Reviews: