RabbitLink User's Manual

> ## 2. Getting Started

> Chapter 2 explains how to connect the programming cable and power supply to the RabbitLink. Basic Ethernet network connections are shown, and instructions for configuring the network parameters on the RabbitLink serial console are included.

> ### 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 × ¼ screws supplied.

> Figure 3. Attach RabbitLink Board to Plastic Enclosure Base

> The plastic enclosure base facilitates handling the RabbitLink during development. The plastic enclosure is offered as a separate option when individual RabbitLink boards are purchased.

> NOTE | Appendix B, "Plastic Enclosure," provides additional information and specifications for the plastic enclosure.

> 2. 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 labled PROG IN, on the RabbitLink. Ensure that the colored edge lines up with pin 1 as shown. Connect the other end of the programming cable to a COM port on your PC. Note that COM1 on the PC is the default COM port in Dynamic C Premier.

> Figure 4. Programming Cable Connections
> 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 environment, and Option 2 can be used to connect the RabbitLink to an existing power supply in a field installation. The red USER LED comes on once power is applied successfully.

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

> Option 2 - Via Screw Terminal Header J5/J6

> NOTE | Do not do this hookup if you have already connected the AC adapter (Option 1).

> Connect the + lead (red) to DCIN on header J5/J6, and connect the - lead (black) to GND on header J4/J5 as shown in Figure 5.

> Figure 5. Alternative Power Supply Connections

> NOTE | It is important that you hook up the positive and negative power leads exactly as described. There is no reverse polarity protection through header J5/J6.

> 4. Apply power.

> Once the RabbitLink is powered up and connected to your PC, you are ready to configure the network parameters described below.

> ### 2.2 Configuring RabbitLink Network Parameters from Your PC

> 1. Open a terminal emulator such as Tera Term or Windows Hypertermal on your PC. Configure the terminal emulator as follows.

> 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

> Click OK once these parameters have been set. You should now be able to type commands.

> NOTE | If no characters appear when you type, press return, then type echo on to turn on the echoing of characters.

> 2. Configure the RabbitLink network parameters. You will need to know your network parameters. Ask your network administrator for assistance, if necessary.

> NOTE | Type show to get a list of all assignable variables and their settings.

> Set IP Address--Type set ip x.x.x.x, where x.x.x.x is the IP address you wish to assign to the RabbitLink board. Factory default: 10.10.1.100.
> Set Gateway--Type set gateway x.x.x.x, where x.x.x.x is the gateway you wish to assign to the RabbitLink board. Factory default: 10.10.1.1.
> Set Netmask--Type set netmask x.x.x.x, where x.x.x.x is the netmask you wish to assign to the RabbitLink board. Factory default: 255.255.255.0.
> Set sender's E-mail address--Type set mail from <username@domain.ca>, where <username@domain.ca> is the E-mail address of the target system "sender" (used only if the RabbitLink is being configured for E-mail).
> Set mail server IP address--Type set mail server x.x.x.x, where x.x.x.x is the IP address of the RabbitLink mail server (used only with E-mail).
> Set Port--Type set port x, where x is the TCP port number. The default TCP port used is 4244. If you are using the RabbitLink across a firewall, and the firewall changes TCP port values, it may be necessary to change the TCP port number.
> Set Name--Type set hostname <name>, where <name> is a unique name (up to 40 characters) that you assign to the RabbitLink board. This name is not tied to any of the network addresses, but does show up in the Dynamic C Premier discovery window. This feature allows the RabbitLink board to retain a given name even if its IP or other network address changes.
> Set Password--Type set passphrase, and you will be prompted for a password. This feature protects the RabbitLink from unwanted Internet connections. The password is not limited to 8 characters, and indeed the password should be as long as possible (up to 255 characters) to increase the security of the system.

> #### 2.2.1 Other Useful Commands

> Review Settings--Type show to get a list of all assignable variables and their settings (except the password).
> Reset--Type reset to reset the values (except the password) to their factory defaults.
> Help--Type help to get online help. You may limit the topics listed by typing help ... to limit the help information to the topic specified.

> NOTE | Appendix F, "Serial Console Commands," provides a complete list of the serial console commands.

> ### 2.3 Target System Connections to the RabbitLink

> Once the RabbitLink network parameters have been configured, the RabbitLink is ready to be used to link any Rabbit-based system to an Ethernet-based network.

> 1. If you have not already done so, disconnect and set aside the programming cable used to connect the COM port on your PC to header J8, which is labeled PROG IN, on the RabbitLink board.
> 2. Connect the 10-pin PROG connector of the program download cable to the programming header of the Rabbit-based system you are going to interact with. Check that the colored edge of the cable lines up with pin 1 of the programming header as shown in Figure 6.
> 3. Connect the unmarked connector of the program download cable to header J9, which is labeled PROG OUT, on the RabbitLink. Check that the colored edge of the cable lines up with pin 1 of the PROG OUT header as shown in Figure 6.
> 4. The RabbitLink must be connected to an Ethernet-based network via an Ethernet hub.
> Figure 6. Connect Rabbit-Based Target System to RabbitLink

> ### 2.4 Ethernet Connections

> Before proceeding, you will need to have either two straight-through Ethernet cables and an Ethernet hub or one Ethernet crossover cable. Your PC must have an RJ-45 Ethernet jack.

> NOTE | 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 usually has an LED or two on it. If your PC does not have Ethernet access, you will need to install at least a 10BaseT Ethernet card (available from your favorite computer supplier).

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

> Connect your PC and the RabbitLink board to an Ethernet hub as shown in Figure 7. The Ethernet hub may also be connected to your network.

> Figure 7. Connect PC and RabbitLink Board to Ethernet Hub

> Figure 8. Link LED Lights Up When Connections Made

> Alternatively, you may use the crossover Ethernet cable to connect the RabbitLink directly to a PC RJ-45 Ethernet jack.

> The green LINK LED should light up once all the connections have been made correctly.

> Dynamic C (version 7.03 or later) or the Rabbit Field Utility (version 2.0 or later) on your PC may now be used to download a program to the Rabbit-based target system. The red USER LED on the RabbitLink blinks while the download or a debug session is in progress.

> NOTE | The Rabbit Field Utility is included on the companion CD. The companion CD also contains a binary image of the firmware, and has the support documention for the RabbitLink.

> ### 2.5 Where Do I Go From Here?

> If you have any problems, call Rabbit Semiconductor Technical Support at (530)757-8400 or Z-World Technical Support at (530)757-3737.

> - Chapter 3, "RabbitLink Software," describes the firmware used to enable the RabbitLink to be a Web server or to originate E-mail. A brief description of Dynamic C for downloading/debugging via the RabbitLink is also included.
> - Appendix A, "Specifications," provides specifications.
> - Appendix B, "Plastic Enclosure," provides information on the optional plastic enclosure.
> - Appendix C, "Install Firmware and Upgrades," provides instructions for installing firmware and firmware updates on your RabbitLink.
> - Appendix D, "Subsystems," provides detailed information about the RabbitLink subsystems.
> - Appendix E, "Programming Cable," provides additional information about the programming cable and the Rabbit 2000TM programming port..
> - Appendix F, "Serial Console Commands," lists all the console commands.

Z-World http://www.zworld.com Voice: (530) 757-3737 FAX: (530) 753-5141 sales@zworld.com | Rabbit Semiconductor http://www.rabbitsemiconductor.com Voice: (530) 757-8400 FAX: (530) 757-8402 sales@rabbitsemiconductor.com