• Top
  • Documentation
  • Books
  • Boolean-reasoning
  • Projects
  • Debugging
  • Std
  • Proof-automation
  • Macro-libraries
  • ACL2
  • Interfacing-tools
  • Hardware-verification
    • Gl
    • Esim
    • Vl2014
    • Sv
    • Fgl
    • Vwsim
    • 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-package-elaborate

Resolve parameters in packages.

Signature

(vl-package-elaborate x elabindex warnings &key (config 'config)) 
  → 
(mv ok warnings1 new-elabindex new-x)

Arguments

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

elabindex — design level.

warnings — Guard (vl-warninglist-p warnings).

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

Returns

warnings1 — Type (vl-warninglist-p warnings1).

new-x — Type (vl-package-p new-x).

Assumption: packages reference each other only in reverse parse order, i.e., later-defined packages can reference parameters inside earlier-defined packages. This gets around some horrible complications in implementation. We still have to do some convoluted stuff with scopestacks.

Definitions and Theorems

Function: vl-package-elaborate-fn

(defun vl-package-elaborate-fn (x elabindex warnings config)
  (declare (xargs :stobjs (elabindex)))
  (declare (xargs :guard (and (vl-package-p x)
                              (vl-warninglist-p warnings)
                              (vl-simpconfig-p config))))
  (let ((__function__ 'vl-package-elaborate))
    (declare (ignorable __function__))
    (b* ((x (vl-package-fix x))
         (warnings (vl-warninglist-fix warnings))
         (elabindex (vl-elabindex-push x))
         ((wmv ok warnings new-x elabindex)
          (vl-package-elaborate-aux
               x elabindex
               :reclimit (vl-simpconfig->elab-limit config)))
         (elabindex (vl-elabindex-undo)))
      (mv ok warnings elabindex new-x))))

Theorem: vl-warninglist-p-of-vl-package-elaborate.warnings1

(defthm vl-warninglist-p-of-vl-package-elaborate.warnings1
  (b* (((mv ?ok ?warnings1 ?new-elabindex ?new-x)
        (vl-package-elaborate-fn x elabindex warnings config)))
    (vl-warninglist-p warnings1))
  :rule-classes :rewrite)

Theorem: vl-package-p-of-vl-package-elaborate.new-x

(defthm vl-package-p-of-vl-package-elaborate.new-x
  (b* (((mv ?ok ?warnings1 ?new-elabindex ?new-x)
        (vl-package-elaborate-fn x elabindex warnings config)))
    (vl-package-p new-x))
  :rule-classes :rewrite)

Theorem: vl-package-elaborate-fn-of-vl-package-fix-x

(defthm vl-package-elaborate-fn-of-vl-package-fix-x
  (equal (vl-package-elaborate-fn (vl-package-fix x)
                                  elabindex warnings config)
         (vl-package-elaborate-fn x elabindex warnings config)))

Theorem: vl-package-elaborate-fn-vl-package-equiv-congruence-on-x

(defthm vl-package-elaborate-fn-vl-package-equiv-congruence-on-x
 (implies
  (vl-package-equiv x x-equiv)
  (equal
       (vl-package-elaborate-fn x elabindex warnings config)
       (vl-package-elaborate-fn x-equiv elabindex warnings config)))
 :rule-classes :congruence)

Theorem: vl-package-elaborate-fn-of-vl-warninglist-fix-warnings

(defthm vl-package-elaborate-fn-of-vl-warninglist-fix-warnings
 (equal
    (vl-package-elaborate-fn x
                             elabindex (vl-warninglist-fix warnings)
                             config)
    (vl-package-elaborate-fn x elabindex warnings config)))

Theorem: vl-package-elaborate-fn-vl-warninglist-equiv-congruence-on-warnings

(defthm
 vl-package-elaborate-fn-vl-warninglist-equiv-congruence-on-warnings
 (implies
  (vl-warninglist-equiv warnings warnings-equiv)
  (equal
       (vl-package-elaborate-fn x elabindex warnings config)
       (vl-package-elaborate-fn x elabindex warnings-equiv config)))
 :rule-classes :congruence)

Theorem: vl-package-elaborate-fn-of-vl-simpconfig-fix-config

(defthm vl-package-elaborate-fn-of-vl-simpconfig-fix-config
  (equal
       (vl-package-elaborate-fn x elabindex
                                warnings (vl-simpconfig-fix config))
       (vl-package-elaborate-fn x elabindex warnings config)))

Theorem: vl-package-elaborate-fn-vl-simpconfig-equiv-congruence-on-config

(defthm
   vl-package-elaborate-fn-vl-simpconfig-equiv-congruence-on-config
 (implies
  (vl-simpconfig-equiv config config-equiv)
  (equal
       (vl-package-elaborate-fn x elabindex warnings config)
       (vl-package-elaborate-fn x elabindex warnings config-equiv)))
 :rule-classes :congruence)