csrr
pseudolyszt.net aborda csrr e outras instruções RISC-V com mais detalhes.
Descrição
Lê um CSR. Em csrr rd, csr, o conteúdo de csr vai para rd. O montador o expande para csrrs com zero, então a forma expandida lê sem modificar nada.
Expande para
csrrs rd, csr, zero
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 CSRRS (Atomic Read and Set Bits in CSR) lê o valor do CSR, estende o valor para XLEN bits com zeros e o escreve no registrador inteiro rd. O valor inicial no registrador inteiro rs1 é tratado como uma máscara de bits que especifica as posições de bits a serem definidas no CSR. Qualquer bit que esteja alto em rs1 fará com que o bit correspondente seja definido no CSR, se esse bit do CSR for gravável.
Para CSRRS e CSRRC, se rs1=x0, então a instrução não escreverá no CSR de forma alguma, e portanto não 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. CSRRS e CSRRC sempre leem o CSR endereçado e causam quaisquer efeitos colaterais de leitura independentemente dos campos rs1 and rd. Observe que se rs1 especifica um registrador diferente de x0, e esse registrador contém um valor zero, a instrução não executará nenhum efeito colateral por campo associado, mas executará quaisquer efeitos colaterais causados pela escrita no CSR inteiro.
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 causarão nenhum dos efeitos colaterais que poderiam ocorrer de outra forma em uma escrita de CSR, nem levantarão exceções de instrução ilegal em acessos a CSRs somente leitura. Para CSRRWI, se rd=x0, então a instrução não lerá o CSR e não 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 da leitura ou escrita de um CSR, campos individuais dentro de um CSR podem ter efeitos colaterais quando escritos. As instruções CSRRW[I] executam efeitos colaterais para todos esses campos dentro do CSR escrito. As instruções CSRRS[I] e CSRRC[I] executam 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.