csrs
псевдоlyszt.net охватывает csrs и другие инструкции RISC-V более подробно.
Описание
Устанавливает биты, указанные регистром, в CSR. В csrs csr, rs биты, равные 1 в rs, устанавливаются в csr, а остальные биты сохраняют свои значения. Ассемблер разворачивает это в csrrs с назначением zero.
Разворачивается в
csrrs zero, csr, rs
Ассемблер заменяет эту псевдоинструкцию реальной инструкцией или инструкциями, перечисленными выше.
Официальное определение
Все инструкции 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=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.
Определены дополнительные псевдоинструкции ассемблера для установки и сброса битов в CSR, когда старое значение не требуется: CSRS/CSRC csr, rs1; CSRSI/CSRCI csr, uimm.