ARMIPS assembler使用说明

疾风之狼

ARMIPS assembler是一款ARM/MIPS汇编工具，他是命令行工具，支持ARM7/ARM9/MIPS R3000/MIPS R4000
  l$ f" a* f4 U7 w. |
" G2 ~) I1 _2 LARMIPS assembler作者是Kingcom,目前发展到0.9版本
( ?0 w) h: T, Z3 n7 |/ y# F
Kingcom's website：http://aerie.wingdreams.net

ARMIPS assembler源代码可去https://github.com/Kingcom/armips获得
( F( d! G7 z- b4 Q0 W
更新版本可去http://buildbot.orphis.net/armips获得

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

ARMIPS命令行用法：

Usage: armips [optional parameters] <FILE>
. v3 {$ ?# G  J; r+ z
Optional parameters:
2 f" _2 p6 r0 t8 V+ t( C -temp <TEMP>         Output temporary assembly data to <TEMP> file
% v# c& r2 a2 i. V# d, b; [ -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
-equ  <NAME> <VAL>   Equivalent to '<NAME> equ <VAL>' in code
-strequ <NAME> <VAL> Equivalent to '<NAME> equ "<VAL>"' in code
" e( D5 L2 G: j6 `: @2 k -erroronwarning      Treat all warnings like errors

File arguments:
7 v0 U& p1 I* S4 {5 {6 [ <FILE>               Main assembly code file

-temp <TEMP>参数是将临时汇编数据输出到<TEMP>文件
- P0 n& _7 E( \+ d( N1 Z) a  r-sym <SYM>参数是将sym格式符号输出到<SYM>文件，这格式支持no$psx和no$gba
-sym2 <SYM2>参数是将sym2格式符号输出到<SYM2>文件，这格式支持pcsx2和ppsspp
9 w  R7 L. E# n  F# ?3 K, ?-root <ROOT>参数是指定执行期间要使用的工作目录
+ m7 k/ S. S4 m/ s+ F- K1 n-equ <NAME> <VAL>参数用法不明
" |% K# ?. {' I& s6 |-strequ <NAME> <VAL>参数用法不明
-erroronwarning参数是当出现任何警告时被视为错误，防止继续编译
: z( Y/ _' o9 n! ~5 z
<FILE>是汇编代码文件，可用记事本之类编辑
$ C$ b$ L# N- m( M2 i
注释说明：
/ t/ k( w' ^0 L: i9 N注释可在单行指令后面“;”和“//”添加
# w2 ?) _4 l! g3 y" |2 V“/* */”式也接受
* e$ B5 F; a/ ^6 W, Z0 k' q# h
) g. T+ {* u' W例子：
- y2 F4 u& v' _.open"1234.gba",0x08000000;//打开1234.gba文件，并将起始地址定义为0x08000000

- x9 d" w8 U4 I7 N$ [.close;/*关闭文件*/

标签说明：
# D( L! z8 {. x. f, w& A标签名可以包含A~Z字母和数字、下划线。但是它不能以数字开头，所有标签名称不区分大小写。
4 ]+ @1 t6 Z* p& t7 Q, @
数值说明：
“0xA”和“0Ah”是16进制数值
“0o12”和“12o”是8进制数值
“1010b”和“0b1010”是2进制数值
7 m+ b# ?. ]: U; H  n! P% @
equ说明：
格式：text equ value
说明：用一个text代替value
例子：
: R, y  ?+ [$ O  a" ^7 kaddress1 equ 0x12345678
6 B, P+ f5 L/ P/ t  l; k5 oldr r0,=address1
.pool
$ N+ k4 U; }, v% C" W
% t+ @+ t# P: M# j5 s函数说明：
. D  e, J7 V2 {
" d  S. c4 J7 f9 k4 T0 Q.open函数：
' J2 i. d2 ^% S3 v格式：
.open "ROM FileName",offset
$ E  y- ?( ?. p.open "Old FileName","New FileName",offset
说明：.open函数打开ROM文件，并将ROM文件起始地址设置为offset地址。但结果指定了2个文件，汇编器会将文件复制到第二个路径。
, Z; y6 A5 t: W7 ~
例子：
.open "1234.gba",0x08000000

) T0 M2 |6 E% o.close函数和.closefile函数：
7 l, H7 i$ l3 L4 ^( W+ R1 r; y格式：
7 m" F0 F9 ?# f.close
.closefile
9 h+ O0 F: `- y7 Y. Q  _, Q# J说明：关闭文件。
9 r4 l; s9 |: f" D0 C2 q
.org函数和.orga函数：
# |1 _% V' u9 j1 V4 D  J' Z3 c格式：
.org RamAddress
; B3 \3 S* ~( f% w.orga FileAddress
说明：
前面用.open函数设置过offset地址的话，那么可以用.org函数设置offset输出地址。

; D! ~: U( @; |0 W( t2 w9 I- ]9 C.orga函数可指定ROM文件的输出地址。

.create函数和.createfile函数
格式：
.create "FileName",offset
  n2 F0 `+ h8 p.createfile "FileName",offset
说明：创建一个文件，如果文件是存在，他会覆盖掉。
) x( L* O1 n1 E3 ^9 S# D
.area函数
格式：
$ r9 v" d: U: o7 Y8 P% c# J) N- g2 p.area SizeEquation[,fill]
# M: |% f$ u* i2 o.endarea
5 _2 Y/ S: ?1 X说明：如果你要向某地址写入一定字节数值，就用.area函数，SizeEquation是能写入最大字节数，超过就编译失败
- @5 O- v( x8 t/ \8 ?" j) v
例子：向0x100地址写入0x5,0x6,0x7,0x8单字节数据
. ~: _) V5 d0 \' }, F: Q9 ]org 0x100
.area 0x8
byte 0x5,0x6,0x7,0x8
.endarea
! X  G2 M' e. \+ l6 E/ L
.align函数
1 }% p6 M9 O6 Q5 }' E( R格式：.align num
说明：写零字节，num为零字节数量，用16进制表示。

.pool函数
; A" E7 X8 {9 O" e- Z; a格式：.pool
说明：如果代码中有“ldr rx,=value”,就要用.pool对齐。
例子：
ldr r0,=0x12345678;
....
% ]0 Z+ [; S  ]' f5 [5 S.pool
3 `! {) u8 Q( J# ^8 a! L; s( Q, f
.fill函数
/ {1 c$ ^* S- _6 r- X格式：
6 f$ r0 c: f" {- T8 P.fill length[,value]
# P0 U; r1 c9 R  \8 P9 kdefs length[,value]
9 K* {3 K/ `% K5 @2 `# u# t说明：填充一定长度单字节数值，如果未指定value，而填充零字节数值；length和value用16进制表示。

.skip函数：
格式：.skip length
说明：跳过指定长度单字节数值，length用16进制表示。
7 i) z' c6 D8 _( ^
- L# i) u! X, u# J写单字节：
+ J& y. M' j; b: R- e8 `.byte value[,...]
.db value[,...]
.ascii value[,...]
, g3 ^) `# a. V.asciiz value[,...]
dcb value[,...]
; ]4 e4 r' N6 D- s& C
写双字节：
.halfword value[,...]
.dh value[,...]
' b1 X4 u. t+ c8 l, S  Bdcw value[,...]
& M, ]) n8 t7 `7 Q* y8 C2 K
+ o2 U& ]% u( [- }% r写四字节：
.word value[,...]
.dw value[,...]
dcd value[,...]
1 B' t; k9 h0 E9 r
写doublewords：
* K0 B9 P  P. q' j8 W7 O.doubleword value[,...]
1 X0 e" }5 I5 u+ A3 |! m.dd value[,...]
! j* _9 J( |2 J! idcq value[,...]

% Z9 P4 @) i, Y# j1 j写浮点数：
.float value[,...]
.double value[,...]
5 r; e) n& [) Q0 B6 K
% o2 ]3 s2 B" cARM的ARM模式和THUMB模式定义：
.arm|ARM模式
, J0 m" |: I  n5 h.thumb|thumb模式
/ g7 s: U) K7 t0 y5 w
& i8 v1 O9 X+ A. u. q7 f) i设置架构：
6 w; D1 X! P7 `5 `. G  D.psx|PlayStation 1(MIPS R3000)
8 W4 ]$ b* {# _3 B; m7 d% j! _.ps2|PlayStation 2(EmotionEngine)
.psp|PlayStation Portable(Allegrex)
% c: l; u+ p8 W8 l! G# Y.n64|Nintendo 64(MIPS R4000)
.rsp|Nintendo 64(RSP)
# A8 Z, o/ i) h& h9 f! `# B.gba|GameBoy Advance(ARM7,默认是thumb模式)
.nds|Nintendo DS(ARM9,默认是ARM模式)
/ i; h+ m6 o' n/ C) t.3ds|Nintendo 3DS(ARM11,默认是ARM模式)
.arm.big|
0 o4 P; {3 K  o+ g/ z% S! b+ t1 B.arm.little|

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