csrw
pseudolyszt.net aborda csrw e outras instruções RISC-V com mais detalhes.
Descrição
Grava um registrador em um CSR. Em csrw csr, rs, o valor em rs substitui o conteúdo de csr. O montador a expande para csrrw com o destino zero, o que ignora a leitura.
Expande para
csrrw zero, csr, rs
O montador substitui esta pseudoinstrução pela instrução ou instruções reais listadas acima.
Definição oficial
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ção | rd é x0 | rs1 é x0 | Lê CSR | Escreve CSR |
|---|---|---|---|---|
| CSRRW | Sim | - | Não | Sim |
| CSRRW | Não | - | Sim | Sim |
| CSRRS/CSRRC | - | Sim | Sim | Não |
| CSRRS/CSRRC | - | Não | Sim | Sim |
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.