home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / sigm / sigmv044.ark / CPM2HELI.DOC < prev    next >
Encoding:
Text File  |  1984-04-29  |  3.7 KB  |  93 lines
  1.               CPM2HELI.DOC
  2.                      by
  3.             Jim Blackwood
  4. ***************************************************************
  5.  
  6. THE PROGRAMS CPM2HELI.OBJ AND HELI2CPM.OBJ CONVERT CPM TEXT
  7. FILES TO PROCESSOR TECH HELIOS II EDIT FILES, AND VICE-VERSA.
  8. TO CONVERT A CP/M FILE, LINEFEEDS, HTABS, AND CTRL/Z'S ARE
  9. REMOVED. IF THERE ARE 64 CHARACTERS WITHOUT A CR, ONE IS
  10. INSERTED. THIS MAKES EDIT DELIRIOUS WITH JOY. THE OTHER WAY,
  11. LINEFEEDS ARE ADDED AFTER EACH CR, AND CTRL/Z IS ADDED AT
  12. THE END. THE SOURCE VERSIONS ARE CPM2HELI.S AND HELI2CPM.S.
  13. THE PROGRAMS WILL NOT RUN, AND THE SOURCE WILL NOT ASSEMBLE
  14. UNDER CP/M. YOU NEED PTDOS1.4 OR 1.5. THE PROGRAMS READ BLOCKS
  15. OF THE INPUT FILE INTO A BUFFER. THE OFFENDING CHARACTERS
  16. ARE REMOVED (OR ADDED) AND THE MODIFIED FILE IS WRITTEN TO
  17. THE DISK. EDIT IS A SCREEN EDITOR, AND I'M MUCH MORE
  18. COMFORTABLE WITH IT THAN I AM WITH ED. THESE PROGRAMS LET
  19. ME ADAPT BASIC PROGRAMS, ASSEMBLY LANGUAGE PROGRAMS, ETC.
  20. FROM THE SIG/M LIBRARY TO MY OWN ENVIRONMENT. I SUSPECT THERE
  21. ARE VERY FEW FOLKS OUT THERE WHO CAN USE THIS STUFF, BUT
  22. IF YOU HAVE CP/M-LIFEBOAT-HELIOS, YOU MIGHT ENJOY IT. I
  23. GUESS I'M SUPPOSED TO MENTION THAT CP/M IS A PRODUCT OF
  24. DIGITAL RESEARCH AND THAT LIFEBOAT IS LIFEBOAT ASSOC.
  25. IF YOU HAVE QUESTIONS, FIND BUGS, ETC., YOU CAN GET ME AT
  26. 201-233-1285. OH YES, YOU MUST SET BU=8000 (OR LOWER)
  27. OR YOU WILL GET A LOADER ERROR, & THINGS MAY BLOW UP.
  28.  
  29. THE OBJECT PROGRAMS ARE ASSEMBLED AT 103H. THE FIRST TIME,
  30. PUT THE OBJECT CODE INTO AN IMAGE FILE. YOU CAN THEN
  31. PROCESS THE SOURCE FILES, AND ASSEMBLE THEM WHEREVER YOU
  32. WISH. USING DDT, PUT THE FILE INTO MEMORY STARTING AT 400H
  33. IN THE FOLLOWING MANNER. BE SURE THAT YOUR BOOTLOAD IS
  34. NOT ANYWHERE IN LOW MEMORY. I PUT MINE AT 0C900H. YOU HAVE
  35. TO PUT THE PROGRAMS AT 400H BECAUSE START.UP USES SOME
  36. LOW MEMORY.
  37.              DDT
  38.              -ICPM2HELI.OBJ
  39.              -R300
  40.  
  41. NOW, BOOT UP HELIOS, AND ENTER:
  42.              IMAGE CPM2H:O,!250,403,64E,:103,103
  43.  
  44. YOU CAN, OF COURSE, USE ANY NAME YOU WANT. TYPE THE
  45. NAME OF THE FILE, AND YOU ARE IN BUSINESS. THE PROGRAM
  46. WILL PROMPT FOR THE INPUT AND OUTPUT FILE NAMES.
  47. IF YOU WANT TO TRANSFER THE HELI2CPM.OBJ FILE, FOLLOW
  48. THE SAME PROCEDURE, EXCEPT THAT THE IMAGE COMMAND IS:
  49.           IMAGE H2CPM:O,!4C0,403,62B,:103,103
  50.  
  51. TO TRANSFER FILES FROM CP/M TO HELIOS:
  52.   WHILE IN CP/M
  53.                DDT
  54.                -I(FNAME)
  55.                -R300
  56.   DDT WILL RESPOND WITH THE LAST LOAD ADDRESS, SAY XXXX
  57.   BOOT UP HELIOS AND ENTER:
  58.           WRITE FNAME,!4C0,400,XXXX
  59.   YOU MAY USE ANY BLOCK SIZE YOU WISH, I PICKED 04C0H.
  60.   IF THE FILE WON'T FIT INTO MEMORY, YOU WILL HAVE TO
  61.   BREAK IT INTO SMALLER FILES. BECAUSE DDT GIVES THE
  62.   LAST PAGE OF MEMORY LOADED, THERE MAY BE GARBAGE
  63.   AT THE END OF THE FILE, BUT PROCESSING THE FILE
  64.   SHOULD REMOVE THIS.
  65.  
  66. TO TRANSFER TEXT FILES FROM HELIOS TO CP/M
  67.   WHILE IN HELIOS
  68.            READ FNAME,103
  69.   THEN BOOT UP CP/M
  70.            SAVE (PAGES) FNAME
  71.   READ WILL GIVE YOU THE NUMBER OF BYTES IN THE FILE
  72.   REMEMBER TO CONVERT HEX BYTES TO DECIMAL PAGES
  73.   NOW DO THE FOLLOWING, WHILE IN CP/M
  74.     ED FNAME
  75.     *A
  76.     *3D
  77.     *E
  78.   NOW YOU CAN TYPE IT, EDIT IT, ASSEMBLE IT, ETC.
  79.  
  80. TO TRANSFER HEX FILES FROM HELIOS TO CP/M
  81.   WHILE IN HELIOS, TYPE THE FILE NAME OF THE IMAGE
  82.   FILE FOLLOWED BY A COMMA. READ WON'T WORK HERE.
  83.   THE IMAGE FILE SHOULD ORG AT 103. CAN'T IMAGINE
  84.   ANYONE WANTING TO DO THIS, AS THESE PROGRAMS WON'T
  85.   RUN UNDER CP/M. HOWEVER IT IS A WAY OF EXCHANGING
  86.   IMAGE FILES UNDER CP/M. IF YOU HAVE PREVIOUSLY
  87.   LISTED THE FILE, YOU WILL KNOW HOW MANY PAGES TO SAVE.
  88.   AT ANY RATE, ONCE YOU HAVE LOADED THE IMAGE FILE AT
  89.   103H, BOOT UP CP/M AND SAVE THE FILE. TO TRANSFER IT BACK
  90.   TO HELIOS, SEE ABOVE.
  91.   CHEERS.
  92.  
  93.