csrspseudo

csrs

pseudo
Assembly RISC-V Referência

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

Descrição

Define os bits nomeados por um registrador em um CSR. Em csrs csr, rs, os bits que são 1 em rs são definidos em csr, e os bits restantes mantêm seus valores. O montador o expande para csrrs com o destino zero.

Expande para

csrrs zero, csr, rs

O montador substitui esta pseudoinstrução pela instrução ou instruções reais listadas acima.

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 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.

ℹ
Como CSRRS e CSRRC realizam uma operação de leitura-modificação-escrita, quaisquer bits que sejam lidos com um valor diferente do seu valor subjacente podem ser modificados por essas instruções mesmo que o bit correspondente não esteja definido em rs1. Por exemplo, pmpaddr__n__[G-1] pode ter um valor subjacente de 1 mas ser lido como 0. Executar CSRRC ou CSRRS para modificar um bit diferente fará com que 0 seja lido de pmpaddr__n__[G-1] e então escrito de volta, atualizando o valor subjacente para 0.

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 no CSR, nem levantará exceções de instrução ilegal em acessos a CSRs somente leitura. Tanto CSRRS quanto 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 no 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çã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 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 os campos para os quais o argumento rs1 ou uimm tem pelo menos um bit definido correspondente a esse campo.

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

Outras pseudoinstruções de montador são definidas para definir e limpar bits no CSR quando o valor antigo não é necessário: CSRS/CSRC csr, rs1; CSRSI/CSRCI csr, uimm.