csrr
pseudolyszt.net couvre csrr et d'autres instructions RISC-V plus en détail.
Description
Lit un CSR. Dans csrr rd, csr, le contenu de csr est placé dans rd. L'assembleur le développe en csrrs avec zero, de sorte que la forme développée effectue une lecture sans rien modifier.
Se développe en
csrrs rd, csr, zero
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 CSRRS (Atomic Read and Set Bits in CSR) lit la valeur du CSR, étend la valeur à XLEN bits par zéros et l'écrit dans le registre entier rd. La valeur initiale du registre entier rs1 est traitée comme un masque de bits qui spécifie les positions de bits à définir dans le CSR. Tout bit qui est à 1 dans rs1 provoquera la mise à 1 du bit correspondant dans le CSR, si ce bit du CSR est inscriptible.
Pour CSRRS et CSRRC, si rs1=x0, alors l'instruction n'écrira pas du tout dans le CSR, et ne provoquera donc aucun des effets de bord qui pourraient autrement se produire lors d'une écriture dans un CSR, ni ne lèvera d'exceptions d'instruction illégale lors d'accès à des CSR en lecture seule. CSRRS et CSRRC lisent toujours le CSR adressé et provoquent tout effet de bord de lecture quels que soient les champs rs1 and rd. Notez que si rs1 spécifie un registre autre que x0, et que ce registre contient une valeur nulle, l'instruction n'effectuera aucun effet de bord par champ associé, mais effectuera tout effet de bord causé par l'écriture dans le CSR entier.
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 provoqueront aucun des effets de bord qui pourraient autrement se produire lors d'une écriture dans un CSR, ni ne lèveront d'exceptions d'instruction illégale lors d'accès à des CSR en lecture seule. Pour CSRRWI, si rd=x0, alors l'instruction ne lira pas le CSR et ne provoquera aucun des effets de bord qui pourraient se produire lors d'une lecture de CSR. CSRRSI et CSRRCI liront toujours le CSR et provoqueront tout effet 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 de la lecture ou de l'écriture d'un CSR, des champs individuels au sein d'un CSR peuvent avoir des effets de bord lorsqu'ils sont écrits. Les instructions CSRRW[I] effectuent les effets de bord pour tous ces champs au sein du CSR écrit. Les instructions CSRRS[I] et CSRRC[I] n'effectuent les effets de bord que pour les champs pour lesquels l'argument rs1 ou uimm a au moins un bit défini 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.