csrw
pseudolyszt.net couvre csrw et d'autres instructions RISC-V plus en détail.
Description
Écrit un registre dans un CSR. Dans csrw csr, rs, la valeur de rs remplace le contenu de csr. L'assembleur la développe en csrrw avec la destination zero, ce qui ignore la lecture.
Se développe en
csrrw zero, csr, rs
L'assembleur remplace cette pseudo-instruction par la ou les instructions réelles listées ci-dessus.
Définition officielle
Toutes les instructions CSR effectuent une lecture-modification-écriture atomique d'un seul CSR, dont le spécificateur CSR est encodé dans le champ csr de 12 bits de l'instruction contenu dans les bits 31-20. Les formes immédiates utilisent un immédiat de 5 bits étendu par zéros encodé dans le champ rs1.
L'instruction CSRRW (Atomic Read/Write CSR) échange atomiquement les valeurs des CSR et des registres entiers. CSRRW lit l'ancienne valeur du CSR, étend la valeur par zéros sur XLEN bits, puis l'écrit dans le registre entier rd. La valeur initiale de rs1 est écrite dans le CSR. Si rd=x0, alors l'instruction ne doit pas lire le CSR et ne doit pas provoquer les effets de bord qui pourraient se produire lors d'une lecture de CSR.
Un CSRRW avec rs1=x0 tentera d'écrire zéro dans le CSR de destination.
Les variantes CSRRWI, CSRRSI et CSRRCI sont similaires à CSRRW, CSRRS et CSRRC respectivement, sauf qu'elles mettent à jour le CSR en utilisant une valeur de XLEN bits obtenue en étendant par zéros un champ immédiat non signé de 5 bits (uimm[4:0]) encodé dans le champ rs1 au lieu d'une valeur provenant d'un registre entier. Pour CSRRSI et CSRRCI, si le champ uimm[4:0] est nul, alors ces instructions n'écriront pas dans le CSR, et ne doivent pas provoquer les effets de bord qui pourraient autrement se produire lors d'une écriture de CSR, ni lever d'exceptions d'instruction illégale sur les accès aux CSR en lecture seule. Pour CSRRWI, si rd=x0, alors l'instruction ne doit pas lire le CSR et ne doit pas provoquer les effets de bord qui pourraient se produire lors d'une lecture de CSR. CSRRSI et CSRRCI liront toujours le CSR et provoqueront les effets de bord de lecture quels que soient les champs rd and rs1.
| Instruction | rd est x0 | rs1 est x0 | Lit le CSR | Écrit le CSR |
|---|---|---|---|---|
| CSRRW | Oui | - | Non | Oui |
| CSRRW | Non | - | Oui | Oui |
| CSRRS/CSRRC | - | Oui | Oui | Non |
| CSRRS/CSRRC | - | Non | Oui | Oui |
En plus des effets de bord qui se produisent en conséquence d'une lecture ou d'une écriture d'un CSR, des champs individuels d'un CSR peuvent avoir des effets de bord lorsqu'ils sont écrits. Les instructions CSRRW[I] déclenchent les effets de bord pour tous ces champs dans le CSR écrit. Les instructions CSRRS[I] et CSRRC[I] ne déclenchent les effets de bord que pour les champs pour lesquels l'argument rs1 ou uimm a au moins un bit positionné correspondant à ce champ.
Le pseudo-instruction d'assembleur pour lire un CSR, CSRR rd, csr, est encodée comme CSRRS rd, csr, x0. Le pseudo-instruction d'assembleur pour écrire un CSR, CSRW csr, rs1, est encodée comme CSRRW x0, csr, rs1, tandis que CSRWI csr, uimm, est encodée comme CSRRWI x0, csr, uimm.