• Top
  • Documentation
  • Books
  • Boolean-reasoning
  • Projects
  • Debugging
  • Std
  • Proof-automation
  • Macro-libraries
  • ACL2
  • Interfacing-tools
  • Hardware-verification
    • Gl
    • Esim
    • Vl2014
      • Warnings
      • Primitives
        • *vl-1-bit-approx-mux*
        • *vl-1-bit-mux*
        • Nedgeflop
          • Vl-make-same-bitselect-from-each
          • Vl-primitive-mkports
          • Vl-nedgeflop-ifstmt
          • Vl-make-1-bit-n-edge-flop
          • Vl-make-nedgeflop-insts
          • Vl-nedgeflop-always
          • Vl-nedgeflop-clkedge-assigns
          • Vl-nedgeflop-update-sexpr
          • Vl-nedgeflop-e-wires
          • Vl-make-delay-assigns
          • Vl-nedgeflop-posedge-clks
          • Vl-nedgeflop-data-mux
          • Vl-nedgeflop-some-edge-sexpr
          • Vl-modinsts-add-atts
          • Vl-nedgeflop-or-edges
        • Vl-primitive-mkport
        • *vl-1-bit-assign*
        • *vl-1-bit-zmux*
        • Vl-primitive-mkwire
        • *vl-1-bit-bufif1*
        • *vl-1-bit-bufif0*
        • *vl-1-bit-delay-1*
        • *vl-1-bit-ceq*
        • *vl-1-bit-buf*
        • *vl-1-bit-rcmos*
        • *vl-1-bit-latch*
        • *vl-1-bit-cmos*
        • *vl-1-bit-power*
        • *vl-1-bit-rpmos*
        • *vl-1-bit-rnmos*
        • *vl-1-bit-pmos*
        • *vl-1-bit-nmos*
        • *vl-1-bit-ground*
        • *vl-1-bit-tranif1*
        • *vl-1-bit-tranif0*
        • *vl-1-bit-rtranif1*
        • *vl-1-bit-rtranif0*
        • *vl-1-bit-rtran*
        • *vl-1-bit-tran*
        • *vl-1-bit-notif1*
        • *vl-1-bit-notif0*
        • *vl-1-bit-and*
        • *vl-1-bit-xor*
        • *vl-1-bit-xnor*
        • *vl-1-bit-pullup*
        • *vl-1-bit-pulldown*
        • *vl-1-bit-or*
        • *vl-1-bit-not*
        • *vl-1-bit-nor*
        • *vl-1-bit-nand*
        • *vl-1-bit-z*
        • *vl-1-bit-x*
        • *vl-1-bit-t*
        • *vl-1-bit-f*
      • Use-set
      • Syntax
      • Getting-started
      • Utilities
      • Loader
      • Transforms
      • Lint
      • Mlib
      • Server
      • Kit
      • Printer
      • Esim-vl
      • Well-formedness
    • Sv
    • Fgl
    • Vwsim
    • Vl
    • X86isa
    • Svl
    • Rtl
  • Software-verification
  • Math
  • Testing-utilities

• Nedgeflop

Vl-primitive-mkports

Helper function for creating lists of primitive port declarations.

Signature

(vl-primitive-mkports prefix i n &key dir (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).

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

Returns

exprs — Type (vl-exprlist-p exprs), given the guard.

ports — Type (vl-portlist-p ports), given the guard.

portdecls — Type (vl-portdecllist-p portdecls), given the guard.

vardecls — Type (vl-vardecllist-p vardecls), given the guard.

Definitions and Theorems

Function: vl-primitive-mkports-fn

(defun vl-primitive-mkports-fn (prefix i n dir loc)
  (declare (xargs :guard (and (stringp prefix)
                              (natp i)
                              (natp n)
                              (vl-direction-p dir)
                              (vl-location-p loc))))
  (declare (xargs :guard (<= i n)))
  (let ((__function__ 'vl-primitive-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-primitive-mkport name1 dir))
         ((mv exprs2 ports2 portdecls2 vardecls2)
          (vl-primitive-mkports prefix (+ 1 (lnfix i))
                                n
                                :dir dir
                                :loc loc)))
      (mv (cons expr1 exprs2)
          (cons port1 ports2)
          (cons portdecl1 portdecls2)
          (cons vardecl1 vardecls2)))))

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

(defthm vl-exprlist-p-of-vl-primitive-mkports.exprs
  (implies (and (force (stringp prefix))
                (force (natp i))
                (force (natp n))
                (force (vl-direction-p dir))
                (force (vl-location-p loc))
                (force (not (< n i))))
           (b* (((mv ?exprs ?ports ?portdecls ?vardecls)
                 (vl-primitive-mkports-fn prefix i n dir loc)))
             (vl-exprlist-p exprs)))
  :rule-classes :rewrite)

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

(defthm vl-portlist-p-of-vl-primitive-mkports.ports
  (implies (and (force (stringp prefix))
                (force (natp i))
                (force (natp n))
                (force (vl-direction-p dir))
                (force (vl-location-p loc))
                (force (not (< n i))))
           (b* (((mv ?exprs ?ports ?portdecls ?vardecls)
                 (vl-primitive-mkports-fn prefix i n dir loc)))
             (vl-portlist-p ports)))
  :rule-classes :rewrite)

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

(defthm vl-portdecllist-p-of-vl-primitive-mkports.portdecls
  (implies (and (force (stringp prefix))
                (force (natp i))
                (force (natp n))
                (force (vl-direction-p dir))
                (force (vl-location-p loc))
                (force (not (< n i))))
           (b* (((mv ?exprs ?ports ?portdecls ?vardecls)
                 (vl-primitive-mkports-fn prefix i n dir loc)))
             (vl-portdecllist-p portdecls)))
  :rule-classes :rewrite)

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

(defthm vl-vardecllist-p-of-vl-primitive-mkports.vardecls
  (implies (and (force (stringp prefix))
                (force (natp i))
                (force (natp n))
                (force (vl-direction-p dir))
                (force (vl-location-p loc))
                (force (not (< n i))))
           (b* (((mv ?exprs ?ports ?portdecls ?vardecls)
                 (vl-primitive-mkports-fn prefix i n dir loc)))
             (vl-vardecllist-p vardecls)))
  :rule-classes :rewrite)

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

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

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

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

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

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

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

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

Theorem: len-of-vl-primitive-mkports

(defthm len-of-vl-primitive-mkports
  (b* (((mv exprs ports portdecls vardecls)
        (vl-primitive-mkports prefix i n
                              :dir dir
                              :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-primitive-mkports-under-iff

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