| // Copyright lowRISC contributors. | 
 | // Licensed under the Apache License, Version 2.0, see LICENSE for details. | 
 | // SPDX-License-Identifier: Apache-2.0 | 
 | // | 
 | module tb; | 
 |   // dep packages | 
 |   import uvm_pkg::*; | 
 |   import dv_utils_pkg::*; | 
 |   import lc_ctrl_pkg::*; | 
 |   import lc_ctrl_reg_pkg::*; | 
 |   import lc_ctrl_state_pkg::*; | 
 |   import lc_ctrl_env_pkg::*; | 
 |   import lc_ctrl_test_pkg::*; | 
 |   import otp_ctrl_pkg::*; | 
 |   import jtag_riscv_agent_pkg::*; | 
 |  | 
 |   // LC_CTRL parameters | 
 |   // Enable asynchronous transitions on alerts. | 
 |   parameter logic [NumAlerts-1:0] AlertAsyncOn = {NumAlerts{1'b1}}; | 
 |   // Idcode value for the JTAG. | 
 |   parameter logic [31:0] IdcodeValue = 32'h00000001; | 
 |   // Random netlist constants | 
 |   parameter lc_keymgr_div_t RndCnstLcKeymgrDivInvalid    = | 
 |     LcKeymgrDivWidth'({(LcKeymgrDivWidth/8){32'h00000000}}); | 
 |   parameter lc_keymgr_div_t RndCnstLcKeymgrDivTestDevRma = | 
 |     LcKeymgrDivWidth'({(LcKeymgrDivWidth/8){8'h5a}}); | 
 |   parameter lc_keymgr_div_t RndCnstLcKeymgrDivProduction = | 
 |     LcKeymgrDivWidth'({(LcKeymgrDivWidth/8){8'ha5}}); | 
 |  | 
 |   // macro includes | 
 |   `include "uvm_macros.svh" | 
 |   `include "dv_macros.svh" | 
 |  | 
 |   wire clk, rst_n; | 
 |   wire devmode; | 
 |   wire [LcPwrIfWidth-1:0] pwr_lc; | 
 |  | 
 |   wire [OtpTestCtrlWidth-1:0] otp_vendor_test_ctrl; | 
 |   wire [OtpTestStatusWidth-1:0] otp_vendor_test_status; | 
 |   assign lc_ctrl_if.otp_vendor_test_ctrl_o = otp_vendor_test_ctrl; | 
 |   assign otp_vendor_test_status = lc_ctrl_if.otp_vendor_test_status_i; | 
 |  | 
 |   // HW revision | 
 |   lc_hw_rev_t hw_rev_o; | 
 |  | 
 |   // interfaces | 
 |   clk_rst_if clk_rst_if ( | 
 |     .clk  (clk), | 
 |     .rst_n(rst_n) | 
 |   ); | 
 |   pins_if #(1) devmode_if (devmode); | 
 |   pins_if #(LcPwrIfWidth) pwr_lc_if (pwr_lc); | 
 |   tl_if tl_if ( | 
 |     .clk  (clk), | 
 |     .rst_n(rst_n) | 
 |   ); | 
 |   lc_ctrl_if lc_ctrl_if ( | 
 |     .clk  (clk), | 
 |     .rst_n(rst_n) | 
 |   ); | 
 |   alert_esc_if esc_scrap_state1_if ( | 
 |     .clk  (clk), | 
 |     .rst_n(rst_n) | 
 |   ); | 
 |   alert_esc_if esc_scrap_state0_if ( | 
 |     .clk  (clk), | 
 |     .rst_n(rst_n) | 
 |   ); | 
 |   jtag_if jtag_if (); | 
 |   push_pull_if #( | 
 |     .HostDataWidth  (OTP_PROG_HDATA_WIDTH), | 
 |     .DeviceDataWidth(OTP_PROG_DDATA_WIDTH) | 
 |   ) otp_prog_if ( | 
 |     .clk  (clk), | 
 |     .rst_n(rst_n) | 
 |   ); | 
 |  | 
 |  | 
 |   // KMAC App agent hookup | 
 |   kmac_pkg::app_rsp_t kmac_data_in; | 
 |   kmac_pkg::app_req_t kmac_data_out; | 
 |   assign kmac_data_in = kmac_app_if.kmac_data_rsp; | 
 |   assign kmac_app_if.kmac_data_req = kmac_data_out; | 
 |  | 
 |   // KMAC vip | 
 |   kmac_app_intf kmac_app_if ( | 
 |     .clk  (clk), | 
 |     .rst_n(rst_n) | 
 |   ); | 
 |  | 
 |   `DV_ALERT_IF_CONNECT() | 
 |  | 
 |   // dut | 
 |   lc_ctrl #( | 
 |     .AlertAsyncOn(AlertAsyncOn), | 
 |     // Idcode value for the JTAG. | 
 |     .IdcodeValue(IdcodeValue), | 
 |     // Random netlist constants | 
 |     .RndCnstLcKeymgrDivInvalid(RndCnstLcKeymgrDivInvalid), | 
 |     .RndCnstLcKeymgrDivTestDevRma(RndCnstLcKeymgrDivTestDevRma), | 
 |     .RndCnstLcKeymgrDivProduction(RndCnstLcKeymgrDivProduction), | 
 |     .ChipGen(LcCtrlChipGen[lc_ctrl_reg_pkg::HwRevFieldWidth-1:0]), | 
 |     .ChipRev(LcCtrlChipRev[lc_ctrl_reg_pkg::HwRevFieldWidth-1:0]) | 
 |   ) dut ( | 
 |     .clk_i (clk), | 
 |     .rst_ni(rst_n), | 
 |  | 
 |     // TODO: connect this to a different clock | 
 |     .clk_kmac_i (clk), | 
 |     .rst_kmac_ni(rst_n), | 
 |  | 
 |     .tl_i      (tl_if.h2d), | 
 |     .tl_o      (tl_if.d2h), | 
 |     .alert_rx_i(alert_rx), | 
 |     .alert_tx_o(alert_tx), | 
 |  | 
 |     .jtag_i     ({jtag_if.tck, jtag_if.tms, jtag_if.trst_n, jtag_if.tdi}), | 
 |     .jtag_o     ({jtag_if.tdo, lc_ctrl_if.tdo_oe}), | 
 |     .scanmode_i (lc_ctrl_if.scanmode_i), | 
 |     .scan_rst_ni(lc_ctrl_if.scan_rst_ni), | 
 |  | 
 |     .esc_scrap_state0_tx_i(esc_scrap_state0_if.esc_tx), | 
 |     .esc_scrap_state0_rx_o(esc_scrap_state0_if.esc_rx), | 
 |     .esc_scrap_state1_tx_i(esc_scrap_state1_if.esc_tx), | 
 |     .esc_scrap_state1_rx_o(esc_scrap_state1_if.esc_rx), | 
 |  | 
 |     .pwr_lc_i(pwr_lc[LcPwrInitReq]), | 
 |     .pwr_lc_o(pwr_lc[LcPwrDoneRsp:LcPwrIdleRsp]), | 
 |  | 
 |     .lc_otp_vendor_test_o(otp_vendor_test_ctrl), | 
 |     .lc_otp_vendor_test_i(otp_vendor_test_status), | 
 |  | 
 |     .lc_otp_program_o({otp_prog_if.req, otp_prog_if.h_data}), | 
 |     .lc_otp_program_i({otp_prog_if.d_data, otp_prog_if.ack}), | 
 |  | 
 |     .kmac_data_i(kmac_data_in), | 
 |     .kmac_data_o(kmac_data_out), | 
 |  | 
 |     .otp_lc_data_i(lc_ctrl_if.otp_i), | 
 |  | 
 |     .lc_dft_en_o               (lc_ctrl_if.lc_dft_en_o), | 
 |     .lc_nvm_debug_en_o         (lc_ctrl_if.lc_nvm_debug_en_o), | 
 |     .lc_hw_debug_en_o          (lc_ctrl_if.lc_hw_debug_en_o), | 
 |     .lc_cpu_en_o               (lc_ctrl_if.lc_cpu_en_o), | 
 |     .lc_creator_seed_sw_rw_en_o(lc_ctrl_if.lc_creator_seed_sw_rw_en_o), | 
 |     .lc_owner_seed_sw_rw_en_o  (lc_ctrl_if.lc_owner_seed_sw_rw_en_o), | 
 |     .lc_iso_part_sw_rd_en_o    (lc_ctrl_if.lc_iso_part_sw_rd_en_o), | 
 |     .lc_iso_part_sw_wr_en_o    (lc_ctrl_if.lc_iso_part_sw_wr_en_o), | 
 |     .lc_seed_hw_rd_en_o        (lc_ctrl_if.lc_seed_hw_rd_en_o), | 
 |     .lc_keymgr_en_o            (lc_ctrl_if.lc_keymgr_en_o), | 
 |     .lc_escalate_en_o          (lc_ctrl_if.lc_escalate_en_o), | 
 |     .lc_check_byp_en_o         (lc_ctrl_if.lc_check_byp_en_o), | 
 |  | 
 |     .lc_clk_byp_req_o(lc_ctrl_if.clk_byp_req_o), | 
 |     .lc_clk_byp_ack_i(lc_ctrl_if.clk_byp_ack_i), | 
 |  | 
 |     .lc_flash_rma_seed_o(lc_ctrl_if.flash_rma_seed_o), | 
 |     .lc_flash_rma_req_o (lc_ctrl_if.flash_rma_req_o), | 
 |     .lc_flash_rma_ack_i (lc_ctrl_if.flash_rma_ack_i), | 
 |  | 
 |     .lc_keymgr_div_o(lc_ctrl_if.keymgr_div_o), | 
 |  | 
 |     .otp_device_id_i(lc_ctrl_if.otp_device_id_i), | 
 |  | 
 |     .otp_manuf_state_i(lc_ctrl_if.otp_manuf_state_i), | 
 |     .hw_rev_o(hw_rev_o) | 
 |   ); | 
 |  | 
 |   // | 
 |   // Whitebox signals - these come from within the RTL | 
 |   // | 
 |  | 
 |   // JTAG/TL Mutex claim | 
 |   // Need a small delay to filter out glitches | 
 |   assign #1ps lc_ctrl_if.mutex_claim_jtag = (dut.tap_reg2hw.claim_transition_if.qe == 1) && | 
 |       prim_mubi_pkg::mubi8_test_false_loose( | 
 |       dut.tap_claim_transition_if_q | 
 |   ); | 
 |  | 
 |   assign #1ps lc_ctrl_if.mutex_claim_tl = (dut.reg2hw.claim_transition_if.qe == 1) && | 
 |       prim_mubi_pkg::mubi8_test_false_loose( | 
 |       dut.sw_claim_transition_if_q | 
 |   ); | 
 |  | 
 |   // FSM State | 
 |   assign #1ps lc_ctrl_if.lc_ctrl_fsm_state = dut.u_lc_ctrl_fsm.fsm_state_q; | 
 |   // Token mux control | 
 |   assign lc_ctrl_if.token_idx0 = dut.u_lc_ctrl_fsm.token_idx0; | 
 |   assign lc_ctrl_if.token_idx1 = dut.u_lc_ctrl_fsm.token_idx1; | 
 |   // Hashed tokens | 
 |   assign lc_ctrl_if.hashed_token_i = dut.u_lc_ctrl_fsm.hashed_token_i; | 
 |   assign lc_ctrl_if.hashed_token_mux = dut.u_lc_ctrl_fsm.hashed_token_mux; | 
 |   assign lc_ctrl_if.token_hash_ack_i = dut.u_lc_ctrl_fsm.token_hash_ack_i; | 
 |  | 
 |  | 
 |  | 
 |   initial begin | 
 |     static | 
 |     lc_ctrl_parameters_cfg | 
 |     parameters_cfg = lc_ctrl_parameters_cfg::type_id::create( | 
 |         "parameters_cfg" | 
 |     ); | 
 |  | 
 |     // drive clk and rst_n from clk_if | 
 |     clk_rst_if.set_active(); | 
 |     uvm_config_db#(virtual clk_rst_if)::set(null, "*.env", "clk_rst_vif", clk_rst_if); | 
 |     uvm_config_db#(devmode_vif)::set(null, "*.env", "devmode_vif", devmode_if); | 
 |     uvm_config_db#(virtual tl_if)::set(null, "*.env.m_tl_agent*", "vif", tl_if); | 
 |     uvm_config_db#(pwr_lc_vif)::set(null, "*.env", "pwr_lc_vif", pwr_lc_if); | 
 |     uvm_config_db#(virtual lc_ctrl_if)::set(null, "*.env", "lc_ctrl_vif", lc_ctrl_if); | 
 |  | 
 |     // verilog_format: off - avoid bad formatting | 
 |     // The jtag_agent is a low_level agent that configured inside jtag_riscv_agent. | 
 |     uvm_config_db#(virtual jtag_if)::set(null, "*.env.m_jtag_riscv_agent.m_jtag_agent*", "vif", | 
 |                                          jtag_if); | 
 |     uvm_config_db#(virtual alert_esc_if)::set(null, "*env.m_esc_scrap_state1_agent*", "vif", | 
 |                                               esc_scrap_state1_if); | 
 |     uvm_config_db#(virtual alert_esc_if)::set(null, "*env.m_esc_scrap_state0_agent*", "vif", | 
 |                                               esc_scrap_state0_if); | 
 |     uvm_config_db#(virtual push_pull_if#(.HostDataWidth(OTP_PROG_HDATA_WIDTH), | 
 |                                          .DeviceDataWidth(OTP_PROG_DDATA_WIDTH))):: | 
 |                    set(null, "*env.m_otp_prog_pull_agent*", "vif", otp_prog_if); | 
 |     uvm_config_db#(virtual kmac_app_intf)::set(null, "*.env.m_kmac_app_agent", "vif", kmac_app_if); | 
 |  | 
 |     // Parameter config object | 
 |     parameters_cfg.alert_async_on = AlertAsyncOn; | 
 |     parameters_cfg.id_code_value = IdcodeValue; | 
 |     parameters_cfg.keymgr_div_invalid = RndCnstLcKeymgrDivInvalid; | 
 |     parameters_cfg.keymgr_div_test_dev_rma = RndCnstLcKeymgrDivTestDevRma; | 
 |     parameters_cfg.keymgr_div_production = RndCnstLcKeymgrDivProduction; | 
 |     uvm_config_db#(lc_ctrl_parameters_cfg)::set(null, "*", "parameters_cfg", parameters_cfg); | 
 |  | 
 |     // verilog_format: on | 
 |     $timeformat(-12, 0, " ps", 12); | 
 |     run_test(); | 
 |   end | 
 |  | 
 |   // Assertions | 
 |   // HW Revision | 
 |   `ASSERT(HWChipGen_A, hw_rev_o.chip_gen == LcCtrlChipGen[lc_ctrl_reg_pkg::HwRevFieldWidth-1:0], | 
 |           clk, ~rst_n) | 
 |   `ASSERT(HWChipRev_A, hw_rev_o.chip_rev == LcCtrlChipRev[lc_ctrl_reg_pkg::HwRevFieldWidth-1:0], | 
 |           clk, ~rst_n) | 
 |  | 
 |  | 
 |   // Assertion controls | 
 |   `DV_ASSERT_CTRL("OtpProgH_DataStableWhenBidirectionalAndReq_A", | 
 |                   otp_prog_if.H_DataStableWhenBidirectionalAndReq_A) | 
 |   `DV_ASSERT_CTRL("OtpProgReqHighUntilAck_A", otp_prog_if.ReqHighUntilAck_A) | 
 |   `DV_ASSERT_CTRL("OtpProgAckAssertedOnlyWhenReqAsserted_A", | 
 |                   otp_prog_if.AckAssertedOnlyWhenReqAsserted_A) | 
 |   `DV_ASSERT_CTRL( | 
 |       "KmacIfSyncReqAckAckNeedsReq", | 
 |       dut.u_lc_ctrl_kmac_if.u_prim_sync_reqack_data_in.u_prim_sync_reqack.SyncReqAckAckNeedsReq) | 
 |   `DV_ASSERT_CTRL( | 
 |       "KmacIfSyncReqAckAckNeedsReq", | 
 |       dut.u_lc_ctrl_kmac_if.u_prim_sync_reqack_data_out.u_prim_sync_reqack.SyncReqAckAckNeedsReq) | 
 |   `DV_ASSERT_CTRL("KmacIfSyncReqAckAckNeedsReq", | 
 |                   kmac_app_if.req_data_if.H_DataStableWhenValidAndNotReady_A) | 
 |   `DV_ASSERT_CTRL("KmacIfSyncReqAckAckNeedsReq", kmac_app_if.req_data_if.ValidHighUntilReady_A) | 
 |   `DV_ASSERT_CTRL("FsmClkBypAckSync", dut.u_lc_ctrl_fsm.u_prim_lc_sync_clk_byp_ack) | 
 |   `DV_ASSERT_CTRL("FsmClkFlashRmaAckSync", dut.u_lc_ctrl_fsm.u_prim_lc_sync_flash_rma_ack) | 
 |   `DV_ASSERT_CTRL("FsmOtpTestTokensValidSync", dut.u_lc_ctrl_fsm.u_prim_lc_sync_test_token_valid) | 
 |   `DV_ASSERT_CTRL("FsmOtpRmaTokenValidSync", dut.u_lc_ctrl_fsm.u_prim_lc_sync_rma_token_valid) | 
 |   `DV_ASSERT_CTRL("StateRegs_A", tb.dut.u_lc_ctrl_fsm.u_state_regs_A) | 
 |   `DV_ASSERT_CTRL("StateRegs_A", tb.dut.FpvSecCmCtrlLcStateCheck_A) | 
 |   `DV_ASSERT_CTRL("FsmStateRegs_A", tb.dut.u_lc_ctrl_fsm.u_fsm_state_regs_A) | 
 |   `DV_ASSERT_CTRL("FsmStateRegs_A", tb.dut.FpvSecCmCtrlLcFsmCheck_A) | 
 |   `DV_ASSERT_CTRL("CountRegs_A", tb.dut.u_lc_ctrl_fsm.u_cnt_regs_A) | 
 |   `DV_ASSERT_CTRL("CountRegs_A", tb.dut.FpvSecCmCtrlLcCntCheck_A) | 
 |   `DV_ASSERT_CTRL("KmacFsmStateRegs_A", tb.dut.u_lc_ctrl_kmac_if.u_state_regs_A) | 
 |   `DV_ASSERT_CTRL("KmacFsmStateRegs_A", tb.dut.FpvSecCmCtrlKmacIfFsmCheck_A) | 
 |   `DV_ASSERT_CTRL("EscStaysOnOnceAsserted_A", tb.dut.u_lc_ctrl_fsm.EscStaysOnOnceAsserted_A) | 
 | endmodule |