Manuals / Xilinx / Communications / Answering Machine

Xilinx UG129 manual PBlazIDE Equivalent RET, RET C, RET NC, RET Z, RET NZ

Models: UG129

1 124

Download 124 pages 29.5 Kb

Page 107

RETURNI [ENABLE/DISABLE] — Return from Interrupt Service Routine and Enable or Disable

R

PBlazIDE Equivalent: RET, RET C, RET NC, RET Z, RET NZ

RETURNI [ENABLE/DISABLE] — Return from Interrupt Service Routine and Enable or Disable Interrupts

The RETURNI instruction is a special variation of the RETURN instruction. It concludes an interrupt service routine. The RETURNI instruction is unconditional and pops the return address from the top of the CALL/RETURN stack into the PC. The return address points to the instruction preempted by an Interrupt Event. The RETURNI instruction restores the CARRY and ZERO flags to the values preserved by the Interrupt Event.

The ENABLE or DISABLE operand defines whether the INTERRUPT input is re-enabled or remains disabled when returning from the interrupt service routine (ISR).

Example

RETURNI ENABLE; Return from interrupt, re-enable interrupts

RETURNI DISABLE; Return from interrupt, leave interrupts disabled

Pseudocode

;pop the top of the CALL/RETURN stack into PC PC Å TOS

;restore the flags to their pre-interrupt values

CARRY Å PRESERVED_CARRY ZERO Å PRESERVED_ZERO

;if “ENABLE” specified, re-enable interrupts

if (ENABLE = TRUE) then

INTERRUPT_ENABLE Å 1 else

INTERRUPT_ENABLE Å 0 endif

Registers/Flags Altered

Registers: PC, CALL/RETURN stack

Flags: CARRY, ZERO, INTERRUPT_ENABLE

Notes

Do not use the RETURNI instruction to return from a subroutine CALL. Instead, use the RETURN instruction.

PBlazIDE Equivalent: RETI ENABLE, RETI DISABLE

PicoBlaze 8-bit Embedded Microcontroller

www.xilinx.com

107

UG129 (v1.1.2) June 24, 2008

Image 107

Xilinx UG129 manual PBlazIDE Equivalent RET, RET C, RET NC, RET Z, RET NZ

Contents

UG129 v1.1.2 June 24 PicoBlaze 8-bit Embedded Microcontroller User GuideVersion Revision Revision HistoryTechnical Support Limitations Limited Warranty and DisclaimerLimitations Limitation of LiabilityPreface Acknowledgments AcknowledgmentsAbout This Guide Guide ContentsPreface About This Guide Table of Contents Interrupts Performance Appendix C PicoBlaze Instruction Set and Event Reference Introduction PicoBlaze Microcontroller FeaturesIntroduction PicoBlaze Microcontroller Functional BlocksGeneral-Purpose Registers Instruction Program StoreInput/Output Arithmetic Logic Unit ALUFlags Byte Scratchpad RAMCALL/RETURN Stack ResetProgram Counter PC Program Flow ControlWhy the PicoBlaze Microcontroller? Why the PicoBlaze Microcontroller?Why Use a Microcontroller within an FPGA? Weaknesses StrengthsSignal Direction Description PicoBlaze Interface SignalsPicoBlaze Interface Signal Descriptions Readstrobe 1PicoBlaze Instruction Set alphabetical listing PicoBlaze Instruction SetEnable Interrupt Returni Disable Address Spaces Instruction 1Kx18 Direct PicoBlaze Instruction Set Processing DataLogic Instructions 3Inverting an Individual Bit Location 2Complementing a Register ValueArithmetic Instructions 616-Setting a Bit LocationSUB and Subcy Subtract Instructions 10Incrementing and Decrementing a Register Multiplication148-bit by 8-bit Multiply Routine Produces a 16-bit Product Division 168-bit by 8-bit Multiply Routine Using Hardware Multiplier18Loading a Register with Itself Acts as a NOP Instruction No Operation NOPTest and Compare Setting and Clearing Carry Flag22The Test Instruction Affects the Zero Flag Shift and Rotate Instructions 25Generate Parity for a Register Using the Test Instruction5PicoBlaze Rotate Instructions Rotate Left Rotate Right SRXProgram Flow Control Moving Data6Instruction Conditional Execution Description Program Flow ControlCALL/RETURN Program Flow Control UG129 v1.1.2 June 24 1Simple Interrupt Logic Interrupts2Example Interrupt Flow Example Interrupt FlowExample Interrupt Flow 3Interrupt Timing DiagramInterrupts Indirect Addressing Scratchpad RAMAddress Modes Direct AddressingScratchpad RAM Implementing a Look-Up TableStack Operations Stack OperationsFifo Operations Scratchpad RAM Portid Port Input and Output Ports1INPUT Operation and Fpga Interface Logic Input OperationsRegister s0 Input OperationsPORTID70 INPORT70Input and Output Ports Applications with Few Input SourcesReadstrobe Interaction with FIFOs Output Operations Output OperationsFpga Register Simple Output Structure for Few Output Destinations8Use Constant Directives to Declare Output Port Addresses 9Pipelining the Portid Decoding Improves Performance Pipelining for Maximum PerformancePipelining for Maximum Performance Effective Pipelining Improves Read Performance Repartitioning the Design for Maximum PerformanceStandard Configuration Single 1Kx18 Block RAM Instruction Storage ConfigurationsTwo PicoBlaze Microcontrollers Share a 1Kx18 Code Image Instruction Storage ConfigurationsDistributed ROM Instead of Block RAM 6Using Distributed ROM for Instruction MemoryInstruction Storage Configurations Frequency PerformanceInput Clock Frequency Predicting Executing PerformancePerformance Assembler PicoBlaze Development ToolsPicoBlaze Development Tools Assembly ErrorsInput and Output Files Mediatronix pBlazIDE Configuring pBlazIDE for the PicoBlaze Microcontroller4Example of How Kcpsm Source Code Converts to pBlazIDE Code Importing KCPSM3 Code into pBlazIDEFunction KCPSM3 Directive PBlazIDE Directive Differences Between the KCPSM3 Assembler and pBlazIDEDirectives Differences Between the KCPSM3 Assembler and pBlazIDEPicoBlaze Development Tools KCPSM3 Module Using the PicoBlaze Microcontroller in an Fpga DesignVhdl Design Flow Using the PicoBlaze Microcontroller in an Fpga Design Connecting the Program ROMBlack Box Instantiation of KCPSM3 using KCPSM3.ngc Black Box Instantiation of KCPSM3 using KCPSM3.ngcGenerating the Program ROM using progrom.coe Generating an ESC Schematic SymbolUsing the PicoBlaze Microcontroller in an Fpga Design Naming or Aliasing Registers Assembler DirectivesLocating Code at a Specific Address PBlazIDE Defining ConstantsNaming the Program ROM Output File Defining I/O Ports pBlazIDEDefining I/O Ports pBlazIDE Input PortsOutput Ports 5Example of pBlazIDE Dsout Directive Input/Output PortsCustom Instruction Op-Codes Custom Instruction Op-CodesAssembler Directives Simulating PicoBlaze Code Instruction Set Simulation with pBlazIDE Edit Simulator Control ButtonsInstruction Set Simulation with pBlazIDE 2pBlazIDE Simulator Control Buttons Function AssemblePause RunStep Over Run to CursorTurbocharging Simulation using FPGAs Turbocharging Simulation using FPGAsSimulating PicoBlaze Code Related Materials and References Chapter Related Materials and References KCPSM3 Syntax Example Program TemplatesAppendix Example Program Templates PBlazIDE SyntaxADD sX, Operand -Add Operand to Register sX PicoBlaze Instruction Set and Event ReferenceAppendix PicoBlaze Instruction Set and Event Reference Addcy sX, Operand -Add Operand to Register sX with CarrySX, Operand Logical Bitwise and Register sX with Operand SX, Operand Logical Bitwise and Register sX with OperandExamples Table C-1CALL Instruction Conditions Description ConditionFigure C-4COMPARE Operation Compare sX, Operand Compare Operand with Register sXDisable Interrupt Disable External Interrupt Input Disable Interrupt Disable External Interrupt InputEnable Interrupt Enable External Interrupt Input KCPSM3 Instruction PBlazIDE Instruction Figure C-5FETCH OperationPortid Å Operand SX Å Inport PC Å PC + Interrupt Event, When Enabled Table C-2JUMP Instruction Conditions Description Load sX, Operand Load Register sX with Operand Or sX, Operand Logical Bitwise or Register sX with Operand Or sX, Operand Logical Bitwise or Register sX with OperandFigure C-7OUTPUT Operation and Fpga Interface Logic Table C-3PicoBlaze Reset Values Resource Reset Event Effect Reset EventReset Event Table C-4RETURN Instruction Conditions Description PBlazIDE Equivalent RET, RET C, RET NC, RET Z, RET NZ Table C-6Rotate Right RR Operation RL sX Rotate Left Register sXRR sX Rotate Right Register sX Table C-5Rotate Left RL OperationTable C-7Shift Left Operations SL 0 1 X a sX Shift Left Register sXSL 0 1 X a sX Shift Left Register sX SR 0 1 X a sX Shift Right Register sX Shift Right with ‘ 0’ fill Figure C-8STORE Operation Store sX, sY SUB sX, Operand -Subtract Operand from Register sXFigure C-10SUBCY Instruction Registers sX Flags CARRY, Zero PBlazIDE Equivalent Subc Figure C-11ZERO Flag Logic for Test Instruction PicoBlaze 8-bit Embedded Microcontroller 117 XOR sX, Operand Logical Bitwise XOR Register sX with Operand Table D-1PicoBlaze Instruction Codes Instruction CodesJump Z PicoBlaze 8-bit Embedded Microcontroller 121 Appendix Instruction Codes Reg Description Register and Scratchpad RAM Planning WorksheetsRegisters Loc Description Scratchpad RAMAppendix Register and Scratchpad RAM Planning Worksheets