ARMIPS assembler使用说明

疾风之狼

% P6 ?* F; j5 R: xARMIPS assembler是一款ARM/MIPS汇编工具，他是命令行工具，支持ARM7/ARM9/MIPS R3000/MIPS R4000
8 h$ B+ w7 @& M4 l
% c: u( h# U% x& [* t% _ARMIPS assembler作者是Kingcom,目前发展到0.9版本
+ f. b/ R, q0 N6 A
" X6 W* Y) }* D& G: N( V; z* I% GKingcom's website：http://aerie.wingdreams.net
; `2 _9 t( c/ n/ Q& b. T
& l% d/ }" ~4 x, OARMIPS assembler源代码可去https://github.com/Kingcom/armips获得

! L9 `2 M6 e' s/ G& W更新版本可去http://buildbot.orphis.net/armips获得

ARMIPS assembler特点支持加载ROM并自动编译代码到ROM，省了使用16进制编辑器复制代码进ROM，进行ROM HACK更方便了。
- q$ G6 m) T$ t4 z5 {5 p& L
ARMIPS命令行用法：

1 f* ?7 q; d# _1 n+ s# J; }+ H5 jUsage: armips [optional parameters] <FILE>

% m) n( s% x2 \( ^Optional parameters:
-temp <TEMP>         Output temporary assembly data to <TEMP> file
-sym  <SYM>          Output symbol data in the sym format to <SYM> file
# @4 S4 _2 f9 z0 V -sym2 <SYM2>         Output symbol data in the sym2 format to <SYM2> file
" u# L( A, i# N5 N -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
-erroronwarning      Treat all warnings like errors
. ^$ N5 G! T" Z2 `
) x7 d. {3 B  Z' e! K% VFile arguments:
7 i2 ]% y  W" ^ <FILE>               Main assembly code file

-temp <TEMP>参数是将临时汇编数据输出到<TEMP>文件
  z) w: `* j. H, N; ~) m-sym <SYM>参数是将sym格式符号输出到<SYM>文件，这格式支持no$psx和no$gba
. A& G" M; R( I  D* c# r$ t-sym2 <SYM2>参数是将sym2格式符号输出到<SYM2>文件，这格式支持pcsx2和ppsspp
-root <ROOT>参数是指定执行期间要使用的工作目录
4 f. ]' s) k- x4 V3 e8 @; {-equ <NAME> <VAL>参数用法不明
-strequ <NAME> <VAL>参数用法不明
-erroronwarning参数是当出现任何警告时被视为错误，防止继续编译

2 g& d" w5 T1 z2 [9 x. O<FILE>是汇编代码文件，可用记事本之类编辑

( K3 [7 a8 W5 K+ `4 }注释说明：
注释可在单行指令后面“;”和“//”添加
“/* */”式也接受
- C7 }, H8 ~$ W0 S8 x2 O" _, p# r
例子：
, @( d; r1 D5 t.open"1234.gba",0x08000000;//打开1234.gba文件，并将起始地址定义为0x08000000

.close;/*关闭文件*/
* i; B2 f5 g& K5 u9 [1 P
. m4 R" ?( z( O9 Z  N: h( V标签说明：
标签名可以包含A~Z字母和数字、下划线。但是它不能以数字开头，所有标签名称不区分大小写。

数值说明：
“0xA”和“0Ah”是16进制数值
“0o12”和“12o”是8进制数值
“1010b”和“0b1010”是2进制数值

equ说明：
6 M: M& X# N4 O3 O0 \  B格式：text equ value
4 J( {  L6 z) X, b/ K4 v说明：用一个text代替value
例子：
address1 equ 0x12345678
ldr r0,=address1
.pool

4 ?; {) s/ j- [$ K; L: K6 }& F函数说明：

.open函数：
格式：
0 o" A' `( a- u  Q.open "ROM FileName",offset
( ~# g3 S: o, N.open "Old FileName","New FileName",offset
! ^" H" D- R1 V- T说明：.open函数打开ROM文件，并将ROM文件起始地址设置为offset地址。但结果指定了2个文件，汇编器会将文件复制到第二个路径。

例子：
% n+ X/ F+ m" E2 H7 j3 a.open "1234.gba",0x08000000
% W8 F2 s/ q" L3 l3 X4 X6 B! z* _
7 T4 _% l8 E( u4 n. I.close函数和.closefile函数：
格式：
+ ^6 @  q& {5 `' ^' P.close
.closefile
说明：关闭文件。

0 S8 g. M+ F) X* V0 L.org函数和.orga函数：
格式：
2 B$ r& F4 }' x2 y' g.org RamAddress
9 s% S+ @7 y3 [% E, R.orga FileAddress
说明：
8 J% c# _+ m% u8 k6 l4 a前面用.open函数设置过offset地址的话，那么可以用.org函数设置offset输出地址。

.orga函数可指定ROM文件的输出地址。
# `7 ]5 s+ h( Z( {+ b$ o
.create函数和.createfile函数
格式：
% [! m! Y% m3 |1 z( J- W.create "FileName",offset
& Q; ^$ D( h! j% q: u* p.createfile "FileName",offset
说明：创建一个文件，如果文件是存在，他会覆盖掉。

.area函数
格式：
' g) ~4 [$ k8 f% N& T& K.area SizeEquation[,fill]
.endarea
说明：如果你要向某地址写入一定字节数值，就用.area函数，SizeEquation是能写入最大字节数，超过就编译失败

8 F8 X1 f2 M* m例子：向0x100地址写入0x5,0x6,0x7,0x8单字节数据
org 0x100
.area 0x8
* m9 R4 ~1 o1 L6 P  t, e/ @, Nbyte 0x5,0x6,0x7,0x8
.endarea

.align函数
格式：.align num
. u7 p  r  _6 o0 o* a/ P. C说明：写零字节，num为零字节数量，用16进制表示。

.pool函数
格式：.pool
说明：如果代码中有“ldr rx,=value”,就要用.pool对齐。
例子：
ldr r0,=0x12345678;
  q6 L; R2 n1 }- Q....
.pool
* L6 k6 ^0 z6 F5 J0 |
.fill函数
格式：
.fill length[,value]
' X# u, D3 W" @defs length[,value]
说明：填充一定长度单字节数值，如果未指定value，而填充零字节数值；length和value用16进制表示。

- e* N! V, l) Z; c& N9 \.skip函数：
3 R9 n9 S3 J7 f' ]格式：.skip length
2 P: s! l; q$ h0 |说明：跳过指定长度单字节数值，length用16进制表示。
0 y: R( e# o, q$ S& H
写单字节：
- ]% r, |2 U% c* P: U! ].byte value[,...]
.db value[,...]
.ascii value[,...]
.asciiz value[,...]
dcb value[,...]
! u9 `5 q' g8 ]8 T) D! e
3 \& G/ f  R& P3 u; f写双字节：
' s7 c% u( R% |2 j; P.halfword value[,...]
! w% _, o8 M( T6 R* }$ h) R; i5 C( f* I.dh value[,...]
: a* l1 Y0 |6 P$ c3 ~: Sdcw value[,...]
8 u7 _$ q+ M+ {9 }9 u5 S
写四字节：
+ c1 G- ~, _; ~, ~5 Z.word value[,...]
) Y9 |6 |  o+ _.dw value[,...]
dcd value[,...]

写doublewords：
: H0 y7 e& p& k1 n8 a, H.doubleword value[,...]
.dd value[,...]
- O( d" d7 X7 T8 Q, U8 x: Idcq value[,...]

1 x: H: K  n- F) k$ h& Q  i6 w写浮点数：
7 N$ l) t* L: I* n; v/ u.float value[,...]
4 X7 O4 r" p! Z  b* _.double value[,...]

/ s. \0 q- n7 yARM的ARM模式和THUMB模式定义：
.arm|ARM模式
& l+ z  x3 Z% ~/ ?8 _- t# C.thumb|thumb模式

设置架构：
.psx|PlayStation 1(MIPS R3000)
- K) u6 H; n4 k9 y- `.ps2|PlayStation 2(EmotionEngine)
9 o9 z9 j# m, Z9 Q6 m4 ].psp|PlayStation Portable(Allegrex)
( x. W! R/ A6 m: L7 s& z.n64|Nintendo 64(MIPS R4000)
.rsp|Nintendo 64(RSP)
0 h" }2 _/ i5 W2 h.gba|GameBoy Advance(ARM7,默认是thumb模式)
.nds|Nintendo DS(ARM9,默认是ARM模式)
# a8 r6 H+ d9 n- M8 m.3ds|Nintendo 3DS(ARM11,默认是ARM模式)
5 Q. |) }- o0 X5 s* I3 W.arm.big|
.arm.little|

常用函数就写这些了，还有大量函数说明没写，更多说明看readme.md吧。
5 Q! C. F, m% g- f7 W