csrspseudo

csrs

pseudo
Assembly RISC-V Riferimento

lyszt.net tratta csrs e altre istruzioni RISC-V in modo più dettagliato.

Descrizione

Imposta i bit indicati da un registro in un CSR. In csrs csr, rs, i bit che valgono 1 in rs vengono impostati in csr, e i bit rimanenti mantengono i loro valori. L'assembler lo espande in csrrs con la destinazione zero.

Si espande in

csrrs zero, csr, rs

L'assembler sostituisce questa pseudoistruzione con la o le istruzioni reali elencate sopra.

Definizione ufficiale

RISC-V Instruction Set Manual

Tutte le istruzioni CSR eseguono una lettura-modifica-scrittura atomica di un singolo CSR, il cui specificatore CSR è codificato nel campo csr a 12 bit dell'istruzione contenuto nei bit 31-20. Le forme immediate utilizzano un immediato a 5 bit esteso con zeri codificato nel campo rs1.

L'istruzione CSRRS (Atomic Read and Set Bits in CSR) legge il valore del CSR, estende il valore a XLEN bit con zeri e lo scrive nel registro intero rd. Il valore iniziale nel registro intero rs1 è trattato come una maschera di bit che specifica le posizioni dei bit da impostare nel CSR. Qualsiasi bit alto in rs1 causerà l'impostazione del bit corrispondente nel CSR, se quel bit del CSR è scrivibile.

ℹ
Poiché CSRRS e CSRRC eseguono un'operazione di lettura-modifica-scrittura, qualsiasi bit che viene letto con un valore diverso dal suo valore sottostante può essere modificato da queste istruzioni anche se il bit corrispondente non è impostato in rs1. Ad esempio, pmpaddr__n__[G-1] può avere un valore sottostante di 1 ma essere letto come 0. L'esecuzione di CSRRC o CSRRS per modificare un bit diverso causerà la lettura di 0 da pmpaddr__n__[G-1] e quindi la sua riscrittura, aggiornando il valore sottostante a 0.

Per CSRRS e CSRRC, se rs1=x0, allora l'istruzione non scriverà affatto nel CSR, e quindi non causerà nessuno degli effetti collaterali che potrebbero altrimenti verificarsi in una scrittura del CSR, né solleverà eccezioni di istruzione illegale negli accessi a CSR di sola lettura. Sia CSRRS che CSRRC leggono sempre il CSR indirizzato e causano qualsiasi effetto collaterale di lettura indipendentemente dai campi rs1 and rd. Si noti che se rs1 specifica un registro diverso da x0, e quel registro contiene un valore zero, l'istruzione non eseguirà alcun effetto collaterale per campo associato, ma eseguirà qualsiasi effetto collaterale causato dalla scrittura nell'intero CSR.

Le varianti CSRRWI, CSRRSI e CSRRCI sono simili rispettivamente a CSRRW, CSRRS e CSRRC, tranne per il fatto che aggiornano il CSR utilizzando un valore a XLEN bit ottenuto estendendo con zeri un campo immediato senza segno a 5 bit (uimm[4:0]) codificato nel campo rs1 invece di un valore da un registro intero. Per CSRRSI e CSRRCI, se il campo uimm[4:0] è zero, allora queste istruzioni non scriveranno nel CSR, e non causeranno nessuno degli effetti collaterali che potrebbero altrimenti verificarsi in una scrittura del CSR, né solleveranno eccezioni di istruzione illegale negli accessi a CSR di sola lettura. Per CSRRWI, se rd=x0, allora l'istruzione non leggerà il CSR e non causerà nessuno degli effetti collaterali che potrebbero verificarsi in una lettura del CSR. Sia CSRRSI che CSRRCI leggeranno sempre il CSR e causeranno qualsiasi effetto collaterale di lettura indipendentemente dai campi rd and rs1.

Istruzionerd è x0rs1 è x0Legge CSRScrive CSR
CSRRWSì-NoSì
CSRRWNo-SìSì
CSRRS/CSRRC-SìSìNo
CSRRS/CSRRC-NoSìSì

Oltre agli effetti collaterali che si verificano come conseguenza della lettura o scrittura di un CSR, singoli campi all'interno di un CSR possono avere effetti collaterali quando vengono scritti. Le istruzioni CSRRW[I] eseguono effetti collaterali per tutti questi campi all'interno del CSR scritto. Le istruzioni CSRRS[I] e CSRRC[I] eseguono effetti collaterali solo per i campi per i quali l'argomento rs1 o uimm ha almeno un bit impostato corrispondente a quel campo.

La pseudoistruzione dell'assembler per leggere un CSR, CSRR rd, csr, è codificata come CSRRS rd, csr, x0. La pseudoistruzione dell'assembler per scrivere un CSR, CSRW csr, rs1, è codificata come CSRRW x0, csr, rs1, mentre CSRWI csr, uimm, è codificata come CSRRWI x0, csr, uimm.

Ulteriori pseudoistruzioni dell'assembler sono definite per impostare e cancellare bit nel CSR quando il vecchio valore non è richiesto: CSRS/CSRC csr, rs1; CSRSI/CSRCI csr, uimm.