ARMIPS assembler使用说明

疾风之狼

3 h% v7 z0 {2 i! S" GARMIPS assembler是一款ARM/MIPS汇编工具，他是命令行工具，支持ARM7/ARM9/MIPS R3000/MIPS R4000

" R: P7 F+ M" p, m- F/ MARMIPS assembler作者是Kingcom,目前发展到0.9版本
8 h1 h7 d' a5 c# m& V5 P
Kingcom's website：http://aerie.wingdreams.net
* m: h% ~3 D9 `1 m  x
8 G  \* W" B9 ?: j0 v+ p% `ARMIPS assembler源代码可去https://github.com/Kingcom/armips获得
& ^9 ?2 a( m5 F' H9 \* F
* k0 x( ?7 T+ Q* B更新版本可去http://buildbot.orphis.net/armips获得

! \  L, f+ N& M5 TARMIPS assembler特点支持加载ROM并自动编译代码到ROM，省了使用16进制编辑器复制代码进ROM，进行ROM HACK更方便了。

2 ^( B; I6 \( ?( M) b& O" x2 qARMIPS命令行用法：

Usage: armips [optional parameters] <FILE>

Optional parameters:
4 @2 f! r# p! i- P' t& g+ z' e) p -temp <TEMP>         Output temporary assembly data to <TEMP> file
-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
7 a  u% @& c5 A# x' G5 q* s' z2 z -equ  <NAME> <VAL>   Equivalent to '<NAME> equ <VAL>' in code
! S7 c) I3 S2 z0 P; [' U4 z: w -strequ <NAME> <VAL> Equivalent to '<NAME> equ "<VAL>"' in code
" d+ |7 G8 l  Z -erroronwarning      Treat all warnings like errors
6 P5 T( B+ g3 e$ |+ U+ v8 `- ^8 h
File arguments:
<FILE>               Main assembly code file
- ~8 _' c4 Z; g9 e
$ x, d) d: W; p4 q7 c7 C-temp <TEMP>参数是将临时汇编数据输出到<TEMP>文件
& m8 }  K8 [. n2 Y. P-sym <SYM>参数是将sym格式符号输出到<SYM>文件，这格式支持no$psx和no$gba
/ E; M! O9 W2 b-sym2 <SYM2>参数是将sym2格式符号输出到<SYM2>文件，这格式支持pcsx2和ppsspp
-root <ROOT>参数是指定执行期间要使用的工作目录
: D" z; j6 U( _* ]( j-equ <NAME> <VAL>参数用法不明
-strequ <NAME> <VAL>参数用法不明
( f" g4 K; x: z-erroronwarning参数是当出现任何警告时被视为错误，防止继续编译
* i) K; x% p; b; Q' o
<FILE>是汇编代码文件，可用记事本之类编辑
. _7 n- x8 b1 C8 g
6 d$ u% D7 N) F8 F注释说明：
3 A% a. e3 U4 `+ b注释可在单行指令后面“;”和“//”添加
“/* */”式也接受

- d. \9 D2 K$ O0 I1 i4 H例子：
.open"1234.gba",0x08000000;//打开1234.gba文件，并将起始地址定义为0x08000000

% n0 ]7 v7 o2 J! S.close;/*关闭文件*/

& j# _: z& d4 M1 V! w  B: Z标签说明：
标签名可以包含A~Z字母和数字、下划线。但是它不能以数字开头，所有标签名称不区分大小写。
& |4 E1 Y; f" O5 `1 l% f8 K
数值说明：
“0xA”和“0Ah”是16进制数值
1 o' v, c  e3 C" R9 e; X! m“0o12”和“12o”是8进制数值
“1010b”和“0b1010”是2进制数值
% h0 G; b* i0 ]+ w9 i) a( n
9 r1 `) g( e; R+ c  ^9 @/ ?equ说明：
格式：text equ value
2 a! M' d8 O. w! @6 M, B" K+ q. B说明：用一个text代替value
例子：
. G# `8 H: u$ raddress1 equ 0x12345678
ldr r0,=address1
.pool

函数说明：

6 {- h2 ?) ?6 ~/ U' O: k. H) V.open函数：
格式：
7 G$ a! z$ Z2 g4 T7 E4 ].open "ROM FileName",offset
+ _8 l$ k% _" u' }# l& w: V.open "Old FileName","New FileName",offset
说明：.open函数打开ROM文件，并将ROM文件起始地址设置为offset地址。但结果指定了2个文件，汇编器会将文件复制到第二个路径。

3 B7 f9 L* ]! C6 h- O/ ~" s例子：
& ]% l( V* d" [! Y.open "1234.gba",0x08000000
* F' w# w2 h) E6 v- S/ ?1 Z% z
  a4 a/ C# w' a5 t# Y3 g.close函数和.closefile函数：
* B4 u3 {, u5 x6 Q0 U0 \8 I! v格式：
.close
0 N8 u7 i' Z+ X3 S+ c  ].closefile
- M) n6 ]  T6 G2 [3 ~* W. H6 N* h说明：关闭文件。
1 N$ g5 ^2 U0 v2 v+ E1 B' T$ @
.org函数和.orga函数：
% f9 K" c5 P: y7 F+ b格式：
.org RamAddress
  q! X- Q3 j) v2 y5 w0 @.orga FileAddress
说明：
前面用.open函数设置过offset地址的话，那么可以用.org函数设置offset输出地址。
. a- g5 I4 w; d$ I: i: H( `( A
% e$ b- B# j' ^1 i8 {% e.orga函数可指定ROM文件的输出地址。

7 g! x% G4 o. M+ f" R& n* w.create函数和.createfile函数
7 q% c4 ?. o: j5 p格式：
, W( B7 D$ {) z.create "FileName",offset
.createfile "FileName",offset
3 L4 R* Y- k7 |说明：创建一个文件，如果文件是存在，他会覆盖掉。

4 B" H/ |. i7 k4 F5 X2 D2 y9 ].area函数
. ~+ v2 E4 F* X格式：
.area SizeEquation[,fill]
# l# A) |; V( R% o7 y) s.endarea
说明：如果你要向某地址写入一定字节数值，就用.area函数，SizeEquation是能写入最大字节数，超过就编译失败

8 V* W; Z( J8 d例子：向0x100地址写入0x5,0x6,0x7,0x8单字节数据
org 0x100
.area 0x8
byte 0x5,0x6,0x7,0x8
& t4 S. r, g: b+ b! w% Z$ P4 b.endarea

.align函数
$ d- V) q2 U! _1 u* g4 P+ ~9 j3 k4 v格式：.align num
1 _" A- a: ?( s9 L说明：写零字节，num为零字节数量，用16进制表示。

, d& S9 L# r9 o, M  U+ ^4 ?.pool函数
格式：.pool
% A& y/ S% K) l说明：如果代码中有“ldr rx,=value”,就要用.pool对齐。
" l$ v- B/ X. P例子：
ldr r0,=0x12345678;
....
3 l' i; A* F! u- G.pool
3 x7 r' Q: r8 L; \  S+ D- Z
.fill函数
4 c0 g+ R8 A; y# f' W/ `7 y格式：
5 ]6 b; e, R/ w+ p1 ~4 o6 A.fill length[,value]
, e9 k  ~, }1 T  l# idefs length[,value]
0 o$ ]' W, ?5 `- D说明：填充一定长度单字节数值，如果未指定value，而填充零字节数值；length和value用16进制表示。

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

写单字节：
.byte value[,...]
/ B# N& ^- M; E/ M8 @.db value[,...]
.ascii value[,...]
.asciiz value[,...]
dcb value[,...]

写双字节：
.halfword value[,...]
.dh value[,...]
$ |! h6 {0 c, Qdcw value[,...]
, O  y$ e/ H! A' G+ q
  x, }1 T8 Z- C" T# L' M写四字节：
.word value[,...]
.dw value[,...]
0 P4 w0 r* C2 P, Y/ j' ydcd value[,...]
# Z) t. N6 m! B3 L' `, }
$ n9 L" m5 g6 G& [$ @; [写doublewords：
: o$ V" N) q) U- ~.doubleword value[,...]
.dd value[,...]
dcq value[,...]

  L6 S6 f7 e2 O9 g8 z写浮点数：
.float value[,...]
4 x4 [% J" j% T2 D. [) P# ].double value[,...]
, G: @+ }- M" Y, Y- ]4 [' {! R; d( |* i
+ i7 ]; Q1 o+ G# OARM的ARM模式和THUMB模式定义：
% e" Q4 n) X% b- O5 Z& a  @.arm|ARM模式
.thumb|thumb模式

设置架构：
' j0 c! U- }, S9 e6 g$ X.psx|PlayStation 1(MIPS R3000)
.ps2|PlayStation 2(EmotionEngine)
! @5 Y; p7 J. u( T* q& ?.psp|PlayStation Portable(Allegrex)
' d2 B9 W+ e6 u6 Y.n64|Nintendo 64(MIPS R4000)
.rsp|Nintendo 64(RSP)
.gba|GameBoy Advance(ARM7,默认是thumb模式)
4 J' ]* D# W" M" W2 u  W.nds|Nintendo DS(ARM9,默认是ARM模式)
.3ds|Nintendo 3DS(ARM11,默认是ARM模式)
.arm.big|
.arm.little|
7 L& d! P8 k8 f& B, Y) f  m" L8 {
常用函数就写这些了，还有大量函数说明没写，更多说明看readme.md吧。
( p) O$ \1 l6 I, N, \$ i