home *** CD-ROM | disk | FTP | other *** search
/ Go64! / Go64_2000-01_2000_CSW_Side_A.d64 / jammon.docs < prev    next >
Encoding:
Text File  |  2004-01-01  |  4.5 KB  |  159 lines
  1. qUICK DOCS FOR jAMAICAmon slj 1/31/97 SJUDD@FFD2.COM
  2. -------------------------
  3.  
  4. lAST UPDATE: 1/20/00
  5.  
  6. VERSION 3.2:
  7.  
  8. V3.2 HAS, IN ADDITION TO SOME BUG FIXES, FULL-FEATURED
  9. SINGLE-STEPPING, I.E. IT FOLLOWS jmpS AND BRANCHES AND rts
  10. AND THINGS LIKE THAT.
  11.  
  12. V3.0 INCORPORATES pEEKpOKEpATCH, MAKING 24-BIT LOAD/SAVE
  13. POSSIBLE.   ppp ALSO ADDS HEX NUMBERS TO basic ALONG WITH
  14. 24-BIT ADDRESSES FOR peek, poke, sys, AND wait.  tHUS YOU CAN
  15. DO THINGS LIKE
  16.  
  17. sys $8000
  18. poke $123456,255
  19. load"blah",8,$020000
  20. save"data",12,$040000,$093800
  21.  
  22. FROM THE basic PROMPT.  fOR MORE INFO ON ppp, VISIT THE
  23. PAGE IN THE fRIDGE; NOTE THAT JAMMON V3.0 USES A SPECIAL
  24. VERSION OF ppp THAT CAN BE RELOCATED.
  25.  
  26.  
  27. fORMAT:
  28.  BYTE  TWO CHARACTERS -- USE 09 INSTEAD OF 9.  eXCEPTION IS
  29. LOAD AND SAVE, WHERE THE DEVICE NUMBER MAY BE 1 OR 2 CHARS
  30. (AND IS IN _DECIMAL_ I.E. NOT HEX).
  31.  
  32.  ADDR16 OR 24 BITS -- TWO OR THREE BYTES.
  33.  
  34. iF A 16-BIT ADDRESS IS USED, THE CURRENT VALUE OF pbr IS 
  35. PREPENDED TO FORM A 24-BIT ADDRESS (E.G. D C000 WILL DISASSEMBLE 
  36. AT $01c000 IF pbr=01).
  37.  
  38. nOTES:
  39. iF e=1 THEN x=m=1
  40.  
  41. rEQUIRES A sUPERcpu!
  42.  
  43. cOMMANDS
  44. --------
  45.  
  46. AA ADDR COMMAND
  47. aSSEMBLE.  nUMBERS/ADDRESSES ARE IN HEX AND PREFIXED BY A $.
  48. <!> ARE VALID IN ABSOLUTE ADDRESSING TO FORCE 8/16/24 BIT ADDRESSES.
  49. tHE FLAGS (SEE R) DETERMINE WHETHER IMMEDIATE MODE IS BE ASSEMBLED
  50. AS 8 OR 16 BITS.  !X AND !M MAY BE USED TO FLIP THE x AND m BITS
  51. DURING ASSEMBLY (!! WILL FLIP BOTH; NOTE THAT x=m=1 WHEN E=1).
  52.  
  53. DD ADDR
  54. dISASSEMBLE ONE SCREEN.
  55.  
  56. <-<-
  57. dISASSEMBLE ONE SCREEN BACKWARDS FROM CURRENT ADDRESS.
  58.  
  59. {$7b}LIRA{$7d}{$7b}LIRA{$7d}
  60. tOGGLE WHETHER DISASSEMBLER FOLLOWS rep AND sep.  nOTE THAT IF e=1
  61. THEN x=m=1 ALWAYS.  (i FELT THE LIRA KEY WAS GROWING LONELY FROM
  62. NEGLECT, SO HE GETS THE TOGGLE HONOR).
  63.  
  64. ,, ADDR BYTE1 [BYTE2 ...]
  65.  rE-DISASSEMBLE.  tHE BYTES FOLLOWING THE ADDRESS ARE READ IN AND 
  66. STORED, AND THE SCREEN IS RE-DISASSEMBLED.
  67.  
  68. PP ADDR1 ADDR2
  69. dISASSEMBLE RANGE.
  70.  
  71. ##NUMBER
  72. nUMBER CONVERSION.  aRGUMENT "NUMBER" MAY BE HEX ($), BINARY (%),
  73. DECIMAL (NO PREFIX), OR CHARACTER (').
  74.  
  75. R/ENO ARGS
  76. dISPLAY REGS/ALTERNATE REGS.  nOTE THAT VALUE OF FLAGS, pbr,
  77. AND $01 CAN ALTER CERTAIN COMMANDS: FLAGS DETERMINE 8/16 BIT
  78. #IMMEDIATE MODE ASSEMBLY AND DISASSEMBLY, pbr CHANGES DEFAULT
  79. ADDRESS LOCATIONS, AND $01 AFFECTS ANY MEMORY READ (DISASSEMBLY,
  80. MEMORY DISPLAY, ETC.)
  81.  
  82. MM [ADDR1 [ADDR2]]
  83. dISPLAY MEMORY.  iF A SECOND ADDRESS IS SPECIFIED, DISPLAY MEMORY
  84. RANGE.  iF NO ADDRESS IS SPECIFIED, THEN CONTINUOUSLY DISPLAY
  85. MEMORY FROM THE CURRENT ADDRESS.
  86.  
  87. II [ADDR1 [ADDR2]]
  88.  dISPLAY MEMORY+TEXT.  mEMORY CAN'T BE MODIFIED LIKE M COMMAND
  89. (NOT ENOUGH ROOM ON THE SCREEN LINE!).
  90.  
  91. I*I* [ADDR1 [ADDR2]]
  92. dISPLAY MEMORY AS SCREEN CODES.
  93.  
  94. HH ADDR1 ADDR2 BYTE1 [BYTE2 ...] OR H ADDR1 ADDR2 "STRING"
  95.  hUNT.
  96.  
  97. FF ADDR1 ADDR2 BYTE
  98.   fILL RANGE OF MEMORY WITH SPECIFIED BYTE.
  99.  
  100. TT ADDR1 ADDR2 DEST
  101. tRANSFER MEMORY.
  102.  
  103. NN ADDR1 ADDR2 ADDR3 DEST
  104. rELOCATE CODE.  ADDR1=START OF CODE, ADDR2=START OF VARIABLES,
  105. AND ADDR3=END OF VARIABLES.  tRANSFERS MEMORY AND UPDATES ADDRESSES
  106. BETWEEN ADDR1 AND ADDR2.  tHIS WAY, PROGRAMS (LIKE jAMAICAmon!) THAT 
  107. HAVE CODE FOLLOWED BY VARIABLES AND TABLES CAN BE RELOCATED IN ONE 
  108. SWELL FOOP (USE W TO GET JAMAICAMON ADDRESSES).  yEP, YOU'RE sol
  109. IF YOU JUST WANT TO RELOCATE A TABLE -- MAYBE A FUTURE UPDATE?
  110.  
  111. tO RELOCATE JAMMON, USE W, SET THE DEST ADDRESS, RELOCATE THE
  112. CODE, AND G DEST.
  113.  
  114. WNO ARGS
  115.  wHERE AM i?  pRINTS ADDRESSES OF JAMMON CODE, VARS, AND END.
  116.  
  117. ;^:VARIOUS
  118. aLTER REGS/ALTERNATE REGS/MEMORY (PRINTED BY R AND E)
  119.  
  120. LL "FILENAME",DEV[,ADDR]
  121. lOAD FILE (TO ADDR IF SPECIFIED), WHERE ADDR CAN BE 24-BITS.
  122.  
  123. SS "FILENAME",DEV,ADDR1,ADDR2
  124. sAVE FILE, ADDR1 AND 2 CAN BE UP TO 24-BITS.
  125.  
  126. @@ @$ @#DEV @COMMAND
  127. sEND DISK COMMAND.  @ READS THE ERROR CHANNEL.  @$ DISPLAYS THE
  128. DIRECTORY.  @#DEV CHANGES THE CURRENT DEVICE TO DEV.  @COMMAND
  129. SENDS "COMMAND" TO THE DRIVE.
  130.  
  131. BB ADDR
  132. sET BREAKPOINT.  tHE ADDRESS AND PREVIOUS CONTENTS ARE REMEMBERED;
  133. IF THE MONITOR IS THEN RE-ENTERED FROM THIS POINT, THE PREVIOUS
  134. CONTENTS ARE RESTORED.  oNLY ONE BREAKPOINT MAY BE SET AT A TIME.
  135.  
  136. GG [ADDR]
  137. rESTORE REGISTERS AND GO.  iF NO ADDRESS IS SPECIFIED, IT WILL GO TO pc.
  138.  
  139. ZZ [ADDR]
  140. zINGLE ZTEP.  zAME AZ GO, BUT ZETS A BREAKPOINT AT ZE NEXT INZTRUCTION.
  141. aLL COMMANDS EXCEPT jsr/jsl ARE FOLLOWED.  wHY NOT FOLLOW jsr?  bECAUSE
  142. CODE LIKE
  143.  
  144. lda data,x
  145. jsr ROUTINE
  146. dex
  147. bne *-9
  148.  
  149. WOULD BE EXTREMELY ANNOYING TO STEP THROUGH, ESPECIALLY IF "ROUTINE"
  150. IS IN THE KERNAL, OR CALLS A MILLION OTHER ROUTINES.
  151.  
  152. XNO ARGS
  153. eXIT TO BASIC.
  154.  
  155. ?NO ARGS
  156. lIST AVAILABLE COMMAND KEYS
  157.  
  158. tHIS PROGRAM IS IN THE PUBLIC DOMAIN.
  159.