csrrw

csrrw

Assembleur RISC-V Référence

lyszt.net couvre csrrw et d'autres instructions RISC-V plus en détail.

Description

Écrit une valeur dans un CSR et relit l'ancien contenu. Dans csrrw rd, csr, rs1, la valeur de rs1 remplace le contenu de csr, et le contenu précédent est placé dans rd. Si rd vaut zero, la lecture est ignorée.

Définition officielle

RISC-V Instruction Set Manual

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.

Instructionrd est x0rs1 est x0Lit le CSRÉcrit le CSR
CSRRWOui-NonOui
CSRRWNon-OuiOui
CSRRS/CSRRC-OuiOuiNon
CSRRS/CSRRC-NonOuiOui

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.