Added English language description for lhaupsx instruction
[openpower-isa.git] / openpower / isa / pifixedloadshift.mdwn
1 <!-- This defines DRAFT instructions that are to be proposed for SV -->
2
3 <!-- This defines instructions that load from RAM to a register -->
4 <!-- Effective Address is always RA, and the usual EA is stored late in RA -->
5
6 <!-- Note that these pages also define equivalent store instructions, -->
7 <!-- these are described in pifixedstoreshift.mdwn -->
8 <!-- https://bugs.libre-soc.org/show_bug.cgi?id=1055 -->
9 <!-- https://libre-soc.org/openpower/sv/rfc/ls004/ -->
10
11
12
13
14 # Load Byte and Zero with Post-Update Indexed
15
16 X-Form
17
18 * lbzupsx RT,RA,RB,SH
19
20 Pseudo-code:
21
22 EA <- (RA)<<(SH+1)
23 RT <- ([0] * (XLEN-8)) || MEM(EA, 1)
24 RA <- (RA) + (RB)
25
26 Description:
27
28 Let the effective address (EA) be the contents of
29 register RA shifted by (SH+1).
30
31 The byte in storage addressed by EA is loaded into RT[56:63].
32 RT[0:55] are set to 0.
33
34 The sum (RA) + (RB) is placed into register RA.
35
36 If RA=0 or RA=RT, the instruction form is invalid.
37
38 Special Registers Altered:
39
40 None
41
42 # Load Halfword and Zero with Post-Update Indexed
43
44 X-Form
45
46 * lhzupsx RT,RA,RB,SH
47
48 Pseudo-code:
49
50 EA <- (RA)<<(SH+1)
51 RT <- ([0] * (XLEN-16)) || MEM(EA, 2)
52 RA <- (RA) + (RB)
53
54 Description:
55
56 Let the effective address (EA) be the contents of
57 register RA shifted by (SH+1).
58
59 The halfword in storage addressed by EA is loaded into RT[48:63].
60 RT[0:47] are set to 0.
61
62 The sum (RA) + (RB) is placed into register RA.
63
64 If RA=0 or RA=RT, the instruction form is invalid.
65
66 Special Registers Altered:
67
68 None
69
70 # Load Halfword Algebraic with Post-Update Indexed
71
72 X-Form
73
74 * lhaupsx RT,RA,RB,SH
75
76 Pseudo-code:
77
78 EA <- (RA)<<(SH+1)
79 RT <- EXTS(MEM(EA, 2))
80 RA <- (RA) + (RB)
81
82 Description:
83
84 Let the effective address (EA) be the contents of
85 register RA shifted by (SH+1).
86
87 The halfword in storage addressed by EA is loaded into RT[48:63].
88 RT[0:47] are filled with a copy of bit 0 of the loaded halfword.
89
90 The sum (RA) + (RB) is placed into register RA.
91
92 If RA=0 or RA=RT, the instruction form is invalid.
93
94 Special Registers Altered:
95
96 None
97
98 # Load Word and Zero with Post-Update Indexed
99
100 X-Form
101
102 * lwzupsx RT,RA,RB
103
104 Pseudo-code:
105
106 EA <- (RA)
107 RT <- [0] * 32 || MEM(EA, 4)
108 RA <- (RA) + (RB)
109
110 Description:
111
112 Let the effective address (EA) be the register RA.
113
114 The halfword in storage addressed by EA is loaded into RT[48:63].
115 RT[0:47] are filled with a copy of bit 0 of the loaded halfword.
116
117 The sum (RA) + (RB) is placed into register RA.
118
119 If RA=0 or RA=RT, the instruction form is invalid.
120
121 Special Registers Altered:
122
123 None
124
125 # Load Word Algebraic with Post-Update Indexed
126
127 X-Form
128
129 * lwaupsx RT,RA,RB
130
131 Pseudo-code:
132
133 EA <- (RA)
134 RT <- EXTS(MEM(EA, 4))
135 RA <- (RA) + (RB)
136
137 Description:
138
139 Let the effective address (EA) be the register RA.
140
141 The word in storage addressed by EA is loaded into RT[32:63].
142 RT[0:31] are filled with a copy of bit 0 of the loaded word.
143
144 The sum (RA) + (RB) is placed into register RA.
145
146 If RA=0 or RA=RT, the instruction form is invalid.
147
148 Special Registers Altered:
149
150 None
151
152 # Load Doubleword with Post-Update Indexed
153
154 X-Form
155
156 * ldupsx RT,RA,RB
157
158 Pseudo-code:
159
160 EA <- (RA)
161 RT <- MEM(EA, 8)
162 RA <- (RA) + (RB)
163
164 Description:
165
166 Let the effective address (EA) be the register RA.
167
168 The doubleword in storage addressed by EA is loaded into RT.
169
170 The sum (RA) + (RB) is placed into register RA.
171
172 If RA=0 or RA=RT, the instruction form is invalid.
173
174 Special Registers Altered:
175
176 None
177