home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / cpm / tdossigi / fkey.dqc / FKEY.DOC
Encoding:
Text File  |  1986-07-05  |  2.5 KB  |  73 lines
  1. FKEY version 1.00
  2. A creation of ESKAY Software (S. Kluger)
  3. No Lefts Reversed
  4.  
  5. FKEY.REL and FKEY.O are modules designed to provide function keys under
  6. TurboDOS.  FKEY.REL can hold a total of 255 bytes, which should
  7. be sufficient for most applications. FKEY.O, the 16 bit version, can
  8. hold 4095 bytes.
  9.  
  10. INSTALLATION
  11. ============
  12.  
  13. To install FKEY on your TurboDOS system, you are must have source to your
  14. console driver (usually named CON96, entry point CONDR@).  Follow this
  15. procedure for installation:
  16.  
  17. 1. Add the FKEY symbol to your GEN file.
  18. 2. Set up the function keys in your PAR file.  The following is a sample
  19.    8-bit PAR file (details omitted):
  20.  
  21.    LEADIN = "^A"    ; leadin character (never gets printed!)
  22.    FKEYS  = "1DIR",0D,0    ; ^A1 = DIR
  23.             "2WHO",0D,0 ; ^A2 = WHO
  24.         "QLOGOFF",0D,0 ; ^AQ = LOGOFF
  25.             0FF        ; endmark
  26.    ; (you get the picture...)
  27.    NOTE:
  28.     It is your responsibility to not exceed 255 bytes!  There are
  29.     two overhead bytes associated with each key, the key designator
  30.     and the endmark.  If the total number of bytes defined at FKEYS
  31.     is >255, the results are disasterous and may cause your system to
  32.     not boot!
  33.     The endmark (0FFH) MUST be present in the 16-bit version!!
  34.     To DISABLE the fkeys, store a 0 at FKEY (PAR FILE: FKEY = 00)
  35.  
  36. 3. Alter your CON96 file as shown below (detail omitted):
  37.  
  38. CONDR@::LD    HL,INITC        ; get initialization complete flag
  39.     LD    A,(HL)
  40.     OR    A                 ; initialization complete flag set ?
  41.     CALL    Z,CONINIT             ; no...initialize console channel
  42. ;
  43.     LD    A,E                 ; get function number
  44.     cp    1
  45.     jr    z,cinhdl
  46.     :
  47.     :
  48.  
  49. cinhdl:    call    getfk##
  50.     call    serial##
  51.     jp    fkey##
  52.  
  53.    If installing the 16-bit version, alter CON96.A in the same fashion.
  54.  
  55. 4. Re-GEN the modified SYS files reset and use the f-keys.
  56.  
  57. NOTE (again):
  58.     Whatever character you set up to be the lead-in character will
  59.     NOT be returned by the console driver!  If you do not use leadin
  60.     as one of the f-key designators, you may hit the leadin char twice
  61.     to send it.
  62.  
  63. LEGAL STUFF:
  64. FKEY.REL and FKEY.O are in the Public Domain and may be freely distributed,
  65. whether for profit or not.  The author does not make any claim as to fitness
  66. for any purpose etc and must not be held liable for any damages arising from
  67. the use, abuse or inability to use FKEY.
  68. BUGS or PRAISE should be forwarded to SENECA RTDS (214) 553-1363 (1200 baud)
  69. in a public or private message to SYSOP.
  70. 
  71.     LD    A,(HL)
  72.     OR    A                 ; initialization complete flag set ?
  73.     CALL    Z,CONINIT             ; no...initialize