home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / utilities / utilst / vmectrl / !VMECtrl / !Help < prev    next >
Text File  |  1995-05-06  |  6KB  |  116 lines
  1. !VMEctrl 1.00  /  VMEcontrol module 1.22
  2. ~~~~~~~~~~~~~     ~~~~~~~~~~~~~~~~~~~~~~
  3. First off, to use this you'll need
  4.     * A VIDC enhancer that uses IO1 (eg. Atomwide, Risc Developments, etc)
  5.       as its 'enable' control. (also works with Andreas Barth's DIY
  6.       enhancer).
  7.       Support for other enhancers will be added if there's any call for it
  8.     * An 'old' machine; ie. one that had to have a VIDC enhancer fitted
  9.       (the 'newer' machines have it built in)
  10.     * the VMEcontrol module (version 1.22 or later). You should find a
  11.       copy of it inside the !VMEctrl directory. Feel free to *copy* it to
  12.       somewhere else, but it *must* remain in this directory [the app.
  13.       uses it as the 'stub' for customised modules]
  14.  
  15. NB: No checks are made for hardware/OS version... If you don't know what you've
  16. got, "*fx 0" from the command line/in a taskwindow will tell you the OS
  17. version. You can try it with your VIDC enhancer and if it works, good. If not,
  18. let me know and I'll try to sort it out.
  19.  
  20. When I say VIDC enhancer, I mean a third party add-on, not the clock switcher
  21. built into the newer machines. (Just to clear that bit up)
  22.  
  23. [ see the file 'ModuleDocs' inside the !VMEctrl directory for information about
  24. the module (commands, swis, etc) ]
  25.  
  26. !VMEctrl is a WIMP frontend for the VMEcontrol module (inside the !VMEctrl
  27. directory) that controls a VIDC enhancer add-on (see the ModuleDocs file for
  28. more information of the module). Basically the front-end allows you to
  29. (re)configure the module to suit your preferences, and then save either a file
  30. that the VMEcontrol module can read back in ('*loadmap <filename>' or use
  31. RMLOAD VMEcontrol <filename>') or a new VMEcontrol module that has your choices
  32. built in (so you can just RMLoad it. You can still use it with the saved files
  33. tho', so this method is probably the better of the two).
  34.  
  35. Usage
  36. ~~~~~
  37. Double-click the !VMEctrl icon in a filer window to run the application ... oh,
  38. you know how it works, skip the waffle ... Clicking on the iconbar icon with
  39. select will open the main window. Adjust will give you a little bit of info on
  40. how to contact me (to say hello, bug reports... etc) and Menu will give a very
  41. exiting [oops, I mean exciting... I hope] menu. Very.
  42.  
  43. The main window
  44. ~~~~~~~~~~~~~~~
  45. This window has two main sections, 'Configuration' and 'Current'. Suprisingly,
  46. the 'current' section refers to the current screen mode. See, it even says what
  47. mode that happens to be! Beneath the tantalising mode number there are two
  48. 'option' icons, 'enabled' & 'configured'. These refer (respectively) to whether
  49. the VME is currently enabled, and whether it is configured to be enabled for
  50. this mode ['enabled' will only ever be different to 'configured' is you've
  51. deliberately en/disabled the VME since the last mode change]. You can click on
  52. these icons to turn the VME on/off, or set the configuration status for the
  53. current mode. [note, unlike the '*mode <n> On|Off' command provided by the
  54. VMEcontrol module for configuration, changing the configuration for the current
  55. mode will have *no* immediate effect (the VME's state will only be affected on
  56. the next mode change)]
  57.  
  58. The 'configuration' section allows you to set the configure the VMEcontrol
  59. module for any screen mode, not just the current one. Use the arrow up/down
  60. icons to move through the *possible* modes [NB: possible is extremely unlikely
  61. to be the same as *available*, just because there are 127 screen modes
  62. *possible* doesn't mean that they exist]. You can also type a mode number into
  63. the mode number writable icon [press Return after entering the number]. No mode
  64. changes take place.
  65. Below the 'mode selection' icons is a single 'option' icon that allows you to
  66. see/set the VME configuration for the displayed screen mode.
  67. Below the 'enabled' option icon is a 'pop-up menu' icon that will open the
  68. 'save' box should you click on it. The save box is also available from the menu.
  69.  
  70. Saving Files/Modules
  71. ~~~~~~~~~~~~~~~~~~~~
  72. The save box can be accessed from the menu (off the Save=> entry), or by
  73. clicking on the 'save config' popup icon in the main window.
  74. The save box contains the normal icons, plus a 'module' option icon. This
  75. allows you to specify whether you want !VMEctrl to save a configuration file
  76. (just the save as *SaveMap does), or generate a module that has your
  77. configuartion built in. Use of the save box shouldn't really need to be
  78. explained, so...
  79.  
  80. Notes
  81. ~~~~~
  82. Once the application has been 'seen' by the filer (or Filer_Boot'ed), double
  83. clicking on a 'VMEmap' (configuration file) will, assuming that the VMEcontrol
  84. module is loaded, load that file (using *loadmap) whether !VMEctrl is running
  85. or not.
  86.  
  87. The !VMEctrl application is a very simple front-end for the VMEcontrol module.
  88. It doesn't provide any extra features (well, it does... the creation of a new
  89. module is an 'extra feature' I suppose) and simply acts as a GUI to the SWIs
  90. (or *commands) that control the module. There are only two reasons why !VMEctrl
  91. should even exist: (1) To generate 'preconfigured' modules, and (2) because
  92. some of you (you know who you are) don't like command line stuff. Of course,
  93. you could configure the module from the CLI, and then use !VMEctrl to save your
  94. custom module...
  95.  
  96. The source code for the module is provided in the 'Source' directory inside he
  97. application. Also, the uncrunched !RunImage is there.
  98.  
  99.  
  100. Disclaimer
  101. ~~~~~~~~~~
  102. Use of this software is completely at your own risk. The author can accept no
  103. responsibility for any damage/loss arising from the use, or inability to use
  104. this software. No warranty, express or implied, applies to this software.
  105. This is not PD: the Copyright in this software belongs at all times to the
  106. author. However, permission is granted for unrestricted distribution
  107. prodividing that *no* charge is made for the distribution [a charge may be made
  108. for handling/media] and that the whole of the software is supplied intact and
  109. unaltered. Permission is also granted for unrestricted use and alteration of
  110. the software [but if you fix a bug / add anything nice, let me know so I can
  111. patch the 'master' version].
  112.  
  113. Bug reports / comments / etc to:
  114. Angelos tou Thanatou c/o 23 Baronsway, Whitkirk, Leeds, LS15 7AW, England.
  115. (until Sept-ish '95: n0ae2@newton.ncl.ac.uk, voice 0191 2301292)
  116.