• Top
  • Documentation
  • Books
  • Boolean-reasoning
  • Projects
  • Debugging
  • Std
  • Proof-automation
  • Macro-libraries
  • ACL2
  • Interfacing-tools
  • Hardware-verification
    • Gl
    • Esim
    • Vl2014
    • Sv
    • Vwsim
    • Fgl
    • Vl
      • Syntax
      • Loader
      • Warnings
      • Getting-started
      • Utilities
      • Printer
      • Kit
      • Mlib
      • Transforms
        • Unparameterization
          • Vl-unparameterize-flow
          • Vl-unparam-inst
          • Vl-unparam-add-to-ledger
          • Vl-scopeinfo-resolve-params
          • Vl-scope-finalize-params
          • Vl-create-unparameterized-interface
          • Vl-create-unparameterized-module
          • Vl-unparam-actualkeys
          • Vl-make-paramdecloverrides
          • Vl-unparam-class
          • Vl-unparam-instlist
          • Vl-create-unparameterized-class
          • Vl-add-lost-interface-warnings
          • Vl-add-lost-module-warnings
          • Vl-unparam-classlist
          • Vl-interfacelist->orignames
          • Vl-user-signature
          • Vl-interfaceport-default-signature
          • Vl-modulelist->orignames
          • Vl-plainarglist-update-ifports
          • Vl-portlist-interface-signatures
          • Vl-user-signatures
          • Vl-plainarg-update-ifports
          • Vl-unparam-inst->instkey
          • Vl-toplevel-signatures
          • Vl-unparam-basename
          • Vl-genblob-resolve-rejoin-scopeitems
          • Vl-gencase-some-match
          • Vl-gencase-match
          • Vl-package-elaborate
          • Vl-unparam-signature
          • Vl-unparam-ledger
          • Vl-packagelist-elaborate
          • Vl-design-elaborate
          • Vl-unparam-actualkey
          • Vl-make-paramdecloverrides-named
          • Vl-unparameterize-main
          • Vl-recover-modules-lost-from-elaboration
          • Vl-finish-unparameterized-interface
          • Vl-paramdecl-set-default
          • Vl-genblob-rejoin-scopeitems
          • Vl-finish-unparameterized-interfaces
          • Vl-unparam-instkey
          • Vl-finish-unparameterized-module
          • Vl-finish-unparameterized-class
          • Vl-finish-unparameterized-modules
          • Vl-finish-unparameterized-classes
          • Vl-genblob-split-scopeitems
          • Vl-user-paramsettings-for-top-names
          • Vl-string/int-alist-to-namedargs
          • Vl-add-lost-interface-warning
          • Vl-unparam-basename-exprstring
          • Vl-add-lost-module-warning
          • Vl-paramdecllist-remove-defaults
          • Vl-ifport-alist
          • Vl-paramdecl-remove-default
          • Vl-ifportexpr->name
          • Vl-paramdecllist-all-localp
          • Vl-unparam-instkeymap
          • Vl-unparam-donelist
          • Vl-unparam-instkeylist
        • Elaborate
        • Addnames
        • Annotate
        • Clean-warnings
        • Eliminitial
        • Custom-transform-hooks
        • Problem-modules
    • X86isa
    • Svl
    • Rtl
  • Software-verification
  • Math
  • Testing-utilities

• Unparameterization

Vl-create-unparameterized-module

Signature

(vl-create-unparameterized-module 
     x name final-paramdecls final-ports 
     elabindex ledger &key (config 'config)) 
 
  → 
(mv new-mod keylist new-elabindex ledger)

Arguments

x — Guard (vl-module-p x).

name — New name including parameter disambiguation.
    Guard (stringp name).

final-paramdecls — Guard (vl-paramdecllist-p final-paramdecls).

final-ports — Guard (vl-portlist-p final-ports).

elabindex — at global level.

ledger — Guard (vl-unparam-ledger-p ledger).

config — Guard (vl-simpconfig-p config).

Returns

new-mod — Type (vl-module-p new-mod).

keylist — signatures for this module.
    Type (vl-unparam-instkeylist-p keylist).

ledger — Type (vl-unparam-ledger-p ledger).

Definitions and Theorems

Function: vl-create-unparameterized-module-fn

(defun vl-create-unparameterized-module-fn
       (x name final-paramdecls
          final-ports elabindex ledger config)
  (declare (xargs :stobjs (elabindex)))
  (declare (xargs :guard (and (vl-module-p x)
                              (stringp name)
                              (vl-paramdecllist-p final-paramdecls)
                              (vl-portlist-p final-ports)
                              (vl-unparam-ledger-p ledger)
                              (vl-simpconfig-p config))))
  (let ((__function__ 'vl-create-unparameterized-module))
    (declare (ignorable __function__))
    (b* ((name (string-fix name))
         (x (change-vl-module x
                              :name name
                              :paramdecls final-paramdecls
                              :ports final-ports))
         ((vl-module x))
         (warnings x.warnings)
         (blob (vl-module->genblob x))
         ((wmv warnings
               keylist new-blob elabindex ledger
               :ctx name)
          (vl-genblob-resolve blob elabindex ledger nil))
         (mod (vl-genblob->module new-blob x))
         (mod (change-vl-module mod
                                :warnings warnings)))
      (mv mod keylist elabindex ledger))))

Theorem: vl-module-p-of-vl-create-unparameterized-module.new-mod

(defthm vl-module-p-of-vl-create-unparameterized-module.new-mod
  (b* (((mv ?new-mod
            ?keylist ?new-elabindex ?ledger)
        (vl-create-unparameterized-module-fn
             x name final-paramdecls
             final-ports elabindex ledger config)))
    (vl-module-p new-mod))
  :rule-classes :rewrite)

Theorem: vl-unparam-instkeylist-p-of-vl-create-unparameterized-module.keylist

(defthm
 vl-unparam-instkeylist-p-of-vl-create-unparameterized-module.keylist
 (b* (((mv ?new-mod
           ?keylist ?new-elabindex ?ledger)
       (vl-create-unparameterized-module-fn
            x name final-paramdecls
            final-ports elabindex ledger config)))
   (vl-unparam-instkeylist-p keylist))
 :rule-classes :rewrite)

Theorem: vl-unparam-ledger-p-of-vl-create-unparameterized-module.ledger

(defthm
     vl-unparam-ledger-p-of-vl-create-unparameterized-module.ledger
  (b* (((mv ?new-mod
            ?keylist ?new-elabindex ?ledger)
        (vl-create-unparameterized-module-fn
             x name final-paramdecls
             final-ports elabindex ledger config)))
    (vl-unparam-ledger-p ledger))
  :rule-classes :rewrite)

Theorem: vl-create-unparameterized-module-fn-of-vl-module-fix-x

(defthm vl-create-unparameterized-module-fn-of-vl-module-fix-x
  (equal (vl-create-unparameterized-module-fn
              (vl-module-fix x)
              name final-paramdecls
              final-ports elabindex ledger config)
         (vl-create-unparameterized-module-fn
              x name final-paramdecls
              final-ports elabindex ledger config)))

Theorem: vl-create-unparameterized-module-fn-vl-module-equiv-congruence-on-x

(defthm
 vl-create-unparameterized-module-fn-vl-module-equiv-congruence-on-x
 (implies (vl-module-equiv x x-equiv)
          (equal (vl-create-unparameterized-module-fn
                      x name final-paramdecls
                      final-ports elabindex ledger config)
                 (vl-create-unparameterized-module-fn
                      x-equiv name final-paramdecls
                      final-ports elabindex ledger config)))
 :rule-classes :congruence)

Theorem: vl-create-unparameterized-module-fn-of-str-fix-name

(defthm vl-create-unparameterized-module-fn-of-str-fix-name
  (equal (vl-create-unparameterized-module-fn
              x (str-fix name)
              final-paramdecls
              final-ports elabindex ledger config)
         (vl-create-unparameterized-module-fn
              x name final-paramdecls
              final-ports elabindex ledger config)))

Theorem: vl-create-unparameterized-module-fn-streqv-congruence-on-name

(defthm
      vl-create-unparameterized-module-fn-streqv-congruence-on-name
  (implies (streqv name name-equiv)
           (equal (vl-create-unparameterized-module-fn
                       x name final-paramdecls
                       final-ports elabindex ledger config)
                  (vl-create-unparameterized-module-fn
                       x name-equiv final-paramdecls
                       final-ports elabindex ledger config)))
  :rule-classes :congruence)

Theorem: vl-create-unparameterized-module-fn-of-vl-paramdecllist-fix-final-paramdecls

(defthm
 vl-create-unparameterized-module-fn-of-vl-paramdecllist-fix-final-paramdecls
 (equal (vl-create-unparameterized-module-fn
             x name
             (vl-paramdecllist-fix final-paramdecls)
             final-ports elabindex ledger config)
        (vl-create-unparameterized-module-fn
             x name final-paramdecls
             final-ports elabindex ledger config)))

Theorem: vl-create-unparameterized-module-fn-vl-paramdecllist-equiv-congruence-on-final-paramdecls

(defthm
 vl-create-unparameterized-module-fn-vl-paramdecllist-equiv-congruence-on-final-paramdecls
 (implies
    (vl-paramdecllist-equiv final-paramdecls final-paramdecls-equiv)
    (equal (vl-create-unparameterized-module-fn
                x name final-paramdecls
                final-ports elabindex ledger config)
           (vl-create-unparameterized-module-fn
                x name final-paramdecls-equiv
                final-ports elabindex ledger config)))
 :rule-classes :congruence)

Theorem: vl-create-unparameterized-module-fn-of-vl-portlist-fix-final-ports

(defthm
 vl-create-unparameterized-module-fn-of-vl-portlist-fix-final-ports
 (equal
  (vl-create-unparameterized-module-fn x name final-paramdecls
                                       (vl-portlist-fix final-ports)
                                       elabindex ledger config)
  (vl-create-unparameterized-module-fn
       x name final-paramdecls
       final-ports elabindex ledger config)))

Theorem: vl-create-unparameterized-module-fn-vl-portlist-equiv-congruence-on-final-ports

(defthm
 vl-create-unparameterized-module-fn-vl-portlist-equiv-congruence-on-final-ports
 (implies (vl-portlist-equiv final-ports final-ports-equiv)
          (equal (vl-create-unparameterized-module-fn
                      x name final-paramdecls
                      final-ports elabindex ledger config)
                 (vl-create-unparameterized-module-fn
                      x
                      name final-paramdecls final-ports-equiv
                      elabindex ledger config)))
 :rule-classes :congruence)

Theorem: vl-create-unparameterized-module-fn-of-vl-unparam-ledger-fix-ledger

(defthm
 vl-create-unparameterized-module-fn-of-vl-unparam-ledger-fix-ledger
 (equal (vl-create-unparameterized-module-fn
             x name final-paramdecls final-ports
             elabindex (vl-unparam-ledger-fix ledger)
             config)
        (vl-create-unparameterized-module-fn
             x name final-paramdecls
             final-ports elabindex ledger config)))

Theorem: vl-create-unparameterized-module-fn-vl-unparam-ledger-equiv-congruence-on-ledger

(defthm
 vl-create-unparameterized-module-fn-vl-unparam-ledger-equiv-congruence-on-ledger
 (implies (vl-unparam-ledger-equiv ledger ledger-equiv)
          (equal (vl-create-unparameterized-module-fn
                      x name final-paramdecls
                      final-ports elabindex ledger config)
                 (vl-create-unparameterized-module-fn
                      x name final-paramdecls final-ports
                      elabindex ledger-equiv config)))
 :rule-classes :congruence)

Theorem: vl-create-unparameterized-module-fn-of-vl-simpconfig-fix-config

(defthm
    vl-create-unparameterized-module-fn-of-vl-simpconfig-fix-config
  (equal (vl-create-unparameterized-module-fn
              x name
              final-paramdecls final-ports elabindex
              ledger (vl-simpconfig-fix config))
         (vl-create-unparameterized-module-fn
              x name final-paramdecls
              final-ports elabindex ledger config)))

Theorem: vl-create-unparameterized-module-fn-vl-simpconfig-equiv-congruence-on-config

(defthm
 vl-create-unparameterized-module-fn-vl-simpconfig-equiv-congruence-on-config
 (implies (vl-simpconfig-equiv config config-equiv)
          (equal (vl-create-unparameterized-module-fn
                      x name final-paramdecls
                      final-ports elabindex ledger config)
                 (vl-create-unparameterized-module-fn
                      x name final-paramdecls final-ports
                      elabindex ledger config-equiv)))
 :rule-classes :congruence)