ARMIPS assembler使用说明

疾风之狼

4 N2 a$ M4 U: y& X" q& r/ rARMIPS assembler是一款ARM/MIPS汇编工具，他是命令行工具，支持ARM7/ARM9/MIPS R3000/MIPS R4000

+ D5 Y9 _' X- R  ], a) z1 bARMIPS assembler作者是Kingcom,目前发展到0.9版本

" o5 f5 W) W- F  S8 MKingcom's website：http://aerie.wingdreams.net

ARMIPS assembler源代码可去https://github.com/Kingcom/armips获得

9 U6 ?$ M( Q/ j, E1 ^, |! k更新版本可去http://buildbot.orphis.net/armips获得

ARMIPS assembler特点支持加载ROM并自动编译代码到ROM，省了使用16进制编辑器复制代码进ROM，进行ROM HACK更方便了。
" t: c7 `# `4 l6 F
6 P; {  F; `2 b. j, K& FARMIPS命令行用法：

5 e2 G+ F5 p9 dUsage: armips [optional parameters] <FILE>

Optional parameters:
-temp <TEMP>         Output temporary assembly data to <TEMP> file
2 I4 m0 C& v+ {6 v8 S -sym  <SYM>          Output symbol data in the sym format to <SYM> file
-sym2 <SYM2>         Output symbol data in the sym2 format to <SYM2> file
-root <ROOT>         Use <ROOT> as working directory during execution
. K( J* X' Y) z# {& b0 L$ J5 i3 ^" u -equ  <NAME> <VAL>   Equivalent to '<NAME> equ <VAL>' in code
. r/ e9 s5 e$ z -strequ <NAME> <VAL> Equivalent to '<NAME> equ "<VAL>"' in code
-erroronwarning      Treat all warnings like errors
, C, {" p& r  @2 L
File arguments:
<FILE>               Main assembly code file

-temp <TEMP>参数是将临时汇编数据输出到<TEMP>文件
-sym <SYM>参数是将sym格式符号输出到<SYM>文件，这格式支持no$psx和no$gba
-sym2 <SYM2>参数是将sym2格式符号输出到<SYM2>文件，这格式支持pcsx2和ppsspp
-root <ROOT>参数是指定执行期间要使用的工作目录
-equ <NAME> <VAL>参数用法不明
8 ]' S# V; d; N7 u0 B$ m-strequ <NAME> <VAL>参数用法不明
-erroronwarning参数是当出现任何警告时被视为错误，防止继续编译

) r* K$ E* b# Z* S% u. @<FILE>是汇编代码文件，可用记事本之类编辑
6 _1 b3 b! R$ h+ W  c" E8 J* W: H
注释说明：
注释可在单行指令后面“;”和“//”添加
7 F! `4 g, a" i) V“/* */”式也接受
- n  y. `( c  q- R& Y+ V6 M7 f( x
3 ^6 L1 u! H  n0 ~' V例子：
. R* A5 @2 w( K/ G& @.open"1234.gba",0x08000000;//打开1234.gba文件，并将起始地址定义为0x08000000
$ B( F! M: Z6 Q4 C  |. {) f# |
8 t1 i" [7 v9 R.close;/*关闭文件*/

' O- |) y" w; X标签说明：
/ Q* p9 ]. Y/ j% G标签名可以包含A~Z字母和数字、下划线。但是它不能以数字开头，所有标签名称不区分大小写。

数值说明：
“0xA”和“0Ah”是16进制数值
3 S% [) _9 d+ |# Z6 l“0o12”和“12o”是8进制数值
“1010b”和“0b1010”是2进制数值
, T$ V8 _8 O. v
equ说明：
; h' B# r' w" z格式：text equ value
说明：用一个text代替value
; s6 A' c8 R' i0 E例子：
address1 equ 0x12345678
, w+ U6 E$ Q* Zldr r0,=address1
.pool

函数说明：
  h! N- V+ F) h* R9 S6 [( {
.open函数：
格式：
.open "ROM FileName",offset
, y9 _( F* X5 ~' S) Q.open "Old FileName","New FileName",offset
& m) R. a3 }: X+ Y2 t说明：.open函数打开ROM文件，并将ROM文件起始地址设置为offset地址。但结果指定了2个文件，汇编器会将文件复制到第二个路径。
* c$ N3 k5 j9 N1 i
( L% J" C1 q+ B例子：
.open "1234.gba",0x08000000
" ?7 _; H; a# C6 y8 r1 b# N
.close函数和.closefile函数：
格式：
.close
.closefile
说明：关闭文件。

+ y* ^1 [% X) z" @0 y.org函数和.orga函数：
0 b5 ~9 j  `" q, K' F4 }# \' h! p9 }格式：
.org RamAddress
.orga FileAddress
说明：
9 m  B8 \9 `( d7 `7 X前面用.open函数设置过offset地址的话，那么可以用.org函数设置offset输出地址。

# ?3 E7 c9 |. Z2 ^5 y5 V.orga函数可指定ROM文件的输出地址。

! O4 ~4 F1 A- r: D" d: c. q2 ], l.create函数和.createfile函数
$ V$ S5 z2 r& P+ L! L格式：
  j% N2 A: ]* `2 w/ G9 F.create "FileName",offset
.createfile "FileName",offset
说明：创建一个文件，如果文件是存在，他会覆盖掉。

4 l9 U$ b7 }* f: v.area函数
8 o; p- b0 t/ P3 h3 J格式：
.area SizeEquation[,fill]
.endarea
7 |" q" L: I2 j& L  \8 ]说明：如果你要向某地址写入一定字节数值，就用.area函数，SizeEquation是能写入最大字节数，超过就编译失败
& @* b) j( W( C7 L8 c7 S$ U
例子：向0x100地址写入0x5,0x6,0x7,0x8单字节数据
org 0x100
4 S) j1 C0 H3 S: S! X1 }( T.area 0x8
byte 0x5,0x6,0x7,0x8
9 I& f+ A3 i9 q3 k8 |.endarea
6 b/ b6 X6 b1 S3 i
.align函数
+ |1 H0 s8 p) v) T格式：.align num
说明：写零字节，num为零字节数量，用16进制表示。
. h7 S' y( Z: G# n( X. E
.pool函数
格式：.pool
说明：如果代码中有“ldr rx,=value”,就要用.pool对齐。
例子：
6 \9 ]! s4 _$ j. `& E/ i6 [ldr r0,=0x12345678;
1 Y# Y2 M- y; U# w1 c....
.pool
$ D! c1 S: {, q) ?: W6 l
4 F% V, R( O/ f! P.fill函数
格式：
.fill length[,value]
defs length[,value]
说明：填充一定长度单字节数值，如果未指定value，而填充零字节数值；length和value用16进制表示。

.skip函数：
格式：.skip length
说明：跳过指定长度单字节数值，length用16进制表示。

写单字节：
.byte value[,...]
.db value[,...]
  q  ?1 X$ T4 t5 X  ]* M.ascii value[,...]
" w( |, i& W, ~.asciiz value[,...]
dcb value[,...]
9 a' p  C' S# `  ^* W# B
2 Z% `5 K. g4 U) F7 v* \写双字节：
.halfword value[,...]
3 \& d9 Z+ _9 ]0 B, _.dh value[,...]
dcw value[,...]

8 ]. @$ V/ i+ E" ]* R: R. ~5 X写四字节：
: z. z# a. H0 x6 ~2 a' I.word value[,...]
0 J) P9 O; s/ A3 D.dw value[,...]
dcd value[,...]
* v& E$ O- ^! }' Q6 R
写doublewords：
.doubleword value[,...]
.dd value[,...]
dcq value[,...]
( P' h+ c6 B8 S% m
7 h3 q" w0 P+ @) }6 n; M写浮点数：
.float value[,...]
.double value[,...]
' ^. F: J3 A, |" b% j  m
ARM的ARM模式和THUMB模式定义：
' Z/ l  a2 Z8 G0 g1 ]% _.arm|ARM模式
- K, v  @, Z% D7 G% d" W2 c+ d.thumb|thumb模式
  C  J3 t  y2 ~- M
: D+ c  P% @( d( B- r  }9 _8 g9 ]8 E设置架构：
.psx|PlayStation 1(MIPS R3000)
- B4 y/ y6 I' Q0 u8 R1 j/ }6 H.ps2|PlayStation 2(EmotionEngine)
  ~2 H6 t7 g) M.psp|PlayStation Portable(Allegrex)
# @# }$ v6 B$ n2 f.n64|Nintendo 64(MIPS R4000)
, o5 I8 l8 U# P' W.rsp|Nintendo 64(RSP)
3 G/ F% ^5 Q- Z1 U.gba|GameBoy Advance(ARM7,默认是thumb模式)
9 y  y* H9 O% ?' R) t3 t.nds|Nintendo DS(ARM9,默认是ARM模式)
.3ds|Nintendo 3DS(ARM11,默认是ARM模式)
, H+ U7 P. ~! u) b+ }5 F; d.arm.big|
& o/ D# c1 d" ^% Q: f.arm.little|

常用函数就写这些了，还有大量函数说明没写，更多说明看readme.md吧。