ARMIPS assembler使用说明

疾风之狼

ARMIPS assembler是一款ARM/MIPS汇编工具，他是命令行工具，支持ARM7/ARM9/MIPS R3000/MIPS R4000
- G5 F0 F' O+ r6 [2 J. m8 J5 ?$ l
ARMIPS assembler作者是Kingcom,目前发展到0.9版本

2 [  q5 B& t* X- d  p4 ^+ V$ lKingcom's website：http://aerie.wingdreams.net
6 O1 i; h5 T/ w: F: a
ARMIPS assembler源代码可去https://github.com/Kingcom/armips获得
# r9 Z: u5 g$ K; L
更新版本可去http://buildbot.orphis.net/armips获得

ARMIPS assembler特点支持加载ROM并自动编译代码到ROM，省了使用16进制编辑器复制代码进ROM，进行ROM HACK更方便了。
1 M- ?" u  L; ?3 V$ q
8 V& l; r% I3 v+ z0 U8 qARMIPS命令行用法：
0 f+ W* C6 D' Q" C5 y( T% i
5 ^2 }0 J; J4 n% t+ N0 Z1 D) v" NUsage: armips [optional parameters] <FILE>
( k/ ^! v) G1 F- u. f6 u
" _' O7 s5 r5 x; n7 C/ x) bOptional parameters:
-temp <TEMP>         Output temporary assembly data to <TEMP> file
-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
- W# w" i/ f& W -erroronwarning      Treat all warnings like errors

File arguments:
( A4 C( s1 B9 Z% ?! R1 T+ r <FILE>               Main assembly code file
) b. K) }5 \, j
-temp <TEMP>参数是将临时汇编数据输出到<TEMP>文件
-sym <SYM>参数是将sym格式符号输出到<SYM>文件，这格式支持no$psx和no$gba
1 p' D& H$ J# ?; Z. P/ T2 `$ @-sym2 <SYM2>参数是将sym2格式符号输出到<SYM2>文件，这格式支持pcsx2和ppsspp
6 e; @$ R& m9 e' \-root <ROOT>参数是指定执行期间要使用的工作目录
-equ <NAME> <VAL>参数用法不明
, H/ G9 k% z. n" u6 ?-strequ <NAME> <VAL>参数用法不明
-erroronwarning参数是当出现任何警告时被视为错误，防止继续编译
. n! |3 F( N+ T0 m6 B+ I* g
% I& }" o* H1 B( r+ N1 H. T<FILE>是汇编代码文件，可用记事本之类编辑

4 r4 S. K$ z+ R0 d$ H- V' I- ^! A注释说明：
注释可在单行指令后面“;”和“//”添加
/ J. N$ \4 C8 G' i- m8 [! ^' E“/* */”式也接受
% E5 ^( I  J! d; [9 U! d
* K, N2 q% n' T+ ~" N% s1 N例子：
.open"1234.gba",0x08000000;//打开1234.gba文件，并将起始地址定义为0x08000000

$ M/ F/ a  |  V* A.close;/*关闭文件*/
- G* }* b3 d& i- x7 Z! l! T
标签说明：
: d, c) {2 d/ _5 V' {6 a标签名可以包含A~Z字母和数字、下划线。但是它不能以数字开头，所有标签名称不区分大小写。
" ^! k: q. |! F( S& T' |# A
数值说明：
“0xA”和“0Ah”是16进制数值
“0o12”和“12o”是8进制数值
“1010b”和“0b1010”是2进制数值
; G! v' O+ B. S/ C+ |, [. x# o9 x$ C
equ说明：
% d* t/ c: W3 Z格式：text equ value
2 g/ z! f9 ~" d) n- a说明：用一个text代替value
例子：
& S7 U! q' A; n$ s' a* K" |address1 equ 0x12345678
ldr r0,=address1
.pool

函数说明：

.open函数：
& x2 n+ y$ k+ G' d' z: D格式：
8 ~4 O2 r3 x; {: U.open "ROM FileName",offset
  b4 Y2 e$ P. P1 d.open "Old FileName","New FileName",offset
说明：.open函数打开ROM文件，并将ROM文件起始地址设置为offset地址。但结果指定了2个文件，汇编器会将文件复制到第二个路径。
2 A' }" t( I7 E" a$ r8 \4 h7 c
例子：
( A5 U+ b$ y; v' {8 c9 v# q6 ]! o.open "1234.gba",0x08000000
$ t$ {* N/ q8 L& I  H. [" h! z
.close函数和.closefile函数：
格式：
.close
" A7 v  \$ F, Q* Z: }* ^4 N.closefile
说明：关闭文件。

.org函数和.orga函数：
格式：
.org RamAddress
.orga FileAddress
7 N9 W( H5 l& `& I! ]9 |说明：
6 S4 F8 J$ E7 B& k- _# e1 M# Q前面用.open函数设置过offset地址的话，那么可以用.org函数设置offset输出地址。
; Y" l# D& X, V% r2 c
.orga函数可指定ROM文件的输出地址。
  y& O; q0 S  [1 Q$ l$ `3 B
' |3 b0 e  L: A) ?3 _.create函数和.createfile函数
0 |7 Y0 ]: H  P5 _格式：
' m& b4 Y7 F2 R" ~* B# V" v7 Y.create "FileName",offset
! \- y) I( B- m& l.createfile "FileName",offset
7 A2 `; H8 @( h! L( i, M说明：创建一个文件，如果文件是存在，他会覆盖掉。

.area函数
格式：
.area SizeEquation[,fill]
& Z- w1 ?& D- P- ]3 k.endarea
说明：如果你要向某地址写入一定字节数值，就用.area函数，SizeEquation是能写入最大字节数，超过就编译失败
( T0 E$ }: Z8 r! }( k
6 n  `: h/ j) K例子：向0x100地址写入0x5,0x6,0x7,0x8单字节数据
org 0x100
.area 0x8
byte 0x5,0x6,0x7,0x8
/ |& ~1 f4 ]% ?+ [. z$ Q.endarea

.align函数
1 t# a& x3 ^( u$ n, G0 O# B) s格式：.align num
/ p- `$ u  K: ?9 c8 ]0 p2 r说明：写零字节，num为零字节数量，用16进制表示。

' B% ]5 ]& s/ A% k' |.pool函数
' x" v1 C  X: K) V6 T格式：.pool
9 g2 P7 l% R, B3 L/ |说明：如果代码中有“ldr rx,=value”,就要用.pool对齐。
例子：
ldr r0,=0x12345678;
% t$ p; x6 l# `; q....
9 _+ o/ c  P  J  u2 e.pool

.fill函数
5 ^0 t0 t6 q4 [" R格式：
# a5 v7 t0 G/ c* N3 z/ ]+ Y.fill length[,value]
defs length[,value]
% j; n, V9 n* P6 L4 _* G' G说明：填充一定长度单字节数值，如果未指定value，而填充零字节数值；length和value用16进制表示。
" [1 X9 l% c$ W6 u; x' h$ T
.skip函数：
格式：.skip length
说明：跳过指定长度单字节数值，length用16进制表示。

. b  q$ B4 }( z9 I$ ^; S2 |& Q" _写单字节：
# h+ E# P7 i7 {.byte value[,...]
3 N: {' T2 T; S- x6 b2 f! C.db value[,...]
.ascii value[,...]
.asciiz value[,...]
  c! s% Z/ d  n- ^, U" M8 mdcb value[,...]

写双字节：
.halfword value[,...]
  f0 b; U4 P6 I- L' c6 t.dh value[,...]
  q  E: {# m0 j8 ?. ^2 _dcw value[,...]

写四字节：
.word value[,...]
.dw value[,...]
) T+ |4 Q: X8 |! O7 Adcd value[,...]
; P/ h; @% ?( U" e' t% @
写doublewords：
.doubleword value[,...]
0 \: |5 Q1 B, Q1 ?! O  N.dd value[,...]
dcq value[,...]
4 G; w; g& p1 [1 p
写浮点数：
.float value[,...]
8 `7 x1 g+ R  _.double value[,...]

ARM的ARM模式和THUMB模式定义：
& Q2 g: G0 Q0 F6 R.arm|ARM模式
.thumb|thumb模式
$ x8 `. S4 `6 l, ]  ~7 ~7 ~
设置架构：
5 |$ c, v* R* w0 x4 a/ ?.psx|PlayStation 1(MIPS R3000)
.ps2|PlayStation 2(EmotionEngine)
5 s( g$ [; I4 m% Y. v.psp|PlayStation Portable(Allegrex)
# a5 Q. j  j$ M' E.n64|Nintendo 64(MIPS R4000)
.rsp|Nintendo 64(RSP)
, C# T7 {3 w' `! u8 T0 z.gba|GameBoy Advance(ARM7,默认是thumb模式)
.nds|Nintendo DS(ARM9,默认是ARM模式)
.3ds|Nintendo 3DS(ARM11,默认是ARM模式)
1 t7 g0 w3 W0 s2 w& Q; F2 O1 H.arm.big|
.arm.little|

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