csrrpseudo

csrr

pseudo
Ensamblador RISC-V Referencia

lyszt.net cubre csrr y otras instrucciones RISC-V con más detalle.

Descripción

Lee un CSR. En csrr rd, csr, el contenido de csr va a rd. El ensamblador lo expande a csrrs con zero, por lo que la forma expandida lee sin modificar nada.

Se expande a

csrrs rd, csr, zero

El ensamblador reemplaza esta pseudoinstrucción con la instrucción o instrucciones reales enumeradas arriba.

Definición oficial

RISC-V Instruction Set Manual

Todas las instrucciones CSR leen, modifican y escriben de forma atómica un único CSR, cuyo especificador de CSR está codificado en el campo csr de 12 bits de la instrucción contenido en los bits 31-20. Las formas inmediatas utilizan un inmediato de 5 bits extendido con ceros codificado en el campo rs1.

La instrucción CSRRS (Atomic Read and Set Bits in CSR) lee el valor del CSR, extiende el valor con ceros a XLEN bits y lo escribe en el registro entero rd. El valor inicial del registro entero rs1 se trata como una máscara de bits que especifica las posiciones de bits que se deben establecer en el CSR. Cualquier bit que esté alto en rs1 hará que el bit correspondiente se establezca en el CSR, si ese bit del CSR es escribible.

ℹ
Dado que CSRRS y CSRRC realizan una operación de lectura-modificación-escritura, cualquier bit que se lea con un valor distinto de su valor subyacente puede ser modificado por estas instrucciones incluso si el bit correspondiente no está establecido en rs1. Por ejemplo, pmpaddr__n__[G-1] puede tener un valor subyacente de 1 pero leerse como 0. Ejecutar CSRRC o CSRRS para modificar un bit diferente hará que se lea 0 de pmpaddr__n__[G-1] y luego se vuelva a escribir, actualizando el valor subyacente a 0.

Tanto para CSRRS como para CSRRC, si rs1=x0, entonces la instrucción no escribirá en el CSR en absoluto, y por lo tanto no causará ninguno de los efectos secundarios que de otro modo podrían ocurrir en una escritura de CSR, ni generará excepciones de instrucción ilegal en accesos a CSR de solo lectura. Tanto CSRRS como CSRRC siempre leen el CSR direccionado y causan cualquier efecto secundario de lectura independientemente de los campos rs1 and rd. Tenga en cuenta que si rs1 especifica un registro distinto de x0, y ese registro contiene un valor cero, la instrucción no ejecutará ningún efecto secundario por campo asociado, pero ejecutará cualquier efecto secundario causado por la escritura en el CSR completo.

Las variantes CSRRWI, CSRRSI y CSRRCI son similares a CSRRW, CSRRS y CSRRC respectivamente, excepto que actualizan el CSR utilizando un valor de XLEN bits obtenido al extender con ceros un campo inmediato sin signo de 5 bits (uimm[4:0]) codificado en el campo rs1 en lugar de un valor de un registro entero. Para CSRRSI y CSRRCI, si el campo uimm[4:0] es cero, entonces estas instrucciones no escribirán en el CSR, y no causarán ninguno de los efectos secundarios que de otro modo podrían ocurrir en una escritura de CSR, ni generarán excepciones de instrucción ilegal en accesos a CSR de solo lectura. Para CSRRWI, si rd=x0, entonces la instrucción no leerá el CSR y no causará ninguno de los efectos secundarios que podrían ocurrir en una lectura de CSR. Tanto CSRRSI como CSRRCI siempre leerán el CSR y causarán cualquier efecto secundario de lectura independientemente de los campos rd and rs1.

Instrucciónrd es x0rs1 es x0Lee CSREscribe CSR
CSRRWSí-NoSí
CSRRWNo-SíSí
CSRRS/CSRRC-SíSíNo
CSRRS/CSRRC-NoSíSí

Además de los efectos secundarios que ocurren como consecuencia de leer o escribir un CSR, los campos individuales dentro de un CSR podrían tener efectos secundarios cuando se escriben. Las instrucciones CSRRW[I] ejecutan efectos secundarios para todos esos campos dentro del CSR escrito. Las instrucciones CSRRS[I] y CSRRC[I] solo ejecutan efectos secundarios para los campos para los cuales el argumento rs1 o uimm tiene al menos un bit establecido correspondiente a ese campo.

La pseudoinstrucción del ensamblador para leer un CSR, CSRR rd, csr, se codifica como CSRRS rd, csr, x0. La pseudoinstrucción del ensamblador para escribir un CSR, CSRW csr, rs1, se codifica como CSRRW x0, csr, rs1, mientras que CSRWI csr, uimm, se codifica como CSRRWI x0, csr, uimm.