csrrw

csrrw

RISC-V Ассемблер Ссылка

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

Описание

Записывает значение в CSR и считывает обратно предыдущее содержимое. В csrrw rd, csr, rs1 значение в rs1 заменяет содержимое csr, а предыдущее содержимое переходит в rd. Если rd установлен в zero, чтение пропускается.

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

RISC-V Instruction Set Manual

Все инструкции CSR атомарно выполняют чтение-модификацию-запись одного CSR, спецификатор CSR которого закодирован в 12-битном поле csr инструкции, находящемся в битах 31-20. Непосредственные формы используют 5-битное непосредственное значение, расширенное нулями, закодированное в поле rs1.

Инструкция CSRRW (Atomic Read/Write CSR) атомарно обменивает значения в CSR и целочисленных регистрах. CSRRW читает старое значение CSR, расширяет значение нулями до XLEN бит, затем записывает его в целочисленный регистр rd. Исходное значение в rs1 записывается в CSR. Если rd=x0, то инструкция не должна читать CSR и не должна вызывать каких-либо побочных эффектов, которые могли бы возникнуть при чтении CSR.

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