ARMIPS assembler使用说明

疾风之狼

% e+ v* }" H& q* Y9 v, _! cARMIPS assembler是一款ARM/MIPS汇编工具，他是命令行工具，支持ARM7/ARM9/MIPS R3000/MIPS R4000
2 Z" J1 }5 |7 r' I
% K7 a& k$ z$ w; QARMIPS assembler作者是Kingcom,目前发展到0.9版本
3 x$ a1 e9 B) Z, D
Kingcom's website：http://aerie.wingdreams.net
, m' Q0 X' ~" S$ B/ \+ x
ARMIPS assembler源代码可去https://github.com/Kingcom/armips获得

更新版本可去http://buildbot.orphis.net/armips获得

ARMIPS assembler特点支持加载ROM并自动编译代码到ROM，省了使用16进制编辑器复制代码进ROM，进行ROM HACK更方便了。
5 p$ y1 ^8 G+ O6 t  T) W/ I5 O8 |2 ^; \
ARMIPS命令行用法：
( f  w5 i% I2 G' l; `
Usage: armips [optional parameters] <FILE>

Optional parameters:
1 q$ Q! f7 I, v* b$ U; s1 v4 w4 n -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
; N7 X+ T( }& [& g3 ?! W -root <ROOT>         Use <ROOT> as working directory during execution
# B' K# _$ U( X# ~! M -equ  <NAME> <VAL>   Equivalent to '<NAME> equ <VAL>' in code
-strequ <NAME> <VAL> Equivalent to '<NAME> equ "<VAL>"' in code
; f+ _+ V' F/ t7 T( f7 P+ ` -erroronwarning      Treat all warnings like errors
) K# h( n% s" K: d( d2 @
File arguments:
<FILE>               Main assembly code file

9 ]& u  R: g0 |7 p-temp <TEMP>参数是将临时汇编数据输出到<TEMP>文件
3 d9 Q( f7 |3 G( V/ N-sym <SYM>参数是将sym格式符号输出到<SYM>文件，这格式支持no$psx和no$gba
-sym2 <SYM2>参数是将sym2格式符号输出到<SYM2>文件，这格式支持pcsx2和ppsspp
9 x  R" v6 f# M. N& l4 U+ A  V-root <ROOT>参数是指定执行期间要使用的工作目录
-equ <NAME> <VAL>参数用法不明
8 _0 h2 k# T- D2 G$ v) F' L-strequ <NAME> <VAL>参数用法不明
& w2 W' }; w) Q-erroronwarning参数是当出现任何警告时被视为错误，防止继续编译
! H$ q5 B7 x  _$ `: G, y
<FILE>是汇编代码文件，可用记事本之类编辑

* }4 o2 m! G* D9 Z1 M1 W  V, n注释说明：
注释可在单行指令后面“;”和“//”添加
“/* */”式也接受
. Y" r% b9 Q" _6 S, }, z, ?; c
8 M( x3 B, Z% K+ ^! o$ P6 p例子：
  v+ e0 n& N) T: ?.open"1234.gba",0x08000000;//打开1234.gba文件，并将起始地址定义为0x08000000
9 a( N0 e8 i6 o$ V/ p) z( I( N
.close;/*关闭文件*/
4 P/ F! B* ^: a' O
标签说明：
标签名可以包含A~Z字母和数字、下划线。但是它不能以数字开头，所有标签名称不区分大小写。

数值说明：
“0xA”和“0Ah”是16进制数值
“0o12”和“12o”是8进制数值
“1010b”和“0b1010”是2进制数值
6 O4 M& B, P) j5 x; g/ Z" @
3 k5 q4 y: S0 pequ说明：
: r2 j; Z( {% j- a9 C) @0 h格式：text equ value
# l6 Q/ U& h2 z说明：用一个text代替value
例子：
1 O( M, D2 ^8 J8 h6 Aaddress1 equ 0x12345678
& o9 l; F/ }+ q' V+ g. }ldr r0,=address1
: r' J, d& O1 I% C$ @( J5 ~.pool
; L# W& A( l& U' Z: G+ Q8 d/ z
函数说明：
3 A3 }1 M& ^" D/ o$ {, m2 z; U8 D
.open函数：
格式：
+ \0 k2 Y' m9 o9 Y.open "ROM FileName",offset
.open "Old FileName","New FileName",offset
说明：.open函数打开ROM文件，并将ROM文件起始地址设置为offset地址。但结果指定了2个文件，汇编器会将文件复制到第二个路径。
2 f# G8 r9 F3 {
3 O! |) `0 ^2 g. ]6 a5 Z$ j例子：
! R% h7 V* Y8 M.open "1234.gba",0x08000000
; w5 Z. b! u3 J# X3 b. y$ ~  }
.close函数和.closefile函数：
: L  x, F: v0 D* h% @& b格式：
+ G1 r' Q9 d# F  A1 I1 f.close
+ a: f7 }6 d( N( c( L.closefile
说明：关闭文件。

.org函数和.orga函数：
( A0 Y8 w2 k5 [+ X! m: E2 x6 ^格式：
. M/ I2 }0 p3 Z. l6 N2 U* b9 B.org RamAddress
( M6 N- d* i) N/ g: ].orga FileAddress
说明：
5 k4 @7 {% x* ~8 S- @5 g5 _前面用.open函数设置过offset地址的话，那么可以用.org函数设置offset输出地址。

6 ^" ^2 |& \9 g.orga函数可指定ROM文件的输出地址。

: |; [. B2 c* F6 R, s.create函数和.createfile函数
  h, q; O: p. K格式：
9 g' v( e; }4 m7 ?0 f; a% ~.create "FileName",offset
3 Q" P5 _* g% h: Z$ ^) p.createfile "FileName",offset
% R* W7 C% Y3 }# J说明：创建一个文件，如果文件是存在，他会覆盖掉。
' H; l8 a$ i$ _/ T' ]% H
.area函数
' M3 n. z  G" N( `3 n1 L* C5 ~# o0 p格式：
- L5 V3 `! }- F* J6 E0 p6 ~; T.area SizeEquation[,fill]
.endarea
说明：如果你要向某地址写入一定字节数值，就用.area函数，SizeEquation是能写入最大字节数，超过就编译失败

. u1 i5 b! ~8 h+ z6 C例子：向0x100地址写入0x5,0x6,0x7,0x8单字节数据
" s0 h2 C! a0 ]: u' [org 0x100
/ q( X5 E* H& U8 b4 J1 {.area 0x8
- @9 [* |) w) \7 Ibyte 0x5,0x6,0x7,0x8
4 f+ O: X- x9 k9 Q8 ].endarea

5 L0 M* ?% \5 R5 C. h.align函数
) U9 r& g4 y8 C格式：.align num
( d. `' @% W, a9 {3 t( Z说明：写零字节，num为零字节数量，用16进制表示。

.pool函数
格式：.pool
说明：如果代码中有“ldr rx,=value”,就要用.pool对齐。
1 V! d3 p6 G; P例子：
, B0 w9 ^' \+ ~7 |; Z6 ]% cldr r0,=0x12345678;
5 Y" D3 D' ?' ]/ o. p& N$ k( H....
6 n7 d, p  J  C.pool

+ T+ k1 V. ]6 n) J/ c0 I3 P- D/ z.fill函数
格式：
.fill length[,value]
defs length[,value]
说明：填充一定长度单字节数值，如果未指定value，而填充零字节数值；length和value用16进制表示。

. {: p. A( W  G8 ?6 a- I0 A- }.skip函数：
格式：.skip length
说明：跳过指定长度单字节数值，length用16进制表示。

% D, u$ V) a' a2 J. I写单字节：
0 y, g3 N- f6 T$ {, I.byte value[,...]
.db value[,...]
" M' H! {: E! P. m. E& M( M4 q.ascii value[,...]
) B- ^$ b# K3 O9 {. K# e.asciiz value[,...]
: x* X9 h- Q5 q, X3 b2 x+ k* A) w+ ndcb value[,...]

) @' s/ ?  b# ^: G+ t% p$ \$ _# c写双字节：
$ G( R, j% E0 }3 B2 h.halfword value[,...]
.dh value[,...]
8 `; ]" t: A1 r- O/ |5 Qdcw value[,...]

% y& s1 v/ B! K4 X. ^5 {! w; `写四字节：
.word value[,...]
, h1 Q4 v1 n9 `! y8 E5 a" h! E.dw value[,...]
7 ~) l# U* T7 T1 y6 G/ wdcd value[,...]

写doublewords：
- ]3 H7 \6 C  \+ S) F.doubleword value[,...]
# m; |8 w9 C& ]3 o+ b% V, b, I.dd value[,...]
4 @# v, d- m# l* X4 rdcq value[,...]
1 K+ F2 t* [1 Z3 E0 |- v4 z+ a* ?' d
写浮点数：
.float value[,...]
.double value[,...]

1 i1 B+ [. v# H) z' s" ]# |ARM的ARM模式和THUMB模式定义：
.arm|ARM模式
5 K' [6 b& J: i6 t' T.thumb|thumb模式

设置架构：
% G( I  T& x1 u+ D, P.psx|PlayStation 1(MIPS R3000)
.ps2|PlayStation 2(EmotionEngine)
.psp|PlayStation Portable(Allegrex)
.n64|Nintendo 64(MIPS R4000)
0 r- V3 Z8 N+ V8 @4 A( d' z.rsp|Nintendo 64(RSP)
% @! U+ D6 P+ n) y4 x1 w.gba|GameBoy Advance(ARM7,默认是thumb模式)
% ]+ H$ ]  F. `! ]4 {0 {; f.nds|Nintendo DS(ARM9,默认是ARM模式)
.3ds|Nintendo 3DS(ARM11,默认是ARM模式)
.arm.big|
.arm.little|

常用函数就写这些了，还有大量函数说明没写，更多说明看readme.md吧。
- O* U9 _3 Q. l' R" s" ^