home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / UTILS2 / X10XA2.ZIP / READ.ME < prev    next >
Text File  |  1994-01-15  |  11KB  |  291 lines
  1.                       Welcome to XA Version 2.1
  2.                       =========================
  3.  
  4. This README file contains important information about XA Version 2.1
  5. that may have been left out from the manuals. For the latest information 
  6. about XA and its accompanying programs and manuals, read this file in 
  7. its entirety. Be sure to read the file XA_201.TXT for complete details
  8. about the operation and features of XA.
  9.  
  10.  
  11.  
  12. Contents:
  13. ======================
  14.   1) Attention New Users - XA's DEMO program.
  15.   2) Attention Registered Users of XA V.2.0
  16.   3) Attention ALL Registered Users
  17.   4) What's New in Version 2.1
  18.   5) Bug Fixes
  19.   6) Additional Information
  20.   7) Distributing the Shareware version of XA
  21.   8) Contacting the Author
  22.  
  23. 1) Attention New Users - XA's DEMO program.
  24. ================================================
  25.  
  26.   A short demonstration program has been added to show new users the
  27.   capabilities of XA. First, copy ALL of the files from the distribution
  28.   floppy (or archive) to the directory where you normally keep your X10
  29.   files. 
  30.  
  31.   Next, type one of the following command at the DOS prompt:
  32.  
  33.       DEMO    (for color monitors)  or,
  34.       DEMO_BW (for monochrome monitors.
  35.  
  36.  
  37. 2) Attention Registered Users of XA V.2.0
  38. ================================================
  39.  
  40.   Normally, all registered users receive the latest version of XA
  41.   according to the terms of the registration agreement. Since the
  42.   release of Version 2.1 (January 94) follows so closely to the release
  43.   of Version 2.0 (Oct-Nov 93), I am not planning on automatically
  44.   sending V 2.1 to those users unless they specifically request it. 
  45.   When more powerful enhancements are added in the future, you will
  46.   receive your registered upgrade.  However, if you would still like 
  47.   V2.1, please contact me via one of the addresses listed below. Please
  48.   remember that this mailing of XA V.2.1 may count towards fulfilling 
  49.   your registration agreement.
  50.  
  51.  
  52. 3) Attention ALL Registered Users:
  53. ================================================
  54.  
  55.   If you have already received the number of upgrades as specified in
  56.   the registration agreement, you may upgrade to the latest version of 
  57.   XA for a very nominal fee.  Please fill out the registration form
  58.   (REGISTER.TXT) and mail it with the specified payment to the address 
  59.   listed below. 
  60.  
  61.  
  62.  
  63. 4) What's New in Version 2.1
  64. ================================================
  65.  
  66.   * Added "polling" mode communications (non-interrupt driven).
  67.     -------------------------------------------------------------
  68.  
  69.     - Polling mode (i=0, IRQ 0) for CP-290 communications was removed
  70.       from V 2.0.  It has been added in V.2.1. of XA.  
  71.     - Also, FINDX10 has been modified to handle polling. 
  72.     - Validated additional checksums in CP-290 messages to ensure 
  73.       communications are correct.
  74.     
  75.   * Modified syntax for the "THRU" token.
  76.     -------------------------------------------------------------
  77.  
  78.     - The syntax for THRU has been modified to allow for an optional
  79.       DATE token. 
  80.   
  81.       Syntax:  DATE 11/25/1993 THRU DATE 1/1/1994
  82.                                     ^^^^
  83.  
  84.     - This allows a more consistent approach to DEFINING special events. 
  85.  
  86.         DEFINE NEW_YEARS DATE 1/1/1994
  87.         DEFINE THANKSGIVING DATE 11/26/1994
  88.         DEFINE CHRISTMAS DATE 12/25/1994
  89.  
  90.         THANKSGIVING THRU NEW_YEARS EXCEPT CHRISTMAS A1 ON SUNSET
  91.  
  92.  
  93.   * Added DEMO files to show new users the capabilities of XA.
  94.     -------------------------------------------------------------
  95.  
  96.     - To run, type DEMO when using a color monitor,
  97.               type DEMO_BW for a monochrome monitor.
  98.  
  99.  
  100.   * Enable VIDEO highlighting
  101.     -------------------------------------------------------------
  102.  
  103.     VIDEO highlighting has been enabled in the shareware version. This
  104.     feature will allow you to tell at a glance whether an event based on
  105.     certain date criteria is downloaded to the CP-290. When using the
  106.     DATE/THRU/EXCEPT tokens, XA will highlight the command using the
  107.     VIDEO4 colors if the event is downloaded to the CP-290. If the event
  108.     does not fall within the programmed range, then the VIDEO2 colors
  109.     will be used. 
  110.  
  111.  
  112. 5) Bug fixes
  113. ================================================
  114.  
  115. The following problems have been reported with XA Ver. 2.00. Most have
  116. been rectified in this release.
  117.  
  118.  
  119.   * ERASE in XA.INI causes XA.EXE to abort.
  120.     -------------------------------------------------------------
  121.  
  122.     Do not put ERASE token in XA.INI. When ERASE is parsed, XA attempts
  123.     to send a command to the CP-290 prior to the proper communication
  124.     channel being opened.  ERASE was not intended to be placed in XA.INI.
  125.     Doing so would force all events in the CP-290 to be cleared whenever
  126.     XA was invoked.
  127.  
  128.     No direct commands, events, or other tokens that may communicate with
  129.     the CP-290 will be sent to the CP-290 while parsing the XA.INI file.
  130.  
  131.  
  132.   * Monitor causes events to be downloaded.
  133.     -------------------------------------------------------------
  134.  
  135.     This occurs when invoking the monitor function by using the "+m"
  136.     command line parameter, and the XA.INI includes the XACMD token.  The
  137.     solution is to invoke monitoring as follows:
  138.  
  139.           XA "monitor",
  140.      not: XA +m
  141.  
  142.     The manual incorrectly stated that you could add the "-e" option to
  143.     prevent parsing of the command file. Beginning with XA 2.00, the "-e"
  144.     option ignores all communication with the CP-290. This allows you to
  145.     verify a command file before storing its data to the CP-290.
  146.  
  147.  
  148.   * F4 ON SUNDAY SUNSET EXCEPT DATE 11/12/1996
  149.        uses EVERYDAY instead of SUNDAY
  150.     -------------------------------------------------------------
  151.  
  152.     Fixed in Version 2.1.
  153.  
  154.  
  155.  
  156.   * Testing a SUNRISE or SUNSET time may not evaluate correctly:
  157.     -------------------------------------------------------------
  158.    
  159.     For example:
  160.       IF (SUNRISE > TIME 5:45 AM)    # Sunrise is 6:55 am
  161.  
  162.     XA was only calculating SUNRISE or SUNSET times when they appeared in
  163.     an EVENT statement (A1 ON MONDAY SUNRISE). If a CONDITIONAL statement
  164.     tested SUNRISE/SET before any events were programmed in the command
  165.     file, the resulting SUNRISE/SET time was midnight (0). If the
  166.     CONDITIONAL statement appeared after an event statement, the
  167.     SUNRISE/SET time would be correct.
  168.  
  169.     Fixed in Version 2.1.
  170.  
  171.  
  172.   * XA.RPT file did not reflect proper modules.
  173.     -------------------------------------------------------------
  174.  
  175.     Using REPORT1, if multiple modules on the same housecode but in
  176.     differents unit ranges (1...8) and (9...16) are programmed for the
  177.     same event, only modules in the first range (1...8) are reported.
  178.     Those modules in the upper range are reported incorrectly as modules
  179.     in the range (1...8).
  180.  
  181.     For example:
  182.       C4 C10 ON EVERYDAY SUNRISE
  183.  
  184.       REPORT1 will show:
  185.           6:15am ON    C4                                      (1)*
  186.           6:15am ON    C4                                      (1)*
  187.  
  188.       instead of:
  189.           6:15am ON    C4                                      (1)*
  190.           6:15am ON    C10                                     (1)*
  191.  
  192.     Fixed in Version 2.1.
  193.  
  194.  
  195.   * Use of the "UNIT ALL" tokens did not program all units for the
  196.     selected housecode. 
  197.     -------------------------------------------------------------
  198.  
  199.     Fixed in Version 2.1.
  200.  
  201.  
  202.   * The following statement would not parse the date range correctly:
  203.     THANKSGIVING THRU NEW_YEARS XMAS_LIGHTS ON SUNSET
  204.     -------------------------------------------------------------
  205.  
  206.     XA did not convert the DEFINE for NEW_YEARS (or any other definition 
  207.     for the "THRU" token) properly.
  208.  
  209.     Fixed in Version 2.1.
  210.  
  211.  
  212. 6) Additional Information
  213. ================================================
  214.  
  215.   * Warning Messages:
  216.     -------------------------------------------------------------
  217.  
  218.     XA will display the following message when it encounters a token it
  219.     doesn't recognize:
  220.  
  221.         ---ERROR--- Invalid expression in statement:
  222.         (...statement displayed here...)
  223.  
  224.     You must edit the file where this warning was encountered. XA always 
  225.     displays the directory and name of the file being parsed.
  226.  
  227.     Note: If this is the SHAREWARE version of XA, see the next section for
  228.     tokens that are NOT supported in this release.
  229.  
  230.  
  231.   * Shareware Version:
  232.     -------------------------------------------------------------
  233.  
  234.     The following tokens are NOT supported in the SHAREWARE version of XA.
  235.       - IF, ELSE, ENDIF
  236.       - INPORT, OUTPORT
  237.       - Arithmetic Operators (+, -, *, /)
  238.       - Logical Operators (AND, &&, &, OR, ||, |)
  239.       - Relational Operators (=, <, >, <=, >=, ==)
  240.  
  241.     As a result, the sample command files (PHONE.CMD, XMAS.CMD, and 
  242.     JOYSTICK.CMD) will report errors when they execute. These files
  243.     are intended to demonstrate various script files you may create 
  244.     with the registered version of XA.
  245.  
  246.     You must register XA with the author to have these tokens enabled.
  247.     Upon registration, you will receive a registered version and printed
  248.     User's Guide. Please fill out the form "REGISTER.TXT".
  249.  
  250.  
  251.   * Using XA with Windows:
  252.     ------------------------------------------------------------- 
  253.     
  254.     The following files have been included to help you run XA within 
  255.     Windows:
  256.  
  257.     - xa_event.pif  - PIF file for downloading contents of XA.CMD to CP-290
  258.     - xa_mon.pif    - PIF file for monitoring events and commands.
  259.     - xa_power.pif  - PIF file for power fail recovery.
  260.  
  261.     Place these files in your Windows subdirectory (normally C:\WINDOWS). 
  262.     These PIF files expect XA to be in the C:\X10 directory. If this is not
  263.     the case, use the Windows PIF editor to modify the settings. See your 
  264.     Windows User's Guide for complete details. Also, see "Appendix D" in
  265.     XA_201.TXT for other important details regarding XA and COM ports.
  266.  
  267.     In some cases, you may notice that some video messages are not displayed
  268.     correctly. Use the Windows PIF editor to change the "Display Usage" from
  269.     "Windowed" to "Full Screen". All messages should be restored properly.
  270.  
  271. 7) Distributing the Shareware version of XA
  272. ================================================
  273.  
  274.   You are encouraged to distribute the SHAREWARE version of XA to your
  275.   friends, BBS's, or online services. Please use the pre-zipped
  276.   SHAREWARE files that are located in the "X10_ZIP" directory of this
  277.   distribution floppy (if applicable). 
  278.  
  279.   Please remember, it is a violation of copyright laws to distribute
  280.   "REGISTERED" versions of XA without permission from the author.
  281.  
  282.  
  283. 8) Contacting the Author
  284. ================================================
  285.  
  286.   ┌────────────────────────────────────────────────────────────────────┐
  287.   │ Bruce Christensen                   CompuServe     :  73201,1531   │
  288.   │ 6594 Hudson Ave.                    Prodigy ID     :  MHNC39A      │
  289.   │ Mentor, OH. 44060-4545              America On-Line:  AuggieBen    │
  290.   └────────────────────────────────────────────────────────────────────┘
  291.