Manuals / ARM / Computer Equipment / Computer Hardware

ARM VERSION 1.2 manual 2 ASR, LSL, LSR, and ROR

Models: VERSION 1.2

1 360

Download 360 pages 38.37 Kb

Page 218

Thumb Instruction Reference

5.3.2ASR, LSL, LSR, and ROR

Shift and rotate operations. These instructions can use a value contained in a register, or an immediate shift value.

Syntax

op Rd, Rs

op Rd, Rm, #expr

where:
op	is one of:
	ASR		Arithmetic Shift Right. Register contents are treated as two’s
			complement signed integers. The sign bit is copied into
			vacated bits.
	LSL		Logical Shift Left. Vacated bits are cleared.
	LSR		Logical Shift Right. Vacated bits are cleared.
	ROR		Rotate Right. Bits moved out of the right-hand end of the
			register are rotated back into the left-hand end.
				Note
				Note
			ROR can only be used with a register-controlled shift.

Rd	is the destination register. It is also the source register for
	register-controlled shifts. Rd must be in the range r0-r7.
Rs	is the register containing the shift value for register-controlled shifts. Rm
	must be in the range r0-r7.
Rm	is the source register for immediate shifts. Rm must be in the range r0-r7.
expr	is the immediate shift value. It is an expression evaluating (at assembly
	time) to an integer in the range:
	•	0-31 if op is LSL
	•	1-32 otherwise.

5-24

Copyright © 2000, 2001 ARM Limited. All rights reserved.

ARM DUI 0068B

Image 218

ARM VERSION 1.2 manual 2 ASR, LSL, LSR, and ROR

Contents

ARM Developer Suite Copyright 2000, 2001 ARM Limited. All rights reserved ARM Developer SuiteAssembler Guide ARM Developer Suite Assembler Guide Glossary About this book on Feedback onIntended audience Using this bookAbout this book This book is organized into the following chaptersFurther reading Typographical conventionsItalic ARM publicationsARM Reference Peripheral Specification ARM DDI Other publicationsFeedback on this book FeedbackFeedback on the ARM Developer Suite ARM DUI 0068B Introduction About the ARM Developer Suite assemblers onAbout the ARM Developer Suite assemblers ARM Developer Suite ADS hasWriting ARM and Thumb Assembly Language Or run the module in AXD with interleaving on See IntroductionCode examples ARM and Thumb state Overview of the ARM architectureArchitecture versions ARM processors always start executing code in ARM stateGeneral-purpose, 32-bit registers Processor modeRegisters Program counter pc Data processing instructions ARM instruction set overviewBranch instructions Multiple register load and store instructions Status register access instructionsSingle register load and store instructions Semaphore instructionsARM instruction capabilities Register accessAccess to the inline barrel shifter Following general points apply to ARM instructionsFollowing general points apply to Thumb instructions Thumb instruction set overviewThumb instruction capabilities Access to the barrel shifter Differences between Thumb and ARM instruction setsSingle register load and store instructions General form of source lines in assembly language is Structure of assembly language modulesLayout of assembly language source files Case rulesComments LabelsLocal labels Constants Is a base between 2 Xxx is a number in that baseAn example ARM assembly language module ELF sections and the Area directiveApplication termination Entry directiveApplication execution END directiveCalling subroutines BX instruction An example Thumb assembly language moduleCODE32 and CODE16 directives Using the C preprocessor Example 2-4 Preprocessing an assembly language source fileConditional execution ALU status flagsExecution conditions ExamplesUsing conditional execution in ARM state Example of the use of conditional executionConditional branches only Converting to Thumb Branch prediction and cachesLoading constants into registers Direct loading with MOV and MVN Right, 2 bitsDirect loading with MOV in Thumb state Loading with LDR Rd, =constPlacing literal pools Loading floating-point constants Loading addresses into registers Direct loading with ADR and AdrlADR Implementing a jump table with ADR Example 2-7 ARM code jump table Example 2-8 Thumb code jump table Loading addresses with LDR Rd, = label R1, =Darea + = LDR R1,PC, #offset into Literal Pool Increments r1 by An LDR Rd, =label example string copyingAddress registers. For example, the instruction Load register Load and store multiple register instructions Syntax of the LDM instructions is ARM LDM and STM instructionsSyntax WhereUsage LDM and STM addressing modesImplementing stacks with LDM and STM Descending or ascendingStacking registers for nested subroutines Block copy with LDM and STM Example 2-11 Block copyMovs Push and POP Thumb LDM and STM instructionsLDM and STM Thumb-state block copy exampleLSR This macro can be invoked as follows Using macrosTest-and-branch macro example After substitution this becomesAfter the instructions are executed, it holds the remainder Unsigned integer division macro exampleRegister that holds the divisor If only the remainder is requiredRatio DivMod r0,r5,r4,r2 Describing data structures with MAP and Field directives Relative maps Register-based maps Program-relative maps Finding the end of the allocated data Forcing correct alignment EndOfChars Using register-based MAP and Field directives Defining register-based symbolsSetting up a C-type structure Is equivalent to the C code2-27 for an explanation of these Making faster access possibleIf you want the equivalent of the C code This example, the MAP directive is NotField MAP Using two register-based structures Avoiding problems with MAP and Field directives ArrayBase RN r9 Using frame directives Symbols on Expressions, literals, and operators onCommand syntax Specifies that the content of inputfile is read-write Specifies that the content of inputfile is read-onlyPosition-independent. The default is /noropi Position-independent. The default is /norwpiValid options are Assembled for the wrong target FPUSelection of libraries, accordingly Selects no floating-point option. This makes your assembledObject file, for use by the debugger see Keep on Command-line optionsSets the maximum source cache size to n. The default is 8MB Allow unaligned LDRsRegister names First pass and reads them from memory on the second passAs \n and \t Turns off warning messagesAssembler Reference Format of source lines Predeclared program status register names Predefined register and coprocessor namesPredeclared register names Predeclared floating-point register namesExpressions or conditions, for example Built-in variablesLists the built-in variables defined by the ARM assembler Determining the armasm version at assembly time Numeric constants on SymbolsSymbol naming rules Labels onVariables Numeric constantsAssembly time substitution of variables GblsDCQ and Dcqu on DCW and Dcwu on Program-relative labelsDCD and Dcdu on Dcfd and Dcfdu on Dcfs and Dcfsu on Register-relative labelsSyntax of a local label is Syntax of a reference to a local label isAssembler Reference Expressions, literals, and operators This section contains the following subsectionsExample String expressionsString literals String literalsNumeric expressions Numeric literals can take any of the following forms Is a sequence of characters using only the digits 0 to nNumeric literals Numeric code of the characterFloating-point literals Floating-point literals can take any of the following formsLogical literals Register-relative and program-relative expressionsLogical expressions There are only two logical literalsOperator precedence String manipulationOperator precedence in C Precedence Unary operators Operator Usage DescriptionExample of use of SBOFFSET1912 and SBOFFSET11 String manipulation operators Binary operatorsMultiplicative operators Addition, subtraction, and logical operators Shift operatorsSHR is a logical shift and does not propagate the sign bit Relational operators Boolean operators 10 shows the Boolean operatorsARM DUI 0068B ARM Instruction Reference Add with carry, Add All Logical Branch Move not All ARM condition codes Q flag LDR and STR, halfwords and signed bytes on ARM memory access instructionsLDR and STR, words and unsigned bytes on LDR and STR, doublewords onOtherwise, a 32-bit word is transferred Where Is either LDR Load Register or STR Store RegisterLDR and STR, words and unsigned bytes Program-relative Zero offsetPre-indexed offset Post-indexed offsetFlexible offset syntax Address alignment for word transfers Loading to r15Saving from r15 ArchitecturesLDR and STR, halfwords and signed bytes Offset syntax Must be within ±255 bytes of the current instructionIs an offset applied to the value in Rn see Offset syntax Is often a numeric constant see examples belowYou cannot load halfwords or bytes to r15 Offset syntax is the same for LDR and STR, doublewords onAddress alignment for halfword transfers Incorrect exampleMust be an even numbered register, and not r14 LDR and STR, doublewordsIs an optional condition code see Conditional execution on Pre-indexed without writebackNot be the same as Rd or Rd+1 Address alignmentIncorrect examples Increment address after each transfer Is either LDM or STMIs any one of the following Increment address before each transferNon word-aligned addresses Loading or storing the base register, with writeback5 PLD Is the register on which the memory address is basedAlignment Both Rd and Rm Is swapped with the contents of the memory location6 SWP ARM general data processing instructions Flexible second operand LSR and LSL Bits of the register are set toCarry flag Instruction substitutionIs the ARM register for the result 2 ADD, SUB, RSB, ADC, SBC, and RSCIs one of ADD, SUB, RSB, ADC, SBC, or RSC Is the ARM register holding the first operandMultiword arithmetic examples Condition flagsUse of r15 These instructions subtract one 96-bit integer from another Is one of AND, ORR, EOR, or BIC 3 AND, ORR, EOR, and BICLogical AND, OR, Exclusive or and Bit Clear Orreq Is the ARM register for the result MOV and MVNMove and Move Not Mvnne CMP and CMN Compare and Compare NegativeCMN TST and TEQ Test and Test EquivalenceTEQ Is the ARM register for the result. Rd must not be r15 7 CLZCount Leading Zeroes Is the operand registerUMULL, UMLAL, Smull and Smlal on ARM multiply instructionsMUL and MLA on MUL and MLA MUL UMULL, UMLAL, Smull and Smlal Is one of UMULL, UMLAL, SMULL, or SmlalUmull Use the top end bits 3116 of Rs SMULxyUse the top end bits 3116 of Rm Are the ARM registers holding the values to be multipliedSmulbt SMLAxy Is the ARM register holding the value to be addedSmlatb Are the ARM registers holding the operands SMULWyUse the top end bits 3116 of Rs Is the ARM register holding the value to be added SMLAWyAre the ARM registers holding the values to be multiplied Smlawt SMLALxy Smlaltt Use the top end bits 3116 of Rm 8 MIA, MIAPH, and MIAxyCurrent processors R15 cannot be used for either Rm or RsThese instructions are only available in XScale Is one of QADD, QSUB, QDADD, or Qdsub ARM saturating arithmetic instructionsQADD, QSUB, QDADD, and Qdsub Are the ARM registers holding the operandsQadd ARM branch instructions Branch, and Branch with Link 2 BX 3 BLX Blxmi ARM coprocessor instructions MCR, MCR2, Mcrr on1 CDP, CDP2 Are ARM source registers. They must not be r15 Is p n, where n is an integer in the range2 MCR, MCR2, Mcrr 3 MRC, MRC2 AffectedMrrc Is an optional suffix specifying a long transfer 5 LDC, STCIs either LDC or STC Is the coprocessor register to load or saveArchitectures 6 LDC2, STC2 Is either LDC2 or STC2Architectures Miscellaneous ARM instructions 1 SWI Software interruptIs the destination register. Rd must not be r15 2 MRSWhere Is either Cpsr or SpsrSee MRS on 3 MSRIs either Cpsr or Spsr MSR CPSRf, r5 Bkpt BreakpointAre general-purpose registers 5 MAR, MRAFor current processors Adrl ARM pseudo-instructionon ARM pseudo-instructionsADR ARM pseudo-instructionon LDR ARM pseudo-instruction onIs the register to load ADR ARM pseudo-instructionIs an optional condition code Non word-aligned address within ±255 bytesWord-aligned address within 256KB Adrl ARM pseudo-instructionNon word-aligned address within 64KB R4,start + = ADD R4,pc,#0xe800 LDR ARM pseudo-instruction R3,=0xff0 Loads Into = MOV r3,#0xff0 NOP ARM pseudo-instruction Thumb Instruction Reference Add with carry Rotate right LDR and STR, register offset on Thumb memory access instructionsLDR and STR, immediate offset on LDR and STR, pc or sp relative onLoad register Where Is eitherLDR and STR, immediate offset Store registerAddress alignment for word and halfword transfers LDR and STR, register offset Strsh LDR and STR, pc or sp relative 4 in the range 0 toR2,pc,#1016 POP reglist POP reglist, pc These instructions do not affect the flagsLoad multiple, increment after Ldmia and StmiaLoad and store multiple registers Store multiple, increment afterR3!, r0,r4 ADD, pc or sp relative on Thumb arithmetic instructionsADD and SUB, sp on ADC, SBC, and MUL on255 to +255 ADD and SUB, low registersTo +7 These instructions update the N, Z, C, and V flags Restrictions2 ADD, high or low registers Is a register containing the second operandADD and SUB, sp Range -508 to +508Is either sp or pc 4 ADD, pc or sp relativeIs the destination register. Rd must be in the range r0- r7 RangeWhere Is one of ADC, SBC, or MUL 5 ADC, SBC, and MULMOV, MVN, and NEG on page 5-28 Move, Move NOT, and Negate Thumb general data processing instructionsCMP and CMN on page 5-26 Compare and Compare Negative TST on page 5-30 Test bitsBitwise logical operations Where Is one of AND, ORR, EOR, or BIC1 AND, ORR, EOR, and BIC Range r0- r72 ASR, LSL, LSR, and ROR Register-controlled shift Immediate shiftWhere Is the register containing the first operand Examples Move, Move NOT, and Negate Where Is the destination register4 MOV, MVN, and NEG Is the source registerCondition flags Test bits Where Is the register containing the first operand5 TST Rn and Rm must be in the range r0-r7Thumb branch instructions 3-23 for more information 1 BIs an optional condition code see -2 on Label must be withinCondition codes for Thumb B instruction 2 BL Long branch with Link3 BX Instruction clears the T flag in the CPSR. Code at 4 BLXBranch with Link, and optionally exchange instruction set BLX label always causes a change to ARM stateThumb software interrupt and breakpoint instructions Bkpt onBkpt immed8 Thumb pseudo-instructions ADR Thumb pseudo-instruction 1KB. expr must be defined locally, it cannot be importedAssembler generates the instruction LDR Thumb pseudo-instructionIf the value of expr is within range of a MOV instruction, =labelname NOP Thumb pseudo-instruction Syntax for NOP isARM DUI 0068B Vector Floating-point Programming Absolute value Vector All Negate Vector All VFP architectures Vector floating-point coprocessorReference Manual Floating-point registers Register banksVector stride VectorsVector wrap-around Restriction on vector lengthScalar operations Vector and scalar operationsControl of scalar, vector and mixed operations Vector operationsVFP and condition codes Vector Floating-point Programming VFP system registers FPSCR, the floating-point status and control register0b000 Modifying individual bits of a VFP system register FPEXC, the floating-point exception registerFPSID, the floating-point system ID register See FMRX, FMXR, and Fmstat onEffects of using flush-to-zero mode Flush-to-zero modeWhen to use flush-to-zero mode Operations not affected by flush-to-zero mode FMRX, FMXR, and Fmstat on VFP instructionsFmrrs and Fmsrr on Ftosi and Ftoui onPage Fabsd d3, d5 Fnegsmi s15, s15 Is the VFP register holding the first operand Fadd and FsubIs the VFP register for the result Is the VFP register holding the second operandWith zero instruction FcmpFloating-point compare Fcmp is always scalar Fcmp instructions can produce Invalid Operation exceptionsIs a single-precision VFP register holding the operand FcvtdsIs a double-precision VFP register for the result Is a double-precision VFP register holding the operand FcvtsdIs a single-precision VFP register for the result Fdiv Precision specified in precision FLD and FSTFloating-point load and store Address used for the transferFldsne Fldm and Fstm Unspecified precision Following instructions are equivalentFMAC, FNMAC, FMSC, and Fnmsc Must be one of FMAC, FNMAC, FMSC, or FnmscFnmscsle Are ARM registers. Do not use r15 Fmdrr and FmrrdIs the VFP double-precision register These instructions do not produce any exceptionsThese instructions are used together as matched pairs FMDHR, FMDLR, FMRDH, and FmrdlIs the ARM register. Rd must not be r15 Fmrs and Fmsr Is the VFP single-precision registerAre the ARM registers. Do not use r15 Fmrrs and FmsrrAre two consecutive VFP single-precision registers FMRX, FMXR, and Fmstat Is the ARM registerFmul and Fnmul Fsito and Fuito Fsqrt Is the VFP register holding the operandFtosi and Ftoui Is a single-precision VFP register for the integer resultFLD pseudo-instruction VFP pseudo-instructionThere is one VFP pseudo-instruction Can be S for single-precision, or D for double-precisionD1,=3.12E106 Loads 3.12E106 into d1 VFP directives and vector notation Vfpassert Scalar on Vfpassert Vector onVfpassert Scalar VFP directives and vector notation on Vfpassert Vector onWhere Is the vector length Is the vector stride VFP directives and vector notation on Vfpassert Scalar onR10,FPSCR ARM DUI 0068B Assembly control directives on Conditional assembly, looping, inclusions, and macrosAlphabetical list of directives Location of descriptions of directivesGBLA, GBLL, and Gbls on Symbol definition directivesThis section describes the following directives Declare a global arithmetic, logical, or string variableGBLA, GBLL, and Gbls Armasm -pd objectsize Seta 0xFF -o objectfile sourcefile LCLA, LCLL, and Lcls SETA, SETL, and Sets Rlist Names onCoprocessor names on 5 CNCN directive defines a name for a coprocessor register Evaluates to a coprocessor register number from 0 to6 CP Evaluates to a coprocessor number from 0 toDN and SN 8 FN Evaluates to a floating-point register number from 0 toDCQ and Dcqu on Data definition directivesDCD and Dcdu on Ltorg Set to this address 2 MAPIs a numeric or program-relative expression During the first pass of the assemblerStorage counter FieldBy the value of expr Space Expressions onQuoted string. The characters of the string are loaded into 5 DCBTo 255 see Numeric expressions on Consecutive bytes of storeProgram-relative expression DCD and DcduNumeric expression see Numeric expressions on DCW and Dcwu on DCQ and Dcqu onDcdo Dcfd and Dcfdu Dcfs and Dcfsu 10 DCI Is a numeric expression see Numeric expressions onDCQ and Dcqu DCD and Dcdu on DCW and Dcwu onDCD and Dcdu on DCQ and Dcqu on DCW and DcwuTo 65535 see Numeric expressions on DataMexit on Assembly control directivesMacro and Mend on IF, ELSE, and Endif on While and Wend onMacro and Mend BGE Using a macro to produce assembly-time diagnostics Mexit4 IF, ELSE, and Endif See Relational operators onExample 7-3 Assembly conditional on a variable being defined While and Wend Frame Address on Frame Register on Frame Restore onFrame description directives Frame POP on Frame Push onIs sp unless the function uses a separate frame pointer Can omit itThere are two alternative syntaxes for Frame POP Is the number of bytes that the stack pointer movesFrame Push There are two alternative syntaxes for Frame PushFrame Register Is the register in which the value is preservedFrame Restore Frame Save Frame State Restore on Function or Proc on Frame State RememberFrame State Restore Frame State Remember on Function or Proc onFunction or Proc Endfunc or Endp Is an assertion that can evaluate to either True or False Reporting directivesAssert Info Is an expression that evaluates to a stringSpecify the -listassembler option to turn on listing Where Is the OPT directive setting. -2 lists valid settings3 OPT OPT Is the subtitle TTL and SubtIs the title Export or Global on Miscellaneous directivesCODE16 and CODE32 on GET or Include onAlign Cacheable, CODE, ALIGN=3 Area Example,CODE,READONLY An example code section CODE16 and CODE32 4 END Entry Entry directive declares an entry point to a programAddress, or a 32-bit integer constant Is the symbolic name to assign to the value6 EQU Is optional. type can be any oneExport or Global Exportas Extern GET or Include Nesting directives onSee Export or Global on File, or library. The symbol name is case-sensitiveGlobal ImportSee GET or Include on IncbinInclude Symbols are kept except register-relative symbols KeepRequire Assembly failsNofp Require directive specifies a dependency between sectionsREQUIRE8 and PRESERVE8 19 RN Evaluates to a register number from 0 toRout Thumb state See ARM Developer SuiteAmong other things, computer software PlatformsSee also Saved Processor Status Register Used to find errors in the application program flowDefault thread runs Otherwise statedSee Read Only Position Independent See also RopiSee also Rwpi See Read Write Position IndependentBy ARM to handle semihosting Normally set to zero on resetBlock of software code or data for an Image See Saved Processor Status RegisterIndex Align Gbll Adrl Symbols Index-6