home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 24 / CD_ASCQ_24_0995.iso / vrac / irdc212.zip / IRDQ.DOC < prev    next >
Text File  |  1995-02-26  |  19KB  |  376 lines
  1. --------------------------------------------------------------------
  2. IRDQ - INFRA-RED Command Line Control
  3. --------------------------------------------------------------------
  4. Version 2.11
  5. February 1995
  6.  
  7. Copyright 1993-1995 - D.Huras - All Rights Reserved
  8.  
  9. ------------------------------------------------IRDQ.DOC v2.11------
  10. CONTENTS
  11. --------------------------------------------------------------------
  12.  1. DESCRIPTION
  13.  2. WARRANTY
  14.  3. SETUP INSTRUCTIONS
  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.   The full functioning version
  31. of IRDQ is supplied with the Registered Version of IRDC.  A limited
  32. function (*2) version of IRDQ is supplied with the Shareware Version
  33. of IRDC.
  34.  
  35. This brief document focuses on the use of IRDQ and is meant to
  36. accompany the IRDC document which goes into much more detail
  37. regarding the hardware interfaces, communication ports, software
  38. applications and problem determination.
  39.  
  40. ----
  41. (*1) ONE FOR ALL, ONE FOR ALL 5, ONE FOR ALL 6, ONE FOR ALL 8,
  42.      ONE FOR ALL 12 and The "Universal" Remote are trademarks of
  43.      Universal Electronics Inc.
  44.  
  45. (*2) The limited function version is subject to the following
  46.      limitations:
  47.      i)   5 Second Pause upon program load.
  48.      ii)  Quiet Mode not supported.
  49.      iii) Supports only 2 Button names per file with /F: argument.
  50.  
  51. 2. WARRANTY
  52. --------------------------------------------------------------------
  53. IRDQ is supplied AS IS.  The author disclaims all warranties,
  54. expressed or implied, including, without limitation, the warranties
  55. of merchantability and of fitness for any purpose.  The author
  56. assumes no liability for damages, direct or consequential, which may
  57. result from the use of IRDQ.
  58.  
  59. 3. SETUP INSTRUCTIONS
  60. --------------------------------------------------------------------
  61. Setup Instructions differ based on the model of the ONE FOR ALL
  62. remote that you are using.  It is very important that you correctly
  63. identify the model before using the program.  Refer to the IRDC.DOC
  64. file to identify your remote and then follow the appropriate Setup
  65. Instructions below.
  66.  
  67. SETUP INSTRUCTIONS FOR:
  68. -----------------------
  69.   ONE FOR ALL 6  [URC4000]
  70.   ONE FOR ALL 12 [URC5000]
  71.  
  72. 1) Plug the Special Serial Cable into the PC Serial Port.
  73. 2) Plug the Special Serial Cable into the ONE FOR ALL Remote Control.
  74. 3) Ensure that there are no loose connections.
  75. 4) Run the IRDQ Program.
  76. 5) VERY IMPORTANT: DO NOT TOUCH ANY BUTTONS on the remote control when
  77.    when using the software.
  78. NOTES:
  79. ------
  80. ∙ The author assumes no liability for damages, direct or
  81.   consequential, which may result from the use of IRDQ.
  82. ∙ If you physically press buttons on the keypad while the software
  83.   is communicating with the remote control strange things can happen
  84.   that could affect the operability of your remote control.  If the
  85.   memory contents of your remote control are altered then the only way
  86.   to restore it to normal operation is to have it reloaded by
  87.   Universal Electronics or a local Service Dealer.
  88. --------------------------------------------------------------------
  89.  
  90. SETUP INSTRUCTIONS FOR:
  91. -----------------------
  92.   ONE FOR ALL 5  [URC2005]
  93.   ONE FOR ALL 6A [URC4005]
  94.   ONE FOR ALL 6B [URC4040]
  95.   ONE FOR ALL 8  [URC6050]
  96.  
  97. 1) Plug the Special Serial Cable into the PC Serial Port.
  98. 2) Plug the Special Serial Cable into the ONE FOR ALL Remote Control.
  99. 3) Ensure that there are no loose connections.
  100. 4) VERY IMPORTANT: You must physically press a button on the remote
  101.    control and then run the IRDQ program with a button name WITHIN 5
  102.    SECONDS to put the remote online. Once the remote is online it will
  103.    remain online (and will not respond to physical key presses) until
  104.    you explicitly take it offline by running IRDQ with the "OFFLINE"
  105.    button name (or the OFFLINE button within a button file).  The LED
  106.    on the remote will flash twice in acknowledgement of the request.
  107.  
  108. NOTE:
  109. -----
  110. ∙ The author assumes no liability for damages, direct or
  111.   consequential, which may result from the use of IRDQ.
  112.  
  113. 4. COMMAND LINE ARGUMENTS
  114. --------------------------------------------------------------------
  115. DEFAULTS:  If the program is run without any command line arguments
  116.            it will default to COMMPORT 1 & MODEL 6.
  117.  
  118. The following command line arguments can be entered in any order:
  119.  
  120. BUTTON    - Name of Button to be pressed (see BUTTON NAMES).
  121.  
  122. /Annnn(n) - Base I/O Address applicable to User Defined CommPort
  123.             (Must be specified as a decimal number)
  124.             If /I argument is present, but /A is not; then Base
  125.             I/O Address will default to 1016 (3F8 Hex).
  126.  
  127. /Cn  - COMMPORT where n = 1,2,3 or 4
  128.  
  129. /F:[d]:\filespec - File Name containing Button Names of Buttons
  130.                    to be pressed. (eg. /F:C:\IRDQ\TV.ON)
  131.  
  132. /In  - IRQ applicable to User Defined CommPort where n = 1 - 15
  133.        If /A argument is present, but /I is not; then IRQ
  134.        will default to 4.
  135.  
  136. /Mn  - MODEL where n = 5, 6, 6A, 6B, 8 or 12
  137.  
  138. /Q   - Quiet Mode; Display no messages during program execution
  139.  
  140. /?   - Display Command Line Arguments & Environment Variable syntax
  141.  
  142. NOTE: - COMMAND LINE OPTIONS OVERRIDE ANY SETTINGS STORED WITHIN
  143.         DOS ENVIRONMENT VARIABLE, IRDQ.
  144.       - MULTIPLE OCCURRENCES OF THE SAME COMMAND LINE ARGUMENT
  145.         ARE ACCEPTED; THE LAST INSTANCE WILL BE USED BY IRDQ.
  146.  
  147. 5. IRDQ DOS ENVIRONMENT VARIABLE
  148. --------------------------------------------------------------------
  149. To minimize program size and improve performance, IRDQ does not
  150. support an INI file of program parameters.  However, you can avoid
  151. using command line arguments by setting up a DOS environment
  152. variable that contains program settings.  The DOS environment
  153. variable 'IRDQ' is used to pass settings to IRDQ.EXE.  You use the
  154. DOS 'SET' command to assign a value to an environment variable.
  155. The syntax is:
  156.  
  157.   SET IRDQ=m,c,i,a,q
  158.  
  159.     where: m = Model (5,6,6A,6B,8 or 12)
  160.            c = CommPort (1 thru 4)
  161.            i = IRQ (1 - 15)
  162.            a = Base I/O address (must be > 0)
  163.            q = Quiet Mode
  164.  
  165. You do not need to specify values for parameters that you do
  166. not wish to change.  However, IRDQ environment variable parameters
  167. are positional so you must use comma's as placeholders if you
  168. wish to skip a parameter.  Trailing comma placeholders are not
  169. required.  Examples are shown below:
  170.  
  171.    To turn on Quiet Mode:      SET IRDQ=,,,,Q
  172.  
  173.    To set Model to 12:         SET IRDQ=12
  174.  
  175.    To set CommPort to 2:       SET IRDQ=,2
  176.  
  177.    To set Model 12,CommPort 2
  178.     and turn Quiet Mode On:    SET IRDQ=12,2,,,Q
  179.  
  180.    To set IRQ to 5:            SET IRDQ=,,5
  181.  
  182.    To set Model 12,IRQ 5, &
  183.    Base I/O Address* 12832:    SET IRDQ=12,,5,12832,Q   *specify in
  184.                                                         decimal
  185.  
  186. The DOS environment variable only needs to be SET once so a logical
  187. place for it is within your AUTOEXEC.BAT file.
  188.  
  189. 6. BUTTON NAMES
  190. --------------------------------------------------------------------
  191. The following Button Names can be passed directly on the Command
  192. Line as an argument OR within the Button File passed to IRDQ with
  193. the /F: command line argument.
  194.  
  195. +----------------------+-----------------------------------------+
  196. |                      |    ONE FOR ALL MODELS SUPPORTED         |
  197. |                      +------+------+------+------+------+------+
  198. |   BUTTON NAMES       |  5   |  6   |  6A  |  6B  |  8   |  12  |
  199. |   (& Synonyms)       | 2005 | 4000 | 4050 | 4005 | 6050 | 5000 |
  200. +----------------------+------+------+------+------+------+------+
  201. | "<"                  |      |  X   |      |      |      |      |
  202. +----------------------+------+------+------+------+------+------+
  203. | "<<",REW,REWIND      |  X   |  X   |  X   |  X   |  X   |  X   |
  204. +----------------------+------+------+------+------+------+------+
  205. | ">>",FF              |  X   |  X   |  X   |  X   |  X   |  X   |
  206. +----------------------+------+------+------+------+------+------+
  207. | 0                    |  X   |  X   |  X   |  X   |  X   |  X   |
  208. +----------------------+------+------+------+------+------+------+
  209. | 1                    |  X   |  X   |  X   |  X   |  X   |  X   |
  210. +----------------------+------+------+------+------+------+------+
  211. | 2                    |  X   |  X   |  X   |  X   |  X   |  X   |
  212. +----------------------+------+------+------+------+------+------+
  213. | 3                    |  X   |  X   |  X   |  X   |  X   |  X   |
  214. +----------------------+------+------+------+------+------+------+
  215. | 4                    |  X   |  X   |  X   |  X   |  X   |  X   |
  216. +----------------------+------+------+------+------+------+------+
  217. | 5                    |  X   |  X   |  X   |  X   |  X   |  X   |
  218. +----------------------+------+------+------+------+------+------+
  219. | 6                    |  X   |  X   |  X   |  X   |  X   |  X   |
  220. +----------------------+------+------+------+------+------+------+
  221. | 7                    |  X   |  X   |  X   |  X   |  X   |  X   |
  222. +----------------------+------+------+------+------+------+------+
  223. | 8                    |  X   |  X   |  X   |  X   |  X   |  X   |
  224. +----------------------+------+------+------+------+------+------+
  225. | 9                    |  X   |  X   |  X   |  X   |  X   |  X   |
  226. +----------------------+------+------+------+------+------+------+
  227. | A                    |  X   |  X   |  X   |  X   |  X   |  X   |
  228. +----------------------+------+------+------+------+------+------+
  229. | A/B                  |      |      |  X   |      |  X   |  X   |
  230. +----------------------+------+------+------+------+------+------+
  231. | AMP                  |      |      |      |      |  X   |  X   |
  232. +----------------------+------+------+------+------+------+------+
  233. | AUDIO                |      |      |  X   |      |  X   |      |
  234. +----------------------+------+------+------+------+------+------+
  235. | AUX                  |  X   |      |      |      |      |  X   |
  236. +----------------------+------+------+------+------+------+------+
  237. | AUX1                 |      |  X   |  X   |  X   |  X   |      |
  238. +----------------------+------+------+------+------+------+------+
  239. | AUX2                 |      |  X   |  X   |  X   |  X   |      |
  240. +----------------------+------+------+------+------+------+------+
  241. | B                    |  X   |  X   |  X   |  X   |  X   |      |
  242. +----------------------+------+------+------+------+------+------+
  243. | B/AUDIO              |      |      |      |      |      |  X   |
  244. +----------------------+------+------+------+------+------+------+
  245. | C                    |  X   |  X   |  X   |  X   |  X   |      |
  246. +----------------------+------+------+------+------+------+------+
  247. | C/VIDEO              |      |      |      |      |      |  X   |
  248. +----------------------+------+------+------+------+------+------+
  249. | CABLE,CBL            |  X   |  X   |  X   |  X   |  X   |  X   |
  250. +----------------------+------+------+------+------+------+------+
  251. | CD                   |  X   |  X   |  X   |  X   |  X   |  X   |
  252. +----------------------+------+------+------+------+------+------+
  253. | CH+                  |  X   |  X   |  X   |  X   |  X   |  X   |
  254. +----------------------+------+------+------+------+------+------+
  255. | CH-                  |  X   |  X   |  X   |  X   |  X   |  X   |
  256. +----------------------+------+------+------+------+------+------+
  257. | DISPLAY,DISP         |  X   |      |  X   |  X   |  X   |  X   |
  258. +----------------------+------+------+------+------+------+------+
  259. | ENTER,ENT            |  X   |  X   |  X   |  X   |  X   |  X   |
  260. +----------------------+------+------+------+------+------+------+
  261. | F1                   |      |      |      |      |      |  X   |
  262. +----------------------+------+------+------+------+------+------+
  263. | F2                   |      |      |      |      |      |  X   |
  264. +----------------------+------+------+------+------+------+------+
  265. | F3                   |      |      |      |      |      |  X   |
  266. +----------------------+------+------+------+------+------+------+
  267. | F4                   |      |      |      |      |      |  X   |
  268. +----------------------+------+------+------+------+------+------+
  269. | MAGIC                |  X   |      |  X   |  X   |  X   |      |
  270. +----------------------+------+------+------+------+------+------+
  271. | MUTE                 |  X   |  X   |  X   |  X   |  X   |  X   |
  272. +----------------------+------+------+------+------+------+------+
  273. | PAUSE                |  X   |  X   |  X   |  X   |  X   |  X   |
  274. +----------------------+------+------+------+------+------+------+
  275. | PLAY                 |  X   |  X   |  X   |  X   |  X   |  X   |
  276. +----------------------+------+------+------+------+------+------+
  277. | POWER,PWR            |  X   |  X   |  X   |  X   |  X   |  X   |
  278. +----------------------+------+------+------+------+------+------+
  279. | PROGRAM,PGM          |  X   |      |  X   |  X   |  X   |  X   |
  280. +----------------------+------+------+------+------+------+------+
  281. | RECALL,RCL           |  X   |  X   |  X   |  X   |  X   |  X   |
  282. +----------------------+------+------+------+------+------+------+
  283. | RECORD,REC           |  X   |  X   |  X   |  X   |  X   |  X   |
  284. +----------------------+------+------+------+------+------+------+
  285. | SAT                  |      |      |      |      |      |  X   |
  286. +----------------------+------+------+------+------+------+------+
  287. | SCAN                 |  X   |      |  X   |  X   |  X   |      |
  288. +----------------------+------+------+------+------+------+------+
  289. | SHIFT                |      |      |  X   |  X   |  X   |      |
  290. +----------------------+------+------+------+------+------+------+
  291. | SLEEP                |      |      |      |      |  X   |  X   |
  292. +----------------------+------+------+------+------+------+------+
  293. | STOP                 |  X   |  X   |  X   |  X   |  X   |  X   |
  294. +----------------------+------+------+------+------+------+------+
  295. | TUNER, TUN           |      |      |      |      |  X   |  X   |
  296. +----------------------+------+------+------+------+------+------+
  297. | TV                   |  X   |  X   |  X   |  X   |  X   |  X   |
  298. +----------------------+------+------+------+------+------+------+
  299. | TV/VCR               |      |  X   |      |      |      |      |
  300. +----------------------+------+------+------+------+------+------+
  301. | VCR                  |  X   |  X   |  X   |  X   |  X   |  X   |
  302. +----------------------+------+------+------+------+------+------+
  303. | VIDEO                |      |      |  X   |      |  X   |      |
  304. +----------------------+------+------+------+------+------+------+
  305. | VOL+                 |  X   |  X   |  X   |  X   |  X   |  X   |
  306. +----------------------+------+------+------+------+------+------+
  307. | VOL-                 |  X   |  X   |  X   |  X   |  X   |  X   |
  308. +----------------------+------+------+------+------+------+------+
  309. | OFFLINE              |  X   |      |  X   |  X   |  X   |      |
  310. +----------------------+------+------+------+------+------+------+
  311. | WAIT                 |  X   |  X   |  X   |  X   |  X   |  X   |
  312. +----------------------+------+------+------+------+------+------+
  313.  
  314.  
  315. NOTES: 1) Double Quotes required for <<,<, & >>
  316. -----     You can use REW, FF rather than "<<" and ">>" respectively.
  317.  
  318.        2) The WAIT button does not exist; it simply instructs IRDQ
  319.           to pause for ½ second.  This is useful when you want the
  320.           program to wait for the remote control to "catch up",
  321.           ie. when running a macro.  (When the remote is running a
  322.           macro, it will not act upon additional instructions
  323.           until it has completed the macro).  If you are having
  324.           problems with a button file then try inserting
  325.           additional WAIT commands between the button names.
  326.  
  327.        2) The OFFLINE button does not exist; it instructs specific
  328.           ONE FOR ALL Models to go offline (and respond to physical
  329.           keypresses).
  330.  
  331. 7. PROGRAM OVERVIEW
  332. --------------------------------------------------------------------
  333. When the program loads, it looks for the IRDQ variable in the DOS
  334. Environment and then proceeds to parse it if found.  If any errors
  335. are detected then the program will terminate with an appropriate
  336. message, otherwise it will parse the command line arguments (which
  337. override the IRDQ environment variable).  Once again, if any errors
  338. are found it will terminate with an appropriate message.
  339.  
  340. If the /F: argument was included on the command line then IRDQ will
  341. attempt to open the file and process the button names.  Otherwise,
  342. IRDQ will look for a button name on the command line and execute
  343. it.  Note: If both the /F: argument AND a button name are passed
  344. on the command line, IRDQ will ignore the button name and process
  345. the button file.
  346.  
  347. 8. RELEASE HISTORY - IRDQ Commercial Software
  348. --------------------------------------------------------------------
  349.  Date      Version     Changes
  350. ------   ----------   ----------------------------------------------
  351. FEB'95      2.11      -Upgraded encryption scheme to improve program
  352.                        compatibility
  353.  
  354. JAN'95      2.10      -Updated keycodes for models URC4005,URC4050 &
  355.                        URC6050 (PROGRAM,RECORD,DISPLAY & MUTE keys)
  356.  
  357. NOV'94      2.00      -Added support for 4 additional ONE FOR ALL
  358.                        remote control models (URC2005,URC4005,
  359.                        URC4050,URC6050)
  360.                       -Added Quick Upgrade/Registration Support
  361.                       -Limited Function version distributed with
  362.                        Shareware Version of IRDC.
  363.  
  364. APR'94      1.01      -Corrected Error Message displayed when an
  365.                        invalid Base I/O Address is detected.
  366.  
  367. OCT'93      1.00      -First Public Release
  368.                       -OFA-12 Button Definition Problems Corrected
  369.                        (Mode Buttons, A,B,C, Power, CH+,CH-)
  370.                       -European Date Format Support Added
  371.  
  372. SEP'93      1.00ß     Beta Test
  373.  
  374.  
  375. ------
  376.