instret

Instructions retired counter for RDINSTRET Instruction

Alias for M-mode CSR minstret.

Privilege mode access is controlled with mcounteren.IR, scounteren.IR, and hcounteren.IR as follows:

mcounteren.IR

scounteren.IR

hcounteren.IR

instret behavior

S-mode

U-mode

VS-mode

VU-mode

0

-

-

IllegalInstruction

IllegalInstruction

IllegalInstruction

IllegalInstruction

1

0

0

read-only

IllegalInstruction

VirtualInstruction

VirtualInstruction

1

1

0

read-only

read-only

VirtualInstruction

VirtualInstruction

1

0

1

read-only

IllegalInstruction

read-only

VirtualInstruction

1

1

1

read-only

read-only

read-only

read-only

Attributes

Defining Extension

  • Zicntr, version >= Zicntr@2.0.0

CSR Address

0xc02

Length

64-bit

Privilege Mode

U

Format

instret format
Figure 1. instret format

Field Summary

Name Location Type Reset Value

instret.COUNT

63:0

RO-H

0

Fields

COUNT

Location

63:0

Description

Alias of minstret.COUNT.

Type

RO-H

Reset value

0

Software read

This CSR may return a value that is different from what is stored in hardware.

if (%%LINK%func;mode;mode%%() == PrivilegeMode::S) {
  if (%%LINK%csr_field;mcounteren.IR;CSR[mcounteren].IR%% == 1'b0) {
    %%LINK%func;raise;raise%%(ExceptionCode::IllegalInstruction, %%LINK%func;mode;mode%%(), $encoding);
  }
} else if (%%LINK%func;mode;mode%%() == PrivilegeMode::U) {
  if (%%LINK%csr_field;misa.S;CSR[misa].S%% == 1'b1) {
    if ((%%LINK%csr_field;mcounteren.IR;CSR[mcounteren].IR%% & %%LINK%csr_field;scounteren.IR;CSR[scounteren].IR%%) == 1'b0) {
      %%LINK%func;raise;raise%%(ExceptionCode::IllegalInstruction, %%LINK%func;mode;mode%%(), $encoding);
    }
  } else if (%%LINK%csr_field;mcounteren.IR;CSR[mcounteren].IR%% == 1'b0) {
    %%LINK%func;raise;raise%%(ExceptionCode::IllegalInstruction, %%LINK%func;mode;mode%%(), $encoding);
  }
} else if (%%LINK%func;mode;mode%%() == PrivilegeMode::VS) {
  if (%%LINK%csr_field;hcounteren.IR;CSR[hcounteren].IR%% == 1'b0 && %%LINK%csr_field;mcounteren.IR;CSR[mcounteren].IR%% == 1'b1) {
    %%LINK%func;raise;raise%%(ExceptionCode::VirtualInstruction, %%LINK%func;mode;mode%%(), $encoding);
  } else if (%%LINK%csr_field;mcounteren.IR;CSR[mcounteren].IR%% == 1'b0) {
    %%LINK%func;raise;raise%%(ExceptionCode::IllegalInstruction, %%LINK%func;mode;mode%%(), $encoding);
  }
} else if (%%LINK%func;mode;mode%%() == PrivilegeMode::VU) {
  if (%%LINK%csr_field;hcounteren.IR;CSR[hcounteren].IR%% & %%LINK%csr_field;scounteren.IR;CSR[scounteren].IR%%) == 1'b0) && (%%LINK%csr_field;mcounteren.IR;CSR[mcounteren].IR%% == 1'b1 {
    %%LINK%func;raise;raise%%(ExceptionCode::VirtualInstruction, %%LINK%func;mode;mode%%(), $encoding);
  } else if (%%LINK%csr_field;mcounteren.IR;CSR[mcounteren].IR%% == 1'b0) {
    %%LINK%func;raise;raise%%(ExceptionCode::IllegalInstruction, %%LINK%func;mode;mode%%(), $encoding);
  }
}
return %%LINK%csr_field;minstret.COUNT;CSR[minstret].COUNT%%;