home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / utility / irdc10.zip / IRDQ.DOC < prev    next >
Text File  |  1993-10-17  |  9KB  |  236 lines

  1. ────────────────────────────────────────────────────────────────────
  2. IRDQ ∙ INFRA-RED Command Line Control
  3. ────────────────────────────────────────────────────────────────────
  4. Version 1.0
  5. October 1993
  6.  
  7. Copyright 1993 ∙ D.Huras ∙ All Rights Reserved
  8.  
  9. ────────────────────────────────────────────────IRDQ.DOC v1.00──────
  10. CONTENTS
  11. ────────────────────────────────────────────────────────────────────
  12.  1. DESCRIPTION
  13.  2. WARNING
  14.  3. WARRANTY
  15.  4. COMMAND LINE ARGUMENTS
  16.  5. IRDQ DOS ENVIRONMENT VARIABLE
  17.  6. BUTTON NAMES
  18.  7. PROGRAM OVERVIEW
  19.  8. RELEASE HISTORY
  20.  
  21. 1. DESCRIPTION
  22. ────────────────────────────────────────────────────────────────────
  23. IRDQ is a program that sends commands to a ONE FOR ALL (*1) Remote
  24. Control that instruct the remote control to emit INFRA RED (I/R)
  25. signals.  Essentially, IRDQ emulates a person pressing buttons on
  26. the remote control keypad.  Any button sequence that can be
  27. physically entered on the remote control keypad can be emulated with
  28. the IRDQ program including setting the Device type.
  29.  
  30. IRDQ is a companion program to IRDC.EXE.   IRDQ is supplied with the
  31. Registered Version of IRDC.EXE.  This brief document focuses on the
  32. use of IRDQ and is meant to accompany the IRDC document which goes
  33. into much more detail regarding the hardware interfaces,
  34. communication ports, software applications and problem
  35. determination.
  36. ────
  37. (*1) ONE FOR ALL, ONE FOR ALL 6, ONE FOR ALL 12, and The "Universal"
  38.      Remote are trademarks of Universal Electronics Inc.
  39.  
  40.  
  41. 2. WARNING
  42. ────────────────────────────────────────────────────────────────────
  43. ONE FOR ALL Remote Controls are sensitive devices; using a ONE FOR
  44. ALL Remote Control with a Special Serial Cable connected to a PC
  45. Serial Port could alter the memory contents of the Remote Control
  46. possibly rendering it inoperable if the following precautions are
  47. not adhered to:
  48.  
  49. 1) Ensure that the PC is powered-off.
  50. 2) Plug the Special Serial Cable into the PC Serial Port.
  51. 3) Plug the Special Serial Cable into the ONE-FOR-ALL Remote
  52.    Control.
  53. 4) Ensure that there are no loose connections.
  54. 5) Power on the PC and run the software.
  55. 6) VERY IMPORTANT: DO NOT TOUCH ANY BUTTONS on the remote control
  56.    when using the software.
  57. 7) Do not disconnect the Special Serial Cable until the PC is
  58.    powered off.
  59.  
  60. The author assumes no liability for damages, direct or
  61. consequential, which may result from the use of IRDQ.
  62.  
  63. NOTES:
  64. ──────
  65. ∙ If you follow these precautions you should not encounter any
  66.   problems using your remote control with the software or manually.
  67.  
  68. ∙ If you physically press buttons on the keypad while the software
  69.   is communicating with the remote control strange things can
  70.   happen that could affect the operability of your remote control.
  71.   If the memory contents of your remote control are altered then the
  72.   only way to restore it to normal operation is to have it reloaded
  73.   by Universal Electronics or a local Service Dealer.
  74.  
  75. 3. WARRANTY
  76. ────────────────────────────────────────────────────────────────────
  77. IRDQ is supplied AS IS.  The author disclaims all warranties,
  78. expressed or implied, including, without limitation, the warranties
  79. of merchantability and of fitness for any purpose.  The author
  80. assumes no liability for damages, direct or consequential, which may
  81. result from the use of IRDQ.
  82.  
  83. 4. COMMAND LINE ARGUMENTS
  84. ────────────────────────────────────────────────────────────────────
  85. DEFAULTS:  If the program is run without any command line arguments
  86.            it will default to COMMPORT 1 & MODEL 6.
  87.  
  88. The following command line arguments can be entered in any order:
  89.  
  90. BUTTON    ∙ Name of Button to be pressed (see BUTTON NAMES).
  91.  
  92. /Annnn(n) ∙ Base I/O Address applicable to User Defined CommPort
  93.             (Must be specified as a decimal number)
  94.             If /I argument is present, but /A is not; then Base
  95.             I/O Address will default to 1016 (3F8 Hex).
  96.  
  97. /Cn  ∙ COMMPORT where n = 1,2,3 & 4
  98.  
  99. /F:[d]:\filespec ∙ File Name containing Button Names of Buttons
  100.                    to be pressed. (eg. /F:C:\IRDQ\TV.ON)
  101.  
  102. /In  ∙ IRQ applicable to User Defined CommPort where n = 1 - 15
  103.        If /A argument is present, but /I is not; then IRQ
  104.        will default to 4.
  105.  
  106. /Mn  ∙ MODEL where n = 6 or 12
  107.  
  108. /Q   ∙ Quiet Mode; Display no messages during program execution
  109.  
  110. /?   ∙ Display Command Line Arguments & Environment Variable syntax
  111.  
  112. NOTE: ∙ COMMAND LINE OPTIONS OVERRIDE ANY SETTINGS STORED WITHIN
  113.         DOS ENVIRONMENT VARIABLE, IRDQ.
  114.       ∙ MULTIPLE OCCURRENCES OF THE SAME COMMAND LINE ARGUMENT
  115.         ARE ACCEPTED; THE LAST INSTANCE WILL BE USED BY IRDQ.
  116.  
  117. 5. IRDQ DOS ENVIRONMENT VARIABLE
  118. ────────────────────────────────────────────────────────────────────
  119. To minimize program size and improve performance, IRDQ does not
  120. support an INI file of program parameters.  However, you can avoid
  121. using command line arguments by setting up a DOS environment
  122. variable that contains program settings.  The DOS environment
  123. variable 'IRDQ' is used to pass settings to IRDQ.EXE.  You use the
  124. DOS 'SET' command to assign a value to an environment variable.
  125. The syntax is:
  126.  
  127.   SET IRDQ=m,c,i,a,q
  128.  
  129.     where: m = Model (6 or 12)
  130.            c = CommPort (1 thru 4)
  131.            i = IRQ (1 - 15)
  132.            a = Base I/O address (must be > 0)
  133.            q = Quiet Mode
  134.  
  135. You do not need to specify values for parameters that you do
  136. not wish to change.  However, IRDQ environment variable parameters
  137. are positional so you must use comma's as placeholders if you
  138. wish to skip a parameter.  Trailing comma placeholders are not
  139. required.  Examples are shown below:
  140.  
  141.    To turn on Quiet Mode:      SET IRDQ=,,,,Q
  142.  
  143.    To set Model to 12:         SET IRDQ=12
  144.  
  145.    To set CommPort to 2:       SET IRDQ=,2
  146.  
  147.    To set Model 12,CommPort 2
  148.     and turn Quiet Mode On:    SET IRDQ=12,2,,,Q
  149.  
  150.    To set IRQ to 5:            SET IRDQ=,,5
  151.  
  152.    To set Model 12,IRQ 5, &
  153.    Base I/O Address* 12832:    SET IRDQ=12,,5,12832,Q   *specify in
  154.                                                         decimal
  155.  
  156. The DOS environment variable only needs to be SET once so a logical
  157. place for it is within your AUTOEXEC.BAT file.
  158.  
  159. 6. BUTTON NAMES
  160. ────────────────────────────────────────────────────────────────────
  161. The following Button Names can be passed directly on the Command
  162. Line as an argument OR within the Button File passed to IRDQ with
  163. the /F: command line argument.
  164.  
  165. ONE FOR ALL 6
  166. ═════════════
  167.  AUX1      CD        TV        POWER
  168.  AUX2      VCR       CABLE     C
  169.  1         2         3         MUTE
  170.  4         5         6
  171.  7         8         9         VOL+
  172.            0                   VOL-
  173.  A                   ENTER     CH+
  174.  B                   RECALL    CH-
  175.  REC       TV/VCR    STOP      PAUSE
  176.  "<<"      "<"       PLAY      ">>"
  177. WAIT
  178.  
  179. Note: Double Quotes required for <<,<, & >>
  180.       You can use REW, FF rather than "<<" and ">>" respectively.
  181.  
  182. ONE FOR ALL 12
  183. ══════════════
  184.  TV        VCR       CABLE     SAT
  185.  AUX       AMP       TUNER     CD
  186.  A         B/AUDIO   C/VIDEO   POWER
  187.  1         2         3         VOL+
  188.  4         5         6         VOL-
  189.  7         8         9         MUTE
  190.  RECALL    0         ENTER
  191.            PLAY                CH+
  192.  "<<"      PAUSE     ">>"      CH-
  193.            STOP                REC
  194.  SLEEP     DISPLAY   A/B       PGM
  195.  F1        F2        F3        F4
  196.  WAIT
  197.  
  198. Note: Double Quotes required for << & >>
  199.       You can use REW, FF rather than "<<" and ">>" respectively.
  200.  
  201. The WAIT button does not exist; it simply instructs IRDQ to pause
  202. for ½ second.  This is useful when you want the program to wait
  203. for the remote control to "catch up", ie. when running a
  204. macro.  (When the remote is running a macro, it will not act
  205. upon additional instructions until it has completed the macro).
  206.  
  207. 7. PROGRAM OVERVIEW
  208. ────────────────────────────────────────────────────────────────────
  209. When the program loads, it looks for the IRDQ variable in the DOS
  210. Environment and then proceeds to parse it if found.  If any errors
  211. are detected then the program will terminate with an appropriate
  212. message, otherwise it will parse the command line arguments (which
  213. override the IRDQ environment variable).  Once again, if any errors
  214. are found it will terminate with an appropriate message.
  215.  
  216. If the /F: argument was included on the command line then IRDQ will
  217. attempt to open the file and process the button names.  Otherwise,
  218. IRDQ will look for a button name on the command line and execute
  219. it.  Note: If both the /F: argument AND a button name are passed
  220. on the command line, IRDQ will ignore the button name and process
  221. the button file.
  222.  
  223. 8. RELEASE HISTORY ∙ IRDQ Commercial Software
  224. ────────────────────────────────────────────────────────────────────
  225.  Date      Version     Changes
  226. ------   ----------   ----------------------------------------------
  227.  
  228. OCT'93      1.00      First Public Release
  229.                       ∙OFA-12 Button Definition Problems Corrected
  230.                        (Mode Buttons, A,B,C, Power, CH+,CH-)
  231.                       ∙European Date Format Support Added
  232. SEP'93      1.00ß     Beta Test
  233.  
  234.  
  235. ──────
  236.