1. Introduction & Overview

The DeviceMate Development Kit provides a hardware platform based on the Rabbit 2000^TM microprocessor and Dynamic C^® to connect any programmable embedded device with a serial connection to the Internet/Ethernet. The intended user of the DeviceMate Development Kit should have a working knowledge of C and TCP/IP.

The DeviceMate Development Kit includes all the hardware and software needed to demonstrate the use of the DeviceMate with the two RabbitCore modules supplied, the RCM2200 (the hardware platform) and the RCM2300 (the target).

1.1 Definitions

The following terms are used throughout this manual.

DeviceMate refers to the Dynamic C software that enables any embedded device with a serial connection to be connected to the Internet/Ethernet.

The DeviceMate hardware platform, also referred to as the DeviceMate Unit (DMU), is any Ethernet-enabled Z-World Rabbit-based single-board computer.

The DeviceMate target, also referred to as the target device, is an embedded single-board computer that is connected to the DeviceMate hardware platform via a serial port.

1.2 DeviceMate Hardware

The DeviceMate hardware platform provided in the DeviceMate Development Kit is the RCM2200, an advanced module that incorporates 256K flash memory, 128K static RAM, digital I/O ports, and a 10Base-T Ethernet port. An RCM2300 module is included in the Development Kit to serve as a working sample target device.

Other Z-World Rabbit-based single-board computers with an Ethernet port can also be used as a DeviceMate hardware platform.

1.2.1 DeviceMate Capabilities

• Monitor inputs or variables remotely on the target device via a Web browser.
• Allows target device to send e-mail and serve Web pages via the DeviceMate hardware platform.
• Stores and retrieves files generated by target device.
• Download new programs via Internet/Ethernet to target device.
• Log information about events, data, or error conditions.
• Use as an external watchdog for the target device.

1.3 Development Software

The software includes library support to program the DeviceMate target and the DeviceMate hardware platform. The program that runs on the hardware platform is a canned program in source code form, and all you have to do is set some macros to enable the software features you will use, set the IP address, then compile and load the program on the hardware platform. Additional programming may be required for some subsystems or for custom user functionality. The target is then programmed separately to interact with the hardware platform via a serial port.

The subsystems are also provided in ANSI C using three nonRabbit architectures. Instructions for porting this code are provided in the DeviceMate Software User's Manual. ANSI C sample programs, which can be ported to other processors, are included with the DeviceMate sample programs on the CD to illustrate how to use nonRabbit-based target devices with the RCM2200 hardware platform.

Dynamic C must be installed on a Windows workstation with at least one free serial (COM) port. See Chapter 3, "Software Installation & Overview," for complete information on installing Dynamic C.

NOTE	Dynamic C v7.10 or later is required to develop applications for the DeviceMate hardware platform. The DeviceMate and other Dynamic C libraries are included on the Development Kit CD-ROM.

The DeviceMate hardware platform provides the following sservices.

• E-mail access
• File system facility
• Message logging (with multiple storage options)
• Remote monitoring of target I/O
• Remote program download (Rabbit-based targets only)
• External watchdog services for the target device
• TCP and UDP sockets
• Serve Web pages
• Update HTML pages with dynamic variables

1.4 How to Use This Manual

This Getting Started manual is intended to give users a quick but solid start with the RCM2200 as the DeviceMate hardware platform. The manual does not contain detailed information on the RCM2200 hardware capabilities, the Dynamic C development environment, or the TCP/IP software support for the integrated Ethernet port. More detailed information on some or all of these topics is available to allow you to make effective use of the DeviceMate hardware platform.

1.4.1 Additional Information

Detailed information about the RCM2200 and the RCM2300 will be found in the RabbitCore RCM2200 User's Manual and in the RabbitCore RCM2300 User's Manual, which are provided on the accompanying CD-ROM in both HTML and Adobe PDF format.

NOTE	We recommend that anyone not thoroughly familiar with Z-World single-board computers at least read through the rest of this manual to gain the necessary familiarity to make use of the more advanced information.

In addition to the product-specific information contained in the hardware user's manuals, several higher-level reference manuals are provided in HTML and PDF form on the accompanying CD-ROM. Users will find these references valuable in developing specific applications for the DeviceMate.

• Dynamic C Premier User's Manual
• DeviceMate Software User's Manual
• An Introduction to TCP/IP
• Dynamic C TCP/IP User's Manual
• Rabbit 2000 Microprocessor User's Manual

1.4.2 Online Documentation

The online documentation is installed along with Dynamic C, and an icon for the documentation menu is placed on the workstation's desktop. Double-click this icon to reach the menu. If the icon is missing, create a new desktop icon that points to default.htm in the docs folder, found in the Dynamic C installation folder.

The latest versions of all documents are always available for free, unregistered download from our Web site at www.zworld.com.