ARMIPS assembler使用说明

疾风之狼

+ _; w, z- P+ \  Z' HARMIPS assembler是一款ARM/MIPS汇编工具，他是命令行工具，支持ARM7/ARM9/MIPS R3000/MIPS R4000
+ i. ~! Q$ }, R' c& |& Q( i
ARMIPS assembler作者是Kingcom,目前发展到0.9版本

Kingcom's website：http://aerie.wingdreams.net
& r7 E' i# B* G0 W* j
ARMIPS assembler源代码可去https://github.com/Kingcom/armips获得

更新版本可去http://buildbot.orphis.net/armips获得
8 f2 N5 r0 M8 R/ f
ARMIPS assembler特点支持加载ROM并自动编译代码到ROM，省了使用16进制编辑器复制代码进ROM，进行ROM HACK更方便了。
0 G, l- O& Q- G+ L/ h- e0 o
# u7 x: Q2 t  y' O  QARMIPS命令行用法：

$ }9 h* s) R7 ]( N( U# q& qUsage: armips [optional parameters] <FILE>

' G. s. J5 u9 ^$ t  H9 f* wOptional parameters:
-temp <TEMP>         Output temporary assembly data to <TEMP> file
-sym  <SYM>          Output symbol data in the sym format to <SYM> file
9 M5 r, q8 z3 T  n) I -sym2 <SYM2>         Output symbol data in the sym2 format to <SYM2> file
; w) j, z- |8 c+ t: G. I2 _ -root <ROOT>         Use <ROOT> as working directory during execution
$ O% h& H: l' e -equ  <NAME> <VAL>   Equivalent to '<NAME> equ <VAL>' in code
-strequ <NAME> <VAL> Equivalent to '<NAME> equ "<VAL>"' in code
) O$ S( g" v; y2 s& ? -erroronwarning      Treat all warnings like errors
8 {4 }. C5 d2 c/ m2 G
5 D5 M9 y1 x8 h  _$ ?File arguments:
9 j% D& Z  E1 Q6 B3 S9 Q <FILE>               Main assembly code file

-temp <TEMP>参数是将临时汇编数据输出到<TEMP>文件
4 A+ z3 e/ Q3 `: S$ K% a-sym <SYM>参数是将sym格式符号输出到<SYM>文件，这格式支持no$psx和no$gba
-sym2 <SYM2>参数是将sym2格式符号输出到<SYM2>文件，这格式支持pcsx2和ppsspp
5 x: P& z' Z+ [0 ~2 R+ \-root <ROOT>参数是指定执行期间要使用的工作目录
* l: A) H% \, `5 N1 M' I& r0 _-equ <NAME> <VAL>参数用法不明
. a% E# L! [* a1 b7 k. f) X-strequ <NAME> <VAL>参数用法不明
& W; G+ P: e! A/ t. r" k7 g-erroronwarning参数是当出现任何警告时被视为错误，防止继续编译
1 f0 o$ x. q' e2 S, s7 C
" U$ d) h* R& x/ S! [) s<FILE>是汇编代码文件，可用记事本之类编辑
4 \3 U$ P$ M  a; Y' V0 b
+ Z3 p) p5 r. q( h( P注释说明：
/ d8 F* @7 {( o5 R( c$ z' `注释可在单行指令后面“;”和“//”添加
7 X$ Q8 U  V: h$ u1 X“/* */”式也接受

例子：
.open"1234.gba",0x08000000;//打开1234.gba文件，并将起始地址定义为0x08000000
' J! M1 n# ]. H% W3 R
) w1 M/ N- j, ^6 O. M$ e.close;/*关闭文件*/
5 ?3 T$ g; d8 \4 M0 U6 ^. q. Y
标签说明：
/ b) z0 N( [& a标签名可以包含A~Z字母和数字、下划线。但是它不能以数字开头，所有标签名称不区分大小写。
) d/ D- H. [# r( E9 C8 [
8 O8 V! N5 O. L1 I% T数值说明：
+ i: M8 L# q1 g8 F# f7 [“0xA”和“0Ah”是16进制数值
“0o12”和“12o”是8进制数值
“1010b”和“0b1010”是2进制数值
& w! e$ W$ f# Z1 E6 O& i  c
/ z  B: X4 }* C% f: A( {! }# _equ说明：
' i8 A8 o8 k8 n9 f4 C! T. ?格式：text equ value
说明：用一个text代替value
例子：
# S6 h4 n7 K* ~  g" `address1 equ 0x12345678
& @1 [& J" s+ I0 S) N1 wldr r0,=address1
4 [# u# C# y) X( e# ~.pool

函数说明：

.open函数：
! C2 B5 M/ t3 n3 i. F8 Z格式：
.open "ROM FileName",offset
7 D  c# n/ u9 }0 o8 N& A.open "Old FileName","New FileName",offset
说明：.open函数打开ROM文件，并将ROM文件起始地址设置为offset地址。但结果指定了2个文件，汇编器会将文件复制到第二个路径。

例子：
9 |$ {' c* L/ s! ^.open "1234.gba",0x08000000

.close函数和.closefile函数：
格式：
.close
.closefile
说明：关闭文件。
+ b; G0 b1 \: Z! o. |$ D
.org函数和.orga函数：
( x: h+ \7 e. J$ @格式：
! m! a& E4 ?% l.org RamAddress
: e/ e6 N7 o4 P) x" ]; R: o.orga FileAddress
& O8 G! J1 d# H. t0 T% T说明：
3 U( _: g* F" s- {% R; K前面用.open函数设置过offset地址的话，那么可以用.org函数设置offset输出地址。
  h" Z6 K. L) Q$ h. v
.orga函数可指定ROM文件的输出地址。

.create函数和.createfile函数
7 G2 A- l$ L7 C4 y  p) `格式：
.create "FileName",offset
6 D* `5 m1 p8 R- u: c3 N4 x' U$ }.createfile "FileName",offset
4 ~' \6 p5 G# Y2 w3 x2 N  [说明：创建一个文件，如果文件是存在，他会覆盖掉。

.area函数
格式：
.area SizeEquation[,fill]
( J1 l8 E+ b0 w, s: R" t, @.endarea
. [/ h1 d$ x* S2 w; V说明：如果你要向某地址写入一定字节数值，就用.area函数，SizeEquation是能写入最大字节数，超过就编译失败
, P- `! t" o) ]! m  d
例子：向0x100地址写入0x5,0x6,0x7,0x8单字节数据
3 a! X* k/ ]1 B3 w& p6 M; forg 0x100
.area 0x8
byte 0x5,0x6,0x7,0x8
1 {  F+ O3 P5 X+ Q' n/ T.endarea
& z: o/ K5 p& ]5 j. i$ g- Z5 w0 ~
.align函数
; T8 O& q3 c# k3 Y3 E. w格式：.align num
说明：写零字节，num为零字节数量，用16进制表示。

  @' l% t$ `% M; M! H.pool函数
格式：.pool
( k0 ]0 D1 }9 q) X* E' h5 R说明：如果代码中有“ldr rx,=value”,就要用.pool对齐。
/ f; }; @% A9 D5 u+ V# v* m例子：
+ h0 t+ k% k; ]) fldr r0,=0x12345678;
....
.pool
. |& r. H$ x/ f6 l0 K% `& P
.fill函数
; x3 B8 v$ W' t$ n( k格式：
2 V! q6 F2 D6 I* p! Y4 n& A( g.fill length[,value]
' Z) N$ i6 }1 ndefs length[,value]
% X$ o/ P* I: I& W& Q, ?/ g4 B说明：填充一定长度单字节数值，如果未指定value，而填充零字节数值；length和value用16进制表示。
4 t& p# C+ c$ X: K& P3 B- L4 K
. ]+ p9 P, p5 g1 m- T$ d.skip函数：
- Q; x9 G7 h+ ~; _, N格式：.skip length
说明：跳过指定长度单字节数值，length用16进制表示。
/ r7 f, g- i( \! K7 h' T3 {
写单字节：
6 h% a3 q- M: N! v3 M/ [.byte value[,...]
.db value[,...]
! {$ j$ x0 F* `8 t7 T* z% S# {.ascii value[,...]
.asciiz value[,...]
dcb value[,...]
2 a0 e1 o2 ?8 E! u5 m  u7 k, @
8 O% @/ J" j1 z* Q0 J; f: Q" N写双字节：
% t+ G& W) p! n, E+ x* B' |8 a8 B.halfword value[,...]
.dh value[,...]
dcw value[,...]
6 k4 w+ D8 }3 r( N: T& ]3 J
写四字节：
.word value[,...]
.dw value[,...]
& V# l  V2 q+ Q" n0 q& K/ Cdcd value[,...]
! Z. f8 H4 T5 \. ]! V# f
$ d( s* T  w: d1 [9 Z2 Y5 K写doublewords：
.doubleword value[,...]
.dd value[,...]
dcq value[,...]
0 y  T" F. t' [
写浮点数：
2 ?& U& A0 C- L3 G7 r.float value[,...]
.double value[,...]
" z3 v: a/ k5 T  m- {! }1 E
, [  X9 p2 F3 [# m) N4 F! G' qARM的ARM模式和THUMB模式定义：
8 O1 K5 Z' q  Q# e7 q4 d' O.arm|ARM模式
.thumb|thumb模式

" u8 n* m) o7 H4 j- K设置架构：
" U! L8 o! ^$ ^  _- T9 e& D.psx|PlayStation 1(MIPS R3000)
  p% ~, j  N9 {4 y, Z.ps2|PlayStation 2(EmotionEngine)
0 x9 Z- r5 U7 r) z) n.psp|PlayStation Portable(Allegrex)
.n64|Nintendo 64(MIPS R4000)
" g# u4 @) v" A3 Z.rsp|Nintendo 64(RSP)
.gba|GameBoy Advance(ARM7,默认是thumb模式)
* Q2 f5 o  @& B$ U6 b.nds|Nintendo DS(ARM9,默认是ARM模式)
.3ds|Nintendo 3DS(ARM11,默认是ARM模式)
8 v$ H0 Q" d$ t5 T.arm.big|
.arm.little|
( S' @8 Q! C$ m  q8 }$ W' n
常用函数就写这些了，还有大量函数说明没写，更多说明看readme.md吧。
+ j" a7 n! S, F6 {