From 0e766f59c72fb895992266d6a610d44cd57696e6 Mon Sep 17 00:00:00 2001 From: Christopher Shepherd Date: Fri, 27 May 2016 17:56:17 -0400 Subject: [PATCH] readme update --- README.md | 138 ++++++++++++++++++++++++++++++++++++++++-------------- 1 file changed, 102 insertions(+), 36 deletions(-) diff --git a/README.md b/README.md index 9a48a49..6eeae95 100644 --- a/README.md +++ b/README.md @@ -5,44 +5,110 @@ yagsdisasm is written in PHP, which may be an unfortunate choice of languages to the disassembly engine is largely inspired by Andy McFadden's Ciderpress disassembly engine, which is why we copy his license terms in LICENSE.txt -as of 5/25/2016, the project is only a couple hours old and is a proof of concept. future revisions to come later +as of 5/27/2016, the project is gaining features such as processor flag tracking and more vector recognition, but still has a ways to go ### Example Run: - $ php yagsdisasm.php -x 0 -m 0 -e 0 -f /Applications/Emulation/Apple\ IIGS/images/WhatIs/Alien\ Mind/Alien\ Mind\ Dk1.2mg -s 1 -n 1 -k 1 -o 801| more + $ php yagsdisasm.php -f ~/Downloads/GATE/The\ Gate\ Dk1.2mg -s0 -n1 -k1 -m1 -x1 -e1 -o801 | more ORG 000801 - MX %00 + MX %11 - 000801- 0A ASL - 000802- A9 10 00 LDA #0010 - 000805- 8D 9F 0A STA 0A9F - 000808- A9 00 01 LDA #0100 - 00080B- 8D A1 0A STA 0AA1 - 00080E- 60 RTS - 00080F- 20 62 09 JSR 0962 - 000812- F4 00 00 PEA 0000 - 000815- F4 07 00 PEA 0007 - 000818- F4 00 20 PEA 2000 - 00081B- F4 00 40 PEA 4000 - 00081E- F4 00 00 PEA 0000 - 000821- F4 36 0A PEA 0A36 - 000824- F4 00 00 PEA 0000 - 000827- F4 3A 0A PEA 0A3A - 00082A- A2 03 27 LDX #2703 - 00082D- 22 00 00 E1 JSL E10000 ; Toolbox: UnPackBytes(@Buff,BfSz,@StartPtr,@Sz):Size - 000831- 68 PLA - 000832- 8D 00 03 STA 0300 - 000835- 60 RTS - 000836- 00 20 BRK 20 - 000838- E1 00 SBC (00,X) - 00083A- 00 80 BRK 80 - 00083C- 20 67 09 JSR 0967 - 00083F- 2C 10 C0 BIT C010 ; r:KBDSTRB - 000842- AD 00 C0 LDA C000 ; r:KBD w:CLR80COL - 000845- 30 13 BMI 085A {+13} - 000847- AD 61 C0 LDA C061 ; r:BUTN0 - 00084A- 30 0E BMI 085A {+0E} - 00084C- AD 62 C0 LDA C062 ; r:BUTN1 - 00084F- 30 09 BMI 085A {+09} - 000851- AD 27 C0 LDA C027 ; rw:KMSTATUS - 000854- 89 80 D0 BIT #D080 + 000801- EE F4 03 INC 03F4 + 000804- 9C 34 C0 STZ C034 ; rw:CLOCKCTL [+border color] + 000807- 9C 22 C0 STZ C022 ; rw:TBCOLOR + 00080A- EA NOP + 00080B- EA NOP + 00080C- EA NOP + 00080D- EA NOP + 00080E- AD 10 C0 LDA C010 ; r:KBDSTRB + 000811- 8D 00 C0 STA C000 ; r:KBD w:CLR80COL + 000814- 8D 0C C0 STA C00C ; w:CLR80VID + 000817- 9C 12 0E STZ 0E12 + 00081A- AF 20 0F E1 LDA E10F20 + 00081E- 8D 10 0E STA 0E10 + 000821- AF 21 0F E1 LDA E10F21 + 000825- F0 07 BEQ 082E {+07} + 000827- 4F 20 0F E1 EOR E10F20 + 00082B- 8D 12 0E STA 0E12 + 00082E- 18 CLC + 00082F- FB XCE + 000830- C2 30 REP #30 + 000832- A9 80 FE LDA #FE80 + 000835- 8F 70 00 E1 STA E10070 ; Break vector + 000839- A2 00 00 LDX #0000 + 00083C- A9 A0 A0 LDA #A0A0 + 00083F- 9D 00 04 STA 0400,X + 000842- E8 INX + 000843- E8 INX + 000844- E0 00 04 CPX #0400 + 000847- 90 F3 BCC 083C {-0D} + 000849- A2 00 A0 LDX #A000 + 00084C- CA DEX + 00084D- CA DEX + 00084E- 9E 00 20 STZ 2000,X + 000851- D0 F9 BNE 084C {-07} + 000853- E2 30 SEP #30 + 000855- A9 00 LDA #00 + 000857- 8D 22 C0 STA C022 ; rw:TBCOLOR + 00085A- A9 00 LDA #00 + 00085C- 8D 34 C0 STA C034 ; rw:CLOCKCTL [+border color] + 00085F- C2 30 REP #30 + 000861- A2 00 00 LDX #0000 + 000864- A9 00 00 LDA #0000 + 000867- 9F 00 7E E1 STA E17E00,X + 00086B- E8 INX + 00086C- E8 INX + 00086D- E0 00 01 CPX #0100 + 000870- D0 F5 BNE 0867 {-0B} + 000872- E2 30 SEP #30 + 000874- 20 80 09 JSR 0980 + 000877- A9 14 LDA #14 + 000879- 8D 78 09 STA 0978 + 00087C- 9C 79 09 STZ 0979 + 00087F- E2 30 SEP #30 + 000881- 38 SEC + 000882- FB XCE + 000883- 20 0D C5 JSR C50D ; SmartPort Entry + 000886- 41 DB 41 ; Call Number + 000887- 6E 09 DW 096E ; Pointer to parameters + 000889- 00 BRK + 00088A- 00 BRK + 00088B- B0 F6 BCS 0883 {-0A} + 00088D- 18 CLC + 00088E- FB XCE + 00088F- C2 30 REP #30 + 000891- EE 71 09 INC 0971 + 000894- EE 71 09 INC 0971 + 000897- EE 74 09 INC 0974 + 00089A- CE 78 09 DEC 0978 + 00089D- D0 E0 BNE 087F {-20} + 00089F- 8B PHB + 0008A0- F4 00 00 PEA 0000 + 0008A3- F4 01 00 PEA 0001 + 0008A6- F4 00 0A PEA 0A00 + 0008A9- F4 10 00 PEA 0010 + 0008AC- F4 1E 00 PEA 001E + 0008AF- 22 00 A5 00 JSL 00A500 + 0008B3- 22 00 0A 01 JSL 010A00 + 0008B7- 18 CLC + 0008B8- FB XCE + 0008B9- C2 30 REP #30 + 0008BB- 8B PHB + 0008BC- F4 00 00 PEA 0000 + 0008BF- F4 01 00 PEA 0001 + 0008C2- F4 00 9E PEA 9E00 + 0008C5- F4 01 00 PEA 0001 + 0008C8- F4 41 00 PEA 0041 + 0008CB- 22 00 96 00 JSL 009600 + 0008CF- 8B PHB + 0008D0- F4 01 00 PEA 0001 + 0008D3- F4 07 00 PEA 0007 + 0008D6- F4 00 20 PEA 2000 + 0008D9- F4 12 00 PEA 0012 + 0008DC- F4 2E 00 PEA 002E + 0008DF- 22 00 96 00 JSL 009600 + 0008E3- A9 20 20 LDA #2020 + 0008E6- A0 10 00 LDY #0010 + 0008E9- A2 00 00 LDX #0000 + 0008EC- 9F 00 9D E1 STA E19D00,X +