ARMIPS assembler使用说明

疾风之狼

ARMIPS assembler是一款ARM/MIPS汇编工具，他是命令行工具，支持ARM7/ARM9/MIPS R3000/MIPS R4000
7 s9 x. V5 Y4 H7 g: ~$ {
- W% {) V9 h4 E# l) Q& _  K6 hARMIPS assembler作者是Kingcom,目前发展到0.9版本

Kingcom's website：http://aerie.wingdreams.net
1 I2 ^7 C  K1 u
3 \2 K( U# X7 g, q  H4 K! _ARMIPS assembler源代码可去https://github.com/Kingcom/armips获得

2 b9 }9 e/ T; k2 \0 I, N更新版本可去http://buildbot.orphis.net/armips获得

ARMIPS assembler特点支持加载ROM并自动编译代码到ROM，省了使用16进制编辑器复制代码进ROM，进行ROM HACK更方便了。

& D, [; U  X2 P' O" }ARMIPS命令行用法：
' w% S, X! t( ^+ K* g
* e9 f! I  H. bUsage: armips [optional parameters] <FILE>
& k/ Z" m4 v, E* I4 ^
Optional parameters:
-temp <TEMP>         Output temporary assembly data to <TEMP> file
2 ~( R8 b- k) f( r -sym  <SYM>          Output symbol data in the sym format to <SYM> file
$ @, u  x7 N* P, i: Y -sym2 <SYM2>         Output symbol data in the sym2 format to <SYM2> file
- E9 Q1 Z7 \: c% q- d0 o; l -root <ROOT>         Use <ROOT> as working directory during execution
-equ  <NAME> <VAL>   Equivalent to '<NAME> equ <VAL>' in code
/ O6 F: `  e  k. I, u: f( C -strequ <NAME> <VAL> Equivalent to '<NAME> equ "<VAL>"' in code
-erroronwarning      Treat all warnings like errors

File arguments:
2 C; T# Z: s9 t+ T" d3 b) L3 w <FILE>               Main assembly code file
8 {6 w" E) G: ?! q' B
9 `0 S) ?! Y3 X. W; V, D- {4 l-temp <TEMP>参数是将临时汇编数据输出到<TEMP>文件
! j, n, ?! o1 J7 y/ I! W% r-sym <SYM>参数是将sym格式符号输出到<SYM>文件，这格式支持no$psx和no$gba
-sym2 <SYM2>参数是将sym2格式符号输出到<SYM2>文件，这格式支持pcsx2和ppsspp
-root <ROOT>参数是指定执行期间要使用的工作目录
+ b4 v1 H) G2 G" a2 G! R- C-equ <NAME> <VAL>参数用法不明
" x& k  X! d. ]  {) z" u' J-strequ <NAME> <VAL>参数用法不明
-erroronwarning参数是当出现任何警告时被视为错误，防止继续编译
* q% P6 p- {9 t3 |1 X5 v* d
5 k: T+ \1 b4 V; D9 Q) Z<FILE>是汇编代码文件，可用记事本之类编辑
: Q! y5 o$ |# }. Z2 ]' g* ~9 t* y
注释说明：
' V) s# X2 E0 L+ J1 b  J+ a注释可在单行指令后面“;”和“//”添加
“/* */”式也接受
" p  Q, ~7 b9 ]+ T; }" R, g
; Y8 t% T3 B  z& M. Q6 Z例子：
.open"1234.gba",0x08000000;//打开1234.gba文件，并将起始地址定义为0x08000000
  |0 w& N7 \- ]* @
.close;/*关闭文件*/
1 u8 |  ~0 E# i$ A! q1 }
标签说明：
4 z: ^8 [) p% C6 i) n标签名可以包含A~Z字母和数字、下划线。但是它不能以数字开头，所有标签名称不区分大小写。

" q4 c1 s1 B) N; R+ u) o数值说明：
“0xA”和“0Ah”是16进制数值
“0o12”和“12o”是8进制数值
/ t2 i; {3 R/ G9 W" |“1010b”和“0b1010”是2进制数值

equ说明：
格式：text equ value
, p1 S' j% k. \% A7 _说明：用一个text代替value
! ^6 P% E  M% v$ ^* A例子：
) H6 ?* J3 u# }& v3 Faddress1 equ 0x12345678
ldr r0,=address1
.pool

函数说明：

.open函数：
  }" \5 A5 N) r& ^格式：
.open "ROM FileName",offset
.open "Old FileName","New FileName",offset
说明：.open函数打开ROM文件，并将ROM文件起始地址设置为offset地址。但结果指定了2个文件，汇编器会将文件复制到第二个路径。

1 v$ T3 ~. R& {例子：
- w: s% _4 w% }2 r. \% w3 R/ |; i.open "1234.gba",0x08000000
4 `2 B- [8 _. x# }% K# k8 m  C
* Z7 ]: G' b0 P. v5 {.close函数和.closefile函数：
$ O  I+ S' o5 g) D格式：
/ c+ J" n' C9 Z, s1 w; i% W# m.close
.closefile
9 ?# k% B; ]% V1 h+ p说明：关闭文件。
, z5 w2 S0 c8 [# [5 M
# k( K8 t2 m2 z.org函数和.orga函数：
格式：
. i8 G3 K5 K' L4 Z.org RamAddress
.orga FileAddress
- ~/ [7 C# R9 H5 q' l说明：
前面用.open函数设置过offset地址的话，那么可以用.org函数设置offset输出地址。

.orga函数可指定ROM文件的输出地址。
1 P, ^9 {7 T% m* O4 C' _
7 x" D0 s6 @  C' R. O8 x.create函数和.createfile函数
格式：
0 j3 R* ^7 k$ d* s.create "FileName",offset
.createfile "FileName",offset
: P6 O6 g7 D5 I5 v说明：创建一个文件，如果文件是存在，他会覆盖掉。

.area函数
) @8 ~4 ?4 k3 w) E" I. P" U) R( W# m格式：
4 _' w' `, Z! y! t/ v& \' g- y.area SizeEquation[,fill]
.endarea
说明：如果你要向某地址写入一定字节数值，就用.area函数，SizeEquation是能写入最大字节数，超过就编译失败

6 u+ g4 |( J) T5 f2 q+ M/ ~例子：向0x100地址写入0x5,0x6,0x7,0x8单字节数据
# P. W; z8 Q* K2 ?& Y/ m1 ]% norg 0x100
; O( n- u1 ?7 ^" `6 z7 Y.area 0x8
. p  S& Z. L4 \3 Ybyte 0x5,0x6,0x7,0x8
.endarea
- i7 w9 W) R9 W& i
.align函数
格式：.align num
, j; e. z7 i1 g: \4 u说明：写零字节，num为零字节数量，用16进制表示。
2 Z' X. T; f2 p1 i% h; q" }
# N, i, ~! L& n/ \" K/ E# \.pool函数
2 X( T0 E) T7 B3 D% i: t格式：.pool
! P. M" y# I3 |$ P2 X" Z说明：如果代码中有“ldr rx,=value”,就要用.pool对齐。
9 u7 {9 c( `8 h# r" D1 p- J例子：
$ V) t* ~0 r: Wldr r0,=0x12345678;
....
. s6 P. J, S& [  Y  l  O, S.pool
. M7 e+ o" v6 {" ~8 r# k
.fill函数
格式：
.fill length[,value]
: }$ b- a$ c/ y7 Y, M% B( h0 |defs length[,value]
说明：填充一定长度单字节数值，如果未指定value，而填充零字节数值；length和value用16进制表示。

.skip函数：
0 x9 @' ~2 @7 N- Z1 F- c- f# y格式：.skip length
说明：跳过指定长度单字节数值，length用16进制表示。
' l, S; f( a* y" l* y
/ C2 j2 m% ^* Y3 z; h" e# l写单字节：
.byte value[,...]
.db value[,...]
.ascii value[,...]
/ ~' a# C  q5 k" T. D4 L.asciiz value[,...]
dcb value[,...]
# y; h# r4 v6 a/ G- P
# X4 p) ]  X+ C; m3 ~( [写双字节：
2 ~; J, T2 Y0 @.halfword value[,...]
.dh value[,...]
/ s# g6 v2 s& H# `  O( B2 _dcw value[,...]
0 \! w5 v9 G1 t6 X1 B
写四字节：
: k3 f2 F/ j( [3 u.word value[,...]
% p% O; _( g" z8 i% t) G* T.dw value[,...]
: V( a: i0 P# F$ ~: A$ Adcd value[,...]

- w* i/ E# W  f! Y0 j0 ^写doublewords：
8 d+ U) i1 m: x  F; v.doubleword value[,...]
.dd value[,...]
dcq value[,...]

& ~2 ]. r3 }8 n% V; b* m% D写浮点数：
3 r' e, k/ `& G8 o) Z4 i- P.float value[,...]
( `) h% J( g+ A+ ?& t! ~.double value[,...]
& B& O/ A0 K. H5 k% y" d0 L. O5 N
ARM的ARM模式和THUMB模式定义：
.arm|ARM模式
.thumb|thumb模式

设置架构：
.psx|PlayStation 1(MIPS R3000)
$ z- J. x  w/ b2 {5 @/ O! i.ps2|PlayStation 2(EmotionEngine)
.psp|PlayStation Portable(Allegrex)
& [6 c) m' S$ E6 U- s' E  c7 x9 u4 K.n64|Nintendo 64(MIPS R4000)
: H6 x. H* [: M9 l6 L& _.rsp|Nintendo 64(RSP)
.gba|GameBoy Advance(ARM7,默认是thumb模式)
.nds|Nintendo DS(ARM9,默认是ARM模式)
.3ds|Nintendo 3DS(ARM11,默认是ARM模式)
.arm.big|
.arm.little|

6 t6 ]+ O/ d  C: k常用函数就写这些了，还有大量函数说明没写，更多说明看readme.md吧。