ARMIPS assembler使用说明

疾风之狼

  }8 v5 a9 O+ u5 d+ A$ iARMIPS assembler是一款ARM/MIPS汇编工具，他是命令行工具，支持ARM7/ARM9/MIPS R3000/MIPS R4000

4 A7 Z' a$ P* C2 NARMIPS assembler作者是Kingcom,目前发展到0.9版本
  j, a- z4 ^7 O0 \9 @
5 M' A/ [5 w; G( nKingcom's website：http://aerie.wingdreams.net
+ {. M9 {  ]3 E' z! n: q
  y0 r# a1 X( ?& G3 |- w+ b2 i9 }ARMIPS assembler源代码可去https://github.com/Kingcom/armips获得
% G  @7 Q# g! p* y$ o
更新版本可去http://buildbot.orphis.net/armips获得
4 M8 [6 k. w6 h, {
7 h2 P  Y2 p3 e# BARMIPS assembler特点支持加载ROM并自动编译代码到ROM，省了使用16进制编辑器复制代码进ROM，进行ROM HACK更方便了。

! `3 K8 B; K- X3 ^0 oARMIPS命令行用法：

  K+ S' v6 X- g' EUsage: armips [optional parameters] <FILE>

9 x; h! k0 a' e7 ~/ `Optional parameters:
5 c- O( k0 q2 b+ ?, J2 p -temp <TEMP>         Output temporary assembly data to <TEMP> file
-sym  <SYM>          Output symbol data in the sym format to <SYM> file
7 w; T( J: j+ u; A5 I( R -sym2 <SYM2>         Output symbol data in the sym2 format to <SYM2> file
+ Y+ o: q3 g0 m3 O -root <ROOT>         Use <ROOT> as working directory during execution
! y" ]% W5 F( k -equ  <NAME> <VAL>   Equivalent to '<NAME> equ <VAL>' in code
-strequ <NAME> <VAL> Equivalent to '<NAME> equ "<VAL>"' in code
-erroronwarning      Treat all warnings like errors
9 {5 S' E8 [+ m
  P' ?: S4 L! Z, uFile arguments:
<FILE>               Main assembly code file
3 I4 \6 F# P3 @& l0 x' T) A
-temp <TEMP>参数是将临时汇编数据输出到<TEMP>文件
-sym <SYM>参数是将sym格式符号输出到<SYM>文件，这格式支持no$psx和no$gba
-sym2 <SYM2>参数是将sym2格式符号输出到<SYM2>文件，这格式支持pcsx2和ppsspp
7 z; Q5 ?- B7 B+ `+ k+ |1 ~-root <ROOT>参数是指定执行期间要使用的工作目录
-equ <NAME> <VAL>参数用法不明
. I6 K! g5 F- b# @! W) ]$ Z-strequ <NAME> <VAL>参数用法不明
-erroronwarning参数是当出现任何警告时被视为错误，防止继续编译

<FILE>是汇编代码文件，可用记事本之类编辑
: Q, P4 r  h) P( N, F$ O
& q/ x! V( K& F1 }" S  [注释说明：
% u* x; s. e1 C7 l" ]4 V# ]注释可在单行指令后面“;”和“//”添加
8 @6 f5 R* F4 a$ y- E; u“/* */”式也接受

例子：
  f& Y' H  a$ h  N' q- l% M.open"1234.gba",0x08000000;//打开1234.gba文件，并将起始地址定义为0x08000000

+ }6 D' ~+ V% m5 \7 g.close;/*关闭文件*/
- g8 e* i0 i. `, S) q' R6 u8 g
. j% [7 q" K$ i% j* `8 }标签说明：
标签名可以包含A~Z字母和数字、下划线。但是它不能以数字开头，所有标签名称不区分大小写。

数值说明：
6 l" ~9 ^; h$ d) e) Y5 s“0xA”和“0Ah”是16进制数值
9 ^( d1 r8 L4 Q) ~0 v+ T4 f! n8 E“0o12”和“12o”是8进制数值
“1010b”和“0b1010”是2进制数值
* l8 z5 g1 K% h1 h
; f6 A% v0 F, K- x% B/ oequ说明：
格式：text equ value
说明：用一个text代替value
例子：
address1 equ 0x12345678
: T: U: V5 R9 Y; N& c. Gldr r0,=address1
.pool
0 P+ y9 c  `& W# E- z1 F/ E! H
3 z8 {( n! X* |  Y1 U% W# Q函数说明：
9 d; i/ q4 i( I' T/ X
.open函数：
格式：
8 z/ _1 J" z4 l' n: L) C8 k.open "ROM FileName",offset
' A" }! T4 A" e( l* U.open "Old FileName","New FileName",offset
说明：.open函数打开ROM文件，并将ROM文件起始地址设置为offset地址。但结果指定了2个文件，汇编器会将文件复制到第二个路径。
( J+ t' e- M. W6 O' v2 Y) T
例子：
# n/ Y% H" X% m! ~. E5 v.open "1234.gba",0x08000000
+ d4 Z2 b; n1 |5 N& ?
0 l% S; [" B+ K1 A.close函数和.closefile函数：
: O5 B- r( y" j# K8 @& w9 J/ v# F% K格式：
.close
: X+ d' L; X5 T.closefile
9 u$ n$ M! S$ U9 ?- U说明：关闭文件。

3 ?+ |! ^% ]! R/ ?3 r1 q- y9 R.org函数和.orga函数：
格式：
.org RamAddress
.orga FileAddress
说明：
前面用.open函数设置过offset地址的话，那么可以用.org函数设置offset输出地址。

.orga函数可指定ROM文件的输出地址。
4 @% |+ W7 h9 K+ }5 _$ c6 W' B
$ Z/ [8 U2 s( H; F- g+ _$ Z.create函数和.createfile函数
7 O  Q+ @4 q/ B4 Q格式：
) Q7 p+ q' y# x; T6 U0 A, c  y.create "FileName",offset
.createfile "FileName",offset
说明：创建一个文件，如果文件是存在，他会覆盖掉。

.area函数
格式：
/ [; Y: V7 x; F2 i; Y% p.area SizeEquation[,fill]
.endarea
说明：如果你要向某地址写入一定字节数值，就用.area函数，SizeEquation是能写入最大字节数，超过就编译失败
, a" E" n0 `* g0 w  l6 k5 {
例子：向0x100地址写入0x5,0x6,0x7,0x8单字节数据
* }. P" J, V' }0 {" m- `org 0x100
.area 0x8
byte 0x5,0x6,0x7,0x8
.endarea
8 i: g! X. k' [* O9 n( ]
# M1 Z# t6 G% \5 n- N9 B% U.align函数
格式：.align num
说明：写零字节，num为零字节数量，用16进制表示。

! J+ s, j- P/ z$ F% i.pool函数
6 M: G0 G3 g' K8 c/ t; y格式：.pool
7 a, K, {. _5 k7 I2 `: B/ C说明：如果代码中有“ldr rx,=value”,就要用.pool对齐。
) [) {  U9 z$ P2 T7 G例子：
ldr r0,=0x12345678;
5 d2 }  J1 q4 X% v; o# R. _; Y....
" A/ B7 i5 d( K3 O7 ].pool

8 S3 [& i6 C* P- p.fill函数
6 K) v+ G2 m4 o7 A格式：
.fill length[,value]
defs length[,value]
说明：填充一定长度单字节数值，如果未指定value，而填充零字节数值；length和value用16进制表示。
4 F. [2 a: D. p" ^
.skip函数：
) @  i6 D/ a9 O, k1 P格式：.skip length
5 b( k3 a* G# B- Q+ a* W) P& P* ~# \说明：跳过指定长度单字节数值，length用16进制表示。
+ B  j# `, Y1 B
写单字节：
.byte value[,...]
: _: S! u3 y+ [1 f$ t$ [7 \.db value[,...]
.ascii value[,...]
1 y9 `% G  C, m: u  d.asciiz value[,...]
/ \* X0 n, x/ n% \dcb value[,...]
# ]3 h* y3 U. @% p
写双字节：
2 R+ l. W7 _: L.halfword value[,...]
.dh value[,...]
dcw value[,...]
* L  k- H2 ~; J5 Z, O7 B
% l9 [  o0 ]5 p/ O' ^写四字节：
.word value[,...]
.dw value[,...]
dcd value[,...]

写doublewords：
' Y% }. `4 o! t3 A# ^.doubleword value[,...]
+ ~) ?7 ~. u0 g- W; a.dd value[,...]
1 P( @; g2 s' p' ~8 Z. a- B% udcq value[,...]
) ~/ l# w4 g' U: N% I; h
2 v' S2 [9 Q3 \! U& u" I7 ?写浮点数：
1 Z- A  x' q2 M: Y& S# O# z.float value[,...]
.double value[,...]

ARM的ARM模式和THUMB模式定义：
.arm|ARM模式
.thumb|thumb模式
2 h* X# f( v. C
设置架构：
.psx|PlayStation 1(MIPS R3000)
.ps2|PlayStation 2(EmotionEngine)
9 X) F* A$ K, F: m# x; U( ~+ e' e.psp|PlayStation Portable(Allegrex)
.n64|Nintendo 64(MIPS R4000)
8 U% b: H* y* I# M.rsp|Nintendo 64(RSP)
.gba|GameBoy Advance(ARM7,默认是thumb模式)
.nds|Nintendo DS(ARM9,默认是ARM模式)
. _; A! U4 D4 q. V0 |.3ds|Nintendo 3DS(ARM11,默认是ARM模式)
.arm.big|
& i. B; d6 M/ c; s$ C) V( z2 y.arm.little|
# o  t& f4 Q/ `
: {9 ?6 q+ Z8 E9 u4 \, D* G, q, V, y常用函数就写这些了，还有大量函数说明没写，更多说明看readme.md吧。
, @$ z8 {% F* |2 j