MB Ref Guide
MB Ref Guide
UG081 (v8.1)
2007 Xilinx, Inc. All Rights Reserved. XILINX, the Xilinx logo, and other designated brands included herein are trademarks of Xilinx, Inc. All other trademarks are the property of their respective owners. NOTICE OF DISCLAIMER: Xilinx is providing this design, code, or information as is. By providing the design, code, or information as one possible implementation of this feature, application, or standard, Xilinx makes no representation that this implementation is free from any claims of infringement. You are responsible for obtaining any rights you may require for your implementation. Xilinx expressly disclaims any warranty whatsoever with respect to the adequacy of the implementation, including but not limited to any warranties or representations that this implementation is free from claims of infringement and any implied warranties of merchantability or fitness for a particular purpose.
www.xilinx.com 1-800-255-7778
UG081 (v8.1)
Table of Contents
Preface: About This Guide
Guide Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Typographical . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 Online Document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Pipeline Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Three Stage Pipeline . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44 Five Stage Pipeline . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44 Branches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Instruction Cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Data Cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
UG081 (v8.1)
www.xilinx.com 1-800-255-7778
67 68 68 68
MicroBlaze I/O Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Processor Local Bus (PLB) Interface Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . On-Chip Peripheral Bus (OPB) Interface Description . . . . . . . . . . . . . . . . . . . . . . . . . . . Local Memory Bus (LMB) Interface Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
72 77 77
77 LMB Signal Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78 LMB Transactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80 Read and Write Data Steering . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82 Master FSL Signal Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83 Slave FSL Signal Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83 FSL Transactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
UG081 (v8.1)
www.xilinx.com 1-800-255-7778
Preface
Guide Contents
This guide contains the following chapters: Chapter 1, MicroBlaze Architecture, contains an overview of MicroBlaze features as well as information on Big-Endian bit-reversed format, 32-bit general purpose registers, cache software support, and Fast Simplex Link interfaces. Chapter 2, MicroBlaze Signal Interface Description, describes the types of signal interfaces that can be used to connect MicroBlaze. Chapter 3, MicroBlaze Application Binary Interface, describes the Application Binary Interface important for developing software in assembly language for the soft processor. Chapter 4, MicroBlaze Instruction Set Architecture, provides notation, formats, and instructions for the Instruction Set Architecture of MicroBlaze.
For additional information, go to http://support.xilinx.com. The following table lists some of the resources you can access directly using the provided URLs. Resource Tutorials Description/URL Tutorials covering Xilinx design flows, from design entry to verification and debugging. http://support.xilinx.com/support/techsup/tutorials/index.htm Answer Browser Application Notes Database of Xilinx solution records. http://support.xilinx.com/xlnx/xil_ans_browser.jsp Descriptions of device-specific design techniques and approaches. http://www.xilinx.com/xlnx/xweb/xil_publications_index.jsp?category= Application+Notes Data Book Pages from The Programmable Logic Data Book, which contains devicespecific information on Xilinx device characteristics, including readback, boundary scan, configuration, length count, and debugging. http://support.xilinx.com/xlnx/xweb/xil_publications_index.jsp Problem Solvers Interactive tools that allow you to troubleshoot your design issues. http://support.xilinx.com/support/troubleshoot/psolvers.htm
www.xilinx.com 1-800-255-7778
Description/URL Latest news, design tips, and patch information for the Xilinx design environment. http://www.support.xilinx.com/xlnx/xil_tt_home.jsp The entire set of GNU manuals. http://www.gnu.org/manual
GNU Manuals
Conventions
This document uses the following conventions. An example illustrates each convention.
Typographical
The following typographical conventions are used in this document: Convention Courier font Courier bold Meaning or Use Messages, prompts, and program files that the system displays. Literal commands that you enter in a syntactical statement. Commands that you select from a menu. Keyboard shortcuts Variables in a syntax statement for which you must supply values. References to other manuals. Italic font Emphasis in text. Example speed grade: - 100 ngdbuild design_name File Open Ctrl+C ngdbuild design_name See the Development System Reference Guide for more information. If a wire is drawn so that it overlaps the pin of a symbol, the two nets are not connected. ngdbuild [option_name] design_name
Helvetica bold
Square brackets
[ ]
An optional entry or parameter. However, in bus specifications, such as bus[7:0], they are required. A list of items from which you must choose one or more.
Braces
{ } |
Vertical bar
www.xilinx.com 1-800-255-7778
Conventions
Example IOB #1: Name = QOUT IOB #2: Name = CLKIN . . . allow block block_name loc1 loc2 ... locn;
Online Document
The following conventions are used in this document: Convention Meaning or Use Cross-reference link to a location in the current document Example See the section Additional Resources for details. Refer to Title Formats in Chapter 1 for details. Cross-reference link to a location in another document Hyperlink to a web-site (URL) See Figure 2-5 in the Virtex-II Handbook. Go to http://www.xilinx.com for the latest speed files.
Blue text
www.xilinx.com 1-800-255-7778
www.xilinx.com 1-800-255-7778
Chapter 1
MicroBlaze Architecture
This chapter contains an overview of MicroBlaze features and detailed information on MicroBlaze architecture including Big-Endian bit-reversed format, 32-bit general purpose registers, virtual-memory management, cache software support, and Fast Simplex Link (FSL) interfaces. This chapter has the following sections: Overview Data Types and Endianness Instructions Registers Pipeline Architecture Memory Architecture Privileged Instructions Virtual-Memory Management Reset, Interrupts, Exceptions, and Break Instruction Cache Data Cache Floating Point Unit (FPU) Fast Simplex Link (FSL) Debug and Trace
www.xilinx.com 1-800-255-7778
Overview
The MicroBlaze embedded processor soft core is a reduced instruction set computer (RISC) optimized for implementation in Xilinx Field Programmable Gate Arrays (FPGAs). Figure 1-1 shows a functional block diagram of the MicroBlaze core. Instruction-side bus interface
Memory Management Unit (MMU)
ITLB
I-Cache
D-Cache
IXCL_M IXCL_S
ALU Program Counter Special Purpose Registers Shift Barrel Shift Multiplier Divider
DXCL_M DXCL_S
DPLB
Bus IF
Bus IF
DOPB DLMB
Figure 1-1:
Features
The MicroBlaze soft core processor is highly configurable, allowing you to select a specific set of features required by your design. The fixed feature set of the processor includes: Thirty-two 32-bit general purpose registers 32-bit instruction word with three operands and two addressing modes 32-bit address bus Single issue pipeline
In addition to these fixed features, the MicroBlaze processor is parameterized to allow selective enabling of additional functionality. Older (deprecated) versions of MicroBlaze support a subset of the optional features described in this manual. Only the latest (preferred) version of MicroBlaze (v7.00) supports all options. Xilinx recommends that all new designs use the latest preferred version of the MicroBlaze processor. Table 1-1, page 11 provides an overview of the configurable features by Microblaze versions.
10
www.xilinx.com 1-800-255-7778
Overview
Table 1-1:
Configurable Feature Overview by MicroBlaze Version Feature MicroBlaze Versions v4.00 deprecated
3 option option option option option option option 0-7 option option option option option 4 option option option option Yes -
v5.00 deprecated
5 option option option option option option option 0-7 Yes No No option option option option Yes option option Yes option -
v6.00 deprecated
3/5 option option option option option option option 0-7 option No No option option option option option option option Yes option option option option -
v7.00 preferred
3/5 option option option option option option option 0-15 option No No option option option option option option option Yes option option option option option option option option option
Version Status
Processor pipeline depth On-chip Peripheral Bus (OPB) data side interface On-chip Peripheral Bus (OPB) instruction side interface Local Memory Bus (LMB) data side interface Local Memory Bus (LMB) instruction side interface Hardware barrel shifter Hardware divider Hardware debug logic Fast Simplex Link (FSL) interfaces Machine status set and clear instructions Instruction cache over IOPB interface Data cache over IOPB interface Instruction cache over CacheLink (IXCL) interface Data cache over CacheLink (DXCL) interface 4 or 8-word cache line on XCL Hardware exception support Pattern compare instructions Floating point unit (FPU) Disable hardware multiplier1 Hardware debug readable ESR and EAR Processor Version Register (PVR) Area or speed optimized Hardware multiplier 64-bit result LUT cache memory Processor Local Bus (PLB) data side interface Processor Local Bus (PLB) instruction side interface Floating point conversion and square root instructions Memory Management Unit (MMU) Extended Fast Simplex Link (FSL) instructions
1. Used in Virtex-II and subsequent families, for saving MUL18 and DSP48 primitives.
www.xilinx.com 1-800-255-7778
11
Byte address Byte label Byte significance Bit label Bit significance Table 1-3:
Byte address Byte label Byte significance Bit label Bit significance Table 1-4:
12
www.xilinx.com 1-800-255-7778
Instructions
Instructions
All MicroBlaze instructions are 32 bits and are defined as either Type A or Type B. Type A instructions have up to two source register operands and one destination register operand. Type B instructions have one source register and a 16-bit immediate operand (which can be extended to 32 bits by preceding the Type B instruction with an imm instruction). Type B instructions have a single destination register operand. Instructions are provided in the following functional categories: arithmetic, logical, branch, load/store, and special. Table 1-6 lists the MicroBlaze instruction set. Refer to Chapter 4, MicroBlaze Instruction Set Architecturefor more information on these instructions. Table 1-5 describes the instruction set nomenclature used in the semantics of each instruction. Table 1-5: Instruction Set Nomenclature Description R0 - R31, General Purpose Register, source operand a R0 - R31, General Purpose Register, source operand b R0 - R31, General Purpose Register, destination operand Special Purpose Register number x Machine Status Register = SPR[1] Exception Status Register = SPR[5] Exception Address Register = SPR[3] Floating Point Unit Status Register = SPR[7] Processor Version Register, where x is the register number = SPR[8192 + x] Branch Target Register = SPR[11] Execute stage Program Counter = SPR[0] Bit y of register x Bit range y to z of register x Bit inverted value of register x 16 bit immediate value x bit immediate value 4 bit Fast Simplex Link (FSL) port designator where x is the port number Carry flag, MSR[29] Special Purpose Register, source operand Special Purpose Register, destination operand Sign extend argument x to 32-bit value Memory contents at location Addr (data-size aligned) Assignment operator Equality comparison
Symbol Ra Rb Rd SPR[x] MSR ESR EAR FSR PVRx BTR PC x[y] x[y:z] x Imm Immx FSLx C Sa Sd s(x) *Addr := =
www.xilinx.com 1-800-255-7778
13
Table 1-5:
Instruction Set Nomenclature (Continued) Description Inequality comparison Greater than comparison Greater than or equal comparison Less than comparison Less than or equal comparison Arithmetic add Arithmetic multiply Arithmetic divide Bit shift right x bits Bit shift left x bits Logic AND Logic OR Logic exclusive OR Perform op1 if condition cond is true, else perform op2 Concatenate. E.g. 0000100 & Imm7 is the concatenation of the fixed field 0000100 and a 7 bit immediate value. Operation performed on signed integer data type. All arithmetic operations are performed on signed word operands, unless otherwise specified Operation performed on unsigned integer data type Operation performed on floating point data type
Symbol != > >= < <= + * / >> x << x and or xor op1 if cond else op2 & signed unsigned float
Table 1-6:
MicroBlaze Instruction Set Summary 0-5 0-5 000000 000001 000010 000011 000100 000101 000110 000111 6-10 6-10 Rd Rd Rd Rd Rd Rd Rd Rd 11-15 16-20 11-15 Ra Ra Ra Ra Ra Ra Ra Ra Rb Rb Rb Rb Rb Rb Rb Rb 21-31 16-31 00000000000 00000000000 00000000000 00000000000 00000000000 00000000000 00000000000 00000000000 Rd := Rb + Ra Rd := Rb + Ra + 1 Rd := Rb + Ra + C Rd := Rb + Ra + C Rd := Rb + Ra Rd := Rb + Ra + 1 Rd := Rb + Ra + C Rd := Rb + Ra + C Semantics
Type A Type B ADD Rd,Ra,Rb RSUB Rd,Ra,Rb ADDC Rd,Ra,Rb RSUBC Rd,Ra,Rb ADDK Rd,Ra,Rb RSUBK Rd,Ra,Rb ADDKC Rd,Ra,Rb RSUBKC Rd,Ra,Rb
14
www.xilinx.com 1-800-255-7778
Instructions
Table 1-6:
MicroBlaze Instruction Set Summary (Continued) 0-5 0-5 000101 6-10 6-10 Rd 11-15 16-20 11-15 Ra Rb 21-31 16-31 00000000001 Semantics Rd := Rb + Ra + 1 Rd[0] := 0 if (Rb >= Ra) else Rd[0] := 1
CMPU Rd,Ra,Rb
000101
Rd
Ra
Rb
00000000011
Rd := Rb + Ra + 1 (unsigned) Rd[0] := 0 if (Rb >= Ra, unsigned) else Rd[0] := 1 Rd := s(Imm) + Ra Rd := s(Imm) + Ra + 1 Rd := s(Imm) + Ra + C Rd := s(Imm) + Ra + C Rd := s(Imm) + Ra Rd := s(Imm) + Ra + 1 Rd := s(Imm) + Ra + C Rd := s(Imm) + Ra + C Rd := Ra * Rb Rd := (Ra * Rb) >> 32 (signed) Rd := (Ra * Rb) >> 32 (unsigned) Rd := (Ra, signed * Rb, unsigned) >> 32 (signed) Rd := s(Ra >> Rb) Rd := (Ra << Rb) & 0 Rd := Ra * s(Imm) Rd : = 0 & (Ra >> Imm5) Rd := s(Ra >> Imm5) Rd := (Ra << Imm5) & 0 Rd := Rb/Ra Rd := Rb/Ra, unsigned Rd := FSL Rb[28:31] (data read) MSR[FSL] := 1 if (FSL_S_Control = 1) MSR[C] := not FSL_S_Exists if N = 1 FSL Rb[28:31] := Ra (data write) MSR[C] := FSL_M_Full if N = 1
ADDI Rd,Ra,Imm RSUBI Rd,Ra,Imm ADDIC Rd,Ra,Imm RSUBIC Rd,Ra,Imm ADDIK Rd,Ra,Imm RSUBIK Rd,Ra,Imm ADDIKC Rd,Ra,Imm RSUBIKC Rd,Ra,Imm MUL Rd,Ra,Rb MULH Rd,Ra,Rb MULHU Rd,Ra,Rb MULHSU Rd,Ra,Rb BSRA Rd,Ra,Rb BSLL Rd,Ra,Rb MULI Rd,Ra,Imm BSRLI Rd,Ra,Imm BSRAI Rd,Ra,Imm BSLLI Rd,Ra,Imm IDIV Rd,Ra,Rb IDIVU Rd,Ra,Rb TNEAGETD Rd,Rb
001000 001001 001010 001011 001100 001101 001110 001111 010000 010000 010000 010000 010001 010001 011000 011001 011001 011001 010010 010010 010011
Rd Rd Rd Rd Rd Rd Rd Rd Rd Rd Rd Rd Rd Rd Rd Rd Rd Rd Rd Rd Rd
Ra Ra Ra Ra Ra Ra Ra Ra Ra Ra Ra Ra Ra Ra Ra Ra Ra Ra Ra Ra 00000 Rb Rb Rb Rb Rb Rb
Imm Imm Imm Imm Imm Imm Imm Imm 00000000000 00000000001 00000000011 00000000010 01000000000 10000000000 Imm 00000000000 & Imm5 00000010000 & Imm5 00000100000 & Imm5 Rb Rb Rb 00000000000 00000000010 0N0TAE 00000 0N0TA0 00000
TNAPUTD Ra,Rb
010011
00000
Ra
Rb
www.xilinx.com 1-800-255-7778
15
Table 1-6:
MicroBlaze Instruction Set Summary (Continued) 0-5 0-5 010011 6-10 6-10 Rd 11-15 16-20 11-15 00000 Rb 21-31 16-31 0N1TAE 00000 0N1TA0 00000 00000000000 00010000000 00100000000 00110000000 01000000000 Semantics Rd := FSL Rb[28:31] (control read) MSR[FSL] := 1 if (FSL_S_Control = 0) MSR[C] := not FSL_S_Exists if N = 1 FSL Rb[28:31] := Ra (control write) MSR[C] := FSL_M_Full if N = 1 Rd := Rb+Ra, float1 Rd := Rb-Ra, float1 Rd := Rb*Ra, float1 Rd := Rb/Ra, float1 Rd := 1 if (Rb = NaN or Ra = NaN, float1) else Rd := 0 Rd := 1 if (Rb < Ra, float1) else Rd := 0 Rd := 1 if (Rb = Ra, float1) else Rd := 0 Rd := 1 if (Rb <= Ra, float1) else Rd := 0 Rd := 1 if (Rb > Ra, float1) else Rd := 0 Rd := 1 if (Rb != Ra, float1) else Rd := 0 Rd := 1 if (Rb >= Ra, float1) else Rd := 0 Rd := float (Ra)1 Rd := int (Ra)1 Rd := sqrt (Ra)1 Rd := FSLx (data read, blocking if N = 0) MSR[FSL] := 1 if (FSLx_S_Control = 1) MSR[C] := not FSLx_S_Exists if N = 1 FSLx := Ra (data write, blocking if N = 0) MSR[C] := FSLx_M_Full if N = 1 Rd := FSLx (control read, blocking if N = 0) MSR[FSL] := 1 if (FSLx_S_Control = 0) MSR[C] := not FSLx_S_Exists if N = 1 FSLx := Ra (control write, blocking if N = 0) MSR[C] := FSLx_M_Full if N = 1
TNCAPUTD Ra,Rb FADD Rd,Ra,Rb FRSUB Rd,Ra,Rb FMUL Rd,Ra,Rb FDIV Rd,Ra,Rb FCMP.UN Rd,Ra,Rb
00000 Rd Rd Rd Rd Rd
Ra Ra Ra Ra Ra Ra
Rb Rb Rb Rb Rb Rb
FCMP.LT Rd,Ra,Rb FCMP.EQ Rd,Ra,Rb FCMP.LE Rd,Ra,Rb FCMP.GT Rd,Ra,Rb FCMP.NE Rd,Ra,Rb FCMP.GE Rd,Ra,Rb FLT Rd,Ra FINT Rd,Ra FSQRT Rd,Ra TNEAGET Rd,FSLx
010110 010110 010110 010110 010110 010110 010110 010110 010110 011011
Rd Rd Rd Rd Rd Rd Rd Rd Rd Rd
Ra Ra Ra Ra Ra Ra Ra Ra Ra 00000
Rb Rb Rb Rb Rb Rb 0 0 0
0N0TAE000000 & FSLx 1N0TA0000000 & FSLx 0N1TAE000000 & FSLx 1N1TA0000000 & FSLx
011011 011011
00000 Rd
Ra 00000
TNCAPUT Ra,FSLx
011011
00000
Ra
16
www.xilinx.com 1-800-255-7778
Instructions
Table 1-6:
MicroBlaze Instruction Set Summary (Continued) 0-5 0-5 100000 100001 100010 100011 100000 6-10 6-10 Rd Rd Rd Rd Rd 11-15 16-20 11-15 Ra Ra Ra Ra Ra Rb Rb Rb Rb Rb 21-31 16-31 00000000000 00000000000 00000000000 00000000000 10000000000 Rd := Ra or Rb Rd := Ra and Rb Rd := Ra xor Rb Rd := Ra and Rb Rd := 1 if (Rb[0:7] = Ra[0:7]) else Rd := 2 if (Rb[8:15] = Ra[8:15]) else Rd := 3 if (Rb[16:23] = Ra[16:23]) else Rd := 4 if (Rb[24:31] = Ra[24:31]) else Rd := 0 Rd := 1 if (Rd = Ra) else Rd := 0 Rd := 1 if (Rd != Ra) else Rd := 0 Rd := s(Ra >> 1) C := Ra[31] Rd := C & (Ra >> 1) C := Ra[31] Rd := 0 & (Ra >> 1) C := Ra[31] Rd := s(Ra[24:31]) Rd := s(Ra[16:31]) ICache_Line[Ra >> 4].Tag := 0 if (C_ICACHE_LINE_LEN = 4) ICache_Line[Ra >> 5].Tag := 0 if (C_ICACHE_LINE_LEN = 8) Semantics
Type A Type B OR Rd,Ra,Rb AND Rd,Ra,Rb XOR Rd,Ra,Rb ANDN Rd,Ra,Rb PCMPBF Rd,Ra,Rb
PCMPEQ Rd,Ra,Rb PCMPNE Rd,Ra,Rb SRA Rd,Ra SRC Rd,Ra SRL Rd,Ra SEXT8 Rd,Ra SEXT16 Rd,Ra WIC Ra,Rb
Rd Rd Rd Rd Rd Rd Rd 00000
Ra Ra Ra Ra Ra Ra Ra Ra
Rb Rb
10000000000 10000000000
WDC Ra,Rb
100100
00000
Ra
Rb
01100100
MTS Sd,Ra
100101
00000
Ra
11 & Sd
SPR[Sd] := Ra, where: SPR[0x0001] is MSR SPR[0x0007] is FSR SPR[0x1000] is PID SPR[0x1001] is ZPR SPR[0x1002] is TLBX SPR[0x1003] is TLBLO SPR[0x1004] is TLBHI SPR[0x1005] is TLBSX
www.xilinx.com 1-800-255-7778
17
Table 1-6:
MicroBlaze Instruction Set Summary (Continued) 0-5 0-5 100101 6-10 6-10 Rd 11-15 16-20 11-15 00000 21-31 16-31 10 & Sa Semantics Rd := SPR[Sa], where: SPR[0x0000] is PC SPR[0x0001] is MSR SPR[0x0003] is EAR SPR[0x0005] is ESR SPR[0x0007] is FSR SPR[0x000B] is BTR SPR[0x000D] is EDR SPR[0x1000] is PID SPR[0x1001] is ZPR SPR[0x1002] is TLBX SPR[0x1003] is TLBLO SPR[0x1004] is TLBHI SPR[0x2000 to 0x200B] is PVR[0 to 11]
MSRCLR Rd,Imm MSRSET Rd,Imm BR Rb BRD Rb BRLD Rd,Rb BRA Rb BRAD Rb BRALD Rd,Rb BRK Rd,Rb
00 & Imm14 00 & Imm14 00000000000 00000000000 00000000000 00000000000 00000000000 00000000000 00000000000
Rd := MSR MSR := MSR and Imm14 Rd := MSR MSR := MSR or Imm14 PC := PC + Rb PC := PC + Rb PC := PC + Rb Rd := PC PC := Rb PC := Rb PC := Rb Rd := PC PC := Rb Rd := PC MSR[BIP] := 1 PC := PC + Rb if Ra = 0 PC := PC + Rb if Ra != 0 PC := PC + Rb if Ra < 0 PC := PC + Rb if Ra <= 0 PC := PC + Rb if Ra > 0 PC := PC + Rb if Ra >= 0 PC := PC + Rb if Ra = 0
BEQ Ra,Rb BNE Ra,Rb BLT Ra,Rb BLE Ra,Rb BGT Ra,Rb BGE Ra,Rb BEQD Ra,Rb
Ra Ra Ra Ra Ra Ra Ra
Rb Rb Rb Rb Rb Rb Rb
18
www.xilinx.com 1-800-255-7778
Instructions
Table 1-6:
MicroBlaze Instruction Set Summary (Continued) 0-5 0-5 100111 100111 100111 100111 100111 101000 101001 101010 101011 101100 101101 101101 101101 101101 6-10 6-10 10001 10010 10011 10100 10101 Rd Rd Rd Rd 00000 10000 10001 10010 10100 11-15 16-20 11-15 Ra Ra Ra Ra Ra Ra Ra Ra Ra 00000 Ra Ra Ra Ra Rb Rb Rb Rb Rb 21-31 16-31 00000000000 00000000000 00000000000 00000000000 00000000000 Imm Imm Imm Imm Imm Imm Imm Imm Imm Semantics PC := PC + Rb if Ra != 0 PC := PC + Rb if Ra < 0 PC := PC + Rb if Ra <= 0 PC := PC + Rb if Ra > 0 PC := PC + Rb if Ra >= 0 Rd := Ra or s(Imm) Rd := Ra and s(Imm) Rd := Ra xor s(Imm) Rd := Ra and s(Imm) Imm[0:15] := Imm PC := Ra + s(Imm) PC := Ra + s(Imm) MSR[IE] := 1 PC := Ra + s(Imm) MSR[BIP] := 0 PC := Ra + s(Imm) MSR[EE] := 1, MSR[EIP] := 0 ESR := 0 PC := PC + s(Imm) PC := PC + s(Imm) PC := PC + s(Imm) Rd := PC PC := s(Imm) PC := s(Imm) PC := s(Imm) Rd := PC PC := s(Imm) Rd := PC MSR[BIP] := 1 PC := PC + s(Imm) if Ra = 0 PC := PC + s(Imm) if Ra != 0 PC := PC + s(Imm) if Ra < 0 PC := PC + s(Imm) if Ra <= 0 PC := PC + s(Imm) if Ra > 0
Type A Type B BNED Ra,Rb BLTD Ra,Rb BLED Ra,Rb BGTD Ra,Rb BGED Ra,Rb ORI Rd,Ra,Imm ANDI Rd,Ra,Imm XORI Rd,Ra,Imm ANDNI Rd,Ra,Imm IMM Imm RTSD Ra,Imm RTID Ra,Imm RTBD Ra,Imm RTED Ra,Imm
BRI Imm BRID Imm BRLID Rd,Imm BRAI Imm BRAID Imm BRALID Rd,Imm BRKI Rd,Imm
BEQI Ra,Imm BNEI Ra,Imm BLTI Ra,Imm BLEI Ra,Imm BGTI Ra,Imm
Ra Ra Ra Ra Ra
www.xilinx.com 1-800-255-7778
19
Table 1-6:
MicroBlaze Instruction Set Summary (Continued) 0-5 0-5 101111 101111 101111 101111 101111 101111 101111 110000 6-10 6-10 00101 10000 10001 10010 10011 10100 10101 Rd 11-15 16-20 11-15 Ra Ra Ra Ra Ra Ra Ra Ra Rb 21-31 16-31 Imm Imm Imm Imm Imm Imm Imm 00000000000 Semantics PC := PC + s(Imm) if Ra >= 0 PC := PC + s(Imm) if Ra = 0 PC := PC + s(Imm) if Ra != 0 PC := PC + s(Imm) if Ra < 0 PC := PC + s(Imm) if Ra <= 0 PC := PC + s(Imm) if Ra > 0 PC := PC + s(Imm) if Ra >= 0 Addr := Ra + Rb Rd[0:23] := 0 Rd[24:31] := *Addr[0:7] Addr := Ra + Rb Rd[0:15] := 0 Rd[16:31] := *Addr[0:15] Addr := Ra + Rb Rd := *Addr Addr := Ra + Rb *Addr[0:8] := Rd[24:31] Addr := Ra + Rb *Addr[0:16] := Rd[16:31] Addr := Ra + Rb *Addr := Rd Addr := Ra + s(Imm) Rd[0:23] := 0 Rd[24:31] := *Addr[0:7] Addr := Ra + s(Imm) Rd[0:15] := 0 Rd[16:31] := *Addr[0:15] Addr := Ra + s(Imm) Rd := *Addr Addr := Ra + s(Imm) *Addr[0:7] := Rd[24:31] Addr := Ra + s(Imm) *Addr[0:15] := Rd[16:31] Addr := Ra + s(Imm) *Addr := Rd
Type A Type B BGEI Ra,Imm BEQID Ra,Imm BNEID Ra,Imm BLTID Ra,Imm BLEID Ra,Imm BGTID Ra,Imm BGEID Ra,Imm LBU Rd,Ra,Rb
LHU Rd,Ra,Rb
110001
Rd
Ra
Rb
00000000000
Rd Rd Rd Rd Rd
Ra Ra Ra Ra Ra
Rb Rb Rb Rb
LHUI Rd,Ra,Imm
111001
Rd
Ra
Imm
Rd Rd Rd Rd
Ra Ra Ra Ra
1. Due to the many different corner cases involved in floating point arithmetic, only the normal behavior is described. A full description of the behavior can be found in Chapter 4, MicroBlaze Instruction Set Architecture.
20
www.xilinx.com 1-800-255-7778
Registers
Registers
MicroBlaze has an orthogonal instruction set architecture. It has thirty-two 32-bit general purpose registers and up to eighteen 32-bit special purpose registers, depending on configured options.
31
R0-R31
Figure 1-2:
R0-R31
General Purpose Registers (R0-R31) Name Description Always has a value of zero. Anything written to R0 is discarded 32-bit general purpose registers 32-bit register used to store return addresses for interrupts. 32-bit general purpose register. Recommended for storing return addresses for user vectors. 32-bit register used to store return addresses for breaks. If MicroBlaze is configured to support hardware exceptions, this register is loaded with the address of the instruction following the instruction causing the HW exception, except for exceptions in delay slots that use BTR instead (see Branch Target Register (BTR)); if not, it is a general purpose register. R18 through R31 are 32-bit general purpose registers. Reset Value 0x00000000 -
0:31
Refer to Table 3-2 for software conventions on general purpose register usage.
www.xilinx.com 1-800-255-7778
21
31
PC
Figure 1-3:
PC
Program Counter (PC) Name Description Program Counter Address of executing instruction, that is, mfs r2 0 stores the address of the mfs instruction itself in R2. Reset Value 0x00000000
PC
17 18 19 20
21
22 23
24
25 26 27 28 29 30 31
CC RESERVED
IE BE
Figure 1-4:
MSR
22
www.xilinx.com 1-800-255-7778
Registers
Machine Status Register (MSR) Name Description Arithmetic Carry Copy Copy of the Arithmetic Carry (bit 29). CC is always the same as bit C. Reset Value 0
CC
1:16 17
Reserved VMS Virtual Protected Mode Save Only available when configured with an MMU (if C_USE_MMU>1) Read/Write 0
18
VM
Virtual Protected Mode 0 MMU address translation and access protection disabled, with C_USE_MMU = 3. Access protection disabled, with C_USE_MMU = 2. 1 MMU address translation and access protection enabled, with C_USE_MMU = 3. Access protection enabled, with C_USE_MMU = 2. Only available when configured with an MMU (if C_USE_MMU>1) Read/Write
19
UMS
User Mode Save Only available when configured with an MMU (if C_USE_MMU>0) Read/Write
20
UM
User Mode 0 Privileged Mode, all instructions are allowed 1 User Mode, certain instructions are not allowed Only available when configured with an MMU (if C_USE_MMU>0) Read/Write
21
PVR
Processor Version Register exists 0 No Processor Version Register 1 Processor Version Register exists Read only
www.xilinx.com 1-800-255-7778
23
Machine Status Register (MSR) (Continued) Name Description Exception In Progress 0 = No hardware exception in progress 1 = Hardware exception in progress Only available if configured with exception support (C_*_EXCEPTION or C_USE_MMU) Read/Write Reset Value 0
EIP
23
EE
Only available if configured with exception support (C_*_EXCEPTION or C_USE_MMU) Read/Write 24 DCE Data Cache Enable 0 = Data Cache disabled 1 = Data Cache enabled Only available if configured to use data cache (C_USE_DCACHE = 1) Read/Write 25 DZ Division by Zero2 0 = No division by zero has occurred 1 = Division by zero has occurred Only available if configured to use hardware divider (C_USE_DIV = 1) Read/Write 26 ICE Instruction Cache Enable 0 = Instruction Cache disabled 1 = Instruction Cache enabled Only available if configured to use instruction cache (C_USE_ICACHE = 1) Read/Write 27 FSL FSL Error 0 = FSL get/getd/put/putd had no error 1 = FSL get/getd/put/putd control type mismatch Only available if configured to use FSL links (C_FSL_LINKS > 0) Read/Write 0 0 0 0
24
www.xilinx.com 1-800-255-7778
Registers
Machine Status Register (MSR) (Continued) Name Description Break in Progress 0 = No Break in Progress 1 = Break in Progress Break Sources can be software break instruction or hardware break from Ext_Brk or Ext_NM_Brk pin. Read/Write Reset Value 0
BIP
29
30
IE
31
BE
Buslock Enable3 0 = Buslock disabled on data-side OPB 1 = Buslock enabled on data-side OPB Buslock Enable does not affect operation of IXCL, DXCL, ILMB, DLMB, IPLB, DPLB or IOPB. Only available if using data-side PLB or OPB Read/Write
1. The MMU exceptions (Data Storage Exception, Instruction Storage Exception, Data TLB Miss Exception, Instruction TLB Miss Exception) cannot be disabled, and are not affected by this bit. 2. This bit is only used for integer divide-by-zero signaling. There is a floating point equivalent in the FSR. The DZ-bit flags divide by zero conditions regardless if the processor is configured with exception handling or not. 3. For details on the bus protocols, refer to the IBM CoreConnect specifications: 128-Bit Processor Local Bus, Architectural Specifications, Version 4.6 and 64-Bit On-Chip Peripheral Bus, Architectural Specifications, Version 2.0.
www.xilinx.com 1-800-255-7778
25
The contents of this register is undefined for all other exceptions. When read with the MFS instruction, the EAR is specified by setting Sa = 0x0003. The EAR register is illustrated in Figure 1-5 and Table 1-10 provides bit descriptions and reset values.
31
EAR
Figure 1-5:
EAR
Exception Address Register (EAR) Description Exception Address Register Reset Value 0x00000000
Name EAR
26
www.xilinx.com 1-800-255-7778
Registers
19 20
26 27
31
RESERVED
DS
ESS
EC
Figure 1-6:
ESR
Exception Status Register (ESR) Name Reserved DS Delay Slot Exception. 0 = not caused by delay slot instruction 1 = caused by delay slot instruction Read-only 0 Description Reset Value
20:26
ESS
27:31
EC
Exception Cause 00000 = Fast Simplex Link exception 00001 = Unaligned data access exception 00010 = Illegal op-code exception 00011 = Instruction bus error exception 00100 = Data bus error exception 00101 = Divide by zero exception 00110 = Floating point unit exception 00111 = Privileged instruction exception 10000 = Data storage exception 10001 = Instruction storage exception 10010 = Data TLB miss exception 10011 = Instruction TLB miss exception Read-only
www.xilinx.com 1-800-255-7778
27
Exception Specific Status (ESS) Bits 20 W Name Description Word Access Exception 0 = unaligned halfword access 1 = unaligned word access 21 S Store Access Exception 0 = unaligned load access 1 = unaligned store access 22:26 Rx Source/Destination Register General purpose register used as source (Store) or destination (Load) in unaligned access 0 0 Reset Value 0
Illegal Instruction Instruction bus error Data bus error Divide by zero Floating point unit Privileged instruction Fast Simplex Link
Reserved Reserved Reserved Reserved Reserved Reserved Reserved FSL DIZ Fast Simplex Link index that caused the exception Data storage - Zone protection 0 = Did not occur 1 = Occurred
0 0 0 0 0 0 0 0 0
Data storage
21
Reserved DIZ Instruction storage - Zone protection 0 = Did not occur 1 = Occurred
0 0
21:26
Reserved
28
www.xilinx.com 1-800-255-7778
Registers
Exception Specific Status (ESS) (Continued) Bits 20 21 Name Reserved S Data TLB miss - Store instruction 0 = Did not occur 1 = Occurred 22:26 Reserved Reserved 0 0 Description Reset Value 0 0
20:26
31
BTR
Figure 1-7:
BTR
Branch Target Register (BTR) Name BTR Description Branch target address used by handler when returning from an exception caused by an instruction in a delay slot. Read-only Reset Value 0x00000000
www.xilinx.com 1-800-255-7778
29
27 28 29 30 31
RESERVED
IO DZ OF UF DO
FSR
Floating Point Status Register (FSR) Name Reserved IO DZ OF UF DO Invalid operation Divide-by-zero Overflow Underflow Denormalized operand error Description Reset Value undefined 0 0 0 0 0
31
EDR
EDR
Exception Data Register (EDR) Description Exception Data Register Reset Value 0x00000000
Name EDR
30
www.xilinx.com 1-800-255-7778
Registers
Figure 1-10 illustrates the PID register and Table 1-16 provides bit descriptions and reset values.
24
31
RESERVED
PID
Reserved PID Used to uniquely identify a software process during MMU address translation. Read/Write 0x00
www.xilinx.com 1-800-255-7778
31
10
12
14
16
18
20
22
24
26
28
30
ZP0
ZP1
ZP2
ZP3
ZP4
ZP5
ZP6
ZP7
ZP8
ZP9
ZP10
ZP11
ZP12
ZP13
ZP14
ZP15
Figure 1-11:
ZPR
Zone Protection Register (ZPR) Description Zone Protect User mode (MSR[UM] = 1): 00 = Override V in TLB entry. No access to the page is allowed 01 = No override. Use V, WR and EX from TLB entry 10 = No override. Use V, WR and EX from TLB entry 11 = Override WR and EX in TLB entry. Access the page as writable and executable Privileged mode (MSR[UM] = 0): 00 = No override. Use V, WR and EX from TLB entry 01 = No override. Use V, WR and EX from TLB entry 10 = Override WR and EX in TLB entry. Access the page as writable and executable 11 = Override WR and EX in TLB entry. Access the page as writable and executable Read/Write Reset Value 0x00000000
32
www.xilinx.com 1-800-255-7778
Registers
22 23 24
28 29 30
31
RPN
EX WR
ZSEL
W I M G
Figure 1-12:
TLBLO
Translation Look-Aside Buffer Low Register (TLBLO) Description Real Page Number or Physical Page Number When a TLB hit occurs, this field is read from the TLB entry and is used to form the physical address. Depending on the value of the SIZE field, some of the RPN bits are not used in the physical address. Software must clear unused bits in this field to zero. Only defined when C_USE_MMU=3. Read/Write Reset Value 0x000000
Name RPN
22
EX
Executable When bit is set to 1, the page contains executable code, and instructions can be fetched from the page. When bit is cleared to 0, instructions cannot be fetched from the page. Attempts to fetch instructions from a page with a clear EX bit cause an instruction-storage exception. Read/Write
www.xilinx.com 1-800-255-7778
33
Translation Look-Aside Buffer Low Register (TLBLO) (Continued) Description Writable When bit is set to 1, the page is writable and store instructions can be used to store data at addresses within the page. When bit is cleared to 0, the page is read-only (not writable). Attempts to store data into a page with a clear WR bit cause a data storage exception. Read/Write Reset Value 0
Name WR
24:27
ZSEL
Zone Select This field selects one of 16 zone fields (Z0-Z15) from the zone-protection register (ZPR). For example, if ZSEL 0x5, zone field Z5 is selected. The selected ZPR field is used to modify the access protection specified by the TLB entry EX and WR fields. It is also used to prevent access to a page by overriding the TLB V (valid) field. Read/Write
0x0
28
Write Through This bit is fixed to 1, because accesses to pages on MicroBlaze are always cached using a write-through caching policy. Read Only
29
Inhibit Caching When bit is set to 1, accesses to the page are not cached (caching is inhibited). When cleared to 0, accesses to the page are cacheable. Read/Write
30
Memory Coherent This bit is fixed to 0, because memory coherence is not implemented on MicroBlaze. Read Only
31
Guarded When bit is set to 1, speculative page accesses are not allowed (memory is guarded). When cleared to 0, speculative page accesses are allowed. The G attribute can be used to protect memory-mapped I/O devices from inappropriate instruction accesses. Read/Write
34
www.xilinx.com 1-800-255-7778
Registers
The UTLB is reset on bit stream download (reset value is 0x00000000 for all TLBHI entries). Note: The UTLB is not reset by the external reset inputs: Reset and Debug_Rst. Figure 1-13 illustrates the TLBHI register and Table 1-19 provides bit descriptions and reset values.
22
25 26 27 28
31
TAG
SIZE
V E U0
Reserved
Figure 1-13:
TLBHI
Translation Look-Aside Buffer High Register (TLBHI) Name Description TLB-entry tag Is compared with the page number portion of the virtual memory address under the control of the SIZE field. Read/Write Reset Value 0x000000
TAG
22:24
SIZE
Size Specifies the page size. The SIZE field controls the bit range used in comparing the TAG field with the page number portion of the virtual memory address. Read/Write
000
25
Valid When bit is set to 1, the TLB entry is valid and contains a page-translation entry. When cleared to 0, the TLB entry is invalid. Read/Write
www.xilinx.com 1-800-255-7778
35
Translation Look-Aside Buffer High Register (TLBHI) (Continued) Name Endian This bit is fixed to 0, since accesses to pages on MicroBlaze are always big endian. Read Only Description Reset Value 0
27
U0
User Defined This bit is fixed to 0, since there are no user defined storage attributes on MicroBlaze. Read Only
28:31
Reserved
36
www.xilinx.com 1-800-255-7778
Registers
26
31
MISS
Reserved
INDEX
Figure 1-14:
TLBX
Translation Look-Aside Buffer Index Register (TLBX) Name Description TLB Miss This bit is cleared to 0 when the TLBSX register is written with a virtual address, and the virtual address is found in a TLB entry. The bit is set to 1 if the virtual address is not found. It is also cleared when the TLBX register itself is written. Read Only Can be read if the memory management special registers parameter C_MMU_TLB_ACCESS > 0. Reset Value 0
MISS
1:25 26:31
Reserved INDEX TLB Index This field is used to index the Translation Look-Aside Buffer entry accessed by the TLBLO and TLBHI registers. The field is updated with a TLB index when the TLBSX register is written with a virtual address, and the virtual address is found in the corresponding TLB entry. Read/Write Can be read and written if the memory management special registers parameter C_MMU_TLB_ACCESS > 0. 000000
www.xilinx.com 1-800-255-7778
37
22
31
VPN
Reserved
Figure 1-15:
TLBSX
Translation Look-Aside Buffer Index Search Register (TLBSX) Name Description Virtual Page Number This field represents the page number portion of the virtual memory address. It is compared with the page number portion of the virtual memory address under the control of the SIZE field, in each of the Translation Look-Aside Buffer entries that have the V bit set to 1. If the virtual page number is found, the TLBX register is written with the index of the TLB entry and the MISS bit in TLBX is cleared to 0. If the virtual page number is not found in any of the TLB entries, the MISS bit in the TLBX register is set to 1. Write Only Reset Value
VPN
22:31
Reserved
38
www.xilinx.com 1-800-255-7778
Registers
When read with the MFS instruction the PVR is specified by setting Sa = 0x200x, with x being the register number between 0x0 and 0xB. Table 1-22 throughTable 1-33 provide bit descriptions and values. Table 1-22: Bits 0 1 2 3 4 5 6 7 8 9:15 16:23 Processor Version Register 0 (PVR0) Description PVR implementation: 0=basic, 1=full Use barrel shifter Use divider Use hardware multiplier Use FPU Use any type of exceptions Use instruction cache Use data cache Use MMU Value Based on C_PVR C_USE_BARREL C_USE_DIV C_USE_HW_MUL > 0 C_USE_FPU > 0 Based on C_*_EXCEPTION C_USE_ICACHE C_USE_DCACHE C_USE_MMU > 0 0 MicroBlaze release version code 0x1 = v5.00.a 0x2 = v5.00.b 0x3 = v5.00.c 0x4 = v6.00.a 0x6 = v6.00.b 0x5 = v7.00.a 0x7 = v7.00.b 24:31 USR1 User configured value 1 C_PVR_USER1 Release Specific
Name CFG BS DIV MUL FPU EXC ICU DCU MMU Reserved MBV
Processor Version Register 1 (PVR1) Description User configured value 2 Value C_PVR_USER2
Name USR2
www.xilinx.com 1-800-255-7778
39
Processor Version Register 2 (PVR2) Name Description Data side OPB in use Data side LMB in use Instruction side OPB in use Instruction side LMB in use Interrupt is edge triggered Interrupt edge is positive Data side PLB in use Instruction side PLB in use Use PLB interconnect C_D_OPB C_D_LMB C_I_OPB C_I_LMB C_INTERRUPT_IS_EDGE C_EDGE_IS_POSITIVE C_D_PLB C_I_PLB C_INTERCONNECT Value
DOPB DLMB IOPB ILMB IRQEDGE IRQPOS DPLB IPLB INTERCON Reserved FSL FSLEXC MSR PCMP AREA BS DIV MUL FPU MUL64 FPU2 IPLBEXC DPLBEXC OP0EXC UNEXC
Use extended FSL instructions Generate exception for FSL control bit mismatch Use msrset and msrclr instructions Use pattern compare instructions Optimize area Use barrel shifter Use divider Use hardware multiplier Use FPU Use 64-bit hardware multiplier Use floating point conversion and square root instructions Generate exception for IPLB error Generate exception for DPLB error Generate exception for 0x0 illegal opcode Generate exception for unaligned data access
C_USE_EXTENDED_FSL_INSTR C_FSL_EXCEPTION C_USE_MSR_INSTR C_USE_PCMP_INSTR C_AREA_OPTIMIZED C_USE_BARREL C_USE_DIV C_USE_HW_MUL > 0 C_USE_FPU > 0 C_USE_HW_MUL = 2 C_USE_FPU = 2 C_IPLB_BUS_EXCEPTION C_DPLB_BUS_EXCEPTION C_OPCODE_0x0_ILLEGAL C_UNALIGNED_EXCEPTION
40
www.xilinx.com 1-800-255-7778
Registers
Processor Version Register 2 (PVR2) (Continued) Name Description Generate exception for any illegal opcode Generate exception for IOPB error Generate exception for DOPB error Generate exception for division by zero Generate exceptions from FPU Value C_ILL_OPCODE_EXCEPTION C_IOPB_BUS_EXCEPTION C_DOPB_BUS_EXCEPTION C_DIV_ZERO_EXCEPTION C_FPU_EXCEPTION
Table 1-25: Bits 0 1:2 3:6 7:9 10:12 13:15 16:18 19:21 22:24 25:31
Processor Version Register 3 (PVR3) Name Description Use debug logic Value C_DEBUG_ENABLED
DEBUG Reserved PCBRK Reserved RDADDR Reserved WRADDR Reserved FSL Reserved
Number of PC breakpoints
C_NUMBER_OF_PC_BRK
C_NUMBER_OF_RD_ADDR_BRK
C_NUMBER_OF_WR_ADDR_BRK
Number of FSLs
C_FSL_LINKS
Processor Version Register 4 (PVR4) Description Use instruction cache Instruction cache tag size Value C_USE_ICACHE C_ADDR_TAG_BITS 1 Allow instruction cache write The base two logarithm of the instruction cache line length C_ALLOW_ICACHE_WR log2(C_ICACHE_LINE_LEN)
www.xilinx.com 1-800-255-7778
41
Processor Version Register 4 (PVR4) (Continued) Description The base two logarithm of the instruction cache byte size The instruction cache is used for all memory accesses Value log2(C_CACHE_BYTE_SIZE) C_ICACHE_ALWAYS_USED 0
Processor Version Register 5 (PVR5) Description Use data cache Data cache tag size Value C_USE_DCACHE C_DCACHE_ADDR_TAG 1 Allow data cache write The base two logarithm of the data cache line length The base two logarithm of the data cache byte size C_ALLOW_DCACHE_WR log2(C_DCACHE_LINE_LEN) log2(C_DCACHE_BYTE_SIZE) 0
Processor Version Register 6 (PVR6) Description Instruction Cache Base Address Value C_ICACHE_BASEADDR
Name ICBA
Processor Version Register 7 (PVR7) Description Instruction Cache High Address Value C_ICACHE_HIGHADDR
Name ICHA
Processor Version Register 8 (PVR8) Description Data Cache Base Address Value C_DCACHE_BASEADDR
Name DCBA
Processor Version Register 9 (PVR9) Description Data Cache High Address Value C_DCACHE_HIGHADDR
Name DCHA
42
www.xilinx.com 1-800-255-7778
Registers
Processor Version Register 10 (PVR10) Description Target architecture: 0x4 = Virtex2 0x5 = Virtex2Pro 0x6 = Spartan3 0x7 = Virtex4 0x8 = Virtex5 0x9 = Spartan3E 0xA = Spartan3A 0xB = Spartan3AN 0xC = Spartan3Adsp Value Defined by parameter C_FAMILY
Name ARCH
8:31
Reserved
Processor Version Register 11 (PVR11) Description Use MMU: 0 = None 1 = User Mode 2 = Protection 3 = Virtual C_USE_MMU Value
Name MMU
Instruction Shadow TLB size Data Shadow TLB size TLB register access: 0 = Minimal 1 = Read 2 = Write 3 = Full
Number of memory protection zones Reserved for future use Reset value for MSR
C_MMU_ZONES 0 C_RESET_MSR
www.xilinx.com 1-800-255-7778
43
Pipeline Architecture
MicroBlaze instruction execution is pipelined. For most instructions, each stage takes one clock cycle to complete. Consequently, the number of clock cycles necessary for a specific instruction to complete is equal to the number of pipeline stages, and one instruction is completed on every cycle. A few instructions require multiple clock cycles in the execute stage to complete. This is achieved by stalling the pipeline. When executing from slower memory, instruction fetches may take multiple cycles. This additional latency directly affects the efficiency of the pipeline. MicroBlaze implements an instruction prefetch buffer that reduces the impact of such multi-cycle instruction memory latency. While the pipeline is stalled by a multi-cycle instruction in the execution stage, the prefetch buffer continues to load sequential instructions. When the pipeline resumes execution, the fetch stage can load new instructions directly from the prefetch buffer instead of waiting for the instruction memory access to complete.
Branches
Normally the instructions in the fetch and decode stages (as well as prefetch buffer) are flushed when executing a taken branch. The fetch pipeline stage is then reloaded with a new instruction from the calculated branch address. A taken branch in MicroBlaze takes three clock cycles to execute, two of which are required for refilling the pipeline. To reduce this latency overhead, MicroBlaze supports branches with delay slots.
44
www.xilinx.com 1-800-255-7778
Pipeline Architecture
Delay Slots
When executing a taken branch with delay slot, only the fetch pipeline stage in MicroBlaze is flushed. The instruction in the decode stage (branch delay slot) is allowed to complete. This technique effectively reduces the branch penalty from two clock cycles to one. Branch instructions with delay slots have a D appended to the instruction mnemonic. For example, the BNE instruction does not execute the subsequent instruction (does not have a delay slot), whereas BNED executes the next instruction before control is transferred to the branch location. A delay slot must not contain the following instructions: IMM, branch, or break. Interrupts and external hardware breaks are deferred until after the delay slot branch has been completed. Instructions that could cause recoverable exceptions (e.g. unaligned word or halfword load and store) are allowed in the delay slot. If an exception is caused in a delay slot the ESR[DS] bit is set, and the exception handler is responsible for returning the execution to the branch target (stored in the special purpose register BTR). If the ESR[DS] bit is set, register R17 is not valid (otherwise it contains the address following the instruction causing the exception).
www.xilinx.com 1-800-255-7778
45
Memory Architecture
MicroBlaze is implemented with a Harvard memory architecture; instruction and data accesses are done in separate address spaces. Each address space has a 32-bit range (that is, handles up to 4 GB of instructions and data memory respectively). The instruction and data memory ranges can be made to overlap by mapping them both to the same physical memory. The latter is useful for software debugging. Both instruction and data interfaces of MicroBlaze are 32 bits wide and use big endian, bit-reversed format. MicroBlaze supports word, halfword, and byte accesses to data memory. Data accesses must be aligned (word accesses must be on word boundaries, halfword on halfword boundaries), unless the processor is configured to support unaligned exceptions. All instruction accesses must be word aligned. MicroBlaze does not separate data accesses to I/O and memory (it uses memory mapped I/O). The processor has up to three interfaces for memory accesses: Local Memory Bus (LMB) Processor Local Bus (PLB) or On-Chip Peripheral Bus (OPB) Xilinx CacheLink (XCL)
The LMB memory address range must not overlap with PLB, OPB or XCL ranges. MicroBlaze has a single cycle latency for accesses to local memory (LMB) and for cache read hits, except with area optimization enabled when data side accesses and data cache read hits require two clock cycles. A data cache write normally has two cycles of latency (more if the posted-write buffer in the memory controller is full). The MicroBlaze instruction and data caches can be configured to use 4 or 8 word cache lines. When using a longer cache line, more bytes are prefetched, which generally improves performance for software with sequential access patterns. However, for software with a more random access pattern the performance can instead decrease for a given cache size. This is caused by a reduced cache hit rate due to fewer available cache lines. For details on the different memory interfaces refer to Chapter 2, MicroBlaze Signal Interface Description.
46
www.xilinx.com 1-800-255-7778
Privileged Instructions
Privileged Instructions
The following MicroBlaze instructions are privileged: GET, PUT, NGET, NPUT, CGET, CPUT, NCGET, NCPUT WIC, WDC MTS MSRCLR, MSRSET (except when only the C bit is affected) BRK RTID, RTBD, RTED BRKI (except when jumping to physical address 0x8 or 0x18)
Attempted use of these instructions when running in user mode causes a privileged instruction exception. There are six ways to leave user mode and virtual mode: 1. 2. 3. 4. 5. 6. Hardware generated reset (including debug reset) Hardware exception Non-maskable break or hardware break Interrupt Executing the instruction "BRALID Re, 0x8 to perform a user vector exception Executing the software break instructions BRKI jumping to physical address 0x8 or 0x18
In all of these cases, except hardware generated reset, the user mode and virtual mode status is saved in the MSR UMS and VMS bits. Application (user-mode) programs transfer control to system-service routines (privileged mode programs) using the BRALID or BRKI instruction, jumping to physical address 0x8. Executing this instruction causes a system-call exception to occur. The exception handler determines which system-service routine to call and whether the calling application has permission to call that service. If permission is granted, the exception handler performs the actual procedure call to the systemservice routine on behalf of the application program. The execution environment expected by the system-service routine requires the execution of prologue instructions to set up that environment. Those instructions usually create the block of storage that holds procedural information (the activation record), update and initialize pointers, and save volatile registers (registers the system-service routine uses). Prologue code can be inserted by the linker when creating an executable module, or it can be included as stub code in either the system-call interrupt handler or the system-library routines. Returns from the system-service routine reverse the process described above. Epilog code is executed to unwind and deallocate the activation record, restore pointers, and restore volatile registers. The interrupt handler executes a return from exception instruction (RTED) to return to the application.
www.xilinx.com 1-800-255-7778
47
Virtual-Memory Management
Programs running on MicroBlaze use effective addresses to access a flat 4 GB address space. The processor can interpret this address space in one of two ways, depending on the translation mode: In real mode, effective addresses are used to directly access physical memory In virtual mode, effective addresses are translated into physical addresses by the virtualmemory management hardware in the processor
Virtual mode provides system software with the ability to relocate programs and data anywhere in the physical address space. System software can move inactive programs and data out of physical memory when space is required by active programs and data. Relocation can make it appear to a program that more memory exists than is actually implemented by the system. This frees the programmer from working within the limits imposed by the amount of physical memory present in a system. Programmers do not need to know which physical-memory addresses are assigned to other software processes and hardware devices. The addresses visible to programs are translated into the appropriate physical addresses by the processor. Virtual mode provides greater control over memory protection. Blocks of memory as small as 1 KB can be individually protected from unauthorized access. Protection and relocation enable system software to support multitasking. This capability gives the appearance of simultaneous or nearsimultaneous execution of multiple programs. In MicroBlaze, virtual mode is implemented by the memory-management unit (MMU), available when C_USE_MMU is set to 3. The MMU controls effective-address to physical-address mapping and supports memory protection. Using these capabilities, system software can implement demandpaged virtual memory and other memory management schemes. The MicroBlaze MMU implementation is based upon PowerPC 405. For details, see the PowerPC Processor Reference Guide document. The MMU features are summarized as follows: Translates effective addresses into physical addresses Controls page-level access during address translation Provides additional virtual-mode protection control through the use of zones Provides independent control over instruction-address and data-address translation and protection Supports eight page sizes: 1 kB, 4 kB, 16 kB, 64 kB, 256 kB, 1 MB, 4 MB, and 16 MB. Any combination of page sizes can be used by system software Software controls the page-replacement strategy
Real Mode
The processor references memory when it fetches an instruction and when it accesses data with a load or store instruction. Programs reference memory locations using a 32-bit effective address calculated by the processor. When real mode is enabled, the physical address is identical to the effective address and the processor uses it to access physical memory. After a processor reset, the processor operates in real mode. Real mode can also be enabled by clearing the VM bit in the MSR. Physical-memory data accesses (loads and stores) are performed in real mode using the effective address. Real mode does not provide system software with virtual address translation, but the full memory access-protection is available, implemented when C_USE_MMU > 1. Implementation of a real-mode memory manager is more straightforward than a virtual-mode memory manager. Real
48
www.xilinx.com 1-800-255-7778
Virtual-Memory Management
mode is often an appropriate solution for memory management in simple embedded environments, when access-protection is necessary, but virtual address translation is not required.
Virtual Mode
In virtual mode, the processor translates an effective address into a physical address using the process shown in Figure 1-16. Virtual mode can be enabled by setting the VM bit in the MSR..
0 24 PID 31
Process ID Register
n Offset
31
0 PID
n+8 Offset
39
n Offset
31
Figure 1-16:
Each address shown in Figure 1-16 contains a page-number field and an offset field. The page number represents the portion of the address translated by the MMU. The offset represents the byte offset into a page and is not translated by the MMU. The virtual address consists of an additional field, called the process ID (PID), which is taken from the PID register (see Process-ID Register, page 31). The combination of PID and effective page number (EPN) is referred to as the virtual page number (VPN). The value n is determined by the page size, as shown in Table 1-34. System software maintains a page-translation table that contains entries used to translate each virtual page into a physical page. The page size defined by a page translation entry determines the size of the page number and offset fields. For example, when a 4 kB page size is used, the pagenumber field is 20 bits and the offset field is 12 bits. The VPN in this case is 28 bits. Then the most frequently used page translations are stored in the translation look-aside buffer (TLB). When translating a virtual address, the MMU examines the page-translation entries for a matching VPN (PID and EPN). Rather than examining all entries in the table, only entries contained in the processor TLB are examined. When a page-translation entry is found with a matching VPN, the corresponding physical-page number is read from the entry and combined with the offset to form the 32-bit physical address. This physical address is used by the processor to reference memory.
www.xilinx.com 1-800-255-7778
49
System software can use the PID to uniquely identify software processes (tasks, subroutines, threads) running on the processor. Independently compiled processes can operate in effectiveaddress regions that overlap each other. This overlap must be resolved by system software if multitasking is supported. Assigning a PID to each process enables system software to resolve the overlap by relocating each process into a unique region of virtual-address space. The virtual-address space mappings enable independent translation of each process into the physical-address space.
Page-Translation Table
The page-translation table is a software-defined and software-managed data structure containing page translations. The requirement for software-managed page translation represents an architectural trade-off targeted at embedded-system applications. Embedded systems tend to have a tightly controlled operating environment and a well-defined set of application software. That environment enables virtual-memory management to be optimized for each embedded system in the following ways: The page-translation table can be organized to maximize page-table search performance (also called table walking) so that a given page-translation entry is located quickly. Most generalpurpose processors implement either an indexed page table (simple search method, large pagetable size) or a hashed page table (complex search method, small page-table size). With software table walking, any hybrid organization can be employed that suits the particular embedded system. Both the page-table size and access time can be optimized. Independent page sizes can be used for application modules, device drivers, system service routines, and data. Independent page-size selection enables system software to more efficiently use memory by reducing fragmentation (unused memory). For example, a large data structure can be allocated to a 16 MB page and a small I/O device-driver can be allocated to a 1 KB page. Page replacement can be tuned to minimize the occurrence of missing page translations. As described in the following section, the most-frequently used page translations are stored in the translation look-aside buffer (TLB). Software is responsible for deciding which translations are stored in the TLB and which translations are replaced when a new translation is required. The replacement strategy can be tuned to avoid thrashing, whereby page-translation entries are constantly being moved in and out of the TLB. The replacement strategy can also be tuned to prevent replacement of critical-page translations, a process sometimes referred to as page locking.
The unified 64-entry TLB, managed by software, caches a subset of instruction and data pagetranslation entries accessible by the MMU. Software is responsible for reading entries from the page-translation table in system memory and storing them in the TLB. The following section describes the unified TLB in more detail. Internally, the MMU also contains shadow TLBs for instructions and data, with sizes configurable by C_MMU_ITLB_SIZE and C_MMU_DTLB_SIZE respectively. These shadow TLBs are managed entirely by the processor (transparent to software) and are used to minimize access conflicts with the unified TLB.
50
www.xilinx.com 1-800-255-7778
Virtual-Memory Management
The MicroBlaze TLB is physically implemented as three separate TLBs: Unified TLBThe UTLB contains 64 entries and is pseudo-associative. Instruction-page and data-page translation can be stored in any UTLB entry. The initialization and management of the UTLB is controlled completely by software. Instruction Shadow TLBThe ITLB contains instruction page-translation entries and is fully associative. The page-translation entries stored in the ITLB represent the most-recently accessed instruction-page translations from the UTLB. The ITLB is used to minimize contention between instruction translation and UTLB-update operations. The initialization and management of the ITLB is controlled completely by hardware and is transparent to software. Data Shadow TLBThe DTLB contains data page-translation entries and is fully associative. The page-translation entries stored in the DTLB represent the most-recently accessed datapage translations from the UTLB. The DTLB is used to minimize contention between data translation and UTLB-update operations. The initialization and management of the DTLB is controlled completely by hardware and is transparent to software.
Generate I-side Effective Address Translation Disabled (MSR[VM]=0) Translation Enabled (MSR[VM]=1)
Generate D-side Effective Address Translation Enabled (MSR[VM]=1) Translation Disabled (MSR[VM]=0)
No Translation
No Translation
Figure 1-17:
www.xilinx.com 1-800-255-7778
51
RPN
EX WR 22
ZSEL
I M G 35
TLBHI:
0 25 26 27 28
TAG
SIZE
V E U0
TID
Figure 1-18:
The TLB entry contents are described in Table 1-18, page 33 and Table 1-19, page 35. The fields within a TLB entry are categorized as follows: Virtual-page identification (TAG, SIZE, V, TID)These fields identify the page-translation entry. They are compared with the virtual-page number during the translation process. Physical-page identification (RPN, SIZE)These fields identify the translated page in physical memory. Access control (EX, WR, ZSEL)These fields specify the type of access allowed in the page and are used to protect pages from improper accesses. Storage attributes (W, I, M, G, E, U0)These fields specify the storage-control attributes, such as whether a page is cacheable and how bytes are ordered (endianness).
Table 1-34 shows the relationship between the TLB-entry SIZE field and the translated page size. This table also shows how the page size determines which address bits are involved in a tag comparison, which address bits are used as a page offset, and which bits in the physical page number are used in the physical address. Table 1-34: Page Size 1 KB 4 KB 16 KB 64 KB 256 KB 1 MB 4 MB 16 MB Page-Translation Bit Ranges by Page Size Tag Comparison Bit Range TAG[0:21] - Address[0:21] TAG[0:19] - Address[0:19] TAG[0:17] - Address[0:17] TAG[0:15] - Address[0:15] TAG[0:13] - Address[0:13] TAG[0:11] - Address[0:11] TAG[0:9] - Address[0:9] TAG[0:7] - Address[0:7] Page Offset Address[22:31] Address[20:31] Address[18:31] Address[16:31] Address[14:31] Address[12:31] Address[10:31] Address[8:31] Physical Page Number RPN[0:21] RPN[0:19] RPN[0:17] RPN[0:15] RPN[0:13] RPN[0:11] RPN[0:9] RPN[0:7] RPN Bits
Clear to 0
SIZE (TLBHI Field) 000 001 010 011 100 101 110 111
52
www.xilinx.com 1-800-255-7778
Virtual-Memory Management
When assigning sizes to instruction pages, software must be careful to avoid creating the opportunity for instruction-cache synonyms.
TLB Access
When the MMU translates a virtual address (the combination of PID and effective address) into a physical address, it first examines the appropriate shadow TLB for the page translation entry. If an entry is found, it is used to access physical memory. If an entry is not found, the MMU examines the UTLB for the entry. A delay occurs each time the UTLB must be accessed due to a shadow TLB miss. The miss latency ranges from 2-32 cycles. The DTLB has priority over the ITLB if both simultaneously access the UTLB. Figure 1-19, page 54 shows the logical process the MMU follows when examining a pagetranslation entry in one of the shadow TLBs or the UTLB. All valid entries in the TLB are checked. A TLB hit occurs when all of the following conditions are met by a TLB entry: The entry is valid The TAG field in the entry matches the effective address EPN under the control of the SIZE field in the entry The TID field in the entry matches the PID
If any of the above conditions are not met, a TLB miss occurs. A TLB miss causes an exception, described as follows: A TID value of 0x00 causes the MMU to ignore the comparison between the TID and PID. Only the TAG and EA[EPN] are compared. A TLB entry with TID=0x00 represents a process-independent translation. Pages that are accessed globally by all processes should be assigned a TID value of 0x00. A PID value of 0x00 does not identify a process that can access any page. When PID=0x00, a page-translation hit only occurs when TID=0x00. It is possible for software to load the TLB with multiple entries that match an EA[EPN] and PID combination. However, this is considered a programming error and results in undefined behavior. When a hit occurs, the MMU reads the RPN field from the corresponding TLB entry. Some or all of the bits in this field are used, depending on the value of the SIZE field (see Table 1-34). For example, if the SIZE field specifies a 256 kB page size, RPN[0:13] represents the physical page number and is used to form the physical address. RPN[14:21] is not used, and software must clear those bits to 0 when initializing the TLB entry. The remainder of the physical address is taken from the page-offset portion of the EA. If the page size is 256 kB, the 32-bit physical address is formed by concatenating RPN[0:13] with bits14:31 of the effective address. Prior to accessing physical memory, the MMU examines the TLB-entry access-control fields. These fields indicate whether the currently executing program is allowed to perform the requested memory access. If access is allowed, the MMU checks the storage-attribute fields to determine how to access the page. The storage-attribute fields specify the caching policy for memory accesses.
www.xilinx.com 1-800-255-7778
53
A matching TLB entry was not found, resulting in a TLB miss A matching TLB entry was found, but access to the page was prevented by either the storage attributes or zone protection
When an interrupt occurs, the processor enters real mode by clearing MSR[VM] to 0. In real mode, all address translation and memory-protection checks performed by the MMU are disabled. After system software initializes the UTLB with page-translation entries, management of the MicroBlaze UTLB is usually performed using interrupt handlers running in real mode. Figure 1-19 diagrams the general process for examining a TLB entry.
TLBHI[V]=1
No
TLB-Entry Miss
Yes
TLBHI[TID]=0x00
Yes
No
Compare TLBHI[TID] with PID
No Match
TLB-Entry Miss
Match
Compare TLBHI[TAG] with EA[EPN] using TLBHI[SIZE]
No Match
TLB-Entry Miss
Not Allowed
Access Violation
Guarded
Storage Violation
Not Guarded
Read TLBLO[RPN] using TLBHI[SIZE] Generate Physical Address from TLBLO[RPN] and Offset Extract Offset from EA using TLBHI[SIZE]
UG011_41_033101
Figure 1-19:
The following sections describe the conditions under which exceptions occur due to TLB access failures.
Data-Storage Exception
When virtual mode is enabled, (MSR[VM]=1), a data-storage exception occurs when access to a page is not permitted for any of the following reasons:
54
www.xilinx.com 1-800-255-7778
Virtual-Memory Management
The TLB entry specifies a zone field that prevents access to the page (ZPR[Zn]=00). This applies to load and store instructions. The TLB entry specifies a read-only page (TLBLO[WR]=0) that is not otherwise overridden by the zone field (ZPR[Zn] 11). This applies to store instructions. The TLB entry specifies a read-only page (TLBLO[WR]=0) that is not otherwise overridden by the zone field (ZPR[Zn] 10 and ZPR[Zn] 11). This applies to store instructions.
Instruction-Storage Exception
When virtual mode is enabled, (MSR[VM]=1), an instruction-storage exception occurs when access to a page is not permitted for any of the following reasons: From user mode:
The TLB entry specifies a zone field that prevents access to the page (ZPR[Zn]=00). The TLB entry specifies a non-executable page (TLBLO[EX]=0) that is not otherwise overridden by the zone field (ZPR[Zn] 11). The TLB entry specifies a guarded-storage page (TLBLO[G]=1). The TLB entry specifies a non-executable page (TLBLO[EX]=0) that is not otherwise overridden by the zone field (ZPR[Zn] 10 and ZPR[Zn] 11). The TLB entry specifies a guarded-storage page (TLBLO[G]=1).
Access Protection
System software uses access protection to protect sensitive memory locations from improper access. System software can restrict memory accesses for both user-mode and privileged-mode software. Restrictions can be placed on reads, writes, and instruction fetches. Access protection is available when virtual protected mode is enabled. Access control applies to instruction fetches, data loads, and data stores. The TLB entry for a virtual page specifies the type of access allowed to the page. The TLB entry also specifies a zone-protection field in the zone-protection register that is used to override the access controls specified by the TLB entry.
www.xilinx.com 1-800-255-7778
55
ProcessProcesses are protected from unauthorized access by assigning a unique process ID (PID) to each process. When system software starts a user-mode application, it loads the PID for that application into the PID register. As the application executes, memory addresses are translated using only TLB entries with a TID field in Translation Look-Aside Buffer High (TLBHI) that matches the PID. This enables system software to restrict accesses for an application to a specific area in virtual memory. A TLB entry with TID=0x00 represents a process-independent translation. Pages that are accessed globally by all processes should be assigned a TID value of 0x00. ExecutionThe processor executes instructions only if they are fetched from a virtual page marked as executable (TLBLO[EX]=1). Clearing TLBLO[EX] to 0 prevents execution of instructions fetched from a page, instead causing an instruction-storage interrupt (ISI) to occur. The ISI does not occur when the instruction is fetched, but instead occurs when the instruction is executed. This prevents speculatively fetched instructions that are later discarded (rather than executed) from causing an ISI. The zone-protection register can override execution protection.
Read/WriteData is written only to virtual pages marked as writable (TLBLO[WR]=1). Clearing TLBLO[WR] to 0 marks a page as read-only. An attempt to write to a read-only page causes a data-storage interrupt (DSI) to occur. The zone-protection register can override write protection.
TLB entries cannot be used to prevent programs from reading pages. In virtual mode, zone protection is used to read-protect pages. This is done by defining a no-access-allowed zone (ZPR[Zn] = 00) and using it to override the TLB-entry access protection. Only programs running in user mode can be prevented from reading a page. Privileged programs always have read access to a page.
Zone Protection
Zone protection is used to override the access protection specified in a TLB entry. Zones are an arbitrary grouping of virtual pages with common access protection. Zones can contain any number of pages specifying any combination of page sizes. There is no requirement for a zone to contain adjacent pages. The zone-protection register (ZPR) is a 32-bit register used to specify the type of protection override applied to each of 16 possible zones. The protection override for a zone is encoded in the ZPR as a 2-bit field. The 4-bit zone-select field in a TLB entry (TLBLO[ZSEL]) selects one of the 16 zone fields from the ZPR (Z0Z15). For example, zone Z5 is selected when ZSEL = 0101. Changing a zone field in the ZPR applies a protection override across all pages in that zone. Without the ZPR, protection changes require individual alterations to each page translation entry within the zone.
UTLB Management
The UTLB serves as the interface between the processor MMU and memory-management software. System software manages the UTLB to tell the MMU how to translate virtual addresses into physical addresses. When a problem occurs due to a missing translation or an access violation, the MMU communicates the problem to system software using the exception mechanism. System software is responsible for providing interrupt handlers to correct these problems so that the MMU can proceed with memory translation. Software reads and writes UTLB entries using the MFS and MTS instructions, respectively. These instructions use the TLBX register index (numbered 0 to 63) corresponding to one of the 64 entries
56
www.xilinx.com 1-800-255-7778
Virtual-Memory Management
in the UTLB. The tag and data portions are read and written separately, so software must execute two MFS or MTS instructions to completely access an entry. The UTLB is searched for a specific translation using the TLBSX register. TLBSX locates a translation using an effective address and loads the corresponding UTLB index into the TLBX register. Individual UTLB entries are invalidated using the MTS instruction to clear the valid bit in the tag portion of a TLB entry (TLBHI[V]).
Solving the above problems in an efficient manner requires keeping track of page accesses and page modifications. MicroBlaze does not track page access and page modification in hardware. Instead, system software can use the TLB-miss exceptions and the data-storage exception to collect this information. As the information is collected, it can be stored in a data structure associated with the page-translation table. Page-access information is used to determine which pages should be kept in physical memory and which are replaced when physical-memory space is required. System software can use the valid bit in the TLB entry (TLBHI[V]) to monitor page accesses. This requires page translations be initialized as not valid (TLBHI[V]=0) to indicate they have not been accessed. The first attempt to access a page causes a TLB-miss exception, either because the UTLB entry is marked not valid or because the page translation is not present in the UTLB. The TLB-miss handler updates the UTLB with a valid translation (TLBHI[V]=1). The set valid bit serves as a record that the page and its translation have been accessed. The TLB-miss handler can also record the information in a separate data structure associated with the page-translation entry. Page-modification information is used to indicate whether an old page can be overwritten with a new page or the old page must first be stored to a hard disk. System software can use the writeprotection bit in the TLB entry (TLBLO[WR]) to monitor page modification. This requires page translations be initialized as read-only (TLBLO[WR]=0) to indicate they have not been modified. The first attempt to write data into a page causes a data-storage exception, assuming the page has already been accessed and marked valid as described above. If software has permission to write into the page, the data-storage handler marks the page as writable (TLBLO[WR]=1) and returns. The set write-protection bit serves as a record that a page has been modified. The data-storage handler can also record this information in a separate data structure associated with the page-translation entry. Tracking page modification is useful when virtual mode is first entered and when a new process is started.
www.xilinx.com 1-800-255-7778
57
Table 1-35 defines the memory address locations of the associated vectors and the hardware enforced register file locations for return addresses. Each vector allocates two addresses to allow full address range branching (requires an IMM followed by a BRAI instruction). The address range 0x28 to 0x4F is reserved for future software support by Xilinx. Allocating these addresses for user applications is likely to conflict with future releases of EDK support software. Table 1-35: Vectors and Return Address Register File Location Event Reset User Vector (Exception) Interrupt Break: Non-maskable hardware Break: Hardware Break: Software Hardware Exception Reserved by Xilinx for future use 0x00000020 - 0x00000024 0x00000028 - 0x0000004F R17 or BTR 0x00000018 - 0x0000001C R16 Vector Address 0x00000000 - 0x00000004 0x00000008 - 0x0000000C 0x00000010 - 0x00000014 Register File Return Address Rx R14
Reset
When a Reset or Debug_Rst (1) occurs, MicroBlaze flushes the pipeline and starts fetching instructions from the reset vector (address 0x0). Both external reset signals are active high and should be asserted for a minimum of 16 cycles.
Equivalent Pseudocode
PC 0x00000000 MSR C_RESET_MSR (see MicroBlaze Core Configurability in Chapter 2) EAR 0; ESR 0; FSR 0 PID 0; ZPR 0; TLBX 0
58
www.xilinx.com 1-800-255-7778
Hardware Exceptions
MicroBlaze can be configured to trap the following internal error conditions: illegal instruction, instruction and data bus error, and unaligned access. The divide by zero exception can only be enabled if the processor is configured with a hardware divider (C_USE_DIV=1). When configured with a hardware floating point unit (C_USE_FPU>0), it can also trap the following floating point specific exceptions: underflow, overflow, float division-by-zero, invalid operation, and denormalized operand error. When configured with a hardware Memory Management Unit, it can also trap the following memory management specific exceptions: Illegal Instruction Exception, Data Storage Exception, Instruction Storage Exception, Data TLB Miss Exception, and Instruction TLB Miss Exception. A hardware exception causes MicroBlaze to flush the pipeline and branch to the hardware exception vector (address 0x20). The execution stage instruction in the exception cycle is not executed. The exception also updates the general purpose register R17 in the following manner: For the MMU exceptions (Data Storage Exception, Instruction Storage Exception, Data TLB Miss Exception, Instruction TLB Miss Exception) the register R17 is loaded with the appropriate program counter value to re-execute the instruction causing the exception upon return. The value is adjusted to return to a preceding IMM instruction, if any. If the exception is caused by an instruction in a branch delay slot, the value is adjusted to return to the branch instruction, including adjustment for a preceding IMM instruction, if any. For all other exceptions the register R17 is loaded with the program counter value of the subsequent instruction, unless the exception is caused by an instruction in a branch delay slot. If the exception is caused by an instruction in a branch delay slot, the ESR[DS] bit is set. In this case the exception handler should resume execution from the branch target address stored in BTR.
The EE and EIP bits in MSR are automatically reverted when executing the RTED instruction. The VM and UM bits in MSR are automatically reverted from VMS and UMS when executing the RTED, RTBD, and RTID instructions.
Exception Causes
Fast Simplex Link Exception The Fast Simplex Link (FSL) exception is caused by executing a get or getd instruction with the e bit set to 1 when there is a control bit mismatch. Instruction Bus Exception The instruction Processor Local Bus(PLB) exception is caused by an active error signal from the slave (IPLB_MRdErr) or timeout signal from the arbiter (IPLB_MTimeout). The instruction On-chip Peripheral Bus exception is caused by an active error signal from the slave (IOPB_errAck) or timeout signal from the arbiter (IOPB_timeout). The instructions side local memory (ILMB) and CacheLink (IXCL) interfaces cannot cause instruction bus exceptions. Illegal Opcode Exception The illegal opcode exception is caused by an instruction with an invalid major opcode (bits 0 through 5 of instruction). Bits 6 through 31 of the instruction are not checked. Optional processor instructions are detected as illegal if not enabled. If the optional feature C_OPCODE_0x0_ILLEGAL is enabled, an illegal opcode exception is also caused if the instruction is equal to 0x00000000.
www.xilinx.com 1-800-255-7778
59
Data Bus Exception The data Processor Local Bus exception is caused by an active error signal from the slave (DPLB_MRdErr or DPLB_MWrErr) or timeout signal from the arbiter (DPLB_MTimeout). The data On-chip Peripheral Bus exception is caused by an active error signal from the slave (DOPB_errAck) or timeout signal from the arbiter (DOPB_timeout). The data side local memory (DLMB) and CacheLink (DXCL) interfaces can not cause data bus exceptions.
Unaligned Exception The unaligned exception is caused by a word access where the address to the data bus has bits 30 or 31 set, or a half-word access with bit 31 set.
Divide by Zero Exception The divide-by-zero exception is caused by an integer division (idiv or idivu) where the divisor is zero.
FPU Exception An FPU exception is caused by an underflow, overflow, divide-by-zero, illegal operation, or denormalized operand occurring with a floating point instruction.
Underflow occurs when the result is denormalized. Overflow occurs when the result is not-a-number (NaN). The divide-by-zero FPU exception is caused by the rA operand to fdiv being zero when rB is not infinite. Illegal operation is caused by a signaling NaN operand or by illegal infinite or zero operand combinations.
Privileged Instruction Exception The Privileged Instruction exception is caused by an attempt to execute a privileged instruction in User Mode.
Data Storage Exception The Data Storage exception is caused by an attempt to access data in memory that results in a memory-protection violation.
Instruction Storage Exception The Instruction Storage exception is caused by an attempt to access instructions in memory that results in a memory-protection violation.
Data TLB Miss Exception The Data TLB Miss exception is caused by an attempt to access data in memory, when a valid Translation Look-Aside Buffer entry is not present, and virtual protected mode is enabled.
Instruction TLB Miss Exception The Instruction TLB Miss exception is caused by an attempt to access instructions in memory, when a valid Translation Look-Aside Buffer entry is not present, and virtual protected mode is enabled.
60
www.xilinx.com 1-800-255-7778
Equivalent Pseudocode
ESR[DS] exception in delay slot if ESR[DS] then BTR branch target PC if MMU exception then if branch preceeded by IMM then r17 PC - 8 else r17 PC - 4 else r17 invalid value else if MMU exception then if instruction preceeded by IMM then r17 PC - 4 else r17 PC else r17 PC + 4 PC 0x00000020 MSR[EE] 0, MSR[EIP] 1 MSR[UMS] MSR[UM], MSR[UM] 0, MSR[VMS] MSR[VM], MSR[VM] 0 ESR[EC] exception specific value ESR[ESS] exception specific value EAR exception specific value FSR exception specific value
Breaks
There are two kinds of breaks: Hardware (external) breaks Software (internal) breaks
Hardware Breaks
Hardware breaks are performed by asserting the external break signal (that is, the Ext_BRK and Ext_NM_BRK input ports). On a break, the instruction in the execution stage completes while the instruction in the decode stage is replaced by a branch to the break vector (address 0x18). The break return address (the PC associated with the instruction in the decode stage at the time of the break) is automatically loaded into general purpose register R16. MicroBlaze also sets the Break In Progress (BIP) flag in the Machine Status Register (MSR). A normal hardware break (that is, the Ext_BRK input port) is only handled when MSR[BIP] and MSR[EIP] are set to 0 (that is, there is no break or exception in progress). The Break In Progress flag disables interrupts. A non-maskable break (that is, the Ext_NM_BRK input port) is always handled immediately. The BIP bit in the MSR is automatically cleared when executing the RTBD instruction.
Software Breaks
To perform a software break, use the brk and brki instructions. Refer to Chapter 4, MicroBlaze Instruction Set Architecture for detailed information on software breaks.
www.xilinx.com 1-800-255-7778
61
Latency
The time it takes MicroBlaze to enter a break service routine from the time the break occurs depends on the instruction currently in the execution stage and the latency to the memory storing the break vector.
Equivalent Pseudocode
r16 PC PC 0x00000018 MSR[BIP] 1 MSR[UMS] MSR[UM], MSR[UM] 0, MSR[VMS] MSR[VM], MSR[VM] 0
Interrupt
MicroBlaze supports one external interrupt source (connected to the Interrupt input port). The processor only reacts to interrupts if the Interrupt Enable (IE) bit in the Machine Status Register (MSR) is set to 1. On an interrupt, the instruction in the execution stage completes while the instruction in the decode stage is replaced by a branch to the interrupt vector (address 0x10). The interrupt return address (the PC associated with the instruction in the decode stage at the time of the interrupt) is automatically loaded into general purpose register R14. In addition, the processor also disables future interrupts by clearing the IE bit in the MSR. The IE bit is automatically set again when executing the RTID instruction. Interrupts are ignored by the processor if either of the break in progress (BIP) or exception in progress (EIP) bits in the MSR are set to 1.
Latency
The time it takes MicroBlaze to enter an Interrupt Service Routine (ISR) from the time an interrupt occurs, depends on the configuration of the processor and the latency of the memory controller storing the interrupt vectors. If MicroBlaze is configured to have a hardware divider, the largest latency happens when an interrupt occurs during the execution of a division instruction.
Equivalent Pseudocode
r14 PC PC 0x00000010 MSR[IE] 0 MSR[UMS] MSR[UM], MSR[UM] 0, MSR[VMS] MSR[VM], MSR[VM] 0
Pseudocode
rx PC PC 0x00000008 MSR[UMS] MSR[UM], MSR[UM] 0, MSR[VMS] MSR[VM], MSR[VM] 0
62
www.xilinx.com 1-800-255-7778
Instruction Cache
Instruction Cache
Overview
MicroBlaze can be used with an optional instruction cache for improved performance when executing code that resides outside the LMB address range. The instruction cache has the following features: Direct mapped (1-way associative) User selectable cacheable memory address range Configurable cache and tag size Caching over CacheLink (XCL) interface Option to use 4 or 8 word cache-line Cache on and off controlled using a bit in the MSR Optional WIC instruction to invalidate instruction cache lines
www.xilinx.com 1-800-255-7778
63
Tag Address
Cache Address
- -
Line Addr
Tag RAM
Tag
Cache_Hit
Word Addr
Instruction RAM
Cache_instruction_data
Figure 1-20:
WIC Instruction
The optional WIC instruction (C_ALLOW_ICACHE_WR=1) is used to invalidate cache lines in the instruction cache from an application. For a detailed description, refer to Chapter 4, MicroBlaze Instruction Set Architecture. The cache must be disabled (MSR[ICE]=0) when the instruction is executed.
64
www.xilinx.com 1-800-255-7778
Data Cache
Data Cache
Overview
MicroBlaze can be used with an optional data cache for improved performance. The cached memory range must not include addresses in the LMB address range. The data cache has the following features Direct mapped (1-way associative) Write-through User selectable cacheable memory address range Configurable cache size and tag size Caching over CacheLink (XCL) interface Option to use 4 or 8 word cache-lines Cache on and off controlled using a bit in the MSR Optional WDC instruction to invalidate data cache lines
Tag Address
- -
Addr
Tag RAM
Tag
Cache_Hit
Addr
Data RAM
Figure 1-21:
www.xilinx.com 1-800-255-7778
65
For example, in a MicroBlaze configured with C_DCACHE_BASEADDR=0x00400000, C_DCACHE_HIGHADDR=0x00403fff, C_DCACHE_BYTE_SIZE=2048, and C_DCACHE_LINELEN=4; the cacheable memory of 16 kB uses 14 bits of byte address, and the 2 kB cache uses 11 bits of byte address, thus the required address tag width is 14-11=3 bits. The total number of block RAM primitives required in this configuration is 1 RAMB16 for storing the 512 data words, and 1 RAMB16 for 128 cache line entries, each consisting of 3 bits of tag, 4 word-valid bits, 1 line-valid bit. In total, 2 RAMB16 primitives.
WDC Instruction
The optional WDC instruction (C_ALLOW_DCACHE_WR=1) is used to invalidate cache lines in the data cache from an application. For a detailed description, please refer to Chapter 4, MicroBlaze Instruction Set Architecture.
66
www.xilinx.com 1-800-255-7778
Format
An IEEE 754 single precision floating point number is composed of the following three fields: 1. 2. 3. 1-bit sign 8-bit biased exponent 23-bit fraction (a.k.a. mantissa or significand)
31
sign
exponent
fraction
Figure 1-22:
The value of a floating point number v in MicroBlaze has the following interpretation: 1. 2. 3. 4. 5. If exponent = 255 and fraction <> 0, then v= NaN, regardless of the sign bit If exponent = 255 and fraction = 0, then v= (-1)sign * If 0 < exponent < 255, then v = (-1)sign * 2(exponent-127) * (1.fraction) If exponent = 0 and fraction <> 0, then v = (-1)sign * 2-126 * (0.fraction) If exponent = 0 and fraction = 0, then v = (-1)sign * 0
1. Numbers that are so close to 0, that they cannot be represented with full precision, that is, any number n that falls in the following ranges: ( 1.17549*10-38 > n > 0 ), or ( 0 > n > -1.17549 * 10-38 )
www.xilinx.com 1-800-255-7778
67
For practical purposes only 3 and 5 are useful, while the others all represent either an error or numbers that can no longer be represented with full precision in a 32 bit format.
Rounding
The MicroBlaze FPU only implements the default rounding mode, Round-to-nearest, specified in IEEE 754. By definition, the result of any floating point operation should return the nearest single precision value to the infinitely precise result. If the two nearest representable values are equally near, then the one with its least significant bit zero is returned.
Operations
All MicroBlaze FPU operations use the processors general purpose registers rather than a dedicated floating point register file, see General Purpose Registers.
Arithmetic
The FPU implements the following floating point operations: addition, fadd subtraction, fsub multiplication, fmul division, fdiv square root, fsqrt (available if C_USE_FPU = 2)
Comparison
The FPU implements the following floating point comparisons: compare less-than, fcmp.lt compare equal, fcmp.eq compare less-or-equal, fcmp.le compare greater-than, fcmp.gt compare not-equal, fcmp.ne compare greater-or-equal, fcmp.ge compare unordered, fcmp.un (used for NaN)
Conversion
The FPU implements the following conversions (available if C_USE_FPU = 2): convert from signed integer to floating point, flt convert from floating point to signed integer, fint
Exceptions
The floating point unit uses the regular hardware exception mechanism in MicroBlaze. When enabled, exceptions are thrown for all the IEEE standard conditions: underflow, overflow, divideby-zero, and illegal operation, as well as for the MicroBlaze specific exception: denormalized operand error. A floating point exception inhibits the write to the destination register (Rd). This allows a floating point exception handler to operate on the uncorrupted register file.
68
www.xilinx.com 1-800-255-7778
ConfigReg fx ResultReg
Figure 1-23:
This method is similar to extending the ISA with custom instructions, but has the benefit of not making the overall speed of the processor pipeline dependent on the custom function. Also, there are no additional requirements on the software tool chain associated with this type of functional extension.
www.xilinx.com 1-800-255-7778
69
Trace Overview
The MicroBlaze trace interface exports a number of internal state signals for performance monitoring and analysis. Xilinx recommends that users only use the trace interface through Xilinx developed analysis cores. This interface is not guaranteed to be backward compatible in future releases of MicroBlaze.
70
www.xilinx.com 1-800-255-7778
Chapter 2
Overview
The MicroBlaze core is organized as a Harvard architecture with separate bus interface units for data and instruction accesses. The following three memory interfaces are supported: Local Memory Bus (LMB), the IBM Processor Local Bus (PLB) or the IBM On-chip Peripheral Bus (OPB), and Xilinx CacheLink (XCL). The LMB provides single-cycle access to on-chip dual-port block RAM. The PLB and OPB interfaces provide a connection to both on-chip and off-chip peripherals and memory. The CacheLink interface is intended for use with specialized external memory controllers. MicroBlaze also supports up to 16 Fast Simplex Link (FSL) ports, each with one master and one slave FSL interface.
Features
MicroBlaze can be configured with the following bus interfaces: A 32-bit version of the PLB V4.6 interface (see IBMs 128-Bit Processor Local Bus Architectural Specifications, Version 4.6). A 32-bit version of the OPB V2.0 bus interface (see IBMs 64-Bit On-Chip Peripheral Bus, Architectural Specifications, Version 2.0) LMB provides simple synchronous protocol for efficient block RAM transfers FSL provides a fast non-arbitrated streaming communication mechanism XCL provides a fast slave-side arbitrated streaming interface between caches and external memory controllers Debug interface for use with the Microprocessor Debug Module (MDM) core Trace interface for performance analysis
www.xilinx.com 1-800-255-7778
71
I-Cache
D-Cache
IXCL_M IXCL_S
ALU Program Counter Special Purpose Registers Shift Barrel Shift Multiplier Divider
DXCL_M DXCL_S
DPLB
Bus IF
Bus IF
DOPB DLMB
Figure 2-1:
72
www.xilinx.com 1-800-255-7778
Table 2-1:
Summary of MicroBlaze Core I/O Interface DOPB DOPB DOPB DOPB DOPB DOPB DOPB DOPB DOPB DOPB DOPB DOPB DOPB DOPB IOPB IOPB IOPB IOPB IOPB IOPB IOPB IOPB IOPB IOPB IOPB IOPB IOPB IOPB I/O O O O O O O O O I I I I I I O O O O O O O O I I I I I I Description Data interface OPB address bus Data interface OPB byte enables Data interface OPB bus lock Data interface OPB write data bus Data interface OPB bus request Data interface OPB read, not write Data interface OPB select Data interface OPB sequential address Data interface OPB read data bus Data interface OPB error acknowledge Data interface OPB bus grant Data interface OPB bus cycle retry Data interface OPB timeout error Data interface OPB transfer acknowledge Instruction interface OPB address bus Instruction interface OPB byte enables Instruction interface OPB bus lock Instruction interface OPB write data bus (always 0x00000000) Instruction interface OPB bus request Instruction interface OPB read, not write (tied to IM_select) Instruction interface OPB select Instruction interface OPB sequential address Instruction interface OPB read data bus Instruction interface OPB error acknowledge Instruction interface OPB bus grant Instruction interface OPB bus cycle retry Instruction interface OPB timeout error Instruction interface OPB transfer acknowledge
Signal DM_ABus[0:31] DM_BE[0:3] DM_busLock DM_DBus[0:31] DM_request DM_RNW DM_select DM_seqAddr DOPB_DBus[0:31] DOPB_errAck DOPB_MGrant DOPB_retry DOPB_timeout DOPB_xferAck IM_ABus[0:31] IM_BE[0:3] IM_busLock IM_DBus[0:31] IM_request IM_RNW IM_select IM_seqAddr IOPB_DBus[0:31] IOPB_errAck IOPB_MGrant IOPB_retry IOPB_timeout IOPB_xferAck
www.xilinx.com 1-800-255-7778
73
Table 2-1:
Summary of MicroBlaze Core I/O (Continued) Interface DPLB DPLB DPLB DPLB DPLB DPLB DPLB DPLB DPLB DPLB DPLB DPLB DPLB DPLB DPLB DPLB DPLB DPLB DPLB DPLB DPLB DPLB DPLB DPLB DPLB DPLB DPLB DPLB I/O O O O O O O O O O O O O O O O O I I I I I I I I I I I I Description Data Interface PLB abort bus request indicator Data Interface PLB address bus Data Interface PLB upper address bus Data Interface PLB byte enables Data Interface PLB bus lock Data Interface PLB lock error indicator Data Interface PLB master data bus size Data Interface PLB bus request priority Data Interface PLB burst read transfer indicator Data Interface PLB bus request Data Interface PLB read/not write Data Interface PLB transfer size Data Interface PLB Transfer Attribute bus Data Interface PLB transfer type Data Interface PLB burst write transfer indicator Data Interface PLB write data bus Data Interface PLB slave busy indicator Data Interface PLB slave read error indicator Data Interface PLB slave write error indicator Data Interface PLB slave interrupt indicator Data Interface PLB terminate write burst indicator Data Interface PLB write data acknowledge Data Interface PLB address acknowledge Data Interface PLB terminate read burst indicator Data Interface PLB read data acknowledge Data Interface PLB read data bus Data Interface PLB read word address Data Interface PLB bus rearbitrate indicator
Signal DPLB_M_ABort DPLB_M_ABus DPLB_M_UABus DPLB_M_BE DPLB_M_busLock DPLB_M_lockErr DPLB_M_MSize DPLB_M_priority DPLB_M_rdBurst DPLB_M_request DPLB_M_RNW DPLB_M_size DPLB_M_TAttribute DPLB_M_type DPLB_M_wrBurst DPLB_M_wrDBus DPLB_MBusy DPLB_MRdErr DPLB_MWrErr DPLB_MIRQ DPLB_MWrBTerm DPLB_MWrDAck DPLB_MAddrAck DPLB_MMRdBTerm DPLB_MRdDAck DPLB_MRdDBus DPLB_MRdWdAddr DPLB_MRearbitrate
74
www.xilinx.com 1-800-255-7778
Table 2-1:
Summary of MicroBlaze Core I/O (Continued) Interface DPLB DPLB IPLB IPLB IPLB IPLB IPLB IPLB IPLB IPLB IPLB IPLB IPLB IPLB IPLB IPLB IPLB IPLB IPLB IPLB IPLB IPLB IPLB IPLB I/O I I O O O O O O O O O O O O O O O O I I I I I I Description Data Interface PLB slave data bus size Data Interface PLB bus timeout Instruction Interface PLB abort bus request indicator Instruction Interface PLB address bus Instruction Interface PLB upper address bus Instruction Interface PLB byte enables Instruction Interface PLB bus lock Instruction Interface PLB lock error indicator Instruction Interface PLB master data bus size Instruction Interface PLB bus request priority Instruction Interface PLB burst read transfer indicator Instruction Interface PLB bus request Instruction Interface PLB read/not write Instruction Interface PLB transfer size Instruction Interface PLB Transfer Attribute bus Instruction Interface PLB transfer type Instruction Interface PLB burst write transfer indicator Instruction Interface PLB write data bus Instruction Interface PLB slave busy indicator Instruction Interface PLB slave read error indicator Instruction Interface PLB slave write error indicator Instruction Interface PLB slave interrupt indicator Instruction Interface PLB terminate write burst indicator Instruction Interface PLB write data acknowledge
Signal DPLB_MSSize DPLB_MTimeout IPLB_M_ABort IPLB_M_ABus IPLB_M_UABus IPLB_M_BE IPLB_M_busLock IPLB_M_lockErr IPLB_M_MSize IPLB_M_priority IPLB_M_rdBurst IPLB_M_request IPLB_M_RNW IPLB_M_size IPLB_M_TAttribute IPLB_M_type IPLB_M_wrBurst IPLB_M_wrDBus IPLB_MBusy IPLB_MRdErr IPLB_MWrErr IPLB_MIRQ IPLB_MWrBTerm IPLB_MWrDAck
www.xilinx.com 1-800-255-7778
75
Table 2-1:
Summary of MicroBlaze Core I/O (Continued) Interface IPLB IPLB IPLB IPLB IPLB IPLB IPLB IPLB DLMB DLMB DLMB DLMB DLMB DLMB DLMB DLMB ILMB ILMB ILMB ILMB ILMB MFSL SFSL IXCL_S IXCL_M DXCL_S DXCL_M Core I/O I I I I I I I I O O O O O O I I O O O I I O I IO IO IO IO I Description Instruction Interface PLB address acknowledge Instruction Interface PLB terminate read burst indicator Instruction Interface PLB read data acknowledge Instruction Interface PLB read data bus Instruction Interface PLB read word address Instruction Interface PLB bus rearbitrate indicator Instruction Interface PLB slave data bus size Instruction Interface PLB bus timeout Data interface LMB address bus Data interface LMB byte enables Data interface LMB write data bus Data interface LMB address strobe Data interface LMB read strobe Data interface LMB write strobe Data interface LMB read data bus Data interface LMB data ready Instruction interface LMB address bus Instruction interface LMB address strobe Instruction interface LMB instruction fetch Instruction interface LMB read data bus Instruction interface LMB data ready Master interface to output FSL channels Slave interface to input FSL channels Instruction side CacheLink FSL slave interface Instruction side CacheLink FSL master interface Data side CacheLink FSL slave interface Data side CacheLink FSL master interface Interrupt
Signal IPLB_MAddrAck IPLB_MMRdBTerm IPLB_MRdDAck IPLB_MRdDBus IPLB_MRdWdAddr IPLB_MRearbitrate IPLB_MSSize IPLB_MTimeout Data_Addr[0:31] Byte_Enable[0:3] Data_Write[0:31] D_AS Read_Strobe Write_Strobe Data_Read[0:31] DReady Instr_Addr[0:31] I_AS IFetch Instr[0:31] IReady FSL0_M .. FSL15_M FSL0_S .. FSL15_S ICache_FSL_in... ICache_FSL_out... DCache_FSL_in... DCache_FSL_out... Interrupt
76
www.xilinx.com 1-800-255-7778
Table 2-1:
Summary of MicroBlaze Core I/O (Continued) Interface Core Core Core Core Core Core Core Core I/O I I I I I O IO O Description Core reset, active high. Should be held for at least 1 Clk clock cycle. Core reset, active high. Should be held for at least 1 Clk clock cycle. Clock1 Break signal from MDM Non-maskable break signal from MDM Pipeline is halted Debug signals from MDM. See Table 2-9 for details. Trace signals for real time HW analysis. See Table 2-10 for details.
1. MicroBlaze is a synchronous design clocked with the Clk signal, except for hardware debug logic, which is clocked with the Dbg_Clk signal. If hardware debug logic is not used, there is no minimum frequency limit for Clk. However, if hardware debug logic is used, there are signals transferred between the two clock regions. In this case Clk must have a higher frequency than Dbg_Clk.
www.xilinx.com 1-800-255-7778
77
Addr[0:31]
The address bus is an output from the core and indicates the memory address that is being accessed by the current transfer. It is valid only when AS is high. In multicycle accesses (accesses requiring more than one clock cycle to complete), Addr[0:31] is valid only in the first clock cycle of the transfer.
Byte_Enable[0:3]
The byte enable signals are outputs from the core and indicate which byte lanes of the data bus contain valid data. Byte_Enable[0:3] is valid only when AS is high. In multicycle accesses (accesses requiring more than one clock cycle to complete), Byte_Enable[0:3] is valid only in the first clock cycle of the transfer. Valid values for Byte_Enable[0:3] are shown in the following table: Table 2-3: Valid Values for Byte_Enable[0:3] Byte Lanes Used Byte_Enable[0:3] 0000 0001 0010 0100 1000 0011 x x x x x x Data[0:7] Data[8:15] Data[16:23] Data[24:31]
78
www.xilinx.com 1-800-255-7778
Table 2-3:
Data[0:7] x x
Data[8:15] x x
Data[16:23]
Data[24:31]
Data_Write[0:31]
The write data bus is an output from the core and contains the data that is written to memory. It becomes valid when AS is high and goes invalid in the clock cycle after Ready is sampled high. Only the byte lanes specified by Byte_Enable[0:3] contain valid data.
AS
The address strobe is an output from the core and indicates the start of a transfer and qualifies the address bus and the byte enables. It is high only in the first clock cycle of the transfer, after which it goes low and remains low until the start of the next transfer.
Read_Strobe
The read strobe is an output from the core and indicates that a read transfer is in progress. This signal goes high in the first clock cycle of the transfer, and remains high until the clock cycle after Ready is sampled high. If a new read transfer is started in the clock cycle after Ready is high, then Read_Strobe remains high.
Write_Strobe
The write strobe is an output from the core and indicates that a write transfer is in progress. This signal goes high in the first clock cycle of the transfer, and remains high until the clock cycle after Ready is sampled high. If a new write transfer is started in the clock cycle after Ready is high, then Write_Strobe remains high.
Data_Read[0:31]
The read data bus is an input to the core and contains data read from memory. Data_Read[0:31] is valid on the rising edge of the clock when Ready is high.
Ready
The Ready signal is an input to the core and indicates completion of the current transfer and that the next transfer can begin in the following clock cycle. It is sampled on the rising edge of the clock. For reads, this signal indicates the Data_Read[0:31] bus is valid, and for writes it indicates that the Data_Write[0:31] bus has been written to local memory.
Clk
All operations on the LMB are synchronous to the MicroBlaze core clock.
www.xilinx.com 1-800-255-7778
79
LMB Transactions
The following diagrams provide examples of LMB bus operations.
Figure 2-2:
Figure 2-3:
80
www.xilinx.com 1-800-255-7778
Figure 2-4:
Figure 2-5:
Figure 2-6:
www.xilinx.com 1-800-255-7778
81
MicroBlaze does not support transfers that are larger than the addressed device. These types of transfers require dynamic bus sizing and conversion cycles that are not supported by the MicroBlaze bus interface. Data steering for read cycles is shown in Table 2-4, and data steering for write cycles is shown in Table 2-5. Table 2-4: Read Data Steering (Load to Register rD) Register rD Data Address [30:31] 11 10 01 00 10 00 00 Table 2-5: Byte_Enable [0:3] 0001 0010 0100 1000 0011 1100 1111 Transfer Size byte byte byte byte halfword halfword word Byte0 Byte1 Byte2 Byte0 Byte2 rD[0:7] rD[8:15] rD[16:23] rD[24:31] Byte3 Byte2 Byte1 Byte0 Byte3 Byte1 Byte3
Write Data Steering (Store from Register rD) Write Data Bus Bytes
Address [30:31] 11 10 01 00 10 00 00
Byte0
Byte1
Byte2
Byte3 rD[24:31]
rD[24:31] rD[24:31] rD[24:31] rD[16:23] rD[16:23] rD[0:7] rD[24:31] rD[8:15] rD[16:23] rD[24:31] rD[24:31]
Note: Other OPB masters may have more restrictive requirements for byte lane placement than
those allowed by MicroBlaze. OPB slave devices are typically attached left-justified with byte devices attached to the most-significant byte lane, and halfword devices attached to the most significant halfword lane. The MicroBlaze steering logic fully supports this attachment method.
82
www.xilinx.com 1-800-255-7778
FSLn_S_Data FSLn_S_Control
std_logic_vector
FSLn_S_Exists
std_logic
www.xilinx.com 1-800-255-7778
83
FSL Transactions
FSL BUS Write Operation
A write to the FSL bus is performed by MicroBlaze using one of the put or putd instructions. A write operation transfers the register contents to an output FSL bus. The transfer is completed in a single clock cycle for blocking mode writes to the FSL (put and cput instructions) as long as the FSL FIFO does not become full. If the FSL FIFO is full, the processor stalls until the FSL full flag is lowered. The non-blocking instructions (with prefix n), always completes in a single clock cycle even if the FSL was full. If the FSL was full, the write is inhibited and the carry bit is set in the MSR.
Schematic
MicroBlaze
Figure 2-7:
CacheLink Connection with Integrated FSL Buffers (Only Instruction Cache Used in this Example)
84
www.xilinx.com 1-800-255-7778
The interface is only available on MicroBlaze when caches are enabled. It is legal to use a CacheLink cache on the instruction side or the data side without caching the other. Memory locations outside the cacheable range are accessed over PLB, OPB or LMB. Cached memory range is accessed over PLB or OPB whenever the caches are software disabled (that is, MSR[DCE]=0 or MSR[ICE]=0). The CacheLink cache controllers handle 4 or 8-word cache lines with critical word first. At the same time the separation from the PLB or OPB bus reduces contention for non-cached memory accesses.
ICACHE_FSL_OUT_Data
output
ICACHE_FSL_OUT_Control
output
www.xilinx.com 1-800-255-7778
85
Table 2-8:
MicroBlaze Cache Link Signals Signal Name DCACHE_FSL_IN_Control DCACHE_FSL_IN_Exists DCACHE_FSL_OUT_Clk DCACHE_FSL_OUT_Write Description FSL control bit from D-side return read data FSL More read data exists in Dside return FSL Clock output to D-side read access FSL Write new cache miss access request to D-side read access FSL Cache miss access (read address or write address + write data + byte write enable) to D-side read access FSL FSL control-bit to D-side read access FSL. Used with address bits [30 to 31] for read/write and byte enable encoding. FSL access buffer for D-side read accesses is full VHDL Type std_logic std_logic std_logic std_logic Direction input input output output
DCACHE_FSL_OUT_Data
std_logic_vector (0 to 31)
output
DCACHE_FSL_OUT_Control
std_logic
output
DCACHE_FSL_OUT_Full
std_logic
input
CacheLink Transactions
All individual CacheLink accesses follow the FSL FIFO based transaction protocol: Access information is encoded over the FSL data and control signals (e.g. DCACHE_FSL_OUT_Data, DCACHE_FSL_OUT_Control, ICACHE_FSL_IN_Data, and ICACHE_FSL_IN_Control) Information is sent (stored) by raising the write enable signal (e.g. DCACHE_FSL_OUT_Write) The sender is only allowed to write if the full signal from the receiver is inactive (e.g. DCACHE_FSL_OUT_Full = 0). The full signal is not used by the instruction cache controller. Information is received (loaded) by raising the read signal (e.g. ICACHE_FSL_IN_Read) The receiver is only allowed to read as long as the sender signals that new data exists (e.g. ICACHE_FSL_IN_Exists = 1)
For details on the generic FSL protocol, please see DS449 Data Sheet. The CacheLink solution uses one incoming (slave) and one outgoing (master) FSL per cache controller. The outgoing FSL is used to send access requests, while the incoming FSL is used for receiving the requested cache lines. CacheLink also uses a specific encoding of the transaction information over the FSL data and control signals. The cache lines used for reads in the CacheLink protocol are 4 or 8 words long. Each cache line is expected to start with the critical word first (that is, if an access to address 0x348 is a miss with a 4
86
www.xilinx.com 1-800-255-7778
word cache line, then the returned cache line should have the following address sequence: 0x348, 0x34c, 0x340, 0x344). The cache controller forwards the first word to the execution unit as well as stores it in the cache memory. This allows execution to resume as soon as the first word is back. The cache controller then follows through by filling up the cache line with the remaining 3 or 7 words as they are received. All write operations to the data cache are single-word write-through.
Note: There must be at least one clock cycle before ICACHE_FSL_IN_Exists goes high (that is,
at least one wait state must be used).
3. 4. 5.
Store the word from ICACHE_FSL_IN_Data to the cache Forward the critical word to the execution unit in order to resume execution Repeat 3 and 4 for the subsequent 3 or 7 words in the cache line
Note: There must be at least one clock cycle before DCACHE_FSL_IN_Exists goes high (that is, at least one wait state must be used). 4. 5. 6. Store the word from DCACHE_FSL_IN_Data to the cache Forward the critical word to the execution unit in order to resume execution Repeat 3 and 4 for the subsequent 3 or 7 words in the cache line
3.
1. Byte and halfword read misses are naturally expected to return complete words, the cache controller then provides the execution unit with the correct bytes.
www.xilinx.com 1-800-255-7778
87
4.
Write the data to be stored to DCACHE_FSL_OUT_Data. For byte and halfword accesses the data is mirrored onto byte-lanes. Mirroring outputs the byte or halfword to be written on all four byte-lanes or on both halfword-lanes, respectively. The control bit should be low (DCACHE_FSL_OUT_Control = 0) for a word or halfword access, and high for a byte access. Word or halfword accesses can be distinguished by the least significant bit of the address (0=word and 1=halfword).
Signal Name Dbg_Clk Dbg_TDI Dbg_TDO Dbg_Reg_En Dbg_Shift1 Dbg_Capture Dbg_Update Debug_Rst1
1. Updated for MicroBlaze v7.00: Dbg_Shift added and Debug_Rst included in DEBUG bus
88
www.xilinx.com 1-800-255-7778
std_logic std_logic std_logic std_logic_vector (0 to 31) std_logic_vector (0 to 31) std_logic_vector (0 to 3) std_logic std_logic std_logic
www.xilinx.com 1-800-255-7778
89
Table 2-10: Signal Name Trace_DCache_Hit Trace_ICache_Req Trace_ICache_Hit Trace_OF_PipeRun Trace_EX_PipeRun4 Trace_MEM_PipeRun4 Trace_MB_Halted2
MicroBlaze Trace Signals Description VHDL Type std_logic std_logic std_logic std_logic std_logic std_logic std_logic Direction output output output output output output output
Data memory address is present in D-Cache Instruction memory address is in I-Cache range Instruction memory address is present in I-Cache Pipeline advance for Decode stage Pipeline advance for Execution stage Pipeline advance for Memory stage Pipeline is halted by debug
1. Valid only when Trace_Valid_Instr = 1 2. Updated for MicroBlaze v7.00: 4 bits added to Trace_MSR_Reg, Trace_PID_Reg added, Trace_MB_Halted added, and 1 bit added to Trace_Exception Kind 3. Valid only when Trace_Exception_Taken = 1 4. Not used with area optimization feature
Table 2-11:
Trace_Exception_Kind [0:4]
90
www.xilinx.com 1-800-255-7778
Parameter Name
C_FAMILY
Target Family
string
virtex2
C_DATA_SIZE C_DYNAMIC_BUS_SIZING C_SCO C_AREA_OPTIMIZED C_INTERCONNECT C_PVR C_PVR_USER1 C_PVR_USER2 C_RESET_MSR C_INSTANCE C_D_PLB
Data Size Legacy Xilinx internal Select area optimization Select PLB interconnect Processor version register mode selection Processor version register USER1 constant Processor version register USER2 constant Reset value for MSR register Instance Name Data side PLB interface
NA NA NA
integer integer integer integer integer integer std_logic_vector (0 to 7) std_logic_vector (0 to 31) std_logic_vector
yes yes
string integer
www.xilinx.com 1-800-255-7778
91
Table 2-12:
MPD Parameters (Continued) Feature/Description Allowable Values 0, 1 0, 1 0, 1 0, 1 0, 1 0, 1 0, 1 0, 1, 2 EDK Default Tool Value Assig ned 1 1 1 1 1 0 0 1 integer 0, 1, 2 0 integer integer 0, 1 0 integer 0, 1 0 integer integer integer integer integer integer yes yes yes yes yes VHDL Type
Parameter Name
Data side OPB interface Data side LMB interface Instruction side PLB interface Instruction side OPB interface Instruction side LMB interface Include barrel shifter Include hardware divider Include hardware multiplier (Virtex2 and later) Include hardware floating point unit (Virtex2 and later) Enable use of instructions: MSRSET and MSRCLR Enable use of instructions: PCMPBF, PCMPEQ, and PCMPNE Enable exception handling for unaligned data accesses Enable exception handling for illegal op-code Enable exception handling for IPLB bus error Enable exception handling for DPLB bus error Enable exception handling for IOPB bus error Enable exception handling for DOPB bus error Enable exception handling for division by zero
C_USE_FPU
C_USE_MSR_INSTR C_USE_PCMP_INSTR
0, 1
C_UNALIGNED_EXCEPTION
0, 1 0, 1 0, 1 0, 1 0, 1 0, 1
0 0 0 0 0 0
92
www.xilinx.com 1-800-255-7778
Table 2-12:
MPD Parameters (Continued) Feature/Description Allowable Values EDK Default Tool Value Assig ned 0 integer integer integer integer integer integer integer integer yes NA integer integer integer std_logic_vector std_logic_vector integer integer integer yes integer VHDL Type
Parameter Name
C_FPU_EXCEPTION
Enable exception handling for hardware floating point unit exceptions Detect opcode 0x0 as an illegal instruction Enable exception handling for Fast Simplex Link MDM Debug interface Number of hardware breakpoints Number of read address watchpoints Number of write address watchpoints Level/Edge Interrupt Negative/Positive Edge Interrupt Number of FSL interfaces FSL data bus size Enable use of extended FSL instructions Instruction cache base address Instruction cache high address Instruction cache Instruction cache write enable Instruction cache line length Instruction cache address tags
integer 0, 1
C_OPCODE_0x0_ILLEGAL C_FSL_EXCEPTION C_DEBUG_ENABLED C_NUMBER_OF_PC_BRK C_NUMBER_OF_RD_ADDR_BRK C_NUMBER_OF_WR_ADDR_BRK C_INTERRUPT_IS_EDGE C_EDGE_IS_POSITIVE C_FSL_LINKS1 C_FSL_DATA_SIZE C_USE_EXTENDED_FSL_INSTR C_ICACHE_BASEADDR C_ICACHE_HIGHADDR C_USE_ICACHE C_ALLOW_ICACHE_WR C_ICACHE_LINELEN C_ADDR_TAG_BITS
0,1 0,1 0,1 0-8 0-4 0-4 0, 1 0, 1 0-16 32 0, 1 0x00000000 0xFFFFFFFF 0x00000000 0xFFFFFFFF 0, 1 0, 1 4, 8 0-25
www.xilinx.com 1-800-255-7778
93
Table 2-12:
MPD Parameters (Continued) Feature/Description Allowable Values 64, 128, 256, 512, 1024, 2048, 4096, 8192, 16384, 32768, 655362 1 0x00000000 0xFFFFFFFF 0x00000000 0xFFFFFFFF 0,1 0,1 4, 8 0-25 64, 128, 256, 512, 1024, 2048, 4096, 8192, 16384, 32768, 655362 1 32 32 0 0, 1 32 32 0 EDK Default Tool Value Assig ned VHDL Type
Parameter Name
C_CACHE_BYTE_SIZE
integer 8192
C_ICACHE_USE_FSL
Cache over CacheLink instead of OPB for instructions Data cache base address Data cache high address Data cache Data cache write enable Data cache line length Data cache address tags Data cache size
integer 1 0x0000 0000 0x3FFF FFFF 0 1 4 17 yes std_logic_vector std_logic_vector integer integer integer integer integer 8192
Cache over CacheLink instead of OPB for data Data side PLB data width Data side PLB native data width Data side PLB burst enable Data side PLB Point-topoint Instruction side PLB data width Instruction side PLB native data width Instruction side PLB burst enable
1 32 32 0 0 32 32 0
94
www.xilinx.com 1-800-255-7778
Table 2-12:
MPD Parameters (Continued) Feature/Description Allowable Values EDK Default Tool Value Assig ned 0 VHDL Type
Parameter Name
C_IPLB_P2P C_USE_MMU
Instruction side PLB Point-to-point Memory Management: 0 = None 1 = Usermode 2 = Protection 3 = Virtual
0, 1
integer integer
0, 1, 2, 3
C_MMU_DTLB_SIZE C_MMU_ITLB_SIZE
Data shadow Translation Look-Aside Buffer size Instruction shadow Translation Look-Aside Buffer size Access to memory management special registers: 0 = Minimal 1 = Read 2 = Write 3 = Full
1, 2, 4, 8
integer integer
1, 2, 4, 8
4 integer
C_MMU_TLB_ACCESS
0, 1, 2, 3
C_MMU_ZONES
0-16
16
integer
1. The number of FSL Links is assigned by the tool itself if you are using the co-processor wizard. If you add the IP manually, you must update the parameter manually. 2. Not all sizes are permitted in all architectures. The cache uses between 0 and 32 RAMB primitives (0 if cache size is less than 2048).
www.xilinx.com 1-800-255-7778
95
96
www.xilinx.com 1-800-255-7778
Chapter 3
Data Types
The data types used by MicroBlaze assembly programs are shown in Table 3-1. Data types such as data8, data16, and data32 are used in place of the usual byte, half-word, and word.register Table 3-1: Data Types in MicroBlaze Assembly Programs Corresponding ANSI C data types char short int long int float enum pointera 1 2 4 4 4 4 2/4 Size (bytes)
MicroBlaze data types (for assembly programs) data8 data16 data32 data32 data32 data32 data16/data32
a. Pointers to small data areas, which can be accessed by global pointers are data16.
www.xilinx.com 1-800-255-7778
97
R18 R19-R31 RPC RMSR REAR RESR RFSR RBTR REDR RPID RZPR RTLBLO RTLBHI RTLBX
Dedicated Non-volatile Special Special Special Special Special Special Special Special Special Special Special Special
Reserved for Assembler Must be saved across function calls. Callee-save Program counter Machine Status Register Exception Address Register Exception Status Register Floating Point Status Register Branch Target Register Exception Data Register Process Identifier Register Zone Protection Register Translation Look-Aside Buffer Low Register Translation Look-Aside Buffer High Register Translation Look-Aside Buffer Index Register
98
www.xilinx.com 1-800-255-7778
Stack Convention
Register Usage Conventions Type Special Special Enforcement HW HW Purpose Translation Look-Aside Buffer Search Index Processor Version Register 0 through 11
The architecture for MicroBlaze defines 32 general purpose registers (GPRs). These registers are classified as volatile, non-volatile, and dedicated. The volatile registers (also known as caller-save) are used as temporaries and do not retain values across the function calls. Registers R3 through R12 are volatile, of which R3 and R4 are used for returning values to the caller function, if any. Registers R5 through R10 are used for passing parameters between subroutines. Registers R19 through R31 retain their contents across function calls and are hence termed as non-volatile registers (a.k.a callee-save). The callee function is expected to save those nonvolatile registers, which are being used. These are typically saved to the stack during the prologue and then reloaded during the epilogue. Certain registers are used as dedicated registers and programmers are not expected to use them for any other purpose.
Registers R14 through R17 are used for storing the return address from interrupts, subroutines, traps, and exceptions in that order. Subroutines are called using the branch and link instruction, which saves the current Program Counter (PC) onto register R15. Small data area pointers are used for accessing certain memory locations with 16- bit immediate value. These areas are discussed in the memory model section of this document. The read only small data area (SDA) anchor R2 (Read-Only) is used to access the constants such as literals. The other SDA anchor R13 (Read-Write) is used for accessing the values in the small data read-write section. Register R1 stores the value of the stack pointer and is updated on entry and exit from functions. Register R18 is used as a temporary register for assembler operations.
MicroBlaze includes special purpose registers such as: program counter (rpc), machine status register (rmsr), exception status register (resr), exception address register (rear), floating point status register (rfsr), branch target register (rbtr), exception data register (redr), memory management registers (rpid, rzpr, rtlblo, rtlbhi, rtlbx, rtlbsx), and processor version registers (rpvr0-rpvr11). These registers are not mapped directly to the register file and hence the usage of these registers is different from the general purpose registers. The value of a special purpose registers can be transferred to or from a general purpose register by using mts and mfs instructions respectively.
Stack Convention
The stack conventions used by MicroBlaze are detailed in Table 3-3. The shaded area in Table 3-3 denotes a part of the stack frame for a caller function, while the unshaded area indicates the callee frame function. The ABI conventions of the stack frame define the protocol for passing parameters, preserving non-volatile register values, and allocating space for the local variables in a function. Functions that contain calls to other subroutines are called as non-leaf functions. These non-leaf functions have to create a new stack frame area for its own use. When the program starts executing,
www.xilinx.com 1-800-255-7778
99
the stack pointer has the maximum value. As functions are called, the stack pointer is decremented by the number of words required by every function for its stack frame. The stack pointer of a caller function always has a higher value as compared to the callee function. Table 3-3: Stack Convention
High Address Function Parameters for called sub-routine (Arg n .. Arg1) (Optional: Maximum number of arguments required for any called procedure from the current procedure). Old Stack Pointer Link Register (R15) Callee Saved Register (R31....R19) (Optional: Only those registers which are used by the current procedure are saved) Local Variables for Current Procedure (Optional: Present only if Locals defined in the procedure) Functional Parameters (Arg n .. Arg 1) (Optional: Maximum number of arguments required for any called procedure from the current procedure) New Stack Pointer Low Address Consider an example where Func1 calls Func2, which in turn calls Func3. The stack representation at different instances is depicted in Figure 3-1. After the call from Func 1 to Func 2, the value of the stack pointer (SP) is decremented. This value of SP is again decremented to accommodate the stack frame for Func3. On return from Func 3 the value of the stack pointer is increased to its original value in the function, Func 2. Details of how the stack is maintained are shown in Figure 3-1. Link Register
Func 1
Func 1 Func 2 SP
Func 1 Func 2
SP
Stack Frame
X9584
100
www.xilinx.com 1-800-255-7778
Memory Model
Calling Convention
The caller function passes parameters to the callee function using either the registers (R5 through R10) or on its own stack frame. The callee uses the stack area of the caller to store the parameters passed to the callee. Refer to Figure 3-1. The parameters for Func 2 are stored either in the registers R5 through R10 or on the stack frame allocated for Func 1.
Memory Model
The memory model for MicroBlaze classifies the data into four different parts: Small Data Area, Data Area, Common Un-Initialized Area, and Literals or Constants.
Data Area
Comparatively large initialized variables are allocated to the data area, which can either be accessed using the read-write SDA anchor R13 or using the absolute address, depending on the command line option given to the compiler.
Literals or Constants
Constants are placed into the read-only small data area and are accessed using the read-only small data area anchor R2. The compiler generates appropriate global pointers to act as base pointers. The actual values of the SDA anchors are decided by the linker, in the final linking stages. For more information on the various sections of the memory please refer to the MicroBlaze Linker Script Sections chapter in the Embedded System Tools Reference Manual. The compiler generates appropriate sections, depending on the command line options. Please refer to the GNU Compiler Tools chapter in the Embedded System Tools Reference Manual for more information about these options.
www.xilinx.com 1-800-255-7778
101
The code expected at these locations is as shown below. For programs compiled without the -xlmode-xmdstub compiler option, the crt0.o initialization file is passed by the mb-gcc compiler to the mb-ld linker for linking. This file sets the appropriate addresses of the exception handlers. For programs compiled with the -xl-mode-xmdstub compiler option, the crt1.o initialization file is linked to the output program. This program has to be run with the xmdstub already loaded in the memory at address location 0x0. Hence at run-time, the initialization code in crt1.o writes the appropriate instructions to location 0x8 through 0x14 depending on the address of the exception and interrupt handlers. The following is code for passing control to Exception and Interrupt handlers:
0x00: 0x04: 0x08: 0x0c: 0x10: 0x14: 0x20: 0x24: bri nop imm bri imm bri imm bri _start1 high bits of address (user exception handler) _exception_handler high bits of address (interrupt handler) _interrupt_handler high bits of address (HW exception handler _hw_exception_handler
MicroBlaze allows exception and interrupt handler routines to be located at any address location addressable using 32 bits. The user exception handler code starts with the label _exception_handler, the hardware exception handler starts with _hw_exception_handler, while the interrupt handler code starts with the label _interrupt_handler. In the current MicroBlaze system, there are dummy routines for interrupt and exception handling, which you can change. In order to override these routines and link your interrupt and exception handlers, you must define the interrupt handler code with an attribute interrupt_handler. For more details about the use and syntax of the interrupt handler attribute, please refer to the GNU Compiler Tools chapter in the Embedded System Tools Reference Guide. When software breakpoints are used in the Xilinx Microprocessor Debug (XMD) tool, the Break (HW/SW) address location is reserved for handling the software breakpoint.
102
www.xilinx.com 1-800-255-7778
Chapter 4
Notation
The symbols used throughout this chapter are defined in Table 4-1. Table 4-1: Symbol Notation Meaning Add Subtract Multiply Bitwise logical AND Bitwise logical OR Bitwise logical XOR Bitwise logical complement of x Assignment Right shift Left shift Register x Bit i in register x Bits i through j in register x Equal comparison Not equal comparison Greater than comparison Greater than or equal comparison
> >=
www.xilinx.com 1-800-255-7778
103
Table 4-1:
Symbol Notation (Continued) Meaning Less than comparison Less than or equal comparison Sign-extend x Memory location at address x FSL interface x Least Significant Word of x Floating point: true if x is denormalized Floating point: true if x is + or - Floating point: true if x is + Floating point: true if x - Floating point: true if x is a quiet or signalling NaN Floating point: true if x is +0 or -0 Floating point: true if x is a quiet NaN Floating point: true if x is a signaling NaN Floating point: return +0 for x > 0, and -0 if x < 0 Floating point: return + for x > 0, and - if x < 0
Symbol < <= sext(x) Mem(x) FSLx LSW(x) isDnz(x) isInfinite(x) isPosInfinite(x) isNegInfinite(x) isNaN(x) isZero(x) isQuietNaN(x) isSigNaN(x) signZero(x) signInfinite(x)
Formats
MicroBlaze uses two instruction formats: Type A and Type B.
Type A
Type A is used for register-register instructions. It contains the opcode, one destination and two source registers.
Opcode 0
Source Reg B 1 6
0 2 1
0 3 1
104
www.xilinx.com 1-800-255-7778
Instructions
Type B
Type B is used for register-immediate instructions. It contains the opcode, one destination and one source registers, and a source 16-bit immediate value.
Opcode 0
Immediate Value 3 1
Instructions
This section provides descriptions of MicroBlaze instructions. Instructions are listed in alphabetical order. For each instruction Xilinx provides the mnemonic, encoding, a description, pseudocode of its semantics, and a list of registers that it modifies.
www.xilinx.com 1-800-255-7778
105
add
Arithmetic Add
Add Add with Carry Add and Keep Carry Add with Carry and Keep Carry
0 0 0 K C 0 0 6
rD 1 1
rA 1 6
rB
0 0 0 0 0 0 0 0 0 0 0 2 1 3 1
Description
The sum of the contents of registers rA and rB, is placed into register rD. Bit 3 of the instruction (labeled as K in the figure) is set to one for the mnemonic addk. Bit 4 of the instruction (labeled as C in the figure) is set to one for the mnemonic addc. Both bits are set to one for the mnemonic addkc. When an add instruction has bit 3 set (addk, addkc), the carry flag will Keep its previous value regardless of the outcome of the execution of the instruction. If bit 3 is cleared (add, addc), then the carry flag will be affected by the execution of the instruction. When bit 4 of the instruction is set to one (addc, addkc), the content of the carry flag (MSR[C]) affects the execution of the instruction. When bit 4 is cleared (add, addk), the content of the carry flag does not affect the execution of the instruction (providing a normal addition).
Pseudocode
if C = 0 then (rD) (rA) + (rB) else (rD) (rA) + (rB) + MSR[C] if K = 0 then MSR[C] CarryOut
Registers Altered
rD MSR[C]
Latency
1 cycle
Note
The C bit in the instruction opcode is not the same as the carry bit in the MSR. The add r0, r0, r0 (= 0x00000000) instruction is never used by the compiler and usually indicates uninitialized memory. If you are using illegal instruction exceptions you can trap these instructions by setting the MicroBlaze parameter C_OPCODE_0x0_ILLEGAL=1.
106
www.xilinx.com 1-800-255-7778
Instructions
addi
rD, rA, IMM rD, rA, IMM rD, rA, IMM rD, rA, IMM
Add Immediate Add Immediate with Carry Add Immediate and Keep Carry Add Immediate with Carry and Keep Carry
0 0 1 K C 0 0 6
rD 1 1
rA 1 6
IMM 3 1
Description
The sum of the contents of registers rA and the value in the IMM field, sign-extended to 32 bits, is placed into register rD. Bit 3 of the instruction (labeled as K in the figure) is set to one for the mnemonic addik. Bit 4 of the instruction (labeled as C in the figure) is set to one for the mnemonic addic. Both bits are set to one for the mnemonic addikc. When an addi instruction has bit 3 set (addik, addikc), the carry flag will keep its previous value regardless of the outcome of the execution of the instruction. If bit 3 is cleared (addi, addic), then the carry flag will be affected by the execution of the instruction. When bit 4 of the instruction is set to one (addic, addikc), the content of the carry flag (MSR[C]) affects the execution of the instruction. When bit 4 is cleared (addi, addik), the content of the carry flag does not affect the execution of the instruction (providing a normal addition).
Pseudocode
if C = 0 then (rD) (rA) + sext(IMM) else (rD) (rA) + sext(IMM) + MSR[C] if K = 0 then MSR[C] CarryOut
Registers Altered
rD MSR[C]
Latency
1 cycle
Notes
The C bit in the instruction opcode is not the same as the carry bit in the MSR. By default, Type B Instructions take the 16-bit IMM field value and sign extend it to 32 bits to use as the immediate operand. This behavior can be overridden by preceding the Type B instruction with an imm instruction. See the instruction imm, page 147 for details on using 32-bit immediate values.
www.xilinx.com 1-800-255-7778
107
and
Logical AND
and
rD, rA, rB
1 0 0 0 0 1 0 6
rD 1 1
rA 1 6
rB
0 0 0 0 0 0 0 0 0 0 0 2 1 3 1
Description
The contents of register rA are ANDed with the contents of register rB; the result is placed into register rD.
Pseudocode
(rD) (rA) (rB)
Registers Altered
rD
Latency
1 cycle
108
www.xilinx.com 1-800-255-7778
Instructions
andi
andi
1 0 1 0 0 1 0 6
rD 1 1
rA 1 6
IMM 3 1
Description
The contents of register rA are ANDed with the value of the IMM field, sign-extended to 32 bits; the result is placed into register rD.
Pseudocode
(rD) (rA) sext(IMM)
Registers Altered
rD
Latency
1 cycle
Note
By default, Type B Instructions will take the 16-bit IMM field value and sign extend it to 32 bits to use as the immediate operand. This behavior can be overridden by preceding the Type B instruction with an imm instruction. See the instruction imm, page 147 for details on using 32-bit immediate values.
www.xilinx.com 1-800-255-7778
109
andn
andn
rD, rA, rB
1 0 0 0 1 1 0 6
rD 1 1
rA 1 6
rB
0 0 0 0 0 0 0 0 0 0 0 2 1 3 1
Description
The contents of register rA are ANDed with the logical complement of the contents of register rB; the result is placed into register rD.
Pseudocode
(rD) (rA) (rB)
Registers Altered
rD
Latency
1 cycle
110
www.xilinx.com 1-800-255-7778
Instructions
andni
andni
1 0 1 0 1 1 0 6
rD 1 1
rA 1 6
IMM 3 1
Description
The IMM field is sign-extended to 32 bits. The contents of register rA are ANDed with the logical complement of the extended IMM field; the result is placed into register rD.
Pseudocode
(rD) (rA) (sext(IMM))
Registers Altered
rD
Latency
1 cycle
Note
By default, Type B Instructions will take the 16-bit IMM field value and sign extend it to 32 bits to use as the immediate operand. This behavior can be overridden by preceding the Type B instruction with an imm instruction. See the instruction imm, page 147 for details on using 32-bit immediate values.
www.xilinx.com 1-800-255-7778
111
beq
Branch if Equal
beq beqd
rA, rB rA, rB
1 0 0 1 1 1 D 0 0 0 0 0 6 1 1
rA 1 6
rB
0 0 0 0 0 0 0 0 0 0 0 2 1 3 1
Description
Branch if rA is equal to 0, to the instruction located in the offset value of rB. The target of the branch will be the instruction at address PC + rB. The mnemonic beqd will set the D bit. The D bit determines whether there is a branch delay slot or not. If the D bit is set, it means that there is a delay slot and the instruction following the branch (that is, in the branch delay slot) is allowed to complete execution before executing the target instruction. If the D bit is not set, it means that there is no delay slot, so the instruction to be executed after the branch is the target instruction.
Pseudocode
If rA = 0 then PC PC + rB else PC PC + 4 if D = 1 then allow following instruction to complete execution
Registers Altered
PC
Latency
1 cycle (if branch is not taken) 2 cycles (if branch is taken and the D bit is set) 3 cycles (if branch is taken and the D bit is not set)
Note
A delay slot must not be used by the following: imm, branch, or break instructions. Interrupts and external hardware breaks are deferred until after the delay slot branch has been completed.
112
www.xilinx.com 1-800-255-7778
Instructions
beqi
beqi beqid
1 0 1 1 1 1 D 0 0 0 0 0 6 1 1
rA 1 6
IMM 3 1
Description
Branch if rA is equal to 0, to the instruction located in the offset value of IMM. The target of the branch will be the instruction at address PC + IMM. The mnemonic beqid will set the D bit. The D bit determines whether there is a branch delay slot or not. If the D bit is set, it means that there is a delay slot and the instruction following the branch (that is, in the branch delay slot) is allowed to complete execution before executing the target instruction. If the D bit is not set, it means that there is no delay slot, so the instruction to be executed after the branch is the target instruction.
Pseudocode
If rA = 0 then PC PC + sext(IMM) else PC PC + 4 if D = 1 then allow following instruction to complete execution
Registers Altered
PC
Latency
1 cycle (if branch is not taken) 2 cycles (if branch is taken and the D bit is set) 3 cycles (if branch is taken and the D bit is not set)
Note
By default, Type B Instructions will take the 16-bit IMM field value and sign extend it to 32 bits to use as the immediate operand. This behavior can be overridden by preceding the Type B instruction with an imm instruction. See the instruction imm, page 147 for details on using 32-bit immediate values. A delay slot must not be used by the following: imm, branch, or break instructions. Interrupts and external hardware breaks are deferred until after the delay slot branch has been completed.
www.xilinx.com 1-800-255-7778
113
bge
bge bged
rA, rB rA, rB
1 0 0 1 1 1 D 0 1 0 1 0 6 1 1
rA 1 6
rB
0 0 0 0 0 0 0 0 0 0 0 2 1 3 1
Description
Branch if rA is greater or equal to 0, to the instruction located in the offset value of rB. The target of the branch will be the instruction at address PC + rB. The mnemonic bged will set the D bit. The D bit determines whether there is a branch delay slot or not. If the D bit is set, it means that there is a delay slot and the instruction following the branch (that is, in the branch delay slot) is allowed to complete execution before executing the target instruction. If the D bit is not set, it means that there is no delay slot, so the instruction to be executed after the branch is the target instruction.
Pseudocode
If rA >= 0 then PC PC + rB else PC PC + 4 if D = 1 then allow following instruction to complete execution
Registers Altered
PC
Latency
1 cycle (if branch is not taken) 2 cycles (if branch is taken and the D bit is set) 3 cycles (if branch is taken and the D bit is not set)
Note
A delay slot must not be used by the following: imm, branch, or break instructions. Interrupts and external hardware breaks are deferred until after the delay slot branch has been completed.
114
www.xilinx.com 1-800-255-7778
Instructions
bgei
bgei bgeid
Branch Immediate if Greater or Equal Branch Immediate if Greater or Equal with Delay
1 0 1 1 1 1 D 0 1 0 1 0 6 1 1
rA 1 6
IMM 3 1
Description
Branch if rA is greater or equal to 0, to the instruction located in the offset value of IMM. The target of the branch will be the instruction at address PC + IMM. The mnemonic bgeid will set the D bit. The D bit determines whether there is a branch delay slot or not. If the D bit is set, it means that there is a delay slot and the instruction following the branch (that is, in the branch delay slot) is allowed to complete execution before executing the target instruction. If the D bit is not set, it means that there is no delay slot, so the instruction to be executed after the branch is the target instruction.
Pseudocode
If rA >= 0 then PC PC + sext(IMM) else PC PC + 4 if D = 1 then allow following instruction to complete execution
Registers Altered
PC
Latency
1 cycle (if branch is not taken) 2 cycles (if branch is taken and the D bit is set) 3 cycles (if branch is taken and the D bit is not set)
Note
By default, Type B Instructions will take the 16-bit IMM field value and sign extend it to 32 bits to use as the immediate operand. This behavior can be overridden by preceding the Type B instruction with an imm instruction. See the instruction imm, page 147 for details on using 32-bit immediate values. A delay slot must not be used by the following: imm, branch, or break instructions. Interrupts and external hardware breaks are deferred until after the delay slot branch has been completed.
www.xilinx.com 1-800-255-7778
115
bgt
bgt bgtd
rA, rB rA, rB
1 0 0 1 1 1 D 0 1 0 0 0 6 1 1
rA 1 6
rB
0 0 0 0 0 0 0 0 0 0 0 2 1 3 1
Description
Branch if rA is greater than 0, to the instruction located in the offset value of rB. The target of the branch will be the instruction at address PC + rB. The mnemonic bgtd will set the D bit. The D bit determines whether there is a branch delay slot or not. If the D bit is set, it means that there is a delay slot and the instruction following the branch (that is, in the branch delay slot) is allowed to complete execution before executing the target instruction. If the D bit is not set, it means that there is no delay slot, so the instruction to be executed after the branch is the target instruction.
Pseudocode
If rA > 0 then PC PC + rB else PC PC + 4 if D = 1 then allow following instruction to complete execution
Registers Altered
PC
Latency
1 cycle (if branch is not taken) 2 cycles (if branch is taken and the D bit is set) 3 cycles (if branch is taken and the D bit is not set)
Note
A delay slot must not be used by the following: imm, branch, or break instructions. Interrupts and external hardware breaks are deferred until after the delay slot branch has been completed.
116
www.xilinx.com 1-800-255-7778
Instructions
bgti
bgti bgtid
Branch Immediate if Greater Than Branch Immediate if Greater Than with Delay
1 0 1 1 1 1 D 0 1 0 0 0 6 1 1
rA 1 6
IMM 3 1
Description
Branch if rA is greater than 0, to the instruction located in the offset value of IMM. The target of the branch will be the instruction at address PC + IMM. The mnemonic bgtid will set the D bit. The D bit determines whether there is a branch delay slot or not. If the D bit is set, it means that there is a delay slot and the instruction following the branch (that is, in the branch delay slot) is allowed to complete execution before executing the target instruction. If the D bit is not set, it means that there is no delay slot, so the instruction to be executed after the branch is the target instruction.
Pseudocode
If rA > 0 then PC PC + sext(IMM) else PC PC + 4 if D = 1 then allow following instruction to complete execution
Registers Altered
PC
Latency
1 cycle (if branch is not taken) 2 cycles (if branch is taken and the D bit is set) 3 cycles (if branch is taken and the D bit is not set)
Note
By default, Type B Instructions will take the 16-bit IMM field value and sign extend it to 32 bits to use as the immediate operand. This behavior can be overridden by preceding the Type B instruction with an imm instruction. See the instruction imm, page 147 for details on using 32-bit immediate values. A delay slot must not be used by the following: imm, branch, or break instructions. Interrupts and external hardware breaks are deferred until after the delay slot branch has been completed.
www.xilinx.com 1-800-255-7778
117
ble
ble bled
rA, rB rA, rB
1 0 0 1 1 1 D 0 0 1 1 0 6 1 1
rA 1 6
rB
0 0 0 0 0 0 0 0 0 0 0 2 1 3 1
Description
Branch if rA is less or equal to 0, to the instruction located in the offset value of rB. The target of the branch will be the instruction at address PC + rB. The mnemonic bled will set the D bit. The D bit determines whether there is a branch delay slot or not. If the D bit is set, it means that there is a delay slot and the instruction following the branch (that is, in the branch delay slot) is allowed to complete execution before executing the target instruction. If the D bit is not set, it means that there is no delay slot, so the instruction to be executed after the branch is the target instruction.
Pseudocode
If rA <= 0 then PC PC + rB else PC PC + 4 if D = 1 then allow following instruction to complete execution
Registers Altered
PC
Latency
1 cycle (if branch is not taken) 2 cycles (if branch is taken and the D bit is set) 3 cycles (if branch is taken and the D bit is not set)
Note
A delay slot must not be used by the following: imm, branch, or break instructions. Interrupts and external hardware breaks are deferred until after the delay slot branch has been completed.
118
www.xilinx.com 1-800-255-7778
Instructions
blei
blei bleid
Branch Immediate if Less or Equal Branch Immediate if Less or Equal with Delay
1 0 1 1 1 1 D 0 0 1 1 0 6 1 1
rA 1 6
IMM 3 1
Description
Branch if rA is less or equal to 0, to the instruction located in the offset value of IMM. The target of the branch will be the instruction at address PC + IMM. The mnemonic bleid will set the D bit. The D bit determines whether there is a branch delay slot or not. If the D bit is set, it means that there is a delay slot and the instruction following the branch (that is, in the branch delay slot) is allowed to complete execution before executing the target instruction. If the D bit is not set, it means that there is no delay slot, so the instruction to be executed after the branch is the target instruction.
Pseudocode
If rA <= 0 then PC PC + sext(IMM) else PC PC + 4 if D = 1 then allow following instruction to complete execution
Registers Altered
PC
Latency
1 cycle (if branch is not taken) 2 cycles (if branch is taken and the D bit is set) 3 cycles (if branch is taken and the D bit is not set)
Note
By default, Type B Instructions will take the 16-bit IMM field value and sign extend it to 32 bits to use as the immediate operand. This behavior can be overridden by preceding the Type B instruction with an imm instruction. See the instruction imm, page 147 for details on using 32-bit immediate values. A delay slot must not be used by the following: imm, branch, or break instructions. Interrupts and external hardware breaks are deferred until after the delay slot branch has been completed.
www.xilinx.com 1-800-255-7778
119
blt
blt bltd
rA, rB rA, rB
1 0 0 1 1 1 D 0 0 1 0 0 6 1 1
rA 1 6
rB
0 0 0 0 0 0 0 0 0 0 0 2 1 3 1
Description
Branch if rA is less than 0, to the instruction located in the offset value of rB. The target of the branch will be the instruction at address PC + rB. The mnemonic bltd will set the D bit. The D bit determines whether there is a branch delay slot or not. If the D bit is set, it means that there is a delay slot and the instruction following the branch (that is, in the branch delay slot) is allowed to complete execution before executing the target instruction. If the D bit is not set, it means that there is no delay slot, so the instruction to be executed after the branch is the target instruction.
Pseudocode
If rA < 0 then PC PC + rB else PC PC + 4 if D = 1 then allow following instruction to complete execution
Registers Altered
PC
Latency
1 cycle (if branch is not taken) 2 cycles (if branch is taken and the D bit is set) 3 cycles (if branch is taken and the D bit is not set)
Note
A delay slot must not be used by the following: imm, branch, or break instructions. Interrupts and external hardware breaks are deferred until after the delay slot branch has been completed.
120
www.xilinx.com 1-800-255-7778
Instructions
blti
blti bltid
Branch Immediate if Less Than Branch Immediate if Less Than with Delay
1 0 1 1 1 1 D 0 0 1 0 0 6 1 1
rA 1 6
IMM 3 1
Description
Branch if rA is less than 0, to the instruction located in the offset value of IMM. The target of the branch will be the instruction at address PC + IMM. The mnemonic bltid will set the D bit. The D bit determines whether there is a branch delay slot or not. If the D bit is set, it means that there is a delay slot and the instruction following the branch (that is, in the branch delay slot) is allowed to complete execution before executing the target instruction. If the D bit is not set, it means that there is no delay slot, so the instruction to be executed after the branch is the target instruction.
Pseudocode
If rA < 0 then PC PC + sext(IMM) else PC PC + 4 if D = 1 then allow following instruction to complete execution
Registers Altered
PC
Latency
1 cycle (if branch is not taken) 2 cycles (if branch is taken and the D bit is set) 3 cycles (if branch is taken and the D bit is not set)
Note
By default, Type B Instructions will take the 16-bit IMM field value and sign extend it to 32 bits to use as the immediate operand. This behavior can be overridden by preceding the Type B instruction with an imm instruction. See the instruction imm, page 147 for details on using 32-bit immediate values. A delay slot must not be used by the following: imm, branch, or break instructions. Interrupts and external hardware breaks are deferred until after the delay slot branch has been completed.
www.xilinx.com 1-800-255-7778
121
bne
bne bned
rA, rB rA, rB
1 0 0 1 1 1 D 0 0 0 1 0 6 1 1
rA 1 6
rB
0 0 0 0 0 0 0 0 0 0 0 2 1 3 1
Description
Branch if rA not equal to 0, to the instruction located in the offset value of rB. The target of the branch will be the instruction at address PC + rB. The mnemonic bned will set the D bit. The D bit determines whether there is a branch delay slot or not. If the D bit is set, it means that there is a delay slot and the instruction following the branch (that is, in the branch delay slot) is allowed to complete execution before executing the target instruction. If the D bit is not set, it means that there is no delay slot, so the instruction to be executed after the branch is the target instruction.
Pseudocode
If rA 0 then PC PC + rB else PC PC + 4 if D = 1 then allow following instruction to complete execution
Registers Altered
PC
Latency
1 cycle (if branch is not taken) 2 cycles (if branch is taken and the D bit is set) 3 cycles (if branch is taken and the D bit is not set)
Note
A delay slot must not be used by the following: imm, branch, or break instructions. Interrupts and external hardware breaks are deferred until after the delay slot branch has been completed.
122
www.xilinx.com 1-800-255-7778
Instructions
bnei
bnei bneid
Branch Immediate if Not Equal Branch Immediate if Not Equal with Delay
1 0 1 1 1 1 D 0 0 0 1 0 6 1 1
rA 1 6
IMM 3 1
Description
Branch if rA not equal to 0, to the instruction located in the offset value of IMM. The target of the branch will be the instruction at address PC + IMM. The mnemonic bneid will set the D bit. The D bit determines whether there is a branch delay slot or not. If the D bit is set, it means that there is a delay slot and the instruction following the branch (that is, in the branch delay slot) is allowed to complete execution before executing the target instruction. If the D bit is not set, it means that there is no delay slot, so the instruction to be executed after the branch is the target instruction.
Pseudocode
If rA 0 then PC PC + sext(IMM) else PC PC + 4 if D = 1 then allow following instruction to complete execution
Registers Altered
PC
Latency
1 cycle (if branch is not taken) 2 cycles (if branch is taken and the D bit is set) 3 cycles (if branch is taken and the D bit is not set)
Note
By default, Type B Instructions will take the 16-bit IMM field value and sign extend it to 32 bits to use as the immediate operand. This behavior can be overridden by preceding the Type B instruction with an imm instruction. See the instruction imm, page 147 for details on using 32-bit immediate values. A delay slot must not be used by the following: imm, branch, or break instructions. Interrupts and external hardware breaks are deferred until after the delay slot branch has been completed.
www.xilinx.com 1-800-255-7778
123
br
Unconditional Branch
rB rB rB rB rD, rB rD, rB D A L 0 0 1 1
Branch Branch Absolute Branch with Delay Branch Absolute with Delay Branch and Link with Delay Branch Absolute and Link with Delay rB 1 6 0 0 0 0 0 0 0 0 0 0 0 2 1 3 1
Description
Branch to the instruction located at address determined by rB. The mnemonics brld and brald will set the L bit. If the L bit is set, linking will be performed. The current value of PC will be stored in rD. The mnemonics bra, brad and brald will set the A bit. If the A bit is set, it means that the branch is to an absolute value and the target is the value in rB, otherwise, it is a relative branch and the target will be PC + rB. The mnemonics brd, brad, brld and brald will set the D bit. The D bit determines whether there is a branch delay slot or not. If the D bit is set, it means that there is a delay slot and the instruction following the branch (that is, in the branch delay slot) is allowed to complete execution before executing the target instruction. If the D bit is not set, it means that there is no delay slot, so the instruction to be executed after the branch is the target instruction.
Pseudocode
if L = 1 then (rD) PC if A = 1 then PC (rB) else PC PC + (rB) if D = 1 then allow following instruction to complete execution
Registers Altered
rD PC
Latency
2 cycles (if the D bit is set) 3 cycles (if the D bit is not set)
124
www.xilinx.com 1-800-255-7778
Instructions
Note
The instructions brl and bral are not available. A delay slot must not be used by the following: imm, branch, or break instructions. Interrupts and external hardware breaks are deferred until after the delay slot branch has been completed.
www.xilinx.com 1-800-255-7778
125
bri
Branch Immediate Branch Absolute Immediate Branch Immediate with Delay Branch Absolute Immediate with Delay Branch and Link Immediate with Delay Branch Absolute and Link Immediate with Delay
1 0 1 1 1 0 0 6
rD
D A L 0 0 1 1 1 6
IMM 3 1
Description
Branch to the instruction located at address determined by IMM, sign-extended to 32 bits. The mnemonics brlid and bralid will set the L bit. If the L bit is set, linking will be performed. The current value of PC will be stored in rD. The mnemonics brai, braid and bralid will set the A bit. If the A bit is set, it means that the branch is to an absolute value and the target is the value in IMM, otherwise, it is a relative branch and the target will be PC + IMM. The mnemonics brid, braid, brlid and bralid will set the D bit. The D bit determines whether there is a branch delay slot or not. If the D bit is set, it means that there is a delay slot and the instruction following the branch (that is, in the branch delay slot) is allowed to complete execution before executing the target instruction. If the D bit is not set, it means that there is no delay slot, so the instruction to be executed after the branch is the target instruction. As a special case, when MicroBlaze is configured to use an MMU (C_USE_MMU >= 1) and bralid rD, 0x8is used to perform a User Vector Exception, the Machine Status Register bits User Mode and Virtual Mode are cleared.
Pseudocode
if L = 1 then (rD) PC if A = 1 then PC (IMM) else PC PC + (IMM) if D = 1 then allow following instruction to complete execution if D = 1 and A = 1 and L = 1 and IMM = 0x8 then MSR[UMS] MSR[UM] MSR[VMS] MSR[VM] MSR[UM] 0 MSR[VM] 0
126
www.xilinx.com 1-800-255-7778
Instructions
Registers Altered
rD PC MSR[UM], MSR[VM]
Latency
2 cycles (if the D bit is set) 3 cycles (if the D bit is not set)
Notes
The instructions brli and brali are not available. By default, Type B Instructions will take the 16-bit IMM field value and sign extend it to 32 bits to use as the immediate operand. This behavior can be overridden by preceding the Type B instruction with an imm instruction. See the instruction imm, page 147 for details on using 32-bit immediate values. A delay slot must not be used by the following: imm, branch, or break instructions. Interrupts and external hardware breaks are deferred until after the delay slot branch has been completed.
www.xilinx.com 1-800-255-7778
127
brk
Break
brk
rD, rB
1 0 0 1 1 0 0 6
rD
0 1 1 0 0 1 1 1 6
rB
0 0 0 0 0 0 0 0 0 0 0 2 1 3 1
Description
Branch and link to the instruction located at address value in rB. The current value of PC will be stored in rD. The BIP flag in the MSR will be set. When MicroBlaze is configured to use an MMU (C_USE_MMU >= 1) this instruction is privileged. This means that if the instruction is attempted in User Mode (MSR[UM] = 1) a Privileged Instruction exception occurs.
Pseudocode
if MSR[UM] == 1 then ESR[EC] 00111 else (rD) PC PC (rB) MSR[BIP] 1
Registers Altered
rD PC MSR[BIP] ESR[EC], in case a privileged instruction exception is generated
Latency
3 cycles
128
www.xilinx.com 1-800-255-7778
Instructions
brki
Break Immediate
brki
rD, IMM
1 0 1 1 1 0 0 6
rD
0 1 1 0 0 1 1 1 6
IMM 3 1
Description
Branch and link to the instruction located at address value in IMM, sign-extended to 32 bits. The current value of PC will be stored in rD. The BIP flag in the MSR will be set. When MicroBlaze is configured to use an MMU (C_USE_MMU >= 1) this instruction is privileged, except as a special case when brki rD, 0x8 or brki rD, 0x18 is used to perform a Software Break. This means that, apart from the special case, if the instruction is attempted in User Mode (MSR[UM] = 1) a Privileged Instruction exception occurs. As a special case, when MicroBlaze is configured to use an MMU (C_USE_MMU >= 1) and brki rD, 0x8 or brki rD, 0x18 is used to perform a Software Break, the Machine Status Register bits User Mode and Virtual Mode are cleared.
Pseudocode
if MSR[UM] == 1 && IMM != 0x8 && IMM != 0x18 then ESR[EC] 00111 else (rD) PC PC sext(IMM) MSR[BIP] 1 if IMM = 0x8 || IMM = 0x18 then MSR[UMS] MSR[UM] MSR[VMS] MSR[VM] MSR[UM] 0 MSR[VM] 0
Registers Altered
rD, unless an exception is generated, in which case the register is unchanged PC MSR[BIP], MSR[UM], MSR[VM] ESR[EC], in case a privileged instruction exception is generated
Latency
3 cycles
Note
By default, Type B Instructions will take the 16-bit IMM field value and sign extend it to 32 bits to use as the immediate operand. This behavior can be overridden by preceding the Type B instruction with an imm instruction. See the instruction imm, page 147 for details on using 32-bit immediate values.
www.xilinx.com 1-800-255-7778
129
bs
Barrel Shift
Barrel Shift Right Logical Barrel Shift Right Arithmetical Barrel Shift Left Logical
0 1 0 0 0 1 0 6
rD 1 1
rA 1 6
rB
S T 0 0 0 0 0 0 0 0 0 2 1 3 1
Description
Shifts the contents of register rA by the amount specified in register rB and puts the result in register rD. The mnemonic bsll sets the S bit (Side bit). If the S bit is set, the barrel shift is done to the left. The mnemonics bsrl and bsra clear the S bit and the shift is done to the right. The mnemonic bsra will set the T bit (Type bit). If the T bit is set, the barrel shift performed is Arithmetical. The mnemonics bsrl and bsll clear the T bit and the shift performed is Logical.
Pseudocode
if S = 1 then (rD) (rA) << (rB)[27:31] else if T = 1 then if ((rB)[27:31]) 0 then (rD)[0:(rB)[27:31]-1] (rA)[0] (rD)[(rB)[27:31]:31] (rA) >> (rB)[27:31] else (rD) (rA) else (rD) (rA) >> (rB)[27:31]
Registers Altered
rD
Latency
1 cycle with C_AREA_OPTIMIZED=0 2 cycles with C_AREA_OPTIMIZED=1
Note
These instructions are optional. To use them, MicroBlaze has to be configured to use barrel shift instructions (C_USE_BARREL=1).
130
www.xilinx.com 1-800-255-7778
Instructions
bsi
Barrel Shift Right Logical Immediate Barrel Shift Right Arithmetical Immediate Barrel Shift Left Logical Immediate
0 1 1 0 0 1 0 6
rD 1 1
rA
0 0 0 0 0 S T 0 0 0 0 1 6 2 1 2 7
IMM 3 1
Description
Shifts the contents of register rA by the amount specified by IMM and puts the result in register rD. The mnemonic bsll sets the S bit (Side bit). If the S bit is set, the barrel shift is done to the left. The mnemonics bsrl and bsra clear the S bit and the shift is done to the right. The mnemonic bsra will set the T bit (Type bit). If the T bit is set, the barrel shift performed is Arithmetical. The mnemonics bsrl and bsll clear the T bit and the shift performed is Logical.
Pseudocode
if S = 1 then (rD) (rA) << IMM else if T = 1 then if IMM 0 then (rD)[0:IMM-1] (rA)[0] (rD)[IMM:31] (rA) >> IMM else (rD) (rA) else (rD) (rA) >> IMM
Registers Altered
rD
Latency
1 cycle with C_AREA_OPTIMIZED=0 2 cycles with C_AREA_OPTIMIZED=1
Notes
These are not Type B Instructions. There is no effect from a preceding imm instruction. These instructions are optional. To use them, MicroBlaze has to be configured to use barrel shift instructions (C_USE_BARREL=1).
www.xilinx.com 1-800-255-7778
131
cmp
Integer Compare
cmp cmpu
0 0 0 1 0 1 0 6
rD 1 1
rA 1 6
rB
0 0 0 0 0 0 0 0 0 U 1 2 1 3 1
Description
The contents of register rA is subtracted from the contents of register rB and the result is placed into register rD. The MSB bit of rD is adjusted to shown true relation between rA and rB. If the U bit is set, rA and rB is considered unsigned values. If the U bit is clear, rA and rB is considered signed values.
Pseudocode
(rD) (rB) + (rA) + 1 (rD)(MSB) (rA) > (rB)
Registers Altered
rD
Latency
1 cycle
132
www.xilinx.com 1-800-255-7778
Instructions
fadd
fadd
rD, rA, rB
Add
0 1 0 1 1 0 0 6
rD 11
rA 16
rB
0 0 0 0 0 0 0 0 0 0 0 21 31
Description
The floating point sum of registers rA and rB, is placed into register rD.
Pseudocode
if isDnz(rA) or isDnz(rB) then (rD) 0xFFC00000 FSR[DO] 1 ESR[EC] 00110 else if isSigNaN(rA) or isSigNaN(rB)or (isPosInfinite(rA) and isNegInfinite(rB)) or (isNegInfinite(rA) and isPosInfinite(rB))) then (rD) 0xFFC00000 FSR[IO] 1 ESR[EC] 00110 else if isQuietNaN(rA) or isQuietNaN(rB) then (rD) 0xFFC00000 else if isDnz((rA)+(rB)) then (rD) signZero((rA)+(rB)) FSR[UF] 1 ESR[EC] 00110 else if isNaN((rA)+(rB)) and then (rD) signInfinite((rA)+(rB)) FSR[OF] 1 ESR[EC] 00110 else (rD) (rA) + (rB)
Registers Altered
rD, unless an FP exception is generated, in which case the register is unchanged ESR[EC], if an FP exception is generated FSR[IO,UF,OF,DO]
Latency
4 cycles with C_AREA_OPTIMIZED=0 6 cycles with C_AREA_OPTIMIZED=1
Note
This instruction is only available when the MicroBlaze parameter C_USE_FPU is greater than 0.
www.xilinx.com 1-800-255-7778
133
frsub
frsub
rD, rA, rB
Reverse subtract
0 1 0 1 1 0 0 6
rD 11
rA 16
rB
0 0 0 1 0 0 0 0 0 0 0 21 31
Description
The floating point value in rA is subtracted from the floating point value in rB and the result is placed into register rD.
Pseudocode
if isDnz(rA) or isDnz(rB) then (rD) 0xFFC00000 FSR[DO] 1 ESR[EC] 00110 else if (isSigNaN(rA) or isSigNaN(rB) or (isPosInfinite(rA) and isPosInfinite(rB)) or (isNegInfinite(rA) and isNegInfinite(rB))) then (rD) 0xFFC00000 FSR[IO] 1 ESR[EC] 00110 else if isQuietNaN(rA) or isQuietNaN(rB) then (rD) 0xFFC00000 else if isDnz((rB)-(rA)) then (rD) signZero((rB)-(rA)) FSR[UF] 1 ESR[EC] 00110 else if isNaN((rB)-(rA)) and then (rD) signInfinite((rB)-(rA)) FSR[OF] 1 ESR[EC] 00110 else (rD) (rB) - (rA)
Registers Altered
rD, unless an FP exception is generated, in which case the register is unchanged ESR[EC], if an FP exception is generated FSR[IO,UF,OF,DO]
Latency
4 cycles with C_AREA_OPTIMIZED=0 6 cycles with C_AREA_OPTIMIZED=1
Note
This instruction is only available when the MicroBlaze parameter C_USE_FPU is greater than 0.
134
www.xilinx.com 1-800-255-7778
Instructions
fmul
fmul
rD, rA, rB
Multiply
0 1 0 1 1 0 0 6
rD 11
rA 16
rB
0 0 1 0 0 0 0 0 0 0 0 21 31
Description
The floating point value in rA is multiplied with the floating point value in rB and the result is placed into register rD.
Pseudocode
if isDnz(rA) or isDnz(rB) then (rD) 0xFFC00000 FSR[DO] 1 ESR[EC] 00110 else if isSigNaN(rA) or isSigNaN(rB) or (isZero(rA) and isInfinite(rB)) or (isZero(rB) and isInfinite(rA)) then (rD) 0xFFC00000 FSR[IO] 1 ESR[EC] 00110 else if isQuietNaN(rA) or isQuietNaN(rB) then (rD) 0xFFC00000 else if isDnz((rB)*(rA)) then (rD) signZero((rA)*(rB)) FSR[UF] 1 ESR[EC] 00110 else if isNaN((rB)*(rA)) and then (rD) signInfinite((rB)*(rA)) FSR[OF] 1 ESR[EC] 00110 else (rD) (rB) * (rA)
Registers Altered
rD, unless an FP exception is generated, in which case the register is unchanged ESR[EC], if an FP exception is generated FSR[IO,UF,OF,DO]
Latency
4 cycles with C_AREA_OPTIMIZED=0 6 cycles with C_AREA_OPTIMIZED=1
Note
This instruction is only available when the MicroBlaze parameter C_USE_FPU is greater than 0.
www.xilinx.com 1-800-255-7778
135
fdiv
fdiv
rD, rA, rB
Divide
0 1 0 1 1 0 0 6
rD 11
rA 16
rB
0 0 1 1 0 0 0 0 0 0 0 21 31
Description
The floating point value in rB is divided by the floating point value in rA and the result is placed into register rD.
Pseudocode
if isDnz(rA) or isDnz(rB) then (rD) 0xFFC00000 FSR[DO] 1 ESR[EC] 00110 else if isSigNaN(rA) or isSigNaN(rB) or (isZero(rA) and isZero(rB)) or (isInfinite(rA) and isInfinite(rB)) then (rD) 0xFFC00000 FSR[IO] 1 ESR[EC] 00110 else if isQuietNaN(rA) or isQuietNaN(rB) then (rD) 0xFFC00000 else if isZero(rA) and not isInfinite(rB) then (rD) signInfinite((rB)/(rA)) FSR[DZ] 1 ESR[EC] 00110 else if isDnz((rB)/(rA)) then (rD) signZero((rA)/(rB)) FSR[UF] 1 ESR[EC] 00110 else if isNaN((rB)/(rA)) and then (rD) signInfinite((rB)/(rA)) FSR[OF] 1 ESR[EC] 00110 else (rD) (rB) / (rA)
Registers Altered
rD, unless an FP exception is generated, in which case the register is unchanged ESR[EC], if an FP exception is generated FSR[IO,UF,OF,DO,DZ]
Latency
28 cycles with C_AREA_OPTIMIZED=0, 30 cycles with C_AREA_OPTIMIZED=1
Note
This instruction is only available when the MicroBlaze parameter C_USE_FPU is greater than 0.
136
www.xilinx.com 1-800-255-7778
Instructions
fcmp
rD, rA, rB rD, rA, rB rD, rA, rB rD, rA, rB rD, rA, rB rD, rA, rB rD, rA, rB
Unordered floating point comparison Less-than floating point comparison Equal floating point comparison Less-or-Equal floating point comparison Greater-than floating point comparison Not-Equal floating point comparison Greater-or-Equal floating point comparison
0 1 0 1 1 0 0 6
rD 11
rA 16
rB
0 1 0 0 21
OpSel 25
0 0 0 0 28 31
Description
The floating point value in rB is compared with the floating point value in rA and the comparison result is placed into register rD. The OpSel field in the instruction code determines the type of comparison performed.
Pseudocode
if isDnz(rA) or isDnz(rB) then (rD) 0 FSR[DO] 1 ESR[EC] 00110 else {read out behavior from Table 4-2}
Registers Altered
rD, unless an FP exception is generated, in which case the register is unchanged ESR[EC], if an FP exception is generated FSR[IO,DO]
Latency
1 cycle with C_AREA_OPTIMIZED=0 3 cycles with C_AREA_OPTIMIZED=1
Note
These instructions are only available when the MicroBlaze parameter C_USE_FPU is greater than 0. Table 4-2, page 138 lists the floating point comparison operations.
www.xilinx.com 1-800-255-7778
137
Table 4-2:
(rB) = (rA)
(rD) 0 (rD) 0
isNaN(rA) or isNaN(rB)
(rD) 1 (rD) 0 FSR[IO] 1 ESR[EC] 00110 (rD) 0 (rD) 0 FSR[IO] 1 ESR[EC] 00110 (rD) 0 FSR[IO] 1 ESR[EC] 00110
Equal Less-or-equal
010 011
(rD) 0 (rD) 0
(rD) 0 (rD) 1
(rD) 1 (rD) 1
Greater-than
100
(rD) 1
(rD) 0
(rD) 0
Not-equal Greater-or-equal
101 110
(rD) 1 (rD) 1
(rD) 1 (rD) 0
(rD) 0 (rD) 1
138
www.xilinx.com 1-800-255-7778
Instructions
flt
flt
rD, rA
0 1 0 1 1 0 0 6
rD 11
rA 16
0 1 0 1 0 0 0 0 0 0 0 21 31
Description
Converts the signed integer in register rA to floating point and puts the result in register rD. This is a 32-bit rounding signed conversion that will produce a 32-bit floating point result.
Pseudocode
(rD) float ((rA))
Registers Altered
rD
Latency
4 cycles with C_AREA_OPTIMIZED=0 6 cycles with C_AREA_OPTIMIZED=1
Note
This instruction is only available when the MicroBlaze parameter C_USE_FPU is set to 2.
www.xilinx.com 1-800-255-7778
139
fint
fint
rD, rA
0 1 0 1 1 0 0 6
rD 11
rA 16
0 1 1 0 0 0 0 0 0 0 0 21 31
Description
Converts the floating point number in register rA to a signed integer and puts the result in register rD. This is a 32-bit signed conversion that will produce a 32-bit integer result.
Pseudocode
if isDnz(rA) then (rD) 0xFFC00000 FSR[DO] 1 ESR[EC] 00110 else if isSigNaN(rA) then (rD) 0xFFC00000 FSR[IO] 1 ESR[EC] 00110 else if isQuietNaN(rA) then (rD) 0xFFC00000 else if isInf(rA) or (rA) < -231 or (rA) > 231 - 1 then (rD) 0xFFC00000 FSR[IO] 1 ESR[EC] 00110 else (rD) int ((rA))
Registers Altered
rD, unless an FP exception is generated, in which case the register is unchanged ESR[EC], if an FP exception is generated FSR[IO,UF,OF,DO]
Latency
5 cycles with C_AREA_OPTIMIZED=0 7 cycles with C_AREA_OPTIMIZED=1
Note
This instruction is only available when the MicroBlaze parameter C_USE_FPU is set to 2.
140
www.xilinx.com 1-800-255-7778
Instructions
fsqrt
fsqrt
rD, rA
Square Root
0 1 0 1 1 0 0 6
rD 11
rA 16
0 1 1 1 0 0 0 0 0 0 0 21 31
Description
Performs a floating point square root on the value in rA and puts the result in register rD.
Pseudocode
if isDnz(rA) then (rD) 0xFFC00000 FSR[DO] 1 ESR[EC] 00110 else if isSigNaN(rA) then (rD) 0xFFC00000 FSR[IO] 1 ESR[EC] 00110 else if isQuietNaN(rA) then (rD) 0xFFC00000 else if (rA) < 0 then (rD) 0xFFC00000 FSR[IO] 1 ESR[EC] 00110 else if (rA) = -0 then (rD) -0 else (rD) sqrt ((rA))
Registers Altered
rD, unless an FP exception is generated, in which case the register is unchanged ESR[EC], if an FP exception is generated FSR[IO,UF,OF,DO]
Latency
27 cycles with C_AREA_OPTIMIZED=0 29 cycles with C_AREA_OPTIMIZED=1
Note
This instruction is only available when the MicroBlaze parameter C_USE_FPU is set to 2.
www.xilinx.com 1-800-255-7778
141
get
tneaget
rD, FSLx
get data from FSL x t = test-only n = non-blocking e = exception if control bit set a = atomic get control from FSL x t = test-only n = non-blocking e = exception if control bit not set a = atomic
tnecaget
rD, FSLx
0 1 1 0 1 1 0 6
rD
0 0 0 0 0 0 n c 11 16
a e 0 0 0 0 0 0 28
FSLx 31
Description
MicroBlaze will read from the FSLx interface and place the result in register rD. The get instruction has 32 variants. The blocking versions (when n bit is 0) will stall microblaze until the data from the FSL interface is valid. The non-blocking versions will not stall microblaze and will set carry to 0 if the data was valid and to 1 if the data was invalid. In case of an invalid access the destination register contents is undefined. All data get instructions (when c bit is 0) expect the control bit from the FSL interface to be 0. If this is not the case, the instruction will set MSR[FSL_Error] to 1. All control get instructions (when c bit is 1) expect the control bit from the FSL interface to be 1. If this is not the case, the instruction will set MSR[FSL_Error] to 1. The exception versions (when e bit is 1) will generate an exception if there is a control bit mismatch. In this case ESR is updated with EC set to the exception cause and ESS set to the FSL index. The target register, rD, is not updated when an exception is generated, instead the FSL data is stored in EDR. The test versions (when t bit is 1) will be handled as the normal case, except that the read signal to the FSL link is not asserted. Atomic versions (when a bit is 1) are not interruptible. This means that a sequence of atomic FSL instructions can be grouped together without an interrupt breaking the program flow. However, note that exceptions may still occur. When MicroBlaze is configured to use an MMU (C_USE_MMU >= 1) these instructions are privileged. This means that if these instructions are attempted in User Mode (MSR[UM]=1) a Privileged Instruction exception occurs.
142
www.xilinx.com 1-800-255-7778
Instructions
Pseudocode
if MSR[UM] == 1 then ESR[EC] 00111 else (rD) FSLx if (n = 1) then MSR[Carry] not (FSLx Exists bit) if (FSLx Control bit c) then MSR[FSL_Error] 1 if (e = 1) then ESR[EC] 00000 ESR[ESS] instruction bits [28:31] EDR FSLx
Registers Altered
rD, unless an exception is generated, in which case the register is unchanged MSR[FSL_Error] MSR[Carry] ESR[EC], in case an FSL exception or a privileged instruction exception is generated ESR[ESS], in case an FSL exception is generated EDR, in case an FSL exception is generated
Latency
1 cycle with C_AREA_OPTIMIZED=0 2 cycles with C_AREA_OPTIMIZED=1
The blocking versions of this instruction will stall the pipeline of MicroBlaze until the instruction can be completed. Interrupts are served when the parameter C_USE_EXTENDED_FSL_INSTR is set to 1, and the instruction is not atomic.
Note
The blocking versions of this instruction should not be placed in a delay slot when the parameter C_USE_EXTENDED_FSL_INSTR is set to 1, since this prevents interrupts from being served. For non-blocking versions, an rsubc instruction can be used to decrement an index variable. The e bit does not have any effect unless C_FSL_EXCEPTION is set to 1. These instructions are only available when the MicroBlaze parameter C_FSL_LINKS is greater than 0. The extended instructions (exception, test and atomic versions) are only available when the MicroBlaze parameter C_USE_EXTENDED_FSL_INSTR is set to 1.
www.xilinx.com 1-800-255-7778
143
getd
tneagetd
rD, rB
get data from FSL rB[28:31] t = test-only n = non-blocking e = exception if control bit set a = atomic get control from FSL rB[28:31] t = test-only n = non-blocking e = exception if control bit not set a = atomic
tnecagetd
rD, rB
0 1 0 0 1 1 0 6
rD
0 0 0 0 0 11 16
rB
0 n c 21
a e 0 0 0 0 0 31
Description
MicroBlaze will read from the FSL interface defined by the four least significant bits in rB and place the result in register rD. The getd instruction has 32 variants. The blocking versions (when n bit is 0) will stall microblaze until the data from the FSL interface is valid. The non-blocking versions will not stall microblaze and will set carry to 0 if the data was valid and to 1 if the data was invalid. In case of an invalid access the destination register contents is undefined. All data get instructions (when c bit is 0) expect the control bit from the FSL interface to be 0. If this is not the case, the instruction will set MSR[FSL_Error] to 1. All control get instructions (when c bit is 1) expect the control bit from the FSL interface to be 1. If this is not the case, the instruction will set MSR[FSL_Error] to 1. The exception versions (when e bit is 1) will generate an exception if there is a control bit mismatch. In this case ESR is updated with EC set to the exception cause and ESS set to the FSL index. The target register, rD, is not updated when an exception is generated, instead the FSL data is stored in EDR. The test versions (when t bit is 1) will be handled as the normal case, except that the read signal to the FSL link is not asserted. Atomic versions (when a bit is 1) are not interruptible. This means that a sequence of atomic FSL instructions can be grouped together without an interrupt breaking the program flow. However, note that exceptions may still occur. When MicroBlaze is configured to use an MMU (C_USE_MMU >= 1) these instructions are privileged. This means that if these instructions are attempted in User Mode (MSR[UM] = 1) a Privileged Instruction exception occurs.
144
www.xilinx.com 1-800-255-7778
Instructions
Pseudocode
if MSR[UM] == 1 then ESR[EC] 00111 else (rD) (FSL rB[28:31]) if (n = 1) then MSR[Carry] not (FSL rB[28:31] Exists bit) if (FSL rB[28:31] Control bit c) then MSR[FSL_Error] 1 if (e = 1) then ESR[EC] 00000 ESR[ESS] rB[28:31] EDR (FSL rB[28:31])
Registers Altered
rD, unless an exception is generated, in which case the register is unchanged MSR[FSL_Error] MSR[Carry] ESR[EC], in case an FSL exception or a privileged instruction exception is generated ESR[ESS], in case an FSL exception is generated EDR, in case an FSL exception is generated
Latency
1 cycle with C_AREA_OPTIMIZED=0 2 cycles with C_AREA_OPTIMIZED=1
The blocking versions of this instruction will stall the pipeline of MicroBlaze until the instruction can be completed. Interrupts are served unless the instruction is atomic, which ensures that the instruction cannot be interrupted.
Note
The blocking versions of this instruction should not be placed in a delay slot, since this prevents interrupts from being served. For non-blocking versions, an rsubc instruction can be used to decrement an index variable. The e bit does not have any effect unless C_FSL_EXCEPTION is set to 1. These instructions are only available when the MicroBlaze parameter C_FSL_LINKS is greater than 0 and the parameter C_USE_EXTENDED_FSL_INSTR is set to 1.
www.xilinx.com 1-800-255-7778
145
idiv
Integer Divide
idiv idivu
0 1 0 0 1 0 0 6
rD 1 1
rA 1 6
rB
0 0 0 0 0 0 0 0 0 U 0 2 1 3 1
Description
The contents of register rB is divided by the contents of register rA and the result is placed into register rD. If the U bit is set, rA and rB is considered unsigned values. If the U bit is clear, rA and rB is considered signed values If the value of rA is 0, the divide_by_zero bit in MSR will be set and the value in rD will be 0, unless an exception is generated.
Pseudocode
if (rA) = 0 then (rD) <- 0 MSR[DZ] <- 1 ESR[EC] <- 00101 else (rD) (rB) / (rA)
Registers Altered
rD, unless Divide by zero exception is generated, in which case the register is unchanged MSR[Divide_By_Zero], if the value in rA is zero ESR[EC], if the value in rA is zero
Latency
1 cycle if (rA) = 0, otherwise 32 cycles with C_AREA_OPTIMIZED=0 1 cycle if (rA) = 0, otherwise 34 cycles with C_AREA_OPTIMIZED=1
Note
This instruction is only valid if MicroBlaze is configured to use a hardware divider (C_USE_DIV = 1).
146
www.xilinx.com 1-800-255-7778
Instructions
imm
Immediate
imm
IMM
1 0 1 1 0 0 0 0 0 0 0 0 0 0 0 0 0 6 1 1 1 6
IMM 3 1
Description
The instruction imm loads the IMM value into a temporary register. It also locks this value so it can be used by the following instruction and form a 32-bit immediate value. The instruction imm is used in conjunction with Type B instructions. Since Type B instructions have only a 16-bit immediate value field, a 32-bit immediate value cannot be used directly. However, 32bit immediate values can be used in MicroBlaze. By default, Type B Instructions will take the 16-bit IMM field value and sign extend it to 32 bits to use as the immediate operand. This behavior can be overridden by preceding the Type B instruction with an imm instruction. The imm instruction locks the 16-bit IMM value temporarily for the next instruction. A Type B instruction that immediately follows the imm instruction will then form a 32-bit immediate value from the 16-bit IMM value of the imm instruction (upper 16 bits) and its own 16-bit immediate value field (lower 16 bits). If no Type B instruction follows the imm instruction, the locked value gets unlocked and becomes useless.
Latency
1 cycle
Notes
The imm instruction and the Type B instruction following it are atomic; consequently, no interrupts are allowed between them. The assembler provided by Xilinx automatically detects the need for imm instructions. When a 32bit IMM value is specified in a Type B instruction, the assembler converts the IMM value to a 16bit one to assemble the instruction and inserts an imm instruction before it in the executable file.
www.xilinx.com 1-800-255-7778
147
lbu
lbu
rD, rA, rB
1 1 0 0 0 0 0 6
rD 11
rA 16
rB
0 0 0 0 0 0 0 0 0 0 0 21 31
Description
Loads a byte (8 bits) from the memory location that results from adding the contents of registers rA and rB. The data is placed in the least significant byte of register rD and the other three bytes in rD are cleared. A data TLB miss exception occurs if virtual protected mode is enabled, and a valid translation entry corresponding to the address is not found in the TLB. A data storage exception occurs if access is prevented by a no-access-allowed zone protection. This only applies to accesses with user mode and virtual protected mode enabled.
Pseudocode
Addr (rA) + (rB) if TLB_Miss(Addr) and MSR[VM] == 1 then ESR[EC] 10010;ESR[S] 0 MSR[UMS] MSR[UM]; MSR[VMS] MSR[VM]; MSR[UM] 0; MSR[VM] 0 else if Access_Protected(Addr) and MSR[UM] == 1 and MSR[VM] == 1 then ESR[EC] 10000;ESR[S] 0; ESR[DIZ] 1 MSR[UMS] MSR[UM]; MSR[VMS] MSR[VM]; MSR[UM] 0; MSR[VM] 0 else (rD)[24:31] Mem(Addr) (rD)[0:23] 0
Registers Altered
rD, unless an exception is generated, in which case the register is unchanged MSR[UM], MSR[VM], MSR[UMS], MSR[VMS], if an exception is generated ESR[EC], ESR[S], if an exception is generated ESR[DIZ], if a data storage exception is generated
Latency
1 cycle with C_AREA_OPTIMIZED=0 2 cycles with C_AREA_OPTIMIZED=1
148
www.xilinx.com 1-800-255-7778
Instructions
lbui
lbui
1 1 1 0 0 0 0 6
rD 11
rA 16
IMM 31
Description
Loads a byte (8 bits) from the memory location that results from adding the contents of register rA with the value in IMM, sign-extended to 32 bits. The data is placed in the least significant byte of register rD and the other three bytes in rD are cleared. A data TLB miss exception occurs if virtual protected mode is enabled, and a valid translation entry corresponding to the address is not found in the TLB. A data storage exception occurs if access is prevented by a no-access-allowed zone protection. This only applies to accesses with user mode and virtual protected mode enabled.
Pseudocode
Addr (rA) + sext(IMM) if TLB_Miss(Addr) and MSR[VM] == 1 then ESR[EC] 10010;ESR[S] 0 MSR[UMS] MSR[UM]; MSR[VMS] MSR[VM]; MSR[UM] 0; MSR[VM] 0 else if Access_Protected(Addr) and MSR[UM] == 1 and MSR[VM] == 1 then ESR[EC] 10000;ESR[S] 0; ESR[DIZ] 1 MSR[UMS] MSR[UM]; MSR[VMS] MSR[VM]; MSR[UM] 0; MSR[VM] 0 else (rD)[24:31] Mem(Addr) (rD)[0:23] 0
Registers Altered
rD, unless an exception is generated, in which case the register is unchanged MSR[UM], MSR[VM], MSR[UMS], MSR[VMS], if an exception is generated ESR[EC], ESR[S], if an exception is generated ESR[DIZ], if a data storage exception is generated
Latency
1 cycle with C_AREA_OPTIMIZED=0 2 cycles with C_AREA_OPTIMIZED=1
Note
By default, Type B Instructions will take the 16-bit IMM field value and sign extend it to 32 bits to use as the immediate operand. This behavior can be overridden by preceding the Type B instruction with an imm instruction. See the instruction imm, page 147 for details on using 32-bit immediate values.
www.xilinx.com 1-800-255-7778
149
lhu
lhu
rD, rA, rB
1 1 0 0 0 1 0 6
rD 11
rA 16
rB
0 0 0 0 0 0 0 0 0 0 0 21 31
Description
Loads a halfword (16 bits) from the halfword aligned memory location that results from adding the contents of registers rA and rB. The data is placed in the least significant halfword of register rD and the most significant halfword in rD is cleared. A data TLB miss exception occurs if virtual protected mode is enabled, and a valid translation entry corresponding to the address is not found in the TLB. A data storage exception occurs if access is prevented by a no-access-allowed zone protection. This only applies to accesses with user mode and virtual protected mode enabled. An unaligned data access exception occurs if the least significant bit in the address is not zero.
Pseudocode
Addr (rA) + (rB) if TLB_Miss(Addr) and MSR[VM] == 1 then ESR[EC] 10010;ESR[S] 0 MSR[UMS] MSR[UM]; MSR[VMS] MSR[VM]; MSR[UM] 0; MSR[VM] 0 else if Access_Protected(Addr) and MSR[UM] == 1 and MSR[VM] == 1 then ESR[EC] 10000;ESR[S] 0; ESR[DIZ] 1 MSR[UMS] MSR[UM]; MSR[VMS] MSR[VM]; MSR[UM] 0; MSR[VM] 0 else if Addr[31] != 0 then ESR[EC] 00001; ESR[W] 0; ESR[S] 0; ESR[Rx] rD else (rD)[16:31] Mem(Addr) (rD)[0:15] 0
Registers Altered
rD, unless an exception is generated, in which case the register is unchanged MSR[UM], MSR[VM], MSR[UMS], MSR[VMS], if a TLB miss exception or a data storage exception is generated ESR[EC], ESR[S], if an exception is generated ESR[DIZ], if a data storage exception is generated ESR[W], ESR[Rx], if an unaligned data access exception is generated
Latency
1 cycle with C_AREA_OPTIMIZED=0 2 cycles with C_AREA_OPTIMIZED=1
150
www.xilinx.com 1-800-255-7778
Instructions
lhui
1 1 1 0 0 1 0
lhui rD 6
Description
Loads a halfword (16 bits) from the halfword aligned memory location that results from adding the contents of register rA and the value in IMM, sign-extended to 32 bits. The data is placed in the least significant halfword of register rD and the most significant halfword in rD is cleared. A data TLB miss exception occurs if virtual protected mode is enabled, and a valid translation entry corresponding to the address is not found in the TLB. A data storage exception occurs if access is prevented by a no-access-allowed zone protection. This only applies to accesses with user mode and virtual protected mode enabled. An unaligned data access exception occurs if the least significant bit in the address is not zero.
Pseudocode
Addr (rA) + sext(IMM) if TLB_Miss(Addr) and MSR[VM] == 1 then ESR[EC] 10010;ESR[S] 0 MSR[UMS] MSR[UM]; MSR[VMS] MSR[VM]; MSR[UM] 0; MSR[VM] 0 else if Access_Protected(Addr) and MSR[UM] == 1 and MSR[VM] == 1 then ESR[EC] 10000;ESR[S] 0; ESR[DIZ] 1 MSR[UMS] MSR[UM]; MSR[VMS] MSR[VM]; MSR[UM] 0; MSR[VM] 0 else if Addr[31] != 0 then ESR[EC] 00001; ESR[W] 0; ESR[S] 0; ESR[Rx] rD else (rD)[16:31] Mem(Addr) (rD)[0:15] 0
Registers Altered
rD, unless an exception is generated, in which case the register is unchanged MSR[UM], MSR[VM], MSR[UMS], MSR[VMS], if a TLB miss exception or a data storage exception is generated ESR[EC], ESR[S], if an exception is generated ESR[DIZ], if a data storage exception is generated ESR[W], ESR[Rx], if an unaligned data access exception is generated
Latency
1 cycle with C_AREA_OPTIMIZED=0 2 cycles with C_AREA_OPTIMIZED=1
Note
By default, Type B Instructions will take the 16-bit IMM field value and sign extend it to 32 bits to use as the immediate operand. This behavior can be overridden by preceding the Type B instruction with an imm instruction. See the instruction imm, page 147 for details on using 32-bit immediate values.
www.xilinx.com 1-800-255-7778
151
lw
Load Word
lw
rD, rA, rB
1 1 0 0 1 0 0 6
rD 11
rA 16
rB
0 0 0 0 0 0 0 0 0 0 0 21 31
Description
Loads a word (32 bits) from the word aligned memory location that results from adding the contents of registers rA and rB. The data is placed in register rD. A data TLB miss exception occurs if virtual protected mode is enabled, and a valid translation entry corresponding to the address is not found in the TLB. A data storage exception occurs if access is prevented by a no-access-allowed zone protection. This only applies to accesses with user mode and virtual protected mode enabled. An unaligned data access exception occurs if the two least significant bits in the address are not zero.
Pseudocode
Addr (rA) + (rB) if TLB_Miss(Addr) and MSR[VM] == 1 then ESR[EC] 10010;ESR[S] 0 MSR[UMS] MSR[UM]; MSR[VMS] MSR[VM]; MSR[UM] 0; MSR[VM] 0 else if Access_Protected(Addr) and MSR[UM] == 1 and MSR[VM] == 1 then ESR[EC] 10000;ESR[S] 0; ESR[DIZ] 1 MSR[UMS] MSR[UM]; MSR[VMS] MSR[VM]; MSR[UM] 0; MSR[VM] 0 else if Addr[30:31] != 0 then ESR[EC] 00001; ESR[W] 1; ESR[S] 0; ESR[Rx] rD else (rD) Mem(Addr)
Registers Altered
rD, unless an exception is generated, in which case the register is unchanged MSR[UM], MSR[VM], MSR[UMS], MSR[VMS], if a TLB miss exception or a data storage exception is generated ESR[EC], ESR[S], if an exception is generated ESR[DIZ], if a data storage exception is generated ESR[W], ESR[Rx], if an unaligned data access exception is generated
Latency
1 cycle with C_AREA_OPTIMIZED=0 2 cycles with C_AREA_OPTIMIZED=1
152
www.xilinx.com 1-800-255-7778
Instructions
lwi
1 1 1 0 1 0 0
lwi rD 6
Description
Loads a word (32 bits) from the word aligned memory location that results from adding the contents of register rA and the value IMM, sign-extended to 32 bits. The data is placed in register rD. A data TLB miss exception occurs if virtual protected mode is enabled, and a valid translation entry corresponding to the address is not found in the TLB.A data storage exception occurs if access is prevented by a no-access-allowed zone protection. This only applies to accesses with user mode and virtual protected mode enabled. An unaligned data access exception occurs if the two least significant bits in the address are not zero.
Pseudocode
Addr (rA) + sext(IMM) if TLB_Miss(Addr) and MSR[VM] == 1 then ESR[EC] 10010;ESR[S] 0 MSR[UMS] MSR[UM]; MSR[VMS] MSR[VM]; MSR[UM] 0; MSR[VM] 0 else if Access_Protected(Addr) and MSR[UM] == 1 and MSR[VM] == 1 then ESR[EC] 10000;ESR[S] 0; ESR[DIZ] 1 MSR[UMS] MSR[UM]; MSR[VMS] MSR[VM]; MSR[UM] 0; MSR[VM] 0 else if Addr[30:31] != 0 then ESR[EC] 00001; ESR[W] 1; ESR[S] 0; ESR[Rx] rD else (rD) Mem(Addr)
Registers Altered
rD, unless an exception is generated, in which case the register is unchanged MSR[UM], MSR[VM], MSR[UMS], MSR[VMS], if a TLB miss exception or a data storage exception is generated ESR[EC], ESR[S], if an exception is generated ESR[DIZ], if a data storage exception is generated ESR[W], ESR[Rx], if an unaligned data access exception is generated
Latency
1 cycle with C_AREA_OPTIMIZED=0 2 cycles with C_AREA_OPTIMIZED=1
Note
By default, Type B Instructions will take the 16-bit IMM field value and sign extend it to 32 bits to use as the immediate operand. This behavior can be overridden by preceding the Type B instruction with an imm instruction. See the instruction imm, page 147 for details on using 32-bit immediate values.
www.xilinx.com 1-800-255-7778
153
mfs
mfs
rD, rS
1 0 0 1 0 1 0 6
rD
0 0 0 0 0 1 0 11 16 18
rS 31
Description
Copies the contents of the special purpose register rS into register rD. The special purpose registers TLBLO and TLBHI are used to copy the contents of the Unified TLB entry indexed by TLBX.
Pseudocode
switch (rS): case 0x0000 : (rD) PC case 0x0001 : (rD) MSR case 0x0003 : (rD) EAR case 0x0005 : (rD) ESR case 0x0007 : (rD) FSR case 0x000B : (rD) BTR case 0x000D : (rD) EDR case 0x1000 : (rD) PID case 0x1001 : (rD) ZPR case 0x1002 : (rD) TLBX case 0x1003 : (rD) TLBLO case 0x1004 : (rD) TLBHI case 0x200x : (rD) PVR[x] (where x = 0 to 11) default : (rD) Undefined
Registers Altered
rD
Latency
1 cycle
154
www.xilinx.com 1-800-255-7778
Instructions
Notes
To refer to special purpose registers in assembly language, use rpc for PC, rmsr for MSR, rear for EAR, resr for ESR, rfsr for FSR, rbtr for BTR, redr for EDR, rpid for PID, rzpr for ZPR, rtlblo for TLBLO, rtlbhi for TLBHI, rtlbx for TLBX, and rpvr0 - rpvr11 for PVR0 - PVR11. The value read from MSR may not include effects of the immediately preceding instruction (dependent on pipeline stall behavior). A NOP should be inserted before the MFS instruction to guarantee correct MSR value. EAR, ESR and BTR are only valid as operands when at least one of the MicroBlaze C_*_EXCEPTION parameters are set to 1. EDR is only valid as operand when the parameter C_FSL_EXCEPTION is set to 1 and the parameter C_FSL_LINKS is greater than 0. FSR is only valid as an operand when the C_USE_FPU parameter is greater than 0. PID, ZPR, TLBLO and TLBHI are only valid as operands when the parameter C_USE_MMU > 1 and the parameter C_MMU_TLB_ACCESS = 1 or 3. TLBX is only valid as operand when the parameter C_USE_MMU > 1 and the parameter C_MMU_TLB_ACCESS > 0. PVR0 is only valid as an operand when C_PVR is 1 or 2, and PVR1 - PVR11 are only valid as operands when C_PVR is set to 2.
www.xilinx.com 1-800-255-7778
155
msrclr
msrclr
rD, Imm
1 0 0 1 0 1 0 6
rD
0 0 0 0 1 0 11 16 17
Imm15 31
Description
Copies the contents of the special purpose register MSR into register rD. Bit positions in the IMM value that are 1 are cleared in the MSR. Bit positions that are 0 in the IMM value are left untouched. When MicroBlaze is configured to use an MMU (C_USE_MMU >= 1) this instruction is privileged for all IMM values except those only affecting C. This means that if the instruction is attempted in User Mode (MSR[UM] = 1) in this case a Privileged Instruction exception occurs.
Pseudocode
if MSR[UM] == 1 && IMM != 0x4 then ESR[EC] 00111 else (MSR) (rD) (MSR) (MSR) (IMM))
Registers Altered
rD MSR ESR[EC], in case a privileged instruction exception is generated
Latency
1 cycle
Note
MSRCLR will affect the Carry bit immediately while the remaining bits will take effect one cycle after the instruction has been executed. The immediate values has to be less than 215. Only bits 17 to 31 of the MSR can be cleared. This instruction is only available when the parameter C_USE_MSR_INSTR is set to 1. When clearing MSR[VM] the instruction must always be followed by a synchronizing branch instruction, for example BRI 4.
156
www.xilinx.com 1-800-255-7778
Instructions
msrset
msrset
rD, Imm
1 0 0 1 0 1 0 6
rD
0 0 0 0 0 0 11 16 17
Imm15 31
Description
Copies the contents of the special purpose register MSR into register rD. Bit positions in the IMM value that are 1 are set in the MSR. Bit positions that are 0 in the IMM value are left untouched. When MicroBlaze is configured to use an MMU (C_USE_MMU >= 1) this instruction is privileged for all IMM values except those only affecting C. This means that if the instruction is attempted in User Mode (MSR[UM] = 1) in this case a Privileged Instruction exception occurs.
Pseudocode
if MSR[UM] ESR[EC] else (rD) (MSR) == 1 && IMM != 0x4 then 00111 (MSR) (MSR) (IMM)
Registers Altered
rD MSR ESR[EC], in case a privileged instruction exception is generated
Latency
1 cycle
Note
MSRSET will affect the Carry bit immediately while the remaining bits will take effect one cycle after the instruction has been executed. The immediate values has to be less than 215. Only bits 17 to 31 of the MSR can be set. This instruction is only available when the parameter C_USE_MSR_INSTR is set to 1. When setting MSR[VM] the instruction must always be followed by a synchronizing branch instruction, for example BRI 4.
www.xilinx.com 1-800-255-7778
157
mts
mts 1 0 0 1 0 1 0 0 0 0 0 0 6
rS, rA rA 11 1 1 16 18 rS 31
Description
Copies the contents of register rD into the special purpose register rS. The special purpose registers TLBLO and TLBHI are used to copy to the Unified TLB entry indexed by TLBX. When MicroBlaze is configured to use an MMU (C_USE_MMU >= 1) this instruction is privileged. This means that if the instruction is attempted in User Mode (MSR[UM] = 1) a Privileged Instruction exception occurs.
Pseudocode
if MSR[UM] == 1 then ESR[EC] 00111 else switch (rS) case 0x0001 : MSR (rA) case 0x0007 : FSR (rA) case 0x1000 : PID (rA) case 0x1001 : ZPR (rA) case 0x1002 : TLBX (rA) case 0x1003 : TLBLO (rA) case 0x1004 : TLBHI (rA) case 0x1005 : TLBSX (rA)
Registers Altered
rS ESR[EC], in case a privileged instruction exception is generated
Latency
1 cycle
Notes
When writing MSR using MTS, the Carry bit takes effect immediately while the remaining bits take effect one cycle after the instruction has been executed. To refer to special purpose registers in assembly language, use rmsr for MSR, rfsr for FSR, rpid for PID, rzpr for ZPR, rtlblo for TLBLO, rtlbhi for TLBHI, rtlbx for TLBX, and rtlbsx for TLBSX. The PC, ESR, EAR, BTR, EDR and PVR0 - PVR11 cannot be written by the MTS instruction. The FSR is only valid as a destination if the MicroBlaze parameter C_USE_FPU is greater than 0. PID, ZPR and TLBSX are only valid as destinations when the parameter C_USE_MMU > 1 and the parameter C_MMU_TLB_ACCESS > 1. TLBLO, TLBHI and TLBX are only valid as destinations when the parameter C_USE_MMU > 1. When changing MSR[VM] or PID the instruction must always be followed by a synchronizing branch instruction, for example BRI 4.
158
www.xilinx.com 1-800-255-7778
Instructions
mul
Multiply
mul
rD, rA, rB
0 1 0 0 0 0 0 6
rD 1 1
rA 1 6
rB
0 0 0 0 0 0 0 0 0 0 0 2 1 3 1
Description
Multiplies the contents of registers rA and rB and puts the result in register rD. This is a 32-bit by 32-bit multiplication that will produce a 64-bit result. The least significant word of this value is placed in rD. The most significant word is discarded.
Pseudocode
(rD) LSW( (rA) (rB) )
Registers Altered
rD
Latency
1 cycle with C_AREA_OPTIMIZED=0 3 cycles with C_AREA_OPTIMIZED=1
Note
This instruction is only valid if the target architecture has multiplier primitives, and if present, the MicroBlaze parameter C_USE_HW_MUL is greater than 0.
www.xilinx.com 1-800-255-7778
159
mulh
Multiply High
mulh
rD, rA, rB
0 1 0 0 0 0 0 6
rD 1 1
rA 1 6
rB
0 0 0 0 0 0 0 0 0 0 1 2 1 3 1
Description
Multiplies the contents of registers rA and rB and puts the result in register rD. This is a 32-bit by 32-bit signed multiplication that will produce a 64-bit result. The most significant word of this value is placed in rD. The least significant word is discarded.
Pseudocode
(rD) MSW( (rA) (rB) ), signed
Registers Altered
rD
Latency
1 cycle with C_AREA_OPTIMIZED=0 3 cycles with C_AREA_OPTIMIZED=1
Note
This instruction is only valid if the target architecture has multiplier primitives, and if present, the MicroBlaze parameter C_USE_HW_MUL is set to 2. When MULH is used, bit 30 and 31 in the MUL instruction must be zero to distinguish between the two instructions. In previous versions of MicroBlaze, these bits were defined as zero, but the actual values were not relevant.
160
www.xilinx.com 1-800-255-7778
Instructions
mulhu
mulhu
rD, rA, rB
0 1 0 0 0 0 0 6
rD 1 1
rA 1 6
rB
0 0 0 0 0 0 0 0 0 1 1 2 1 3 1
Description
Multiplies the contents of registers rA and rB and puts the result in register rD. This is a 32-bit by 32-bit unsigned multiplication that will produce a 64-bit unsigned result. The most significant word of this value is placed in rD. The least significant word is discarded.
Pseudocode
(rD) MSW( (rA) (rB) ), unsigned
Registers Altered
rD
Latency
1 cycle with C_AREA_OPTIMIZED=0 3 cycles with C_AREA_OPTIMIZED=1
Note
This instruction is only valid if the target architecture has multiplier primitives, and if present, the MicroBlaze parameter C_USE_HW_MUL is set to 2. When MULHU is used, bit 30 and 31 in the MUL instruction must be zero to distinguish between the two instructions. In previous versions of MicroBlaze, these bits were defined as zero, but the actual values were not relevant.
www.xilinx.com 1-800-255-7778
161
mulhsu
mulhsu
rD, rA, rB
0 1 0 0 0 0 0 6
rD 1 1
rA 1 6
rB
0 0 0 0 0 0 0 0 0 1 0 2 1 3 1
Description
Multiplies the contents of registers rA and rB and puts the result in register rD. This is a 32-bit signed by 32-bit unsigned multiplication that will produce a 64-bit signed result. The most significant word of this value is placed in rD. The least significant word is discarded.
Pseudocode
(rD) MSW( (rA), signed (rB), unsigned ), signed
Registers Altered
rD
Latency
1 cycle with C_AREA_OPTIMIZED=0 3 cycles with C_AREA_OPTIMIZED=1
Note
This instruction is only valid if the target architecture has multiplier primitives, and if present, the MicroBlaze parameter C_USE_HW_MUL is set to 2. When MULHSU is used, bit 30 and 31 in the MUL instruction must be zero to distinguish between the two instructions. In previous versions of MicroBlaze, these bits were defined as zero, but the actual values were not relevant.
162
www.xilinx.com 1-800-255-7778
Instructions
muli
Multiply Immediate
muli
0 1 1 0 0 0 0 6
rD 1 1
rA 1 6
IMM 3 1
Description
Multiplies the contents of registers rA and the value IMM, sign-extended to 32 bits; and puts the result in register rD. This is a 32-bit by 32-bit multiplication that will produce a 64-bit result. The least significant word of this value is placed in rD. The most significant word is discarded.
Pseudocode
(rD) LSW( (rA) sext(IMM) )
Registers Altered
rD
Latency
1 cycle with C_AREA_OPTIMIZED=0 3 cycles with C_AREA_OPTIMIZED=1
Notes
By default, Type B Instructions will take the 16-bit IMM field value and sign extend it to 32 bits to use as the immediate operand. This behavior can be overridden by preceding the Type B instruction with an imm instruction. See the instruction imm, page 147 for details on using 32-bit immediate values. This instruction is only valid if the target architecture has multiplier primitives, and if present, the MicroBlaze parameter C_USE_HW_MUL is greater than 0.
www.xilinx.com 1-800-255-7778
163
or
Logical OR
or
rD, rA, rB
1 0 0 0 0 0 0 6
rD 1 1
rA 1 6
rB
0 0 0 0 0 0 0 0 0 0 0 2 1 3 1
Description
The contents of register rA are ORed with the contents of register rB; the result is placed into register rD.
Pseudocode
(rD) (rA) (rB)
Registers Altered
rD
Latency
1 cycle
164
www.xilinx.com 1-800-255-7778
Instructions
ori
ori
1 0 1 0 0 0 0 6
rD 1 1
rA 1 6
IMM 3 1
Description
The contents of register rA are ORed with the extended IMM field, sign-extended to 32 bits; the result is placed into register rD.
Pseudocode
(rD) (rA) (IMM)
Registers Altered
rD
Latency
1 cycle
Note
By default, Type B Instructions will take the 16-bit IMM field value and sign extend it to 32 bits to use as the immediate operand. This behavior can be overridden by preceding the Type B instruction with an imm instruction. See the instruction imm, page 147 for details on using 32-bit immediate values.
www.xilinx.com 1-800-255-7778
165
pcmpbf
pcmpbf
rD, rA, rB
1 0 0 0 0 0 0 6
rD 1 1
rA 1 6
rB
1 0 0 0 0 0 0 0 0 0 0 2 1 3 1
Description
The contents of register rA is bytewise compared with the contents in register rB. rD is loaded with the position of the first matching byte pair, starting with MSB as position 1, and comparing until LSB as position 4 If none of the byte pairs match, rD is set to 0
Pseudocode
if rB[0:7] = rA[0:7] then (rD) 1 else if rB[8:15] = rA[8:15] then (rD) 2 else if rB[16:23] = rA[16:23] then (rD) 3 else if rB[24:31] = rA[24:31] then (rD) 4 else (rD) 0
Registers Altered
rD
Latency
1 cycle
Note
This instruction is only available when the parameter C_USE_PCMP_INSTR is set to 1.
166
www.xilinx.com 1-800-255-7778
Instructions
pcmpeq
pcmpeq
rD, rA, rB
1 0 0 0 1 0 0 6
rD 1 1
rA 1 6
rB
1 0 0 0 0 0 0 0 0 0 0 2 1 3 1
Description
The contents of register rA is compared with the contents in register rB. rD is loaded with 1 if they match, and 0 if not
Pseudocode
if (rB) = (rA) then (rD) 1 else (rD) 0
Registers Altered
rD
Latency
1 cycle
Note
This instruction is only available when the parameter C_USE_PCMP_INSTR is set to 1.
www.xilinx.com 1-800-255-7778
167
pcmpne
pcmpne
rD, rA, rB
1 0 0 0 1 1 0 6
rD 1 1
rA 1 6
rB
1 0 0 0 0 0 0 0 0 0 0 2 1 3 1
Description
The contents of register rA is compared with the contents in register rB. rD is loaded with 0 if they match, and 1 if not
Pseudocode
if (rB) = (rA) then (rD) 0 else (rD) 1
Registers Altered
rD
Latency
1 cycle
Note
This instruction is only available when the parameter C_USE_PCMP_INSTR is set to 1.
168
www.xilinx.com 1-800-255-7778
Instructions
put
naput
rA, FSLx
put data to FSL x n = non-blocking a = atomic put data to FSL x test-only n = non-blocking a = atomic put control to FSL x n = non-blocking a = atomic put control to FSL x test-only n = non-blocking a = atomic
tnaput
FSLx
ncaput
rA, FSLx
tncaput
FSLx
0 1 1 0 1 1 0 0 0 0 0 0 6 11
rA
1 n c 16
a 0 0 0 0 0 0 0 28
FSLx 31
Description
MicroBlaze will write the value from register rA to the FSLx interface. The put instruction has 16 variants. The blocking versions (when n is 0) will stall MicroBlaze until there is space available in the FSL interface. The non-blocking versions will not stall MicroBlaze and will set carry to 0 if space was available and to 1 if no space was available. All data put instructions (when c is 0) will set the control bit to the FSL interface to 0 and all control put instructions (when c is 1) will set the control bit to 1. The test versions (when t bit is 1) will be handled as the normal case, except that the write signal to the FSL link is not asserted (thus no source register is required). Atomic versions (when a bit is 1) are not interruptible. This means that a sequence of atomic FSL instructions can be grouped together without an interrupt breaking the program flow. However, note that exceptions may still occur. When MicroBlaze is configured to use an MMU (C_USE_MMU >= 1) these instructions are privileged. This means that if these instructions are attempted in User Mode (MSR[UM] = 1) a Privileged Instruction exception occurs.
Pseudocode
if MSR[UM] == 1 then ESR[EC] 00111 else (FSLx) (rA) if (n = 1) then MSR[Carry] (FSLx Full bit) (FSLx Control bit) C
www.xilinx.com 1-800-255-7778
169
Registers Altered
MSR[Carry] ESR[EC], in case a privileged instruction exception is generated
Latency
1 cycle with C_AREA_OPTIMIZED=0 2 cycles with C_AREA_OPTIMIZED=1
The blocking versions of this instruction will stall the pipeline of MicroBlaze until the instruction can be completed. Interrupts are served when the parameter C_USE_EXTENDED_FSL_INSTR is set to 1, and the instruction is not atomic.
Note
The blocking versions of this instruction should not be placed in a delay slot when the parameter C_USE_EXTENDED_FSL_INSTR is set to 1, since this prevents interrupts from being served. These instructions are only available when the MicroBlaze parameter C_FSL_LINKS is greater than 0. The extended instructions (atomic versions) are only available when the MicroBlaze parameter C_USE_EXTENDED_FSL_INSTR is set to 1.
170
www.xilinx.com 1-800-255-7778
Instructions
putd
naputd
rA, rB
put data to FSL rB[28:31] n = non-blocking a = atomic put data to FSL rB[28:31] test-only n = non-blocking a = atomic put control to FSL rB[28:31] n = non-blocking a = atomic put control to FSL rB[28:31] test-only n = non-blocking a = atomic
tnaputd
rB
ncaputd
rA, rB
tncaputd
rB
0 1 0 0 1 1 0 0 0 0 0 0 6 11
rA 16
rB
1 n c 21
a 0 0 0 0 0 0 31
Description
MicroBlaze will write the value from register rA to the FSL interface defined by the four least significant bits in rB. The putd instruction has 16 variants. The blocking versions (when n is 0) will stall MicroBlaze until there is space available in the FSL interface. The non-blocking versions will not stall MicroBlaze and will set carry to 0 if space was available and to 1 if no space was available. All data putd instructions (when c is 0) will set the control bit to the FSL interface to 0 and all control putd instructions (when c is 1) will set the control bit to 1. The test versions (when t bit is 1) will be handled as the normal case, except that the write signal to the FSL link is not asserted (thus no source register is required). Atomic versions (when a bit is 1) are not interruptible. This means that a sequence of atomic FSL instructions can be grouped together without an interrupt breaking the program flow. However, note that exceptions may still occur. When MicroBlaze is configured to use an MMU (C_USE_MMU >= 1) these instructions are privileged. This means that if these instructions are attempted in User Mode (MSR[UM] = 1) a Privileged Instruction exception occurs.
Pseudocode
if MSR[UM] == 1 then ESR[EC] 00111 else (FSL rB[28:31]) (rA) if (n = 1) then MSR[Carry] (FSL rB[28:31] Full bit) (FSL rB[28:31] Control bit) C
www.xilinx.com 1-800-255-7778
171
Registers Altered
MSR[Carry] ESR[EC], in case a privileged instruction exception is generated
Latency
1 cycle with C_AREA_OPTIMIZED=0 2 cycles with C_AREA_OPTIMIZED=1
The blocking versions of this instruction will stall the pipeline of MicroBlaze until the instruction can be completed. Interrupts are served unless the instruction is atomic, which ensures that the instruction cannot be interrupted.
Note
The blocking versions of this instruction should not be placed in a delay slot, since this prevents interrupts from being served. These instructions are only available when the MicroBlaze parameter C_FSL_LINKS is greater than 0 and the parameter C_USE_EXTENDED_FSL_INSTR is set to 1.
172
www.xilinx.com 1-800-255-7778
Instructions
rsub
Subtract Subtract with Carry Subtract and Keep Carry Subtract with Carry and Keep Carry
0 0 0 K C 1 0 6
rD 1 1
rA 1 6
rB
0 0 0 0 0 0 0 0 0 0 0 2 1 3 1
Description
The contents of register rA is subtracted from the contents of register rB and the result is placed into register rD. Bit 3 of the instruction (labeled as K in the figure) is set to one for the mnemonic rsubk. Bit 4 of the instruction (labeled as C in the figure) is set to one for the mnemonic rsubc. Both bits are set to one for the mnemonic rsubkc. When an rsub instruction has bit 3 set (rsubk, rsubkc), the carry flag will Keep its previous value regardless of the outcome of the execution of the instruction. If bit 3 is cleared (rsub, rsubc), then the carry flag will be affected by the execution of the instruction. When bit 4 of the instruction is set to one (rsubc, rsubkc), the content of the carry flag (MSR[C]) affects the execution of the instruction. When bit 4 is cleared (rsub, rsubk), the content of the carry flag does not affect the execution of the instruction (providing a normal subtraction).
Pseudocode
if C = 0 then (rD) (rB) + (rA) + 1 else (rD) (rB) + (rA) + MSR[C] if K = 0 then MSR[C] CarryOut
Registers Altered
rD MSR[C]
Latency
1 cycle
Notes
In subtractions, Carry = (Borrow). When the Carry is set by a subtraction, it means that there is no Borrow, and when the Carry is cleared, it means that there is a Borrow.
www.xilinx.com 1-800-255-7778
173
rsubi
rD, rA, IMM rD, rA, IMM rD, rA, IMM rD, rA, IMM
Subtract Immediate Subtract Immediate with Carry Subtract Immediate and Keep Carry Subtract Immediate with Carry and Keep Carry
0 0 1 K C 1 0 6
rD 1 1
rA 1 6
IMM 3 1
Description
The contents of register rA is subtracted from the value of IMM, sign-extended to 32 bits, and the result is placed into register rD. Bit 3 of the instruction (labeled as K in the figure) is set to one for the mnemonic rsubik. Bit 4 of the instruction (labeled as C in the figure) is set to one for the mnemonic rsubic. Both bits are set to one for the mnemonic rsubikc. When an rsubi instruction has bit 3 set (rsubik, rsubikc), the carry flag will Keep its previous value regardless of the outcome of the execution of the instruction. If bit 3 is cleared (rsubi, rsubic), then the carry flag will be affected by the execution of the instruction. When bit 4 of the instruction is set to one (rsubic, rsubikc), the content of the carry flag (MSR[C]) affects the execution of the instruction. When bit 4 is cleared (rsubi, rsubik), the content of the carry flag does not affect the execution of the instruction (providing a normal subtraction).
Pseudocode
if C = 0 then (rD) sext(IMM) + (rA) + 1 else (rD) sext(IMM) + (rA) + MSR[C] if K = 0 then MSR[C] CarryOut
Registers Altered
rD MSR[C]
Latency
1 cycle
Notes
In subtractions, Carry = (Borrow). When the Carry is set by a subtraction, it means that there is no Borrow, and when the Carry is cleared, it means that there is a Borrow. By default, Type B Instructions will take the 16-bit IMM field value and sign extend it to 32 bits to use as the immediate operand. This behavior can be overridden by preceding the Type B instruction with an imm instruction. See the instruction imm, page 147 for details on using 32-bit immediate values.
174
www.xilinx.com 1-800-255-7778
Instructions
rtbd
rtbd
rA, IMM
1 0 1 1 0 1 1 0 0 1 0 0 6 11
rA 16
IMM 31
Description
Return from break will branch to the location specified by the contents of rA plus the IMM field, sign-extended to 32 bits. It will also enable breaks after execution by clearing the BIP flag in the MSR. This instruction always has a delay slot. The instruction following the RTBD is always executed before the branch target. That delay slot instruction has breaks disabled. When MicroBlaze is configured to use an MMU (C_USE_MMU >= 1) this instruction is privileged. This means that if the instruction is attempted in User Mode (MSR[UM] = 1) a Privileged Instruction exception occurs.
Pseudocode
if MSR[UM] == 1 then ESR[EC] 00111 else PC (rA) + sext(IMM) allow following instruction to complete execution MSR[BIP] 0 MSR[UM] MSR[UMS] MSR[VM] MSR[VMS]
Registers Altered
PC MSR[BIP], MSR[UM], MSR[VM] ESR[EC], in case a privileged instruction exception is generated
Latency
2 cycles
Note
Convention is to use general purpose register r16 as rA. A delay slot must not be used by the following: imm, branch, or break instructions. Interrupts and external hardware breaks are deferred until after the delay slot branch has been completed.
www.xilinx.com 1-800-255-7778
175
rtid
rtid
rA, IMM
1 0 1 1 0 1 1 0 0 0 1 0 6 11
rA 16
IMM 31
Description
Return from interrupt will branch to the location specified by the contents of rA plus the IMM field, sign-extended to 32 bits. It will also enable interrupts after execution. This instruction always has a delay slot. The instruction following the RTID is always executed before the branch target. That delay slot instruction has interrupts disabled. When MicroBlaze is configured to use an MMU (C_USE_MMU >= 1) this instruction is privileged. This means that if the instruction is attempted in User Mode (MSR[UM] = 1) a Privileged Instruction exception occurs.
Pseudocode
if MSR[UM] == 1 then ESR[EC] 00111 else PC (rA) + sext(IMM) allow following instruction to complete execution MSR[IE] 1 MSR[UM] MSR[UMS] MSR[VM] MSR[VMS]
Registers Altered
PC MSR[IE], MSR[UM], MSR[VM] ESR[EC], in case a privileged instruction exception is generated
Latency
2 cycles
Note
Convention is to use general purpose register r14 as rA. A delay slot must not be used by the following: imm, branch, or break instructions. Interrupts and external hardware breaks are deferred until after the delay slot branch has been completed.
176
www.xilinx.com 1-800-255-7778
Instructions
rted
rted
rA, IMM
1 0 1 1 0 1 1 0 1 0 0 0 6 11
rA 16
IMM 31
Description
Return from exception will branch to the location specified by the contents of rA plus the IMM field, sign-extended to 32 bits. The instruction will also enable exceptions after execution. This instruction always has a delay slot. The instruction following the RTED is always executed before the branch target. When MicroBlaze is configured to use an MMU (C_USE_MMU >= 1) this instruction is privileged. This means that if the instruction is attempted in User Mode (MSR[UM] = 1) a Privileged Instruction exception occurs.
Pseudocode
if MSR[UM] == 1 then ESR[EC] 00111 else PC (rA) + sext(IMM) allow following instruction to complete execution MSR[EE] 1 MSR[EIP] 0 MSR[UM] MSR[UMS] MSR[VM] MSR[VMS] ESR 0
Registers Altered
PC MSR[EE], MSR[EIP], MSR[UM], MSR[VM] ESR
Latency
2 cycles
Note
Convention is to use general purpose register r17 as rA. This instruction requires that one or more of the MicroBlaze parameters C_*_EXCEPTION are set to 1. A delay slot must not be used by the following: imm, branch, or break instructions. Interrupts and external hardware breaks are deferred until after the delay slot branch has been completed. Note: Code returning from an exception must first check if MSR[DS] is set, and in that case return
to the address in BTR.
www.xilinx.com 1-800-255-7778
177
rtsd
rtsd
rA, IMM
1 0 1 1 0 1 1 0 0 0 0 0 6 1 1
rA 1 6
IMM 3 1
Description
Return from subroutine will branch to the location specified by the contents of rA plus the IMM field, sign-extended to 32 bits. This instruction always has a delay slot. The instruction following the RTSD is always executed before the branch target.
Pseudocode
PC (rA) + sext(IMM) allow following instruction to complete execution
Registers Altered
PC
Latency
2 cycles
Note
Convention is to use general purpose register r15 as rA. A delay slot must not be used by the following: imm, branch, or break instructions. Interrupts and external hardware breaks are deferred until after the delay slot branch has been completed.
178
www.xilinx.com 1-800-255-7778
Instructions
sb
Store Byte
sb
rD, rA, rB
1 1 0 1 0 0 0 6
rD 11
rA 16
rB
0 0 0 0 0 0 0 0 0 0 0 21 31
Description
Stores the contents of the least significant byte of register rD, into the memory location that results from adding the contents of registers rA and rB. A data TLB miss exception occurs if virtual protected mode is enabled, and a valid translation entry corresponding to the address is not found in the TLB. A data storage exception occurs if virtual protected mode is enabled, and access is prevented by noaccess-allowed or read-only zone protection. No-access-allowed can only occur in user mode.
Pseudocode
Addr (rA) + (rB) if TLB_Miss(Addr) and MSR[VM] == 1 then ESR[EC] 10010;ESR[S] 1 MSR[UMS] MSR[UM]; MSR[VMS] MSR[VM]; MSR[UM] 0; MSR[VM] 0 else if Access_Protected(Addr) and MSR[VM] == 1 then ESR[EC] 10000;ESR[S] 1; ESR[DIZ] No-access-allowed MSR[UMS] MSR[UM]; MSR[VMS] MSR[VM]; MSR[UM] 0; MSR[VM] 0 else Mem(Addr) (rD)[24:31]
Registers Altered
rD, unless an exception is generated, in which case the register is unchanged MSR[UM], MSR[VM], MSR[UMS], MSR[VMS], if an exception is generated ESR[EC], ESR[S], if an exception is generated ESR[DIZ], if a data storage exception is generated
Latency
1 cycle with C_AREA_OPTIMIZED=0 2 cycles with C_AREA_OPTIMIZED=1
www.xilinx.com 1-800-255-7778
179
sbi
sbi
1 1 1 1 0 0 0 6
rD 11
rA 16
IMM 31
Description
Stores the contents of the least significant byte of register rD, into the memory location that results from adding the contents of register rA and the value IMM, sign-extended to 32 bits. A data TLB miss exception occurs if virtual protected mode is enabled, and a valid translation entry corresponding to the address is not found in the TLB. A data storage exception occurs if virtual protected mode is enabled, and access is prevented by noaccess-allowed or read-only zone protection. No-access-allowed can only occur in user mode.
Pseudocode
Addr (rA) + sext(IMM) if TLB_Miss(Addr) and MSR[VM] == 1 then ESR[EC] 10010;ESR[S] 1 MSR[UMS] MSR[UM]; MSR[VMS] MSR[VM]; MSR[UM] 0; MSR[VM] 0 else if Access_Protected(Addr) and MSR[VM] == 1 then ESR[EC] 10000;ESR[S] 1; ESR[DIZ] No-access-allowed MSR[UMS] MSR[UM]; MSR[VMS] MSR[VM]; MSR[UM] 0; MSR[VM] 0 else Mem(Addr) (rD)[24:31]
Registers Altered
rD, unless an exception is generated, in which case the register is unchanged MSR[UM], MSR[VM], MSR[UMS], MSR[VMS], if an exception is generated ESR[EC], ESR[S], if an exception is generated ESR[DIZ], if a data storage exception is generated
Latency
1 cycle with C_AREA_OPTIMIZED=0 2 cycles with C_AREA_OPTIMIZED=1
Note
By default, Type B Instructions will take the 16-bit IMM field value and sign extend it to 32 bits to use as the immediate operand. This behavior can be overridden by preceding the Type B instruction with an imm instruction. See the instruction imm, page 147 for details on using 32-bit immediate values.
180
www.xilinx.com 1-800-255-7778
Instructions
sext16
sext16
rD, rA
1 0 0 1 0 0 0 6
rD 1 1
rA
0 0 0 0 0 0 0 0 0 1 1 0 0 0 0 1 1 6 3 1
Description
This instruction sign-extends a halfword (16 bits) into a word (32 bits). Bit 16 in rA will be copied into bits 0-15 of rD. Bits 16-31 in rA will be copied into bits 16-31 of rD.
Pseudocode
(rD)[0:15] (rA)[16] (rD)[16:31] (rA)[16:31]
Registers Altered
rD
Latency
1 cycle
www.xilinx.com 1-800-255-7778
181
sext8
sext8
rD, rA
1 0 0 1 0 0 0 6
rD 1 1
rA
0 0 0 0 0 0 0 0 0 1 1 0 0 0 0 0 1 6 3 1
Description
This instruction sign-extends a byte (8 bits) into a word (32 bits). Bit 24 in rA will be copied into bits 0-23 of rD. Bits 24-31 in rA will be copied into bits 24-31 of rD.
Pseudocode
(rD)[0:23] (rA)[24] (rD)[24:31] (rA)[24:31]
Registers Altered
rD
Latency
1 cycle
182
www.xilinx.com 1-800-255-7778
Instructions
sh
Store Halfword
sh
rD, rA, rB
1 1 0 1 0 1 0 6
rD 11
rA 16
rB
0 0 0 0 0 0 0 0 0 0 0 21 31
Description
Stores the contents of the least significant halfword of register rD, into the halfword aligned memory location that results from adding the contents of registers rA and rB. A data TLB miss exception occurs if virtual protected mode is enabled, and a valid translation entry corresponding to the address is not found in the TLB. A data storage exception occurs if virtual protected mode is enabled, and access is prevented by noaccess-allowed or read-only zone protection. No-access-allowed can only occur in user mode. An unaligned data access exception occurs if the least significant bit in the address is not zero.
Pseudocode
Addr (rA) + (rB) if TLB_Miss(Addr) and MSR[VM] == 1 then ESR[EC] 10010;ESR[S] 1 MSR[UMS] MSR[UM]; MSR[VMS] MSR[VM]; MSR[UM] 0; MSR[VM] 0 else if Access_Protected(Addr) and MSR[VM] == 1 then ESR[EC] 10000;ESR[S] 1; ESR[DIZ] No-access-allowed MSR[UMS] MSR[UM]; MSR[VMS] MSR[VM]; MSR[UM] 0; MSR[VM] 0 else if Addr[31] != 0 then ESR[EC] 00001; ESR[W] 0; ESR[S] 1; ESR[Rx] rD else Mem(Addr) (rD)[16:31]
Registers Altered
rD, unless an exception is generated, in which case the register is unchanged MSR[UM], MSR[VM], MSR[UMS], MSR[VMS], if a TLB miss exception or a data storage exception is generated ESR[EC], ESR[S], if an exception is generated ESR[DIZ], if a data storage exception is generated ESR[W], ESR[Rx], if an unaligned data access exception is generated
Latency
1 cycle with C_AREA_OPTIMIZED=0 2 cycles with C_AREA_OPTIMIZED=1
www.xilinx.com 1-800-255-7778
183
shi
1 1 1 1 0 1 0
shi rD 6
Description
Stores the contents of the least significant halfword of register rD, into the halfword aligned memory location that results from adding the contents of register rA and the value IMM, sign-extended to 32 bits. A data TLB miss exception occurs if virtual protected mode is enabled, and a valid translation entry corresponding to the address is not found in the TLB. A data storage exception occurs if virtual protected mode is enabled, and access is prevented by no-access-allowed or read-only zone protection. No-access-allowed can only occur in user mode. An unaligned data access exception occurs if the least significant bit in the address is not zero.
Pseudocode
Addr (rA) + sext(IMM) if TLB_Miss(Addr) and MSR[VM] == 1 then ESR[EC] 10010;ESR[S] 1 MSR[UMS] MSR[UM]; MSR[VMS] MSR[VM]; MSR[UM] 0; MSR[VM] 0 else if Access_Protected(Addr) and MSR[VM] == 1 then ESR[EC] 10000;ESR[S] 1; ESR[DIZ] No-access-allowed MSR[UMS] MSR[UM]; MSR[VMS] MSR[VM]; MSR[UM] 0; MSR[VM] 0 else if Addr[31] != 0 then ESR[EC] 00001; ESR[W] 0; ESR[S] 1; ESR[Rx] rD else Mem(Addr) (rD)[16:31]
Registers Altered
rD, unless an exception is generated, in which case the register is unchanged MSR[UM], MSR[VM], MSR[UMS], MSR[VMS], if a TLB miss exception or a data storage exception is generated ESR[EC], ESR[S], if an exception is generated ESR[DIZ], if a data storage exception is generated ESR[W], ESR[Rx], if an unaligned data access exception is generated
Latency
1 cycle with C_AREA_OPTIMIZED=0 2 cycles with C_AREA_OPTIMIZED=1
Note
By default, Type B Instructions will take the 16-bit IMM field value and sign extend it to 32 bits to use as the immediate operand. This behavior can be overridden by preceding the Type B instruction with an imm instruction. See the instruction imm, page 147 for details on using 32-bit immediate values.
184
www.xilinx.com 1-800-255-7778
Instructions
sra
sra
rD, rA
1 0 0 1 0 0 0 6
rD 1 1
rA
0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 1 6 3 1
Description
Shifts arithmetically the contents of register rA, one bit to the right, and places the result in rD. The most significant bit of rA (that is, the sign bit) placed in the most significant bit of rD. The least significant bit coming out of the shift chain is placed in the Carry flag.
Pseudocode
(rD)[0] (rA)[0] (rD)[1:31] (rA)[0:30] MSR[C] (rA)[31]
Registers Altered
rD MSR[C]
Latency
1 cycle
www.xilinx.com 1-800-255-7778
185
src
src
rD, rA
1 0 0 1 0 0 0 6
rD 1 1
rA
0 0 0 0 0 0 0 0 0 0 1 0 0 0 0 1 1 6 3 1
Description
Shifts the contents of register rA, one bit to the right, and places the result in rD. The Carry flag is shifted in the shift chain and placed in the most significant bit of rD. The least significant bit coming out of the shift chain is placed in the Carry flag.
Pseudocode
(rD)[0] MSR[C] (rD)[1:31] (rA)[0:30] MSR[C] (rA)[31]
Registers Altered
rD MSR[C]
Latency
1 cycle
186
www.xilinx.com 1-800-255-7778
Instructions
srl
srl
rD, rA
1 0 0 1 0 0 0 6
rD 1 1
rA
0 0 0 0 0 0 0 0 0 1 0 0 0 0 0 1 1 6 3 1
Description
Shifts logically the contents of register rA, one bit to the right, and places the result in rD. A zero is shifted in the shift chain and placed in the most significant bit of rD. The least significant bit coming out of the shift chain is placed in the Carry flag.
Pseudocode
(rD)[0] 0 (rD)[1:31] (rA)[0:30] MSR[C] (rA)[31]
Registers Altered
rD MSR[C]
Latency
1 cycle
www.xilinx.com 1-800-255-7778
187
sw
Store Word
sw
rD, rA, rB
1 1 0 1 1 0 0 6
rD 11
rA 16
rB
0 0 0 0 0 0 0 0 0 0 0 21 31
Description
Stores the contents of register rD, into the word aligned memory location that results from adding the contents of registers rA and rB. A data TLB miss exception occurs if virtual protected mode is enabled, and a valid translation entry corresponding to the address is not found in the TLB. A data storage exception occurs if virtual protected mode is enabled, and access is prevented by noaccess-allowed or read-only zone protection. No-access-allowed can only occur in user mode. An unaligned data access exception occurs if the two least significant bits in the address are not zero.
Pseudocode
Addr (rA) + (rB) if TLB_Miss(Addr) and MSR[VM] == 1 then ESR[EC] 10010;ESR[S] 1 MSR[UMS] MSR[UM]; MSR[VMS] MSR[VM]; MSR[UM] 0; MSR[VM] 0 else if Access_Protected(Addr) and MSR[VM] == 1 then ESR[EC] 10000;ESR[S] 1; ESR[DIZ] No-access-allowed MSR[UMS] MSR[UM]; MSR[VMS] MSR[VM]; MSR[UM] 0; MSR[VM] 0 else if Addr[30:31] != 0 then ESR[EC] 00001; ESR[W] 1; ESR[S] 1; ESR[Rx] rD else Mem(Addr) (rD)[0:31]
Registers Altered
rD, unless an exception is generated, in which case the register is unchanged MSR[UM], MSR[VM], MSR[UMS], MSR[VMS], if a TLB miss exception or a data storage exception is generated ESR[EC], ESR[S], if an exception is generated ESR[DIZ], if a data storage exception is generated ESR[W], ESR[Rx], if an unaligned data access exception is generated
Latency
1 cycle with C_AREA_OPTIMIZED=0 2 cycles with C_AREA_OPTIMIZED=1
188
www.xilinx.com 1-800-255-7778
Instructions
swi
1 1 1 1 1 0 0
swi rD 6
Description
Stores the contents of register rD, into the word aligned memory location that results from adding the contents of registers rA and the value IMM, sign-extended to 32 bits. A data TLB miss exception occurs if virtual protected mode is enabled, and a valid translation entry corresponding to the address is not found in the TLB. A data storage exception occurs if virtual protected mode is enabled, and access is prevented by noaccess-allowed or read-only zone protection. No-access-allowed can only occur in user mode. An unaligned data access exception occurs if the two least significant bits in the address are not zero.
Pseudocode
Addr (rA) + sext(IMM) if TLB_Miss(Addr) and MSR[VM] == 1 then ESR[EC] 10010;ESR[S] 1 MSR[UMS] MSR[UM]; MSR[VMS] MSR[VM]; MSR[UM] 0; MSR[VM] 0 else if Access_Protected(Addr) and MSR[VM] == 1 then ESR[EC] 10000;ESR[S] 1; ESR[DIZ] No-access-allowed MSR[UMS] MSR[UM]; MSR[VMS] MSR[VM]; MSR[UM] 0; MSR[VM] 0 else if Addr[30:31] != 0 then ESR[EC] 00001; ESR[W] 1; ESR[S] 1; ESR[Rx] rD else Mem(Addr) (rD)[0:31]
Register Altered
rD, unless an exception is generated, in which case the register is unchanged MSR[UM], MSR[VM], MSR[UMS], MSR[VMS], if a TLB miss exception or a data storage exception is generated ESR[EC], ESR[S], if an exception is generated ESR[DIZ], if a data storage exception is generated ESR[W], ESR[Rx], if an unaligned data access exception is generated
Latency
1 cycle with C_AREA_OPTIMIZED=0 2 cycles with C_AREA_OPTIMIZED=1
Note
By default, Type B Instructions will take the 16-bit IMM field value and sign extend it to 32 bits to use as the immediate operand. This behavior can be overridden by preceding the Type B instruction with an imm instruction. See the instruction imm, page 147 for details on using 32-bit immediate values.
www.xilinx.com 1-800-255-7778
189
wdc
wdc
rA,rB
1 0 0 1 0 0 0 0 0 0 0 0 6 1 1
rA 1 6
rB
0 0 0 0 1 1 0 0 1 0 0 3 1
Description
Write into the data cache tag to invalidate a cache line. The register rB value is not used. Register rA contains the address of the affected cache line. The WDC instruction should only be used when the data cache is disabled (that is, MSR[DCE]=0). When MicroBlaze is configured to use an MMU (C_USE_MMU >= 1) this instruction is privileged. This means that if the instruction is attempted in User Mode (MSR[UM] = 1) a Privileged Instruction exception occurs.
Pseudocode
if MSR[UM] == 1 then ESR[EC] 00111 else if C_DCACHE_LINE_LEN (DCache Line)[(Ra) if C_DCACHE_LINE_LEN (DCache Line)[(Ra)
Registers Altered
ESR[EC], in case a privileged instruction exception is generated
Latency
1 cycle
190
www.xilinx.com 1-800-255-7778
Instructions
wic
wic
rA,rB
1 0 0 1 0 0 0 0 0 0 0 0 6 1 1
rA 1 6
rB
0 0 0 0 1 1 0 1 0 0 0 3 1
Description
Write into the instruction cache tag to invalidate a cache line. The register rB value is not used. Register rA contains the address of the affected cache line. The WIC instruction should only be used when the instruction cache is disabled (that is, MSR[ICE]=0). When MicroBlaze is configured to use an MMU (C_USE_MMU >= 1) this instruction is privileged. This means that if the instruction is attempted in User Mode (MSR[UM] = 1) a Privileged Instruction exception occurs.
Pseudocode
if MSR[UM] == 1 then ESR[EC] 00111 else if C_ICACHE_LINE_LEN (ICache Line)[(Ra) if C_ICACHE_LINE_LEN (ICache Line)[(Ra)
Registers Altered
ESR[EC], in case a privileged instruction exception is generated
Latency
1 cycle
www.xilinx.com 1-800-255-7778
191
xor
Logical Exclusive OR
xor
rD, rA, rB
1 0 0 0 1 0 0 6
rD 1 1
rA 1 6
rB
0 0 0 0 0 0 0 0 0 0 0 2 1 3 1
Description
The contents of register rA are XORed with the contents of register rB; the result is placed into register rD.
Pseudocode
(rD) (rA) (rB)
Registers Altered
rD
Latency
1 cycle
192
www.xilinx.com 1-800-255-7778
Instructions
xori
xori
1 0 1 0 1 0 0 6
rD 1 1
rA 1 6
IMM 3 1
Description
The IMM field is extended to 32 bits by concatenating 16 0-bits on the left. The contents of register rA are XORed with the extended IMM field; the result is placed into register rD.
Pseudocode
(rD) (rA) sext(IMM)
Registers Altered
rD
Latency
1 cycle
Note
By default, Type B Instructions will take the 16-bit IMM field value and sign extend it to 32 bits to use as the immediate operand. This behavior can be overridden by preceding the Type B instruction with an imm instruction. See the instruction imm, page 147 for details on using 32-bit immediate values.
www.xilinx.com 1-800-255-7778
193
194
www.xilinx.com 1-800-255-7778