csrrw

csrrw

Assembly RISC-V Referência

lyszt.net aborda csrrw e outras instruções RISC-V com mais detalhes.

Descrição

Grava um valor em um CSR e lê o conteúdo antigo de volta. Em csrrw rd, csr, rs1, o valor em rs1 substitui o conteúdo de csr, e o conteúdo anterior vai para rd. Com rd definido como zero, a leitura é ignorada.

Definição oficial

RISC-V Instruction Set Manual

Todas as instruções CSR realizam leitura-modificação-escrita atômica de um único CSR, cujo especificador CSR é codificado no campo csr de 12 bits da instrução contido nos bits 31-20. As formas imediatas usam um imediato de 5 bits estendido com zeros codificado no campo rs1.

A instrução CSRRW (Atomic Read/Write CSR) troca atomicamente valores nos CSRs e registradores inteiros. CSRRW lê o valor antigo do CSR, estende o valor com zeros para XLEN bits e então o escreve no registrador inteiro rd. O valor inicial em rs1 é escrito no CSR. Se rd=x0, então a instrução não deve ler o CSR e não deve causar nenhum dos efeitos colaterais que poderiam ocorrer em uma leitura de CSR.

Um CSRRW com rs1=x0 tentará escrever zero no CSR de destino.

As variantes CSRRWI, CSRRSI e CSRRCI são semelhantes a CSRRW, CSRRS e CSRRC respectivamente, exceto que atualizam o CSR usando um valor de XLEN bits obtido estendendo com zeros um campo imediato não assinado de 5 bits (uimm[4:0]) codificado no campo rs1 em vez de um valor de um registrador inteiro. Para CSRRSI e CSRRCI, se o campo uimm[4:0] for zero, então essas instruções não escreverão no CSR, e não devem causar nenhum dos efeitos colaterais que poderiam ocorrer de outra forma em uma escrita de CSR, nem levantar exceções de instrução ilegal em acessos a CSRs somente leitura. Para CSRRWI, se rd=x0, então a instrução não deve ler o CSR e não deve causar nenhum dos efeitos colaterais que poderiam ocorrer em uma leitura de CSR. Tanto CSRRSI quanto CSRRCI sempre lerão o CSR e causarão quaisquer efeitos colaterais de leitura independentemente dos campos rd and rs1.

Instruçãord é x0rs1 é x0Lê CSREscreve CSR
CSRRWSim-NãoSim
CSRRWNão-SimSim
CSRRS/CSRRC-SimSimNão
CSRRS/CSRRC-NãoSimSim

Além dos efeitos colaterais que ocorrem como consequência de ler ou escrever um CSR, campos individuais dentro de um CSR podem ter efeitos colaterais quando escritos. As instruções CSRRW[I] acionam efeitos colaterais para todos esses campos dentro do CSR escrito. As instruções CSRRS[I] e CSRRC[I] acionam efeitos colaterais apenas para campos para os quais o argumento rs1 ou uimm tem pelo menos um bit definido correspondente a esse campo.

A pseudoinstrução do montador para ler um CSR, CSRR rd, csr, é codificada como CSRRS rd, csr, x0. A pseudoinstrução do montador para escrever um CSR, CSRW csr, rs1, é codificada como CSRRW x0, csr, rs1, enquanto CSRWI csr, uimm, é codificada como CSRRWI x0, csr, uimm.