ARMIPS assembler使用说明

疾风之狼

: C  X5 ]# B% R; rARMIPS assembler是一款ARM/MIPS汇编工具，他是命令行工具，支持ARM7/ARM9/MIPS R3000/MIPS R4000
) ?+ {- G: M0 _0 X
ARMIPS assembler作者是Kingcom,目前发展到0.9版本

Kingcom's website：http://aerie.wingdreams.net
9 I& @, [, q; a5 R6 m
ARMIPS assembler源代码可去https://github.com/Kingcom/armips获得
% w+ K5 S" \. k, ]+ W
- f1 W" t% }2 X) y% L9 k# @. c更新版本可去http://buildbot.orphis.net/armips获得
) v  Y3 R, n: ?- u6 h
ARMIPS assembler特点支持加载ROM并自动编译代码到ROM，省了使用16进制编辑器复制代码进ROM，进行ROM HACK更方便了。
7 `" s; h* r. q* o) X
* s( U3 Y  N* r: f( [0 pARMIPS命令行用法：

. N$ t" G( k0 r1 ^0 k! J4 k/ E& gUsage: armips [optional parameters] <FILE>

Optional parameters:
& P, m* \* \: ]7 U- g  t -temp <TEMP>         Output temporary assembly data to <TEMP> file
" z+ C1 R* i% e' g: Z& F$ F -sym  <SYM>          Output symbol data in the sym format to <SYM> file
4 s# V4 _1 ~0 L: J1 q -sym2 <SYM2>         Output symbol data in the sym2 format to <SYM2> file
-root <ROOT>         Use <ROOT> as working directory during execution
-equ  <NAME> <VAL>   Equivalent to '<NAME> equ <VAL>' in code
- `- `% ]4 I9 e' M* e -strequ <NAME> <VAL> Equivalent to '<NAME> equ "<VAL>"' in code
5 v3 D% x9 i7 `( M& ] -erroronwarning      Treat all warnings like errors

0 \! p7 r, L% hFile arguments:
! m0 |  C# w' d <FILE>               Main assembly code file

-temp <TEMP>参数是将临时汇编数据输出到<TEMP>文件
* ~9 z% G$ w7 |; V: ~" H-sym <SYM>参数是将sym格式符号输出到<SYM>文件，这格式支持no$psx和no$gba
-sym2 <SYM2>参数是将sym2格式符号输出到<SYM2>文件，这格式支持pcsx2和ppsspp
-root <ROOT>参数是指定执行期间要使用的工作目录
-equ <NAME> <VAL>参数用法不明
-strequ <NAME> <VAL>参数用法不明
$ ]# r- S' n) H1 \-erroronwarning参数是当出现任何警告时被视为错误，防止继续编译

<FILE>是汇编代码文件，可用记事本之类编辑

注释说明：
注释可在单行指令后面“;”和“//”添加
“/* */”式也接受
0 S# X; w. [0 E3 K2 p
. w9 x6 |: a8 E9 o5 i% L& J' w例子：
+ X, X1 i1 \2 C.open"1234.gba",0x08000000;//打开1234.gba文件，并将起始地址定义为0x08000000

.close;/*关闭文件*/
; ~3 f7 l+ I4 J3 t
标签说明：
; N. F- u+ {1 M9 ^) e/ F# F5 }标签名可以包含A~Z字母和数字、下划线。但是它不能以数字开头，所有标签名称不区分大小写。

7 _3 l5 K9 p0 Y! p2 E( a0 T# a数值说明：
. W. K, j& f+ L( Z$ P- f“0xA”和“0Ah”是16进制数值
0 d# S8 B2 Z' p“0o12”和“12o”是8进制数值
“1010b”和“0b1010”是2进制数值
: D6 C  a5 K% r1 B0 q
+ w- @/ R# ?1 R0 o# t% @; a' Wequ说明：
格式：text equ value
1 d' v6 H; c' g. c说明：用一个text代替value
例子：
: V, t6 R) U0 M4 B1 \* C2 D1 yaddress1 equ 0x12345678
ldr r0,=address1
) h" P* C. m3 D5 J.pool

3 f: S! ^! w, j4 m/ S函数说明：

9 T1 ]& o! k& s( I.open函数：
  P. u0 C" \; l& h格式：
.open "ROM FileName",offset
.open "Old FileName","New FileName",offset
/ N$ C7 d- ?( M. ^4 |! S说明：.open函数打开ROM文件，并将ROM文件起始地址设置为offset地址。但结果指定了2个文件，汇编器会将文件复制到第二个路径。

- I) ?5 C  W* I, i例子：
( s% c+ h# K+ a' \: X$ H.open "1234.gba",0x08000000
4 r' e1 V* O0 S$ Z2 o
.close函数和.closefile函数：
; x; [7 c# S% E& h( m/ G6 Y格式：
.close
.closefile
说明：关闭文件。

- B5 `+ z" |) H) a  m1 c.org函数和.orga函数：
" ~2 ]) Z" F5 {3 x格式：
. V0 R8 G0 m9 K& J- ~" f; j.org RamAddress
# }7 O9 i3 I" `7 c% e' U.orga FileAddress
说明：
4 J2 p  [& ?5 Y. f6 [, W前面用.open函数设置过offset地址的话，那么可以用.org函数设置offset输出地址。

.orga函数可指定ROM文件的输出地址。
% k0 U- Y7 ?8 `9 w9 `% {$ X
.create函数和.createfile函数
$ V' v( D# a. y) w, E0 K6 ^* _6 |2 H: \格式：
" C1 `0 c/ J3 ?; A: G.create "FileName",offset
.createfile "FileName",offset
说明：创建一个文件，如果文件是存在，他会覆盖掉。
% x6 U8 `5 [9 C( g
* V, O( K- {" c$ V.area函数
格式：
.area SizeEquation[,fill]
. Y7 @( y6 @4 s% z+ y1 D/ @2 @) x) v.endarea
$ @5 C0 f/ {- p$ ^说明：如果你要向某地址写入一定字节数值，就用.area函数，SizeEquation是能写入最大字节数，超过就编译失败

例子：向0x100地址写入0x5,0x6,0x7,0x8单字节数据
+ ^- s  u" T& f& N" aorg 0x100
3 S4 Y; f4 v4 {8 y5 @- ?: n.area 0x8
byte 0x5,0x6,0x7,0x8
.endarea

& {5 P& o; d2 N8 U: d& v/ l5 z$ b' E.align函数
" n5 z4 l5 T# N7 p格式：.align num
说明：写零字节，num为零字节数量，用16进制表示。
( n" U6 P2 h  ^$ n" a; `& [9 R
.pool函数
! h; J5 c5 \& ]) O6 ?格式：.pool
说明：如果代码中有“ldr rx,=value”,就要用.pool对齐。
. U1 ]1 t5 i. h8 f# C例子：
ldr r0,=0x12345678;
....
.pool

! Y" i5 K' |: n% e+ M- b5 a- M6 y.fill函数
格式：
( y( X3 U, K# W, _' F6 }7 j% X.fill length[,value]
( Z& v4 u2 E$ f7 Xdefs length[,value]
说明：填充一定长度单字节数值，如果未指定value，而填充零字节数值；length和value用16进制表示。
" r% G& {( [2 V
.skip函数：
格式：.skip length
说明：跳过指定长度单字节数值，length用16进制表示。

6 C/ x. w3 h: H% w写单字节：
6 p. _( i/ v- P6 f; N.byte value[,...]
" U4 W: s/ U  `9 ?.db value[,...]
.ascii value[,...]
2 ~5 g$ C7 B4 P- I: d9 q.asciiz value[,...]
, f4 T* R* G$ x; Pdcb value[,...]

写双字节：
.halfword value[,...]
) O% C. E- {* D) \0 P5 N' ?.dh value[,...]
dcw value[,...]

0 _5 ?2 r% X9 y$ s写四字节：
/ ^, o6 D2 W+ ~" t0 O% v.word value[,...]
.dw value[,...]
6 c2 u6 j5 h& `- I0 J& Cdcd value[,...]
/ q/ E+ _/ r3 z# t2 p9 D( p. g
4 L5 J1 E& a) B写doublewords：
.doubleword value[,...]
9 k/ ~1 \0 }1 e9 x/ S! H.dd value[,...]
dcq value[,...]

写浮点数：
.float value[,...]
  ~1 F- |$ ^* E.double value[,...]

: ]$ t0 [3 @1 mARM的ARM模式和THUMB模式定义：
1 w! H0 Q3 c9 o8 ]! M) B.arm|ARM模式
! e# ^! w  w& X! U( l# V: X.thumb|thumb模式
. j+ c9 b  M1 _) l3 s! H1 I: f
设置架构：
* P! B; J( @1 V* ~2 z5 e.psx|PlayStation 1(MIPS R3000)
.ps2|PlayStation 2(EmotionEngine)
.psp|PlayStation Portable(Allegrex)
.n64|Nintendo 64(MIPS R4000)
$ y+ ~: I( H) U5 I! i* z, z.rsp|Nintendo 64(RSP)
.gba|GameBoy Advance(ARM7,默认是thumb模式)
; m8 G8 g: Z  O3 r, t& S" t( z.nds|Nintendo DS(ARM9,默认是ARM模式)
.3ds|Nintendo 3DS(ARM11,默认是ARM模式)
.arm.big|
, Y/ O" G0 z/ |; B* l.arm.little|

常用函数就写这些了，还有大量函数说明没写，更多说明看readme.md吧。