csrr
疑似lyszt.netはcsrrおよびその他のRISC-V命令をより詳しく扱っています。
説明
CSR を読み取ります。csrr rd, csr では、csr の内容が rd に格納されます。アセンブラはこれを zero を伴う csrrs に展開するため、展開後の形式は何も変更せずに読み取ります。
展開先
csrrs rd, csr, zero
アセンブラはこの疑似命令を、上記に示された実際の命令または複数の命令に置き換えます。
公式の定義
すべてのCSR命令は、単一のCSRをアトミックに読み出し・変更・書き込みします。そのCSR指定子は、ビット31-20に保持される命令の12ビットのcsrフィールドにエンコードされます。即値形式では、rs1フィールドにエンコードされた5ビットのゼロ拡張即値を使用します。
CSRRS(CSRのアトミック読み出しとビット設定)命令は、CSRの値を読み出し、その値をXLENビットにゼロ拡張して、整数レジスタrdに書き込みます。整数レジスタrs1の初期値は、CSR内で設定するビット位置を指定するビットマスクとして扱われます。rs1でハイになっているビットは、そのCSRビットが書き込み可能であれば、CSR内の対応するビットを設定します。
CSRRSとCSRRCの両方について、rs1=x0の場合、命令はCSRにまったく書き込みを行わないため、CSR書き込みで発生する可能性のある副作用を一切引き起こさず、読み出し専用CSRへのアクセスで不正命令例外も発生させません。CSRRSとCSRRCはどちらも、rs1 and rdフィールドに関係なく、アドレス指定されたCSRを常に読み出し、読み出しの副作用を引き起こします。rs1がx0以外のレジスタを指定し、そのレジスタがゼロ値を保持している場合、命令は付随するフィールド単位の副作用を実行しませんが、CSR全体への書き込みによって生じる副作用は実行します。
CSRRWI、CSRRSI、CSRRCIの各変種は、それぞれCSRRW、CSRRS、CSRRCと同様ですが、整数レジスタからの値ではなく、rs1フィールドにエンコードされた5ビットの符号なし即値(uimm[4:0])フィールドをゼロ拡張して得たXLENビット値を使用してCSRを更新します。CSRRSIとCSRRCIについて、uimm[4:0]フィールドがゼロの場合、これらの命令はCSRに書き込みを行わず、CSR書き込みで発生する可能性のある副作用を一切引き起こさず、読み出し専用CSRへのアクセスで不正命令例外も発生させません。CSRRWIについて、rd=x0の場合、命令はCSRを読み出さず、CSR読み出しで発生する可能性のある副作用を一切引き起こしません。CSRRSIとCSRRCIはどちらも、rd and rs1フィールドに関係なく、常にCSRを読み出し、読み出しの副作用を引き起こします。
| 命令 | rdがx0 | rs1がx0 | CSR読み出し | CSR書き込み |
|---|---|---|---|---|
| CSRRW | はい | - | いいえ | はい |
| CSRRW | いいえ | - | はい | はい |
| CSRRS/CSRRC | - | はい | はい | いいえ |
| CSRRS/CSRRC | - | いいえ | はい | はい |
CSRの読み出しまたは書き込みの結果として発生する副作用に加えて、CSR内の個々のフィールドは書き込み時に副作用を持つ場合があります。CSRRW[I]命令は、書き込まれたCSR内のそのようなすべてのフィールドの副作用を実行します。CSRRS[I]およびCSRRC[I]命令は、rs1またはuimm引数がそのフィールドに対応する少なくとも1つのビットが設定されているフィールドについてのみ、副作用を実行します。
CSRを読み出すアセンブラ疑似命令CSRR rd, csrは、CSRRS rd, csr, x0としてエンコードされます。CSRを書き込むアセンブラ疑似命令CSRW csr, rs1は、CSRRW x0, csr, rs1としてエンコードされ、CSRWI csr, uimmは、CSRRWI x0, csr, uimmとしてエンコードされます。