csrrw
lyszt.net behandelt csrrw und andere RISC-V-Befehle ausführlicher.
Beschreibung
Schreibt einen Wert in ein CSR und liest den alten Inhalt zurück. In csrrw rd, csr, rs1 ersetzt der Wert in rs1 den Inhalt von csr, und der vorherige Inhalt wird nach rd geschrieben. Ist rd auf zero gesetzt, wird das Lesen übersprungen.
Offizielle Definition
Alle CSR-Instruktionen führen ein atomares Lesen-Ändern-Schreiben eines einzelnen CSR durch, dessen CSR-Spezifizierer im 12-Bit-csr-Feld der Instruktion in den Bits 31-20 kodiert ist. Die Immediate-Formen verwenden ein 5-Bit-null-erweitertes Immediate, das im rs1-Feld kodiert ist.
Die CSRRW-Instruktion (Atomic Read/Write CSR) tauscht Werte in den CSRs und Integer-Registern atomar aus. CSRRW liest den alten Wert des CSR, null-erweitert den Wert auf XLEN Bits und schreibt ihn dann in das Integer-Register rd. Der Anfangswert in rs1 wird in den CSR geschrieben. Wenn rd=x0, dann darf die Instruktion den CSR nicht lesen und darf keine der Nebenwirkungen verursachen, die bei einem CSR-Lesevorgang auftreten könnten.
Ein CSRRW mit rs1=x0 versucht, Null in den Ziel-CSR zu schreiben.
Die Varianten CSRRWI, CSRRSI und CSRRCI ähneln CSRRW, CSRRS bzw. CSRRC, außer dass sie den CSR mit einem XLEN-Bit-Wert aktualisieren, der durch Null-Erweiterung eines 5-Bit-unsignierten-Immediate-Felds (uimm[4:0]) erhalten wird, das im rs1-Feld kodiert ist, anstatt mit einem Wert aus einem Integer-Register. Für CSRRSI und CSRRCI gilt: Wenn das uimm[4:0]-Feld null ist, dann schreiben diese Instruktionen nicht in den CSR und dürfen keine der Nebenwirkungen verursachen, die andernfalls bei einem CSR-Schreibvorgang auftreten könnten, noch Ausnahmen für illegale Instruktionen bei Zugriffen auf schreibgeschützte CSRs auslösen. Für CSRRWI gilt: Wenn rd=x0, dann darf die Instruktion den CSR nicht lesen und darf keine der Nebenwirkungen verursachen, die bei einem CSR-Lesevorgang auftreten könnten. Sowohl CSRRSI als auch CSRRCI lesen immer den CSR und verursachen alle Lese-Nebenwirkungen unabhängig von den Feldern rd and rs1.
| Instruktion | rd ist x0 | rs1 ist x0 | Liest CSR | Schreibt CSR |
|---|---|---|---|---|
| CSRRW | Ja | - | Nein | Ja |
| CSRRW | Nein | - | Ja | Ja |
| CSRRS/CSRRC | - | Ja | Ja | Nein |
| CSRRS/CSRRC | - | Nein | Ja | Ja |
Zusätzlich zu den Nebenwirkungen, die als Folge des Lesens oder Schreibens eines CSR auftreten, können einzelne Felder innerhalb eines CSR Nebenwirkungen beim Schreiben haben. Die CSRRW[I]-Instruktionen lösen Nebenwirkungen für alle solchen Felder innerhalb des geschriebenen CSR aus. Die CSRRS[I]- und CSRRC[I]-Instruktionen lösen Nebenwirkungen nur für Felder aus, für die das rs1- oder uimm-Argument mindestens ein Bit gesetzt hat, das diesem Feld entspricht.
Die Assembler-Pseudoinstruktion zum Lesen eines CSR, CSRR rd, csr, ist als CSRRS rd, csr, x0 kodiert. Die Assembler-Pseudoinstruktion zum Schreiben eines CSR, CSRW csr, rs1, ist als CSRRW x0, csr, rs1 kodiert, während CSRWI csr, uimm als CSRRWI x0, csr, uimm kodiert ist.