ARMIPS assembler使用说明

疾风之狼

$ F; `! U* L& ?: ^ARMIPS assembler是一款ARM/MIPS汇编工具，他是命令行工具，支持ARM7/ARM9/MIPS R3000/MIPS R4000

ARMIPS assembler作者是Kingcom,目前发展到0.9版本
9 D9 M. a) b2 W- r2 }+ P
Kingcom's website：http://aerie.wingdreams.net

! d; k! c. W) f1 ^+ r$ d/ L- n4 NARMIPS assembler源代码可去https://github.com/Kingcom/armips获得
! S& e7 P/ `* g1 R+ |( G# `* ^
8 G( x# \) q0 b0 r4 O& M# }+ z更新版本可去http://buildbot.orphis.net/armips获得

ARMIPS assembler特点支持加载ROM并自动编译代码到ROM，省了使用16进制编辑器复制代码进ROM，进行ROM HACK更方便了。

: ]! K- ^1 ]7 D4 M* KARMIPS命令行用法：
7 H$ ]* e' h1 Y9 U. c4 o- ?8 \( h+ a
4 b# R0 O3 l4 A$ O: v% {Usage: armips [optional parameters] <FILE>

* p1 B& n$ P' W, x' qOptional parameters:
- A) o  v6 y4 s: i -temp <TEMP>         Output temporary assembly data to <TEMP> file
+ T( e3 G7 M# J% }: z3 u -sym  <SYM>          Output symbol data in the sym format to <SYM> file
$ _9 c8 G- ?4 C1 F$ B+ A' L -sym2 <SYM2>         Output symbol data in the sym2 format to <SYM2> file
- I- W9 O9 G6 |4 p! P* G- s -root <ROOT>         Use <ROOT> as working directory during execution
* [) a- C: `0 K* ]' _: L) G -equ  <NAME> <VAL>   Equivalent to '<NAME> equ <VAL>' in code
-strequ <NAME> <VAL> Equivalent to '<NAME> equ "<VAL>"' in code
$ k5 s. n. Y0 T% w' y6 O8 c8 V -erroronwarning      Treat all warnings like errors
  {" L/ T" [2 F
File arguments:
* S" r, ], ?6 [. c <FILE>               Main assembly code file

/ I. L( v/ J; V-temp <TEMP>参数是将临时汇编数据输出到<TEMP>文件
-sym <SYM>参数是将sym格式符号输出到<SYM>文件，这格式支持no$psx和no$gba
1 j( Z- q* t/ [" Z6 d-sym2 <SYM2>参数是将sym2格式符号输出到<SYM2>文件，这格式支持pcsx2和ppsspp
-root <ROOT>参数是指定执行期间要使用的工作目录
-equ <NAME> <VAL>参数用法不明
! F  f7 v+ V3 v3 C3 S-strequ <NAME> <VAL>参数用法不明
5 Y, b7 A: l( R' e7 T) K2 O-erroronwarning参数是当出现任何警告时被视为错误，防止继续编译
2 c- r3 g4 H7 ], y5 k
<FILE>是汇编代码文件，可用记事本之类编辑

7 I# p, S& Z3 S0 N3 M注释说明：
注释可在单行指令后面“;”和“//”添加
- v9 F5 [# k, ~! A  M; m“/* */”式也接受
7 l" t+ K3 g( i
例子：
$ i4 v' }5 P4 r& M5 _, D9 ^2 A7 H.open"1234.gba",0x08000000;//打开1234.gba文件，并将起始地址定义为0x08000000
! G8 a4 X; T* w; \/ \
9 y. e6 t  W- `.close;/*关闭文件*/
# t' @- ]) J3 p9 }
标签说明：
, Z  s( T6 m6 C' u标签名可以包含A~Z字母和数字、下划线。但是它不能以数字开头，所有标签名称不区分大小写。
' a- p/ _- V/ \, ~# c: ]
数值说明：
3 X$ g+ h( A; V! X6 n) U7 p9 [+ j“0xA”和“0Ah”是16进制数值
/ \) Z0 V& M1 s/ m- P* l/ ?. Q“0o12”和“12o”是8进制数值
“1010b”和“0b1010”是2进制数值
! N2 y- ^2 S' }& i
equ说明：
6 h# M$ W- }- @6 C格式：text equ value
说明：用一个text代替value
: v8 u3 q  U4 W4 |例子：
+ z6 H8 S1 H( `. v# x' ^- Zaddress1 equ 0x12345678
& C* s1 \2 I$ @# \; d! L, Vldr r0,=address1
! |  Y5 r+ Z# @3 ].pool

) y/ }3 X" k) @函数说明：
: D9 X7 e# X  [7 ^
2 X% U  B0 q3 E  |.open函数：
6 ]4 R; D' T4 _格式：
4 Z! d7 ^( N2 A5 ?+ L1 B4 l; g.open "ROM FileName",offset
.open "Old FileName","New FileName",offset
说明：.open函数打开ROM文件，并将ROM文件起始地址设置为offset地址。但结果指定了2个文件，汇编器会将文件复制到第二个路径。

$ S6 y; r; l3 T+ [* o$ `& i4 E& G例子：
; ]: a( S- g9 F6 {$ \1 M' q, B1 C.open "1234.gba",0x08000000
6 ?8 M) Y; L! F5 V
0 V6 E% T' \8 I.close函数和.closefile函数：
格式：
.close
4 r+ ^- u3 g+ B4 L+ b.closefile
说明：关闭文件。

.org函数和.orga函数：
格式：
.org RamAddress
8 v2 g1 k% r; A0 r.orga FileAddress
7 V: a4 x% E9 ?5 ]( U6 N说明：
+ I0 [7 H. g# F; h- c3 L前面用.open函数设置过offset地址的话，那么可以用.org函数设置offset输出地址。

* p; K3 `6 t/ [.orga函数可指定ROM文件的输出地址。
1 |  }1 z/ X" _2 X- `
.create函数和.createfile函数
( {* H1 d# p- ?- F; q格式：
9 p; K3 P" o! A1 n/ o.create "FileName",offset
4 q4 n" y# A' g$ }* }* `' o) S.createfile "FileName",offset
说明：创建一个文件，如果文件是存在，他会覆盖掉。
! I9 l6 k- S- E' T; d1 |% l: m2 s& \
.area函数
* {+ L; u9 k! l& B  t格式：
.area SizeEquation[,fill]
.endarea
说明：如果你要向某地址写入一定字节数值，就用.area函数，SizeEquation是能写入最大字节数，超过就编译失败
- n/ d. k( h+ W- d  w9 Z
例子：向0x100地址写入0x5,0x6,0x7,0x8单字节数据
6 p8 Y8 V3 O6 o' s+ g! ~, @1 k. k' xorg 0x100
" L! b. S( V0 S/ [) u9 N.area 0x8
byte 0x5,0x6,0x7,0x8
.endarea
5 S7 ]0 u( b: ~" h" W
.align函数
+ s0 C. P. {: }0 v- K, ?- T* V/ G; l格式：.align num
0 u3 r4 f4 C. N: M. ?  d说明：写零字节，num为零字节数量，用16进制表示。
* Z8 z: ]# Z& Z  J, ]1 y% a2 A
.pool函数
格式：.pool
+ a  ?$ e7 o5 m6 [1 S. }说明：如果代码中有“ldr rx,=value”,就要用.pool对齐。
例子：
1 f0 Q/ i( |( w! gldr r0,=0x12345678;
. I$ G1 f6 Z' f. P....
1 p0 A( e4 e- M1 Y+ Q.pool
: i- v, J5 \6 Y( M  }; m) h/ C
.fill函数
格式：
.fill length[,value]
defs length[,value]
说明：填充一定长度单字节数值，如果未指定value，而填充零字节数值；length和value用16进制表示。
: W) e& q7 A8 z6 c: D+ `- l& h
7 K+ H) V- H9 d.skip函数：
: c; r' F  g% O2 [* _" q格式：.skip length
说明：跳过指定长度单字节数值，length用16进制表示。

写单字节：
.byte value[,...]
.db value[,...]
.ascii value[,...]
. K. J( [8 v8 l.asciiz value[,...]
dcb value[,...]
3 P: e2 s+ s9 ^5 y- C9 Q/ T
- K/ ?- N  M$ F写双字节：
( ]. F; S7 n2 k, F8 X6 w.halfword value[,...]
6 S% Y$ f( g% t1 v0 _( X1 i.dh value[,...]
( a2 O, Y; }0 Cdcw value[,...]
3 k0 q# x2 l2 O! v7 x  g
- T: ^7 c5 m  R+ s% p写四字节：
: @1 R. j8 H# V7 N5 c$ C* X- I! C.word value[,...]
: P& S6 U8 _9 I/ I. H.dw value[,...]
dcd value[,...]

写doublewords：
.doubleword value[,...]
$ a8 q6 s# U+ h: J6 d.dd value[,...]
dcq value[,...]
# |9 V7 r& E0 r% X% \
9 G8 ^' L& x% Q9 B9 E) L写浮点数：
.float value[,...]
.double value[,...]

" R, J$ E9 ^% E3 YARM的ARM模式和THUMB模式定义：
.arm|ARM模式
.thumb|thumb模式
2 A8 N4 @. M  X  L. q5 h& U) K
设置架构：
.psx|PlayStation 1(MIPS R3000)
.ps2|PlayStation 2(EmotionEngine)
.psp|PlayStation Portable(Allegrex)
.n64|Nintendo 64(MIPS R4000)
.rsp|Nintendo 64(RSP)
' v1 Z$ n; P! F6 h1 Q.gba|GameBoy Advance(ARM7,默认是thumb模式)
.nds|Nintendo DS(ARM9,默认是ARM模式)
8 q# l6 R0 z3 N/ h1 K.3ds|Nintendo 3DS(ARM11,默认是ARM模式)
.arm.big|
( ]  R7 N0 t' A( i5 d.arm.little|
5 ]  X! G/ U8 O( Z3 W1 h4 n' V
常用函数就写这些了，还有大量函数说明没写，更多说明看readme.md吧。
" T- T6 K; D! Z" K