csrwiPseudoelement

csrwi

Pseudoelement
RISC-V Assembler Referenz

lyszt.net behandelt csrwi und andere RISC-V-Befehle ausführlicher.

Beschreibung

Schreibt eine 5-Bit-Konstante in ein CSR. In csrwi csr, uimm ersetzt der Wert 0 bis 31 den Inhalt von csr. Das Konstantenfeld ist fünf Bit breit; um einen größeren Wert zu schreiben, übergib ihn über ein Register mit csrw.

Wird erweitert zu

csrrwi zero, csr, uimm

Der Assembler ersetzt diese Pseudoanweisung durch die oben aufgeführte(n) echte(n) Anweisung(en).

Offizielle Definition

RISC-V Instruction Set Manual

Alle CSR-Instruktionen führen einen atomaren Lese-Ändere-Schreibe-Vorgang an einem einzelnen CSR durch, dessen CSR-Spezifizierer im 12-Bit-Feld csr der Instruktion in den Bits 31-20 kodiert ist. Die Immediate-Formen verwenden ein 5-Bit-null-erweitertes Immediate, das im Feld rs1 kodiert ist.

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]) im Feld rs1 anstelle eines Werts aus einem Integer-Register gewonnen wird. Bei CSRRSI und CSRRCI gilt: Wenn das Feld uimm[4:0] null ist, schreiben diese Instruktionen nicht in den CSR und verursachen keine der Nebenwirkungen, die andernfalls bei einem CSR-Schreibvorgang auftreten könnten, noch lösen sie Ausnahmen für illegale Instruktionen bei Zugriffen auf schreibgeschützte CSRs aus. Bei CSRRWI gilt: Wenn rd=x0, dann liest die Instruktion den CSR nicht und verursacht keine der Nebenwirkungen, die bei einem CSR-Lesevorgang auftreten könnten. Sowohl CSRRSI als auch CSRRCI lesen stets den CSR und verursachen jegliche Lese-Nebenwirkungen unabhängig von den Feldern rd and rs1.

Instruktionrd ist x0uimm=0Liest CSRSchreibt CSR
CSRRWIJa-NeinJa
CSRRWINein-JaJa
CSRRSI/CSRRCI-JaJaNein
CSRRSI/CSRRCI-NeinJaJa

Die Assembler-Pseudoinstruktion zum Lesen eines CSR, CSRR rd, csr, wird als CSRRS rd, csr, x0 kodiert. Die Assembler-Pseudoinstruktion zum Schreiben eines CSR, CSRW csr, rs1, wird als CSRRW x0, csr, rs1 kodiert, während CSRWI csr, uimm als CSRRWI x0, csr, uimm kodiert wird.