csrrw

csrrw

Ensamblador RISC-V Referencia

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

Descripción

Escribe un valor en un CSR y vuelve a leer el contenido anterior. En csrrw rd, csr, rs1, el valor de rs1 reemplaza el contenido de csr, y el contenido anterior pasa a rd. Con rd establecido en zero, se omite la lectura.

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 se codifica en el campo csr de 12 bits de la instrucción contenido en los bits 31-20. Las formas inmediatas usan un inmediato de 5 bits extendido con ceros codificado en el campo rs1.

La instrucción CSRRW (Atomic Read/Write CSR) intercambia atómicamente los valores de los CSR y los registros enteros. CSRRW lee el valor antiguo del CSR, extiende el valor con ceros a XLEN bits y luego lo escribe en el registro entero rd. El valor inicial en rs1 se escribe en el CSR. Si rd=x0, entonces la instrucción no debe leer el CSR ni causar ninguno de los efectos secundarios que podrían ocurrir en una lectura de CSR.

Un CSRRW con rs1=x0 intentará escribir cero en el CSR de destino.

Las variantes CSRRWI, CSRRSI y CSRRCI son similares a CSRRW, CSRRS y CSRRC respectivamente, excepto que actualizan el CSR usando 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 deben causar ninguno de los efectos secundarios que podrían ocurrir de otro modo en una escritura de CSR, ni generar excepciones de instrucción ilegal en accesos a CSR de solo lectura. Para CSRRWI, si rd=x0, entonces la instrucción no debe leer el CSR ni 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 al escribirse. Las instrucciones CSRRW[I] aplican efectos secundarios para todos esos campos dentro del CSR escrito. Las instrucciones CSRRS[I] y CSRRC[I] solo aplican 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.