ARMIPS assembler使用说明

疾风之狼

ARMIPS assembler是一款ARM/MIPS汇编工具，他是命令行工具，支持ARM7/ARM9/MIPS R3000/MIPS R4000
6 R5 B+ Y$ t. C& \1 e3 }
ARMIPS assembler作者是Kingcom,目前发展到0.9版本
/ r& d3 A  `: q- Q' N* l9 @2 n- r* D
- L" U* ~4 y) p( tKingcom's website：http://aerie.wingdreams.net

ARMIPS assembler源代码可去https://github.com/Kingcom/armips获得

/ E" c& y0 n; {4 ~% ?更新版本可去http://buildbot.orphis.net/armips获得
3 f% n! A6 C0 W; y, w3 r' a
ARMIPS assembler特点支持加载ROM并自动编译代码到ROM，省了使用16进制编辑器复制代码进ROM，进行ROM HACK更方便了。

ARMIPS命令行用法：
1 M9 @* L9 y2 G6 E% s
Usage: armips [optional parameters] <FILE>
2 H1 Z7 i+ c. S/ M
6 O5 Z' x/ ]4 {# kOptional parameters:
1 g; ?6 j! g! n* g$ c6 \ -temp <TEMP>         Output temporary assembly data to <TEMP> file
! l& u6 @, W. p* w! K& {) O, b -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
* x& b6 Y3 X3 x -equ  <NAME> <VAL>   Equivalent to '<NAME> equ <VAL>' in code
$ p; ?6 o- i8 R2 K -strequ <NAME> <VAL> Equivalent to '<NAME> equ "<VAL>"' in code
-erroronwarning      Treat all warnings like errors
# g; b4 k% O1 D3 b; L+ Q* z
File arguments:
<FILE>               Main assembly code file
, a; Q& O( Q; ]) D% a6 o
-temp <TEMP>参数是将临时汇编数据输出到<TEMP>文件
1 u: `, V! ?1 ~- d/ ~" z3 i-sym <SYM>参数是将sym格式符号输出到<SYM>文件，这格式支持no$psx和no$gba
-sym2 <SYM2>参数是将sym2格式符号输出到<SYM2>文件，这格式支持pcsx2和ppsspp
; C( R" r% S" X6 e( H8 R" `; |-root <ROOT>参数是指定执行期间要使用的工作目录
-equ <NAME> <VAL>参数用法不明
0 v/ o- z5 W# `9 k% w! O-strequ <NAME> <VAL>参数用法不明
-erroronwarning参数是当出现任何警告时被视为错误，防止继续编译

" m; x, p+ Y8 b<FILE>是汇编代码文件，可用记事本之类编辑
! d  x) F* N% E  _
* h+ V/ X1 O3 q  [' p注释说明：
9 d6 }  d& W* c) G注释可在单行指令后面“;”和“//”添加
“/* */”式也接受
% g9 Q* u2 c$ [. u6 M
例子：
.open"1234.gba",0x08000000;//打开1234.gba文件，并将起始地址定义为0x08000000

& d1 _. I4 W& E/ v6 b- |6 v/ S.close;/*关闭文件*/

标签说明：
标签名可以包含A~Z字母和数字、下划线。但是它不能以数字开头，所有标签名称不区分大小写。

数值说明：
“0xA”和“0Ah”是16进制数值
“0o12”和“12o”是8进制数值
“1010b”和“0b1010”是2进制数值
2 x2 X. X1 i4 ^
equ说明：
格式：text equ value
0 u+ x6 w: l" ~6 R5 N说明：用一个text代替value
" y# |( v) O1 G" F8 f) T$ g例子：
address1 equ 0x12345678
ldr r0,=address1
7 l( W6 S6 S: K3 t! i* V! u7 S.pool
2 q) `0 ?, q3 z) c# C
函数说明：

3 Y  S+ e% |0 ~.open函数：
) i" ]$ \9 P1 E) X" D格式：
.open "ROM FileName",offset
.open "Old FileName","New FileName",offset
8 O" Y" x1 T2 h- U" ]: S8 f  g说明：.open函数打开ROM文件，并将ROM文件起始地址设置为offset地址。但结果指定了2个文件，汇编器会将文件复制到第二个路径。

例子：
' O! s3 k  l$ M" _1 I.open "1234.gba",0x08000000
" k8 p2 e: [/ {% [- N9 J5 }0 i" Z
.close函数和.closefile函数：
格式：
.close
+ n1 E- }  X/ z9 |.closefile
说明：关闭文件。

.org函数和.orga函数：
- |8 b; C/ E5 m& J格式：
# R# R4 n9 Y! g* X+ X2 x$ L.org RamAddress
% I2 I( V% _) s.orga FileAddress
说明：
前面用.open函数设置过offset地址的话，那么可以用.org函数设置offset输出地址。
4 L+ H8 x* A; V9 z8 @  q  G. J
# p1 y0 G6 B1 }  I) M0 B.orga函数可指定ROM文件的输出地址。

.create函数和.createfile函数
' ~/ G% X# T& G/ b格式：
.create "FileName",offset
.createfile "FileName",offset
说明：创建一个文件，如果文件是存在，他会覆盖掉。

.area函数
# |7 ?! a3 N& D  H" j* s格式：
.area SizeEquation[,fill]
9 H( x$ A  p3 K* E/ x+ H3 e.endarea
' w8 q# E0 V- D% a; Z8 i1 u说明：如果你要向某地址写入一定字节数值，就用.area函数，SizeEquation是能写入最大字节数，超过就编译失败
" v& j; @. D6 P0 ~5 s+ n) U
  ?. O, U7 _" I' H0 `6 n  `8 ~例子：向0x100地址写入0x5,0x6,0x7,0x8单字节数据
org 0x100
6 B" D4 ]. |* j; I$ _% s6 @& f.area 0x8
byte 0x5,0x6,0x7,0x8
9 j3 ^4 G7 K/ t- ~2 Y$ }5 h9 F2 ~; w- |.endarea

% g1 y. `7 N0 O: J$ K' |$ y.align函数
7 i" R  R" ?% \格式：.align num
0 J! A* M. t& R0 h说明：写零字节，num为零字节数量，用16进制表示。

/ t1 k6 |& [( _$ K; N4 K.pool函数
格式：.pool
说明：如果代码中有“ldr rx,=value”,就要用.pool对齐。
4 m" P9 `3 D7 @, a' ?5 B例子：
+ }( Y$ P' G9 A: bldr r0,=0x12345678;
) e2 \8 R5 J9 v9 `8 Q....
.pool
  q( e! L: L" I: M; F) G+ m
* G: L" v2 r$ K! N% v  g.fill函数
' i) o' X; Q9 C' T+ T格式：
" P1 s# f" D+ u.fill length[,value]
defs length[,value]
说明：填充一定长度单字节数值，如果未指定value，而填充零字节数值；length和value用16进制表示。
, x, x5 x( b! i
.skip函数：
0 U# G7 r2 V2 [( }) C格式：.skip length
- V% ?5 J& l. k- s' v说明：跳过指定长度单字节数值，length用16进制表示。

0 k: m- z; H6 {( c# C写单字节：
  U+ L. ~, m. t" w- h4 T6 H1 U.byte value[,...]
.db value[,...]
.ascii value[,...]
.asciiz value[,...]
dcb value[,...]
3 J9 v2 ^5 H$ ^( {2 z1 E/ l' _
& f3 e! L* u, y: Q6 M写双字节：
.halfword value[,...]
.dh value[,...]
1 |8 G. A% H. I/ a* idcw value[,...]

: r2 N9 q5 ?. R+ ^* u# V写四字节：
.word value[,...]
9 U9 C( R0 u6 ]* [8 x.dw value[,...]
4 S. R$ X5 s5 `& B' D* tdcd value[,...]
3 j2 ?" J, y7 M
写doublewords：
- F) y0 m& b) B1 n.doubleword value[,...]
1 V$ g. S* |: ^' X6 i" h0 F.dd value[,...]
6 D1 o" W. j0 z2 i7 N4 _+ zdcq value[,...]
6 y5 u9 S( G( U, |1 ^# ?
. \+ b" V, I! a' N4 N0 l写浮点数：
.float value[,...]
) T+ b; m9 J  F2 {.double value[,...]
. H' Z  ]7 Z* m5 g
ARM的ARM模式和THUMB模式定义：
/ H5 |/ |7 m9 n.arm|ARM模式
; y5 Y; O2 @6 N7 L4 _& _.thumb|thumb模式

设置架构：
.psx|PlayStation 1(MIPS R3000)
8 L5 _( D: V7 E9 o' l.ps2|PlayStation 2(EmotionEngine)
.psp|PlayStation Portable(Allegrex)
) Q( t" |7 s0 G" j( n! z.n64|Nintendo 64(MIPS R4000)
.rsp|Nintendo 64(RSP)
.gba|GameBoy Advance(ARM7,默认是thumb模式)
.nds|Nintendo DS(ARM9,默认是ARM模式)
.3ds|Nintendo 3DS(ARM11,默认是ARM模式)
.arm.big|
0 Q# L5 ~) k9 p% H$ D# T.arm.little|
8 T- N. B) y7 [8 S$ E
常用函数就写这些了，还有大量函数说明没写，更多说明看readme.md吧。