ARMIPS assembler使用说明

疾风之狼

' l, v- K" N" O1 VARMIPS assembler是一款ARM/MIPS汇编工具，他是命令行工具，支持ARM7/ARM9/MIPS R3000/MIPS R4000
0 V$ _0 V. v& D  I
2 C! ~2 }, H, p( CARMIPS assembler作者是Kingcom,目前发展到0.9版本

Kingcom's website：http://aerie.wingdreams.net

; Z7 q- y# w' p2 k4 g% n& aARMIPS assembler源代码可去https://github.com/Kingcom/armips获得

更新版本可去http://buildbot.orphis.net/armips获得
7 h) H9 ]* y9 F; ?
ARMIPS assembler特点支持加载ROM并自动编译代码到ROM，省了使用16进制编辑器复制代码进ROM，进行ROM HACK更方便了。

ARMIPS命令行用法：

Usage: armips [optional parameters] <FILE>
* b, G6 v2 A- y+ R
Optional parameters:
% i" D9 V8 b! ~ -temp <TEMP>         Output temporary assembly data to <TEMP> file
! @2 s/ [& A  n) h% f -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- j7 O0 b8 |2 l! L2 @! S -equ  <NAME> <VAL>   Equivalent to '<NAME> equ <VAL>' in code
. _/ L, O2 K! P) p4 x -strequ <NAME> <VAL> Equivalent to '<NAME> equ "<VAL>"' in code
( f6 a% }; v. D7 e -erroronwarning      Treat all warnings like errors
5 T; R! [$ L( G. X/ k( w+ a- K
& ^. C; c7 a0 u" Z. u' M" L, \- xFile arguments:
<FILE>               Main assembly code file
3 {" }" \2 n% d: I8 I
-temp <TEMP>参数是将临时汇编数据输出到<TEMP>文件
-sym <SYM>参数是将sym格式符号输出到<SYM>文件，这格式支持no$psx和no$gba
-sym2 <SYM2>参数是将sym2格式符号输出到<SYM2>文件，这格式支持pcsx2和ppsspp
2 q7 U5 h, _" p, y4 e$ ^-root <ROOT>参数是指定执行期间要使用的工作目录
-equ <NAME> <VAL>参数用法不明
/ ?: M8 Y# T/ I2 x! X* b" m& T-strequ <NAME> <VAL>参数用法不明
) u* @: R5 j5 T' p( K, Z3 T-erroronwarning参数是当出现任何警告时被视为错误，防止继续编译

* ]4 `7 o+ C& U/ r/ ^1 ?  ~3 q<FILE>是汇编代码文件，可用记事本之类编辑
$ _: w8 Q0 R- s4 y( \/ A, V
8 }" h, n* V5 f4 K注释说明：
4 C* n/ }5 B+ S3 S注释可在单行指令后面“;”和“//”添加
9 Y, I* t4 I' _$ e- U- K  H“/* */”式也接受

例子：
.open"1234.gba",0x08000000;//打开1234.gba文件，并将起始地址定义为0x08000000
: b7 v% q' J! G1 i
$ `% y8 L, P$ Y% ^.close;/*关闭文件*/
/ }' m# V3 O% P4 t" R/ {4 B7 S- z( u
标签说明：
: _0 s, ^  P6 ]& U/ F% d5 E6 J标签名可以包含A~Z字母和数字、下划线。但是它不能以数字开头，所有标签名称不区分大小写。

数值说明：
, z/ Q: ]& w) S# M2 w) C  C“0xA”和“0Ah”是16进制数值
2 B. a( S* |" o  h“0o12”和“12o”是8进制数值
“1010b”和“0b1010”是2进制数值
1 i! l1 V0 C0 v/ u
equ说明：
. c5 f; X; k# N; v3 ~: g7 \, [格式：text equ value
- |  S" Y, |9 `- [说明：用一个text代替value
5 G) k  ^$ D' ?+ O1 W例子：
* p4 @8 [+ L( C5 |3 Q* Daddress1 equ 0x12345678
+ ]0 v- j& ?1 O* n. ?ldr r0,=address1
! Z; t! R  }3 c* Q/ }, Q' B& C.pool
, ~6 ^  T/ }2 N
函数说明：

.open函数：
格式：
. Q. x  T: S4 |8 h7 ].open "ROM FileName",offset
( |- z/ E  c3 C.open "Old FileName","New FileName",offset
( P! X% W/ v. `$ L说明：.open函数打开ROM文件，并将ROM文件起始地址设置为offset地址。但结果指定了2个文件，汇编器会将文件复制到第二个路径。
& u1 M- P& c; g
例子：
5 k" b# p% G! k" D+ y  b.open "1234.gba",0x08000000
; Y2 T) c. l  \( R4 ]3 Y0 c
# Y/ [/ j, u' e0 g.close函数和.closefile函数：
8 a/ `( K, _* }* c0 J% L% s格式：
.close
) }' N1 l% _3 |( r' C3 d$ j4 _.closefile
1 p/ ~6 P. l8 U0 _- e说明：关闭文件。
0 w, J. W" C8 z* _+ M
" ^8 |1 A+ E6 u' u0 i; M.org函数和.orga函数：
+ @" i4 f/ v% c格式：
( i  |# B2 Y2 Y! s.org RamAddress
.orga FileAddress
* a8 l* U8 A( [$ Q! B说明：
前面用.open函数设置过offset地址的话，那么可以用.org函数设置offset输出地址。
1 o3 X2 C- [, D! u
.orga函数可指定ROM文件的输出地址。

) `! R, o; W& }9 t  y3 ~.create函数和.createfile函数
格式：
4 L. `7 ?* q3 ]/ d.create "FileName",offset
. }5 N( ]! z  W, u.createfile "FileName",offset
说明：创建一个文件，如果文件是存在，他会覆盖掉。
0 B1 g' [7 ]; m
.area函数
8 i% p' y4 {$ }( c/ k格式：
' G, T8 r2 i/ V7 ].area SizeEquation[,fill]
0 ?$ y5 e# z: X.endarea
5 ~) ^; V0 v2 `+ k说明：如果你要向某地址写入一定字节数值，就用.area函数，SizeEquation是能写入最大字节数，超过就编译失败

. c: m/ k; c9 @, ?0 _+ S  @例子：向0x100地址写入0x5,0x6,0x7,0x8单字节数据
' T" T' X7 ^* P$ Y7 Eorg 0x100
.area 0x8
byte 0x5,0x6,0x7,0x8
9 O2 W/ G. u3 m( L* H.endarea

7 F( O! f# |( g.align函数
4 |  z4 y% T  b格式：.align num
6 C1 _& K0 u* c6 Y说明：写零字节，num为零字节数量，用16进制表示。
5 ^* P, I1 Z* K$ c, b4 _5 c1 y
2 f! j1 T# Q9 P7 s.pool函数
格式：.pool
说明：如果代码中有“ldr rx,=value”,就要用.pool对齐。
例子：
ldr r0,=0x12345678;
....
.pool
6 Y" h) J( p0 t- Q3 n6 t
.fill函数
格式：
.fill length[,value]
& \/ w# Q, G+ }8 |" M; R/ W4 Cdefs length[,value]
) c2 L3 r8 ~; }# }0 h说明：填充一定长度单字节数值，如果未指定value，而填充零字节数值；length和value用16进制表示。

4 G/ t4 e* j  f" Y.skip函数：
格式：.skip length
说明：跳过指定长度单字节数值，length用16进制表示。
8 `1 [0 f! H! Y* e& U: Y  B6 r
! Y* o& w: s7 A/ P+ e5 p写单字节：
.byte value[,...]
.db value[,...]
.ascii value[,...]
- @7 B( t  R" d6 S! P.asciiz value[,...]
dcb value[,...]

8 P/ P- f7 T4 e) w* A写双字节：
.halfword value[,...]
# i! M* \) N* J. j! ?.dh value[,...]
dcw value[,...]
# g% @) T! e: _- E8 R
写四字节：
.word value[,...]
.dw value[,...]
dcd value[,...]

写doublewords：
8 v" a( O- w& v% S; |' ?.doubleword value[,...]
9 g' f/ s+ B* J6 o0 [4 Q) q; C.dd value[,...]
. s( e+ v2 i! }* ?; X# i( Q+ ]; {$ Wdcq value[,...]

+ |" _4 t" }( E7 B- L: i4 M写浮点数：
2 V) V, N0 u3 r* j% a) x1 L8 N.float value[,...]
.double value[,...]

% _7 m- I4 t* rARM的ARM模式和THUMB模式定义：
.arm|ARM模式
.thumb|thumb模式
: m3 p1 O* b& B: }1 ]
9 x( S  }- ?0 p2 i设置架构：
.psx|PlayStation 1(MIPS R3000)
/ S6 J0 R( `- C$ `% J  L# c.ps2|PlayStation 2(EmotionEngine)
% p5 [# l& @( _8 A' O8 D( a( y.psp|PlayStation Portable(Allegrex)
+ o& X" k# d7 D* s+ E! N.n64|Nintendo 64(MIPS R4000)
.rsp|Nintendo 64(RSP)
* }, s; N+ {& A0 \.gba|GameBoy Advance(ARM7,默认是thumb模式)
) ]6 ]& ], e% B* S; l0 P0 G6 f.nds|Nintendo DS(ARM9,默认是ARM模式)
  L- ?% w# E0 X5 E6 @.3ds|Nintendo 3DS(ARM11,默认是ARM模式)
.arm.big|
$ G9 k4 F+ ]2 G" Q* @. j5 @& a.arm.little|
3 @! }- T- I0 i
常用函数就写这些了，还有大量函数说明没写，更多说明看readme.md吧。