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 / KAYPRO / ADVENT2.ARK / -READ.ME next >
Text File  |  1986-09-20  |  6KB  |  157 lines
  1.            MODIFICATION NOTES FOR THE TurboROM SYSTEM
  2.  
  3.                              6/17/86
  4.  
  5.  
  6. This disk is provided as a service to those who wish to modify or 
  7. experiment with the TurboROM RAM resident system. Additonal disks 
  8. and  information  is available from  Advent  Products,  Inc.  and 
  9. Plu*Perfect  Systems with regards to patches and improvements for 
  10. application programs and extensions to the TurboROM.
  11.  
  12. 1.   Basic I/O System  BIOS
  13.  
  14. The   source  code  to  the high  memory  BIOS,  TURBO-BS.ASM  is 
  15. provided  as   standard   on the support disk  shipped  with  the 
  16. TurboROM.  This disk contains  the  compiled listing which  shows 
  17. the relative addresses  of  the  various parts. 
  18.  
  19. This  code  has been assembled with the CDL Macro  III  assembler  
  20. which  is  not  commonly  available.  The  reason  we  use   this  
  21. assembler   is   that  it is the only product  that   meets   our  
  22. requirements for sparse (i.e. patchable) relocatable code with an  
  23. arbitrary  number  of  relocation  bases.    This  assembler  was  
  24. originally  available  from  Technical Design Labs in the  middle  
  25. seventies.    Its   ownership  then  passed  to  Xitan  and  then 
  26. reverted  to CDL  who  were  recently  purchased by  Rising  Star 
  27. Industries   (of  VALDOCS  fame).    Currently,   RSI  is selling 
  28. the assembler,   linker  and  debuggers for $70.   The package is 
  29. called "RSI Assembly Language  Programming Tools/ TPM III  User's 
  30. Guide."   Their  address is 25500  Hawthorne Blvd.,  Suite  2000, 
  31. Torrance  CA  90505.    Phone  (213)  373- 9112.   An  equivalent 
  32. assembler is also available from Phoenix who  was also originally 
  33. also connected with TDL.     
  34.  
  35. If you have access to a CDL type assembler and want to modify the  
  36. BIOS   you  may chose to re-write the BIOS or you may wish to  do  
  37. your  additions  as  a  relocatable  patch (with  origin  at  the  
  38. label LDPARM in the current bios.).  If you use the .phex and the 
  39. .xlink  pseudo  ops this will produce a REL  file  that   can  be 
  40. merged  with  the current TURBO-BS.REL using any   text   editor.  
  41. Just  make  sure there is only one EOF record.  Then on  a  stock 
  42. Kaypro  system  re-run  the MAKTURBO  utility  using  your  newly 
  43. modifed  TURBO-BS.REL  file.  Run MOVTURBO to build an  operating 
  44. system  of  desired  size  and then use  TURBOGEN  to  write  the 
  45. operating system on the system tracks of your boot disk.
  46.  
  47. Note  if  you are patching  the  BIOS  that  all  the  cold  boot 
  48. initialization  code   is   placed  in  front   of   the  command 
  49. processor  where it is abandoned to give  a  larger TPA.    There 
  50. is  almost  a whole sector free for   additional   initialization 
  51. code in this area.  Almost 4 full sectors are also  available  at  
  52. the  end of the BIOS,   but take care to  avoid  the  first   42H  
  53. bytes which a are reserved for scratch space  by  the  BIOS.  
  54.  
  55.  
  56. 2.   Console Command Processor CCP
  57.  
  58.  
  59. The  most common request we get is for the ability  to  integrate  
  60. ZCPR3  into  the system.   Echelon, Inc. offers versions of ZCPR3 
  61. that  can  be  used with the TurboROM,  and most  of  the  Kaypro 
  62. bulletin  board  systems  offer ZCPR3 for  the  TurboROM  online. 
  63.  
  64. Echelon's address:
  65.  
  66.      Echelon, Inc.
  67.      101 First Street, Suite 427
  68.      Los Altos, CA 94022
  69.      (415) 948-3820
  70.      
  71. The  command processor can  be  overlayed with a new one as  long 
  72. as the 2K limit is not exceeded.   However,   a  better  solution  
  73. is   to   re-assemble   the   command   processor   with  Digital 
  74. Research's  RMAC and then use  LINK-80  to  produce  a   new  PRL 
  75. file  that can be integrated in a  relocatable  manner  with  the 
  76. TurboROM system (by re-running the MAKTURBO  utility).    On this 
  77. disk  there  is  the  source  code to ZCPR1 that is used in  this 
  78. manner.   To produce a  suitable PRL file from this:-  
  79.  
  80.  
  81. RMAC ZCPR        ;;assemble and produce microsoft type REL
  82. LINK ZCPR[OP,L0200]    ;;link REL file and output PRL with load
  83.             ;;address of 0200 H
  84.  
  85. Then  on a stock Kaypro system re-run the MAKTURBO utility  using 
  86. your  newly  linked  ZCPR.PRL  file.  Run MOVTURBO  to  build  an 
  87. operating  system of desired size and then use TURBOGEN to  write 
  88. the operating system on the system tracks of your boot disk.
  89.  
  90.  
  91. 3. Files on the Developer's Disk
  92.  
  93.  
  94. -READ   .ME  
  95.  
  96.      This documentation file.
  97.  
  98. HARDNOTE.TXT 
  99.  
  100.      Notes  by Derek McKay at Plu*Perfect systems on the care and 
  101.      feeding of hard disk drives for use with the TurboROM.
  102.  
  103.  
  104. NOBLANK .ASM 
  105.  
  106.      8080 assembly language source for NOBLANK.COM.
  107.  
  108. NOBLANK .COM 
  109.  
  110.      Executable  program to inhibit video screen blanking on  the 
  111.      84 and Kaypro 10 versions of the TurboROM. This program sets 
  112.      a flag in high memory to a non-zero value. This program does 
  113.      not  verify that the TurboROM is present nor does  it  check 
  114.      that  the machine is '84 type Kaypro (translation:  use this 
  115.      program ONLY on an '84 or Kaypro 10  with the TurboROM). 
  116.  
  117. ROM     .DOC 
  118.  
  119.      Documentation  on the internal structure and workings of the 
  120.      TurboROM.   These  notes  were  used  while  developing  the 
  121.      TurboROM.  These  may be of use to those who wish  to  write 
  122.      programs  to take advantage of the TurboROM features.   Some 
  123.      of this material is duplicated in the TurboROM manual. 
  124.  
  125. STATLN  .C   
  126.  
  127.      "C"  source for a program to enable/disable the 25th line on 
  128.      '84 and Kaypro 10 computers with the TurboROM.
  129.  
  130. STATLN  .COM 
  131.  
  132.      Executable  program to enable/disable the 25th line  on  '84 
  133.      and Kaypro 10 computers with the TurboROM.
  134.  
  135. TURBO-BS.PRN 
  136.  
  137.      Print file of assembled BIOS used by the TurboROM.
  138.  
  139. TURBOSAF.ASM 
  140.      
  141.      Assembly  language  "source" for the  TURBOSAF.COM  program.  
  142.      Notes  are  included  in  the source on  how  to  patch  the 
  143.      executable version (TURBOSAF.COM).
  144.  
  145. TURBOSAF.COM 
  146.  
  147.      Executable  program  used to "park" the heads on  hard  disk 
  148.      drives.   This  program must be "patched" with the  cylinder 
  149.      number  that  the heads are to  be  positioned  over.   This 
  150.      program  supports two hard disk drives connected to the  WD-
  151.      1002 hard disk controller.
  152.  
  153. ZCPR    .ASM
  154.  
  155.      Assembly  language source for the version of ZCPR1  used  by 
  156.      the TurboROM.
  157.