{-# LANGUAGE TemplateHaskell #-} {-# LANGUAGE OverloadedStrings #-} module Clash.Primitives.Verification (checkBBF) where import Data.Either import qualified Control.Lens as Lens import Control.Monad.State (State) import Data.Text.Prettyprint.Doc.Extra (Doc) import qualified Data.Text as Text import Data.Semigroup.Monad (getMon) import GHC.Stack (HasCallStack) import Clash.Annotations.Primitive (HDL(..)) import Clash.Backend (Backend, blockDecl, hdlKind) import Clash.Core.Term (Term(Var)) import Clash.Core.TermInfo (termType) import Clash.Core.TermLiteral (termToDataError) import Clash.Util (indexNote) import Clash.Netlist (mkExpr) import Clash.Netlist.Util (stripVoid) import Clash.Netlist.Util (id2identifier) import qualified Clash.Netlist.Id as Id import Clash.Netlist.Types (BlackBox(BBFunction), TemplateFunction(..), BlackBoxContext, Identifier, NetlistMonad, Declaration(Assignment, NetDecl', TickDecl), HWType(Bool, KnownDomain), WireOrReg(Wire), NetlistId(..), DeclarationType(Concurrent), tcCache, bbInputs) import Clash.Netlist.BlackBox.Types (BlackBoxFunction, BlackBoxMeta(..), TemplateKind(TDecl), RenderVoid(..), emptyBlackBoxMeta) import Clash.Verification.Internal import Clash.Verification.PrettyPrinters checkBBF :: BlackBoxFunction checkBBF _isD _primName args _ty = case litArgs of Left err -> pure (Left err) Right (propName, renderAs, cvProperty0) -> do cvProperty1 <- mapM (uncurry bindMaybe) cvProperty0 let decls = concatMap snd cvProperty1 cvProperty2 = fmap fst cvProperty1 pure (Right (meta, bb (checkTF decls clkId propName renderAs cvProperty2))) where -- TODO: Improve error handling; currently errors don't indicate what -- TODO: blackbox generated them. (Var (id2identifier -> clkId)) = indexNote "clk" (lefts args) 1 (Var (id2identifier -> _clkId)) = indexNote "rst" (lefts args) 2 litArgs = do propName <- termToDataError (indexNote "propName" (lefts args) 3) renderAs <- termToDataError (indexNote "renderAs" (lefts args) 4) cvProperty <- termToDataError (indexNote "propArg" (lefts args) 5) Right (propName, renderAs, cvProperty) bb = BBFunction "Clash.Primitives.Verification.checkTF" 0 meta = emptyBlackBoxMeta {bbKind=TDecl, bbRenderVoid=RenderVoid} bindMaybe :: Maybe String -- ^ Hint for new identifier -> Term -- ^ Term to bind. Does not bind if it's already a reference to a signal -> NetlistMonad (Identifier, [Declaration]) -- ^ ([new] reference to signal, [declarations need to get it in scope]) bindMaybe _ (Var vId) = pure (id2identifier vId, []) bindMaybe Nothing t = bindMaybe (Just "s") t bindMaybe (Just nm) t = do tcm <- Lens.use tcCache newId <- Id.make (Text.pack nm) (expr0, decls) <- mkExpr False Concurrent (NetlistId newId (termType tcm t)) t pure ( newId , decls ++ [sigDecl Bool newId, Assignment newId expr0] ) -- Simple wire without comment sigDecl :: HWType -> Identifier -> Declaration sigDecl typ nm = NetDecl' Nothing Wire nm (Right typ) Nothing checkTF :: [Declaration] -> Identifier -> Text.Text -> RenderAs -> Property' Identifier -> TemplateFunction checkTF decls clkId propName renderAs prop = TemplateFunction [] (const True) (checkTF' decls clkId propName renderAs prop) checkTF' :: forall s . (HasCallStack, Backend s) => [Declaration] -- ^ Extra decls needed -> Identifier -- ^ Clock -> Text.Text -- ^ Prop name -> RenderAs -> Property' Identifier -> BlackBoxContext -> State s Doc checkTF' decls clkId propName renderAs prop bbCtx = do blockName <- Id.makeBasic (propName <> "_block") getMon (blockDecl blockName (TickDecl renderedPslProperty : decls)) where hdl = hdlKind (undefined :: s) edge = case head (bbInputs bbCtx) of (_, stripVoid -> KnownDomain _nm _period e _rst _init _polarity, _) -> e _ -> error $ "Unexpected first argument: " ++ show (head (bbInputs bbCtx)) renderedPslProperty | renderAs == SVA || hdl == SystemVerilog = sva | otherwise = psl where sva = pprSvaProperty propName (Id.toText clkId) edge (fmap Id.toText prop) psl = pprPslProperty hdl propName (Id.toText clkId) edge (fmap Id.toText prop)