• 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
    • Vwsim
    • Fgl
    • Vl
    • X86isa
    • Svl
    • Rtl
  • Software-verification
  • Math
  • Testing-utilities

• Occform

Vl-occform-mkports

Helper function for creating lists of port declarations.

Signature

(vl-occform-mkports prefix i n &key dir width (loc '*vl-fakeloc*)) 
  → 
(mv exprs ports portdecls vardecls)

Arguments

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

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

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

dir — direction of each port.
    Guard (vl-direction-p dir).

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

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

Returns

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

ports — Type (vl-portlist-p ports).

portdecls — Type (vl-portdecllist-p portdecls).

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

Definitions and Theorems

Function: vl-occform-mkports-fn

(defun vl-occform-mkports-fn (prefix i n dir width loc)
  (declare (xargs :guard (and (stringp prefix)
                              (natp i)
                              (natp n)
                              (vl-direction-p dir)
                              (posp width)
                              (vl-location-p loc))))
  (declare (xargs :guard (<= i n)))
  (let ((__function__ 'vl-occform-mkports))
    (declare (ignorable __function__))
    (b* (((when (mbe :logic (zp (- (lnfix n) (lnfix i)))
                     :exec (eql i n)))
          (mv nil nil nil nil))
         (name1 (hons-copy (cat prefix (natstr i))))
         ((mv expr1 port1 portdecl1 vardecl1)
          (vl-occform-mkport name1 dir width))
         ((mv exprs2 ports2 portdecls2 vardecls2)
          (vl-occform-mkports prefix (+ 1 (lnfix i))
                              n
                              :dir dir
                              :width width
                              :loc loc)))
      (mv (cons expr1 exprs2)
          (cons port1 ports2)
          (cons portdecl1 portdecls2)
          (cons vardecl1 vardecls2)))))

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

(defthm vl-exprlist-p-of-vl-occform-mkports.exprs
  (b* (((mv ?exprs ?ports ?portdecls ?vardecls)
        (vl-occform-mkports-fn prefix i n dir width loc)))
    (vl-exprlist-p exprs))
  :rule-classes :rewrite)

Theorem: vl-portlist-p-of-vl-occform-mkports.ports

(defthm vl-portlist-p-of-vl-occform-mkports.ports
  (b* (((mv ?exprs ?ports ?portdecls ?vardecls)
        (vl-occform-mkports-fn prefix i n dir width loc)))
    (vl-portlist-p ports))
  :rule-classes :rewrite)

Theorem: vl-portdecllist-p-of-vl-occform-mkports.portdecls

(defthm vl-portdecllist-p-of-vl-occform-mkports.portdecls
  (b* (((mv ?exprs ?ports ?portdecls ?vardecls)
        (vl-occform-mkports-fn prefix i n dir width loc)))
    (vl-portdecllist-p portdecls))
  :rule-classes :rewrite)

Theorem: vl-vardecllist-p-of-vl-occform-mkports.vardecls

(defthm vl-vardecllist-p-of-vl-occform-mkports.vardecls
  (b* (((mv ?exprs ?ports ?portdecls ?vardecls)
        (vl-occform-mkports-fn prefix i n dir width loc)))
    (vl-vardecllist-p vardecls))
  :rule-classes :rewrite)

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

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

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

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

Theorem: vl-occform-mkports-fn-mvtypes-2

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

Theorem: vl-occform-mkports-fn-mvtypes-3

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

Theorem: len-of-vl-occform-mkports

(defthm len-of-vl-occform-mkports
  (b* (((mv exprs ports portdecls vardecls)
        (vl-occform-mkports prefix i n
                            :dir dir
                            :width width
                            :loc loc))
       (len (nfix (- (nfix n) (nfix i)))))
    (and (equal (len exprs) len)
         (equal (len ports) len)
         (equal (len portdecls) len)
         (equal (len vardecls) len))))

Theorem: vl-occform-mkports-under-iff

(defthm vl-occform-mkports-under-iff
  (b* (((mv exprs ports portdecls vardecls)
        (vl-occform-mkports prefix i n
                            :dir dir
                            :width width
                            :loc loc))
       (len (- (nfix n) (nfix i))))
    (and (iff exprs (posp len))
         (iff ports (posp len))
         (iff portdecls (posp len))
         (iff vardecls (posp len)))))

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

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

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

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

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

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

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

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

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

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

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

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

Theorem: vl-occform-mkports-fn-of-vl-direction-fix-dir

(defthm vl-occform-mkports-fn-of-vl-direction-fix-dir
  (equal (vl-occform-mkports-fn prefix i n (vl-direction-fix dir)
                                width loc)
         (vl-occform-mkports-fn prefix i n dir width loc)))

Theorem: vl-occform-mkports-fn-vl-direction-equiv-congruence-on-dir

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

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

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

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

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

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

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

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

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