csrs
Pseudoelementlyszt.net behandelt csrs und andere RISC-V-Befehle ausführlicher.
Beschreibung
Setzt die durch ein Register benannten Bits in einem CSR. In csrs csr, rs werden Bits, die in rs 1 sind, in csr gesetzt, und die übrigen Bits behalten ihre Werte. Der Assembler expandiert es zu csrrs mit dem Ziel zero.
Wird erweitert zu
csrrs zero, csr, rs
Der Assembler ersetzt diese Pseudoanweisung durch die oben aufgeführte(n) echte(n) Anweisung(en).
Offizielle Definition
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 CSRRS (Atomic Read and Set 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 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.
Für CSRRS und CSRRC gilt: Wenn rs1=x0, dann schreibt die Instruktion überhaupt nicht in den 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 den adressierten 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 den gesamten CSR verursacht werden.
Die Varianten CSRRWI, CSRRSI und CSRRCI sind ähnlich zu 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 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 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. Für 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 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 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 die 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.
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.