diff options
author | Jim Wilson <jimw@sifive.com> | 2018-03-14 16:04:03 -0700 |
---|---|---|
committer | Jim Wilson <jimw@sifive.com> | 2018-03-14 16:04:03 -0700 |
commit | 0e35537d754f1c687850d1caccb2d78d2e418391 (patch) | |
tree | 61e8574058def02b9f33ceba1eab999e575cad8e /gas/doc | |
parent | 3ae9ce5dd7d1119ca2c94c63a07b04921048ebe3 (diff) | |
download | gdb-0e35537d754f1c687850d1caccb2d78d2e418391.zip gdb-0e35537d754f1c687850d1caccb2d78d2e418391.tar.gz gdb-0e35537d754f1c687850d1caccb2d78d2e418391.tar.bz2 |
RISC-V: Add .insn support.
gas/ChangeLog
2018-03-07 Kito Cheng <kito.cheng@gmail.com>
* config/tc-riscv.c (opcode_name_list): New.
(opcode_names_hash): Likewise.
(init_opcode_names_hash): Likewise.
(opcode_name_lookup): Likewise.
(validate_riscv_insn): New argument length, and add new format
which used in .insn directive.
(md_begin): Refine hash table initialization logic into
init_opcode_hash.
(init_opcode_hash): New.
(my_getOpcodeExpression): Parse opcode name for .insn.
(riscv_ip): New argument hash, able to handle .insn directive.
(s_riscv_insn): Handler for .insn directive.
(riscv_pseudo_table): New entry for .insn.
* doc/c-riscv.texi: Add documentation for .insn directive.
* testsuite/gas/riscv/insn.d: Add testcase for .insn directive.
* testsuite/gas/riscv/insn.s: Likewise.
include/ChangeLog
2018-03-07 Kito Cheng <kito.cheng@gmail.com>
* opcode/riscv.h (OP_MASK_FUNCT3): New.
(OP_SH_FUNCT3): Likewise.
(OP_MASK_FUNCT7): Likewise.
(OP_SH_FUNCT7): Likewise.
(OP_MASK_OP2): Likewise.
(OP_SH_OP2): Likewise.
(OP_MASK_CFUNCT4): Likewise.
(OP_SH_CFUNCT4): Likewise.
(OP_MASK_CFUNCT3): Likewise.
(OP_SH_CFUNCT3): Likewise.
(riscv_insn_types): Likewise.
opcodes/ChangeLog
2018-03-07 Kito Cheng <kito.cheng@gmail.com>
* riscv-opc.c (riscv_insn_types): New.
Diffstat (limited to 'gas/doc')
-rw-r--r-- | gas/doc/c-riscv.texi | 241 |
1 files changed, 241 insertions, 0 deletions
diff --git a/gas/doc/c-riscv.texi b/gas/doc/c-riscv.texi index 3f327d6..30e6125 100644 --- a/gas/doc/c-riscv.texi +++ b/gas/doc/c-riscv.texi @@ -17,6 +17,7 @@ @menu * RISC-V-Options:: RISC-V Options * RISC-V-Directives:: RISC-V Directives +* RISC-V-Formats:: RISC-V Instruction Formats @end menu @node RISC-V-Options @@ -148,4 +149,244 @@ opportunistically relax some code sequences, but sometimes this behavior is not desirable. @end table +@cindex INSN directives +@item .insn @var{value} +@itemx .insn @var{value} +This directive permits the numeric representation of an instructions +and makes the assembler insert the operands according to one of the +instruction formats for @samp{.insn} (@ref{RISC-V-Formats}). +For example, the instruction @samp{add a0, a1, a2} could be written as +@samp{.insn r 0x33, 0, 0, a0, a1, a2}. + @end table + +@node RISC-V-Formats +@section Instruction Formats +@cindex instruction formats, risc-v +@cindex RISC-V instruction formats + +The RISC-V Instruction Set Manual Volume I: User-Level ISA lists 12 +instruction formats where some of the formats have multiple variants. +For the @samp{.insn} pseudo directive the assembler recognizes some +of the formats. +Typically, the most general variant of the instruction format is used +by the @samp{.insn} directive. + +The following table lists the abbreviations used in the table of +instruction formats: + +@display +@multitable @columnfractions .15 .40 +@item opcode @tab Unsigned immediate or opcode name for 7-bits opcode. +@item opcode2 @tab Unsigned immediate or opcode name for 2-bits opcode. +@item func7 @tab Unsigned immediate for 7-bits function code. +@item func4 @tab Unsigned immediate for 4-bits function code. +@item func3 @tab Unsigned immediate for 3-bits function code. +@item func2 @tab Unsigned immediate for 2-bits function code. +@item rd @tab Destination register number for operand x, can be GPR or FPR. +@item rd' @tab Destination register number for operand x, +only accept s0-s1, a0-a5, fs0-fs1 and fa0-fa5. +@item rs1 @tab First source register number for operand x, can be GPR or FPR. +@item rs1' @tab First source register number for operand x, +only accept s0-s1, a0-a5, fs0-fs1 and fa0-fa5. +@item rs2 @tab Second source register number for operand x, can be GPR or FPR. +@item rs2' @tab Second source register number for operand x, +only accept s0-s1, a0-a5, fs0-fs1 and fa0-fa5. +@item simm12 @tab Sign-extended 12-bit immediate for operand x. +@item simm20 @tab Sign-extended 20-bit immediate for operand x. +@item simm6 @tab Sign-extended 6-bit immediate for operand x. +@item uimm8 @tab Unsigned 8-bit immediate for operand x. +@item symbol @tab Symbol or lable reference for operand x. +@end multitable +@end display + +The following table lists all available opcode name: + +@table @code +@item C0 +@item C1 +@item C2 +Opcode space for compressed instructions. + +@item LOAD +Opcode space for load instructions. + +@item LOAD_FP +Opcode space for floating-point load instructions. + +@item STORE +Opcode space for store instructions. + +@item STORE_FP +Opcode space for floating-point store instructions. + +@item AUIPC +Opcode space for auipc instruction. + +@item LUI +Opcode space for lui instruction. + +@item BRANCH +Opcode space for branch instructions. + +@item JAL +Opcode space for jal instruction. + +@item JALR +Opcode space for jalr instruction. + +@item OP +Opcode space for ALU instructions. + +@item OP_32 +Opcode space for 32-bits ALU instructions. + +@item OP_IMM +Opcode space for ALU with immediate instructions. + +@item OP_IMM_32 +Opcode space for 32-bits ALU with immediate instructions. + +@item OP_FP +Opcode space for floating-point operation instructions. + +@item MADD +Opcode space for madd instruction. + +@item MSUB +Opcode space for msub instruction. + +@item NMADD +Opcode space for nmadd instruction. + +@item NMSUB +Opcode space for msub instruction. + +@item AMO +Opcode space for atomic memory operation instructions. + +@item MISC_IMM +Opcode space for misc instructions. + +@item SYSTEM +Opcode space for system instructions. + +@item CUSTOM_0 +@item CUSTOM_1 +@item CUSTOM_2 +@item CUSTOM_3 +Opcode space for customize instructions. + +@end table + +An instruction is two or four bytes in length and must be aligned +on a 2 byte boundary. The first two bits of the instruction specify the +length of the instruction, 00, 01 and 10 indicates a two byte instruction, +11 indicates a four byte instruction. + +The following table lists the RISC-V instruction formats that are available +with the @samp{.insn} pseudo directive: + +@table @code +@item R type: .insn r opcode, func3, func7, rd, rs1, rs2 +@verbatim ++-------+-----+-----+-------+----+-------------+ +| func7 | rs2 | rs1 | func3 | rd | opcode | ++-------+-----+-----+-------+----+-------------+ +31 25 20 15 12 7 0 +@end verbatim + +@item R type with 4 register operands: .insn r opcode, func3, func2, rd, rs1, rs2, rs3 +@verbatim ++-----+-------+-----+-----+-------+----+-------------+ +| rs3 | func2 | rs2 | rs1 | func3 | rd | opcode | ++-----+-------+-----+-----+-------+----+-------------+ +31 27 25 20 15 12 7 0 +@end verbatim + +@item I type: .insn i opcode, func3, rd, rs1, simm12 +@verbatim ++-------------+-----+-------+----+-------------+ +| simm12 | rs1 | func3 | rd | opcode | ++-------------+-----+-------+----+-------------+ +31 20 15 12 7 0 +@end verbatim + +@item S type: .insn s opcode, func3, rd, rs1, simm12 +@verbatim ++--------------+-----+-----+-------+-------------+-------------+ +| simm12[11:5] | rs2 | rs1 | func3 | simm12[4:0] | opcode | ++--------------+-----+-----+-------+-------------+-------------+ +31 25 20 15 12 7 0 +@end verbatim + +@item SB type: .insn sb opcode, func3, rd, rs1, symbol +@itemx SB type: .insn sb opcode, func3, rd, simm12(rs1) +@verbatim ++--------------+-----+-----+-------+-------------+-------------+ +| simm21[11:5] | rs2 | rs1 | func3 | simm12[4:0] | opcode | ++--------------+-----+-----+-------+-------------+-------------+ +31 25 20 15 12 7 0 +@end verbatim + +@item U type: .insn u opcode, rd, simm20 +@verbatim ++---------------------------+----+-------------+ +| simm20 | rd | opcode | ++---------------------------+----+-------------+ +31 12 7 0 +@end verbatim + +@item UJ type: .insn uj opcode, rd, symbol +@verbatim ++------------+--------------+------------+---------------+----+-------------+ +| simm20[20] | simm20[10:1] | simm20[11] | simm20[19:12] | rd | opcode | ++------------+--------------+------------+---------------+----+-------------+ +31 30 21 20 12 7 0 +@end verbatim + +@item CR type: .insn cr opcode2, func4, rd, rs1 +@verbatim ++---------+--------+-----+---------+ +| func4 | rd/rs1 | rs2 | opcode2 | ++---------+--------+-----+---------+ +15 12 7 2 0 +@end verbatim + +@item CI type: .insn ci opcode2, func3, rd, simm6 +@verbatim ++---------+-----+--------+-----+---------+ +| func3 | imm | rd/rs1 | imm | opcode2 | ++---------+-----+--------+-----+---------+ +15 13 12 7 2 0 +@end verbatim + +@item CIW type: .insn ciw opcode2, func3, rd, uimm8 +@verbatim ++---------+--------------+-----+---------+ +| func3 | imm | rd' | opcode2 | ++---------+--------------+-----+---------+ +15 13 7 2 0 +@end verbatim + +@item CB type: .insn cb opcode2, func3, rs1, symbol +@verbatim ++---------+--------+------+--------+---------+ +| func3 | offset | rs1' | offset | opcode2 | ++---------+--------+------+--------+---------+ +15 13 10 7 2 0 +@end verbatim + +@item CJ type: .insn cj opcode2, symbol +@verbatim ++---------+--------------------+---------+ +| func3 | jump target | opcode2 | ++---------+--------------------+---------+ +15 13 7 2 0 +@end verbatim + + +@end table + +For the complete list of all instruction format variants see +The RISC-V Instruction Set Manual Volume I: User-Level ISA. |