• Top
  • Documentation
  • Books
  • Boolean-reasoning
  • Projects
  • Debugging
  • Std
  • Proof-automation
  • Macro-libraries
  • ACL2
  • Interfacing-tools
  • Hardware-verification
    • Gl
    • Esim
    • Vl2014
      • Warnings
      • Primitives
      • Use-set
      • Syntax
      • Getting-started
      • Utilities
      • Loader
      • Transforms
        • Expression-sizing
        • Occform
          • Vl-mux-occform
          • Vl-basic-binary-op-occform
          • Vl-occform-mkports
          • Vl-unary-reduction-op-occform
          • Vl-make-n-bit-mux
          • Vl-bitselect-occform
          • Vl-assign-occform
          • Vl-plusminus-occform
          • Vl-shift-occform
          • Vl-gte-occform
          • Vl-plain-occform
          • Vl-unary-not-occform
          • Vl-rem-occform
          • Vl-div-occform
          • Vl-ceq-occform
          • Vl-mult-occform
          • Vl-make-n-bit-dynamic-bitselect-m
          • Vl-simple-instantiate
          • Vl-occform-mkwires
          • Vl-assignlist-occform
          • Vl-occform-argfix
          • Vl-make-n-bit-unsigned-gte
          • Vl-make-2^n-bit-dynamic-bitselect
          • Vl-make-n-bit-div-rem
          • Vl-make-n-bit-plusminus
          • Vl-make-n-bit-signed-gte
          • Vl-make-n-bit-shr-by-m-bits
          • Vl-make-n-bit-shl-by-m-bits
          • Vl-occform-mkport
          • Vl-make-n-bit-dynamic-bitselect
          • Vl-make-n-bit-reduction-op
          • Vl-make-n-bit-adder-core
          • Vl-make-n-bit-xdetect
          • Vl-make-n-bit-x-propagator
          • Vl-make-n-bit-shl-place-p
          • Vl-make-n-bit-shr-place-p
          • Vl-make-n-bit-mult
          • Vl-occform-mkwire
          • Vl-make-nedgeflop-vec
          • Vl-make-n-bit-binary-op
          • Vl-make-list-of-netdecls
          • Vl-make-n-bit-delay-1
          • Vl-make-n-bit-zmux
          • *vl-2-bit-dynamic-bitselect*
          • Vl-make-n-bit-unsigned-rem
          • Vl-make-n-bit-unsigned-div
          • Vl-make-n-bit-shr-place-ps
          • Vl-make-n-bit-shl-place-ps
          • Vl-make-n-bit-assign
          • Vl-make-n-bit-x
          • Vl-make-n-bit-ceq
          • Vl-make-n-bit-xor-each
          • Vl-make-n-bit-not
          • Vl-make-1-bit-delay-m
          • Vl-make-n-bit-delay-m
          • *vl-1-bit-signed-gte*
          • *vl-1-bit-div-rem*
          • *vl-1-bit-adder-core*
          • Vl-make-nedgeflop
          • *vl-1-bit-mult*
          • *vl-1-bit-dynamic-bitselect*
        • Oprewrite
        • Expand-functions
        • Delayredux
        • Unparameterization
        • Caseelim
        • Split
        • Selresolve
        • Weirdint-elim
        • Vl-delta
        • Replicate-insts
        • Rangeresolve
        • Propagate
        • Clean-selects
        • Clean-params
        • Blankargs
        • Inline-mods
        • Expr-simp
        • Trunc
        • Always-top
        • Gatesplit
        • Gate-elim
        • Expression-optimization
        • Elim-supplies
        • Wildelim
        • Drop-blankports
        • Clean-warnings
        • Addinstnames
        • Custom-transform-hooks
        • Annotate
        • Latchcode
        • Elim-unused-vars
        • Problem-modules
      • Lint
      • Mlib
      • Server
      • Kit
      • Printer
      • Esim-vl
      • Well-formedness
    • Sv
    • Fgl
    • Vwsim
    • Vl
    • X86isa
    • Svl
    • Rtl
  • Software-verification
  • Math
  • Testing-utilities

• Occform

Vl-occform-mkwires

Helper function for creating lists of net declarations.

Signature

(vl-occform-mkwires prefix i n &key width (loc '*vl-fakeloc*)) 
  → 
(mv exprs decls)

Arguments

prefix — name prefix for each wire.
    Guard (stringp prefix).

i — starting index, inclusive!.
    Guard (natp i).

n — ending index, non-inclusive!.
    Guard (natp n).

width — width of each wire.
    Guard (posp width).

loc — Guard (vl-location-p loc).

Returns

exprs — Type (vl-exprlist-p exprs).

decls — Type (vl-vardecllist-p decls).

We generate a list of net declarations,

wire [width-1:0] prefix_i;
...
wire [width-1:0] prefix_{n-1};

And return these declarations, along with the corresponding expressions with sizes pre-computed.

Definitions and Theorems

Function: vl-occform-mkwires-fn

(defun vl-occform-mkwires-fn (prefix i n width loc)
 (declare (xargs :guard (and (stringp prefix)
                             (natp i)
                             (natp n)
                             (posp width)
                             (vl-location-p loc))))
 (declare (xargs :guard (<= i n)))
 (let ((__function__ 'vl-occform-mkwires))
  (declare (ignorable __function__))
  (b*
   (((when (mbe :logic (zp (- (lnfix n) (lnfix i)))
                :exec (eql i n)))
     (mv nil nil))
    (width (lposfix width))
    (name (hons-copy (cat prefix (natstr i))))
    (expr (vl-idexpr name width :vl-unsigned))
    (type
       (make-vl-coretype :name :vl-logic
                         :pdims (list (vl-make-n-bit-range width))))
    (decl (make-vl-vardecl :name name
                           :type type
                           :nettype :vl-wire
                           :loc loc))
    ((mv rest-exprs rest-decls)
     (vl-occform-mkwires prefix (+ 1 (lnfix i))
                         n
                         :width width
                         :loc loc)))
   (mv (cons expr rest-exprs)
       (cons decl rest-decls)))))

Theorem: vl-exprlist-p-of-vl-occform-mkwires.exprs

(defthm vl-exprlist-p-of-vl-occform-mkwires.exprs
  (b* (((mv ?exprs ?decls)
        (vl-occform-mkwires-fn prefix i n width loc)))
    (vl-exprlist-p exprs))
  :rule-classes :rewrite)

Theorem: vl-vardecllist-p-of-vl-occform-mkwires.decls

(defthm vl-vardecllist-p-of-vl-occform-mkwires.decls
  (b* (((mv ?exprs ?decls)
        (vl-occform-mkwires-fn prefix i n width loc)))
    (vl-vardecllist-p decls))
  :rule-classes :rewrite)

Theorem: vl-occform-mkwires-fn-mvtypes-0

(defthm vl-occform-mkwires-fn-mvtypes-0
  (true-listp (mv-nth 0
                      (vl-occform-mkwires-fn prefix i n width loc)))
  :rule-classes :type-prescription)

Theorem: vl-occform-mkwires-fn-mvtypes-1

(defthm vl-occform-mkwires-fn-mvtypes-1
  (true-listp (mv-nth 1
                      (vl-occform-mkwires-fn prefix i n width loc)))
  :rule-classes :type-prescription)

Theorem: len-of-vl-occform-mkwires

(defthm len-of-vl-occform-mkwires
  (b* (((mv exprs decls)
        (vl-occform-mkwires prefix i n
                            :width width
                            :loc loc)))
    (and (equal (len exprs)
                (nfix (- (nfix n) (nfix i))))
         (equal (len decls)
                (nfix (- (nfix n) (nfix i)))))))

Theorem: vl-occform-mkwires-under-iff

(defthm vl-occform-mkwires-under-iff
  (b* (((mv exprs decls)
        (vl-occform-mkwires prefix i n
                            :width width
                            :loc loc)))
    (and (iff exprs (posp (- (nfix n) (nfix i))))
         (iff decls (posp (- (nfix n) (nfix i)))))))

Theorem: vl-occform-mkwires-fn-of-str-fix-prefix

(defthm vl-occform-mkwires-fn-of-str-fix-prefix
  (equal (vl-occform-mkwires-fn (str-fix prefix)
                                i n width loc)
         (vl-occform-mkwires-fn prefix i n width loc)))

Theorem: vl-occform-mkwires-fn-streqv-congruence-on-prefix

(defthm vl-occform-mkwires-fn-streqv-congruence-on-prefix
  (implies
       (streqv prefix prefix-equiv)
       (equal (vl-occform-mkwires-fn prefix i n width loc)
              (vl-occform-mkwires-fn prefix-equiv i n width loc)))
  :rule-classes :congruence)

Theorem: vl-occform-mkwires-fn-of-nfix-i

(defthm vl-occform-mkwires-fn-of-nfix-i
  (equal (vl-occform-mkwires-fn prefix (nfix i)
                                n width loc)
         (vl-occform-mkwires-fn prefix i n width loc)))

Theorem: vl-occform-mkwires-fn-nat-equiv-congruence-on-i

(defthm vl-occform-mkwires-fn-nat-equiv-congruence-on-i
  (implies
       (acl2::nat-equiv i i-equiv)
       (equal (vl-occform-mkwires-fn prefix i n width loc)
              (vl-occform-mkwires-fn prefix i-equiv n width loc)))
  :rule-classes :congruence)

Theorem: vl-occform-mkwires-fn-of-nfix-n

(defthm vl-occform-mkwires-fn-of-nfix-n
  (equal (vl-occform-mkwires-fn prefix i (nfix n)
                                width loc)
         (vl-occform-mkwires-fn prefix i n width loc)))

Theorem: vl-occform-mkwires-fn-nat-equiv-congruence-on-n

(defthm vl-occform-mkwires-fn-nat-equiv-congruence-on-n
  (implies
       (acl2::nat-equiv n n-equiv)
       (equal (vl-occform-mkwires-fn prefix i n width loc)
              (vl-occform-mkwires-fn prefix i n-equiv width loc)))
  :rule-classes :congruence)

Theorem: vl-occform-mkwires-fn-of-pos-fix-width

(defthm vl-occform-mkwires-fn-of-pos-fix-width
  (equal (vl-occform-mkwires-fn prefix i n (pos-fix width)
                                loc)
         (vl-occform-mkwires-fn prefix i n width loc)))

Theorem: vl-occform-mkwires-fn-pos-equiv-congruence-on-width

(defthm vl-occform-mkwires-fn-pos-equiv-congruence-on-width
  (implies
       (acl2::pos-equiv width width-equiv)
       (equal (vl-occform-mkwires-fn prefix i n width loc)
              (vl-occform-mkwires-fn prefix i n width-equiv loc)))
  :rule-classes :congruence)

Theorem: vl-occform-mkwires-fn-of-vl-location-fix-loc

(defthm vl-occform-mkwires-fn-of-vl-location-fix-loc
 (equal
      (vl-occform-mkwires-fn prefix i n width (vl-location-fix loc))
      (vl-occform-mkwires-fn prefix i n width loc)))

Theorem: vl-occform-mkwires-fn-vl-location-equiv-congruence-on-loc

(defthm vl-occform-mkwires-fn-vl-location-equiv-congruence-on-loc
  (implies
       (vl-location-equiv loc loc-equiv)
       (equal (vl-occform-mkwires-fn prefix i n width loc)
              (vl-occform-mkwires-fn prefix i n width loc-equiv)))
  :rule-classes :congruence)