ARMIPS assembler使用说明

疾风之狼

" y" z5 L% m' z5 Q, u) t# cARMIPS assembler是一款ARM/MIPS汇编工具，他是命令行工具，支持ARM7/ARM9/MIPS R3000/MIPS R4000

ARMIPS assembler作者是Kingcom,目前发展到0.9版本
$ n' p9 x) o( R  O
- A4 F- [4 Y* X# AKingcom's website：http://aerie.wingdreams.net

ARMIPS assembler源代码可去https://github.com/Kingcom/armips获得
. x) z: N* g3 g( J" v% F4 X: R( Q
0 B( _( J6 e$ Q7 s更新版本可去http://buildbot.orphis.net/armips获得
6 U+ I$ H% |' o; T5 U6 P
ARMIPS assembler特点支持加载ROM并自动编译代码到ROM，省了使用16进制编辑器复制代码进ROM，进行ROM HACK更方便了。
1 \! B4 C7 G2 G" y: t) K
. }0 k7 r$ S+ Z( l2 W! OARMIPS命令行用法：
7 M2 D' L; M! }2 _5 ]4 Z3 }' C( a
8 h' k/ ^5 ~) z- oUsage: armips [optional parameters] <FILE>

Optional parameters:
# ]' u$ Q; |! A% A5 z0 B+ v -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
0 D& Q# j2 H/ u5 I5 ^2 m* o( G -equ  <NAME> <VAL>   Equivalent to '<NAME> equ <VAL>' in code
& i! \7 s& w% ^# h3 Q -strequ <NAME> <VAL> Equivalent to '<NAME> equ "<VAL>"' in code
/ B% B" O5 ~  p6 C7 ?1 S0 G$ R) A -erroronwarning      Treat all warnings like errors

' a( f! h" ?% o+ L! x# w9 qFile arguments:
& e6 ~3 {/ e5 k# o6 u <FILE>               Main assembly code file
8 P  [0 \- s+ @. F! `6 j  I
3 @1 L/ H" }; e1 @* B: o-temp <TEMP>参数是将临时汇编数据输出到<TEMP>文件
2 I) X" L6 v' E0 n-sym <SYM>参数是将sym格式符号输出到<SYM>文件，这格式支持no$psx和no$gba
& h) V& J# J* d* f+ |-sym2 <SYM2>参数是将sym2格式符号输出到<SYM2>文件，这格式支持pcsx2和ppsspp
-root <ROOT>参数是指定执行期间要使用的工作目录
; e! G: U) o4 B. L-equ <NAME> <VAL>参数用法不明
-strequ <NAME> <VAL>参数用法不明
-erroronwarning参数是当出现任何警告时被视为错误，防止继续编译

<FILE>是汇编代码文件，可用记事本之类编辑

! P3 b& u* A  e3 R9 ~注释说明：
& B2 O6 E* ~' c* z( s3 v0 _* a: b注释可在单行指令后面“;”和“//”添加
% p0 r6 F& i9 o1 d1 O$ S“/* */”式也接受

' n. B0 Q8 j+ Q& \例子：
7 a5 L" R, @$ l7 I% _' K.open"1234.gba",0x08000000;//打开1234.gba文件，并将起始地址定义为0x08000000

7 J  E3 Y$ m5 Q6 q/ j.close;/*关闭文件*/
2 E- f2 \( _7 W% a+ l# B% X: a9 f
标签说明：
标签名可以包含A~Z字母和数字、下划线。但是它不能以数字开头，所有标签名称不区分大小写。
+ }7 b% H5 }% L
4 W  u0 B+ r4 ?/ p5 v数值说明：
“0xA”和“0Ah”是16进制数值
7 p9 j. E- A" t; c7 K( G“0o12”和“12o”是8进制数值
! X! c: ?# n2 |- m8 j$ p* D6 U& ]7 ^“1010b”和“0b1010”是2进制数值
& W& O2 g3 L/ n- p  z2 b, A
0 {1 g1 J) }9 K0 Q' Oequ说明：
格式：text equ value
说明：用一个text代替value
$ i* h! }/ Y9 h3 p( h4 K: U: A! V例子：
address1 equ 0x12345678
ldr r0,=address1
& A5 ]' T4 }3 h; Q8 W8 l.pool
6 y% `; W& S% V2 D0 z; a0 @- M
函数说明：
' A: R8 \6 H* {6 g& Z" ^" \
  D- B3 r7 I6 W! P+ A! r& u6 O$ C.open函数：
- F* X, h* ^4 U3 ?* ~4 l3 w* |格式：
0 s' \! Y! ^+ Q/ e* G.open "ROM FileName",offset
.open "Old FileName","New FileName",offset
$ {& {9 e  N1 i& S, @5 Y说明：.open函数打开ROM文件，并将ROM文件起始地址设置为offset地址。但结果指定了2个文件，汇编器会将文件复制到第二个路径。
4 ?" f9 L0 J! T7 {* Y
4 a9 C  j5 w: h* \; s( y1 K例子：
5 U& k( G1 p$ j. J: K8 A! z5 O.open "1234.gba",0x08000000
+ s) B# \% j* w3 q+ ^
, h; c, B+ H% Y: {.close函数和.closefile函数：
格式：
.close
.closefile
- i% D3 f  n! ^$ k) T& ^4 |, t说明：关闭文件。
: _0 ^, P, T) v3 q! I) D  t; X
" H, o9 ?, N. b7 u.org函数和.orga函数：
格式：
.org RamAddress
' i' v* b/ `1 R6 q/ `# K: b5 [; W.orga FileAddress
说明：
前面用.open函数设置过offset地址的话，那么可以用.org函数设置offset输出地址。

" f2 R0 ?* t8 s( |3 z3 b% q, X.orga函数可指定ROM文件的输出地址。

.create函数和.createfile函数
格式：
.create "FileName",offset
.createfile "FileName",offset
说明：创建一个文件，如果文件是存在，他会覆盖掉。
, [1 @  R# r& T) y! }/ f4 k
" X/ K& d! e; ^, K.area函数
格式：
.area SizeEquation[,fill]
& b. t+ }& ^; j.endarea
说明：如果你要向某地址写入一定字节数值，就用.area函数，SizeEquation是能写入最大字节数，超过就编译失败

例子：向0x100地址写入0x5,0x6,0x7,0x8单字节数据
: f9 f0 ^, Y- R& ?0 ~' J7 ^org 0x100
* H' k6 v- u; T  p1 H& x4 b.area 0x8
' b: b  K. D  I0 y) K% H$ Mbyte 0x5,0x6,0x7,0x8
' M% q' h& Y( W: y2 s.endarea

+ `* U: O7 v& J8 i. s.align函数
- Y: X# p& H$ F) r: `格式：.align num
说明：写零字节，num为零字节数量，用16进制表示。
, a& z4 G0 R( y* K' R" I
  c0 m# b. S1 I.pool函数
格式：.pool
说明：如果代码中有“ldr rx,=value”,就要用.pool对齐。
5 M7 f$ x( H6 G+ m7 _例子：
ldr r0,=0x12345678;
9 [1 N: ^* A! j" T+ e....
7 L. C4 C( a0 z1 i& |7 y) B1 ~.pool
* G  x: l& H' }* R- Y
.fill函数
1 I! D: F( g# Y: i格式：
.fill length[,value]
defs length[,value]
) U% y) f) [& ^$ s说明：填充一定长度单字节数值，如果未指定value，而填充零字节数值；length和value用16进制表示。
$ K5 [! |$ D% d" T
.skip函数：
! a# B+ J  \/ Z6 D1 O( X格式：.skip length
2 `2 v2 F: W1 L' w$ _2 _8 }1 F$ o说明：跳过指定长度单字节数值，length用16进制表示。

) h  w2 S% K3 y3 I4 @. s2 p写单字节：
5 g% s* i* P7 V/ E.byte value[,...]
.db value[,...]
.ascii value[,...]
' D" k+ C) \2 @2 Z' `1 d4 x.asciiz value[,...]
7 z3 d& e9 u1 q" [) J& g- |$ A# pdcb value[,...]

# m" ^7 J. w7 L$ u3 z写双字节：
6 f" w& Q8 G" G6 K.halfword value[,...]
.dh value[,...]
dcw value[,...]
( Q  x% J% y0 i5 E2 e- M
- v7 H' ~& @+ Q8 h) h: E写四字节：
.word value[,...]
.dw value[,...]
1 p) W( C+ I, Cdcd value[,...]
: C7 g7 s0 F7 s7 c: d% ~( q, g
( t# H2 Q# m) ^写doublewords：
.doubleword value[,...]
.dd value[,...]
dcq value[,...]

9 p8 t# i0 `- [写浮点数：
.float value[,...]
4 N) X% N& m! m  d5 p.double value[,...]
, B+ w4 S! q/ y# B: p% z% V  ~
6 Y0 ~$ q# t# N- i2 V# `ARM的ARM模式和THUMB模式定义：
.arm|ARM模式
; F2 I' {& ?8 _, O/ k; a.thumb|thumb模式

设置架构：
.psx|PlayStation 1(MIPS R3000)
! M& J; d& @) j6 E/ G.ps2|PlayStation 2(EmotionEngine)
6 S! x$ O% {$ z9 e2 ~/ o. D.psp|PlayStation Portable(Allegrex)
.n64|Nintendo 64(MIPS R4000)
.rsp|Nintendo 64(RSP)
.gba|GameBoy Advance(ARM7,默认是thumb模式)
2 i$ E1 i- N- c6 e- g- e  }.nds|Nintendo DS(ARM9,默认是ARM模式)
! m" j, J- u" C+ R0 N; b0 k* [0 t. J.3ds|Nintendo 3DS(ARM11,默认是ARM模式)
.arm.big|
  s& s. M4 k4 J2 X. Y.arm.little|

5 S+ Z  c% J2 S" ]! j! `2 w常用函数就写这些了，还有大量函数说明没写，更多说明看readme.md吧。