home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 18 REXX / 18-REXX.zip / rxcp290.zip / Readme.1st < prev    next >
Text File  |  1996-05-06  |  7KB  |  135 lines
  1. INTRODUCTION
  2.  
  3.  The X-10 company has for years provided a cost-effective and popular means for control of the lights and 
  4.  appliances in the home, by means of the X-10 Home Control System. X-10's CP290 Home Control Interface 
  5.  provides the hardware required to control the X-10 modules from your computer's serial port. Now you can 
  6.  combine the capabilities of the X-10 system with the Power and Flexibility of OS/2, and OS/2's REXX language, 
  7.  with RxCP290 - the REXX Interface to X-10 Home Control. 
  8.  
  9.  RxCP290 is an extension of OS/2's built-in REXX language that provides functions for communicating to the CP290 
  10.  Home Control Interface for X-10. This allows you to control X-10 modules and functions in your home or office 
  11.  from OS/2 REXX Programs. 
  12.  
  13.  The RxCP290 package consists of the following: 
  14.  
  15.       The RxCP290 REXX Functions, in the form of a Dynamic Link Library (DLL). 
  16.  
  17.       This documentation, in both online and printed formats. 
  18.  
  19.       REXX Example programs, including: 
  20.  
  21.          -  SmallTest.CMD - a minimal program that demonstrates the simple turning on of a X-10 Module. 
  22.  
  23.          -  TestCP.CMD - A REXX program with examples and explanation of proper usage of all of the RxCP290 
  24.             Functions. 
  25.  
  26.          -  SaveRest.CMD - a REXX program with procedures for saving and restoring CP290 Timer events to and 
  27.             from disk files. 
  28.  
  29.          -  CP29Web.CMD - An example REXX CGI program that works in conjunction with CP290.html to allow 
  30.             control of any X-10 module from an OS/2-Hosted World Wide Web site. 
  31.  
  32.          -  CP290.RXX - the REXX source to the CP290.EXE X-10 control program included in the package. This 
  33.             program was written with the DrDialog Application Enabler package. 
  34.  
  35.       The CP290.EXE program, a WorkPlace Shell program based on OS/2's Notebook control, with support for all 
  36.        of the basic functions of the CP290 Home Control Interface. This was written in REXX with the DrDialog 
  37.        package. 
  38.  
  39.       An installation program, written in REXX, for installing the RxCP290 package 
  40.   
  41. DISTRIBUTION NOTE
  42.  
  43.  RxCP290 is Distributed as Shareware. This Demonstration Version is the same as the Release Version in all 
  44.  respects, except that the Upload and Download of CP290 Timer Events is disabled for this demonstration
  45.  version.  The Full Release Version, with these functions enabled, is available from BMT Micro for $25.00.
  46.  Please see the file Order.Txt in this distribution for an order form for BMT Micro.
  47.  
  48.  
  49. INSTALLATION - Automatic Installation
  50.  
  51.  Automatic installation may be accomplished by using the Install.cmd REXX program included with the distribution. 
  52.  This installation program will copy the RxCP290 DLL to \OS2\APPS\DLL on your boot drive, and will create a 
  53.  \RxCP290 directory on your boot drive for the rest of the package. 
  54.  
  55.  Should you not wish the rest of the package be installed to this directory, you may specify a directory to install 
  56.  the RxCP290 Utilities, Example Programs, and Documentation to on the command line. For example, to install 
  57.  these in a directory named F:\X10Stuff, you would start install.cmd like this: 
  58.  
  59.  A:\>install F:\X10Stuff
  60.  
  61.  Once started, the Install.cmd program will display the From and To directory information for the installation, and 
  62.  will prompt for a Y/N response. Pressing 'y' or 'Y' will continue the installation, anything else will abort. 
  63.  
  64.  The RxCP290 utilities are ready to run immediately upon completion of the installation process. 
  65.  
  66. INSTALLATION - Manual Installation
  67.  
  68.  If you do not desire to have the RxCP290 DLL in your \OS2\APPS\DLL directory, you may simply copy the dll file 
  69.  to the directory of your choice. If this directory is not included in the LIBPATH as specified in your CONFIG.SYS 
  70.  file, then only REXX programs started in this directory will be able to find and use the RxCP290 functions in this 
  71.  DLL file. 
  72.  
  73.  The remaining RxCP290 Documentation, Example Program, and Utility files may be installed anywhere the user 
  74.  desires. 
  75.  
  76. Trademarks
  77.  
  78.  X-10 and CP290 Home Control Interface are registered trade marks of X-10 (USA) Inc. 
  79.  
  80. Disclaimer
  81.  
  82.  THERE IS NO WARRANTY FOR THIS PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN 
  83.  OTHERWISE STATED IN WRITING DECKER AUTOMATION PROVIDES THE PROGRAM "AS IS" WITHOUT WARRANTY OF 
  84.  ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF 
  85.  MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND 
  86.  PERFORMANCE OF THE PROGRAM LIES WITH THE USER. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR 
  87.  AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR 
  88.  REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, 
  89.  SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMANGES ARISING OUT OF THE USE OF INABILITY TO USE THE 
  90.  PROGRAM (INCLUDING BUT NOT LIMITED TO THE LOSS OF DATA OR DATA BEING RENDERED INACURATE OR LOSSES 
  91.  SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER 
  92.  PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. 
  93.  
  94. ABOUT X-10
  95.  
  96.  The X-10 Home Control System is a popular system for automating the control of lights and appliances in the 
  97.  home. X-10 modules and controllers are sold by a number of companies, under a num,ber of labels. For more 
  98.  information, you may wish to contact X-10, at the following: 
  99.  
  100.  X-10 (USA) Inc.
  101.  185A LeGrande Ave
  102.  Northvale, NJ 07647
  103.  (201) 784-9700
  104.  
  105.  X-10 Home Controls Inc
  106.  1200 Aerowood Drive, Unit 20
  107.  Mississauga, Ontario L4W 2S7
  108.  (416) 624-4446
  109.  
  110.  
  111.  
  112.  Decker Automation is a Factory Floor Automation Software and Networking consulting firm. We have extensive 
  113.  experience with all aspects of the software side of factory-floor automation, from programming simple PLCs 
  114.  through designing complete automation network architectures. Our experience also includes the design of PLCs 
  115.  and PLC-like languages and systems, design and implementation of several different Fieldbuses, and 
  116.  communications device driver creation for various operating systems including DOS, Windows, OS/2, and VMS. Our 
  117.  experience with the WorldFIP fieldbus is particularly extensive. 
  118.  
  119.  In addition, Decker Automation has contributed several programs to the OS/2 community. These include the 
  120.  other World Wide Web Browser for OS/2, <B>Lynx/2</B>, and an Internet retrieval tool, <B>GetURL</B>. We are 
  121.  also working on expanding our REXX-based Home Automation line of products - look for support for a PC to IR 
  122.  Remote control interface, and the new X-10 CM10A Home Controller in the near future! 
  123.  
  124.  Decker Automation may be contacted at: 
  125.  
  126.          Decker Automation
  127.          833 Penny Lane
  128.          Lexington, KY 40509
  129.  
  130.          Tel/Fax:  606/263-8560
  131.          Email:    djd@cris.com
  132.          WWW Page: http://www.cris.com/~djd
  133.  
  134.  
  135.