ARMIPS assembler使用说明

疾风之狼

ARMIPS assembler是一款ARM/MIPS汇编工具，他是命令行工具，支持ARM7/ARM9/MIPS R3000/MIPS R4000

ARMIPS assembler作者是Kingcom,目前发展到0.9版本
( Z* U5 d2 ^0 C0 f& K' r/ a: \
Kingcom's website：http://aerie.wingdreams.net
# q# s% s3 V; u3 q
7 I3 b! x: z, [$ d. C/ p! yARMIPS assembler源代码可去https://github.com/Kingcom/armips获得
# [5 u& p- m! u, _
2 v& X: h9 _: {' M6 M. ], }更新版本可去http://buildbot.orphis.net/armips获得
$ v) y: w' |7 S
  _+ m( o9 V/ O# w0 b+ ?: p; d6 bARMIPS assembler特点支持加载ROM并自动编译代码到ROM，省了使用16进制编辑器复制代码进ROM，进行ROM HACK更方便了。
$ @  Z- Y. i5 P3 x0 O0 _! D
ARMIPS命令行用法：

Usage: armips [optional parameters] <FILE>
( {, I  `; r0 G; @' T
Optional parameters:
-temp <TEMP>         Output temporary assembly data to <TEMP> file
/ n$ X" q, W9 U, B! m -sym  <SYM>          Output symbol data in the sym format to <SYM> file
7 w7 H8 h3 r" a( b) E -sym2 <SYM2>         Output symbol data in the sym2 format to <SYM2> file
' b$ a9 t4 Q2 S7 b! F9 d% t/ d5 X -root <ROOT>         Use <ROOT> as working directory during execution
0 u" V, B6 I* |/ p -equ  <NAME> <VAL>   Equivalent to '<NAME> equ <VAL>' in code
' ^$ ?5 c9 f1 W" q0 S! m -strequ <NAME> <VAL> Equivalent to '<NAME> equ "<VAL>"' in code
, U& v1 q  |6 v  {8 @ -erroronwarning      Treat all warnings like errors

7 B# l# j+ A8 h7 E( DFile arguments:
5 F. A- n6 m8 }3 f# r- k6 p4 k <FILE>               Main assembly code file
4 v" C8 a1 L$ Z6 U* l8 D
-temp <TEMP>参数是将临时汇编数据输出到<TEMP>文件
9 S, ?2 K! y8 W. V7 M-sym <SYM>参数是将sym格式符号输出到<SYM>文件，这格式支持no$psx和no$gba
-sym2 <SYM2>参数是将sym2格式符号输出到<SYM2>文件，这格式支持pcsx2和ppsspp
-root <ROOT>参数是指定执行期间要使用的工作目录
-equ <NAME> <VAL>参数用法不明
-strequ <NAME> <VAL>参数用法不明
-erroronwarning参数是当出现任何警告时被视为错误，防止继续编译
4 R3 J6 o( t, ^1 P1 d
<FILE>是汇编代码文件，可用记事本之类编辑
4 R9 O  w5 q* |8 O, x, b! }
5 x% Z6 Y) F+ {* o) j- e注释说明：
! R7 Z" |( g/ o7 g( A8 x8 I! h. r注释可在单行指令后面“;”和“//”添加
“/* */”式也接受

例子：
7 E: R1 X/ O; U5 r" _$ k, d) ].open"1234.gba",0x08000000;//打开1234.gba文件，并将起始地址定义为0x08000000
. Z) k: O2 P# K1 o0 k; ~- @
.close;/*关闭文件*/

* O$ B, i( i* p, G- C% h2 q! ~- q标签说明：
标签名可以包含A~Z字母和数字、下划线。但是它不能以数字开头，所有标签名称不区分大小写。
4 V) M3 p, Y$ o
数值说明：
8 f4 w3 U, F0 n“0xA”和“0Ah”是16进制数值
7 k3 x; e/ g+ R: D  Z“0o12”和“12o”是8进制数值
8 a; }/ r- c, i) k0 v“1010b”和“0b1010”是2进制数值

. k* t- g# Y) e3 C* h" q! k" s! G) @; ^equ说明：
格式：text equ value
说明：用一个text代替value
例子：
7 E: g1 v. ^7 J' H& u; |: daddress1 equ 0x12345678
( y  R( f- R; ~# h! z. Fldr r0,=address1
+ G6 [) s7 T0 a.pool
$ s; L4 @$ x; S9 l6 g
9 F. ^. `$ u* `, Q3 Q函数说明：

.open函数：
格式：
.open "ROM FileName",offset
.open "Old FileName","New FileName",offset
! }  v. r6 {8 f0 p7 Y+ p说明：.open函数打开ROM文件，并将ROM文件起始地址设置为offset地址。但结果指定了2个文件，汇编器会将文件复制到第二个路径。

例子：
, k9 A  L, U) Y7 E- J* a2 \.open "1234.gba",0x08000000
- S- V& }8 B! A6 _6 o6 c
) X3 P2 a& s& n$ ^.close函数和.closefile函数：
$ K, ~  p8 r# I* B" ]% s4 \格式：
0 _) p  X  N, v) t0 p" O.close
0 _- t. H0 Z  W- S, \. s.closefile
说明：关闭文件。

* J" q' ?5 ]' Z8 i2 P.org函数和.orga函数：
格式：
& o3 b7 \5 ?: n3 U/ g0 @.org RamAddress
.orga FileAddress
3 U$ s4 M& z8 j说明：
$ {+ t' x  u* |( R6 m# N; q6 |前面用.open函数设置过offset地址的话，那么可以用.org函数设置offset输出地址。
  t4 w; P+ [6 Z
+ h2 l# N. V" M5 W.orga函数可指定ROM文件的输出地址。
3 x. Z5 ~7 x$ z; m' k' j/ V, |
6 ?1 f/ m* b0 T; T4 X; L1 d# g.create函数和.createfile函数
4 \# P6 V6 C3 c0 W3 l6 G格式：
.create "FileName",offset
" x0 v/ }) c: O! V0 b.createfile "FileName",offset
说明：创建一个文件，如果文件是存在，他会覆盖掉。
! x: p4 `1 ~% u8 m
.area函数
格式：
( b( R0 j8 V& L9 L1 f( Z9 n.area SizeEquation[,fill]
) t2 J( p% ^" t9 e; c! P.endarea
1 ]) U: c5 A; l/ C( f说明：如果你要向某地址写入一定字节数值，就用.area函数，SizeEquation是能写入最大字节数，超过就编译失败
8 m9 }/ k1 S3 T
7 h% H; [5 j$ m( z% t例子：向0x100地址写入0x5,0x6,0x7,0x8单字节数据
0 T2 j3 [: Q$ J: `  Lorg 0x100
.area 0x8
byte 0x5,0x6,0x7,0x8
# N* F2 c) T0 Y# y1 E.endarea
! i" W% s% v! f
.align函数
4 x: W- U" V$ M2 K1 y格式：.align num
) _* K7 _: m! {2 i说明：写零字节，num为零字节数量，用16进制表示。

.pool函数
# |6 q1 n( ?! Z# g  P' }! ~格式：.pool
说明：如果代码中有“ldr rx,=value”,就要用.pool对齐。
3 D. C" Z7 V$ u2 h" v例子：
ldr r0,=0x12345678;
) u$ u2 c# Z* c1 U, _, a....
7 G7 N' e2 G- w5 Z7 O; D2 Q- |.pool
1 Z% p7 C3 y# r& S% K$ v% y
# `6 ]' k3 b8 y4 A$ [* M.fill函数
格式：
.fill length[,value]
defs length[,value]
  J3 ~4 R. x8 x! |2 N) F5 `说明：填充一定长度单字节数值，如果未指定value，而填充零字节数值；length和value用16进制表示。
/ s% p; I  z. N+ }* z
.skip函数：
3 r8 X6 W% R% A6 S格式：.skip length
. U* \* z$ w2 e& I4 r说明：跳过指定长度单字节数值，length用16进制表示。

写单字节：
.byte value[,...]
$ I4 h2 Y6 z3 T( z. T+ I* d6 p.db value[,...]
.ascii value[,...]
6 W' R& P' _" ]+ S0 I.asciiz value[,...]
, O# z6 h* n5 A* ?: N0 p( Gdcb value[,...]
! u9 Z/ W  m" U- i
& Q9 T4 ?- e1 h写双字节：
.halfword value[,...]
' @, S# t; E# q3 i. r.dh value[,...]
dcw value[,...]

7 h2 b/ v0 @7 D0 P8 B+ u. T  P写四字节：
.word value[,...]
: I' c) u5 `4 Y7 C.dw value[,...]
9 A( S, ]+ W7 R  ?/ _  Xdcd value[,...]
" y. ^2 H3 e5 o% O
写doublewords：
, R& n9 |6 n4 H7 C0 h( Y.doubleword value[,...]
.dd value[,...]
- i% m+ G( ~: `5 gdcq value[,...]
/ r9 B* A2 B7 d$ `/ z
4 H2 U* ?9 q8 ?写浮点数：
.float value[,...]
.double value[,...]

ARM的ARM模式和THUMB模式定义：
.arm|ARM模式
7 S( U7 `8 [" x! I.thumb|thumb模式

设置架构：
.psx|PlayStation 1(MIPS R3000)
.ps2|PlayStation 2(EmotionEngine)
) H: `4 @+ x' y1 ]  T.psp|PlayStation Portable(Allegrex)
.n64|Nintendo 64(MIPS R4000)
, q; w, v8 b) [# ^  C* M; k.rsp|Nintendo 64(RSP)
.gba|GameBoy Advance(ARM7,默认是thumb模式)
- v  V$ }1 {) W, F- `6 l/ e% [% y.nds|Nintendo DS(ARM9,默认是ARM模式)
2 k' R. t: @+ N( g6 H.3ds|Nintendo 3DS(ARM11,默认是ARM模式)
; T  ?# t2 \0 W( \! \' r4 Z8 z.arm.big|
! i) x8 V; Q1 b! u* U.arm.little|
3 S, l* U0 j( j  c0 T
/ h$ g1 S  T7 @* }! N& _常用函数就写这些了，还有大量函数说明没写，更多说明看readme.md吧。
$ T. i7 o" _) Z3 G- g# P, ?