• 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
        • 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
          • Edgesynth
            • Vl-edgesynth-stmt-p
            • Vl-edgetable-p
            • Vl-always-edgesynth
            • Vl-edgesynth-merge-data-ifs
            • Vl-assignstmtlist->controls
            • Vl-assignstmtlist->lhses
            • Vl-assignstmtlist->rhses
            • Vl-edgesynth-flatten-data-ifs
            • Vl-edgesynth-pattern-match
            • 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-edgesynth-make-data-inputs
            • Vl-edgesynth-make-clock-inputs
            • Vl-edgesynth-stmt-clklift
            • Vl-edgesynth-blockelim
            • Vl-alwayslist-edgesynth
            • Vl-edgesynth-create
            • Vl-edgesynth-classify-iftest
            • Vl-module-edgesynth
            • Vl-edgesynth-normalize-ifs
            • Vl-edgesynth-delays-okp
            • Vl-edgesynth-stmt-assigns
            • Vl-make-edgetable
            • Vl-edgesynth-sort-edges
            • Vl-modulelist-edgesynth
            • Vl-modulelist-edgesynth-aux
            • Vl-assignstmtlist-p
            • Vl-edgesynth-edgelist-p
            • Vl-assigncontrols-p
            • Vl-edgesynth-stmt-conditions
            • Vl-edgesynth-edge-p
            • Vl-design-edgesynth
            • Vl-edgesynth-get-delay
            • Vl-edgesynth-iftype-p
            • Edge-tables
          • Stmtrewrite
          • Cblock
          • Vl-always-convert-regports
          • Vl-always-convert-regs
          • Stmttemps
          • Edgesplit
          • Vl-always-check-reg
          • Vl-convert-regs
          • Latchsynth
          • Vl-always-check-regs
          • Vl-match-always-at-some-edges
          • Unelse
          • Vl-always-convert-reg
          • Vl-design-always-backend
          • Vl-stmt-guts
          • Vl-always-convert-regport
          • Vl-always-scary-regs
          • Eliminitial
          • Ifmerge
          • Vl-edge-control-p
          • Elimalways
        • 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

• 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)))))