		Search-engine friendly clone of the ACL2 documentation.

Missing-parents

Exec-bne

Semantics of the BNE instruction [ISA:2.5.2].

Signature
(exec-bne rs1 rs2 imm pc stat feat) → new-stat
Arguments: rs1 — Guard (ubyte5p rs1).; rs2 — Guard (ubyte5p rs2).; imm — Guard (ubyte12p imm).; stat — Guard (statp stat).; feat — Guard (featp feat).
Returns: new-stat — Type (statp new-stat).

We read two unsigned XLEN-bit integers from rs1 and rs2. We use the 12 bits of the immediate as the high bits of a 13-bit integer, whose low bit is 0 (i.e. the immediate measures multiples of 2); the unsigned 13-bit integer is sign-extended to XLEN bits, obtaining an offset. We add the offset to the address of the instruction, which is passed as the pc input to this function; this is the branch target. We compare the two integers from the registers: if they are not equal, we write the branch target to the program counter; otherwise, we increment the program counter.

Definitions and Theorems

Function: exec-bne

(defun exec-bne (rs1 rs2 imm pc stat feat)
  (declare (xargs :guard (and (ubyte5p rs1)
                              (ubyte5p rs2)
                              (ubyte12p imm)
                              (statp stat)
                              (featp feat))))
  (declare (xargs :guard (and (stat-validp stat feat)
                              (cond ((feat-32p feat) (ubyte32p pc))
                                    ((feat-64p feat) (ubyte64p pc))
                                    (t (impossible))))))
  (let ((__function__ 'exec-bne))
    (declare (ignorable __function__))
    (b* ((rs1-operand (read-xreg-unsigned (ubyte5-fix rs1)
                                          stat feat))
         (rs2-operand (read-xreg-unsigned (ubyte5-fix rs2)
                                          stat feat))
         (offset (loghead (feat->xlen feat)
                          (logext 13 (ash (ubyte12-fix imm) 1))))
         (target-pc (+ pc offset))
         (stat (if (/= rs1-operand rs2-operand)
                   (write-pc target-pc stat feat)
                 (inc4-pc stat feat))))
      stat)))

Theorem: statp-of-exec-bne

(defthm statp-of-exec-bne
  (b* ((new-stat (exec-bne rs1 rs2 imm pc stat feat)))
    (statp new-stat))
  :rule-classes :rewrite)

Theorem: exec-bne-of-ubyte5-fix-rs1

(defthm exec-bne-of-ubyte5-fix-rs1
  (equal (exec-bne (ubyte5-fix rs1)
                   rs2 imm pc stat feat)
         (exec-bne rs1 rs2 imm pc stat feat)))

Theorem: exec-bne-ubyte5-equiv-congruence-on-rs1

(defthm exec-bne-ubyte5-equiv-congruence-on-rs1
  (implies (ubyte5-equiv rs1 rs1-equiv)
           (equal (exec-bne rs1 rs2 imm pc stat feat)
                  (exec-bne rs1-equiv rs2 imm pc stat feat)))
  :rule-classes :congruence)

Theorem: exec-bne-of-ubyte5-fix-rs2

(defthm exec-bne-of-ubyte5-fix-rs2
  (equal (exec-bne rs1 (ubyte5-fix rs2)
                   imm pc stat feat)
         (exec-bne rs1 rs2 imm pc stat feat)))

Theorem: exec-bne-ubyte5-equiv-congruence-on-rs2

(defthm exec-bne-ubyte5-equiv-congruence-on-rs2
  (implies (ubyte5-equiv rs2 rs2-equiv)
           (equal (exec-bne rs1 rs2 imm pc stat feat)
                  (exec-bne rs1 rs2-equiv imm pc stat feat)))
  :rule-classes :congruence)

Theorem: exec-bne-of-ubyte12-fix-imm

(defthm exec-bne-of-ubyte12-fix-imm
  (equal (exec-bne rs1 rs2 (ubyte12-fix imm)
                   pc stat feat)
         (exec-bne rs1 rs2 imm pc stat feat)))

Theorem: exec-bne-ubyte12-equiv-congruence-on-imm

(defthm exec-bne-ubyte12-equiv-congruence-on-imm
  (implies (acl2::ubyte12-equiv imm imm-equiv)
           (equal (exec-bne rs1 rs2 imm pc stat feat)
                  (exec-bne rs1 rs2 imm-equiv pc stat feat)))
  :rule-classes :congruence)

Theorem: exec-bne-of-stat-fix-stat

(defthm exec-bne-of-stat-fix-stat
  (equal (exec-bne rs1 rs2 imm pc (stat-fix stat)
                   feat)
         (exec-bne rs1 rs2 imm pc stat feat)))

Theorem: exec-bne-stat-equiv-congruence-on-stat

(defthm exec-bne-stat-equiv-congruence-on-stat
  (implies (stat-equiv stat stat-equiv)
           (equal (exec-bne rs1 rs2 imm pc stat feat)
                  (exec-bne rs1 rs2 imm pc stat-equiv feat)))
  :rule-classes :congruence)

Theorem: exec-bne-of-feat-fix-feat

(defthm exec-bne-of-feat-fix-feat
  (equal (exec-bne rs1 rs2 imm pc stat (feat-fix feat))
         (exec-bne rs1 rs2 imm pc stat feat)))

Theorem: exec-bne-feat-equiv-congruence-on-feat

(defthm exec-bne-feat-equiv-congruence-on-feat
  (implies (feat-equiv feat feat-equiv)
           (equal (exec-bne rs1 rs2 imm pc stat feat)
                  (exec-bne rs1 rs2 imm pc stat feat-equiv)))
  :rule-classes :congruence)