csrrпсевдо

csrr

псевдо
RISC-V Ассемблер Ссылка

lyszt.net охватывает csrr и другие инструкции RISC-V более подробно.

Описание

Читает CSR. В csrr rd, csr содержимое csr попадает в rd. Ассемблер разворачивает это в csrrs с zero, поэтому развёрнутая форма читает, ничего не изменяя.

Разворачивается в

csrrs rd, csr, zero

Ассемблер заменяет эту псевдоинструкцию реальной инструкцией или инструкциями, перечисленными выше.

Официальное определение

RISC-V Instruction Set Manual

Все инструкции 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. Например, pmpaddr__n__[G-1] может иметь базовое значение 1, но читаться как 0. Выполнение CSRRC или CSRRS для изменения другого бита приведёт к чтению 0 из pmpaddr__n__[G-1] и последующей записи обратно, обновляя базовое значение до 0.

Для 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 равно x0rs1 равно 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.