home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d9xx / d943 / irmaster.lha / IRMaster / IR_Master.doc next >
Text File  |  1993-12-20  |  12KB  |  341 lines
  1. +-------------------------------------------------------------------------+
  2. |      #### #####         #######  ####  ##### ###### ###### #####        |
  3. |       ##   ##  #  ####  #### ## ##  ## ###     ##   ####    ##  #       |
  4. |       ##   ####   ####  #### ## ######   ###   ##   ##      ####        |
  5. |      #### ### ##        ##   ## ##  ## #####   ##   ###### ### ##       |
  6. +-------------------------------------------------------------------------+
  7.  
  8.           Written in 1993 by Jürgen Frank & Michael Watzl
  9.           © 1993  in 1993 by Jürgen Frank & Michael Watzl
  10.  
  11.           This package is shareware - it may be freely distributet.
  12.           But if you want to use it frequently you have to register...
  13.  
  14.           The prices:
  15.  
  16.               This package + documents for the hardware   $15 / 25 DM 
  17.               This package + documents + pieces           $25 / 40 DM 
  18.               This packege + complete hardware            $40 / 60 DM 
  19.  
  20. --------------------------------------------------------------------------
  21.                                 Contents:
  22. --------------------------------------------------------------------------
  23.  
  24.             1.      What it does
  25.             2.      Installation
  26.             3.      IR-Editor
  27.             3.1         Menus
  28.             3.2         Toolbox
  29.             3.3         A word about learning IR
  30.             4.      IR-Runner
  31.             4.1         Starting the runner
  32.             4.2         Arexx port
  33.  
  34. --------------------------------------------------------------------------
  35.  
  36.  
  37.  
  38.  
  39. 1. What it does
  40. ===============
  41.  
  42. The IRMaster is a package which enables you to control nearly any
  43. appliance working via a remote control (infra red). You can use
  44. the IR-Editor to create a window with gadgets - your remote control
  45. on the Amiga screen. Then you can make your Amiga learn the
  46. ir-commands.
  47.  
  48. With the IR-Runner you can bring up the window you edited and control
  49. e.g. your tv set by the Amiga.
  50.  
  51.  
  52.  
  53.  
  54. 2. Installation
  55. ===============
  56.  
  57. The IR-Master package works with Kick/WB 1.2/1.3/2.x/3.0...
  58.  
  59.  
  60.     Copy the req.library to your LIBS: drawer of your boot disk.
  61.     Create a directory for the IR-Editor and the IR-Runner.
  62.     Copy them to this directory.
  63.  
  64.  
  65.  
  66.  
  67. 3. The IR-Editor
  68. ================
  69.  
  70. With the IR-Editor you can create a remote control on your Amiga screen.
  71.  
  72.  
  73. 3.1 Menus
  74. ---------
  75.                                 
  76.  
  77.     "Load..."           Pops up a requester to load a saved set of gadgets.
  78.     
  79.     "Save"              Saves the current set of gadgets.
  80.     
  81.     "Saves as..."       Pops up a requester to save the current gadget.
  82.     
  83.     "Info"              Gives some information like the used memory etc.
  84.     
  85.     "About"             Credits...
  86.     
  87.     "Quit"              Quits the editor.
  88.  
  89.  
  90. 3.2 Toolbox
  91. -----------
  92.                                
  93.                     +-----------+
  94.                     |  TOOLBOX  |
  95.                     +-----+-----+
  96.         Creates a   | NEW | \/  | Kills the active 
  97.         new gadget  |     | /\  | gadget
  98.                     +-----+-----+
  99.         Moves the   |  |  | ||_ | Sizes the active
  100.         act. gadget | \|/ |  |_|| gadget
  101.                     +-----+-----+
  102.         Ataches a   | :-) |+---+| Refreshes the 
  103.         Icon to the |+---+|+---+| display
  104.         act. gadget +-----+-----+
  105.         Attaches    | TEXT|  ?  | Pops up a requester
  106.         text to the |     |     | to change the IR-prefs for this gadget
  107.         act. gadget +-----+-----+
  108.         Waits for   | |/_ |_|/_ | Sends the learned IR-Data
  109.         a IR-Impulse|HH   |+|__ |
  110.         to learn    +-----+-----+
  111.  
  112.  
  113. The funtions of the toolbox are pretty self explaining. You can create
  114. new gadgets, kill gadgets, move & resize gadgets ...
  115.  
  116.  
  117. Gadget & text/graphic
  118. ---------------------
  119. You can either attache text or an icon to the gadget. In the first
  120. case it will have a 3D-border and the text will be centered inside
  121. the gadget. In the other case or you can select any icon (.info file)
  122. as image information for the gadget.
  123. There will be no border so if you want some you have to draw your own in the
  124. icon...
  125. The gadget will be automatically resized to the icon's size but you can resize
  126. it afterwards.
  127.  
  128.  
  129.  
  130. 3.3 A word about learning IR
  131. ----------------------------
  132.  
  133.     Learn ir-commands:
  134.         
  135.         - click on the gadget you created               -> gadget is activated
  136.         - click on "learn" in the toolbox               -> pointer is frozen
  137.         - point your remote control to the ir-sensor    
  138.           (distance ca. 1-15 cm)
  139.         - push on button until the pointer can be
  140.           moved again
  141.           
  142.     Test ir-commands      
  143.     
  144.         - click on gadget you want to test              -> gadget is active
  145.         - hold transmitter in direction to the ir-receiver of the 
  146.           implement with a distance of 1-30 cm.       
  147.         - click on "test" in the toolbox                -> command will be sent
  148.  
  149.         
  150.         Important notes
  151.         ---------------
  152.         
  153.         - It is possible that the implement (like CD, Videorecorder, TV set, ...)
  154.           won't react on the ir-master the first time.
  155.           In this case you have to change the parameters in the config-requester.
  156.           To get to the configrequester you must:
  157.           
  158.             - click on the gadget the config should be changed
  159.             - click on the config gadget in the toolbox (the '?')
  160.             
  161.           All the changes (exept wobbelcode) can be testet without learning 
  162.           it again. 
  163.           
  164.           Config menu:
  165.           
  166.           
  167.             37 kHz   -> Carrier frequency of the ir signal is 37 kHz
  168.                         matches for ca. 70% of all implements
  169.             45 kHz   -> Carrier frequency is 45 kHz           
  170.                         matches for ca. 10%
  171.             Unpulsed -> no carrier frequency
  172.                         ca. 8%
  173.                         
  174.             Send command slider            
  175.                 This inicates how often the ir command should be sent.
  176.                 Normally 3-5 times is enough.
  177.                 
  178.             Wobbelcode
  179.                 This is a special form of the ir code. An implement
  180.                 which uses Wobbelcode (e.g. Grundig tools) sends
  181.                 code A the first time and the next time it sends
  182.                 (for the same function) code B.
  183.                 In this case you have to learn twice. To learn this type
  184.                 of code you must click on Wobbelcode in the config menu
  185.                 and then click on learn and follow the messages in the
  186.                 status bar.
  187.                 You can recognize Wobbelcode implements when the implement
  188.                 reacts the first time at once but the second time it
  189.                 does nothing or it reacts very late.
  190.                 
  191.         - The learning of ir commands depends on the distance between        
  192.           remote control and ir sensor. After a fault try you should
  193.           attempt it again with different distances of 0 - 20 cm.
  194.         - If the batteries of the remote control are weak you should  
  195.           use new batteries.
  196.         - If you can't control an implement at all, you should assert,  
  197.           whether the implement can be controlled directly by the remote
  198.           control - some remote controls can switch between differten ir codes.
  199.         - In general all (!) impements can be controlled exept Telefunken.
  200.           For this type of implements we offer a special hardware - simply
  201.           contact Jürgen Frank (address is given below).
  202.         - Finally:  
  203.           The parameters in the config menu are the most common but if it
  204.           does not work - use trial an error. You can't damage your
  205.           hardware by changing the parameters...
  206.           
  207.           If you own a Akai, Blaupunkt, Fisher, Technics, Philips, Grundig,
  208.           Panasonic, Sony... you can learn the command set by nearly 100%.
  209.           (tested very (!) often...)
  210.           
  211.           
  212.           YOU CAN ALSO USE UP TO 5 (WITH Y-ADAPTERS) IR TRANSMITTER IN YOUR 
  213.           JOYSTICPORT. 
  214.           
  215.  
  216.  
  217.  
  218.  
  219.  
  220. 4. IR-Runner
  221. ============
  222.  
  223.  
  224. 4.1 Starting the IR-Runner
  225. --------------------------
  226.  
  227. If you have created a remote control and saved it you surely want
  228. to use it...
  229.  
  230. Therefore you have to start the IR-Runner:
  231.  
  232.     Shell/Cli:
  233.     
  234.         1> IRRunner <projectname.irm>
  235.     
  236.     Workbench:
  237.         
  238.         Click on IRRunner (once) + shift-doubleclick on the project's icon
  239.     or  Doubleclick the project's icon with the default tool correctly set    
  240.     
  241.  
  242.  
  243. 4.2 Arexx port
  244. --------------
  245.  
  246. The IR-Runner has it's own Arexx-port. The port name depends on the project's
  247. name:
  248.  
  249.     Project name:   CD_Player.irm   ->  port name: CD_Player_rexx
  250.     
  251. There are three rexx commands:
  252.  
  253.     Command     Arguments           Description                 Example
  254.  
  255.     IR_Quit    <no arguments>       Quits the ir-runner.        IR_Quit
  256.     IR_Move    x y                  Moves the Window.           IR_Move 50 100
  257.     IR_Send    n                    Sends command no. n         IR_Send 1
  258.     
  259.  
  260. To find out which "number" a gadget has (to activate it via Arexx) simply
  261. click on it in the IR-Editor. In the status bar you can read a message like
  262. this: 'Gadget x selected'.
  263.  
  264. Note: If you remove (kill) a gadget in the editor (e.g. gadget no. 3) then
  265. the other gadgets will get other numbers: 4 becomes 3, 5 becomes 4...
  266.  
  267.  
  268.  
  269. -------------------------------------------------------------------------------
  270.  
  271. We hope you enjoy the IRMaster. If you find it useful and you wish to use it
  272. please register with the following form:
  273.  
  274.  
  275. IF YOU HAVE ANY PROBLEMS WITH THE IR-MASTER, PLEASE CONTACT EITHER MICHAEL
  276. WATZL OR JUERGEN FRANK.
  277.  
  278.  
  279. -------------------------------------------------------------------------------
  280. ------------------ cut here ---------------------------------------------------
  281. -------------------------------------------------------------------------------
  282.  
  283. REGISTRATION FORM
  284.  
  285.  
  286.     COMPANY:    ___________________________________________
  287.     NAME:       ___________________________________________
  288.     STREET:     ___________________________________________ 
  289.     CITY:       ___________________________________________
  290.     POSTALCODE: ___________________________________________
  291.     COUNTRY:    ___________________________________________
  292.     TELEPHONE:  _____________
  293.  
  294.  
  295. I want to become registered user of the IRMaster. Therefore I 
  296.  
  297.     o enclose a cheque (if from foreign countries - drawn on a german bank)
  298.     
  299.     o transfer payment to
  300.         Raiffeisen-Volksbank Donauwoerth eG
  301.         86609 Donauwoerth
  302.         Acc.: 4185455   Bank Code: 722 901 00
  303.        for payment reference use: "IRMASTER REGISTRATION"
  304.        
  305.  
  306. Please send me:       
  307.  
  308.     o newest version of this package + documents for the hardware
  309.       for the price of: $15 / DM 25
  310.  
  311.     o newset version of this package + hardware pieces (incl. docs)
  312.       for the price of: $25 / DM 40
  313.     
  314.     o newest veriosn of this package + complete hardware (incl. docs)
  315.       for the price of: $40 / DM 60
  316.  
  317.  
  318.  
  319.  
  320.     ____________________              ___________________________
  321.        date, locality                            sign
  322.  
  323.      
  324.  
  325. -------------------------------------------------------------------------------
  326. ------------------ cut here ---------------------------------------------------
  327. -------------------------------------------------------------------------------
  328.  
  329.  
  330. If you find this package useful please register. If you don't, throw it away.
  331. If you find any bugs or if you have any suggestions for the next version
  332. please let me know.
  333.  
  334. Michael Watzl                   Juergen Frank    
  335. Konradstrasse 11                Wittelsbackerweg 7
  336. 86609 Donauwoerth               86609 Donauwörth    
  337.  
  338. Germany                         Germany
  339.  
  340. Tel: Germany 0906 5834          Tel: Germany 0906 1057
  341.