1. Introduction

The Jackrabbit is a high-performance, C-programmable controller with a compact form factor. A Rabbit 2000 microprocessor operating at 30 MHz provides fast data processing.

1.1 Features

• 30 MHz clock
• 24 CMOS-compatible I/O
• 3 analog channels: 1 A/D input, 2 PWM D/A outputs
• 4 high-power outputs (factory-configured as 3 sinking and 1 sourcing)
• 4 serial ports (2 RS-232 or 1 RS-232 with RTS/CTS, 1 RS-485, and 1 CMOS-compatible)
• 6 timers (five 8-bit timers and one 10-bit timer)
• 128K SRAM, 256K flash EPROM
• Real-time clock
• Watchdog supervisor
• Voltage regulator
• Backup battery

Appendix A provides detailed specifications for the Jackrabbit.

Three versions of the Jackrabbit are available. Their standard features are summarized in Table 1.

Table 1. Jackrabbit Series Features

Model	Features
BL1800	Full-featured controller with switching voltage regulator.
BL1810	BL1800 with 14.7 MHz clock, 128K flash EPROM, linear voltage regulator, sinking outputs sink up to 200 mA, sourcing output sources up to 100 mA, RS-232 serial ports rated for 1 kV ESD
BL1820	BL1810 with 3 additional digital I/O, no RS-485, no backup battery, 32K SRAM.

1.2 Development and Evaluation Tools

1.2.1 Development Kit

The Development Kit has the essentials that you need to design your own a microprocessor-based system, and includes a complete software development system (Dynamic C).

The items in the Development Kit and their use are as follows:

• CD-ROM with Dynamic C software, Jackrabbit controller and Rabbit^TM 2000 microprocessor documentation. You may install this software by inserting the disk into your CD-ROM drive. If it doesn't start automatically, click on "setup.exe." This software runs under Windows `95, Windows `98, and Windows NT. We suggest taking the option to load the documentation to your hard disk. The documentation is in both HTML and Adobe PDF format, and may be viewed with a browser.
• Jackrabbit BL1810 controller board. This is a complete controller board that includes a Rabbit 2000 processor, 128K of flash memory, and 128K of RAM.
• Prorotyping Board. The Jackrabbit board can be plugged into this board. The Prorotyping Board includes various accessories such as pushbutton switches, LEDs, and a beeper. In addition, you can add your own circuitry in the prototyping space provided.
• Programming cable. The programming cable is used to connect your PC serial port to the Jackrabbit board to write and debug C programs that run on the Jackrabbit board.
• Loose parts kit. This bag of parts contains parts that you can solder to the Prorotyping Board for various demonstrations.
• AC adapter. The AC adapter is used to power the Jackrabbit board. The wall transformer is supplied only for Development Kits sold for the North American market. The Jackrabbit can also be powered from any DC voltage source between 7.5 V and 25 V. The regulator becomes rather hot for voltages above 15 V.

1.2.2 Documentation

• Our documentation is provided in paperless form on the CD-ROM included in the Development Kit. (A paper copy of the "Getting Started Manual" is included.) Most documents, including this comprehensive Jackrabbit User's Manual, are provided in two formats: HTML and PDF. HTML documents can be viewed with an Internet browser, either Netscape Navigator or Internet Explorer. HTML documents are very convenient because all the documents are hyperlinked together, and it is easy to navigate from one place to another. PDF documents can be viewed using the Adobe Acrobat reader, which is automatically invoked from the browser. The PDF format is best suited for documents requiring high resolution, such as schematics, or if you want to print the document. Don't print a hard copy from the HTML version because the HTML version has no page numbers and the cross-references and table of contents links only work if viewed on line. The PDF versions contain page number references to allow navigation when reading a paper version of the manual. To view the online documentation with a browser, open the file default.htm in the docs folder. When you open the default.htm file with your browser, you will see a page similar to that shown below.

1.2.3 Software

The Jackrabbit is programmed using Z-World's Dynamic C, an integrated development environment that includes an editor, a C compiler, and a debugger. Library functions provide an easy-to-use interface for the Jackrabbit board.

The Prorotyping Board includes pushbutton switches, LEDs, and a beeper, and is plugged into the Jackrabbit board. By writing programs that run on the Jackrabbit board, you can flash the LEDs, beep the beeper, and otherwise demonstrate the capabilities of the Jackrabbit. Schematics for both boards are included on the CD-ROM in PDF format.

The Jackrabbit board has a standard Rabbit programming connector, which is a 10-pin header with a 2 mm pitch. A programming cable is used to connect a PC serial port (COM port) to the Jackrabbit board. The programming cable has a level converter board in the middle of the cable since the programming connectors support CMOS logic levels, and not the higher voltage RS-232 levels that are used by PC serial ports. When the programming cable is connected, Dynamic C running on the PC can hard-reset the Jackrabbit board and cold-boot it. The cold boot includes compiling and downloading a BIOS program that stays resident while you work. If you crash the target, Dynamic C will automatically reboot and recompile the BIOS if it senses that a target communication error occurred.

You have a choice of doing your software development in the flash memory or in the static RAM included on the Jackrabbit board. There are 128K bytes in each memory. Some versions of the Jackrabbit board have only 32K bytes of static RAM. If you use one of these boards, you must do development in flash memory. The advantage of working in RAM is to save wear on the flash, which is limited to about 100,000 writes.

NOTE	Note that an application can be developed in RAM, but cannot run standalone from RAM after the programming cable is disconnected. All applications can only run from flash.

When using flash, the compile to a file is followed by a download to the flash. The disadvantage of using flash is that interrupts must be disabled for approximately 5 ms whenever a break point is set in the program. This can crash fast interrupt routines that are running while you stop at a breakpoint or single-step the program. Flash or RAM is selected on the Options-Compiler menu.

Dynamic C provides a number of debugging features. You can single-step your program, either in C, statement by statement, or in assembly language, instruction by instruction. You can set break points, where the program will stop, on any statement. You can evaluate watch expressions. A watch expression is any C expression that can be evaluated in the context of the program. If the program is at a break point, a watch expression can view any expression using local or external variables. If the program is running and a call to the debugger is included in the user's code (runwatch();), it is possible to evaluate watch expressions using global variables only while the target program continues to run, slowed down only by the need to refresh a display in response to a <Ctrl-U> command.