background image

User’s Manual

39

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. Prior to Dynamic C 7.20 these functions were in 

STDIO.LIB

.

PrintToConsole

int PrintToConsole(char flag);

This function controls 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 length to the serial console on a Rab-
bitLink.   Any data are acceptable since the data will not show up in 

t

he Dynamic C 

STDIO

 window.

PARAMETERS

data

A pointer to the data to be sent.

length 

The length of the buffer passed in data

.

RETURN VALUE

The actual number of bytes written to the console.

Содержание EG2110

Страница 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 ...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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 ...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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 ...

Страница 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 ...

Страница 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...

Страница 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...

Страница 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 ...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 22: ...User s Manual 18 ...

Страница 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 ...

Страница 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 ...

Страница 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...

Страница 26: ...22 RabbitLink EG2110 ...

Страница 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 ...

Страница 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...

Страница 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...

Страница 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 ...

Страница 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 ...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 36: ...32 RabbitLink EG2110 ...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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 ...

Страница 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 ...

Страница 46: ...42 RabbitLink EG2110 ...

Страница 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...

Страница 48: ...44 RabbitLink EG2110 ...

Страница 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 ...

Страница 50: ......

Отзывы: