csrr
псевдоlyszt.net охватывает csrr и другие инструкции RISC-V более подробно.
Описание
Читает CSR. В csrr rd, csr содержимое csr попадает в rd. Ассемблер разворачивает это в csrrs с zero, поэтому развёрнутая форма читает, ничего не изменяя.
Разворачивается в
csrrs rd, csr, zero
Ассемблер заменяет эту псевдоинструкцию реальной инструкцией или инструкциями, перечисленными выше.
Официальное определение
Все инструкции CSR атомарно выполняют чтение-модификацию-запись одного CSR, спецификатор которого закодирован в 12-битном поле csr инструкции, содержащемся в битах 31-20. Непосредственные формы используют 5-битное непосредственное значение, расширенное нулями, закодированное в поле rs1.
Инструкция CSRRS (Atomic Read and Set Bits in CSR) читает значение CSR, расширяет значение нулями до XLEN бит и записывает его в целочисленный регистр rd. Начальное значение в целочисленном регистре rs1 рассматривается как битовая маска, задающая позиции битов, которые нужно установить в CSR. Любой бит, который высок в rs1, приведёт к установке соответствующего бита в CSR, если этот бит CSR доступен для записи.
Для CSRRS и CSRRC, если rs1=x0, то инструкция вообще не будет записывать в CSR и, следовательно, не вызовет никаких побочных эффектов, которые иначе могли бы возникнуть при записи CSR, а также не вызовет исключений недопустимой инструкции при доступе к CSR только для чтения. И CSRRS, и CSRRC всегда читают адресуемый CSR и вызывают любые побочные эффекты чтения независимо от полей rs1 and rd. Обратите внимание, что если rs1 задаёт регистр, отличный от x0, и этот регистр содержит нулевое значение, инструкция не выполнит никаких сопутствующих побочных эффектов на уровне полей, но выполнит любые побочные эффекты, вызванные записью во весь CSR.
Варианты CSRRWI, CSRRSI и CSRRCI аналогичны CSRRW, CSRRS и CSRRC соответственно, за исключением того, что они обновляют CSR, используя XLEN-битное значение, полученное расширением нулями 5-битного беззнакового непосредственного поля (uimm[4:0]), закодированного в поле rs1, вместо значения из целочисленного регистра. Для CSRRSI и CSRRCI, если поле uimm[4:0] равно нулю, то эти инструкции не будут записывать в CSR и не вызовут никаких побочных эффектов, которые иначе могли бы возникнуть при записи CSR, а также не вызовут исключений недопустимой инструкции при доступе к CSR только для чтения. Для CSRRWI, если rd=x0, то инструкция не будет читать CSR и не вызовет никаких побочных эффектов, которые могли бы возникнуть при чтении CSR. И CSRRSI, и CSRRCI всегда будут читать CSR и вызывать любые побочные эффекты чтения независимо от полей rd and rs1.
| Инструкция | rd равно x0 | rs1 равно x0 | Читает CSR | Записывает CSR |
|---|---|---|---|---|
| CSRRW | Да | - | Нет | Да |
| CSRRW | Нет | - | Да | Да |
| CSRRS/CSRRC | - | Да | Да | Нет |
| CSRRS/CSRRC | - | Нет | Да | Да |
Помимо побочных эффектов, возникающих вследствие чтения или записи CSR, отдельные поля внутри CSR могут иметь побочные эффекты при записи. Инструкции CSRRW[I] выполняют побочные эффекты для всех таких полей в записываемом CSR. Инструкции CSRRS[I] и CSRRC[I] выполняют побочные эффекты только для тех полей, для которых аргумент rs1 или uimm имеет хотя бы один установленный бит, соответствующий этому полю.
Псевдоинструкция ассемблера для чтения CSR, CSRR rd, csr, кодируется как CSRRS rd, csr, x0. Псевдоинструкция ассемблера для записи CSR, CSRW csr, rs1, кодируется как CSRRW x0, csr, rs1, а CSRWI csr, uimm кодируется как CSRRWI x0, csr, uimm.