Atmel AVR instruction set: Difference between revisions

Content deleted Content added
Status register: Added Z flag exception for subtract with carry. Reorganized to group it with C flag exception.
Status register: Added article link to Exclusive OR function
 
(8 intermediate revisions by 5 users not shown)
Line 1:
{{Short description|Microcontroller machine language}}
{{manual|date=June 2014}}
{{main article|Atmel AVR}}
 
Line 173 ⟶ 172:
# N [[Negative flag]]. Set to a copy of the most significant bit of an arithmetic result.
# V [[Overflow flag]]. Set in case of two's complement overflow.
# S Sign flag. Unique to AVR, this is always N⊕VN[[Exclusive or|⊕]]V, and shows the true sign of a comparison.
# H [[Half-carry flag]]. This is an internal carry from additions and is used to support [[Binary-coded decimal|BCD]] arithmetic.
# T Bit copy. Special bit load and bit store instructions use this bit.
Line 179 ⟶ 178:
 
There are two special cases which exist to facilitate multi-byte arithmetic:
* The <code>INC</code> and <code>DEC</code> instructions do ''not'' modify the carry flag, so they may be used to loop over [[arbitrary-precision arithmetic]] operands.<ref name="isa_manual">{{cite web |url=httphttps://ww1.microchip.com/downloads/en/devicedocDeviceDoc/atmelAVR-0856InstructionSet-avrManual-instruction-set-manualDS40002198.pdf |title=AVR Instruction Set Manual |date=November 2016 |publisher=Atmel |id=Atmel-0856L}}</ref>{{Rp|84,101}}
* The <code>CPC</code>, <code>SBC</code> and <code>SBCI</code> (compare/subtract with carry) instructions do ''not'' set the Z flag when the result is zero, but only clear it if the result is non-zero.{{r|isa_manual|p=79,147,149}} For ''fixed'' precision multi-byte comparisons, implemented with an [[Loop unrolling|unrolled]] <code>CP; CPC; CPC; CPC</code> sequence, this produces a zero flag which is set only if the ''entire'' difference is zero.
 
Line 266 ⟶ 265:
! Transfer
! Jump
! Branch
! Call
|-
|valign=top rowspan=5|{{#tag:syntaxhighlight|
ADD Rd, Rr
ADC Rd, Rr
ADIW Rp+1:Rp, K6
 
SUB Rd, Rr
SUBI Rdh, K8
SBC Rd, Rr
SBCI Rdh, K8
SBIW Rp+1:Rp, K6
 
INC Rd
DEC Rd
 
AND Rd, Rr
ANDI Rdh, K8
OR Rd, Rr
ORI Rdh, K8
<!--
|lang="nasm"|style=font-size:95%}} <!--
<S> CLR Rd </S> (EOR)
<S> SER Rdh </S> (LDI)
<S> SBR Rdh, K8 </S> (ORI)
<S> CBR Rdh, K8 </S> (ANDI)
<S> TST Rd </S> (AND)
!-->
SWAPCOM Rd
{{#tag:syntaxhighlight|
COM NEG Rd
NEGCP Rd, Rr
CP CPC Rd, Rr
CPCCPI RdRdh, RrK8
SWAP Rd
CPI Rdh, K8
<!--
SWAP Rd
<S> ROL LSL Rd </S> (ADCADD) !-->
|lang="nasm"|style=font-size:95%}} <!--
<S> LSL ROL Rd </S> (ADDADC) !--><!--
!-->
<S> ROL Rd </S> (ADC) !-->
ROR LSR Rd
{{#tag:syntaxhighlight|
ASR ROR Rd
ASR Rd
 
LSRMUL Rd, Rr
CPIMULS Rdh, K8Rrh
ROR Rd
MULSU Rdq, Rrq
ASR Rd
FMUL Rdq, Rrq
FMULS Rdq, Rrq
FMULSU Rdq, Rrq
|lang="nasm"|style=font-size:95%}}
|valign=top rowspan=5|{{#tag:syntaxhighlight|
BSET s
MUL Rd, Rr
BCLR s
MULS Rdh, Rrh
MULSUSBI RdqIO5, Rrqb
FMULCBI RdqIO5, Rrqb
FMULSBST RdqRd, Rrqb
FMULSUBLD RdqRd, Rrqb
|lang="nasm"|style=font-size:95%}}
|valign=top|{{#tag:syntaxhighlight|
BSET s
BCLR s
SBI IO5, b
CBI IO5, b
BST Rd, b
BLD Rd, b
 
NOP
BREAK
SLEEP
WDR|lang="nasm"|style=font-size:95%}} <!--
WDR
|valign=top rowspan=5|{{#tag:syntaxhighlight|
|lang="nasm"|style=font-size:95%}}
|valign=top|{{#tag:syntaxhighlight|
MOV Rd, Rr
MOVW Rd+1:Rd, Rr+1:Rr
 
IN Rd, IO6
OUT IO6, Rr
 
PUSH Rr
POP Rr
 
LDI Rdh, K8
LDS Rd, D16
 
LD Rd, X
LDD Rd, YZ+K6
LD Rd, -XYZ
LD Rd, XYZ+
 
STS D16, Rr
 
ST X, Rr
STD YZ+K6, Rr
ST -XYZ, Rr
ST XYZ+, Rr
 
LPM
LPM Rd, Z
LPM Rd, Z+
ELPM
ELPM Rd, Z
ELPM Rd, Z+
 
SPM|lang="nasm"|style=font-size:95%}} <!--
SPM
|lang="nasm"|style=font-size:95%}}
|valign=top|{{#tag:syntaxhighlight|
RJMP S12
IJMP
EIJMP
JMP P22|lang="nasm"|style=font-size:95%}}
JMP P22
|-
|lang="nasm"|style=font-size:95%}}
! Call
|valign=top|{{#tag:syntaxhighlight|
|-
CPSE Rd, Rr
 
SBRC Rr, b
SBRS Rr, b
 
SBIC IO5, b
SBIS IO5, b
 
BRBC s, S7
BRBS s, S7
|lang="nasm"|style=font-size:95%}}
|valign=top|{{#tag:syntaxhighlight|
RCALL S12
ICALL
EICALL
CALL P22
 
RET
RETI|lang="nasm"|style=font-size:95%}}
RETI
|-
|lang="nasm"|style=font-size:95%}}
! Branch
|-
|valign=top|{{#tag:syntaxhighlight|
MUL CPSE Rd, Rr
 
SBRC Rr, b
SBRS Rr, b
 
SBI SBIC IO5, b
CBI SBIS IO5, b
 
BRBC s, S7
BRBS s, S7|lang="nasm"|style=font-size:95%}}
|}
 
Line 543 ⟶ 538:
== Instruction encoding ==
Bit assignments:
* {{not a typo|rrrrr / ddddd}} = Source/destination register
* {{not a typo|rrrr / dddd}} = Source/destination register (R16–R31)
* {{not a typo|rrr / ddd}} = Source/destination register (R16–R23)
* RRRR / DDDD = Source/destination register pair (R1:R0–R31:R30)
* {{not a typo|ddddd}} = Destination register
* {{not a typo|dddd}} = Destination register (R16–R31)
* {{not a typo|ddd}} = Destination register (R16–R23)
* DDDD = Destination register pair (R1:R0–R31:R30)
* pp = Register pair, W, X, Y or Z
* y = Y/Z register pair bit (0=Z, 1=Y)
* u = FMUL(SFMULS(U)) signedunsigned withbit (0=FMULS signed or, 1=FMULSU unsigned)
* s = Store/load bit (0=loadLD Rd,mem, 1=storeST mem,Rd)
* c = Call/jump (0=jump, 1=call)
* cy = With carry (0=without carry, 1=with carry)
Line 567 ⟶ 558:
* {{not a typo|KKKKKKKK}} = 8-bit constant
 
The Atmel AVR uses many split fields, where bits are not contiguous in the instruction word. The load/storemost withcommonly offsetencountered instructions areis the 5-bit source register field in bits 9 and 3–0. The most extreme example whereis the load/store with offset instructions, which break a 6-bit offset is broken into three pieces.
 
{|class="wikitable" style="text-align:center"
Line 593 ⟶ 584:
| 0 || 0 || 0 || 0 || 0 || 0 || 1 || 1 || 1 ||colspan=3| d d d || u ||colspan=3| r r r ||align=left| FMULS(U) Rd,Rr
|-
|colspan=17|
! 0 || 0 ||colspan=4| opcode || r ||colspan=5| d d d d d ||colspan=4| r r r r ||align=left| 2-operand instructions
|-
! 0 || 0 ||colspan=4| opcode || r ||colspan=5| d d d d d ||colspan=4| r r r r ||align=left| 2Two-operand instructions
|-
| 0 || 0 || 0 || c̅y̅ || 0 || 1 || r ||colspan=5| d d d d d ||colspan=4| r r r r ||align=left| CPC/CP Rd,Rr
Line 631 ⟶ 624:
! 1 || 0 || 0 || 1 || 0 || 0 || s ||colspan=5| d d d d d ||colspan=4| opcode ||align=left| Load/store operations
|-
| 1 || 0 || 0 || 1 || 0 || 0 || s ||colspan=5| d d d d d || 0 || 0 || 0 || 0 ||align=left rowspan=2| LDS rdRd,i/STS i,rdRd
|-
| colspan=16| 16-Bit immediate SRAM address i
|-bgcolor=lightgray
| 1 || 0 || 0 || 1 || 0 || 1 || 0 || 1s || 0 |colspan=5| 1d ||d xd ||d xd || 1 || 0 || 0 || 0 || (reserved)
|-
| 1 || 0 || 0 || 1 || 0 || 0 || s ||colspan=5| d d d d d || y || 0 || 0 || 1 ||align=left| LD/ST Rd through Z+/Y+
|-
| 1 || 0 || 0 || 1 || 0 || 0 || s ||colspan=5| d d d d d || y || 0 || 1 || 0 ||align=left| LD/ST Rd through &minus;Z/&minus;Y
|-bgcolor=lightgray
| 1 || 0 || 0 || 1 || 0 || 0 || s ||colspan=5| d d d d d || y || 0 || 1 || 1 || (reserved)
|-
| 1 || 0 || 0 || 1 || 0 || 0 || 0 ||colspan=5| d d d d d || 0 || 1 || q || 0 ||align=left| LPM/ELPM Rd,Z
Line 691 ⟶ 688:
| 1 || 0 || 0 || 1 || 0 || 1 || 0 || 1 || 0 || 0 || 0 || 1 || 1 || 0 || 0 || 0 ||align=left| RETI
|-bgcolor=lightgray
| 1 || 0 || 0 || 1 || 0 || 1 || 0 || 1 || 0 ||colspan=2| 0 || 100 || x || 1 || 0 || 0 || 0 || (reserved)
|-bgcolor=lightgray
| 1 || 0 || 0 || 1 || 0 || 1 || 0 || 1 || 0 || 1 || x || x || 1 || 0 || 0 || 0 || (reserved)
|-
| 1 || 0 || 0 || 1 || 0 || 1 || 0 || 1 || 1 || 0 || 0 || 0 || 1 || 0 || 0 || 0 ||align=left| SLEEP
Line 712 ⟶ 707:
|-
| 1 || 0 || 0 || 1 || 0 || 1 || 0 || c || 0 || 0 || 0 || e || 1 || 0 || 0 || 1 ||align=left| Indirect jump/call to Z or EIND:Z
|-bgcolor=lightgray
| 1 || 0 || 0 || 1 || 0 || 1 || 0 || c ||colspan=3| ≠ 000 || e || 1 || 0 || 0 || 1 || (reserved)
|-
| 1 || 0 || 0 || 1 || 0 || 1 || 0 ||colspan=5| d d d d d || 1 || 0 || 1 || 0 ||align=left| DEC Rd