home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: OtherApp / OtherApp.zip / x10test.zip / x10test.hlp (.txt) < prev   
OS/2 Help File  |  1998-08-08  |  103KB  |  474 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Description ΓòÉΓòÉΓòÉ
  3.  
  4. X10 Comm Tester ver. 1.0 - An OS/2 PM testing utility for X10 Powerhouse 
  5. controller model CM11x/CM12x and CP290. This utility is written for HOUSE/2 - 
  6. Home Automation & Security for OS/2 - to help determine communications problems 
  7. between the controllers and computer. X10 Comm Tester is freeware. 
  8.  
  9. HOUSE/2 is an OS/2 version 3.0 and later program to control the home automation 
  10. interface model CM11A made by X10 PowerHouse. 
  11.  
  12. HOUSE/2 is shareware and registration is available through BMT Micro at 
  13. www.bmtmicro.com or through the author directly. Registration now includes the 
  14. game Leave-One, a puzzle similar to Pegged. See the section How To Register 
  15. HOUSE/2 for details. 
  16.  
  17. For more information on home control devices, see Internet Links for Home 
  18. Automation in this Help file. 
  19.  
  20.  
  21. ΓòÉΓòÉΓòÉ 2. Controller Pictures ΓòÉΓòÉΓòÉ
  22.  
  23. X10 Comm Tester works for the controllers shown below. 
  24.  
  25. Figure 1. The CM11A Home Control Interface 
  26.  
  27. Figure 2. The CM11F Home Control Interface 
  28.  
  29. Figure 3. The CM11G Home Control Interface 
  30.  
  31. Figure 4. The CM12U Home Control Interface 
  32.  
  33. Figure 5. The CP290 Home Control Interface 
  34.  
  35.  
  36. ΓòÉΓòÉΓòÉ 3. Internet Links for Home Automation ΓòÉΓòÉΓòÉ
  37.  
  38. To get more information on home automation, you can visit any of the sites 
  39. listed here: 
  40.  
  41. www.x10.com
  42. Homepage of X10 POWERHOUSE.
  43. This is the manufacturer of X10 products.
  44.  
  45. www.x10.com/x10euro.htm
  46. Links to European Representatives of X10 POWERHOUSE.
  47.  
  48. www.smarthome.com
  49. Home Automation System, Inc. Vendor carrying large
  50. selection of home automation devices. Download
  51. catalog in PDF format, search for part numbers online.
  52.  
  53. www.hwg-telekom.de
  54. HWG Telekommunikations Systeme GmbH.
  55. X10 Representative of Germany, Austria and
  56. Switzerland. The CM11A is available as
  57. PowerHaus-II in these countries.
  58.  
  59. www.automationplus.com
  60. Mail order company for home automation devices.
  61.  
  62. www.asihome.com
  63. Mail order company for home automation devices.
  64.  
  65. support.tandy.com/support_security/
  66. Radio Shack Support. Follow the X10 links.
  67. Contains FAQ for home automation devices.
  68.  
  69. www.hometoys.com
  70. Mailing lists, newsletters, articles and product reviews
  71. of home automation products and services.
  72.  
  73. www.homecontrols.com
  74. Large product catalog for home automation devices.
  75. Also carries 220/230V models for international markets.
  76.  
  77. www.hometeam.com
  78. Information about products and services for home automation.
  79.  
  80. www.infinet.com/~dhoehnen/ha/list.html
  81. Index of home automation related sites.
  82.  
  83. www.io.com/~lbs/
  84. Laser Business Systems Ltd. Home Automation dealer in
  85. the United Kingdom. Lists controllers and modules for many
  86. other European countries.
  87.  
  88.  
  89. ΓòÉΓòÉΓòÉ 4. Menu Description ΓòÉΓòÉΓòÉ
  90.  
  91. Describes all menu items available for this program. 
  92.  
  93.  
  94. ΓòÉΓòÉΓòÉ 4.1. FILE - Save As ΓòÉΓòÉΓòÉ
  95.  
  96. Saves the currently displayed data to a text file of your choice. This will 
  97. record the troubleshooting session and help in documenting the problem. 
  98.  
  99.  
  100. ΓòÉΓòÉΓòÉ 4.2. FILE - Exit ΓòÉΓòÉΓòÉ
  101.  
  102. Exit the program. If the program is still connected to the interface, the 
  103. connection is terminated. 
  104.  
  105.  
  106. ΓòÉΓòÉΓòÉ 4.3. HELP - General Help ΓòÉΓòÉΓòÉ
  107.  
  108. Displays this help file (X10TEST.HLP). 
  109.  
  110.  
  111. ΓòÉΓòÉΓòÉ 4.4. HELP - About ΓòÉΓòÉΓòÉ
  112.  
  113. Product information. 
  114.  
  115.  
  116. ΓòÉΓòÉΓòÉ 5. Program Features ΓòÉΓòÉΓòÉ
  117.  
  118. This section explains the various program buttons and controls. 
  119.  
  120. Com Port Selection: 
  121.  
  122. This spin button allows to select the com port where the controller is 
  123. connected to. The range is COM1 through COM8. The default is COM2. Com port 
  124. setting is not saved when the program is terminated. Baud rate and other 
  125. parameters are fixed and are automatically set when the controller type is 
  126. selected. 
  127.  
  128. Note: Com port can only be changed when the program is offline. 
  129.  
  130. CM11x/CM12x or CP290 (Send To) or CP290 (Receive): 
  131.  
  132. This button toggles between the CM11x/CM12x and CP290 controller tests. The 
  133. CM11x/CM12x test consists of requesting the time. The received information is 
  134. then shown on the screen. The CP290 (Send To) test first executes the CP290 
  135. built-in diagnostics, then attempts to read and display the time. The CP290 
  136. (Receive) test allows to check the operation of the rocker switches on the 
  137. CP290 by reading the response as soon as a switch is activated. 
  138.  
  139. The program must be offline to change controller tests. 
  140.  
  141. Connect - Disconnect: 
  142.  
  143. This button toggles between online and offline. If the button displays Connect, 
  144. then the program is offline and the com port is closed. If it displays 
  145. Disconnect, then the program is online and the com port is open. The 
  146. offline/online status is also shown in the text window below the buttons. 
  147.  
  148. Test: 
  149.  
  150. This button sends out a request to the controllers to check if they are 
  151. present. The request and the reply are printed on the screen in hex format. If 
  152. the reply is the expected format, then Test passed will be printed. For sample 
  153. sessions see the sections on Troubleshooting the CP290 or Troubleshooting the 
  154. CM11A 
  155.  
  156. Test sends out a request to read time for the controller selected. All data is 
  157. displayed in raw hex format in the large text window as it is sent and 
  158. received. Next to the raw hex data there will be comments enclosed in brackets 
  159. explaining what the data means, i.e.  ===>C3  (Request Status) 
  160.  
  161. Clear: 
  162.  
  163. Clears the text window. 
  164.  
  165. Exit: 
  166.  
  167. Exit the program. If the program is still connected to the interface, the 
  168. connection is terminated. 
  169.  
  170.  
  171. ΓòÉΓòÉΓòÉ 6. Troubleshooting the CP290 ΓòÉΓòÉΓòÉ
  172.  
  173. Sample X10 Comm Test Session for the CP290 (Send To) Test 
  174.  
  175.  
  176.   COM2: CP290
  177.   ===>FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF07  (Diagnostics)
  178.   waiting 10 seconds...
  179.   <===00FFFFFFFFFFFF00
  180.   Diagnostics passed.
  181.  
  182.   ===>FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF04  (Request Clock & Base)
  183.   <===FFFFFFFFFFFF00181401608D
  184.   Test passed. CP290 contains no data.
  185.   Time: 20:24  Weekday: Mon  House Code: A  -Check sum passed-
  186.  
  187.  
  188. Note: The arrows above have the following meaning:
  189.  
  190.   ===> Data sent to controller
  191.   <=== Data received from controller
  192.  
  193. Sample X10 Comm Test Session for the CP290 (Receive) Test 
  194.  
  195.  
  196.   COM2: CP290
  197.   Waiting to receive data from CP290...
  198.   Press a key on CP290 to receive data. Timeout in 10 seconds...
  199.   <===FFFFFFFFFFFF0063000860CB
  200.   CP290 contains no data.
  201.   Event: A5 OFF  Base Housecode: A  -Check sum passed-
  202.  
  203. CP290 Interface Connection Problems. 
  204.  
  205. If you are having problems connecting to the CP290 interface then follow these 
  206. steps below. 
  207.  
  208.       Γûá  Make sure the com port setting in the configuration matches the com 
  209.       port you use for the interface. 
  210.  
  211.       Γûá  With X10 Comm Tester online, press Test several times. 
  212.  
  213.       Γûá  If you have Ray Gwinn's SIO comm drivers, use the included PMLM (Poor 
  214.       Man's Line Monitor) to monitor data exchange between the computer and 
  215.       CP290. PMLM will also display the baudrate the port is set to. If it is 
  216.       not 600 then SIO may be locking the port to another baudrate. See below. 
  217.  
  218.       Γûá  If you are using Ray Gwinn's SIO com drivers, check if the baud rate 
  219.       is locked for the particular com port you are using with the interface. 
  220.       Unlock it so X10 Comm Tester can change the baud rate to 600. From the 
  221.       SIO reference, it states: 
  222.  
  223.  
  224.                Locked Baud Rate
  225.  
  226.                Placing a colon and a baud rate following the communications port, eg
  227.                (COM1:38400,3F8,IRQ4), causes the port to be locked at that baud rate.
  228.                No program, OS2 or DOS, is allowed to change the baud rate.
  229.  
  230.       Γûá  Try the standard COM1 or COM2 ports if you have problems with any 
  231.       other com ports like COM3 - COM8. Also, remove any serial cable 
  232.       extensions or adapters and connect the interface directly to the 
  233.       computer. See the section RS-232 Cable Connection for CP290 for connector 
  234.       pin-outs. 
  235.  
  236.       Γûá  Try using a different computer or different com port to access the 
  237.       CP290. 
  238.  
  239.       Γûá  E-mail me and I will try to help you out. 
  240.  
  241.  
  242. ΓòÉΓòÉΓòÉ 7. RS-232 Cable Connection for CP290 ΓòÉΓòÉΓòÉ
  243.  
  244. Below is a connection diagram to connect the CP290 to a 25 or 9 pin serial 
  245. port. 
  246.  
  247.  
  248. ΓòÉΓòÉΓòÉ 8. Troubleshooting the CM11x/CM12x ΓòÉΓòÉΓòÉ
  249.  
  250. Sample X10 Comm Test Session for the CM11x/CM12x 
  251.  
  252.  
  253.   COM2: CM11x
  254.   --->8B  (Get Time)
  255.   <---
  256.   No response.
  257.   <---5A  (Poll Signal)
  258.   --->C3  (Request Status)
  259.   <---0302E6E3  (Interface Data)
  260.   --->8B  (Get Time)
  261.   <---960011100B632067004000000000
  262.   Test passed.
  263.   COM2: CM11x
  264.   <---A5  (Power Fail Poll)
  265.   <---A5  (Power Fail Poll)
  266.   <---A5  (Power Fail Poll)
  267.   <---A5  (Power Fail Poll)
  268.   <---A5  (Power Fail Poll)
  269.   --->8B  (Get Time)
  270.   <---
  271.   No response.
  272.  
  273.  
  274. Note: The arrows above have the following meaning:
  275.  
  276.   ---> Data sent to controller
  277.   <--- Data received from controller
  278.  
  279. Note: If the display shows  <---A5  (Power Fail Poll), then use HOUSE/2 to 
  280. connect to the CM11x and clear the poll signal. To clear this poll signal, the 
  281. interface is waiting for a clock set which X10 Comm Tester is not designed to 
  282. do. X10 Comm Tester shows that the interface is talking to your computer and 
  283. has achieved it's purpose. 
  284.  
  285. CM11A Interface Connection Problems. 
  286.  
  287. If you are having problems connecting to the CM11A interface giving you Connect 
  288. Error messages, then follow these steps below. 
  289.  
  290.       Γûá  Make sure the com port setting in the configuration matches the com 
  291.       port you use for the interface. 
  292.  
  293.       Γûá  Make sure you have all the included files present in your directory. 
  294.  
  295.       Γûá  It appears that newly installed interfaces sometimes won't talk to 
  296.       computers. If this is the case, then try kick-starting the interface with 
  297.       an other X10 Controller (like a Mini Controller) if you have one 
  298.       available. 
  299.  
  300.       Γûá  With X10 Comm Tester online, press Test several times. 
  301.  
  302.       Γûá  If you have Ray Gwinn's SIO comm drivers, use the included PMLM (Poor 
  303.       Man's Line Monitor) to monitor data exchange between the computer and 
  304.       CM11A. X10 Comm Tester will send out ╨¢ (character 139) when pressing 
  305.       Test. The interface should respond with 14 bytes of data. Also, if you 
  306.       send an X10 event like A1 ON using a mini controller or Power Flash 
  307.       module, the CM11A will send the letter Z to the computer in one second 
  308.       intervals until the computer retrieves the data. You can observe these 
  309.       events with PMLM and they may help in troubleshooting. PMLM will also 
  310.       display the baudrate the port is set to. If it is not 4800 then SIO may 
  311.       be locking the port to another baudrate. See below. 
  312.  
  313.       Γûá  If you are using Ray Gwinn's SIO com drivers, check if the baud rate 
  314.       is locked for the particular com port you are using with the interface. 
  315.       Unlock it so X10 Comm Tester can change the baud rate to 4800. From the 
  316.       SIO reference, it states: 
  317.  
  318.  
  319.                Locked Baud Rate
  320.  
  321.                Placing a colon and a baud rate following the communications port, eg
  322.                (COM1:38400,3F8,IRQ4), causes the port to be locked at that baud rate.
  323.                No program, OS2 or DOS, is allowed to change the baud rate.
  324.  
  325.       Γûá  Try the standard COM1 or COM2 ports if you have problems with any 
  326.       other com ports like COM3 - COM8. Also, remove any serial cable 
  327.       extensions or adapters and connect the interface directly to the 
  328.       computer. See the section RS-232 Cable Connection for CM11x/CM12x for 
  329.       connector pin-outs. 
  330.  
  331.       Γûá  Try ActiveHome or HomeDirector to see if these programs will talk to 
  332.       the interface. Do not run these programs in a Win-OS2 session initially, 
  333.       this just adds to the complexity of troubleshooting. If you can talk to 
  334.       the interface with ActiveHome or HomeDirector, then X10 Comm Tester 
  335.       should work also, provided the baud rate is not locked or the serial port 
  336.       is not used by another application. 
  337.  
  338.       Γûá  Try using a different computer or different com port to access the 
  339.       CM11A. 
  340.  
  341.       Γûá  If the CM11A will absolutely not talk to the computer, as a last 
  342.       resort, unplug it, remove the batteries and let it sit for an hour or so 
  343.       to completely reset it. Then follow the CM11A installation instruction 
  344.       precisely and try it again. 
  345.  
  346.       Γûá  E-mail me and I will try to help you out. 
  347.  
  348.  
  349. ΓòÉΓòÉΓòÉ 9. RS-232 Cable Connection for CM11x/CM12x ΓòÉΓòÉΓòÉ
  350.  
  351. Below is a connection diagram to connect the CM11x/CM12x to a 25 or 9 pin 
  352. serial port. 
  353.  
  354.  
  355. ΓòÉΓòÉΓòÉ 10. Installation ΓòÉΓòÉΓòÉ
  356.  
  357. Note:  REXX or Object REXX must be installed on your system for this program to 
  358. work. REXX is installed by default, but if you did not install it then run Warp 
  359. installation again and selectively install REXX support. 
  360.  
  361. Unzip all files into a separate directory, I suggest the name HOUSE2. If you 
  362. have the HOUSE/2 program, copy all files into that HOUSE/2 directory. 
  363.  
  364. Open an OS/2 Window and change to the directory you just created. Type INSTALL 
  365. and the script will create a HOUSE2 folder on the desktop and fill it with all 
  366. executable programs present in the directory. To start the program, 
  367. double-click on the X10 Comm Tester object inside the HOUSE2 Folder. 
  368.  
  369. If you do not want to run the INSTALL, then you can also start X10 Comm Tester 
  370. by opening an OS/2 Window command prompt, change the active directory to the 
  371. directory where X10TEST.EXE resides and type X10TEST and press enter. 
  372.  
  373. Installing this program on your system does not change any of the INI or 
  374. CONFIG.SYS files. 
  375.  
  376. The following files belong to this program. Note that VPOBJ.DLL and RXASYNC.DLL 
  377. are also used by HOUSE/2 but are included for completeness here: 
  378.  
  379.        X10TEST.EXE       The executable main program. 
  380.  
  381.        X10TEST.HLP       The main help file. 
  382.  
  383.        VPOBJ.DLL         Dynamic Link Library required by executable. Only 
  384.                          required if you do not also use HOUSE/2. 
  385.  
  386.        RXASYNC.DLL       Dynamic Link Library required for serial 
  387.                          communications to the CM11A and CP290 interface. Only 
  388.                          required if you do not also use HOUSE/2. This library 
  389.                          of serial communications routines is included by 
  390.                          permission of Crucial Applications (Author: Ian Timms, 
  391.                          e-mail: itimms@ariel.ucs.unimelb.edu.au). The entire 
  392.                          serial communications package, including the source 
  393.                          code for RXASYNC, is available at my home page or 
  394.                          other major OS/2 sites by the filename RXASYN20.ZIP 
  395.  
  396.        INSTALL.CMD       General installation script for X10 Comm Tester and 
  397.                          HOUSE/2. 
  398.  
  399.        READ.ME           Program description and installation instructions. 
  400.  
  401.        BMTORDER.TXT      Order form to register HOUSE/2 through BMT Micro. 
  402.  
  403.  To remove this program from your system, close the program, delete all your 
  404.  X10TEST object or shadow from your desktop or folders and delete all the files 
  405.  (if you have HOUSE/2, delete only the non common files) listed above. 
  406.  
  407.  
  408. ΓòÉΓòÉΓòÉ 11. The Legal Stuff ΓòÉΓòÉΓòÉ
  409.  
  410. This program is free. It may be distributed electronically at no fee or a 
  411. minimum fee to cover media and distribution costs as long as all files are kept 
  412. together. 
  413.  
  414. RXASYNC.DLL, required for serial communications to the CM11x and CP290 
  415. interface, is a library of serial communications routines and is included by 
  416. permission of Crucial Applications (Author: Ian Timms, e-mail: 
  417. itimms@ariel.ucs.unimelb.edu.au). The entire serial communications package, 
  418. including the source code for RXASYNC, is available at my home page or other 
  419. major OS/2 sites by the filename RXASYN20.ZIP 
  420.  
  421. DISCLAIMER 
  422.  
  423. The author of HOUSE/2 is in no way responsible for any damage this program may 
  424. cause to computer equipment by running this software on it. 
  425.  
  426. Any trademarks mentioned in this document belong to their respective owners and 
  427. the author of this program is not connected in any way to these products nor 
  428. does he endorse any of the products mentioned. 
  429.  
  430.  
  431. ΓòÉΓòÉΓòÉ 12. How to Register HOUSE/2 ΓòÉΓòÉΓòÉ
  432.  
  433. HOUSE/2 registration now includes the game Leave-One. It's a challenging puzzle 
  434. similar to Pegged. See my website for a screen shot of this game. 
  435.  
  436. There are two ways you can register HOUSE/2: 
  437.  
  438. Send e-mail to ASchw@worldnet.att.net to request my mailing address. You can 
  439. then send me a check or money order and I will return instructions on how to 
  440. receive the registered version. The cost is $30.00 using this option. 
  441.  
  442. Register through BMT Micro at www.bmtmicro.com. BMT Micro offers a variety of 
  443. purchasing methods, see the file BMTORDER.TXT for details. After registration, 
  444. instructions will be given to you within usually one day on how to receive the 
  445. registered version. The cost is $35.00 for this option. 
  446.  
  447. Quantity discounts are available. Please e-mail me for details. 
  448.  
  449.  
  450. ΓòÉΓòÉΓòÉ 13. Support ΓòÉΓòÉΓòÉ
  451.  
  452. For support for this program, you can contact me directly via e-mail. 
  453.  
  454. My e-mail address: 
  455.  
  456.   ASchw@worldnet.att.net 
  457.  
  458. Visit my home page, "The Warped Code Cellar" at 
  459.  
  460.   http://home.att.net/~ASchw 
  461.  
  462. for other information and applications for OS/2 like HOUSE/2, Memory Game and 
  463. Leave One, two speech navigation enabled games. 
  464.  
  465. Monitor my home page regularly for new and upgraded OS/2 programs. This will be 
  466. the place where all programs will be available first. 
  467.  
  468. This program and HOUSE/2 is also available at the following sites: 
  469.  
  470. Internet: 
  471.  
  472.   http://home.att.net/~ASchw 
  473.   http://www.bmtmicro.com 
  474.   http://hobbes.nmsu.edu