ARMIPS assembler使用说明

疾风之狼

# V0 i5 W/ n- t3 xARMIPS assembler是一款ARM/MIPS汇编工具，他是命令行工具，支持ARM7/ARM9/MIPS R3000/MIPS R4000
- W4 M3 ?+ n, v1 p  |5 _- x+ |
6 _; e% t3 E* T& `3 MARMIPS assembler作者是Kingcom,目前发展到0.9版本

& t3 o1 l$ M: K- @( `; o' ]1 |! o3 xKingcom's website：http://aerie.wingdreams.net

ARMIPS assembler源代码可去https://github.com/Kingcom/armips获得
$ b) l2 C! r9 ]5 ^+ m% W% e
6 m0 J1 D# Y5 R7 i更新版本可去http://buildbot.orphis.net/armips获得

4 r1 [, S" _8 f) V& \# j' NARMIPS assembler特点支持加载ROM并自动编译代码到ROM，省了使用16进制编辑器复制代码进ROM，进行ROM HACK更方便了。
8 c( W% J9 [) Z! |/ n9 X9 M+ T
ARMIPS命令行用法：

+ D& j/ i, B6 N: tUsage: armips [optional parameters] <FILE>
+ y5 [& ?% h8 O& l; H* A0 e
Optional parameters:
3 n, E2 F# l, r+ A6 l/ @2 C8 h9 x -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
# P3 M; `. N5 F -root <ROOT>         Use <ROOT> as working directory during execution
-equ  <NAME> <VAL>   Equivalent to '<NAME> equ <VAL>' in code
-strequ <NAME> <VAL> Equivalent to '<NAME> equ "<VAL>"' in code
- |# n4 o0 \0 G -erroronwarning      Treat all warnings like errors

File arguments:
* b( m( i9 B2 O' _4 @$ n5 ^( F8 X <FILE>               Main assembly code file
) r' e7 |2 f* x( O1 q
-temp <TEMP>参数是将临时汇编数据输出到<TEMP>文件
-sym <SYM>参数是将sym格式符号输出到<SYM>文件，这格式支持no$psx和no$gba
-sym2 <SYM2>参数是将sym2格式符号输出到<SYM2>文件，这格式支持pcsx2和ppsspp
4 |" j  m7 `0 k4 O6 D-root <ROOT>参数是指定执行期间要使用的工作目录
-equ <NAME> <VAL>参数用法不明
-strequ <NAME> <VAL>参数用法不明
-erroronwarning参数是当出现任何警告时被视为错误，防止继续编译
1 c2 t1 @9 o% T3 D( j8 P# z
<FILE>是汇编代码文件，可用记事本之类编辑
+ O4 {# ~8 y* \, ?6 n# v
) @0 a/ T/ p# x: l: Z$ x0 t注释说明：
7 X$ w. p; N9 X8 {- S注释可在单行指令后面“;”和“//”添加
. B5 W/ m$ f% z“/* */”式也接受
. a/ s3 Q( J! i8 `
* }; ^- G/ z% {+ N& V9 y! S例子：
.open"1234.gba",0x08000000;//打开1234.gba文件，并将起始地址定义为0x08000000

' [  S3 Y1 ~& c& n.close;/*关闭文件*/

% e' y2 t. h- b) C* o. p5 X3 E; s标签说明：
标签名可以包含A~Z字母和数字、下划线。但是它不能以数字开头，所有标签名称不区分大小写。

数值说明：
“0xA”和“0Ah”是16进制数值
“0o12”和“12o”是8进制数值
% u9 i2 h! t6 ?- ^0 e“1010b”和“0b1010”是2进制数值
6 N+ d0 T. U0 l% U: O
equ说明：
格式：text equ value
. n9 V+ a$ p4 `2 D) s说明：用一个text代替value
例子：
( s2 Z, n& y! laddress1 equ 0x12345678
ldr r0,=address1
8 d) D# [3 q% G7 J* I.pool

; f' L( j3 M# m函数说明：
, r& z. W. H3 q  X4 L
.open函数：
格式：
.open "ROM FileName",offset
.open "Old FileName","New FileName",offset
- r9 f0 ?2 Y7 i, r说明：.open函数打开ROM文件，并将ROM文件起始地址设置为offset地址。但结果指定了2个文件，汇编器会将文件复制到第二个路径。
" l7 w, O) g3 [
1 \+ d* w! I  f5 R8 o2 A' p5 M. |% s+ L+ X$ l例子：
.open "1234.gba",0x08000000

.close函数和.closefile函数：
格式：
.close
.closefile
说明：关闭文件。
" P2 l& D; m6 [# P  z3 Z9 T
: }/ N( p7 E8 z. E  M.org函数和.orga函数：
$ S. n/ G( o. G格式：
.org RamAddress
.orga FileAddress
! `8 n1 P# d. i说明：
1 c% x" L: h) t前面用.open函数设置过offset地址的话，那么可以用.org函数设置offset输出地址。
9 ~& J* b( o3 a' D9 E% I9 n# \7 u+ ^
.orga函数可指定ROM文件的输出地址。

.create函数和.createfile函数
6 N* X: z! c1 f格式：
.create "FileName",offset
.createfile "FileName",offset
说明：创建一个文件，如果文件是存在，他会覆盖掉。

.area函数
格式：
: ~3 C* S  ~  Q9 e+ ?, Y.area SizeEquation[,fill]
.endarea
说明：如果你要向某地址写入一定字节数值，就用.area函数，SizeEquation是能写入最大字节数，超过就编译失败
1 i7 P: I. U. p
' ~+ f5 H% q9 J; A+ a9 ~例子：向0x100地址写入0x5,0x6,0x7,0x8单字节数据
4 i7 K, s4 J" U6 h# r1 Yorg 0x100
.area 0x8
byte 0x5,0x6,0x7,0x8
' W: [1 z+ k. f.endarea
( F6 a& X+ s3 u" ^& D0 ^  O* V
.align函数
格式：.align num
3 z" ^9 Z5 F& i说明：写零字节，num为零字节数量，用16进制表示。
7 ?; m7 v4 C9 L, ~: _5 |. `: y
.pool函数
. b' x8 Y$ Z1 _8 [格式：.pool
$ H: }9 c6 D3 i- U说明：如果代码中有“ldr rx,=value”,就要用.pool对齐。
例子：
ldr r0,=0x12345678;
! }- S- h1 t( Q5 T. ~....
.pool

) o) P* n" o* J& T% c2 Z0 B( Z.fill函数
: a8 P$ h! E. K: b) J' G% u格式：
' Z5 d( O) e: @: w6 J- V.fill length[,value]
0 B* ]6 V/ H) o$ p2 @defs length[,value]
) u4 z, D) I3 d5 X  @说明：填充一定长度单字节数值，如果未指定value，而填充零字节数值；length和value用16进制表示。
- |9 U/ R2 ?3 F& [8 u  K
( A( g% W/ z  O6 E.skip函数：
! O- T+ |. J7 b/ F; G6 s格式：.skip length
说明：跳过指定长度单字节数值，length用16进制表示。

# ~+ G5 U) X+ B* G" C6 J写单字节：
7 b3 h( U# R% L( ~* d.byte value[,...]
.db value[,...]
.ascii value[,...]
! G  q6 T. B8 {1 ], B2 @5 N.asciiz value[,...]
dcb value[,...]
; Z  G6 ^5 i* h
' z# c$ e! T+ a9 }0 N  Y) L写双字节：
9 j6 V; f5 k3 a.halfword value[,...]
% d; S. k) a7 A( Z.dh value[,...]
8 G" Z+ }0 \" D6 T( d9 ]dcw value[,...]
  F/ S- B! Y: }4 }  V
# n! N' u9 B: S2 Z( I写四字节：
3 ]" q* T. A2 N.word value[,...]
.dw value[,...]
, {: u- Y; ~1 y/ A- g1 y0 d- S5 Kdcd value[,...]
9 {( U1 E0 y! w; F/ F6 G
写doublewords：
. ?5 `# I/ p$ L# q, p.doubleword value[,...]
4 N9 S  h% Q2 U  P4 @* {0 X" m.dd value[,...]
# I( T+ w/ X! V  U5 p, Udcq value[,...]

2 f3 z( c" H% Q+ x: z- h# q/ O写浮点数：
& [  t3 `4 T% Q! [.float value[,...]
.double value[,...]

ARM的ARM模式和THUMB模式定义：
.arm|ARM模式
  X& `( d3 U" ]$ D0 z.thumb|thumb模式

设置架构：
* q/ @1 c; H+ h( [1 D.psx|PlayStation 1(MIPS R3000)
, B! T( ^4 w5 {- Y* R: F3 M.ps2|PlayStation 2(EmotionEngine)
  p, v: I0 L% ~5 m& H: N; W1 x.psp|PlayStation Portable(Allegrex)
, P' N5 ^0 M) S5 i( @' h3 [.n64|Nintendo 64(MIPS R4000)
' P* e) ?4 M( Z.rsp|Nintendo 64(RSP)
4 T6 _; n) ~0 R; @7 y+ W0 T3 E  s7 l.gba|GameBoy Advance(ARM7,默认是thumb模式)
.nds|Nintendo DS(ARM9,默认是ARM模式)
& t3 Y6 A) W2 p& l.3ds|Nintendo 3DS(ARM11,默认是ARM模式)
.arm.big|
0 K' h. ?, k- @+ C* c3 v) `8 M.arm.little|

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