defpackage firrtl/errors : import core import verse import firrtl/ir2 import firrtl/ir-utils import firrtl/primops import firrtl/passes import firrtl-main import bigint2 ; TODO ; make sure it compiles, write tests, look over code to make sure its right ;========== ALL CHECKS ================= ;PARSER CHECK ; * No nested modules <- parser ; * Only modules in circuit (no statements or expressions) <- parser ; * Module must be a reference in inst declaration ;AFTER ?????? ; o No combinational loops ;================= High Form Check ========================== ; * Subexps of Subfield and Index can only be subfields, index, or refs ; * Can only connect to a Ref or Subfield or Index or WritePort ; * A module has the same name as main of circuit ; * mems cannot be a bundle with flips ; * instance module must have the same name as a defined module ; * Unique names per module ; * No name can be a prefix of any other name. ; * all references are declared ; * UInt only has positive ints ; * Vector types has positive size ; * Width sizes are positive ; * Primops have the correct number of arguments public defstruct CheckHighForm <: Pass public defmethod pass (b:CheckHighForm) -> (Circuit -> Circuit) : check-high-form public defmethod name (b:CheckHighForm) -> String : "High Form Check" public defmethod short-name (b:CheckHighForm) -> String : "high-form-check" var mname = "" ;----------------- Errors ------------------------ defn NotUnique (info:FileInfo, name:Symbol) : PassException $ string-join $ [info ": [module " mname "] Reference " name " does not have a unique name."] defn IsPrefix (info:FileInfo, prefix:Symbol) : PassException $ string-join $ [info ": [module " mname "] Symbol " prefix " is a prefix."] defn InvalidLOC (info:FileInfo) : PassException $ string-join $ [info ": [module " mname "] Invalid connect to an expression that is not a reference or a WritePort."] defn NegUInt (info:FileInfo) : PassException $ string-join $ [info ": [module " mname "] UIntValue cannot be negative."] defn UndeclaredReference (info:FileInfo, name:Symbol) : PassException $ string-join $ [info ": [module " mname "] Reference " name " is not declared."] defn PoisonWithFlip (info:FileInfo, name:Symbol) : PassException $ string-join $ [info ": [module " mname "] Poison " name " cannot be a bundle type with flips."] defn MemWithFlip (info:FileInfo, name:Symbol) : PassException $ string-join $ [info ": [module " mname "] Memory " name " cannot be a bundle type with flips."] defn InvalidSubfield (info:FileInfo) : PassException $ string-join $ [info ": [module " mname "] Invalid subfield access to non-reference."] defn InvalidIndex (info:FileInfo) : PassException $ string-join $ [info ": [module " mname "] Invalid index access to non-reference."] defn NoTopModule (info:FileInfo, name:Symbol) : PassException $ string-join $ [info ": A single module must be named " name "."] defn ModuleNotDefined (info:FileInfo, name:Symbol) : PassException $ string-join $ [info ": Module " name " is not defined."] defn IncorrectNumArgs (info:FileInfo, op:Symbol, n:Int) : PassException $ string-join $ [info ": [module " mname "] Primop " op " requires " n " expression arguments."] defn IncorrectNumConsts (info:FileInfo, op:Symbol, n:Int) : PassException $ string-join $ [info ": [module " mname "] Primop " op " requires " n " integer arguments."] defn NegWidth (info:FileInfo) : PassException $ string-join $ [info ": [module " mname "] Width cannot be negative or zero."] defn NegVecSize (info:FileInfo) : PassException $ string-join $ [info ": [module " mname "] Vector type size cannot be negative."] defn NegMemSize (info:FileInfo) : PassException $ string-join $ [info ": [module " mname "] Memory size cannot be negative or zero."] defn IllegalUnknownWidth (info:FileInfo) : PassException $ string-join $ [info ": [module " mname "] Widths must be defined for memories and poison nodes."] ;---------------- Helper Functions -------------- defn has-flip? (t:Type) -> True|False : var has? = false defn find-flip (t:Type) -> Type : match(t) : (t:BundleType) : for f in fields(t) do : if flip(f) == REVERSE : has? = true t (t) : t find-flip(t) map(find-flip,t) has? defn contains? (c:?T,cs:Streamable) -> True|False : label myret : for x in cs do : if x == c : myret(true) false ;defstruct Trie : ; char : Char ; children : HashTable ; ;defn char-hash (c:Char) -> Int : symbol-hash(to-symbol(c)) ;defn new-trie (c:Char) -> Trie : Trie(c,HashTable(char-hash)) ;defn tail (s:String) -> String : substring(s,1,length(s)) ; ;defn insert-top (trie:Trie,symbol:Symbol) -> True|False : true ; insert(trie,string-join([" " symbol])) ; ;defn insert (trie:Trie,string:String) -> True|False : ; if length(string) == 0 : char(trie) ; ; val child = get?(children(trie),string[0],false) ; if length(string) == 1 : ; match(child) : ; (c:Trie) : false ; (c:False) : ; children(trie)[string[0]] = new-trie(string[0]) ; true ; else : ; match(child) : ; (c:Trie) : insert(c,tail(string)) ; (c:False) : ; val t = new-trie(string[0]) ; insert(t,tail(string)) ; children(trie)[string[0]] = t ; ;defn has? (trie:Trie, string:String) -> True|False : ; if length(string) == 0 : true ; if length(string) >= 1 : ; if key?(children(trie),string[0]) : ; has?(tail(string), children(trie)[string[0]]) ; else : false ; ;defn any-prefixes? (trie:Trie,delim:String) -> String|False : ; if has?(trie,delim) : ; val c = get-children-after(trie:Trie,delim:String) ; if length(keys(c)) > 1 : ; ; ; if length(partial-delim) == 0 : to-string(char(trie)) ; if length(partial-delim) == 1 : ; if key?(children(trie),partial-delim[0]) : any-prefixes?(...WAS HERE ; if char(trie) == partial-delim[0] : ; if length(keys(children(trie))) >= 2 : to-string(char(trie)) ; else : false ; else : ; label myret : ; for x in children(trie) do : ; match(any-prefixes?(value(x),full-delim,full-delim)) : ; (s:False) : false ; (s:String) : myret(string-join([char(trie) s])) ; false ; else : ; label myret : ; for x in children(trie) do : ; if char(trie) == partial-delim[0] : ; match(any-prefixes?(value(x),tail(partial-delim),full-delim)) : ; (s:False) : false ; (s:String) : myret(string-join([char(trie) s])) ; match(any-prefixes?(value(x),partial-delim,full-delim)) : ; (s:False) : false ; (s:String) : myret(string-join([char(trie) s])) ; match(any-prefixes?(value(x),full-delim,full-delim)) : ; (s:False) : false ; (s:String) : myret(string-join([char(trie) s])) ; false defn check-high-form-primop (e:DoPrim, errors:Vector,info:FileInfo) -> False : defn correct-num (ne:Int|False,nc:Int) -> False : if not (ne typeof False) : if length(args(e)) != ne as Int : add(errors,IncorrectNumArgs(info,to-symbol(op(e)),ne as Int)) if length(consts(e)) != nc : add(errors,IncorrectNumConsts(info,to-symbol $ op(e),nc)) switch {op(e) == _} : ADD-OP : correct-num(2,0) SUB-OP : correct-num(2,0) MUL-OP : correct-num(2,0) DIV-OP : correct-num(2,0) MOD-OP : correct-num(2,0) QUO-OP : correct-num(2,0) REM-OP : correct-num(2,0) ADD-WRAP-OP : correct-num(2,0) SUB-WRAP-OP : correct-num(2,0) LESS-OP : correct-num(2,0) LESS-EQ-OP : correct-num(2,0) GREATER-OP : correct-num(2,0) GREATER-EQ-OP : correct-num(2,0) EQUAL-OP : correct-num(2,0) NEQUAL-OP : correct-num(2,0) EQUIV-OP : correct-num(2,0) NEQUIV-OP : correct-num(2,0) MUX-OP : correct-num(3,0) PAD-OP : correct-num(1,1) AS-UINT-OP : correct-num(1,0) AS-SINT-OP : correct-num(1,0) DYN-SHIFT-LEFT-OP : correct-num(2,0) DYN-SHIFT-RIGHT-OP : correct-num(2,0) SHIFT-LEFT-OP : correct-num(1,1) SHIFT-RIGHT-OP : correct-num(1,1) CONVERT-OP : correct-num(1,0) NEG-OP : correct-num(1,0) BIT-NOT-OP : correct-num(1,0) BIT-AND-OP : correct-num(2,0) BIT-OR-OP : correct-num(2,0) BIT-XOR-OP : correct-num(2,0) BIT-AND-REDUCE-OP : correct-num(false,0) BIT-OR-REDUCE-OP : correct-num(false,0) BIT-XOR-REDUCE-OP : correct-num(false,0) CONCAT-OP : correct-num(2,0) BIT-SELECT-OP : correct-num(1,1) BITS-SELECT-OP : correct-num(1,2) ;--------------- Check High Form Pass ------------------- public defn check-high-form (c:Circuit) -> Circuit : val errors = Vector() defn check-valid-loc (info:FileInfo,e:Expression) -> False : match(e) : (e:UIntValue|SIntValue|DoPrim) : add(errors,InvalidLOC(info)) (e) : false defn check-high-form-w (info:FileInfo,w:Width,unknown-ok?:True|False) -> Width : match(w) : (w:LongWidth) : if width(w) <= to-long(0) : add(errors,NegWidth(info)) w (w:UnknownWidth) : if unknown-ok? == false : add(errors,IllegalUnknownWidth(info)) w (w) : w defn check-high-form-t (info:FileInfo,t:Type,unknown-ok?:True|False) -> Type : match(map(check-high-form-t{info,_,true},t)) : (t:VectorType) : if size(t) < 0 : add(errors,NegVecSize(info)) (t) : false map(check-high-form-w{info,_:Width,unknown-ok?},t) defn check-high-form-e (info:FileInfo,e:Expression,names:HashTable) -> Expression : match(map(check-high-form-e{info,_,names},e)) : (e:Ref) : if not key?(names,name(e)) : add(errors,UndeclaredReference(info,name(e))) (e:Subfield) : match(exp(e)) : (e:Ref|Subfield|Index) : false (e) : add(errors,InvalidSubfield(info)) (e:Index) : match(exp(e)) : (e:Ref|Subfield|Index) : false (e) : add(errors,InvalidIndex(info)) (e:DoPrim) : check-high-form-primop(e,errors,info) (e:UIntValue) : false ;if neg?(value(e)) : add(errors,NegUInt(info)) (e) : false map(check-high-form-w{info,_:Width,true},e) map(check-high-form-t{info,_:Type,true},e) e defn check-high-form-s (s:Stmt,names:HashTable,mnames:HashTable) -> Stmt : defn check-name (info:FileInfo,name:Symbol) -> False : if key?(names,name) : add(errors,NotUnique(info,name)) map(check-high-form-t{info(s),_:Type,true},s) map{check-high-form-s{_,names,mnames},_} $ { match(s) : ;map(check-high-form-e{info(s),_,names},s)) : (s:DefWire) : check-name(info(s),name(s)) names[name(s)] = true (s:DefPoison) : check-name(info(s),name(s)) if has-flip?(type(s)) : add(errors, PoisonWithFlip(info(s), name(s))) names[name(s)] = true check-high-form-t(info(s),type(s),false) (s:DefRegister) : check-name(info(s),name(s)) names[name(s)] = true check-high-form-e(info(s),reset(s),names) check-high-form-e(info(s),clock(s),names) (s:DefMemory) : check-name(info(s),name(s)) names[name(s)] = true if has-flip?(type(s)) : add(errors, MemWithFlip(info(s), name(s))) if size(s) <= 0 : add(errors,NegMemSize(info(s))) check-high-form-t(info(s),type(s),false) check-high-form-e(info(s),clock(s),names) (s:DefInstance) : if not contains?(name(module(s) as Ref),map(name,modules(c))) : add(errors, ModuleNotDefined(info(s),name(module(s) as Ref))) check-name(info(s),name(s)) names[name(s)] = true (s:DefNode) : check-name(info(s),name(s)) check-high-form-e(info(s),value(s),names) names[name(s)] = true (s:DefAccessor) : check-name(info(s),name(s)) check-high-form-e(info(s),index(s),names) check-high-form-e(info(s),source(s),names) names[name(s)] = true (s:Connect) : check-valid-loc(info(s),loc(s)) check-high-form-e(info(s),loc(s),names) check-high-form-e(info(s),exp(s),names) (s:BulkConnect) : check-valid-loc(info(s),loc(s)) check-high-form-e(info(s),loc(s),names) check-high-form-e(info(s),exp(s),names) (s:OnReset) : check-high-form-e(info(s),loc(s),names) check-high-form-e(info(s),exp(s),names) (s:Conditionally) : check-high-form-e(info(s),pred(s),names) (s) : false s }() defn check-high-form-m (m:Module) -> False : mname = name(m) val names = HashTable(symbol-hash) val mnames = HashTable(symbol-hash) for m in modules(c) do : mnames[name(m)] = true for p in ports(m) do : names[name(p)] = true map(check-high-form-t{info(p),_,true},type(p)) map(check-high-form-w{info(p),_,true},type(p)) match(m) : (m:ExModule) : false (m:InModule) : check-high-form-s(body(m),names,mnames) ;match(any-prefixes?(names,to-string(sym),to-string(sym))) : ;(s:False) : false ;(s:String) : add(errors,IsPrefix(info,to-symbol(s))) false var number-top-m = 0 for m in modules(c) do : if name(m) == main(c) : number-top-m = number-top-m + 1 check-high-form-m(m) if number-top-m != 1 : add(errors,NoTopModule(info!(c),main(c))) throw(PassExceptions(errors)) when not empty?(errors) c ;================= KIND CHECK ========================== ; o Cannot connect directly to a mem ever ; o onreset can only handle a register ; o Cannot use a mem in anything except an accessor, Readport, or Writeport public defstruct CheckKinds <: Pass public defmethod pass (b:CheckKinds) -> (Circuit -> Circuit) : check-kinds public defmethod name (b:CheckKinds) -> String : "Check Kinds" public defmethod short-name (b:CheckKinds) -> String : "check-kinds" ;----------------- Errors --------------------- defn NotMem (info:FileInfo, name:Symbol) : PassException $ string-join $ [info ": [module " mname "] Reference " name " must be a mem."] defn IsMem (info:FileInfo, name:Symbol) : PassException $ string-join $ [info ": [module " mname "] Reference " name " cannot be a mem."] defn OnResetNotReg (info:FileInfo, name:Symbol) : PassException $ string-join $ [info ": [module " mname "] Illegal on-reset to non-reg reference " name "."] defn AccessVecOrMem (info:FileInfo) : PassException $ string-join $ [info ": [module " mname "] Accessors can only access vector-typed components or memories."] ;----------------- Check Kinds Pass --------------------- ; I may have been overeager in looking for places where mems can't be, as mems are guaranteed to have a vector ; type, and this will get caught in the type check pass public defn check-kinds (c:Circuit) -> Circuit : val errors = Vector() defn get-kind (e:Expression) -> Kind : match(e) : (e:WRef) : kind(e) (e:WSubfield) : get-kind(exp(e)) (e:WIndex) : get-kind(exp(e)) defn check-not-mem (info:FileInfo,e:Expression) -> False : do(check-not-mem{info,_},e) match(e) : (e:WRef) : if kind(e) == MemKind() : add(errors,IsMem(info,name(e))) (e:WSubfield) : check-not-mem(info,exp(e)) (e:WIndex) : check-not-mem(info,exp(e)) (e) : false defn check-is-reg (info:FileInfo,e:Expression) -> False : do(check-is-reg{info,_},e) match(e) : (e:WRef) : if kind(e) != RegKind() : add(errors,OnResetNotReg(info,name(e))) (e:WSubfield) : check-is-reg(info,exp(e)) (e:WIndex) : check-is-reg(info,exp(e)) (e) : false defn check-is-mem (info:FileInfo,e:Expression) -> False : do(check-is-mem{info,_},e) match(e) : (e:WRef) : if kind(e) != MemKind() : add(errors,NotMem(info,name(e))) (e:WSubfield) : check-is-mem(info,exp(e)) (e:WIndex) : check-is-mem(info,exp(e)) (e) : false defn check-kinds-s (s:Stmt) -> False : match(s) : (s:DefNode) : check-not-mem(info(s),value(s)) (s:DefAccessor) : check-not-mem(info(s),index(s)) if (get-kind(source(s)) != MemKind()) and (not type(source(s)) typeof VectorType) : println(get-kind(source(s))) println(type(source(s))) add(errors,AccessVecOrMem(info(s))) (s:Conditionally) : check-not-mem(info(s),pred(s)) (s:Connect) : check-not-mem(info(s),loc(s)) check-not-mem(info(s),exp(s)) (s:BulkConnect) : check-not-mem(info(s),loc(s)) check-not-mem(info(s),exp(s)) (s:OnReset) : check-is-reg(info(s),loc(s)) check-not-mem(info(s),exp(s)) (s) : false do(check-kinds-s,s) for m in modules(c) do : mname = name(m) match(m) : (m:ExModule) : false (m:InModule) : check-kinds-s(body(m)) throw(PassExceptions(errors)) when not empty?(errors) c ;==================== CHECK TYPES ===================== ; o Subfields are only on bundles, before type inference <- need to not error, just do unknown-type ; o Indexes are only on vectors ; o pred in conditionally must be of type UInt ; o enable/index in read/writeports must be UInt ; o node's value cannot be a bundle with a flip in it ; o := has same types ; o 2nd arg in dshr/l must be UInt, in general do primops ; o clock must be ClockType ; o reset must be UInt<1> public defstruct CheckTypes <: Pass public defmethod pass (b:CheckTypes) -> (Circuit -> Circuit) : check-types public defmethod name (b:CheckTypes) -> String : "Check Types" public defmethod short-name (b:CheckTypes) -> String : "check-types" ;----------------- Errors --------------------- defn SubfieldNotInBundle (info:FileInfo, name:Symbol) : PassException $ string-join $ [info ": [module " mname "] Subfield " name " is not in bundle."] defn SubfieldOnNonBundle (info:FileInfo, name:Symbol) : PassException $ string-join $ [info ": [module " mname "] Subfield " name " is accessed on a non-bundle."] defn IndexTooLarge (info:FileInfo, value:Int) : PassException $ string-join $ [info ": [module " mname "] Index with value " value " is too large."] defn IndexOnNonVector (info:FileInfo) : PassException $ string-join $ [info ": [module " mname "] Index illegal on non-vector type."] defn IndexNotUInt (info:FileInfo) : PassException $ string-join $ [info ": [module " mname "] Index is not of UIntType."] defn EnableNotUInt (info:FileInfo) : PassException $ string-join $ [info ": [module " mname "] Enable is not of UIntType."] defn InvalidConnect (info:FileInfo) : PassException $ string-join $ [info ": [module " mname "] Type mismatch."] defn PredNotUInt (info:FileInfo) : PassException $ string-join $ [info ": [module " mname "] Predicate not a UIntType."] defn OpNotGround (info:FileInfo, op:Symbol) : PassException $ string-join $ [info ": [module " mname "] Primop " op " cannot operate on non-ground types."] defn OpNotUInt (info:FileInfo, op:Symbol,e:Symbol) : PassException $ string-join $ [info ": [module " mname "] Primop " op " requires argument " e " to be a UInt type."] defn OpNotAllUInt (info:FileInfo, op:Symbol) : PassException $ string-join $ [info ": [module " mname "] Primop " op " requires all arguments to be UInt type."] defn OpNotAllSameType (info:FileInfo, op:Symbol) : PassException $ string-join $ [info ": [module " mname "] Primop " op " requires all operands to have the same type."] defn NodeIllegalFlips (info:FileInfo) : PassException $ string-join $ [info ": [module " mname "] Node cannot be a bundle type with flips."] defn OnResetIllegalFlips (info:FileInfo) : PassException $ string-join $ [info ": [module " mname "] The register in onreset cannot be a bundle type with flips."] ;---------------- Helper Functions -------------- defmethod equal? (t1:Type,t2:Type) -> True|False : match(t1,t2) : (t1:ClockType,t2:ClockType) : true (t1:UIntType,t2:UIntType) : true (t1:SIntType,t2:SIntType) : true (t1:BundleType,t2:BundleType) : var same? = true for (f1 in fields(t1),f2 in fields(t2)) do : if flip(f1) != flip(f2) : same? = false if name(f1) != name(f2) : same? = false if type(f1) != type(f2) : same? = false same? (t1:VectorType,t2:VectorType) : if type(t1) == type(t2) and size(t1) == size(t2) : true else : false (t1,t2) : false defn u () -> UIntType : UIntType(UnknownWidth()) defn s () -> SIntType : SIntType(UnknownWidth()) defn check-types-primop (e:DoPrim, errors:Vector,info:FileInfo) -> False : defn all-same-type (ls:List) -> False : var error? = false for x in ls do : if type(head(ls)) != type(x) : error? = true if error? : add(errors,OpNotAllSameType(info,to-symbol $ op(e))) defn all-ground (ls:List) -> False : var error? = false for x in ls do : if not (type(x) typeof UIntType or type(x) typeof SIntType) : error? = true if error? : add(errors,OpNotGround(info,to-symbol $ op(e))) defn all-uint (ls:List) -> False : var error? = false for x in ls do : if not (type(x) typeof UIntType) : error? = true if error? : add(errors,OpNotAllUInt(info,to-symbol $ op(e))) defn is-uint (x:Expression) -> False : var error? = false if not (type(x) typeof UIntType) : error? = true if error? : add(errors,OpNotUInt(info,to-symbol $ op(e),to-symbol(x))) all-ground(args(e)) switch {op(e) == _} : ADD-OP : false SUB-OP : false MUL-OP : false DIV-OP : false MOD-OP : false QUO-OP : false REM-OP : false ADD-WRAP-OP : false SUB-WRAP-OP : false LESS-OP : false LESS-EQ-OP : false GREATER-OP : false GREATER-EQ-OP : false EQUAL-OP : false NEQUAL-OP : false EQUIV-OP : all-same-type(args(e)) NEQUIV-OP : all-same-type(args(e)) MUX-OP : all-same-type(tail(args(e))) is-uint(head(args(e))) PAD-OP : false AS-UINT-OP : false AS-SINT-OP : false DYN-SHIFT-LEFT-OP : is-uint(args(e)[1]) DYN-SHIFT-RIGHT-OP : is-uint(args(e)[1]) SHIFT-LEFT-OP : false SHIFT-RIGHT-OP : false CONVERT-OP : false NEG-OP : false BIT-NOT-OP : all-same-type(args(e)) BIT-AND-OP : all-same-type(args(e)) BIT-OR-OP : all-same-type(args(e)) BIT-XOR-OP : all-same-type(args(e)) BIT-SELECT-OP : false BITS-SELECT-OP : false BIT-AND-REDUCE-OP : all-uint(args(e)) BIT-OR-REDUCE-OP : all-uint(args(e)) BIT-XOR-REDUCE-OP : all-uint(args(e)) CONCAT-OP : all-uint(args(e)) ;----------------- Check Types Pass --------------------- public defn check-types (c:Circuit) -> Circuit : val errors = Vector() defn check-types-e (info:FileInfo,e:Expression) -> Expression : match(map(check-types-e{info,_},e)) : (e:WRef) : e (e:WSubfield) : match(type(exp(e))) : (t:BundleType) : val ft = for p in fields(t) find : name(p) == name(e) if ft == false : add(errors,SubfieldNotInBundle(info,name(e))) (t) : add(errors,SubfieldOnNonBundle(info,name(e))) (e:WIndex) : match(type(exp(e))) : (t:VectorType) : if value(e) >= size(t) : add(errors,IndexTooLarge(info,value(e))) (t) : add(errors,IndexOnNonVector(info)) (e:DoPrim) : check-types-primop(e,errors,info) (e:UIntValue|SIntValue) : false e defn bulk-equals? (t1:Type,t2:Type) -> True|False : match(t1,t2) : (t1:BundleType,t2:BundleType) : var same? = true for (f1 in fields(t1),f2 in fields(t2)) do : if name(f1) == name(f2) : if flip(f1) != flip(f2) : same? = false if not bulk-equals?(type(f1),type(f2)) : same? = false same? (t1:ClockType,t2:ClockType) : true (t1:UIntType,t2:UIntType) : true (t1:SIntType,t2:SIntType) : true (t1:VectorType,t2:VectorType) : if bulk-equals?(type(t1),type(t2)) : true else : false (t1,t2) : false defn check-types-s (s:Stmt) -> Stmt : map{check-types-s,_} $ { match(map(check-types-e{info(s),_},s)) : (s:Connect) : if type(loc(s)) != type(exp(s)) : add(errors,InvalidConnect(info(s))) (s:BulkConnect) : if not bulk-equals?(type(loc(s)),type(exp(s))) : add(errors,InvalidConnect(info(s))) (s:OnReset) : if type(loc(s)) != type(exp(s)) : add(errors,InvalidConnect(info(s))) if has-flip?(type(loc(s))) : add(errors,OnResetIllegalFlips(info(s))) (s:Conditionally) : if type(pred(s)) != u() : add(errors,PredNotUInt(info(s))) (s:DefNode) : if has-flip?(type(value(s))) : add(errors,NodeIllegalFlips(info(s))) (s) : false s }() for m in modules(c) do : mname = name(m) match(m) : (m:ExModule) : false (m:InModule) : check-types-s(body(m)) throw(PassExceptions(errors)) when not empty?(errors) c ;================= GENDER CHECK ========================== ; o Nodes always male ; o Accessors only have one gender, unless rdwr ; o output/input only one gender ; o correctly check for the base bundle public defstruct CheckGenders <: Pass public defmethod pass (b:CheckGenders) -> (Circuit -> Circuit) : check-genders public defmethod name (b:CheckGenders) -> String : "Check Genders" public defmethod short-name (b:CheckGenders) -> String : "check-genders" ;----------------- Errors --------------------- defn WrongGender (info:FileInfo,expr:Symbol,wrong:Symbol,right:Symbol) : PassException $ string-join $ [info ": [module " mname "] Expression " expr " is used as a " wrong " but can only be used as a " right "."] defn InferDirection (info:FileInfo,name:Symbol) : PassException $ string-join $ [info ": [module " mname "] Accessor " name " has a direction that requires inference."] ;---------------- Helper Functions -------------- defn dir-to-gender (d:PortDirection) -> Gender : switch {_ == d} : INPUT : MALE OUTPUT : FEMALE ;BI-GENDER defn gender (s:DefAccessor) -> Gender : switch {_ == acc-dir(s)} : READ : MALE WRITE : FEMALE INFER : UNKNOWN-GENDER RDWR : BI-GENDER defn as-srcsnk (g:Gender) -> Symbol : switch {_ == g} : MALE : `source FEMALE : `sink UNKNOWN-GENDER : `unknown BI-GENDER : `sourceOrSink ;----------------- Check Genders Pass --------------------- public defn check-genders (c:Circuit) -> Circuit : val errors = Vector() defn get-kind (e:Expression) -> Kind : match(e) : (e:WRef) : kind(e) (e:WSubfield) : get-kind(exp(e)) (e:WIndex) : get-kind(exp(e)) (e) : NodeKind() defn check-gender (info:FileInfo,genders:HashTable,e:Expression,desired:Gender) -> False : val gender = get-gender(e,genders) val kind* = get-kind(e) val flip? = match(type(e)) : (t:BundleType) : for f in fields(t) any? : flip(f) == REVERSE (t) : false ;println(e) ;println(gender) ;println(desired) ;println(kind*) ;println(desired == gender) ;if gender != desired and gender != BI-GENDER: switch fn ([x,y]) : gender == x and desired == y : [MALE, FEMALE] : add(errors,WrongGender(info,to-symbol(e),as-srcsnk(desired),as-srcsnk(gender))) [FEMALE, MALE] : if kind* != PortKind() and kind* != InstanceKind(): add(errors,WrongGender(info,to-symbol(e),as-srcsnk(desired),as-srcsnk(gender))) else : false defn get-gender (e:Expression,genders:HashTable) -> Gender : match(e) : (e:WRef) : genders[name(e)] (e:WSubfield) : val f = {_ as Field} $ for f in fields(type(exp(e)) as BundleType) find : name(f) == name(e) get-gender(exp(e),genders) * flip(f) (e:WIndex) : get-gender(exp(e),genders) (e:DoPrim) : MALE (e:UIntValue) : MALE (e:SIntValue) : MALE defn check-genders-e (info:FileInfo,e:Expression,genders:HashTable) -> False : do(check-genders-e{info,_,genders},e) match(e) : (e:WRef) : false (e:WSubfield) : false (e:WIndex) : false (e:DoPrim) : for e in args(e) do : check-gender(info,genders,e,MALE) (e:UIntValue) : false (e:SIntValue) : false defn check-genders-s (s:Stmt,genders:HashTable) -> False : do(check-genders-e{info(s),_:Expression,genders},s) do(check-genders-s{_:Stmt,genders},s) match(s) : (s:DefWire) : genders[name(s)] = BI-GENDER (s:DefPoison) : genders[name(s)] = MALE (s:DefRegister) : genders[name(s)] = BI-GENDER (s:DefNode) : check-gender(info(s),genders,value(s),MALE) genders[name(s)] = MALE (s:DefMemory) : genders[name(s)] = BI-GENDER (s:DefInstance) : genders[name(s)] = MALE (s:DefAccessor) : if acc-dir(s) == INFER : add(errors,InferDirection(info(s),name(s))) check-gender(info(s),genders,index(s),MALE) check-gender(info(s),genders,source(s),gender(s)) genders[name(s)] = gender(s) (s:Connect) : check-gender(info(s),genders,loc(s),FEMALE) check-gender(info(s),genders,exp(s),MALE) (s:BulkConnect) : check-gender(info(s),genders,loc(s),FEMALE) check-gender(info(s),genders,exp(s),MALE) (s:OnReset) : check-gender(info(s),genders,loc(s),FEMALE) check-gender(info(s),genders,exp(s),MALE) (s:Conditionally) : check-gender(info(s),genders,pred(s),MALE) (s:EmptyStmt) : false (s:Begin) : false for m in modules(c) do : mname = name(m) val genders = HashTable(symbol-hash) for p in ports(m) do : genders[name(p)] = dir-to-gender(direction(p)) match(m) : (m:ExModule) : false (m:InModule) : check-genders-s(body(m),genders) throw(PassExceptions(errors)) when not empty?(errors) c ;;================ Initialization Check ================== ; Error on all componenents that are not connected to. public defstruct CheckInitialization <: Pass public defmethod pass (b:CheckInitialization) -> (Circuit -> Circuit) : check-init public defmethod name (b:CheckInitialization) -> String : "Check Initialization" public defmethod short-name (b:CheckInitialization) -> String : "check-init" ;----------------- Errors ------------------------ defn RefNotInitialized (info:FileInfo, name:Symbol) : PassException $ string-join $ [info ": [module " mname "] Reference " name " is not fully initialized."] ;------------ Helper Functions ------------- ;------------ Pass ------------------ public defn check-init (c:Circuit) : val errors = Vector() defn check-init-m (m:InModule) : val init? = HashTable(symbol-hash) defn get-name (e:Expression) -> Symbol : match(e) : (e:Ref) : name(e) (e:Subfield) : symbol-join([get-name(exp(e)) `. name(e)]) (e) : error("Shouldn't be here") defn check-init-s (s:Stmt) : do(check-init-s,s) match(s) : (s:DefWire|DefRegister) : init?[name(s)] = info(s) (s:DefAccessor) : if acc-dir(s) == WRITE : init?[name(s)] = info(s) (s:DefInstance) : for f in fields(type(module(s)) as BundleType) do : if flip(f) == REVERSE : init?[symbol-join([name(s) `. name(f)])] = info(s) (s:Connect) : init?[get-name(loc(s))] = true (s) : false for p in ports(m) do : if direction(p) == OUTPUT : init?[name(p)] = info(p) check-init-s(body(m)) for x in init? do : match(value(x)) : (v:FileInfo) : add(errors, RefNotInitialized(v,key(x))) (v) : false for m in modules(c) do : mname = name(m) match(m) : (m:InModule) : check-init-m(m) (m) : false throw(PassExceptions(errors)) when not empty?(errors) c ;================= Width Check ========================== ;AFTER WIDTH INFERENCE ; * No names ; * No Unknowns ; * All widths are positive ; * widths are large enough to contain value public defstruct CheckWidths <: Pass public defmethod pass (b:CheckWidths) -> (Circuit -> Circuit) : check-width public defmethod name (b:CheckWidths) -> String : "Width Check" public defmethod short-name (b:CheckWidths) -> String : "width-check" ;----------------- Errors ------------------------ defn UninferredWidth (info:FileInfo) : PassException $ string-join $ [info ": [module " mname "] Uninferred width."] defn WidthTooSmall (info:FileInfo,v:String) : PassException $ string-join $ [info ": [module " mname "] Width too small for constant " v "."] ;---------------- Helper Functions -------------- ;--------------- Check Width Pass ------------------- public defn check-width (c:Circuit) -> Circuit : val errors = Vector() defn check-width-m (m:Module) -> False : defn check-width-w (info:FileInfo,w:Width) -> Width : match(w) : (w:LongWidth) : if width(w) <= to-long(0) : add(errors,NegWidth(info)) (w) : add(errors,UninferredWidth(info)) w defn check-width-e (info:FileInfo,e:Expression) -> Expression : match(map(check-width-e{info,_},e)) : (e:UIntValue) : match(width(e)) : (w:LongWidth) : if max(to-long(1),to-long(req-num-bits(value(e)) - 1)) > width(w) : add(errors,WidthTooSmall(info,to-string(value(e)))) (w) : add(errors,UninferredWidth(info)) check-width-w(info,width(e)) (e:SIntValue) : match(width(e)) : (w:LongWidth) : if to-long(req-num-bits(value(e))) > width(w) : add(errors,WidthTooSmall(info,to-string(value(e)))) (w) : add(errors,UninferredWidth(info)) check-width-w(info,width(e)) (e:DoPrim) : false (e) : false ;mapr(check-width-w{info,_},type(map(check-width-e{info,_},e))) e defn check-width-s (s:Stmt) -> Stmt : map(check-width-e{info(s),_},map(check-width-s,s)) map(mapr{check-width-w{info(s),_},_:Type},s) for p in ports(m) do : mapr(check-width-w{info(p),_},type(p)) match(m) : (m:ExModule) : false (m:InModule) : check-width-s(body(m)) false for m in modules(c) do : mname = name(m) check-width-m(m) throw(PassExceptions(errors)) when not empty?(errors) c ;================= Low Form Check ========================== ;AFTER LOWERING ; o All things connect to once ; o no reg ; o no accessors ; o only vecs are for memories ; o no bundles (future, will have them for mems) ; o only predicated conditional connects public defstruct CheckLowForm <: Pass public defmethod pass (b:CheckLowForm) -> (Circuit -> Circuit) : check-low-form public defmethod name (b:CheckLowForm) -> String : "Low Form Check" public defmethod short-name (b:CheckLowForm) -> String : "low-form-check" ;----------------- Errors ------------------------ defn InvalidVec (info:FileInfo,name:Symbol) : PassException $ string-join $ [info ": [module " mname "] Expression " name " has an illegal vector type."] defn InvalidBundle (info:FileInfo,name:Symbol) : PassException $ string-join $ [info ": [module " mname "] Expression " name " has an illegal bundle type."] defn NoWhen (info:FileInfo) : PassException $ string-join $ [info ": [module " mname "] Illegal when statement. No when statements with multiple statements are allowed in low firrtl."] defn SingleAssignment (info:FileInfo,name:Symbol) : PassException $ string-join $ [info ": [module " mname "] Illegal assignment to " name ". Wires can only be assigned to once."] defn NoOnReset (info:FileInfo) : PassException $ string-join $ [info ": [module " mname "] Invalid use of on-reset. No on-resets are allowed in low firrtl."] defn NoBulkConnect (info:FileInfo) : PassException $ string-join $ [info ": [module " mname "] Invalid use of <>. No <>'s are allowed in low firrtl."] ;---------------- Helper Functions -------------- ;--------------- Check Low Form Pass ------------------- public defn check-low-form (c:Circuit) -> Circuit : val errors = Vector() defn check-low-form-t (info:FileInfo,t:Type,name:Symbol) -> False : match(t) : (t:VectorType) : add(errors,InvalidVec(info,name)) (t:BundleType) : add(errors,InvalidBundle(info,name)) (t) : false defn check-low-form-m (m:Module) -> False : for p in ports(m) do : check-low-form-t(info(p),type(p),name(p)) val assigned? = HashTable(symbol-hash) val insts = Vector() val mems = Vector() defn check-correct-exp (info:FileInfo,e:Expression) -> False : do(check-correct-exp{info,_:Expression},e) match(e) : (e:Ref) : if contains?(insts,name(e)) : for f in fields(type(e) as BundleType) do : check-low-form-t(info,type(f),name(e)) if contains?(mems,name(e)) : check-low-form-t(info,type(type(e) as VectorType),name(e)) (e) : false ;check-low-form-t(info,type(e),to-symbol $ to-string(e)) defn check-low-form-s (s:Stmt) -> False : match(s) : (s:DefWire) : check-low-form-t(info(s),type(s),name(s)) (s:DefPoison) : check-low-form-t(info(s),type(s),name(s)) (s:DefMemory) : check-low-form-t(info(s),type(s),name(s)) add(mems,name(s)) (s:DefInstance) : for f in fields(type(module(s)) as BundleType) do : check-low-form-t(info(s),type(f),name(s)) add(insts,name(s)) (s:DefNode) : check-correct-exp(info(s),value(s)) (s:DefRegister) : false (s:DefAccessor) : false (s:Conditionally) : if (not alt(s) typeof EmptyStmt) or (conseq(s) typeof Begin) : add(errors,NoWhen(info(s))) (s:OnReset) : add(errors,NoOnReset(info(s))) (s:BulkConnect) : add(errors,NoBulkConnect(info(s))) (s:Connect) : check-correct-exp(info(s),exp(s)) match(loc(s)) : (e:Ref|Subfield) : val n* = to-symbol $ to-string $ e if key?(assigned?,n*) : add(errors,SingleAssignment(info(s),n*)) else : assigned?[to-symbol $ to-string $ e] = true (e) : check-correct-exp(info(s),e) (s:EmptyStmt) : false (s:Begin) : do(check-low-form-s,s) match(m) : (m:ExModule) : false (m:InModule) : check-low-form-s(body(m)) false for m in modules(c) do : mname = name(m) check-low-form-m(m) throw(PassExceptions(errors)) when not empty?(errors) c