ARMIPS assembler使用说明

疾风之狼

ARMIPS assembler是一款ARM/MIPS汇编工具，他是命令行工具，支持ARM7/ARM9/MIPS R3000/MIPS R4000

ARMIPS assembler作者是Kingcom,目前发展到0.9版本
) g8 P$ h$ j3 X7 h
Kingcom's website：http://aerie.wingdreams.net

ARMIPS assembler源代码可去https://github.com/Kingcom/armips获得
: {3 M# m8 V! Z5 L4 b/ @) F9 _
更新版本可去http://buildbot.orphis.net/armips获得
. G* f9 S3 o$ {9 ~
ARMIPS assembler特点支持加载ROM并自动编译代码到ROM，省了使用16进制编辑器复制代码进ROM，进行ROM HACK更方便了。

2 A' x( l4 N# t6 oARMIPS命令行用法：
' y; ~/ h! [: U! p9 h- _7 r
Usage: armips [optional parameters] <FILE>
- a7 {0 `9 F0 b7 d7 P: x. Y. a
Optional parameters:
) y9 u3 S; w9 p7 {! m$ [ -temp <TEMP>         Output temporary assembly data to <TEMP> file
. b" e8 M- p$ j5 a) E5 ^- B -sym  <SYM>          Output symbol data in the sym format to <SYM> file
& V3 G4 m6 l! j& t3 W -sym2 <SYM2>         Output symbol data in the sym2 format to <SYM2> file
-root <ROOT>         Use <ROOT> as working directory during execution
" i1 W7 g; T1 P. D -equ  <NAME> <VAL>   Equivalent to '<NAME> equ <VAL>' in code
-strequ <NAME> <VAL> Equivalent to '<NAME> equ "<VAL>"' in code
% a3 h5 V* P2 |* ]2 [" z -erroronwarning      Treat all warnings like errors
( q0 Z. t8 w. }4 g
File arguments:
<FILE>               Main assembly code file
3 A. @6 S* \  J
-temp <TEMP>参数是将临时汇编数据输出到<TEMP>文件
-sym <SYM>参数是将sym格式符号输出到<SYM>文件，这格式支持no$psx和no$gba
-sym2 <SYM2>参数是将sym2格式符号输出到<SYM2>文件，这格式支持pcsx2和ppsspp
-root <ROOT>参数是指定执行期间要使用的工作目录
-equ <NAME> <VAL>参数用法不明
-strequ <NAME> <VAL>参数用法不明
$ n% r( C: D+ U: V: j-erroronwarning参数是当出现任何警告时被视为错误，防止继续编译
8 Z' ^7 x: }8 q; }
<FILE>是汇编代码文件，可用记事本之类编辑
0 r1 n+ s, @  s
1 M# g! J! o9 c/ B  [/ j' z注释说明：
' x. U6 G- @8 q+ D+ K+ [/ v' Q5 U注释可在单行指令后面“;”和“//”添加
' d0 L% d8 ^, }1 j. M“/* */”式也接受

例子：
.open"1234.gba",0x08000000;//打开1234.gba文件，并将起始地址定义为0x08000000
9 E* h' v1 v% ?8 M& {, g' c
" N2 ~) h& R, W( p' C$ O.close;/*关闭文件*/

& w5 Q0 O; D$ U: c; I) T: m3 w2 U标签说明：
标签名可以包含A~Z字母和数字、下划线。但是它不能以数字开头，所有标签名称不区分大小写。

数值说明：
5 z- ^; a3 B9 }. J$ L“0xA”和“0Ah”是16进制数值
! b# R/ b. n) @  C$ r$ ]/ C$ ?“0o12”和“12o”是8进制数值
  w/ f- r$ ?5 W“1010b”和“0b1010”是2进制数值
6 K4 h7 o& @* a
equ说明：
4 A4 j; _3 c4 o" O2 w9 U格式：text equ value
说明：用一个text代替value
% ?& @: I/ R; U- N# e1 M例子：
address1 equ 0x12345678
ldr r0,=address1
.pool
0 z+ z7 ^" @9 v, d8 T" t
1 B7 p$ k+ |9 s& }函数说明：

$ K" r. z4 S0 e% K0 x  W- E.open函数：
格式：
.open "ROM FileName",offset
" u5 }+ L9 a% l- @& L, m. K9 y, ~.open "Old FileName","New FileName",offset
说明：.open函数打开ROM文件，并将ROM文件起始地址设置为offset地址。但结果指定了2个文件，汇编器会将文件复制到第二个路径。
5 e& F& k" B* ^. O' C. _' n2 B
例子：
.open "1234.gba",0x08000000
$ w: i7 r' B6 o5 A6 T
.close函数和.closefile函数：
格式：
  C6 w5 T/ Z% |: S3 r9 i1 f.close
.closefile
说明：关闭文件。

" L. X2 \$ ~; e/ n.org函数和.orga函数：
格式：
.org RamAddress
.orga FileAddress
说明：
前面用.open函数设置过offset地址的话，那么可以用.org函数设置offset输出地址。
/ j) _( I8 x9 y
# s) G& N. L( \7 d* G: r8 q* W9 e( x$ [; ?.orga函数可指定ROM文件的输出地址。
1 M) V  e# K6 ~/ V
# v& l' _9 e- T0 A0 [* O* r" l.create函数和.createfile函数
格式：
# m/ N4 [& F1 ]3 W$ V.create "FileName",offset
/ }) d. T! N3 C2 D+ z.createfile "FileName",offset
+ O6 g' E0 O$ t% c6 x说明：创建一个文件，如果文件是存在，他会覆盖掉。
$ r% ~' A) e$ u! G
.area函数
格式：
.area SizeEquation[,fill]
.endarea
  p' B7 u6 u2 D0 A' G' K说明：如果你要向某地址写入一定字节数值，就用.area函数，SizeEquation是能写入最大字节数，超过就编译失败

例子：向0x100地址写入0x5,0x6,0x7,0x8单字节数据
org 0x100
/ \) j9 a! G' O  _; E.area 0x8
byte 0x5,0x6,0x7,0x8
.endarea
/ P8 O" u8 `5 r3 Q" Z  Y/ W
.align函数
格式：.align num
/ c: m3 F0 n" i9 x2 c说明：写零字节，num为零字节数量，用16进制表示。
9 v6 Y% D2 C/ f2 J4 u2 v
.pool函数
" ~5 u+ t1 ~* }* I格式：.pool
/ D( E, B- ^' c2 u" M+ \$ {说明：如果代码中有“ldr rx,=value”,就要用.pool对齐。
. q/ M7 y2 P5 j& d; c9 }) N: I1 ~例子：
ldr r0,=0x12345678;
2 W$ e: w4 i" K9 o  `7 v....
.pool
* G% n% Y8 b8 D( D8 k, s
2 Y6 f2 D3 a  o1 W$ U5 c5 Y* K.fill函数
% l" U, e: S! |* x; {# K) H格式：
4 m( D! r  R  G8 |.fill length[,value]
, ]* j' }2 M& [# w) C4 edefs length[,value]
/ V3 s" g' w4 ^说明：填充一定长度单字节数值，如果未指定value，而填充零字节数值；length和value用16进制表示。

.skip函数：
格式：.skip length
( F$ o9 s2 v  z说明：跳过指定长度单字节数值，length用16进制表示。

! u2 w3 C# C! n1 F- J  J; q0 q写单字节：
8 B& b. N8 G7 y0 [: v.byte value[,...]
.db value[,...]
% S" D& w4 _  }4 w' W5 a.ascii value[,...]
.asciiz value[,...]
1 f/ X3 T1 D, j3 j& edcb value[,...]
9 S4 _, L6 w' y, \( O( Q
+ i* s0 ]0 t, f1 ^1 s" \写双字节：
0 e3 b, }, L2 S+ N! v! M.halfword value[,...]
.dh value[,...]
dcw value[,...]
% O1 _+ G4 `4 K" t
) j/ D$ T: H, k5 ~/ [9 ]: ?/ w写四字节：
2 F3 `( g/ V4 l. J! V.word value[,...]
.dw value[,...]
dcd value[,...]

5 q! V! ^$ G3 ?0 t* V: U3 f写doublewords：
. l8 W/ u- C% f) I: s8 t.doubleword value[,...]
$ q0 j7 p; r& A  W: S% I' z.dd value[,...]
2 \( O# D7 d) _/ ddcq value[,...]
. ~& r& R5 a" M, g& ?9 X# l
写浮点数：
.float value[,...]
.double value[,...]

ARM的ARM模式和THUMB模式定义：
.arm|ARM模式
3 v- |( C9 R& P! h; g.thumb|thumb模式
7 w6 s( B; j" K8 U0 i7 S6 W
* e2 n4 B4 [& V% N3 L* E* _0 s( J设置架构：
! W  q# |; W7 v# V9 C6 v( R3 _.psx|PlayStation 1(MIPS R3000)
.ps2|PlayStation 2(EmotionEngine)
.psp|PlayStation Portable(Allegrex)
& |1 i' C! `5 V$ w5 P- |.n64|Nintendo 64(MIPS R4000)
.rsp|Nintendo 64(RSP)
, ]4 ~' w- c, t' R  x.gba|GameBoy Advance(ARM7,默认是thumb模式)
.nds|Nintendo DS(ARM9,默认是ARM模式)
/ w3 I6 g6 ^8 P, b7 }/ i, A.3ds|Nintendo 3DS(ARM11,默认是ARM模式)
2 A2 q- `( n: Z/ |( e.arm.big|
.arm.little|
) t- z0 P  A% x' y4 u: {( D$ z
常用函数就写这些了，还有大量函数说明没写，更多说明看readme.md吧。