csrspseudo

csrs

pseudo
Assembleur RISC-V Référence

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

Description

Définit les bits nommés par un registre dans un CSR. Dans csrs csr, rs, les bits qui valent 1 dans rs sont définis dans csr, et les bits restants conservent leurs valeurs. L'assembleur le développe en csrrs avec la destination zero.

Se développe en

csrrs zero, csr, rs

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.

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 à positionner dans le CSR. Tout bit à l'état haut dans rs1 provoquera le positionnement du bit correspondant dans le CSR, si ce bit du CSR est inscriptible.

ℹ
Étant donné que CSRRS et CSRRC effectuent une opération de lecture-modification-écriture, tout bit lu avec une valeur différente de sa valeur sous-jacente peut être modifié par ces instructions même si le bit correspondant n'est pas positionné dans rs1. Par exemple, pmpaddr__n__[G-1] peut avoir une valeur sous-jacente de 1 mais être lu à 0. L'exécution de CSRRC ou CSRRS pour modifier un autre bit provoquera la lecture de 0 depuis pmpaddr__n__[G-1] puis sa réécriture, mettant à jour la valeur sous-jacente à 0.

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.

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

D'autres pseudo-instructions d'assembleur sont définies pour positionner et effacer des bits dans le CSR lorsque l'ancienne valeur n'est pas requise : CSRS/CSRC csr, rs1 ; CSRSI/CSRCI csr, uimm.