• Top
    • Documentation
    • Books
    • Boolean-reasoning
    • Projects
    • Debugging
    • Community
    • 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-simple-instantiate-list
                • Vl-simple-instantiate-args-main
                • Vl-simple-inst
              • 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
    • Vl-simple-instantiate

    Vl-simple-instantiate-list

    Generate a bunch of module instances.

    Signature
    (vl-simple-instantiate-list x prefix arglists &key (n '0) 
                                (loc '*vl-fakeloc*)) 
     
      → 
    insts
    Arguments
    x — module to instantiate.
        Guard (vl-module-p x).
    prefix — base name for instances, e.g., prefix_3, prefix_2.
        Guard (stringp prefix).
    arglists — actuals for each instance.
        Guard (vl-exprlistlist-p arglists).
    n — name index, counts up.
        Guard (natp n).
    loc — Guard (vl-location-p loc).
    Returns
    insts — Type (vl-modinstlist-p insts).

    Definitions and Theorems

    Function: vl-simple-instantiate-list-fn

    (defun vl-simple-instantiate-list-fn (x prefix arglists n loc)
      (declare (xargs :guard (and (vl-module-p x)
                                  (stringp prefix)
                                  (vl-exprlistlist-p arglists)
                                  (natp n)
                                  (vl-location-p loc))))
      (let ((__function__ 'vl-simple-instantiate-list))
        (declare (ignorable __function__))
        (if (atom arglists)
            nil
          (cons (vl-simple-instantiate x (cat prefix (natstr n))
                                       (car arglists)
                                       :loc loc)
                (vl-simple-instantiate-list-fn x prefix (cdr arglists)
                                               (+ 1 (lnfix n))
                                               loc)))))

    Theorem: vl-modinstlist-p-of-vl-simple-instantiate-list

    (defthm vl-modinstlist-p-of-vl-simple-instantiate-list
      (b*
       ((insts (vl-simple-instantiate-list-fn x prefix arglists n loc)))
       (vl-modinstlist-p insts))
      :rule-classes :rewrite)

    Theorem: vl-simple-instantiate-list-fn-of-vl-module-fix-x

    (defthm vl-simple-instantiate-list-fn-of-vl-module-fix-x
      (equal (vl-simple-instantiate-list-fn (vl-module-fix x)
                                            prefix arglists n loc)
             (vl-simple-instantiate-list-fn x prefix arglists n loc)))

    Theorem: vl-simple-instantiate-list-fn-vl-module-equiv-congruence-on-x

    (defthm
          vl-simple-instantiate-list-fn-vl-module-equiv-congruence-on-x
     (implies
      (vl-module-equiv x x-equiv)
      (equal
         (vl-simple-instantiate-list-fn x prefix arglists n loc)
         (vl-simple-instantiate-list-fn x-equiv prefix arglists n loc)))
     :rule-classes :congruence)

    Theorem: vl-simple-instantiate-list-fn-of-str-fix-prefix

    (defthm vl-simple-instantiate-list-fn-of-str-fix-prefix
      (equal (vl-simple-instantiate-list-fn x (str-fix prefix)
                                            arglists n loc)
             (vl-simple-instantiate-list-fn x prefix arglists n loc)))

    Theorem: vl-simple-instantiate-list-fn-streqv-congruence-on-prefix

    (defthm vl-simple-instantiate-list-fn-streqv-congruence-on-prefix
     (implies
      (streqv prefix prefix-equiv)
      (equal
         (vl-simple-instantiate-list-fn x prefix arglists n loc)
         (vl-simple-instantiate-list-fn x prefix-equiv arglists n loc)))
     :rule-classes :congruence)

    Theorem: vl-simple-instantiate-list-fn-of-vl-exprlistlist-fix-arglists

    (defthm
          vl-simple-instantiate-list-fn-of-vl-exprlistlist-fix-arglists
      (equal (vl-simple-instantiate-list-fn
                  x prefix (vl-exprlistlist-fix arglists)
                  n loc)
             (vl-simple-instantiate-list-fn x prefix arglists n loc)))

    Theorem: vl-simple-instantiate-list-fn-vl-exprlistlist-equiv-congruence-on-arglists

    (defthm
     vl-simple-instantiate-list-fn-vl-exprlistlist-equiv-congruence-on-arglists
     (implies
      (vl-exprlistlist-equiv arglists arglists-equiv)
      (equal
         (vl-simple-instantiate-list-fn x prefix arglists n loc)
         (vl-simple-instantiate-list-fn x prefix arglists-equiv n loc)))
     :rule-classes :congruence)

    Theorem: vl-simple-instantiate-list-fn-of-nfix-n

    (defthm vl-simple-instantiate-list-fn-of-nfix-n
      (equal (vl-simple-instantiate-list-fn x prefix arglists (nfix n)
                                            loc)
             (vl-simple-instantiate-list-fn x prefix arglists n loc)))

    Theorem: vl-simple-instantiate-list-fn-nat-equiv-congruence-on-n

    (defthm vl-simple-instantiate-list-fn-nat-equiv-congruence-on-n
     (implies
      (acl2::nat-equiv n n-equiv)
      (equal
         (vl-simple-instantiate-list-fn x prefix arglists n loc)
         (vl-simple-instantiate-list-fn x prefix arglists n-equiv loc)))
     :rule-classes :congruence)

    Theorem: vl-simple-instantiate-list-fn-of-vl-location-fix-loc

    (defthm vl-simple-instantiate-list-fn-of-vl-location-fix-loc
      (equal (vl-simple-instantiate-list-fn
                  x
                  prefix arglists n (vl-location-fix loc))
             (vl-simple-instantiate-list-fn x prefix arglists n loc)))

    Theorem: vl-simple-instantiate-list-fn-vl-location-equiv-congruence-on-loc

    (defthm
      vl-simple-instantiate-list-fn-vl-location-equiv-congruence-on-loc
     (implies
      (vl-location-equiv loc loc-equiv)
      (equal
         (vl-simple-instantiate-list-fn x prefix arglists n loc)
         (vl-simple-instantiate-list-fn x prefix arglists n loc-equiv)))
     :rule-classes :congruence)