home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / BEEHIVE / UTILITYS / 256FIX.ARC / 256FIX.DOC < prev   
Text File  |  1988-08-07  |  7KB  |  112 lines
  1. Documentation for:  256TC Keyboard Driver creator (256FIX.COM)
  2.                     written by Andrew Scott,  copyright Adrenalin
  3.                     Software 1990.
  4. --------------------------------------------------( Version 1.0 )
  5.  
  6.      The keyboard designed for the microbee 256TC computer places 
  7. its  users in an annoying position:  sometimes they can't use it! 
  8. The  keyboard uses a different method of key  identification  and 
  9. can  be  read  using a completely different method from  the  one 
  10. customly  used on the old microbee  keyboard.  These  differences 
  11. sometimes  put the computer in a loop,  trying to check for a key 
  12. that will never be pressed.
  13.      This  problem  will never arrive if system  calls  are  used 
  14. instead of the key-pressed routines employed by some programmers, 
  15. but these calls take longer and therefore are not so appealing to 
  16. games  programmers.  These  games were barred from use  by  256TC 
  17. users - which is an otherwise good computer. To fix this problem, 
  18. 256FIX  has been written to read in a program,  find  key-pressed 
  19. checks, substitute ones more suited to the 256TC, then output the 
  20. reborn program into another file.
  21.  
  22.      256FIX itself is very easy to use,  simply enter "256FIX" as 
  23. usual  to run a program.  A screen will be shown displaying  some 
  24. information about your computer and 256FIX itself.  Next you will 
  25. be  asked what sort of driver you wish to replace the faulty  one 
  26. with.
  27.      You  can  press "1" and select the XBIOS subset  C  routine, 
  28. which is a system call,  and might not work with some systems, if 
  29. it doesn't work with your system, then you will have been told in 
  30. the first screen.  Pressing "2" selects a code appendage routine. 
  31. This  involves adding about 300 bytes onto the end of a  program, 
  32. and the faulty routine is changed to a call to this routine. This 
  33. driver is faster than the XBIOS driver,  but if the program  uses 
  34. relocating  code  then "2" won't work,  and if you don't  have  a 
  35. 256TC  keyboard,  it is not likely to work anyway - but what  are 
  36. you doing using this program?
  37.  
  38.      Now  you  are  asked for the faulty  file.  You  must  enter 
  39. filename and extension followed by return.  You are then told the 
  40. file the results of 256FIX will be sent to (the output file).  Do 
  41. not  delete  the original file after 256FIX  has  finished  - the 
  42. output file may not work, and you will need to try another set of 
  43. options (see below) until it does work.
  44.      If  you enter the name of a file that does NOT  exist,  then 
  45. you will be told, and prompted for another name.
  46.  
  47.      From  now  on  256FIX will be  analysing  your  program  and 
  48. creating the output file. As soon as a code segment is found that 
  49. looks  like  a  key-press  check,  it will stop  and  see  if  it 
  50. recognises it. If it doesn't then the message:
  51.           This procedure seems to be non-standard!
  52.           Do you wish to continue? (Y/N): N
  53. will appear. If you want to continue to process this code segment 
  54. then  press  "Y" press anything else and it won't.  Most  of  the 
  55. time,  256FIX  will  recognise the code and you won't need to  do 
  56. this.  If  this  message does come up however,  try  "Y"  and  if 
  57. nothing  comes  of it,  try "N" later.  If you do press  "Y"  and 
  58. 256FIX can't do anything with the code segment, then the message:
  59.           ** Can't process routine, passing **
  60. will appear, 256FIX is passing the routine without processing it.
  61.      Most  of the time,  256FIX will recognise the code  segment, 
  62. and you will have the following presented to you:
  63.           === Set Options for Driver === Length: xxx bytes
  64.           Do you wish to Reverse Zero Flags?          (Y= +7) Y
  65.           Do you wish to use HL as key register?      (Y=+20) Y
  66.           Do you wish to clear buffer after keypress? (Y=+12) N
  67. The length "xxx" will be a number around 20-60,  this is the size 
  68. of  the space 256FIX has to work with.  The options are  features 
  69. that  the replacement code will have,  if the code is  "standard" 
  70. 256FIX will suggest answers to the questions (Y or N).  Sometimes 
  71. 256FIX  does  not  give  correct  suggestions  and  some  of  the 
  72. questions must be answered "N" instead of "Y" or vica versa.  The 
  73. most  likely one to be wrong is the second question,  followed by 
  74. the first. The last question should never need to be answered "Y" 
  75. unless the program being altered reads the keyboard buffer  after 
  76. its  key-press check (the 256TC has a 8 character keyboard buffer 
  77. unlike the old keyboards).  If the output program does not  work, 
  78. try using different options.
  79.      After all of the program is analysed, 256FIX may decide that 
  80. the program should work regardless. In this case the message:
  81.           Program does not need altering.
  82. will  be  shown  upon the finish of the  analysis.  If  any  non-
  83. standard  procedures  are found,  and to these the answer "N"  is 
  84. given  or it is not able to process it anyway,  and Driver  2  is 
  85. selected (appended code), no code will be appended.
  86.  
  87.      After all this,  you should find an extra file on your disk, 
  88. after  write-protecting your disk (better safe than sorry) try it 
  89. out.  If it doesn't work,  try another option, or another driver. 
  90. Here are some suggestions for cracking that elusive program.
  91.      1)  If the program runs for awhile,  the suddenly  hangs  or 
  92. quits,  or generally blows a tantram, you could have selected the 
  93. wrong driver.
  94.      2) If the program runs,  but things happen, like the program 
  95. reacts  as  if you've pressed down keys,  then try  changing  the 
  96. "Reverse Zero Flags" option.
  97.      3)  If the program reacts as if it doesn't know you're there 
  98. (like  it did in the first place) then either the "clear  buffer" 
  99. or  "use HL" options could be wrong - if you said "N"  to  "clear 
  100. buffer"  then  it  is  probably "use HL".  If  the  code  segment 
  101. "Length"  is  more  than 45,  then "use HL"  should  probably  be 
  102. answered "N".
  103.      4)  If the program runs ok,  but sometimes reacts as if  you 
  104. have  pressed many keys (the ones you had pressed previously)  at 
  105. one time, the maybe "clear buffer" should be answered "Y".
  106.  
  107.      I  take no responsibility for damage 256FIX  causes,  but  I 
  108. would  be VERY surprised if it did.  This is a program that every 
  109. 256TC owner should have,  it opens a whole new range of programs, 
  110. eg. Grotnik Software, Mytek, etc. Good luck with yours.
  111. 
  112. 256TC owner should have,  it opens a whole new range of progra