readme update

This commit is contained in:
Christopher Shepherd 2016-05-27 17:56:17 -04:00
parent 4677f075ae
commit 0e766f59c7
1 changed files with 102 additions and 36 deletions

138
README.md
View File

@ -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 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: ### 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 ORG 000801
MX %00 MX %11
000801- 0A ASL 000801- EE F4 03 INC 03F4
000802- A9 10 00 LDA #0010 000804- 9C 34 C0 STZ C034 ; rw:CLOCKCTL [+border color]
000805- 8D 9F 0A STA 0A9F 000807- 9C 22 C0 STZ C022 ; rw:TBCOLOR
000808- A9 00 01 LDA #0100 00080A- EA NOP
00080B- 8D A1 0A STA 0AA1 00080B- EA NOP
00080E- 60 RTS 00080C- EA NOP
00080F- 20 62 09 JSR 0962 00080D- EA NOP
000812- F4 00 00 PEA 0000 00080E- AD 10 C0 LDA C010 ; r:KBDSTRB
000815- F4 07 00 PEA 0007 000811- 8D 00 C0 STA C000 ; r:KBD w:CLR80COL
000818- F4 00 20 PEA 2000 000814- 8D 0C C0 STA C00C ; w:CLR80VID
00081B- F4 00 40 PEA 4000 000817- 9C 12 0E STZ 0E12
00081E- F4 00 00 PEA 0000 00081A- AF 20 0F E1 LDA E10F20
000821- F4 36 0A PEA 0A36 00081E- 8D 10 0E STA 0E10
000824- F4 00 00 PEA 0000 000821- AF 21 0F E1 LDA E10F21
000827- F4 3A 0A PEA 0A3A 000825- F0 07 BEQ 082E {+07}
00082A- A2 03 27 LDX #2703 000827- 4F 20 0F E1 EOR E10F20
00082D- 22 00 00 E1 JSL E10000 ; Toolbox: UnPackBytes(@Buff,BfSz,@StartPtr,@Sz):Size 00082B- 8D 12 0E STA 0E12
000831- 68 PLA 00082E- 18 CLC
000832- 8D 00 03 STA 0300 00082F- FB XCE
000835- 60 RTS 000830- C2 30 REP #30
000836- 00 20 BRK 20 000832- A9 80 FE LDA #FE80
000838- E1 00 SBC (00,X) 000835- 8F 70 00 E1 STA E10070 ; Break vector
00083A- 00 80 BRK 80 000839- A2 00 00 LDX #0000
00083C- 20 67 09 JSR 0967 00083C- A9 A0 A0 LDA #A0A0
00083F- 2C 10 C0 BIT C010 ; r:KBDSTRB 00083F- 9D 00 04 STA 0400,X
000842- AD 00 C0 LDA C000 ; r:KBD w:CLR80COL 000842- E8 INX
000845- 30 13 BMI 085A {+13} 000843- E8 INX
000847- AD 61 C0 LDA C061 ; r:BUTN0 000844- E0 00 04 CPX #0400
00084A- 30 0E BMI 085A {+0E} 000847- 90 F3 BCC 083C {-0D}
00084C- AD 62 C0 LDA C062 ; r:BUTN1 000849- A2 00 A0 LDX #A000
00084F- 30 09 BMI 085A {+09} 00084C- CA DEX
000851- AD 27 C0 LDA C027 ; rw:KMSTATUS 00084D- CA DEX
000854- 89 80 D0 BIT #D080 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