home *** CD-ROM | disk | FTP | other *** search
/ The Pier Shareware 6 / The_Pier_Shareware_Number_6_(The_Pier_Exchange)_(1995).iso / 010 / irdc200.zip / IRDC.DOC < prev    next >
Text File  |  1994-12-03  |  41KB  |  910 lines

  1. --------------------------------------------------------------------
  2. IRDC - INFRA-RED Direct Control
  3. --------------------------------------------------------------------
  4. Version 2.00
  5. November 1994
  6.  
  7. Copyright 1993,1994 - D.Huras - All Rights Reserved
  8.  
  9. ------------------------------------------------IRDC.DOC v2.00------
  10. CONTENTS
  11. --------------------------------------------------------------------
  12.  1. DESCRIPTION
  13.  2. WARRANTY
  14.  3. FEATURE OVERVIEW
  15.  4. REQUIREMENTS
  16.  5. ONE FOR ALL REMOTES
  17.  6. SETUP INFORMATION
  18.  7. INSTALLATION INSTRUCTIONS
  19.  8. COMMAND LINE ARGUMENTS
  20.  9. COMMUNICATION PORTS
  21. 10. PROGRAM OVERVIEW
  22. 11. KEYBOARD USAGE
  23. 12. APPLICATIONS
  24. 13. PROBLEM RESOLUTION
  25. 14. REGISTRATION INFORMATION
  26. 15. UPGRADE INFORMATION
  27. 16. RELEASE HISTORY
  28.  
  29. 1. DESCRIPTION
  30. --------------------------------------------------------------------
  31. IRDC is a program that sends commands to a ONE FOR ALL (*1) Remote
  32. Control that instruct the remote control to emit INFRA RED (I/R)
  33. signals.  Essentially, IRDC emulates a person pressing buttons on
  34. the remote control keypad.  Any button sequence that can be
  35. physically entered on the remote control keypad can be emulated with
  36. the IRDC program including setting the Device type. The range for
  37. the I/R signals can easily be extended through the use of the X-10
  38. Powermid product.
  39.  
  40. IRDC will only operate with ONE FOR ALL* remote controls that have
  41. an external port; the ONE FOR ALL 5*, ONE FOR ALL 6*, ONE FOR ALL 8*
  42. and ONE FOR ALL 12* are the models with an external port that are
  43. currently supported.  (See the ONE FOR ALL REMOTES section for
  44. further information).  A special serial cable with a 3-pin male
  45. connector at one end (that plugs into the ONE FOR ALL external port)
  46. and an RS232 9-pin female connector on the other end (that plugs
  47. into a PC serial port) is used to allow the software to communicate
  48. with the remote control.  (This cable can be ordered from many Home
  49. Automation Dealers --- see the CABLE.DOC file) The external port is
  50. located under the battery cover and its primary purpose is for
  51. upgrading the remote control (ie. loading new I/R signals into the
  52. remote control).  The ONE FOR ALL remote controls cannot "learn" new
  53. I/R signals; however, they can be "force fed" new I/R signals
  54. through the external port.  This may be necessary if you acquire new
  55. electronic equipment with I/R signals that are not defined within
  56. your ONE FOR ALL remote control.
  57.  
  58. Unless your electronic equipment is located near your PC and you can
  59. "aim" the ONE FOR ALL remote control appropriately, then the
  60. benefits of IRDC may not be readily apparent.  To get the most out
  61. of IRDC, you really need an I/R extender such as the X-10 Powermid
  62. product.  This enables you to locate your PC and remote control
  63. anywhere in your home or apartment and distribute I/R signals to
  64. other locations.  See the 'APPLICATIONS' section of this document
  65. for further information.
  66.  
  67. IRDC is a DOS program that uses a simple point & click user
  68. interface.  (A Mouse though not required is highly recommended).
  69. IRDC is designed to be robust software that is processor speed
  70. independent.  This program is shareware and you are invited to
  71. evaluate it for 30 days. If you continue to use the program after
  72. the 30 day evaluation period you are asked to register it.  The
  73. author retains all rights to the program.
  74.  
  75. ----
  76. (*1) ONE FOR ALL, ONE FOR ALL 5, ONE FOR ALL 6, ONE FOR ALL 8,
  77.      ONE FOR ALL 12 and The "Universal" Remote are trademarks of
  78.      Universal Electronics Inc.
  79.  
  80. 2. WARRANTY
  81. --------------------------------------------------------------------
  82. IRDC is supplied AS IS.  The author disclaims all warranties,
  83. expressed or implied, including, without limitation, the warranties
  84. of merchantability and of fitness for any purpose.  The author
  85. assumes no liability for damages, direct or consequential, which may
  86. result from the use of IRDC.
  87.  
  88. 3. FEATURE OVERVIEW
  89. --------------------------------------------------------------------
  90. - User-Friendly full screen point & click DOS character-based
  91.   Interface; your PC screen becomes a large remote keypad.
  92.  
  93. - All program functions can be controlled using a mouse; no keyboard
  94.   intervention is required.
  95.  
  96. - Supports Standard CommPorts 1 thru 4 and a User Defined CommPort
  97.   which can support any IRQ between 1 & 15 (inclusive) and any
  98.   Base I/O Address.
  99.  
  100. - Optional comprehensive on-line Help sub-system.
  101.  
  102. - All program parameters can be stored within an INI file thereby
  103.   obviating the need for any command line arguments.
  104.  
  105. - Extended Remote Codes can also be defined within the INI file
  106.   and presented in a List Box along with your description.  (Eg. TV
  107.   10  Surround ON).  You can simply double click on the list box
  108.   entry instead of trying to remember the extended code and then
  109.   clicking TV,A,1,0.  The entries in the list box are unsorted and
  110.   added in the same order as they are encountered within the INI
  111.   file.  This allows you to arrange the list in the order that you
  112.   prefer.
  113.  
  114. - The program WILL load without a ONE FOR ALL remote control
  115.   connected.  It will still attempt to use the serial CommPort; in
  116.   most cases (eg. if you have a modem attached to the serial port)
  117.   the results will be innocuous.  However, be aware that any device
  118.   connected to the CommPort configured for use with IRDC will
  119.   receive serial transmissions.
  120.  
  121. 4. REQUIREMENTS
  122. --------------------------------------------------------------------
  123. - An IBM-Compatible PC with at least 1 serial port.
  124.  
  125. - A ONE FOR ALL 5, 6, 8 or 12 remote control.  See the 'ONE FOR ALL
  126.   REMOTES' section for further information on the supported models.
  127.  
  128. - A Special Serial Cable to connect the ONE FOR ALL remote to a PC
  129.   Serial Port.  (This cable can be ordered from many Home Automation
  130.   Dealers; see CABLE.DOC file).
  131.  
  132. - A Colour adapter/display is recommended although the program
  133.   should run with a monochrome display/adapter.  If you
  134.   experience problems with the default colors, then try the /BW
  135.   command line argument which will set everything to Black &
  136.   White.
  137.  
  138. The program requires approximately 360K available conventional memory
  139. to run.  The memory requirements will increase as you add Extended
  140. Remote Code definitions to the IRDC.INI file.  (eg. 100 definitions
  141. will require an additional 6.5K of memory --- approximately).
  142.  
  143. 5. ONE FOR ALL REMOTES
  144. --------------------------------------------------------------------
  145. IRDC supports 6 different ONE FOR ALL Remote Control Models.  The
  146. Model Number is usually printed on the front of the remote or on the
  147. battery cover. Be sure that you have correctly identified the model
  148. of your remote before using the program.  You can identify your
  149. model to IRDC by using the /Mn(n) argument as indicated in the
  150. rightmost column below; you can also dynamically select the model by
  151. using the Configuration Panel.
  152.  
  153. Model No.   Model Name    Description                       IRDC (/M)
  154. --------  --------------  --------------------------------  ---------
  155. URC-2005  ONE FOR ALL 5   Ergonomic Design (paddle shaped)   5
  156. URC-4000  ONE FOR ALL 6   Conventional Design (rectangular)  6
  157. URC-4050  ONE FOR ALL 6   Conventional Design (rectangular)  6A
  158. URC-4005  ONE FOR ALL 6   Ergonomic Design (paddle shaped)   6B
  159. URC-5000  ONE FOR ALL 12  Conventional Design (rectangular)  12
  160. URC-6050  ONE FOR ALL 8   Ergonomic Design (paddle shaped)   8
  161.  
  162. 6. SETUP INFORMATION
  163. --------------------------------------------------------------------
  164. Setup Instructions differ based on the model of the ONE FOR ALL
  165. remote that you are using.  It is very important that you
  166. correctly identify the model before using the program.  Refer to the
  167. ONE FOR ALL REMOTES section to identify your remote and then follow
  168. the appropriate Setup Instructions below.
  169.  
  170. SETUP INSTRUCTIONS FOR:
  171. -----------------------
  172.   ONE FOR ALL 6  [URC4000]
  173.   ONE FOR ALL 12 [URC5000]
  174.  
  175. 1) Plug the Special Serial Cable into the PC Serial Port.
  176. 2) Plug the Special Serial Cable into the ONE FOR ALL Remote Control.
  177. 3) Ensure that there are no loose connections.
  178. 4) Load the IRDC program.
  179. 5) VERY IMPORTANT: DO NOT TOUCH ANY BUTTONS on the remote control when
  180.    when using the software.
  181. NOTES:
  182. ------
  183. ∙ The author assumes no liability for damages, direct or
  184.   consequential, which may result from the use of IRDC.
  185. ∙ If you physically press buttons on the keypad while the software
  186.   is communicating with the remote control strange things can happen
  187.   that could affect the operability of your remote control.  If the
  188.   memory contents of your remote control are altered then the only way
  189.   to restore it to normal operation is to have it reloaded by
  190.   Universal Electronics or a local Service Dealer.
  191. --------------------------------------------------------------------
  192.  
  193. SETUP INSTRUCTIONS FOR:
  194. -----------------------
  195.   ONE FOR ALL 5  [URC2005]
  196.   ONE FOR ALL 6A [URC4005]
  197.   ONE FOR ALL 6B [URC4040]
  198.   ONE FOR ALL 8  [URC6050]
  199.  
  200. 1) Plug the Special Serial Cable into the PC Serial Port.
  201. 2) Plug the Special Serial Cable into the ONE FOR ALL Remote Control.
  202. 3) Ensure that there are no loose connections.
  203. 4) Load the IRDC program.
  204. 5) VERY IMPORTANT: You must physically press a button on the remote
  205.    control and then click on one of the on-screen buttons WITHIN 5
  206.    SECONDS to put the remote online. Once the remote is online it will
  207.    remain online (and will not respond to physical key presses) until
  208.    you explicitly take it offline by clicking on the 'Take Remote
  209.    Offline' button. When you click on the 'Take Remote Offline' button
  210.    the LED on the remote will flash twice in acknowledgement of the
  211.    request.
  212. NOTE:
  213. -----
  214. ∙ The author assumes no liability for damages, direct or
  215.   consequential, which may result from the use of IRDC.
  216.  
  217. 7. INSTALLATION INSTRUCTIONS
  218. --------------------------------------------------------------------
  219. There are no special installation instructions; simply copy the
  220. program to a sub-directory of your choice and run it.  The program
  221. will look for 2 files in the directory it is run from.  However,
  222. the program will run with or without the following 2 files:
  223.  
  224.   1) IRDC.HLP
  225.      IRDC retrieves the on-line help text from this file. If the
  226.      file is not found then IRDC will disable the 'Help' command
  227.      button and the Help feature will be unavailable.  The program
  228.      will load slightly faster when the help sub-system is not
  229.      loaded; if you decide that you no longer require the online
  230.      help you can simply delete or rename the IRDC.HLP file.
  231.  
  232.   2) IRDC.INI
  233.      IRDC will look for an IRDC.INI file in the current
  234.      directory.  All program parameters can be defined within
  235.      this file as well as Extended Remote Code definitions.  Any
  236.      errors found within the IRDC.INI file will be reported and
  237.      the program will be terminated.  IRDC will generate an
  238.      IRDC.INI file (or overwrite an existing IRDC.INI file) when
  239.      the 'Save' button on the Configuration panel is clicked.
  240.      Note that Command Line Args will ALWAYS OVERRIDE
  241.      conflicting parameters within the IRDC.INI file.  A sample
  242.      IRDC.INI file, generated by IRDC, is shown below:
  243.  
  244. ;
  245. ;IRDC.INI File Created: 10-02-1993 07:37:33
  246. ;
  247. ; All Lines prefixed with ; are ignored
  248. ; Program Options
  249. ; ---------------
  250. ; CommPort=1,2,3 OR 4                DEFAULT=1
  251. ; Model=5,6,6A,6B,8 or 12            DEFAULT=6
  252. ; BW=YES or NO                       DEFAULT=NO (Colour)
  253. ; DisplaySetupInformation=YES or NO  DEFAULT=YES
  254. ;
  255. Model=6
  256. BW=NO
  257. DisplaySetupInformation=YES
  258. ;
  259. ; User Defined CommPort
  260. ; ---------------------
  261. ; IRQ and Base_IO_Address apply to User Defined CommPort ONLY
  262. ;
  263. ; IRQ=1-15                 DEFAULT=4; IF Base_IO_Address is set
  264. ; Base_IO_Address=nnnn(n)  DEFAULT=1016; IF IRQ is set
  265. ;
  266. IRQ=4
  267. Base_IO_Address=1016
  268. ;
  269. ; Extended Remote Codes
  270. ; ---------------------
  271. ;
  272. ; The codes applicable to your I/R devices can be found in your
  273. ; your ONE FOR ALL manual.
  274. ;
  275. CODE=TV,10,DISPLAY
  276. CODE=TV,11,MTS
  277. CODE=TV,12,PICTURE +
  278. CODE=TV,13,PICTURE -
  279. CODE=TV,14,SLEEP
  280. CODE=TV,15,TV/VIDEO
  281. CODE=TV,15,ANTENNA/AUX
  282. CODE=TV,18,COLOUR UP
  283. CODE=TV,19,COLOUR DOWN
  284. CODE=TV,20,BRIGHT UP
  285. CODE=TV,21,BRIGHT DOWN
  286. CODE=TV,22,HUE UP
  287. CODE=TV,23,HUE DOWN
  288. CODE=TV,24,MATRIX/SURROUND
  289. CODE=VCR,10,SLOW SRCH UP
  290. CODE=VCR,11,SLOW SRCH DN
  291. CODE=VCR,12,MENU
  292. CODE=VCR,13,SELECT
  293. CODE=VCR,14,ON SCREEN
  294. CODE=VCR,15,CANCEL/SKIP
  295. CODE=VCR,16,TIMER
  296. ;
  297. ; End of IRDC.INI (07:37:33)
  298.  
  299. 8. COMMAND LINE ARGUMENTS
  300. --------------------------------------------------------------------
  301. DEFAULTS:  If the program is run without any command line arguments
  302.            it will default to COMMPORT 1,MODEL 6,COLOUR DISPLAY &
  303.            WARNING=YES.  Note that CommPort, Model & Display can
  304.            be toggled from within the program.
  305.  
  306. The following command line arguments can be entered in any order:
  307.  
  308. /Annnn(n) - Base I/O Address applicable to User Defined CommPort
  309.             (Must be specified as a decimal number)
  310.             If /I argument is present, but /A is not; then Base
  311.             I/O Address will default to 1016 (3F8 Hex).
  312.  
  313. /BW  - Use Black & White colours
  314. /BW- - Use Colour (You would only use this argument to override
  315.        an INI BW=YES)
  316.  
  317. /Cn  - COMMPORT where n = 1,2,3 or 4
  318.  
  319. /In  - IRQ applicable to User Defined CommPort where n = 1 - 15
  320.        If /A argument is present, but /I is not; then IRQ
  321.        will default to 4.
  322.  
  323. /Mn  - MODEL where n = 5, 6, 6A, 6B, 8, or 12
  324.  
  325. /NW  - Suppress the automatic display of SETUP INFORMATION upon program
  326.        load. (This command line argument is not required if you have
  327.        elected to forego the online help by renaming or deleting
  328.        IRDC.HLP).
  329. /NW- - Display Setup Information (You would only use this argument to
  330.        override an INI WARNING=NO)
  331.  
  332. /?   - Display Command Line Arguments
  333.  
  334. NOTE: - COMMAND LINE OPTIONS OVERRIDE IRDC.INI SETTINGS
  335.       - MULTIPLE OCCURRENCES OF THE SAME COMMAND LINE ARGUMENT
  336.         ARE ACCEPTED; THE LAST INSTANCE WILL BE USED BY IRDC.
  337.  
  338. 9. COMMUNICATION PORTS
  339. --------------------------------------------------------------------
  340. IRDC supports "pseudo standard" CommPorts 1 thru 4 using the
  341. following settings:
  342.  
  343.             +----------+------+------------------+
  344.             |          |      | Base I/O Address |
  345.             | CommPort | IRQ  +---------+--------+
  346.             |          |      | Decimal |  HEX.  |
  347.             +----------+------+---------+--------+
  348.             |    1     |   4  |  1016   |  3F8   |
  349.             +----------+------+---------+--------+
  350.             |    2     |   3  |   760   |  2F8   |
  351.             +----------+------+---------+--------+
  352.             |    3     |   4  |  1000   |  3E8   |
  353.             +----------+------+---------+--------+
  354.             |    4     |   3  |   744   |  2E8   |
  355.             +----------+------+---------+--------+
  356.  
  357. If one of these CommPort settings matches your hardware
  358. configuration simply use the /C command line argument with the
  359. appropriate CommPort.  The CommPort= IRDC.INI directive can also be
  360. used.
  361.  
  362. You can define your own CommPort by selecting User Defined CommPort
  363. from the Configuration Panel screen and setting the IRQ interrupt
  364. and Base I/O Address.  (You could also use the /I and /A Command
  365. Line Args or IRQ= & Base_IO_Address= IRDC.INI file directives).
  366. IRQ can be set to any value between 1 and 15 (inclusive).  Base I/O
  367. Address can be set to any value greater than zero.  CAUTION: your
  368. hardware may "lock up" if incorrect settings are used.  Once you
  369. have enabled communications with the remote, then use the 'Save
  370. Options' menu item to save the information to the IRDC.INI file.
  371.  
  372. NOTE: THE BASE I/O ADDRESS MUST BE SPECIFIED IN DECIMAL NOTATION.
  373.  
  374.           IBM PS/2 CommPort Parameters are shown below:
  375.             +----------+------+------------------+
  376.             |   PS/2   |      | Base I/O Address |
  377.             | CommPort | IRQ  +---------+--------+
  378.             |          |      | Decimal |  HEX.  |
  379.             +----------+------+---------+--------+
  380.             |    1     |   4  |  1016   |  3F8   |
  381.             |    2     |   3  |   760   |  2F8   |
  382.             |    3     |   3  | 12832   | 3220   |
  383.             |    4     |   3  | 12840   | 3228   |
  384.             |    5     |   3  | 16928   | 4220   |
  385.             |    6     |   3  | 16936   | 4228   |
  386.             |    7     |   3  | 21024   | 5220   |
  387.             |    8     |   3  | 21032   | 5228   |
  388.             +----------+------+---------+--------+
  389.           A User Defined CommPort must be used for
  390.           PS/2 CommPorts 3-8.
  391.  
  392.  
  393. 10. PROGRAM OVERVIEW
  394. --------------------------------------------------------------------
  395. When the program loads, it looks for an IRDC.INI file in the current
  396. directory and then proceeds to parse it if one is found.  If any
  397. errors are detected within the INI file the program will terminate
  398. with an appropriate message, otherwise it will parse the command
  399. line arguments (which override any conflicting INI directives).
  400. Once again, if any errors are found it will terminate with an
  401. appropriate message.  Finally, it will look for a IRDC.HLP file and
  402. activate the online Help if the file is found.  The IRDC full screen
  403. interface will then be presented with the remote keypad displayed on
  404. the right and the various program controls displayed on the left.
  405. The upper left button of the remote keypad is the "active" control
  406. at this time.  The program DOES NOT open the CommPort until you
  407. actually press one of the remote keypad buttons; this allows you to
  408. confirm the active CommPort before actually using it.
  409.  
  410. The Status Window on the upper left side of the screen will display
  411. all remote keypad button activity as it is executed.  In addition
  412. it will display a message each time a CommPort is opened.  (eg. the
  413. first time you press a remote keypad button there will be a very
  414. brief delay as the CommPort must be opened first).  There is also
  415. a small LED indicator in the middle of the screen which will flash
  416. briefly whenever a remote keypad button is clicked/pressed.
  417.  
  418. When the configuration button is clicked, the Configuration panel is
  419. overlaid on the left side of the screen.  The current settings for
  420. the Model, CommPort, Display and the Warning Flag are indicated with
  421. option buttons.  If you change the Model or Display settings the
  422. screen will immediately reflect the new settings.  To make your
  423. settings permanent, click on Save; all current settings (including
  424. any Extended Remote Code definitions) will be written to the
  425. IRDC.INI file.  If an IRDC.INI already exists, the program will
  426. display an Overwrite Confirmation before overwriting the existing
  427. IRDC.INI file.  To continue with these new settings for the current
  428. session only, click on OK; to restore the prior settings, click on
  429. Cancel (or press ESCAPE).
  430.  
  431. As stated earlier, a mouse is highly recommended; you can simply
  432. click on the remote keypad buttons, the control buttons and the
  433. Extended Remote Code List Box scroll bars to perform program
  434. functions.  To execute an Extended Remote Code contained within the
  435. Extended Remote Code list box, simply Double Click on it.
  436.  
  437. 11. KEYBOARD USAGE
  438. --------------------------------------------------------------------
  439. Use the TAB/Shift-TAB keys to move among the various remote keypad
  440. buttons and the control buttons (eg. Configure, Help & Exit).  The
  441. Up/Down arrows can be used to move up and down the Extended Remote
  442. Code List Boxes.  Use the Space Bar key to select the current List
  443. Box item, check/uncheck a check box, or invoke a command button.
  444. (The Enter key can also be used for all controls except the Extended
  445. Remote Code list box; the space bar must be used.) The ESCAPE key
  446. will exit the current function or the program if no other windows
  447. are visible.
  448.  
  449. The cursor keys can be used to navigate within the keypad area; you
  450. can jump to adjacent buttons by pressing the appropriate key.  The
  451. program will jump over 1 blank row/button if an ajacent button is
  452. not present.
  453.  
  454. The following quick access keys are applicable when
  455. the Configuration Panel IS NOT displayed:
  456.  
  457.         Configure - Alt-c
  458.              Help - Alt-h
  459.              Exit - Alt-x
  460.      Remote Codes - Alt-d
  461.  
  462. The following quick access keys are applicable when the Configuration
  463. Panel IS displayed:
  464.  
  465.             Model - Alt-m
  466.          CommPort - Alt-p
  467.           Display - Alt-d
  468. Setup Information - Alt-i
  469.                OK - Alt-o
  470.              Save - Alt-s
  471.            Cancel - Alt-a
  472.  
  473. 12. APPLICATIONS
  474. --------------------------------------------------------------------
  475. After experimenting a little with IRDC you may find yourself
  476. thinking: "its a neat 'toy' but what practical uses does it have?"
  477. This section attempts to describe the practical applications for
  478. this type of software.
  479.  
  480. Generating I/R Signals & IRDQ.EXE
  481. ---------------------------------
  482. IRDC allows you to generate I/R signals simply by clicking the
  483. buttons on the on-screen remote keypad.  It also allows you to build
  484. a list box of those 'difficult to remember' Extended Remote Codes
  485. which you can invoke with a double click.  It offers convenience
  486. since you can leave it running in a window when working in a
  487. multi-tasking or task-switching environment and simply switch to it
  488. as required.  However, it does require 'human' intervention since
  489. you have to physically click your mouse button in order to generate
  490. I/R signals.  This is where IRDQ.EXE comes into play; IRDQ is a
  491. command line driven version of IRDC that instructs ONE FOR ALL
  492. remotes to emit I/R signals based on a button name passed on the
  493. command line.  Alternatively, it will 'press' a series of buttons
  494. that are contained within a file when the filename is passed to IRDQ
  495. on the command line.  This means you can build "macros" by creating
  496. files of the button names to be pressed.  In addition, it means the
  497. entire library of ONE-FOR-ALL I/R codes is at your disposal because
  498. you can dynamically set the device type at anytime.  For example,
  499. you could build a button file containing the following button
  500. names:
  501.  
  502.      ;
  503.      ; IRDQ Button File - Turn on both TV's
  504.      ; Note: lines prefixed with ";" are ignored
  505.      ;
  506.      ; Assign TV Code: 000 (Sony TV)
  507.      TV
  508.      A
  509.      B
  510.      C
  511.      0
  512.      0
  513.      0
  514.      ; The Wait button name does not exist,but instructs IRDQ
  515.      ; to wait for 1/2 second to allow the ONE FOR ALL remote
  516.      ; to 'catch up'
  517.      Wait
  518.      ; The SONY TV has an Extended Remote Code to turn the POWER ON
  519.      ; use this code rather than the POWER button which is just
  520.      ; a toggle
  521.      A
  522.      6
  523.      8
  524.      Wait
  525.      ; Assign TV Code: 047 (GE TV)
  526.      TV
  527.      A
  528.      B
  529.      C
  530.      0
  531.      4
  532.      7
  533.      Wait
  534.      ; The GE TV has an Extended Remote Code to turn the POWER ON
  535.      ; use this code rather than the POWER button which is just
  536.      ; a toggle
  537.      A
  538.      1
  539.      8
  540.  
  541. The end result being you can build a virtually unlimited library
  542. of I/R signal sequences and generate them simply by invoking a
  543. program from the DOS command prompt.
  544.  
  545. I/R Signal Distribution
  546. -----------------------
  547. The range of the I/R signals that the remote control generates based
  548. on instructions from the software is limited to the same room as
  549. where your PC is located.  This limitation is severe enough that the
  550. program would not be very useful at all unless you happened to
  551. locate all of your I/R electronic equipment in the same room as your
  552. PC.  This is obviously unrealistic, but fortunately there is a
  553. relatively inexpensive solution that will enable you to distribute
  554. I/R signals to virtually anywhere in your home or apartment.  An I/R
  555. extender can be used to "read" I/R signals from one location,
  556. translate them into radio waves and beam them to one or more other
  557. locations where they'll be translated back into I/R signals and sent
  558. to the targeted electronic equipment.  The entire process takes
  559. milliseconds and is virtually instantaneous.  The X-10 Powermid is
  560. an I/R Extender; it has 2 components, a unit that receives the I/R
  561. signals and transmits them via radio waves, and a unit that picks up
  562. the radio signals and transmits the I/R signals.  Both units are
  563. small 3" x 3" x 3" pyramid-shaped devices enclosed within a black
  564. plastic casing.  You can install multiple Receiver/I.R emitters that
  565. are sourced by the same Transmitter; this allows you to distribute
  566. I/R signals to multiple locations.  Recoton also markets an IR
  567. Extender.  To use an I/R extender with IRDC/IRDQ, you'd simply aim
  568. the ONE FOR ALL remote at the I/R Transceiver.
  569.  
  570. Scheduling I/R Signals
  571. ----------------------
  572. With IRDC/IRDQ, a ONE-FOR-ALL Remote & an I/R Extender you have the
  573. capability to easily generate & distribute an I/R signal for just
  574. about any electronic equipment that exists to virtually anywhere
  575. within your home.  The capability to schedule I/R signal
  576. transmissions at predetermined times would be a step closer towards
  577. a completely automated I/R system.  Since IRDQ can be driven from
  578. the DOS command prompt you could accomplish this through the use of
  579. any DOS-based scheduler.  For example, a Scheduler is bundled with
  580. Central Point's PC Tools.  You lodge the dates & times of the
  581. programs you want to run and then load the resident portion of the
  582. Scheduler into memory as a TSR from your AUTOEXEC.BAT.  The
  583. Scheduler will kick in at the predetermined times and run the programs
  584. you've defined.  If you happen to be working on your computer at a
  585. scheduled program time, the scheduler will ask you if you want to
  586. run the Scheduled program now or delay it; if you proceed to run it
  587. the Scheduler will save the memory image of your current working
  588. environment and restore it after it has run the scheduled program.
  589. There are many other DOS schedulers around including several fine
  590. shareware products.  Back'n Forth, a shareware Task-Switcher, has
  591. many features including a built in scheduler.
  592.  
  593. Event-Driven I/R Signal Generation
  594. ----------------------------------
  595. A truly automated I/R system should support event-driven I/R signal
  596. generation.  The transmission of I/R signals should not be limited
  597. to scheduled times, but rather, should be driven by events such as
  598. the reception of X-10 signals, changes in temperature, motion
  599. detection, contact closure, etc.  Most PC-based home automation
  600. systems which react to received events support 'shelling to DOS' to
  601. execute programs based on the events you specify; so IRDQ could be
  602. used with these programs to integrate I/R signal generation.  The
  603. HC2000 program is an example of a home automation system that is
  604. based on 2-way X-10 communications.
  605.  
  606. The HC2000 Home Automation Program
  607. ----------------------------------
  608. HC2000 is a software-based X-10 home automation system.  It requires
  609. a dedicated PC but will run quite satisfactorily on a 4.77 MHz XT.
  610. If you've upgraded your PC and have an older machine that is
  611. collecting dust as a paperweight somewhere then HC2000 will allow
  612. you to put it to good use as the 'brain' of your home automation
  613. system.
  614.  
  615. HC2000 requires a TW523 device which is a two-way X-10 module that
  616. sends and receives X-10 signals.  An Editor is supplied with HC2000
  617. that allows you to build your home automation program.  You can
  618. send X-10 signals at scheduled times, or when other X-10 commands
  619. are received (allowing you to build remote 'macros'), or based on
  620. the values of user variables that you define and manipulate.  In
  621. addition to having the program respond to events by sending X-10
  622. commands, you can also run DOS programs.  This means you can use
  623. IRDQ.EXE to emit I/R signals based on the events that are trapped
  624. by HC2000.  For example, you could define an X-10 command that would
  625. invoke the button sequence to turn on the two TV's that was defined
  626. earlier in this section; the following steps outline how you could
  627. accomplish this:
  628.  
  629. 1) Create the Button File: TURNTVS.ON
  630.  
  631. 2) Start up the HC2000 editor and create a User Variable entitled
  632.    'DOS IRDQ.EXE TURNTVS.ON'.
  633.  
  634. 3) Add an X-10 remote command using the House/Unit Code that you
  635.    want to define and add a 'LOG' statement using the User Variable
  636.    you defined in step 2: eg:
  637.  
  638.      ■ A1 ON {Turn on both TVs} ::=
  639.        Log "DOS IRDQ.EXE TURNTVS.ON'
  640.  
  641.    (This command would respond to House Code A, Unit 1.)
  642.  
  643. 4) Exit the HC2000 editor and run HCDOS; HCDOS checks all of the
  644.    messages that HC2000 logs and when it encounters the IRDQ.EXE
  645.    message it will execute IRDQ.EXE and pass it the TURNTVS.ON
  646.    parameter.
  647.  
  648. IRDQ.EXE has been successfully tested with HC2000.
  649.  
  650. 13. PROBLEM RESOLUTION
  651. --------------------------------------------------------------------
  652. The ONE FOR ALL remote control PC interface deploys a relatively
  653. simple communications protocol and you should not experience any
  654. problems provided that your special serial cable is in good
  655. condition and there are no loose connections.  However, the timing
  656. of the serial communications is very critical and there is not much
  657. tolerance for even minor deviation.  Any resident software that
  658. tampers with the system clock could throw the serial communications
  659. out of sync.
  660.  
  661. If IRDC does not appear to be working at all, then read through the
  662. following checklist to confirm your hardware/software setup.
  663.  
  664. 1) Verify that your remote control is supported; See the ONE FOR ALL
  665.    REMOTES section for further information on the supported models.
  666.  
  667. 2) Ensure that you are using the correct CommPort; click on the
  668.    Configuration button and verify that the active CommPort is
  669.    correct.
  670.  
  671. 3) Ensure that the special serial cable connections are firm and
  672.    that the cable is not bent or stretched; The most likely cause is
  673.    the 3-pin serial connector not being seated properly in the
  674.    external port of the ONE FOR ALL remote.  In some cases, it may
  675.    appear to be properly seated but in fact it is not.  It may be
  676.    necessary to tape the connection to ensure that it is sound.
  677.  
  678. 4) Ensure that memory resident software is not conflicting with
  679.    IRDC by booting your PC without any Device Drivers or TSR's.
  680.    (ie. use a stripped down CONFIG.SYS and AUTOEXEC.BAT).
  681.  
  682. If IRDC appears to be working but you run into a situation where the
  683. LED on the remote control stays ON with an amber colour and will not
  684. turn off, then communications between the remote control and the
  685. software have been disrupted. The most likely cause for this is a
  686. loose connection.  The remote control is in Serial Execution mode;
  687. power OFF your PC, check cable connections, power ON your PC and
  688. reload IRDC.  Click on a remote button and the LED should flicker
  689. amber, then green, then turn off.  This problem can also be caused
  690. by a CommPort IRQ conflict (ie. having a TSR loaded which uses
  691. CommPort 4 while attempting to use IRDC with CommPort 2); in this case
  692. it is necessary to perform a cold boot to reset serial devices and
  693. then booting without loading the conflicting TSR.  If your remote
  694. consistently becomes stuck in Serial Execution mode, then it is
  695. probably the result of a timing problem; please contact the author
  696. in this case, adjustments can be made to the software to work around
  697. this.
  698.  
  699. If the ONE FOR REMOTE becomes "unresponsive" to IRDC, it could be
  700. because commands were sent to it while it was executing a macro.
  701. This only applies to a ONE FOR ALL 12 which will not act on commands
  702. sent while it is executing a macro; you should wait for the macro
  703. to complete before sending more commands.
  704.  
  705. As a last resort, you may want to try using another serial port to
  706. see if this eliminates the problem. Other common problems &
  707. solutions are listed below:
  708.  
  709. Interrupt Conflict
  710. ------------------
  711. If you're using a COMMPORT that shares an interrupt with another
  712. COMMPORT (eg. 1 & 3, 2 & 4), then you must ensure that no memory
  713. resident software (eg. a FAX TSR) that uses the other COMMPORT is
  714. loaded as it will not release the interrupt.
  715.  
  716. Serial Mouse Drivers
  717. --------------------
  718. If you use a Serial Mouse, this may cause a conflict if IRDC
  719. attempts to communicate with a remote on the same CommPort.  IRDC
  720. will not run properly if it attempts to communicate with a COMMPORT
  721. that has been initialized with a Mouse Driver (ie.  you cannot use a
  722. switchbox between the remote and a Mouse unless you reboot without
  723. loading the Mouse Driver).
  724.  
  725. IRDC Encryption
  726. ----------------
  727. The IRDC executable file is encrypted and there is a remote
  728. possibility that the decryption process may fail with certain
  729. processors; a blank screen immediately after attempting to run the
  730. program typifies this problem.  Please contact the author if you
  731. encounter this problem.
  732.  
  733. The open architecture of the PC compatible operating environment and
  734. the near infinite combinations of hardware and software complicate
  735. the compatibility of applications software.  While every effort has
  736. been made to ensure that IRDC is compatible with as many hardware
  737. and software combinations as possible, there may be operating
  738. environments in which IRDC will not run properly.
  739.  
  740. Problems can be reported to:
  741.  
  742.    David Huras
  743.    37 Ruddell Crescent
  744.    Georgetown, Ont. L7G 5N4
  745.    CANADA
  746.  
  747.    FAX: 905-873-6429
  748.    CIS: 72767,472
  749.    Internet: david.huras@canrem.com
  750.  
  751. 14. REGISTRATION INFORMATION
  752. --------------------------------------------------------------------
  753. The registration fee for IRDC is $25. (US Dollars for US shipping
  754. addresses, CDN Dollars for Canadian shipping addresses).  IRDC is
  755. currently supplied as fully functioning software without built-in
  756. delays or "nag" screens prompting you to register. However, the
  757. program will timeout after 10 minutes.  This limitation does not
  758. apply to the Registered version.
  759.  
  760. A SIGNIFICANT amount of time and effort went into this program;
  761. please register the program if you intend to use it beyond the 30
  762. day evaluation period.  Registered Users will be shipped a printed
  763. manual and a 3½" diskette (if you would prefer a 5¼" diskette please
  764. advise) containing the Registered Version of the IRDC.
  765.  
  766. Registered Users will also receive IRDQ.EXE, a command line driven
  767. version of IRDC.  With IRDQ you can press buttons on ONE FOR ALL
  768. remote keypads simply by entering commands at the DOS prompt, for
  769. example you would type IRDQ POWER to press the POWER button.
  770. Alternatively you can pass a file name containing a list of button
  771. names to IRDQ, eg.  IRDQ /F:BUTTON.FIL where BUTTON.FIL contains
  772.  
  773.   AUX
  774.   WAIT
  775.   POWER
  776.   TV
  777.   WAIT
  778.   POWER
  779.   VCR
  780.   WAIT
  781.   POWER
  782.   "<<"
  783.  
  784. This "macro" would turn on your Receiver, TV & VCR and rewind the
  785. tape in the VCR.  IRDQ is a compact program which was designed to be
  786. interfaced with software based home automation systems like HC2000.
  787. You could also "grow your own" home automation system by using IRDQ
  788. with a DOS-based program scheduler like the one provided with
  789. Central Point's PC Tools.  All IRDQ program options can be imbedded
  790. within the DOS environment thereby eliminating the need for any
  791. command line arguments other than button names or a filename
  792. containing button names.  (See the APPLICATIONS section for further
  793. information about IRDQ).
  794.  
  795. To expedite your registration, you may wish to register using
  796. CompuServe Shareware Registration; you will receive a Registration
  797. Key via CompuServe E-Mail within 1 business day that will enable the
  798. registered program features. (See CompuServe Shareware Registration
  799. below).  If you elect to use this method of registration then your
  800. your software will ship within 1 business day.
  801.  
  802. If you do not wish to register via CompuServe Shareware Registration
  803. then complete the order form in the REGISTER.FRM file and send with
  804. your payment to:
  805.  
  806.    David Huras
  807.    37 Ruddell Crescent
  808.    Georgetown, Ont. L7G 5N4
  809.    CANADA
  810.  
  811. CompuServe Shareware Registration
  812. =================================
  813. You can register IRDC, IRDCw or BOTH using CompuServe Shareware
  814. Registration.  The Registration Fee will be charged to your
  815. CompuServe billing account and the latest version of the software
  816. along with a printed User Guide will be shipped within one business
  817. day.  In addition, you will receive a Registration Key via
  818. CompuServe E-Mail (within one business day) that will immediately
  819. allow you to run IRDC with the registered version features enabled
  820. while you wait for your diskette to arrive.  GO SWREG while on
  821. CompuServe to use Shareware Registration.
  822.  
  823. Program Title                      Program Name    Program ID#   Charge
  824. ===================                ============    ===========   =======
  825. INFRA-RED Direct Control (DOS)        IRDC            1449       $25.00
  826.  
  827. INFRA-RED Direct Control (WINDOWS)    IRDCw           2521       $25.00
  828.  
  829. INFRA-RED Control Bundle (DOS & WIN)  IRCB            2522       $40.00
  830.  
  831. 15. UPGRADE INFORMATION
  832. --------------------------------------------------------------------
  833.  
  834. Quick Upgrade
  835. =============
  836. REGISTERED USERS of prior versions of IRDC can immediately run the
  837. shareware version of IRDC v2.00 and all future shareware versions of
  838. IRDC with the registered features enabled.   IRDC will look in the
  839. current sub-directory for the IRDC.KEY file; if a valid file is
  840. found then IRDC will enable all registered program features.   This
  841. means you can upgrade by downloading the latest shareware version of
  842. IRDC and ensuring that your IRDC.KEY file resides in the same
  843. sub-directory.
  844.  
  845.  
  846. Existing Registered Users
  847. =========================
  848. If you registered a version of IRDC prior to 2.00; then you are
  849. entitled to an IRDC.KEY file that will enable you to immediately use
  850. the shareware version of IRDC v2.00 with the registered features
  851. enabled.  Your IRDC.KEY file can be forwarded via CompuServe E-Mail,
  852. Internet E-Mail, or you can download it directly from the author.
  853. Please contact the author via E-Mail or FAX to arrange for the
  854. delivery of your IRDC.KEY file.
  855.  
  856. Diskette Upgrade
  857. ================
  858. REGISTERED USERS of prior versions of IRDC can request a diskette
  859. containing the current version of the software at ANY TIME by simply
  860. sending a diskette containing their registered version of the
  861. software and $2 for postage to the author.
  862.  
  863. REGISTERED USERS of IRDCw(WIN) can upgrade to IRDC(DOS) for
  864. a special price of $15.00.  (See REGISTER.FRM for Details)
  865.  
  866. REGISTERED USERS of IRDC(DOS) can upgrade to IRDCw(WINDOWS) for
  867. a special price of $15.00.  (See REGISTER.FRM for Details)
  868.  
  869. 16. RELEASE HISTORY - IRDC Shareware/Registered Version
  870. --------------------------------------------------------------------
  871.  Date      Version     Changes
  872. ------   ----------   ----------------------------------------------
  873.  
  874. NOV'94      2.00      -Added support for 4 additional ONE FOR ALL
  875.                        remote control models (URC2005,URC4005,URC4050,
  876.                        URC6050)
  877.                       -Added Dynamic User Defined CommPort Support
  878.                       -Added Quick Upgrade/Registration
  879.                       -Changed initial warning prompt to contextual
  880.                        jump into the Help Dialogue
  881.  
  882. APR'94      1.03      -Added Save IRDC.INI prompt when Exit attempted
  883.                        without saving a changed Configuration
  884.  
  885. MAR'94      1.02      -Re-enabled ESCAPE key to exit Configuration
  886.                        Panel
  887.  
  888. OCT'93      1.01      -Enabled ESCAPE key to exit Program
  889.                       -Corrected typo in Help File Warning
  890.                        (URC-5000-2 not supported should have
  891.                        read URC-5000-1 not supported)
  892.  
  893. OCT'93      1.00      First Public Release
  894.                       -Configuration Panel Re-organized
  895.                        -SAVE Button Added
  896.                        -Warning CheckBox Added
  897.                       -'F1' Key to invoke Help added
  898.                       -Cursor Key navigation added to keypad area
  899.                        (cursor keys will navigate to adjacent
  900.                         buttons - will skip 1 row or button if
  901.                         no adjacent button).
  902.                       -OFA-12 Button Definition Problems Corrected
  903.                        (Mode Buttons, A,B,C, Power, CH+,CH-)
  904.                       -OFA-12 Extended Remote Code support added
  905.                        for F1 - F4.
  906.                       -European Date Format Support Added
  907. SEP'93      1.00ß     Beta Test
  908.  
  909. ------
  910.