csrrPseudoelement

csrr

Pseudoelement
RISC-V Assembler Referenz

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

Beschreibung

Liest ein CSR. In csrr rd, csr wird der Inhalt von csr nach rd geschrieben. Der Assembler erweitert dies zu csrrs mit zero, sodass die erweiterte Form liest, ohne etwas zu verändern.

Wird erweitert zu

csrrs rd, csr, zero

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-Immediate mit Nullerweiterung, das im Feld rs1 kodiert ist.

Die Instruktion CSRRS (Atomic Read and Set Bits in CSR) liest den Wert des CSR, erweitert den Wert mit Nullen auf XLEN Bits und schreibt ihn in das Integer-Register rd. Der Anfangswert im Integer-Register rs1 wird als Bitmaske behandelt, die die im CSR zu setzenden Bitpositionen angibt. Jedes Bit, das in rs1 hoch ist, bewirkt, dass das entsprechende Bit im CSR gesetzt wird, sofern dieses CSR-Bit beschreibbar ist.

ℹ
Da CSRRS und CSRRC einen Lese-Ändere-Schreibe-Vorgang ausführen, können alle Bits, die mit einem anderen Wert als ihrem zugrunde liegenden Wert gelesen werden, durch diese Instruktionen geändert werden, selbst wenn das entsprechende Bit in rs1 nicht gesetzt ist. Beispielsweise kann pmpaddr__n__[G-1] einen zugrunde liegenden Wert von 1 haben, aber als 0 gelesen werden. Das Ausführen von CSRRC oder CSRRS zum Ändern eines anderen Bits bewirkt, dass 0 aus pmpaddr__n__[G-1] gelesen und dann zurückgeschrieben wird, wodurch der zugrunde liegende Wert auf 0 aktualisiert wird.

Für CSRRS und CSRRC gilt: Wenn rs1=x0, dann schreibt die Instruktion überhaupt nicht in das CSR und verursacht daher keine der Nebenwirkungen, die andernfalls bei einem CSR-Schreibvorgang auftreten könnten, noch löst sie Ausnahmen für illegale Instruktionen bei Zugriffen auf schreibgeschützte CSRs aus. CSRRS und CSRRC lesen immer das adressierte CSR und verursachen alle Lese-Nebenwirkungen unabhängig von den Feldern rs1 and rd. Beachten Sie, dass wenn rs1 ein anderes Register als x0 angibt und dieses Register einen Nullwert enthält, die Instruktion keine begleitenden feldbezogenen Nebenwirkungen ausführt, aber alle Nebenwirkungen ausführt, die durch das Schreiben in das gesamte CSR verursacht werden.

Die Varianten CSRRWI, CSRRSI und CSRRCI ähneln CSRRW, CSRRS bzw. CSRRC, außer dass sie das CSR mit einem XLEN-Bit-Wert aktualisieren, der durch Nullerweiterung eines 5-Bit-Immediate-Felds ohne Vorzeichen (uimm[4:0]) gewonnen wird, das im Feld rs1 kodiert ist, anstelle eines Werts aus einem Integer-Register. Für CSRRSI und CSRRCI gilt: Wenn das Feld uimm[4:0] null ist, dann schreiben diese Instruktionen nicht in das 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. Für CSRRWI gilt: Wenn rd=x0, dann liest die Instruktion das CSR nicht und verursacht keine der Nebenwirkungen, die bei einem CSR-Lesevorgang auftreten könnten. Sowohl CSRRSI als auch CSRRCI lesen immer das CSR und verursachen alle Lese-Nebenwirkungen unabhängig von den Feldern rd and rs1.

Instruktionrd ist x0rs1 ist x0Liest CSRSchreibt CSR
CSRRWJa-NeinJa
CSRRWNein-JaJa
CSRRS/CSRRC-JaJaNein
CSRRS/CSRRC-NeinJaJa

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 Instruktionen CSRRW[I] führen Nebenwirkungen für alle solchen Felder innerhalb des geschriebenen CSR aus. Die Instruktionen CSRRS[I] und CSRRC[I] führen Nebenwirkungen nur für Felder aus, für die das Argument rs1 oder uimm 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.