User`s manual

DeviceMate Web Enables Your New and Existing Products
In an increasingly ‘connected’ world,
Z•World’s new DeviceMate provides a
comprehensive and low-cost solution
for designers who want to quickly web-
enable their new or existing devices
and systems. DeviceMate offers a seam-
less integration of powerful hardware
and software, allowing users to remotely
monitor and supervise any programmable
device equipped with a serial interface.
The DeviceMate Development Kit con-
tains everything needed to jumpstart
development, including the RCM2200
core module (Z•World’s most compact
Ethernet hardware) as the DeviceMate
unit, a sample target unit, complete
DeviceMate software with no royalties
or license fees, and an easy-to-use
demonstration system.
The DeviceMate unit acts as a multi-
purpose programmable interface
between the Internet/Ethernet and target
devices. Operating independently from
the target system, DeviceMate continues
to function even if the target system
fails. DeviceMate can send E-mail
alarms and facilitate communication
for diagnosis and repair when an
exceptional event occurs. DeviceMate
can also use TCP and UDP sockets,
serve dynamic web pages, read inputs
and variables remotely, and log data
generated by the target system.
DeviceMate’s unique software feature
set combines the industry-proven
Dynamic C
®
development system with
all the necessary sample programs and
library support for both the DeviceMate
unit and target system. Development
for the DeviceMate can be as simple as
modifying an existing demo program
(such as setting the IP address) and then
compiling and downloading the program
to the DeviceMate unit. Library API
functions are provided for programming
the target.
DeviceMate is well suited for a wide
range of applications, including vending
and gaming machines, security systems,
home automation, building controls,
and manufacturing equipment. When
implementing a DeviceMate solution in
a production environment, designers
can use any Ethernet-enabled Z•World
single-board computer or core module
featuring the powerful Rabbit 2000
microprocessor.
Features
Use TCP and UDP sockets
Send E-mail
Store and retrieve files
Serve dynamic web pages
Read inputs and variables remotely
Log events, data, or error conditions
No royalties or license fees!
DeviceMate Unit (RCM2200)
DeviceMate Development Kit
TCP/IP: Changing the Network Configuration Information
There are a couple of ways to set the IP address, netmask, gateway, and name server. You can set the default settings
by defining the MY_IP_ADDRESS, MY_NETMASK, MY_GATEWAY, and MY_NAMESERVER macros. These macros
define the networking information, unless they are overridden by some other means.
Dynamic C provides a convenient way to change these values at runtime through the tcp_config interface.
This function takes two strings. The first string is the name of the parameter you want to override, and the second
string is the value you want to set. For example, tcp_config (“MY_IP_ADDRESS”, “10.0.0.120”) will change the
IP address of your board to 10.0.0.120.
Combining the tcp_config function with the file system and a user interface gives you a convenient way to
dynamically update the network information on your device. If you are planning on using a serial port for this
configuration, consider using the ZConsole library, which provides a canned set of network configuration routines.
Dynamic C also supports setting the basic information using DHCP (Dynamic Host Configuration Protocol).
This method causes the controller to contact a network device that supplies it with the configuration information.
An example of using DHCP can be found in the samples/tcpip/dhcp.c program.
In Control • Fall 2001 • www.zworld.com
2