csrwipseudo

csrwi

pseudo
Assembleur RISC-V Référence

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

Description

Écrit une constante de 5 bits dans un CSR. Dans csrwi csr, uimm, la valeur de 0 à 31 remplace le contenu de csr. Le champ de constante est large de cinq bits ; pour écrire une valeur plus grande, passez-la par un registre avec csrw.

Se développe en

csrrwi zero, csr, uimm

L'assembleur remplace cette pseudo-instruction par la ou les instructions réelles listées ci-dessus.

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.

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 de 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.

Instructionrd est x0uimm=0Lit le CSRÉcrit le CSR
CSRRWIOui-NonOui
CSRRWINon-OuiOui
CSRRSI/CSRRCI-OuiOuiNon
CSRRSI/CSRRCI-NonOuiOui

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.