csrsпсевдо

csrs

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

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

Описание

Устанавливает биты, указанные регистром, в CSR. В csrs csr, rs биты, равные 1 в rs, устанавливаются в csr, а остальные биты сохраняют свои значения. Ассемблер разворачивает это в csrrs с назначением zero.

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

csrrs zero, csr, rs

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

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

RISC-V Instruction Set Manual

Все инструкции CSR выполняют атомарное чтение-модификацию-запись одного 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.

Определены дополнительные псевдоинструкции ассемблера для установки и сброса битов в CSR, когда старое значение не требуется: CSRS/CSRC csr, rs1; CSRSI/CSRCI csr, uimm.