csrcPseudoelement

csrc

Pseudoelement
RISC-V Assembler Referenz

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

Beschreibung

Löscht die durch ein Register benannten Bits in einem CSR. In csrc csr, rs werden Bits, die in rs den Wert 1 haben, in csr gelöscht, und die übrigen Bits behalten ihre Werte. Der Assembler expandiert sie zu csrrc mit dem Ziel zero.

Wird erweitert zu

csrrc zero, csr, rs

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 ein atomares Lesen-Ändern-Schreiben eines 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 Instruktion CSRRC (Atomic Read and Clear Bits in CSR) liest den Wert des CSR, null-erweitert den Wert auf XLEN Bits und schreibt ihn in das Integer-Register rd. Der Anfangswert im Integer-Register rs1 wird als Bitmaske behandelt, die die Bitpositionen angibt, die im CSR gelöscht werden sollen. Jedes Bit, das in rs1 hoch ist, bewirkt, dass das entsprechende Bit im CSR gelöscht wird, sofern dieses CSR-Bit beschreibbar ist.

ℹ
Da CSRRS und CSRRC eine Lese-Ändere-Schreibe-Operation durchfü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 von 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. Sowohl CSRRS als auch 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 sind ähnlich zu CSRRW, CSRRS bzw. CSRRC, außer dass sie das CSR mit einem XLEN-Bit-Wert aktualisieren, der durch Null-Erweiterung eines 5-Bit-unsignierten-Immediate-Felds (uimm[4:0]) erhalten 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.

Weitere Assembler-Pseudoinstruktionen sind definiert, um Bits im CSR zu setzen und zu löschen, wenn der alte Wert nicht benötigt wird: CSRS/CSRC csr, rs1; CSRSI/CSRCI csr, uimm.