ARMIPS assembler使用说明

疾风之狼

ARMIPS assembler是一款ARM/MIPS汇编工具，他是命令行工具，支持ARM7/ARM9/MIPS R3000/MIPS R4000
' S) I4 [  _/ o' p
$ r) V9 P/ Y' B  o1 {ARMIPS assembler作者是Kingcom,目前发展到0.9版本
1 K2 B; y; _  H( p3 B0 G  i  Z
Kingcom's website：http://aerie.wingdreams.net

$ H& O# Q0 y  F  ~7 t5 v6 D+ kARMIPS assembler源代码可去https://github.com/Kingcom/armips获得

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

/ T% S  `" Y3 W& C) ~0 {1 E" rARMIPS assembler特点支持加载ROM并自动编译代码到ROM，省了使用16进制编辑器复制代码进ROM，进行ROM HACK更方便了。
$ ]/ c# Y% S! \' Y& ^7 w
ARMIPS命令行用法：

Usage: armips [optional parameters] <FILE>
; u. z) C1 Y( U
Optional parameters:
-temp <TEMP>         Output temporary assembly data to <TEMP> file
-sym  <SYM>          Output symbol data in the sym format to <SYM> file
# P) ]& m8 U' p- B( d) b -sym2 <SYM2>         Output symbol data in the sym2 format to <SYM2> file
& N( i" ?, ^% l! w -root <ROOT>         Use <ROOT> as working directory during execution
-equ  <NAME> <VAL>   Equivalent to '<NAME> equ <VAL>' in code
$ Z+ V1 I0 z8 m: s% N/ A -strequ <NAME> <VAL> Equivalent to '<NAME> equ "<VAL>"' in code
7 ?6 A1 V5 [. f$ i' m" f -erroronwarning      Treat all warnings like errors

File arguments:
' E7 i; f. q# c5 G) c  s <FILE>               Main assembly code file

& p- v" J+ Z5 ~% c. v/ `$ ~-temp <TEMP>参数是将临时汇编数据输出到<TEMP>文件
8 q  {& i3 q! L6 J-sym <SYM>参数是将sym格式符号输出到<SYM>文件，这格式支持no$psx和no$gba
8 A; B0 b4 f! z6 r# k-sym2 <SYM2>参数是将sym2格式符号输出到<SYM2>文件，这格式支持pcsx2和ppsspp
" @& l, {9 G( b* F8 R2 D+ {8 u-root <ROOT>参数是指定执行期间要使用的工作目录
-equ <NAME> <VAL>参数用法不明
-strequ <NAME> <VAL>参数用法不明
0 D. z/ Q' I; V  T- M4 \( }0 C; g-erroronwarning参数是当出现任何警告时被视为错误，防止继续编译
. y, \  S4 \, l+ K
0 U. n2 a. t, m<FILE>是汇编代码文件，可用记事本之类编辑
- F4 ]# E7 U1 A
注释说明：
! g* e* ?/ d2 M" v5 g注释可在单行指令后面“;”和“//”添加
“/* */”式也接受
+ d$ @0 _6 P! d3 o2 r" f$ A
例子：
.open"1234.gba",0x08000000;//打开1234.gba文件，并将起始地址定义为0x08000000

1 p/ }% n7 |) L9 e* m! ^.close;/*关闭文件*/
% e" k. |% k- f) [
标签说明：
  X+ i+ _& d: ~3 y  H" a标签名可以包含A~Z字母和数字、下划线。但是它不能以数字开头，所有标签名称不区分大小写。

/ u$ A- n& F& U+ d数值说明：
  `# g! w9 ^' N6 W  W8 B“0xA”和“0Ah”是16进制数值
“0o12”和“12o”是8进制数值
“1010b”和“0b1010”是2进制数值

equ说明：
5 ~6 F1 `  T' j/ s$ A格式：text equ value
说明：用一个text代替value
例子：
address1 equ 0x12345678
+ u! o! E$ ?! |1 R$ L# w3 N5 Vldr r0,=address1
.pool
9 Y$ f) g9 p" b2 a$ J; K
函数说明：

.open函数：
3 w' X! f' U( Z! }  d8 p格式：
.open "ROM FileName",offset
.open "Old FileName","New FileName",offset
说明：.open函数打开ROM文件，并将ROM文件起始地址设置为offset地址。但结果指定了2个文件，汇编器会将文件复制到第二个路径。
) m9 \  @+ P9 f1 v  R5 d3 m" ~6 W
例子：
2 N) ?1 K- h' v; d.open "1234.gba",0x08000000

.close函数和.closefile函数：
1 x" n. j: E, \格式：
; [) ?9 o* k" r# v5 k% R5 j.close
$ d3 H3 O, w3 H/ `.closefile
/ f3 v5 H( O; q( f说明：关闭文件。

.org函数和.orga函数：
格式：
: d/ ?, w  x; z' ^) }4 c; a.org RamAddress
9 q8 G% u9 P$ D.orga FileAddress
3 O! ?5 S$ x6 F0 u, L说明：
前面用.open函数设置过offset地址的话，那么可以用.org函数设置offset输出地址。
6 U" ?- f! G; L( f
6 d  t- i# D/ @0 U1 D; @( D$ a.orga函数可指定ROM文件的输出地址。
  P; K6 s* M2 U% r: e& s& }
.create函数和.createfile函数
格式：
.create "FileName",offset
.createfile "FileName",offset
  E! m" ?+ G; k7 C) z说明：创建一个文件，如果文件是存在，他会覆盖掉。

5 _! q5 g; H! D* a0 c: @6 z.area函数
& U* Q2 H, L+ N/ P格式：
) j8 u$ b% g0 O" r" o0 k.area SizeEquation[,fill]
.endarea
3 }5 k) N( k  Y* J6 ^4 ]8 m3 l说明：如果你要向某地址写入一定字节数值，就用.area函数，SizeEquation是能写入最大字节数，超过就编译失败

例子：向0x100地址写入0x5,0x6,0x7,0x8单字节数据
org 0x100
) S+ y+ ^$ Q0 M  w5 L: ].area 0x8
/ c7 M- j3 w' u' V2 cbyte 0x5,0x6,0x7,0x8
.endarea
' c, l9 C% C  L8 ?+ D
.align函数
格式：.align num
说明：写零字节，num为零字节数量，用16进制表示。
5 C, c8 a' C+ h) S* O2 q
.pool函数
, X  c7 p$ R/ t  S格式：.pool
说明：如果代码中有“ldr rx,=value”,就要用.pool对齐。
! Q3 ?0 l  E  `  o例子：
ldr r0,=0x12345678;
....
5 r( }: |9 t  F( @- K$ W& Z.pool

( I& O' Z7 L6 R  _. T.fill函数
格式：
.fill length[,value]
defs length[,value]
说明：填充一定长度单字节数值，如果未指定value，而填充零字节数值；length和value用16进制表示。
& g* b0 n/ ^5 V" z
.skip函数：
1 p0 p/ H. Y2 E: P8 v2 H1 T格式：.skip length
说明：跳过指定长度单字节数值，length用16进制表示。
5 ^8 l! }5 K9 `$ {, M1 v* @
写单字节：
0 W3 y' E5 V/ p9 s# M; n. J6 H.byte value[,...]
.db value[,...]
.ascii value[,...]
4 ~, C/ v5 |) g! X( e.asciiz value[,...]
% n2 K0 a! P  u1 gdcb value[,...]

/ y$ N" V8 r# ]  m写双字节：
.halfword value[,...]
.dh value[,...]
dcw value[,...]
( v$ V5 G  K* p, [
写四字节：
  a" k: W- |6 e& W1 p; X  y# [.word value[,...]
3 d. d; Y- |- I% H1 r+ n.dw value[,...]
% b2 |5 p. o& C3 w  kdcd value[,...]
; m: n) L2 f( o+ @' y9 r* X2 ]8 |
写doublewords：
) ]; J( ^" h" }1 _.doubleword value[,...]
.dd value[,...]
dcq value[,...]
8 ~8 J3 g0 B2 D6 s: Q- D
写浮点数：
$ D! E$ K* R, j! m.float value[,...]
.double value[,...]
5 u# j# _2 ~' Q+ T* }
ARM的ARM模式和THUMB模式定义：
.arm|ARM模式
.thumb|thumb模式

# k" W4 j* p# w( m设置架构：
.psx|PlayStation 1(MIPS R3000)
4 V5 V/ }! }4 H' Q) @2 E; o2 x3 C.ps2|PlayStation 2(EmotionEngine)
$ C- b. n0 C1 q* C# e! ~3 T& R8 L.psp|PlayStation Portable(Allegrex)
! D0 t& r% @6 f0 M  {$ C.n64|Nintendo 64(MIPS R4000)
.rsp|Nintendo 64(RSP)
. Y. W: k- _7 R" y2 u.gba|GameBoy Advance(ARM7,默认是thumb模式)
.nds|Nintendo DS(ARM9,默认是ARM模式)
.3ds|Nintendo 3DS(ARM11,默认是ARM模式)
" p' Q+ c6 {" v. K3 A.arm.big|
: e* F/ z7 }$ Y2 g! h% F3 {' X' k.arm.little|
6 A6 d6 u* S- O4 U
常用函数就写这些了，还有大量函数说明没写，更多说明看readme.md吧。
; _2 y1 v. d+ X) r5 h