ARMIPS assembler使用说明

疾风之狼

, y* c# V( X% F6 X4 W4 jARMIPS assembler是一款ARM/MIPS汇编工具，他是命令行工具，支持ARM7/ARM9/MIPS R3000/MIPS R4000

ARMIPS assembler作者是Kingcom,目前发展到0.9版本
+ X3 F  g5 ?: L' ~1 D- u( ]9 }
Kingcom's website：http://aerie.wingdreams.net

ARMIPS assembler源代码可去https://github.com/Kingcom/armips获得

更新版本可去http://buildbot.orphis.net/armips获得
  k4 I) V. o! B0 G4 d/ r$ p- k# X
ARMIPS assembler特点支持加载ROM并自动编译代码到ROM，省了使用16进制编辑器复制代码进ROM，进行ROM HACK更方便了。
7 ?( |3 l# C" i( G" G& ]. Z# G  D
- ~) B( ?2 Q& O5 [  ^9 RARMIPS命令行用法：
+ Q9 [9 U- `8 z* `+ l
Usage: armips [optional parameters] <FILE>

Optional parameters:
-temp <TEMP>         Output temporary assembly data to <TEMP> file
( }  u! Z! w! |0 [ -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
3 ?! Z+ q! J4 ]+ t -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

File arguments:
8 j5 ?/ q6 r5 b9 w5 S# i <FILE>               Main assembly code file

2 n+ v& w. R8 @, W" X7 S( ]-temp <TEMP>参数是将临时汇编数据输出到<TEMP>文件
-sym <SYM>参数是将sym格式符号输出到<SYM>文件，这格式支持no$psx和no$gba
-sym2 <SYM2>参数是将sym2格式符号输出到<SYM2>文件，这格式支持pcsx2和ppsspp
-root <ROOT>参数是指定执行期间要使用的工作目录
-equ <NAME> <VAL>参数用法不明
! I$ ?5 v! {% O7 f& z8 ^% P-strequ <NAME> <VAL>参数用法不明
/ a' R  r  N9 p" P-erroronwarning参数是当出现任何警告时被视为错误，防止继续编译
# C2 q& Z( ~2 V/ A  Y: J8 S5 l% c
: u* u$ v, s. ^  Y<FILE>是汇编代码文件，可用记事本之类编辑
  m6 |) N4 ~5 n
注释说明：
注释可在单行指令后面“;”和“//”添加
0 z$ a+ C& P2 m) I9 D" w! G“/* */”式也接受
; [; B: U4 g  w& Q3 H; `
例子：
  \% x1 P: Z2 G4 M.open"1234.gba",0x08000000;//打开1234.gba文件，并将起始地址定义为0x08000000
( }! O) Y/ l$ o
.close;/*关闭文件*/

标签说明：
标签名可以包含A~Z字母和数字、下划线。但是它不能以数字开头，所有标签名称不区分大小写。

数值说明：
9 K5 w- d9 O1 b  ?  ?0 f“0xA”和“0Ah”是16进制数值
“0o12”和“12o”是8进制数值
- z  v/ L! C9 c4 W5 w& |! I; |$ m“1010b”和“0b1010”是2进制数值

equ说明：
格式：text equ value
说明：用一个text代替value
例子：
address1 equ 0x12345678
+ n* V- v2 U& ?- m& rldr r0,=address1
.pool

函数说明：

2 b- [( R0 U! `8 z.open函数：
# b+ H- S% j; p格式：
.open "ROM FileName",offset
$ ?0 v8 \9 w6 L. O1 k.open "Old FileName","New FileName",offset
% V6 b6 L. g* P9 S5 A说明：.open函数打开ROM文件，并将ROM文件起始地址设置为offset地址。但结果指定了2个文件，汇编器会将文件复制到第二个路径。

例子：
: w& K8 `- E: s$ t8 S.open "1234.gba",0x08000000
& V; q3 I  R) o
9 I! d; Z7 H! `# }.close函数和.closefile函数：
格式：
- T  ^9 k; y& Z2 E$ R$ Z3 l% b.close
.closefile
* ]* ]. b4 T6 r说明：关闭文件。

.org函数和.orga函数：
格式：
# P: a' i, Q) ~4 u8 k.org RamAddress
.orga FileAddress
说明：
前面用.open函数设置过offset地址的话，那么可以用.org函数设置offset输出地址。
# J1 s9 O1 B4 v
.orga函数可指定ROM文件的输出地址。

.create函数和.createfile函数
9 ~9 N; w+ I! Z" C3 t, B; m$ b格式：
9 C& R* Z) H: y2 C+ p.create "FileName",offset
, {9 S! v5 }" F: |; [  L.createfile "FileName",offset
/ g: V: k- a" u( S1 [3 O: f说明：创建一个文件，如果文件是存在，他会覆盖掉。
( b" _2 C  V, m6 s- H
.area函数
格式：
.area SizeEquation[,fill]
.endarea
说明：如果你要向某地址写入一定字节数值，就用.area函数，SizeEquation是能写入最大字节数，超过就编译失败

例子：向0x100地址写入0x5,0x6,0x7,0x8单字节数据
org 0x100
: a- ~( B9 ]$ |& w$ s  q5 A  m.area 0x8
byte 0x5,0x6,0x7,0x8
.endarea
0 n% h  N) y3 M! w0 ]6 g; v  ]
.align函数
格式：.align num
% B- c! ^8 X2 `3 k. v/ e说明：写零字节，num为零字节数量，用16进制表示。

$ u+ _- i6 G' E7 y.pool函数
9 c. ]; Z, ]0 Q" V3 v格式：.pool
说明：如果代码中有“ldr rx,=value”,就要用.pool对齐。
% s3 E) O9 u2 Z, a. P2 o# U* v例子：
- V1 P3 e4 |, G# K5 gldr r0,=0x12345678;
) z0 P4 h! V7 r- O2 V( V6 E....
.pool

/ D9 d# t$ T2 x8 d/ ].fill函数
格式：
5 b* H0 S' a0 Q; F.fill length[,value]
defs length[,value]
说明：填充一定长度单字节数值，如果未指定value，而填充零字节数值；length和value用16进制表示。

.skip函数：
4 b; {5 c7 R0 v  ]" c  @7 E5 i" I格式：.skip length
说明：跳过指定长度单字节数值，length用16进制表示。
" k; R9 n0 e& {: Q# y
; d, F! u- }4 x# g写单字节：
3 E5 J; W/ B& |  d9 N, r0 M.byte value[,...]
3 p% L; s0 q% K+ m.db value[,...]
6 K# x6 ^) x" Y.ascii value[,...]
.asciiz value[,...]
dcb value[,...]

写双字节：
.halfword value[,...]
.dh value[,...]
, {; s5 `( n2 w7 m' y4 D4 Ldcw value[,...]

2 F1 B  p* A3 O# M& h) v8 H  R写四字节：
- v6 l6 F* N  H& G.word value[,...]
.dw value[,...]
$ V* F1 p7 \! F  e# pdcd value[,...]
) a; J" e  W7 w3 Q- R% L$ ]
写doublewords：
# J# D, ~. V+ N: n& K.doubleword value[,...]
8 S# f0 r' J( U: T.dd value[,...]
9 T) j, j. T" @* h4 xdcq value[,...]
6 }) }$ P4 q% m
写浮点数：
1 f+ E8 Y5 I  O7 Q.float value[,...]
.double value[,...]

ARM的ARM模式和THUMB模式定义：
.arm|ARM模式
.thumb|thumb模式
5 E" @% v1 ]! J# O* b! ^
设置架构：
.psx|PlayStation 1(MIPS R3000)
.ps2|PlayStation 2(EmotionEngine)
. P# S9 Y8 s% s. M.psp|PlayStation Portable(Allegrex)
.n64|Nintendo 64(MIPS R4000)
.rsp|Nintendo 64(RSP)
.gba|GameBoy Advance(ARM7,默认是thumb模式)
.nds|Nintendo DS(ARM9,默认是ARM模式)
.3ds|Nintendo 3DS(ARM11,默认是ARM模式)
( r( D1 D6 }9 N  P.arm.big|
.arm.little|

) C! L  T& E3 g$ Z: `常用函数就写这些了，还有大量函数说明没写，更多说明看readme.md吧。
4 K( p: O. z6 l0 r/ ^, L. ~  o0 ^