ARMIPS assembler使用说明

疾风之狼

ARMIPS assembler是一款ARM/MIPS汇编工具，他是命令行工具，支持ARM7/ARM9/MIPS R3000/MIPS R4000
# M! e: }4 }( |2 `! p5 e
ARMIPS assembler作者是Kingcom,目前发展到0.9版本
9 v8 f: R# b' J( e2 U9 B; ]
Kingcom's website：http://aerie.wingdreams.net
7 o4 g( X6 p2 ]4 T' O2 F
ARMIPS assembler源代码可去https://github.com/Kingcom/armips获得

6 H  E$ M' a. M8 S. W" X" y更新版本可去http://buildbot.orphis.net/armips获得
$ S. O* F- N' S+ M2 ^
4 q2 I8 c. A2 _3 DARMIPS assembler特点支持加载ROM并自动编译代码到ROM，省了使用16进制编辑器复制代码进ROM，进行ROM HACK更方便了。

ARMIPS命令行用法：

Usage: armips [optional parameters] <FILE>
, d2 i" ?" |' }2 L$ A0 [
Optional parameters:
' r" }8 P' a6 |1 A+ M3 L: g -temp <TEMP>         Output temporary assembly data to <TEMP> file
. s. n# M4 b) {* D -sym  <SYM>          Output symbol data in the sym format to <SYM> file
+ D0 I' N, z2 ? -sym2 <SYM2>         Output symbol data in the sym2 format to <SYM2> file
-root <ROOT>         Use <ROOT> as working directory during execution
-equ  <NAME> <VAL>   Equivalent to '<NAME> equ <VAL>' in code
9 P+ `' C, H0 w& v -strequ <NAME> <VAL> Equivalent to '<NAME> equ "<VAL>"' in code
-erroronwarning      Treat all warnings like errors

& ]3 q- Y+ {9 X& u3 ~* \File arguments:
<FILE>               Main assembly code file
7 k# p) E8 l+ `( L4 ^; P" `( G
, ]4 I! W" c" |; s" w% ^2 M# ^3 ^-temp <TEMP>参数是将临时汇编数据输出到<TEMP>文件
  Y/ R4 \0 j) [9 l-sym <SYM>参数是将sym格式符号输出到<SYM>文件，这格式支持no$psx和no$gba
0 v6 f8 T! P! W( K-sym2 <SYM2>参数是将sym2格式符号输出到<SYM2>文件，这格式支持pcsx2和ppsspp
-root <ROOT>参数是指定执行期间要使用的工作目录
$ H/ x% X- Z) Y: g: O0 I) |' V  O-equ <NAME> <VAL>参数用法不明
+ T! u) X5 B# D8 Q" ~$ ]-strequ <NAME> <VAL>参数用法不明
$ X9 o" d% x  f+ L' G' Z) V, w-erroronwarning参数是当出现任何警告时被视为错误，防止继续编译

<FILE>是汇编代码文件，可用记事本之类编辑
3 O. k2 q5 ]- L- v8 n$ G
; \  s+ C+ w4 ~2 ?% k1 W注释说明：
注释可在单行指令后面“;”和“//”添加
  w- }0 z, F+ k/ x3 k, k“/* */”式也接受

  t/ _' X4 u% _+ I例子：
.open"1234.gba",0x08000000;//打开1234.gba文件，并将起始地址定义为0x08000000
! L% O0 n3 d- U% j; z. S6 Y
! f- C1 R! A% J.close;/*关闭文件*/

1 M# ]  k; L( j标签说明：
. ^  I  A( H' C标签名可以包含A~Z字母和数字、下划线。但是它不能以数字开头，所有标签名称不区分大小写。

2 F; |0 q) o0 ^7 z数值说明：
“0xA”和“0Ah”是16进制数值
* ]0 V# Y2 j' k: n+ y“0o12”和“12o”是8进制数值
“1010b”和“0b1010”是2进制数值
. \; s1 j' \3 @$ w8 N2 Z, k7 x! ]
equ说明：
( L& P  r  h' Z7 d格式：text equ value
说明：用一个text代替value
例子：
address1 equ 0x12345678
# ?# v. K5 o7 X" o& Dldr r0,=address1
.pool
$ @+ ^/ V: L4 h4 e
函数说明：
' y  ^& P. W& W% |% |5 `" r
  o- g! G) A3 X/ |0 ~.open函数：
格式：
0 ]! V( U- S2 Y$ j.open "ROM FileName",offset
.open "Old FileName","New FileName",offset
. ^6 M3 L6 D4 Q( f6 S; p- i1 X说明：.open函数打开ROM文件，并将ROM文件起始地址设置为offset地址。但结果指定了2个文件，汇编器会将文件复制到第二个路径。
) C( t4 m- V! w0 {, t% T5 f: j( O
例子：
4 h' ~6 `  s+ N! T6 ?( F* y.open "1234.gba",0x08000000

% j: u! g% ^( w% z0 Q4 E5 `) l/ g.close函数和.closefile函数：
格式：
3 ]8 I* D. j9 ?) G& K( ^.close
- G5 e' I  I- f$ j7 [( L.closefile
" |& W0 j5 ]  ?说明：关闭文件。

.org函数和.orga函数：
* `7 W9 f: l* n% c格式：
9 Z; b+ w9 C6 E' I: F7 x" {.org RamAddress
.orga FileAddress
说明：
3 O& p* a* T- f2 r1 k前面用.open函数设置过offset地址的话，那么可以用.org函数设置offset输出地址。
/ y# k! f; g; i0 {
.orga函数可指定ROM文件的输出地址。

& o9 h! H3 y. X0 N* ~. O1 z' E.create函数和.createfile函数
格式：
.create "FileName",offset
.createfile "FileName",offset
' z# t2 n7 ]) C; z$ g说明：创建一个文件，如果文件是存在，他会覆盖掉。

.area函数
4 U: U/ }' f. d" x格式：
.area SizeEquation[,fill]
.endarea
0 t9 P6 d% O" }1 x" V8 q. H说明：如果你要向某地址写入一定字节数值，就用.area函数，SizeEquation是能写入最大字节数，超过就编译失败

例子：向0x100地址写入0x5,0x6,0x7,0x8单字节数据
org 0x100
.area 0x8
& H( Z' f, T. M+ J. dbyte 0x5,0x6,0x7,0x8
; H6 t( E' R) P$ Q.endarea

: d, J+ U# k, g' _6 ]& c.align函数
1 R% S8 Q5 G9 ^格式：.align num
0 |( W4 E+ G- s5 ^0 k. ^  }) J说明：写零字节，num为零字节数量，用16进制表示。

.pool函数
" a8 j( V1 k/ ]1 M& y格式：.pool
说明：如果代码中有“ldr rx,=value”,就要用.pool对齐。
例子：
7 n, f6 ?/ {' {! Y/ P# m4 m" q& W( Cldr r0,=0x12345678;
....
4 ?* v) }6 `2 ]* j. y- Y- x.pool

2 a$ n7 p7 Q. Z% Z1 f.fill函数
格式：
3 @0 D+ S' \% R.fill length[,value]
defs length[,value]
; w. Y; U( c7 a/ ]: T( T说明：填充一定长度单字节数值，如果未指定value，而填充零字节数值；length和value用16进制表示。
& r6 |5 O) E# b, M( M
.skip函数：
格式：.skip length
4 D4 t8 |& I5 [( k说明：跳过指定长度单字节数值，length用16进制表示。

2 N& p5 ^( N2 R6 W4 e7 E" X写单字节：
" S4 B. X' z/ O" \% O.byte value[,...]
.db value[,...]
3 z0 K7 I9 i$ @: r, O+ {+ |.ascii value[,...]
.asciiz value[,...]
: Z8 O" E  O" Z6 P& V6 N, ]4 }( Kdcb value[,...]
* N9 E+ @( a+ M3 a
0 @. i; G' @( i- F写双字节：
8 A: R6 J: D1 r9 _.halfword value[,...]
& o" O) n5 _2 L& {- T: E6 ^6 X.dh value[,...]
dcw value[,...]
* f6 S8 q5 w3 E6 s
& a$ f- f+ Z8 H: Y. P: m写四字节：
.word value[,...]
* O- s6 C, G! n; Q7 V3 {9 h0 |% w+ ].dw value[,...]
7 [0 @( p  d. E. ]6 S0 [+ ddcd value[,...]
) _. z; Q$ n8 D& J# }
写doublewords：
( u% X7 [4 U. s% o2 O" D.doubleword value[,...]
4 m% R! Z! {+ u) L.dd value[,...]
% U, \2 ?, V" t! |9 l* zdcq value[,...]
3 [3 U  ]  |+ G$ Q
写浮点数：
2 B. j& H! \# h. t.float value[,...]
5 E$ x8 F2 j. E' b1 r.double value[,...]

3 j( S3 ]% `  k8 mARM的ARM模式和THUMB模式定义：
.arm|ARM模式
.thumb|thumb模式
, V. J' x- }# f- ^6 _
设置架构：
.psx|PlayStation 1(MIPS R3000)
.ps2|PlayStation 2(EmotionEngine)
.psp|PlayStation Portable(Allegrex)
2 Y" j& m/ y. ~.n64|Nintendo 64(MIPS R4000)
.rsp|Nintendo 64(RSP)
0 c4 O+ g/ o5 u; b2 d7 z.gba|GameBoy Advance(ARM7,默认是thumb模式)
8 T' X" a1 A8 d7 C( \8 S.nds|Nintendo DS(ARM9,默认是ARM模式)
. ^5 \% t8 T; l# O* [) l; t+ b" F.3ds|Nintendo 3DS(ARM11,默认是ARM模式)
2 ^! {8 w+ h& V  h; ~9 E( _.arm.big|
6 B0 }6 [$ o2 s.arm.little|
- }! }+ g3 g1 a% P: D- z! U, w
常用函数就写这些了，还有大量函数说明没写，更多说明看readme.md吧。
% S$ y! ?3 F0 Z/ j6 x9 Z