ARMIPS assembler使用说明

疾风之狼

- i4 f1 k, i) v0 p& K0 _ARMIPS assembler是一款ARM/MIPS汇编工具，他是命令行工具，支持ARM7/ARM9/MIPS R3000/MIPS R4000
& `4 v! o6 D1 P8 k5 i  m+ @
ARMIPS assembler作者是Kingcom,目前发展到0.9版本

# v& o$ [+ [+ u* Q. BKingcom's website：http://aerie.wingdreams.net
  I# R8 _7 k- t
* x8 @1 L* Y) x/ j7 b& DARMIPS assembler源代码可去https://github.com/Kingcom/armips获得
& a) }1 T1 V) c7 b. d3 @
/ O7 h# F) s' P2 s更新版本可去http://buildbot.orphis.net/armips获得

: V/ G- n9 @3 D4 uARMIPS assembler特点支持加载ROM并自动编译代码到ROM，省了使用16进制编辑器复制代码进ROM，进行ROM HACK更方便了。

- t/ ^& n3 e- TARMIPS命令行用法：
5 r+ N; R; z7 c4 N8 c
Usage: armips [optional parameters] <FILE>

Optional parameters:
% A4 _7 ~1 A, x* J& \' W/ J: f8 i -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
3 d" p4 Q* ~, a" i' r, n -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
% T( I6 Q/ K8 f3 Q6 y: k -erroronwarning      Treat all warnings like errors

3 [9 l) q, y2 R9 p" ^File arguments:
; S+ G1 Z4 Q% K0 w  b0 ~ <FILE>               Main assembly code file
  t* T: f, p& C7 c6 Z- B3 O5 q
) x* C; P' Y8 I-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>参数用法不明
( T9 A6 o8 q0 ^  U6 W! z-erroronwarning参数是当出现任何警告时被视为错误，防止继续编译
( w* F5 j; m! L* ^
4 H% C6 r1 n% W( [) z! F! l% T<FILE>是汇编代码文件，可用记事本之类编辑
5 A$ o2 Y7 f0 d8 z8 }1 D
注释说明：
; T4 g8 a) g$ U$ W4 ~: e. O1 d注释可在单行指令后面“;”和“//”添加
“/* */”式也接受
. K) }- I; u) w3 J
例子：
3 h4 d6 c1 [: p# o+ W7 K) z% \.open"1234.gba",0x08000000;//打开1234.gba文件，并将起始地址定义为0x08000000

.close;/*关闭文件*/
6 h& f6 ~) X) e. s. j- d  f
标签说明：
标签名可以包含A~Z字母和数字、下划线。但是它不能以数字开头，所有标签名称不区分大小写。
! C" ^, D4 U9 ^% d% @9 }: v- M) c
数值说明：
# H+ j* T4 M2 o6 k: j+ q5 j“0xA”和“0Ah”是16进制数值
+ K2 s1 s+ i) d- [9 S# K“0o12”和“12o”是8进制数值
  ]( t: S$ V9 ?% G4 s“1010b”和“0b1010”是2进制数值
. c, J# g7 g6 E  ~
equ说明：
& u2 s& p2 b/ K' m9 L格式：text equ value
说明：用一个text代替value
! M- Z. D7 N" q* B9 T例子：
, W) q4 ?$ _5 u) Daddress1 equ 0x12345678
ldr r0,=address1
) M5 ^# v0 m4 M) j.pool

( {6 v  q; J2 K( R' k函数说明：
8 X1 l( H  v' b
.open函数：
; i8 ?9 s0 p3 t格式：
.open "ROM FileName",offset
1 z1 s8 L) ?- l# l$ ]4 I.open "Old FileName","New FileName",offset
% e4 o; b; i; s6 M: h2 U说明：.open函数打开ROM文件，并将ROM文件起始地址设置为offset地址。但结果指定了2个文件，汇编器会将文件复制到第二个路径。
3 Z% }: q& y& v
! T: D5 d2 P; ~4 ^- {例子：
.open "1234.gba",0x08000000
! z$ w6 P: ~4 ?& f% q
.close函数和.closefile函数：
格式：
# ?% z) I' I# C' v* U, p.close
% \' P/ d- @  }: t" y# S2 |.closefile
' b: S3 l; e+ w2 d( l8 g说明：关闭文件。

1 P- v% K7 F# s.org函数和.orga函数：
格式：
.org RamAddress
.orga FileAddress
说明：
前面用.open函数设置过offset地址的话，那么可以用.org函数设置offset输出地址。
! T# K7 {6 T  \7 x: ^% d* @
.orga函数可指定ROM文件的输出地址。
5 M. ~( C$ g( U1 P
.create函数和.createfile函数
* O: R2 {' n; F3 b8 Z格式：
.create "FileName",offset
  @9 K3 J  ~+ r" f& v.createfile "FileName",offset
8 a# y( K' }. [3 A说明：创建一个文件，如果文件是存在，他会覆盖掉。

+ X* P2 ]0 V! v- X+ d! B/ j7 k.area函数
2 B3 |$ D7 W6 ?7 G, _2 n格式：
.area SizeEquation[,fill]
.endarea
说明：如果你要向某地址写入一定字节数值，就用.area函数，SizeEquation是能写入最大字节数，超过就编译失败

例子：向0x100地址写入0x5,0x6,0x7,0x8单字节数据
org 0x100
' ~+ V$ f8 L: m' B# v.area 0x8
byte 0x5,0x6,0x7,0x8
.endarea

.align函数
格式：.align num
" }. R0 y# J! l9 L6 j) c, R. I+ B说明：写零字节，num为零字节数量，用16进制表示。

; S  w/ H# E( x3 Y% A2 Q/ C& g.pool函数
格式：.pool
5 ]" n: n1 y6 ?! z/ e+ K说明：如果代码中有“ldr rx,=value”,就要用.pool对齐。
1 f) s: M/ E$ v2 C4 G. l  r例子：
ldr r0,=0x12345678;
....
8 a! I% v0 k6 }# @" U  H.pool
% I- O" ?# F6 F# I0 F
.fill函数
+ y  X+ w0 a! r2 n格式：
.fill length[,value]
  w2 f) R5 R$ L. s+ d: Bdefs length[,value]
( g7 H% B( }  H* S; H9 T4 C说明：填充一定长度单字节数值，如果未指定value，而填充零字节数值；length和value用16进制表示。
4 i1 t$ o: C  h2 g" [/ J
.skip函数：
格式：.skip length
说明：跳过指定长度单字节数值，length用16进制表示。
+ s. d6 N8 ?" `5 P4 R. J) x1 ?# E
写单字节：
# R  r: V, S7 ?9 w! r% Z) e' V3 x.byte value[,...]
% b; D2 z) g9 I3 ^; C.db value[,...]
2 a8 E- V7 z7 A0 M3 |1 |.ascii value[,...]
! @6 f: w7 N7 ?' p' i$ u+ B; D.asciiz value[,...]
( K, i6 E. a/ ~/ j7 \7 jdcb value[,...]
, ]) \# G+ w1 d( t
写双字节：
0 _, z6 t( O+ ?$ C.halfword value[,...]
.dh value[,...]
% ~$ Z2 t/ m9 W! ~4 kdcw value[,...]
8 J/ `$ m& {( ]% k! V
( d: v7 _! Q- |+ u" \0 Z; \$ O写四字节：
5 b  N  H5 I8 @2 B5 x3 n( N.word value[,...]
! K1 B- {+ u! o" {2 s! P( I0 n5 L.dw value[,...]
7 a9 J8 n3 d. Q& ~: S' k6 ydcd value[,...]
  k' W3 ?& ~) g* h
. F/ }5 C- o# O2 a* m8 o写doublewords：
.doubleword value[,...]
( O: V6 `  R' f.dd value[,...]
dcq value[,...]

写浮点数：
.float value[,...]
.double value[,...]

ARM的ARM模式和THUMB模式定义：
: N  Q: [3 A5 {3 \( ^. S2 N' g.arm|ARM模式
.thumb|thumb模式
# ?8 C3 E- M; f1 z
设置架构：
) m2 t) e9 Y! ^7 F.psx|PlayStation 1(MIPS R3000)
# q9 c3 S1 u: Z, F.ps2|PlayStation 2(EmotionEngine)
.psp|PlayStation Portable(Allegrex)
.n64|Nintendo 64(MIPS R4000)
.rsp|Nintendo 64(RSP)
  U" k; g9 ~, `. w4 o# ~6 f.gba|GameBoy Advance(ARM7,默认是thumb模式)
" I, j6 h( e  J& j; k.nds|Nintendo DS(ARM9,默认是ARM模式)
.3ds|Nintendo 3DS(ARM11,默认是ARM模式)
.arm.big|
, T( y+ N. k% W7 m# l# G( U.arm.little|

常用函数就写这些了，还有大量函数说明没写，更多说明看readme.md吧。
$ ?; a; E/ m. B2 {* Z6 G