ARMIPS assembler使用说明

疾风之狼

# M1 l$ N! [2 Z! lARMIPS assembler是一款ARM/MIPS汇编工具，他是命令行工具，支持ARM7/ARM9/MIPS R3000/MIPS R4000
8 v4 l7 ~. y! g$ r! k
% f8 z9 P, a& y# \; w- J" LARMIPS assembler作者是Kingcom,目前发展到0.9版本

( d1 X8 {. r0 s  dKingcom's website：http://aerie.wingdreams.net
" |. }( w' K: j2 i" P
ARMIPS assembler源代码可去https://github.com/Kingcom/armips获得
3 g) {; n4 v* S; q7 v  G% l
更新版本可去http://buildbot.orphis.net/armips获得
/ i* ~" M' c2 C1 j! S* C
2 @$ h* W- _1 r4 bARMIPS assembler特点支持加载ROM并自动编译代码到ROM，省了使用16进制编辑器复制代码进ROM，进行ROM HACK更方便了。

ARMIPS命令行用法：

Usage: armips [optional parameters] <FILE>
) j/ q, n- j$ F2 g1 k, ~- z
6 B$ C# j( [, a2 s3 L( R' F, r. d3 ^Optional parameters:
6 X: r/ I# b. a8 c -temp <TEMP>         Output temporary assembly data to <TEMP> file
0 j" F1 ~$ v1 J' t -sym  <SYM>          Output symbol data in the sym format to <SYM> file
-sym2 <SYM2>         Output symbol data in the sym2 format to <SYM2> file
+ ^$ q. w8 a3 ]( E -root <ROOT>         Use <ROOT> as working directory during execution
-equ  <NAME> <VAL>   Equivalent to '<NAME> equ <VAL>' in code
-strequ <NAME> <VAL> Equivalent to '<NAME> equ "<VAL>"' in code
-erroronwarning      Treat all warnings like errors
# }9 |$ V7 }- \" H" q6 ?8 {% i  ~4 p# |
File arguments:
& Z* _1 a3 u. Y) f2 ? <FILE>               Main assembly code file
3 v; e/ t+ x8 N# Q& m9 ~
# b4 G) E/ x+ u) Y8 u* S& v-temp <TEMP>参数是将临时汇编数据输出到<TEMP>文件
-sym <SYM>参数是将sym格式符号输出到<SYM>文件，这格式支持no$psx和no$gba
/ x; e" @9 Z! \+ X7 Y' h9 \-sym2 <SYM2>参数是将sym2格式符号输出到<SYM2>文件，这格式支持pcsx2和ppsspp
, `& x  q+ ~) b$ s2 a-root <ROOT>参数是指定执行期间要使用的工作目录
7 f# m  H- ]2 }8 E: S: W-equ <NAME> <VAL>参数用法不明
; ]1 F1 {9 q/ B5 ]-strequ <NAME> <VAL>参数用法不明
-erroronwarning参数是当出现任何警告时被视为错误，防止继续编译
( N2 }" C, R% f
<FILE>是汇编代码文件，可用记事本之类编辑
+ u* o( [9 S$ U
9 r: p8 N* Y' R- H注释说明：
注释可在单行指令后面“;”和“//”添加
. D5 w! q) o) r* ~" d/ F# g# @“/* */”式也接受

例子：
.open"1234.gba",0x08000000;//打开1234.gba文件，并将起始地址定义为0x08000000
/ J; d' }* d2 _
& k. M8 m5 v) ~2 r) S.close;/*关闭文件*/

' G4 Y5 G) J$ k. K/ r3 u标签说明：
标签名可以包含A~Z字母和数字、下划线。但是它不能以数字开头，所有标签名称不区分大小写。
6 [, _9 K3 b& i. q) h
( ], P  K4 P& b数值说明：
“0xA”和“0Ah”是16进制数值
. i. i& |; M4 |/ |: D* c3 x“0o12”和“12o”是8进制数值
“1010b”和“0b1010”是2进制数值

equ说明：
格式：text equ value
! [" |! @8 x7 _+ T6 ?说明：用一个text代替value
* `$ [1 ?# b6 U2 c6 o例子：
address1 equ 0x12345678
ldr r0,=address1
( Y% C" ~" [; e3 `0 T( i3 K3 @  x.pool

函数说明：
; D- F  w6 D7 z: C; Y& @% t: m
" S0 D: z6 [0 M.open函数：
格式：
.open "ROM FileName",offset
& \2 h+ s8 e1 ~7 _( f; @+ U.open "Old FileName","New FileName",offset
! m8 J3 U" I8 Z, [+ B说明：.open函数打开ROM文件，并将ROM文件起始地址设置为offset地址。但结果指定了2个文件，汇编器会将文件复制到第二个路径。

% \9 t: ~7 K: p- F5 [. u, q, U0 d例子：
.open "1234.gba",0x08000000

5 {0 B- f! n  E+ Q% n  m.close函数和.closefile函数：
格式：
.close
.closefile
说明：关闭文件。

.org函数和.orga函数：
) T0 x8 F/ h2 K, e( E格式：
* m9 a. p+ K4 [# \! Z0 d.org RamAddress
$ A8 l8 b( H5 s3 c3 z.orga FileAddress
& k- x4 @- ]) u5 L9 ^5 G2 w' L说明：
前面用.open函数设置过offset地址的话，那么可以用.org函数设置offset输出地址。

.orga函数可指定ROM文件的输出地址。

% O5 `# |0 I; j9 j  {.create函数和.createfile函数
格式：
.create "FileName",offset
  {1 s% y2 u' g2 |$ K- l.createfile "FileName",offset
说明：创建一个文件，如果文件是存在，他会覆盖掉。
' [; c9 N; e! _7 K! U6 F
.area函数
' C" |& ~2 x4 P7 i- @# G格式：
.area SizeEquation[,fill]
.endarea
$ @  Y9 t8 m: B  f+ y1 |+ U" }说明：如果你要向某地址写入一定字节数值，就用.area函数，SizeEquation是能写入最大字节数，超过就编译失败

例子：向0x100地址写入0x5,0x6,0x7,0x8单字节数据
org 0x100
.area 0x8
- X) n; i$ L3 p4 pbyte 0x5,0x6,0x7,0x8
9 M! z0 V% j2 e5 @) Q3 j1 v.endarea

.align函数
格式：.align num
说明：写零字节，num为零字节数量，用16进制表示。
9 E3 f: h: m+ q/ g" C$ X
; H9 ]5 i9 D2 j  {' @/ E.pool函数
格式：.pool
1 y2 t, a; h$ Y6 t+ c1 F. G说明：如果代码中有“ldr rx,=value”,就要用.pool对齐。
例子：
ldr r0,=0x12345678;
....
; r" R# x& Y$ P- s% C' v.pool
, \+ T, h; C3 Z0 R" G9 T
3 S: D- \+ M8 b.fill函数
格式：
1 H7 Y; [& Z/ X) h4 {! ^.fill length[,value]
$ B7 f. M1 ^# Y. c6 cdefs length[,value]
说明：填充一定长度单字节数值，如果未指定value，而填充零字节数值；length和value用16进制表示。
6 O- u& C* G! C# r1 L9 h
.skip函数：
格式：.skip length
3 Z% r; m2 n: D3 o说明：跳过指定长度单字节数值，length用16进制表示。
4 r9 t' }- r, x
( N* Q% U7 K7 m! l: F; l; y/ Z6 d+ R$ u写单字节：
.byte value[,...]
.db value[,...]
$ K2 M2 e& \$ L/ N6 t) `5 G* M0 o.ascii value[,...]
9 M, d, \2 i0 |2 ?5 _0 h; R.asciiz value[,...]
dcb value[,...]

" [% H0 X: r  R. U' r+ r写双字节：
.halfword value[,...]
$ }( F3 Z* b4 B.dh value[,...]
dcw value[,...]
+ L1 N* d- e' J" b
) ^3 i$ ^5 W8 w7 n写四字节：
( i5 `5 [8 W+ e7 h.word value[,...]
.dw value[,...]
dcd value[,...]

2 ^, [( B! ?" Y4 O0 h' C% I3 `写doublewords：
.doubleword value[,...]
9 Q4 l' _. O$ ^$ B& t" {.dd value[,...]
dcq value[,...]
0 @; _( C" V" s: O9 }
写浮点数：
.float value[,...]
.double value[,...]
' Q$ t0 v4 x- C
ARM的ARM模式和THUMB模式定义：
3 |& d7 s+ `1 i  Z  r% X- j2 V0 E3 U5 ].arm|ARM模式
.thumb|thumb模式
- S! K8 H! O# T
设置架构：
.psx|PlayStation 1(MIPS R3000)
.ps2|PlayStation 2(EmotionEngine)
.psp|PlayStation Portable(Allegrex)
, L' X' g# a) O9 u$ K5 }" d7 ?.n64|Nintendo 64(MIPS R4000)
.rsp|Nintendo 64(RSP)
0 y% [; M9 N: O.gba|GameBoy Advance(ARM7,默认是thumb模式)
.nds|Nintendo DS(ARM9,默认是ARM模式)
.3ds|Nintendo 3DS(ARM11,默认是ARM模式)
.arm.big|
# H% n+ F! @3 [' {( R8 L* L1 u.arm.little|
4 P  f! {8 m' j& f8 w
常用函数就写这些了，还有大量函数说明没写，更多说明看readme.md吧。