From 0fa5ab5869ee6dac64d807cfd0a8399f8a47d7dc Mon Sep 17 00:00:00 2001 From: Fiscarelli Date: Wed, 16 Dec 2020 16:26:56 -0500 Subject: [PATCH] CEP Release v3.0 --- .DS_Store | Bin 0 -> 6148 bytes README.md | 47 +- cep_architecture.jpg | Bin 102286 -> 0 bytes cosim/README.md | 14 - cosim/bareMetalTests/Makefile | 3 + cosim/bareMetalTests/srotTest/Makefile | 32 + cosim/bareMetalTests/srotTest/c_dispatch.cc | 122 ++ cosim/bareMetalTests/srotTest/c_dispatch.h | 23 + cosim/bareMetalTests/srotTest/c_module.cc | 84 ++ cosim/bareMetalTests/srotTest/c_module.h | 18 + .../bareMetalTests/srotTest/riscv_wrapper.cc | 65 + cosim/bfmTests/Makefile | 2 + cosim/bfmTests/srotTest/Makefile | 31 + cosim/bfmTests/srotTest/c_dispatch.cc | 107 ++ cosim/bfmTests/srotTest/c_dispatch.h | 23 + cosim/bfmTests/srotTest/c_module.cc | 88 ++ cosim/bfmTests/srotTest/c_module.h | 18 + cosim/cep_buildChips.make | 10 +- cosim/drivers/cep_tests/CEP.h | 44 +- cosim/drivers/cep_tests/cep_aes.cc | 74 +- cosim/drivers/cep_tests/cep_apis.cc | 1 + cosim/drivers/cep_tests/cep_apis.h | 78 +- cosim/drivers/cep_tests/cep_riscv.cc | 220 ++- cosim/drivers/cep_tests/cep_riscv.h | 14 + cosim/drivers/cep_tests/cepregression.cc | 31 +- cosim/drivers/cep_tests/cepregression.h | 4 + cosim/drivers/diag/cepGpioTest.cc | 114 ++ cosim/drivers/diag/cepGpioTest.h | 40 + cosim/drivers/diag/cepSpiTest.cc | 109 ++ cosim/drivers/diag/cepSpiTest.h | 40 + cosim/drivers/diag/cepSrotTest.cc | 299 ++++ cosim/drivers/diag/cepSrotTest.h | 93 ++ cosim/drivers/diag/cepUartTest.cc | 164 +++ cosim/drivers/diag/cepUartTest.h | 42 + cosim/drivers/diag/random48.cc | 40 +- cosim/drivers/diag/random48.h | 8 +- cosim/drivers/linux/cep_diag.cc | 28 + cosim/drivers/linux/cep_diag.h | 2 + cosim/dvt/aes_capture.incl | 20 +- cosim/dvt/behav_models/cep_driver.v | 82 +- cosim/dvt/behav_models/tl_master_beh.v | 87 +- cosim/dvt/cep_adrMap.incl | 123 +- cosim/dvt/cep_hierMap.incl | 5 + cosim/dvt/cep_tb.v | 48 +- cosim/dvt/driver_common.incl | 24 + cosim/dvt/v2c_cmds.incl | 14 +- cosim/isaTests/Makefile | 24 +- cosim/share/access.cc | 29 + cosim/share/access.h | 2 + cosim/share/portable_io.h | 12 + cosim/share/shIpc.cc | 16 + cosim/share/shIpc.h | 5 +- cosim/simDiag/simPio.cc | 2 + cosim/simDiag/simPio.h | 2 + .../CEP_SecEvalTargets.pdf | Bin cep_logo.jpg => doc/cep_logo.jpg | Bin cep_logo.txt => doc/cep_logo.txt | 0 doc/cep_v3.0_architecture.jpg | Bin 0 -> 301316 bytes doc/related_logos.jpg | Bin 0 -> 24003 bytes doc/version.jpg | Bin 0 -> 8664 bytes get_external_dependencies.sh | 6 +- hdl_cores/aes/aes_192_mock_tss.sv | 251 ++++ hdl_cores/freedom/Makefile.vc707 | 115 +- hdl_cores/freedom/bootrom/sdboot/sd.c | 2 +- hdl_cores/freedom/common.mk | 12 +- hdl_cores/freedom/fpga-shells/.gitignore | 1 + hdl_cores/freedom/fpga-shells/README.md | 105 ++ hdl_cores/freedom/fpga-shells/build.wake | 14 + .../microsemi/common/tcl/libero.tcl | 253 ++++ .../constraints/PF_EvalKit_DDR3_fp.pdc | 34 + .../constraints/PF_EvalKit_DDR3_io.pdc | 319 ++++ .../constraints/PF_EvalKit_PCIe_fp.pdc | 29 + .../constraints/PF_EvalKit_PCIe_io.pdc | 133 ++ .../constraints/PF_EvalKit_base_io.pdc | 199 +++ .../constraints/PF_EvalKit_fp.pdc | 3 + .../constraints/chiplink_io.pdc | 432 ++++++ .../constraints/clock_groups.sdc | 5 + .../vera/constraints/false_paths.sdc | 41 + .../microsemi/vera/constraints/floor_plan.pdc | 4 + .../vera/constraints/pin_constraints.pdc | 11 + .../fpga-shells/microsemi/vera/tcl/board.tcl | 12 + .../src/main/scala/clocks/Bundles.scala | 17 + .../src/main/scala/clocks/ClockGroup.scala | 33 + .../src/main/scala/clocks/Nodes.scala | 70 + .../src/main/scala/clocks/PLLFactory.scala | 98 ++ .../src/main/scala/clocks/Parameters.scala | 77 + .../src/main/scala/clocks/ResetWrangler.scala | 43 + .../MicrosemiPolarFireDDR3.scala | 165 +++ .../MicrosemiPolarFireDDR3Periphery.scala | 37 + .../MicrosemiPolarFireDDR4.scala | 166 +++ .../MicrosemiPolarFireDDR4Periphery.scala | 37 + .../PolarFireEvalKitPCIeX4.scala | 75 + .../PolarFireEvalKitPCIeX4Periphery.scala | 35 + .../devices/xilinx/ethernet/ethernet.scala | 125 ++ .../main/scala/devices/xilinx/xdma/XDMA.scala | 52 + .../scala/devices/xilinx/xdma/package.scala | 10 + .../xilinxarty100tmig/XilinxArty100TMIG.scala | 171 +++ .../xilinxvc707mig/XilinxVC707MIG.scala | 170 +++ .../XilinxVC707MIGPeriphery.scala | 35 + .../xilinxvc707pciex1/XilinxVC707PCIeX1.scala | 76 + .../XilinxVC707PCIeX1Periphery.scala | 32 + .../xilinxvcu118mig/XilinxVCU118MIG.scala | 163 +++ .../XilinxVCU118MIGPeriphery.scala | 35 + .../corejtagdebug/corejtagdebug.scala | 71 + .../main/scala/ip/microsemi/polarfire.scala | 40 + .../polarfire_ccc/PolarFireCCC.scala | 81 + .../PolarFireClockDivider.scala | 40 + .../polarfire_ddr3/PolarFireDDR3.scala | 129 ++ .../polarfire_ddr4/PolarFireDDR4.scala | 132 ++ .../polarfire_dll/PolarFireDLL.scala | 46 + .../PolarFireGlitchlessMux.scala | 41 + .../PolarFireInitMonitor.scala | 32 + .../PolarFireOscillator.scala | 37 + .../PolarFirePCIeRootPort.scala | 608 ++++++++ .../polarfire_reset/PolarFireReset.scala | 44 + .../polarfire_tx_pll/PolarFireTxPLL.scala | 45 + .../PolarFireTransceiverRefClk.scala | 46 + .../src/main/scala/ip/xilinx/Unisim.scala | 370 +++++ .../src/main/scala/ip/xilinx/Xilinx.scala | 490 +++++++ .../ip/xilinx/arty100tmig/arty100tmig.scala | 263 ++++ .../ip/xilinx/ibufds_gte2/ibufds_gte2.scala | 18 + .../vc707axi_to_pcie_x1.scala | 491 +++++++ .../scala/ip/xilinx/vc707mig/vc707mig.scala | 534 +++++++ .../scala/ip/xilinx/vcu118mig/vcu118mig.scala | 179 +++ .../src/main/scala/ip/xilinx/xdma/xdma.scala | 469 ++++++ .../ip/xilinx/xxv_ethernet/nfmac10g.scala | 52 + .../ip/xilinx/xxv_ethernet/xxv_ethernet.scala | 177 +++ .../src/main/scala/shell/ButtonOverlay.scala | 28 + .../main/scala/shell/CTSResetOverlay.scala | 23 + .../main/scala/shell/ChipLinkOverlay.scala | 58 + .../src/main/scala/shell/ClockOverlay.scala | 81 + .../src/main/scala/shell/DDROverlay.scala | 27 + .../src/main/scala/shell/Ethernet.scala | 51 + .../src/main/scala/shell/GPIOOverlay.scala | 35 + .../main/scala/shell/GPIOPMODOverlay.scala | 45 + .../src/main/scala/shell/I2COverlay.scala | 38 + .../src/main/scala/shell/IOShell.scala | 159 ++ .../scala/shell/JTAGDebugBScanOverlay.scala | 31 + .../main/scala/shell/JTAGDebugOverlay.scala | 50 + .../src/main/scala/shell/LEDOverlay.scala | 30 + .../src/main/scala/shell/PCIeOverlay.scala | 31 + .../src/main/scala/shell/PWMOverlay.scala | 36 + .../src/main/scala/shell/PinOverlay.scala | 38 + .../src/main/scala/shell/SDIOOverlay.scala | 70 + .../main/scala/shell/SPIFlashOverlay.scala | 37 + .../src/main/scala/shell/Shell.scala | 80 + .../src/main/scala/shell/SwitchOverlay.scala | 25 + .../main/scala/shell/TracePMODOverlay.scala | 30 + .../src/main/scala/shell/UARTOverlay.scala | 46 + .../src/main/scala/shell/Util.scala | 53 + .../main/scala/shell/cJTAGDebugOverlay.scala | 57 + .../shell/microsemi/ChipLinkOverlay.scala | 84 ++ .../scala/shell/microsemi/ClockOverlay.scala | 23 + .../scala/shell/microsemi/LEDOverlay.scala | 19 + .../microsemi/PolarFireEvalKitShell.scala | 661 +++++++++ .../shell/microsemi/PolarFireShell.scala | 42 + .../scala/shell/microsemi/VeraShell.scala | 251 ++++ .../src/main/scala/shell/package.scala | 10 + .../scala/shell/xilinx/Arty100TShell.scala | 369 +++++ .../main/scala/shell/xilinx/ArtyShell.scala | 245 ++++ .../scala/shell/xilinx/ButtonOverlay.scala | 34 + .../scala/shell/xilinx/ChipLinkOverlay.scala | 73 + .../scala/shell/xilinx/ClockOverlay.scala | 41 + .../shell/xilinx/GPIOPMODXilinxOverlay.scala | 13 + .../shell/xilinx/GPIOXilinxOverlay.scala | 20 + .../main/scala/shell/xilinx/I2COverlay.scala | 21 + .../shell/xilinx/JTAGDebugBScanOverlay.scala | 29 + .../scala/shell/xilinx/JTAGDebugOverlay.scala | 21 + .../main/scala/shell/xilinx/LEDOverlay.scala | 29 + .../main/scala/shell/xilinx/PWMOverlay.scala | 19 + .../shell/xilinx/PeripheralsVC707Shell.scala | 163 +++ .../scala/shell/xilinx/PinXilinxOverlay.scala | 13 + .../main/scala/shell/xilinx/SDIOOverlay.scala | 13 + .../shell/xilinx/SPIFlashXilinxOverlay.scala | 23 + .../scala/shell/xilinx/SwitchOverlay.scala | 34 + .../scala/shell/xilinx/TracePMODOverlay.scala | 29 + .../main/scala/shell/xilinx/UARTOverlay.scala | 25 + .../scala/shell/xilinx/UltraScaleShell.scala | 135 ++ .../scala/shell/xilinx/VC707NewShell.scala | 337 +++++ .../main/scala/shell/xilinx/VC707Shell.scala | 613 ++++++++ .../scala/shell/xilinx/VCU118NewShell.scala | 452 ++++++ .../main/scala/shell/xilinx/VCU118Shell.scala | 276 ++++ .../main/scala/shell/xilinx/XilinxShell.scala | 83 ++ .../shell/xilinx/cJTAGDebugOverlay.scala | 13 + .../fpga-shells/vsrc/nfmac10g/axis2xgmii.v | 499 +++++++ .../fpga-shells/vsrc/nfmac10g/nfmac10g.v | 195 +++ .../fpga-shells/vsrc/nfmac10g/padding_ctrl.v | 288 ++++ .../fpga-shells/vsrc/nfmac10g/rst_mod.v | 103 ++ .../freedom/fpga-shells/vsrc/nfmac10g/rx.v | 99 ++ .../freedom/fpga-shells/vsrc/nfmac10g/tx.v | 139 ++ .../fpga-shells/vsrc/nfmac10g/xgmii2axis.v | 448 ++++++ .../vsrc/nfmac10g/xgmii_includes.vh | 494 +++++++ .../freedom/fpga-shells/wit-manifest.json | 32 + hdl_cores/freedom/fpga-shells/xilinx/Makefile | 42 + .../xilinx/arty/constraints/arty-config.xdc | 5 + .../xilinx/arty/constraints/arty-master.xdc | 240 +++ .../fpga-shells/xilinx/arty/tcl/board.tcl | 5 + .../fpga-shells/xilinx/arty/tcl/ip.tcl | 44 + .../arty_a7_100/constraints/arty-config.xdc | 5 + .../arty_a7_100/constraints/arty-master.xdc | 240 +++ .../xilinx/arty_a7_100/tcl/board.tcl | 5 + .../fpga-shells/xilinx/arty_a7_100/tcl/ip.tcl | 43 + .../xilinx/common/tcl/bitstream.tcl | 10 + .../fpga-shells/xilinx/common/tcl/boards.tcl | 9 + .../fpga-shells/xilinx/common/tcl/init.tcl | 48 + .../fpga-shells/xilinx/common/tcl/opt.tcl | 7 + .../fpga-shells/xilinx/common/tcl/place.tcl | 13 + .../xilinx/common/tcl/prologue.tcl | 138 ++ .../fpga-shells/xilinx/common/tcl/report.tcl | 44 + .../fpga-shells/xilinx/common/tcl/route.tcl | 10 + .../fpga-shells/xilinx/common/tcl/synth.tcl | 25 + .../fpga-shells/xilinx/common/tcl/util.tcl | 24 + .../fpga-shells/xilinx/common/tcl/vivado.tcl | 43 + .../xilinx/common/tcl/write_cfgmem.tcl | 26 + .../xilinx/common/vsrc/PowerOnResetFPGAOnly.v | 16 + .../xilinx/vc707/constraints/vc707-master.xdc | 6 + .../fpga-shells/xilinx/vc707/tcl/board.tcl | 4 + .../fpga-shells/xilinx/vc707/tcl/clocks.tcl | 60 + .../fpga-shells/xilinx/vc707/tcl/ios.tcl | 68 + .../fpga-shells/xilinx/vc707/vsrc/sdio.v | 58 + .../xilinx/vc707/vsrc/vc707reset.v | 78 + .../vcu118/constraints/vcu118-master.xdc | 12 + .../fpga-shells/xilinx/vcu118/tcl/board.tcl | 6 + .../fpga-shells/xilinx/vcu118/vsrc/sdio.v | 59 + .../xilinx/vcu118/vsrc/vcu118reset.v | 78 + .../mitll-blocks/src/main/scala/aes.scala | 395 +++-- .../src/main/scala/cep_addresses.scala | 92 +- .../src/main/scala/cep_registers.scala | 4 +- .../mitll-blocks/src/main/scala/srot.scala | 280 ++++ .../main/scala/unleashed/DevKitConfigs.scala | 18 +- .../scala/unleashed/DevKitFPGADesign.scala | 2 + hdl_cores/gps/gps_clkgen.v | 2 + hdl_cores/llki/llki_pkg.sv | 258 ++++ hdl_cores/llki/llki_pp_wrapper.sv | 466 ++++++ hdl_cores/llki/srot_wrapper.sv | 1304 +++++++++++++++++ hdl_cores/llki/tlul_err.sv | 113 ++ hdl_cores/llki/top_pkg.sv | 42 + licenseLog.txt | 7 + .../llki_supports/llki_discrete.sv | 2 +- unit_simulation/llki_supports/llki_rom.sv | 1 + unit_simulation/llki_supports/llki_struct.h | 2 +- unit_simulation/llki_supports/llki_tl.sv | 2 +- unit_simulation/llki_supports/tlul_pkg.sv | 1 + 243 files changed, 22463 insertions(+), 433 deletions(-) create mode 100644 .DS_Store delete mode 100644 cep_architecture.jpg create mode 100644 cosim/bareMetalTests/srotTest/Makefile create mode 100644 cosim/bareMetalTests/srotTest/c_dispatch.cc create mode 100644 cosim/bareMetalTests/srotTest/c_dispatch.h create mode 100644 cosim/bareMetalTests/srotTest/c_module.cc create mode 100644 cosim/bareMetalTests/srotTest/c_module.h create mode 100644 cosim/bareMetalTests/srotTest/riscv_wrapper.cc create mode 100644 cosim/bfmTests/srotTest/Makefile create mode 100644 cosim/bfmTests/srotTest/c_dispatch.cc create mode 100644 cosim/bfmTests/srotTest/c_dispatch.h create mode 100644 cosim/bfmTests/srotTest/c_module.cc create mode 100644 cosim/bfmTests/srotTest/c_module.h create mode 100644 cosim/drivers/diag/cepGpioTest.cc create mode 100644 cosim/drivers/diag/cepGpioTest.h create mode 100644 cosim/drivers/diag/cepSpiTest.cc create mode 100644 cosim/drivers/diag/cepSpiTest.h create mode 100644 cosim/drivers/diag/cepSrotTest.cc create mode 100644 cosim/drivers/diag/cepSrotTest.h create mode 100644 cosim/drivers/diag/cepUartTest.cc create mode 100644 cosim/drivers/diag/cepUartTest.h rename CEP_SecEvalTargets.pdf => doc/CEP_SecEvalTargets.pdf (100%) rename cep_logo.jpg => doc/cep_logo.jpg (100%) rename cep_logo.txt => doc/cep_logo.txt (100%) create mode 100644 doc/cep_v3.0_architecture.jpg create mode 100644 doc/related_logos.jpg create mode 100644 doc/version.jpg create mode 100644 hdl_cores/aes/aes_192_mock_tss.sv create mode 100644 hdl_cores/freedom/fpga-shells/.gitignore create mode 100644 hdl_cores/freedom/fpga-shells/README.md create mode 100644 hdl_cores/freedom/fpga-shells/build.wake create mode 100644 hdl_cores/freedom/fpga-shells/microsemi/common/tcl/libero.tcl create mode 100644 hdl_cores/freedom/fpga-shells/microsemi/polarfireevalkit/constraints/PF_EvalKit_DDR3_fp.pdc create mode 100644 hdl_cores/freedom/fpga-shells/microsemi/polarfireevalkit/constraints/PF_EvalKit_DDR3_io.pdc create mode 100644 hdl_cores/freedom/fpga-shells/microsemi/polarfireevalkit/constraints/PF_EvalKit_PCIe_fp.pdc create mode 100644 hdl_cores/freedom/fpga-shells/microsemi/polarfireevalkit/constraints/PF_EvalKit_PCIe_io.pdc create mode 100644 hdl_cores/freedom/fpga-shells/microsemi/polarfireevalkit/constraints/PF_EvalKit_base_io.pdc create mode 100644 hdl_cores/freedom/fpga-shells/microsemi/polarfireevalkit/constraints/PF_EvalKit_fp.pdc create mode 100644 hdl_cores/freedom/fpga-shells/microsemi/polarfireevalkit/constraints/chiplink_io.pdc create mode 100644 hdl_cores/freedom/fpga-shells/microsemi/polarfireevalkit/constraints/clock_groups.sdc create mode 100644 hdl_cores/freedom/fpga-shells/microsemi/vera/constraints/false_paths.sdc create mode 100644 hdl_cores/freedom/fpga-shells/microsemi/vera/constraints/floor_plan.pdc create mode 100644 hdl_cores/freedom/fpga-shells/microsemi/vera/constraints/pin_constraints.pdc create mode 100644 hdl_cores/freedom/fpga-shells/microsemi/vera/tcl/board.tcl create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/clocks/Bundles.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/clocks/ClockGroup.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/clocks/Nodes.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/clocks/PLLFactory.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/clocks/Parameters.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/clocks/ResetWrangler.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/devices/microsemi/polarfire_ddr3/MicrosemiPolarFireDDR3.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/devices/microsemi/polarfire_ddr3/MicrosemiPolarFireDDR3Periphery.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/devices/microsemi/polarfire_ddr4/MicrosemiPolarFireDDR4.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/devices/microsemi/polarfire_ddr4/MicrosemiPolarFireDDR4Periphery.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/devices/microsemi/polarfire_pcie/PolarFireEvalKitPCIeX4.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/devices/microsemi/polarfire_pcie/PolarFireEvalKitPCIeX4Periphery.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/devices/xilinx/ethernet/ethernet.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/devices/xilinx/xdma/XDMA.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/devices/xilinx/xdma/package.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/devices/xilinx/xilinxarty100tmig/XilinxArty100TMIG.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/devices/xilinx/xilinxvc707mig/XilinxVC707MIG.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/devices/xilinx/xilinxvc707mig/XilinxVC707MIGPeriphery.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/devices/xilinx/xilinxvc707pciex1/XilinxVC707PCIeX1.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/devices/xilinx/xilinxvc707pciex1/XilinxVC707PCIeX1Periphery.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/devices/xilinx/xilinxvcu118mig/XilinxVCU118MIG.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/devices/xilinx/xilinxvcu118mig/XilinxVCU118MIGPeriphery.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/corejtagdebug/corejtagdebug.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire_ccc/PolarFireCCC.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire_clock_divider/PolarFireClockDivider.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire_ddr3/PolarFireDDR3.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire_ddr4/PolarFireDDR4.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire_dll/PolarFireDLL.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire_glitchless_mux/PolarFireGlitchlessMux.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire_init_monitor/PolarFireInitMonitor.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire_oscillator/PolarFireOscillator.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire_pcie_rootport/PolarFirePCIeRootPort.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire_reset/PolarFireReset.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire_tx_pll/PolarFireTxPLL.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire_xcvr_refclk/PolarFireTransceiverRefClk.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/ip/xilinx/Unisim.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/ip/xilinx/Xilinx.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/ip/xilinx/arty100tmig/arty100tmig.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/ip/xilinx/ibufds_gte2/ibufds_gte2.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/ip/xilinx/vc707axi_to_pcie_x1/vc707axi_to_pcie_x1.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/ip/xilinx/vc707mig/vc707mig.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/ip/xilinx/vcu118mig/vcu118mig.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/ip/xilinx/xdma/xdma.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/ip/xilinx/xxv_ethernet/nfmac10g.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/ip/xilinx/xxv_ethernet/xxv_ethernet.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/ButtonOverlay.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/CTSResetOverlay.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/ChipLinkOverlay.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/ClockOverlay.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/DDROverlay.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/Ethernet.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/GPIOOverlay.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/GPIOPMODOverlay.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/I2COverlay.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/IOShell.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/JTAGDebugBScanOverlay.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/JTAGDebugOverlay.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/LEDOverlay.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/PCIeOverlay.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/PWMOverlay.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/PinOverlay.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/SDIOOverlay.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/SPIFlashOverlay.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/Shell.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/SwitchOverlay.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/TracePMODOverlay.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/UARTOverlay.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/Util.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/cJTAGDebugOverlay.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/microsemi/ChipLinkOverlay.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/microsemi/ClockOverlay.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/microsemi/LEDOverlay.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/microsemi/PolarFireEvalKitShell.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/microsemi/PolarFireShell.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/microsemi/VeraShell.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/package.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/Arty100TShell.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/ArtyShell.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/ButtonOverlay.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/ChipLinkOverlay.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/ClockOverlay.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/GPIOPMODXilinxOverlay.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/GPIOXilinxOverlay.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/I2COverlay.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/JTAGDebugBScanOverlay.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/JTAGDebugOverlay.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/LEDOverlay.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/PWMOverlay.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/PeripheralsVC707Shell.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/PinXilinxOverlay.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/SDIOOverlay.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/SPIFlashXilinxOverlay.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/SwitchOverlay.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/TracePMODOverlay.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/UARTOverlay.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/UltraScaleShell.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/VC707NewShell.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/VC707Shell.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/VCU118NewShell.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/VCU118Shell.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/XilinxShell.scala create mode 100644 hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/cJTAGDebugOverlay.scala create mode 100644 hdl_cores/freedom/fpga-shells/vsrc/nfmac10g/axis2xgmii.v create mode 100644 hdl_cores/freedom/fpga-shells/vsrc/nfmac10g/nfmac10g.v create mode 100644 hdl_cores/freedom/fpga-shells/vsrc/nfmac10g/padding_ctrl.v create mode 100644 hdl_cores/freedom/fpga-shells/vsrc/nfmac10g/rst_mod.v create mode 100644 hdl_cores/freedom/fpga-shells/vsrc/nfmac10g/rx.v create mode 100644 hdl_cores/freedom/fpga-shells/vsrc/nfmac10g/tx.v create mode 100644 hdl_cores/freedom/fpga-shells/vsrc/nfmac10g/xgmii2axis.v create mode 100644 hdl_cores/freedom/fpga-shells/vsrc/nfmac10g/xgmii_includes.vh create mode 100644 hdl_cores/freedom/fpga-shells/wit-manifest.json create mode 100644 hdl_cores/freedom/fpga-shells/xilinx/Makefile create mode 100644 hdl_cores/freedom/fpga-shells/xilinx/arty/constraints/arty-config.xdc create mode 100644 hdl_cores/freedom/fpga-shells/xilinx/arty/constraints/arty-master.xdc create mode 100644 hdl_cores/freedom/fpga-shells/xilinx/arty/tcl/board.tcl create mode 100644 hdl_cores/freedom/fpga-shells/xilinx/arty/tcl/ip.tcl create mode 100644 hdl_cores/freedom/fpga-shells/xilinx/arty_a7_100/constraints/arty-config.xdc create mode 100644 hdl_cores/freedom/fpga-shells/xilinx/arty_a7_100/constraints/arty-master.xdc create mode 100644 hdl_cores/freedom/fpga-shells/xilinx/arty_a7_100/tcl/board.tcl create mode 100644 hdl_cores/freedom/fpga-shells/xilinx/arty_a7_100/tcl/ip.tcl create mode 100644 hdl_cores/freedom/fpga-shells/xilinx/common/tcl/bitstream.tcl create mode 100644 hdl_cores/freedom/fpga-shells/xilinx/common/tcl/boards.tcl create mode 100644 hdl_cores/freedom/fpga-shells/xilinx/common/tcl/init.tcl create mode 100644 hdl_cores/freedom/fpga-shells/xilinx/common/tcl/opt.tcl create mode 100644 hdl_cores/freedom/fpga-shells/xilinx/common/tcl/place.tcl create mode 100644 hdl_cores/freedom/fpga-shells/xilinx/common/tcl/prologue.tcl create mode 100644 hdl_cores/freedom/fpga-shells/xilinx/common/tcl/report.tcl create mode 100644 hdl_cores/freedom/fpga-shells/xilinx/common/tcl/route.tcl create mode 100644 hdl_cores/freedom/fpga-shells/xilinx/common/tcl/synth.tcl create mode 100644 hdl_cores/freedom/fpga-shells/xilinx/common/tcl/util.tcl create mode 100644 hdl_cores/freedom/fpga-shells/xilinx/common/tcl/vivado.tcl create mode 100644 hdl_cores/freedom/fpga-shells/xilinx/common/tcl/write_cfgmem.tcl create mode 100644 hdl_cores/freedom/fpga-shells/xilinx/common/vsrc/PowerOnResetFPGAOnly.v create mode 100644 hdl_cores/freedom/fpga-shells/xilinx/vc707/constraints/vc707-master.xdc create mode 100644 hdl_cores/freedom/fpga-shells/xilinx/vc707/tcl/board.tcl create mode 100644 hdl_cores/freedom/fpga-shells/xilinx/vc707/tcl/clocks.tcl create mode 100644 hdl_cores/freedom/fpga-shells/xilinx/vc707/tcl/ios.tcl create mode 100644 hdl_cores/freedom/fpga-shells/xilinx/vc707/vsrc/sdio.v create mode 100644 hdl_cores/freedom/fpga-shells/xilinx/vc707/vsrc/vc707reset.v create mode 100644 hdl_cores/freedom/fpga-shells/xilinx/vcu118/constraints/vcu118-master.xdc create mode 100644 hdl_cores/freedom/fpga-shells/xilinx/vcu118/tcl/board.tcl create mode 100644 hdl_cores/freedom/fpga-shells/xilinx/vcu118/vsrc/sdio.v create mode 100644 hdl_cores/freedom/fpga-shells/xilinx/vcu118/vsrc/vcu118reset.v create mode 100644 hdl_cores/freedom/mitll-blocks/src/main/scala/srot.scala create mode 100644 hdl_cores/llki/llki_pkg.sv create mode 100644 hdl_cores/llki/llki_pp_wrapper.sv create mode 100644 hdl_cores/llki/srot_wrapper.sv create mode 100644 hdl_cores/llki/tlul_err.sv create mode 100644 hdl_cores/llki/top_pkg.sv diff --git a/.DS_Store b/.DS_Store new file mode 100644 index 0000000000000000000000000000000000000000..25cb17904a97682fac1b86fd5e4a22874701747c GIT binary patch literal 6148 zcmeHKO-sW-5PfSa)QTux6i>N`o`ix2Pnt?Sdh+7U+NRh-YKrv(q=))9YGxkh|Z zJ838V!9=8Ycm=!ye^CK>cFWko1$wy7KEJ9v8fDk|Nu$w(r?`4i?a5C9$pPigga1sG2+1I$ZZ}*-xis6!4z1Pr>hJN|sYk{Z;C5jXhhevS`rHUIDLw zSKvzlc|Qakf}zFKpni35(w_jtGTqvEtlyl(Kpe!-Vrq~cnlhM+cP - + +

+

+

- v2.71 -
Copyright 2020 Massachusetts Institute of Technology

+

+ +

+ +The Common Evaluation Platform (CEP) is intended as a surrogate System on a Chip (SoC) that provides users an open-source evaluation platform for the evaluation of custom tools and techniques. An extensive verification environment provided to ensure the underlying functionality is maintained even after modification. -
+The Logic Locking Key Interface (LLKI) has been provided as a representative means of distributing key / configuration material to LLKI-enabled cores. -The Common Evaluation Platform (CEP) is intended as a surrogate System on a Chip (SoC) allowing users to test a variety of tools and techniques. Test vectors are provided to ensure the underlying functionality is maintained even after modification. +For CEP v3.0, the Surrogate Root of Trust (SRoT) and LLKI-enabled AES-192 core has been added. Example test vectors have been with additional LLKI information being available in the comments of files located in ./hdl_cores/llki.

- +

-Additional information on the objectives of the CEP may be found in [./CEP_SecEvalTargets.pdf](CEP_SecEvalTargets.pdf). +Additional information on the objectives of the CEP may be found in [./doc/CEP_SecEvalTargets.pdf](CEP_SecEvalTargets.pdf). The CEP is based on the SiFive U500 Platform which leverages the UCB Rocket Chip. Much of the design is described in Chisel (https://github.com/freechipsproject/chisel3), a domain specific extension to Scala tailored towards constructing hardware. The output of the Chisel generators is synthesizable verilog. @@ -82,6 +88,8 @@ The RISC-V source code resides in /software/riscv-gnu-toolchain Begin by installing the dependencies by executing the following: `sudo apt install autoconf automake autotools-dev curl python3 libmpc-dev libmpfr-dev libgmp-dev gawk build-essential bison flex texinfo gperf libtool patchutils bc zlib1g-dev libexpat-dev` +Now, build the toolchain. + Ensure you have write permissions to the directory pointed to by $RISCV and that the current shell has NOT sourced the Xilinx Vivado environment script: $ cd /software/riscv-gnu-toolchain @@ -138,7 +146,10 @@ Install the required dependencies by running the following command: |-- generated_dsp_code/ - Placeholder for the generated DSP code that cannot be | directly included in the CEP repository due to licensing | restrictions. - |-- software/ + | + |-- opentitan/ - Copy of the OpenTitan repository, some components are used by the LLKI. + | + |-- software/ | |-- freedom-u-sdk/ - Directory containing an export of the https://github.com/ | mcd500/freedom-u-sdk directory, which is a fork of the @@ -274,7 +285,7 @@ You should see the following logo/text appear: ./+++++++++++oo+++: +oo++o++++o+o+oo+oo.- `s+++s`- .--:---:-:-::-::` -::::::::::::::::::. :::::. - Common Evaluation Platform v2.71 + Common Evaluation Platform v3.0 Copyright (C) 2020 Massachusetts Institute of Technology Built upon the SiFive Freedom U500 Platform using @@ -297,7 +308,7 @@ At the command prompt, you can run the CEP diagnostics by commanding `cep_diag`. A partial output should be similar to: ```sh -*** CEP Tag=CEPTest CEP HW VERSION = v2.71 was built on Sep 17 2020 12:01:26 *** +*** CEP Tag=CEPTest CEP HW VERSION = v3.00 was built on Sep 17 2020 12:01:26 *** CEP FPGA Physical=0x70000000 -> Virtual=0x00000020004fa000 gSkipInit=0/0 gverbose=0/0 @@ -428,7 +439,7 @@ v2.6 - (18 September 2020) https://github.com/sifive/sifive-blocks/tree/12bdbe50636b6c57c8dc997e483787fdb5ee540b - Dec 17, 2019 https://github.com/mcd500/freedom-u-sdk/tree/29fe529f8dd8e1974fe1743184b3e13ebb2a21dc - Apr 12, 2019 * riscv-tools (formerly under rocket-chip) now located in ./software/riscv-gnu-toolchain -7* KNOWN ISSUES: +* KNOWN ISSUES: - The iCacheCoherency passes when running bare-metal simulation, but fails when running on the VC-707. There is an issue with the iCache protocol that the tight-looped iCache coherency test results in one or more of the Rocket Cores (there are 4 in the CEP) L1 iCache not getting the value associated with the most recent write to instruction memory. @@ -455,8 +466,11 @@ v2.7 - (28 October 2020) - isaTests/rv64ud-p-ldst v2.71 - (2 November 2020) -* Corrected README.md issues +* Corrected README.md issue +v3.0 - (18 December 2020) +* Initial LLKI release with Surrogate Root of Trust +* AES core replaced with LLKI-enabled AES core, all other cores remain unchanged ## Licensing The CEP been developed with a goal of using components with non-viral, open source licensing whenever possible. When not feasible (such as Linux), pointers to reference repositories are given using the [get_external_dependencies.sh](./get_external_dependencies.sh) script. @@ -466,10 +480,11 @@ Additional licensing information can be found in the [LICENSE](./LICENSE) and [l ## DISTRIBUTION STATEMENT A. Approved for public release: distribution unlimited. -This material is based upon work supported by the Assistant Secretary of Defense for Research and Engineering under Air Force Contract No. FA8721-05-C-0002 and/or FA8702-15-D-0001. Any opinions, findings, conclusions or recommendations expressed in this material are those of the author(s) and do not necessarily reflect the views of the Assistant Secretary of Defense for Research and Engineering. +© 2020 MASSACHUSETTS INSTITUTE OF TECHNOLOGY -© 2020 Massachusetts Institute of Technology. +Subject to FAR 52.227-11 – Patent Rights – Ownership by the Contractor (May 2014) +SPDX-License-Identifier: BSD-2-Clause -The software/firmware is provided to you on an as-is basis. +This material is based upon work supported by the Name of Sponsor under Air Force Contract No. FA8721-05-C-0002 and/or FA8702-15-D-0001. Any opinions, findings, conclusions or recommendations expressed in this material are those of the author(s) and do not necessarily reflect the views of the Name of Sponsor. -Delivered to the U.S. Government with Unlimited Rights, as defined in DFARS Part 252.227-7013 or 7014 (Feb 2014). Notwithstanding any copyright notice, U.S. Government rights in this work are defined by DFARS 252.227-7013 or DFARS 252.227-7014 as detailed above. Use of this work other than as specifically authorized by the U.S. Government may violate any copyrights that exist in this work. +The software/firmware is provided to you on an As-Is basis \ No newline at end of file diff --git a/cep_architecture.jpg b/cep_architecture.jpg deleted file mode 100644 index 46fc581a854391a5d8089b3759f3ee6a573a24b0..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 102286 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ŏ_=JO#I*#g>q&Bd{6}9~G^cn-Z74Qjpt3gTj zpa`yd6iogAC9aK^{#etOdifeS*nR5ZhZoANQ8&8NQn{wb}kP2|ew9w|iLzZ3I5|Agqf?d#r%JWfCOPO2pN+64tyv{uBp z#)Uq0^#Fse$q~=|Dfi5h(f%_el?ST&6Qdx$%1XJcOycyJRDcquWbjv;Y=mZ0Q&M3z z4ky)0AUD-SLe-AtY#JE|-R=QK4y2HiXo0!7)uS%loBNF{ru@-wghctf`;F9!_1w;H zSukMp4pANoY705>D9ct{a<`q*_vVuD0l6v_M^RUoN{C>g$h)!bV?pGW3jIf6Nj-_F ziP8Do!F(Z?;zZ}<7#LWZixJRTvTN^c>wAQUaS>w(mmkY9F>wF*OJPB3diaK~vOxFQS@C zDDksUsw0}B2hC!k?dSA|3IUZ)Y%U7P`MSv~>6-IC-5N~+50((sZO_X~Z^j2D^QDGb z*MSOLs1X?6EwWxxqzV#bakNbI6dJsCetQ#e_s^^`*kHe6Hog_4&u&;WdyV1NS@`nm ztu+S5B)SS777r+I!D9g!E08pN4}@#IMi=~s$J4u17pp7QOL#5U7?yz2n*$rvqKad> z8R@|+m5>l%54=K^)zIESNBfc5%MiM}>dG6?!>*wlLpcDQY85EMJz}#WbRMm#ZEFmwj70R;zvL2|f~lSJ4-`eIXpl-APrF`^8ky3f z?!qjyv;pn6(H&ldngtUNH^Hb)%OFERSu~VJTVt3CUk3YO6It{GlhvP+RR>X&AqXiG zWy!fB2ifNVa2Tvje{YVPTTG&}Xi=Yy&!a{av3B`gw_+FuGkXq|i-C&O>)T)^W2-|E#>1Kp~e1oOZKCUr5Z2bb>pAB5XwHF9>h_)jHa=)t#*J#JPI}e3E4;`@DS)G zl>UP9adQMn`nE>(1C#QrB370DY@9X$R{779GkW2yG)U0ShLX;q1|eI-yhY4^;T~JW zypfG;apr%KvRj;agD~9U%p0ZRmYVSwy>3g**q}9UsTo^3GcZE7bmo741MpVi4#Lcy z$^i`%uCY9@>7Jud%=fu-v8nOm3JTD~FVhlr^DA|kOMn9uM? zs%EyKk=m@HX(Gb7{-M_>{?_7(KUHayZN1r`{{g0j%}FjVP^zg73G^lqGlhZ}&{tY< z9B%iYnqzHL&|TEy^cusdt-t)k1Mth``)9!rVN=iC@2*^>GyOkKj`!JK(zrQ3J*{3d zouJ`8h}`ZFMr-Pw)o_NId|6|N*^9z61H~=fA_l&vY;j2Zs`vNF6k`ZWw)=@_N5KWu*OX +#include "v2c_cmds.h" +#include "access.h" +#include "c_dispatch.h" +#include "c_module.h" +#include "cep_apis.h" +#include "cep_adrMap.h" +#include "simPio.h" +/* + * main + */ +int main(int argc, char *argv[]) +{ + + /* ===================================== */ + /* SETUP SECTION FOR SIMULATION */ + /* ===================================== */ + unsigned long seed; + sscanf(argv[1],"0x%x",&seed); + printf("Seed = 0x%x\n",seed); + int errCnt = 0; + int verbose = 0x1f; + + /* ===================================== */ + /* spawn all the paralle threads */ + /* ===================================== */ + int activeSlot=0; // only 1 board + // + // ============================ + // fork all the tests here + // ============================ + // + shPthread thr; + // + // max number of cores not include the system thread + // + int maxHost = MAX_CORES; // number of cores/threads + // + // each bit is to turn on the given core (bit0 = core0, bit1=core1, etc..) + // + long unsigned int mask = 1 << (seed & 0x3); + // + // Set the active CPU mask before spawn the threads... + // + thr.SetActiveMask(mask); + // + // c_module is the threead to run + // + for (int i=0;i +#include "random48.h" + +#include "cep_adrMap.h" +#include "cep_apis.h" +#include "simdiag_global.h" +#include "cepregression.h" +#include "simPio.h" + +// +void *c_module(void *arg) { + + + // ====================================== + // Set up + // ====================================== + pthread_parm_t *tParm = (pthread_parm_t *)arg; + int errCnt = 0; + int slotId = tParm->slotId; + int cpuId = tParm->cpuId; + int verbose = tParm->verbose; + Int32U seed = tParm->seed; + int restart = tParm->restart; + int offset = GET_OFFSET(slotId,cpuId); + GlobalShMemory.getSlotCpuId(offset,&slotId,&cpuId); + //printf("offset=%x seed=%x verbose=%x GlobalShMemory=%x\n",offset,seed, verbose,(unsigned long) &GlobalShMemory); + // notify I am Alive!!! + shIpc *ptr = GlobalShMemory.getIpcPtr(offset); + ptr->SetAliveStatus(); + sleep(1); + + // ====================================== + // Test is Here + // ====================================== + simPio pio; + pio.MaybeAThread(); // chec + pio.EnableShIpc(1); + pio.SetVerbose(verbose); + + // + // ====================================== + // Test starts here + // ====================================== + // MUST + // wait until Calibration is done.. + //int calibDone = calibrate_ddr3(50); + int calibDone = is_program_loaded(50); + + // + errCnt += check_bare_status(cpuId,500); + // + pio.RunClk(100); + // + // ====================================== + // Exit + // ====================================== +cleanup: + if (errCnt != 0) { + LOGI("======== TEST FAIL ========== %x\n",errCnt); + } else { + LOGI("======== TEST PASS ========== \n"); + } + // shIpc *ptr = GlobalShMemory.getIpcPtr(offset); + ptr->SetError(errCnt); + ptr->SetThreadDone(); + pthread_exit(NULL); + return ((void *)NULL); +} + diff --git a/cosim/bareMetalTests/srotTest/c_module.h b/cosim/bareMetalTests/srotTest/c_module.h new file mode 100644 index 0000000..92a0535 --- /dev/null +++ b/cosim/bareMetalTests/srotTest/c_module.h @@ -0,0 +1,18 @@ +//************************************************************************ +// Copyright (C) 2020 Massachusetts Institute of Technology +// SPDX short identifier: BSD-2-Clause +// +// File Name: +// Program: Common Evaluation Platform (CEP) +// Description: +// Notes: +// +//************************************************************************ +#ifndef c_module_H +#define c_module_H + +#include "shPthread.h" + +void *c_module(void *); /* thread routine */ + +#endif diff --git a/cosim/bareMetalTests/srotTest/riscv_wrapper.cc b/cosim/bareMetalTests/srotTest/riscv_wrapper.cc new file mode 100644 index 0000000..de4fc75 --- /dev/null +++ b/cosim/bareMetalTests/srotTest/riscv_wrapper.cc @@ -0,0 +1,65 @@ +//************************************************************************ +// Copyright (C) 2020 Massachusetts Institute of Technology +// SPDX short identifier: MIT +// +// File Name: +// Program: Common Evaluation Platform (CEP) +// Description: +// Notes: +// +//************************************************************************ +// +// For bareMetal mode ONLY +// +#ifdef BARE_MODE +#include "cep_adrMap.h" +#include "cep_apis.h" + +#include "cepSrotTest.h" +#include "cepregression.h" + + +//#define printf(...) { return 0; } + +#ifdef __cplusplus +extern "C" { +#endif + +//int main(void) +void thread_entry(int cid, int nc) +{ + // + int errCnt = 0; + int testId[4] = {0x00,0x11,0x22,0x33}; + int coreId = read_csr(mhartid); + // + set_printf(0); + + // + // + set_cur_status(CEP_RUNNING_STATUS); + initConfig(); + if (!errCnt) { errCnt = cepSrotTest_runTest(coreId,0,0); } + // + // + // Done + // + set_status(errCnt,testId[coreId]); + /* + if (errCnt) { + set_pass(); + } else { + set_fail(); + } + */ + // + // Stuck here forever... + // + exit(errCnt); +} + +#ifdef __cplusplus +} +#endif + +#endif diff --git a/cosim/bfmTests/Makefile b/cosim/bfmTests/Makefile index e4845f1..8ae2221 100644 --- a/cosim/bfmTests/Makefile +++ b/cosim/bfmTests/Makefile @@ -55,6 +55,8 @@ BFM_TEST_LIST = \ ddr3Test \ memPreload \ regression \ + miscTests \ + SINGLE_OLD_TESTS = \ aes \ diff --git a/cosim/bfmTests/srotTest/Makefile b/cosim/bfmTests/srotTest/Makefile new file mode 100644 index 0000000..04ed935 --- /dev/null +++ b/cosim/bfmTests/srotTest/Makefile @@ -0,0 +1,31 @@ +#//************************************************************************ +#// Copyright (C) 2020 Massachusetts Institute of Technology +#// SPDX short identifier: BSD-2-Clause +#// +#// File Name: +#// Program: Common Evaluation Platform (CEP) +#// Description: +#// Notes: +#// +#//************************************************************************ +# +# +# +COSIM_NAME = $(shell cd ../..; basename `pwd`) +DUT_TOP_DIR = $(shell cd ../../..; pwd | ./${COSIM_NAME}/bin/strip_net.pl ) +BLD_DIR = $(shell cd ..; pwd | ../bin/strip_net.pl ) +TEST_SUITE = $(shell basename ${BLD_DIR}) +TEST_DIR = $(shell cd .; pwd | ../../bin/strip_net.pl ) +TEST_NAME = $(shell basename `pwd`) +SIM_DIR = ${DUT_TOP_DIR}/${COSIM_NAME} + +# +# Top target!!! +# +all: .vrun_flag + +# +# override anything here before calling the common file +# +include ${BLD_DIR}/common.make + diff --git a/cosim/bfmTests/srotTest/c_dispatch.cc b/cosim/bfmTests/srotTest/c_dispatch.cc new file mode 100644 index 0000000..8086bbc --- /dev/null +++ b/cosim/bfmTests/srotTest/c_dispatch.cc @@ -0,0 +1,107 @@ +//************************************************************************ +// Copyright (C) 2020 Massachusetts Institute of Technology +// SPDX short identifier: BSD-2-Clause +// +// File Name: +// Program: Common Evaluation Platform (CEP) +// Description: +// Notes: +// +//************************************************************************ +#include +#include "v2c_cmds.h" +#include "access.h" +#include "c_dispatch.h" +#include "c_module.h" +#include "cep_adrMap.h" +#include "cep_apis.h" +#include "simPio.h" +/* + * main + */ +int main(int argc, char *argv[]) +{ + + /* ===================================== */ + /* SETUP SECTION FOR SIMULATION */ + /* ===================================== */ + unsigned long seed; + sscanf(argv[1],"0x%x",&seed); + printf("Seed = 0x%x\n",seed); + int errCnt = 0; + int verbose = 0x1f; + + /* ===================================== */ + /* spawn all the paralle threads */ + /* ===================================== */ + int activeSlot=0; // only 1 board + // + // ============================ + // fork all the tests here + // ============================ + // + shPthread thr; + // + // max number of cores not include the system thread + // + int maxHost = MAX_CORES; // number of cores/threads + // + // each bit is to turn on the given core (bit0 = core0, bit1=core1, etc..) + // + long unsigned int mask = 0x1 << (seed & 0x3); + // + // Set the active CPU mask before spawn the threads... + // + thr.SetActiveMask(mask); + // + // c_module is the threead to run + // + for (int i=0;i +#include "random48.h" + +#include "cep_adrMap.h" +#include "cep_apis.h" +#include "simdiag_global.h" +#include "cepSrotTest.h" +#include "cepregression.h" + +// +void *c_module(void *arg) { + + + // ====================================== + // Set up + // ====================================== + pthread_parm_t *tParm = (pthread_parm_t *)arg; + int errCnt = 0; + int slotId = tParm->slotId; + int cpuId = tParm->cpuId; + int verbose = tParm->verbose; + Int32U seed = tParm->seed; + int restart = tParm->restart; + int offset = GET_OFFSET(slotId,cpuId); + GlobalShMemory.getSlotCpuId(offset,&slotId,&cpuId); + //printf("offset=%x seed=%x verbose=%x GlobalShMemory=%x\n",offset,seed, verbose,(unsigned long) &GlobalShMemory); + // notify I am Alive!!! + shIpc *ptr = GlobalShMemory.getIpcPtr(offset); + ptr->SetAliveStatus(); + sleep(1); + + // ====================================== + // Test is Here + // ====================================== + simPio pio; + pio.MaybeAThread(); // chec + pio.EnableShIpc(1); + pio.SetVerbose(verbose); + + // + // ====================================== + // Test starts here + // ====================================== + // MUST + // wait until Calibration is done.. + //int calibDone = calibrate_ddr3(50); + pio.RunClk(500); + + // + initConfig(); +#if 1 + if (!errCnt) { errCnt = cepSrotTest_runTest(cpuId,seed, verbose); } +#endif + // + // + pio.RunClk(100); + // + // ====================================== + // Exit + // ====================================== +cleanup: + if (errCnt != 0) { + LOGI("======== TEST FAIL ========== %x\n",errCnt); + } else { + LOGI("======== TEST PASS ========== \n"); + } + // shIpc *ptr = GlobalShMemory.getIpcPtr(offset); + ptr->SetError(errCnt); + ptr->SetThreadDone(); + pthread_exit(NULL); + return ((void *)NULL); +} + diff --git a/cosim/bfmTests/srotTest/c_module.h b/cosim/bfmTests/srotTest/c_module.h new file mode 100644 index 0000000..92a0535 --- /dev/null +++ b/cosim/bfmTests/srotTest/c_module.h @@ -0,0 +1,18 @@ +//************************************************************************ +// Copyright (C) 2020 Massachusetts Institute of Technology +// SPDX short identifier: BSD-2-Clause +// +// File Name: +// Program: Common Evaluation Platform (CEP) +// Description: +// Notes: +// +//************************************************************************ +#ifndef c_module_H +#define c_module_H + +#include "shPthread.h" + +void *c_module(void *); /* thread routine */ + +#endif diff --git a/cosim/cep_buildChips.make b/cosim/cep_buildChips.make index 28d09a1..92ee884 100644 --- a/cosim/cep_buildChips.make +++ b/cosim/cep_buildChips.make @@ -150,6 +150,7 @@ endif DUT_COMMON_FILES = ${DUT_TOP_DIR}/hdl_cores/aes/table.v \ ${DUT_TOP_DIR}/hdl_cores/aes/round.v \ ${DUT_TOP_DIR}/hdl_cores/aes/aes_192.v \ + ${DUT_TOP_DIR}/hdl_cores/llki/tlul_err.sv \ $(wildcard ${DUT_TOP_DIR}/generated_dsp_code/*.v) \ ${BHV_DIR}/ddr3.v \ @@ -182,7 +183,8 @@ DUT_XILINX_TOP_TB = ${DVT_DIR}/${DUT_XILINX_TOP_MODULE}.v XILINX_MODELSIM_INI = ${SIM_DIR}/xil_lib/modelsim.ini XILINX_LIBRARY_LIST = -L unisims_ver -L unimacro_ver -L unifast_ver -L secureip -L xpm DUT_XILINX_VOPT_ARGS = +acc -64 +nolibcell +nospecify +notimingchecks -modelsimini ${XILINX_MODELSIM_INI} ${WORK_DIR}.glbl ${XILINX_LIBRARY_LIST} -DUT_XILINX_VLOG_ARGS = +acc -sv -64 -incr +define+MODELSIM +define+RANDOMIZE_MEM_INIT +DUT_XILINX_VLOG_ARGS = +acc -sv -64 -incr +define+MODELSIM +define+RANDOMIZE_MEM_INIT+RANDOMIZE_REG_INIT+RANDOM="1'b0" +#DUT_XILINX_VLOG_ARGS = +acc -sv -64 -incr +define+MODELSIM +define+RANDOM="1'b0" DUT_XILINX_VCOM_ARGS = -64 -93 -modelsimini ${XILINX_MODELSIM_INI} DUT_XILINX_VSIM_ARGS = -64 -modelsimini ${XILINX_MODELSIM_INI} ${XILINX_LIBRARY_LIST} -warning 3363 -warning 3053 -warning 8630 @@ -245,6 +247,10 @@ SEARCH_DIR_LIST := ${DVT_DIR} \ ${DUT_TOP_DIR}/hdl_cores/rsa/rtl \ ${DUT_TOP_DIR}/hdl_cores/sha256 \ ${DUT_TOP_DIR}/hdl_cores/dsp \ + ${DUT_TOP_DIR}/hdl_cores/llki \ + $(DUT_TOP_DIR)/opentitan/hw/ip/tlul/rtl \ + $(DUT_TOP_DIR)/opentitan/hw/ip/prim/rtl \ + $(DUT_TOP_DIR)/opentitan/hw/ip/prim_generic/rtl \ ${BHV_DIR} @@ -313,7 +319,7 @@ ${BLD_DIR}/.buildVlog : ${VERILOG_DEFINE_LIST} ${SIM_DIR}/common.make ${SIM_DIR} @for i in ${INCDIR_LIST}; do \ echo "+incdir+"$${i} >> ${BLD_DIR}/searchPaths_build; \ done - ${VLOG_CMD} -work ${WORK_DIR} -f ${BLD_DIR}/searchPaths_build +libext+.v ${BLD_DIR}/config.v ${DUT_VLOG_ARGS} ${DUT_VERILOG_FLIST} ${DUT_XILINX_TOP_TB} + ${VLOG_CMD} -work ${WORK_DIR} -f ${BLD_DIR}/searchPaths_build +libext+.v +libext+.sv ${BLD_DIR}/config.v ${DUT_VLOG_ARGS} ${DUT_VERILOG_FLIST} ${DUT_XILINX_TOP_TB} touch $@ # diff --git a/cosim/drivers/cep_tests/CEP.h b/cosim/drivers/cep_tests/CEP.h index 9eccb91..ddb3857 100644 --- a/cosim/drivers/cep_tests/CEP.h +++ b/cosim/drivers/cep_tests/CEP.h @@ -11,8 +11,8 @@ // CEP Verion String - const uint8_t CEP_MAJOR_VERSION = 0x02; - const uint8_t CEP_MINOR_VERSION = 0x50; + const uint8_t CEP_MAJOR_VERSION = 0x03; + const uint8_t CEP_MINOR_VERSION = 0x00; // General Constants const uint32_t BITS_PER_BYTE = 8; @@ -22,8 +22,6 @@ // Maximum expected name size for the ipCoreData structure #define MAX_CONFIG_STRING_K 32 - // Defines the total number of cores in the CEP - #define CEP_TOTAL_CORES 11 // Indexes used to select the desired core #define AES_BASE_K 0 @@ -37,6 +35,9 @@ #define IIR_BASE_K 8 #define GPS_BASE_K 9 #define CEP_VERSION_REG_K 10 + #define SROT_BASE_K 11 + // Defines the total number of cores in the CEP + #define CEP_TOTAL_CORES 12 // Structure defining the base address and status // of the CEP cores @@ -49,18 +50,18 @@ // Array containing the base addresses and enable status of // all the CEP cores (indexed by the constants above) const cep_core_info_t cep_core_info[CEP_TOTAL_CORES] = { - {"AES", 0x70000000, true}, // AES - {"MD5", 0x70010000, true}, // MD5 + {"AES", 0x70000000, true}, // AES + {"MD5", 0x70010000, true}, // MD5 {"SHA256", 0x70020000, true}, // SHA256 {"RSA", 0x70030000, true}, // RSA - {"DES3", 0x70040000, true}, // DES3 + {"DES3", 0x70040000, true}, // DES3 {"DFT", 0x70050000, true}, // DFT {"IDFT", 0x70060000, true}, // IDFT - {"FIR", 0x70070000, true}, // FIR + {"FIR", 0x70070000, true}, // FIR {"IIR", 0x70080000, true}, // IIR {"GPS", 0x70090000, true}, // GPS - {"CEP Version", 0x700F0000, true} // CEP Version Register - }; + {"CEP Version", 0x700F0000, true}, // CEP Version Register + {"SROT", 0x70100000, true}}; // SRoT // Constants copied from AES.h const uint32_t AES_KEY_BITS = 192; @@ -228,6 +229,23 @@ const uint32_t FIR_OUT_ADDR = FIR_IN_DATA + BYTES_PER_WORD; const uint32_t FIR_OUT_DATA = FIR_OUT_ADDR + BYTES_PER_WORD; const uint32_t FIR_DONE = 0; - const uint32_t FIR_RESET = 40; - const uint32_t FIR_SHIFT = 48; - const uint32_t FIR_SHIFT2= 56; + const uint32_t FIR_RESET = 40; + const uint32_t FIR_SHIFT = 48; + const uint32_t FIR_SHIFT2 = 56; + + // Constants related to the Surrogate Root of Trust + // These constants must be equal to those in llki_pkg.sv + const uint32_t SROT_KEYINDEXRAM_ADDR = 0x00000100; + const uint32_t SROT_KEYINDEXRAM_SIZE = 0x00000020; + const uint32_t SROT_KEYRAM_ADDR = 0x00000120; + const uint32_t SROT_KEYRAM_SIZE = 0x00000040; + + // Reminder, data width is 64-bits + const uint32_t SROT_CTRLSTS_ADDR = 0x00000000; + const uint32_t SROT_CTRLSTS_MODEBIT0_MASK = 0x0000000000000001; // If either mode bit is set, TileLink access to the Key and Key Index RAMs are disabled + // These bits are SET ONLY + const uint32_t SROT_CTRLSTS_MODEBIT1_MASK = 0x0000000000000002; + const uint32_t SROT_CTRLSTS_RESP_WAITING_MASK = 0x0000000000000004; + + const uint32_t SROT_LLKIC2_SENDRECV_ADDR = 0x00000008; + diff --git a/cosim/drivers/cep_tests/cep_aes.cc b/cosim/drivers/cep_tests/cep_aes.cc index dd4a633..d2493db 100644 --- a/cosim/drivers/cep_tests/cep_aes.cc +++ b/cosim/drivers/cep_tests/cep_aes.cc @@ -24,6 +24,7 @@ #include #include "cep_aes.h" +#include "cepSrotTest.h" #include "simdiag_global.h" #include "portable_io.h" #include "CEP.h" @@ -184,9 +185,74 @@ int cep_aes::RunAes192Test(int maxLoop) { uint8_t key0[] = {0x2b,0x7e,0x15,0x16,0x28,0xae,0xd2,0xa6, 0xab,0xf7,0x15,0x88,0x09,0xcf,0x4f,0x3c, 0x2b,0x7e,0x15,0x16,0x28,0xae,0xd2,0xa6}; uint8_t pt0[] = {0x32,0x43,0xf6,0xa8,0x88,0x5a,0x30,0x8d, 0x31,0x31,0x98,0xa2,0xe0,0x37,0x07,0x34}; */ - int outLen=mBlockSize; + int outLen=mBlockSize; + uint8_t response_status; // - for (int i=0;i -#include "cep_adrMap.h" + #include + #include "cep_adrMap.h" -#ifndef PLAYBACK_CMD_H -#define PLAYBACK_CMD_H -#define WRITE__CMD 1 -#define RDnCMP_CMD 2 -#define RDSPIN_CMD 3 + #ifndef PLAYBACK_CMD_H + #define PLAYBACK_CMD_H + #define WRITE__CMD 1 + #define RDnCMP_CMD 2 + #define RDSPIN_CMD 3 -#define WRITE__CMD_SIZE 3 -#define RDnCMP_CMD_SIZE 3 -#define RDSPIN_CMD_SIZE 5 + #define WRITE__CMD_SIZE 3 + #define RDnCMP_CMD_SIZE 3 + #define RDSPIN_CMD_SIZE 5 + #endif -#endif + #ifdef __cplusplus + extern "C" { + #endif -#ifdef __cplusplus -extern "C" { -#endif - /* - * Function Prototypes - */ + // + // Function Prototypes + // void dump_wave(int cycle2start, int cycle2capture, int enable); int calibrate_ddr3(int maxTimeOut); int is_program_loaded(int maxTimeOut); @@ -44,13 +44,13 @@ extern "C" { void set_fail(void); void set_cur_status(int status); int check_PassFail_status(int coreMask,int maxTimeOut); - // + void cep_raw_write(uint64_t pAddress, uint64_t pData); uint64_t cep_raw_read(uint64_t pAddress); int cep_playback(uint64_t *cmdSeq, - uint64_t upperAdr, uint64_t lowerAdr, - int totalCmds, int totalSize, - int verbose); + uint64_t upperAdr, uint64_t lowerAdr, + int totalCmds, int totalSize, + int verbose); // // lock @@ -62,23 +62,21 @@ extern "C" { void Set_C2C_Capture(int enable); int Get_C2C_Capture(void); void writeDvt(int msb, int lsb, int bits); - -// -// syscalls.c has printf -// -#ifdef BARE_MODE -#undef printf -#include "encoding.h" - extern int printf(const char *format, ...); - extern void set_printf(int enable); - extern int get_printf(void); -#endif - -// end of extern -#ifdef __cplusplus -} -#endif + // + // syscalls.c has printf + // + #ifdef BARE_MODE + #undef printf + #include "encoding.h" + extern int printf(const char *format, ...); + extern void set_printf(int enable); + extern int get_printf(void); + #endif + + // end of extern + #ifdef __cplusplus + } + #endif -// =============== -#endif +#endif // CEP_APIS_H diff --git a/cosim/drivers/cep_tests/cep_riscv.cc b/cosim/drivers/cep_tests/cep_riscv.cc index 3b46bcc..4c56ef0 100644 --- a/cosim/drivers/cep_tests/cep_riscv.cc +++ b/cosim/drivers/cep_tests/cep_riscv.cc @@ -1,4 +1,4 @@ -//************************************************************************ +// ************************************************************************ // Copyright (C) 2020 Massachusetts Institute of Technology // SPDX License Identifier: MIT // @@ -7,53 +7,56 @@ // Description: // Notes: // -//************************************************************************ +// ************************************************************************ + // // for self-modifying code!!!!! look for 0x5A!!! // -#if 0 - // ************************* - // This is from native Linux's objdump - // ************************* +/* + +// ************************* +// This is from native Linux's objdump +// ************************* volatile char get_selfModCodeValue(void) { - 74: 55 push %rbp - 75: 48 89 e5 mov %rsp,%rbp -/home/aduong/CEP/CEP-master/software/freedom-u-sdk/buildroot/package/cep_diag/src/cep_riscv.cc:33 - return (volatile char)0x5A; // this value will be modified to test I-cache coherency - 78: b8 5a 00 00 00 mov $0x5a,%eax -/home/aduong/CEP/CEP-master/software/freedom-u-sdk/buildroot/package/cep_diag/src/cep_riscv.cc:34 -} - 7d: 5d pop %rbp - 7e: c3 retq - // ************************* - // This is from RISCV's objdump under Linux - // ************************* - // - // from OBJDUMP - get_selfModCodeValue(): + 74: 55 push %rbp + 75: 48 89 e5 mov %rsp,%rbp + /home/aduong/CEP/CEP-master/software/freedom-u-sdk/buildroot/package/cep_diag/src/cep_riscv.cc:33 + return (volatile char)0x5A; // this value will be modified to test I-cache coherency + 78: b8 5a 00 00 00 mov $0x5a,%eax + /home/aduong/CEP/CEP-master/software/freedom-u-sdk/buildroot/package/cep_diag/src/cep_riscv.cc:34 + } +7d: 5d pop %rbp +7e: c3 retq +// ************************* +// This is from RISCV's objdump under Linux +// ************************* +// +// from OBJDUMP +get_selfModCodeValue(): /home/aduong/CEP/CEP-master/software/freedom-u-sdk/buildroot/package/cep_diag/src/cep_exports.cc:321 - char get_selfModCodeValue(void) { - 14a0: 1141 addi sp,sp,-16 +char get_selfModCodeValue(void) { + 14a0: 1141 addi sp,sp,-16 14a2: e422 sd s0,8(sp) 14a4: 0800 addi s0,sp,16 - - 00000000000014a6 <.L0 >: - /home/aduong/CEP/CEP-master/software/freedom-u-sdk/buildroot/package/cep_diag/src/cep_exports.cc:322 - return (volatile char)0x5A; // this value will be modified to test I-cache coherency - 14a6: 05a00793 li a5,90 + + 00000000000014a6 <.L0 >: + /home/aduong/CEP/CEP-master/software/freedom-u-sdk/buildroot/package/cep_diag/src/cep_exports.cc:322 + return (volatile char)0x5A; // this value will be modified to test I-cache coherency + 14a6: 05a00793 li a5,90 // // ************************* // This is from RISCV's objdump under BARE mode // ************************* // -volatile char get_selfModCodeValue(void) { - return (volatile char)0x5A; // this value will be modified to test I-cache coherency -} - 80001a12: 05a00513 li a0,90 + volatile char get_selfModCodeValue(void) { + return (volatile char)0x5A; // this value will be modified to test I-cache coherency + } + 80001a12: 05a00513 li a0,90 80001a16: 8082 ret #endif +*/ // Only for RISCV #ifdef RISCV_CPU @@ -83,6 +86,159 @@ volatile char get_selfModCodeValue(void) { #endif +// +// Atomic +// return old value before operation +// +uint64_t cep_atomic_op(uint64_t *ptr, uint64_t val,int OP) { + switch (OP) { + case ATOMIC_OP_EXCH : return __atomic_exchange_n(ptr,val,__ATOMIC_SEQ_CST); break; + case ATOMIC_OP_ADD : return __atomic_fetch_add(ptr,val,__ATOMIC_SEQ_CST); break; + case ATOMIC_OP_AND : return __atomic_fetch_and(ptr,val,__ATOMIC_SEQ_CST); break; + case ATOMIC_OP_OR : return __atomic_fetch_or(ptr,val,__ATOMIC_SEQ_CST); break; + case ATOMIC_OP_SUB : return __atomic_fetch_sub(ptr,val,__ATOMIC_SEQ_CST); break; + case ATOMIC_OP_XOR : return __atomic_fetch_xor(ptr,val,__ATOMIC_SEQ_CST); break; + case ATOMIC_OP_LOAD : return __atomic_load_n(ptr,__ATOMIC_SEQ_CST); break; + case ATOMIC_OP_STORE : __atomic_store_n(ptr,val,__ATOMIC_SEQ_CST); return 0; break; + } + return -1; +} +// +// Lock via atomic exchange (load-reserved/store-conditional ONLY on cached region, see Sifive Manual on Atominc Operation) +// +int cep_exchAtomicTest(int coreId, uint64_t *ptr, uint64_t mySig, uint64_t partSig, uint64_t incVal, int loop) { + // + // + // + int errCnt = 0; + int timeOut = 20; + int i=1; + uint64_t myCurSig = mySig; + uint64_t regAdr = reg_base_addr + cep_scratch0_reg + (coreId * 16); + // + while (i <= loop) { + // strong compare + // if (__atomic_compare_exchange_n(ptr,&myCurSig,partSig,0,__ATOMIC_SEQ_CST,__ATOMIC_SEQ_CST)) { // next + if (__atomic_compare_exchange_n(ptr,&myCurSig,partSig,0,__ATOMIC_ACQ_REL,__ATOMIC_ACQ_REL)) { // next + DUT_WRITE32_64(regAdr,mySig); + DUT_WRITE32_64(regAdr+8,partSig); + timeOut = 20; + mySig += incVal; + partSig += incVal; + i++; + // + } else { + DUT_WRITE32_64(regAdr,myCurSig); // what I got when false!!! + DUT_WRITE32_64(regAdr+8,(i << 16) | timeOut); + timeOut--; + if (timeOut <= 0) { + errCnt = i; + return errCnt; + } + } + myCurSig = mySig; // reset since myCurSig got exchange!! + } + return errCnt; +} + +// +// Simple Atomic test (all ops) +// +int cep_runAtomicTest(uint64_t *ptr, uint64_t expVal) { + int errCnt = 0; + uint64_t actVal, oriVal=expVal; + + // + // load the location with expVal + // + __atomic_store_n(ptr,expVal,__ATOMIC_SEQ_CST); + // + // readback and check + // + actVal = __atomic_load_n(ptr,__ATOMIC_SEQ_CST); + if (actVal != expVal) { + errCnt = 1 << 0; + return errCnt; + } + // + // add 1's complement to it to make it all 0xFF...FF + // + actVal = __atomic_fetch_add(ptr,~expVal,__ATOMIC_SEQ_CST); + if (actVal != expVal) { + errCnt = 1 << 1; + return errCnt; + } + expVal = (uint64_t)-1; + // + // Add 1 to get zero + // + actVal = __atomic_fetch_add(ptr,1,__ATOMIC_SEQ_CST); + if (actVal != expVal) { + errCnt = 1 << 1; + return errCnt; + } + expVal = 0; + // + // walk a 1 via OR to make all 0xFF + // + for (int i=0;i<64;i++) { + actVal = __atomic_fetch_or(ptr,((uint64_t)1 << i),__ATOMIC_SEQ_CST); + if (actVal != expVal) { + errCnt = (i << 16) | (1 << 2); + return errCnt; + } + expVal |= ((uint64_t)1 << i); + } + // + // Subract to get 1's complement + // + actVal = __atomic_fetch_sub(ptr,oriVal,__ATOMIC_SEQ_CST); + if (actVal != expVal) { + errCnt = 1 << 3; + return errCnt; + } + expVal = ~oriVal; + // + // XOR to get all 0xFF...FF + // + actVal = __atomic_fetch_xor(ptr,~expVal,__ATOMIC_SEQ_CST); + if (actVal != expVal) { + errCnt = 1 << 4; + return errCnt; + } + expVal = (uint64_t)-1; + // + // walk a 0 via AND to make all 0 + // + for (int i=0;i<64;i++) { + actVal = __atomic_fetch_and(ptr,~((uint64_t)1 << i),__ATOMIC_SEQ_CST); + if (actVal != expVal) { + errCnt = (i << 16) | (1 << 5); + return errCnt; + } + expVal &= ~((uint64_t)1 << i); + } + // + // Exchange + // + actVal = __atomic_exchange_n(ptr,oriVal,__ATOMIC_SEQ_CST); + if (actVal != expVal) { + errCnt = (1 << 6); + return errCnt; + } + expVal = oriVal; + // + // Final load + // + actVal = __atomic_load_n(ptr,__ATOMIC_SEQ_CST); + if (actVal != expVal) { + errCnt = 1 << 7; + return errCnt; + } + // + return errCnt; +} + // // KEEP THIS ONE UNDER 64bytes (cache block) and do not change unless ... // diff --git a/cosim/drivers/cep_tests/cep_riscv.h b/cosim/drivers/cep_tests/cep_riscv.h index 2a15ab0..f6b55d8 100644 --- a/cosim/drivers/cep_tests/cep_riscv.h +++ b/cosim/drivers/cep_tests/cep_riscv.h @@ -14,6 +14,16 @@ #include +#define ATOMIC_OP_EXCH 1 +#define ATOMIC_OP_ADD 2 +#define ATOMIC_OP_AND 3 +#define ATOMIC_OP_OR 4 +#define ATOMIC_OP_SUB 5 +#define ATOMIC_OP_XOR 6 +#define ATOMIC_OP_LOAD 7 +#define ATOMIC_OP_STORE 8 + + #ifdef __cplusplus extern "C" { #endif @@ -23,6 +33,10 @@ extern "C" { volatile char get_selfModCodeValue(void) ; int set_selfModCodeValue(char newByte, int verbose); int do_DIcache_SMC(uint64_t *smc_base, int blockCnt, int startVal, int verbose); + // Atomic stuffs + uint64_t cep_atomic_op(uint64_t *ptr, uint64_t val, int OP) ; + int cep_runAtomicTest(uint64_t *ptr, uint64_t expVal); + int cep_exchAtomicTest(int coreId, uint64_t *ptr, uint64_t mySig, uint64_t partSig, uint64_t incVal, int loop); // end of extern #ifdef __cplusplus diff --git a/cosim/drivers/cep_tests/cepregression.cc b/cosim/drivers/cep_tests/cepregression.cc index 2fe72e2..f025001 100644 --- a/cosim/drivers/cep_tests/cepregression.cc +++ b/cosim/drivers/cep_tests/cepregression.cc @@ -110,6 +110,20 @@ IpCore_st ipCores[CEP_TOTAL_CORES]; // BEGIN: CEP MMAP Utility Functions //************************************************************************ // cep_read - Read from a CEP address +uint32_t cep_read32(int device, uint32_t pAddress) { +#ifdef BARE_MODE + return *(volatile uint32_t*)(ipCores[device].address + pAddress); +#elif SIM_ENV_ONLY + uint32_t d32; + DUT_READ32_32( ipCores[device].address + pAddress, d32); + return d32; +#elif LINUX_MODE + return lnx_cep_read32(ipCores[device].address + pAddress); +#else + return *(uint32_t*)(&(ipCores[device].mem)[pAddress]); +#endif +} +// 64-bits uint64_t cep_read(int device, uint32_t pAddress) { #ifdef BARE_MODE return *(volatile uint64_t*)(ipCores[device].address + pAddress); @@ -122,13 +136,27 @@ uint64_t cep_read(int device, uint32_t pAddress) { #else return *(uint64_t*)(&(ipCores[device].mem)[pAddress]); #endif - } + uint64_t get_physical_adr(int device, uint32_t pAddress) { return (ipCores[device].address + pAddress); } // cep_write - Write to a CEP address +// +void cep_write32(int device, uint32_t pAddress, uint32_t pData) { +#ifdef BARE_MODE + *(volatile uint32_t*)(ipCores[device].address + pAddress) = pData; +#elif SIM_ENV_ONLY + DUT_WRITE32_32( ipCores[device].address + pAddress, pData); +#elif LINUX_MODE + return lnx_cep_write32(ipCores[device].address + pAddress, pData); +#else + memcpy(ipCores[device].mem + pAddress, &pData, sizeof(pData)); +#endif +} + +//64-bit void cep_write(int device, uint32_t pAddress, uint64_t pData) { #ifdef BARE_MODE *(volatile uint64_t*)(ipCores[device].address + pAddress) = pData; @@ -140,6 +168,7 @@ void cep_write(int device, uint32_t pAddress, uint64_t pData) { memcpy(ipCores[device].mem + pAddress, &pData, sizeof(pData)); #endif } + //************************************************************************ // END: CEP MMAP Utility Functions //************************************************************************ diff --git a/cosim/drivers/cep_tests/cepregression.h b/cosim/drivers/cep_tests/cepregression.h index e55f59c..d675d2f 100644 --- a/cosim/drivers/cep_tests/cepregression.h +++ b/cosim/drivers/cep_tests/cepregression.h @@ -46,6 +46,10 @@ extern "C" { int cep_SHA256_test(void); uint64_t get_physical_adr(int device, uint32_t pAddress); + // 32-bits + void cep_write32(int device, uint32_t pAddress, uint32_t pData); + uint32_t cep_read32(int device, uint32_t pAddress); + // 64-bits void cep_write(int device, uint32_t pAddress, uint64_t pData); uint64_t cep_read(int device, uint32_t pAddress); diff --git a/cosim/drivers/diag/cepGpioTest.cc b/cosim/drivers/diag/cepGpioTest.cc new file mode 100644 index 0000000..9b802c7 --- /dev/null +++ b/cosim/drivers/diag/cepGpioTest.cc @@ -0,0 +1,114 @@ +//************************************************************************ +// Copyright (C) 2020 Massachusetts Institute of Technology +// SPDX License Identifier: MIT +// +// File Name: +// Program: Common Evaluation Platform (CEP) +// Description: +// Notes: +// +//************************************************************************ +#include + +#include "simdiag_global.h" +#include "cep_adrMap.h" +#include "cepGpioTest.h" + +#include "cep_apis.h" +#include "portable_io.h" + +#ifdef SIM_ENV_ONLY +#include "simPio.h" +#endif + + +#ifdef BARE_MODE + +#else +#include "simPio.h" +#endif + +extern void regBaseTest_Construct(regBaseTest_t *me, + int target, + int accessSize, + int seed, + int verbose + ); +// +// Overload functions +// +int +cepGpioTest_WriteEntry(regBaseTest_t *me, uint32_t adr, uint64_t dat) +{ + DUT_WRITE32_32(adr,dat); + return 0; +} + +uint64_t cepGpioTest_ReadEntry(regBaseTest_t *me, uint32_t adr) { + uint32_t d32; + DUT_READ32_32(adr,d32); + return (uint64_t)d32; +} + +// +// ============================= +// The test itself +// ============================= +// + +int cepGpioTest_runRegTest(int cpuId, int accessSize,int seed, int verbose) { + + int errCnt = 0; + // + regBaseTest_t *regp; // + // + cepGpioTest_CREATE(regp,cpuId, accessSize, seed + (cpuId*100),verbose); + + // + // start adding register to test + // + // only 4 bits + // + // (*regp->AddAReg_p)(regp, gpio_base_addr + gpio_pin , 0xF); + (*regp->AddAReg_p)(regp, gpio_base_addr + gpio_input_en , 0xF); + (*regp->AddAReg_p)(regp, gpio_base_addr + gpio_output_en , 0xF); + // (*regp->AddAReg_p)(regp, gpio_base_addr + gpio_port_output , 0xF); + (*regp->AddAReg_p)(regp, gpio_base_addr + gpio_pue , 0xF); + (*regp->AddAReg_p)(regp, gpio_base_addr + gpio_ds , 0xF); + (*regp->AddAReg_p)(regp, gpio_base_addr + gpio_rise_ie , 0xF); + // (*regp->AddAReg_p)(regp, gpio_base_addr + gpio_rise_ip , 0xF); + (*regp->AddAReg_p)(regp, gpio_base_addr + gpio_fall_ie , 0xF); + //(*regp->AddAReg_p)(regp, gpio_base_addr + gpio_fall_ip , 0xF); + (*regp->AddAReg_p)(regp, gpio_base_addr + gpio_high_ie , 0xF); + //(*regp->AddAReg_p)(regp, gpio_base_addr + gpio_high_ip , 0xF); + (*regp->AddAReg_p)(regp, gpio_base_addr + gpio_low_ie , 0xF); + //(*regp->AddAReg_p)(regp, gpio_base_addr + gpio_low_ip , 0xF); + // (*regp->AddAReg_p)(regp, gpio_base_addr + gpio_iof_en , 0xF); + //(*regp->AddAReg_p)(regp, gpio_base_addr + gpio_iof_sel , 0xF); + (*regp->AddAReg_p)(regp, gpio_base_addr + gpio_out_xor , 0xF); + // + // now do it + errCnt = (*regp->doRegTest_p)(regp); + // + // Destructors + // + cepGpioTest_DELETE(regp); + // + // + // +#ifdef SIM_ENV_ONLY + for (int i=0;i<4;i++) { + DUT_WRITE_DVT(DVTF_PAT_HI, DVTF_PAT_LO, i); + DUT_WRITE_DVT(DVTF_GET_CORE_STATUS, DVTF_GET_CORE_STATUS, 1); + uint64_t d64 = DUT_READ_DVT(DVTF_PAT_HI, DVTF_PAT_LO); + LOGI("CoreId=%d = 0x%016lx\n",i,d64); + } +#endif + return errCnt; +} + +int cepGpioTest_runTest(int cpuId, int seed, int verbose) { + int errCnt = 0; + if (!errCnt) { errCnt += cepGpioTest_runRegTest(cpuId,32, seed, verbose); } + return errCnt; +} diff --git a/cosim/drivers/diag/cepGpioTest.h b/cosim/drivers/diag/cepGpioTest.h new file mode 100644 index 0000000..12935a4 --- /dev/null +++ b/cosim/drivers/diag/cepGpioTest.h @@ -0,0 +1,40 @@ +//************************************************************************ +// Copyright (C) 2020 Massachusetts Institute of Technology +// SPDX License Identifier: MIT +// +// File Name: +// Program: Common Evaluation Platform (CEP) +// Description: +// Notes: +// +//************************************************************************ + +#ifndef cepGpioTest_H +#define cepGpioTest_H + +#include "regBaseTest.h" + +// +// Constructor/Destructor +// +#define cepGpioTest_CREATE(me,target,accessSize,seed,verbose) \ + {REGBASETEST_CREATE(me,target,accessSize,seed,verbose); \ + me->WriteReg_p = cepGpioTest_WriteEntry; \ + me->ReadReg_p = cepGpioTest_ReadEntry;} + + +#define cepGpioTest_DELETE(me) REGBASETEST_DELETE(me) + + +// +// Overload functions +// +int cepGpioTest_WriteEntry(regBaseTest_t *me, uint32_t adr, uint64_t dat); +uint64_t cepGpioTest_ReadEntry(regBaseTest_t *me, uint32_t adr); +// +// The test itself +// +int cepGpioTest_runTest(int cpuId, int seed, int verbose); +int cepGpioTest_runRegTest(int cpuId, int accessSize,int seed, int verbose); + +#endif diff --git a/cosim/drivers/diag/cepSpiTest.cc b/cosim/drivers/diag/cepSpiTest.cc new file mode 100644 index 0000000..be027be --- /dev/null +++ b/cosim/drivers/diag/cepSpiTest.cc @@ -0,0 +1,109 @@ +//************************************************************************ +// Copyright (C) 2020 Massachusetts Institute of Technology +// SPDX License Identifier: MIT +// +// File Name: +// Program: Common Evaluation Platform (CEP) +// Description: +// Notes: +// +//************************************************************************ +#include + +#include "simdiag_global.h" +#include "cep_adrMap.h" +#include "cepSpiTest.h" + +#include "cep_apis.h" +#include "portable_io.h" + +#ifdef SIM_ENV_ONLY +#include "simPio.h" +#endif + + +#ifdef BARE_MODE + +#else +#include "simPio.h" +#endif + +extern void regBaseTest_Construct(regBaseTest_t *me, + int target, + int accessSize, + int seed, + int verbose + ); +// +// Overload functions +// +int +cepSpiTest_WriteEntry(regBaseTest_t *me, uint32_t adr, uint64_t dat) +{ + DUT_WRITE32_32(adr,dat); + return 0; +} + +uint64_t cepSpiTest_ReadEntry(regBaseTest_t *me, uint32_t adr) { + uint32_t d32; + DUT_READ32_32(adr,d32); + return (uint64_t)d32; +} + +// +// ============================= +// The test itself +// ============================= +// + +int cepSpiTest_runRegTest(int cpuId, int accessSize,int seed, int verbose) { + + int errCnt = 0; + // + regBaseTest_t *regp; // + // + cepSpiTest_CREATE(regp,cpuId, accessSize, seed + (cpuId*100),verbose); + + // + // start adding register to test + // + (*regp->AddAReg_p)(regp, spi_base_addr + spi_sckdiv, 0x00000FFF); + (*regp->AddAReg_p)(regp, spi_base_addr + spi_sckmode, 0x00000003); + (*regp->AddAReg_p)(regp, spi_base_addr + spi_csid, 0x00000001); + (*regp->AddAReg_p)(regp, spi_base_addr + spi_csdef, 0x00000001); + (*regp->AddAReg_p)(regp, spi_base_addr + spi_csmode, 0x00000003); + (*regp->AddAReg_p)(regp, spi_base_addr + spi_dcssck, 0x00FF00FF); + (*regp->AddAReg_p)(regp, spi_base_addr + spi_dintercs, 0x00FF00FF); + (*regp->AddAReg_p)(regp, spi_base_addr + spi_extradel, 0x000000FF); + (*regp->AddAReg_p)(regp, spi_base_addr + spi_sampledel, 0x0000001F); + (*regp->AddAReg_p)(regp, spi_base_addr + spi_fmt, 0x000F000F); + (*regp->AddAReg_p)(regp, spi_base_addr + spi_txmark, 0x00000007); + (*regp->AddAReg_p)(regp, spi_base_addr + spi_rxmark, 0x00000007); + (*regp->AddAReg_p)(regp, spi_base_addr + spi_ie, 0x00000003); + //(*regp->AddAReg_p)(regp, spi_base_addr + spi_insnmode, 0x00000001); + //(*regp->AddAReg_p)(regp, spi_base_addr + spi_insnfmt, 0xFFFF3FFF); + // now do it + errCnt = (*regp->doRegTest_p)(regp); + // + // Destructors + // + cepSpiTest_DELETE(regp); + // + // + // +#ifdef SIM_ENV_ONLY + for (int i=0;i<4;i++) { + DUT_WRITE_DVT(DVTF_PAT_HI, DVTF_PAT_LO, i); + DUT_WRITE_DVT(DVTF_GET_CORE_STATUS, DVTF_GET_CORE_STATUS, 1); + uint64_t d64 = DUT_READ_DVT(DVTF_PAT_HI, DVTF_PAT_LO); + LOGI("CoreId=%d = 0x%016lx\n",i,d64); + } +#endif + return errCnt; +} + +int cepSpiTest_runTest(int cpuId, int seed, int verbose) { + int errCnt = 0; + if (!errCnt) { errCnt += cepSpiTest_runRegTest(cpuId,32, seed, verbose); } + return errCnt; +} diff --git a/cosim/drivers/diag/cepSpiTest.h b/cosim/drivers/diag/cepSpiTest.h new file mode 100644 index 0000000..4b959b9 --- /dev/null +++ b/cosim/drivers/diag/cepSpiTest.h @@ -0,0 +1,40 @@ +//************************************************************************ +// Copyright (C) 2020 Massachusetts Institute of Technology +// SPDX License Identifier: MIT +// +// File Name: +// Program: Common Evaluation Platform (CEP) +// Description: +// Notes: +// +//************************************************************************ + +#ifndef cepSpiTest_H +#define cepSpiTest_H + +#include "regBaseTest.h" + +// +// Constructor/Destructor +// +#define cepSpiTest_CREATE(me,target,accessSize,seed,verbose) \ + {REGBASETEST_CREATE(me,target,accessSize,seed,verbose); \ + me->WriteReg_p = cepSpiTest_WriteEntry; \ + me->ReadReg_p = cepSpiTest_ReadEntry;} + + +#define cepSpiTest_DELETE(me) REGBASETEST_DELETE(me) + + +// +// Overload functions +// +int cepSpiTest_WriteEntry(regBaseTest_t *me, uint32_t adr, uint64_t dat); +uint64_t cepSpiTest_ReadEntry(regBaseTest_t *me, uint32_t adr); +// +// The test itself +// +int cepSpiTest_runTest(int cpuId, int seed, int verbose); +int cepSpiTest_runRegTest(int cpuId, int accessSize,int seed, int verbose); + +#endif diff --git a/cosim/drivers/diag/cepSrotTest.cc b/cosim/drivers/diag/cepSrotTest.cc new file mode 100644 index 0000000..716225c --- /dev/null +++ b/cosim/drivers/diag/cepSrotTest.cc @@ -0,0 +1,299 @@ +//************************************************************************ +// Copyright (C) 2020 Massachusetts Institute of Technology +// SPDX License Identifier: MIT +// +// File Name: +// Program: Common Evaluation Platform (CEP) +// Description: +// Notes: +// +//************************************************************************ +#include + +#include "simdiag_global.h" +#include "cep_adrMap.h" +#include "cepSrotTest.h" +#include "CEP.h" +#include "cepregression.h" +#include "random48.h" + +#include "cep_apis.h" +#include "portable_io.h" + +#ifdef SIM_ENV_ONLY +#include "simPio.h" +#endif + + +#ifdef BARE_MODE + +#else +#include "simPio.h" +#endif + +// Helper function for sending a message to the SRoT and waiting for a response +// Response status will be returned +uint8_t send_srot_message(int verbose, uint64_t message) { + // Temporarily hold the response message + uint64_t response_message; + + // Write a word to the LLKI C2 Send FIFO + cep_write(SROT_BASE_K, SROT_LLKIC2_SENDRECV_ADDR, message); + + // Poll the response waiting bit + do {;} while (!(cep_read(SROT_BASE_K, SROT_CTRLSTS_ADDR) & SROT_CTRLSTS_RESP_WAITING_MASK)); + + // Read the response + response_message = cep_read(SROT_BASE_K, SROT_LLKIC2_SENDRECV_ADDR); + + // Return the status + return((uint8_t)llkic2_extract_status(response_message)); +} // end send_srot_message + + +// Helper function for parsing LLKIC2 message statu +int parse_message_status(uint8_t message_status, int verbose) { + + // Parse the status field to see if any error occured + switch (message_status) { + case LLKI_STATUS_GOOD : + if (verbose) { + LOGI("\n"); + LOGI("cepSrotTest_runTest: Good message received!\n"); + LOGI("\n"); + } + break; + case LLKI_STATUS_KEY_PRESENT : + LOGI("\n"); + LOGI("cepSrotTest_runTest: LLKI-KL Key Present\n"); + LOGI("\n"); + return 0; + break; + case LLKI_STATUS_KEY_NOT_PRESENT : + LOGI("\n"); + LOGI("cepSrotTest_runTest: LLKI-KL Key Not Present\n"); + LOGI("\n"); + return 0; + break; + case LLKI_STATUS_BAD_MSG_ID : + LOGE("\n"); + LOGE("cepSrotTest_runTest: Bad message ID\n"); + LOGE("\n"); + return 1; + break; + case LLKI_STATUS_BAD_MSG_LEN : + LOGE("\n"); + LOGE("cepSrotTest_runTest: Bad message length\n"); + LOGE("\n"); + return 1; + break; + case LLKI_STATUS_KEY_INDEX_EXCEED : + LOGE("\n"); + LOGE("cepSrotTest_runTest: Key Index exceeds allowable bounds\n"); + LOGE("\n"); + return 1; + break; + case LLKI_STATUS_KEY_INDEX_INVALID : + LOGE("\n"); + LOGE("cepSrotTest_runTest: Referenced Key Index is not valid\n"); + LOGE("\n"); + return 1; + break; + case LLKI_STATUS_BAD_POINTER_PAIR : + LOGE("\n"); + LOGE("cepSrotTest_runTest: Referenced Key Index pointer pair is not valid\n"); + LOGE("\n"); + return 1; + break; + case LLKI_STATUS_BAD_CORE_INDEX : + LOGE("\n"); + LOGE("cepSrotTest_runTest: Referenced Key Index specifies an out of bounds core index\n"); + LOGE("\n"); + return 1; + break; + case LLKI_STATUS_KL_REQ_BAD_MSG_ID : + LOGE("\n"); + LOGE("cepSrotTest_runTest: LLKI-KL Request Bad Message ID\n"); + LOGE("\n"); + return 1; + break; + case LLKI_STATUS_KL_REQ_BAD_MSG_LEN : + LOGE("\n"); + LOGE("cepSrotTest_runTest: LLKI-KL Request Bad Message Length\n"); + LOGE("\n"); + return 1; + break; + case LLKI_STATUS_KL_RESP_BAD_MSG_ID : + LOGE("\n"); + LOGE("cepSrotTest_runTest: LLKI-KL Response Bad Message ID\n"); + LOGE("\n"); + return 1; + break; + case LLKI_STATUS_KL_TILELINK_ERROR : + LOGE("\n"); + LOGE("cepSrotTest_runTest: LLKI-KL Tilelink Error\n"); + LOGE("\n"); + return 1; + break; + case LLKI_STATUS_UNKNOWN_ERROR : + LOGE("\n"); + LOGE("cepSrotTest_runTest: Unknown Error\n"); + LOGE("\n"); + return 1; + break; + default : + LOGE("\n"); + LOGE("cepSrotTest_runTest: Unknown message error\n"); + LOGE("\n"); + return 1; + break; + } // end switch (my_message) + +} // end parse_message_status + +int cepSrotTest_runTest(int cpuId, int seed, int verbose) { + + uint64_t response_message; + uint8_t response_status; + + // Initialize the SRoT Key Index RAM + LOGI("\n"); + LOGI("----------------------------------------------------------------------------\n"); + LOGI("cepSrotTest_runTest: Initializing the Key Index RAM... \n"); + LOGI("----------------------------------------------------------------------------\n"); + LOGI("\n"); + for (int i = 0; i < SROT_KEYINDEXRAM_SIZE; i++) { + cep_write(SROT_BASE_K, SROT_KEYINDEXRAM_ADDR + (i*8), 0x0000000000000000); + } + + LOGI("\n"); + LOGI("----------------------------------------------------------------------------\n"); + LOGI("cepSrotTest_runTest: Loading a key into the Key RAM... \n"); + LOGI("----------------------------------------------------------------------------\n"); + LOGI("\n"); + cep_write(SROT_BASE_K, SROT_KEYRAM_ADDR + 0, AES_MOCK_TSS_KEY_0); + cep_write(SROT_BASE_K, SROT_KEYRAM_ADDR + 8, AES_MOCK_TSS_KEY_1); + + LOGI("\n"); + LOGI("----------------------------------------------------------------------------\n"); + LOGI("cepSrotTest_runTest: Loading a valid key index... \n"); + LOGI("----------------------------------------------------------------------------\n"); + LOGI("\n"); + cep_write(SROT_BASE_K, SROT_KEYINDEXRAM_ADDR + 0, key_index_pack( 0x0000, // low pointer + 0x0001, // high pointer + LLKI_AES_CORE_INDEX, // core index + 0x1)); // Valid + + LOGI("\n"); + LOGI("----------------------------------------------------------------------------\n"); + LOGI("cepSrotTest_runTest: Switching the LLKI from DEBUG to OPERATIONAL mode... \n"); + LOGI("----------------------------------------------------------------------------\n"); + LOGI("\n"); + cep_write(SROT_BASE_K, SROT_CTRLSTS_ADDR, SROT_CTRLSTS_MODEBIT0_MASK | SROT_CTRLSTS_MODEBIT1_MASK); + + // Set the desired message values + LOGI("\n"); + LOGI("----------------------------------------------------------------------------\n"); + LOGI("cepSrotTest_runTest: Issuing a Load Key Request to the SRoT and waiting \n"); + LOGI("cepSrotTest_runTest: for the response... \n"); + LOGI("----------------------------------------------------------------------------\n"); + LOGI("\n"); + response_status = send_srot_message(verbose, llkic2_pack( LLKI_MID_C2LOADKEYREQ, // Message ID + 0x00, // Status (unused) + 0x01, // Message Length + 0x00, // Key Index + 0xDEADBEEF)); // Reserved Field + + // Parse the message status + if (parse_message_status(response_status, verbose)) { + return 1; + } + + // Set the desired message values + LOGI("\n"); + LOGI("----------------------------------------------------------------------------\n"); + LOGI("cepSrotTest_runTest: Issuing a Key Status Request to the SRoT and waiting \n"); + LOGI("cepSrotTest_runTest: for the response... \n"); + LOGI("----------------------------------------------------------------------------\n"); + LOGI("\n"); + // Write a word to the LLKI C2 Send FIFO + response_status = send_srot_message(verbose, llkic2_pack( LLKI_MID_C2KEYSTATUSREQ, // Message ID + 0x00, // Status (unused) + 0x01, // Message Length + 0x00, // Key Index + 0xDEADBEEF)); // Reserved Field + switch (response_status) { + case LLKI_STATUS_KEY_PRESENT : + LOGI("\n"); + LOGI("----------------------------------------------------------------------------\n"); + LOGI("cepSrotTest_runTest: Key is present (as expected) \n"); + LOGI("----------------------------------------------------------------------------\n"); + LOGI("\n"); + break; + case LLKI_STATUS_KEY_NOT_PRESENT : + LOGE("\n"); + LOGE("----------------------------------------------------------------------------\n"); + LOGE("cepSrotTest_runTest: Key is NOT present (not expected) \n"); + LOGE("----------------------------------------------------------------------------\n"); + LOGE("\n"); + return 1; + default: + parse_message_status(response_status, verbose); + return 1; + } + + // Set the desired message values + LOGI("\n"); + LOGI("----------------------------------------------------------------------------\n"); + LOGI("cepSrotTest_runTest: Issuing a Clear Key Request to the SRoT and waiting \n"); + LOGI("cepSrotTest_runTest: for the response... \n"); + LOGI("----------------------------------------------------------------------------\n"); + LOGI("\n"); + response_status = send_srot_message(verbose, llkic2_pack( LLKI_MID_C2CLEARKEYREQ, // Message ID + 0x00, // Status (unused) + 0x01, // Message Length + 0x00, // Key Index + 0xDEADBEEF)); // Reserved Field + if (parse_message_status(response_status, verbose)) { + return 1; + } + + + // Set the desired message values + LOGI("\n"); + LOGI("----------------------------------------------------------------------------\n"); + LOGI("cepSrotTest_runTest: Issuing a Key Status Request to the SRoT and waiting \n"); + LOGI("cepSrotTest_runTest: for the response... \n"); + LOGI("----------------------------------------------------------------------------\n"); + LOGI("\n"); + response_status = send_srot_message(verbose, llkic2_pack( LLKI_MID_C2KEYSTATUSREQ, // Message ID + 0x00, // Status (unused) + 0x01, // Message Length + 0x00, // Key Index + 0xDEADBEEF)); // Reserved Field + + switch (response_status) { + case LLKI_STATUS_KEY_NOT_PRESENT : + LOGI("\n"); + LOGI("----------------------------------------------------------------------------\n"); + LOGI("cepSrotTest_runTest: Key is NOT present (as expected) \n"); + LOGI("----------------------------------------------------------------------------\n"); + LOGI("\n"); + break; + case LLKI_STATUS_KEY_PRESENT : + LOGE("\n"); + LOGE("----------------------------------------------------------------------------\n"); + LOGE("cepSrotTest_runTest: Key is present (not expected) \n"); + LOGE("----------------------------------------------------------------------------\n"); + LOGE("\n"); + return 1; + default: + parse_message_status(response_status, verbose); + return 1; + } + + + // Complete the test (successfully) + return 0; + +} diff --git a/cosim/drivers/diag/cepSrotTest.h b/cosim/drivers/diag/cepSrotTest.h new file mode 100644 index 0000000..3cf7633 --- /dev/null +++ b/cosim/drivers/diag/cepSrotTest.h @@ -0,0 +1,93 @@ +//************************************************************************ +// Copyright (C) 2020 Massachusetts Institute of Technology +// SPDX License Identifier: MIT +// +// File Name: +// Program: Common Evaluation Platform (CEP) +// Description: +// Notes: +// +//************************************************************************ + +#ifndef cepSrotTest_H +#define cepSrotTest_H + +#include +#include +#include + + // ---------------------------------------------------------------------------- + // LLKI related constants, structures, and function prototypes + // ---------------------------------------------------------------------------- + + // LLKI Message ID constants + const uint8_t LLKI_MID_C2LOADKEYREQ = 0x00; + const uint8_t LLKI_MID_C2CLEARKEYREQ = 0x01; + const uint8_t LLKI_MID_C2KEYSTATUSREQ = 0x02; + const uint8_t LLKI_MID_C2LOADKEYACK = 0x03; + const uint8_t LLKI_MID_C2CLEARKEYACK = 0x04; + const uint8_t LLKI_MID_C2KEYSTATUSRESP = 0x05; + const uint8_t LLKI_MID_C2ERRORRESP = 0x06; + + // LLKI Status Constants + const uint8_t LLKI_STATUS_GOOD = 0x00; + const uint8_t LLKI_STATUS_KEY_PRESENT = 0x01; + const uint8_t LLKI_STATUS_KEY_NOT_PRESENT = 0x02; + + const uint8_t LLKI_STATUS_BAD_MSG_ID = 0x20; + const uint8_t LLKI_STATUS_BAD_MSG_LEN = 0x21; + const uint8_t LLKI_STATUS_KEY_INDEX_EXCEED = 0x22; // Specified key index exceeds size + // of key index ram + const uint8_t LLKI_STATUS_KEY_INDEX_INVALID = 0x23; + const uint8_t LLKI_STATUS_BAD_POINTER_PAIR = 0x24; + const uint8_t LLKI_STATUS_BAD_CORE_INDEX = 0x25; + const uint8_t LLKI_STATUS_KL_REQ_BAD_MSG_ID = 0x26; + const uint8_t LLKI_STATUS_KL_REQ_BAD_MSG_LEN = 0x27; + const uint8_t LLKI_STATUS_KL_RESP_BAD_MSG_ID = 0x28; + const uint8_t LLKI_STATUS_KL_TILELINK_ERROR = 0x29; + const uint8_t LLKI_STATUS_KL_LOSS_OF_SYNC = 0x30; + + const uint8_t LLKI_STATUS_UNKNOWN_ERROR = 0xFF; + + // LLKI Core Index Constants + const uint8_t LLKI_AES_CORE_INDEX = 0x00; + const uint8_t LLKI_INVALID_CORE_INDEX = 0xFF; + + const uint8_t LLKI_KEYINDEX_VALID = 0x80; + + // Packing macro for creating an LLKIC2 message to send to the SRoT + #define llkic2_pack(msg_id, status, msg_len, key_index, rsvd1) { \ + (((uint64_t)msg_id << 0) & 0x00000000000000FF) | \ + (((uint64_t)status << 8) & 0x000000000000FF00) | \ + (((uint64_t)msg_len << 16) & 0x0000000000FF0000) | \ + (((uint64_t)key_index << 24) & 0x00000000FF000000) | \ + (((uint64_t)rsvd1 << 32) & 0xFFFFFFFF00000000) \ + } + + // Packing macro for creating a Key Index entry + #define key_index_pack(low_pointer, high_pointer, core_index, valid) { \ + (((uint64_t)low_pointer << 0) & 0x000000000000FFFF) | \ + (((uint64_t)high_pointer << 16) & 0x00000000FFFF0000) | \ + (((uint64_t)core_index << 32) & 0x000000FF00000000) | \ + (((uint64_t)valid << 63) & 0x8000000000000000) \ + } + + // Helper macros for response message processing + #define llkic2_extract_status(message) { \ + (uint8_t)(((uint64_t)message >> 8) & 0x00000000000000FF) \ + } + + // LLKI helper functions + uint8_t send_srot_message(int verbose, uint64_t message); + int parse_message_status(uint8_t message_status, int verbose); + + // Mock TSS Keys + const uint64_t AES_MOCK_TSS_KEY_0 = 0x0123456789ABCDEF; + const uint64_t AES_MOCK_TSS_KEY_1 = 0xFEDCBA9876543210; + + // + // The test itself + // + int cepSrotTest_runTest(int cpuId, int seed, int verbose); + +#endif diff --git a/cosim/drivers/diag/cepUartTest.cc b/cosim/drivers/diag/cepUartTest.cc new file mode 100644 index 0000000..b91d7c3 --- /dev/null +++ b/cosim/drivers/diag/cepUartTest.cc @@ -0,0 +1,164 @@ +//************************************************************************ +// Copyright (C) 2020 Massachusetts Institute of Technology +// SPDX License Identifier: MIT +// +// File Name: +// Program: Common Evaluation Platform (CEP) +// Description: +// Notes: +// +//************************************************************************ +#include + +#include "simdiag_global.h" +#include "cep_adrMap.h" +#include "cepUartTest.h" + +#include "cep_apis.h" +#include "portable_io.h" + +#ifdef SIM_ENV_ONLY +#include "simPio.h" +#endif + + +#ifdef BARE_MODE + +#else +#include "simPio.h" +#endif + +extern void regBaseTest_Construct(regBaseTest_t *me, + int target, + int accessSize, + int seed, + int verbose + ); +// +// Overload functions +// +int +cepUartTest_WriteEntry(regBaseTest_t *me, uint32_t adr, uint64_t dat) +{ + DUT_WRITE32_32(adr,dat); + return 0; +} + +uint64_t cepUartTest_ReadEntry(regBaseTest_t *me, uint32_t adr) { + uint32_t d32; + DUT_READ32_32(adr,d32); + return (uint64_t)d32; +} + +// +// ============================= +// The test itself +// ============================= +// +int cepUartTest_runTxRxTest(int cpuId, int divisor, char *txStr, int txLen, int stopBits, int verbose) { + int errCnt = 0; + // + // write divisor register + // + if (verbose) { + LOGI("%s: div=%d str=%s len=%d stop=%d\n",__FUNCTION__,divisor,txStr,txLen,stopBits); + } + DUT_WRITE32_32(uart_base_addr + uart_div, divisor); + int act; + DUT_READ32_32(uart_base_addr + uart_div, act); + if (act != divisor) { + LOGE("%s: mismatch divisor act=0x%x exp=0x%x\n",__FUNCTION__,act,divisor); + errCnt++; + return errCnt; + } else if (verbose) { + LOGI("%s: OK divisor act=0x%x exp=0x%x\n",__FUNCTION__,act,divisor); + } + // enable tx/rx + int dat = ((1 << 0) | // txen + ((stopBits & 0x1) << 1) ); // 0=1 stop bit, 1=2 stop bits + // + DUT_WRITE32_32(uart_base_addr + uart_txctrl,dat); + DUT_WRITE32_32(uart_base_addr + uart_rxctrl,dat); + // + int ti=0, ri=0, tmp; + char rxDat; + while ((ri < txLen) && (!errCnt)) { + // TX? + if (ti < txLen) { // still more to TX?? (include NULL) + DUT_READ32_32(uart_base_addr + uart_txfifo, tmp); + if (((tmp >> 31) & 0x1) == 0) { // not full + DUT_WRITE32_32(uart_base_addr + uart_txfifo, (uint32_t)txStr[ti]); + ti++; + } + } + // any RX? + if (ri < txLen) { + DUT_READ32_32(uart_base_addr + uart_rxfifo, tmp); + if (((tmp >> 31) & 0x1) == 0) { // something in there + rxDat = (char)(tmp & 0xff); + // check + if (rxDat != txStr[ri]) { + LOGE("%s: mismatch char ri=%d act=0x%x exp=0x%x\n",__FUNCTION__,rxDat,txStr[ri]); + errCnt++; + break; + } else if (verbose) { + LOGI("%s: OK char ri=%d act=0x%x exp=0x%x\n",__FUNCTION__,ri,rxDat,txStr[ri]); + ri++; + } + } + } else { + break; + } + } + // disable + DUT_WRITE32_32(uart_base_addr + uart_txctrl,0); + DUT_WRITE32_32(uart_base_addr + uart_rxctrl,0); + return errCnt; +} + +int cepUartTest_runRegTest(int cpuId, int accessSize,int seed, int verbose) { + + int errCnt = 0; + // + regBaseTest_t *regp; // + // + cepUartTest_CREATE(regp,cpuId, accessSize, seed + (cpuId*100),verbose); + + // + // start adding register to test + // + (*regp->AddAReg_p)(regp, uart_base_addr + uart_txctrl, (0x7 << 16) | 0x3); + (*regp->AddAReg_p)(regp, uart_base_addr + uart_rxctrl, (0x7 << 16) | 0x1); + (*regp->AddAReg_p)(regp, uart_base_addr + uart_ie, 0x3); + // (*regp->AddAReg_p)(regp, uart_base_addr + uart_ie, 0xFFFFFFFF); + (*regp->AddAReg_p)(regp, uart_base_addr + uart_div, 0xFFFF); + + // now do it + errCnt = (*regp->doRegTest_p)(regp); + // + // Destructors + // + cepUartTest_DELETE(regp); + // + // + // +#ifdef SIM_ENV_ONLY + for (int i=0;i<4;i++) { + DUT_WRITE_DVT(DVTF_PAT_HI, DVTF_PAT_LO, i); + DUT_WRITE_DVT(DVTF_GET_CORE_STATUS, DVTF_GET_CORE_STATUS, 1); + uint64_t d64 = DUT_READ_DVT(DVTF_PAT_HI, DVTF_PAT_LO); + LOGI("CoreId=%d = 0x%016lx\n",i,d64); + } +#endif + return errCnt; +} + +int cepUartTest_runTest(int cpuId, int seed, int verbose) { + int errCnt = 0; + char txStr[] = "Hello"; + char txStr2[] = "MIT LL"; + if (!errCnt) { errCnt += cepUartTest_runTxRxTest(cpuId,16, txStr, strlen(txStr), 0, 1); } + if (!errCnt) { errCnt += cepUartTest_runTxRxTest(cpuId,24, txStr2, strlen(txStr2),1, 1); } + if (!errCnt) { errCnt += cepUartTest_runRegTest(cpuId,32, seed, verbose); } + return errCnt; +} diff --git a/cosim/drivers/diag/cepUartTest.h b/cosim/drivers/diag/cepUartTest.h new file mode 100644 index 0000000..6694243 --- /dev/null +++ b/cosim/drivers/diag/cepUartTest.h @@ -0,0 +1,42 @@ +//************************************************************************ +// Copyright (C) 2020 Massachusetts Institute of Technology +// SPDX License Identifier: MIT +// +// File Name: +// Program: Common Evaluation Platform (CEP) +// Description: +// Notes: +// +//************************************************************************ + +#ifndef cepUartTest_H +#define cepUartTest_H + +#include "regBaseTest.h" + +// +// Constructor/Destructor +// +#define cepUartTest_CREATE(me,target,accessSize,seed,verbose) \ + {REGBASETEST_CREATE(me,target,accessSize,seed,verbose); \ + me->WriteReg_p = cepUartTest_WriteEntry; \ + me->ReadReg_p = cepUartTest_ReadEntry;} + + +#define cepUartTest_DELETE(me) REGBASETEST_DELETE(me) + + +// +// Overload functions +// +int cepUartTest_WriteEntry(regBaseTest_t *me, uint32_t adr, uint64_t dat); +uint64_t cepUartTest_ReadEntry(regBaseTest_t *me, uint32_t adr); +// +// The test itself +// +int cepUartTest_runTest(int cpuId, int seed, int verbose); + +int cepUartTest_runRegTest(int cpuId, int accessSize,int seed, int verbose); +int cepUartTest_runTxRxTest(int cpuId, int divisor, char *txStr, int txLen, int stopBits, int verbose); + +#endif diff --git a/cosim/drivers/diag/random48.cc b/cosim/drivers/diag/random48.cc index 6b86576..6428df7 100644 --- a/cosim/drivers/diag/random48.cc +++ b/cosim/drivers/diag/random48.cc @@ -3,32 +3,32 @@ // #include "random48.h" -static volatile u_long Random48_customDiagRandomNumber= 0; +static volatile uint64_t Random48_customDiagRandomNumber= 0; -void Random48_srand48 (u_long seed) { +void Random48_srand48 (uint64_t seed) { Random48_customDiagRandomNumber = seed; } -u_long Random48_mrand48 (void) { - u_long a = 48271; // multiplier (see Fishman & Moore) - u_long m = 2147483647; // modulus = 2^31-1 - u_long q = 44488; // quotient = m div a - u_long r = 3399; // remainder = m mod a - u_long divQ = Random48_customDiagRandomNumber/q; - u_long modQ = Random48_customDiagRandomNumber%q; - u_long newValue = a*modQ - r*divQ; - return Random48_customDiagRandomNumber = (newValue > 0)? (u_long)newValue: ((u_long)newValue + m); +uint64_t Random48_mrand48 (void) { + uint64_t a = 48271; // multiplier (see Fishman & Moore) + uint64_t m = 2147483647; // modulus = 2^31-1 + uint64_t q = 44488; // quotient = m div a + uint64_t r = 3399; // remainder = m mod a + uint64_t divQ = Random48_customDiagRandomNumber/q; + uint64_t modQ = Random48_customDiagRandomNumber%q; + uint64_t newValue = a*modQ - r*divQ; + return Random48_customDiagRandomNumber = (newValue > 0)? (uint64_t)newValue: ((uint64_t)newValue + m); } -u_long Random48_mrand48_custom (u_long *Random48_customDiagRandomNumber) { - u_long a = 48271; // multiplier (see Fishman & Moore) - u_long m = 2147483647; // modulus = 2^31-1 - u_long q = 44488; // quotient = m div a - u_long r = 3399; // remainder = m mod a - u_long divQ = *Random48_customDiagRandomNumber/q; - u_long modQ = *Random48_customDiagRandomNumber%q; - u_long newValue = a*modQ - r*divQ; - return *Random48_customDiagRandomNumber = (newValue > 0)? (u_long)newValue: ((u_long)newValue + m); +uint64_t Random48_mrand48_custom (uint64_t *Random48_customDiagRandomNumber) { + uint64_t a = 48271; // multiplier (see Fishman & Moore) + uint64_t m = 2147483647; // modulus = 2^31-1 + uint64_t q = 44488; // quotient = m div a + uint64_t r = 3399; // remainder = m mod a + uint64_t divQ = *Random48_customDiagRandomNumber/q; + uint64_t modQ = *Random48_customDiagRandomNumber%q; + uint64_t newValue = a*modQ - r*divQ; + return *Random48_customDiagRandomNumber = (newValue > 0)? (uint64_t)newValue: ((uint64_t)newValue + m); } int Random48_rand(void) { diff --git a/cosim/drivers/diag/random48.h b/cosim/drivers/diag/random48.h index c6a490f..8fff45f 100644 --- a/cosim/drivers/diag/random48.h +++ b/cosim/drivers/diag/random48.h @@ -5,16 +5,18 @@ #include #include +#include + //#include #include "simdiag_global.h" // // random generator // -extern void Random48_srand48(u_long seed); -extern u_long Random48_mrand48 (void); +extern void Random48_srand48(uint64_t seed); +extern uint64_t Random48_mrand48 (void); extern int Random48_rand(void); -extern u_long Random48_mrand48_custom (u_long *Random48_customDiagRandomNumber); +extern uint64_t Random48_mrand48_custom (uint64_t *Random48_customDiagRandomNumber); #endif // RANDOM48_H diff --git a/cosim/drivers/linux/cep_diag.cc b/cosim/drivers/linux/cep_diag.cc index b02358f..d838ec3 100644 --- a/cosim/drivers/linux/cep_diag.cc +++ b/cosim/drivers/linux/cep_diag.cc @@ -59,6 +59,7 @@ typedef struct p2vMap { p2vMap_st _cepMap; p2vMap_st _ddr3Map; +p2vMap_st _otherMap; // spi/UART // // offs can be full address as well since it will be masked off @@ -70,6 +71,16 @@ void lnx_cep_write(u_int32_t offs,u_int64_t pData) { memcpy(_cepMap.mem + (offs & _cepMap.mask) , &pData, sizeof(pData)); } +// +// Access to SPI/UART Only +// +u_int32_t lnx_cep_read32(u_int32_t offs) { + return *(u_int32_t*)(&(_otherMap.mem)[offs & _otherMap.mask]); +} +void lnx_cep_write32(u_int32_t offs,u_int32_t pData) { + memcpy(_otherMap.mem + (offs & _otherMap.mask) , &pData, sizeof(pData)); +} + // // DDR3 // @@ -129,6 +140,23 @@ static int do_cep_map() { } } // + // SPI/UART + // + _otherMap.phy_address = other_base_addr; + _otherMap.pagesize = other_base_size; + _otherMap.mask = _otherMap.pagesize -1; + _otherMap.fd = open("/dev/mem",O_RDWR|O_SYNC); + if (_otherMap.fd < 0) { + printf("ERROR: **** Can't open /dev/mem for OTHER @0x%016lx\n", _otherMap.phy_address); + return 1; + } else { + _otherMap.mem = (unsigned char *)mmap(0, _otherMap.pagesize, PROT_READ | PROT_WRITE, MAP_SHARED, _otherMap.fd, _otherMap.phy_address); + if (_otherMap.mem == MAP_FAILED) { + printf("ERROR: **** Can't map memory %zu for OTHER\n", _otherMap.phy_address); + return 1; + } + } + // Print_CepBuildDate(); return 0; } diff --git a/cosim/drivers/linux/cep_diag.h b/cosim/drivers/linux/cep_diag.h index 33ed41d..af155fa 100644 --- a/cosim/drivers/linux/cep_diag.h +++ b/cosim/drivers/linux/cep_diag.h @@ -38,6 +38,8 @@ extern "C" { // u_int64_t lnx_cep_read(u_int32_t offs); void lnx_cep_write(u_int32_t offs,u_int64_t pData); + u_int32_t lnx_cep_read32(u_int32_t offs); + void lnx_cep_write32(u_int32_t offs,u_int32_t pData); // u_int64_t lnx_mem_read(u_int32_t offs); void lnx_mem_write(u_int32_t offs,u_int64_t pData); diff --git a/cosim/dvt/aes_capture.incl b/cosim/dvt/aes_capture.incl index 036af9b..9d2f973 100644 --- a/cosim/dvt/aes_capture.incl +++ b/cosim/dvt/aes_capture.incl @@ -24,10 +24,10 @@ int AES_fd; always @(posedge c2c_capture_enable[`DVTF_AES_CAPTURE_EN_BIT]) begin $display("Enable cycle-by-cycle capturing of AES stimulus"); // wait until it gets out of reset - if (cep_tb.fpga.topDesign.topMod.aes.blackbox.rst) - @(negedge cep_tb.fpga.topDesign.topMod.aes.blackbox.rst); + if (cep_tb.fpga.topDesign.topMod.aesmodule.aes_192_mock_tss_inst.rst) + @(negedge cep_tb.fpga.topDesign.topMod.aesmodule.aes_192_mock_tss_inst.rst); // next clock - @(posedge cep_tb.fpga.topDesign.topMod.aes.blackbox.clk); + @(posedge cep_tb.fpga.topDesign.topMod.aesmodule.aes_192_mock_tss_inst.clk); CaptureAES_vector=1; AES_fd=$fopen("../../drivers/vectors/aes_stimulus.txt","w"); captureAES_Stimulus(); @@ -35,7 +35,7 @@ end always @(negedge c2c_capture_enable[`DVTF_AES_CAPTURE_EN_BIT]) begin if (CaptureAES_vector) begin CaptureAES_vector=0; - repeat (2) @(posedge cep_tb.fpga.topDesign.topMod.aes.blackbox.clk); + repeat (2) @(posedge cep_tb.fpga.topDesign.topMod.aesmodule.aes_192_mock_tss_inst.clk); $display("Stop Capturing AES stimulus"); $fwrite(AES_fd,"};\n"); $fwrite(AES_fd,"`define AES_SAMPLE_COUNT %d\n",AES_sampleNum); @@ -72,7 +72,7 @@ end // // wait until valid in to interleaver while (CaptureAES_vector) begin - @(negedge cep_tb.fpga.topDesign.topMod.aes.blackbox.clk); + @(negedge cep_tb.fpga.topDesign.topMod.aesmodule.aes_192_mock_tss_inst.clk); // MUST align to HEX number if _ is used!!! if (AES_sampleNum>0) begin $fwrite(AES_fd," ,"); @@ -80,11 +80,11 @@ end $fwrite(AES_fd," "); end $fwrite(AES_fd,"'h%x_%x_%x_%x_%x\n", - {3'b0,cep_tb.fpga.topDesign.topMod.aes.blackbox.start}, - cep_tb.fpga.topDesign.topMod.aes.blackbox.key[191:0], - cep_tb.fpga.topDesign.topMod.aes.blackbox.state[127:0], - {3'b0,cep_tb.fpga.topDesign.topMod.aes.blackbox.out_valid}, - cep_tb.fpga.topDesign.topMod.aes.blackbox.out[127:0]); + {3'b0,cep_tb.fpga.topDesign.topMod.aesmodule.aes_192_mock_tss_inst.start}, + cep_tb.fpga.topDesign.topMod.aesmodule.aes_192_mock_tss_inst.key[191:0], + cep_tb.fpga.topDesign.topMod.aesmodule.aes_192_mock_tss_inst.state[127:0], + {3'b0,cep_tb.fpga.topDesign.topMod.aesmodule.aes_192_mock_tss_inst.out_valid}, + cep_tb.fpga.topDesign.topMod.aesmodule.aes_192_mock_tss_inst.out[127:0]); AES_sampleNum++; end // while (1) end diff --git a/cosim/dvt/behav_models/cep_driver.v b/cosim/dvt/behav_models/cep_driver.v index 0b98c45..679a04b 100644 --- a/cosim/dvt/behav_models/cep_driver.v +++ b/cosim/dvt/behav_models/cep_driver.v @@ -295,6 +295,29 @@ begin end endtask // WRITE32_64_TASK +`define SHIPC_WRITE32_32_TASK WRITE32_32_DPI() +task WRITE32_32_DPI; + reg [63:0] d; + reg [7:0] mask; +begin + //`logI("%m a=%x d=%x",a,d); + // + if (inBox.mAdr[2]) mask = 'hF0; + else mask = 'h0F; + // + d[63:32] = inBox.mPar[0]; + d[31:0] = inBox.mPar[0]; +`ifdef BFM_MODE + case (MY_LOCAL_ID) + 0: `CORE0_TL_PATH.tl_a_ul_write_generic(MY_LOCAL_ID & 'h1, inBox.mAdr,d,mask); + 1: `CORE1_TL_PATH.tl_a_ul_write_generic(MY_LOCAL_ID & 'h1, inBox.mAdr,d,mask); + 2: `CORE2_TL_PATH.tl_a_ul_write_generic(MY_LOCAL_ID & 'h1, inBox.mAdr,d,mask); + 3: `CORE3_TL_PATH.tl_a_ul_write_generic(MY_LOCAL_ID & 'h1, inBox.mAdr,d,mask); + endcase // case (MY_LOCAL_ID) +`endif +end +endtask // WRITE32_64_TASK + `else // ================= OLD PLI @@ -317,8 +340,6 @@ begin 3: `CORE3_TL_PATH.tl_x_ul_write(MY_LOCAL_ID & 'h1, a, d); endcase // case (MY_LOCAL_ID) end // else: !if(backdoor_enable) -`else - cep_tb.write_ddr3_backdoor(a,d); `endif end endtask // WRITE32_64_TASK @@ -355,6 +376,27 @@ reg [63:0] d; //`logI("%m a=%x d=%x",a,d); end endtask // READ32_64_TASK + +`define SHIPC_READ32_32_TASK READ32_32_DPI() +task READ32_32_DPI; + reg [63:0] d; + reg [7:0] mask; + begin + if (inBox.mAdr[2]) mask = 'hF0; + else mask = 'h0F; +`ifdef BFM_MODE + case (MY_LOCAL_ID) + 0: `CORE0_TL_PATH.tl_x_ul_read_generic(MY_LOCAL_ID & 'h1, inBox.mAdr, mask, d); + 1: `CORE1_TL_PATH.tl_x_ul_read_generic(MY_LOCAL_ID & 'h1, inBox.mAdr, mask, d); + 2: `CORE2_TL_PATH.tl_x_ul_read_generic(MY_LOCAL_ID & 'h1, inBox.mAdr, mask, d); + 3: `CORE3_TL_PATH.tl_x_ul_read_generic(MY_LOCAL_ID & 'h1, inBox.mAdr, mask, d); + endcase // case (MY_LOCAL_ID) + inBox.mPar[0] = inBox.mAdr[2] ? d[63:32] : d[31:0]; +`endif + //`logI("%m a=%x d=%x",a,d); +end +endtask // READ32_64_TASK + `else // -------------- OLD PLI `define SHIPC_READ32_64_TASK READ32_64_TASK(__shIpc_address[31:0],{__shIpc_p0[31:0],__shIpc_p1[31:0]}) @@ -556,11 +598,12 @@ endtask // READ32_64_TASK force `CORE0_PATH.core.reset =1; end end - assign pcPass = (`CORE0_PC[30:0] === passFail[0][30:0]) || - ((`CORE0_PC[30:0] == passFail[2][30:0]) && (passFail[2][30:0] != 0)) || - ((`CORE0_PC[30:0] == passFail[3][30:0]) && (passFail[3][30:0] != 0) && checkToHost); + assign pcPass = `CORE0_VALID && + ((`CORE0_PC[30:0] === passFail[0][30:0]) || + ((`CORE0_PC[30:0] == passFail[2][30:0]) && (passFail[2][30:0] != 0)) || + ((`CORE0_PC[30:0] == passFail[3][30:0]) && (passFail[3][30:0] != 0) && checkToHost)); - assign pcFail = (`CORE0_PC[30:0] === passFail[1][30:0]); + assign pcFail = `CORE0_VALID && (`CORE0_PC[30:0] === passFail[1][30:0]); end else if (MY_LOCAL_ID == 1) begin always @(posedge pcPass or posedge pcFail) begin @@ -572,10 +615,11 @@ endtask // READ32_64_TASK force `CORE1_PATH.core.reset =1; end end - assign pcPass = (`CORE1_PC[30:0] === passFail[0][30:0]) || - ((`CORE1_PC[30:0] == passFail[2][30:0]) && (passFail[2][30:0] != 0)) || - ((`CORE1_PC[30:0] == passFail[3][30:0]) && (passFail[3][30:0] != 0) && checkToHost); - assign pcFail = (`CORE1_PC[30:0] === passFail[1][30:0]); + assign pcPass = `CORE1_VALID && + ((`CORE1_PC[30:0] === passFail[0][30:0]) || + ((`CORE1_PC[30:0] == passFail[2][30:0]) && (passFail[2][30:0] != 0)) || + ((`CORE1_PC[30:0] == passFail[3][30:0]) && (passFail[3][30:0] != 0) && checkToHost)); + assign pcFail = `CORE1_VALID && (`CORE1_PC[30:0] === passFail[1][30:0]); end else if (MY_LOCAL_ID == 2) begin always @(posedge pcPass or posedge pcFail) begin @@ -587,10 +631,11 @@ endtask // READ32_64_TASK force `CORE2_PATH.core.reset =1; end end - assign pcPass = (`CORE2_PC[30:0] === passFail[0][30:0]) || - ((`CORE2_PC[30:0] == passFail[2][30:0]) && (passFail[2][30:0] != 0)) || - ((`CORE2_PC[30:0] == passFail[3][30:0]) && (passFail[3][30:0] != 0) && checkToHost); - assign pcFail = (`CORE2_PC[30:0] === passFail[1][30:0]); + assign pcPass = `CORE2_VALID && + ((`CORE2_PC[30:0] === passFail[0][30:0]) || + ((`CORE2_PC[30:0] == passFail[2][30:0]) && (passFail[2][30:0] != 0)) || + ((`CORE2_PC[30:0] == passFail[3][30:0]) && (passFail[3][30:0] != 0) && checkToHost)); + assign pcFail = `CORE2_VALID && (`CORE2_PC[30:0] === passFail[1][30:0]); end else if (MY_LOCAL_ID == 3) begin always @(posedge pcPass or posedge pcFail) begin @@ -602,10 +647,11 @@ endtask // READ32_64_TASK force `CORE3_PATH.core.reset =1; end end - assign pcPass = (`CORE3_PC[30:0] === passFail[0][30:0]) || - ((`CORE3_PC[30:0] == passFail[3][30:0]) && (passFail[3][30:0] != 0)) | - ((`CORE3_PC[30:0] == passFail[2][30:0]) && (passFail[2][30:0] != 0) && checkToHost); - assign pcFail = (`CORE3_PC[30:0] === passFail[1][30:0]); + assign pcPass = `CORE3_VALID && + ((`CORE3_PC[30:0] === passFail[0][30:0]) || + ((`CORE3_PC[30:0] == passFail[3][30:0]) && (passFail[3][30:0] != 0)) | + ((`CORE3_PC[30:0] == passFail[2][30:0]) && (passFail[2][30:0] != 0) && checkToHost)); + assign pcFail = `CORE3_VALID && (`CORE3_PC[30:0] === passFail[1][30:0]); end endgenerate `endif // `ifdef RISCV_TESTS diff --git a/cosim/dvt/behav_models/tl_master_beh.v b/cosim/dvt/behav_models/tl_master_beh.v index 7da1a81..5cd7f3f 100644 --- a/cosim/dvt/behav_models/tl_master_beh.v +++ b/cosim/dvt/behav_models/tl_master_beh.v @@ -280,7 +280,7 @@ module tl_master_beh if (!tl_err && ((tl_master_d_bits_opcode != `TL_D_ACCESSACKDATA) || (tl_master_d_bits_param != 0) || - (tl_master_d_bits_size != 3) || +// (tl_master_d_bits_size != 3) || (tl_master_d_bits_source != src_id) || (tl_master_d_bits_denied) || (tl_master_d_bits_corrupt))) begin @@ -296,6 +296,79 @@ module tl_master_beh end endtask + task tl_x_ul_read_generic; + input [SRC_SIZE-1:0] src_id; + input [ADR_WIDTH-1:0] a; + input [BUS_SIZE-1:0] mask; + output [DATA_WIDTH-1:0] d; + // + begin + checkReset(); + if (tl_err) disable tl_a_ul_read; + //`logI("%m : src=%d a=0x%x %t",src_id,a,$time); + // + // use negedge to drive output + @(posedge clock); `TICK_DELAY; + tl_master_a_bits_opcode = `TL_A_GET; + tl_master_a_bits_param = 0; // must + if (mask == ((1<PrintVerbose("access::Write64_64 mSlotId=%d mLocalId=%d address=%016llx dat=%016llx\n", + mSlotId,mLocalId,address,data); + } + ptr->Write32_32(address,data); +#endif +#else + *reinterpret_cast(address) = data; +#endif + +} + + void access::Write32_64(u_int32_t address, u_int64_t data) { #ifdef SIM_ENV_ONLY #ifdef DLL_SIM @@ -134,6 +151,18 @@ unsigned access::GetSimClk() { return dat; } +u_int32_t access::Read32_32(u_int32_t address) { + u_int32_t data=0; +#ifdef SIM_ENV_ONLY + //shIpc *ptr = GlobalShMemory.getIpcPtr(GetSlotId(),GetLocalId()); + data = ptr->Read32_32(address); + if (0) { // GetVerbose()) { + ptr->PrintPostVerbose("access::Read32_32 mSlotId=%d mLocalId=%d address=%08x dat=%016llx\n",mSlotId,mLocalId,address,data); + } +#endif + return data; +} + u_int64_t access::Read32_64(u_int32_t address) { u_int64_t data=0; #ifdef SIM_ENV_ONLY diff --git a/cosim/share/access.h b/cosim/share/access.h index 8919b62..a205b85 100644 --- a/cosim/share/access.h +++ b/cosim/share/access.h @@ -85,12 +85,14 @@ class access { // // Address is Byte Address // + void Write32_32(u_int32_t address, u_int32_t dat); void Write32_64(u_int32_t address, u_int64_t dat); void Write64_64(u_int64_t address, u_int64_t dat); unsigned GetSimClk(); void SimCheckPoint(char *saveFile); + u_int32_t Read32_32(u_int32_t address); u_int64_t Read32_64(u_int32_t address); u_int64_t Read64_64(u_int64_t address); // diff --git a/cosim/share/portable_io.h b/cosim/share/portable_io.h index 829492a..3561698 100644 --- a/cosim/share/portable_io.h +++ b/cosim/share/portable_io.h @@ -53,6 +53,9 @@ #define DUT_WRITE32_64(a,d) sim_Write64_64(a,d) #define DUT_READ32_64(a,d) d=sim_Read64_64(a) +#define DUT_WRITE32_32(a,d) sim_Write32_32(a,d) +#define DUT_READ32_32(a,d) d=sim_Read32_32(a) + #define DDR3_WRITE(a,d) sim_Write64_64(a,d) #define DDR3_READ(a,d) d=sim_Read64_64(a) @@ -60,6 +63,9 @@ #define DUT_WRITE32_64(a,d) sim_Write32_64(a,d) #define DUT_READ32_64(a,d) d=sim_Read32_64(a) +#define DUT_WRITE32_32(a,d) sim_Write32_32(a,d) +#define DUT_READ32_32(a,d) d=sim_Read32_32(a) + #define DDR3_WRITE(a,d) sim_Write32_64(a,d) #define DDR3_READ(a,d) d=sim_Read32_64(a) @@ -93,6 +99,9 @@ #define DUT_WRITE32_64(a,d) lnx_cep_write(a,d) #define DUT_READ32_64(a,d) { d = lnx_cep_read(a); } +#define DUT_WRITE32_32(a,d) lnx_cep_write32(a,(int)d) +#define DUT_READ32_32(a,d) { d = (int)lnx_cep_read32(a); } + #define DDR3_WRITE(a,d) *(volatile uint64_t *)((intptr_t)a)=d #define DDR3_READ(a,d) d=*(volatile uint64_t *)((intptr_t)a) @@ -125,6 +134,9 @@ #define DUT_WRITE32_64(a,d) *reinterpret_cast(a)=d #define DUT_READ32_64(a,d) d=*reinterpret_cast(a) +#define DUT_WRITE32_32(a,d) *reinterpret_cast(a)=d +#define DUT_READ32_32(a,d) d=*reinterpret_cast(a) + #define DDR3_WRITE(a,d) *reinterpret_cast(a)=d #define DDR3_READ(a,d) d=*reinterpret_cast(a) diff --git a/cosim/share/shIpc.cc b/cosim/share/shIpc.cc index 9843876..fed9f09 100644 --- a/cosim/share/shIpc.cc +++ b/cosim/share/shIpc.cc @@ -529,6 +529,14 @@ void shIpc::Write12Bytes2Mailbox(int wordPos, u_int32_t *data) { // 64-bit addeess space // ========================================== // +void shIpc::Write32_32(u_int32_t adr, u_int32_t dat) { + mAdr = adr; + // Set data stuff + mPar[0] = dat; + // set cmd + SendCmdNwait(SHIPC_WRITE32_32); +} + void shIpc::Write64_64(u_int64_t adr, u_int64_t dat) { mAdr = adr; // Set data stuff @@ -555,6 +563,14 @@ void shIpc::Write64_32(u_int64_t adr, u_int32_t dat) { SendCmdNwait(SHIPC_WRITE64_32); } +u_int32_t shIpc::Read32_32(u_int32_t adr) { + mAdr = adr; + // set cmd + SendCmdNwait(SHIPC_READ32_32); + // Set data stuff + return mPar[0]; +} + u_int64_t shIpc::Read64_64(u_int64_t adr) { mAdr = adr; // set cmd diff --git a/cosim/share/shIpc.h b/cosim/share/shIpc.h index 82b5f85..3edc0f9 100644 --- a/cosim/share/shIpc.h +++ b/cosim/share/shIpc.h @@ -196,9 +196,12 @@ class shIpc { // 64-bit addeess space // ========================================== // + void Write32_32(u_int32_t adr, u_int32_t dat) ; void Write64_32(u_int64_t adr, u_int32_t dat) ; void Write64_64(u_int64_t adr, u_int64_t dat) ; - void Write32_64(u_int32_t adr, u_int64_t dat) ; + void Write32_64(u_int32_t adr, u_int64_t dat) ; + + u_int32_t Read32_32(u_int32_t adr) ; u_int32_t Read64_32(u_int64_t adr) ; u_int64_t Read64_64(u_int64_t adr) ; u_int64_t Read32_64(u_int32_t adr) ; diff --git a/cosim/simDiag/simPio.cc b/cosim/simDiag/simPio.cc index 482b7a6..cc24ff4 100644 --- a/cosim/simDiag/simPio.cc +++ b/cosim/simDiag/simPio.cc @@ -28,8 +28,10 @@ u_long curTarget = 0; simPio gCpu; void sim_RunClk(int a) { access axc; axc.RunClk(a); } +u_int32_t sim_Read32_32(u_int32_t adr) { access axc; return axc.Read32_32(adr); } u_int64_t sim_Read32_64(u_int32_t adr) { access axc; return axc.Read32_64(adr); } u_int64_t sim_Read64_64(u_int64_t adr) { access axc; return axc.Read64_64(adr); } +void sim_Write32_32(u_int32_t adr, u_int32_t data) { access axc; axc.Write32_32(adr,data); } void sim_Write32_64(u_int32_t adr, u_int64_t data) { access axc; axc.Write32_64(adr,data); } void sim_Write64_64(u_int64_t adr, u_int64_t data) { access axc; axc.Write64_64(adr,data); } void sim_Framer_RdWr(u_int32_t adr, u_int32_t wrDat, u_int32_t *rdDat) { access axc; axc.Framer_RdWr(adr,wrDat,rdDat); } diff --git a/cosim/simDiag/simPio.h b/cosim/simDiag/simPio.h index 6def91e..f0e894b 100644 --- a/cosim/simDiag/simPio.h +++ b/cosim/simDiag/simPio.h @@ -38,8 +38,10 @@ extern simPio gCpu; extern "C" { void sim_RunClk(int a); u_int64_t sim_Read32_64(u_int32_t adr); + u_int32_t sim_Read32_32(u_int32_t adr); u_int64_t sim_Read64_64(u_int64_t adr); void sim_Write32_64(u_int32_t adr, u_int64_t data); + void sim_Write32_32(u_int32_t adr, u_int32_t data); void sim_Write64_64(u_int64_t adr, u_int64_t data); void sim_WriteDvtFlag(int msb, int lsb, int val) ; u_int64_t sim_ReadDvtFlag(int msb, int lsb) ; diff --git a/CEP_SecEvalTargets.pdf b/doc/CEP_SecEvalTargets.pdf similarity index 100% rename from CEP_SecEvalTargets.pdf rename to doc/CEP_SecEvalTargets.pdf diff --git a/cep_logo.jpg b/doc/cep_logo.jpg similarity index 100% rename from cep_logo.jpg rename to doc/cep_logo.jpg diff --git a/cep_logo.txt b/doc/cep_logo.txt similarity index 100% rename from cep_logo.txt rename to doc/cep_logo.txt diff --git a/doc/cep_v3.0_architecture.jpg b/doc/cep_v3.0_architecture.jpg new file mode 100644 index 0000000000000000000000000000000000000000..d3315b8c0110fe276119bf234bf0ff2ff25896ad GIT binary patch literal 301316 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 K>O1mR?|%VnJJ{<0 literal 0 HcmV?d00001 diff --git a/doc/related_logos.jpg b/doc/related_logos.jpg new file mode 100644 index 0000000000000000000000000000000000000000..aaf4a0e25919aa0c348678536c26bcd7d2be97cd GIT binary patch literal 24003 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 literal 0 HcmV?d00001 diff --git a/doc/version.jpg b/doc/version.jpg new file mode 100644 index 0000000000000000000000000000000000000000..2a05206df58a849ccc665f20f6763fd749ec43d4 GIT binary patch literal 8664 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 $@ +incdirs := $(BUILD_DIR)/$(CONFIG_PROJECT).$(CONFIG).incdirs +$(incdirs): + echo $(INCDIRS) > $@ + bit := $(BUILD_DIR)/obj/$(MODEL).bit -$(bit): $(romgen) $(f) +$(bit): $(romgen) $(f) $(incdirs) cd $(BUILD_DIR); vivado \ -nojournal -mode batch \ -source $(fpga_common_script_dir)/vivado.tcl \ -tclargs \ -top-module "$(MODEL)" \ -F "$(f)" \ + -include_dirs "$(incdirs)" \ -ip-vivado-tcls "$(shell find '$(BUILD_DIR)' -name '*.vivado.tcl')" \ -board "$(BOARD)" diff --git a/hdl_cores/freedom/fpga-shells/.gitignore b/hdl_cores/freedom/fpga-shells/.gitignore new file mode 100644 index 0000000..b83d222 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/.gitignore @@ -0,0 +1 @@ +/target/ diff --git a/hdl_cores/freedom/fpga-shells/README.md b/hdl_cores/freedom/fpga-shells/README.md new file mode 100644 index 0000000..a65bcda --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/README.md @@ -0,0 +1,105 @@ +# fpga-shells + +An FPGA shell is a Chisel module designed to wrap any SiFive core configuration. +The goal of the fpga-shell system is to reduce the number of wrappers to have only +one for each physical device rather than one for every combination of physical device and core configuration. + +Each shell consists of Overlays which use dependency injection to create and connect peripheral device interfaces in an FPGADesign to the toplevel shell module. + +Most devices already have an overlay defined for them in `src/main/scala/shell[/xilinx]`. +If you're using a Xilinx device, you'll probably want to use the xilinx-specific overlay +because it defines a few things that you'd otherwise have to specify yourself. + +Generally, you'll want to create a device shell that extends `Series7Shell` or `UltraScaleShell`. +If you need different functionality (or you're not using a Xilinx device), you can extend `Shell` and implement abstract members. +Some Microsemi devices are supported by fgpa-shells as well (and can be found in `src/main/scala/shell/microsemi`) + +For example: + +```Scala +class DeviceShell()(implicit p: Parameters) extends UltraScaleShell { + // create Overlays + val myperipheral = Overlay(PeripheralOverlayKey) (new PeripheralOverlay(_,_,_)) + // ... + + // assign abstract members + val pllReset = InModuleBody { Wire(Bool()) } + val topDesign = LazyModule(p(DesignKey)(designParameters)) + + // ensure clocks are connected + designParameters(ClockInputOverlayKey).foreach { unused => + val source = unused(ClockInputOverlayParams()) + val sink = ClockSinkNode(Seq(ClockSinkParameters())) + sink := source + } + + // override module implementation to connect reset + override lazy val module = new LazyRawModuleImp(this) { + val reset = IO(Input(Bool())) + pllReset := reset + } +} +``` + +Each peripheral device to be added to the shell must define an `Overlay`, which creates the device and connects it to the toplevel shell. +In addition, in order to access the overlay, the device needs to have a `case class OverlayParams` and a `case object OverlayKey` + +```Scala +case class PeripheralOverlayParams()(implicit val p: Parameters) +case object PeripheralOverlayKey extends Field[Seq[DesignOverlay[PeripheralOverlayParams, PeripheralDesignOutput]]](Nil) +``` + +If the device is parameterizable, then each parameter for the device creation can be passed to the `PeripheralOverlayParams` constructor by adding a field for said parameter. +Typically, devices are connected to a TileLink bus for processor control, so `PeripheralDesignOutput` can usually be substituted with `TLInwardNode`. + +The `Overlay` extends `IOOverlay` which is paramerized by the device's `IO` (in this case `PeripheralDeviceIO` is a subtype of `Data` and is a port specification for the peripheral device) +and `DesignOutput`. + +```Scala +abstract class AbstractPeripheralOverlay(val params: PeripheralOverlayParams) + extends IOOverlay[PeripheralDeviceIO, PeripheralDesignOutput] +{ + // assign abstract member p (used to access overlays with their key) + // e.g. p(PeripheralOverlayKey) will return a Seq[DesignOverlay[PeripheralOverlayParams, PeripheralDesignOutput]] + implicit val p = params.p +} +``` + +Continuing our example with a `DeviceShell` shell, the actual overlay is constructed by extending our abstract `PeripheralOverlay` +```Scala +class ConcretePeripheralOverlay(val shell: DeviceShell, val name: String, params: PeripheralOverlayParams) + extends AbstractPeripheralOverlay(params) +{ + val device = LazyModule(new PeripheralDevice(PeripheralDeviceParams(???))) // if your peripheral device isn't parameterizable, then it'll have an empty constructor + + def ioFactory = new PeripheralDeviceIO // ioFactory defines interface of val io + val designOutput = device.node + + // this is where "code-injection" starts + val ioSource = BundleBridgeSource(() => device.module.io.cloneType) // create a bridge between device (source) and shell (sink) + val ioSink = shell { ioSource.makeSink() } + + InModuleBody { ioSource.bundle <> device.module.io } + + shell { InModuleBody { + val port = ioSink.bundle + + io <> port // io is the bundle of shell-level IO as specified by ioFactory + } } +} +``` + +The actual device implementation (where the device's functionality is defined) will be something like this: +```Scala +case class PeripheralDeviceParams(param1: Param1Type, ???) // only necessary if your device is parameterizable +class PeripheralDevice(c: PeripheralDeviceParams)(implicit p: Parameters) extends LazyModule { + + val node: PeripheralDesignOutput = ??? + + // device implementation + lazy val module = new LazyModuleImp(this) { + val io = ??? + ??? + } +} +``` diff --git a/hdl_cores/freedom/fpga-shells/build.wake b/hdl_cores/freedom/fpga-shells/build.wake new file mode 100644 index 0000000..6149b28 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/build.wake @@ -0,0 +1,14 @@ +def scalacOpts = + "-deprecation", + "-feature", + "-unchecked", + "-language:reflectiveCalls", + "-Xsource:2.11", + Nil + +global def fpgaShellsScalaModule = + def scalaVersion = rocketchipScalaModule.getScalaModuleScalaVersion + makeScalaModule "fpga-shells" here scalaVersion + | setScalaModuleDeps (sifiveBlocksScalaModule, rocketchipScalaModule, Nil) + | setScalaModuleScalacOptions scalacOpts + | addMacrosParadiseCompilerPlugin diff --git a/hdl_cores/freedom/fpga-shells/microsemi/common/tcl/libero.tcl b/hdl_cores/freedom/fpga-shells/microsemi/common/tcl/libero.tcl new file mode 100644 index 0000000..b26894e --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/microsemi/common/tcl/libero.tcl @@ -0,0 +1,253 @@ +#============================================================================== +# Build a Libero project from Chisel generated Verilog and the Libero TCL +# scriplets generated by each IP block FPGA-Shell. +#============================================================================== + +######### Script arguments ######### + +if {$argc != 5} { + puts "!!! ERROR !!!: This script takes 5 arguments from the Chisel build environment: BUILD_DIR MODEL PROJECT CONFIG BOARD" + exit +} + +puts "*****************************************************************" +puts "******************** Building Libero project ********************" +puts "*****************************************************************" + +set chisel_build_dir [lindex $argv 0] +set chisel_model [lindex $argv 1] +set chisel_project [lindex $argv 2] +set chisel_config [lindex $argv 3] +set chisel_board [lindex $argv 4] + +puts "Number of arguments: $argc" +puts "Chisel build directory: $chisel_build_dir" +puts "Chisel model: $chisel_model" +puts "Chisel project: $chisel_project" +puts "Chisel config: $chisel_config" +puts "Chisel board: $chisel_board" + +set Prjname "$chisel_model" +set Proj "./Libero/$Prjname" + +set FPExpressDir "$chisel_build_dir/FlashProExpress" +puts "FlashPro Express folder: $FPExpressDir" +file mkdir $FPExpressDir + +set scriptdir [file dirname [info script]] +set commondir [file dirname $scriptdir] +set boarddir [file join [ file dirname $commondir] $chisel_board] + +########################################### +set CoreJTAGDebugver {2.0.100} +set PF_DDR3ver {2.3.201} +set PF_DDR4ver {2.3.201} +set PF_CCCver {1.0.115} +set PF_INIT_MONITORver {2.0.103} +set PF_CORERESETPFver {2.1.100} +set PF_PCIEver {2.0.100} +set PF_XCVR_REF_CLKver {1.0.103} +set PF_TX_PLLver {2.0.002} + +set use_enhanced_constraint_flow 1 +set tb {testbench} +file delete -force "$Proj" +set rootcomp {Top_SD} +set rootcomp1 Top_SD +set TOP Top_SD + +set SimTime 100us +set NUM_TX_PLL 1 +set quad 1 +set txpll_refclk_mode "ded" +set xcvrrefclk_refclk_mode "diff" + +#########ORIGINAl SETTINGS############# + +#Device Selection +source [file join $boarddir tcl board.tcl] + +#Analysis operating conditions +set TEMPR {EXT} +set VOLTR {EXT} +set IOVOLTR_12 {EXT} +set IOVOLTR_15 {EXT} +set IOVOLTR_18 {EXT} +set IOVOLTR_25 {EXT} +set IOVOLTR_33 {EXT} + +#Design Flow +set HDL {VERILOG} +set Block 0 +set SAPI 0 +set vmflow 1 +set synth 1 +set fanout {10} + +#########ORIGINAl SETTINGS############# + +new_project -ondemand_build_dh 1 -location "$Proj" -name "$Prjname" -project_description {} -block_mode $Block -standalone_peripheral_initialization $SAPI -use_enhanced_constraint_flow $use_enhanced_constraint_flow -hdl $HDL -family $family -die $die -package $package -speed $speed -die_voltage $die_voltage -part_range $part_range -adv_options IO_DEFT_STD:$IOTech -adv_options RESTRICTPROBEPINS:$ResProbe -adv_options RESTRICTSPIPINS:$ResSPI -adv_options TEMPR:$TEMPR -adv_options VCCI_1.2_VOLTR:$IOVOLTR_12 -adv_options VCCI_1.5_VOLTR:$IOVOLTR_15 -adv_options VCCI_1.8_VOLTR:$IOVOLTR_18 -adv_options VCCI_2.5_VOLTR:$IOVOLTR_25 -adv_options VCCI_3.3_VOLTR:$IOVOLTR_33 -adv_options VOLTR:$VOLTR + +# +# Import Chisel generated verilog files into Libero project +# +import_files \ + -convert_EDN_to_HDL 0 \ + -hdl_source "$chisel_build_dir/$chisel_project.$chisel_config.v" \ + -hdl_source "../../rocket-chip/vsrc/AsyncResetReg.v" \ + -hdl_source "../../rocket-chip/vsrc/plusarg_reader.v" + +download_latest_cores +#download_core -vlnv {Actel:DirectCore:COREDES:3.0.106} -vlnv {Actel:DirectCore:COREAHBLTOAXI:2.1.101} -vlnv {Actel:DirectCore:CORE3DES:3.1.104} -vlnv {Actel:DirectCore:COREAHBTOAPB3:3.1.100} -vlnv {Actel:DirectCore:CoreAPB3:4.1.100} -vlnv {Actel:DirectCore:corepwm:4.3.101} -vlnv {Actel:DirectCore:CoreTimer:2.0.103} -vlnv {Actel:DirectCore:CORECORDIC:4.0.102} -vlnv {Actel:DirectCore:CORESPI:5.1.104} -vlnv {Actel:DirectCore:COREAXI4SRAM:2.1.105} -vlnv {Actel:DirectCore:CoreDDRMemCtrlr:0.0.74} -vlnv {Actel:DirectCore:CoreJESD204BTX:3.0.114} -vlnv {Actel:DirectCore:COREUART:5.6.102} -vlnv {Actel:DirectCore:CoreUARTapb:5.6.102} -vlnv {Actel:DirectCore:COREABC:3.7.101} -vlnv {Actel:DirectCore:COREFFT:7.0.104} -vlnv {Actel:DirectCore:CORERSENC:3.5.102} -vlnv {Actel:DirectCore:CORERSDEC:3.6.104} -vlnv {Actel:DirectCore:COREFIFO:2.6.108} -vlnv {Actel:DirectCore:CORE429:3.12.105} -vlnv {Actel:DirectCore:CORE429_APB:3.12.105} -vlnv {Actel:DirectCore:CORETSE:3.1.102} -vlnv {Actel:DirectCore:CORETSE_AHB:3.1.102} -vlnv {Actel:DirectCore:COREFIR_PF:2.0.104} -vlnv {Actel:DirectCore:COREAXI4DMACONTROLLER:2.0.100} -vlnv {Actel:DirectCore:COREBOOTSTRAP:2.0.100} -vlnv {Actel:DirectCore:CoreJESD204BRX:3.0.126} -vlnv {Actel:DirectCore:CORESGMII:3.2.101} -vlnv {Actel:DirectCore:COREAHBL2AHBL_BRIDGE:2.0.108} -vlnv {Actel:DirectCore:CORERISCV_AXI4:2.0.102} -vlnv {Actel:DirectCore:COREJTAGDEBUG:2.0.100} -vlnv {Actel:DirectCore:CoreAXI4Interconnect:2.2.102} -vlnv {Actel:DirectCore:COREMDIO_APB:2.1.100} -vlnv {Actel:DirectCore:CORERMII:3.0.105} -vlnv {Actel:DirectCore:COREDDR_TIP:1.1.124} -vlnv {Actel:DirectCore:COREDDS:3.0.105} -vlnv {Actel:DirectCore:COREI2C:7.2.101} -vlnv {Actel:DirectCore:CoreAHBLite:5.3.101} -vlnv {Actel:DirectCore:CoreGPIO:3.2.102} -vlnv {Actel:DirectCore:COREAXITOAHBL:3.2.104} -vlnv {Actel:DirectCore:COREEDAC:2.10.104} -vlnv {Microsemi:MiV:MIV_RV32IMA_L1_AHB:2.0.100} -vlnv {Microsemi:MiV:MIV_RV32IMAF_L1_AHB:2.0.100} -vlnv {Actel:DirectCore:CorePCS:3.5.106} -vlnv {Actel:DirectCore:COREPCIF:4.1.123} -vlnv {Actel:DirectCore:COREPCIF_AHB:4.1.123} -vlnv {Actel:SystemBuilder:CORESMARTBERT:2.0.106} -vlnv {Actel:DirectCore:CORESYSSERVICES_PF:2.3.116} -vlnv {Actel:DirectCore:CORERESET_PF:2.1.100} -vlnv {Microsemi:SolutionCore:iog_cdr_test_wrapper:1.0.0} -vlnv {Microsemi:SolutionCore:alpha_blend_control:2.0.0} -vlnv {Microsemi:SolutionCore:BayerConversionTop:2.0.0} -vlnv {Microsemi:SolutionCore:ImageEdgeDetection:2.0.0} -vlnv {Microsemi:SolutionCore:ImageSharpenFilter:2.0.0} -vlnv {Microsemi:SolutionCore:RGB2YCbCr:2.0.0} -vlnv {Microsemi:SolutionCore:Scaler:2.0.0} -vlnv {Microsemi:SolutionCore:ddr_memory_arbiter:2.0.0} -vlnv {Microsemi:SolutionCore:YCbCr2RGB:2.0.0} -vlnv {Microsemi:SolutionCore:display_controller:2.0.0} -vlnv {Microsemi:SolutionCore:DisplayEnhancements:2.0.0} -vlnv {Microsemi:SolutionCore:pattern_generator:2.0.0} -vlnv {Actel:DirectCore:CORE10GMAC:2.1.126} -vlnv {Actel:DirectCore:CORECIC:2.1.103} -vlnv {Microsemi:SolutionCore:CPRI:2.0.0} -vlnv {Microsemi:SolutionCore:LiteFast:1.0.3} -vlnv {Microsemi:MiV:MIV_RV32IMA_L1_AXI:2.0.100} -vlnv {Actel:DirectCore:COREAXI4INTERCONNECT:2.5.100} -vlnv {Actel:DirectCore:COREXAUI:2.0.133} -vlnv {Microsemi:SolutionCore:mipi_csi2_tx:2.0.0} -vlnv {Actel:DirectCore:COREQSGMII:2.0.108} -vlnv {Microsemi:SolutionCore:complex_multiplier:1.0.26} -vlnv {Microsemi:SolutionCore:mipicsi2rxdecoderPF:2.1.0} -location {www.actel-ip.com/repositories/DirectCore} +#download_core -vlnv {Actel:Simulation:CLK_GEN:1.0.1} -vlnv {Actel:Simulation:PULSE_GEN:1.0.1} -vlnv {Actel:Simulation:RESET_GEN:1.0.1} -vlnv {Actel:DirectCore:CoreDDRMemCtrlr:0.0.74} -vlnv {Actel:DirectCore:COREDDR_TIP:1.1.124} -vlnv {Actel:SgCore:PF_CCC:1.0.112} -vlnv {Actel:SgCore:PF_CRYPTO:1.0.101} -vlnv {Actel:SgCore:PF_DPSRAM:1.1.110} -vlnv {Actel:SgCore:PF_DRI:1.0.101} -vlnv {Actel:SgCore:PF_INIT_MONITOR:2.0.101} -vlnv {Actel:SgCore:PF_NGMUX:1.0.101} -vlnv {Actel:SgCore:PF_OSC:1.0.102} -vlnv {Actel:SgCore:PF_TAMPER:1.0.102} -vlnv {Actel:SgCore:PF_TPSRAM:1.1.108} -vlnv {Actel:SgCore:PF_TX_PLL:1.0.109} -vlnv {Actel:SgCore:PF_UPROM:1.0.108} -vlnv {Actel:SgCore:PF_URAM:1.1.107} -vlnv {Actel:SgCore:PF_XCVR:1.0.223} -vlnv {Actel:SgCore:PF_XCVR_REF_CLK:1.0.103} -vlnv {Actel:SystemBuilder:PF_IOD_CDR:1.0.210} -vlnv {Actel:SystemBuilder:PF_IOD_LVDS7_RX:1.0.104} -vlnv {Actel:SystemBuilder:PF_IOD_LVDS7_TX:1.0.104} -vlnv {Actel:SystemBuilder:CORESMARTBERT:2.0.106} -vlnv {Actel:SgCore:PF_CLK_DIV:1.0.102} -vlnv {Actel:SgCore:PF_PCIE:1.0.234} -vlnv {Actel:SystemBuilder:PF_DDR3:2.2.109} -vlnv {Actel:SystemBuilder:PF_DDR4:2.2.109} -vlnv {Actel:SystemBuilder:PF_IOD_GENERIC_RX:1.0.238} -vlnv {Actel:SystemBuilder:PF_IOD_GENERIC_TX:1.0.234} -vlnv {Actel:SystemBuilder:PF_LPDDR3:2.1.111} -vlnv {Actel:SystemBuilder:PF_RGMII_TO_GMII:1.0.208} -vlnv {Actel:SystemBuilder:PF_SRAM_AHBL_AXI:1.1.123} -location {www.actel-ip.com/repositories/SgCore} +# +# +# Execute all design entry scripts generated from Chisel flow. +# +set tclfiles [glob -directory $chisel_build_dir $chisel_project.$chisel_config.*.libero.tcl ] + +foreach f $tclfiles { + puts "---------- Executing Libero TCL script: $f ----------" + source $f +} + +# +# Build design hierarchy and set project root to design's top level +# +build_design_hierarchy + +#set_root -module {U500PolarFireEvalKitFPGAChip::work} +set proj_root $chisel_model +append proj_root "::work" +puts "project root: $proj_root" +set_root -module $proj_root + +# +# Import IO, Placement and timing constrainst +# +puts "-----------------------------------------------------------------" +puts "------------------ Applying design constraints ------------------" +puts "-----------------------------------------------------------------" + +set sdc $chisel_project.$chisel_config.shell.sdc +set io_pdc $chisel_project.$chisel_config.shell.io.pdc + +import_files -fp_pdc [file join $boarddir constraints floor_plan.pdc] +import_files -io_pdc [file join $boarddir constraints pin_constraints.pdc] +import_files -io_pdc [file join $chisel_build_dir $io_pdc] +import_files -convert_EDN_to_HDL 0 -sdc [file join $chisel_build_dir $sdc] + +organize_tool_files -tool {PLACEROUTE} \ + -file $Proj/constraint/fp/floor_plan.pdc \ + -file $Proj/constraint/io/pin_constraints.pdc \ + -file $Proj/constraint/io/$io_pdc \ + -file $Proj/constraint/$sdc \ + -module $proj_root -input_type {constraint} + +organize_tool_files -tool {VERIFYTIMING} \ + -file $Proj/constraint/$sdc \ + -module $proj_root -input_type {constraint} + +run_tool -name {CONSTRAINT_MANAGEMENT} +derive_constraints_sdc + +# +# Synthesis +# +puts "-----------------------------------------------------------------" +puts "--------------------------- Synthesis ---------------------------" +puts "-----------------------------------------------------------------" +run_tool -name {SYNTHESIZE} + +# +# Place and route +# +puts "-----------------------------------------------------------------" +puts "------------------------ Place and Route ------------------------" +puts "-----------------------------------------------------------------" +configure_tool -name {PLACEROUTE} -params {EFFORT_LEVEL:true} -params {REPAIR_MIN_DELAY:true} -params {TDPR:true} -params {IOREG_COMBINING:true} +run_tool -name {PLACEROUTE} + +configure_tool -name {VERIFYTIMING} -params {CONSTRAINTS_COVERAGE:1} -params {FORMAT:XML} -params {MAX_TIMING_FAST_HV_LT:1} -params {MAX_TIMING_SLOW_LV_HT:1} -params {MAX_TIMING_SLOW_LV_LT:1} -params {MAX_TIMING_VIOLATIONS_FAST_HV_LT:1} -params {MAX_TIMING_VIOLATIONS_SLOW_LV_HT:1} -params {MAX_TIMING_VIOLATIONS_SLOW_LV_LT:1} -params {MIN_TIMING_FAST_HV_LT:1} -params {MIN_TIMING_SLOW_LV_HT:1} -params {MIN_TIMING_SLOW_LV_LT:1} -params {MIN_TIMING_VIOLATIONS_FAST_HV_LT:1} -params {MIN_TIMING_VIOLATIONS_SLOW_LV_HT:1} -params {MIN_TIMING_VIOLATIONS_SLOW_LV_LT:1} +run_tool -name {VERIFYTIMING} + +# +# Verify Timing +# +puts "-----------------------------------------------------------------" +puts "------------------------- Verify Timing -------------------------" +puts "-----------------------------------------------------------------" +configure_tool -name {VERIFYTIMING} \ + -params {FORMAT:XML} \ + -params {CONSTRAINTS_COVERAGE:1} \ + -params {MAX_TIMING_FAST_HV_LT:1} \ + -params {MAX_TIMING_SLOW_LV_HT:1} \ + -params {MAX_TIMING_SLOW_LV_LT:1} \ + -params {MAX_TIMING_VIOLATIONS_FAST_HV_LT:1} \ + -params {MAX_TIMING_VIOLATIONS_SLOW_LV_HT:1} \ + -params {MAX_TIMING_VIOLATIONS_SLOW_LV_LT:1} \ + -params {MIN_TIMING_FAST_HV_LT:1} \ + -params {MIN_TIMING_SLOW_LV_HT:1} \ + -params {MIN_TIMING_SLOW_LV_LT:1} \ + -params {MIN_TIMING_VIOLATIONS_FAST_HV_LT:1} \ + -params {MIN_TIMING_VIOLATIONS_SLOW_LV_HT:1} \ + -params {MIN_TIMING_VIOLATIONS_SLOW_LV_LT:1} +run_tool -name {VERIFYTIMING} + +puts "" +puts "Checking timing reports" + +set reportdir [file join $chisel_build_dir Libero $Prjname designer $Prjname] +set reports [glob -directory $reportdir [set Prjname]_\{min,max\}_timing_violations_\{fast,slow\}_\{hv,lv\}_\{lt,ht\}.*] +set ok true +set eof true + +foreach report [lsort $reports] { + puts -nonewline " Parsing [file tail ${report}]... " + set fp [open $report] + while {[gets $fp line] >= 0} { + set what [string trim "$line"] + set eof false + if { "$what" == "This report was not generated" } { + puts "empty" + break + } + if { "$what" == "No Path" } { + puts "pass" + break + } + if { "$what" == "Path 1" } { + puts "failed" + set ok false + break + } + set eof true + } + close $fp + if { $eof } { + puts "end-of-file" + set ok false + } +} + +if { !$ok } { + puts "" + puts "Timing constraints not met!" + return -code error "timing failed" +} + +# +# Generate programming files +# +puts "-----------------------------------------------------------------" +puts "------------------ Generate programming files -------------------" +puts "-----------------------------------------------------------------" +run_tool -name {GENERATEPROGRAMMINGDATA} + +run_tool -name {GENERATEPROGRAMMINGFILE} + +export_prog_job \ + -job_file_name $chisel_model \ + -export_dir $FPExpressDir \ + -bitstream_file_type {TRUSTED_FACILITY} \ + -bitstream_file_components {} diff --git a/hdl_cores/freedom/fpga-shells/microsemi/polarfireevalkit/constraints/PF_EvalKit_DDR3_fp.pdc b/hdl_cores/freedom/fpga-shells/microsemi/polarfireevalkit/constraints/PF_EvalKit_DDR3_fp.pdc new file mode 100644 index 0000000..58c1aef --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/microsemi/polarfireevalkit/constraints/PF_EvalKit_DDR3_fp.pdc @@ -0,0 +1,34 @@ +# Microsemi Physical design constraints file + +# Version: PolarFire v2.0 12.200.0.20 + +# Design Name: U500PolarFireEvalKitFPGAChip + +# Input Netlist Format: EDIF + +# Family: PolarFire , Die: MPF300TS_ES , Package: FCG1152 , Speed grade: -1 + +# Date generated: Mon Jan 8 10:19:51 2018 + + +# +# Local clock constraints +# + + +# +# Region constraints +# + + +# +# Core cell constraints +# + +set_location -inst_name iofpga/polarfireddr/island/blackbox/DDRPHY_BLK_0/LANE_0_CTRL/I_LANECTRL -fixed true -x 1967 -y 378 +set_location -inst_name iofpga/polarfireddr/island/blackbox/DDRPHY_BLK_0/IOD_BCLK_TRAINING/I_IOD_0 -fixed true -x 2388 -y 378 +set_location -inst_name iofpga/polarfireddr/island/blackbox/DDRPHY_BLK_0/LANE_1_CTRL/I_LANECTRL -fixed true -x 1823 -y 378 +set_location -inst_name iofpga/polarfireddr/island/blackbox/DDRPHY_BLK_0/LANE_1_IOD_READ_TRAINING/I_IOD_0 -fixed true -x 1812 -y 378 +set_location -inst_name iofpga/polarfireddr/island/blackbox/DDRPHY_BLK_0/LANE_0_IOD_READ_TRAINING/I_IOD_0 -fixed true -x 1956 -y 378 +set_location -inst_name iofpga/polarfireddr/island/blackbox/CCC_0/pll_inst_0 -fixed true -x 2460 -y 377 + diff --git a/hdl_cores/freedom/fpga-shells/microsemi/polarfireevalkit/constraints/PF_EvalKit_DDR3_io.pdc b/hdl_cores/freedom/fpga-shells/microsemi/polarfireevalkit/constraints/PF_EvalKit_DDR3_io.pdc new file mode 100644 index 0000000..ac3826f --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/microsemi/polarfireevalkit/constraints/PF_EvalKit_DDR3_io.pdc @@ -0,0 +1,319 @@ +# Microsemi I/O Physical Design Constraints file + +# User I/O Constraints file + +# Version: PolarFire v2.0 12.200.0.20 + +# Family: PolarFire , Die: MPF300TS_ES , Package: FCG1152 + +set_io -port_name {ddr_A[0]} \ + -pin_name AL27 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {ddr_A[1]} \ + -pin_name AL26 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {ddr_A[2]} \ + -pin_name AM27 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {ddr_A[3]} \ + -pin_name AN27 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {ddr_A[4]} \ + -pin_name AN26 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {ddr_A[5]} \ + -pin_name AP25 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {ddr_A[6]} \ + -pin_name AL25 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {ddr_A[7]} \ + -pin_name AK25 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {ddr_A[8]} \ + -pin_name AJ23 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {ddr_A[9]} \ + -pin_name AH23 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {ddr_A[10]} \ + -pin_name AJ25 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {ddr_A[11]} \ + -pin_name AJ24 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {ddr_A[12]} \ + -pin_name AL22 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {ddr_A[13]} \ + -pin_name AK23 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {ddr_A[14]} \ + -pin_name AL24 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {ddr_A[15]} \ + -pin_name AL23 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {ddr_BA[0]} \ + -pin_name AE25 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {ddr_BA[1]} \ + -pin_name AD23 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {ddr_BA[2]} \ + -pin_name AD25 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name ddr_CAS_N \ + -pin_name AF25 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name ddr_CK0 \ + -pin_name AP26 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name ddr_CK0_N \ + -pin_name AP27 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name ddr_CKE \ + -pin_name AF22 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name ddr_CS_N \ + -pin_name AE22 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {ddr_DM[0]} \ + -pin_name AN23 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {ddr_DM[1]} \ + -pin_name AL20 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {ddr_DQS[0]} \ + -pin_name AP23 \ + -fixed true \ + -DIRECTION INOUT + + +set_io -port_name {ddr_DQS[1]} \ + -pin_name AH22 \ + -fixed true \ + -DIRECTION INOUT + + +set_io -port_name {ddr_DQS_N[0]} \ + -pin_name AP24 \ + -fixed true \ + -DIRECTION INOUT + + +set_io -port_name {ddr_DQS_N[1]} \ + -pin_name AJ21 \ + -fixed true \ + -DIRECTION INOUT + + +set_io -port_name {ddr_DQ[0]} \ + -pin_name AN22 \ + -fixed true \ + -DIRECTION INOUT + + +set_io -port_name {ddr_DQ[1]} \ + -pin_name AN21 \ + -fixed true \ + -DIRECTION INOUT + + +set_io -port_name {ddr_DQ[2]} \ + -pin_name AM24 \ + -fixed true \ + -DIRECTION INOUT + + +set_io -port_name {ddr_DQ[3]} \ + -pin_name AN24 \ + -fixed true \ + -DIRECTION INOUT + + +set_io -port_name {ddr_DQ[4]} \ + -pin_name AP21 \ + -fixed true \ + -DIRECTION INOUT + + +set_io -port_name {ddr_DQ[5]} \ + -pin_name AP20 \ + -fixed true \ + -DIRECTION INOUT + + +set_io -port_name {ddr_DQ[6]} \ + -pin_name AP19 \ + -fixed true \ + -DIRECTION INOUT + + +set_io -port_name {ddr_DQ[7]} \ + -pin_name AN19 \ + -fixed true \ + -DIRECTION INOUT + + +set_io -port_name {ddr_DQ[8]} \ + -pin_name AM21 \ + -fixed true \ + -DIRECTION INOUT + + +set_io -port_name {ddr_DQ[9]} \ + -pin_name AK22 \ + -fixed true \ + -DIRECTION INOUT + + +set_io -port_name {ddr_DQ[10]} \ + -pin_name AK21 \ + -fixed true \ + -DIRECTION INOUT + + +set_io -port_name {ddr_DQ[11]} \ + -pin_name AK20 \ + -fixed true \ + -DIRECTION INOUT + + +set_io -port_name {ddr_DQ[12]} \ + -pin_name AJ20 \ + -fixed true \ + -DIRECTION INOUT + + +set_io -port_name {ddr_DQ[13]} \ + -pin_name AH21 \ + -fixed true \ + -DIRECTION INOUT + + +set_io -port_name {ddr_DQ[14]} \ + -pin_name AG21 \ + -fixed true \ + -DIRECTION INOUT + + +set_io -port_name {ddr_DQ[15]} \ + -pin_name AM19 \ + -fixed true \ + -DIRECTION INOUT + + +set_io -port_name ddr_ODT \ + -pin_name AF23 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name ddr_RAS_N \ + -pin_name AE23 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name ddr_RESET_N \ + -pin_name AG22 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name ddr_SHIELD0 \ + -pin_name AM22 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name ddr_SHIELD1 \ + -pin_name AM20 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name ddr_WE_N \ + -pin_name AF24 \ + -fixed true \ + -DIRECTION OUTPUT + diff --git a/hdl_cores/freedom/fpga-shells/microsemi/polarfireevalkit/constraints/PF_EvalKit_PCIe_fp.pdc b/hdl_cores/freedom/fpga-shells/microsemi/polarfireevalkit/constraints/PF_EvalKit_PCIe_fp.pdc new file mode 100644 index 0000000..46d891f --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/microsemi/polarfireevalkit/constraints/PF_EvalKit_PCIe_fp.pdc @@ -0,0 +1,29 @@ +# Microsemi Physical design constraints file + +# Version: PolarFire v2.0 12.200.0.20 + +# Design Name: U500PolarFireEvalKitFPGAChip + +# Input Netlist Format: EDIF + +# Family: PolarFire , Die: MPF300TS_ES , Package: FCG1152 , Speed grade: -1 + +# Date generated: Mon Jan 8 10:19:51 2018 + + +# +# Local clock constraints +# + + +# +# Region constraints +# + + +# +# Core cell constraints +# + +set_location -inst_name pf_xcvr_ref_clk/transceiver_refclk_0/I_IO -fixed true -x 2468 -y 236 +set_location -inst_name pf_tx_pll/transmit_pll_0/txpll_isnt_0 -fixed true -x 2466 -y 239 diff --git a/hdl_cores/freedom/fpga-shells/microsemi/polarfireevalkit/constraints/PF_EvalKit_PCIe_io.pdc b/hdl_cores/freedom/fpga-shells/microsemi/polarfireevalkit/constraints/PF_EvalKit_PCIe_io.pdc new file mode 100644 index 0000000..f6a68f4 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/microsemi/polarfireevalkit/constraints/PF_EvalKit_PCIe_io.pdc @@ -0,0 +1,133 @@ +# Microsemi I/O Physical Design Constraints file + +# User I/O Constraints file + +# Version: PolarFire v2.1 12.200.10.7 + +# Family: PolarFire , Die: MPF300TS_ES , Package: FCG1152 + +# Date generated: Fri Feb 9 16:31:44 2018 + +# +# User Locked I/O Bank Settings +# + +# +# Unlocked I/O Bank Settings +# The I/O Bank Settings can be locked by directly editing this file +# or by making changes in the I/O Attribute Editor +# + +# +# User Locked I/O settings +# + + + +# +# Dedicated Peripheral I/O Settings +# + + +# +# Unlocked I/O settings +# The I/Os in this section are unplaced or placed but are not locked +# the other listed attributes have been applied +# + + +# +#Ports using Dedicated Pins + +# + +set_io -port_name pcie_PCIESS_LANE_RXD0_N \ + -pin_name V30 \ + -DIRECTION INPUT + + +set_io -port_name pcie_PCIESS_LANE_RXD0_P \ + -pin_name V29 \ + -DIRECTION INPUT + + +set_io -port_name pcie_PCIESS_LANE_RXD1_N \ + -pin_name W32 \ + -DIRECTION INPUT + + +set_io -port_name pcie_PCIESS_LANE_RXD1_P \ + -pin_name W31 \ + -DIRECTION INPUT + + +set_io -port_name pcie_PCIESS_LANE_RXD2_N \ + -pin_name Y30 \ + -DIRECTION INPUT + + +set_io -port_name pcie_PCIESS_LANE_RXD2_P \ + -pin_name Y29 \ + -DIRECTION INPUT + + +set_io -port_name pcie_PCIESS_LANE_RXD3_N \ + -pin_name AB30 \ + -DIRECTION INPUT + + +set_io -port_name pcie_PCIESS_LANE_RXD3_P \ + -pin_name AB29 \ + -DIRECTION INPUT + + +set_io -port_name pcie_PCIESS_LANE_TXD0_N \ + -pin_name V34 \ + -DIRECTION OUTPUT + + +set_io -port_name pcie_PCIESS_LANE_TXD0_P \ + -pin_name V33 \ + -DIRECTION OUTPUT + + +set_io -port_name pcie_PCIESS_LANE_TXD1_N \ + -pin_name Y34 \ + -DIRECTION OUTPUT + + +set_io -port_name pcie_PCIESS_LANE_TXD1_P \ + -pin_name Y33 \ + -DIRECTION OUTPUT + + +set_io -port_name pcie_PCIESS_LANE_TXD2_N \ + -pin_name AA32 \ + -DIRECTION OUTPUT + + +set_io -port_name pcie_PCIESS_LANE_TXD2_P \ + -pin_name AA31 \ + -DIRECTION OUTPUT + + +set_io -port_name pcie_PCIESS_LANE_TXD3_N \ + -pin_name AB34 \ + -DIRECTION OUTPUT + + +set_io -port_name pcie_PCIESS_LANE_TXD3_P \ + -pin_name AB33 \ + -DIRECTION OUTPUT + + +set_io -port_name ref_clk_pad_n \ + -pin_name W28 \ + -DIRECTION INPUT + + +set_io -port_name ref_clk_pad_p \ + -pin_name W27 \ + -DIRECTION INPUT + + diff --git a/hdl_cores/freedom/fpga-shells/microsemi/polarfireevalkit/constraints/PF_EvalKit_base_io.pdc b/hdl_cores/freedom/fpga-shells/microsemi/polarfireevalkit/constraints/PF_EvalKit_base_io.pdc new file mode 100644 index 0000000..9466a66 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/microsemi/polarfireevalkit/constraints/PF_EvalKit_base_io.pdc @@ -0,0 +1,199 @@ +# Microsemi I/O Physical Design Constraints file + +# +# User Locked I/O Bank Settings +# + +# +# Unlocked I/O Bank Settings +# The I/O Bank Settings can be locked by directly editing this file +# or by making changes in the I/O Attribute Editor +# + +# +# User Locked I/O settings +# + +#set_io -port_name btn_0 \ +# -pin_name B19 \ +# -fixed true \ +# -DIRECTION OUTPUT + + +#set_io -port_name btn_1 \ +# -pin_name C21 \ +# -fixed true \ +# -DIRECTION OUTPUT + + +#set_io -port_name btn_2 \ +# -pin_name A25 \ +# -fixed true \ +# -DIRECTION OUTPUT + + +#set_io -port_name btn_3 \ +# -pin_name B27 \ +# -fixed true \ +# -DIRECTION OUTPUT + + +set_io -port_name led_0 \ + -pin_name F22 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name led_1 \ + -pin_name B26 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name led_2 \ + -pin_name C26 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name led_3 \ + -pin_name D25 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name led_4 \ + -pin_name C27 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name led_5 \ + -pin_name F23 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name led_6 \ + -pin_name H22 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name led_7 \ + -pin_name H21 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name ref_clk0 \ + -pin_name E25 \ + -fixed true \ + -DIRECTION INPUT + + +set_io -port_name pf_user_reset_n \ + -pin_name K22 \ + -fixed true \ + -DIRECTION INPUT + + +#set_io -port_name uart_rx \ +# -pin_name H18 \ +# -fixed true \ +# -DIRECTION INPUT + + +set_io -port_name uart_tx \ + -pin_name G17 \ + -fixed true \ + -DIRECTION OUTPUT + + +# +# SPI flash +# + +set_io -port_name spi_flash_hold \ + -pin_name A22 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name spi_flash_reset \ + -pin_name A24 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name spi_flash_sck \ + -pin_name H19 \ + -fixed true \ + -DIRECTION OUTPUT + + +#set_io -port_name spi_flash_sdi \ +# -pin_name C18 \ +# -fixed true \ +# -DIRECTION INPUT + + +set_io -port_name spi_flash_sdo \ + -pin_name G19 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name spi_flash_ss \ + -pin_name A20 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name spi_flash_wp \ + -pin_name A27 \ + -fixed true \ + -DIRECTION OUTPUT + + +# +# Debug +# + +set_io -port_name debug_io1 \ + -pin_name C17 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name debug_io2 \ + -pin_name A17 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name debug_io3 \ + -pin_name B17 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name debug_io4 \ + -pin_name A18 \ + -fixed true \ + -DIRECTION OUTPUT + +set_io -port_name ddr_CTRLR_READY \ + -pin_name A19 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name jtag_TDO \ + -pin_name A3 \ + -fixed true \ + -DIRECTION OUTPUT + + + + diff --git a/hdl_cores/freedom/fpga-shells/microsemi/polarfireevalkit/constraints/PF_EvalKit_fp.pdc b/hdl_cores/freedom/fpga-shells/microsemi/polarfireevalkit/constraints/PF_EvalKit_fp.pdc new file mode 100644 index 0000000..e813990 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/microsemi/polarfireevalkit/constraints/PF_EvalKit_fp.pdc @@ -0,0 +1,3 @@ + +set_location -inst_name hart_clk_ccc/hart_clk_ccc_0/pll_inst_0 -fixed true -x 2461 -y 377 +set_location -inst_name ddr3_clk_ccc/ddr3_clk_ccc_0/pll_inst_0 -fixed true -x 2460 -y 5 diff --git a/hdl_cores/freedom/fpga-shells/microsemi/polarfireevalkit/constraints/chiplink_io.pdc b/hdl_cores/freedom/fpga-shells/microsemi/polarfireevalkit/constraints/chiplink_io.pdc new file mode 100644 index 0000000..8b45d2c --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/microsemi/polarfireevalkit/constraints/chiplink_io.pdc @@ -0,0 +1,432 @@ +# Microsemi I/O Physical Design Constraints file + +# User I/O Constraints file + +# Version: PolarFire v2.0 12.200.0.20 + +# Family: PolarFire , Die: MPF300TS_ES , Package: FCG1152 + +# +# Chiplink IOs +# + +set_io -port_name chiplink_b2c_clk \ + -pin_name D13 \ + -fixed true \ + -DIRECTION INPUT + + +set_io -port_name {chiplink_b2c_data[0]} \ + -pin_name H9 \ + -fixed true \ + -DIRECTION INPUT + + +set_io -port_name {chiplink_b2c_data[1]} \ + -pin_name H8 \ + -fixed true \ + -DIRECTION INPUT + + +set_io -port_name {chiplink_b2c_data[2]} \ + -pin_name G9 \ + -fixed true \ + -DIRECTION INPUT + + +set_io -port_name {chiplink_b2c_data[3]} \ + -pin_name F9 \ + -fixed true \ + -DIRECTION INPUT + + +set_io -port_name {chiplink_b2c_data[4]} \ + -pin_name L19 \ + -fixed true \ + -DIRECTION INPUT + + +set_io -port_name {chiplink_b2c_data[5]} \ + -pin_name L18 \ + -fixed true \ + -DIRECTION INPUT + + +set_io -port_name {chiplink_b2c_data[6]} \ + -pin_name H16 \ + -fixed true \ + -DIRECTION INPUT + + +set_io -port_name {chiplink_b2c_data[7]} \ + -pin_name H17 \ + -fixed true \ + -DIRECTION INPUT + + +set_io -port_name {chiplink_b2c_data[8]} \ + -pin_name J18 \ + -fixed true \ + -DIRECTION INPUT + + +set_io -port_name {chiplink_b2c_data[9]} \ + -pin_name J19 \ + -fixed true \ + -DIRECTION INPUT + + +set_io -port_name {chiplink_b2c_data[10]} \ + -pin_name F14 \ + -fixed true \ + -DIRECTION INPUT + + +set_io -port_name {chiplink_b2c_data[11]} \ + -pin_name F15 \ + -fixed true \ + -DIRECTION INPUT + + +set_io -port_name {chiplink_b2c_data[12]} \ + -pin_name G15 \ + -fixed true \ + -DIRECTION INPUT + + +set_io -port_name {chiplink_b2c_data[13]} \ + -pin_name G16 \ + -fixed true \ + -DIRECTION INPUT + + +set_io -port_name {chiplink_b2c_data[14]} \ + -pin_name K15 \ + -fixed true \ + -DIRECTION INPUT + + +set_io -port_name {chiplink_b2c_data[15]} \ + -pin_name J15 \ + -fixed true \ + -DIRECTION INPUT + + +set_io -port_name {chiplink_b2c_data[16]} \ + -pin_name J14 \ + -fixed true \ + -DIRECTION INPUT + + +set_io -port_name {chiplink_b2c_data[17]} \ + -pin_name J13 \ + -fixed true \ + -DIRECTION INPUT + + +set_io -port_name {chiplink_b2c_data[18]} \ + -pin_name L17 \ + -fixed true \ + -DIRECTION INPUT + + +set_io -port_name {chiplink_b2c_data[19]} \ + -pin_name M17 \ + -fixed true \ + -DIRECTION INPUT + + +set_io -port_name {chiplink_b2c_data[20]} \ + -pin_name J16 \ + -fixed true \ + -DIRECTION INPUT + + +set_io -port_name {chiplink_b2c_data[21]} \ + -pin_name K16 \ + -fixed true \ + -DIRECTION INPUT + + +set_io -port_name {chiplink_b2c_data[22]} \ + -pin_name K18 \ + -fixed true \ + -DIRECTION INPUT + + +set_io -port_name {chiplink_b2c_data[23]} \ + -pin_name K17 \ + -fixed true \ + -DIRECTION INPUT + + +set_io -port_name {chiplink_b2c_data[24]} \ + -pin_name F12 \ + -fixed true \ + -DIRECTION INPUT + + +set_io -port_name {chiplink_b2c_data[25]} \ + -pin_name E12 \ + -fixed true \ + -DIRECTION INPUT + + +set_io -port_name {chiplink_b2c_data[26]} \ + -pin_name H14 \ + -fixed true \ + -DIRECTION INPUT + + +set_io -port_name {chiplink_b2c_data[27]} \ + -pin_name G14 \ + -fixed true \ + -DIRECTION INPUT + + +set_io -port_name {chiplink_b2c_data[28]} \ + -pin_name F13 \ + -fixed true \ + -DIRECTION INPUT + + +set_io -port_name {chiplink_b2c_data[29]} \ + -pin_name E13 \ + -fixed true \ + -DIRECTION INPUT + + +set_io -port_name {chiplink_b2c_data[30]} \ + -pin_name A7 \ + -fixed true \ + -DIRECTION INPUT + + +set_io -port_name {chiplink_b2c_data[31]} \ + -pin_name A8 \ + -fixed true \ + -DIRECTION INPUT + + +set_io -port_name chiplink_b2c_rst \ + -pin_name D11 \ + -fixed true \ + -DIRECTION INPUT + + +set_io -port_name chiplink_b2c_send \ + -pin_name D10 \ + -fixed true \ + -DIRECTION INPUT + + +set_io -port_name chiplink_c2b_clk \ + -pin_name C11 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {chiplink_c2b_data[0]} \ + -pin_name F8 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {chiplink_c2b_data[1]} \ + -pin_name F7 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {chiplink_c2b_data[2]} \ + -pin_name G5 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {chiplink_c2b_data[3]} \ + -pin_name F5 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {chiplink_c2b_data[4]} \ + -pin_name C6 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {chiplink_c2b_data[5]} \ + -pin_name B6 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {chiplink_c2b_data[6]} \ + -pin_name B9 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {chiplink_c2b_data[7]} \ + -pin_name A9 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {chiplink_c2b_data[8]} \ + -pin_name H13 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {chiplink_c2b_data[9]} \ + -pin_name H12 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {chiplink_c2b_data[10]} \ + -pin_name D8 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {chiplink_c2b_data[11]} \ + -pin_name C8 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {chiplink_c2b_data[12]} \ + -pin_name C7 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {chiplink_c2b_data[13]} \ + -pin_name B7 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {chiplink_c2b_data[14]} \ + -pin_name E10 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {chiplink_c2b_data[15]} \ + -pin_name E11 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {chiplink_c2b_data[16]} \ + -pin_name J11 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {chiplink_c2b_data[17]} \ + -pin_name H11 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {chiplink_c2b_data[18]} \ + -pin_name G12 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {chiplink_c2b_data[19]} \ + -pin_name G11 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {chiplink_c2b_data[20]} \ + -pin_name E6 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {chiplink_c2b_data[21]} \ + -pin_name D6 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {chiplink_c2b_data[22]} \ + -pin_name D9 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {chiplink_c2b_data[23]} \ + -pin_name C9 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {chiplink_c2b_data[24]} \ + -pin_name B10 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {chiplink_c2b_data[25]} \ + -pin_name A10 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {chiplink_c2b_data[26]} \ + -pin_name G10 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {chiplink_c2b_data[27]} \ + -pin_name F10 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {chiplink_c2b_data[28]} \ + -pin_name E7 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {chiplink_c2b_data[29]} \ + -pin_name E8 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {chiplink_c2b_data[30]} \ + -pin_name E1 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name {chiplink_c2b_data[31]} \ + -pin_name D1 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name chiplink_c2b_rst \ + -pin_name G7 \ + -fixed true \ + -DIRECTION OUTPUT + + +set_io -port_name chiplink_c2b_send \ + -pin_name H7 \ + -fixed true \ + -DIRECTION OUTPUT + + diff --git a/hdl_cores/freedom/fpga-shells/microsemi/polarfireevalkit/constraints/clock_groups.sdc b/hdl_cores/freedom/fpga-shells/microsemi/polarfireevalkit/constraints/clock_groups.sdc new file mode 100644 index 0000000..77ebb48 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/microsemi/polarfireevalkit/constraints/clock_groups.sdc @@ -0,0 +1,5 @@ +#set_clock_groups -name {Coreplex} -logically_exclusive -group [ get_clocks { hart_clk_ccc/hart_clk_ccc_0/pll_inst_0/OUT0 } ] +set_clock_groups -name {PCIe_AXI} -logically_exclusive -group [ get_clocks { hart_clk_ccc/hart_clk_ccc_0/pll_inst_0/OUT1 } ] +set_clock_groups -name {DDR_subsystem} -logically_exclusive -group [ get_clocks { iofpga/polarfireddr/island/blackbox/CCC_0/pll_inst_0/OUT1 } ] + + diff --git a/hdl_cores/freedom/fpga-shells/microsemi/vera/constraints/false_paths.sdc b/hdl_cores/freedom/fpga-shells/microsemi/vera/constraints/false_paths.sdc new file mode 100644 index 0000000..4aed0fe --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/microsemi/vera/constraints/false_paths.sdc @@ -0,0 +1,41 @@ +set_false_path -from [ get_ports { ereset_n }] +create_clock -name {chiplink_b2c_clk} -period 8 [ get_ports { chiplink_b2c_clk } ] + +# The c2b_clk comes from a phase-shifted output of the PLL +create_generated_clock -name {chiplink_c2b_clk} \ + -divide_by 1 -phase 0 \ + -source [ get_pins { hart_clk_ccc/hart_clk_ccc_0/pll_inst_0/OUT2 } ] \ + [ get_ports { chiplink_c2b_clk } ] + +set_clock_groups -asynchronous \ + -group [ get_clocks { chiplink_b2c_clk \ + iofpga/chiplink_rx_pll/chiplink_rx_pll_0/pll_inst_0/OUT1 } ] \ + -group [ get_clocks { ref_clk0 \ + hart_clk_ccc/hart_clk_ccc_0/pll_inst_0/OUT1 \ + hart_clk_ccc/hart_clk_ccc_0/pll_inst_0/OUT2 \ + chiplink_c2b_clk } ] \ + -group [ get_clocks { osc_rc160mhz } ] \ + -group [ get_clocks { ref_clk_pad_p } ] \ + -group [ get_clocks { iofpga/pf_ddr4/island/blackbox/CCC_0/pll_inst_0/OUT1 } ] + +# RX side: want to latch almost anywhere except on the rising edge of the clock +# The data signals coming from Aloe have: clock - 1.2 <= transition <= clock + 0.8 +# HFU500 Expansion board has 200mil delta between clock and data +# Let's add 0.1ns of safety for trace jitter+skew on both sides: +# min = hold = -1.2 - 0.1 +# max = period - setup = 0.8 + 0.1 +set_input_delay -min -1.3 -clock {chiplink_b2c_clk} [ get_ports { chiplink_b2c_data* chiplink_b2c_rst chiplink_b2c_send } ] +set_input_delay -max 0.9 -clock {chiplink_b2c_clk} [ get_ports { chiplink_b2c_data* chiplink_b2c_rst chiplink_b2c_send } ] + +# TX side: want to transition almost anywhere except on the rising edge of the clock +# The data signals going to Aloe must have: clock - 1.85 <= NO transition <= clock + 0.65 +# Let's add 0.6ns of safey for trace jitter+skew on both sides: +# min = -hold = -0.65 - 0.6 +# max = setup = 1.85 + 0.6 +set_output_delay -min -1.25 -clock {chiplink_c2b_clk} [ get_ports { chiplink_c2b_data* chiplink_c2b_rst chiplink_c2b_send } ] +set_output_delay -max 2.45 -clock {chiplink_c2b_clk} [ get_ports { chiplink_c2b_data* chiplink_c2b_rst chiplink_c2b_send } ] +# phase = 31.5 -> 0.55ns setup slack, 0.45ns hold slack + +#retiming is required +set_false_path -from [ get_pins { iofpga/link/ResetCatchAndSync_d3_1/AsyncResetSynchronizerShiftReg_w1_d3_i0/sync_2/reg_0/q/CLK } ] -to [ get_ports { chiplink_c2b_rst } ] +set_false_path -from [ get_ports { chiplink_b2c_rst } ] -to [ get_pins { iofpga/link/AsyncResetReg/q/D } ] diff --git a/hdl_cores/freedom/fpga-shells/microsemi/vera/constraints/floor_plan.pdc b/hdl_cores/freedom/fpga-shells/microsemi/vera/constraints/floor_plan.pdc new file mode 100644 index 0000000..68f37ef --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/microsemi/vera/constraints/floor_plan.pdc @@ -0,0 +1,4 @@ +# Constraints + +set_location -inst_name corePLL/corePLL_0/pll_inst_0 -fixed true -x 1 -y 377 +set_location -inst_name rxPLL/rxPLL_0/pll_inst_0 -fixed true -x 0 -y 377 diff --git a/hdl_cores/freedom/fpga-shells/microsemi/vera/constraints/pin_constraints.pdc b/hdl_cores/freedom/fpga-shells/microsemi/vera/constraints/pin_constraints.pdc new file mode 100644 index 0000000..673fd31 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/microsemi/vera/constraints/pin_constraints.pdc @@ -0,0 +1,11 @@ +# +# User Locked I/O Bank Settings +# + +set_iobank -bank_name Bank0 -vcci 1.80 -fixed true +set_iobank -bank_name Bank1 -vcci 1.20 -fixed true +set_iobank -bank_name Bank2 -vcci 3.30 -fixed true +set_iobank -bank_name Bank4 -vcci 1.80 -fixed true +set_iobank -bank_name Bank5 -vcci 3.30 -fixed true +set_iobank -bank_name Bank6 -vcci 1.80 -fixed true +set_iobank -bank_name Bank7 -vcci 1.80 -fixed true diff --git a/hdl_cores/freedom/fpga-shells/microsemi/vera/tcl/board.tcl b/hdl_cores/freedom/fpga-shells/microsemi/vera/tcl/board.tcl new file mode 100644 index 0000000..6c743fd --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/microsemi/vera/tcl/board.tcl @@ -0,0 +1,12 @@ +#Device Selection +set family {PolarFire} +set die {MPF300TS_ES} +set package {FCG1152} +set speed {-1} +set die_voltage {1.0} +set part_range {EXT} + +#Device Settings +set IOTech {LVCMOS 1.8V} +set ResProbe {1} +set ResSPI {0} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/clocks/Bundles.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/clocks/Bundles.scala new file mode 100644 index 0000000..7fa93bd --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/clocks/Bundles.scala @@ -0,0 +1,17 @@ +// See LICENSE.SiFive for license details. +package sifive.fpgashells.clocks + +import Chisel._ +import freechips.rocketchip.diplomacy._ +import freechips.rocketchip.util._ + +class ClockBundle(params: ClockBundleParameters) extends GenericParameterizedBundle(params) +{ + val clock = Clock() + val reset = Bool() +} + +class ClockGroupBundle(params: ClockGroupBundleParameters) extends GenericParameterizedBundle(params) +{ + val member = HeterogeneousBag(params.members.map(p => new ClockBundle(p))) +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/clocks/ClockGroup.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/clocks/ClockGroup.scala new file mode 100644 index 0000000..aa09e02 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/clocks/ClockGroup.scala @@ -0,0 +1,33 @@ +// See LICENSE.SiFive for license details. +package sifive.fpgashells.clocks + +import Chisel._ +import chisel3.internal.sourceinfo.SourceInfo +import freechips.rocketchip.config.Parameters +import freechips.rocketchip.diplomacy._ + +case class ClockGroupNode(groupName: String)(implicit valName: ValName) + extends MixedNexusNode(ClockGroupImp, ClockImp)( + dFn = { _ => ClockSourceParameters() }, + uFn = { seq => ClockGroupSinkParameters(name = groupName, members = seq) }) + +class ClockGroup(groupName: String)(implicit p: Parameters) extends LazyModule +{ + val node = ClockGroupNode(groupName) + + lazy val module = new LazyModuleImp(this) { + val (in, _) = node.in(0) + val (out, _) = node.out.unzip + + require (node.in.size == 1) + require (in.member.size == out.size) + + (in.member zip out) foreach { case (i, o) => o := i } + } +} + +object ClockGroup +{ + def apply()(implicit p: Parameters, valName: ValName) = + LazyModule(new ClockGroup(valName.name)).node +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/clocks/Nodes.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/clocks/Nodes.scala new file mode 100644 index 0000000..2593bf5 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/clocks/Nodes.scala @@ -0,0 +1,70 @@ +// See LICENSE.SiFive for license details. +package sifive.fpgashells.clocks + +import Chisel._ +import chisel3.internal.sourceinfo.SourceInfo +import freechips.rocketchip.config.Parameters +import freechips.rocketchip.diplomacy._ + +object ClockImp extends SimpleNodeImp[ClockSourceParameters, ClockSinkParameters, ClockEdgeParameters, ClockBundle] +{ + def edge(pd: ClockSourceParameters, pu: ClockSinkParameters, p: Parameters, sourceInfo: SourceInfo) = ClockEdgeParameters(pd, pu, p, sourceInfo) + def bundle(e: ClockEdgeParameters) = new ClockBundle(e.bundle) + def render(e: ClockEdgeParameters) = RenderedEdge(colour = "#00cc00" /* green */) +} + +case class ClockSourceNode(val portParams: Seq[ClockSourceParameters])(implicit valName: ValName) extends SourceNode(ClockImp)(portParams) +case class ClockSinkNode(val portParams: Seq[ClockSinkParameters])(implicit valName: ValName) extends SinkNode(ClockImp)(portParams) +case class ClockAdapterNode( + sourceFn: ClockSourceParameters => ClockSourceParameters = { m => m }, + sinkFn: ClockSinkParameters => ClockSinkParameters = { s => s })( + implicit valName: ValName) + extends AdapterNode(ClockImp)(sourceFn, sinkFn) +case class ClockIdentityNode()(implicit valName: ValName) extends IdentityNode(ClockImp)() + +object ClockSinkNode +{ + def apply( + freqMHz: Double, + dutyCycle: Double = 50, + phaseDeg: Double = 0, + // Create SDC/TCL constraints that the clock matches these requirements: + phaseErrorDeg: Double = 5, + freqErrorPPM: Double = 10000, + jitterPS: Double = 300)(implicit valName: ValName): ClockSinkNode = + ClockSinkNode(Seq(ClockSinkParameters( + phaseDeg = phaseDeg, + phaseErrorDeg = phaseErrorDeg, + freqErrorPPM = freqErrorPPM, + jitterPS = jitterPS, + take = Some(ClockParameters( + freqMHz = freqMHz, + dutyCycle = dutyCycle))))) +} + +object ClockSourceNode +{ + def apply( + freqMHz: Double, + dutyCycle: Double = 50, + jitterPS: Double = 300)(implicit valName: ValName): ClockSourceNode = + ClockSourceNode(Seq(ClockSourceParameters( + jitterPS = Some(jitterPS), + give = Some(ClockParameters( + freqMHz = freqMHz, + dutyCycle = dutyCycle))))) +} + +object ClockGroupImp extends SimpleNodeImp[ClockGroupSourceParameters, ClockGroupSinkParameters, ClockGroupEdgeParameters, ClockGroupBundle] +{ + def edge(pd: ClockGroupSourceParameters, pu: ClockGroupSinkParameters, p: Parameters, sourceInfo: SourceInfo) = ClockGroupEdgeParameters(pd, pu, p, sourceInfo) + def bundle(e: ClockGroupEdgeParameters) = new ClockGroupBundle(e.bundle) + def render(e: ClockGroupEdgeParameters) = RenderedEdge(colour = "#00cc00" /* green */) +} + +case class ClockGroupAdapterNode( + sourceFn: ClockGroupSourceParameters => ClockGroupSourceParameters = { m => m }, + sinkFn: ClockGroupSinkParameters => ClockGroupSinkParameters = { s => s })( + implicit valName: ValName) + extends AdapterNode(ClockGroupImp)(sourceFn, sinkFn) +case class ClockGroupIdentityNode()(implicit valName: ValName) extends IdentityNode(ClockGroupImp)() diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/clocks/PLLFactory.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/clocks/PLLFactory.scala new file mode 100644 index 0000000..7f76285 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/clocks/PLLFactory.scala @@ -0,0 +1,98 @@ +// See LICENSE for license details. +package sifive.fpgashells.clocks + +import chisel3._ +import freechips.rocketchip.config._ +import freechips.rocketchip.diplomacy._ +import sifive.fpgashells.shell._ +import scala.collection.immutable.ListMap + +case class PLLNode(val feedback: Boolean)(implicit valName: ValName) + extends MixedNexusNode(ClockImp, ClockGroupImp)( + dFn = { _ => ClockGroupSourceParameters() }, + uFn = { _ => ClockSinkParameters() }) + +case class PLLInClockParameters( + freqMHz: Double, + jitter: Double = 50, + feedback: Boolean = false) + +case class PLLOutClockParameters( + freqMHz: Double, + phaseDeg: Double = 0, + dutyCycle: Double = 50, // in percent + // used to create constraints: + jitterPS: Double = 300, + freqErrorPPM: Double = 10000, + phaseErrorDeg: Double = 5) + +case class PLLParameters( + name: String, + input: PLLInClockParameters, + req: Seq[PLLOutClockParameters]) + +trait PLLInstance { + def getInput: Clock + def getReset: Option[Bool] + def getLocked: Bool + def getClocks: Seq[Clock] + def getClockNames: Seq[String] +} + +case object PLLFactoryKey extends Field[PLLFactory] +class PLLFactory(scope: IOShell, maxOutputs: Int, gen: PLLParameters => PLLInstance) +{ + private var pllNodes: Seq[PLLNode] = Nil + + def apply(feedback: Boolean = false)(implicit valName: ValName, p: Parameters): PLLNode = { + val node = scope { PLLNode(feedback) } + pllNodes = node +: pllNodes + node + } + + val plls: ModuleValue[Seq[(PLLInstance, PLLNode)]] = scope { InModuleBody { + val plls = pllNodes.flatMap { case node => + require (node.in.size == 1) + val (in, edgeIn) = node.in(0) + val (out, edgeOut) = node.out.unzip + + val params = PLLParameters( + name = node.valName.name, + input = PLLInClockParameters( + freqMHz = edgeIn.clock.freqMHz, + jitter = edgeIn.source.jitterPS.getOrElse(50), + feedback = node.feedback), + req = edgeOut.flatMap(_.members).map { e => + PLLOutClockParameters( + freqMHz = e.clock.freqMHz, + phaseDeg = e.sink.phaseDeg, + dutyCycle = e.clock.dutyCycle, + jitterPS = e.sink.jitterPS, + freqErrorPPM = e.sink.freqErrorPPM, + phaseErrorDeg = e.sink.phaseErrorDeg)}) + + val pll = gen(params) + pll.getInput := in.clock + pll.getReset.foreach { _ := in.reset } + (out.flatMap(_.member) zip pll.getClocks) foreach { case (o, i) => + o.clock := i + o.reset := !pll.getLocked || in.reset + } + Some((pll, node)) + } + + // Require all clock group names to be distinct + val sdcGroups = Map() ++ plls.flatMap { case tuple => + val (pll, node) = tuple + val (out, edgeOut) = node.out.unzip + val groupLabels = edgeOut.flatMap(e => Seq.fill(e.members.size) { e.sink.name }) + groupLabels zip pll.getClocks.map(x => IOPin(x)) + }.groupBy(_._1).mapValues(_.map(_._2)) + + // Ensure there are no clock groups with the same name + require (sdcGroups.size == pllNodes.map(_.edges.out.size).sum) + sdcGroups.foreach { case (_, clockPins) => scope.sdc.addGroup(pins = clockPins) } + + plls + } } +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/clocks/Parameters.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/clocks/Parameters.scala new file mode 100644 index 0000000..80477d4 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/clocks/Parameters.scala @@ -0,0 +1,77 @@ +// See LICENSE.SiFive for license details. +package sifive.fpgashells.clocks + +import Chisel._ +import chisel3.internal.sourceinfo.SourceInfo +import freechips.rocketchip.config.Parameters +import freechips.rocketchip.diplomacy._ +import scala.math.max + +// All Clock parameters specify only the PLL values required at power-on +// Dynamic control of the PLL from software can take the values out-of-range + +case class ClockParameters( + freqMHz: Double, + dutyCycle: Double = 50) //in percent +{ + require (freqMHz > 0) + require (0 < dutyCycle) + require (dutyCycle < 100) +} + +case class ClockSourceParameters( + jitterPS: Option[Double] = None, // if known at chisel elaboration + give: Option[ClockParameters] = None) + +case class ClockSinkParameters( + phaseDeg: Double = 0, + // Create SDC/TCL constraints that the clock matches these requirements: + phaseErrorDeg: Double = 5, + freqErrorPPM: Double = 10000, + jitterPS: Double = 200, + take: Option[ClockParameters] = None) +{ + require (phaseErrorDeg >= 0) + require (freqErrorPPM >= 0) +} + +case class ClockBundleParameters() + +case class ClockEdgeParameters( + source: ClockSourceParameters, + sink: ClockSinkParameters, + params: Parameters, + sourceInfo: SourceInfo) +{ + // Unify the given+taken ClockParameters + require (!source.give.isEmpty || !sink.take.isEmpty) + val clock = source.give.orElse(sink.take).get + source.give.foreach { x => require (clock == x) } + sink.take.foreach { x => require (clock == x) } + + val bundle = ClockBundleParameters() +} + +// ClockGroups exist as the output of a PLL + +case class ClockGroupSourceParameters() +case class ClockGroupSinkParameters( + name: String, + members: Seq[ClockSinkParameters]) + +case class ClockGroupBundleParameters( + members: Seq[ClockBundleParameters]) + +case class ClockGroupEdgeParameters( + source: ClockGroupSourceParameters, + sink: ClockGroupSinkParameters, + params: Parameters, + sourceInfo: SourceInfo) +{ + val sourceParameters = ClockSourceParameters() + val members = sink.members.map { s => + ClockEdgeParameters(sourceParameters, s, params, sourceInfo) + } + + val bundle = ClockGroupBundleParameters(members.map(_.bundle)) +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/clocks/ResetWrangler.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/clocks/ResetWrangler.scala new file mode 100644 index 0000000..2e7f4b4 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/clocks/ResetWrangler.scala @@ -0,0 +1,43 @@ +// See LICENSE for license details. +package sifive.fpgashells.clocks + +import chisel3._ +import chisel3.util._ +import freechips.rocketchip.config._ +import freechips.rocketchip.diplomacy._ +import freechips.rocketchip.util._ + +class ResetWrangler(debounceNs: Double = 100000)(implicit p: Parameters) extends LazyModule +{ + val node = ClockAdapterNode() + + lazy val module = new LazyRawModuleImp(this) { + val (in, _) = node.in.unzip + val (out, _) = node.out.unzip + + val status = IO(Output(UInt(in.size.W))) + status := Cat(in.map(_.reset).reverse) + + val causes = in.map(_.reset).foldLeft(false.B)(_ || _) + val (slowIn, slowEdge) = node.in.minBy(_._2.clock.freqMHz) + val slowPeriodNs = 1000 / slowEdge.clock.freqMHz + val slowTicks = math.ceil(debounceNs/slowPeriodNs).toInt max 7 + val slowBits = log2Ceil(slowTicks+1) + + // debounce + val increment = Wire(Bool()) + val incremented = Wire(UInt(slowBits.W)) + val debounced = withClockAndReset(slowIn.clock, causes) { + AsyncResetReg(incremented, 0, increment, Some("debounce")) + } + increment := debounced =/= slowTicks.U + incremented := debounced + 1.U + val deglitched = AsyncResetReg(increment, slowIn.clock, causes, true, Some("deglitch")) + + // catch and sync increment to each domain + (in zip out) foreach { case (i, o) => + o.clock := i.clock + o.reset := ResetCatchAndSync(o.clock, deglitched) + } + } +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/devices/microsemi/polarfire_ddr3/MicrosemiPolarFireDDR3.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/devices/microsemi/polarfire_ddr3/MicrosemiPolarFireDDR3.scala new file mode 100644 index 0000000..0cd535c --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/devices/microsemi/polarfire_ddr3/MicrosemiPolarFireDDR3.scala @@ -0,0 +1,165 @@ +// See LICENSE for license details. +package sifive.fpgashells.devices.microsemi.polarfireddr3 + +import Chisel._ +import chisel3.experimental.{Analog,attach} +import freechips.rocketchip.amba.axi4._ +import freechips.rocketchip.config.Parameters +//import freechips.rocketchip.coreplex._ +import freechips.rocketchip.subsystem._ +import freechips.rocketchip.diplomacy._ +import freechips.rocketchip.tilelink._ +import freechips.rocketchip.interrupts._ +import sifive.fpgashells.ip.microsemi.polarfireddr3.{PolarFireEvalKitDDR3IOClocksReset, PolarFireEvalKitDDR3IODDR, DDR3_Subsys} + +case class PolarFireEvalKitDDR3Params( + address : Seq[AddressSet] +) + +class PolarFireEvalKitDDR3Pads(depth : BigInt) extends PolarFireEvalKitDDR3IODDR(depth) { + def this(c : PolarFireEvalKitDDR3Params) { + this(AddressRange.fromSets(c.address).head.size) + } +} + +class PolarFireEvalKitDDR3IO(depth : BigInt) extends PolarFireEvalKitDDR3IODDR(depth) with PolarFireEvalKitDDR3IOClocksReset + +class PolarFireEvalKitDDR3Island(c : PolarFireEvalKitDDR3Params)(implicit p: Parameters) extends LazyModule with CrossesToOnlyOneClockDomain { + val ranges = AddressRange.fromSets(c.address) + require (ranges.size == 1, "DDR range must be contiguous") + val offset = ranges.head.base + val depth = ranges.head.size + val crossing = AsynchronousCrossing(8) + + require((depth<=0x100000000L),"PolarFire Evaluation Kit supports upto 4GB depth configuraton") + + val device = new MemoryDevice + val node = AXI4SlaveNode(Seq(AXI4SlavePortParameters( + slaves = Seq(AXI4SlaveParameters( + address = c.address, + resources = device.reg, + regionType = RegionType.UNCACHED, + executable = true, + supportsWrite = TransferSizes(1, 256*8), + supportsRead = TransferSizes(1, 256*8))), + beatBytes = 8))) + + lazy val module = new LazyModuleImp(this) { + val io = IO(new Bundle { + val port = new PolarFireEvalKitDDR3IO(depth) + }) + + //MIG black box instantiation + val blackbox = Module(new DDR3_Subsys(depth)) + val (axi_async, _) = node.in(0) + + //pins to top level + + //inouts + attach(io.port.DQ,blackbox.io.DQ) + attach(io.port.DQS_N,blackbox.io.DQS_N) + attach(io.port.DQS,blackbox.io.DQS) + + //outputs + io.port.A := blackbox.io.A + io.port.BA := blackbox.io.BA + io.port.RAS_N := blackbox.io.RAS_N + io.port.CAS_N := blackbox.io.CAS_N + io.port.WE_N := blackbox.io.WE_N + io.port.RESET_N := blackbox.io.RESET_N + io.port.CK0 := blackbox.io.CK0 + io.port.CK0_N := blackbox.io.CK0_N + io.port.CKE := blackbox.io.CKE + io.port.CS_N := blackbox.io.CS_N + io.port.DM := blackbox.io.DM + io.port.ODT := blackbox.io.ODT + + io.port.CTRLR_READY := blackbox.io.CTRLR_READY + io.port.SHIELD0 := blackbox.io.SHIELD0 + io.port.SHIELD1 := blackbox.io.SHIELD1 + + //inputs + val awaddr = axi_async.aw.bits.addr - UInt(offset) + val araddr = axi_async.ar.bits.addr - UInt(offset) + + //slave AXI interface write address ports + blackbox.io.axi0_awid := axi_async.aw.bits.id + blackbox.io.axi0_awaddr := awaddr //truncated + blackbox.io.axi0_awlen := axi_async.aw.bits.len + blackbox.io.axi0_awsize := axi_async.aw.bits.size + blackbox.io.axi0_awburst := axi_async.aw.bits.burst + blackbox.io.axi0_awlock := axi_async.aw.bits.lock + blackbox.io.axi0_awcache := UInt("b0011") + blackbox.io.axi0_awprot := axi_async.aw.bits.prot + blackbox.io.axi0_awvalid := axi_async.aw.valid + axi_async.aw.ready := blackbox.io.axi0_awready + + //slave interface write data ports + blackbox.io.axi0_wdata := axi_async.w.bits.data + blackbox.io.axi0_wstrb := axi_async.w.bits.strb + blackbox.io.axi0_wlast := axi_async.w.bits.last + blackbox.io.axi0_wvalid := axi_async.w.valid + axi_async.w.ready := blackbox.io.axi0_wready + + //slave interface write response + blackbox.io.axi0_bready := axi_async.b.ready + axi_async.b.bits.id := blackbox.io.axi0_bid + axi_async.b.bits.resp := blackbox.io.axi0_bresp + axi_async.b.valid := blackbox.io.axi0_bvalid + + //slave AXI interface read address ports + blackbox.io.axi0_arid := axi_async.ar.bits.id + blackbox.io.axi0_araddr := araddr // truncated + blackbox.io.axi0_arlen := axi_async.ar.bits.len + blackbox.io.axi0_arsize := axi_async.ar.bits.size + blackbox.io.axi0_arburst := axi_async.ar.bits.burst + blackbox.io.axi0_arlock := axi_async.ar.bits.lock + blackbox.io.axi0_arcache := UInt("b0011") + blackbox.io.axi0_arprot := axi_async.ar.bits.prot + blackbox.io.axi0_arvalid := axi_async.ar.valid + axi_async.ar.ready := blackbox.io.axi0_arready + + //slace AXI interface read data ports + blackbox.io.axi0_rready := axi_async.r.ready + axi_async.r.bits.id := blackbox.io.axi0_rid + axi_async.r.bits.data := blackbox.io.axi0_rdata + axi_async.r.bits.resp := blackbox.io.axi0_rresp + axi_async.r.bits.last := blackbox.io.axi0_rlast + axi_async.r.valid := blackbox.io.axi0_rvalid + + //misc + blackbox.io.AXI0_AWUSERTAG := UInt("b0000") + blackbox.io.SYS_RESET_N :=io.port.SYS_RESET_N + blackbox.io.PLL_REF_CLK :=io.port.PLL_REF_CLK + + io.port.SYS_CLK := blackbox.io.SYS_CLK + io.port.PLL_LOCK := blackbox.io.PLL_LOCK + } +} + +class PolarFireEvalKitDDR3(c : PolarFireEvalKitDDR3Params)(implicit p: Parameters) extends LazyModule { + val ranges = AddressRange.fromSets(c.address) + val depth = ranges.head.size + + val buffer = LazyModule(new TLBuffer) + val toaxi4 = LazyModule(new TLToAXI4(adapterName = Some("mem"), stripBits = 1)) + val indexer = LazyModule(new AXI4IdIndexer(idBits = 4)) + val deint = LazyModule(new AXI4Deinterleaver(p(CacheBlockBytes))) + val yank = LazyModule(new AXI4UserYanker) + val island = LazyModule(new PolarFireEvalKitDDR3Island(c)) + + val node: TLInwardNode = + island.crossAXI4In(island.node) := yank.node := deint.node := indexer.node := toaxi4.node := buffer.node + + lazy val module = new LazyModuleImp(this) { + val io = IO(new Bundle { + val port = new PolarFireEvalKitDDR3IO(depth) + }) + + io.port <> island.module.io.port + + // Shove the island + island.module.clock := io.port.SYS_CLK + island.module.reset := !io.port.CTRLR_READY + } +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/devices/microsemi/polarfire_ddr3/MicrosemiPolarFireDDR3Periphery.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/devices/microsemi/polarfire_ddr3/MicrosemiPolarFireDDR3Periphery.scala new file mode 100644 index 0000000..476218e --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/devices/microsemi/polarfire_ddr3/MicrosemiPolarFireDDR3Periphery.scala @@ -0,0 +1,37 @@ +// See LICENSE for license details. +package sifive.fpgashells.devices.microsemi.polarfireddr3 + +import Chisel._ +import freechips.rocketchip.config._ +//import freechips.rocketchip.coreplex.HasMemoryBus +import freechips.rocketchip.subsystem.BaseSubsystem +import freechips.rocketchip.diplomacy.{LazyModule, LazyModuleImp, AddressRange} + +case object MemoryMicrosemiDDR3Key extends Field[PolarFireEvalKitDDR3Params] + +//trait HasMemoryPolarFireEvalKitDDR3 extends HasMemoryBus { +trait HasMemoryPolarFireEvalKitDDR3 { this: BaseSubsystem => + val module: HasMemoryPolarFireEvalKitDDR3ModuleImp + + val polarfireddrsubsys = LazyModule(new PolarFireEvalKitDDR3(p(MemoryMicrosemiDDR3Key))) + + polarfireddrsubsys.node := mbus.toDRAMController(Some("PolarFireDDR"))() +} + +trait HasMemoryPolarFireEvalKitDDR3Bundle { + val polarfireddrsubsys: PolarFireEvalKitDDR3IO + def connectPolarFireEValKitDDR3ToPads(pads: PolarFireEvalKitDDR3Pads) { + pads <> polarfireddrsubsys + } +} + +trait HasMemoryPolarFireEvalKitDDR3ModuleImp extends LazyModuleImp + with HasMemoryPolarFireEvalKitDDR3Bundle { + val outer: HasMemoryPolarFireEvalKitDDR3 + val ranges = AddressRange.fromSets(p(MemoryMicrosemiDDR3Key).address) + require (ranges.size == 1, "DDR range must be contiguous") + val depth = ranges.head.size + val polarfireddrsubsys = IO(new PolarFireEvalKitDDR3IO(depth)) + + polarfireddrsubsys <> outer.polarfireddrsubsys.module.io.port +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/devices/microsemi/polarfire_ddr4/MicrosemiPolarFireDDR4.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/devices/microsemi/polarfire_ddr4/MicrosemiPolarFireDDR4.scala new file mode 100644 index 0000000..1274d29 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/devices/microsemi/polarfire_ddr4/MicrosemiPolarFireDDR4.scala @@ -0,0 +1,166 @@ +// See LICENSE for license details. +package sifive.fpgashells.devices.microsemi.polarfireddr4 + +import Chisel._ +import chisel3.experimental.{Analog,attach} +import freechips.rocketchip.amba.axi4._ +import freechips.rocketchip.config.Parameters +import freechips.rocketchip.subsystem._ +import freechips.rocketchip.diplomacy._ +import freechips.rocketchip.tilelink._ +import freechips.rocketchip.interrupts._ +import sifive.fpgashells.ip.microsemi.polarfireddr4.{PolarFireEvalKitDDR4IOClocksReset, PolarFireEvalKitDDR4IODDR, DDR4_Subsys} + +case class PolarFireEvalKitDDR4Params( + address : Seq[AddressSet] +) + +class PolarFireEvalKitDDR4Pads(depth : BigInt) extends PolarFireEvalKitDDR4IODDR(depth) { + def this(c : PolarFireEvalKitDDR4Params) { + this(AddressRange.fromSets(c.address).head.size) + } +} + +class PolarFireEvalKitDDR4IO(depth : BigInt) extends PolarFireEvalKitDDR4IODDR(depth) with PolarFireEvalKitDDR4IOClocksReset + +class PolarFireEvalKitDDR4Island(c : PolarFireEvalKitDDR4Params)(implicit p: Parameters) extends LazyModule with HasCrossing { + val ranges = AddressRange.fromSets(c.address) + require (ranges.size == 1, "DDR range must be contiguous") + val offset = ranges.head.base + val depth = ranges.head.size + val crossing = AsynchronousCrossing(8) + require((depth<=0x100000000L),"PF Eval Kit supports upto 4GB depth configuraton") + + val device = new MemoryDevice + val node = AXI4SlaveNode(Seq(AXI4SlavePortParameters( + slaves = Seq(AXI4SlaveParameters( + address = c.address, + resources = device.reg, + regionType = RegionType.UNCACHED, + executable = true, + supportsWrite = TransferSizes(1, 128), + supportsRead = TransferSizes(1, 128))), + beatBytes = 8))) + + lazy val module = new LazyModuleImp(this) { + val io = IO(new Bundle { + val port = new PolarFireEvalKitDDR4IO(depth) + }) + + // DDR block black box instantiation + val blackbox = Module(new DDR4_Subsys(depth)) + val (axi_async, _) = node.in(0) + + //pins to top level + + //inouts + attach(io.port.DQ,blackbox.io.DQ) + attach(io.port.DQS_N,blackbox.io.DQS_N) + attach(io.port.DQS,blackbox.io.DQS) + + //outputs + io.port.A := blackbox.io.A + io.port.ACT_N := blackbox.io.ACT_N + io.port.BA := blackbox.io.BA + io.port.BG := blackbox.io.BG + io.port.RAS_N := blackbox.io.RAS_N + io.port.CAS_N := blackbox.io.CAS_N + io.port.WE_N := blackbox.io.WE_N + io.port.RESET_N := blackbox.io.RESET_N + io.port.CK0 := blackbox.io.CK0 + io.port.CK0_N := blackbox.io.CK0_N + io.port.CKE := blackbox.io.CKE + io.port.CS_N := blackbox.io.CS_N + io.port.DM_N := blackbox.io.DM_N + io.port.ODT := blackbox.io.ODT + + io.port.CTRLR_READY := blackbox.io.CTRLR_READY + io.port.SHIELD0 := blackbox.io.SHIELD0 + io.port.SHIELD1 := blackbox.io.SHIELD1 + + //inputs + val awaddr = axi_async.aw.bits.addr - UInt(offset) + val araddr = axi_async.ar.bits.addr - UInt(offset) + + //slave AXI interface write address ports + blackbox.io.axi0_awid := axi_async.aw.bits.id + blackbox.io.axi0_awaddr := awaddr //truncated + blackbox.io.axi0_awlen := axi_async.aw.bits.len + blackbox.io.axi0_awsize := axi_async.aw.bits.size + blackbox.io.axi0_awburst := axi_async.aw.bits.burst + blackbox.io.axi0_awlock := axi_async.aw.bits.lock + blackbox.io.axi0_awcache := UInt("b0011") + blackbox.io.axi0_awprot := axi_async.aw.bits.prot + blackbox.io.axi0_awvalid := axi_async.aw.valid + axi_async.aw.ready := blackbox.io.axi0_awready + + //slave interface write data ports + blackbox.io.axi0_wdata := axi_async.w.bits.data + blackbox.io.axi0_wstrb := axi_async.w.bits.strb + blackbox.io.axi0_wlast := axi_async.w.bits.last + blackbox.io.axi0_wvalid := axi_async.w.valid + axi_async.w.ready := blackbox.io.axi0_wready + + //slave interface write response + blackbox.io.axi0_bready := axi_async.b.ready + axi_async.b.bits.id := blackbox.io.axi0_bid + axi_async.b.bits.resp := blackbox.io.axi0_bresp + axi_async.b.valid := blackbox.io.axi0_bvalid + + //slave AXI interface read address ports + blackbox.io.axi0_arid := axi_async.ar.bits.id + blackbox.io.axi0_araddr := araddr + blackbox.io.axi0_arlen := axi_async.ar.bits.len + blackbox.io.axi0_arsize := axi_async.ar.bits.size + blackbox.io.axi0_arburst := axi_async.ar.bits.burst + blackbox.io.axi0_arlock := axi_async.ar.bits.lock + blackbox.io.axi0_arcache := UInt("b0011") + blackbox.io.axi0_arprot := axi_async.ar.bits.prot + blackbox.io.axi0_arvalid := axi_async.ar.valid + axi_async.ar.ready := blackbox.io.axi0_arready + + //slace AXI interface read data ports + blackbox.io.axi0_rready := axi_async.r.ready + axi_async.r.bits.id := blackbox.io.axi0_rid + axi_async.r.bits.data := blackbox.io.axi0_rdata + axi_async.r.bits.resp := blackbox.io.axi0_rresp + axi_async.r.bits.last := blackbox.io.axi0_rlast + axi_async.r.valid := blackbox.io.axi0_rvalid + + //misc + //blackbox.io.AXI0_AWUSERTAG := UInt("b0000") + blackbox.io.SYS_RESET_N :=io.port.SYS_RESET_N + blackbox.io.PLL_REF_CLK :=io.port.PLL_REF_CLK + + io.port.SYS_CLK := blackbox.io.SYS_CLK + io.port.RESET_N := blackbox.io.RESET_N + io.port.PLL_LOCK := blackbox.io.PLL_LOCK + } +} + +class PolarFireEvalKitDDR4(c : PolarFireEvalKitDDR4Params)(implicit p: Parameters) extends LazyModule { + val ranges = AddressRange.fromSets(c.address) + val depth = ranges.head.size + + val buffer = LazyModule(new TLBuffer) + val toaxi4 = LazyModule(new TLToAXI4(adapterName = Some("mem"), stripBits = 1)) + val indexer = LazyModule(new AXI4IdIndexer(idBits = 4)) + val deint = LazyModule(new AXI4Deinterleaver(p(CacheBlockBytes))) + val yank = LazyModule(new AXI4UserYanker) + val island = LazyModule(new PolarFireEvalKitDDR4Island(c)) + + val node: TLInwardNode = + island.crossAXI4In(island.node) := yank.node := deint.node := indexer.node := toaxi4.node := buffer.node + + lazy val module = new LazyModuleImp(this) { + val io = IO(new Bundle { + val port = new PolarFireEvalKitDDR4IO(depth) + }) + + io.port <> island.module.io.port + + // Shove the island + island.module.clock := io.port.SYS_CLK + island.module.reset := !io.port.CTRLR_READY + } +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/devices/microsemi/polarfire_ddr4/MicrosemiPolarFireDDR4Periphery.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/devices/microsemi/polarfire_ddr4/MicrosemiPolarFireDDR4Periphery.scala new file mode 100644 index 0000000..6a95c4c --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/devices/microsemi/polarfire_ddr4/MicrosemiPolarFireDDR4Periphery.scala @@ -0,0 +1,37 @@ +// See LICENSE for license details. +package sifive.fpgashells.devices.microsemi.polarfireddr4 + +import Chisel._ +import freechips.rocketchip.config._ +//import freechips.rocketchip.coreplex.HasMemoryBus +import freechips.rocketchip.subsystem.BaseSubsystem +import freechips.rocketchip.diplomacy.{LazyModule, LazyModuleImp, AddressRange} + +case object MemoryMicrosemiDDR4Key extends Field[PolarFireEvalKitDDR4Params] + +//trait HasMemoryPolarFireEvalKitDDR4 extends HasMemoryBus { +trait HasMemoryPolarFireEvalKitDDR4 { this: BaseSubsystem => + val module: HasMemoryPolarFireEvalKitDDR4ModuleImp + + val polarfireddrsubsys = LazyModule(new PolarFireEvalKitDDR4(p(MemoryMicrosemiDDR4Key))) + + polarfireddrsubsys.node := mbus.toDRAMController(Some("PolarFireDDR"))() +} + +trait HasMemoryPolarFireEvalKitDDR4Bundle { + val polarfireddrsubsys: PolarFireEvalKitDDR4IO + def connectPolarFireEValKitDDR4ToPads(pads: PolarFireEvalKitDDR4Pads) { + pads <> polarfireddrsubsys + } +} + +trait HasMemoryPolarFireEvalKitDDR4ModuleImp extends LazyModuleImp + with HasMemoryPolarFireEvalKitDDR4Bundle { + val outer: HasMemoryPolarFireEvalKitDDR4 + val ranges = AddressRange.fromSets(p(MemoryMicrosemiDDR4Key).address) + require (ranges.size == 1, "DDR range must be contiguous") + val depth = ranges.head.size + val polarfireddrsubsys = IO(new PolarFireEvalKitDDR4IO(depth)) + + polarfireddrsubsys <> outer.polarfireddrsubsys.module.io.port +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/devices/microsemi/polarfire_pcie/PolarFireEvalKitPCIeX4.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/devices/microsemi/polarfire_pcie/PolarFireEvalKitPCIeX4.scala new file mode 100644 index 0000000..2bae837 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/devices/microsemi/polarfire_pcie/PolarFireEvalKitPCIeX4.scala @@ -0,0 +1,75 @@ +// See LICENSE for license details. +package sifive.fpgashells.devices.microsemi.polarfireevalkitpciex4 + +import Chisel._ +import freechips.rocketchip.amba.axi4._ +//import freechips.rocketchip.coreplex.CacheBlockBytes +import freechips.rocketchip.config.Parameters +import freechips.rocketchip.diplomacy._ +import freechips.rocketchip.tilelink._ +import freechips.rocketchip.interrupts._ +import freechips.rocketchip.util._ +import freechips.rocketchip.subsystem.{HasCrossing, CacheBlockBytes} + +import sifive.fpgashells.ip.microsemi.polarfirepcierootport._ + +trait PolarFireEvalKitPCIeRefClk extends Bundle{ +//TODO: bring reference clock connection in here + val REFCLK_rxp = Bool(INPUT) + val REFCLK_rxn = Bool(INPUT) +} + +class PolarFireEvalKitPCIeX4Pads extends Bundle + with PolarFirePCIeIOSerial + with PolarFireEvalKitPCIeRefClk + +class PolarFireEvalKitPCIeX4IO extends Bundle + with PolarFireEvalKitPCIeRefClk + with PolarFirePCIeIOSerial + with PolarFirePCIeIODebug + with PolarFirePCIeIOClocksReset { + val axi_ctl_aresetn = Bool(INPUT) +} + +class PolarFireEvalKitPCIeX4(implicit p: Parameters) extends LazyModule with HasCrossing { + val crossing = SynchronousCrossing() + val axi_to_pcie = LazyModule(new PolarFirePCIeX4) + + val slave: TLInwardNode = + (axi_to_pcie.slave + := AXI4Buffer() + := AXI4UserYanker() + := AXI4Deinterleaver(p(CacheBlockBytes)) + := AXI4IdIndexer(idBits=4) + := TLToAXI4(adapterName = Some("pcie-slave"))) + + val control: TLInwardNode = + (axi_to_pcie.control + := TLToAPB(false) + := TLBuffer() + := TLFragmenter(4, p(CacheBlockBytes))) + + val master: TLOutwardNode = + (TLWidthWidget(8) + := AXI4ToTL() + := AXI4UserYanker(capMaxFlight=Some(8)) + := AXI4Fragmenter() + := AXI4IdIndexer(idBits=2) + := AXI4Buffer() + := axi_to_pcie.master) + + val TLScope = LazyModule(new SimpleLazyModule with LazyScope) + val intnode: IntOutwardNode = IntSyncCrossingSink() := TLScope { + IntSyncCrossingSource(alreadyRegistered = true) := axi_to_pcie.intnode + } + + lazy val module = new LazyModuleImp(this) { + val io = IO(new Bundle { + val port = new PolarFireEvalKitPCIeX4IO + }) + + io.port <> axi_to_pcie.module.io.port + TLScope.module.clock := io.port.PCIE_1_TL_CLK_125MHz + TLScope.module.reset := ResetCatchAndSync(io.port.PCIE_1_TL_CLK_125MHz, reset) + } +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/devices/microsemi/polarfire_pcie/PolarFireEvalKitPCIeX4Periphery.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/devices/microsemi/polarfire_pcie/PolarFireEvalKitPCIeX4Periphery.scala new file mode 100644 index 0000000..4131d35 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/devices/microsemi/polarfire_pcie/PolarFireEvalKitPCIeX4Periphery.scala @@ -0,0 +1,35 @@ +// See LICENSE for license details. +package sifive.fpgashells.devices.microsemi.polarfireevalkitpciex4 + +import Chisel._ +//import freechips.rocketchip.coreplex.{HasInterruptBus, HasSystemBus} +import freechips.rocketchip.diplomacy.{LazyModule, LazyModuleImp, BufferParams} +import freechips.rocketchip.subsystem.BaseSubsystem +import freechips.rocketchip.tilelink._ + +//trait HasSystemPolarFireEvalKitPCIeX4 extends HasSystemBus with HasInterruptBus { +trait HasSystemPolarFireEvalKitPCIeX4 { this: BaseSubsystem => + val pf_eval_kit_pcie = LazyModule(new PolarFireEvalKitPCIeX4) + private val cname = "polarfirepcie" + sbus.coupleFrom(s"master_named_$cname") { _ :=* TLFIFOFixer(TLFIFOFixer.all) :=* pf_eval_kit_pcie.crossTLOut(pf_eval_kit_pcie.master) } + sbus.coupleTo(s"slave_named_$cname") { pf_eval_kit_pcie.crossTLIn(pf_eval_kit_pcie.slave) :*= TLWidthWidget(sbus.beatBytes) :*= _ } + sbus.coupleTo(s"controller_named_$cname") { pf_eval_kit_pcie.crossTLIn(pf_eval_kit_pcie.control) :*= TLWidthWidget(sbus.beatBytes) :*= _ } + ibus.fromSync := pf_eval_kit_pcie.crossIntOut(pf_eval_kit_pcie.intnode) +} + +trait HasSystemPolarFireEvalKitPCIeX4Bundle { + val pf_eval_kit_pcie: PolarFireEvalKitPCIeX4IO + def connectPolarFireEvalKitPCIeX4ToPads(pads: PolarFireEvalKitPCIeX4Pads) { + pads <> pf_eval_kit_pcie + } +} + +trait HasSystemPolarFireEvalKitPCIeX4ModuleImp extends LazyModuleImp + with HasSystemPolarFireEvalKitPCIeX4Bundle { + val outer: HasSystemPolarFireEvalKitPCIeX4 + val pf_eval_kit_pcie = IO(new PolarFireEvalKitPCIeX4IO) + + pf_eval_kit_pcie <> outer.pf_eval_kit_pcie.module.io.port + + outer.pf_eval_kit_pcie.module.clock := outer.pf_eval_kit_pcie.module.io.port.AXI_CLK +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/devices/xilinx/ethernet/ethernet.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/devices/xilinx/ethernet/ethernet.scala new file mode 100644 index 0000000..9bc195a --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/devices/xilinx/ethernet/ethernet.scala @@ -0,0 +1,125 @@ +// See LICENSE for license details. +package sifive.fpgashells.devices.xilinx.ethernet + +import chisel3._ +import chisel3.util._ +import freechips.rocketchip.config.Parameters +import freechips.rocketchip.diplomacy._ +import freechips.rocketchip.tilelink._ +import freechips.rocketchip.amba.axi4._ +import freechips.rocketchip.regmapper._ +import freechips.rocketchip.util._ +import freechips.rocketchip.subsystem.CacheBlockBytes +import sifive.fpgashells.clocks._ +import sifive.fpgashells.shell._ +import sifive.fpgashells.ip.xilinx.xxv_ethernet._ + +class EthernetMACIO extends Bundle { + val pcs = Flipped(new EthernetPCS) +} + +class EtherBeat extends Bundle { + val data = UInt(64.W) + val last = Bool() +} + +abstract class EthernetMAC(busWidthBytes: Int, base: BigInt)(implicit p: Parameters) extends IORegisterRouter( + RegisterRouterParams( + name = "ethernet", + compat = Seq("sifive,ethernet0"), + base = base, + beatBytes = busWidthBytes), + new EthernetMACIO) +{ + lazy val module = new LazyModuleImp(this) { + val mac = Module(new nfmac10g) + port.pcs.tx_d := mac.io.xgmii_txd + port.pcs.tx_c := mac.io.xgmii_txc + mac.io.xgmii_rxd := port.pcs.rx_d + mac.io.xgmii_rxc := port.pcs.rx_c + + mac.io.tx_clk0 := port.pcs.tx_clock + mac.io.rx_clk0 := port.pcs.rx_clock + mac.io.reset := reset // combined with locked to reset MAC RX/TX FSMs + mac.io.tx_dcm_locked := !port.pcs.tx_reset + mac.io.rx_dcm_locked := !port.pcs.rx_reset + mac.io.tx_axis_aresetn := !ResetCatchAndSync(port.pcs.tx_clock, reset.asBool) + mac.io.rx_axis_aresetn := !ResetCatchAndSync(port.pcs.rx_clock, reset.asBool) + + // FIFO interface + val txen = RegInit(false.B) + val rxen = RegInit(false.B) + val loop = RegInit(0.U(3.W)) + val skip = RegInit(false.B) + val last = RegInit(true.B) + val rxQ = Module(new AsyncQueue(new EtherBeat, params=AsyncQueueParams(depth=16))) + val txQ = Module(new AsyncQueue(new EtherBeat, params=AsyncQueueParams(depth=16))) + val txO = withClockAndReset(port.pcs.tx_clock, port.pcs.tx_reset) { Queue(txQ.io.deq, 2) } + val rxI = withClockAndReset(port.pcs.rx_clock, port.pcs.rx_reset) { + val w = Wire(chiselTypeOf(rxQ.io.enq)) + rxQ.io.enq <> Queue(w, 2) + w + } + + // TX AXIS / RX AXIS + rxQ.io.enq_clock := port.pcs.rx_clock + rxQ.io.enq_reset := port.pcs.rx_reset + rxQ.io.deq_clock := clock + rxQ.io.deq_reset := reset + txQ.io.enq_clock := clock + txQ.io.enq_reset := reset + txQ.io.deq_clock := port.pcs.tx_clock + txQ.io.deq_reset := port.pcs.tx_reset + + port.pcs.loopback := loop + + regmap( + 0 -> RegFieldGroup("control", Some("Control Registers"), Seq( + RegField(1, txen, RegFieldDesc("tx_en", "TX Enable", reset=Some(0))), + RegField(1, rxen, RegFieldDesc("rx_en", "RX Enable", reset=Some(0))), + RegField(1), + RegField(1, last, RegFieldDesc("last", "Last frame", reset=Some(1))), + RegField(3, loop, RegFieldDesc("loop", "TX-RX PCS Loopback", reset=Some(0))), + RegField(1, skip, RegFieldDesc("skip", "Bypass RX-TX directly", reset=Some(0))), + RegField(8), + RegField.r(1, txQ.io.enq.ready, RegFieldDesc("tx_ready", "TX Ready")), + RegField.r(1, rxQ.io.deq.valid, RegFieldDesc("rx_valid", "RX Valid")), + RegField.r(1, port.pcs.tx_reset, RegFieldDesc("tx_reset", "TX Reset")), + RegField.r(1, port.pcs.rx_reset, RegFieldDesc("rx_reset", "RX Reset")), + RegField.r(1, mac.io.tx_axis_tready, RegFieldDesc("mac_ready", "MAC Ready")), +// RegField.r(1, port.pcs.rx_lock, RegFieldDesc("rx_lock", "RX Lock")), + RegField.r(1, port.pcs.sfp_detect, RegFieldDesc("sfp_detect", "SFP Detect")))), + 16 -> RegFieldGroup("tx", Some("TX Data Queue"), Seq(RegField.w(64, RegWriteFn((valid, data) => { + txQ.io.enq.valid := valid; + txQ.io.enq.bits.data := data + txQ.io.enq.bits.last := last + txQ.io.enq.ready })))), + 24 -> RegFieldGroup("rx", Some("RX Data Queue"), Seq(RegField.r(64, RegReadFn(ready => { + rxQ.io.deq.ready := ready + (rxQ.io.deq.valid, rxQ.io.deq.bits.data)}))))) // discards last + + val tx_txen = withClockAndReset(port.pcs.tx_clock, port.pcs.tx_reset) { RegNext(RegNext(txen)) } + txO.ready := mac.io.tx_axis_tready && tx_txen + mac.io.tx_axis_tvalid := txO.valid && tx_txen + mac.io.tx_axis_tdata := txO.bits.data + mac.io.tx_axis_tlast := txO.bits.last + mac.io.tx_axis_tkeep := 0xff.U + mac.io.tx_axis_tuser := 0.U + + // rxQ.io ready is ignored; loss of packets can happen + val rx_rxen = withClockAndReset(port.pcs.rx_clock, port.pcs.rx_reset) { RegNext(RegNext(rxen)) } + rxI.valid := mac.io.rx_axis_tvalid && rx_rxen + rxI.bits.data := mac.io.rx_axis_tdata + rxI.bits.last := mac.io.rx_axis_tlast + // ignore tkeep/tuser + + when (withClockAndReset(port.pcs.tx_clock, port.pcs.tx_reset) { RegNext(RegNext(skip)) } ) { + txO.ready := rxI.ready + rxI.valid := txO.valid + rxI.bits := txO.bits + } + } +} + +class TLEthernetMAC(busWidthBytes: Int, c: BigInt)(implicit p: Parameters) + extends EthernetMAC(busWidthBytes, c) with HasTLControlRegMap diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/devices/xilinx/xdma/XDMA.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/devices/xilinx/xdma/XDMA.scala new file mode 100644 index 0000000..d5c4a16 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/devices/xilinx/xdma/XDMA.scala @@ -0,0 +1,52 @@ +// See LICENSE for license details. +package sifive.fpgashells.devices.xilinx.xdma + +import chisel3._ +import freechips.rocketchip.amba.axi4._ +import freechips.rocketchip.config.Parameters +import freechips.rocketchip.diplomacy._ +import freechips.rocketchip.tilelink._ +import freechips.rocketchip.interrupts._ +import freechips.rocketchip.subsystem.{CrossesToOnlyOneClockDomain, CacheBlockBytes} +import sifive.fpgashells.ip.xilinx.xdma._ + +class XDMA(c: XDMAParams)(implicit p: Parameters, val crossing: ClockCrossingType = AsynchronousCrossing(8)) + extends LazyModule with CrossesToOnlyOneClockDomain +{ + val imp = LazyModule(new DiplomaticXDMA(c)) + + val slave: TLInwardNode = + (imp.slave + := AXI4Buffer() + := AXI4UserYanker() + := AXI4Deinterleaver(p(CacheBlockBytes)) + := AXI4IdIndexer(idBits=c.sIDBits) + := TLToAXI4(adapterName = Some("pcie-slave"))) + + val control: TLInwardNode = + (imp.control + := AXI4Buffer() + := AXI4UserYanker(capMaxFlight = Some(2)) + := TLToAXI4() + := TLFragmenter(4, p(CacheBlockBytes), holdFirstDeny = true)) + + val master: TLOutwardNode = + (TLWidthWidget(c.busBytes) + := AXI4ToTL() + := AXI4UserYanker(capMaxFlight=Some(16)) + := AXI4Fragmenter() + := AXI4IdIndexer(idBits=2) + := imp.master) + + val intnode: IntOutwardNode = imp.intnode + + lazy val module = new LazyModuleImp(this) { + val io = IO(new Bundle { + val pads = new XDMAPads(c.lanes) + val clocks = new XDMAClocks + }) + + io.pads <> imp.module.io.pads + io.clocks <> imp.module.io.clocks + } +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/devices/xilinx/xdma/package.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/devices/xilinx/xdma/package.scala new file mode 100644 index 0000000..97df7e0 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/devices/xilinx/xdma/package.scala @@ -0,0 +1,10 @@ +// See LICENSE for license details. +package sifive.fpgashells.devices.xilinx + +package object xdma +{ + type XDMAPads = sifive.fpgashells.ip.xilinx.xdma.XDMAPads + type XDMAClocks = sifive.fpgashells.ip.xilinx.xdma.XDMAClocks + type XDMAParams = sifive.fpgashells.ip.xilinx.xdma.XDMAParams + val XDMAParams = sifive.fpgashells.ip.xilinx.xdma.XDMAParams +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/devices/xilinx/xilinxarty100tmig/XilinxArty100TMIG.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/devices/xilinx/xilinxarty100tmig/XilinxArty100TMIG.scala new file mode 100644 index 0000000..5b72ebf --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/devices/xilinx/xilinxarty100tmig/XilinxArty100TMIG.scala @@ -0,0 +1,171 @@ +// See LICENSE for license details. +package sifive.fpgashells.devices.xilinx.xilinxarty100tmig + +import Chisel._ +import chisel3.experimental.{Analog,attach} +import freechips.rocketchip.amba.axi4._ +import freechips.rocketchip.config.Parameters +import freechips.rocketchip.subsystem._ +import freechips.rocketchip.diplomacy._ +import freechips.rocketchip.tilelink._ +import freechips.rocketchip.interrupts._ +import sifive.fpgashells.ip.xilinx.arty100tmig.{Arty100TMIGIOClocksReset, Arty100TMIGIODDR, arty100tmig} + +case class XilinxArty100TMIGParams( + address : Seq[AddressSet] +) + +class XilinxArty100TMIGPads(depth : BigInt) extends Arty100TMIGIODDR(depth) { + def this(c : XilinxArty100TMIGParams) { + this(AddressRange.fromSets(c.address).head.size) + } +} + +class XilinxArty100TMIGIO(depth : BigInt) extends Arty100TMIGIODDR(depth) with Arty100TMIGIOClocksReset + +class XilinxArty100TMIGIsland(c : XilinxArty100TMIGParams, val crossing: ClockCrossingType = AsynchronousCrossing(8))(implicit p: Parameters) extends LazyModule with CrossesToOnlyOneClockDomain { + val ranges = AddressRange.fromSets(c.address) + require (ranges.size == 1, "DDR range must be contiguous") + val offset = ranges.head.base + val depth = ranges.head.size + require((depth<=0x10000000L),"artymig supports upto 256 MB depth configuraton") + + val device = new MemoryDevice + val node = AXI4SlaveNode(Seq(AXI4SlavePortParameters( + slaves = Seq(AXI4SlaveParameters( + address = c.address, + resources = device.reg, + regionType = RegionType.UNCACHED, + executable = true, + supportsWrite = TransferSizes(1, 64), + supportsRead = TransferSizes(1, 64))), + beatBytes = 8))) + + lazy val module = new LazyRawModuleImp(this) { + val io = IO(new Bundle { + val port = new XilinxArty100TMIGIO(depth) + }) + + childClock := io.port.ui_clk + childReset := io.port.ui_clk_sync_rst + + //MIG black box instantiation + val blackbox = Module(new arty100tmig(depth)) + val (axi_async, _) = node.in(0) + + //pins to top level + + //inouts + attach(io.port.ddr3_dq,blackbox.io.ddr3_dq) + attach(io.port.ddr3_dqs_n,blackbox.io.ddr3_dqs_n) + attach(io.port.ddr3_dqs_p,blackbox.io.ddr3_dqs_p) + + //outputs + io.port.ddr3_addr := blackbox.io.ddr3_addr + io.port.ddr3_ba := blackbox.io.ddr3_ba + io.port.ddr3_ras_n := blackbox.io.ddr3_ras_n + io.port.ddr3_cas_n := blackbox.io.ddr3_cas_n + io.port.ddr3_we_n := blackbox.io.ddr3_we_n + io.port.ddr3_reset_n := blackbox.io.ddr3_reset_n + io.port.ddr3_ck_p := blackbox.io.ddr3_ck_p + io.port.ddr3_ck_n := blackbox.io.ddr3_ck_n + io.port.ddr3_cke := blackbox.io.ddr3_cke + io.port.ddr3_cs_n := blackbox.io.ddr3_cs_n + io.port.ddr3_dm := blackbox.io.ddr3_dm + io.port.ddr3_odt := blackbox.io.ddr3_odt + + //inputs + //NO_BUFFER clock + blackbox.io.sys_clk_i := io.port.sys_clk_i + blackbox.io.clk_ref_i := io.port.clk_ref_i + + io.port.ui_clk := blackbox.io.ui_clk + io.port.ui_clk_sync_rst := blackbox.io.ui_clk_sync_rst + io.port.mmcm_locked := blackbox.io.mmcm_locked + blackbox.io.aresetn := io.port.aresetn + blackbox.io.app_sr_req := Bool(false) + blackbox.io.app_ref_req := Bool(false) + blackbox.io.app_zq_req := Bool(false) + //app_sr_active := unconnected + //app_ref_ack := unconnected + //app_zq_ack := unconnected + + val awaddr = axi_async.aw.bits.addr - UInt(offset) + val araddr = axi_async.ar.bits.addr - UInt(offset) + + //slave AXI interface write address ports + blackbox.io.s_axi_awid := axi_async.aw.bits.id + blackbox.io.s_axi_awaddr := awaddr //truncated + blackbox.io.s_axi_awlen := axi_async.aw.bits.len + blackbox.io.s_axi_awsize := axi_async.aw.bits.size + blackbox.io.s_axi_awburst := axi_async.aw.bits.burst + blackbox.io.s_axi_awlock := axi_async.aw.bits.lock + blackbox.io.s_axi_awcache := UInt("b0011") + blackbox.io.s_axi_awprot := axi_async.aw.bits.prot + blackbox.io.s_axi_awqos := axi_async.aw.bits.qos + blackbox.io.s_axi_awvalid := axi_async.aw.valid + axi_async.aw.ready := blackbox.io.s_axi_awready + + //slave interface write data ports + blackbox.io.s_axi_wdata := axi_async.w.bits.data + blackbox.io.s_axi_wstrb := axi_async.w.bits.strb + blackbox.io.s_axi_wlast := axi_async.w.bits.last + blackbox.io.s_axi_wvalid := axi_async.w.valid + axi_async.w.ready := blackbox.io.s_axi_wready + + //slave interface write response + blackbox.io.s_axi_bready := axi_async.b.ready + axi_async.b.bits.id := blackbox.io.s_axi_bid + axi_async.b.bits.resp := blackbox.io.s_axi_bresp + axi_async.b.valid := blackbox.io.s_axi_bvalid + + //slave AXI interface read address ports + blackbox.io.s_axi_arid := axi_async.ar.bits.id + blackbox.io.s_axi_araddr := araddr // truncated + blackbox.io.s_axi_arlen := axi_async.ar.bits.len + blackbox.io.s_axi_arsize := axi_async.ar.bits.size + blackbox.io.s_axi_arburst := axi_async.ar.bits.burst + blackbox.io.s_axi_arlock := axi_async.ar.bits.lock + blackbox.io.s_axi_arcache := UInt("b0011") + blackbox.io.s_axi_arprot := axi_async.ar.bits.prot + blackbox.io.s_axi_arqos := axi_async.ar.bits.qos + blackbox.io.s_axi_arvalid := axi_async.ar.valid + axi_async.ar.ready := blackbox.io.s_axi_arready + + //slace AXI interface read data ports + blackbox.io.s_axi_rready := axi_async.r.ready + axi_async.r.bits.id := blackbox.io.s_axi_rid + axi_async.r.bits.data := blackbox.io.s_axi_rdata + axi_async.r.bits.resp := blackbox.io.s_axi_rresp + axi_async.r.bits.last := blackbox.io.s_axi_rlast + axi_async.r.valid := blackbox.io.s_axi_rvalid + + //misc + io.port.init_calib_complete := blackbox.io.init_calib_complete + blackbox.io.sys_rst :=io.port.sys_rst + //mig.device_temp :- unconnceted + } +} + +class XilinxArty100TMIG(c : XilinxArty100TMIGParams, crossing: ClockCrossingType = AsynchronousCrossing(8))(implicit p: Parameters) extends LazyModule { + val ranges = AddressRange.fromSets(c.address) + val depth = ranges.head.size + + val buffer = LazyModule(new TLBuffer) + val toaxi4 = LazyModule(new TLToAXI4(adapterName = Some("mem"))) + val indexer = LazyModule(new AXI4IdIndexer(idBits = 4)) + val deint = LazyModule(new AXI4Deinterleaver(p(CacheBlockBytes))) + val yank = LazyModule(new AXI4UserYanker) + val island = LazyModule(new XilinxArty100TMIGIsland(c, crossing)) + + val node: TLInwardNode = + island.crossAXI4In(island.node) := yank.node := deint.node := indexer.node := toaxi4.node := buffer.node + + lazy val module = new LazyModuleImp(this) { + val io = IO(new Bundle { + val port = new XilinxArty100TMIGIO(depth) + }) + + io.port <> island.module.io.port + } +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/devices/xilinx/xilinxvc707mig/XilinxVC707MIG.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/devices/xilinx/xilinxvc707mig/XilinxVC707MIG.scala new file mode 100644 index 0000000..0b287f6 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/devices/xilinx/xilinxvc707mig/XilinxVC707MIG.scala @@ -0,0 +1,170 @@ +// See LICENSE for license details. +package sifive.fpgashells.devices.xilinx.xilinxvc707mig + +import Chisel._ +import chisel3.experimental.{Analog,attach} +import freechips.rocketchip.amba.axi4._ +import freechips.rocketchip.config.Parameters +import freechips.rocketchip.subsystem._ +import freechips.rocketchip.diplomacy._ +import freechips.rocketchip.tilelink._ +import freechips.rocketchip.interrupts._ +import sifive.fpgashells.ip.xilinx.vc707mig.{VC707MIGIOClocksReset, VC707MIGIODDR, vc707mig} + +case class XilinxVC707MIGParams( + address : Seq[AddressSet] +) + +class XilinxVC707MIGPads(depth : BigInt) extends VC707MIGIODDR(depth) { + def this(c : XilinxVC707MIGParams) { + this(AddressRange.fromSets(c.address).head.size) + } +} + +class XilinxVC707MIGIO(depth : BigInt) extends VC707MIGIODDR(depth) with VC707MIGIOClocksReset + +class XilinxVC707MIGIsland(c : XilinxVC707MIGParams, val crossing: ClockCrossingType = AsynchronousCrossing(8))(implicit p: Parameters) extends LazyModule with CrossesToOnlyOneClockDomain { + val ranges = AddressRange.fromSets(c.address) + require (ranges.size == 1, "DDR range must be contiguous") + val offset = ranges.head.base + val depth = ranges.head.size + require((depth<=0x100000000L),"vc707mig supports upto 4GB depth configuraton") + + val device = new MemoryDevice + val node = AXI4SlaveNode(Seq(AXI4SlavePortParameters( + slaves = Seq(AXI4SlaveParameters( + address = c.address, + resources = device.reg, + regionType = RegionType.UNCACHED, + executable = true, + supportsWrite = TransferSizes(1, 128), + supportsRead = TransferSizes(1, 128))), + beatBytes = 8))) + + lazy val module = new LazyRawModuleImp(this) { + val io = IO(new Bundle { + val port = new XilinxVC707MIGIO(depth) + }) + + childClock := io.port.ui_clk + childReset := io.port.ui_clk_sync_rst + + //MIG black box instantiation + val blackbox = Module(new vc707mig(depth)) + val (axi_async, _) = node.in(0) + + //pins to top level + + //inouts + attach(io.port.ddr3_dq,blackbox.io.ddr3_dq) + attach(io.port.ddr3_dqs_n,blackbox.io.ddr3_dqs_n) + attach(io.port.ddr3_dqs_p,blackbox.io.ddr3_dqs_p) + + //outputs + io.port.ddr3_addr := blackbox.io.ddr3_addr + io.port.ddr3_ba := blackbox.io.ddr3_ba + io.port.ddr3_ras_n := blackbox.io.ddr3_ras_n + io.port.ddr3_cas_n := blackbox.io.ddr3_cas_n + io.port.ddr3_we_n := blackbox.io.ddr3_we_n + io.port.ddr3_reset_n := blackbox.io.ddr3_reset_n + io.port.ddr3_ck_p := blackbox.io.ddr3_ck_p + io.port.ddr3_ck_n := blackbox.io.ddr3_ck_n + io.port.ddr3_cke := blackbox.io.ddr3_cke + io.port.ddr3_cs_n := blackbox.io.ddr3_cs_n + io.port.ddr3_dm := blackbox.io.ddr3_dm + io.port.ddr3_odt := blackbox.io.ddr3_odt + + //inputs + //NO_BUFFER clock + blackbox.io.sys_clk_i := io.port.sys_clk_i + + io.port.ui_clk := blackbox.io.ui_clk + io.port.ui_clk_sync_rst := blackbox.io.ui_clk_sync_rst + io.port.mmcm_locked := blackbox.io.mmcm_locked + blackbox.io.aresetn := io.port.aresetn + blackbox.io.app_sr_req := Bool(false) + blackbox.io.app_ref_req := Bool(false) + blackbox.io.app_zq_req := Bool(false) + //app_sr_active := unconnected + //app_ref_ack := unconnected + //app_zq_ack := unconnected + + val awaddr = axi_async.aw.bits.addr - UInt(offset) + val araddr = axi_async.ar.bits.addr - UInt(offset) + + //slave AXI interface write address ports + blackbox.io.s_axi_awid := axi_async.aw.bits.id + blackbox.io.s_axi_awaddr := awaddr //truncated + blackbox.io.s_axi_awlen := axi_async.aw.bits.len + blackbox.io.s_axi_awsize := axi_async.aw.bits.size + blackbox.io.s_axi_awburst := axi_async.aw.bits.burst + blackbox.io.s_axi_awlock := axi_async.aw.bits.lock + blackbox.io.s_axi_awcache := UInt("b0011") + blackbox.io.s_axi_awprot := axi_async.aw.bits.prot + blackbox.io.s_axi_awqos := axi_async.aw.bits.qos + blackbox.io.s_axi_awvalid := axi_async.aw.valid + axi_async.aw.ready := blackbox.io.s_axi_awready + + //slave interface write data ports + blackbox.io.s_axi_wdata := axi_async.w.bits.data + blackbox.io.s_axi_wstrb := axi_async.w.bits.strb + blackbox.io.s_axi_wlast := axi_async.w.bits.last + blackbox.io.s_axi_wvalid := axi_async.w.valid + axi_async.w.ready := blackbox.io.s_axi_wready + + //slave interface write response + blackbox.io.s_axi_bready := axi_async.b.ready + axi_async.b.bits.id := blackbox.io.s_axi_bid + axi_async.b.bits.resp := blackbox.io.s_axi_bresp + axi_async.b.valid := blackbox.io.s_axi_bvalid + + //slave AXI interface read address ports + blackbox.io.s_axi_arid := axi_async.ar.bits.id + blackbox.io.s_axi_araddr := araddr // truncated + blackbox.io.s_axi_arlen := axi_async.ar.bits.len + blackbox.io.s_axi_arsize := axi_async.ar.bits.size + blackbox.io.s_axi_arburst := axi_async.ar.bits.burst + blackbox.io.s_axi_arlock := axi_async.ar.bits.lock + blackbox.io.s_axi_arcache := UInt("b0011") + blackbox.io.s_axi_arprot := axi_async.ar.bits.prot + blackbox.io.s_axi_arqos := axi_async.ar.bits.qos + blackbox.io.s_axi_arvalid := axi_async.ar.valid + axi_async.ar.ready := blackbox.io.s_axi_arready + + //slace AXI interface read data ports + blackbox.io.s_axi_rready := axi_async.r.ready + axi_async.r.bits.id := blackbox.io.s_axi_rid + axi_async.r.bits.data := blackbox.io.s_axi_rdata + axi_async.r.bits.resp := blackbox.io.s_axi_rresp + axi_async.r.bits.last := blackbox.io.s_axi_rlast + axi_async.r.valid := blackbox.io.s_axi_rvalid + + //misc + io.port.init_calib_complete := blackbox.io.init_calib_complete + blackbox.io.sys_rst :=io.port.sys_rst + //mig.device_temp :- unconnceted + } +} + +class XilinxVC707MIG(c : XilinxVC707MIGParams, crossing: ClockCrossingType = AsynchronousCrossing(8))(implicit p: Parameters) extends LazyModule { + val ranges = AddressRange.fromSets(c.address) + val depth = ranges.head.size + + val buffer = LazyModule(new TLBuffer) + val toaxi4 = LazyModule(new TLToAXI4(adapterName = Some("mem"), stripBits = 1)) + val indexer = LazyModule(new AXI4IdIndexer(idBits = 4)) + val deint = LazyModule(new AXI4Deinterleaver(p(CacheBlockBytes))) + val yank = LazyModule(new AXI4UserYanker) + val island = LazyModule(new XilinxVC707MIGIsland(c, crossing)) + + val node: TLInwardNode = + island.crossAXI4In(island.node) := yank.node := deint.node := indexer.node := toaxi4.node := buffer.node + + lazy val module = new LazyModuleImp(this) { + val io = IO(new Bundle { + val port = new XilinxVC707MIGIO(depth) + }) + + io.port <> island.module.io.port + } +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/devices/xilinx/xilinxvc707mig/XilinxVC707MIGPeriphery.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/devices/xilinx/xilinxvc707mig/XilinxVC707MIGPeriphery.scala new file mode 100644 index 0000000..933c986 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/devices/xilinx/xilinxvc707mig/XilinxVC707MIGPeriphery.scala @@ -0,0 +1,35 @@ +// See LICENSE for license details. +package sifive.fpgashells.devices.xilinx.xilinxvc707mig + +import Chisel._ +import freechips.rocketchip.config._ +import freechips.rocketchip.subsystem.BaseSubsystem +import freechips.rocketchip.diplomacy.{LazyModule, LazyModuleImp, AddressRange} + +case object MemoryXilinxDDRKey extends Field[XilinxVC707MIGParams] + +trait HasMemoryXilinxVC707MIG { this: BaseSubsystem => + val module: HasMemoryXilinxVC707MIGModuleImp + + val xilinxvc707mig = LazyModule(new XilinxVC707MIG(p(MemoryXilinxDDRKey))) + + xilinxvc707mig.node := mbus.toDRAMController(Some("xilinxvc707mig"))() +} + +trait HasMemoryXilinxVC707MIGBundle { + val xilinxvc707mig: XilinxVC707MIGIO + def connectXilinxVC707MIGToPads(pads: XilinxVC707MIGPads) { + pads <> xilinxvc707mig + } +} + +trait HasMemoryXilinxVC707MIGModuleImp extends LazyModuleImp + with HasMemoryXilinxVC707MIGBundle { + val outer: HasMemoryXilinxVC707MIG + val ranges = AddressRange.fromSets(p(MemoryXilinxDDRKey).address) + require (ranges.size == 1, "DDR range must be contiguous") + val depth = ranges.head.size + val xilinxvc707mig = IO(new XilinxVC707MIGIO(depth)) + + xilinxvc707mig <> outer.xilinxvc707mig.module.io.port +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/devices/xilinx/xilinxvc707pciex1/XilinxVC707PCIeX1.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/devices/xilinx/xilinxvc707pciex1/XilinxVC707PCIeX1.scala new file mode 100644 index 0000000..851d85e --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/devices/xilinx/xilinxvc707pciex1/XilinxVC707PCIeX1.scala @@ -0,0 +1,76 @@ +// See LICENSE for license details. +package sifive.fpgashells.devices.xilinx.xilinxvc707pciex1 + +import Chisel._ +import freechips.rocketchip.amba.axi4._ +import freechips.rocketchip.config.Parameters +import freechips.rocketchip.diplomacy._ +import freechips.rocketchip.tilelink._ +import freechips.rocketchip.interrupts._ +import freechips.rocketchip.subsystem.{CrossesToOnlyOneClockDomain, CacheBlockBytes} +import sifive.fpgashells.ip.xilinx.vc707axi_to_pcie_x1.{VC707AXIToPCIeX1, VC707AXIToPCIeX1IOClocksReset, VC707AXIToPCIeX1IOSerial} +import sifive.fpgashells.ip.xilinx.ibufds_gte2.IBUFDS_GTE2 + +trait VC707AXIToPCIeRefClk extends Bundle{ + val REFCLK_rxp = Bool(INPUT) + val REFCLK_rxn = Bool(INPUT) +} + +class XilinxVC707PCIeX1Pads extends Bundle + with VC707AXIToPCIeX1IOSerial + with VC707AXIToPCIeRefClk + +class XilinxVC707PCIeX1IO extends Bundle + with VC707AXIToPCIeRefClk + with VC707AXIToPCIeX1IOSerial + with VC707AXIToPCIeX1IOClocksReset { + val axi_ctl_aresetn = Bool(INPUT) +} + +class XilinxVC707PCIeX1(implicit p: Parameters, val crossing: ClockCrossingType = AsynchronousCrossing(8)) + extends LazyModule with CrossesToOnlyOneClockDomain +{ + val axi_to_pcie_x1 = LazyModule(new VC707AXIToPCIeX1) + + val slave: TLInwardNode = + (axi_to_pcie_x1.slave + := AXI4Buffer() + := AXI4UserYanker() + := AXI4Deinterleaver(p(CacheBlockBytes)) + := AXI4IdIndexer(idBits=4) + := TLToAXI4(adapterName = Some("pcie-slave"))) + + val control: TLInwardNode = + (axi_to_pcie_x1.control + := AXI4Buffer() + := AXI4UserYanker(capMaxFlight = Some(2)) + := TLToAXI4() + := TLFragmenter(4, p(CacheBlockBytes), holdFirstDeny = true)) + + val master: TLOutwardNode = + (TLWidthWidget(8) + := AXI4ToTL() + := AXI4UserYanker(capMaxFlight=Some(8)) + := AXI4Fragmenter() + := axi_to_pcie_x1.master) + + val intnode: IntOutwardNode = axi_to_pcie_x1.intnode + + lazy val module = new LazyRawModuleImp(this) { + val io = IO(new Bundle { + val port = new XilinxVC707PCIeX1IO + }) + + childClock := io.port.axi_aclk_out + childReset := ~io.port.axi_aresetn + + io.port <> axi_to_pcie_x1.module.io.port + + //PCIe Reference Clock + val ibufds_gte2 = Module(new IBUFDS_GTE2) + axi_to_pcie_x1.module.io.REFCLK := ibufds_gte2.io.O + ibufds_gte2.io.CEB := UInt(0) + ibufds_gte2.io.I := io.port.REFCLK_rxp + ibufds_gte2.io.IB := io.port.REFCLK_rxn + } +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/devices/xilinx/xilinxvc707pciex1/XilinxVC707PCIeX1Periphery.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/devices/xilinx/xilinxvc707pciex1/XilinxVC707PCIeX1Periphery.scala new file mode 100644 index 0000000..caf570b --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/devices/xilinx/xilinxvc707pciex1/XilinxVC707PCIeX1Periphery.scala @@ -0,0 +1,32 @@ +// See LICENSE for license details. +package sifive.fpgashells.devices.xilinx.xilinxvc707pciex1 + +import Chisel._ +import freechips.rocketchip.diplomacy.{LazyModule, LazyModuleImp, BufferParams} +import freechips.rocketchip.subsystem.BaseSubsystem +import freechips.rocketchip.tilelink._ +import freechips.rocketchip.interrupts.IntSyncCrossingSink + +trait HasSystemXilinxVC707PCIeX1 { this: BaseSubsystem => + val xilinxvc707pcie = LazyModule(new XilinxVC707PCIeX1) + private val cname = "xilinxvc707pcie" + sbus.coupleFrom(s"master_named_$cname") { _ :=* TLFIFOFixer(TLFIFOFixer.all) :=* xilinxvc707pcie.crossTLOut(xilinxvc707pcie.master) } + sbus.coupleTo(s"slave_named_$cname") { xilinxvc707pcie.crossTLIn(xilinxvc707pcie.slave) :*= TLWidthWidget(sbus.beatBytes) :*= _ } + sbus.coupleTo(s"controller_named_$cname") { xilinxvc707pcie.crossTLIn(xilinxvc707pcie.control) :*= TLWidthWidget(sbus.beatBytes) :*= _ } + ibus.fromSync := xilinxvc707pcie.crossIntOut(xilinxvc707pcie.intnode) +} + +trait HasSystemXilinxVC707PCIeX1Bundle { + val xilinxvc707pcie: XilinxVC707PCIeX1IO + def connectXilinxVC707PCIeX1ToPads(pads: XilinxVC707PCIeX1Pads) { + pads <> xilinxvc707pcie + } +} + +trait HasSystemXilinxVC707PCIeX1ModuleImp extends LazyModuleImp + with HasSystemXilinxVC707PCIeX1Bundle { + val outer: HasSystemXilinxVC707PCIeX1 + val xilinxvc707pcie = IO(new XilinxVC707PCIeX1IO) + + xilinxvc707pcie <> outer.xilinxvc707pcie.module.io.port +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/devices/xilinx/xilinxvcu118mig/XilinxVCU118MIG.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/devices/xilinx/xilinxvcu118mig/XilinxVCU118MIG.scala new file mode 100644 index 0000000..9141126 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/devices/xilinx/xilinxvcu118mig/XilinxVCU118MIG.scala @@ -0,0 +1,163 @@ +// See LICENSE for license details. +package sifive.fpgashells.devices.xilinx.xilinxvcu118mig + +import Chisel._ +import chisel3.experimental.{Analog,attach} +import freechips.rocketchip.amba.axi4._ +import freechips.rocketchip.config.Parameters +import freechips.rocketchip.subsystem._ +import freechips.rocketchip.diplomacy._ +import freechips.rocketchip.tilelink._ +import freechips.rocketchip.interrupts._ +import sifive.fpgashells.ip.xilinx.vcu118mig.{VCU118MIGIOClocksReset, VCU118MIGIODDR, vcu118mig} + +case class XilinxVCU118MIGParams( + address : Seq[AddressSet] +) + +class XilinxVCU118MIGPads(depth : BigInt) extends VCU118MIGIODDR(depth) { + def this(c : XilinxVCU118MIGParams) { + this(AddressRange.fromSets(c.address).head.size) + } +} + +class XilinxVCU118MIGIO(depth : BigInt) extends VCU118MIGIODDR(depth) with VCU118MIGIOClocksReset + +class XilinxVCU118MIGIsland(c : XilinxVCU118MIGParams)(implicit p: Parameters) extends LazyModule with CrossesToOnlyOneClockDomain { + val ranges = AddressRange.fromSets(c.address) + require (ranges.size == 1, "DDR range must be contiguous") + val offset = ranges.head.base + val depth = ranges.head.size + val crossing = AsynchronousCrossing(8) + require((depth<=0x80000000L),"vcu118mig supports upto 2GB depth configuraton") + + val device = new MemoryDevice + val node = AXI4SlaveNode(Seq(AXI4SlavePortParameters( + slaves = Seq(AXI4SlaveParameters( + address = c.address, + resources = device.reg, + regionType = RegionType.UNCACHED, + executable = true, + supportsWrite = TransferSizes(1, 256*8), + supportsRead = TransferSizes(1, 256*8))), + beatBytes = 8))) + + lazy val module = new LazyModuleImp(this) { + val io = IO(new Bundle { + val port = new XilinxVCU118MIGIO(depth) + }) + + //MIG black box instantiation + val blackbox = Module(new vcu118mig(depth)) + val (axi_async, _) = node.in(0) + + //pins to top level + + //inouts + attach(io.port.c0_ddr4_dq,blackbox.io.c0_ddr4_dq) + attach(io.port.c0_ddr4_dqs_c,blackbox.io.c0_ddr4_dqs_c) + attach(io.port.c0_ddr4_dqs_t,blackbox.io.c0_ddr4_dqs_t) + attach(io.port.c0_ddr4_dm_dbi_n,blackbox.io.c0_ddr4_dm_dbi_n) + + //outputs + io.port.c0_ddr4_adr := blackbox.io.c0_ddr4_adr + io.port.c0_ddr4_bg := blackbox.io.c0_ddr4_bg + io.port.c0_ddr4_ba := blackbox.io.c0_ddr4_ba + io.port.c0_ddr4_reset_n := blackbox.io.c0_ddr4_reset_n + io.port.c0_ddr4_act_n := blackbox.io.c0_ddr4_act_n + io.port.c0_ddr4_ck_c := blackbox.io.c0_ddr4_ck_c + io.port.c0_ddr4_ck_t := blackbox.io.c0_ddr4_ck_t + io.port.c0_ddr4_cke := blackbox.io.c0_ddr4_cke + io.port.c0_ddr4_cs_n := blackbox.io.c0_ddr4_cs_n + io.port.c0_ddr4_odt := blackbox.io.c0_ddr4_odt + + //inputs + //NO_BUFFER clock + blackbox.io.c0_sys_clk_i := io.port.c0_sys_clk_i + + io.port.c0_ddr4_ui_clk := blackbox.io.c0_ddr4_ui_clk + io.port.c0_ddr4_ui_clk_sync_rst := blackbox.io.c0_ddr4_ui_clk_sync_rst + blackbox.io.c0_ddr4_aresetn := io.port.c0_ddr4_aresetn + + val awaddr = axi_async.aw.bits.addr - UInt(offset) + val araddr = axi_async.ar.bits.addr - UInt(offset) + + //slave AXI interface write address ports + blackbox.io.c0_ddr4_s_axi_awid := axi_async.aw.bits.id + blackbox.io.c0_ddr4_s_axi_awaddr := awaddr //truncated + blackbox.io.c0_ddr4_s_axi_awlen := axi_async.aw.bits.len + blackbox.io.c0_ddr4_s_axi_awsize := axi_async.aw.bits.size + blackbox.io.c0_ddr4_s_axi_awburst := axi_async.aw.bits.burst + blackbox.io.c0_ddr4_s_axi_awlock := axi_async.aw.bits.lock + blackbox.io.c0_ddr4_s_axi_awcache := UInt("b0011") + blackbox.io.c0_ddr4_s_axi_awprot := axi_async.aw.bits.prot + blackbox.io.c0_ddr4_s_axi_awqos := axi_async.aw.bits.qos + blackbox.io.c0_ddr4_s_axi_awvalid := axi_async.aw.valid + axi_async.aw.ready := blackbox.io.c0_ddr4_s_axi_awready + + //slave interface write data ports + blackbox.io.c0_ddr4_s_axi_wdata := axi_async.w.bits.data + blackbox.io.c0_ddr4_s_axi_wstrb := axi_async.w.bits.strb + blackbox.io.c0_ddr4_s_axi_wlast := axi_async.w.bits.last + blackbox.io.c0_ddr4_s_axi_wvalid := axi_async.w.valid + axi_async.w.ready := blackbox.io.c0_ddr4_s_axi_wready + + //slave interface write response + blackbox.io.c0_ddr4_s_axi_bready := axi_async.b.ready + axi_async.b.bits.id := blackbox.io.c0_ddr4_s_axi_bid + axi_async.b.bits.resp := blackbox.io.c0_ddr4_s_axi_bresp + axi_async.b.valid := blackbox.io.c0_ddr4_s_axi_bvalid + + //slave AXI interface read address ports + blackbox.io.c0_ddr4_s_axi_arid := axi_async.ar.bits.id + blackbox.io.c0_ddr4_s_axi_araddr := araddr // truncated + blackbox.io.c0_ddr4_s_axi_arlen := axi_async.ar.bits.len + blackbox.io.c0_ddr4_s_axi_arsize := axi_async.ar.bits.size + blackbox.io.c0_ddr4_s_axi_arburst := axi_async.ar.bits.burst + blackbox.io.c0_ddr4_s_axi_arlock := axi_async.ar.bits.lock + blackbox.io.c0_ddr4_s_axi_arcache := UInt("b0011") + blackbox.io.c0_ddr4_s_axi_arprot := axi_async.ar.bits.prot + blackbox.io.c0_ddr4_s_axi_arqos := axi_async.ar.bits.qos + blackbox.io.c0_ddr4_s_axi_arvalid := axi_async.ar.valid + axi_async.ar.ready := blackbox.io.c0_ddr4_s_axi_arready + + //slace AXI interface read data ports + blackbox.io.c0_ddr4_s_axi_rready := axi_async.r.ready + axi_async.r.bits.id := blackbox.io.c0_ddr4_s_axi_rid + axi_async.r.bits.data := blackbox.io.c0_ddr4_s_axi_rdata + axi_async.r.bits.resp := blackbox.io.c0_ddr4_s_axi_rresp + axi_async.r.bits.last := blackbox.io.c0_ddr4_s_axi_rlast + axi_async.r.valid := blackbox.io.c0_ddr4_s_axi_rvalid + + //misc + io.port.c0_init_calib_complete := blackbox.io.c0_init_calib_complete + blackbox.io.sys_rst :=io.port.sys_rst + } +} + +class XilinxVCU118MIG(c : XilinxVCU118MIGParams)(implicit p: Parameters) extends LazyModule { + val ranges = AddressRange.fromSets(c.address) + val depth = ranges.head.size + + val buffer = LazyModule(new TLBuffer) + val toaxi4 = LazyModule(new TLToAXI4(adapterName = Some("mem"), stripBits = 1)) + val indexer = LazyModule(new AXI4IdIndexer(idBits = 4)) + val deint = LazyModule(new AXI4Deinterleaver(p(CacheBlockBytes))) + val yank = LazyModule(new AXI4UserYanker) + val island = LazyModule(new XilinxVCU118MIGIsland(c)) + + val node: TLInwardNode = + island.crossAXI4In(island.node) := yank.node := deint.node := indexer.node := toaxi4.node := buffer.node + + lazy val module = new LazyModuleImp(this) { + val io = IO(new Bundle { + val port = new XilinxVCU118MIGIO(depth) + }) + + io.port <> island.module.io.port + + // Shove the island + island.module.clock := io.port.c0_ddr4_ui_clk + island.module.reset := io.port.c0_ddr4_ui_clk_sync_rst + } +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/devices/xilinx/xilinxvcu118mig/XilinxVCU118MIGPeriphery.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/devices/xilinx/xilinxvcu118mig/XilinxVCU118MIGPeriphery.scala new file mode 100644 index 0000000..bde5149 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/devices/xilinx/xilinxvcu118mig/XilinxVCU118MIGPeriphery.scala @@ -0,0 +1,35 @@ +// See LICENSE for license details. +package sifive.fpgashells.devices.xilinx.xilinxvcu118mig + +import Chisel._ +import freechips.rocketchip.config._ +import freechips.rocketchip.subsystem.BaseSubsystem +import freechips.rocketchip.diplomacy.{LazyModule, LazyModuleImp, AddressRange} + +case object MemoryXilinxDDRKey extends Field[XilinxVCU118MIGParams] + +trait HasMemoryXilinxVCU118MIG { this: BaseSubsystem => + val module: HasMemoryXilinxVCU118MIGModuleImp + + val xilinxvcu118mig = LazyModule(new XilinxVCU118MIG(p(MemoryXilinxDDRKey))) + + xilinxvcu118mig.node := mbus.toDRAMController(Some("xilinxvcu118mig"))() +} + +trait HasMemoryXilinxVCU118MIGBundle { + val xilinxvcu118mig: XilinxVCU118MIGIO + def connectXilinxVCU118MIGToPads(pads: XilinxVCU118MIGPads) { + pads <> xilinxvcu118mig + } +} + +trait HasMemoryXilinxVCU118MIGModuleImp extends LazyModuleImp + with HasMemoryXilinxVCU118MIGBundle { + val outer: HasMemoryXilinxVCU118MIG + val ranges = AddressRange.fromSets(p(MemoryXilinxDDRKey).address) + require (ranges.size == 1, "DDR range must be contiguous") + val depth = ranges.head.size + val xilinxvcu118mig = IO(new XilinxVCU118MIGIO(depth)) + + xilinxvcu118mig <> outer.xilinxvcu118mig.module.io.port +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/corejtagdebug/corejtagdebug.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/corejtagdebug/corejtagdebug.scala new file mode 100644 index 0000000..3c7feb0 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/corejtagdebug/corejtagdebug.scala @@ -0,0 +1,71 @@ +// See LICENSE for license details. +package sifive.fpgashells.ip.microsemi.corejtagdebug + +import Chisel._ +import chisel3.experimental.{Analog,attach} +import freechips.rocketchip.util.{ElaborationArtefacts} +import freechips.rocketchip.util.GenericParameterizedBundle +import freechips.rocketchip.config._ + +// Black Box for Microsemi DirectCore IP block Actel:DirectCore:COREJTAGDEBUG:2.0.100 + +trait CoreJtagDebugIOJTAGPads extends Bundle { + + val TCK = Clock(INPUT) + val TDI = Bool(INPUT) + val TMS = Bool(INPUT) + val TRSTB = Bool(INPUT) + val TDO = Bool(OUTPUT) +} + +trait CoreJtagDebugIOTarget extends Bundle { + + val TGT_TCK = Clock(OUTPUT) + val TGT_TDI = Bool(OUTPUT) + val TGT_TMS = Bool(OUTPUT) + val TGT_TRST = Bool(OUTPUT) + val TGT_TDO = Bool(INPUT) +} + +//scalastyle:off +//turn off linter: blackbox name must match verilog module +class CoreJtagDebugBlock(implicit val p:Parameters) extends BlackBox +{ + override def desiredName = "corejtagdebug_wrapper" + + val io = new CoreJtagDebugIOJTAGPads with CoreJtagDebugIOTarget { + // chain inputs + val UTDO_IN_0 = Bool(INPUT) + val UTDO_IN_1 = Bool(INPUT) + val UTDO_IN_2 = Bool(INPUT) + val UTDO_IN_3 = Bool(INPUT) + val UTDODRV_0 = Bool(INPUT) + val UTDODRV_1 = Bool(INPUT) + val UTDODRV_2 = Bool(INPUT) + val UTDODRV_3 = Bool(INPUT) + + // chain outputs + val UTDI_OUT = Bool(OUTPUT) + val URSTB_OUT = Bool(OUTPUT) + val UIREG_OUT = Bits(OUTPUT,8) + val UDRUPD_OUT = Bool(OUTPUT) + val UDRSH_OUT = Bool(OUTPUT) + val UDRCK_OUT = Bool(OUTPUT) + val UDRCAP_OUT = Bool(OUTPUT) + } + + ElaborationArtefacts.add( + "Libero.corejtagdebug.tcl", + """ +create_design -id Actel:DirectCore:COREJTAGDEBUG:2.0.100 -design_name {corejtagdebug_wrapper} -config_file {} -params {} -inhibit_configurator 0 +open_smartdesign -design {corejtagdebug_wrapper} +configure_design -component {corejtagdebug_wrapper} -library {} +configure_vlnv_instance -component {corejtagdebug_wrapper} -library {} -name {corejtagdebug_wrapper_0} -params {"IR_CODE:0x55" "ACTIVE_HIGH_TGT_RESET:1"} -validate_rules 0 +fix_vlnv_instance -component {corejtagdebug_wrapper} -library {} -name {corejtagdebug_wrapper_0} +open_smartdesign -design {corejtagdebug_wrapper} +configure_design -component {corejtagdebug_wrapper} -library {} +""" + ) + +} +//scalastyle:on diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire.scala new file mode 100644 index 0000000..edd6aa0 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire.scala @@ -0,0 +1,40 @@ +// See LICENSE for license details. +package sifive.fpgashells.ip.microsemi + +import Chisel._ +import chisel3.{Input, Output} +import chisel3.experimental.{Analog, attach} +import freechips.rocketchip.util.{ElaborationArtefacts} + + +//======================================================================== +// This file contains common devices for Microsemi PolarFire FPGAs. +//======================================================================== + +//------------------------------------------------------------------------- +// Clock network macro +//------------------------------------------------------------------------- + +class CLKBUF() extends BlackBox +{ + val io = new Bundle{ + val PAD = Clock(INPUT) + val Y = Clock(OUTPUT) + } +} + +class CLKINT() extends BlackBox +{ + val io = new Bundle{ + val A = Clock(INPUT) + val Y = Clock(OUTPUT) + } +} + +class ICB_CLKINT() extends BlackBox +{ + val io = new Bundle{ + val A = Clock(INPUT) + val Y = Clock(OUTPUT) + } +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire_ccc/PolarFireCCC.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire_ccc/PolarFireCCC.scala new file mode 100644 index 0000000..a5d6ff3 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire_ccc/PolarFireCCC.scala @@ -0,0 +1,81 @@ +// See LICENSE for license details. +package sifive.fpgashells.ip.microsemi.polarfireccc + +import Chisel._ +import freechips.rocketchip.util.{ElaborationArtefacts} +import freechips.rocketchip.config._ + +import sifive.fpgashells.clocks._ + +case class PolarFireCCCParameters( + name: String, + pll_in_freq: Double = 50, + gl0Enabled: Boolean = false, + gl1Enabled: Boolean = false, + gl2Enabled: Boolean = false, + gl3Enabled: Boolean = false, + gl0_0_out_freq: Double = 111.111, + gl1_0_out_freq: Double = 111.111, + gl2_0_out_freq: Double = 111.111, + gl3_0_out_freq: Double = 111.111, + gl0_0_pll_phase: Double = 0, + gl1_0_pll_phase: Double = 0, + gl2_0_pll_phase: Double = 0, + gl3_0_pll_phase: Double = 0, + feedback: Boolean = false +) + +// Black Box for Microsemi PolarFire Clock Conditioning Circuit (CCC) Actel:SgCore:PF_CCC:1.0.112 +class PolarFireCCCIOPads(c : PLLParameters) extends Bundle { + val REF_CLK_0 = Clock(INPUT) + val OUT0_FABCLK_0 = if (c.req.size >= 1) Some(Clock(OUTPUT)) else None + val OUT1_FABCLK_0 = if (c.req.size >= 2) Some(Clock(OUTPUT)) else None + val OUT2_FABCLK_0 = if (c.req.size >= 3) Some(Clock(OUTPUT)) else None + val OUT3_FABCLK_0 = if (c.req.size >= 4) Some(Clock(OUTPUT)) else None + val PLL_LOCK_0 = Bool(OUTPUT) +} + +//scalastyle:off +//turn off linter: blackbox name must match verilog module +class PolarFireCCC(c : PLLParameters) extends BlackBox with PLLInstance { + val moduleName = c.name + override def desiredName = c.name + + val io = new PolarFireCCCIOPads(c) + def getInput = io.REF_CLK_0 + def getReset = None + def getLocked = io.PLL_LOCK_0 + def getClocks = Seq() ++ io.OUT0_FABCLK_0 ++ io.OUT1_FABCLK_0 ++ + io.OUT2_FABCLK_0 ++ io.OUT3_FABCLK_0 + + def getClockNames = Seq.tabulate (c.req.size) { i => + s"${c.name}/${c.name}_0/pll_inst_0/OUT${i}" + } + + val used = Seq.tabulate(4) { i => + s" GL${i}_0_IS_USED:${i < c.req.size} \\\n" + }.mkString + + val outputs = c.req.zipWithIndex.map { case (req, i) => + s""" GL${i}_0_OUT_FREQ:${req.freqMHz} \\ + | GL${i}_0_PLL_PHASE:${req.phaseDeg} \\ + |""".stripMargin + }.mkString + + // !!! work-around libero bug + // val feedback = if (c.input.feedback) "External" else "Post-VCO" + val feedback = "Post-VCO" + + ElaborationArtefacts.add(s"${moduleName}.libero.tcl", + s"""create_design -id Actel:SgCore:PF_CCC:1.0.115 -design_name {${moduleName}} -config_file {} -params {} -inhibit_configurator 0 + |open_smartdesign -design {${moduleName}} + |configure_design -component {${moduleName}} -library {} + |configure_vlnv_instance -component {${moduleName}} -library {} -name {${moduleName}_0} -validate_rules 0 -params { \\ + | PLL_IN_FREQ_0:${c.input.freqMHz} \\ + | PLL_FEEDBACK_MODE_0:${feedback} \\ + |${used}${outputs}} + |fix_vlnv_instance -component {${moduleName}} -library {} -name {${moduleName}_0} + |open_smartdesign -design {${moduleName}} + |configure_design -component {${moduleName}} -library {} + |""".stripMargin) +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire_clock_divider/PolarFireClockDivider.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire_clock_divider/PolarFireClockDivider.scala new file mode 100644 index 0000000..0dba06b --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire_clock_divider/PolarFireClockDivider.scala @@ -0,0 +1,40 @@ +// See LICENSE for license details. +package sifive.fpgashells.ip.microsemi.polarfireclockdivider + +import Chisel._ +import chisel3.experimental.{Analog,attach} +import freechips.rocketchip.util.{ElaborationArtefacts} +import freechips.rocketchip.util.GenericParameterizedBundle +import freechips.rocketchip.config._ + +// Black Box for Actel:SgCore:PF_CLK_DIV:1.0.101 + +trait PolarFireClockDividerIOPads extends Bundle { + + val CLK_OUT = Clock(OUTPUT) + val CLK_IN = Clock(INPUT) +} + +//scalastyle:off +//turn off linter: blackbox name must match verilog module +class PolarFireClockDivider(implicit val p:Parameters) extends BlackBox +{ + override def desiredName = "pf_clk_divider" + + val io = new PolarFireClockDividerIOPads { + } + + ElaborationArtefacts.add( + "Libero.polarfire_clock_divider.libero.tcl", + """ +create_design -id Actel:SgCore:PF_CLK_DIV:1.0.101 -design_name {pf_clk_divider} -config_file {} -params {} -inhibit_configurator 0 +open_smartdesign -design {pf_clk_divider} +configure_design -component {pf_clk_divider} -library {} +configure_vlnv_instance -component {pf_clk_divider} -library {} -name {pf_clk_divider_0} -params {"DIVIDER:2"} -validate_rules 0 +fix_vlnv_instance -component {pf_clk_divider} -library {} -name {pf_clk_divider_0} +open_smartdesign -design {pf_clk_divider} +configure_design -component {pf_clk_divider} -library {} +""" + ) +} +//scalastyle:on diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire_ddr3/PolarFireDDR3.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire_ddr3/PolarFireDDR3.scala new file mode 100644 index 0000000..e8b2a6a --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire_ddr3/PolarFireDDR3.scala @@ -0,0 +1,129 @@ +// See LICENSE for license details. +package sifive.fpgashells.ip.microsemi.polarfireddr3 + +import Chisel._ +import chisel3.experimental.{Analog,attach} +import freechips.rocketchip.util.{ElaborationArtefacts} +import freechips.rocketchip.util.GenericParameterizedBundle +import freechips.rocketchip.config._ + +// Black Box for Microsemi PolarFire DDR3 controller version 2.1.101 + +class PolarFireEvalKitDDR3IODDR(depth : BigInt) extends GenericParameterizedBundle(depth) { + + val A = Bits(OUTPUT,16) + val BA = Bits(OUTPUT,3) + val RAS_N = Bool(OUTPUT) + val CAS_N = Bool(OUTPUT) + val WE_N = Bool(OUTPUT) + val CTRLR_READY = Bool(OUTPUT) + val SHIELD0 = Bool(OUTPUT) + val SHIELD1 = Bool(OUTPUT) + val CK0 = Bits(OUTPUT,1) + val CK0_N = Bits(OUTPUT,1) + val CKE = Bits(OUTPUT,1) + val CS_N = Bits(OUTPUT,1) + val DM = Bits(OUTPUT,2) + val ODT = Bits(OUTPUT,1) + val RESET_N = Bool(OUTPUT) + + val DQ = Analog(16.W) + val DQS = Analog(2.W) + val DQS_N = Analog(2.W) +} + +trait PolarFireEvalKitDDR3IOClocksReset extends Bundle { + + val SYS_RESET_N = Bool(INPUT) + val PLL_REF_CLK = Clock(INPUT) + + val SYS_CLK = Clock(OUTPUT) + val PLL_LOCK = Bool(OUTPUT) + +} + +//scalastyle:off +//turn off linter: blackbox name must match verilog module +class DDR3_Subsys(depth : BigInt)(implicit val p:Parameters) extends BlackBox +{ + override def desiredName = "pf_ddr" + + val io = new PolarFireEvalKitDDR3IODDR(depth) with PolarFireEvalKitDDR3IOClocksReset { + //axi slave interface + //slave interface write address ports + val axi0_awid = Bits(INPUT,4) + val axi0_awaddr = Bits(INPUT,32) + val axi0_awlen = Bits(INPUT,8) + val axi0_awsize = Bits(INPUT,3) + val axi0_awburst = Bits(INPUT,2) + val axi0_awlock = Bits(INPUT,2) + val axi0_awcache = Bits(INPUT,4) + val axi0_awprot = Bits(INPUT,3) + val axi0_awvalid = Bool(INPUT) + val axi0_awready = Bool(OUTPUT) + //slave interface write data ports + val axi0_wdata = Bits(INPUT,64) + val axi0_wstrb = Bits(INPUT,8) + val axi0_wlast = Bool(INPUT) + val axi0_wvalid = Bool(INPUT) + val axi0_wready = Bool(OUTPUT) + //slave interface write response ports + val axi0_bready = Bool(INPUT) + val axi0_bid = Bits(OUTPUT,4) + val axi0_bresp = Bits(OUTPUT,2) + val axi0_bvalid = Bool(OUTPUT) + //slave interface read address ports + val axi0_arid = Bits(INPUT,4) + val axi0_araddr = Bits(INPUT,32) + val axi0_arlen = Bits(INPUT,8) + val axi0_arsize = Bits(INPUT,3) + val axi0_arburst = Bits(INPUT,2) + val axi0_arlock = Bits(INPUT,2) + val axi0_arcache = Bits(INPUT,4) + val axi0_arprot = Bits(INPUT,3) + val axi0_arvalid = Bool(INPUT) + val axi0_arready = Bool(OUTPUT) + //slave interface read data ports + val axi0_rready = Bool(INPUT) + val axi0_rid = Bits(OUTPUT,4) + val axi0_rdata = Bits(OUTPUT,64) + val axi0_rresp = Bits(OUTPUT,2) + val axi0_rlast = Bool(OUTPUT) + val axi0_rvalid = Bool(OUTPUT) + //misc + val AXI0_AWUSERTAG = Bits(INPUT,4) + val AXI0_BUSERTAG = Bits(OUTPUT,4) + } + + ElaborationArtefacts.add( + "AddIPInstance.polarfire_ddr3.libero.tcl", + """ +create_design -id Actel:SystemBuilder:PF_DDR3:2.2.109 -design_name {pf_ddr} -config_file {} -params {} -inhibit_configurator 0 +open_smartdesign -design pf_ddr +sysbld_configure_page -component pf_ddr -page PF_DDR3_UI -param WIDTH:16 \ + -param CLOCK_DDR:666.666 \ + -param CLOCK_PLL_REFERENCE:111.111 \ + -param CCC_PLL_CLOCK_MULTIPLIER:6 \ + -param ROW_ADDR_WIDTH:16 \ + -param CAS_LATENCY:9 \ + -param RTT_NOM:RZQ6 \ + -param CAS_WRITE_LATENCY:7 \ + -param OUTPUT_DRIVE_STRENGTH:RZQ7 \ + -param TIMING_RAS:36 \ + -param TIMING_RCD:13.5 \ + -param TIMING_RP:13.5 \ + -param TIMING_RC:49.5 \ + -param TIMING_WR:15 \ + -param TIMING_FAW:30 \ + -param TIMING_WTR:5 \ + -param TIMING_RRD:7.5 \ + -param TIMING_RTP:7.5 \ + -param TIMING_RFC:350 \ + -param AXI_ID_WIDTH:6 +save_design -component pf_ddr -library {} -file {} +generate_design -component pf_ddr -library {} -file {} -generator {} -recursive 1 +close_design -component pf_ddr +""" + ) +} +//scalastyle:on diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire_ddr4/PolarFireDDR4.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire_ddr4/PolarFireDDR4.scala new file mode 100644 index 0000000..a4af0e9 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire_ddr4/PolarFireDDR4.scala @@ -0,0 +1,132 @@ +// See LICENSE for license details. +package sifive.fpgashells.ip.microsemi.polarfireddr4 + +import Chisel._ +import chisel3.experimental.{Analog,attach} +import freechips.rocketchip.util.{ElaborationArtefacts} +import freechips.rocketchip.util.GenericParameterizedBundle +import freechips.rocketchip.config._ + +// Black Box + +class PolarFireEvalKitDDR4IODDR(depth : BigInt) extends GenericParameterizedBundle(depth) { + + val A = Bits(OUTPUT,14) + val ACT_N = Bool(OUTPUT) + val BA = Bits(OUTPUT,2) + val BG = Bits(OUTPUT,2) + val RAS_N = Bool(OUTPUT) + val CAS_N = Bool(OUTPUT) + val WE_N = Bool(OUTPUT) + val SHIELD0 = Bool(OUTPUT) + val SHIELD1 = Bool(OUTPUT) + val CK0 = Bits(OUTPUT,1) + val CK0_N = Bits(OUTPUT,1) + val CKE = Bits(OUTPUT,1) + val CS_N = Bits(OUTPUT,1) + val DM_N = Bits(OUTPUT,2) + val ODT = Bits(OUTPUT,1) + + val DQ = Analog(16.W) + val DQS = Analog(2.W) + val DQS_N = Analog(2.W) + + val RESET_N = Bool(OUTPUT) +} + +trait PolarFireEvalKitDDR4IOClocksReset extends Bundle { + + val SYS_RESET_N = Bool(INPUT) + val PLL_REF_CLK = Clock(INPUT) + + val SYS_CLK = Clock(OUTPUT) + val PLL_LOCK = Bool(OUTPUT) + val CTRLR_READY = Bool(OUTPUT) +} + +//scalastyle:off +//turn off linter: blackbox name must match verilog module +class DDR4_Subsys(depth : BigInt)(implicit val p:Parameters) extends BlackBox +{ + override def desiredName = "pf_ddr" + + val io = new PolarFireEvalKitDDR4IODDR(depth) with PolarFireEvalKitDDR4IOClocksReset { + //axi slave interface + //slave interface write address ports + val axi0_awid = Bits(INPUT,6) + val axi0_awaddr = Bits(INPUT,32) + val axi0_awlen = Bits(INPUT,8) + val axi0_awsize = Bits(INPUT,3) + val axi0_awburst = Bits(INPUT,2) + val axi0_awlock = Bits(INPUT,2) + val axi0_awcache = Bits(INPUT,4) + val axi0_awprot = Bits(INPUT,3) + val axi0_awvalid = Bool(INPUT) + val axi0_awready = Bool(OUTPUT) + //slave interface write data ports + val axi0_wdata = Bits(INPUT,64) + val axi0_wstrb = Bits(INPUT,8) + val axi0_wlast = Bool(INPUT) + val axi0_wvalid = Bool(INPUT) + val axi0_wready = Bool(OUTPUT) + //slave interface write response ports + val axi0_bready = Bool(INPUT) + val axi0_bid = Bits(OUTPUT,6) + val axi0_bresp = Bits(OUTPUT,2) + val axi0_bvalid = Bool(OUTPUT) + //slave interface read address ports + val axi0_arid = Bits(INPUT,6) + val axi0_araddr = Bits(INPUT,32) + val axi0_arlen = Bits(INPUT,8) + val axi0_arsize = Bits(INPUT,3) + val axi0_arburst = Bits(INPUT,2) + val axi0_arlock = Bits(INPUT,2) + val axi0_arcache = Bits(INPUT,4) + val axi0_arprot = Bits(INPUT,3) + val axi0_arvalid = Bool(INPUT) + val axi0_arready = Bool(OUTPUT) + //slave interface read data ports + val axi0_rready = Bool(INPUT) + val axi0_rid = Bits(OUTPUT,6) + val axi0_rdata = Bits(OUTPUT,64) + val axi0_rresp = Bits(OUTPUT,2) + val axi0_rlast = Bool(OUTPUT) + val axi0_rvalid = Bool(OUTPUT) + //misc + //val AXI0_AWUSERTAG = Bits(INPUT,4) + //val AXI0_BUSERTAG = Bits(OUTPUT,4) + } + + ElaborationArtefacts.add( + "AddIPInstance.ddr4.libero.tcl", + """ +create_design -id Actel:SystemBuilder:PF_DDR4:2.3.201 -design_name {pf_ddr} -config_file {} -params {} -inhibit_configurator 0 +open_smartdesign -design pf_ddr + +sysbld_configure_page -component pf_ddr -page PF_DDR4_UI -param WIDTH:16 \ + -param MEMCTRLR_INST_NO:0 \ + -param ENABLE_ECC:false \ + -param AXI_WIDTH:64 \ + -param FABRIC_INTERFACE:AXI4 \ + -param CLOCK_DDR:800 \ + -param CLOCK_PLL_REFERENCE:200 \ + -param ROW_ADDR_WIDTH:15 \ + -param CCC_PLL_CLOCK_MULTIPLIER:16 \ + -param RTT_NOM:RZQ6 \ + -param READ_PREAMBLE:1 \ + -param TIMING_RAS:34 \ + -param TIMING_RCD:13.92 \ + -param TIMING_RP:13.92 \ + -param TIMING_RC:47.92 \ + -param TIMING_RFC:350 \ + -param TIMING_FAW:20 \ + -param AXI_ID_WIDTH:6 + +save_design -component pf_ddr -library {} -file {} + +generate_design -component pf_ddr -library {} -file {} -generator {} -recursive 1 + +close_design -component pf_ddr""") + +} +//scalastyle:on diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire_dll/PolarFireDLL.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire_dll/PolarFireDLL.scala new file mode 100644 index 0000000..4a4c0ee --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire_dll/PolarFireDLL.scala @@ -0,0 +1,46 @@ +// See LICENSE for license details. +package sifive.fpgashells.ip.microsemi.polarfiredll + +import Chisel._ +import chisel3.experimental.{Analog,attach} +import freechips.rocketchip.util.{ElaborationArtefacts} +import freechips.rocketchip.util.GenericParameterizedBundle +import freechips.rocketchip.config._ + +// Black Box for Microsemi PolarFire Delay Locked Loop (DLL) Actel:SgCore:PF_CCC:1.0.112 + +class PolarFireDLLIOPads extends Bundle { + + val DLL_FB_CLK = Clock(INPUT) + val DLL_REF_CLK = Clock(INPUT) + val DLL_CLK_0_FABCLK = Clock(OUTPUT) + val DLL_LOCK = Bool(OUTPUT) +} + +//scalastyle:off +//turn off linter: blackbox name must match verilog module +class PolarFireDLL(name: String)(implicit val p:Parameters) extends BlackBox +{ + val modulename = name + override def desiredName = name + + val io = new PolarFireDLLIOPads + + ElaborationArtefacts.add( + "AddIPInstance." ++ modulename ++".libero.tcl", + """ +create_design -id Actel:SgCore:PF_CCC:1.0.115 -design_name {""" ++ modulename ++"""} -config_file {} -params {} -inhibit_configurator 0 +open_smartdesign -design {""" ++ modulename ++"""} +configure_design -component {""" ++ modulename ++"""} -library {} +configure_vlnv_instance -component {""" ++ modulename ++"""} -library {} -name {""" ++ modulename ++"""_0} \ + -params {"DLL_ONLY_EN:true" \ + "DLL_IN:125" \ + "DLL_MODE:INJECTION_REM_MODE" \ + "DLL_CLK_0_FABCLK_EN:true" \ + } -validate_rules 0 +fix_vlnv_instance -component {""" ++ modulename ++"""} -library {} -name {""" ++ modulename ++"""_0} +open_smartdesign -design {""" ++ modulename ++"""} +configure_design -component {""" ++ modulename ++"""} -library {}""" + ) +} +//scalastyle:on diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire_glitchless_mux/PolarFireGlitchlessMux.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire_glitchless_mux/PolarFireGlitchlessMux.scala new file mode 100644 index 0000000..9905780 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire_glitchless_mux/PolarFireGlitchlessMux.scala @@ -0,0 +1,41 @@ +// See LICENSE for license details. +package sifive.fpgashells.ip.microsemi.polarfireglitchlessmux + +import Chisel._ +import chisel3.experimental.{Analog,attach} +import freechips.rocketchip.util.{ElaborationArtefacts} +import freechips.rocketchip.util.GenericParameterizedBundle +import freechips.rocketchip.config._ + +// Black Box forMicrosemi PolarFire glitchless mux Actel:SgCore:PF_NGMUX:1.0.101 + +trait PolarFireGlitchlessMuxIOPads extends Bundle { + + val CLK_OUT = Clock(OUTPUT) + val CLK0 = Clock(INPUT) + val CLK1 = Clock(INPUT) + val SEL = Bool(INPUT) +} + +//scalastyle:off +//turn off linter: blackbox name must match verilog module +class PolarFireGlitchlessMux(implicit val p:Parameters) extends BlackBox +{ + override def desiredName = "pf_glitchless_mux" + + val io = new PolarFireGlitchlessMuxIOPads { + } + + ElaborationArtefacts.add( + "Libero.polarfire_glitchless_mux.libero.tcl", + """ +create_design -id Actel:SgCore:PF_NGMUX:1.0.101 -design_name {pf_glitchless_mux} -config_file {} -params {} -inhibit_configurator 0 +open_smartdesign -design {pf_glitchless_mux} +configure_design -component {pf_glitchless_mux} -library {} +fix_vlnv_instance -component {pf_glitchless_mux} -library {} -name {pf_glitchless_mux_0} +open_smartdesign -design {pf_glitchless_mux} +configure_design -component {pf_glitchless_mux} -library {} +""" + ) +} +//scalastyle:on diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire_init_monitor/PolarFireInitMonitor.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire_init_monitor/PolarFireInitMonitor.scala new file mode 100644 index 0000000..33d1797 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire_init_monitor/PolarFireInitMonitor.scala @@ -0,0 +1,32 @@ +// See LICENSE for license details. +package sifive.fpgashells.ip.microsemi.polarfireinitmonitor + +import Chisel._ +import freechips.rocketchip.util.{ElaborationArtefacts} +import freechips.rocketchip.config._ + +// Black Box for Microsemi PolarFire Clock Conditioning Circuit (CCC) Actel:SgCore:PF_INIT_MONITOR:2.0.103 + +trait PolarFireInitMonitorIOPads { + val DEVICE_INIT_DONE = Bool(OUTPUT) + val FABRIC_POR_N = Bool(OUTPUT) + val PCIE_INIT_DONE = Bool(OUTPUT) + val SRAM_INIT_DONE = Bool(OUTPUT) + val USRAM_INIT_DONE = Bool(OUTPUT) +} + +class PolarFireInitMonitor(implicit val p:Parameters) extends BlackBox +{ + override def desiredName = "polarfire_init_monitor" + + val io = new Bundle with PolarFireInitMonitorIOPads + + ElaborationArtefacts.add(s"${desiredName}.libero.tcl", + s"""create_design -id Actel:SgCore:PF_INIT_MONITOR:2.0.103 -design_name {polarfire_init_monitor} -config_file {} -params {} -inhibit_configurator 0 + |open_smartdesign -design {polarfire_init_monitor} + |configure_design -component {polarfire_init_monitor} -library {} + |fix_vlnv_instance -component {polarfire_init_monitor} -library {} -name {polarfire_init_monitor_0} + |open_smartdesign -design {polarfire_init_monitor} + |configure_design -component {polarfire_init_monitor} -library {} + |""".stripMargin) +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire_oscillator/PolarFireOscillator.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire_oscillator/PolarFireOscillator.scala new file mode 100644 index 0000000..d3c32f7 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire_oscillator/PolarFireOscillator.scala @@ -0,0 +1,37 @@ +// See LICENSE for license details. +package sifive.fpgashells.ip.microsemi.polarfire_oscillator + +import Chisel._ +import chisel3.experimental.{Analog,attach} +import freechips.rocketchip.util.{ElaborationArtefacts} +import freechips.rocketchip.util.GenericParameterizedBundle +import freechips.rocketchip.config._ + +// Black Box for Microsemi PolarFire internal oscillator Actel:SgCore:PF_OSC:1.0.102 + +trait PolarFireOscillatorIOPads extends Bundle { + + val RCOSC_160MHZ_GL = Clock(OUTPUT) +} + +//scalastyle:off +//turn off linter: blackbox name must match verilog module +class PolarFireOscillator(implicit val p:Parameters) extends BlackBox +{ + override def desiredName = "pf_oscillator" + + val io = new PolarFireOscillatorIOPads { + } + + ElaborationArtefacts.add( + "Libero.polarfire_oscillator.libero.tcl", + """ +create_design -id Actel:SgCore:PF_OSC:1.0.102 -design_name {pf_oscillator} -config_file {} -params {} -inhibit_configurator 0 +open_smartdesign -design {pf_oscillator} +configure_design -component {pf_oscillator} -library {} +fix_vlnv_instance -component {pf_oscillator} -library {} -name {pf_oscillator_0} +open_smartdesign -design {pf_oscillator} +configure_design -component {pf_oscillator} -library {} """ + ) +} +//scalastyle:on diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire_pcie_rootport/PolarFirePCIeRootPort.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire_pcie_rootport/PolarFirePCIeRootPort.scala new file mode 100644 index 0000000..24dd7e7 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire_pcie_rootport/PolarFirePCIeRootPort.scala @@ -0,0 +1,608 @@ +// See LICENSE for license details. +package sifive.fpgashells.ip.microsemi.polarfirepcierootport + +import Chisel._ +import freechips.rocketchip.config._ +import freechips.rocketchip.diplomacy._ +import freechips.rocketchip.amba.axi4._ +import freechips.rocketchip.amba.apb._ +import freechips.rocketchip.interrupts._ +import freechips.rocketchip.util.{ElaborationArtefacts} + + +import chisel3.{Input, Output} +import chisel3.experimental.attach + +// Black Box for Microsemi PolarFire PCIe root port + +trait PolarFirePCIeIOSerial extends Bundle { + //serial external pins + val PCIESS_LANE_TXD0_N = Bool(OUTPUT) + val PCIESS_LANE_TXD0_P = Bool(OUTPUT) + val PCIESS_LANE_TXD1_N = Bool(OUTPUT) + val PCIESS_LANE_TXD1_P = Bool(OUTPUT) + val PCIESS_LANE_TXD2_N = Bool(OUTPUT) + val PCIESS_LANE_TXD2_P = Bool(OUTPUT) + val PCIESS_LANE_TXD3_N = Bool(OUTPUT) + val PCIESS_LANE_TXD3_P = Bool(OUTPUT) + + val PCIESS_LANE_RXD0_N = Bool(INPUT) + val PCIESS_LANE_RXD0_P = Bool(INPUT) + val PCIESS_LANE_RXD1_N = Bool(INPUT) + val PCIESS_LANE_RXD1_P = Bool(INPUT) + val PCIESS_LANE_RXD2_N = Bool(INPUT) + val PCIESS_LANE_RXD2_P = Bool(INPUT) + val PCIESS_LANE_RXD3_N = Bool(INPUT) + val PCIESS_LANE_RXD3_P = Bool(INPUT) +} + +trait PolarFirePCIeIOClocksReset extends Bundle { + //clock, reset, control + val APB_S_PCLK = Clock(INPUT) + val APB_S_PRESET_N = Bool(INPUT) + + val AXI_CLK = Clock(INPUT) + val AXI_CLK_STABLE = Bool(INPUT) + + val PCIE_1_TL_CLK_125MHz = Clock(INPUT) + val PCIE_1_TX_BIT_CLK = Clock(INPUT) + val PCIE_1_TX_PLL_REF_CLK = Clock(INPUT) + val PCIE_1_TX_PLL_LOCK = Bool(INPUT) + + val PCIESS_LANE0_CDR_REF_CLK_0 = Clock(INPUT) + val PCIESS_LANE1_CDR_REF_CLK_0 = Clock(INPUT) + val PCIESS_LANE2_CDR_REF_CLK_0 = Clock(INPUT) + val PCIESS_LANE3_CDR_REF_CLK_0 = Clock(INPUT) +} + +trait PolarFirePCIeIODebug extends Bundle { + + val debug_pclk = Output(Clock()) + val debug_preset = Output(Bool()) + val debug_penable = Output(Bool()) + val debug_psel = Output(Bool()) + val debug_paddr2 = Output(Bool()) + val debug_paddr3 = Output(Bool()) +} + +//scalastyle:off +//turn off linter: blackbox name must match verilog module +class polarfire_pcie_rp() extends BlackBox +{ + val io = new Bundle with PolarFirePCIeIOSerial + with PolarFirePCIeIOClocksReset { + + // APB control interface + val APB_S_PADDR = Bits(INPUT,26) + val APB_S_PENABLE = Bool(INPUT) + val APB_S_PSEL = Bool(INPUT) + val APB_S_PWDATA = Bits(INPUT,32) + val APB_S_PWRITE = Bool(INPUT) + val APB_S_PRDATA = Bits(OUTPUT,32) + val APB_S_PREADY = Bool(OUTPUT) + val APB_S_PSLVERR = Bool(OUTPUT) + + //axi slave + val PCIESS_AXI_1_S_ARREADY = Bool(OUTPUT) + val PCIESS_AXI_1_S_AWREADY = Bool(OUTPUT) + val PCIESS_AXI_1_S_BID = Bits(OUTPUT,4) + val PCIESS_AXI_1_S_BRESP = Bits(OUTPUT,2) + val PCIESS_AXI_1_S_BVALID = Bool(OUTPUT) + val PCIESS_AXI_1_S_RDATA = Bits(OUTPUT,64) + val PCIESS_AXI_1_S_RID = Bits(OUTPUT,4) + val PCIESS_AXI_1_S_RLAST = Bool(OUTPUT) + val PCIESS_AXI_1_S_RRESP = Bits(OUTPUT,2) + val PCIESS_AXI_1_S_RVALID = Bool(OUTPUT) + val PCIESS_AXI_1_S_WREADY = Bool(OUTPUT) + + val PCIESS_AXI_1_S_ARADDR = Bits(INPUT,32) + val PCIESS_AXI_1_S_ARBURST = Bits(INPUT,2) + val PCIESS_AXI_1_S_ARID = Bits(INPUT,4) + val PCIESS_AXI_1_S_ARLEN = Bits(INPUT,8) + val PCIESS_AXI_1_S_ARSIZE = Bits(INPUT,2) + val PCIESS_AXI_1_S_ARVALID = Bool(INPUT) + val PCIESS_AXI_1_S_AWADDR = Bits(INPUT,32) + val PCIESS_AXI_1_S_AWBURST = Bits(INPUT,2) + val PCIESS_AXI_1_S_AWID = Bits(INPUT,4) + val PCIESS_AXI_1_S_AWLEN = Bits(INPUT,8) + val PCIESS_AXI_1_S_AWSIZE = Bits(INPUT,2) + val PCIESS_AXI_1_S_AWVALID = Bool(INPUT) + val PCIESS_AXI_1_S_BREADY = Bool(INPUT) + val PCIESS_AXI_1_S_RREADY = Bool(INPUT) + val PCIESS_AXI_1_S_WDATA = Bits(INPUT,64) + val PCIESS_AXI_1_S_WLAST = Bool(INPUT) + val PCIESS_AXI_1_S_WSTRB = Bits(INPUT,8) + val PCIESS_AXI_1_S_WVALID = Bool(INPUT) + + //axi master + val PCIESS_AXI_1_M_ARADDR = Bits(OUTPUT,32) + val PCIESS_AXI_1_M_ARBURST = Bits(OUTPUT,2) + val PCIESS_AXI_1_M_ARID = Bits(OUTPUT,4) + val PCIESS_AXI_1_M_ARLEN = Bits(OUTPUT,8) + val PCIESS_AXI_1_M_ARSIZE = Bits(OUTPUT,2) + val PCIESS_AXI_1_M_ARVALID = Bool(OUTPUT) + val PCIESS_AXI_1_M_AWADDR = Bits(OUTPUT,32) + val PCIESS_AXI_1_M_AWBURST = Bits(OUTPUT,2) + val PCIESS_AXI_1_M_AWID = Bits(OUTPUT,4) + val PCIESS_AXI_1_M_AWLEN = Bits(OUTPUT,8) + val PCIESS_AXI_1_M_AWSIZE = Bits(OUTPUT,2) + val PCIESS_AXI_1_M_AWVALID = Bool(OUTPUT) + val PCIESS_AXI_1_M_BREADY = Bool(OUTPUT) + val PCIESS_AXI_1_M_RREADY = Bool(OUTPUT) + val PCIESS_AXI_1_M_WDATA = Bits(OUTPUT,64) + val PCIESS_AXI_1_M_WLAST = Bool(OUTPUT) + val PCIESS_AXI_1_M_WSTRB = Bits(OUTPUT,8) + val PCIESS_AXI_1_M_WVALID = Bool(OUTPUT) + + val PCIESS_AXI_1_M_ARREADY = Bool(INPUT) + val PCIESS_AXI_1_M_AWREADY = Bool(INPUT) + val PCIESS_AXI_1_M_BID = Bits(INPUT,4) + val PCIESS_AXI_1_M_BRESP = Bits(INPUT,2) + val PCIESS_AXI_1_M_BVALID = Bool(INPUT) + val PCIESS_AXI_1_M_RDATA = Bits(INPUT,64) + val PCIESS_AXI_1_M_RID = Bits(INPUT,4) + val PCIESS_AXI_1_M_RLAST = Bool(INPUT) + val PCIESS_AXI_1_M_RRESP = Bits(INPUT,2) + val PCIESS_AXI_1_M_RVALID = Bool(INPUT) + val PCIESS_AXI_1_M_WREADY = Bool(INPUT) + + // Misc + //val DLL_OUT = Bool(OUTPUT) + val PCIE_1_DLUP_EXIT = Bool(OUTPUT) + val PCIE_1_HOT_RST_EXIT = Bool(OUTPUT) + val PCIE_1_INTERRUPT_OUT = Bool(OUTPUT) + val PCIE_1_L2_EXIT = Bool(OUTPUT) + val PCIE_1_LTSSM = Bits(OUTPUT,5) + val PCIE_1_M_WDERR = Bool(OUTPUT) + val PCIE_1_S_RDERR = Bool(OUTPUT) + + val PCIE_1_INTERRUPT = Bits(INPUT,8) + val PCIE_1_M_RDERR = Bool(INPUT) + val PCIE_1_S_WDERR = Bool(INPUT) + } +} +//scalastyle:off + +class PolarFirePCIeX4(implicit p:Parameters) extends LazyModule +{ + val device = new SimpleDevice("pci", Seq("plda,axi-pcie-root-port-1.00")) { + override def describe(resources: ResourceBindings): Description = { + val Description(name, mapping) = super.describe(resources) + val intc = "pcie_intc" + def ofInt(x: Int) = Seq(ResourceInt(BigInt(x))) + def ofMap(x: Int) = Seq(0, 0, 0, x).flatMap(ofInt) ++ Seq(ResourceReference(intc)) ++ ofInt(x) + val extra = Map( + "#address-cells" -> ofInt(3), + "#size-cells" -> ofInt(2), + "#interrupt-cells" -> ofInt(1), + "device_type" -> Seq(ResourceString("pci")), + "interrupt-map-mask" -> Seq(0, 0, 0, 7).flatMap(ofInt), + "interrupt-map" -> Seq(1, 2, 3, 4).flatMap(ofMap), + "ranges" -> resources("ranges").map{ case Binding(_, ResourceAddress(address, perms)) => + ResourceMapping(address, BigInt(0x02000000) << 64, perms) }, + "interrupt-controller" -> Seq(ResourceMap(labels = Seq(intc), value = Map( + "interrupt-controller" -> Nil, + "#address-cells" -> ofInt(0), + "#interrupt-cells" -> ofInt(1))))) + Description(name, mapping ++ extra) + } + } + + val slave = AXI4SlaveNode(Seq(AXI4SlavePortParameters( + slaves = Seq(AXI4SlaveParameters( + address = List(AddressSet(0x40000000L, 0x1fffffffL),AddressSet(0x2030000000L, 0x0fffffffL)), + resources = Seq(Resource(device, "ranges")), + executable = true, + supportsWrite = TransferSizes(1, 128), + supportsRead = TransferSizes(1, 128))), + beatBytes = 8))) + + val control = APBSlaveNode(Seq(APBSlavePortParameters( + slaves = Seq(APBSlaveParameters( + address = List(AddressSet(0x2000000000L, 0x03ffffffL)), + resources = device.reg("control"), + supportsWrite = TransferSizes(1, 4), + supportsRead = TransferSizes(1, 4))), + beatBytes = 4))) + + + val master = AXI4MasterNode(Seq(AXI4MasterPortParameters( + masters = Seq(AXI4MasterParameters( + name = "PolarFire PCIe", + id = IdRange(0, 16), + aligned = false))))) + + val intnode = IntSourceNode(IntSourcePortSimple(resources = device.int)) + + lazy val module = new LazyModuleImp(this) { + // Must have exactly the right number of idBits + require (slave.edges.in(0).bundle.idBits == 4) + require (master.edges.out(0).bundle.dataBits == 64) + + class PolarFirePCIeX4IOBundle extends Bundle with PolarFirePCIeIOSerial + with PolarFirePCIeIODebug + with PolarFirePCIeIOClocksReset; + + val io = IO(new Bundle { + val port = new PolarFirePCIeX4IOBundle + val REFCLK = Bool(INPUT) + }) + + val blackbox = Module(new polarfire_pcie_rp) + + val (s, _) = slave.in(0) + val (c, _) = control.in(0) + val (m, _) = master.out(0) + val (i, _) = intnode.out(0) + + //to top level + i(0) := blackbox.io.PCIE_1_INTERRUPT_OUT + blackbox.io.APB_S_PCLK := io.port.APB_S_PCLK + blackbox.io.APB_S_PRESET_N := io.port.APB_S_PRESET_N + + blackbox.io.AXI_CLK := io.port.AXI_CLK + blackbox.io.AXI_CLK_STABLE := io.port.AXI_CLK_STABLE + + blackbox.io.PCIE_1_TL_CLK_125MHz := io.port.PCIE_1_TL_CLK_125MHz + blackbox.io.PCIE_1_TX_BIT_CLK := io.port.PCIE_1_TX_BIT_CLK + blackbox.io.PCIE_1_TX_PLL_REF_CLK := io.port.PCIE_1_TX_PLL_REF_CLK + blackbox.io.PCIE_1_TX_PLL_LOCK := io.port.PCIE_1_TX_PLL_LOCK + blackbox.io.PCIESS_LANE0_CDR_REF_CLK_0 := io.port.PCIESS_LANE0_CDR_REF_CLK_0 + blackbox.io.PCIESS_LANE1_CDR_REF_CLK_0 := io.port.PCIESS_LANE1_CDR_REF_CLK_0 + blackbox.io.PCIESS_LANE2_CDR_REF_CLK_0 := io.port.PCIESS_LANE2_CDR_REF_CLK_0 + blackbox.io.PCIESS_LANE3_CDR_REF_CLK_0 := io.port.PCIESS_LANE3_CDR_REF_CLK_0 + + io.port.PCIESS_LANE_TXD0_N := blackbox.io.PCIESS_LANE_TXD0_N + io.port.PCIESS_LANE_TXD0_P := blackbox.io.PCIESS_LANE_TXD0_P + io.port.PCIESS_LANE_TXD1_N := blackbox.io.PCIESS_LANE_TXD1_N + io.port.PCIESS_LANE_TXD1_P := blackbox.io.PCIESS_LANE_TXD1_P + io.port.PCIESS_LANE_TXD2_N := blackbox.io.PCIESS_LANE_TXD2_N + io.port.PCIESS_LANE_TXD2_P := blackbox.io.PCIESS_LANE_TXD2_P + io.port.PCIESS_LANE_TXD3_N := blackbox.io.PCIESS_LANE_TXD3_N + io.port.PCIESS_LANE_TXD3_P := blackbox.io.PCIESS_LANE_TXD3_P + + blackbox.io.PCIESS_LANE_RXD0_N := io.port.PCIESS_LANE_RXD0_N + blackbox.io.PCIESS_LANE_RXD0_P := io.port.PCIESS_LANE_RXD0_P + blackbox.io.PCIESS_LANE_RXD1_N := io.port.PCIESS_LANE_RXD1_N + blackbox.io.PCIESS_LANE_RXD1_P := io.port.PCIESS_LANE_RXD1_P + blackbox.io.PCIESS_LANE_RXD2_N := io.port.PCIESS_LANE_RXD2_N + blackbox.io.PCIESS_LANE_RXD2_P := io.port.PCIESS_LANE_RXD2_P + blackbox.io.PCIESS_LANE_RXD3_N := io.port.PCIESS_LANE_RXD3_N + blackbox.io.PCIESS_LANE_RXD3_P := io.port.PCIESS_LANE_RXD3_P + + //s + //slave interface + blackbox.io.PCIESS_AXI_1_S_AWID := s.aw.bits.id + blackbox.io.PCIESS_AXI_1_S_AWADDR := s.aw.bits.addr + blackbox.io.PCIESS_AXI_1_S_AWLEN := s.aw.bits.len + blackbox.io.PCIESS_AXI_1_S_AWSIZE := s.aw.bits.size + blackbox.io.PCIESS_AXI_1_S_AWBURST := s.aw.bits.burst + blackbox.io.PCIESS_AXI_1_S_AWVALID := s.aw.valid + s.aw.ready := blackbox.io.PCIESS_AXI_1_S_AWREADY + + blackbox.io.PCIESS_AXI_1_S_WDATA := s.w.bits.data + blackbox.io.PCIESS_AXI_1_S_WSTRB := s.w.bits.strb + blackbox.io.PCIESS_AXI_1_S_WLAST := s.w.bits.last + blackbox.io.PCIESS_AXI_1_S_WVALID := s.w.valid + s.w.ready := blackbox.io.PCIESS_AXI_1_S_WREADY + + s.b.bits.id := blackbox.io.PCIESS_AXI_1_S_BID + s.b.bits.resp := blackbox.io.PCIESS_AXI_1_S_BRESP + s.b.valid := blackbox.io.PCIESS_AXI_1_S_BVALID + blackbox.io.PCIESS_AXI_1_S_BREADY := s.b.ready + + blackbox.io.PCIESS_AXI_1_S_ARID := s.ar.bits.id + blackbox.io.PCIESS_AXI_1_S_ARADDR := s.ar.bits.addr + blackbox.io.PCIESS_AXI_1_S_ARLEN := s.ar.bits.len + blackbox.io.PCIESS_AXI_1_S_ARSIZE := s.ar.bits.size + blackbox.io.PCIESS_AXI_1_S_ARBURST := s.ar.bits.burst + blackbox.io.PCIESS_AXI_1_S_ARVALID := s.ar.valid + s.ar.ready := blackbox.io.PCIESS_AXI_1_S_ARREADY + + s.r.bits.id := blackbox.io.PCIESS_AXI_1_S_RID + s.r.bits.data := blackbox.io.PCIESS_AXI_1_S_RDATA + s.r.bits.resp := blackbox.io.PCIESS_AXI_1_S_RRESP + s.r.bits.last := blackbox.io.PCIESS_AXI_1_S_RLAST + s.r.valid := blackbox.io.PCIESS_AXI_1_S_RVALID + blackbox.io.PCIESS_AXI_1_S_RREADY := s.r.ready + + blackbox.io.PCIE_1_INTERRUPT := UInt(0) + blackbox.io.PCIE_1_M_RDERR := Bool(false) + blackbox.io.PCIE_1_S_WDERR := Bool(false) + + //ctl + blackbox.io.APB_S_PADDR := c.paddr + blackbox.io.APB_S_PENABLE := c.penable + blackbox.io.APB_S_PSEL := c.psel + blackbox.io.APB_S_PWDATA := c.pwdata + blackbox.io.APB_S_PWRITE := c.pwrite + c.prdata := blackbox.io.APB_S_PRDATA + c.pready := blackbox.io.APB_S_PREADY + c.pslverr := blackbox.io.APB_S_PSLVERR + + + // debug + io.port.debug_pclk := io.port.APB_S_PCLK + io.port.debug_preset := io.port.APB_S_PRESET_N + io.port.debug_penable := c.penable + io.port.debug_psel := c.psel + io.port.debug_paddr2 := c.paddr(2) + io.port.debug_paddr3 := c.paddr(3) + + //m + m.aw.bits.cache := UInt(0) + m.aw.bits.prot := AXI4Parameters.PROT_PRIVILEDGED + m.aw.bits.qos := UInt(0) + + m.aw.bits.id := blackbox.io.PCIESS_AXI_1_M_AWID + m.aw.bits.addr := blackbox.io.PCIESS_AXI_1_M_AWADDR + m.aw.bits.len := blackbox.io.PCIESS_AXI_1_M_AWLEN + m.aw.bits.size := blackbox.io.PCIESS_AXI_1_M_AWSIZE + m.aw.bits.burst := blackbox.io.PCIESS_AXI_1_M_AWBURST + m.aw.bits.id := blackbox.io.PCIESS_AXI_1_M_AWID + m.aw.valid := blackbox.io.PCIESS_AXI_1_M_AWVALID + blackbox.io.PCIESS_AXI_1_M_AWREADY := m.aw.ready + + m.w.bits.data := blackbox.io.PCIESS_AXI_1_M_WDATA + m.w.bits.strb := blackbox.io.PCIESS_AXI_1_M_WSTRB + m.w.bits.last := blackbox.io.PCIESS_AXI_1_M_WLAST + m.w.valid := blackbox.io.PCIESS_AXI_1_M_WVALID + blackbox.io.PCIESS_AXI_1_M_WREADY := m.w.ready + + blackbox.io.PCIESS_AXI_1_M_BID := m.b.bits.id + blackbox.io.PCIESS_AXI_1_M_BRESP := m.b.bits.resp + blackbox.io.PCIESS_AXI_1_M_BVALID := m.b.valid + m.b.ready := blackbox.io.PCIESS_AXI_1_M_BREADY + + m.ar.bits.cache := UInt(0) + m.ar.bits.prot := AXI4Parameters.PROT_PRIVILEDGED + m.ar.bits.qos := UInt(0) + + m.ar.bits.id := blackbox.io.PCIESS_AXI_1_M_ARID + m.ar.bits.addr := blackbox.io.PCIESS_AXI_1_M_ARADDR + m.ar.bits.len := blackbox.io.PCIESS_AXI_1_M_ARLEN + m.ar.bits.size := blackbox.io.PCIESS_AXI_1_M_ARSIZE + m.ar.bits.burst := blackbox.io.PCIESS_AXI_1_M_ARBURST + m.ar.valid := blackbox.io.PCIESS_AXI_1_M_ARVALID + m.ar.bits.id := blackbox.io.PCIESS_AXI_1_M_ARID + blackbox.io.PCIESS_AXI_1_M_ARREADY := m.ar.ready + + blackbox.io.PCIESS_AXI_1_M_RID := m.r.bits.id + blackbox.io.PCIESS_AXI_1_M_RDATA := m.r.bits.data + blackbox.io.PCIESS_AXI_1_M_RRESP := m.r.bits.resp + blackbox.io.PCIESS_AXI_1_M_RLAST := m.r.bits.last + blackbox.io.PCIESS_AXI_1_M_RVALID := m.r.valid + m.r.ready := blackbox.io.PCIESS_AXI_1_M_RREADY + } + + ElaborationArtefacts.add( + "Libero.polarfire_pcie_root_port.libero.tcl", + """ +new_file -type {SmartDesign} -name polarfire_pcie_rp +add_vlnv_instance -component {polarfire_pcie_rp} -library {} -vendor {Actel} -lib {SgCore} -name {PF_PCIE} -version {2.0.100} -instance_name {PF_PCIE_0} -promote_all 0 -file_name {} +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_IS_CONFIGURED:true"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_SIMULATION_LEVEL:RTL"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIESS_LANE0_IS_USED:true"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIESS_LANE1_IS_USED:false"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIESS_LANE2_IS_USED:false"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIESS_LANE3_IS_USED:false"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_GPSS1_LANE0_IS_USED:false"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_GPSS1_LANE1_IS_USED:false"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_GPSS1_LANE2_IS_USED:false"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_GPSS1_LANE3_IS_USED:false"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PROTOCOL_PRESET_USED:PCIe"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_TX_CLK_DIV_FACTOR:1"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_CONTROLLER_ENABLED:Disabled"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_NUMBER_OF_LANES:x1"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_LANE_RATE:Gen1 (2.5 Gbps)"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_REF_CLK_FREQ:100"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_PORT_TYPE:End Point"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_CDR_REF_CLK_SOURCE:Dedicated"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_CDR_REF_CLK_NUMBER:1"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_CONTROLLER_ENABLED:Enabled"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_NUMBER_OF_LANES:x4"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_LANE_RATE:Gen2 (5.0 Gbps)"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_REF_CLK_FREQ:100"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_PORT_TYPE:Root Port"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_CDR_REF_CLK_SOURCE:Dedicated"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_CDR_REF_CLK_NUMBER:1"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_VENDOR_ID:0x11AA"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_SUB_VENDOR_ID:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_REVISION_ID:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_DEVICE_ID:0x1556"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_SUB_SYSTEM_ID:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_CLASS_CODE:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_VENDOR_ID:0x11AA"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_SUB_VENDOR_ID:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_REVISION_ID:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_DEVICE_ID:0x1556"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_SUB_SYSTEM_ID:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_CLASS_CODE:0x060400"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_BAR_MODE:Custom"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_PHY_REF_CLK_SLOT:Slot"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_INTERRUPTS:INTx"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_DE_EMPHASIS:-3.5 dB"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_EXPOSE_WAKE_SIG:Disabled"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_TRANSMIT_SWING:Full Swing"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_BAR_MODE:Custom"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_PHY_REF_CLK_SLOT:Slot"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_INTERRUPTS:MSI4"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_DE_EMPHASIS:-3.5 dB"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_EXPOSE_WAKE_SIG:Disabled"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_TRANSMIT_SWING:Full Swing"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_NUM_FTS:63"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_L0_ACC_LATENCY:No limit"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_L0_EXIT_LATENCY:64 ns to less than 128 ns"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_L1_ENABLE:Disabled"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_L1_ACC_LATENCY:No limit"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_L1_EXIT_LATENCY:16 us to less than 32 us"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_NUM_FTS:63"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_L0_ACC_LATENCY:No limit"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_L0_EXIT_LATENCY:64 ns to less than 128 ns"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_L1_ENABLE:Disabled"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_L1_ACC_LATENCY:No limit"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_L1_EXIT_LATENCY:16 us to less than 32 us"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_MASTER_TYPE_BAR_0_TABLE:64-bit prefetchable memory"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_MASTER_SIZE_BAR_0_TABLE:4 KB"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_MASTER_TABLE_SIZE_BAR_0_TABLE:4 KB"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_MASTER_SOURCE_ADDRESS_BAR_0_TABLE:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_MASTER_TRANS_ADDRESS_BAR_0_TABLE:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_MASTER_TYPE_BAR_0_TABLE:64-bit prefetchable memory"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_MASTER_SIZE_BAR_0_TABLE:2 GB"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_MASTER_TABLE_SIZE_BAR_0_TABLE:4 KB"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_MASTER_SOURCE_ADDRESS_BAR_0_TABLE:0x100000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_MASTER_TRANS_ADDRESS_BAR_0_TABLE:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_MASTER_TYPE_BAR_1_TABLE:Disabled"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_MASTER_SIZE_BAR_1_TABLE:4 KB"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_MASTER_TABLE_SIZE_BAR_1_TABLE:4 KB"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_MASTER_SOURCE_ADDRESS_BAR_1_TABLE:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_MASTER_TRANS_ADDRESS_BAR_1_TABLE:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_MASTER_TYPE_BAR_1_TABLE:Disabled"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_MASTER_SIZE_BAR_1_TABLE:4 KB"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_MASTER_TABLE_SIZE_BAR_1_TABLE:4 KB"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_MASTER_SOURCE_ADDRESS_BAR_1_TABLE:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_MASTER_TRANS_ADDRESS_BAR_1_TABLE:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_MASTER_TYPE_BAR_2_TABLE:Disabled"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_MASTER_SIZE_BAR_2_TABLE:4 KB"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_MASTER_TABLE_SIZE_BAR_2_TABLE:4 KB"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_MASTER_SOURCE_ADDRESS_BAR_2_TABLE:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_MASTER_TRANS_ADDRESS_BAR_2_TABLE:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_MASTER_TYPE_BAR_2_TABLE:Disabled"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_MASTER_SIZE_BAR_2_TABLE:4 KB"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_MASTER_TABLE_SIZE_BAR_2_TABLE:4 KB"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_MASTER_SOURCE_ADDRESS_BAR_2_TABLE:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_MASTER_TRANS_ADDRESS_BAR_2_TABLE:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_MASTER_TYPE_BAR_3_TABLE:Disabled"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_MASTER_SIZE_BAR_3_TABLE:4 KB"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_MASTER_TABLE_SIZE_BAR_3_TABLE:4 KB"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_MASTER_SOURCE_ADDRESS_BAR_3_TABLE:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_MASTER_TRANS_ADDRESS_BAR_3_TABLE:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_MASTER_TYPE_BAR_3_TABLE:Disabled"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_MASTER_SIZE_BAR_3_TABLE:4 KB"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_MASTER_TABLE_SIZE_BAR_3_TABLE:4 KB"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_MASTER_SOURCE_ADDRESS_BAR_3_TABLE:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_MASTER_TRANS_ADDRESS_BAR_3_TABLE:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_MASTER_TYPE_BAR_4_TABLE:Disabled"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_MASTER_SIZE_BAR_4_TABLE:4 KB"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_MASTER_TABLE_SIZE_BAR_4_TABLE:4 KB"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_MASTER_SOURCE_ADDRESS_BAR_4_TABLE:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_MASTER_TRANS_ADDRESS_BAR_4_TABLE:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_MASTER_TYPE_BAR_4_TABLE:Disabled"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_MASTER_SIZE_BAR_4_TABLE:4 KB"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_MASTER_TABLE_SIZE_BAR_4_TABLE:4 KB"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_MASTER_SOURCE_ADDRESS_BAR_4_TABLE:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_MASTER_TRANS_ADDRESS_BAR_4_TABLE:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_MASTER_TYPE_BAR_5_TABLE:Disabled"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_MASTER_SIZE_BAR_5_TABLE:4 KB"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_MASTER_TABLE_SIZE_BAR_5_TABLE:4 KB"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_MASTER_SOURCE_ADDRESS_BAR_5_TABLE:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_MASTER_TRANS_ADDRESS_BAR_5_TABLE:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_MASTER_TYPE_BAR_5_TABLE:Disabled"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_MASTER_SIZE_BAR_5_TABLE:4 KB"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_MASTER_TABLE_SIZE_BAR_5_TABLE:4 KB"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_MASTER_SOURCE_ADDRESS_BAR_5_TABLE:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_MASTER_TRANS_ADDRESS_BAR_5_TABLE:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_SLAVE_STATE_TABLE_0:Disabled"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_SLAVE_SIZE_TABLE_0:4 KB"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_SLAVE_SOURCE_ADDRESS_TABLE_0:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_SLAVE_TRANS_ADDRESS_TABLE_0:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_SLAVE_STATE_TABLE_0:Enabled"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_SLAVE_SIZE_TABLE_0:256 MB"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_SLAVE_SOURCE_ADDRESS_TABLE_0:0x30000000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_SLAVE_TRANS_ADDRESS_TABLE_0:0x30000000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_SLAVE_STATE_TABLE_1:Disabled"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_SLAVE_SIZE_TABLE_1:4 KB"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_SLAVE_SOURCE_ADDRESS_TABLE_1:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_SLAVE_TRANS_ADDRESS_TABLE_1:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_SLAVE_STATE_TABLE_1:Enabled"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_SLAVE_SIZE_TABLE_1:512 MB"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_SLAVE_SOURCE_ADDRESS_TABLE_1:0x40000000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_SLAVE_TRANS_ADDRESS_TABLE_1:0x40000000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_SLAVE_STATE_TABLE_2:Disabled"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_SLAVE_SIZE_TABLE_2:4 KB"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_SLAVE_SOURCE_ADDRESS_TABLE_2:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_SLAVE_TRANS_ADDRESS_TABLE_2:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_SLAVE_STATE_TABLE_2:Enabled"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_SLAVE_SIZE_TABLE_2:2 GB"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_SLAVE_SOURCE_ADDRESS_TABLE_2:0x80000000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_SLAVE_TRANS_ADDRESS_TABLE_2:0x2080000000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_SLAVE_STATE_TABLE_3:Disabled"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_SLAVE_SIZE_TABLE_3:4 KB"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_SLAVE_SOURCE_ADDRESS_TABLE_3:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_SLAVE_TRANS_ADDRESS_TABLE_3:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_SLAVE_STATE_TABLE_3:Disabled"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_SLAVE_SIZE_TABLE_3:4 KB"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_SLAVE_SOURCE_ADDRESS_TABLE_3:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_SLAVE_TRANS_ADDRESS_TABLE_3:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_SLAVE_STATE_TABLE_4:Disabled"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_SLAVE_SIZE_TABLE_4:4 KB"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_SLAVE_SOURCE_ADDRESS_TABLE_4:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_SLAVE_TRANS_ADDRESS_TABLE_4:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_SLAVE_STATE_TABLE_4:Disabled"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_SLAVE_SIZE_TABLE_4:4 KB"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_SLAVE_SOURCE_ADDRESS_TABLE_4:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_SLAVE_TRANS_ADDRESS_TABLE_4:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_SLAVE_STATE_TABLE_5:Disabled"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_SLAVE_SIZE_TABLE_5:4 KB"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_SLAVE_SOURCE_ADDRESS_TABLE_5:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_SLAVE_TRANS_ADDRESS_TABLE_5:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_SLAVE_STATE_TABLE_5:Disabled"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_SLAVE_SIZE_TABLE_5:4 KB"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_SLAVE_SOURCE_ADDRESS_TABLE_5:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_SLAVE_TRANS_ADDRESS_TABLE_5:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_SLAVE_STATE_TABLE_6:Disabled"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_SLAVE_SIZE_TABLE_6:4 KB"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_SLAVE_SOURCE_ADDRESS_TABLE_6:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_SLAVE_TRANS_ADDRESS_TABLE_6:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_SLAVE_STATE_TABLE_6:Disabled"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_SLAVE_SIZE_TABLE_6:4 KB"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_SLAVE_SOURCE_ADDRESS_TABLE_6:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_SLAVE_TRANS_ADDRESS_TABLE_6:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_SLAVE_STATE_TABLE_7:Disabled"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_SLAVE_SIZE_TABLE_7:4 KB"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_SLAVE_SOURCE_ADDRESS_TABLE_7:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_0_SLAVE_TRANS_ADDRESS_TABLE_7:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_SLAVE_STATE_TABLE_7:Disabled"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_SLAVE_SIZE_TABLE_7:4 KB"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_SLAVE_SOURCE_ADDRESS_TABLE_7:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_PCIE_1_SLAVE_TRANS_ADDRESS_TABLE_7:0x0000"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_EXPOSE_LANE_DRI_PORTS:false"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"UI_EXPOSE_PCIE_APBLINK_PORTS:true"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"SD_EXPORT_HIDDEN_PORTS:false"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"EXPOSE_ALL_DEBUG_PORTS:false"} -validate_rules 0 +configure_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} -params {"XT_ES_DEVICE:true"} -validate_rules 0 +fix_vlnv_instance -component {polarfire_pcie_rp} -library {} -name {PF_PCIE_0} + +promote_pin_to_top -component {polarfire_pcie_rp} -library {} -pin {PF_PCIE_0:AXI_CLK} -pin_create_new {} +promote_pin_to_top -component {polarfire_pcie_rp} -library {} -pin {PF_PCIE_0:AXI_CLK_STABLE} -pin_create_new {} +promote_pin_to_top -component {polarfire_pcie_rp} -library {} -pin {PF_PCIE_0:PCIESS_LANE0_CDR_REF_CLK_0} -pin_create_new {} +promote_pin_to_top -component {polarfire_pcie_rp} -library {} -pin {PF_PCIE_0:PCIESS_LANE1_CDR_REF_CLK_0} -pin_create_new {} +promote_pin_to_top -component {polarfire_pcie_rp} -library {} -pin {PF_PCIE_0:PCIESS_LANE2_CDR_REF_CLK_0} -pin_create_new {} +promote_pin_to_top -component {polarfire_pcie_rp} -library {} -pin {PF_PCIE_0:PCIESS_LANE3_CDR_REF_CLK_0} -pin_create_new {} +promote_pin_to_top -component {polarfire_pcie_rp} -library {} -pin {PF_PCIE_0:PCIE_1_TL_CLK_125MHZ} -pin_create_new {} + +promote_pin_to_top -component {polarfire_pcie_rp} -library {} -pin {PF_PCIE_0:PCIE_1_INTERRUPT} -pin_create_new {} +promote_pin_to_top -component {polarfire_pcie_rp} -library {} -pin {PF_PCIE_0:PCIE_1_S_WDERR} -pin_create_new {} +promote_pin_to_top -component {polarfire_pcie_rp} -library {} -pin {PF_PCIE_0:PCIE_1_M_RDERR} -pin_create_new {} + +promote_pin_to_top -component {polarfire_pcie_rp} -library {} -pin {PF_PCIE_0:PCIE_1_DLUP_EXIT} -pin_create_new {} +promote_pin_to_top -component {polarfire_pcie_rp} -library {} -pin {PF_PCIE_0:PCIE_1_HOT_RST_EXIT} -pin_create_new {} +promote_pin_to_top -component {polarfire_pcie_rp} -library {} -pin {PF_PCIE_0:PCIE_1_INTERRUPT_OUT} -pin_create_new {} +promote_pin_to_top -component {polarfire_pcie_rp} -library {} -pin {PF_PCIE_0:PCIE_1_L2_EXIT} -pin_create_new {} +promote_pin_to_top -component {polarfire_pcie_rp} -library {} -pin {PF_PCIE_0:PCIE_1_LTSSM} -pin_create_new {} +promote_pin_to_top -component {polarfire_pcie_rp} -library {} -pin {PF_PCIE_0:PCIE_1_M_WDERR} -pin_create_new {} +promote_pin_to_top -component {polarfire_pcie_rp} -library {} -pin {PF_PCIE_0:PCIE_1_S_RDERR} -pin_create_new {} + +promote_pin_to_top -component {polarfire_pcie_rp} -library {} -pin {PF_PCIE_0:APB_S_PCLK} -pin_create_new {} +promote_pin_to_top -component {polarfire_pcie_rp} -library {} -pin {PF_PCIE_0:APB_S_PRESET_N} -pin_create_new {} + +promote_pin_to_top -component {polarfire_pcie_rp} -library {} -pin {PF_PCIE_0:AXI_1_SLAVE} -pin_create_new {} +promote_pin_to_top -component {polarfire_pcie_rp} -library {} -pin {PF_PCIE_0:PCIE_APB_SLAVE} -pin_create_new {} +promote_pin_to_top -component {polarfire_pcie_rp} -library {} -pin {PF_PCIE_0:CLKS_FROM_TXPLL_TO_PCIE_1} -pin_create_new {} +promote_pin_to_top -component {polarfire_pcie_rp} -library {} -pin {PF_PCIE_0:AXI_1_MASTER} -pin_create_new {} + +generate_design -component {polarfire_pcie_rp} -library {} -generator {} -recursive 1 +""" + ) + +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire_reset/PolarFireReset.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire_reset/PolarFireReset.scala new file mode 100644 index 0000000..6972075 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire_reset/PolarFireReset.scala @@ -0,0 +1,44 @@ +// See LICENSE for license details. +package sifive.fpgashells.ip.microsemi.polarfirereset + +import Chisel._ +import chisel3.experimental.{Analog,attach} +import freechips.rocketchip.util.{ElaborationArtefacts} +import freechips.rocketchip.util.GenericParameterizedBundle +import freechips.rocketchip.config._ + +// Black Box for Microsemi PolarFire IP block Actel:DirectCore:CORERESET_PF:2.1.100 + +trait PolarFireResetIOPads extends Bundle { + + val CLK = Clock(INPUT) + val EXT_RST_N = Bool(INPUT) + val FF_US_RESTORE = Bool(INPUT) + val INIT_DONE = Bool(INPUT) + val PLL_LOCK = Bool(INPUT) + val SS_BUSY = Bool(INPUT) + val FABRIC_RESET_N = Bool(OUTPUT) +} + +//scalastyle:off +//turn off linter: blackbox name must match verilog module +class PolarFireReset(implicit val p:Parameters) extends BlackBox +{ + override def desiredName = "polarfire_reset" + + val io = new PolarFireResetIOPads { + } + + + ElaborationArtefacts.add( + "Libero.polarfire_reset.libero.tcl", + """ +create_design -id Actel:DirectCore:CORERESET_PF:2.1.100 -design_name {polarfire_reset} -config_file {} -params {} -inhibit_configurator 0 +open_smartdesign -design {polarfire_reset} +configure_design -component {polarfire_reset} -library {} +fix_vlnv_instance -component {polarfire_reset} -library {} -name {polarfire_reset_0} +open_smartdesign -design {polarfire_reset} +configure_design -component {polarfire_reset} -library {}""" + ) +} +//scalastyle:on diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire_tx_pll/PolarFireTxPLL.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire_tx_pll/PolarFireTxPLL.scala new file mode 100644 index 0000000..a8e2079 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire_tx_pll/PolarFireTxPLL.scala @@ -0,0 +1,45 @@ +// See LICENSE for license details. +package sifive.fpgashells.ip.microsemi.polarfiretxpll + +import Chisel._ +import chisel3.experimental.{Analog,attach} +import freechips.rocketchip.util.{ElaborationArtefacts} +import freechips.rocketchip.util.GenericParameterizedBundle +import freechips.rocketchip.config._ + +// Black Box for Microsemi:SgCore:PF_TX_PLL:1.0.109 + +trait PolarFireTxPLLIOPads extends Bundle { + + val REF_CLK = Clock(INPUT) + val BIT_CLK = Clock(OUTPUT) + val CLK_125 = Clock(OUTPUT) + val REF_CLK_TO_LANE = Clock(OUTPUT) + val LOCK = Bool(OUTPUT) + val PLL_LOCK = Bool(OUTPUT) +} + +//scalastyle:off +//turn off linter: blackbox name must match verilog module +class PolarFireTxPLL(implicit val p:Parameters) extends BlackBox +{ + override def desiredName = "transmit_pll" + + val io = new PolarFireTxPLLIOPads { + } + + ElaborationArtefacts.add( + "Libero.polarfire_tx_pll.libero.tcl", + """ +create_design -id Actel:SgCore:PF_TX_PLL:2.0.002 -design_name {transmit_pll} -config_file {} -params {} -inhibit_configurator 0 +open_smartdesign -design {transmit_pll} +configure_design -component {transmit_pll} -library {} +configure_vlnv_instance -component {transmit_pll} -library {} -name {transmit_pll_0} -params {"TxPLL_REF:100" "TxPLL_OUT:2500"} -validate_rules 0 +fix_vlnv_instance -component {transmit_pll} -library {} -name {transmit_pll_0} +open_smartdesign -design {transmit_pll} +configure_design -component {transmit_pll} -library {} +""" + ) + +} +//scalastyle:on diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire_xcvr_refclk/PolarFireTransceiverRefClk.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire_xcvr_refclk/PolarFireTransceiverRefClk.scala new file mode 100644 index 0000000..9b69680 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/ip/microsemi/polarfire_xcvr_refclk/PolarFireTransceiverRefClk.scala @@ -0,0 +1,46 @@ +// See LICENSE for license details. +package sifive.fpgashells.ip.microsemi.polarfirexcvrrefclk + +import Chisel._ +import chisel3.experimental.{Analog,attach} +import freechips.rocketchip.util.{ElaborationArtefacts} +import freechips.rocketchip.util.GenericParameterizedBundle +import freechips.rocketchip.config._ + +// Black Box for Microsemi:SgCore:PF_XCVR_REF_CLK:1.0.103 + +trait PolarFireTransceiverRefClkIOPads extends Bundle { + + val REF_CLK_PAD_P = Bool(INPUT) + val REF_CLK_PAD_N = Bool(INPUT) + val REF_CLK = Clock(OUTPUT) + val FAB_REF_CLK = Clock(OUTPUT) +} + +//scalastyle:off +//turn off linter: blackbox name must match verilog module +class PolarFireTransceiverRefClk(implicit val p:Parameters) extends BlackBox +{ + override def desiredName = "transceiver_refclk" + + val io = new PolarFireTransceiverRefClkIOPads { + } + + ElaborationArtefacts.add( + "Libero.polarfire_xcvr_refclk.libero.tcl", + """ +create_design -id Actel:SgCore:PF_XCVR_REF_CLK:1.0.103 -design_name {transceiver_refclk} -config_file {} -params {} -inhibit_configurator 0 +open_smartdesign -design {transceiver_refclk} +configure_design -component {transceiver_refclk} -library {} +configure_vlnv_instance -component {transceiver_refclk} -library {} -name {transceiver_refclk_0} \ + -params {"ENABLE_FAB_CLK_0:1" \ + } -validate_rules 0 + +fix_vlnv_instance -component {transceiver_refclk} -library {} -name {transceiver_refclk_0} +open_smartdesign -design {transceiver_refclk} +configure_design -component {transceiver_refclk} -library {} +""" + ) + +} +//scalastyle:on diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/ip/xilinx/Unisim.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/ip/xilinx/Unisim.scala new file mode 100644 index 0000000..87e72dc --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/ip/xilinx/Unisim.scala @@ -0,0 +1,370 @@ +// See LICENSE for license details. + +package sifive.fpgashells.ip.xilinx +import Chisel._ +import chisel3.{Input, Output} +import chisel3.experimental.{Analog, attach, StringParam, RawParam, IntParam, DoubleParam} + +import sifive.blocks.devices.pinctrl.{BasePin} + +object booleanToVerilogVectorParam extends (Boolean => RawParam) { + def apply(b : Boolean) : RawParam = if(b) RawParam("1") else RawParam("0") +} + +object booleanToVerilogStringParam extends (Boolean => StringParam) { + def apply(b : Boolean) : StringParam = if(b) StringParam("""TRUE""") else StringParam("""FALSE""") +} + + +/** IBUFDS -- SelectIO Differential Input */ + +class IBUFDS( + CAPACITANCE : String = "DONT_CARE", + DIFF_TERM : Boolean = false, + DQS_BIAS : Boolean = false, + IBUF_DELAY_VALUE : Int = 0, + IBUF_LOW_PWR : Boolean = true, + IFD_DELAY_VALUE : String = "AUTO", + IOSTANDARD : String = "DEFAULT" +) +extends BlackBox( + Map( + "CAPACITANCE" -> StringParam(CAPACITANCE), + "DIFF_TERM" -> booleanToVerilogStringParam(DIFF_TERM), + "DQS_BIAS" -> booleanToVerilogStringParam(DQS_BIAS), + "IBUF_DELAY_VALUE" -> IntParam(IBUF_DELAY_VALUE), + "IBUF_LOW_PWR" -> booleanToVerilogStringParam(IBUF_LOW_PWR), + "IFD_DELAY_VALUE" -> StringParam(IFD_DELAY_VALUE), + "IOSTANDARD" -> StringParam(IOSTANDARD) + ) +) { + val io = IO(new Bundle { + val O = Output(Clock()) + val I = Input(Clock()) + val IB = Input(Clock()) + }) +} + +/** IBUFG -- Clock Input Buffer */ + +class IBUFG extends BlackBox { + val io = IO(new Bundle { + val O = Output(Clock()) + val I = Input(Clock()) + }) +} + +object IBUFG { + def apply (pin: Clock): Clock = { + val pad = Module (new IBUFG()) + pad.io.I := pin + pad.io.O + } +} + +/** IBUF -- Input Buffer */ + +class IBUF extends BlackBox { + val io = IO(new Bundle { + val O = Output(Bool()) + val I = Input(Bool()) + }) +} + +object IBUF { + def apply(pin: Bool): Bool = { + val pad = Module (new IBUF) + pad.io.I := pin + pad.io.O + } +} + +/** IBUFDS_GTE2 -- Differential Signaling Input Buffer */ + +class IBUFDS_GTE2( + CLKCM_CFG : Boolean = true, + CLKRCV_TRST : Boolean = true, + CLKSWING_CFG : Int = 3 +) +extends BlackBox( + Map( + "CLKCM_CFG" -> booleanToVerilogStringParam(CLKCM_CFG), + "CLKRCV_TRST" -> booleanToVerilogStringParam(CLKCM_CFG), + "CLKSWING_CFG" -> IntParam(CLKSWING_CFG) + ) +) { + val io = IO(new Bundle { + val O = Bool(OUTPUT) + val ODIV2 = Bool(OUTPUT) + val CEB = Bool(INPUT) + val I = Bool(INPUT) + val IB = Bool(INPUT) + }) +} + +class IBUFDS_GTE4( + REFCLK_EN_TX_PATH: Int = 0, + REFCLK_HROW_CK_SEL: Int = 0, + REFCLK_ICNTL_RX: Int = 0) + extends BlackBox(Map( + "REFCLK_EN_TX_PATH" -> IntParam(REFCLK_EN_TX_PATH), + "REFCLK_HROW_CK_SEL" -> IntParam(REFCLK_HROW_CK_SEL), + "REFCLK_ICNTL_RX" -> IntParam(REFCLK_ICNTL_RX))) +{ + val io = IO(new Bundle { + val O = Clock(OUTPUT) + val ODIV2 = Clock(OUTPUT) + val CEB = Bool(INPUT) + val I = Clock(INPUT) + val IB = Clock(INPUT) + }) +} + +/** IDDR - 7 Series SelectIO DDR flop */ + +class IDDR( + DDR_CLK_EDGE : String = "OPPOSITE_EDGE", + INIT_Q1 : Boolean = false, + INIT_Q2 : Boolean = false, + IS_C_INVERTED : Boolean = false, + IS_D_INVERTED : Boolean = false, + SRTYPE : String = "SYNC" +) +extends BlackBox( + Map( + "DDR_CLK_EDGE" -> StringParam(DDR_CLK_EDGE), + "INIT_Q1" -> booleanToVerilogVectorParam(INIT_Q1), + "INIT_Q2" -> booleanToVerilogVectorParam(INIT_Q2), + "IS_C_INVERTED" -> booleanToVerilogVectorParam(IS_C_INVERTED), + "IS_D_INVERTED" -> booleanToVerilogVectorParam(IS_D_INVERTED), + "SRTYPE" -> StringParam(SRTYPE) + ) +) { + val io = IO(new Bundle { + val Q1 = Output(Bool()) + val Q2 = Output(Bool()) + val C = Input(Bool()) + val CE = Input(Bool()) + val D = Input(Bool()) + val R = Input(Bool()) + val S = Input(Bool()) + }) +} + +/** IDELAYCTRL - 7 Series SelectIO */ + +class IDELAYCTRL( + sim_device : String = "7SERIES" +) +extends BlackBox( + Map( + "SIM_DEVICE" -> StringParam(sim_device) + ) +) { + val io = IO(new Bundle { + val RDY = Output(Bool()) + val REFCLK = Input(Bool()) + val RST = Input(Bool()) + }) +} + + +/** IDELAYE2 -- 7 Series SelectIO ILogic programmable delay. */ + +class IDELAYE2( + CINVCTRL_SEL : Boolean = false, + DELAY_SRC : String = "IDATAIN", + HIGH_PERFORMANCE_MODE : Boolean = false, + IDELAY_TYPE : String = "FIXED", + IDELAY_VALUE : Int = 0, + IS_C_INVERTED : Boolean = false, + IS_DATAIN_INVERTED : Boolean = false, + IS_IDATAIN_INVERTED : Boolean = false, + PIPE_SEL : Boolean = false, + REFCLK_FREQUENCY : Double = 200.0, + SIGNAL_PATTERN : String = "DATA", + SIM_DELAY_D : Int = 0 +) +extends BlackBox( + Map( + "CINVCTRL_SEL" -> booleanToVerilogStringParam(CINVCTRL_SEL), + "DELAY_SRC" -> StringParam(DELAY_SRC), + "HIGH_PERFORMANCE_MODE" -> booleanToVerilogStringParam(HIGH_PERFORMANCE_MODE), + "IDELAY_TYPE" -> StringParam(IDELAY_TYPE), + "IS_C_INVERTED" -> booleanToVerilogVectorParam(IS_C_INVERTED), + "IS_DATAIN_INVERTED" -> booleanToVerilogVectorParam(IS_DATAIN_INVERTED), + "IS_IDATAIN_INVERTED" -> booleanToVerilogVectorParam(IS_IDATAIN_INVERTED), + "PIPE_SEL" -> booleanToVerilogStringParam(PIPE_SEL), + "REFCLK_FREQUENCY" -> DoubleParam(REFCLK_FREQUENCY), + "SIGNAL_PATTERN" -> StringParam(SIGNAL_PATTERN), + "SIM_DELAY_D" -> IntParam(SIM_DELAY_D) + ) +) { + val io = IO(new Bundle { + val DATAOUT = Output(Bool()) + val CNTVALUEOUT = Output(UInt(5.W)) + val C = Input(Bool()) + val CE = Input(Bool()) + val CINVCTRL = Input(Bool()) + val DATAIN = Input(Bool()) + val IDATAIN = Input(Bool()) + val INC = Input(Bool()) + val LD = Input(Bool()) + val LDPIPEEN = Input(Bool()) + val REGRST = Input(Bool()) + val CNTVALUEIN = Input(UInt(5.W)) + }) +} + +/** IOBUF -- Bidirectional IO Buffer. */ + +//Cannot convert to BlackBox because of line +//val IO = IO(Analog(1.W)) +//is illegal + +class IOBUF extends BlackBox { + + val io = new Bundle { + val O = Output(Bool()) + val IO = Analog(1.W) + val I = Input(Bool()) + val T = Input(Bool()) + } +} + +object IOBUF { + + def apply (pin: Analog, ctrl: BasePin): Bool = { + val pad = Module(new IOBUF()) + pad.io.I := ctrl.o.oval + pad.io.T := ~ctrl.o.oe + ctrl.i.ival := pad.io.O & ctrl.o.ie + attach(pad.io.IO, pin) + pad.io.O & ctrl.o.ie + } + + // Creates an output IOBUF + def apply (pin: Analog, in: Bool): Unit = { + val pad = Module(new IOBUF()) + pad.io.I := in + pad.io.T := false.B + attach(pad.io.IO, pin) + } + + // Creates an input IOBUF + def apply (pin: Analog): Bool = { + val pad = Module(new IOBUF()) + pad.io.I := false.B + pad.io.T := true.B + attach(pad.io.IO, pin) + pad.io.O + } + +} + +/** ODDR - 7 Series SelectIO DDR flop */ + +class ODDR( + DDR_CLK_EDGE : String = "OPPOSITE_EDGE", + INIT : Boolean = false, + IS_C_INVERTED : Boolean = false, + IS_D1_INVERTED : Boolean = false, + IS_D2_INVERTED : Boolean = false, + SRTYPE : String = "SYNC" +) +extends BlackBox( + Map( + "DDR_CLK_EDGE" -> StringParam(DDR_CLK_EDGE), + "INIT" -> booleanToVerilogVectorParam(INIT), + "IS_C_INVERTED" -> booleanToVerilogVectorParam(IS_C_INVERTED), + "IS_D1_INVERTED" -> booleanToVerilogVectorParam(IS_D1_INVERTED), + "IS_D2_INVERTED" -> booleanToVerilogVectorParam(IS_D2_INVERTED), + "SRTYPE" -> StringParam(SRTYPE) + ) +) { + val io = IO(new Bundle { + val Q = Output(Bool()) + val C = Input(Clock()) + val CE = Input(Bool()) + val D1 = Input(Bool()) + val D2 = Input(Bool()) + val R = Input(Bool()) + val S = Input(Bool()) + }) +} + +/** ODELAYE2 -- 7 Series SelectIO OLogic programmable delay. */ + +class ODELAYE2( + CINVCTRL_SEL : Boolean = false, + DELAY_SRC : String = "ODATAIN", + HIGH_PERFORMANCE_MODE : Boolean = false, + IS_C_INVERTED : Boolean = false, + IS_ODATAIN_INVERTED : Boolean = false, + ODELAY_TYPE : String = "FIXED", + ODELAY_VALUE : Int = 0, + PIPE_SEL : Boolean = false, + REFCLK_FREQUENCY : Double = 200.0, + SIGNAL_PATTERN : String = "DATA", + SIM_DELAY_D : Int = 0 +) +extends BlackBox( + Map( + "CINVCTRL_SEL" -> booleanToVerilogStringParam(CINVCTRL_SEL), + "DELAY_SRC" -> StringParam(DELAY_SRC), + "HIGH_PERFORMANCE_MODE" -> booleanToVerilogStringParam(HIGH_PERFORMANCE_MODE), + "IS_C_INVERTED" -> booleanToVerilogVectorParam(IS_C_INVERTED), + "IS_ODATAIN_INVERTED" -> booleanToVerilogVectorParam(IS_ODATAIN_INVERTED), + "ODELAY_TYPE" -> StringParam(ODELAY_TYPE), + "PIPE_SEL" -> booleanToVerilogStringParam(PIPE_SEL), + "REFCLK_FREQUENCY" -> DoubleParam(REFCLK_FREQUENCY), + "SIGNAL_PATTERN" -> StringParam(SIGNAL_PATTERN), + "SIM_DELAY_D" -> IntParam(SIM_DELAY_D) + ) +) { + val io = IO(new Bundle { + val DATAOUT = Output(Bool()) + val CNTVALUEOUT = Output(UInt(5.W)) + val C = Input(Bool()) + val CE = Input(Bool()) + val CINVCTRL = Input(Bool()) + val CLKIN = Input(Bool()) + val INC = Input(Bool()) + val LD = Input(Bool()) + val LDPIPEEN = Input(Bool()) + val ODATAIN = Input(Bool()) + val REGRST = Input(Bool()) + val CNTVALUEIN = Input(UInt(5.W)) + }) +} + +/** PULLUP : can be applied to Input to add a Pullup. */ + +class PULLUP extends BlackBox { + val io = IO(new Bundle { + val O = Analog(1.W) + }) +} + +object PULLUP { + def apply (pin: Analog): Unit = { + val pullup = Module(new PULLUP()) + attach(pullup.io.O, pin) + } +} + +/** KEEPER : can be applied to I/O to hold its last value since driven. */ + +class KEEPER extends BlackBox { + val io = IO(new Bundle { + val O = Analog(1.W) + }) +} + +object KEEPER { + def apply (pin: Analog): Unit = { + val pullup = Module(new KEEPER()) + attach(pullup.io.O, pin) + } +} + diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/ip/xilinx/Xilinx.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/ip/xilinx/Xilinx.scala new file mode 100644 index 0000000..adb2fcc --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/ip/xilinx/Xilinx.scala @@ -0,0 +1,490 @@ +// See LICENSE for license details. +package sifive.fpgashells.ip.xilinx + +import Chisel._ +import chisel3.{Input, Output} +import chisel3.experimental.{Analog, attach} +import freechips.rocketchip.util.{ElaborationArtefacts} + +import sifive.blocks.devices.pinctrl.{BasePin} +import sifive.fpgashells.clocks._ +import freechips.rocketchip.diplomacy.LazyModule + +class JTAGTUNNEL extends BlackBox { + val io = new Bundle { + val jtag_tck = Output(Bool()) + val jtag_tms = Output(Bool()) + val jtag_tdi = Output(Bool()) + val jtag_tdo = Input(Bool()) + val jtag_tdo_en = Input(Bool()) + } + //setInline("JTAGTUNNEL.v", + // s""" + ElaborationArtefacts.add("JTAGTUNNEL.v", + """ + |module JTAGTUNNEL( + | output jtag_tck, + | output jtag_tms, + | output jtag_tdi, + | input jtag_tdo, + | input jtag_tdo_en + |); + | + |parameter USER_CHAIN=4; + |wire CAPTURE; + |wire DRCK; + |wire RESET; + |wire SEL; + |wire SHIFT; + |wire UPDATE; + |wire RUNTEST; + | + |wire jtag_tck; + |reg jtag_tms; + |wire jtag_tdi; + |wire jtag_tdo; + |wire jtag_tdo_en; + |wire TDO; + |wire reset; + |wire start_tck; + |reg [6:0] shiftreg_cnt; + |reg [7:0] counter_neg; + |reg [7:0] counter_pos; + |reg TDI_REG; + | + |BSCANE2 #( + | .JTAG_CHAIN(USER_CHAIN) // Value for USER command. + |) + |BSCANE2_inst ( + | .CAPTURE(CAPTURE), // 1-bit output: CAPTURE output from TAP controller. + | .DRCK(DRCK), // 1-bit output: Gated TCK output. When SEL is asserted, DRCK toggles when CAPTURE or + | // SHIFT are asserted. + | .RESET(RESET), // 1-bit output: Reset output for TAP controller. + | .RUNTEST(RUNTEST), // 1-bit output: Output asserted when TAP controller is in Run Test/Idle state. + | .SEL(SEL), // 1-bit output: USER instruction active output. + | .SHIFT(SHIFT), // 1-bit output: SHIFT output from TAP controller. + | .TCK(TCK), // 1-bit output: Test Clock output. Fabric connection to TAP Clock pin. + | .TDI(TDI), // 1-bit output: Test Data Input (TDI) output from TAP controller. + | .TMS(TMS), // 1-bit output: Test Mode Select output. Fabric connection to TAP. + | .UPDATE(UPDATE), // 1-bit output: UPDATE output from TAP controller + | .TDO(TDO) // 1-bit input: Test Data Output (TDO) input for USER function. + | ); + |// + |BUFGCE BUFGCE_JTAG ( + | .O(jtag_tck), // 1-bit output: Clock output + | .CE(start_tck), // 1-bit input: Clock enable input for I0 + | .I(TCK) // 1-bit input: Primary clock + |); + | + | + |assign start_tck = SEL; + |assign jtag_tdi = TDI; + |assign TDO = jtag_tdo_en ? jtag_tdo : 1'b1; + | + |always@(*) begin + | if (counter_neg == 8'h04) begin + | jtag_tms = TDI_REG; + | end else if (counter_neg == 8'h05) begin + | jtag_tms = 1'b1; + | end else if ((counter_neg == (8'h08 + shiftreg_cnt)) || (counter_neg == (8'h08 + shiftreg_cnt - 8'h01))) begin + | jtag_tms = 1'b1; + | end else begin + | jtag_tms = 1'b0; + | end + |end + | + |always@(posedge TCK) begin + | if (~SHIFT) begin + | shiftreg_cnt <= 7'b0000000; + | end else if ((counter_pos >= 8'h01) && (counter_pos <= 8'h07)) begin + | shiftreg_cnt <= {{TDI, shiftreg_cnt[6:1]}}; + | end else begin + | shiftreg_cnt <= shiftreg_cnt; + | end + |end + | + |always@(posedge TCK) begin + | if (~SHIFT) begin + | TDI_REG <= 1'b0; + | end else if (counter_pos == 8'h00) begin + | TDI_REG <= ~TDI; + | end else begin + | TDI_REG <= TDI_REG; + | end + |end + | + |always@(negedge TCK) begin + | if (~SHIFT) begin + | counter_neg <= 8'b00000000; + | end else begin + | counter_neg <= counter_neg + 1; + | end + |end + | + |always@(posedge TCK) begin + | if (~SHIFT) begin + | counter_pos <= 8'b00000000; + | end else begin + | counter_pos <= counter_pos + 1; + | end + |end + |endmodule + """.stripMargin) +} + +object JTAGTUNNEL { + + def apply (DUT_TCK: Bool, DUT_TMS: Bool, DUT_TDI: Bool, DUT_TDO:Bool, DUT_TDO_en: Bool): Unit = { + val inst_jtag_tunnel = Module(new JTAGTUNNEL()) + DUT_TCK := inst_jtag_tunnel.io.jtag_tck + DUT_TMS := inst_jtag_tunnel.io.jtag_tms + DUT_TDI := inst_jtag_tunnel.io.jtag_tdi + inst_jtag_tunnel.io.jtag_tdo := DUT_TDO + inst_jtag_tunnel.io.jtag_tdo_en := DUT_TDO_en + } +} + +//======================================================================== +// This file contains common devices used by our Xilinx FPGA flows and some +// BlackBox modules used in the Xilinx FPGA flows +//======================================================================== + +//------------------------------------------------------------------------- +// mmcm +//------------------------------------------------------------------------- +/** mmcm: This is generated by the Xilinx IP Generation Scripts */ + +class mmcm extends BlackBox { + val io = new Bundle { + val clk_in1 = Input(Clock()) + val clk_out1 = Output(Clock()) + val clk_out2 = Output(Clock()) + val clk_out3 = Output(Clock()) + val resetn = Input(Bool()) + val locked = Output(Bool()) + } +} + +//------------------------------------------------------------------------- +// reset_sys +//------------------------------------------------------------------------- +/** reset_sys: This is generated by the Xilinx IP Generation Scripts */ + +class reset_sys extends BlackBox { + val io = new Bundle { + val slowest_sync_clk = Input(Clock()) + val ext_reset_in = Input(Bool()) + val aux_reset_in = Input(Bool()) + val mb_debug_sys_rst = Input(Bool()) + val dcm_locked = Input(Bool()) + val mb_reset = Output(Bool()) + val bus_struct_reset = Output(Bool()) + val peripheral_reset = Output(Bool()) + val interconnect_aresetn = Output(Bool()) + val peripheral_aresetn = Output(Bool()) + } +} + +//------------------------------------------------------------------------- +// reset_mig +//------------------------------------------------------------------------- +/** reset_mig: This is generated by the Xilinx IP Generation Scripts */ + +class reset_mig extends BlackBox { + val io = new Bundle { + val slowest_sync_clk = Input(Clock()) + val ext_reset_in = Input(Bool()) + val aux_reset_in = Input(Bool()) + val mb_debug_sys_rst = Input(Bool()) + val dcm_locked = Input(Bool()) + val mb_reset = Output(Bool()) + val bus_struct_reset = Output(Bool()) + val peripheral_reset = Output(Bool()) + val interconnect_aresetn = Output(Bool()) + val peripheral_aresetn = Output(Bool()) + } +} + +//------------------------------------------------------------------------- +// PowerOnResetFPGAOnly +//------------------------------------------------------------------------- +/** PowerOnResetFPGAOnly -- this generates a power_on_reset signal using + * initial blocks. It is synthesizable on FPGA flows only. + */ + +// This is a FPGA-Only construct, which uses +// 'initial' constructions +class PowerOnResetFPGAOnly extends BlackBox { + val io = new Bundle { + val clock = Input(Clock()) + val power_on_reset = Output(Bool()) + } +} + +object PowerOnResetFPGAOnly { + def apply (clk: Clock, name: String): Bool = { + val por = Module(new PowerOnResetFPGAOnly()) + por.suggestName(name) + por.io.clock := clk + por.io.power_on_reset + } + def apply (clk: Clock): Bool = apply(clk, "fpga_power_on") +} + + +//------------------------------------------------------------------------- +// vc707_sys_clock_mmcm +//------------------------------------------------------------------------- +//IP : xilinx mmcm with "NO_BUFFER" input clock +class Series7MMCM(c : PLLParameters) extends BlackBox with PLLInstance { + val io = new Bundle { + val clk_in1 = Clock(INPUT) + val clk_out1 = if (c.req.size >= 1) Some(Clock(OUTPUT)) else None + val clk_out2 = if (c.req.size >= 2) Some(Clock(OUTPUT)) else None + val clk_out3 = if (c.req.size >= 3) Some(Clock(OUTPUT)) else None + val clk_out4 = if (c.req.size >= 4) Some(Clock(OUTPUT)) else None + val clk_out5 = if (c.req.size >= 5) Some(Clock(OUTPUT)) else None + val clk_out6 = if (c.req.size >= 6) Some(Clock(OUTPUT)) else None + val clk_out7 = if (c.req.size >= 7) Some(Clock(OUTPUT)) else None + val reset = Bool(INPUT) + val locked = Bool(OUTPUT) + } + + val moduleName = c.name + override def desiredName = c.name + + def getClocks = Seq() ++ io.clk_out1 ++ io.clk_out2 ++ + io.clk_out3 ++ io.clk_out4 ++ + io.clk_out5 ++ io.clk_out6 ++ + io.clk_out7 + def getInput = io.clk_in1 + def getReset = Some(io.reset) + def getLocked = io.locked + def getClockNames = Seq.tabulate (c.req.size) { i => + s"${c.name}/inst/mmcm_adv_inst/CLKOUT${i}" + } + + val used = Seq.tabulate(7) { i => + s" CONFIG.CLKOUT${i+1}_USED {${i < c.req.size}} \\\n" + }.mkString + + val outputs = c.req.zipWithIndex.map { case (r, i) => + s""" CONFIG.CLKOUT${i+1}_REQUESTED_OUT_FREQ {${r.freqMHz}} \\ + | CONFIG.CLKOUT${i+1}_REQUESTED_PHASE {${r.phaseDeg}} \\ + | CONFIG.CLKOUT${i+1}_REQUESTED_DUTY_CYCLE {${r.dutyCycle}} \\ + |""".stripMargin + }.mkString + + val checks = c.req.zipWithIndex.map { case (r, i) => + val f = if (i == 0) "_F" else "" + val phaseMin = r.phaseDeg - r.phaseErrorDeg + val phaseMax = r.phaseDeg + r.phaseErrorDeg + val freqMin = r.freqMHz * (1 - r.freqErrorPPM / 1000000) + val freqMax = r.freqMHz * (1 + r.freqErrorPPM / 1000000) + s"""set jitter [get_property CONFIG.CLKOUT${i+1}_JITTER [get_ips ${moduleName}]] + |if {$$jitter > ${r.jitterPS}} { + | puts "Output jitter $$jitter ps exceeds required limit of ${r.jitterPS}" + | exit 1 + |} + |set phase [get_property CONFIG.MMCM_CLKOUT${i}_PHASE [get_ips ${moduleName}]] + |if {$$phase < ${phaseMin} || $$phase > ${phaseMax}} { + | puts "Achieved phase $$phase degrees is outside tolerated range ${phaseMin}-${phaseMax}" + | exit 1 + |} + |set div2 [get_property CONFIG.MMCM_CLKOUT${i}_DIVIDE${f} [get_ips ${moduleName}]] + |set freq [expr { ${c.input.freqMHz} * $$mult / $$div1 / $$div2 }] + |if {$$freq < ${freqMin} || $$freq > ${freqMax}} { + | puts "Achieved frequency $$freq MHz is outside tolerated range ${freqMin}-${freqMax}" + | exit 1 + |} + |puts "Achieve frequency $$freq MHz phase $$phase degrees jitter $$jitter ps" + |""".stripMargin + }.mkString + + + val aligned = if (c.input.feedback) " CONFIG.USE_PHASE_ALIGNMENT {true} \\\n" else "" + + ElaborationArtefacts.add(s"${moduleName}.vivado.tcl", + s"""create_ip -name clk_wiz -vendor xilinx.com -library ip -module_name \\ + | ${moduleName} -dir $$ipdir -force + |set_property -dict [list \\ + | CONFIG.CLK_IN1_BOARD_INTERFACE {Custom} \\ + | CONFIG.PRIM_SOURCE {No_buffer} \\ + | CONFIG.NUM_OUT_CLKS {${c.req.size.toString}} \\ + | CONFIG.PRIM_IN_FREQ {${c.input.freqMHz.toString}} \\ + | CONFIG.CLKIN1_JITTER_PS {${c.input.jitter}} \\ + |${used}${aligned}${outputs}] [get_ips ${moduleName}] + |set mult [get_property CONFIG.MMCM_CLKFBOUT_MULT_F [get_ips ${moduleName}]] + |set div1 [get_property CONFIG.MMCM_DIVCLK_DIVIDE [get_ips ${moduleName}]] + |${checks}""".stripMargin) +} + +//------------------------------------------------------------------------- +// vc707reset +//------------------------------------------------------------------------- + +class vc707reset() extends BlackBox +{ + val io = new Bundle{ + val areset = Bool(INPUT) + val clock1 = Clock(INPUT) + val reset1 = Bool(OUTPUT) + val clock2 = Clock(INPUT) + val reset2 = Bool(OUTPUT) + val clock3 = Clock(INPUT) + val reset3 = Bool(OUTPUT) + val clock4 = Clock(INPUT) + val reset4 = Bool(OUTPUT) + } +} + +//------------------------------------------------------------------------- +// vcu118_sys_clock_mmcm +//------------------------------------------------------------------------- +//IP : xilinx mmcm with "NO_BUFFER" input clock + +class vcu118_sys_clock_mmcm0 extends BlackBox { + val io = new Bundle { + val clk_in1 = Bool(INPUT) + val clk_out1 = Clock(OUTPUT) + val clk_out2 = Clock(OUTPUT) + val clk_out3 = Clock(OUTPUT) + val clk_out4 = Clock(OUTPUT) + val clk_out5 = Clock(OUTPUT) + val clk_out6 = Clock(OUTPUT) + val clk_out7 = Clock(OUTPUT) + val reset = Bool(INPUT) + val locked = Bool(OUTPUT) + } + + ElaborationArtefacts.add( + "vcu118_sys_clock_mmcm0.vivado.tcl", + """create_ip -name clk_wiz -vendor xilinx.com -library ip -module_name vcu118_sys_clock_mmcm0 -dir $ipdir -force + set_property -dict [list \ + CONFIG.CLK_IN1_BOARD_INTERFACE {Custom} \ + CONFIG.PRIM_SOURCE {No_buffer} \ + CONFIG.CLKOUT2_USED {true} \ + CONFIG.CLKOUT3_USED {true} \ + CONFIG.CLKOUT4_USED {true} \ + CONFIG.CLKOUT5_USED {true} \ + CONFIG.CLKOUT6_USED {true} \ + CONFIG.CLKOUT7_USED {true} \ + CONFIG.CLKOUT1_REQUESTED_OUT_FREQ {12.5} \ + CONFIG.CLKOUT2_REQUESTED_OUT_FREQ {25} \ + CONFIG.CLKOUT3_REQUESTED_OUT_FREQ {37.5} \ + CONFIG.CLKOUT4_REQUESTED_OUT_FREQ {50} \ + CONFIG.CLKOUT5_REQUESTED_OUT_FREQ {100} \ + CONFIG.CLKOUT6_REQUESTED_OUT_FREQ {150.000} \ + CONFIG.CLKOUT7_REQUESTED_OUT_FREQ {75} \ + CONFIG.CLK_IN1_BOARD_INTERFACE {Custom} \ + CONFIG.PRIM_IN_FREQ {250.000} \ + CONFIG.CLKIN1_JITTER_PS {50.0} \ + CONFIG.MMCM_DIVCLK_DIVIDE {5} \ + CONFIG.MMCM_CLKFBOUT_MULT_F {24.000} \ + CONFIG.MMCM_CLKIN1_PERIOD {4.000} \ + CONFIG.MMCM_CLKOUT0_DIVIDE_F {96.000} \ + CONFIG.MMCM_CLKOUT1_DIVIDE {48} \ + CONFIG.MMCM_CLKOUT2_DIVIDE {32} \ + CONFIG.MMCM_CLKOUT3_DIVIDE {24} \ + CONFIG.MMCM_CLKOUT4_DIVIDE {12} \ + CONFIG.MMCM_CLKOUT5_DIVIDE {8} \ + CONFIG.MMCM_CLKOUT6_DIVIDE {16} \ + CONFIG.NUM_OUT_CLKS {7} \ + CONFIG.CLKOUT1_JITTER {213.008} \ + CONFIG.CLKOUT1_PHASE_ERROR {154.678} \ + CONFIG.CLKOUT2_JITTER {179.547} \ + CONFIG.CLKOUT2_PHASE_ERROR {154.678} \ + CONFIG.CLKOUT3_JITTER {164.187} \ + CONFIG.CLKOUT3_PHASE_ERROR {154.678} \ + CONFIG.CLKOUT4_JITTER {154.688} \ + CONFIG.CLKOUT4_PHASE_ERROR {154.678} \ + CONFIG.CLKOUT5_JITTER {135.165} \ + CONFIG.CLKOUT5_PHASE_ERROR {154.678} \ + CONFIG.CLKOUT6_JITTER {126.046} \ + CONFIG.CLKOUT6_PHASE_ERROR {154.678} \ + CONFIG.CLKOUT7_JITTER {142.781} \ + CONFIG.CLKOUT7_PHASE_ERROR {154.678}] [get_ips vcu118_sys_clock_mmcm0] """ + ) +} + +class vcu118_sys_clock_mmcm1 extends BlackBox { + val io = new Bundle { + val clk_in1 = Bool(INPUT) + val clk_out1 = Clock(OUTPUT) + val clk_out2 = Clock(OUTPUT) + val reset = Bool(INPUT) + val locked = Bool(OUTPUT) + } + + ElaborationArtefacts.add( + "vcu118_sys_clock_mmcm1.vivado.tcl", + """create_ip -name clk_wiz -vendor xilinx.com -library ip -module_name vcu118_sys_clock_mmcm1 -dir $ipdir -force + set_property -dict [list \ + CONFIG.CLK_IN1_BOARD_INTERFACE {Custom} \ + CONFIG.PRIM_SOURCE {No_buffer} \ + CONFIG.CLKOUT2_USED {true} \ + CONFIG.CLKOUT3_USED {false} \ + CONFIG.CLKOUT4_USED {false} \ + CONFIG.CLKOUT5_USED {false} \ + CONFIG.CLKOUT6_USED {false} \ + CONFIG.CLKOUT7_USED {false} \ + CONFIG.CLKOUT1_REQUESTED_OUT_FREQ {32.5} \ + CONFIG.CLKOUT2_REQUESTED_OUT_FREQ {65} \ + CONFIG.CLK_IN1_BOARD_INTERFACE {Custom} \ + CONFIG.PRIM_IN_FREQ {250.000} \ + CONFIG.CLKIN1_JITTER_PS {50.0} \ + CONFIG.MMCM_DIVCLK_DIVIDE {25} \ + CONFIG.MMCM_CLKFBOUT_MULT_F {117.000} \ + CONFIG.MMCM_CLKIN1_PERIOD {4.000} \ + CONFIG.MMCM_CLKOUT0_DIVIDE_F {36.000} \ + CONFIG.MMCM_CLKOUT1_DIVIDE {18} \ + CONFIG.MMCM_CLKOUT2_DIVIDE {1} \ + CONFIG.MMCM_CLKOUT3_DIVIDE {1} \ + CONFIG.MMCM_CLKOUT4_DIVIDE {1} \ + CONFIG.MMCM_CLKOUT5_DIVIDE {1} \ + CONFIG.MMCM_CLKOUT6_DIVIDE {1} \ + CONFIG.NUM_OUT_CLKS {2} \ + CONFIG.CLKOUT1_JITTER {257.594} \ + CONFIG.CLKOUT1_PHASE_ERROR {366.693} \ + CONFIG.CLKOUT2_JITTER {232.023} \ + CONFIG.CLKOUT2_PHASE_ERROR {366.693}] \ + [get_ips vcu118_sys_clock_mmcm1] """ + ) +} + +//------------------------------------------------------------------------- +// vcu118reset +//------------------------------------------------------------------------- + +class vcu118reset() extends BlackBox +{ + val io = new Bundle{ + val areset = Bool(INPUT) + val clock1 = Clock(INPUT) + val reset1 = Bool(OUTPUT) + val clock2 = Clock(INPUT) + val reset2 = Bool(OUTPUT) + val clock3 = Clock(INPUT) + val reset3 = Bool(OUTPUT) + val clock4 = Clock(INPUT) + val reset4 = Bool(OUTPUT) + } +} + +//------------------------------------------------------------------------- +// sdio_spi_bridge +//------------------------------------------------------------------------- + +class sdio_spi_bridge() extends BlackBox +{ + val io = new Bundle{ + val clk = Clock(INPUT) + val reset = Bool(INPUT) + val sd_cmd = Analog(1.W) + val sd_dat = Analog(4.W) + val spi_sck = Bool(INPUT) + val spi_cs = Bool(INPUT) + val spi_dq_o = Bits(INPUT,4) + val spi_dq_i = Bits(OUTPUT,4) + } +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/ip/xilinx/arty100tmig/arty100tmig.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/ip/xilinx/arty100tmig/arty100tmig.scala new file mode 100644 index 0000000..a507664 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/ip/xilinx/arty100tmig/arty100tmig.scala @@ -0,0 +1,263 @@ +package sifive.fpgashells.ip.xilinx.arty100tmig + +import Chisel._ +import chisel3.experimental.{Analog,attach} +import freechips.rocketchip.util.{ElaborationArtefacts} +import freechips.rocketchip.util.GenericParameterizedBundle +import freechips.rocketchip.config._ + +// Black Box + +class Arty100TMIGIODDR(depth : BigInt) extends GenericParameterizedBundle(depth) { + require((depth<=0x10000000L),"Arty100TMIGIODDR supports upto 256 MB depth configuraton") + val ddr3_addr = Bits(OUTPUT,14) + val ddr3_ba = Bits(OUTPUT,3) + val ddr3_ras_n = Bool(OUTPUT) + val ddr3_cas_n = Bool(OUTPUT) + val ddr3_we_n = Bool(OUTPUT) + val ddr3_reset_n = Bool(OUTPUT) + val ddr3_ck_p = Bits(OUTPUT,1) + val ddr3_ck_n = Bits(OUTPUT,1) + val ddr3_cke = Bits(OUTPUT,1) + val ddr3_cs_n = Bits(OUTPUT,1) + val ddr3_dm = Bits(OUTPUT,2) + val ddr3_odt = Bits(OUTPUT,1) + + val ddr3_dq = Analog(16.W) + val ddr3_dqs_n = Analog(2.W) + val ddr3_dqs_p = Analog(2.W) +} + +trait Arty100TMIGIOClocksReset extends Bundle { + //inputs + //"NO_BUFFER" clock source (must be connected to IBUF outside of IP) + val sys_clk_i = Bool(INPUT) + val clk_ref_i = Bool(INPUT) + //user interface signals + val ui_clk = Clock(OUTPUT) + val ui_clk_sync_rst = Bool(OUTPUT) + val mmcm_locked = Bool(OUTPUT) + val aresetn = Bool(INPUT) + //misc + val init_calib_complete = Bool(OUTPUT) + val sys_rst = Bool(INPUT) +} + +//scalastyle:off +//turn off linter: blackbox name must match verilog module +class arty100tmig(depth : BigInt)(implicit val p:Parameters) extends BlackBox +{ + require((depth<=0x10000000L),"arty100tmig supports upto 256 MB depth configuraton") + + val io = new Arty100TMIGIODDR(depth) with Arty100TMIGIOClocksReset { + // User interface signals + val app_sr_req = Bool(INPUT) + val app_ref_req = Bool(INPUT) + val app_zq_req = Bool(INPUT) + val app_sr_active = Bool(OUTPUT) + val app_ref_ack = Bool(OUTPUT) + val app_zq_ack = Bool(OUTPUT) + //axi_s + //slave interface write address ports + val s_axi_awid = Bits(INPUT,4) + val s_axi_awaddr = Bits(INPUT,if(depth<=0x40000000) 30 else 32) + val s_axi_awlen = Bits(INPUT,8) + val s_axi_awsize = Bits(INPUT,3) + val s_axi_awburst = Bits(INPUT,2) + val s_axi_awlock = Bits(INPUT,1) + val s_axi_awcache = Bits(INPUT,4) + val s_axi_awprot = Bits(INPUT,3) + val s_axi_awqos = Bits(INPUT,4) + val s_axi_awvalid = Bool(INPUT) + val s_axi_awready = Bool(OUTPUT) + //slave interface write data ports + val s_axi_wdata = Bits(INPUT,64) + val s_axi_wstrb = Bits(INPUT,8) + val s_axi_wlast = Bool(INPUT) + val s_axi_wvalid = Bool(INPUT) + val s_axi_wready = Bool(OUTPUT) + //slave interface write response ports + val s_axi_bready = Bool(INPUT) + val s_axi_bid = Bits(OUTPUT,4) + val s_axi_bresp = Bits(OUTPUT,2) + val s_axi_bvalid = Bool(OUTPUT) + //slave interface read address ports + val s_axi_arid = Bits(INPUT,4) + val s_axi_araddr = Bits(INPUT,if(depth<=0x40000000) 30 else 32) + val s_axi_arlen = Bits(INPUT,8) + val s_axi_arsize = Bits(INPUT,3) + val s_axi_arburst = Bits(INPUT,2) + val s_axi_arlock = Bits(INPUT,1) + val s_axi_arcache = Bits(INPUT,4) + val s_axi_arprot = Bits(INPUT,3) + val s_axi_arqos = Bits(INPUT,4) + val s_axi_arvalid = Bool(INPUT) + val s_axi_arready = Bool(OUTPUT) + //slave interface read data ports + val s_axi_rready = Bool(INPUT) + val s_axi_rid = Bits(OUTPUT,4) + val s_axi_rdata = Bits(OUTPUT,64) + val s_axi_rresp = Bits(OUTPUT,2) + val s_axi_rlast = Bool(OUTPUT) + val s_axi_rvalid = Bool(OUTPUT) + //misc + val device_temp = Bits(OUTPUT,12) + } + + + val migprj = """{ + + + design_1_mig_7series_0_0 + 1 + 1 + OFF + 1024 + ON + Enabled + xc7a100t-csg324/-1 + 4.1 + No Buffer + No Buffer + ACTIVE HIGH + FALSE + 1 + 50 Ohms + 0 + + DDR3_SDRAM/Components/MT41K128M16XX-15E + 3000 + 1.8V + 4:1 + 166.666 + 0 + 666 + 1.000 + 1 + 1 + 1 + 1 + 16 + 1 + 1 + Disabled + Normal + 8 + FALSE + + 14 + 10 + 3 + 1.35V + 268435456 + BANK_ROW_COLUMN + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 8 - Fixed + Sequential + 5 + Normal + No + Slow Exit + Enable + RZQ/6 + Disable + Enable + RZQ/6 + 0 + Disabled + Enabled + Output Buffer Enabled + Full Array + 5 + Enabled + Normal + Dynamic ODT off + AXI + + RD_PRI_REG + 28 + 64 + 4 + 0 + + + + } """ + + + + + val migprjname = """{/arty100tmig.prj}""" + val modulename = """arty100tmig""" + + ElaborationArtefacts.add( + modulename++".vivado.tcl", + """set migprj """++migprj++""" + set migprjfile """++migprjname++""" + set migprjfilepath $ipdir$migprjfile + set fp [open $migprjfilepath w+] + puts $fp $migprj + close $fp + create_ip -vendor xilinx.com -library ip -name mig_7series -module_name """ ++ modulename ++ """ -dir $ipdir -force + set_property CONFIG.XML_INPUT_FILE $migprjfilepath [get_ips """ ++ modulename ++ """] """ + ) + + +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/ip/xilinx/ibufds_gte2/ibufds_gte2.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/ip/xilinx/ibufds_gte2/ibufds_gte2.scala new file mode 100644 index 0000000..90f58f5 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/ip/xilinx/ibufds_gte2/ibufds_gte2.scala @@ -0,0 +1,18 @@ +// See LICENSE for license details. +package sifive.fpgashells.ip.xilinx.ibufds_gte2 + +import Chisel._ + +//IP : xilinx unisim IBUFDS_GTE2 +//Differential Signaling Input Buffer +//unparameterized + +class IBUFDS_GTE2 extends BlackBox { + val io = new Bundle { + val O = Bool(OUTPUT) + val ODIV2 = Bool(OUTPUT) + val CEB = Bool(INPUT) + val I = Bool(INPUT) + val IB = Bool(INPUT) + } +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/ip/xilinx/vc707axi_to_pcie_x1/vc707axi_to_pcie_x1.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/ip/xilinx/vc707axi_to_pcie_x1/vc707axi_to_pcie_x1.scala new file mode 100644 index 0000000..1884238 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/ip/xilinx/vc707axi_to_pcie_x1/vc707axi_to_pcie_x1.scala @@ -0,0 +1,491 @@ +// See LICENSE for license details. +package sifive.fpgashells.ip.xilinx.vc707axi_to_pcie_x1 + +import Chisel._ +import freechips.rocketchip.config._ +import freechips.rocketchip.diplomacy._ +import freechips.rocketchip.amba.axi4._ +import freechips.rocketchip.interrupts._ +import freechips.rocketchip.util.{ElaborationArtefacts} + +// IP VLNV: xilinx.com:customize_ip:vc707pcietoaxi:1.0 +// Black Box +// Signals named _exactly_ as per Vivado generated verilog +// s : -{lock, cache, prot, qos} + +trait VC707AXIToPCIeX1IOSerial extends Bundle { + //serial external pins + val pci_exp_txp = Bool(OUTPUT) + val pci_exp_txn = Bool(OUTPUT) + val pci_exp_rxp = Bool(INPUT) + val pci_exp_rxn = Bool(INPUT) +} + +trait VC707AXIToPCIeX1IOClocksReset extends Bundle { + //clock, reset, control + val axi_aresetn = Bool(INPUT) + val axi_aclk_out = Clock(OUTPUT) + val axi_ctl_aclk_out = Clock(OUTPUT) + val mmcm_lock = Bool(OUTPUT) +} + +//scalastyle:off +//turn off linter: blackbox name must match verilog module +class vc707axi_to_pcie_x1() extends BlackBox +{ + val io = new Bundle with VC707AXIToPCIeX1IOSerial + with VC707AXIToPCIeX1IOClocksReset { + //refclk + val REFCLK = Bool(INPUT) + + //clock, reset, control + val INTX_MSI_Request = Bool(INPUT) + val INTX_MSI_Grant = Bool(OUTPUT) + val MSI_enable = Bool(OUTPUT) + val MSI_Vector_Num = Bits(INPUT,5) + val MSI_Vector_Width = Bits(OUTPUT,3) + + //interrupt + val interrupt_out = Bool(OUTPUT) + + //axi slave + //-{lock, cache, prot, qos} + //slave interface write address + val s_axi_awid = Bits(INPUT,4) + val s_axi_awaddr = Bits(INPUT,32) + val s_axi_awregion = Bits(INPUT,4) + val s_axi_awlen = Bits(INPUT,8) + val s_axi_awsize = Bits(INPUT,3) + val s_axi_awburst = Bits(INPUT,2) + //val s_axi_awlock = Bool(INPUT) + //val s_axi_awcache = Bits(INPUT,4) + //val s_axi_awprot = Bits(INPUT,3) + //val s_axi_awqos = Bits(INPUT,4) + val s_axi_awvalid = Bool(INPUT) + val s_axi_awready = Bool(OUTPUT) + //slave interface write data + val s_axi_wdata = Bits(INPUT,64) + val s_axi_wstrb = Bits(INPUT,8) + val s_axi_wlast = Bool(INPUT) + val s_axi_wvalid = Bool(INPUT) + val s_axi_wready = Bool(OUTPUT) + //slave interface write response + val s_axi_bready = Bool(INPUT) + val s_axi_bid = Bits(OUTPUT,4) + val s_axi_bresp = Bits(OUTPUT,2) + val s_axi_bvalid = Bool(OUTPUT) + //slave interface read address + val s_axi_arid = Bits(INPUT,4) + val s_axi_araddr = Bits(INPUT,32) + val s_axi_arregion = Bits(INPUT,4) + val s_axi_arlen = Bits(INPUT,8) + val s_axi_arsize = Bits(INPUT,3) + val s_axi_arburst = Bits(INPUT,2) + //val s_axi_arlock = Bits(INPUT,1) + //val s_axi_arcache = Bits(INPUT,4) + //val s_axi_arprot = Bits(INPUT,3) + //val s_axi_arqos = Bits(INPUT,4) + val s_axi_arvalid = Bool(INPUT) + val s_axi_arready = Bool(OUTPUT) + //slave interface read data + val s_axi_rready = Bool(INPUT) + val s_axi_rid = Bits(OUTPUT,4) + val s_axi_rdata = Bits(OUTPUT,64) + val s_axi_rresp = Bits(OUTPUT,2) + val s_axi_rlast = Bool(OUTPUT) + val s_axi_rvalid = Bool(OUTPUT) + + //axi master + //-{id,region,qos} + //slave interface write address ports + //val m_axi_awid = Bits(OUTPUT,4) + val m_axi_awaddr = Bits(OUTPUT,32) + //val m_axi_awregion = Bits(OUTPUT,4) + val m_axi_awlen = Bits(OUTPUT,8) + val m_axi_awsize = Bits(OUTPUT,3) + val m_axi_awburst = Bits(OUTPUT,2) + val m_axi_awlock = Bool(OUTPUT) + val m_axi_awcache = Bits(OUTPUT,4) + val m_axi_awprot = Bits(OUTPUT,3) + //val m_axi_awqos = Bits(OUTPUT,4) + val m_axi_awvalid = Bool(OUTPUT) + val m_axi_awready = Bool(INPUT) + //slave interface write data ports + val m_axi_wdata = Bits(OUTPUT,64) + val m_axi_wstrb = Bits(OUTPUT,8) + val m_axi_wlast = Bool(OUTPUT) + val m_axi_wvalid = Bool(OUTPUT) + val m_axi_wready = Bool(INPUT) + //slave interface write response ports + val m_axi_bready = Bool(OUTPUT) + //val m_axi_bid = Bits(INPUT,4) + val m_axi_bresp = Bits(INPUT,2) + val m_axi_bvalid = Bool(INPUT) + //slave interface read address ports + //val m_axi_arid = Bits(OUTPUT,4) + val m_axi_araddr = Bits(OUTPUT,32) + //val m_axi_arregion = Bits(OUTPUT,4) + val m_axi_arlen = Bits(OUTPUT,8) + val m_axi_arsize = Bits(OUTPUT,3) + val m_axi_arburst = Bits(OUTPUT,2) + val m_axi_arlock = Bits(OUTPUT,1) + val m_axi_arcache = Bits(OUTPUT,4) + val m_axi_arprot = Bits(OUTPUT,3) + //val m_axi_arqos = Bits(OUTPUT,4) + val m_axi_arvalid = Bool(OUTPUT) + val m_axi_arready = Bool(INPUT) + //slave interface read data ports + val m_axi_rready = Bool(OUTPUT) + //val m_axi_rid = Bits(INPUT,4) + val m_axi_rdata = Bits(INPUT,64) + val m_axi_rresp = Bits(INPUT,2) + val m_axi_rlast = Bool(INPUT) + val m_axi_rvalid = Bool(INPUT) + + //axi lite slave for control + val s_axi_ctl_awaddr = Bits(INPUT,32) + val s_axi_ctl_awvalid = Bool(INPUT) + val s_axi_ctl_awready = Bool(OUTPUT) + val s_axi_ctl_wdata = Bits(INPUT,32) + val s_axi_ctl_wstrb = Bits(INPUT,4) + val s_axi_ctl_wvalid = Bool(INPUT) + val s_axi_ctl_wready = Bool(OUTPUT) + val s_axi_ctl_bresp = Bits(OUTPUT,2) + val s_axi_ctl_bvalid = Bool(OUTPUT) + val s_axi_ctl_bready = Bool(INPUT) + val s_axi_ctl_araddr = Bits(INPUT,32) + val s_axi_ctl_arvalid = Bool(INPUT) + val s_axi_ctl_arready = Bool(OUTPUT) + val s_axi_ctl_rdata = Bits(OUTPUT,32) + val s_axi_ctl_rresp = Bits(OUTPUT,2) + val s_axi_ctl_rvalid = Bool(OUTPUT) + val s_axi_ctl_rready = Bool(INPUT) + } +} +//scalastyle:off + +//wrap vc707_axi_to_pcie_x1 black box in Nasti Bundles + +class VC707AXIToPCIeX1(implicit p:Parameters) extends LazyModule +{ + val device = new SimpleDevice("pci", Seq("xlnx,axi-pcie-host-1.00.a")) { + override def describe(resources: ResourceBindings): Description = { + val Description(name, mapping) = super.describe(resources) + val intc = "pcie_intc" + def ofInt(x: Int) = Seq(ResourceInt(BigInt(x))) + def ofMap(x: Int) = Seq(0, 0, 0, x).flatMap(ofInt) ++ Seq(ResourceReference(intc)) ++ ofInt(x) + val extra = Map( + "#address-cells" -> ofInt(3), + "#size-cells" -> ofInt(2), + "#interrupt-cells" -> ofInt(1), + "device_type" -> Seq(ResourceString("pci")), + "interrupt-map-mask" -> Seq(0, 0, 0, 7).flatMap(ofInt), + "interrupt-map" -> Seq(1, 2, 3, 4).flatMap(ofMap), + "ranges" -> resources("ranges").map(x => + (x: @unchecked) match { case Binding(_, ResourceAddress(address, perms)) => + ResourceMapping(address, BigInt(0x02000000) << 64, perms) }), + "interrupt-controller" -> Seq(ResourceMap(labels = Seq(intc), value = Map( + "interrupt-controller" -> Nil, + "#address-cells" -> ofInt(0), + "#interrupt-cells" -> ofInt(1))))) + Description(name, mapping ++ extra) + } + } + + val slave = AXI4SlaveNode(Seq(AXI4SlavePortParameters( + slaves = Seq(AXI4SlaveParameters( + address = List(AddressSet(0x40000000L, 0x1fffffffL)), + resources = Seq(Resource(device, "ranges")), + executable = true, + supportsWrite = TransferSizes(1, 128), + supportsRead = TransferSizes(1, 128))), + beatBytes = 8))) + + val control = AXI4SlaveNode(Seq(AXI4SlavePortParameters( + slaves = Seq(AXI4SlaveParameters( + address = List(AddressSet(0x2000000000L, 0x3ffffffL)), // when truncated to 32-bits, is 0 + resources = device.reg("control"), + supportsWrite = TransferSizes(1, 4), + supportsRead = TransferSizes(1, 4), + interleavedId = Some(0))), // AXI4-Lite never interleaves responses + beatBytes = 4))) + + val master = AXI4MasterNode(Seq(AXI4MasterPortParameters( + masters = Seq(AXI4MasterParameters( + name = "VC707 PCIe", + id = IdRange(0, 1), + aligned = false))))) + + val intnode = IntSourceNode(IntSourcePortSimple(resources = device.int)) + + lazy val module = new LazyModuleImp(this) { + // The master on the control port must be AXI-lite + require (control.edges.in(0).master.endId == 1) + // Must have exactly the right number of idBits + require (slave.edges.in(0).bundle.idBits == 4) + + class VC707AXIToPCIeX1IOBundle extends Bundle with VC707AXIToPCIeX1IOSerial + with VC707AXIToPCIeX1IOClocksReset; + + val io = IO(new Bundle { + val port = new VC707AXIToPCIeX1IOBundle + val REFCLK = Bool(INPUT) + }) + + val blackbox = Module(new vc707axi_to_pcie_x1) + + val (s, _) = slave.in(0) + val (c, _) = control.in(0) + val (m, _) = master.out(0) + val (i, _) = intnode.out(0) + + //to top level + blackbox.io.axi_aresetn := io.port.axi_aresetn + io.port.axi_aclk_out := blackbox.io.axi_aclk_out + io.port.axi_ctl_aclk_out := blackbox.io.axi_ctl_aclk_out + io.port.mmcm_lock := blackbox.io.mmcm_lock + io.port.pci_exp_txp := blackbox.io.pci_exp_txp + io.port.pci_exp_txn := blackbox.io.pci_exp_txn + blackbox.io.pci_exp_rxp := io.port.pci_exp_rxp + blackbox.io.pci_exp_rxn := io.port.pci_exp_rxn + i(0) := blackbox.io.interrupt_out + blackbox.io.REFCLK := io.REFCLK + + //s + //AXI4 signals ordered as per AXI4 Specification (Release D) Section A.2 + //-{lock, cache, prot, qos} + //-{aclk, aresetn, awuser, wid, wuser, buser, ruser} + //global signals + //aclk := + //aresetn := + //slave interface write address + blackbox.io.s_axi_awid := s.aw.bits.id + blackbox.io.s_axi_awaddr := s.aw.bits.addr + blackbox.io.s_axi_awlen := s.aw.bits.len + blackbox.io.s_axi_awsize := s.aw.bits.size + blackbox.io.s_axi_awburst := s.aw.bits.burst + //blackbox.io.s_axi_awlock := s.aw.bits.lock + //blackbox.io.s_axi_awcache := s.aw.bits.cache + //blackbox.io.s_axi_awprot := s.aw.bits.prot + //blackbox.io.s_axi_awqos := s.aw.bits.qos + blackbox.io.s_axi_awregion := UInt(0) + //blackbox.io.awuser := s.aw.bits.user + blackbox.io.s_axi_awvalid := s.aw.valid + s.aw.ready := blackbox.io.s_axi_awready + //slave interface write data ports + //blackbox.io.s_axi_wid := s.w.bits.id + blackbox.io.s_axi_wdata := s.w.bits.data + blackbox.io.s_axi_wstrb := s.w.bits.strb + blackbox.io.s_axi_wlast := s.w.bits.last + //blackbox.io.s_axi_wuser := s.w.bits.user + blackbox.io.s_axi_wvalid := s.w.valid + s.w.ready := blackbox.io.s_axi_wready + //slave interface write response + s.b.bits.id := blackbox.io.s_axi_bid + s.b.bits.resp := blackbox.io.s_axi_bresp + //s.b.bits.user := blackbox.io.s_axi_buser + s.b.valid := blackbox.io.s_axi_bvalid + blackbox.io.s_axi_bready := s.b.ready + //slave AXI interface read address ports + blackbox.io.s_axi_arid := s.ar.bits.id + blackbox.io.s_axi_araddr := s.ar.bits.addr + blackbox.io.s_axi_arlen := s.ar.bits.len + blackbox.io.s_axi_arsize := s.ar.bits.size + blackbox.io.s_axi_arburst := s.ar.bits.burst + //blackbox.io.s_axi_arlock := s.ar.bits.lock + //blackbox.io.s_axi_arcache := s.ar.bits.cache + //blackbox.io.s_axi_arprot := s.ar.bits.prot + //blackbox.io.s_axi_arqos := s.ar.bits.qos + blackbox.io.s_axi_arregion := UInt(0) + //blackbox.io.s_axi_aruser := s.ar.bits.user + blackbox.io.s_axi_arvalid := s.ar.valid + s.ar.ready := blackbox.io.s_axi_arready + //slave AXI interface read data ports + s.r.bits.id := blackbox.io.s_axi_rid + s.r.bits.data := blackbox.io.s_axi_rdata + s.r.bits.resp := blackbox.io.s_axi_rresp + s.r.bits.last := blackbox.io.s_axi_rlast + //s.r.bits.ruser := blackbox.io.s_axi_ruser + s.r.valid := blackbox.io.s_axi_rvalid + blackbox.io.s_axi_rready := s.r.ready + + //ctl + //axi-lite slave interface write address + blackbox.io.s_axi_ctl_awaddr := c.aw.bits.addr + blackbox.io.s_axi_ctl_awvalid := c.aw.valid + c.aw.ready := blackbox.io.s_axi_ctl_awready + //axi-lite slave interface write data ports + blackbox.io.s_axi_ctl_wdata := c.w.bits.data + blackbox.io.s_axi_ctl_wstrb := c.w.bits.strb + blackbox.io.s_axi_ctl_wvalid := c.w.valid + c.w.ready := blackbox.io.s_axi_ctl_wready + //axi-lite slave interface write response + blackbox.io.s_axi_ctl_bready := c.b.ready + c.b.bits.id := UInt(0) + c.b.bits.resp := blackbox.io.s_axi_ctl_bresp + c.b.valid := blackbox.io.s_axi_ctl_bvalid + //axi-lite slave AXI interface read address ports + blackbox.io.s_axi_ctl_araddr := c.ar.bits.addr + blackbox.io.s_axi_ctl_arvalid := c.ar.valid + c.ar.ready := blackbox.io.s_axi_ctl_arready + //slave AXI interface read data ports + blackbox.io.s_axi_ctl_rready := c.r.ready + c.r.bits.id := UInt(0) + c.r.bits.data := blackbox.io.s_axi_ctl_rdata + c.r.bits.resp := blackbox.io.s_axi_ctl_rresp + c.r.bits.last := Bool(true) + c.r.valid := blackbox.io.s_axi_ctl_rvalid + + //m + //AXI4 signals ordered per AXI4 Specification (Release D) Section A.2 + //-{id,region,qos} + //-{aclk, aresetn, awuser, wid, wuser, buser, ruser} + //global signals + //aclk := + //aresetn := + //master interface write address + m.aw.bits.id := UInt(0) + m.aw.bits.addr := blackbox.io.m_axi_awaddr + m.aw.bits.len := blackbox.io.m_axi_awlen + m.aw.bits.size := blackbox.io.m_axi_awsize + m.aw.bits.burst := blackbox.io.m_axi_awburst + m.aw.bits.lock := blackbox.io.m_axi_awlock + m.aw.bits.cache := blackbox.io.m_axi_awcache + m.aw.bits.prot := blackbox.io.m_axi_awprot + m.aw.bits.qos := UInt(0) + //m.aw.bits.region := blackbox.io.m_axi_awregion + //m.aw.bits.user := blackbox.io.m_axi_awuser + m.aw.valid := blackbox.io.m_axi_awvalid + blackbox.io.m_axi_awready := m.aw.ready + + //master interface write data ports + m.w.bits.data := blackbox.io.m_axi_wdata + m.w.bits.strb := blackbox.io.m_axi_wstrb + m.w.bits.last := blackbox.io.m_axi_wlast + //m.w.bits.user := blackbox.io.m_axi_wuser + m.w.valid := blackbox.io.m_axi_wvalid + blackbox.io.m_axi_wready := m.w.ready + + //master interface write response + //blackbox.io.m_axi_bid := m.b.bits.id + blackbox.io.m_axi_bresp := m.b.bits.resp + //blackbox.io.m_axi_buser := m.b.bits.user + blackbox.io.m_axi_bvalid := m.b.valid + m.b.ready := blackbox.io.m_axi_bready + + //master AXI interface read address ports + m.ar.bits.id := UInt(0) + m.ar.bits.addr := blackbox.io.m_axi_araddr + m.ar.bits.len := blackbox.io.m_axi_arlen + m.ar.bits.size := blackbox.io.m_axi_arsize + m.ar.bits.burst := blackbox.io.m_axi_arburst + m.ar.bits.lock := blackbox.io.m_axi_arlock + m.ar.bits.cache := blackbox.io.m_axi_arcache + m.ar.bits.prot := blackbox.io.m_axi_arprot + m.ar.bits.qos := UInt(0) + //m.ar.bits.region := blackbox.io.m_axi_arregion + //m.ar.bits.user := blackbox.io.s_axi_aruser + m.ar.valid := blackbox.io.m_axi_arvalid + blackbox.io.m_axi_arready := m.ar.ready + + //master AXI interface read data ports + //blackbox.io.m_axi_rid := m.r.bits.id + blackbox.io.m_axi_rdata := m.r.bits.data + blackbox.io.m_axi_rresp := m.r.bits.resp + blackbox.io.m_axi_rlast := m.r.bits.last + //blackbox.io.s_axi_ruser := s.bits.ruser + blackbox.io.m_axi_rvalid := m.r.valid + m.r.ready := blackbox.io.m_axi_rready + } + + ElaborationArtefacts.add( + "vc707axi_to_pcie_x1.vivado.tcl", + """ + create_ip -vendor xilinx.com -library ip -version 2.8 -name axi_pcie -module_name vc707axi_to_pcie_x1 -dir $ipdir -force + set_property -dict [list \ + CONFIG.AXIBAR2PCIEBAR_0 {0x40000000} \ + CONFIG.AXIBAR2PCIEBAR_1 {0x00000000} \ + CONFIG.AXIBAR2PCIEBAR_2 {0x00000000} \ + CONFIG.AXIBAR2PCIEBAR_3 {0x00000000} \ + CONFIG.AXIBAR2PCIEBAR_4 {0x00000000} \ + CONFIG.AXIBAR2PCIEBAR_5 {0x00000000} \ + CONFIG.AXIBAR_0 {0x40000000} \ + CONFIG.AXIBAR_1 {0xFFFFFFFF} \ + CONFIG.AXIBAR_2 {0xFFFFFFFF} \ + CONFIG.AXIBAR_3 {0xFFFFFFFF} \ + CONFIG.AXIBAR_4 {0xFFFFFFFF} \ + CONFIG.AXIBAR_5 {0xFFFFFFFF} \ + CONFIG.AXIBAR_AS_0 {true} \ + CONFIG.AXIBAR_AS_1 {false} \ + CONFIG.AXIBAR_AS_2 {false} \ + CONFIG.AXIBAR_AS_3 {false} \ + CONFIG.AXIBAR_AS_4 {false} \ + CONFIG.AXIBAR_AS_5 {false} \ + CONFIG.AXIBAR_HIGHADDR_0 {0x5FFFFFFF} \ + CONFIG.AXIBAR_HIGHADDR_1 {0x00000000} \ + CONFIG.AXIBAR_HIGHADDR_2 {0x00000000} \ + CONFIG.AXIBAR_HIGHADDR_3 {0x00000000} \ + CONFIG.AXIBAR_HIGHADDR_4 {0x00000000} \ + CONFIG.AXIBAR_HIGHADDR_5 {0x00000000} \ + CONFIG.AXIBAR_NUM {1} \ + CONFIG.BAR0_ENABLED {true} \ + CONFIG.BAR0_SCALE {Gigabytes} \ + CONFIG.BAR0_SIZE {4} \ + CONFIG.BAR0_TYPE {Memory} \ + CONFIG.BAR1_ENABLED {false} \ + CONFIG.BAR1_SCALE {N/A} \ + CONFIG.BAR1_SIZE {8} \ + CONFIG.BAR1_TYPE {N/A} \ + CONFIG.BAR2_ENABLED {false} \ + CONFIG.BAR2_SCALE {N/A} \ + CONFIG.BAR2_SIZE {8} \ + CONFIG.BAR2_TYPE {N/A} \ + CONFIG.BAR_64BIT {true} \ + CONFIG.BASEADDR {0x00000000} \ + CONFIG.BASE_CLASS_MENU {Bridge_device} \ + CONFIG.CLASS_CODE {0x060400} \ + CONFIG.COMP_TIMEOUT {50ms} \ + CONFIG.Component_Name {design_1_axi_pcie_1_0} \ + CONFIG.DEVICE_ID {0x7111} \ + CONFIG.ENABLE_CLASS_CODE {true} \ + CONFIG.HIGHADDR {0x03FFFFFF} \ + CONFIG.INCLUDE_BAROFFSET_REG {true} \ + CONFIG.INCLUDE_RC {Root_Port_of_PCI_Express_Root_Complex} \ + CONFIG.INTERRUPT_PIN {false} \ + CONFIG.MAX_LINK_SPEED {2.5_GT/s} \ + CONFIG.MSI_DECODE_ENABLED {true} \ + CONFIG.M_AXI_ADDR_WIDTH {32} \ + CONFIG.M_AXI_DATA_WIDTH {64} \ + CONFIG.NO_OF_LANES {X1} \ + CONFIG.NUM_MSI_REQ {0} \ + CONFIG.PCIEBAR2AXIBAR_0_SEC {1} \ + CONFIG.PCIEBAR2AXIBAR_0 {0x00000000} \ + CONFIG.PCIEBAR2AXIBAR_1 {0xFFFFFFFF} \ + CONFIG.PCIEBAR2AXIBAR_1_SEC {1} \ + CONFIG.PCIEBAR2AXIBAR_2 {0xFFFFFFFF} \ + CONFIG.PCIEBAR2AXIBAR_2_SEC {1} \ + CONFIG.PCIE_BLK_LOCN {X1Y1} \ + CONFIG.PCIE_USE_MODE {GES_and_Production} \ + CONFIG.REF_CLK_FREQ {100_MHz} \ + CONFIG.REV_ID {0x00} \ + CONFIG.SLOT_CLOCK_CONFIG {true} \ + CONFIG.SUBSYSTEM_ID {0x0007} \ + CONFIG.SUBSYSTEM_VENDOR_ID {0x10EE} \ + CONFIG.SUB_CLASS_INTERFACE_MENU {Host_bridge} \ + CONFIG.S_AXI_ADDR_WIDTH {32} \ + CONFIG.S_AXI_DATA_WIDTH {64} \ + CONFIG.S_AXI_ID_WIDTH {4} \ + CONFIG.S_AXI_SUPPORTS_NARROW_BURST {false} \ + CONFIG.VENDOR_ID {0x10EE} \ + CONFIG.XLNX_REF_BOARD {None} \ + CONFIG.axi_aclk_loopback {false} \ + CONFIG.en_ext_ch_gt_drp {false} \ + CONFIG.en_ext_clk {false} \ + CONFIG.en_ext_gt_common {false} \ + CONFIG.en_ext_pipe_interface {false} \ + CONFIG.en_transceiver_status_ports {false} \ + CONFIG.no_slv_err {false} \ + CONFIG.rp_bar_hide {true} \ + CONFIG.shared_logic_in_core {false} ] [get_ips vc707axi_to_pcie_x1]""" + ) +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/ip/xilinx/vc707mig/vc707mig.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/ip/xilinx/vc707mig/vc707mig.scala new file mode 100644 index 0000000..d5d58ab --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/ip/xilinx/vc707mig/vc707mig.scala @@ -0,0 +1,534 @@ +// See LICENSE for license details. +package sifive.fpgashells.ip.xilinx.vc707mig + +import Chisel._ +import chisel3.experimental.{Analog,attach} +import freechips.rocketchip.util.{ElaborationArtefacts} +import freechips.rocketchip.util.GenericParameterizedBundle +import freechips.rocketchip.config._ + +// IP VLNV: xilinx.com:customize_ip:vc707mig:1.0 +// Black Box + +class VC707MIGIODDR(depth : BigInt) extends GenericParameterizedBundle(depth) { + require((depth<=0x100000000L),"VC707MIGIODDR supports upto 4GB depth configuraton") + val ddr3_addr = Bits(OUTPUT,if(depth<=0x40000000L) 14 else 16) + val ddr3_ba = Bits(OUTPUT,3) + val ddr3_ras_n = Bool(OUTPUT) + val ddr3_cas_n = Bool(OUTPUT) + val ddr3_we_n = Bool(OUTPUT) + val ddr3_reset_n = Bool(OUTPUT) + val ddr3_ck_p = Bits(OUTPUT,1) + val ddr3_ck_n = Bits(OUTPUT,1) + val ddr3_cke = Bits(OUTPUT,1) + val ddr3_cs_n = Bits(OUTPUT,1) + val ddr3_dm = Bits(OUTPUT,8) + val ddr3_odt = Bits(OUTPUT,1) + + val ddr3_dq = Analog(64.W) + val ddr3_dqs_n = Analog(8.W) + val ddr3_dqs_p = Analog(8.W) +} + +//reused directly in io bundle for sifive.blocks.devices.xilinxvc707mig +trait VC707MIGIOClocksReset extends Bundle { + //inputs + //"NO_BUFFER" clock source (must be connected to IBUF outside of IP) + val sys_clk_i = Bool(INPUT) + //user interface signals + val ui_clk = Clock(OUTPUT) + val ui_clk_sync_rst = Bool(OUTPUT) + val mmcm_locked = Bool(OUTPUT) + val aresetn = Bool(INPUT) + //misc + val init_calib_complete = Bool(OUTPUT) + val sys_rst = Bool(INPUT) +} + +//scalastyle:off +//turn off linter: blackbox name must match verilog module +class vc707mig(depth : BigInt)(implicit val p:Parameters) extends BlackBox +{ + require((depth<=0x100000000L),"vc707mig supports upto 4GB depth configuraton") + override def desiredName = if(depth<=0x40000000) "vc707mig1gb" else "vc707mig4gb" + + val io = new VC707MIGIODDR(depth) with VC707MIGIOClocksReset { + // User interface signals + val app_sr_req = Bool(INPUT) + val app_ref_req = Bool(INPUT) + val app_zq_req = Bool(INPUT) + val app_sr_active = Bool(OUTPUT) + val app_ref_ack = Bool(OUTPUT) + val app_zq_ack = Bool(OUTPUT) + //axi_s + //slave interface write address ports + val s_axi_awid = Bits(INPUT,4) + val s_axi_awaddr = Bits(INPUT,if(depth<=0x40000000) 30 else 32) + val s_axi_awlen = Bits(INPUT,8) + val s_axi_awsize = Bits(INPUT,3) + val s_axi_awburst = Bits(INPUT,2) + val s_axi_awlock = Bits(INPUT,1) + val s_axi_awcache = Bits(INPUT,4) + val s_axi_awprot = Bits(INPUT,3) + val s_axi_awqos = Bits(INPUT,4) + val s_axi_awvalid = Bool(INPUT) + val s_axi_awready = Bool(OUTPUT) + //slave interface write data ports + val s_axi_wdata = Bits(INPUT,64) + val s_axi_wstrb = Bits(INPUT,8) + val s_axi_wlast = Bool(INPUT) + val s_axi_wvalid = Bool(INPUT) + val s_axi_wready = Bool(OUTPUT) + //slave interface write response ports + val s_axi_bready = Bool(INPUT) + val s_axi_bid = Bits(OUTPUT,4) + val s_axi_bresp = Bits(OUTPUT,2) + val s_axi_bvalid = Bool(OUTPUT) + //slave interface read address ports + val s_axi_arid = Bits(INPUT,4) + val s_axi_araddr = Bits(INPUT,if(depth<=0x40000000) 30 else 32) + val s_axi_arlen = Bits(INPUT,8) + val s_axi_arsize = Bits(INPUT,3) + val s_axi_arburst = Bits(INPUT,2) + val s_axi_arlock = Bits(INPUT,1) + val s_axi_arcache = Bits(INPUT,4) + val s_axi_arprot = Bits(INPUT,3) + val s_axi_arqos = Bits(INPUT,4) + val s_axi_arvalid = Bool(INPUT) + val s_axi_arready = Bool(OUTPUT) + //slave interface read data ports + val s_axi_rready = Bool(INPUT) + val s_axi_rid = Bits(OUTPUT,4) + val s_axi_rdata = Bits(OUTPUT,64) + val s_axi_rresp = Bits(OUTPUT,2) + val s_axi_rlast = Bool(OUTPUT) + val s_axi_rvalid = Bool(OUTPUT) + //misc + val device_temp = Bits(OUTPUT,12) + } + + val vc707mig1gbprj = """ { + + + vc707mig1gp + 1 + 1 + OFF + 1024 + ON + Enabled + xc7vx485t-ffg1761/-2 + 3.0 + No Buffer + Use System Clock + ACTIVE HIGH + FALSE + 0 + 50 Ohms + 0 + + DDR3_SDRAM/SODIMMs/MT8JTF12864HZ-1G6 + 1250 + 2.0V + 4:1 + 200 + 0 + 800 + 1.000 + 1 + 1 + 1 + 1 + 64 + 1 + 1 + Disabled + Normal + FALSE + + 14 + 10 + 3 + 1.5V + BANK_ROW_COLUMN + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 8 - Fixed + Sequential + 11 + Normal + No + Slow Exit + Enable + RZQ/7 + Disable + Enable + RZQ/6 + 0 + Disabled + Enabled + Output Buffer Enabled + Full Array + 8 + Enabled + Normal + Dynamic ODT off + AXI + + RD_PRI_REG + 30 + 64 + 4 + 0 + + + + } """ + + val vc707mig4gbprj = """ { + + + vc707mig4gb + 1 + 1 + OFF + 1024 + ON + Enabled + xc7vx485t-ffg1761/-2 + 3.0 + No Buffer + Use System Clock + ACTIVE HIGH + FALSE + 0 + 50 Ohms + 0 + + DDR3_SDRAM/SODIMMs/MT8KTF51264HZ-1G9 + 1250 + 2.0V + 4:1 + 200 + 0 + 800 + 1.000 + 1 + 1 + 1 + 1 + 64 + 1 + 1 + Disabled + Normal + FALSE + + 16 + 10 + 3 + 1.5V + BANK_ROW_COLUMN + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 8 - Fixed + Sequential + 11 + Normal + No + Slow Exit + Enable + RZQ/7 + Disable + Enable + RZQ/6 + 0 + Disabled + Enabled + Output Buffer Enabled + Full Array + 8 + Enabled + Normal + Dynamic ODT off + AXI + + RD_PRI_REG + 32 + 64 + 4 + 0 + + + +}""" + + val migprj = if(depth<=0x40000000) vc707mig1gbprj else vc707mig4gbprj + val migprjname = if(depth<=0x40000000) """{/vc707mig1gb.prj}""" else """{/vc707mig4gb.prj}""" + val modulename = if(depth<=0x40000000) """vc707mig1gb""" else """vc707mig4gb""" + + + ElaborationArtefacts.add( + modulename++".vivado.tcl", + """set migprj """++migprj++""" + set migprjfile """++migprjname++""" + set migprjfilepath $ipdir$migprjfile + set fp [open $migprjfilepath w+] + puts $fp $migprj + close $fp + create_ip -vendor xilinx.com -library ip -name mig_7series -module_name """ ++ modulename ++ """ -dir $ipdir -force + set_property CONFIG.XML_INPUT_FILE $migprjfilepath [get_ips """ ++ modulename ++ """] """ + ) + + +} +//scalastyle:on diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/ip/xilinx/vcu118mig/vcu118mig.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/ip/xilinx/vcu118mig/vcu118mig.scala new file mode 100644 index 0000000..1c383fc --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/ip/xilinx/vcu118mig/vcu118mig.scala @@ -0,0 +1,179 @@ +// See LICENSE for license details. +package sifive.fpgashells.ip.xilinx.vcu118mig + +import Chisel._ +import chisel3.experimental.{Analog,attach} +import freechips.rocketchip.util.{ElaborationArtefacts} +import freechips.rocketchip.util.GenericParameterizedBundle +import freechips.rocketchip.config._ + +// IP VLNV: xilinx.com:customize_ip:vcu118mig:1.0 +// Black Box + +class VCU118MIGIODDR(depth : BigInt) extends GenericParameterizedBundle(depth) { + require((depth<=0x80000000L),"VCU118MIGIODDR supports upto 2GB depth configuraton") + val c0_ddr4_adr = Bits(OUTPUT,17) + val c0_ddr4_bg = Bits(OUTPUT,1) + val c0_ddr4_ba = Bits(OUTPUT,2) + val c0_ddr4_reset_n = Bool(OUTPUT) + val c0_ddr4_act_n = Bool(OUTPUT) + val c0_ddr4_ck_c = Bits(OUTPUT,1) + val c0_ddr4_ck_t = Bits(OUTPUT,1) + val c0_ddr4_cke = Bits(OUTPUT,1) + val c0_ddr4_cs_n = Bits(OUTPUT,1) + val c0_ddr4_odt = Bits(OUTPUT,1) + + val c0_ddr4_dq = Analog(64.W) + val c0_ddr4_dqs_c = Analog(8.W) + val c0_ddr4_dqs_t = Analog(8.W) + val c0_ddr4_dm_dbi_n = Analog(8.W) +} + +//reused directly in io bundle for sifive.blocks.devices.xilinxvcu118mig +trait VCU118MIGIOClocksReset extends Bundle { + //inputs + //"NO_BUFFER" clock source (must be connected to IBUF outside of IP) + val c0_sys_clk_i = Bool(INPUT) + //user interface signals + val c0_ddr4_ui_clk = Clock(OUTPUT) + val c0_ddr4_ui_clk_sync_rst = Bool(OUTPUT) + val c0_ddr4_aresetn = Bool(INPUT) + //misc + val c0_init_calib_complete = Bool(OUTPUT) + val sys_rst = Bool(INPUT) +} + +//scalastyle:off +//turn off linter: blackbox name must match verilog module +class vcu118mig(depth : BigInt)(implicit val p:Parameters) extends BlackBox +{ + require((depth<=0x80000000L),"vcu118mig supports upto 2GB depth configuraton") + + val io = new VCU118MIGIODDR(depth) with VCU118MIGIOClocksReset { + //slave interface write address ports + val c0_ddr4_s_axi_awid = Bits(INPUT,4) + val c0_ddr4_s_axi_awaddr = Bits(INPUT,31) + val c0_ddr4_s_axi_awlen = Bits(INPUT,8) + val c0_ddr4_s_axi_awsize = Bits(INPUT,3) + val c0_ddr4_s_axi_awburst = Bits(INPUT,2) + val c0_ddr4_s_axi_awlock = Bits(INPUT,1) + val c0_ddr4_s_axi_awcache = Bits(INPUT,4) + val c0_ddr4_s_axi_awprot = Bits(INPUT,3) + val c0_ddr4_s_axi_awqos = Bits(INPUT,4) + val c0_ddr4_s_axi_awvalid = Bool(INPUT) + val c0_ddr4_s_axi_awready = Bool(OUTPUT) + //slave interface write data ports + val c0_ddr4_s_axi_wdata = Bits(INPUT,64) + val c0_ddr4_s_axi_wstrb = Bits(INPUT,8) + val c0_ddr4_s_axi_wlast = Bool(INPUT) + val c0_ddr4_s_axi_wvalid = Bool(INPUT) + val c0_ddr4_s_axi_wready = Bool(OUTPUT) + //slave interface write response ports + val c0_ddr4_s_axi_bready = Bool(INPUT) + val c0_ddr4_s_axi_bid = Bits(OUTPUT,4) + val c0_ddr4_s_axi_bresp = Bits(OUTPUT,2) + val c0_ddr4_s_axi_bvalid = Bool(OUTPUT) + //slave interface read address ports + val c0_ddr4_s_axi_arid = Bits(INPUT,4) + val c0_ddr4_s_axi_araddr = Bits(INPUT,31) + val c0_ddr4_s_axi_arlen = Bits(INPUT,8) + val c0_ddr4_s_axi_arsize = Bits(INPUT,3) + val c0_ddr4_s_axi_arburst = Bits(INPUT,2) + val c0_ddr4_s_axi_arlock = Bits(INPUT,1) + val c0_ddr4_s_axi_arcache = Bits(INPUT,4) + val c0_ddr4_s_axi_arprot = Bits(INPUT,3) + val c0_ddr4_s_axi_arqos = Bits(INPUT,4) + val c0_ddr4_s_axi_arvalid = Bool(INPUT) + val c0_ddr4_s_axi_arready = Bool(OUTPUT) + //slave interface read data ports + val c0_ddr4_s_axi_rready = Bool(INPUT) + val c0_ddr4_s_axi_rid = Bits(OUTPUT,4) + val c0_ddr4_s_axi_rdata = Bits(OUTPUT,64) + val c0_ddr4_s_axi_rresp = Bits(OUTPUT,2) + val c0_ddr4_s_axi_rlast = Bool(OUTPUT) + val c0_ddr4_s_axi_rvalid = Bool(OUTPUT) + } + + ElaborationArtefacts.add( + "vcu118mig.vivado.tcl", + """ + create_ip -vendor xilinx.com -library ip -version 2.2 -name ddr4 -module_name vcu118mig -dir $ipdir -force + set_property -dict [list \ + CONFIG.AL_SEL {0} \ + CONFIG.C0.ADDR_WIDTH {17} \ + CONFIG.C0.BANK_GROUP_WIDTH {1} \ + CONFIG.C0.CKE_WIDTH {1} \ + CONFIG.C0.CK_WIDTH {1} \ + CONFIG.C0.CS_WIDTH {1} \ + CONFIG.C0.ControllerType {DDR4_SDRAM} \ + CONFIG.C0.DDR4_AUTO_AP_COL_A3 {false} \ + CONFIG.C0.DDR4_AutoPrecharge {false} \ + CONFIG.C0.DDR4_AxiAddressWidth {31} \ + CONFIG.C0.DDR4_AxiArbitrationScheme {RD_PRI_REG} \ + CONFIG.C0.DDR4_AxiDataWidth {64} \ + CONFIG.C0.DDR4_AxiIDWidth {4} \ + CONFIG.C0.DDR4_AxiNarrowBurst {false} \ + CONFIG.C0.DDR4_AxiSelection {true} \ + CONFIG.C0.DDR4_BurstLength {8} \ + CONFIG.C0.DDR4_BurstType {Sequential} \ + CONFIG.C0.DDR4_CLKFBOUT_MULT {8} \ + CONFIG.C0.DDR4_CLKOUT0_DIVIDE {5} \ + CONFIG.C0.DDR4_Capacity {512} \ + CONFIG.C0.DDR4_CasLatency {11} \ + CONFIG.C0.DDR4_CasWriteLatency {9} \ + CONFIG.C0.DDR4_ChipSelect {true} \ + CONFIG.C0.DDR4_Clamshell {false} \ + CONFIG.C0.DDR4_CustomParts {no_file_loaded} \ + CONFIG.C0.DDR4_DIVCLK_DIVIDE {2} \ + CONFIG.C0.DDR4_DataMask {DM_NO_DBI} \ + CONFIG.C0.DDR4_DataWidth {64} \ + CONFIG.C0.DDR4_Ecc {false} \ + CONFIG.C0.DDR4_MCS_ECC {false} \ + CONFIG.C0.DDR4_Mem_Add_Map {ROW_COLUMN_BANK} \ + CONFIG.C0.DDR4_MemoryName {MainMemory} \ + CONFIG.C0.DDR4_MemoryPart {MT40A256M16GE-083E} \ + CONFIG.C0.DDR4_MemoryType {Components} \ + CONFIG.C0.DDR4_MemoryVoltage {1.2V} \ + CONFIG.C0.DDR4_OnDieTermination {RZQ/6} \ + CONFIG.C0.DDR4_Ordering {Normal} \ + CONFIG.C0.DDR4_OutputDriverImpedenceControl {RZQ/7} \ + CONFIG.C0.DDR4_PhyClockRatio {4:1} \ + CONFIG.C0.DDR4_SAVE_RESTORE {false} \ + CONFIG.C0.DDR4_SELF_REFRESH {false} \ + CONFIG.C0.DDR4_Slot {Single} \ + CONFIG.C0.DDR4_Specify_MandD {true} \ + CONFIG.C0.DDR4_TimePeriod {1250} \ + CONFIG.C0.DDR4_UserRefresh_ZQCS {false} \ + CONFIG.C0.DDR4_isCKEShared {false} \ + CONFIG.C0.DDR4_isCustom {false} \ + CONFIG.C0.LR_WIDTH {1} \ + CONFIG.C0.ODT_WIDTH {1} \ + CONFIG.C0.StackHeight {1} \ + CONFIG.C0_CLOCK_BOARD_INTERFACE {Custom} \ + CONFIG.C0_DDR4_BOARD_INTERFACE {Custom} \ + CONFIG.DCI_Cascade {false} \ + CONFIG.DIFF_TERM_SYSCLK {false} \ + CONFIG.Debug_Signal {Disable} \ + CONFIG.Default_Bank_Selections {false} \ + CONFIG.Enable_SysPorts {true} \ + CONFIG.IOPowerReduction {OFF} \ + CONFIG.IO_Power_Reduction {false} \ + CONFIG.IS_FROM_PHY {1} \ + CONFIG.MCS_DBG_EN {false} \ + CONFIG.No_Controller {1} \ + CONFIG.PARTIAL_RECONFIG_FLOW_MIG {false} \ + CONFIG.PING_PONG_PHY {1} \ + CONFIG.Phy_Only {Complete_Memory_Controller} \ + CONFIG.RECONFIG_XSDB_SAVE_RESTORE {false} \ + CONFIG.RESET_BOARD_INTERFACE {Custom} \ + CONFIG.Reference_Clock {Differential} \ + CONFIG.SET_DW_TO_40 {false} \ + CONFIG.System_Clock {No_Buffer} \ + CONFIG.TIMING_3DS {false} \ + CONFIG.TIMING_OP1 {false} \ + CONFIG.TIMING_OP2 {false} \ + ] [get_ips vcu118mig]""" + ) + +} +//scalastyle:on diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/ip/xilinx/xdma/xdma.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/ip/xilinx/xdma/xdma.scala new file mode 100644 index 0000000..93e2677 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/ip/xilinx/xdma/xdma.scala @@ -0,0 +1,469 @@ +// See LICENSE for license details. +package sifive.fpgashells.ip.xilinx.xdma + +import chisel3._ +import chisel3.util._ +import freechips.rocketchip.config._ +import freechips.rocketchip.diplomacy._ +import freechips.rocketchip.amba.axi4._ +import freechips.rocketchip.interrupts._ +import freechips.rocketchip.util.{ElaborationArtefacts} + +trait HasXDMAPads { + def lanes: Int + + val pci_exp_txp = Output(UInt(lanes.W)) + val pci_exp_txn = Output(UInt(lanes.W)) + val pci_exp_rxp = Input(UInt(lanes.W)) + val pci_exp_rxn = Input(UInt(lanes.W)) +} + +trait HasXDMAClocks { + val sys_clk = Input(Clock()) // + val sys_clk_gt = Input(Clock()) // PCIe reference clock IBUFDS_GTE4.O + val sys_rst_n = Input(Bool()) + val axi_aclk = Output(Clock()) + val axi_aresetn = Output(Bool()) +} + +trait HasXDMAJunk { + val cfg_ltssm_state = Output(UInt(6.W)) + val user_lnk_up = Output(Bool()) + val axi_ctl_aresetn = Output(Bool()) // copy of axi_aresetn in RP mode +} + +case class XDMABusParams(idBits: Int, addrBits: Int, dataBytes: Int) +{ + val dataBits = dataBytes*8 +} + +trait HasXDMABus { + def mbus: XDMABusParams + def sbus: XDMABusParams + def slbus: XDMABusParams + + // I + val interrupt_out = Output(Bool()) + val interrupt_out_msi_vec0to31 = Output(Bool()) + val interrupt_out_msi_vec32to63 = Output(Bool()) + + // M.AW + val m_axib_awready = Input(Bool()) + val m_axib_awvalid = Output(Bool()) + val m_axib_awid = Output(UInt(mbus.idBits.W)) + val m_axib_awaddr = Output(UInt(mbus.addrBits.W)) + val m_axib_awlen = Output(UInt(8.W)) + val m_axib_awsize = Output(UInt(3.W)) + val m_axib_awburst = Output(UInt(2.W)) + val m_axib_awprot = Output(UInt(3.W)) + val m_axib_awcache = Output(UInt(4.W)) + val m_axib_awlock = Output(Bool()) + + // M.AR + val m_axib_arready = Input(Bool()) + val m_axib_arvalid = Output(Bool()) + val m_axib_arid = Output(UInt(mbus.idBits.W)) + val m_axib_araddr = Output(UInt(mbus.addrBits.W)) + val m_axib_arlen = Output(UInt(8.W)) + val m_axib_arsize = Output(UInt(3.W)) + val m_axib_arburst = Output(UInt(2.W)) + val m_axib_arprot = Output(UInt(3.W)) + val m_axib_arcache = Output(UInt(4.W)) + val m_axib_arlock = Output(Bool()) + + // M.W + val m_axib_wready = Input(Bool()) + val m_axib_wvalid = Output(Bool()) + val m_axib_wdata = Output(UInt(mbus.dataBits.W)) + val m_axib_wstrb = Output(UInt(mbus.dataBytes.W)) + val m_axib_wlast = Output(Bool()) + + // M.B + val m_axib_bready = Output(Bool()) + val m_axib_bvalid = Input(Bool()) + val m_axib_bid = Input(UInt(mbus.idBits.W)) + val m_axib_bresp = Input(UInt(2.W)) + + // M.R + val m_axib_rready = Output(Bool()) + val m_axib_rvalid = Input(Bool()) + val m_axib_rid = Input(UInt(mbus.idBits.W)) + val m_axib_rdata = Input(UInt(mbus.dataBits.W)) + val m_axib_rresp = Input(UInt(2.W)) + val m_axib_rlast = Input(Bool()) + + // S.AW + val s_axib_awready = Output(Bool()) + val s_axib_awvalid = Input(Bool()) + val s_axib_awid = Input(UInt(sbus.idBits.W)) + val s_axib_awaddr = Input(UInt(sbus.addrBits.W)) + val s_axib_awregion = Input(UInt(4.W)) + val s_axib_awlen = Input(UInt(8.W)) + val s_axib_awsize = Input(UInt(3.W)) + val s_axib_awburst = Input(UInt(2.W)) + + // S.AR + val s_axib_arready = Output(Bool()) + val s_axib_arvalid = Input(Bool()) + val s_axib_arid = Input(UInt(sbus.idBits.W)) + val s_axib_araddr = Input(UInt(sbus.addrBits.W)) + val s_axib_arregion = Input(UInt(4.W)) + val s_axib_arlen = Input(UInt(8.W)) + val s_axib_arsize = Input(UInt(3.W)) + val s_axib_arburst = Input(UInt(2.W)) + + // S.W + val s_axib_wready = Output(Bool()) + val s_axib_wvalid = Input(Bool()) + val s_axib_wdata = Input(UInt(sbus.dataBits.W)) + val s_axib_wstrb = Input(UInt(sbus.dataBytes.W)) + val s_axib_wlast = Input(Bool()) + + // S.B + val s_axib_bready = Input(Bool()) + val s_axib_bvalid = Output(Bool()) + val s_axib_bid = Output(UInt(sbus.idBits.W)) + val s_axib_bresp = Output(UInt(2.W)) + + // S.R + val s_axib_rready = Input(Bool()) + val s_axib_rvalid = Output(Bool()) + val s_axib_rid = Output(UInt(sbus.idBits.W)) + val s_axib_rdata = Output(UInt(sbus.dataBits.W)) + val s_axib_rresp = Output(UInt(2.W)) + val s_axib_rlast = Output(Bool()) + + // SL.AW + val s_axil_awready = Output(Bool()) + val s_axil_awvalid = Input(Bool()) + val s_axil_awaddr = Input(UInt(slbus.addrBits.W)) + val s_axil_awprot = Input(UInt(3.W)) + + // SL.AR + val s_axil_arready = Output(Bool()) + val s_axil_arvalid = Input(Bool()) + val s_axil_araddr = Input(UInt(slbus.addrBits.W)) + val s_axil_arprot = Input(UInt(3.W)) + + // SL.W + val s_axil_wready = Output(Bool()) + val s_axil_wvalid = Input(Bool()) + val s_axil_wdata = Input(UInt(slbus.dataBits.W)) + val s_axil_wstrb = Input(UInt(slbus.dataBytes.W)) + + // SL.B + val s_axil_bready = Input(Bool()) + val s_axil_bvalid = Output(Bool()) + val s_axil_bresp = Output(UInt(2.W)) + + // SL.R + val s_axil_rready = Input(Bool()) + val s_axil_rvalid = Output(Bool()) + val s_axil_rdata = Output(UInt(slbus.dataBits.W)) + val s_axil_rresp = Output(UInt(2.W)) +} + +class XDMABlackBoxIO( + val lanes: Int, + val mbus: XDMABusParams, + val sbus: XDMABusParams, + val slbus: XDMABusParams) extends Bundle + with HasXDMAPads + with HasXDMAClocks + with HasXDMAJunk + with HasXDMABus + +class XDMAPads(val lanes: Int) extends Bundle with HasXDMAPads +class XDMAClocks() extends Bundle with HasXDMAClocks + +case class XDMAParams( + name: String, + location: String, + bars: Seq[AddressSet], + control: BigInt, + lanes: Int = 1, + gen: Int = 3, + addrBits: Int = 64, + mIDBits: Int = 4, + sIDBits: Int = 4) +{ + require (!bars.isEmpty) + require (lanes >= 1 && lanes <= 16 && isPow2(lanes)) + require (gen >= 1 && gen <= 3) + require (addrBits == 32 || addrBits == 64) + require (mIDBits >= 1 && mIDBits <= 8) + require (sIDBits >= 1 && sIDBits <= 8) + bars.foreach { a => require (a.max >> addrBits == 0) } + + private val bandwidth = lanes * 250 << (gen-1) // MB/s + private val busBytesAt250MHz = bandwidth / 250 + val busBytes = busBytesAt250MHz max 8 + private val minMHz = 250.0 * busBytesAt250MHz / busBytes + val axiMHz = minMHz max 62.5 + + val ecamSize = 0x4000000 + val ecamMask = ecamSize - 1 + require ((control & ecamMask) == 0) +} + +class XDMABlackBox(c: XDMAParams) extends BlackBox +{ + override def desiredName = c.name + + val mbus = XDMABusParams(c.mIDBits, c.addrBits, c.busBytes) + val sbus = XDMABusParams(c.sIDBits, c.addrBits, c.busBytes) + val slbus = XDMABusParams(0, 32, 4) + + val io = IO(new XDMABlackBoxIO(c.lanes, mbus, sbus, slbus)) + val pcieGTs = c.gen match { + case 1 => "2.5_GT/s" + case 2 => "5.0_GT/s" + case 3 => "8.0_GT/s" + case _ => "wrong" + } + + // 62.5, 125, 250 (no trailing zeros) + val formatter = new java.text.DecimalFormat("0.###") + val axiMHzStr = formatter.format(c.axiMHz) + + val bars = c.bars.zipWithIndex.map { case (a, i) => + f""" CONFIG.axibar_${i} {0x${a.base}%X} \\ + | CONFIG.axibar_highaddr_${i} {0x${a.max}%X} \\ + | CONFIG.axibar2pciebar_${i} {0x${a.base}%X} \\ + |""".stripMargin + } + + ElaborationArtefacts.add(s"${desiredName}.vivado.tcl", + s"""create_ip -vendor xilinx.com -library ip -version 4.1 -name xdma -module_name ${desiredName} -dir $$ipdir -force + |set_property -dict [list \\ + | CONFIG.functional_mode {AXI_Bridge} \\ + | CONFIG.pcie_blk_locn {${c.location}} \\ + | CONFIG.device_port_type {Root_Port_of_PCI_Express_Root_Complex} \\ + | CONFIG.pf0_bar0_enabled {false} \\ + | CONFIG.pf0_sub_class_interface_menu {PCI_to_PCI_bridge} \\ + | CONFIG.ref_clk_freq {100_MHz} \\ + | CONFIG.pl_link_cap_max_link_width {X${c.lanes}} \\ + | CONFIG.pl_link_cap_max_link_speed {${pcieGTs}} \\ + | CONFIG.msi_rx_pin_en {true} \\ + | CONFIG.axisten_freq {${axiMHzStr}} \\ + | CONFIG.axi_addr_width {${c.addrBits}} \\ + | CONFIG.axi_data_width {${c.busBytes*8}_bit} \\ + | CONFIG.axi_id_width {${c.mIDBits}} \\ + | CONFIG.s_axi_id_width {${c.sIDBits}} \\ + | CONFIG.axibar_num {${c.bars.size}} \\ + |${bars.mkString}] [get_ips ${desiredName}] + |""".stripMargin) +} + +class DiplomaticXDMA(c: XDMAParams)(implicit p:Parameters) extends LazyModule +{ + val device = new SimpleDevice("pci", Seq("xlnx,xdma-host-3.00")) { + override def describe(resources: ResourceBindings): Description = { + val Description(name, mapping) = super.describe(resources) + val intc = s"${c.name}_intc" + def ofInt(x: Int) = Seq(ResourceInt(BigInt(x))) + def ofMap(x: Int) = Seq(0, 0, 0, x).flatMap(ofInt) ++ Seq(ResourceReference(intc)) ++ ofInt(x) + val extra = Map( + "#address-cells" -> ofInt(3), + "#size-cells" -> ofInt(2), + "#interrupt-cells" -> ofInt(1), + "device_type" -> Seq(ResourceString("pci")), + "interrupt-names" -> Seq("misc", "msi0", "msi1").map(ResourceString.apply _), + "interrupt-map-mask" -> Seq(0, 0, 0, 7).flatMap(ofInt), + "interrupt-map" -> Seq(1, 2, 3, 4).flatMap(ofMap), + "ranges" -> resources("ranges").map(x => + (x: @unchecked) match { case Binding(_, ResourceAddress(address, perms)) => + ResourceMapping(address, BigInt(0x02000000) << 64, perms) }), + "interrupt-controller" -> Seq(ResourceMap(labels = Seq(intc), value = Map( + "interrupt-controller" -> Nil, + "#address-cells" -> ofInt(0), + "#interrupt-cells" -> ofInt(1))))) + Description(name, mapping ++ extra) + } + } + + val slave = AXI4SlaveNode(Seq(AXI4SlavePortParameters( + slaves = Seq(AXI4SlaveParameters( + address = c.bars, + resources = Seq(Resource(device, "ranges")), + executable = true, + supportsWrite = TransferSizes(1, 128), + supportsRead = TransferSizes(1, 128))), + beatBytes = c.busBytes))) + + val control = AXI4SlaveNode(Seq(AXI4SlavePortParameters( + slaves = Seq(AXI4SlaveParameters( + address = List(AddressSet(c.control, c.ecamMask)), + resources = device.reg("control"), + supportsWrite = TransferSizes(1, 4), + supportsRead = TransferSizes(1, 4), + interleavedId = Some(0))), // AXI4-Lite never interleaves responses + beatBytes = 4))) + + val master = AXI4MasterNode(Seq(AXI4MasterPortParameters( + masters = Seq(AXI4MasterParameters( + name = c.name, + id = IdRange(0, 1 << c.mIDBits), + aligned = false))))) + + val intnode = IntSourceNode(IntSourcePortSimple(num = 3, resources = device.int)) + + lazy val module = new LazyRawModuleImp(this) { + // The master on the control port must be AXI-lite + require (control.edges.in(0).master.endId == 1) + // Must have the right number of slave idBits + require (slave.edges.in(0).bundle.idBits <= c.sIDBits) + // Must have the right bus width + require (master.edges.out(0).slave.beatBytes == c.busBytes) + + val io = IO(new Bundle { + val pads = new XDMAPads(c.lanes) + val clocks = new XDMAClocks + }) + + val blackbox = Module(new XDMABlackBox(c)) + + val (s, _) = slave.in(0) + val (t, _) = control.in(0) + val (m, _) = master.out(0) + val (i, _) = intnode.out(0) + + // Pads + io.pads.pci_exp_txp := blackbox.io.pci_exp_txp + io.pads.pci_exp_txn := blackbox.io.pci_exp_txn + blackbox.io.pci_exp_rxp := io.pads.pci_exp_rxp + blackbox.io.pci_exp_rxn := io.pads.pci_exp_rxn + + // Clocks + blackbox.io.sys_clk := io.clocks.sys_clk + blackbox.io.sys_clk_gt := io.clocks.sys_clk_gt + blackbox.io.sys_rst_n := io.clocks.sys_rst_n + io.clocks.axi_aclk := blackbox.io.axi_aclk + io.clocks.axi_aresetn := blackbox.io.axi_aresetn + + // I + i(0) := blackbox.io.interrupt_out + i(1) := blackbox.io.interrupt_out_msi_vec0to31 + i(2) := blackbox.io.interrupt_out_msi_vec32to63 + + // M.AW + blackbox.io.m_axib_awready := m.aw.ready + m.aw.valid := blackbox.io.m_axib_awvalid + m.aw.bits.id := blackbox.io.m_axib_awid + m.aw.bits.addr := blackbox.io.m_axib_awaddr + m.aw.bits.len := blackbox.io.m_axib_awlen + m.aw.bits.size := blackbox.io.m_axib_awsize + m.aw.bits.burst := blackbox.io.m_axib_awburst + m.aw.bits.prot := blackbox.io.m_axib_awprot + m.aw.bits.cache := blackbox.io.m_axib_awcache + m.aw.bits.lock := blackbox.io.m_axib_awlock + m.aw.bits.qos := 0.U + + // M.AR + blackbox.io.m_axib_arready := m.ar.ready + m.ar.valid := blackbox.io.m_axib_arvalid + m.ar.bits.id := blackbox.io.m_axib_arid + m.ar.bits.addr := blackbox.io.m_axib_araddr + m.ar.bits.len := blackbox.io.m_axib_arlen + m.ar.bits.size := blackbox.io.m_axib_arsize + m.ar.bits.burst := blackbox.io.m_axib_arburst + m.ar.bits.prot := blackbox.io.m_axib_arprot + m.ar.bits.cache := blackbox.io.m_axib_arcache + m.ar.bits.lock := blackbox.io.m_axib_arlock + m.ar.bits.qos := 0.U + + // M.W + blackbox.io.m_axib_wready := m.w.ready + m.w.valid := blackbox.io.m_axib_wvalid + m.w.bits.data := blackbox.io.m_axib_wdata + m.w.bits.strb := blackbox.io.m_axib_wstrb + m.w.bits.last := blackbox.io.m_axib_wlast + + // M.B + m.b.ready := blackbox.io.m_axib_bready + blackbox.io.m_axib_bvalid := m.b.valid + blackbox.io.m_axib_bid := m.b.bits.id + blackbox.io.m_axib_bresp := m.b.bits.resp + + // M.R + m.r.ready := blackbox.io.m_axib_rready + blackbox.io.m_axib_rvalid := m.r.valid + blackbox.io.m_axib_rid := m.r.bits.id + blackbox.io.m_axib_rdata := m.r.bits.data + blackbox.io.m_axib_rresp := m.r.bits.resp + blackbox.io.m_axib_rlast := m.r.bits.last + + // S.AW + s.aw.ready := blackbox.io.s_axib_awready + blackbox.io.s_axib_awvalid := s.aw.valid + blackbox.io.s_axib_awid := s.aw.bits.id + blackbox.io.s_axib_awaddr := s.aw.bits.addr + blackbox.io.s_axib_awregion := 0.U + blackbox.io.s_axib_awlen := s.aw.bits.len + blackbox.io.s_axib_awsize := s.aw.bits.size + blackbox.io.s_axib_awburst := s.aw.bits.burst + + // S.AR + s.ar.ready := blackbox.io.s_axib_arready + blackbox.io.s_axib_arvalid := s.ar.valid + blackbox.io.s_axib_arid := s.ar.bits.id + blackbox.io.s_axib_araddr := s.ar.bits.addr + blackbox.io.s_axib_arregion := 0.U + blackbox.io.s_axib_arlen := s.ar.bits.len + blackbox.io.s_axib_arsize := s.ar.bits.size + blackbox.io.s_axib_arburst := s.ar.bits.burst + + // S.W + s.w.ready := blackbox.io.s_axib_wready + blackbox.io.s_axib_wvalid := s.w.valid + blackbox.io.s_axib_wdata := s.w.bits.data + blackbox.io.s_axib_wstrb := s.w.bits.strb + blackbox.io.s_axib_wlast := s.w.bits.last + + // S.B + blackbox.io.s_axib_bready := s.b.ready + s.b.valid := blackbox.io.s_axib_bvalid + s.b.bits.id := blackbox.io.s_axib_bid + s.b.bits.resp := blackbox.io.s_axib_bresp + + // S.R + blackbox.io.s_axib_rready := s.r.ready + s.r.valid := blackbox.io.s_axib_rvalid + s.r.bits.id := blackbox.io.s_axib_rid + s.r.bits.data := blackbox.io.s_axib_rdata + s.r.bits.resp := blackbox.io.s_axib_rresp + s.r.bits.last := blackbox.io.s_axib_rlast + + // SL.AW + t.aw.ready := blackbox.io.s_axil_awready + blackbox.io.s_axil_awvalid := t.aw.valid + blackbox.io.s_axil_awaddr := t.aw.bits.addr & c.ecamMask.U + blackbox.io.s_axil_awprot := t.aw.bits.prot + + // SL.AR + t.ar.ready := blackbox.io.s_axil_arready + blackbox.io.s_axil_arvalid := t.ar.valid + blackbox.io.s_axil_araddr := t.ar.bits.addr & c.ecamMask.U + blackbox.io.s_axil_arprot := t.ar.bits.prot + + // SL.W + t.w.ready := blackbox.io.s_axil_wready + blackbox.io.s_axil_wvalid := t.w.valid + blackbox.io.s_axil_wdata := t.w.bits.data + blackbox.io.s_axil_wstrb := t.w.bits.strb + + // SL.B + blackbox.io.s_axil_bready := t.b.ready + t.b.valid := blackbox.io.s_axil_bvalid + t.b.bits.id := 0.U + t.b.bits.resp := blackbox.io.s_axil_bresp + + // SL.R + blackbox.io.s_axil_rready := t.r.ready + t.r.valid := blackbox.io.s_axil_rvalid + t.r.bits.id := 0.U + t.r.bits.data := blackbox.io.s_axil_rdata + t.r.bits.resp := blackbox.io.s_axil_rresp + t.r.bits.last := true.B + } +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/ip/xilinx/xxv_ethernet/nfmac10g.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/ip/xilinx/xxv_ethernet/nfmac10g.scala new file mode 100644 index 0000000..2ddddcf --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/ip/xilinx/xxv_ethernet/nfmac10g.scala @@ -0,0 +1,52 @@ +// See LICENSE for license details. +package sifive.fpgashells.ip.xilinx.xxv_ethernet + +import chisel3._ +import chisel3.util._ +import freechips.rocketchip.config._ +import freechips.rocketchip.diplomacy._ + +class nfmac10g extends BlackBox { + val io = IO(new Bundle { + val tx_clk0 = Input(Clock()) + val rx_clk0 = Input(Clock()) + val reset = Input(Bool()) + val tx_dcm_locked = Input(Bool()) + val rx_dcm_locked = Input(Bool()) + + // XGMII + val xgmii_txd = Output(UInt(64.W)) + val xgmii_txc = Output(UInt(8.W)) + val xgmii_rxd = Input (UInt(64.W)) + val xgmii_rxc = Input (UInt(8.W)) + + // Tx AXIS + val tx_axis_aresetn = Input (Bool()) + val tx_axis_tready = Output(Bool()) + val tx_axis_tvalid = Input (Bool()) + val tx_axis_tlast = Input (Bool()) + val tx_axis_tdata = Input (UInt(64.W)) + val tx_axis_tkeep = Input (UInt(8.W)) + val tx_axis_tuser = Input (UInt(1.W)) + + // Rx AXIS + val rx_axis_aresetn = Input (Bool()) + val rx_axis_tvalid = Output(Bool()) + val rx_axis_tlast = Output(Bool()) + val rx_axis_tdata = Output(UInt(64.W)) + val rx_axis_tkeep = Output(UInt(8.W)) + val rx_axis_tuser = Output(UInt(1.W)) + + // Unused by nfmac10g + val tx_ifg_delay = Input(UInt(8.W)) + val pause_val = Input(UInt(16.W)) + val pause_req = Input(Bool()) + val tx_configuration_vector = Input(UInt(80.W)) + val rx_configuration_vector = Input(UInt(80.W)) + val status_vector = Output(UInt(2.W)) + val tx_statistics_vector = Output(UInt(26.W)) + val tx_statistics_valid = Output(Bool()) + val rx_statistics_vector = Output(UInt(30.W)) + val rx_statistics_valid = Output(Bool()) + }) +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/ip/xilinx/xxv_ethernet/xxv_ethernet.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/ip/xilinx/xxv_ethernet/xxv_ethernet.scala new file mode 100644 index 0000000..47d75e7 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/ip/xilinx/xxv_ethernet/xxv_ethernet.scala @@ -0,0 +1,177 @@ +// See LICENSE for license details. +package sifive.fpgashells.ip.xilinx.xxv_ethernet + +import chisel3._ +import chisel3.util._ +import freechips.rocketchip.config._ +import freechips.rocketchip.diplomacy._ +import freechips.rocketchip.amba.axi4._ +import freechips.rocketchip.util.{ElaborationArtefacts} + +trait HasXXVEthernetPads { + val gt_txp_out_0 = Output(Bool()) + val gt_txn_out_0 = Output(Bool()) + val gt_rxp_in_0 = Input(Bool()) + val gt_rxn_in_0 = Input(Bool()) + val gt_refclk_p = Input(Clock()) + val gt_refclk_n = Input(Clock()) +} + +trait HasXXVEthernetClocks { + val rx_core_clk_0 = Input (Clock()) // >= 156.25MHz ... maybe core clock to avoid another crossing? + val tx_mii_clk_0 = Output(Clock()) // TX data path + + val sys_reset = Input(Bool()) + val dclk = Input(Clock()) // free-running fsm clock + + val user_rx_reset_0 = Output(Bool()) + val user_tx_reset_0 = Output(Bool()) +} + +trait HasXXVEthernetMAC { + val rx_mii_d_0 = Output(UInt(64.W)) + val tx_mii_d_0 = Input (UInt(64.W)) + val rx_mii_c_0 = Output(UInt(8.W)) + val tx_mii_c_0 = Input (UInt(8.W)) + + val gt_loopback_in_0 = Input(UInt(3.W)) + val stat_rx_block_lock_0 = Output(Bool()) +} + +trait HasXXVEthernetJunk { + // Unused loopback test stuff + val ctl_rx_test_pattern_0 = Input(Bool()) + val ctl_rx_test_pattern_enable_0 = Input(Bool()) + val ctl_rx_data_pattern_select_0 = Input(Bool()) + val ctl_rx_prbs31_test_pattern_enable_0 = Input(Bool()) + + val ctl_tx_test_pattern_0 = Input(Bool()) + val ctl_tx_test_pattern_enable_0 = Input(Bool()) + val ctl_tx_test_pattern_select_0 = Input(Bool()) + val ctl_tx_data_pattern_select_0 = Input(Bool()) + val ctl_tx_test_pattern_seed_a_0 = Input(UInt(58.W)) + val ctl_tx_test_pattern_seed_b_0 = Input(UInt(58.W)) + val ctl_tx_prbs31_test_pattern_enable_0 = Input(Bool()) + + // Drive these always to 0 + val rx_reset_0 = Input(Bool()) + val tx_reset_0 = Input(Bool()) + val gtwiz_reset_tx_datapath_0 = Input(Bool()) + val gtwiz_reset_rx_datapath_0 = Input(Bool()) + + val gtpowergood_out_0 = Output(Bool()) + val gt_refclk_out = Output(Clock()) // 156.25MHz from xcvr refclk pads + val rx_clk_out_0 = Output(Clock()) // RX control+status signals + val rxrecclkout_0 = Output(Clock()) + + // Drive these always to 3'b101 as per documentation + val txoutclksel_in_0 = Input(UInt(3.W)) + val rxoutclksel_in_0 = Input(UInt(3.W)) + + val stat_rx_framing_err_valid_0 = Output(Bool()) + val stat_rx_framing_err_0 = Output(Bool()) + val stat_rx_hi_ber_0 = Output(Bool()) + val stat_rx_valid_ctrl_code_0 = Output(Bool()) + val stat_rx_bad_code_0 = Output(Bool()) + val stat_rx_bad_code_valid_0 = Output(Bool()) + val stat_rx_error_valid_0 = Output(Bool()) + val stat_rx_error_0 = Output(UInt(8.W)) + val stat_rx_fifo_error_0 = Output(Bool()) + val stat_rx_local_fault_0 = Output(Bool()) + val stat_rx_status_0 = Output(Bool()) + val stat_tx_local_fault_0 = Output(Bool()) +} + +class XXVEthernetBlackBoxIO extends Bundle + with HasXXVEthernetPads + with HasXXVEthernetClocks + with HasXXVEthernetMAC + with HasXXVEthernetJunk + +class XXVEthernetPads() extends Bundle with HasXXVEthernetPads +class XXVEthernetMAC() extends Bundle with HasXXVEthernetMAC +class XXVEthernetClocks() extends Bundle with HasXXVEthernetClocks + +case class XXVEthernetParams( + name: String, + speed: Int, + dclkMHz: Double) +{ + require (speed == 10 || speed == 25) + val refMHz = if (speed == 10) 156.25 else 161.1328125 +} + +class XXVEthernetBlackBox(c: XXVEthernetParams) extends BlackBox +{ + override def desiredName = c.name + + val io = IO(new XXVEthernetBlackBoxIO) + + ElaborationArtefacts.add(s"${desiredName}.vivado.tcl", + s"""create_ip -vendor xilinx.com -library ip -version 2.4 -name xxv_ethernet -module_name ${desiredName} -dir $$ipdir -force + |set_property -dict [list \\ + | CONFIG.NUM_OF_CORES {1} \\ + | CONFIG.CORE {Ethernet PCS/PMA 64-bit} \\ + | CONFIG.BASE_R_KR {BASE-R} \\ + | CONFIG.LINE_RATE {${c.speed}} \\ + | CONFIG.GT_REF_CLK_FREQ {${c.refMHz}} \\ + | CONFIG.GT_DRP_CLK {${c.dclkMHz}} \\ + |] [get_ips ${desiredName}] + |""".stripMargin) +} + +class DiplomaticXXVEthernet(c: XXVEthernetParams)(implicit p:Parameters) extends LazyModule +{ + lazy val module = new LazyRawModuleImp(this) { + val io = IO(new Bundle { + val pads = new XXVEthernetPads + val mac = new XXVEthernetMAC + val clocks = new XXVEthernetClocks + }) + + val blackbox = Module(new XXVEthernetBlackBox(c)) + + // pads + io.pads.gt_txp_out_0 := blackbox.io.gt_txp_out_0 + io.pads.gt_txn_out_0 := blackbox.io.gt_txn_out_0 + blackbox.io.gt_rxp_in_0 := io.pads.gt_rxp_in_0 + blackbox.io.gt_rxn_in_0 := io.pads.gt_rxn_in_0 + blackbox.io.gt_refclk_p := io.pads.gt_refclk_p + blackbox.io.gt_refclk_n := io.pads.gt_refclk_n + + // clocks + io.clocks.tx_mii_clk_0 := blackbox.io.tx_mii_clk_0 + io.clocks.user_rx_reset_0 := blackbox.io.user_rx_reset_0 + io.clocks.user_tx_reset_0 := blackbox.io.user_tx_reset_0 + blackbox.io.rx_core_clk_0 := io.clocks.rx_core_clk_0 + blackbox.io.sys_reset := io.clocks.sys_reset + blackbox.io.dclk := io.clocks.dclk + + // MAC + blackbox.io.tx_mii_d_0 := io.mac.tx_mii_d_0 + blackbox.io.tx_mii_c_0 := io.mac.tx_mii_c_0 + io.mac.rx_mii_d_0 := blackbox.io.rx_mii_d_0 + io.mac.rx_mii_c_0 := blackbox.io.rx_mii_c_0 + blackbox.io.gt_loopback_in_0 := io.mac.gt_loopback_in_0 + io.mac.stat_rx_block_lock_0 := blackbox.io.stat_rx_block_lock_0 + + // Junk + blackbox.io.txoutclksel_in_0 := 5.U + blackbox.io.rxoutclksel_in_0 := 5.U + blackbox.io.rx_reset_0 := io.clocks.sys_reset + blackbox.io.tx_reset_0 := io.clocks.sys_reset + blackbox.io.gtwiz_reset_tx_datapath_0 := io.clocks.sys_reset + blackbox.io.gtwiz_reset_rx_datapath_0 := io.clocks.sys_reset + blackbox.io.ctl_rx_test_pattern_0 := false.B + blackbox.io.ctl_rx_test_pattern_enable_0 := false.B + blackbox.io.ctl_rx_data_pattern_select_0 := false.B + blackbox.io.ctl_rx_prbs31_test_pattern_enable_0 := false.B + blackbox.io.ctl_tx_test_pattern_0 := false.B + blackbox.io.ctl_tx_test_pattern_enable_0 := false.B + blackbox.io.ctl_tx_test_pattern_select_0 := false.B + blackbox.io.ctl_tx_data_pattern_select_0 := false.B + blackbox.io.ctl_tx_test_pattern_seed_a_0 := 0.U + blackbox.io.ctl_tx_test_pattern_seed_b_0 := 0.U + blackbox.io.ctl_tx_prbs31_test_pattern_enable_0 := false.B + } +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/ButtonOverlay.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/ButtonOverlay.scala new file mode 100644 index 0000000..df7021c --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/ButtonOverlay.scala @@ -0,0 +1,28 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell + +import chisel3._ +import freechips.rocketchip.config._ +import freechips.rocketchip.diplomacy._ + +case class ButtonShellInput( + header: String = "", + number: Int = 0) + +case class ButtonDesignInput()(implicit val p: Parameters) +case class ButtonOverlayOutput(but: ModuleValue[Bool]) +case object ButtonOverlayKey extends Field[Seq[DesignPlacer[ButtonDesignInput, ButtonShellInput, ButtonOverlayOutput]]](Nil) +trait ButtonShellPlacer[Shell] extends ShellPlacer[ButtonDesignInput, ButtonShellInput, ButtonOverlayOutput] + +abstract class ButtonPlacedOverlay( + val name: String, val di: ButtonDesignInput, si:ButtonShellInput) + extends IOPlacedOverlay[Bool, ButtonDesignInput, ButtonShellInput, ButtonOverlayOutput] +{ + implicit val p = di.p + + def ioFactory = Input(Bool()) + + val buttonSource = shell { BundleBridgeSource(() => Bool()) } + val buttonSink = buttonSource.makeSink() + def overlayOutput = ButtonOverlayOutput(but = InModuleBody { buttonSink.bundle }) +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/CTSResetOverlay.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/CTSResetOverlay.scala new file mode 100644 index 0000000..fa2762e --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/CTSResetOverlay.scala @@ -0,0 +1,23 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell + +import chisel3._ +import freechips.rocketchip.config._ +import freechips.rocketchip.diplomacy._ + +//Core-To-Shell Reset Overlay: No IOs, but passes a Bool into the shell to be orred into the pllReset, allowing core signals to reset the shell + +case class CTSResetShellInput() +case class CTSResetDesignInput(rst: Bool)(implicit val p: Parameters) +case class CTSResetOverlayOutput() +case object CTSResetOverlayKey extends Field[Seq[DesignPlacer[CTSResetDesignInput, CTSResetShellInput, CTSResetOverlayOutput]]](Nil) +trait CTSResetShellPlacer[Shell] extends ShellPlacer[CTSResetDesignInput, CTSResetShellInput, CTSResetOverlayOutput] + +abstract class CTSResetPlacedOverlay( + val name: String, val di: CTSResetDesignInput, si: CTSResetShellInput) + extends PlacedOverlay[CTSResetDesignInput, CTSResetShellInput, CTSResetOverlayOutput] +{ + implicit val p = di.p + + def overlayOutput = CTSResetOverlayOutput() +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/ChipLinkOverlay.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/ChipLinkOverlay.scala new file mode 100644 index 0000000..290f0d0 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/ChipLinkOverlay.scala @@ -0,0 +1,58 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell + +import chisel3._ +import freechips.rocketchip.config._ +import freechips.rocketchip.diplomacy._ +import freechips.rocketchip.tilelink._ +import sifive.blocks.devices.chiplink._ +import sifive.fpgashells.clocks._ + +case class ChipLinkShellInput( + fmc: String = "") + +case class ChipLinkDesignInput( + di: ChipLinkParams, + txGroup: ClockGroupNode, + txData: ClockSinkNode, + wrangler: ClockAdapterNode)( + implicit val p: Parameters) + +case class ChipLinkOverlayOutput(node: TLNode) +case object ChipLinkOverlayKey extends Field[Seq[DesignPlacer[ChipLinkDesignInput, ChipLinkShellInput, ChipLinkOverlayOutput]]](Nil) +trait ChipLinkShellPlacer[Shell] extends ShellPlacer[ChipLinkDesignInput, ChipLinkShellInput, ChipLinkOverlayOutput] + +abstract class ChipLinkPlacedOverlay( + val name: String, + val di: ChipLinkDesignInput, + val si: ChipLinkShellInput, + val rxPhase: Double, + val txPhase: Double) + extends IOPlacedOverlay[WideDataLayerPort, ChipLinkDesignInput, ChipLinkShellInput, ChipLinkOverlayOutput] +{ + implicit val p = di.p + val freqMHz = di.txData.portParams.head.take.get.freqMHz + val phaseDeg = di.txData.portParams.head.phaseDeg + + def fpgaReset = false + val link = LazyModule(new ChipLink(di.di.copy(fpgaReset = fpgaReset))) + val rxPLL = p(PLLFactoryKey)(feedback = true) + val ioSink = shell { link.ioNode.makeSink() } + val rxI = shell { ClockSourceNode(freqMHz = freqMHz, jitterPS = 100) } + val rxGroup = shell { ClockGroup() } + val rxO = shell { ClockSinkNode(freqMHz = freqMHz, phaseDeg = rxPhase) } + val txClock = shell { ClockSinkNode(freqMHz = freqMHz, phaseDeg = phaseDeg + txPhase) } + + rxO := di.wrangler := rxGroup := rxPLL := rxI + txClock := di.wrangler := di.txGroup + + def overlayOutput = ChipLinkOverlayOutput(node = link.node) + def ioFactory = new WideDataLayerPort(ChipLinkParams(Nil,Nil)) + + shell { InModuleBody { + val (rxOut, _) = rxO.in(0) + val port = ioSink.bundle + io <> port + port.b2c.clk := rxOut.clock + } } +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/ClockOverlay.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/ClockOverlay.scala new file mode 100644 index 0000000..b2fce1d --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/ClockOverlay.scala @@ -0,0 +1,81 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell + +import chisel3._ +import freechips.rocketchip.config._ +import freechips.rocketchip.diplomacy._ +import sifive.fpgashells.clocks._ + +case class ClockInputShellInput() +case class ClockOutputShellInput() +case class ClockInputDesignInput()(implicit val p: Parameters) +case class ClockOutputDesignInput()(implicit val p: Parameters) +case class ClockInputOverlayOutput(node: ClockSourceNode) +case class ClockOutputOverlayOutput(clock: ClockSinkNode) + +trait ClockInputShellPlacer[Shell] extends ShellPlacer[ClockInputDesignInput, ClockInputShellInput, ClockInputOverlayOutput] +trait ClockOutputShellPlacer[Shell] extends ShellPlacer[ClockOutputDesignInput, ClockOutputShellInput, ClockOutputOverlayOutput] + +case object ClockInputOverlayKey extends Field[Seq[DesignPlacer[ClockInputDesignInput, ClockInputShellInput, ClockInputOverlayOutput]]](Nil) +case object ClockOutputOverlayKey extends Field[Seq[DesignPlacer[ClockOutputDesignInput, ClockOutputShellInput, ClockOutputOverlayOutput]]](Nil) + +class LVDSClock extends Bundle +{ + val p = Clock() + val n = Clock() +} + +abstract class LVDSClockInputPlacedOverlay( + val name: String, val di: ClockInputDesignInput, val si: ClockInputShellInput) + extends IOPlacedOverlay[LVDSClock, ClockInputDesignInput, ClockInputShellInput, ClockInputOverlayOutput] +{ + implicit val p = di.p + def node: ClockSourceNode + + def ioFactory = Input(new LVDSClock) + + val clock = shell { InModuleBody { + val (bundle, edge) = node.out.head + shell.sdc.addClock(name, io.p, edge.clock.freqMHz) + bundle.clock + } } + def overlayOutput = ClockInputOverlayOutput(node) +} + + +abstract class SingleEndedClockInputPlacedOverlay( + val name: String, val di: ClockInputDesignInput, val si: ClockInputShellInput) + extends IOPlacedOverlay[Clock, ClockInputDesignInput, ClockInputShellInput, ClockInputOverlayOutput] +{ + implicit val p = di.p + def node: ClockSourceNode + + def ioFactory = Input(Clock()) + + val clock = shell { InModuleBody { + val (bundle, edge) = node.out.head + shell.sdc.addClock(name, io:Clock, edge.clock.freqMHz) + bundle.clock + } } + def overlayOutput = ClockInputOverlayOutput(node) +} + +abstract class SingleEndedClockBundleInputPlacedOverlay( + val name: String, val di: ClockInputDesignInput, val si: ClockInputShellInput) + extends IOPlacedOverlay[ClockBundle, ClockInputDesignInput, ClockInputShellInput, ClockInputOverlayOutput] +{ + implicit val p = di.p + def node: ClockSourceNode + + def ioFactory = Input(new ClockBundle(ClockBundleParameters())) + + val clock = shell { InModuleBody { + val (bundle, edge) = node.out.head + bundle.clock + } } + val reset = shell { InModuleBody { + val (bundle, edge) = node.out.head + bundle.reset + } } + def overlayOutput = ClockInputOverlayOutput(node) +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/DDROverlay.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/DDROverlay.scala new file mode 100644 index 0000000..be0ed9e --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/DDROverlay.scala @@ -0,0 +1,27 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell + +import chisel3._ +import freechips.rocketchip.config._ +import freechips.rocketchip.diplomacy._ +import freechips.rocketchip.tilelink._ +import sifive.fpgashells.clocks._ + + +case class DDRShellInput() +case class DDRDesignInput( + baseAddress: BigInt, + wrangler: ClockAdapterNode, + corePLL: PLLNode, + vc7074gbdimm: Boolean = false)( + implicit val p: Parameters) +case class DDROverlayOutput(ddr: TLInwardNode) +trait DDRShellPlacer[Shell] extends ShellPlacer[DDRDesignInput, DDRShellInput, DDROverlayOutput] + +case object DDROverlayKey extends Field[Seq[DesignPlacer[DDRDesignInput, DDRShellInput, DDROverlayOutput]]](Nil) + +abstract class DDRPlacedOverlay[IO <: Data](val name: String, val di: DDRDesignInput, val si: DDRShellInput) + extends IOPlacedOverlay[IO, DDRDesignInput, DDRShellInput, DDROverlayOutput] +{ + implicit val p = di.p +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/Ethernet.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/Ethernet.scala new file mode 100644 index 0000000..7ab9ff4 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/Ethernet.scala @@ -0,0 +1,51 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell + +import chisel3._ +import freechips.rocketchip.config._ +import freechips.rocketchip.diplomacy._ +import sifive.blocks.devices.uart._ +import freechips.rocketchip.subsystem.{BaseSubsystem, PeripheryBus, PeripheryBusKey} +import freechips.rocketchip.tilelink.TLBusWrapper +import freechips.rocketchip.interrupts.IntInwardNode + +case class EthernetShellInput() +case class EthernetDesignInput()(implicit val p: Parameters) +case class EthernetOverlayOutput(eth: ModuleValue[EthernetPCS]) +case object EthernetOverlayKey extends Field[Seq[DesignPlacer[EthernetDesignInput, EthernetShellInput, EthernetOverlayOutput]]](Nil) +trait EthernetShellPlacer[Shell] extends ShellPlacer[EthernetDesignInput, EthernetShellInput, EthernetOverlayOutput] + +class EthernetPads extends Bundle { + val tx_p = Output(Bool()) + val tx_n = Output(Bool()) + val rx_p = Input(Bool()) + val rx_n = Input(Bool()) + val refclk_p = Input(Clock()) + val refclk_n = Input(Clock()) +} + +class EthernetPCS extends Bundle { + val rx_clock = Output(Clock()) + val rx_reset = Output(Bool()) + val rx_d = Output(UInt(64.W)) + val rx_c = Output(UInt(8.W)) + val tx_clock = Output(Clock()) + val tx_reset = Output(Bool()) + val tx_d = Input(UInt(64.W)) + val tx_c = Input(UInt(8.W)) + val loopback = Input(UInt(3.W)) + val rx_lock = Output(Bool()) + val sfp_detect = Output(Bool()) +} + +abstract class EthernetPlacedOverlay( + val name: String, val di: EthernetDesignInput, val si: EthernetShellInput) + extends IOPlacedOverlay[EthernetPads, EthernetDesignInput, EthernetShellInput, EthernetOverlayOutput] +{ + implicit val p = di.p + + val pcsPads = InModuleBody { Wire(new EthernetPCS) } + + def ioFactory = new EthernetPads + def overlayOutput = EthernetOverlayOutput(eth = pcsPads) +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/GPIOOverlay.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/GPIOOverlay.scala new file mode 100644 index 0000000..d3d575b --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/GPIOOverlay.scala @@ -0,0 +1,35 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell + +import chisel3._ +import freechips.rocketchip.config._ +import freechips.rocketchip.diplomacy._ +import sifive.blocks.devices.gpio._ +import freechips.rocketchip.tilelink.TLBusWrapper +import freechips.rocketchip.interrupts.IntInwardNode +import chisel3.experimental.Analog + +//Might delete later... +//Should GPIO be an overlay? Probably not, PinOverlay might take over this use case +//Plus this should NOT place the controller +case class GPIOShellInput() +case class GPIODesignInput(gpioParam: GPIOParams, controlBus: TLBusWrapper, intNode: IntInwardNode)(implicit val p: Parameters) +case class GPIOOverlayOutput(gpio: TLGPIO) +case object GPIOOverlayKey extends Field[Seq[DesignPlacer[GPIODesignInput, GPIOShellInput, GPIOOverlayOutput]]](Nil) +trait GPIOShellPlacer[Shell] extends ShellPlacer[GPIODesignInput, GPIOShellInput, GPIOOverlayOutput] + +class ShellGPIOPortIO(width: Int = 4) extends Bundle { + val gpio = Vec(width, Analog(1.W)) +} + +abstract class GPIOPlacedOverlay( + val name: String, val di: GPIODesignInput, si: GPIOShellInput) + extends IOPlacedOverlay[ShellGPIOPortIO, GPIODesignInput, GPIOShellInput, GPIOOverlayOutput] +{ + implicit val p = di.p + + def ioFactory = new ShellGPIOPortIO(di.gpioParam.width) + val tlgpio = GPIO.attach(GPIOAttachParams(di.gpioParam, di.controlBus, di.intNode)) + val tlgpioSink = shell { tlgpio.ioNode.makeSink } + def overlayOutput = GPIOOverlayOutput(gpio = tlgpio) +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/GPIOPMODOverlay.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/GPIOPMODOverlay.scala new file mode 100644 index 0000000..e43b8e3 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/GPIOPMODOverlay.scala @@ -0,0 +1,45 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell + +import chisel3._ +import freechips.rocketchip.config._ +import freechips.rocketchip.diplomacy._ +import sifive.blocks.devices.gpio._ +import freechips.rocketchip.tilelink.TLBusWrapper +import freechips.rocketchip.interrupts.IntInwardNode +import chisel3.experimental.Analog + +case class GPIOPMODShellInput() +case class GPIOPMODDesignInput()(implicit val p: Parameters) +case class GPIOPMODOverlayOutput(pmod: ModuleValue[GPIOPMODPortIO]) +case object GPIOPMODOverlayKey extends Field[Seq[DesignPlacer[GPIOPMODDesignInput, GPIOPMODShellInput, GPIOPMODOverlayOutput]]](Nil) +trait GPIOPMODShellPlacer[Shell] extends ShellPlacer[GPIOPMODDesignInput, GPIOPMODShellInput, GPIOPMODOverlayOutput] + +class GPIOPMODPortIO extends Bundle { + val gpio_pmod_0 = Analog(1.W) + val gpio_pmod_1 = Analog(1.W) + val gpio_pmod_2 = Analog(1.W) + val gpio_pmod_3 = Analog(1.W) + val gpio_pmod_4 = Analog(1.W) + val gpio_pmod_5 = Analog(1.W) + val gpio_pmod_6 = Analog(1.W) + val gpio_pmod_7 = Analog(1.W) +} + +abstract class GPIOPMODPlacedOverlay( + val name: String, val di: GPIOPMODDesignInput, val si: GPIOPMODShellInput) + extends IOPlacedOverlay[GPIOPMODPortIO, GPIOPMODDesignInput, GPIOPMODShellInput, GPIOPMODOverlayOutput] +{ + implicit val p = di.p + + def ioFactory = new GPIOPMODPortIO + + val pmodgpioSource = BundleBridgeSource(() => new GPIOPMODPortIO) + val pmodgpioSink = shell { pmodgpioSource.makeSink } + + def overlayOutput = GPIOPMODOverlayOutput(pmod = InModuleBody { pmodgpioSource.bundle } ) + + shell { InModuleBody { + io <> pmodgpioSink.bundle + }} +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/I2COverlay.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/I2COverlay.scala new file mode 100644 index 0000000..0c40f59 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/I2COverlay.scala @@ -0,0 +1,38 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell + +import chisel3._ +import chisel3.experimental.Analog +import freechips.rocketchip.config._ +import freechips.rocketchip.diplomacy._ +import sifive.blocks.devices.i2c._ +import freechips.rocketchip.subsystem.{BaseSubsystem, PeripheryBus, PeripheryBusKey} +import freechips.rocketchip.tilelink.TLBusWrapper +import freechips.rocketchip.interrupts.IntInwardNode + +//This should NOT do the device placement, just return the bundlebridge +case class I2CShellInput(index: Int = 0) +case class I2CDesignInput(i2cParams: I2CParams, controlBus: TLBusWrapper, intNode: IntInwardNode)(implicit val p: Parameters) +case class I2COverlayOutput(i2c: TLI2C) +trait I2CShellPlacer[Shell] extends ShellPlacer[I2CDesignInput, I2CShellInput, I2COverlayOutput] + +case object I2COverlayKey extends Field[Seq[DesignPlacer[I2CDesignInput, I2CShellInput, I2COverlayOutput]]](Nil) + +class ShellI2CPortIO extends Bundle { + val scl = Analog(1.W) + val sda = Analog(1.W) +} + +abstract class I2CPlacedOverlay( + val name: String, val di: I2CDesignInput, val si: I2CShellInput) + extends IOPlacedOverlay[ShellI2CPortIO, I2CDesignInput, I2CShellInput, I2COverlayOutput] +{ + implicit val p = di.p + + def ioFactory = new ShellI2CPortIO + + val tli2c = I2C.attach(I2CAttachParams(di.i2cParams, di.controlBus, di.intNode)) + val tli2cSink = shell { tli2c.ioNode.makeSink } + + def overlayOutput = I2COverlayOutput(i2c = tli2c) +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/IOShell.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/IOShell.scala new file mode 100644 index 0000000..d40bf18 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/IOShell.scala @@ -0,0 +1,159 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell + +import chisel3._ +import chisel3.experimental.{DataMirror, IO} +import freechips.rocketchip.config._ +import freechips.rocketchip.util._ +import freechips.rocketchip.diplomacy._ + +case class IOPin(element: Element, index: Int = 0) +{ + private val width = DataMirror.widthOf(element) + require (width.known) + require (index >= 0 && index < width.get) + + def name = { + //replace all [#]'s with _# in the pin base name, then append on the final [#] (pindex) if width > 1 + val pin = element.instanceName.split("\\.").map(_.replaceAll("""\[(\d+)\]""", "_$1")).mkString("_") + val path = element.parentPathName.split("\\.") + val pindex = pin + (if (width.get > 1) s"[${index}]" else "") + (path.drop(1) :+ pindex).mkString("/") + } + + def sdcPin = { + val path = name + if (path.contains("/")) s"[get_pins {${path}}]" else s"[get_ports {${path}}]" + } + + def sdcClock = s"[get_clocks -of_objects ${sdcPin}]" + + def isOutput = { + import chisel3.ActualDirection._ + DataMirror.directionOf(element) match { + case Output => true + case Input => false + case Bidirectional(_) => true + case Unspecified => { require(false); false } + } + } + + def isInput = { + import chisel3.ActualDirection._ + DataMirror.directionOf(element) match { + case Output => false + case Input => true + case Bidirectional(_) => true + case Unspecified => { require(false); false } + } + } +} + +object IOPin +{ + def of(x: Data): Seq[IOPin] = { + val elts = x match { + case a: Aggregate => getDataElements(a).reverse // because Chisel has it backwards + case e: Element => Seq(e) + } + elts.flatMap { elt => + val width = DataMirror.widthOf(elt) + require (width.known) + Seq.tabulate(width.get) { i => IOPin(elt, i) } + } + } +} + +case class IOTiming( + minInput: Double = 0, + maxInput: Double = 0, + minOutput: Double = 0, + maxOutput: Double = 0) + +class SDC(val name: String) +{ + private var clocks: Seq[() => String] = Nil + private var groups: Seq[() => String] = Nil + private var falses: Seq[() => String] = Nil + private var timings: Seq[() => String] = Nil + + protected def addRawClock (command: => String) { clocks = (() => command) +: clocks } + protected def addRawGroup (command: => String) { groups = (() => command) +: groups } + protected def addRawFalse (command: => String) { falses = (() => command) +: falses } + protected def addRawTiming(command: => String) { timings = (() => command) +: timings } + addRawGroup("set_clock_groups -asynchronous") + + private def flatten(x: Seq[() => String], sep: String = "\n") = x.map(_()).filter(_ != "").reverse.mkString(sep) + ElaborationArtefacts.add(name, + s"""# ------------------------- Base Clocks -------------------- + |${flatten(clocks)} + |# ------------------------- Clock Groups ------------------- + |${if (groups.size == 1) "" else flatten(groups, " \\\n")} + |# ------------------------- False Paths -------------------- + |${flatten(falses)} + |# ------------------------- IO Timings --------------------- + |${flatten(timings)} + |""".stripMargin) + + def addClock(name: => String, pin: => IOPin, freqMHz: => Double, jitterNs: => Double = 0.5) { + addRawClock(s"create_clock -name ${name} -period ${1000/freqMHz} ${pin.sdcPin}") + addRawClock(s"set_input_jitter ${name} ${jitterNs}") + } + + def addDerivedClock(name: => String, source: => IOPin, sink: => IOPin) { + addRawClock(s"create_generated_clock -name ${name} -divide_by 1 -source ${source.sdcPin} ${sink.sdcPin}") + } + + def addGroup(clocks: => Seq[String] = Nil, pins: => Seq[IOPin] = Nil) { + def thunk = { + val clocksList = clocks + val (pinsList, portsList) = pins.map(_.name).partition(_.contains("/")) + val sep = " \\\n " + val clocksStr = (" [get_clocks {" +: clocksList).mkString(sep) + " \\\n }]" + val pinsStr = (" [get_clocks -of_objects [get_pins {" +: pinsList ).mkString(sep) + " \\\n }]]" + val portsStr = (" [get_clocks -of_objects [get_ports {" +: portsList).mkString(sep) + " \\\n }]]" + val str = s" -group [list${if (clocksList.isEmpty) "" else clocksStr}${if (pinsList.isEmpty) "" else pinsStr}${if (portsList.isEmpty) "" else portsStr}]" + if (clocksList.isEmpty && pinsList.isEmpty && portsList.isEmpty) "" else str + } + addRawGroup(thunk) + } + + def addAsyncPath(through: => Seq[IOPin]) { + addRawFalse("set_false_path" + through.map(x => s" -through ${x.sdcPin}").mkString) + } + + def addInputDelay(port: => IOPin, clock: => String, min: => Double, max: => Double) { + addRawTiming(f"set_input_delay -min ${min}% -5.2f -clock ${clock} ${port.sdcPin}") + addRawTiming(f"set_input_delay -max ${max}% -5.2f -clock ${clock} ${port.sdcPin}") + } + + def addOutputDelay(port: => IOPin, clock: => String, min: => Double, max: => Double) { + addRawTiming(f"set_output_delay -min ${min}% -5.2f -clock ${clock} ${port.sdcPin}") + addRawTiming(f"set_output_delay -max ${max}% -5.2f -clock ${clock} ${port.sdcPin}") + } + + def addIOTiming(io: IOPin, clock: => String, timing: => IOTiming) { + if (io.isInput) { addInputDelay (io, clock, timing.minInput, timing.maxInput) } + if (io.isOutput) { addOutputDelay(io, clock, timing.minOutput, timing.maxOutput) } + } +} + +// An IOOverlay is an Overlay with a public shell-level IO + +trait IOPlacedOverlay[IO <: Data, DesignInput, ShellInput, OverlayOutput] extends PlacedOverlay[DesignInput, ShellInput, OverlayOutput] +{ + def ioFactory: IO + def shell: IOShell + + val io = shell { InModuleBody { + val port = IO(ioFactory) + port.suggestName(name) + port + } } +} + +abstract class IOShell()(implicit p: Parameters) extends Shell +{ + // This can be overriden if a particular vendor needs customized SDC output + def sdc: SDC +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/JTAGDebugBScanOverlay.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/JTAGDebugBScanOverlay.scala new file mode 100644 index 0000000..6d353a0 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/JTAGDebugBScanOverlay.scala @@ -0,0 +1,31 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell + +import chisel3._ +import chisel3.experimental._ +import freechips.rocketchip.config._ +import freechips.rocketchip.util._ +import freechips.rocketchip.diplomacy._ +import freechips.rocketchip.jtag._ +import freechips.rocketchip.devices.debug._ +import freechips.rocketchip.subsystem.{BaseSubsystem, PeripheryBus, PeripheryBusKey} +import sifive.fpgashells.ip.xilinx._ + +case class JTAGDebugBScanShellInput() +case class JTAGDebugBScanDesignInput()(implicit val p: Parameters) +case class JTAGDebugBScanOverlayOutput(jtag: ModuleValue[FlippedJTAGIO]) +case object JTAGDebugBScanOverlayKey extends Field[Seq[DesignPlacer[JTAGDebugBScanDesignInput, JTAGDebugBScanShellInput, JTAGDebugBScanOverlayOutput]]](Nil) +trait JTAGDebugBScanShellPlacer[Shell] extends ShellPlacer[JTAGDebugBScanDesignInput, JTAGDebugBScanShellInput, JTAGDebugBScanOverlayOutput] + +abstract class JTAGDebugBScanPlacedOverlay( + val name: String, val di: JTAGDebugBScanDesignInput, val si: JTAGDebugBScanShellInput) + extends PlacedOverlay[JTAGDebugBScanDesignInput, JTAGDebugBScanShellInput, JTAGDebugBScanOverlayOutput] +{ + implicit val p = di.p + def shell: Shell + + val jtagDebugSource = BundleBridgeSource(() => new FlippedJTAGIO()) + val jtagDebugSink = shell { jtagDebugSource.makeSink } + val jtout = InModuleBody { jtagDebugSource.bundle} + def overlayOutput = JTAGDebugBScanOverlayOutput(jtag = jtout) +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/JTAGDebugOverlay.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/JTAGDebugOverlay.scala new file mode 100644 index 0000000..0e9373b --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/JTAGDebugOverlay.scala @@ -0,0 +1,50 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell + +import chisel3._ +import chisel3.experimental.Analog +import freechips.rocketchip.config._ +import freechips.rocketchip.util._ +import freechips.rocketchip.diplomacy._ +import freechips.rocketchip.jtag._ +import freechips.rocketchip.devices.debug._ +import freechips.rocketchip.subsystem.{BaseSubsystem, PeripheryBus, PeripheryBusKey} +import sifive.fpgashells.ip.xilinx._ + +case class JTAGDebugShellInput() +case class JTAGDebugDesignInput()(implicit val p: Parameters) +case class JTAGDebugOverlayOutput(jtag: ModuleValue[FlippedJTAGIO]) +case object JTAGDebugOverlayKey extends Field[Seq[DesignPlacer[JTAGDebugDesignInput, JTAGDebugShellInput, JTAGDebugOverlayOutput]]](Nil) +trait JTAGDebugShellPlacer[Shell] extends ShellPlacer[JTAGDebugDesignInput, JTAGDebugShellInput, JTAGDebugOverlayOutput] + +class ShellJTAGIO extends Bundle { + // JTAG + val jtag_TCK = Analog(1.W) + val jtag_TMS = Analog(1.W) + val jtag_TDI = Analog(1.W) + val jtag_TDO = Analog(1.W) + val srst_n = Analog(1.W) +} + +// TODO: Fix interaction of BundleBridge/Flipped to get rid of this Bundle +class FlippedJTAGIO extends Bundle { + val TCK = Input(Clock()) + val TMS = Input(Bool()) + val TDI = Input(Bool()) + val TDO = Output(new Tristate()) + val srst_n = Input(Bool()) +} + +abstract class JTAGDebugPlacedOverlay( + val name: String, val di: JTAGDebugDesignInput, val si: JTAGDebugShellInput) + extends IOPlacedOverlay[ShellJTAGIO, JTAGDebugDesignInput, JTAGDebugShellInput, JTAGDebugOverlayOutput] +{ + implicit val p = di.p + + def ioFactory = new ShellJTAGIO + + val jtagDebugSource = BundleBridgeSource(() => new FlippedJTAGIO()) + val jtagDebugSink = shell { jtagDebugSource.makeSink } + val jtout = InModuleBody { jtagDebugSource.bundle} + def overlayOutput = JTAGDebugOverlayOutput(jtag = jtout) +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/LEDOverlay.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/LEDOverlay.scala new file mode 100644 index 0000000..fb0631a --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/LEDOverlay.scala @@ -0,0 +1,30 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell + +import chisel3._ +import freechips.rocketchip.config._ +import freechips.rocketchip.diplomacy._ + +case class LEDShellInput( + color: String = "", + header: String = "", + rgb: Boolean = false, + number: Int = 0) + +case class LEDDesignInput()(implicit val p: Parameters) +case class LEDOverlayOutput(led: ModuleValue[Bool]) +case object LEDOverlayKey extends Field[Seq[DesignPlacer[LEDDesignInput, LEDShellInput, LEDOverlayOutput]]](Nil) +trait LEDShellPlacer[Shell] extends ShellPlacer[LEDDesignInput, LEDShellInput, LEDOverlayOutput] + +abstract class LEDPlacedOverlay( + val name: String, val di: LEDDesignInput, si: LEDShellInput) + extends IOPlacedOverlay[Bool, LEDDesignInput, LEDShellInput, LEDOverlayOutput] +{ + implicit val p = di.p + + def ioFactory = Output(Bool()) + + val ledSource = BundleBridgeSource(() => Bool()) + val ledSink = shell { ledSource.makeSink() } + def overlayOutput = LEDOverlayOutput(InModuleBody { ledSource.out(0)._1 }) +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/PCIeOverlay.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/PCIeOverlay.scala new file mode 100644 index 0000000..4762eae --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/PCIeOverlay.scala @@ -0,0 +1,31 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell + +import chisel3._ +import freechips.rocketchip.config._ +import freechips.rocketchip.diplomacy._ +import freechips.rocketchip.tilelink._ +import freechips.rocketchip.interrupts._ +import sifive.fpgashells.clocks._ + +case class PCIeShellInput() +case class PCIeDesignInput( + wrangler: ClockAdapterNode, + bars: Seq[AddressSet] = Seq(AddressSet(0x40000000L, 0x1FFFFFFFL)), + ecam: BigInt = 0x2000000000L, + corePLL: PLLNode)( + implicit val p: Parameters) + +case class PCIeOverlayOutput( + pcieNode: TLNode, + intNode: IntOutwardNode) +trait PCIeShellPlacer[Shell] extends ShellPlacer[PCIeDesignInput, PCIeShellInput, PCIeOverlayOutput] + +case object PCIeOverlayKey extends Field[Seq[DesignPlacer[PCIeDesignInput, PCIeShellInput, PCIeOverlayOutput]]](Nil) + +abstract class PCIePlacedOverlay[IO <: Data]( + val name: String, val di: PCIeDesignInput, val si: PCIeShellInput) + extends IOPlacedOverlay[IO, PCIeDesignInput, PCIeShellInput, PCIeOverlayOutput] +{ + implicit val p = di.p +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/PWMOverlay.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/PWMOverlay.scala new file mode 100644 index 0000000..97639f4 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/PWMOverlay.scala @@ -0,0 +1,36 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell + +import chisel3._ +import chisel3.experimental.Analog +import freechips.rocketchip.config._ +import freechips.rocketchip.diplomacy._ +import sifive.blocks.devices.pwm._ +import freechips.rocketchip.subsystem.{BaseSubsystem, PeripheryBus, PeripheryBusKey} +import freechips.rocketchip.tilelink.TLBusWrapper +import freechips.rocketchip.interrupts.IntInwardNode + +//another one that makes the controller... remove this +case class PWMShellInput(index: Int = 0) +case class PWMDesignInput(pwmParams: PWMParams, controlBus: TLBusWrapper, intNode: IntInwardNode)(implicit val p: Parameters) +case class PWMOverlayOutput(pwm: TLPWM) +case object PWMOverlayKey extends Field[Seq[DesignPlacer[PWMDesignInput, PWMShellInput, PWMOverlayOutput]]](Nil) +trait PWMShellPlacer[Shell] extends ShellPlacer[PWMDesignInput, PWMShellInput, PWMOverlayOutput] + +class ShellPWMPortIO extends Bundle { + val pwm_gpio = Vec(4, Analog(1.W)) +} + +abstract class PWMPlacedOverlay( + val name: String, val di: PWMDesignInput, val si: PWMShellInput) + extends IOPlacedOverlay[ShellPWMPortIO, PWMDesignInput, PWMShellInput, PWMOverlayOutput] +{ + implicit val p = di.p + + def ioFactory = new ShellPWMPortIO + + val tlpwm = PWM.attach(PWMAttachParams(di.pwmParams, di.controlBus, di.intNode)) + val tlpwmSink = shell { tlpwm.ioNode.makeSink } + + def overlayOutput = PWMOverlayOutput(pwm = tlpwm) +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/PinOverlay.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/PinOverlay.scala new file mode 100644 index 0000000..f617b59 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/PinOverlay.scala @@ -0,0 +1,38 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell + +import chisel3._ +import freechips.rocketchip.config._ +import freechips.rocketchip.diplomacy._ +import sifive.blocks.devices.gpio._ +import freechips.rocketchip.tilelink.TLBusWrapper +import freechips.rocketchip.interrupts.IntInwardNode +import chisel3.experimental.Analog + +case class PinShellInput() +case class PinDesignInput()(implicit val p: Parameters) +case class PinOverlayOutput(pin: ModuleValue[PinPortIO]) +case object PinOverlayKey extends Field[Seq[DesignPlacer[PinDesignInput, PinShellInput, PinOverlayOutput]]](Nil) +trait PinShellPlacer[Shell] extends ShellPlacer[PinDesignInput, PinShellInput, PinOverlayOutput] + +class PinPortIO extends Bundle { + val pins = Vec(8, Analog(1.W)) +} + +abstract class PinPlacedOverlay( + val name: String, val di: PinDesignInput, val si: PinShellInput) + extends IOPlacedOverlay[PinPortIO, PinDesignInput, PinShellInput, PinOverlayOutput] +{ + implicit val p = di.p + + def ioFactory = new PinPortIO + + val pinSource = BundleBridgeSource(() => new PinPortIO) + val pinSink = shell { pinSource.makeSink } + + def overlayOutput = PinOverlayOutput(pin = InModuleBody { pinSource.bundle } ) + + shell { InModuleBody { + io <> pinSink.bundle + }} +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/SDIOOverlay.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/SDIOOverlay.scala new file mode 100644 index 0000000..8c57359 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/SDIOOverlay.scala @@ -0,0 +1,70 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell + +import chisel3._ +import chisel3.experimental.Analog +import freechips.rocketchip.config._ +import freechips.rocketchip.diplomacy._ +import sifive.blocks.devices.spi._ +import freechips.rocketchip.tilelink.TLBusWrapper +import freechips.rocketchip.interrupts.IntInwardNode + +//This should not do the controller placement either +case class SDIOShellInput() +case class SDIODesignInput(spiParam: SPIParams, controlBus: TLBusWrapper, intNode: IntInwardNode)(implicit val p: Parameters) +case class SDIOOverlayOutput(spi: TLSPI) +case object SDIOOverlayKey extends Field[Seq[DesignPlacer[SDIODesignInput, SDIOShellInput, SDIOOverlayOutput]]](Nil) +trait SDIOShellPlacer[Shell] extends ShellPlacer[SDIODesignInput, SDIOShellInput, SDIOOverlayOutput] + +// SDIO Port. Not sure how generic this is, it might need to move. +class FPGASDIOPortIO extends Bundle { + val sdio_clk = Output(Bool()) + val sdio_cmd = Output(Bool()) + val sdio_dat_0 = Input(Bool()) + val sdio_dat_1 = Analog(1.W) + val sdio_dat_2 = Analog(1.W) + val sdio_dat_3 = Output(Bool()) +} + +abstract class SDIOPlacedOverlay( + val name: String, val di: SDIODesignInput, val si: SDIOShellInput) + extends IOPlacedOverlay[FPGASDIOPortIO, SDIODesignInput, SDIOShellInput, SDIOOverlayOutput] +{ + implicit val p = di.p + + def ioFactory = new FPGASDIOPortIO + val tlspi = SPI.attach(SPIAttachParams(di.spiParam, di.controlBus, di.intNode)) + val tlspiSink = tlspi.ioNode.makeSink + + val spiSource = BundleBridgeSource(() => new SPIPortIO(di.spiParam)) + val spiSink = shell { spiSource.makeSink } + def overlayOutput = SDIOOverlayOutput(spi = tlspi) + + InModuleBody { + val (io, _) = spiSource.out(0) + val tlspiport = tlspiSink.bundle + io <> tlspiport + (0 to 3).foreach { case q => + tlspiport.dq(q).i := RegNext(RegNext(io.dq(q).i)) + } + } + + shell { InModuleBody { + val sd_spi_sck = spiSink.bundle.sck + val sd_spi_cs = spiSink.bundle.cs(0) + + val sd_spi_dq_i = Wire(Vec(4, Bool())) + val sd_spi_dq_o = Wire(Vec(4, Bool())) + + spiSink.bundle.dq.zipWithIndex.foreach { + case(pin, idx) => + sd_spi_dq_o(idx) := pin.o + pin.i := sd_spi_dq_i(idx) + } + + io.sdio_clk := sd_spi_sck + io.sdio_dat_3 := sd_spi_cs + io.sdio_cmd := sd_spi_dq_o(0) + sd_spi_dq_i := Seq(false.B, io.sdio_dat_0, false.B, false.B) + } } +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/SPIFlashOverlay.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/SPIFlashOverlay.scala new file mode 100644 index 0000000..a542116 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/SPIFlashOverlay.scala @@ -0,0 +1,37 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell + +import chisel3._ +import freechips.rocketchip.config._ +import freechips.rocketchip.diplomacy._ +import sifive.blocks.devices.spi._ +import freechips.rocketchip.tilelink.TLBusWrapper +import freechips.rocketchip.interrupts.IntInwardNode +import chisel3.experimental.Analog + +//This one does controller also +case class SPIFlashShellInput(index: Int = 0) +case class SPIFlashDesignInput(spiFlashParam: SPIFlashParams, controlBus: TLBusWrapper, memBus: TLBusWrapper, intNode: IntInwardNode)(implicit val p: Parameters) +case class SPIFlashOverlayOutput(spiflash: TLSPIFlash) +case object SPIFlashOverlayKey extends Field[Seq[DesignPlacer[SPIFlashDesignInput, SPIFlashShellInput, SPIFlashOverlayOutput]]](Nil) +trait SPIFlashShellPlacer[Shell] extends ShellPlacer[SPIFlashDesignInput, SPIFlashShellInput, SPIFlashOverlayOutput] + + +class ShellSPIFlashPortIO extends Bundle { + val qspi_sck = Analog(1.W) + val qspi_cs = Analog(1.W) + val qspi_dq = Vec(4, Analog(1.W)) +} + +abstract class SPIFlashPlacedOverlay( + val name: String, val di: SPIFlashDesignInput, val si: SPIFlashShellInput) + extends IOPlacedOverlay[ShellSPIFlashPortIO, SPIFlashDesignInput, SPIFlashShellInput, SPIFlashOverlayOutput] +{ + implicit val p = di.p + + def ioFactory = new ShellSPIFlashPortIO + val tlqspi = SPI.attachFlash(SPIFlashAttachParams(di.spiFlashParam, di.controlBus, di.memBus, di.intNode)) + + val tlqspiSink = shell { tlqspi.ioNode.makeSink } + def overlayOutput = SPIFlashOverlayOutput(spiflash = tlqspi) +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/Shell.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/Shell.scala new file mode 100644 index 0000000..b570408 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/Shell.scala @@ -0,0 +1,80 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell + +import chisel3._ +import freechips.rocketchip.config._ +import freechips.rocketchip.diplomacy._ + +import chisel3.experimental.ChiselAnnotation +import firrtl._ +import firrtl.analyses._ +import firrtl.annotations._ +//import firrtl.ir._ +import freechips.rocketchip.util.DontTouch + +case object DesignKey extends Field[Parameters => LazyModule] + +// Overlays are declared by the Shell and placed somewhere by the Design +// ... they inject diplomatic code both where they were placed and in the shell +// ... they are instantiated with DesignInput and return DesignOutput +// placed overlay has been invoked by the design +trait PlacedOverlay[DesignInput, ShellInput, OverlayOutput] { + def name: String + def designInput: DesignInput + def shellInput: ShellInput + def overlayOutput: OverlayOutput +} + +trait ShellPlacer[DesignInput, ShellInput, OverlayOutput] { + def valName: ValName + def shellInput: ShellInput + def place(di: DesignInput): PlacedOverlay[DesignInput, ShellInput, OverlayOutput] +} + +trait DesignPlacer[DesignInput, ShellInput, OverlayOutput] { + def isPlaced: Boolean + def name: String + def shellInput: ShellInput + def place(di: DesignInput): PlacedOverlay[DesignInput, ShellInput, OverlayOutput] +} + +trait ShellOverlayAccessor[DesignInput, ShellInput, OverlayOutput] { + def get(): Option[PlacedOverlay[DesignInput, ShellInput, OverlayOutput]] +} + +abstract class Shell()(implicit p: Parameters) extends LazyModule with LazyScope +{ + private var overlays = Parameters.empty + def designParameters: Parameters = overlays ++ p + + def Overlay[DesignInput, ShellInput, OverlayOutput]( + key: Field[Seq[DesignPlacer[DesignInput, ShellInput, OverlayOutput]]], + placer: ShellPlacer[DesignInput, ShellInput, OverlayOutput]): + ShellOverlayAccessor[DesignInput, ShellInput, OverlayOutput] = { + val thunk = new Object + with ShellOverlayAccessor[DesignInput, ShellInput, OverlayOutput] + with DesignPlacer[DesignInput, ShellInput, OverlayOutput] { + var placedOverlay: Option[PlacedOverlay[DesignInput, ShellInput, OverlayOutput]] = None + def get() = placedOverlay + def isPlaced = !placedOverlay.isEmpty + def name = placer.valName.name + def shellInput = placer.shellInput + def place(input: DesignInput): PlacedOverlay[DesignInput, ShellInput, OverlayOutput] = { + require (!isPlaced, s"Overlay ${name} has already been placed by the design; cannot place again") + val it = placer.place(input) + placedOverlay = Some(it) + it + } + } + overlays = overlays ++ Parameters((site, here, up) => { + case x: Field[_] if x eq key => { + val tail = up(key) + if (thunk.isPlaced) { tail } else { thunk +: tail } + } + }) + thunk + } + + // feel free to override this if necessary + lazy val module = new LazyRawModuleImp(this) +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/SwitchOverlay.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/SwitchOverlay.scala new file mode 100644 index 0000000..ba81d0c --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/SwitchOverlay.scala @@ -0,0 +1,25 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell + +import chisel3._ +import freechips.rocketchip.config._ +import freechips.rocketchip.diplomacy._ + +case class SwitchShellInput(number: Int = 0) +case class SwitchDesignInput()(implicit val p: Parameters) +case class SwitchOverlayOutput(sw: ModuleValue[Bool]) +case object SwitchOverlayKey extends Field[Seq[DesignPlacer[SwitchDesignInput, SwitchShellInput, SwitchOverlayOutput]]](Nil) +trait SwitchShellPlacer[Shell] extends ShellPlacer[SwitchDesignInput, SwitchShellInput, SwitchOverlayOutput] + +abstract class SwitchPlacedOverlay( + val name: String, val di: SwitchDesignInput, val si: SwitchShellInput) + extends IOPlacedOverlay[Bool, SwitchDesignInput, SwitchShellInput, SwitchOverlayOutput] +{ + implicit val p = di.p + + def ioFactory = Input(Bool()) + + val switchSource = shell { BundleBridgeSource(() => Bool()) } + val switchSink = switchSource.makeSink() + def overlayOutput = SwitchOverlayOutput(sw = InModuleBody { switchSink.bundle } ) +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/TracePMODOverlay.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/TracePMODOverlay.scala new file mode 100644 index 0000000..6c1175c --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/TracePMODOverlay.scala @@ -0,0 +1,30 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell + +import chisel3._ +import freechips.rocketchip.config._ +import freechips.rocketchip.diplomacy._ +import sifive.blocks.devices.gpio._ +import freechips.rocketchip.tilelink.TLBusWrapper +import freechips.rocketchip.interrupts.IntInwardNode +import chisel3.experimental.Analog + +case class TracePMODShellInput() +case class TracePMODDesignInput()(implicit val p: Parameters) +case class TracePMODOverlayOutput(trace: ModuleValue[UInt]) +case object TracePMODOverlayKey extends Field[Seq[DesignPlacer[TracePMODDesignInput, TracePMODShellInput, TracePMODOverlayOutput]]](Nil) +trait TracePMODShellPlacer[Shell] extends ShellPlacer[TracePMODDesignInput, TracePMODShellInput, TracePMODOverlayOutput] + +abstract class TracePMODPlacedOverlay( + val name: String, val di: TracePMODDesignInput, val si: TracePMODShellInput) + extends IOPlacedOverlay[UInt, TracePMODDesignInput, TracePMODShellInput, TracePMODOverlayOutput] +{ + implicit val p = di.p + + def ioFactory = Output(UInt(8.W)) + + val pmodTraceSource = BundleBridgeSource(() => UInt(8.W)) + val pmodTraceSink = shell { pmodTraceSource.makeSink } + val traceout = InModuleBody { pmodTraceSource.out(0)._1 } + def overlayOutput = TracePMODOverlayOutput(trace = traceout ) +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/UARTOverlay.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/UARTOverlay.scala new file mode 100644 index 0000000..a2e6425 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/UARTOverlay.scala @@ -0,0 +1,46 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell + +import chisel3._ +import chisel3.experimental.Analog +import freechips.rocketchip.config._ +import freechips.rocketchip.diplomacy._ +import sifive.blocks.devices.uart._ +import freechips.rocketchip.subsystem.{BaseSubsystem, PeripheryBus, PeripheryBusKey} +import freechips.rocketchip.tilelink.TLBusWrapper +import freechips.rocketchip.interrupts.IntInwardNode + +//dont make the controller here +//move flowcontrol to shell input?? +case class UARTShellInput(index: Int = 0) +case class UARTDesignInput(uartParams: UARTParams, divInit: Int, controlBus: TLBusWrapper, intNode: IntInwardNode)(implicit val p: Parameters) +case class UARTOverlayOutput(uart: TLUART) +case object UARTOverlayKey extends Field[Seq[DesignPlacer[UARTDesignInput, UARTShellInput, UARTOverlayOutput]]](Nil) +trait UARTShellPlacer[Shell] extends ShellPlacer[UARTDesignInput, UARTShellInput, UARTOverlayOutput] + +// Tack on cts, rts signals available on some FPGAs. They are currently unused +// by our designs. +class ShellUARTPortIO(val flowControl: Boolean) extends Bundle { + val txd = Analog(1.W) + val rxd = Analog(1.W) + val rtsn = if (flowControl) Some(Analog(1.W)) else None + val ctsn = if (flowControl) Some(Analog(1.W)) else None +} + +//class UARTReplacementBundle extends Bundle with HasUARTTopBundleContents + +abstract class UARTPlacedOverlay( + val name: String, val di: UARTDesignInput, val si: UARTShellInput, val flowControl: Boolean) + extends IOPlacedOverlay[ShellUARTPortIO, UARTDesignInput, UARTShellInput, UARTOverlayOutput] +{ + implicit val p = di.p + + def ioFactory = new ShellUARTPortIO(flowControl) + + val tluart = UART.attach(UARTAttachParams(di.uartParams, di.divInit, di.controlBus, di.intNode)) + val tluartSink = tluart.ioNode.makeSink + val uartSource = BundleBridgeSource(() => new UARTPortIO()) + val uartSink = shell { uartSource.makeSink } + + def overlayOutput = UARTOverlayOutput(uart = tluart) +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/Util.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/Util.scala new file mode 100644 index 0000000..4a713ed --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/Util.scala @@ -0,0 +1,53 @@ +package sifive.fpgashells.shell + +import chisel3._ +import chisel3.experimental.{Analog, attach} +import chisel3.util.HasBlackBoxInline + +class AnalogToUInt(w: Int = 1) extends BlackBox with HasBlackBoxInline { + val io = IO(new Bundle { + val a = Analog(w.W) + val b = Output(UInt(w.W)) + }) + setInline(s"AnalogToUInt_${w.toString}.v", + s"""module AnalogToUInt (a, b); + | inout [${w - 1}:0] a; + | output [${w - 1}:0] b; + | assign b = a; + |endmodule + |""".stripMargin) +} + +object AnalogToUInt { + def apply(a: Analog): UInt = { + val a2b = Module(new AnalogToUInt(w = a.getWidth)) + attach(a, a2b.io.a) + a2b.io.b + } +} + +class UIntToAnalog(w: Int = 1) extends BlackBox with HasBlackBoxInline { + val io = IO(new Bundle { + val a = Analog(w.W) + val b = Input(UInt(w.W)) + val b_en = Input(Bool()) + }) + require(w >= 1) + setInline(s"UIntToAnalog_${w.toString}.v", + s"""module UIntToAnalog_${w.toString} (a, b, b_en); + | inout [${w - 1}:0] a; + | input [${w - 1}:0] b; + | input b_en; + | assign a = b_en ? b : $w'b${"z"*w}; + |endmodule + |""".stripMargin) +} + +object UIntToAnalog { + def apply(b: UInt, a: Analog, b_en: Bool): Unit = { + val a2b = Module(new UIntToAnalog(w = a.getWidth)) + attach(a, a2b.io.a) + a2b.io.b := b + a2b.io.b_en := b_en + } +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/cJTAGDebugOverlay.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/cJTAGDebugOverlay.scala new file mode 100644 index 0000000..a14c61c --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/cJTAGDebugOverlay.scala @@ -0,0 +1,57 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell + +import chisel3._ +import chisel3.experimental.Analog +import freechips.rocketchip.config._ +import freechips.rocketchip.util._ +import freechips.rocketchip.diplomacy._ +import freechips.rocketchip.devices.debug._ +import freechips.rocketchip.subsystem.{BaseSubsystem, PeripheryBus, PeripheryBusKey} +import sifive.fpgashells.ip.xilinx._ +import sifive.blocks.devices.pinctrl._ + +case class cJTAGDebugShellInput( + color: String = "", + header: String = "", + rgb: Bool = false.B, + number: Int = 0) + +case class cJTAGDebugDesignInput()(implicit val p: Parameters) +case class cJTAGDebugOverlayOutput(cjtag: ModuleValue[FPGAcJTAGSignals]) +trait cJTAGDebugShellPlacer[Shell] extends ShellPlacer[cJTAGDebugDesignInput, cJTAGDebugShellInput, cJTAGDebugOverlayOutput] + +case object cJTAGDebugOverlayKey extends Field[Seq[DesignPlacer[cJTAGDebugDesignInput, cJTAGDebugShellInput, cJTAGDebugOverlayOutput]]](Nil) + +class FPGAcJTAGIO extends Bundle { + // cJTAG + val cjtag_TCKC = Analog(1.W) + val cjtag_TMSC = Analog(1.W) + val srst_n = Analog(1.W) +} + +class FPGAcJTAGSignals extends Bundle { + val tckc_pin = Input(Clock()) + val tmsc_pin = new BasePin() + val srst_n = Input(Bool()) +} + +abstract class cJTAGDebugPlacedOverlay( + val name: String, val di: cJTAGDebugDesignInput, val si: cJTAGDebugShellInput) + extends IOPlacedOverlay[FPGAcJTAGIO, cJTAGDebugDesignInput, cJTAGDebugShellInput, cJTAGDebugOverlayOutput] +{ + implicit val p = di.p + def ioFactory = new FPGAcJTAGIO + + val cjtagDebugSource = BundleBridgeSource(() => new FPGAcJTAGSignals) + val cjtagDebugSink = shell { cjtagDebugSource.makeSink } + + def overlayOutput = cJTAGDebugOverlayOutput(cjtag = InModuleBody { cjtagDebugSource.bundle} ) + + shell { InModuleBody { + cjtagDebugSink.bundle.tckc_pin := IOBUF(io.cjtag_TCKC).asClock + IOBUF(io.cjtag_TMSC, cjtagDebugSink.bundle.tmsc_pin) + KEEPER(io.cjtag_TMSC) + cjtagDebugSink.bundle.srst_n := IOBUF(io.srst_n) + } } +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/microsemi/ChipLinkOverlay.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/microsemi/ChipLinkOverlay.scala new file mode 100644 index 0000000..de3e1c7 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/microsemi/ChipLinkOverlay.scala @@ -0,0 +1,84 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell.microsemi + + import chisel3._ +import freechips.rocketchip.diplomacy._ +import freechips.rocketchip.util._ +import sifive.fpgashells.shell._ +import sifive.fpgashells.ip.microsemi._ + + abstract class ChipLinkPolarFirePlacedOverlay(name: String, di: ChipLinkDesignInput, si: ChipLinkShellInput) + extends ChipLinkPlacedOverlay(name, di, si, rxPhase=180, txPhase=270) +{ + def shell: VeraShell + + override def fpgaReset = true + val resetBBSource = shell { BundleBridgeSource(() => Bool()) } + val resetBBSink = resetBBSource.makeSink + + shell { InModuleBody { + val bb = resetBBSource.bundle + bb := shell.initMonitor.io.DEVICE_INIT_DONE + } } + + InModuleBody { + val bb = resetBBSink.bundle + // Provide reset pulse to initialize b2c_reset (before RX PLL locks) + link.module.io.fpga_reset.foreach { _ := !bb } + } + + shell { InModuleBody { + val (tx, _) = txClock.in(0) + val (rx, _) = rxI.out(0) + val rxEdge = rxI.edges.out(0) + + // !!! add a DDR pad + io.c2b.clk := tx.clock + + val clkint = Module(new CLKINT) + clkint.suggestName(s"${name}_rx_clkint") + clkint.io.A := io.b2c.clk + rx.clock := clkint.io.Y + + // Consume as much slack for safey for trace jitter+skew on both sides as possible + val txMargin = 0.3 //was 1.5, 0.0 + val rxMargin = 0.3 // <- we badly need a PLL with external feedback! + + // At 125MHz, 6 corner analysis yields these worst min/max corners: + // RX min_slow_lv_lt: 0.038ns slack + 0!!! margin + // max_fast_hv_lt: 0.089ns slack + 0!!! margin + // TX min_fast_hv_lt: 0.086ns slack + 1.5 margin + // max_slow_lv_lt: 0.024ns slack + 1.5 margin + + // We have to add a these constants to work around some Libero timing analysis bug + val periodNs = 1000.0 / rxEdge.clock.freqMHz + + val timing = IOTiming( + /* The data signals coming from Aloe have: clock - 1.2 <= transition <= clock + 0.8 + * min = hold = - 1.2 + * max = period - setup = 0.8 + */ + minInput = -2.2 - rxMargin + periodNs*2, + maxInput = -0.2 + rxMargin + periodNs*2, + /* The data signals going to Aloe must have: clock - 1.85 <= NO transition <= clock + 0.65 + * min = -hold = -0.65 + * max = setup = 1.85 + */ + minOutput = -0.65 - txMargin + periodNs, + maxOutput = 1.85 + txMargin + periodNs) + + val sysclk: Clock = shell.sys_clock.get() match { + case Some(x: SysClockVeraPlacedOverlay) => x.clock + } + + shell.sdc.addClock(s"${name}_b2c_clock", io.b2c.clk, rxEdge.clock.freqMHz) + //shell.sdc.addDerivedClock(sdcTxClockName, "{corePLL/corePLL_0/pll_inst_0/OUT1}", io.c2b.clk) + shell.sdc.addDerivedClock(s"${name}_c2b_clock", IOPin(sysclk), io.c2b.clk) + IOPin.of(io).filter(p => p.isInput && !(p.element eq io.b2c.clk)).foreach { e => + shell.sdc.addIOTiming(e, s"${name}_b2c_clock", timing) + } + IOPin.of(io).filter(p => p.isOutput && !(p.element eq io.c2b.clk)).foreach { e => + shell.sdc.addIOTiming(e, s"${name}_c2b_clock", timing) + } + } } +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/microsemi/ClockOverlay.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/microsemi/ClockOverlay.scala new file mode 100644 index 0000000..23210d8 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/microsemi/ClockOverlay.scala @@ -0,0 +1,23 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell.microsemi + + import chisel3._ +import freechips.rocketchip.diplomacy._ +import sifive.fpgashells.shell._ +import sifive.fpgashells.ip.microsemi._ + + abstract class ClockInputMicrosemiPlacedOverlay(name: String, di: ClockInputDesignInput, si: ClockInputShellInput) + extends SingleEndedClockInputPlacedOverlay(name, di, si) +{ + def shell: MicrosemiShell + + shell { InModuleBody { + val (c, _) = node.out(0) + val clkint = Module(new CLKINT) + clkint.suggestName(s"${name}_clkint") + + clkint.io.A := io + c.clock := clkint.io.Y + c.reset := false.B + } } +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/microsemi/LEDOverlay.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/microsemi/LEDOverlay.scala new file mode 100644 index 0000000..aa81c0c --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/microsemi/LEDOverlay.scala @@ -0,0 +1,19 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell.microsemi + + import chisel3._ +import freechips.rocketchip.diplomacy._ +import sifive.fpgashells.shell._ +import sifive.fpgashells.ip.microsemi._ + + abstract class LEDMicrosemiPlacedOverlay(name: String, di: LEDDesignInput, si: LEDShellInput, pins: Seq[String] = Nil) + extends LEDPlacedOverlay(name, di, si) +{ + def shell: MicrosemiShell + val width = pins.size + + shell { InModuleBody { + io := ledSink.bundle // could/should put OBUFs here? + (pins zip IOPin.of(io)) foreach { case (pin, io) => shell.io_pdc.addPin(io, pin) } + } } +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/microsemi/PolarFireEvalKitShell.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/microsemi/PolarFireEvalKitShell.scala new file mode 100644 index 0000000..fc79189 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/microsemi/PolarFireEvalKitShell.scala @@ -0,0 +1,661 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell.microsemi.polarfireevalkitshell + +import Chisel._ +import chisel3.{Input, Output, RawModule, withClockAndReset} +import chisel3.experimental.{Analog, attach} + +import freechips.rocketchip.config._ +import freechips.rocketchip.devices.debug._ +import freechips.rocketchip.util.{SyncResetSynchronizerShiftReg, ResetCatchAndSync, ElaborationArtefacts, HeterogeneousBag} + +import sifive.blocks.devices.gpio._ +import sifive.blocks.devices.spi._ +import sifive.blocks.devices.uart._ + +import sifive.fpgashells.ip.microsemi.{CLKINT} + +import sifive.fpgashells.devices.microsemi.polarfireddr3._ +import sifive.fpgashells.devices.microsemi.polarfireddr4._ + +import sifive.fpgashells.ip.microsemi.corejtagdebug._ +import sifive.fpgashells.ip.microsemi.polarfireccc._ +import sifive.fpgashells.ip.microsemi.polarfireinitmonitor._ +import sifive.fpgashells.ip.microsemi.polarfirereset._ + +import sifive.fpgashells.devices.microsemi.polarfireevalkitpciex4._ +import sifive.fpgashells.ip.microsemi.polarfirexcvrrefclk._ +import sifive.fpgashells.ip.microsemi.polarfiretxpll._ + +import sifive.fpgashells.ip.microsemi.polarfire_oscillator._ +import sifive.fpgashells.ip.microsemi.polarfireclockdivider._ +import sifive.fpgashells.ip.microsemi.polarfireglitchlessmux._ +import sifive.blocks.devices.chiplink._ +import sifive.fpgashells.clocks._ + + +//------------------------------------------------------------------------- +// PolarFire Evaluation Kit Shell +//------------------------------------------------------------------------- + +trait HasDDR3 { this: PolarFireEvalKitShell => + + require(!p.lift(MemoryMicrosemiDDR3Key).isEmpty) + val ddr = IO(new PolarFireEvalKitDDR3Pads(p(MemoryMicrosemiDDR3Key))) + + def connectMIG(dut: HasMemoryPolarFireEvalKitDDR3ModuleImp): Unit = { + // Clock & Reset + dut.polarfireddrsubsys.PLL_REF_CLK := mig_clock_in + dut.polarfireddrsubsys.SYS_RESET_N := sys_reset_n + + mig_clock_out := dut.polarfireddrsubsys.SYS_CLK + mig_plllock_out := dut.polarfireddrsubsys.PLL_LOCK + ddr_ctrlr_ready := dut.polarfireddrsubsys.CTRLR_READY + + ddr <> dut.polarfireddrsubsys + } +} + +trait HasDDR4 { this: PolarFireEvalKitShell => + + require(!p.lift(MemoryMicrosemiDDR4Key).isEmpty) + val ddr = IO(new PolarFireEvalKitDDR4Pads(p(MemoryMicrosemiDDR4Key))) + + def connectMIG(dut: HasMemoryPolarFireEvalKitDDR4ModuleImp): Unit = { + // Clock & Reset + dut.polarfireddrsubsys.PLL_REF_CLK := mig_clock_in + dut.polarfireddrsubsys.SYS_RESET_N := sys_reset_n + + mig_clock_out := dut.polarfireddrsubsys.SYS_CLK + mig_plllock_out := dut.polarfireddrsubsys.PLL_LOCK + ddr_ctrlr_ready := dut.polarfireddrsubsys.CTRLR_READY + + ddr <> dut.polarfireddrsubsys + } +} + +trait HasPCIe { this: PolarFireEvalKitShell => + val pcie = IO(new PolarFireEvalKitPCIeX4Pads) + + def connectPCIe(dut: HasSystemPolarFireEvalKitPCIeX4ModuleImp): Unit = { + // Clock & Reset +// dut.pf_eval_kit_pcie.APB_S_PCLK := hart_clk + dut.pf_eval_kit_pcie.APB_S_PCLK := dut_clock + dut.pf_eval_kit_pcie.APB_S_PRESET_N := UInt("b1") + +// dut.pf_eval_kit_pcie.AXI_CLK := hart_clk_150 + dut.pf_eval_kit_pcie.AXI_CLK := dut_clock + dut.pf_eval_kit_pcie.AXI_CLK_STABLE := hart_clk_lock + + dut.pf_eval_kit_pcie.PCIE_1_TL_CLK_125MHz := pcie_tl_clk + + dut.pf_eval_kit_pcie.PCIE_1_TX_PLL_REF_CLK := pf_tx_pll_refclk_to_lane + + dut.pf_eval_kit_pcie.PCIE_1_TX_BIT_CLK := pf_tx_pll_bitclk + + dut.pf_eval_kit_pcie.PCIESS_LANE0_CDR_REF_CLK_0 := pcie_refclk + dut.pf_eval_kit_pcie.PCIESS_LANE1_CDR_REF_CLK_0 := pcie_refclk + dut.pf_eval_kit_pcie.PCIESS_LANE2_CDR_REF_CLK_0 := pcie_refclk + dut.pf_eval_kit_pcie.PCIESS_LANE3_CDR_REF_CLK_0 := pcie_refclk + + dut.pf_eval_kit_pcie.PCIE_1_TX_PLL_LOCK := pf_tx_pll_lock + + pcie <> dut.pf_eval_kit_pcie + } +} +/* +trait HasCoreJTAGDebug { this: PolarFireEvalKitShell => + // JTAG inside the FPGA fabric through user JTAG FPGA macro (UJTAG) + val fpga_jtag = Module(new CoreJtagDebugBlock) + + fpga_jtag.io.UTDO_IN_0 := UInt("b0") + fpga_jtag.io.UTDO_IN_1 := UInt("b0") + fpga_jtag.io.UTDO_IN_2 := UInt("b0") + fpga_jtag.io.UTDO_IN_3 := UInt("b0") + fpga_jtag.io.UTDODRV_0 := UInt("b0") + fpga_jtag.io.UTDODRV_1 := UInt("b0") + fpga_jtag.io.UTDODRV_2 := UInt("b0") + fpga_jtag.io.UTDODRV_3 := UInt("b0") + +} +*/ + + +trait HasPFEvalKitChipLink { this: PolarFireEvalKitShell => + + val chiplink = IO(new WideDataLayerPort(ChipLinkParams(Nil,Nil))) + val ereset_n = IO(Bool(INPUT)) + + def constrainChipLink(iofpga: Boolean = false): Unit = { + val direction0Pins = if(iofpga) "chiplink_b2c" else "chiplink_c2b" + val direction1Pins = if(iofpga) "chiplink_c2b" else "chiplink_b2c" +/* + ElaborationArtefacts.add( + """vc707chiplink.vivado.tcl""", + """set vc707chiplink_vivado_tcl_dir [file dirname [file normalize [info script]]] + add_files -fileset [current_fileset -constrset] [glob -directory $vc707chiplink_vivado_tcl_dir {*.vc707chiplink.xdc}]""" + ) +*/ + +/* + ElaborationArtefacts.add( + """vc707chiplink.xdc""", s""" + set_property PACKAGE_PIN AF39 [get_ports ${direction0Pins}_clk] + set_property PACKAGE_PIN AD40 [get_ports {${direction0Pins}_data[0]}] + set_property PACKAGE_PIN AD41 [get_ports {${direction0Pins}_data[1]}] + set_property PACKAGE_PIN AF41 [get_ports {${direction0Pins}_data[2]}] + set_property PACKAGE_PIN AG41 [get_ports {${direction0Pins}_data[3]}] + set_property PACKAGE_PIN AK39 [get_ports {${direction0Pins}_data[4]}] + set_property PACKAGE_PIN AL39 [get_ports {${direction0Pins}_data[5]}] + set_property PACKAGE_PIN AJ42 [get_ports {${direction0Pins}_data[6]}] + set_property PACKAGE_PIN AK42 [get_ports {${direction0Pins}_data[7]}] + set_property PACKAGE_PIN AL41 [get_ports {${direction0Pins}_data[8]}] + set_property PACKAGE_PIN AL42 [get_ports {${direction0Pins}_data[9]}] + set_property PACKAGE_PIN AF42 [get_ports {${direction0Pins}_data[10]}] + set_property PACKAGE_PIN AG42 [get_ports {${direction0Pins}_data[11]}] + set_property PACKAGE_PIN AD38 [get_ports {${direction0Pins}_data[12]}] + set_property PACKAGE_PIN AE38 [get_ports {${direction0Pins}_data[13]}] + set_property PACKAGE_PIN AC40 [get_ports {${direction0Pins}_data[14]}] + set_property PACKAGE_PIN AC41 [get_ports {${direction0Pins}_data[15]}] + set_property PACKAGE_PIN AD42 [get_ports {${direction0Pins}_data[16]}] + set_property PACKAGE_PIN AE42 [get_ports {${direction0Pins}_data[17]}] + set_property PACKAGE_PIN AJ38 [get_ports {${direction0Pins}_data[18]}] + set_property PACKAGE_PIN AK38 [get_ports {${direction0Pins}_data[19]}] + set_property PACKAGE_PIN AB41 [get_ports {${direction0Pins}_data[20]}] + set_property PACKAGE_PIN AB42 [get_ports {${direction0Pins}_data[21]}] + set_property PACKAGE_PIN Y42 [get_ports {${direction0Pins}_data[22]}] + set_property PACKAGE_PIN AA42 [get_ports {${direction0Pins}_data[23]}] + set_property PACKAGE_PIN Y39 [get_ports {${direction0Pins}_data[24]}] + set_property PACKAGE_PIN AA39 [get_ports {${direction0Pins}_data[25]}] + set_property PACKAGE_PIN W40 [get_ports {${direction0Pins}_data[26]}] + set_property PACKAGE_PIN Y40 [get_ports {${direction0Pins}_data[27]}] + set_property PACKAGE_PIN AB38 [get_ports {${direction0Pins}_data[28]}] + set_property PACKAGE_PIN AB39 [get_ports {${direction0Pins}_data[29]}] + set_property PACKAGE_PIN AC38 [get_ports {${direction0Pins}_data[30]}] + set_property PACKAGE_PIN AC39 [get_ports {${direction0Pins}_data[31]}] + set_property PACKAGE_PIN AJ40 [get_ports ${direction0Pins}_send] + set_property PACKAGE_PIN AJ41 [get_ports ${direction0Pins}_rst] + + set_property PACKAGE_PIN U39 [get_ports ${direction1Pins}_clk] + set_property PACKAGE_PIN U37 [get_ports {${direction1Pins}_data[0]}] + set_property PACKAGE_PIN U38 [get_ports {${direction1Pins}_data[1]}] + set_property PACKAGE_PIN U36 [get_ports {${direction1Pins}_data[2]}] + set_property PACKAGE_PIN T37 [get_ports {${direction1Pins}_data[3]}] + set_property PACKAGE_PIN U32 [get_ports {${direction1Pins}_data[4]}] + set_property PACKAGE_PIN U33 [get_ports {${direction1Pins}_data[5]}] + set_property PACKAGE_PIN V33 [get_ports {${direction1Pins}_data[6]}] + set_property PACKAGE_PIN V34 [get_ports {${direction1Pins}_data[7]}] + set_property PACKAGE_PIN P35 [get_ports {${direction1Pins}_data[8]}] + set_property PACKAGE_PIN P36 [get_ports {${direction1Pins}_data[9]}] + set_property PACKAGE_PIN W32 [get_ports {${direction1Pins}_data[10]}] + set_property PACKAGE_PIN W33 [get_ports {${direction1Pins}_data[11]}] + set_property PACKAGE_PIN R38 [get_ports {${direction1Pins}_data[12]}] + set_property PACKAGE_PIN R39 [get_ports {${direction1Pins}_data[13]}] + set_property PACKAGE_PIN U34 [get_ports {${direction1Pins}_data[14]}] + set_property PACKAGE_PIN T35 [get_ports {${direction1Pins}_data[15]}] + set_property PACKAGE_PIN R33 [get_ports {${direction1Pins}_data[16]}] + set_property PACKAGE_PIN R34 [get_ports {${direction1Pins}_data[17]}] + set_property PACKAGE_PIN N33 [get_ports {${direction1Pins}_data[18]}] + set_property PACKAGE_PIN N34 [get_ports {${direction1Pins}_data[19]}] + set_property PACKAGE_PIN P32 [get_ports {${direction1Pins}_data[20]}] + set_property PACKAGE_PIN P33 [get_ports {${direction1Pins}_data[21]}] + set_property PACKAGE_PIN V35 [get_ports {${direction1Pins}_data[22]}] + set_property PACKAGE_PIN V36 [get_ports {${direction1Pins}_data[23]}] + set_property PACKAGE_PIN W36 [get_ports {${direction1Pins}_data[24]}] + set_property PACKAGE_PIN W37 [get_ports {${direction1Pins}_data[25]}] + set_property PACKAGE_PIN T32 [get_ports {${direction1Pins}_data[26]}] + set_property PACKAGE_PIN R32 [get_ports {${direction1Pins}_data[27]}] + set_property PACKAGE_PIN V39 [get_ports {${direction1Pins}_data[28]}] + set_property PACKAGE_PIN V40 [get_ports {${direction1Pins}_data[29]}] + set_property PACKAGE_PIN P37 [get_ports {${direction1Pins}_data[30]}] + set_property PACKAGE_PIN P38 [get_ports {${direction1Pins}_data[31]}] + + set_property PACKAGE_PIN T36 [get_ports ${direction1Pins}_send] + set_property PACKAGE_PIN R37 [get_ports ${direction1Pins}_rst] + + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[31]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[30]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[29]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[28]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[27]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[26]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[25]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[24]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[23]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[22]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[21]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[20]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[19]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[18]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[17]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[16]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[15]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[14]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[13]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[12]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[11]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[10]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[9]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[8]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[7]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[6]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[5]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[4]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[3]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[2]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[1]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[0]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[31]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[30]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[29]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[28]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[27]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[26]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[25]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[24]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[23]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[22]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[21]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[20]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[19]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[18]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[17]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[16]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[15]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[14]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[13]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[12]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[11]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[10]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[9]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[8]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[7]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[6]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[5]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[4]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[3]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[2]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[1]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[0]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[31]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[30]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[29]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[28]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[27]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[26]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[25]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[24]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[23]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[22]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[21]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[20]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[19]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[18]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[17]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[16]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[15]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[14]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[13]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[12]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[11]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[10]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[9]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[8]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[7]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[6]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[5]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[4]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[3]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[2]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[1]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[0]}] + + + set_property IOSTANDARD LVCMOS18 [get_ports ${direction0Pins}_clk] + set_property IOSTANDARD LVCMOS18 [get_ports ${direction0Pins}_rst] + set_property IOSTANDARD LVCMOS18 [get_ports ${direction0Pins}_send] + set_property IOSTANDARD LVCMOS18 [get_ports ${direction1Pins}_clk] + set_property IOSTANDARD LVCMOS18 [get_ports ${direction1Pins}_rst] + set_property IOSTANDARD LVCMOS18 [get_ports ${direction1Pins}_send] + set_property SLEW FAST [get_ports ${direction1Pins}_clk] + set_property SLEW FAST [get_ports ${direction1Pins}_rst] + set_property SLEW FAST [get_ports ${direction1Pins}_send] + + + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[31]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[30]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[29]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[28]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[27]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[26]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[25]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[24]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[23]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[22]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[21]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[20]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[19]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[18]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[17]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[16]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[15]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[14]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[13]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[12]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[11]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[10]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[9]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[8]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[7]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[6]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[5]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[4]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[3]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[2]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[1]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[0]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_send] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_clk] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_rst] + + # Aloe reset sent to FPGA + set_property IOSTANDARD LVCMOS18 [get_ports ereset_n] + set_property PACKAGE_PIN AF40 [get_ports ereset_n] + + #Put first level RX/TX flops in IOB + set_property IOB TRUE [get_cells -of_objects [all_fanout -flat -endpoints_only [get_ports "chiplink_b2c_data*"]]] + set_property IOB TRUE [get_cells -of_objects [all_fanout -flat -endpoints_only [get_ports "chiplink_b2c_send"]]] + set_property IOB TRUE [get_cells -of_objects [all_fanin -flat -startpoints_only [get_ports "chiplink_c2b_data*"]]] + set_property IOB TRUE [get_cells -of_objects [all_fanin -flat -startpoints_only [get_ports "chiplink_c2b_send"]]] +""" + ) +*/ + } + + def connectChipLink(dut: { val chiplink: Seq[WideDataLayerPort] } , iofpga: Boolean = false): Unit = { + constrainChipLink(iofpga) + + chiplink <> dut.chiplink(0) + //dut.chiplink_xilinx_7series_phy.get.idelayctrl_refclk := sys_clock + } +} + +abstract class PolarFireEvalKitShell(implicit val p: Parameters) extends RawModule { + + //----------------------------------------------------------------------- + // Interface + //----------------------------------------------------------------------- + + // 50MHz crystal oscillator + val ref_clk0 = IO(Input(Clock())) + + // + val ref_clk_pad_p = IO(Input(Bool())) + val ref_clk_pad_n = IO(Input(Bool())) + + // Reset push-button - active low + val pf_user_reset_n = IO(Input(Bool())) + + // LED + val led = IO(Vec(8, Output(Bool()))) + + // UART + val uart_tx = IO(Output(Bool())) + val uart_rx = IO(Input(Bool())) + + // SPI Flash + val spi_flash_reset = IO(Output(Bool())) + val spi_flash_sdo = IO(Output(Bool())) + val spi_flash_sdi = IO(Input(Bool())) + val spi_flash_sck = IO(Output(Bool())) + val spi_flash_ss = IO(Output(Bool())) + val spi_flash_wp = IO(Output(Bool())) + val spi_flash_hold = IO(Output(Bool())) + + // JTAG + val jtag_TRSTB = IO(Input(Bool())) + val jtag_TCK = IO(Input(Clock())) + val jtag_TMS = IO(Input(Bool())) + val jtag_TDI = IO(Input(Bool())) + val jtag_TDO = IO(Output(Bool())) + + //Buttons + val btn_0 = IO(Analog(1.W)) + val btn_1 = IO(Analog(1.W)) + val btn_2 = IO(Analog(1.W)) + val btn_3 = IO(Analog(1.W)) + + //Sliding switches + val sw_0 = IO(Analog(1.W)) + val sw_1 = IO(Analog(1.W)) + val sw_2 = IO(Analog(1.W)) + val sw_3 = IO(Analog(1.W)) + val sw_4 = IO(Analog(1.W)) + val sw_5 = IO(Analog(1.W)) + val sw_6 = IO(Analog(1.W)) + val sw_7 = IO(Analog(1.W)) + + // debug + val debug_io0 = IO(Output(Bool())) + val debug_io1 = IO(Output(Clock())) + val debug_io2 = IO(Output(Bool())) + val debug_io3 = IO(Output(Bool())) + val debug_io4 = IO(Output(Clock())) + val debug_io5 = IO(Output(Bool())) + + //----------------------------------------------------------------------- + // Wire declarations + //----------------------------------------------------------------------- + + val sys_clock = Wire(Clock()) + val sys_reset_n = Wire(Bool()) + + val dut_clock = Wire(Clock()) + val dut_reset = Wire(Bool()) + val dut_reset_i = Wire(Bool()) + val dut_reset_sync = Wire(Bool()) + + val dut_ndreset = Wire(Bool()) + + val mig_mmcm_locked = Wire(Bool()) + val mig_sys_reset = Wire(Bool()) + + val mig_clock = Wire(Clock()) + val mig_reset = Wire(Bool()) + val mig_resetn = Wire(Bool()) + + val mig_clock_in = Wire(Clock()) + val mig_clock_out = Wire(Clock()) + val mig_plllock_out = Wire(Bool()) + + val pcie_dat_reset = Wire(Bool()) + val pcie_dat_resetn = Wire(Bool()) + val pcie_cfg_reset = Wire(Bool()) + val pcie_cfg_resetn = Wire(Bool()) + val pcie_dat_clock = Wire(Clock()) + val pcie_cfg_clock = Wire(Clock()) + val mmcm_lock_pcie = Wire(Bool()) + + val fpga_reset = Wire(Bool()) + val ddr_ctrlr_ready = Wire(Bool()) + + //----------------------------------------------------------------------- + // Differential clock + //----------------------------------------------------------------------- + val pf_xcvr_ref_clk = Module(new PolarFireTransceiverRefClk) + pf_xcvr_ref_clk.io.REF_CLK_PAD_P := ref_clk_pad_p + pf_xcvr_ref_clk.io.REF_CLK_PAD_N := ref_clk_pad_n + val pcie_refclk = pf_xcvr_ref_clk.io.REF_CLK + + val pf_tx_pll = Module(new PolarFireTxPLL) + pf_tx_pll.io.REF_CLK := pcie_refclk + val pf_tx_pll_bitclk = pf_tx_pll.io.BIT_CLK + val pf_tx_pll_refclk_to_lane = pf_tx_pll.io.REF_CLK_TO_LANE + val pf_tx_pll_lock = pf_tx_pll.io.LOCK + + //----------------------------------------------------------------------- + // DDR3 Subsystem Clocks + //----------------------------------------------------------------------- + val ddr3_clk_ccc = Module(new PolarFireCCC( + PLLParameters( + name = "ddr3_clk_ccc", + PLLInClockParameters(50), + Seq(PLLOutClockParameters(111.111))))) + + ddr3_clk_ccc.io.REF_CLK_0 := ref_clk0 + val ddr3_clk_in = ddr3_clk_ccc.io.OUT0_FABCLK_0.get + val ddr3_clk_in_lock = ddr3_clk_ccc.io.PLL_LOCK_0 + mig_clock_in := ddr3_clk_in + + //----------------------------------------------------------------------- + // Coreplex Clock Generator + //----------------------------------------------------------------------- + val hart_clk_ccc = Module(new PolarFireCCC( + PLLParameters( + name = "hart_clk_ccc", + PLLInClockParameters(166.666), + Seq( + PLLOutClockParameters(25), + PLLOutClockParameters(125), + PLLOutClockParameters(150) + ) + ) + )) + + val hart_clk_25 = hart_clk_ccc.io.OUT0_FABCLK_0.get + val hart_clk_125 = hart_clk_ccc.io.OUT1_FABCLK_0.get + val hart_clk_150 = hart_clk_ccc.io.OUT2_FABCLK_0.get + val hart_clk_lock = hart_clk_ccc.io.PLL_LOCK_0 + + // DUT clock + hart_clk_ccc.io.REF_CLK_0 := mig_clock_out + dut_clock := hart_clk_25 + +// debug_io1 := dut_clock +// debug_io2 := hart_clk_lock +// debug_io3 := ddr3_clk_in + + //----------------------------------------------------------------------- + // System reset + //----------------------------------------------------------------------- + val pf_init_monitor = Module(new PolarFireInitMonitor) + + val pf_reset = Module(new PolarFireReset) + + pf_reset.io.CLK := ddr3_clk_in + pf_reset.io.PLL_LOCK := ddr3_clk_in_lock + pf_reset.io.INIT_DONE := pf_init_monitor.io.DEVICE_INIT_DONE + pf_reset.io.EXT_RST_N := pf_user_reset_n + + pf_reset.io.SS_BUSY := UInt("b0") + pf_reset.io.FF_US_RESTORE := UInt("b0") + + fpga_reset := !pf_reset.io.FABRIC_RESET_N + + sys_reset_n := pf_reset.io.FABRIC_RESET_N + +// debug_io4 := sys_reset_n + + mig_resetn := !mig_reset + pcie_dat_resetn := !pcie_dat_reset + pcie_cfg_resetn := !pcie_cfg_reset + + dut_reset_i := !pf_reset.io.FABRIC_RESET_N | !hart_clk_lock | !ddr_ctrlr_ready + +// withClockAndReset(hart_clk, fpga_reset) { +// dut_reset := ResetCatchAndSync(hart_clk, dut_reset_i, 10) +// } + withClockAndReset(dut_clock, fpga_reset) { + dut_reset := ResetCatchAndSync(dut_clock, dut_reset_i, 10) + } + + //overrided in connectMIG and connect PCIe + //provide defaults to allow above reset sequencing logic to work without both + mig_clock := dut_clock + pcie_dat_clock := dut_clock + pcie_cfg_clock := dut_clock + mig_mmcm_locked := UInt("b1") + mmcm_lock_pcie := UInt("b1") + + led(4) := dut_ndreset + led(5) := !pf_user_reset_n + led(6) := fpga_reset + led(7) := dut_reset + + //----------------------------------------------------------------------- + // PCIe Subsystem TL Clock + //----------------------------------------------------------------------- + val pf_oscillator = Module(new PolarFireOscillator) + val pf_clk_divider = Module(new PolarFireClockDivider) + val pf_glitchless_mux = Module(new PolarFireGlitchlessMux) + pf_clk_divider.io.CLK_IN := pf_oscillator.io.RCOSC_160MHZ_GL + pf_glitchless_mux.io.CLK0 := pf_clk_divider.io.CLK_OUT + pf_glitchless_mux.io.CLK1 := hart_clk_125 + pf_glitchless_mux.io.SEL := pf_init_monitor.io.PCIE_INIT_DONE + val pcie_tl_clk = pf_glitchless_mux.io.CLK_OUT + + //--------------------------------------------------------------------- + // Debug JTAG + //--------------------------------------------------------------------- + + // JTAG inside the FPGA fabric through user JTAG FPGA macro (UJTAG) +/* + val fpga_jtag = Module(new CoreJtagDebugBlock) + + fpga_jtag.io.UTDO_IN_0 := UInt("b0") + fpga_jtag.io.UTDO_IN_1 := UInt("b0") + fpga_jtag.io.UTDO_IN_2 := UInt("b0") + fpga_jtag.io.UTDO_IN_3 := UInt("b0") + fpga_jtag.io.UTDODRV_0 := UInt("b0") + fpga_jtag.io.UTDODRV_1 := UInt("b0") + fpga_jtag.io.UTDODRV_2 := UInt("b0") + fpga_jtag.io.UTDODRV_3 := UInt("b0") + + def connectDebugJTAG(dut: HasPeripheryDebugModuleImp): SystemJTAGIO = { + val djtag = dut.debug.systemjtag.get + + djtag.jtag.TCK := fpga_jtag.io.TGT_TCK + djtag.jtag.TMS := fpga_jtag.io.TGT_TMS + djtag.jtag.TDI := fpga_jtag.io.TGT_TDI + fpga_jtag.io.TGT_TDO := djtag.jtag.TDO.data + + fpga_jtag.io.TRSTB := jtag_TRSTB + fpga_jtag.io.TCK := jtag_TCK + fpga_jtag.io.TMS := jtag_TMS + fpga_jtag.io.TDI := jtag_TDI + jtag_TDO := fpga_jtag.io.TDO + + djtag.mfr_id := p(JtagDTMKey).idcodeManufId.U(11.W) + + djtag.reset := fpga_reset + dut_ndreset := dut.debug.ndreset + djtag + } +*/ + //----------------------------------------------------------------------- + // UART + //----------------------------------------------------------------------- + + def connectUART(dut: HasPeripheryUARTModuleImp): Unit = dut.uart.headOption.foreach(connectUART) + + def connectUART(uart: UARTPortIO): Unit = { + uart.rxd := SyncResetSynchronizerShiftReg(uart_rx, 2, init = Bool(true), name=Some("uart_rxd_sync")) + uart_tx := uart.txd + } + + //----------------------------------------------------------------------- + // SPI + //----------------------------------------------------------------------- + + def connectSPI(dut: HasPeripherySPIModuleImp): Unit = dut.spi.headOption.foreach(connectSPI) + + def connectSPI(spi: SPIPortIO): Unit = { + spi_flash_reset := fpga_reset + spi_flash_wp := UInt("b0") + spi_flash_hold := UInt("b0") + spi_flash_sck := spi.sck + spi_flash_ss := spi.cs(0) + spi_flash_sdo := spi.dq(0).o + spi.dq(0).i := spi_flash_sdi + } +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/microsemi/PolarFireShell.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/microsemi/PolarFireShell.scala new file mode 100644 index 0000000..c6e0d69 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/microsemi/PolarFireShell.scala @@ -0,0 +1,42 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell.microsemi + + import chisel3._ +import freechips.rocketchip.config._ +import freechips.rocketchip.diplomacy._ +import freechips.rocketchip.util._ +import sifive.fpgashells.clocks._ +import sifive.fpgashells.ip.microsemi.polarfireccc._ +import sifive.fpgashells.ip.microsemi.polarfireinitmonitor._ +import sifive.fpgashells.shell._ + + class IO_PDC(val name: String) +{ + private var constraints: Seq[() => String] = Nil + protected def addConstraint(command: => String) { constraints = (() => command) +: constraints } + ElaborationArtefacts.add(name, constraints.map(_()).reverse.mkString("\n") + "\n") + + def addPin(io: IOPin, pin: String, ioStandard: String = "") { + def dir = if (io.isInput) { if (io.isOutput) "INOUT" else "INPUT" } else { "OUTPUT" } + def ioSt = if (!ioStandard.isEmpty) { + require(ioStandard == "LVCMOS33") + "-io_std LVCMOS33" + } else {""} + addConstraint(s"set_io -port_name {${io.name}} -pin_name ${pin} -fixed true -DIRECTION ${dir} ${ioSt} ") + } +} + + abstract class MicrosemiShell()(implicit p: Parameters) extends IOShell +{ + val sdc = new SDC("shell.sdc") + val io_pdc = new IO_PDC("shell.io.pdc") +} + + abstract class PolarFireShell()(implicit p: Parameters) extends MicrosemiShell +{ + val initMonitor = InModuleBody { Module(new PolarFireInitMonitor) } + val pllFactory = new PLLFactory(this, 7, p => Module(new PolarFireCCC(p))) + override def designParameters = super.designParameters.alterPartial { + case PLLFactoryKey => pllFactory + } +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/microsemi/VeraShell.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/microsemi/VeraShell.scala new file mode 100644 index 0000000..8a21424 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/microsemi/VeraShell.scala @@ -0,0 +1,251 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell.microsemi + +import chisel3._ +import chisel3.experimental.IO +import freechips.rocketchip.config._ +import freechips.rocketchip.util._ +import freechips.rocketchip.diplomacy._ +import freechips.rocketchip.tilelink._ +import sifive.fpgashells.clocks._ +import sifive.fpgashells.shell._ +import sifive.fpgashells.ip.microsemi._ +import sifive.blocks.devices.chiplink._ + +import sifive.fpgashells.devices.microsemi.polarfireevalkitpciex4._ +import sifive.fpgashells.devices.microsemi.polarfireddr4._ + +import sifive.fpgashells.ip.microsemi._ +import sifive.fpgashells.ip.microsemi.polarfirexcvrrefclk._ +import sifive.fpgashells.ip.microsemi.polarfiretxpll._ +import sifive.fpgashells.ip.microsemi.polarfire_oscillator._ +import sifive.fpgashells.ip.microsemi.polarfireclockdivider._ +import sifive.fpgashells.ip.microsemi.polarfireglitchlessmux._ +import sifive.fpgashells.ip.microsemi.polarfirereset._ + +class SysClockVeraPlacedOverlay(val shell: VeraShell, name: String, val designInput: ClockInputDesignInput, val shellInput: ClockInputShellInput) + extends ClockInputMicrosemiPlacedOverlay(name, designInput, shellInput) +{ + val node = shell { ClockSourceNode(freqMHz = 50, jitterPS = 50)(ValName(name)) } + + shell { InModuleBody { + val (c, _) = node.out(0) + c.reset := shell.pllReset + shell.io_pdc.addPin(io:Clock, "AG4") + } } +} +class SysClockVeraShellPlacer(val shell: VeraShell, val shellInput: ClockInputShellInput)(implicit val valName: ValName) + extends ClockInputShellPlacer[VeraShell] { + def place(designInput: ClockInputDesignInput) = new SysClockVeraPlacedOverlay(shell, valName.name, designInput, shellInput) +} + +class LEDVeraPlacedOverlay(val shell: VeraShell, name: String, val designInput: LEDDesignInput, val shellInput: LEDShellInput) + extends LEDMicrosemiPlacedOverlay(name, designInput, shellInput, Seq("AK17", "AN17", "AM17", "AL18")) +class LEDVeraShellPlacer(val shell: VeraShell, val shellInput: LEDShellInput)(implicit val valName: ValName) + extends LEDShellPlacer[VeraShell] { + def place(designInput: LEDDesignInput) = new LEDVeraPlacedOverlay(shell, valName.name, designInput, shellInput) +} + +class ChipLinkVeraPlacedOverlay(val shell: VeraShell, name: String, val designInput: ChipLinkDesignInput, val shellInput: ChipLinkShellInput) + extends ChipLinkPolarFirePlacedOverlay(name, designInput, shellInput) +{ + val ereset_n = shell { InModuleBody { + val ereset_n = IO(Input(Bool())) + ereset_n.suggestName("ereset_n") + shell.io_pdc.addPin(ereset_n, "U5") + ereset_n + } } + + shell { InModuleBody { + val dir1 = Seq("U10", "AC8", "U9", /* clk, rst, send */ + "V13", "W13", "T5", "T4", "V14", "W14", "R3", "R2", + "W6", "Y6", "U2", "U1", "T3", "T2", "W1", "Y1", + "V3", "V4", "AA4", "AA5", "V1", "V2", "Y3", "Y2", + "W4", "W3", "AA3", "AA2", "Y7", "AA7", "AB2", "AB1") + val dir2 = Seq("T9", "AD5", "AD3", /* clk, rst, send */ + "AB9", "AA8", "AB5", "AC4", "AC1", "AD1", "AB4", "AC3", + "W10", "Y10", "AB7", "AB6", "W8", "Y8", "Y12", "Y13", + "AA10","AA9", "W11", "Y11", "AC7", "AC6", "AA14","AA13", + "AB11","AB10","AB14","AC13","AC11","AC12","AB12","AA12") + val dirB2C = Seq(IOPin(io.b2c.clk), IOPin(io.b2c.rst), IOPin(io.b2c.send)) ++ + IOPin.of(io.b2c.data) + val dirC2B = Seq(IOPin(io.c2b.clk), IOPin(io.c2b.rst), IOPin(io.c2b.send)) ++ + IOPin.of(io.c2b.data) + (dirB2C zip dir1) foreach { case (io, pin) => shell.io_pdc.addPin(io, pin) } + (dirC2B zip dir2) foreach { case (io, pin) => shell.io_pdc.addPin(io, pin) } + + val (rx, _) = rxI.out(0) + rx.reset := shell.pllReset + } } +} +class ChipLinkVeraShellPlacer(val shell: VeraShell, val shellInput: ChipLinkShellInput)(implicit val valName: ValName) + extends ChipLinkShellPlacer[VeraShell] { + def place(designInput: ChipLinkDesignInput) = new ChipLinkVeraPlacedOverlay(shell, valName.name, designInput, shellInput) +} + +class PCIeVeraPlacedOverlay(val shell: VeraShell, name: String, val designInput: PCIeDesignInput, val shellInput: PCIeShellInput) + extends PCIePlacedOverlay[PolarFireEvalKitPCIeX4Pads](name, designInput, shellInput) +{ + val sdcClockName = "axiClock" + val pcie = LazyModule(new PolarFireEvalKitPCIeX4) + val ioNode = BundleBridgeSource(() => pcie.module.io.cloneType) + val topIONode = shell { ioNode.makeSink() } + val pcieClk_125 = shell { ClockSinkNode(freqMHz = 125)} + val pcieGroup = shell { ClockGroup()} + pcieClk_125 := designInput.wrangler := pcieGroup := designInput.corePLL + + val slaveSide = TLIdentityNode() + pcie.crossTLIn(pcie.slave) := slaveSide + pcie.crossTLIn(pcie.control) := slaveSide + val node = NodeHandle(slaveSide, pcie.crossTLOut(pcie.master)) + val intnode = pcie.crossIntOut(pcie.intnode) + + def overlayOutput = PCIeOverlayOutput(node, intnode) + def ioFactory = new PolarFireEvalKitPCIeX4Pads + + InModuleBody { ioNode.bundle <> pcie.module.io } + + shell { InModuleBody { + val (sys, _) = shell.sys_clock.get.get.overlayOutput.node.out(0) + val (pcieClk, _) = pcieClk_125.in(0) + val port = topIONode.bundle.port + val coreClock = shell.pllFactory.plls.getWrappedValue(1)._1.getClocks(0) + io <> port + + + val refClk = Module(new PolarFireTransceiverRefClk) + val pcie_tx_pll = Module(new PolarFireTxPLL) + val pf_osc = Module(new PolarFireOscillator) + val pf_clk_div = Module(new PolarFireClockDivider) + val pf_gless_mux = Module(new PolarFireGlitchlessMux) + + val pf_reset = Module(new PolarFireReset) + pf_reset.io.CLK := coreClock + pf_reset.io.PLL_LOCK := shell.pllFactory.plls.getWrappedValue(1)._1.getLocked + pf_reset.io.INIT_DONE := shell.initMonitor.io.DEVICE_INIT_DONE + pf_reset.io.EXT_RST_N := !shell.pllReset + //pf_reset.io.EXT_RST_N := true.B + pf_reset.io.SS_BUSY := false.B + pf_reset.io.FF_US_RESTORE := false.B + val sys_reset_n = pf_reset.io.FABRIC_RESET_N + + val osc_rc160mhz = pf_osc.io.RCOSC_160MHZ_GL + + pf_clk_div.io.CLK_IN := osc_rc160mhz + pf_gless_mux.io.CLK0 := pf_clk_div.io.CLK_OUT + pf_gless_mux.io.CLK1 := pcieClk.clock + pf_gless_mux.io.SEL := shell.initMonitor.io.PCIE_INIT_DONE + + refClk.io.REF_CLK_PAD_P := io.REFCLK_rxp + refClk.io.REF_CLK_PAD_N := io.REFCLK_rxn + val pcie_fab_ref_clk = refClk.io.FAB_REF_CLK + pcie_tx_pll.io.REF_CLK := refClk.io.REF_CLK + + val pf_rstb = IO(Output(Bool())) + pf_rstb.suggestName("pf_rstb") + val perst_x1_slot = IO(Output(Bool())) + perst_x1_slot.suggestName("perst_x1_slot") + val perst_x16_slot = IO(Output(Bool())) + perst_x16_slot.suggestName("perst_x16_slot") + val perst_m2_slot = IO(Output(Bool())) + perst_m2_slot.suggestName("perst_m2_slot") + val perst_sata_slot = IO(Output(Bool())) + perst_sata_slot.suggestName("perst_sata_slot") + + val led_test = IO(Output(Bool())) + led_test.suggestName("led_test") + val led_test1 = IO(Output(Bool())) + led_test1.suggestName("led_test1") + val led_test2 = IO(Output(Bool())) + led_test2.suggestName("led_test2") + + withClockAndReset(coreClock, !sys_reset_n) { + val timer = RegInit(268435456.U(29.W)) + timer := timer - timer.orR + val pf_rstb_i= !(!pf_reset.io.FABRIC_RESET_N || timer.orR) + + pf_rstb := pf_rstb_i + perst_x1_slot := pf_rstb_i + perst_x16_slot := pf_rstb_i + perst_m2_slot := pf_rstb_i + perst_sata_slot := pf_rstb_i + + led_test := pf_rstb_i + } + led_test1 := shell.initMonitor.io.PCIE_INIT_DONE + led_test2 := shell.pllFactory.plls.getWrappedValue(1)._1.getLocked + + port.APB_S_PCLK := coreClock + port.APB_S_PRESET_N := true.B + port.AXI_CLK := coreClock + port.AXI_CLK_STABLE := shell.pllFactory.plls.getWrappedValue(1)._1.getLocked //TODO: how to get correct number? + port.PCIE_1_TL_CLK_125MHz := pf_gless_mux.io.CLK_OUT + port.PCIE_1_TX_PLL_REF_CLK := pcie_tx_pll.io.REF_CLK_TO_LANE + port.PCIE_1_TX_BIT_CLK := pcie_tx_pll.io.BIT_CLK + port.PCIESS_LANE0_CDR_REF_CLK_0 := refClk.io.REF_CLK + port.PCIESS_LANE1_CDR_REF_CLK_0 := refClk.io.REF_CLK + port.PCIESS_LANE2_CDR_REF_CLK_0 := refClk.io.REF_CLK + port.PCIESS_LANE3_CDR_REF_CLK_0 := refClk.io.REF_CLK + port.PCIE_1_TX_PLL_LOCK := pcie_tx_pll.io.LOCK + + shell.io_pdc.addPin(led_test, "AK17") + shell.io_pdc.addPin(led_test1, "AN17") + shell.io_pdc.addPin(led_test2, "AM17") + shell.io_pdc.addPin(pf_rstb, "AG15") + shell.io_pdc.addPin(perst_x1_slot, "B4", ioStandard = "LVCMOS33") + shell.io_pdc.addPin(perst_x16_slot, "A4", ioStandard = "LVCMOS33") + shell.io_pdc.addPin(perst_m2_slot, "B5", ioStandard = "LVCMOS33") + shell.io_pdc.addPin(perst_sata_slot, "A5", ioStandard = "LVCMOS33") + shell.io_pdc.addPin(io.REFCLK_rxp, "W27") + shell.io_pdc.addPin(io.REFCLK_rxn, "W28") + shell.io_pdc.addPin(io.PCIESS_LANE_TXD0_N, "V34") + shell.io_pdc.addPin(io.PCIESS_LANE_TXD0_P, "V33") + shell.io_pdc.addPin(io.PCIESS_LANE_TXD1_N, "Y34") + shell.io_pdc.addPin(io.PCIESS_LANE_TXD1_P, "Y33") + shell.io_pdc.addPin(io.PCIESS_LANE_TXD2_N, "AA32") + shell.io_pdc.addPin(io.PCIESS_LANE_TXD2_P, "AA31") + shell.io_pdc.addPin(io.PCIESS_LANE_TXD3_N, "AB34") + shell.io_pdc.addPin(io.PCIESS_LANE_TXD3_P, "AB33") + shell.io_pdc.addPin(io.PCIESS_LANE_RXD0_N, "V30") + shell.io_pdc.addPin(io.PCIESS_LANE_RXD0_P, "V29") + shell.io_pdc.addPin(io.PCIESS_LANE_RXD1_N, "W32") + shell.io_pdc.addPin(io.PCIESS_LANE_RXD1_P, "W31") + shell.io_pdc.addPin(io.PCIESS_LANE_RXD2_N, "Y30") + shell.io_pdc.addPin(io.PCIESS_LANE_RXD2_P, "Y29") + shell.io_pdc.addPin(io.PCIESS_LANE_RXD3_N, "AB30") + shell.io_pdc.addPin(io.PCIESS_LANE_RXD3_P, "AB29") + + shell.sdc.addClock(s"${name}_ref_clk", io.REFCLK_rxp, 100) + } } + + shell.sdc.addGroup(clocks = Seq("osc_rc160mhz")) +} +class PCIeVeraShellPlacer(val shell: VeraShell, val shellInput: PCIeShellInput)(implicit val valName: ValName) + extends PCIeShellPlacer[VeraShell] { + def place(designInput: PCIeDesignInput) = new PCIeVeraPlacedOverlay(shell, valName.name, designInput, shellInput) +} + +class VeraShell()(implicit p: Parameters) extends PolarFireShell +{ + // PLL reset causes + val pllReset = InModuleBody { Wire(Bool()) } + + val sys_clock = Overlay(ClockInputOverlayKey, new SysClockVeraShellPlacer(this, ClockInputShellInput())) + val led = Overlay(LEDOverlayKey, new LEDVeraShellPlacer(this, LEDShellInput())) + val chiplink = Overlay(ChipLinkOverlayKey, new ChipLinkVeraShellPlacer(this, ChipLinkShellInput())) + val pcie = Overlay(PCIeOverlayKey, new PCIeVeraShellPlacer(this, PCIeShellInput())) + + val topDesign = LazyModule(p(DesignKey)(designParameters)) + + override lazy val module = new LazyRawModuleImp(this) { + val pf_user_reset_n = IO(Input(Bool())) + io_pdc.addPin(pf_user_reset_n, "AK18") + val ereset: Bool = chiplink.get() match { + case Some(x: ChipLinkVeraPlacedOverlay) => !x.ereset_n + case _ => false.B + } + pllReset := + !pf_user_reset_n || + !initMonitor.io.DEVICE_INIT_DONE || ereset + } +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/package.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/package.scala new file mode 100644 index 0000000..0669f14 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/package.scala @@ -0,0 +1,10 @@ +// See LICENSE for license details. +package sifive.fpgashells + +import chisel3._ +import scala.language.implicitConversions + +package object shell { + implicit def boolToIOPin(x: Bool): IOPin = IOPin(x, 0) + implicit def clockToIOPin(x: Clock): IOPin = IOPin(x, 0) +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/Arty100TShell.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/Arty100TShell.scala new file mode 100644 index 0000000..a03a5bd --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/Arty100TShell.scala @@ -0,0 +1,369 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell.xilinx + +import chisel3._ +import freechips.rocketchip.config._ +import freechips.rocketchip.diplomacy._ +import freechips.rocketchip.tilelink._ +import freechips.rocketchip.util.SyncResetSynchronizerShiftReg +import sifive.fpgashells.clocks._ +import sifive.fpgashells.shell._ +import sifive.fpgashells.ip.xilinx._ +import sifive.fpgashells.devices.xilinx.xilinxarty100tmig._ + +class SysClockArtyPlacedOverlay(val shell: Arty100TShellBasicOverlays, name: String, val designInput: ClockInputDesignInput, val shellInput: ClockInputShellInput) + extends SingleEndedClockInputXilinxPlacedOverlay(name, designInput, shellInput) +{ + val node = shell { ClockSourceNode(freqMHz = 100, jitterPS = 50) } + + shell { InModuleBody { + val clk: Clock = io + shell.xdc.addPackagePin(clk, "E3") + shell.xdc.addIOStandard(clk, "LVCMOS33") + } } +} +class SysClockArtyShellPlacer(val shell: Arty100TShellBasicOverlays, val shellInput: ClockInputShellInput)(implicit val valName: ValName) + extends ClockInputShellPlacer[Arty100TShellBasicOverlays] { + def place(designInput: ClockInputDesignInput) = new SysClockArtyPlacedOverlay(shell, valName.name, designInput, shellInput) +} + +//PMOD JA used for SDIO +class SDIOArtyPlacedOverlay(val shell: Arty100TShellBasicOverlays, name: String, val designInput: SDIODesignInput, val shellInput: SDIOShellInput) + extends SDIOXilinxPlacedOverlay(name, designInput, shellInput) +{ + shell { InModuleBody { + val packagePinsWithPackageIOs = Seq(("D12", IOPin(io.sdio_clk)), + ("B11", IOPin(io.sdio_cmd)), + ("A11", IOPin(io.sdio_dat_0)), + ("D13", IOPin(io.sdio_dat_1)), + ("B18", IOPin(io.sdio_dat_2)), + ("G13", IOPin(io.sdio_dat_3))) + + packagePinsWithPackageIOs foreach { case (pin, io) => { + shell.xdc.addPackagePin(io, pin) + shell.xdc.addIOStandard(io, "LVCMOS33") + shell.xdc.addIOB(io) + } } + packagePinsWithPackageIOs drop 1 foreach { case (pin, io) => { + shell.xdc.addPullup(io) + } } + } } +} +class SDIOArtyShellPlacer(val shell: Arty100TShellBasicOverlays, val shellInput: SDIOShellInput)(implicit val valName: ValName) + extends SDIOShellPlacer[Arty100TShellBasicOverlays] { + def place(designInput: SDIODesignInput) = new SDIOArtyPlacedOverlay(shell, valName.name, designInput, shellInput) +} + +class SPIFlashArtyPlacedOverlay(val shell: Arty100TShellBasicOverlays, name: String, val designInput: SPIFlashDesignInput, val shellInput: SPIFlashShellInput) + extends SPIFlashXilinxPlacedOverlay(name, designInput, shellInput) +{ + + shell { InModuleBody { + val packagePinsWithPackageIOs = Seq(("L16", IOPin(io.qspi_sck)), + ("L13", IOPin(io.qspi_cs)), + ("K17", IOPin(io.qspi_dq(0))), + ("K18", IOPin(io.qspi_dq(1))), + ("L14", IOPin(io.qspi_dq(2))), + ("M14", IOPin(io.qspi_dq(3)))) + + packagePinsWithPackageIOs foreach { case (pin, io) => { + shell.xdc.addPackagePin(io, pin) + shell.xdc.addIOStandard(io, "LVCMOS33") + } } + packagePinsWithPackageIOs drop 1 foreach { case (pin, io) => { + shell.xdc.addPullup(io) + } } + } } +} +class SPIFlashArtyShellPlacer(val shell: Arty100TShellBasicOverlays, val shellInput: SPIFlashShellInput)(implicit val valName: ValName) + extends SPIFlashShellPlacer[Arty100TShellBasicOverlays] { + def place(designInput: SPIFlashDesignInput) = new SPIFlashArtyPlacedOverlay(shell, valName.name, designInput, shellInput) +} + +class TracePMODArtyPlacedOverlay(val shell: Arty100TShellBasicOverlays, name: String, val designInput: TracePMODDesignInput, val shellInput: TracePMODShellInput) + extends TracePMODXilinxPlacedOverlay(name, designInput, shellInput, packagePins = Seq("U12", "V12", "V10", "V11", "U14", "V14", "T13", "U13")) +class TracePMODArtyShellPlacer(val shell: Arty100TShellBasicOverlays, val shellInput: TracePMODShellInput)(implicit val valName: ValName) + extends TracePMODShellPlacer[Arty100TShellBasicOverlays] { + def place(designInput: TracePMODDesignInput) = new TracePMODArtyPlacedOverlay(shell, valName.name, designInput, shellInput) +} + +class GPIOPMODArtyPlacedOverlay(val shell: Arty100TShellBasicOverlays, name: String, val designInput: GPIOPMODDesignInput, val shellInput: GPIOPMODShellInput) + extends GPIOPMODXilinxPlacedOverlay(name, designInput, shellInput) +{ + shell { InModuleBody { + val packagePinsWithPackageIOs = Seq(("E15", IOPin(io.gpio_pmod_0)), //These are PMOD B + ("E16", IOPin(io.gpio_pmod_1)), + ("D15", IOPin(io.gpio_pmod_2)), + ("C15", IOPin(io.gpio_pmod_3)), + ("J17", IOPin(io.gpio_pmod_4)), + ("J18", IOPin(io.gpio_pmod_5)), + ("K15", IOPin(io.gpio_pmod_6)), + ("J15", IOPin(io.gpio_pmod_7))) + + packagePinsWithPackageIOs foreach { case (pin, io) => { + shell.xdc.addPackagePin(io, pin) + shell.xdc.addIOStandard(io, "LVCMOS33") + } } + packagePinsWithPackageIOs drop 7 foreach { case (pin, io) => { + shell.xdc.addPullup(io) + } } + } } +} +class GPIOPMODArtyShellPlacer(val shell: Arty100TShellBasicOverlays, val shellInput: GPIOPMODShellInput)(implicit val valName: ValName) + extends GPIOPMODShellPlacer[Arty100TShellBasicOverlays] { + def place(designInput: GPIOPMODDesignInput) = new GPIOPMODArtyPlacedOverlay(shell, valName.name, designInput, shellInput) +} + +class UARTArtyPlacedOverlay(val shell: Arty100TShellBasicOverlays, name: String, val designInput: UARTDesignInput, val shellInput: UARTShellInput) + extends UARTXilinxPlacedOverlay(name, designInput, shellInput, false) +{ + shell { InModuleBody { + val packagePinsWithPackageIOs = Seq(("A9", IOPin(io.rxd)), + ("D10", IOPin(io.txd))) + + packagePinsWithPackageIOs foreach { case (pin, io) => { + shell.xdc.addPackagePin(io, pin) + shell.xdc.addIOStandard(io, "LVCMOS33") + shell.xdc.addIOB(io) + } } + } } +} +class UARTArtyShellPlacer(val shell: Arty100TShellBasicOverlays, val shellInput: UARTShellInput)(implicit val valName: ValName) + extends UARTShellPlacer[Arty100TShellBasicOverlays] { + def place(designInput: UARTDesignInput) = new UARTArtyPlacedOverlay(shell, valName.name, designInput, shellInput) +} + +//LEDS - 4 normal leds, r0, g0, b0, r1, g1, b1 ... +object LEDArtyPinConstraints{ + val pins = Seq("H5", "J5", "T9", "T10", "G6", "F6", "E1", "G3", "J4", "G4", "J3", "J2", "H4", "K1", "H6", "K2") +} +class LEDArtyPlacedOverlay(val shell: Arty100TShellBasicOverlays, name: String, val designInput: LEDDesignInput, val shellInput: LEDShellInput) + extends LEDXilinxPlacedOverlay(name, designInput, shellInput, packagePin = Some(LEDArtyPinConstraints.pins(shellInput.number))) +class LEDArtyShellPlacer(val shell: Arty100TShellBasicOverlays, val shellInput: LEDShellInput)(implicit val valName: ValName) + extends LEDShellPlacer[Arty100TShellBasicOverlays] { + def place(designInput: LEDDesignInput) = new LEDArtyPlacedOverlay(shell, valName.name, designInput, shellInput) +} + +//SWs +object SwitchArtyPinConstraints{ + val pins = Seq("A8", "C11", "C10", "A10") +} +class SwitchArtyPlacedOverlay(val shell: Arty100TShellBasicOverlays, name: String, val designInput: SwitchDesignInput, val shellInput: SwitchShellInput) + extends SwitchXilinxPlacedOverlay(name, designInput, shellInput, packagePin = Some(SwitchArtyPinConstraints.pins(shellInput.number))) +class SwitchArtyShellPlacer(val shell: Arty100TShellBasicOverlays, val shellInput: SwitchShellInput)(implicit val valName: ValName) + extends SwitchShellPlacer[Arty100TShellBasicOverlays] { + def place(designInput: SwitchDesignInput) = new SwitchArtyPlacedOverlay(shell, valName.name, designInput, shellInput) +} + +//Buttons +object ButtonArtyPinConstraints { + val pins = Seq("D9", "C9", "B9", "B8") +} +class ButtonArtyPlacedOverlay(val shell: Arty100TShellBasicOverlays, name: String, val designInput: ButtonDesignInput, val shellInput: ButtonShellInput) + extends ButtonXilinxPlacedOverlay(name, designInput, shellInput, packagePin = Some(ButtonArtyPinConstraints.pins(shellInput.number))) +class ButtonArtyShellPlacer(val shell: Arty100TShellBasicOverlays, val shellInput: ButtonShellInput)(implicit val valName: ValName) + extends ButtonShellPlacer[Arty100TShellBasicOverlays] { + def place(designInput: ButtonDesignInput) = new ButtonArtyPlacedOverlay(shell, valName.name, designInput, shellInput) +} + +class JTAGDebugBScanArtyPlacedOverlay(val shell: Arty100TShellBasicOverlays, name: String, val designInput: JTAGDebugBScanDesignInput, val shellInput: JTAGDebugBScanShellInput) + extends JTAGDebugBScanXilinxPlacedOverlay(name, designInput, shellInput) +class JTAGDebugBScanArtyShellPlacer(val shell: Arty100TShellBasicOverlays, val shellInput: JTAGDebugBScanShellInput)(implicit val valName: ValName) + extends JTAGDebugBScanShellPlacer[Arty100TShellBasicOverlays] { + def place(designInput: JTAGDebugBScanDesignInput) = new JTAGDebugBScanArtyPlacedOverlay(shell, valName.name, designInput, shellInput) +} + +// PMOD JD used for JTAG +class JTAGDebugArtyPlacedOverlay(val shell: Arty100TShellBasicOverlays, name: String, val designInput: JTAGDebugDesignInput, val shellInput: JTAGDebugShellInput) + extends JTAGDebugXilinxPlacedOverlay(name, designInput, shellInput) +{ + shell { InModuleBody { + shell.sdc.addClock("JTCK", IOPin(io.jtag_TCK), 10) + shell.sdc.addGroup(clocks = Seq("JTCK")) + shell.xdc.clockDedicatedRouteFalse(IOPin(io.jtag_TCK)) + val packagePinsWithPackageIOs = Seq(("F4", IOPin(io.jtag_TCK)), //pin JD-3 + ("D2", IOPin(io.jtag_TMS)), //pin JD-8 + ("E2", IOPin(io.jtag_TDI)), //pin JD-7 + ("D4", IOPin(io.jtag_TDO)), //pin JD-1 + ("H2", IOPin(io.srst_n))) + + packagePinsWithPackageIOs foreach { case (pin, io) => { + shell.xdc.addPackagePin(io, pin) + shell.xdc.addIOStandard(io, "LVCMOS33") + shell.xdc.addPullup(io) + } } + } } +} +class JTAGDebugArtyShellPlacer(val shell: Arty100TShellBasicOverlays, val shellInput: JTAGDebugShellInput)(implicit val valName: ValName) + extends JTAGDebugShellPlacer[Arty100TShellBasicOverlays] { + def place(designInput: JTAGDebugDesignInput) = new JTAGDebugArtyPlacedOverlay(shell, valName.name, designInput, shellInput) +} + +//cjtag +class cJTAGDebugArtyPlacedOverlay(val shell: Arty100TShellBasicOverlays, name: String, val designInput: cJTAGDebugDesignInput, val shellInput: cJTAGDebugShellInput) + extends cJTAGDebugXilinxPlacedOverlay(name, designInput, shellInput) +{ + shell { InModuleBody { + shell.sdc.addClock("JTCKC", IOPin(io.cjtag_TCKC), 10) + shell.sdc.addGroup(clocks = Seq("JTCKC")) + shell.xdc.clockDedicatedRouteFalse(IOPin(io.cjtag_TCKC)) + val packagePinsWithPackageIOs = Seq(("F4", IOPin(io.cjtag_TCKC)), //pin JD-3 + ("D2", IOPin(io.cjtag_TMSC)), //pin JD-8 + ("H2", IOPin(io.srst_n))) + + packagePinsWithPackageIOs foreach { case (pin, io) => { + shell.xdc.addPackagePin(io, pin) + shell.xdc.addIOStandard(io, "LVCMOS33") + } } + shell.xdc.addPullup(IOPin(io.cjtag_TCKC)) + shell.xdc.addPullup(IOPin(io.srst_n)) + } } +} +class cJTAGDebugArtyShellPlacer(val shell: Arty100TShellBasicOverlays, val shellInput: cJTAGDebugShellInput)(implicit val valName: ValName) + extends cJTAGDebugShellPlacer[Arty100TShellBasicOverlays] { + def place(designInput: cJTAGDebugDesignInput) = new cJTAGDebugArtyPlacedOverlay(shell, valName.name, designInput, shellInput) +} + +case object ArtyDDRSize extends Field[BigInt](0x10000000L * 1) // 256 MB +class DDRArtyPlacedOverlay(val shell: Arty100TShellBasicOverlays, name: String, val designInput: DDRDesignInput, val shellInput: DDRShellInput) + extends DDRPlacedOverlay[XilinxArty100TMIGPads](name, designInput, shellInput) +{ + val size = p(ArtyDDRSize) + + val ddrClk1 = shell { ClockSinkNode(freqMHz = 166.666)} + val ddrClk2 = shell { ClockSinkNode(freqMHz = 200)} + val ddrGroup = shell { ClockGroup() } + ddrClk1 := di.wrangler := ddrGroup := di.corePLL + ddrClk2 := di.wrangler := ddrGroup + + val migParams = XilinxArty100TMIGParams(address = AddressSet.misaligned(di.baseAddress, size)) + val mig = LazyModule(new XilinxArty100TMIG(migParams)) + val ioNode = BundleBridgeSource(() => mig.module.io.cloneType) + val topIONode = shell { ioNode.makeSink() } + val ddrUI = shell { ClockSourceNode(freqMHz = 100) } + val areset = shell { ClockSinkNode(Seq(ClockSinkParameters())) } + areset := di.wrangler := ddrUI + + def overlayOutput = DDROverlayOutput(ddr = mig.node) + def ioFactory = new XilinxArty100TMIGPads(size) + + InModuleBody { ioNode.bundle <> mig.module.io } + + shell { InModuleBody { + require (shell.sys_clock.get.isDefined, "Use of DDRArtyPlacedOverlay depends on SysClockArtyPlacedOverlay") + val (sys, _) = shell.sys_clock.get.get.overlayOutput.node.out(0) + val (ui, _) = ddrUI.out(0) + val (dclk1, _) = ddrClk1.in(0) + val (dclk2, _) = ddrClk2.in(0) + val (ar, _) = areset.in(0) + val port = topIONode.bundle.port + + io <> port + ui.clock := port.ui_clk + ui.reset := !port.mmcm_locked || port.ui_clk_sync_rst + port.sys_clk_i := dclk1.clock.asUInt + port.clk_ref_i := dclk2.clock.asUInt + port.sys_rst := shell.pllReset + port.aresetn := !ar.reset + } } + + shell.sdc.addGroup(clocks = Seq("clk_pll_i"), pins = Seq(mig.island.module.blackbox.io.ui_clk)) +} +class DDRArtyShellPlacer(val shell: Arty100TShellBasicOverlays, val shellInput: DDRShellInput)(implicit val valName: ValName) + extends DDRShellPlacer[Arty100TShellBasicOverlays] { + def place(designInput: DDRDesignInput) = new DDRArtyPlacedOverlay(shell, valName.name, designInput, shellInput) +} + +//Core to shell external resets +class CTSResetArtyPlacedOverlay(val shell: Arty100TShellBasicOverlays, name: String, val designInput: CTSResetDesignInput, val shellInput: CTSResetShellInput) + extends CTSResetPlacedOverlay(name, designInput, shellInput) +class CTSResetArtyShellPlacer(val shell: Arty100TShellBasicOverlays, val shellInput: CTSResetShellInput)(implicit val valName: ValName) + extends CTSResetShellPlacer[Arty100TShellBasicOverlays] { + def place(designInput: CTSResetDesignInput) = new CTSResetArtyPlacedOverlay(shell, valName.name, designInput, shellInput) +} + + +abstract class Arty100TShellBasicOverlays()(implicit p: Parameters) extends Series7Shell { + // Order matters; ddr depends on sys_clock + val sys_clock = Overlay(ClockInputOverlayKey, new SysClockArtyShellPlacer(this, ClockInputShellInput())) + val led = Seq.tabulate(16)(i => Overlay(LEDOverlayKey, new LEDArtyShellPlacer(this, LEDMetas(i))(valName = ValName(s"led_$i")))) + val switch = Seq.tabulate(4)(i => Overlay(SwitchOverlayKey, new SwitchArtyShellPlacer(this, SwitchShellInput(number = i))(valName = ValName(s"switch_$i")))) + val button = Seq.tabulate(4)(i => Overlay(ButtonOverlayKey, new ButtonArtyShellPlacer(this, ButtonShellInput(number = i))(valName = ValName(s"button_$i")))) + val ddr = Overlay(DDROverlayKey, new DDRArtyShellPlacer(this, DDRShellInput())) + val uart = Overlay(UARTOverlayKey, new UARTArtyShellPlacer(this, UARTShellInput())) + val sdio = Overlay(SDIOOverlayKey, new SDIOArtyShellPlacer(this, SDIOShellInput())) + val jtag = Overlay(JTAGDebugOverlayKey, new JTAGDebugArtyShellPlacer(this, JTAGDebugShellInput())) + val cjtag = Overlay(cJTAGDebugOverlayKey, new cJTAGDebugArtyShellPlacer(this, cJTAGDebugShellInput())) + val spi_flash = Overlay(SPIFlashOverlayKey, new SPIFlashArtyShellPlacer(this, SPIFlashShellInput())) + val cts_reset = Overlay(CTSResetOverlayKey, new CTSResetArtyShellPlacer(this, CTSResetShellInput())) + val jtagBScan = Overlay(JTAGDebugBScanOverlayKey, new JTAGDebugBScanArtyShellPlacer(this, JTAGDebugBScanShellInput())) + + def LEDMetas(i: Int): LEDShellInput = + LEDShellInput( + color = if((i < 12) && (i % 3 == 1)) "green" else if((i < 12) && (i % 3 == 2)) "blue" else "red", + rgb = (i < 12), + number = i) +} + +class Arty100TShell()(implicit p: Parameters) extends Arty100TShellBasicOverlays +{ + // PLL reset causes + val pllReset = InModuleBody { Wire(Bool()) } + + val topDesign = LazyModule(p(DesignKey)(designParameters)) + + // Place the sys_clock at the Shell if the user didn't ask for it + p(ClockInputOverlayKey).foreach(_.place(ClockInputDesignInput())) + + override lazy val module = new LazyRawModuleImp(this) { + val reset = IO(Input(Bool())) + xdc.addBoardPin(reset, "reset") + + val reset_ibuf = Module(new IBUF) + reset_ibuf.io.I := reset + val sysclk: Clock = sys_clock.get() match { + case Some(x: SysClockArtyPlacedOverlay) => x.clock + } + val powerOnReset = PowerOnResetFPGAOnly(sysclk) + sdc.addAsyncPath(Seq(powerOnReset)) + + pllReset := + (!reset_ibuf.io.O) || powerOnReset //Arty100T is active low reset + } +} + +class Arty100TShellGPIOPMOD()(implicit p: Parameters) extends Arty100TShellBasicOverlays +//This is the Shell used for coreip arty builds, with GPIOS and trace signals on the pmods +{ + // PLL reset causes + val pllReset = InModuleBody { Wire(Bool()) } + + val gpio_pmod = Overlay(GPIOPMODOverlayKey, new GPIOPMODArtyShellPlacer(this, GPIOPMODShellInput())) + val trace_pmod = Overlay(TracePMODOverlayKey, new TracePMODArtyShellPlacer(this, TracePMODShellInput())) + + val topDesign = LazyModule(p(DesignKey)(designParameters)) + + // Place the sys_clock at the Shell if the user didn't ask for it + p(ClockInputOverlayKey).foreach(_.place(ClockInputDesignInput())) + + override lazy val module = new LazyRawModuleImp(this) { + val reset = IO(Input(Bool())) + xdc.addBoardPin(reset, "reset") + + val reset_ibuf = Module(new IBUF) + reset_ibuf.io.I := reset + + val sysclk: Clock = sys_clock.get() match { + case Some(x: SysClockArtyPlacedOverlay) => x.clock + } + val powerOnReset = PowerOnResetFPGAOnly(sysclk) + sdc.addAsyncPath(Seq(powerOnReset)) + val ctsReset: Bool = cts_reset.get() match { + case Some(x: CTSResetArtyPlacedOverlay) => x.designInput.rst + case None => false.B + } + + pllReset := + (!reset_ibuf.io.O) || powerOnReset || ctsReset //Arty100T is active low reset + } +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/ArtyShell.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/ArtyShell.scala new file mode 100644 index 0000000..a1e964c --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/ArtyShell.scala @@ -0,0 +1,245 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell.xilinx.artyshell + +import Chisel._ +import chisel3.{Input, Output, RawModule, withClockAndReset} +import chisel3.experimental.{attach, Analog} + +import freechips.rocketchip.config._ +import freechips.rocketchip.devices.debug._ + +import sifive.blocks.devices.gpio._ +import sifive.blocks.devices.pwm._ +import sifive.blocks.devices.spi._ +import sifive.blocks.devices.uart._ +import sifive.blocks.devices.pinctrl.{BasePin} + +import sifive.fpgashells.ip.xilinx.{IBUFG, IOBUF, PULLUP, mmcm, reset_sys, PowerOnResetFPGAOnly} + +//------------------------------------------------------------------------- +// ArtyShell +//------------------------------------------------------------------------- + +abstract class ArtyShell(implicit val p: Parameters) extends RawModule { + + //----------------------------------------------------------------------- + // Interface + //----------------------------------------------------------------------- + + // Clock & Reset + val CLK100MHZ = IO(Input(Clock())) + val ck_rst = IO(Input(Bool())) + + // Green LEDs + val led_0 = IO(Analog(1.W)) + val led_1 = IO(Analog(1.W)) + val led_2 = IO(Analog(1.W)) + val led_3 = IO(Analog(1.W)) + + // RGB LEDs, 3 pins each + val led0_r = IO(Analog(1.W)) + val led0_g = IO(Analog(1.W)) + val led0_b = IO(Analog(1.W)) + + val led1_r = IO(Analog(1.W)) + val led1_g = IO(Analog(1.W)) + val led1_b = IO(Analog(1.W)) + + val led2_r = IO(Analog(1.W)) + val led2_g = IO(Analog(1.W)) + val led2_b = IO(Analog(1.W)) + + // Sliding switches + val sw_0 = IO(Analog(1.W)) + val sw_1 = IO(Analog(1.W)) + val sw_2 = IO(Analog(1.W)) + val sw_3 = IO(Analog(1.W)) + + // Buttons. First 3 used as GPIO, the last is used as wakeup + val btn_0 = IO(Analog(1.W)) + val btn_1 = IO(Analog(1.W)) + val btn_2 = IO(Analog(1.W)) + val btn_3 = IO(Analog(1.W)) + + // Dedicated QSPI interface + val qspi_cs = IO(Analog(1.W)) + val qspi_sck = IO(Analog(1.W)) + val qspi_dq = IO(Vec(4, Analog(1.W))) + + // UART0 + val uart_rxd_out = IO(Analog(1.W)) + val uart_txd_in = IO(Analog(1.W)) + + // JA (Used for more generic GPIOs) + val ja_0 = IO(Analog(1.W)) + val ja_1 = IO(Analog(1.W)) + val ja_2 = IO(Analog(1.W)) + val ja_3 = IO(Analog(1.W)) + val ja_4 = IO(Analog(1.W)) + val ja_5 = IO(Analog(1.W)) + val ja_6 = IO(Analog(1.W)) + val ja_7 = IO(Analog(1.W)) + + // JC (used for additional debug/trace connection) + val jc = IO(Vec(8, Analog(1.W))) + + // JD (used for JTAG connection) + val jd_0 = IO(Analog(1.W)) // TDO + val jd_1 = IO(Analog(1.W)) // TRST_n + val jd_2 = IO(Analog(1.W)) // TCK + val jd_4 = IO(Analog(1.W)) // TDI + val jd_5 = IO(Analog(1.W)) // TMS + val jd_6 = IO(Analog(1.W)) // SRST_n + + // ChipKit Digital I/O Pins + val ck_io = IO(Vec(20, Analog(1.W))) + + // ChipKit SPI + val ck_miso = IO(Analog(1.W)) + val ck_mosi = IO(Analog(1.W)) + val ck_ss = IO(Analog(1.W)) + val ck_sck = IO(Analog(1.W)) + + //----------------------------------------------------------------------- + // Wire declrations + //----------------------------------------------------------------------- + + // Note: these frequencies are approximate. + val clock_8MHz = Wire(Clock()) + val clock_32MHz = Wire(Clock()) + val clock_65MHz = Wire(Clock()) + + val mmcm_locked = Wire(Bool()) + + val reset_core = Wire(Bool()) + val reset_bus = Wire(Bool()) + val reset_periph = Wire(Bool()) + val reset_intcon_n = Wire(Bool()) + val reset_periph_n = Wire(Bool()) + + val SRST_n = Wire(Bool()) + + val dut_jtag_TCK = Wire(Clock()) + val dut_jtag_TMS = Wire(Bool()) + val dut_jtag_TDI = Wire(Bool()) + val dut_jtag_TDO = Wire(Bool()) + val dut_jtag_reset = Wire(Bool()) + val dut_ndreset = Wire(Bool()) + + //----------------------------------------------------------------------- + // Clock Generator + //----------------------------------------------------------------------- + // Mixed-mode clock generator + + val ip_mmcm = Module(new mmcm()) + + ip_mmcm.io.clk_in1 := CLK100MHZ + clock_8MHz := ip_mmcm.io.clk_out1 // 8.388 MHz = 32.768 kHz * 256 + clock_65MHz := ip_mmcm.io.clk_out2 // 65 Mhz + clock_32MHz := ip_mmcm.io.clk_out3 // 65/2 Mhz + ip_mmcm.io.resetn := ck_rst + mmcm_locked := ip_mmcm.io.locked + + //----------------------------------------------------------------------- + // System Reset + //----------------------------------------------------------------------- + // processor system reset module + + val ip_reset_sys = Module(new reset_sys()) + + ip_reset_sys.io.slowest_sync_clk := clock_8MHz + ip_reset_sys.io.ext_reset_in := ck_rst & SRST_n + ip_reset_sys.io.aux_reset_in := true.B + ip_reset_sys.io.mb_debug_sys_rst := dut_ndreset + ip_reset_sys.io.dcm_locked := mmcm_locked + + reset_core := ip_reset_sys.io.mb_reset + reset_bus := ip_reset_sys.io.bus_struct_reset + reset_periph := ip_reset_sys.io.peripheral_reset + reset_intcon_n := ip_reset_sys.io.interconnect_aresetn + reset_periph_n := ip_reset_sys.io.peripheral_aresetn + + //----------------------------------------------------------------------- + // SPI Flash + //----------------------------------------------------------------------- + + def connectSPIFlash(dut: HasPeripherySPIFlashModuleImp): Unit = dut.qspi.headOption.foreach { + connectSPIFlash(_, dut.clock, dut.reset) + } + + def connectSPIFlash(qspi: SPIPortIO, clock: Clock, reset: Bool): Unit = { + val qspi_pins = Wire(new SPIPins(() => {new BasePin()}, qspi.c)) + + SPIPinsFromPort(qspi_pins, qspi, clock, reset, syncStages = qspi.c.defaultSampleDel) + + IOBUF(qspi_sck, qspi.sck) + IOBUF(qspi_cs, qspi.cs(0)) + + (qspi_dq zip qspi_pins.dq).foreach { case(a, b) => IOBUF(a, b) } + } + + //--------------------------------------------------------------------- + // Debug JTAG + //--------------------------------------------------------------------- + + def connectDebugJTAG(dut: HasPeripheryDebugModuleImp): SystemJTAGIO = { + + require(dut.debug.isDefined, "Connecting JTAG requires that debug module exists") + //------------------------------------------------------------------- + // JTAG Reset + //------------------------------------------------------------------- + + val jtag_power_on_reset = PowerOnResetFPGAOnly(clock_32MHz) + + dut_jtag_reset := jtag_power_on_reset + + //------------------------------------------------------------------- + // JTAG IOBUFs + //------------------------------------------------------------------- + + dut_jtag_TCK := IBUFG(IOBUF(jd_2).asClock) + + dut_jtag_TMS := IOBUF(jd_5) + PULLUP(jd_5) + + dut_jtag_TDI := IOBUF(jd_4) + PULLUP(jd_4) + + IOBUF(jd_0, dut_jtag_TDO) + + SRST_n := IOBUF(jd_6) + PULLUP(jd_6) + + //------------------------------------------------------------------- + // JTAG PINS + //------------------------------------------------------------------- + + val djtag = dut.debug.get.systemjtag.get + + djtag.jtag.TCK := dut_jtag_TCK + djtag.jtag.TMS := dut_jtag_TMS + djtag.jtag.TDI := dut_jtag_TDI + dut_jtag_TDO := djtag.jtag.TDO.data + + djtag.mfr_id := p(JtagDTMKey).idcodeManufId.U(11.W) + djtag.part_number := p(JtagDTMKey).idcodePartNum.U(16.W) + djtag.version := p(JtagDTMKey).idcodeVersion.U(4.W) + + djtag.reset := dut_jtag_reset + dut_ndreset := dut.debug.get.ndreset + + djtag + } + + //--------------------------------------------------------------------- + // UART + //--------------------------------------------------------------------- + + def connectUART(dut: HasPeripheryUARTModuleImp): Unit = dut.uart.headOption.foreach(connectUART) + + def connectUART(uart: UARTPortIO): Unit = { + IOBUF(uart_rxd_out, uart.txd) + uart.rxd := IOBUF(uart_txd_in) + } + +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/ButtonOverlay.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/ButtonOverlay.scala new file mode 100644 index 0000000..a197597 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/ButtonOverlay.scala @@ -0,0 +1,34 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell.xilinx + +import chisel3._ +import freechips.rocketchip.diplomacy._ +import sifive.fpgashells.shell._ +import sifive.fpgashells.ip.xilinx._ + +abstract class ButtonXilinxPlacedOverlay(name: String, di: ButtonDesignInput, si: ButtonShellInput, boardPin: Option[String] = None, packagePin: Option[String] = None, ioStandard: String = "LVCMOS33") + extends ButtonPlacedOverlay(name, di, si) +{ + def shell: XilinxShell + + shell { InModuleBody { + val but = Wire(Bool()) + buttonSource.out(0)._1 := but + val ibuf = Module(new IBUF) + ibuf.suggestName(s"button_ibuf_${si.number}") + ibuf.io.I := io + but := ibuf.io.O + + require((boardPin.isEmpty || packagePin.isEmpty), "can't provide both boardpin and packagepin, this is ambiguous") + val cutAt = if(boardPin.isDefined) 1 else 0 + val ios = IOPin.of(io) + val boardIO = ios.take(cutAt) + val packageIO = ios.drop(cutAt) + + (boardPin zip boardIO) foreach { case (pin, io) => shell.xdc.addBoardPin (io, pin) } + (packagePin zip packageIO) foreach { case (pin, io) => + shell.xdc.addPackagePin(io, pin) + shell.xdc.addIOStandard(io, ioStandard) + } + } } +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/ChipLinkOverlay.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/ChipLinkOverlay.scala new file mode 100644 index 0000000..aac3f33 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/ChipLinkOverlay.scala @@ -0,0 +1,73 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell.xilinx + +import chisel3._ +import freechips.rocketchip.diplomacy._ +import freechips.rocketchip.util._ +import sifive.fpgashells.shell._ +import sifive.fpgashells.ip.xilinx._ + +abstract class ChipLinkXilinxPlacedOverlay(name: String, di: ChipLinkDesignInput, si: ChipLinkShellInput, rxPhase: Double, txPhase: Double, rxMargin: Double, txMargin: Double) + extends ChipLinkPlacedOverlay(name, di.copy(di = di.di.copy(fpgaReset = true))(di.p), si, rxPhase, txPhase) +{ + def shell: XilinxShell + + override def fpgaReset = true + + InModuleBody { + // Provide reset pulse to initialize b2c_reset (before RX PLL locks) + link.module.io.fpga_reset.foreach { _ := PowerOnResetFPGAOnly(Module.clock) } + } + + shell { InModuleBody { + val (tx, _) = txClock.in(0) + val (rx, _) = rxI.out(0) + val rxEdge = rxI.edges.out(0) + + val oddr = Module(new ODDR(DDR_CLK_EDGE = "SAME_EDGE", SRTYPE = "ASYNC")) + oddr.suggestName(s"${name}_tx_oddr") + io.c2b.clk := oddr.io.Q.asClock + oddr.io.C := tx.clock + oddr.io.CE := true.B + oddr.io.D1 := true.B + oddr.io.D2 := false.B + oddr.io.S := false.B + // We can't use tx.reset here as it waits for all PLLs to lock, + // including RX, which depends on this clock being driven. + // tap.reset only waits for the TX PLL to lock. + oddr.io.R := ResetCatchAndSync(tx.clock, PowerOnResetFPGAOnly(tx.clock)) + + val ibufg = Module(new IBUFG) + ibufg.suggestName(s"${name}_rx_ibufg") + ibufg.io.I := io.b2c.clk + rx.clock := ibufg.io.O + rx.reset := shell.pllReset + + IOPin.of(io).foreach { shell.xdc.addIOStandard(_, "LVCMOS18") } + IOPin.of(io).filterNot(_.element eq io.b2c.clk).foreach { shell.xdc.addIOB(_) } + IOPin.of(io).filter(_.isOutput).foreach { shell.xdc.addSlew(_, "FAST") } + + val timing = IOTiming( + /* The data signals coming from Aloe have: clock - 1.2 <= transition <= clock + 0.8 + * min = hold = - 1.2 + * max = period - setup = 0.8 + */ + minInput = -1.2 - rxMargin, + maxInput = 0.8 + rxMargin, + /* The data signals going to Aloe must have: clock - 1.85 <= NO transition <= clock + 0.65 + * min = -hold = -0.65 + * max = setup = 1.85 + */ + minOutput = -0.65 - txMargin, + maxOutput = 1.85 + txMargin) + + shell.sdc.addClock(s"${name}_b2c_clock", io.b2c.clk, rxEdge.clock.freqMHz, 0.3) + shell.sdc.addDerivedClock(s"${name}_c2b_clock", oddr.io.C, io.c2b.clk) + IOPin.of(io).filter(p => p.isInput && !(p.element eq io.b2c.clk)).foreach { e => + shell.sdc.addIOTiming(e, s"${name}_b2c_clock", timing) + } + IOPin.of(io).filter(p => p.isOutput && !(p.element eq io.c2b.clk)).foreach { e => + shell.sdc.addIOTiming(e, s"${name}_c2b_clock", timing) + } + } } +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/ClockOverlay.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/ClockOverlay.scala new file mode 100644 index 0000000..839a589 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/ClockOverlay.scala @@ -0,0 +1,41 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell.xilinx + +import chisel3._ +import freechips.rocketchip.diplomacy._ +import sifive.fpgashells.shell._ +import sifive.fpgashells.ip.xilinx._ + +abstract class LVDSClockInputXilinxPlacedOverlay(name: String, di: ClockInputDesignInput, si: ClockInputShellInput) + extends LVDSClockInputPlacedOverlay(name, di, si) +{ + def shell: XilinxShell + + shell { InModuleBody { + val ibufds = Module(new IBUFDS) + ibufds.suggestName(s"${name}_ibufds") + + val (c, _) = node.out(0) + ibufds.io.I := io.p + ibufds.io.IB := io.n + c.clock := ibufds.io.O + c.reset := shell.pllReset + } } +} + + +abstract class SingleEndedClockInputXilinxPlacedOverlay(name: String, di: ClockInputDesignInput, si: ClockInputShellInput) + extends SingleEndedClockInputPlacedOverlay(name, di, si) +{ + def shell: XilinxShell + + shell { InModuleBody { + val ibuf = Module(new IBUFG) + ibuf.suggestName(s"${name}_ibufg") + + val (c, _) = node.out(0) + ibuf.io.I := io + c.clock := ibuf.io.O + c.reset := shell.pllReset + } } +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/GPIOPMODXilinxOverlay.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/GPIOPMODXilinxOverlay.scala new file mode 100644 index 0000000..d77f69c --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/GPIOPMODXilinxOverlay.scala @@ -0,0 +1,13 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell.xilinx + +import chisel3._ +import freechips.rocketchip.diplomacy._ +import sifive.fpgashells.shell._ +import sifive.fpgashells.ip.xilinx._ + +abstract class GPIOPMODXilinxPlacedOverlay(name: String, di: GPIOPMODDesignInput, si: GPIOPMODShellInput) + extends GPIOPMODPlacedOverlay(name, di, si) +{ + def shell: XilinxShell +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/GPIOXilinxOverlay.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/GPIOXilinxOverlay.scala new file mode 100644 index 0000000..d578ac6 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/GPIOXilinxOverlay.scala @@ -0,0 +1,20 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell.xilinx + +import chisel3._ +import freechips.rocketchip.diplomacy._ +import sifive.fpgashells.shell._ +import sifive.fpgashells.ip.xilinx._ + +abstract class GPIOXilinxPlacedOverlay(name: String, di: GPIODesignInput, si: GPIOShellInput) + extends GPIOPlacedOverlay(name, di, si) +{ + def shell: XilinxShell + + shell { InModuleBody { + tlgpioSink.bundle.pins.zipWithIndex.foreach{ case (tlpin, idx) => { + UIntToAnalog(tlpin.o.oval, io.gpio(idx), tlpin.o.oe) + tlpin.i.ival := AnalogToUInt(io.gpio(idx)) + } } + } } +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/I2COverlay.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/I2COverlay.scala new file mode 100644 index 0000000..07fca0d --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/I2COverlay.scala @@ -0,0 +1,21 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell.xilinx + + import chisel3._ +import freechips.rocketchip.diplomacy._ +import sifive.fpgashells.shell._ +import sifive.fpgashells.ip.xilinx._ + + abstract class I2CXilinxPlacedOverlay(name: String, di: I2CDesignInput, si: I2CShellInput) + extends I2CPlacedOverlay(name, di, si) +{ + def shell: XilinxShell + + shell { InModuleBody { + UIntToAnalog(tli2cSink.bundle.scl.out, io.scl, tli2cSink.bundle.scl.oe) + UIntToAnalog(tli2cSink.bundle.sda.out, io.sda, tli2cSink.bundle.sda.oe) + + tli2cSink.bundle.scl.in := AnalogToUInt(io.scl) + tli2cSink.bundle.sda.in := AnalogToUInt(io.sda) + } } +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/JTAGDebugBScanOverlay.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/JTAGDebugBScanOverlay.scala new file mode 100644 index 0000000..cd43e10 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/JTAGDebugBScanOverlay.scala @@ -0,0 +1,29 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell.xilinx + +import chisel3._ +import freechips.rocketchip.diplomacy._ +import sifive.fpgashells.shell._ +import sifive.fpgashells.ip.xilinx._ + +abstract class JTAGDebugBScanXilinxPlacedOverlay(name: String, di: JTAGDebugBScanDesignInput, si: JTAGDebugBScanShellInput) + extends JTAGDebugBScanPlacedOverlay(name, di, si) +{ + def shell: XilinxShell + + shell { InModuleBody { + val tmp_tck = Wire(Bool()) + val tmp_tms = Wire(Bool()) + val tmp_tdi = Wire(Bool()) + val tmp_tdo = Wire(Bool()) + val tmp_tdo_en = Wire(Bool()) + + JTAGTUNNEL(tmp_tck, tmp_tms, tmp_tdi, tmp_tdo, tmp_tdo_en) + + jtagDebugSink.bundle.TCK := tmp_tck.asClock() + jtagDebugSink.bundle.TMS := tmp_tms + jtagDebugSink.bundle.TDI := tmp_tdi + tmp_tdo := jtagDebugSink.bundle.TDO.data + tmp_tdo_en := jtagDebugSink.bundle.TDO.driven + } } +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/JTAGDebugOverlay.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/JTAGDebugOverlay.scala new file mode 100644 index 0000000..e91bb94 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/JTAGDebugOverlay.scala @@ -0,0 +1,21 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell.xilinx + +import chisel3._ +import freechips.rocketchip.diplomacy._ +import sifive.fpgashells.shell._ +import sifive.fpgashells.ip.xilinx._ + +abstract class JTAGDebugXilinxPlacedOverlay(name: String, di: JTAGDebugDesignInput, si: JTAGDebugShellInput) + extends JTAGDebugPlacedOverlay(name, di, si) +{ + def shell: XilinxShell + + shell { InModuleBody { + jtagDebugSink.bundle.TCK := AnalogToUInt(io.jtag_TCK).asBool.asClock + jtagDebugSink.bundle.TMS := AnalogToUInt(io.jtag_TMS) + jtagDebugSink.bundle.TDI := AnalogToUInt(io.jtag_TDI) + UIntToAnalog(jtagDebugSink.bundle.TDO.data,io.jtag_TDO,jtagDebugSink.bundle.TDO.driven) + jtagDebugSink.bundle.srst_n := AnalogToUInt(io.srst_n) + } } +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/LEDOverlay.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/LEDOverlay.scala new file mode 100644 index 0000000..1725ffe --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/LEDOverlay.scala @@ -0,0 +1,29 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell.xilinx + +import chisel3._ +import freechips.rocketchip.diplomacy._ +import sifive.fpgashells.shell._ +import sifive.fpgashells.ip.xilinx._ + +abstract class LEDXilinxPlacedOverlay(name: String, di: LEDDesignInput, si: LEDShellInput, boardPin: Option[String] = None, packagePin: Option[String] = None, ioStandard: String = "LVCMOS33") + extends LEDPlacedOverlay(name, di, si) +{ + def shell: XilinxShell + + shell { InModuleBody { + io := ledSink.bundle // could/should put OBUFs here? + + require((boardPin.isEmpty || packagePin.isEmpty), "can't provide both boardpin and packagepin, this is ambiguous") + val cutAt = if(boardPin.isDefined) 1 else 0 + val ios = IOPin.of(io) + val boardIO = ios.take(cutAt) + val packageIO = ios.drop(cutAt) + + (boardPin zip boardIO) foreach { case (pin, io) => shell.xdc.addBoardPin (io, pin) } + (packagePin zip packageIO) foreach { case (pin, io) => + shell.xdc.addPackagePin(io, pin) + shell.xdc.addIOStandard(io, ioStandard) + } + } } +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/PWMOverlay.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/PWMOverlay.scala new file mode 100644 index 0000000..c182e59 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/PWMOverlay.scala @@ -0,0 +1,19 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell.xilinx + + import chisel3._ +import freechips.rocketchip.diplomacy._ +import sifive.fpgashells.shell._ +import sifive.fpgashells.ip.xilinx._ + +abstract class PWMXilinxPlacedOverlay(name: String, di: PWMDesignInput, si: PWMShellInput) + extends PWMPlacedOverlay(name, di, si) +{ + def shell: XilinxShell + + shell { InModuleBody { + tlpwmSink.bundle.gpio.zip(io.pwm_gpio).foreach { case(design_pwm, io_pwm) => + UIntToAnalog(design_pwm, io_pwm, true.B) + } + } } +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/PeripheralsVC707Shell.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/PeripheralsVC707Shell.scala new file mode 100644 index 0000000..c9f2d31 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/PeripheralsVC707Shell.scala @@ -0,0 +1,163 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell.xilinx + +import chisel3._ +import chisel3.experimental._ + +import freechips.rocketchip.config._ +import freechips.rocketchip.diplomacy._ +import freechips.rocketchip.tilelink._ +import freechips.rocketchip.util._ + +import sifive.fpgashells.clocks._ +import sifive.fpgashells.shell._ +import sifive.fpgashells.ip.xilinx._ + +import sifive.blocks.devices.gpio._ +import sifive.blocks.devices.pinctrl._ + +class UARTPeripheralVC707PlacedOverlay(val shell: VC707Shell, name: String, val designInput: UARTDesignInput, val shellInput: UARTShellInput) + extends UARTXilinxPlacedOverlay(name, designInput, shellInput, true) +{ + shell { InModuleBody { + val uartLocations = List(List("AT32", "AR34", "AU33", "AU36"), List("V34", "T35", "V33", "U34")) //uart0 - USB, uart1 - FMC 105 debug card J20 p1-rx p2-tx p3-ctsn p4-rtsn + val packagePinsWithPackageIOs = Seq((uartLocations(shellInput.index)(0), IOPin(io.ctsn.get)), + (uartLocations(shellInput.index)(1), IOPin(io.rtsn.get)), + (uartLocations(shellInput.index)(2), IOPin(io.rxd)), + (uartLocations(shellInput.index)(3), IOPin(io.txd))) + + packagePinsWithPackageIOs foreach { case (pin, io) => { + shell.xdc.addPackagePin(io, pin) + shell.xdc.addIOStandard(io, "LVCMOS18") + shell.xdc.addIOB(io) + } } + } } +} + +class UARTPeripheralVC707ShellPlacer(val shell: VC707Shell, val shellInput: UARTShellInput)(implicit val valName: ValName) + extends UARTShellPlacer[VC707Shell] +{ + def place(designInput: UARTDesignInput) = new UARTPeripheralVC707PlacedOverlay(shell, valName.name, designInput, shellInput) +} + +class I2CPeripheralVC707PlacedOverlay(val shell: VC707Shell, name: String, val designInput: I2CDesignInput, val shellInput: I2CShellInput) + extends I2CXilinxPlacedOverlay(name, designInput, shellInput) +{ + shell { InModuleBody { + val i2cLocations = List(List("AJ38", "U32"), List("AK38", "U33")) //i2c0: J1 p37-scl p38-sda i2c1: J2 p39-scl p40-sda + val packagePinsWithPackageIOs = Seq((i2cLocations(shellInput.index)(0), IOPin(io.scl)), + (i2cLocations(shellInput.index)(1), IOPin(io.sda))) + + packagePinsWithPackageIOs foreach { case (pin, io) => { + shell.xdc.addPackagePin(io, pin) + shell.xdc.addIOStandard(io, "LVCMOS18") + shell.xdc.addIOB(io) + } } + } } +} + +class I2CPeripheralVC707ShellPlacer(val shell: VC707Shell, val shellInput: I2CShellInput)(implicit val valName: ValName) + extends I2CShellPlacer[VC707Shell] +{ + def place(designInput: I2CDesignInput) = new I2CPeripheralVC707PlacedOverlay(shell, valName.name, designInput, shellInput) +} + +class QSPIPeripheralVC707PlacedOverlay(val shell: VC707Shell, name: String, val designInput: SPIFlashDesignInput, val shellInput: SPIFlashShellInput) + extends SPIFlashXilinxPlacedOverlay(name, designInput, shellInput) +{ + shell { InModuleBody { + val qspiLocations = List(List("AD40", "AB41", "AD41", "AB42", "AF41", "Y42"), List("AG41", "AA42", "AK39", "Y39", "AL39", "AA39")) //J1 pins 1-6 and 7-12 (sck, cs, dq0-3) + val packagePinsWithPackageIOs = Seq((qspiLocations(shellInput.index)(0), IOPin(io.qspi_sck)), + (qspiLocations(shellInput.index)(1), IOPin(io.qspi_cs)), + (qspiLocations(shellInput.index)(2), IOPin(io.qspi_dq(0))), + (qspiLocations(shellInput.index)(3), IOPin(io.qspi_dq(1))), + (qspiLocations(shellInput.index)(4), IOPin(io.qspi_dq(2))), + (qspiLocations(shellInput.index)(5), IOPin(io.qspi_dq(3)))) + + packagePinsWithPackageIOs foreach { case (pin, io) => { + shell.xdc.addPackagePin(io, pin) + shell.xdc.addIOStandard(io, "LVCMOS18") + shell.xdc.addIOB(io) + } } + packagePinsWithPackageIOs drop 1 foreach { case (pin, io) => { + shell.xdc.addPullup(io) + } } + } } +} + +class QSPIPeripheralVC707ShellPlacer(val shell: VC707Shell, val shellInput: SPIFlashShellInput)(implicit val valName: ValName) + extends SPIFlashShellPlacer[VC707Shell] +{ + def place(designInput: SPIFlashDesignInput) = new QSPIPeripheralVC707PlacedOverlay(shell, valName.name, designInput, shellInput) +} + +class PWMPeripheralVC707PlacedOverlay(val shell: VC707Shell, name: String, val designInput: PWMDesignInput, val shellInput: PWMShellInput) + extends PWMXilinxPlacedOverlay(name, designInput, shellInput) +{ + shell { InModuleBody { + val packagePinsWithPackageIOs = Seq(("AD36", IOPin(io.pwm_gpio(0))), //J23 pins 5-8 + ("Y35", IOPin(io.pwm_gpio(1))), + ("AD37", IOPin(io.pwm_gpio(2))), + ("AA36", IOPin(io.pwm_gpio(3)))) + + packagePinsWithPackageIOs foreach { case (pin, io) => { + shell.xdc.addPackagePin(io, pin) + shell.xdc.addIOStandard(io, "LVCMOS18") + shell.xdc.addIOB(io) + } } + } } +} + +class PWMPeripheralVC707ShellPlacer(val shell: VC707Shell, val shellInput: PWMShellInput)(implicit val valName: ValName) + extends PWMShellPlacer[VC707Shell] { + def place(designInput: PWMDesignInput) = new PWMPeripheralVC707PlacedOverlay(shell, valName.name, designInput, shellInput) +} + +class GPIOPeripheralVC707PlacedOverlay(val shell: VC707Shell, name: String, val designInput: GPIODesignInput, val shellInput: GPIOShellInput) + extends GPIOXilinxPlacedOverlay(name, designInput, shellInput) +{ + shell { InModuleBody { + val gpioLocations = List("AB33", "AF31", "AC33", "AF32", "AD32", "AE34", "AD33", "AE35", "AC30", "AF34", "AD30", "AG34", "AA29", "AE32", "AA30", "AE33") //J3 pins 1-16 + val iosWithLocs = io.gpio.zip(gpioLocations) + val packagePinsWithPackageIOs = iosWithLocs.map { case (io, pin) => (pin, IOPin(io)) } + println(packagePinsWithPackageIOs) + + packagePinsWithPackageIOs foreach { case (pin, io) => { + shell.xdc.addPackagePin(io, pin) + shell.xdc.addIOStandard(io, "LVCMOS18") + shell.xdc.addIOB(io) + } } + } } +} + +class GPIOPeripheralVC707ShellPlacer(val shell: VC707Shell, val shellInput: GPIOShellInput)(implicit val valName: ValName) + extends GPIOShellPlacer[VC707Shell] { + + def place(designInput: GPIODesignInput) = new GPIOPeripheralVC707PlacedOverlay(shell, valName.name, designInput, shellInput) +} + +class PeripheralVC707Shell(implicit p: Parameters) extends VC707Shell { + + val gpio = Overlay(GPIOOverlayKey, new GPIOPeripheralVC707ShellPlacer(this, GPIOShellInput())) + val uart = Seq.tabulate(2) { i => Overlay(UARTOverlayKey, new UARTPeripheralVC707ShellPlacer(this, UARTShellInput(index = i))(valName = ValName(s"uart$i"))) } + val qspi = Seq.tabulate(2) { i => Overlay(SPIFlashOverlayKey, new QSPIPeripheralVC707ShellPlacer(this, SPIFlashShellInput(index = i))(valName = ValName(s"qspi$i"))) } + val pwm = Seq.tabulate(1) { i => Overlay(PWMOverlayKey, new PWMPeripheralVC707ShellPlacer(this, PWMShellInput(index = i))(valName = ValName(s"pwm$i"))) } + val i2c = Seq.tabulate(2) { i => Overlay(I2COverlayKey, new I2CPeripheralVC707ShellPlacer(this, I2CShellInput(index = i))(valName = ValName(s"i2c$i"))) } + + val topDesign = LazyModule(p(DesignKey)(designParameters)) + + p(ClockInputOverlayKey).foreach(_.place(ClockInputDesignInput())) + + override lazy val module = new LazyRawModuleImp(this) { + + val reset = IO(Input(Bool())) + val clock = IO(Input(Clock())) + xdc.addBoardPin(reset, "reset") + val por_clock = sys_clock.get.get.asInstanceOf[SysClockVC707PlacedOverlay].clock + val powerOnReset = PowerOnResetFPGAOnly(por_clock) + + pllReset := + reset || powerOnReset + + } +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/PinXilinxOverlay.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/PinXilinxOverlay.scala new file mode 100644 index 0000000..5794487 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/PinXilinxOverlay.scala @@ -0,0 +1,13 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell.xilinx + +import chisel3._ +import freechips.rocketchip.diplomacy._ +import sifive.fpgashells.shell._ +import sifive.fpgashells.ip.xilinx._ + +abstract class PinXilinxPlacedOverlay(name: String, di: PinDesignInput, si: PinShellInput) + extends PinPlacedOverlay(name, di, si) +{ + def shell: XilinxShell +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/SDIOOverlay.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/SDIOOverlay.scala new file mode 100644 index 0000000..a73b109 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/SDIOOverlay.scala @@ -0,0 +1,13 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell.xilinx + +import chisel3._ +import freechips.rocketchip.diplomacy._ +import sifive.fpgashells.shell._ +import sifive.fpgashells.ip.xilinx._ + +abstract class SDIOXilinxPlacedOverlay(name: String, di: SDIODesignInput, si: SDIOShellInput) + extends SDIOPlacedOverlay(name, di, si) +{ + def shell: XilinxShell +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/SPIFlashXilinxOverlay.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/SPIFlashXilinxOverlay.scala new file mode 100644 index 0000000..97b4673 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/SPIFlashXilinxOverlay.scala @@ -0,0 +1,23 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell.xilinx + +import chisel3._ +import freechips.rocketchip.diplomacy._ +import sifive.fpgashells.shell._ +import sifive.fpgashells.ip.xilinx._ + +abstract class SPIFlashXilinxPlacedOverlay(name: String, di: SPIFlashDesignInput, si: SPIFlashShellInput) + extends SPIFlashPlacedOverlay(name, di, si) +{ + def shell: XilinxShell + + shell { InModuleBody { + UIntToAnalog(tlqspiSink.bundle.sck , io.qspi_sck, true.B) + UIntToAnalog(tlqspiSink.bundle.cs(0), io.qspi_cs , true.B) + + tlqspiSink.bundle.dq.zip(io.qspi_dq).foreach { case(design_dq, io_dq) => + UIntToAnalog(design_dq.o, io_dq, design_dq.oe) + design_dq.i := AnalogToUInt(io_dq) + } + } } +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/SwitchOverlay.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/SwitchOverlay.scala new file mode 100644 index 0000000..0955139 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/SwitchOverlay.scala @@ -0,0 +1,34 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell.xilinx + +import chisel3._ +import freechips.rocketchip.diplomacy._ +import sifive.fpgashells.shell._ +import sifive.fpgashells.ip.xilinx._ + +abstract class SwitchXilinxPlacedOverlay(name: String, di: SwitchDesignInput, si: SwitchShellInput, boardPin: Option[String] = None, packagePin: Option[String] = None, ioStandard: String = "LVCMOS33") + extends SwitchPlacedOverlay(name, di, si) +{ + def shell: XilinxShell + + shell { InModuleBody { + val bwire = Wire(Bool()) + switchSource.out(0)._1 := bwire.asUInt + val ibuf = Module(new IBUF) + ibuf.suggestName(s"switch_ibuf_${si.number}") + ibuf.io.I := io + bwire := ibuf.io.O + + require((boardPin.isEmpty || packagePin.isEmpty), "can't provide both boardpin and packagepin, this is ambiguous") + val cutAt = if(boardPin.isDefined) 1 else 0 + val ios = IOPin.of(io) + val boardIO = ios.take(cutAt) + val packageIO = ios.drop(cutAt) + + (boardPin zip boardIO) foreach { case (pin, io) => shell.xdc.addBoardPin (io, pin) } + (packagePin zip packageIO) foreach { case (pin, io) => + shell.xdc.addPackagePin(io, pin) + shell.xdc.addIOStandard(io, ioStandard) + } + } } +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/TracePMODOverlay.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/TracePMODOverlay.scala new file mode 100644 index 0000000..7a408c9 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/TracePMODOverlay.scala @@ -0,0 +1,29 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell.xilinx + +import chisel3._ +import freechips.rocketchip.diplomacy._ +import sifive.fpgashells.shell._ +import sifive.fpgashells.ip.xilinx._ + +abstract class TracePMODXilinxPlacedOverlay(name: String, di: TracePMODDesignInput, si: TracePMODShellInput, boardPins: Seq[String] = Nil, packagePins: Seq[String] = Nil, ioStandard: String = "LVCMOS33") + extends TracePMODPlacedOverlay(name, di, si) +{ + def shell: XilinxShell + val width = boardPins.size + packagePins.size + + shell { InModuleBody { + io := pmodTraceSink.bundle + + val cutAt = boardPins.size + val ios = IOPin.of(io) + val boardIOs = ios.take(cutAt) + val packageIOs = ios.drop(cutAt) + + (boardPins zip boardIOs) foreach { case (pin, io) => shell.xdc.addBoardPin (io, pin) } + (packagePins zip packageIOs) foreach { case (pin, io) => + shell.xdc.addPackagePin(io, pin) + shell.xdc.addIOStandard(io, ioStandard) + } + } } +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/UARTOverlay.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/UARTOverlay.scala new file mode 100644 index 0000000..d6a50e0 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/UARTOverlay.scala @@ -0,0 +1,25 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell.xilinx + +import chisel3._ +import freechips.rocketchip.diplomacy._ +import sifive.fpgashells.shell._ +import sifive.fpgashells.ip.xilinx._ + +abstract class UARTXilinxPlacedOverlay(name: String, di: UARTDesignInput, si: UARTShellInput, flowControl: Boolean) + extends UARTPlacedOverlay(name, di, si, flowControl) +{ + def shell: XilinxShell + + InModuleBody { + val (io, _) = uartSource.out(0) + val tluartport = tluartSink.bundle + io <> tluartport + tluartport.rxd := RegNext(RegNext(io.rxd)) + } + + shell { InModuleBody { + UIntToAnalog(uartSink.bundle.txd, io.txd, true.B) + uartSink.bundle.rxd := AnalogToUInt(io.rxd) + } } +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/UltraScaleShell.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/UltraScaleShell.scala new file mode 100644 index 0000000..49b5f57 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/UltraScaleShell.scala @@ -0,0 +1,135 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell.xilinx + +import chisel3._ +import freechips.rocketchip.config._ +import freechips.rocketchip.diplomacy._ +import freechips.rocketchip.tilelink._ +import sifive.fpgashells.clocks._ +import sifive.fpgashells.shell._ +import sifive.fpgashells.ip.xilinx._ +import sifive.fpgashells.devices.xilinx.xdma._ +import sifive.fpgashells.devices.xilinx.ethernet._ +import sifive.fpgashells.ip.xilinx.xxv_ethernet._ + +class XDMATopPads(val numLanes: Int) extends Bundle { + val refclk = Input(new LVDSClock) + val lanes = new XDMAPads(numLanes) +} + +class XDMABridge(val numLanes: Int) extends Bundle { + val lanes = new XDMAPads(numLanes) + val srstn = Input(Bool()) + val O = Input(Clock()) + val ODIV2 = Input(Clock()) +} + +abstract class EthernetUltraScalePlacedOverlay(name: String, di: EthernetDesignInput, si: EthernetShellInput, config: XXVEthernetParams) + extends EthernetPlacedOverlay(name, di, si) +{ + def shell: UltraScaleShell + + val pcs = LazyModule(new DiplomaticXXVEthernet(config)) + pcs.suggestName(name + "_pcs") + + val padSource = BundleBridgeSource(() => new XXVEthernetPads) + val padSink = shell { padSource.makeSink() } + val dclk = InModuleBody { Wire(Clock()) } + + InModuleBody { + padSource.bundle <> pcs.module.io.pads + + val clocks = pcs.module.io.clocks + clocks.rx_core_clk_0 := clocks.tx_mii_clk_0 + clocks.dclk := dclk + clocks.sys_reset := Module.reset + + val macIO = pcs.module.io.mac + val pcsIO = overlayOutput.eth + macIO.tx_mii_d_0 := pcsIO.tx_d + macIO.tx_mii_c_0 := pcsIO.tx_c + pcsIO.rx_d := macIO.rx_mii_d_0 + pcsIO.rx_c := macIO.rx_mii_c_0 + + macIO.gt_loopback_in_0 := pcsIO.loopback + pcsIO.rx_lock := macIO.stat_rx_block_lock_0 + pcsIO.sfp_detect := true.B + + pcsIO.rx_clock := clocks.tx_mii_clk_0 + pcsIO.rx_reset := clocks.user_rx_reset_0 + pcsIO.tx_clock := clocks.tx_mii_clk_0 + pcsIO.tx_reset := clocks.user_tx_reset_0 + + // refclk_p is added by the IP xdc's anonymous create_clock [get_pins name_refclk_p] + shell.sdc.addGroup(clocks = Seq(s"${name}_refclk_p"), pins = Seq(pcs.module.blackbox.io.tx_mii_clk_0)) + } + + shell { InModuleBody { + val pcsIO = padSink.bundle + io.tx_p := pcsIO.gt_txp_out_0 + io.tx_n := pcsIO.gt_txn_out_0 + pcsIO.gt_rxp_in_0 := io.rx_p + pcsIO.gt_rxn_in_0 := io.rx_n + pcsIO.gt_refclk_p := io.refclk_p + pcsIO.gt_refclk_n := io.refclk_n + } } +} + +abstract class PCIeUltraScalePlacedOverlay(name: String, di: PCIeDesignInput, si: PCIeShellInput, config: XDMAParams) + extends PCIePlacedOverlay[XDMATopPads](name, di, si) +{ + def shell: UltraScaleShell + + val pcie = LazyModule(new XDMA(config)) + val bridge = BundleBridgeSource(() => new XDMABridge(config.lanes)) + val topBridge = shell { bridge.makeSink() } + val axiClk = ClockSourceNode(freqMHz = config.axiMHz) + val areset = ClockSinkNode(Seq(ClockSinkParameters())) + areset := di.wrangler := axiClk + + val slaveSide = TLIdentityNode() + pcie.crossTLIn(pcie.slave) := slaveSide + pcie.crossTLIn(pcie.control) := slaveSide + val node = NodeHandle(slaveSide, pcie.crossTLOut(pcie.master)) + val intnode = pcie.crossIntOut(pcie.intnode) + + def overlayOutput = PCIeOverlayOutput(node, intnode) + def ioFactory = new XDMATopPads(config.lanes) + + InModuleBody { + val (axi, _) = axiClk.out(0) + val (ar, _) = areset.in(0) + val b = bridge.out(0)._1 + + pcie.module.clock := ar.clock + pcie.module.reset := ar.reset + + b.lanes <> pcie.module.io.pads + + axi.clock := pcie.module.io.clocks.axi_aclk + axi.reset := !pcie.module.io.clocks.axi_aresetn + pcie.module.io.clocks.sys_rst_n := b.srstn + pcie.module.io.clocks.sys_clk := b.ODIV2 + pcie.module.io.clocks.sys_clk_gt := b.O + + shell.sdc.addGroup(clocks = Seq(s"${name}_ref_clk"), pins = Seq(pcie.imp.module.blackbox.io.axi_aclk)) +// shell.sdc.addGroup(pins = Seq(pcie.imp.module.blackbox.io.sys_clk_gt)) + shell.sdc.addAsyncPath(Seq(pcie.imp.module.blackbox.io.axi_aresetn)) + } + + shell { InModuleBody { + val b = topBridge.in(0)._1 + + val ibufds = Module(new IBUFDS_GTE4) + ibufds.suggestName(s"${name}_refclk_ibufds") + ibufds.io.CEB := false.B + ibufds.io.I := io.refclk.p + ibufds.io.IB := io.refclk.n + b.O := ibufds.io.O + b.ODIV2 := ibufds.io.ODIV2 + b.srstn := !shell.pllReset + io.lanes <> b.lanes + + shell.sdc.addClock(s"${name}_ref_clk", io.refclk.p, 100) + } } +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/VC707NewShell.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/VC707NewShell.scala new file mode 100644 index 0000000..ddbd8ed --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/VC707NewShell.scala @@ -0,0 +1,337 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell.xilinx + +import chisel3._ +import chisel3.experimental.IO +import freechips.rocketchip.config._ +import freechips.rocketchip.diplomacy._ +import freechips.rocketchip.tilelink._ +import freechips.rocketchip.util.SyncResetSynchronizerShiftReg +import sifive.fpgashells.clocks._ +import sifive.fpgashells.shell._ +import sifive.fpgashells.ip.xilinx._ +import sifive.blocks.devices.chiplink._ +import sifive.fpgashells.devices.xilinx.xilinxvc707mig._ +import sifive.fpgashells.devices.xilinx.xilinxvc707pciex1._ + +class SysClockVC707PlacedOverlay(val shell: VC707Shell, name: String, val designInput: ClockInputDesignInput, val shellInput: ClockInputShellInput) + extends LVDSClockInputXilinxPlacedOverlay(name, designInput, shellInput) +{ + val node = shell { ClockSourceNode(freqMHz = 200, jitterPS = 50)(ValName(name)) } + + shell { InModuleBody { + shell.xdc.addBoardPin(io.p, "clk_p") + shell.xdc.addBoardPin(io.n, "clk_n") + } } +} +class SysClockVC707ShellPlacer(val shell: VC707Shell, val shellInput: ClockInputShellInput)(implicit val valName: ValName) + extends ClockInputShellPlacer[VC707Shell] { + def place(designInput: ClockInputDesignInput) = new SysClockVC707PlacedOverlay(shell, valName.name, designInput, shellInput) +} + +class SDIOVC707PlacedOverlay(val shell: VC707Shell, name: String, val designInput: SDIODesignInput, val shellInput: SDIOShellInput) + extends SDIOXilinxPlacedOverlay(name, designInput, shellInput) +{ + shell { InModuleBody { + val packagePinsWithPackageIOs = Seq(("AN30", IOPin(io.sdio_clk)), + ("AP30", IOPin(io.sdio_cmd)), + ("AR30", IOPin(io.sdio_dat_0)), + ("AU31", IOPin(io.sdio_dat_1)), + ("AV31", IOPin(io.sdio_dat_2)), + ("AT30", IOPin(io.sdio_dat_3))) + + packagePinsWithPackageIOs foreach { case (pin, io) => { + shell.xdc.addPackagePin(io, pin) + shell.xdc.addIOStandard(io, "LVCMOS18") + shell.xdc.addIOB(io) + } } + packagePinsWithPackageIOs drop 1 foreach { case (pin, io) => { + shell.xdc.addPullup(io) + } } + } } +} +class SDIOVC707ShellPlacer(val shell: VC707Shell, val shellInput: SDIOShellInput)(implicit val valName: ValName) + extends SDIOShellPlacer[VC707Shell] { + def place(designInput: SDIODesignInput) = new SDIOVC707PlacedOverlay(shell, valName.name, designInput, shellInput) +} + +class UARTVC707PlacedOverlay(val shell: VC707Shell, name: String, val designInput: UARTDesignInput, val shellInput: UARTShellInput) + extends UARTXilinxPlacedOverlay(name, designInput, shellInput, true) +{ + shell { InModuleBody { + val packagePinsWithPackageIOs = Seq(("AT32", IOPin(io.ctsn.get)), + ("AR34", IOPin(io.rtsn.get)), + ("AU33", IOPin(io.rxd)), + ("AU36", IOPin(io.txd))) + + packagePinsWithPackageIOs foreach { case (pin, io) => { + shell.xdc.addPackagePin(io, pin) + shell.xdc.addIOStandard(io, "LVCMOS18") + shell.xdc.addIOB(io) + } } + } } +} +class UARTVC707ShellPlacer(val shell: VC707Shell, val shellInput: UARTShellInput)(implicit val valName: ValName) + extends UARTShellPlacer[VC707Shell] { + def place(designInput: UARTDesignInput) = new UARTVC707PlacedOverlay(shell, valName.name, designInput, shellInput) +} + +class LEDVC707PlacedOverlay(val shell: VC707Shell, name: String, val designInput: LEDDesignInput, val shellInput: LEDShellInput) + extends LEDXilinxPlacedOverlay(name, designInput, shellInput, boardPin = Some(s"leds_8bits_tri_o_${shellInput.number}")) +class LEDVC707ShellPlacer(val shell: VC707Shell, val shellInput: LEDShellInput)(implicit val valName: ValName) + extends LEDShellPlacer[VC707Shell] { + def place(designInput: LEDDesignInput) = new LEDVC707PlacedOverlay(shell, valName.name, designInput, shellInput) +} + +class SwitchVC707PlacedOverlay(val shell: VC707Shell, name: String, val designInput: SwitchDesignInput, val shellInput: SwitchShellInput) + extends SwitchXilinxPlacedOverlay(name, designInput, shellInput, boardPin = Some(s"dip_switches_tri_i_${shellInput.number}")) +class SwitchVC707ShellPlacer(val shell: VC707Shell, val shellInput: SwitchShellInput)(implicit val valName: ValName) + extends SwitchShellPlacer[VC707Shell] { + def place(designInput: SwitchDesignInput) = new SwitchVC707PlacedOverlay(shell, valName.name, designInput, shellInput) +} + +class ButtonVC707PlacedOverlay(val shell: VC707Shell, name: String, val designInput: ButtonDesignInput, val shellInput: ButtonShellInput) + extends ButtonXilinxPlacedOverlay(name, designInput, shellInput, boardPin = Some(s"push_buttons_5bits_tri_i_${shellInput.number}")) +class ButtonVC707ShellPlacer(val shell: VC707Shell, val shellInput: ButtonShellInput)(implicit val valName: ValName) + extends ButtonShellPlacer[VC707Shell] { + def place(designInput: ButtonDesignInput) = new ButtonVC707PlacedOverlay(shell, valName.name, designInput, shellInput) +} + +class ChipLinkVC707PlacedOverlay(val shell: VC707Shell, name: String, val designInput: ChipLinkDesignInput, val shellInput: ChipLinkShellInput) + extends ChipLinkXilinxPlacedOverlay(name, designInput, shellInput, rxPhase=280, txPhase=220, rxMargin=0.3, txMargin=0.3) +{ + val ereset_n = shell { InModuleBody { + val ereset_n = IO(Input(Bool())) + ereset_n.suggestName("ereset_n") + shell.xdc.addPackagePin(ereset_n, "AF40") + shell.xdc.addIOStandard(ereset_n, "LVCMOS18") + shell.xdc.addTermination(ereset_n, "NONE") + ereset_n + } } + + shell { InModuleBody { + val dir1 = Seq("AF39", "AJ41", "AJ40", /* clk, rst, send */ + "AD40", "AD41", "AF41", "AG41", "AK39", "AL39", "AJ42", "AK42", + "AL41", "AL42", "AF42", "AG42", "AD38", "AE38", "AC40", "AC41", + "AD42", "AE42", "AJ38", "AK38", "AB41", "AB42", "Y42", "AA42", + "Y39", "AA39", "W40", "Y40", "AB38", "AB39", "AC38", "AC39") + val dir2 = Seq("U39", "R37", "T36", /* clk, rst, send */ + "U37", "U38", "U36", "T37", "U32", "U33", "V33", "V34", + "P35", "P36", "W32", "W33", "R38", "R39", "U34", "T35", + "R33", "R34", "N33", "N34", "P32", "P33", "V35", "V36", + "W36", "W37", "T32", "R32", "V39", "V40", "P37", "P38") + (IOPin.of(io.b2c) zip dir1) foreach { case (io, pin) => shell.xdc.addPackagePin(io, pin) } + (IOPin.of(io.c2b) zip dir2) foreach { case (io, pin) => shell.xdc.addPackagePin(io, pin) } + } } +} +class ChipLinkVC707ShellPlacer(val shell: VC707Shell, val shellInput: ChipLinkShellInput)(implicit val valName: ValName) + extends ChipLinkShellPlacer[VC707Shell] { + def place(designInput: ChipLinkDesignInput) = new ChipLinkVC707PlacedOverlay(shell, valName.name, designInput, shellInput) +} + +// TODO: JTAG is untested +class JTAGDebugVC707PlacedOverlay(val shell: VC707Shell, name: String, val designInput: JTAGDebugDesignInput, val shellInput: JTAGDebugShellInput) + extends JTAGDebugXilinxPlacedOverlay(name, designInput, shellInput) +{ + shell { InModuleBody { + shell.sdc.addClock("JTCK", IOPin(io.jtag_TCK), 10) + shell.sdc.addGroup(clocks = Seq("JTCK")) + shell.xdc.clockDedicatedRouteFalse(IOPin(io.jtag_TCK)) +/* if old method + val packagePinsWithPackageIOs = Seq(("R32", IOPin(io.jtag_TCK)), + ("W36", IOPin(io.jtag_TMS)), + ("W37", IOPin(io.jtag_TDI)), + ("V40", IOPin(io.jtag_TDO))) +*/ + /* + #Olimex Pin Olimex Function LCD Pin LCD Function FPGA Pin + #1 VREF 14 5V + #3 TTRST_N 1 LCD_DB7 AN40 + #5 TTDI 2 LCD_DB6 AR39 + #7 TTMS 3 LCD_DB5 AR38 + #9 TTCK 4 LCD_DB4 AT42 + #11 TRTCK NC NC NC + #13 TTDO 9 LCD_E AT40 + #15 TSRST_N 10 LCD_RW AR42 + #2 VREF 14 5V + #18 GND 13 GND + */ + val packagePinsWithPackageIOs = Seq(("AT42", IOPin(io.jtag_TCK)), + ("AR38", IOPin(io.jtag_TMS)), + ("AR39", IOPin(io.jtag_TDI)), + ("AT40", IOPin(io.jtag_TDO))) + packagePinsWithPackageIOs foreach { case (pin, io) => { + shell.xdc.addPackagePin(io, pin) + shell.xdc.addIOStandard(io, "LVCMOS18") + shell.xdc.addPullup(io) + } } + } } +} +class JTAGDebugVC707ShellPlacer(val shell: VC707Shell, val shellInput: JTAGDebugShellInput)(implicit val valName: ValName) + extends JTAGDebugShellPlacer[VC707Shell] { + def place(designInput: JTAGDebugDesignInput) = new JTAGDebugVC707PlacedOverlay(shell, valName.name, designInput, shellInput) +} + +case object VC7071GDDRSize extends Field[BigInt](0x40000000L * 1) // 1GB +case object VC7074GDDRSize extends Field[BigInt](0x40000000L * 4) // 4GB +class DDRVC707PlacedOverlay(val shell: VC707Shell, name: String, val designInput: DDRDesignInput, val shellInput: DDRShellInput) + extends DDRPlacedOverlay[XilinxVC707MIGPads](name, designInput, shellInput) +{ + val size = if (designInput.vc7074gbdimm) p(VC7074GDDRSize) else p(VC7071GDDRSize) + + val migParams = XilinxVC707MIGParams(address = AddressSet.misaligned(di.baseAddress, size)) + val mig = LazyModule(new XilinxVC707MIG(migParams)) + val ioNode = BundleBridgeSource(() => mig.module.io.cloneType) + val topIONode = shell { ioNode.makeSink() } + val ddrUI = shell { ClockSourceNode(freqMHz = 200) } + val areset = shell { ClockSinkNode(Seq(ClockSinkParameters())) } + areset := designInput.wrangler := ddrUI + + def overlayOutput = DDROverlayOutput(ddr = mig.node) + def ioFactory = new XilinxVC707MIGPads(size) + + InModuleBody { ioNode.bundle <> mig.module.io } + + shell { InModuleBody { + require (shell.sys_clock.get.isDefined, "Use of DDRVC707PlacedOverlay depends on SysClockVC707PlacedOverlay") + val (sys, _) = shell.sys_clock.get.get.overlayOutput.node.out(0) + val (ui, _) = ddrUI.out(0) + val (ar, _) = areset.in(0) + val port = topIONode.bundle.port + io <> port + ui.clock := port.ui_clk + ui.reset := !port.mmcm_locked || port.ui_clk_sync_rst + port.sys_clk_i := sys.clock.asUInt + port.sys_rst := sys.reset // pllReset + port.aresetn := !ar.reset + } } + + shell.sdc.addGroup(clocks = Seq("clk_pll_i")) +} +class DDRVC707ShellPlacer(val shell: VC707Shell, val shellInput: DDRShellInput)(implicit val valName: ValName) + extends DDRShellPlacer[VC707Shell] { + def place(designInput: DDRDesignInput) = new DDRVC707PlacedOverlay(shell, valName.name, designInput, shellInput) +} + +class PCIeVC707PlacedOverlay(val shell: VC707Shell, name: String, val designInput: PCIeDesignInput, val shellInput: PCIeShellInput) + extends PCIePlacedOverlay[XilinxVC707PCIeX1Pads](name, designInput, shellInput) +{ + val pcie = LazyModule(new XilinxVC707PCIeX1) + val ioNode = BundleBridgeSource(() => pcie.module.io.cloneType) + val topIONode = shell { ioNode.makeSink() } + val axiClk = shell { ClockSourceNode(freqMHz = 125) } + val areset = shell { ClockSinkNode(Seq(ClockSinkParameters())) } + areset := designInput.wrangler := axiClk + + val slaveSide = TLIdentityNode() + pcie.crossTLIn(pcie.slave) := slaveSide + pcie.crossTLIn(pcie.control) := slaveSide + val node = NodeHandle(slaveSide, pcie.crossTLOut(pcie.master)) + val intnode = pcie.crossIntOut(pcie.intnode) + + def overlayOutput = PCIeOverlayOutput(node, intnode) + def ioFactory = new XilinxVC707PCIeX1Pads + + InModuleBody { ioNode.bundle <> pcie.module.io } + + shell { InModuleBody { + val (axi, _) = axiClk.out(0) + val (ar, _) = areset.in(0) + val port = topIONode.bundle.port + io <> port + axi.clock := port.axi_aclk_out + axi.reset := !port.mmcm_lock + port.axi_aresetn := !ar.reset + port.axi_ctl_aresetn := !ar.reset + + shell.xdc.addPackagePin(io.REFCLK_rxp, "A10") + shell.xdc.addPackagePin(io.REFCLK_rxn, "A9") + shell.xdc.addPackagePin(io.pci_exp_txp, "H4") + shell.xdc.addPackagePin(io.pci_exp_txn, "H3") + shell.xdc.addPackagePin(io.pci_exp_rxp, "G6") + shell.xdc.addPackagePin(io.pci_exp_rxn, "G5") + + shell.sdc.addClock(s"${name}_ref_clk", io.REFCLK_rxp, 100) + } } + + shell.sdc.addGroup(clocks = Seq("txoutclk", "userclk1")) +} +class PCIeVC707ShellPlacer(val shell: VC707Shell, val shellInput: PCIeShellInput)(implicit val valName: ValName) + extends PCIeShellPlacer[VC707Shell] { + def place(designInput: PCIeDesignInput) = new PCIeVC707PlacedOverlay(shell, valName.name, designInput, shellInput) +} + +abstract class VC707Shell()(implicit p: Parameters) extends Series7Shell +{ + // PLL reset causes + val pllReset = InModuleBody { Wire(Bool()) } + + // Order matters; ddr depends on sys_clock + val sys_clock = Overlay(ClockInputOverlayKey, new SysClockVC707ShellPlacer(this, ClockInputShellInput())) + val led = Seq.tabulate(8)(i => Overlay(LEDOverlayKey, new LEDVC707ShellPlacer(this, LEDShellInput(color = "red", number = i))(valName = ValName(s"led_$i")))) + val switch = Seq.tabulate(8)(i => Overlay(SwitchOverlayKey, new SwitchVC707ShellPlacer(this, SwitchShellInput(number = i))(valName = ValName(s"switch_$i")))) + val button = Seq.tabulate(5)(i => Overlay(ButtonOverlayKey, new ButtonVC707ShellPlacer(this, ButtonShellInput(number = i))(valName = ValName(s"button_$i")))) + val chiplink = Overlay(ChipLinkOverlayKey, new ChipLinkVC707ShellPlacer(this, ChipLinkShellInput())) + val ddr = Overlay(DDROverlayKey, new DDRVC707ShellPlacer(this, DDRShellInput())) + val sdio = Overlay(SDIOOverlayKey, new SDIOVC707ShellPlacer(this, SDIOShellInput())) + val jtag = Overlay(JTAGDebugOverlayKey, new JTAGDebugVC707ShellPlacer(this, JTAGDebugShellInput())) +} + +class VC707BaseShell()(implicit p: Parameters) extends VC707Shell +{ + val uart = Seq.tabulate(1)(i => Overlay(UARTOverlayKey, new UARTVC707ShellPlacer(this, UARTShellInput(index = 0)))) + val topDesign = LazyModule(p(DesignKey)(designParameters)) + + // Place the sys_clock at the Shell if the user didn't ask for it + p(ClockInputOverlayKey).foreach(_.place(ClockInputDesignInput())) + + override lazy val module = new LazyRawModuleImp(this) { + val reset = IO(Input(Bool())) + xdc.addBoardPin(reset, "reset") + + val reset_ibuf = Module(new IBUF) + reset_ibuf.io.I := reset + + val sysclk: Clock = sys_clock.get() match { + case Some(x: SysClockVC707PlacedOverlay) => x.clock + } + val powerOnReset = PowerOnResetFPGAOnly(sysclk) + sdc.addAsyncPath(Seq(powerOnReset)) + + val ereset: Bool = chiplink.get() match { + case Some(x: ChipLinkVCU118PlacedOverlay) => !x.ereset_n + case _ => false.B + } + pllReset := + reset_ibuf.io.O || powerOnReset || ereset + } +} + +class VC707PCIeShell()(implicit p: Parameters) extends VC707Shell +{ + val uart = Seq.tabulate(1)(i => Overlay(UARTOverlayKey, new UARTVC707ShellPlacer(this, UARTShellInput(index = 0)))) + val pcie = Overlay(PCIeOverlayKey, new PCIeVC707ShellPlacer(this, PCIeShellInput())) + val topDesign = LazyModule(p(DesignKey)(designParameters)) + + // Place the sys_clock at the Shell if the user didn't ask for it + p(ClockInputOverlayKey).foreach(_.place(ClockInputDesignInput())) + + override lazy val module = new LazyRawModuleImp(this) { + val reset = IO(Input(Bool())) + xdc.addBoardPin(reset, "reset") + + val reset_ibuf = Module(new IBUF) + reset_ibuf.io.I := reset + val sysclk: Clock = sys_clock.get() match { + case Some(x: SysClockVC707PlacedOverlay) => x.clock + } + val powerOnReset = PowerOnResetFPGAOnly(sysclk) + sdc.addAsyncPath(Seq(powerOnReset)) + val ereset: Bool = chiplink.get() match { + case Some(x: ChipLinkVCU118PlacedOverlay) => !x.ereset_n + case _ => false.B + } + pllReset := + reset_ibuf.io.O || powerOnReset || ereset + } +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/VC707Shell.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/VC707Shell.scala new file mode 100644 index 0000000..a0ed4c2 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/VC707Shell.scala @@ -0,0 +1,613 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell.xilinx.vc707shell + +import Chisel._ +import chisel3.{Input, Output, RawModule, withClockAndReset} +import chisel3.experimental.{attach, Analog} + +import freechips.rocketchip.config._ +import freechips.rocketchip.devices.debug._ +import freechips.rocketchip.util.{SyncResetSynchronizerShiftReg, ElaborationArtefacts, HeterogeneousBag} + +import sifive.blocks.devices.gpio._ +import sifive.blocks.devices.spi._ +import sifive.blocks.devices.uart._ +import sifive.blocks.devices.chiplink._ + +import sifive.fpgashells.devices.xilinx.xilinxvc707mig._ +import sifive.fpgashells.devices.xilinx.xilinxvc707pciex1._ +import sifive.fpgashells.ip.xilinx.{IBUFDS, PowerOnResetFPGAOnly, sdio_spi_bridge, Series7MMCM, vc707reset} + +//vc707_sys_clock_mmcm0, vc707_sys_clock_, vc707_sys_clock_mmcm2 , vc707reset} +import sifive.fpgashells.clocks._ +//------------------------------------------------------------------------- +// VC707Shell +//------------------------------------------------------------------------- + +trait HasDDR3 { this: VC707Shell => + + require(!p.lift(MemoryXilinxDDRKey).isEmpty) + val ddr = IO(new XilinxVC707MIGPads(p(MemoryXilinxDDRKey))) + + def connectMIG(dut: HasMemoryXilinxVC707MIGModuleImp): Unit = { + // Clock & Reset + dut.xilinxvc707mig.sys_clk_i := sys_clock.asUInt + mig_clock := dut.xilinxvc707mig.ui_clk + mig_sys_reset := dut.xilinxvc707mig.ui_clk_sync_rst + mig_mmcm_locked := dut.xilinxvc707mig.mmcm_locked + dut.xilinxvc707mig.aresetn := mig_resetn + dut.xilinxvc707mig.sys_rst := sys_reset + + ddr <> dut.xilinxvc707mig + } +} + +trait HasPCIe { this: VC707Shell => + val pcie = IO(new XilinxVC707PCIeX1Pads) + + def connectPCIe(dut: HasSystemXilinxVC707PCIeX1ModuleImp): Unit = { + // Clock & Reset + dut.xilinxvc707pcie.axi_aresetn := pcie_dat_resetn + pcie_dat_clock := dut.xilinxvc707pcie.axi_aclk_out + pcie_cfg_clock := dut.xilinxvc707pcie.axi_ctl_aclk_out + mmcm_lock_pcie := dut.xilinxvc707pcie.mmcm_lock + dut.xilinxvc707pcie.axi_ctl_aresetn := pcie_dat_resetn + + pcie <> dut.xilinxvc707pcie + } +} + +trait HasDebugJTAG { this: VC707Shell => + // JTAG + val jtag_TCK = IO(Input(Clock())) + val jtag_TMS = IO(Input(Bool())) + val jtag_TDI = IO(Input(Bool())) + val jtag_TDO = IO(Output(Bool())) + + def connectDebugJTAG(dut: HasPeripheryDebugModuleImp, fmcxm105: Boolean = true): SystemJTAGIO = { + + require(dut.debug.isDefined, "Connecting JTAG requires that debug module exists") + ElaborationArtefacts.add( + """debugjtag.vivado.tcl""", + """set vc707debugjtag_vivado_tcl_dir [file dirname [file normalize [info script]]] + add_files -fileset [current_fileset -constrset] [glob -directory $vc707debugjtag_vivado_tcl_dir {*.vc707debugjtag.xdc}]""" + ) + + if(fmcxm105) { + //VC707 constraints for Xilinx FMC XM105 Debug Card + ElaborationArtefacts.add( + """vc707debugjtag.xdc""", + """set_property CLOCK_DEDICATED_ROUTE FALSE [get_nets jtag_TCK] + set_property -dict { PACKAGE_PIN R32 IOSTANDARD LVCMOS18 PULLUP TRUE } [get_ports {jtag_TCK}] + set_property -dict { PACKAGE_PIN W36 IOSTANDARD LVCMOS18 PULLUP TRUE } [get_ports {jtag_TMS}] + set_property -dict { PACKAGE_PIN W37 IOSTANDARD LVCMOS18 PULLUP TRUE } [get_ports {jtag_TDI}] + set_property -dict { PACKAGE_PIN V40 IOSTANDARD LVCMOS18 PULLUP TRUE } [get_ports {jtag_TDO}] + create_clock -add -name JTCK -period 100 -waveform {0 50} [get_ports {jtag_TCK}];""" + ) + } else { + //VC707 constraints for Olimex connect to LCD panel header + ElaborationArtefacts.add( + """vc707debugjtag.xdc""", + """ + #Olimex Pin Olimex Function LCD Pin LCD Function FPGA Pin + #1 VREF 14 5V + #3 TTRST_N 1 LCD_DB7 AN40 + #5 TTDI 2 LCD_DB6 AR39 + #7 TTMS 3 LCD_DB5 AR38 + #9 TTCK 4 LCD_DB4 AT42 + #11 TRTCK NC NC NC + #13 TTDO 9 LCD_E AT40 + #15 TSRST_N 10 LCD_RW AR42 + #2 VREF 14 5V + #18 GND 13 GND + set_property CLOCK_DEDICATED_ROUTE FALSE [get_nets jtag_TCK] + set_property -dict { PACKAGE_PIN AT42 IOSTANDARD LVCMOS18 PULLUP TRUE } [get_ports {jtag_TCK}] + set_property -dict { PACKAGE_PIN AR38 IOSTANDARD LVCMOS18 PULLUP TRUE } [get_ports {jtag_TMS}] + set_property -dict { PACKAGE_PIN AR39 IOSTANDARD LVCMOS18 PULLUP TRUE } [get_ports {jtag_TDI}] + set_property -dict { PACKAGE_PIN AT40 IOSTANDARD LVCMOS18 PULLUP TRUE } [get_ports {jtag_TDO}] + create_clock -add -name JTCK -period 100 -waveform {0 50} [get_ports {jtag_TCK}];""" + ) + } + + val djtag = dut.debug.get.systemjtag.get + + djtag.jtag.TCK := jtag_TCK + djtag.jtag.TMS := jtag_TMS + djtag.jtag.TDI := jtag_TDI + jtag_TDO := djtag.jtag.TDO.data + + djtag.mfr_id := p(JtagDTMKey).idcodeManufId.U(11.W) + djtag.part_number := p(JtagDTMKey).idcodePartNum.U(16.W) + djtag.version := p(JtagDTMKey).idcodeVersion.U(4.W) + + djtag.reset := PowerOnResetFPGAOnly(dut_clock) + dut_ndreset := dut.debug.get.ndreset + djtag + } +} + +trait HasVC707ChipLink { this: VC707Shell => + + val chiplink = IO(new WideDataLayerPort(ChipLinkParams(Nil,Nil))) + val ereset_n = IO(Bool(INPUT)) + + def constrainChipLink(iofpga: Boolean = false): Unit = { + val direction0Pins = if(iofpga) "chiplink_b2c" else "chiplink_c2b" + val direction1Pins = if(iofpga) "chiplink_c2b" else "chiplink_b2c" + + ElaborationArtefacts.add( + """vc707chiplink.vivado.tcl""", + """set vc707chiplink_vivado_tcl_dir [file dirname [file normalize [info script]]] + add_files -fileset [current_fileset -constrset] [glob -directory $vc707chiplink_vivado_tcl_dir {*.vc707chiplink.xdc}]""" + ) + + ElaborationArtefacts.add( + """vc707chiplink.xdc""", s""" + set_property PACKAGE_PIN AF39 [get_ports ${direction0Pins}_clk] + set_property PACKAGE_PIN AD40 [get_ports {${direction0Pins}_data[0]}] + set_property PACKAGE_PIN AD41 [get_ports {${direction0Pins}_data[1]}] + set_property PACKAGE_PIN AF41 [get_ports {${direction0Pins}_data[2]}] + set_property PACKAGE_PIN AG41 [get_ports {${direction0Pins}_data[3]}] + set_property PACKAGE_PIN AK39 [get_ports {${direction0Pins}_data[4]}] + set_property PACKAGE_PIN AL39 [get_ports {${direction0Pins}_data[5]}] + set_property PACKAGE_PIN AJ42 [get_ports {${direction0Pins}_data[6]}] + set_property PACKAGE_PIN AK42 [get_ports {${direction0Pins}_data[7]}] + set_property PACKAGE_PIN AL41 [get_ports {${direction0Pins}_data[8]}] + set_property PACKAGE_PIN AL42 [get_ports {${direction0Pins}_data[9]}] + set_property PACKAGE_PIN AF42 [get_ports {${direction0Pins}_data[10]}] + set_property PACKAGE_PIN AG42 [get_ports {${direction0Pins}_data[11]}] + set_property PACKAGE_PIN AD38 [get_ports {${direction0Pins}_data[12]}] + set_property PACKAGE_PIN AE38 [get_ports {${direction0Pins}_data[13]}] + set_property PACKAGE_PIN AC40 [get_ports {${direction0Pins}_data[14]}] + set_property PACKAGE_PIN AC41 [get_ports {${direction0Pins}_data[15]}] + set_property PACKAGE_PIN AD42 [get_ports {${direction0Pins}_data[16]}] + set_property PACKAGE_PIN AE42 [get_ports {${direction0Pins}_data[17]}] + set_property PACKAGE_PIN AJ38 [get_ports {${direction0Pins}_data[18]}] + set_property PACKAGE_PIN AK38 [get_ports {${direction0Pins}_data[19]}] + set_property PACKAGE_PIN AB41 [get_ports {${direction0Pins}_data[20]}] + set_property PACKAGE_PIN AB42 [get_ports {${direction0Pins}_data[21]}] + set_property PACKAGE_PIN Y42 [get_ports {${direction0Pins}_data[22]}] + set_property PACKAGE_PIN AA42 [get_ports {${direction0Pins}_data[23]}] + set_property PACKAGE_PIN Y39 [get_ports {${direction0Pins}_data[24]}] + set_property PACKAGE_PIN AA39 [get_ports {${direction0Pins}_data[25]}] + set_property PACKAGE_PIN W40 [get_ports {${direction0Pins}_data[26]}] + set_property PACKAGE_PIN Y40 [get_ports {${direction0Pins}_data[27]}] + set_property PACKAGE_PIN AB38 [get_ports {${direction0Pins}_data[28]}] + set_property PACKAGE_PIN AB39 [get_ports {${direction0Pins}_data[29]}] + set_property PACKAGE_PIN AC38 [get_ports {${direction0Pins}_data[30]}] + set_property PACKAGE_PIN AC39 [get_ports {${direction0Pins}_data[31]}] + set_property PACKAGE_PIN AJ40 [get_ports ${direction0Pins}_send] + set_property PACKAGE_PIN AJ41 [get_ports ${direction0Pins}_rst] + + set_property PACKAGE_PIN U39 [get_ports ${direction1Pins}_clk] + set_property PACKAGE_PIN U37 [get_ports {${direction1Pins}_data[0]}] + set_property PACKAGE_PIN U38 [get_ports {${direction1Pins}_data[1]}] + set_property PACKAGE_PIN U36 [get_ports {${direction1Pins}_data[2]}] + set_property PACKAGE_PIN T37 [get_ports {${direction1Pins}_data[3]}] + set_property PACKAGE_PIN U32 [get_ports {${direction1Pins}_data[4]}] + set_property PACKAGE_PIN U33 [get_ports {${direction1Pins}_data[5]}] + set_property PACKAGE_PIN V33 [get_ports {${direction1Pins}_data[6]}] + set_property PACKAGE_PIN V34 [get_ports {${direction1Pins}_data[7]}] + set_property PACKAGE_PIN P35 [get_ports {${direction1Pins}_data[8]}] + set_property PACKAGE_PIN P36 [get_ports {${direction1Pins}_data[9]}] + set_property PACKAGE_PIN W32 [get_ports {${direction1Pins}_data[10]}] + set_property PACKAGE_PIN W33 [get_ports {${direction1Pins}_data[11]}] + set_property PACKAGE_PIN R38 [get_ports {${direction1Pins}_data[12]}] + set_property PACKAGE_PIN R39 [get_ports {${direction1Pins}_data[13]}] + set_property PACKAGE_PIN U34 [get_ports {${direction1Pins}_data[14]}] + set_property PACKAGE_PIN T35 [get_ports {${direction1Pins}_data[15]}] + set_property PACKAGE_PIN R33 [get_ports {${direction1Pins}_data[16]}] + set_property PACKAGE_PIN R34 [get_ports {${direction1Pins}_data[17]}] + set_property PACKAGE_PIN N33 [get_ports {${direction1Pins}_data[18]}] + set_property PACKAGE_PIN N34 [get_ports {${direction1Pins}_data[19]}] + set_property PACKAGE_PIN P32 [get_ports {${direction1Pins}_data[20]}] + set_property PACKAGE_PIN P33 [get_ports {${direction1Pins}_data[21]}] + set_property PACKAGE_PIN V35 [get_ports {${direction1Pins}_data[22]}] + set_property PACKAGE_PIN V36 [get_ports {${direction1Pins}_data[23]}] + set_property PACKAGE_PIN W36 [get_ports {${direction1Pins}_data[24]}] + set_property PACKAGE_PIN W37 [get_ports {${direction1Pins}_data[25]}] + set_property PACKAGE_PIN T32 [get_ports {${direction1Pins}_data[26]}] + set_property PACKAGE_PIN R32 [get_ports {${direction1Pins}_data[27]}] + set_property PACKAGE_PIN V39 [get_ports {${direction1Pins}_data[28]}] + set_property PACKAGE_PIN V40 [get_ports {${direction1Pins}_data[29]}] + set_property PACKAGE_PIN P37 [get_ports {${direction1Pins}_data[30]}] + set_property PACKAGE_PIN P38 [get_ports {${direction1Pins}_data[31]}]""" + s""" + + set_property PACKAGE_PIN T36 [get_ports ${direction1Pins}_send] + set_property PACKAGE_PIN R37 [get_ports ${direction1Pins}_rst] + + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[31]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[30]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[29]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[28]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[27]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[26]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[25]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[24]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[23]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[22]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[21]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[20]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[19]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[18]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[17]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[16]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[15]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[14]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[13]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[12]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[11]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[10]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[9]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[8]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[7]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[6]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[5]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[4]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[3]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[2]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[1]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction0Pins}_data[0]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[31]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[30]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[29]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[28]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[27]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[26]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[25]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[24]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[23]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[22]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[21]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[20]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[19]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[18]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[17]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[16]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[15]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[14]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[13]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[12]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[11]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[10]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[9]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[8]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[7]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[6]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[5]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[4]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[3]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[2]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[1]}] + set_property IOSTANDARD LVCMOS18 [get_ports {${direction1Pins}_data[0]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[31]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[30]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[29]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[28]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[27]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[26]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[25]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[24]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[23]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[22]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[21]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[20]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[19]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[18]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[17]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[16]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[15]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[14]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[13]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[12]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[11]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[10]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[9]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[8]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[7]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[6]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[5]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[4]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[3]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[2]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[1]}] + set_property SLEW FAST [get_ports {${direction1Pins}_data[0]}]""" + s""" + + + set_property IOSTANDARD LVCMOS18 [get_ports ${direction0Pins}_clk] + set_property IOSTANDARD LVCMOS18 [get_ports ${direction0Pins}_rst] + set_property IOSTANDARD LVCMOS18 [get_ports ${direction0Pins}_send] + set_property IOSTANDARD LVCMOS18 [get_ports ${direction1Pins}_clk] + set_property IOSTANDARD LVCMOS18 [get_ports ${direction1Pins}_rst] + set_property IOSTANDARD LVCMOS18 [get_ports ${direction1Pins}_send] + set_property SLEW FAST [get_ports ${direction1Pins}_clk] + set_property SLEW FAST [get_ports ${direction1Pins}_rst] + set_property SLEW FAST [get_ports ${direction1Pins}_send] + + + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[31]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[30]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[29]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[28]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[27]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[26]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[25]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[24]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[23]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[22]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[21]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[20]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[19]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[18]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[17]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[16]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[15]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[14]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[13]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[12]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[11]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[10]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[9]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[8]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[7]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[6]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[5]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[4]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[3]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[2]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[1]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_data[0]] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_send] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_clk] + set_property OFFCHIP_TERM NONE [get_ports ${direction1Pins}_rst] + + # Aloe reset sent to FPGA + set_property IOSTANDARD LVCMOS18 [get_ports ereset_n] + set_property PACKAGE_PIN AF40 [get_ports ereset_n] + + #Put first level RX/TX flops in IOB + set_property IOB TRUE [get_cells -of_objects [all_fanout -flat -endpoints_only [get_ports "chiplink_b2c_data*"]]] + set_property IOB TRUE [get_cells -of_objects [all_fanout -flat -endpoints_only [get_ports "chiplink_b2c_send"]]] + set_property IOB TRUE [get_cells -of_objects [all_fanin -flat -startpoints_only [get_ports "chiplink_c2b_data*"]]] + set_property IOB TRUE [get_cells -of_objects [all_fanin -flat -startpoints_only [get_ports "chiplink_c2b_send"]]] +""" + ) + } + + def connectChipLink(dut: { val chiplink: Seq[WideDataLayerPort] } , iofpga: Boolean = false): Unit = { + constrainChipLink(iofpga) + + chiplink <> dut.chiplink(0) + //dut.chiplink_xilinx_7series_phy.get.idelayctrl_refclk := sys_clock + } +} + + +abstract class VC707Shell(implicit val p: Parameters) extends RawModule { + + //----------------------------------------------------------------------- + // Interface + //----------------------------------------------------------------------- + + // 200Mhz differential sysclk + val sys_diff_clock_clk_n = IO(Input(Clock())) + val sys_diff_clock_clk_p = IO(Input(Clock())) + + // active high reset + val reset = IO(Input(Bool())) + + // LED + val led = IO(Vec(8, Output(Bool()))) + + // UART + val uart_tx = IO(Output(Bool())) + val uart_rx = IO(Input(Bool())) + val uart_rtsn = IO(Output(Bool())) + val uart_ctsn = IO(Input(Bool())) + + // SDIO + val sdio_clk = IO(Output(Bool())) + val sdio_cmd = IO(Analog(1.W)) + val sdio_dat = IO(Analog(4.W)) + + //Buttons + val btn_0 = IO(Analog(1.W)) + val btn_1 = IO(Analog(1.W)) + val btn_2 = IO(Analog(1.W)) + val btn_3 = IO(Analog(1.W)) + + //Sliding switches + val sw_0 = IO(Analog(1.W)) + val sw_1 = IO(Analog(1.W)) + val sw_2 = IO(Analog(1.W)) + val sw_3 = IO(Analog(1.W)) + val sw_4 = IO(Analog(1.W)) + val sw_5 = IO(Analog(1.W)) + val sw_6 = IO(Analog(1.W)) + val sw_7 = IO(Analog(1.W)) + + + //----------------------------------------------------------------------- + // Wire declrations + //----------------------------------------------------------------------- + + val sys_clock = Wire(Clock()) + val sys_reset = Wire(Bool()) + + val dut_clock = Wire(Clock()) + val dut_reset = Wire(Bool()) + val dut_resetn = Wire(Bool()) + + val dut_ndreset = Wire(Bool()) + + val sd_spi_sck = Wire(Bool()) + val sd_spi_cs = Wire(Bool()) + val sd_spi_dq_i = Wire(Vec(4, Bool())) + val sd_spi_dq_o = Wire(Vec(4, Bool())) + + val do_reset = Wire(Bool()) + + val mig_mmcm_locked = Wire(Bool()) + val mig_sys_reset = Wire(Bool()) + + val mig_clock = Wire(Clock()) + val mig_reset = Wire(Bool()) + val mig_resetn = Wire(Bool()) + + val pcie_dat_reset = Wire(Bool()) + val pcie_dat_resetn = Wire(Bool()) + val pcie_cfg_reset = Wire(Bool()) + val pcie_cfg_resetn = Wire(Bool()) + val pcie_dat_clock = Wire(Clock()) + val pcie_cfg_clock = Wire(Clock()) + val mmcm_lock_pcie = Wire(Bool()) + + //----------------------------------------------------------------------- + // Differential clock + //----------------------------------------------------------------------- + + val sys_clk_ibufds = Module(new IBUFDS) + sys_clk_ibufds.io.I := sys_diff_clock_clk_p + sys_clk_ibufds.io.IB := sys_diff_clock_clk_n + + //----------------------------------------------------------------------- + // System clock and reset + //----------------------------------------------------------------------- + + // Clock that drives the clock generator and the MIG + sys_clock := sys_clk_ibufds.io.O + + // Allow the debug module to reset everything. Resets the MIG + sys_reset := reset | dut_ndreset + + //----------------------------------------------------------------------- + // Clock Generator + //----------------------------------------------------------------------- + + //25MHz and multiples + val vc707_sys_clock_mmcm0 = Module(new Series7MMCM(PLLParameters( + "vc707_sys_clock_mmcm2", + PLLInClockParameters(200, 50), + Seq( + PLLOutClockParameters(12.5), + PLLOutClockParameters(25), + PLLOutClockParameters(37.5), + PLLOutClockParameters(50), + PLLOutClockParameters(100), + PLLOutClockParameters(150.00), + PLLOutClockParameters(100, 180))))) + + vc707_sys_clock_mmcm0.io.clk_in1 := sys_clock + vc707_sys_clock_mmcm0.io.reset := reset + val vc707_sys_clock_mmcm0_locked = vc707_sys_clock_mmcm0.io.locked + val Seq(clk12_5, clk25, clk37_5, clk50, clk100, clk150, clk100_180) = vc707_sys_clock_mmcm0.getClocks + + //65MHz and multiples + //val vc707_sys_clock_mmcm1 = Module(new vc707_sys_clock_mmcm1) + val vc707_sys_clock_mmcm1 = Module(new Series7MMCM(PLLParameters( + "vc707_sys_clock_mmcm1", + PLLInClockParameters(200, 50), + Seq( + PLLOutClockParameters(32.5), + PLLOutClockParameters(65, 180))))) + + vc707_sys_clock_mmcm1.io.clk_in1 := sys_clock + vc707_sys_clock_mmcm1.io.reset := reset + val clk32_5 = vc707_sys_clock_mmcm1.io.clk_out1 + val clk65 = vc707_sys_clock_mmcm1.io.clk_out2 + val vc707_sys_clock_mmcm1_locked = vc707_sys_clock_mmcm1.io.locked + + // DUT clock + dut_clock := clk37_5 + + //----------------------------------------------------------------------- + // System reset + //----------------------------------------------------------------------- + + do_reset := !mig_mmcm_locked || !mmcm_lock_pcie || mig_sys_reset || !vc707_sys_clock_mmcm0_locked || + !vc707_sys_clock_mmcm1_locked + mig_resetn := !mig_reset + dut_resetn := !dut_reset + pcie_dat_resetn := !pcie_dat_reset + pcie_cfg_resetn := !pcie_cfg_reset + + + val safe_reset = Module(new vc707reset) + + safe_reset.io.areset := do_reset + safe_reset.io.clock1 := mig_clock + mig_reset := safe_reset.io.reset1 + safe_reset.io.clock2 := pcie_dat_clock + pcie_dat_reset := safe_reset.io.reset2 + safe_reset.io.clock3 := pcie_cfg_clock + pcie_cfg_reset := safe_reset.io.reset3 + safe_reset.io.clock4 := dut_clock + dut_reset := safe_reset.io.reset4 + + //overrided in connectMIG and connect PCIe + //provide defaults to allow above reset sequencing logic to work without both + mig_clock := dut_clock + pcie_dat_clock := dut_clock + pcie_cfg_clock := dut_clock + mig_mmcm_locked := UInt("b1") + mmcm_lock_pcie := UInt("b1") + + + + //----------------------------------------------------------------------- + // UART + //----------------------------------------------------------------------- + + uart_rtsn := false.B + + def connectUART(dut: HasPeripheryUARTModuleImp): Unit = dut.uart.headOption.foreach(connectUART) + + def connectUART(uart: UARTPortIO): Unit = { + uart.rxd := SyncResetSynchronizerShiftReg(uart_rx, 2, init = Bool(true), name=Some("uart_rxd_sync")) + uart_tx := uart.txd + } + + //----------------------------------------------------------------------- + // SPI + //----------------------------------------------------------------------- + + def connectSPI(dut: HasPeripherySPIModuleImp): Unit = dut.spi.headOption.foreach(connectSPI) + + def connectSPI(spi: SPIPortIO): Unit = { + // SPI + sd_spi_sck := spi.sck + sd_spi_cs := spi.cs(0) + + spi.dq.zipWithIndex.foreach { + case(pin, idx) => + sd_spi_dq_o(idx) := pin.o + pin.i := sd_spi_dq_i(idx) + } + + //------------------------------------------------------------------- + // SDIO <> SPI Bridge + //------------------------------------------------------------------- + + val ip_sdio_spi = Module(new sdio_spi_bridge()) + + ip_sdio_spi.io.clk := dut_clock + ip_sdio_spi.io.reset := dut_reset + + // SDIO + attach(sdio_dat, ip_sdio_spi.io.sd_dat) + attach(sdio_cmd, ip_sdio_spi.io.sd_cmd) + sdio_clk := ip_sdio_spi.io.spi_sck + + // SPI + ip_sdio_spi.io.spi_sck := sd_spi_sck + ip_sdio_spi.io.spi_cs := sd_spi_cs + sd_spi_dq_i := ip_sdio_spi.io.spi_dq_i.asBools + ip_sdio_spi.io.spi_dq_o := sd_spi_dq_o.asUInt + } + + ElaborationArtefacts.add("old-shell.vivado.tcl", + """set obj [current_fileset -constrset] + |add_files -quiet -norecurse -fileset $obj [file join $boarddir tcl ios.tcl] + |add_files -quiet -norecurse -fileset $obj [file join $boarddir tcl clocks.tcl] + |""".stripMargin) +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/VCU118NewShell.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/VCU118NewShell.scala new file mode 100644 index 0000000..525760e --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/VCU118NewShell.scala @@ -0,0 +1,452 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell.xilinx + +import chisel3._ +import chisel3.experimental.{attach, Analog, IO} +import freechips.rocketchip.config._ +import freechips.rocketchip.diplomacy._ +import freechips.rocketchip.tilelink._ +import freechips.rocketchip.util.SyncResetSynchronizerShiftReg +import sifive.fpgashells.clocks._ +import sifive.fpgashells.shell._ +import sifive.fpgashells.ip.xilinx._ +import sifive.blocks.devices.chiplink._ +import sifive.fpgashells.devices.xilinx.xilinxvcu118mig._ +import sifive.fpgashells.devices.xilinx.xdma._ +import sifive.fpgashells.ip.xilinx.xxv_ethernet._ + +class SysClockVCU118PlacedOverlay(val shell: VCU118ShellBasicOverlays, name: String, val designInput: ClockInputDesignInput, val shellInput: ClockInputShellInput) + extends LVDSClockInputXilinxPlacedOverlay(name, designInput, shellInput) +{ + val node = shell { ClockSourceNode(freqMHz = 250, jitterPS = 50)(ValName(name)) } + + shell { InModuleBody { + shell.xdc.addPackagePin(io.p, "E12") + shell.xdc.addPackagePin(io.n, "D12") + shell.xdc.addIOStandard(io.p, "DIFF_SSTL12") + shell.xdc.addIOStandard(io.n, "DIFF_SSTL12") + } } +} +class SysClockVCU118ShellPlacer(shell: VCU118ShellBasicOverlays, val shellInput: ClockInputShellInput)(implicit val valName: ValName) + extends ClockInputShellPlacer[VCU118ShellBasicOverlays] +{ + def place(designInput: ClockInputDesignInput) = new SysClockVCU118PlacedOverlay(shell, valName.name, designInput, shellInput) +} + +class RefClockVCU118PlacedOverlay(val shell: VCU118ShellBasicOverlays, name: String, val designInput: ClockInputDesignInput, val shellInput: ClockInputShellInput) + extends LVDSClockInputXilinxPlacedOverlay(name, designInput, shellInput) { + val node = shell { ClockSourceNode(freqMHz = 125, jitterPS = 50)(ValName(name)) } + + shell { InModuleBody { + shell.xdc.addPackagePin(io.p, "AY24") + shell.xdc.addPackagePin(io.n, "AY23") + shell.xdc.addIOStandard(io.p, "LVDS") + shell.xdc.addIOStandard(io.n, "LVDS") + } } +} +class RefClockVCU118ShellPlacer(shell: VCU118ShellBasicOverlays, val shellInput: ClockInputShellInput)(implicit val valName: ValName) + extends ClockInputShellPlacer[VCU118ShellBasicOverlays] { + def place(designInput: ClockInputDesignInput) = new RefClockVCU118PlacedOverlay(shell, valName.name, designInput, shellInput) +} + +class SDIOVCU118PlacedOverlay(val shell: VCU118ShellBasicOverlays, name: String, val designInput: SDIODesignInput, val shellInput: SDIOShellInput) + extends SDIOXilinxPlacedOverlay(name, designInput, shellInput) +{ + shell { InModuleBody { + val packagePinsWithPackageIOs = Seq(("AV15", IOPin(io.sdio_clk)), + ("AY15", IOPin(io.sdio_cmd)), + ("AW15", IOPin(io.sdio_dat_0)), + ("AV16", IOPin(io.sdio_dat_1)), + ("AU16", IOPin(io.sdio_dat_2)), + ("AY14", IOPin(io.sdio_dat_3))) + + packagePinsWithPackageIOs foreach { case (pin, io) => { + shell.xdc.addPackagePin(io, pin) + shell.xdc.addIOStandard(io, "LVCMOS18") + } } + packagePinsWithPackageIOs drop 1 foreach { case (pin, io) => { + shell.xdc.addPullup(io) + shell.xdc.addIOB(io) + } } + } } +} +class SDIOVCU118ShellPlacer(shell: VCU118ShellBasicOverlays, val shellInput: SDIOShellInput)(implicit val valName: ValName) + extends SDIOShellPlacer[VCU118ShellBasicOverlays] { + def place(designInput: SDIODesignInput) = new SDIOVCU118PlacedOverlay(shell, valName.name, designInput, shellInput) +} + +class SPIFlashVCU118PlacedOverlay(val shell: VCU118ShellBasicOverlays, name: String, val designInput: SPIFlashDesignInput, val shellInput: SPIFlashShellInput) + extends SPIFlashXilinxPlacedOverlay(name, designInput, shellInput) +{ + + shell { InModuleBody { + val packagePinsWithPackageIOs = Seq(("AF13", IOPin(io.qspi_sck)), + ("AJ11", IOPin(io.qspi_cs)), + ("AP11", IOPin(io.qspi_dq(0))), + ("AN11", IOPin(io.qspi_dq(1))), + ("AM11", IOPin(io.qspi_dq(2))), + ("AL11", IOPin(io.qspi_dq(3)))) + + packagePinsWithPackageIOs foreach { case (pin, io) => { + shell.xdc.addPackagePin(io, pin) + // shell.xdc.addIOStandard(io, "LVCMOS18") + } } + //packagePinsWithPackageIOs drop 1 foreach { case (pin, io) => { + // shell.xdc.addPullup(io) + //} } + } } +} +class SPIFlashVCU118ShellPlacer(shell: VCU118ShellBasicOverlays, val shellInput: SPIFlashShellInput)(implicit val valName: ValName) + extends SPIFlashShellPlacer[VCU118ShellBasicOverlays] { + def place(designInput: SPIFlashDesignInput) = new SPIFlashVCU118PlacedOverlay(shell, valName.name, designInput, shellInput) +} + +class UARTVCU118PlacedOverlay(val shell: VCU118ShellBasicOverlays, name: String, val designInput: UARTDesignInput, val shellInput: UARTShellInput) + extends UARTXilinxPlacedOverlay(name, designInput, shellInput, true) +{ + shell { InModuleBody { + val packagePinsWithPackageIOs = Seq(("AY25", IOPin(io.ctsn.get)), + ("BB22", IOPin(io.rtsn.get)), + ("AW25", IOPin(io.rxd)), + ("BB21", IOPin(io.txd))) + + packagePinsWithPackageIOs foreach { case (pin, io) => { + shell.xdc.addPackagePin(io, pin) + shell.xdc.addIOStandard(io, "LVCMOS18") + shell.xdc.addIOB(io) + } } + } } +} +class UARTVCU118ShellPlacer(shell: VCU118ShellBasicOverlays, val shellInput: UARTShellInput)(implicit val valName: ValName) + extends UARTShellPlacer[VCU118ShellBasicOverlays] { + def place(designInput: UARTDesignInput) = new UARTVCU118PlacedOverlay(shell, valName.name, designInput, shellInput) +} + +class QSFP1VCU118PlacedOverlay(val shell: VCU118ShellBasicOverlays, name: String, val designInput: EthernetDesignInput, val shellInput: EthernetShellInput) + extends EthernetUltraScalePlacedOverlay(name, designInput, shellInput, XXVEthernetParams(name = name, speed = 10, dclkMHz = 125)) +{ + val dclkSource = shell { BundleBridgeSource(() => Clock()) } + val dclkSink = dclkSource.makeSink() + InModuleBody { + dclk := dclkSink.bundle + } + shell { InModuleBody { + dclkSource.bundle := shell.ref_clock.get.get.overlayOutput.node.out(0)._1.clock + shell.xdc.addPackagePin(io.tx_p, "V7") + shell.xdc.addPackagePin(io.tx_n, "V6") + shell.xdc.addPackagePin(io.rx_p, "Y2") + shell.xdc.addPackagePin(io.rx_n, "Y1") + shell.xdc.addPackagePin(io.refclk_p, "W9") + shell.xdc.addPackagePin(io.refclk_n, "W8") + } } +} +class QSFP1VCU118ShellPlacer(shell: VCU118ShellBasicOverlays, val shellInput: EthernetShellInput)(implicit val valName: ValName) + extends EthernetShellPlacer[VCU118ShellBasicOverlays] { + def place(designInput: EthernetDesignInput) = new QSFP1VCU118PlacedOverlay(shell, valName.name, designInput, shellInput) +} + +class QSFP2VCU118PlacedOverlay(val shell: VCU118ShellBasicOverlays, name: String, val designInput: EthernetDesignInput, val shellInput: EthernetShellInput) + extends EthernetUltraScalePlacedOverlay(name, designInput, shellInput, XXVEthernetParams(name = name, speed = 10, dclkMHz = 125)) +{ + val dclkSource = shell { BundleBridgeSource(() => Clock()) } + val dclkSink = dclkSource.makeSink() + InModuleBody { + dclk := dclkSink.bundle + } + shell { InModuleBody { + dclkSource.bundle := shell.ref_clock.get.get.overlayOutput.node.out(0)._1.clock + shell.xdc.addPackagePin(io.tx_p, "L5") + shell.xdc.addPackagePin(io.tx_n, "L4") + shell.xdc.addPackagePin(io.rx_p, "T2") + shell.xdc.addPackagePin(io.rx_n, "T1") + shell.xdc.addPackagePin(io.refclk_p, "R9") + shell.xdc.addPackagePin(io.refclk_n, "R8") + } } +} +class QSFP2VCU118ShellPlacer(shell: VCU118ShellBasicOverlays, val shellInput: EthernetShellInput)(implicit val valName: ValName) + extends EthernetShellPlacer[VCU118ShellBasicOverlays] { + def place(designInput: EthernetDesignInput) = new QSFP2VCU118PlacedOverlay(shell, valName.name, designInput, shellInput) +} + +object LEDVCU118PinConstraints { + val pins = Seq("AT32", "AV34", "AY30", "BB32", "BF32", "AU37", "AV36", "BA37") +} +class LEDVCU118PlacedOverlay(val shell: VCU118ShellBasicOverlays, name: String, val designInput: LEDDesignInput, val shellInput: LEDShellInput) + extends LEDXilinxPlacedOverlay(name, designInput, shellInput, packagePin = Some(LEDVCU118PinConstraints.pins(shellInput.number)), ioStandard = "LVCMOS12") +class LEDVCU118ShellPlacer(shell: VCU118ShellBasicOverlays, val shellInput: LEDShellInput)(implicit val valName: ValName) + extends LEDShellPlacer[VCU118ShellBasicOverlays] { + def place(designInput: LEDDesignInput) = new LEDVCU118PlacedOverlay(shell, valName.name, designInput, shellInput) +} + +object SwitchVCU118PinConstraints { + val pins = Seq("B17", "G16", "J16", "D21") +} +class SwitchVCU118PlacedOverlay(val shell: VCU118ShellBasicOverlays, name: String, val designInput: SwitchDesignInput, val shellInput: SwitchShellInput) + extends SwitchXilinxPlacedOverlay(name, designInput, shellInput, packagePin = Some(SwitchVCU118PinConstraints.pins(shellInput.number)), ioStandard = "LVCMOS12") +class SwitchVCU118ShellPlacer(shell: VCU118ShellBasicOverlays, val shellInput: SwitchShellInput)(implicit val valName: ValName) + extends SwitchShellPlacer[VCU118ShellBasicOverlays] { + def place(designInput: SwitchDesignInput) = new SwitchVCU118PlacedOverlay(shell, valName.name, designInput, shellInput) +} + +class ChipLinkVCU118PlacedOverlay(val shell: VCU118ShellBasicOverlays, name: String, val designInput: ChipLinkDesignInput, val shellInput: ChipLinkShellInput) + extends ChipLinkXilinxPlacedOverlay(name, designInput, shellInput, rxPhase= -120, txPhase= -90, rxMargin=0.6, txMargin=0.5) +{ + val ereset_n = shell { InModuleBody { + val ereset_n = IO(Analog(1.W)) + ereset_n.suggestName("ereset_n") + val pin = IOPin(ereset_n, 0) + shell.xdc.addPackagePin(pin, "BC8") + shell.xdc.addIOStandard(pin, "LVCMOS18") + shell.xdc.addTermination(pin, "NONE") + shell.xdc.addPullup(pin) + + val iobuf = Module(new IOBUF) + iobuf.suggestName("chiplink_ereset_iobuf") + attach(ereset_n, iobuf.io.IO) + iobuf.io.T := true.B // !oe + iobuf.io.I := false.B + + iobuf.io.O + } } + + shell { InModuleBody { + val dir1 = Seq("BC9", "AV8", "AV9", /* clk, rst, send */ + "AY9", "BA9", "BF10", "BF9", "BC11", "BD11", "BD12", "BE12", + "BF12", "BF11", "BE14", "BF14", "BD13", "BE13", "BC15", "BD15", + "BE15", "BF15", "BA14", "BB14", "BB13", "BB12", "BA16", "BA15", + "BC14", "BC13", "AY8", "AY7", "AW8", "AW7", "BB16", "BC16") + val dir2 = Seq("AV14", "AK13", "AK14", /* clk, rst, send */ + "AR14", "AT14", "AP12", "AR12", "AW12", "AY12", "AW11", "AY10", + "AU11", "AV11", "AW13", "AY13", "AN16", "AP16", "AP13", "AR13", + "AT12", "AU12", "AK15", "AL15", "AL14", "AM14", "AV10", "AW10", + "AN15", "AP15", "AK12", "AL12", "AM13", "AM12", "AJ13", "AJ12") + (IOPin.of(io.b2c) zip dir1) foreach { case (io, pin) => shell.xdc.addPackagePin(io, pin) } + (IOPin.of(io.c2b) zip dir2) foreach { case (io, pin) => shell.xdc.addPackagePin(io, pin) } + } } +} +class ChipLinkVCU118ShellPlacer(shell: VCU118ShellBasicOverlays, val shellInput: ChipLinkShellInput)(implicit val valName: ValName) + extends ChipLinkShellPlacer[VCU118ShellBasicOverlays] { + def place(designInput: ChipLinkDesignInput) = new ChipLinkVCU118PlacedOverlay(shell, valName.name, designInput, shellInput) +} + +// TODO: JTAG is untested +class JTAGDebugVCU118PlacedOverlay(val shell: VCU118ShellBasicOverlays, name: String, val designInput: JTAGDebugDesignInput, val shellInput: JTAGDebugShellInput) + extends JTAGDebugXilinxPlacedOverlay(name, designInput, shellInput) +{ + shell { InModuleBody { + shell.sdc.addClock("JTCK", IOPin(io.jtag_TCK), 10) + shell.sdc.addGroup(clocks = Seq("JTCK")) + shell.xdc.clockDedicatedRouteFalse(IOPin(io.jtag_TCK)) + val packagePinsWithPackageIOs = Seq(("P29", IOPin(io.jtag_TCK)), + ("L31", IOPin(io.jtag_TMS)), + ("M31", IOPin(io.jtag_TDI)), + ("R29", IOPin(io.jtag_TDO))) + + packagePinsWithPackageIOs foreach { case (pin, io) => { + shell.xdc.addPackagePin(io, pin) + shell.xdc.addIOStandard(io, "LVCMOS18") + shell.xdc.addPullup(io) + } } + } } +} +class JTAGDebugVCU118ShellPlacer(shell: VCU118ShellBasicOverlays, val shellInput: JTAGDebugShellInput)(implicit val valName: ValName) + extends JTAGDebugShellPlacer[VCU118ShellBasicOverlays] { + def place(designInput: JTAGDebugDesignInput) = new JTAGDebugVCU118PlacedOverlay(shell, valName.name, designInput, shellInput) +} + +case object VCU118DDRSize extends Field[BigInt](0x40000000L * 2) // 2GB +class DDRVCU118PlacedOverlay(val shell: VCU118ShellBasicOverlays, name: String, val designInput: DDRDesignInput, val shellInput: DDRShellInput) + extends DDRPlacedOverlay[XilinxVCU118MIGPads](name, designInput, shellInput) +{ + val size = p(VCU118DDRSize) + + val migParams = XilinxVCU118MIGParams(address = AddressSet.misaligned(di.baseAddress, size)) + val mig = LazyModule(new XilinxVCU118MIG(migParams)) + val ioNode = BundleBridgeSource(() => mig.module.io.cloneType) + val topIONode = shell { ioNode.makeSink() } + val ddrUI = shell { ClockSourceNode(freqMHz = 200) } + val areset = shell { ClockSinkNode(Seq(ClockSinkParameters())) } + areset := designInput.wrangler := ddrUI + + def overlayOutput = DDROverlayOutput(ddr = mig.node) + def ioFactory = new XilinxVCU118MIGPads(size) + + InModuleBody { ioNode.bundle <> mig.module.io } + + shell { InModuleBody { + require (shell.sys_clock.get.isDefined, "Use of DDRVCU118Overlay depends on SysClockVCU118Overlay") + val (sys, _) = shell.sys_clock.get.get.overlayOutput.node.out(0) + val (ui, _) = ddrUI.out(0) + val (ar, _) = areset.in(0) + val port = topIONode.bundle.port + io <> port + ui.clock := port.c0_ddr4_ui_clk + ui.reset := /*!port.mmcm_locked ||*/ port.c0_ddr4_ui_clk_sync_rst + port.c0_sys_clk_i := sys.clock.asUInt + port.sys_rst := sys.reset // pllReset + port.c0_ddr4_aresetn := !ar.reset + + val allddrpins = Seq( "D14", "B15", "B16", "C14", "C15", "A13", "A14", + "A15", "A16", "B12", "C12", "B13", "C13", "D15", "H14", "H15", "F15", + "H13", "G15", "G13", "N20", "E13", "E14", "F14", "A10", "F13", "C8", + "F11", "E11", "F10", "F9", "H12", "G12", "E9", "D9", "R19", "P19", + "M18", "M17", "N19", "N18", "N17", "M16", "L16", "K16", "L18", "K18", + "J17", "H17", "H19", "H18", "F19", "F18", "E19", "E18", "G20", "F20", + "E17", "D16", "D17", "C17", "C19", "C18", "D20", "D19", "C20", "B20", + "N23", "M23", "R21", "P21", "R22", "P22", "T23", "R23", "K24", "J24", + "M21", "L21", "K21", "J21", "K22", "J22", "H23", "H22", "E23", "E22", + "F21", "E21", "F24", "F23", "D10", "P16", "J19", "E16", "A18", "M22", + "L20", "G23", "D11", "P17", "K19", "F16", "A19", "N22", "M20", "H24", + "G11", "R18", "K17", "G18", "B18", "P20", "L23", "G22") + + (IOPin.of(io) zip allddrpins) foreach { case (io, pin) => shell.xdc.addPackagePin(io, pin) } + } } + + shell.sdc.addGroup(pins = Seq(mig.island.module.blackbox.io.c0_ddr4_ui_clk)) +} +class DDRVCU118ShellPlacer(shell: VCU118ShellBasicOverlays, val shellInput: DDRShellInput)(implicit val valName: ValName) + extends DDRShellPlacer[VCU118ShellBasicOverlays] { + def place(designInput: DDRDesignInput) = new DDRVCU118PlacedOverlay(shell, valName.name, designInput, shellInput) +} + +class PCIeVCU118FMCPlacedOverlay(val shell: VCU118ShellBasicOverlays, name: String, val designInput: PCIeDesignInput, val shellInput: PCIeShellInput) + extends PCIeUltraScalePlacedOverlay(name, designInput, shellInput, XDMAParams( + name = "fmc_xdma", + location = "X0Y3", + bars = designInput.bars, + control = designInput.ecam, + lanes = 4)) +{ + shell { InModuleBody { + // Work-around incorrectly pre-assigned pins + IOPin.of(io).foreach { shell.xdc.addPackagePin(_, "") } + + // We need some way to connect both of these to reach x8 + val ref126 = Seq("V38", "V39") /* [pn] GBT0 Bank 126 */ + val ref121 = Seq("AK38", "AK39") /* [pn] GBT0 Bank 121 */ + val ref = ref126 + + // Bank 126 (DP5, DP6, DP4, DP7), Bank 121 (DP3, DP2, DP1, DP0) + val rxp = Seq("U45", "R45", "W45", "N45", "AJ45", "AL45", "AN45", "AR45") /* [0-7] */ + val rxn = Seq("U46", "R46", "W46", "N46", "AJ46", "AL46", "AN46", "AR46") /* [0-7] */ + val txp = Seq("P42", "M42", "T42", "K42", "AL40", "AM42", "AP42", "AT42") /* [0-7] */ + val txn = Seq("P43", "M43", "T43", "K43", "AL41", "AM43", "AP43", "AT43") /* [0-7] */ + + def bind(io: Seq[IOPin], pad: Seq[String]) { + (io zip pad) foreach { case (io, pad) => shell.xdc.addPackagePin(io, pad) } + } + + bind(IOPin.of(io.refclk), ref) + // We do these individually so that zip falls off the end of the lanes: + bind(IOPin.of(io.lanes.pci_exp_txp), txp) + bind(IOPin.of(io.lanes.pci_exp_txn), txn) + bind(IOPin.of(io.lanes.pci_exp_rxp), rxp) + bind(IOPin.of(io.lanes.pci_exp_rxn), rxn) + } } +} +class PCIeVCU118FMCShellPlacer(shell: VCU118ShellBasicOverlays, val shellInput: PCIeShellInput)(implicit val valName: ValName) + extends PCIeShellPlacer[VCU118ShellBasicOverlays] { + def place(designInput: PCIeDesignInput) = new PCIeVCU118FMCPlacedOverlay(shell, valName.name, designInput, shellInput) +} + +class PCIeVCU118EdgePlacedOverlay(val shell: VCU118ShellBasicOverlays, name: String, val designInput: PCIeDesignInput, val shellInput: PCIeShellInput) + extends PCIeUltraScalePlacedOverlay(name, designInput, shellInput, XDMAParams( + name = "edge_xdma", + location = "X1Y2", + bars = designInput.bars, + control = designInput.ecam, + lanes = 8)) +{ + shell { InModuleBody { + // Work-around incorrectly pre-assigned pins + IOPin.of(io).foreach { shell.xdc.addPackagePin(_, "") } + + // PCIe Edge connector U2 + // Lanes 00-03 Bank 227 + // Lanes 04-07 Bank 226 + // Lanes 08-11 Bank 225 + // Lanes 12-15 Bank 224 + + // FMC+ J22 + val ref227 = Seq("AC9", "AC8") /* [pn] Bank 227 PCIE_CLK2_*/ + val ref = ref227 + + // PCIe Edge connector U2 : Bank 227, 226 + val rxp = Seq("AA4", "AB2", "AC4", "AD2", "AE4", "AF2", "AG4", "AH2") // [0-7] + val rxn = Seq("AA3", "AB1", "AC3", "AD1", "AE3", "AF1", "AG3", "AH1") // [0-7] + val txp = Seq("Y7", "AB7", "AD7", "AF7", "AH7", "AK7", "AM7", "AN5") // [0-7] + val txn = Seq("Y6", "AB6", "AD6", "AF6", "AH6", "AK6", "AM6", "AN4") // [0-7] + + def bind(io: Seq[IOPin], pad: Seq[String]) { + (io zip pad) foreach { case (io, pad) => shell.xdc.addPackagePin(io, pad) } + } + + bind(IOPin.of(io.refclk), ref) + // We do these individually so that zip falls off the end of the lanes: + bind(IOPin.of(io.lanes.pci_exp_txp), txp) + bind(IOPin.of(io.lanes.pci_exp_txn), txn) + bind(IOPin.of(io.lanes.pci_exp_rxp), rxp) + bind(IOPin.of(io.lanes.pci_exp_rxn), rxn) + } } +} +class PCIeVCU118EdgeShellPlacer(shell: VCU118ShellBasicOverlays, val shellInput: PCIeShellInput)(implicit val valName: ValName) + extends PCIeShellPlacer[VCU118ShellBasicOverlays] { + def place(designInput: PCIeDesignInput) = new PCIeVCU118EdgePlacedOverlay(shell, valName.name, designInput, shellInput) +} + +abstract class VCU118ShellBasicOverlays()(implicit p: Parameters) extends UltraScaleShell{ + val sys_clock = Overlay(ClockInputOverlayKey, new SysClockVCU118ShellPlacer(this, ClockInputShellInput())) + val ref_clock = Overlay(ClockInputOverlayKey, new RefClockVCU118ShellPlacer(this, ClockInputShellInput())) + val led = Seq.tabulate(8)(i => Overlay(LEDOverlayKey, new LEDVCU118ShellPlacer(this, LEDShellInput(color = "red", number = i))(valName = ValName(s"led_$i")))) + val switch = Seq.tabulate(4)(i => Overlay(SwitchOverlayKey, new SwitchVCU118ShellPlacer(this, SwitchShellInput(number = i))(valName = ValName(s"switch_$i")))) + val ddr = Overlay(DDROverlayKey, new DDRVCU118ShellPlacer(this, DDRShellInput())) + val uart = Overlay(UARTOverlayKey, new UARTVCU118ShellPlacer(this, UARTShellInput())) + val sdio = Overlay(SDIOOverlayKey, new SDIOVCU118ShellPlacer(this, SDIOShellInput())) + val jtag = Overlay(JTAGDebugOverlayKey, new JTAGDebugVCU118ShellPlacer(this, JTAGDebugShellInput())) + val qsfp1 = Overlay(EthernetOverlayKey, new QSFP1VCU118ShellPlacer(this, EthernetShellInput())) + val qsfp2 = Overlay(EthernetOverlayKey, new QSFP2VCU118ShellPlacer(this, EthernetShellInput())) + val chiplink = Overlay(ChipLinkOverlayKey, new ChipLinkVCU118ShellPlacer(this, ChipLinkShellInput())) + val spi_flash = Overlay(SPIFlashOverlayKey, new SPIFlashVCU118ShellPlacer(this, SPIFlashShellInput())) +} + +class VCU118Shell()(implicit p: Parameters) extends VCU118ShellBasicOverlays +{ + // PLL reset causes + val pllReset = InModuleBody { Wire(Bool()) } + + // Order matters; ddr depends on sys_clock + val fmc = Overlay(PCIeOverlayKey, new PCIeVCU118FMCShellPlacer(this, PCIeShellInput())) + val edge = Overlay(PCIeOverlayKey, new PCIeVCU118EdgeShellPlacer(this, PCIeShellInput())) + + val topDesign = LazyModule(p(DesignKey)(designParameters)) + + // Place the sys_clock at the Shell if the user didn't ask for it + designParameters(ClockInputOverlayKey).foreach { unused => + val source = unused.place(ClockInputDesignInput()).overlayOutput.node + val sink = ClockSinkNode(Seq(ClockSinkParameters())) + sink := source + } + + override lazy val module = new LazyRawModuleImp(this) { + val reset = IO(Input(Bool())) + xdc.addPackagePin(reset, "L19") + xdc.addIOStandard(reset, "LVCMOS12") + + val reset_ibuf = Module(new IBUF) + reset_ibuf.io.I := reset + + val sysclk: Clock = sys_clock.get() match { + case Some(x: SysClockVCU118PlacedOverlay) => x.clock + } + + val powerOnReset: Bool = PowerOnResetFPGAOnly(sysclk) + sdc.addAsyncPath(Seq(powerOnReset)) + + val ereset: Bool = chiplink.get() match { + case Some(x: ChipLinkVCU118PlacedOverlay) => !x.ereset_n + case _ => false.B + } + + pllReset := (reset_ibuf.io.O || powerOnReset || ereset) + } +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/VCU118Shell.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/VCU118Shell.scala new file mode 100644 index 0000000..c18e95b --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/VCU118Shell.scala @@ -0,0 +1,276 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell.xilinx.vcu118shell + +import Chisel._ +import chisel3.{Input, Output, RawModule, withClockAndReset} +import chisel3.experimental.{Analog, attach} + +import freechips.rocketchip.config._ +import freechips.rocketchip.devices.debug._ +import freechips.rocketchip.util.{SyncResetSynchronizerShiftReg} + +import sifive.blocks.devices.gpio._ +import sifive.blocks.devices.spi._ +import sifive.blocks.devices.uart._ + +import sifive.fpgashells.devices.xilinx.xilinxvcu118mig._ +import sifive.fpgashells.ip.xilinx.{IBUFDS, PowerOnResetFPGAOnly, sdio_spi_bridge, vcu118_sys_clock_mmcm0, + vcu118_sys_clock_mmcm1, vcu118reset} + +//------------------------------------------------------------------------- +// VCU118Shell +//------------------------------------------------------------------------- + +trait HasDDR3 { this: VCU118Shell => + + require(!p.lift(MemoryXilinxDDRKey).isEmpty) + val ddr = IO(new XilinxVCU118MIGPads(p(MemoryXilinxDDRKey))) + + def connectMIG(dut: HasMemoryXilinxVCU118MIGModuleImp): Unit = { + // Clock & Reset + dut.xilinxvcu118mig.c0_sys_clk_i := sys_clock.asUInt + mig_clock := dut.xilinxvcu118mig.c0_ddr4_ui_clk + mig_sys_reset := dut.xilinxvcu118mig.c0_ddr4_ui_clk_sync_rst + dut.xilinxvcu118mig.c0_ddr4_aresetn := mig_resetn + dut.xilinxvcu118mig.sys_rst := sys_reset + + ddr <> dut.xilinxvcu118mig + } +} + +abstract class VCU118Shell(implicit val p: Parameters) extends RawModule { + + //----------------------------------------------------------------------- + // Interface + //----------------------------------------------------------------------- + + // 250Mhz differential sysclk + val sys_diff_clock_clk_n = IO(Input(Clock())) + val sys_diff_clock_clk_p = IO(Input(Clock())) + + // active high reset + val reset = IO(Input(Bool())) + + // LED + //val led = IO(Vec(8, Output(Bool()))) + + // UART + val uart_tx = IO(Output(Bool())) + val uart_rx = IO(Input(Bool())) + val uart_rtsn = IO(Output(Bool())) + val uart_ctsn = IO(Input(Bool())) + + // SDIO + val sdio_clk = IO(Output(Bool())) + val sdio_cmd = IO(Analog(1.W)) + val sdio_dat = IO(Analog(4.W)) + + // JTAG + val jtag_TCK = IO(Input(Clock())) + val jtag_TMS = IO(Input(Bool())) + val jtag_TDI = IO(Input(Bool())) + val jtag_TDO = IO(Output(Bool())) + + //Buttons + //val btn_0 = IO(Analog(1.W)) + //val btn_1 = IO(Analog(1.W)) + //val btn_2 = IO(Analog(1.W)) + //val btn_3 = IO(Analog(1.W)) + + //Sliding switches + //val sw_0 = IO(Analog(1.W)) + //val sw_1 = IO(Analog(1.W)) + //val sw_2 = IO(Analog(1.W)) + //val sw_3 = IO(Analog(1.W)) + //val sw_4 = IO(Analog(1.W)) + //val sw_5 = IO(Analog(1.W)) + //val sw_6 = IO(Analog(1.W)) + //val sw_7 = IO(Analog(1.W)) + + + //----------------------------------------------------------------------- + // Wire declrations + //----------------------------------------------------------------------- + + val sys_clock = Wire(Clock()) + val sys_reset = Wire(Bool()) + + val dut_clock = Wire(Clock()) + val dut_reset = Wire(Bool()) + val dut_resetn = Wire(Bool()) + + val dut_ndreset = Wire(Bool()) + + val sd_spi_sck = Wire(Bool()) + val sd_spi_cs = Wire(Bool()) + val sd_spi_dq_i = Wire(Vec(4, Bool())) + val sd_spi_dq_o = Wire(Vec(4, Bool())) + + val do_reset = Wire(Bool()) + + val mig_mmcm_locked = Wire(Bool()) + val mig_sys_reset = Wire(Bool()) + + val mig_clock = Wire(Clock()) + val mig_reset = Wire(Bool()) + val mig_resetn = Wire(Bool()) + + val pcie_dat_reset = Wire(Bool()) + val pcie_dat_resetn = Wire(Bool()) + val pcie_cfg_reset = Wire(Bool()) + val pcie_cfg_resetn = Wire(Bool()) + val pcie_dat_clock = Wire(Clock()) + val pcie_cfg_clock = Wire(Clock()) + val mmcm_lock_pcie = Wire(Bool()) + + //----------------------------------------------------------------------- + // Differential clock + //----------------------------------------------------------------------- + + val sys_clk_ibufds = Module(new IBUFDS) + sys_clk_ibufds.io.I := sys_diff_clock_clk_p + sys_clk_ibufds.io.IB := sys_diff_clock_clk_n + + //----------------------------------------------------------------------- + // System clock and reset + //----------------------------------------------------------------------- + + // Clock that drives the clock generator and the MIG + sys_clock := sys_clk_ibufds.io.O + + // Allow the debug module to reset everything. Resets the MIG + sys_reset := reset | dut_ndreset + + //----------------------------------------------------------------------- + // Clock Generator + //----------------------------------------------------------------------- + + //25MHz and multiples + val vcu118_sys_clock_mmcm0 = Module(new vcu118_sys_clock_mmcm0) + vcu118_sys_clock_mmcm0.io.clk_in1 := sys_clock.asUInt + vcu118_sys_clock_mmcm0.io.reset := reset + val clk12_5 = vcu118_sys_clock_mmcm0.io.clk_out1 + val clk25 = vcu118_sys_clock_mmcm0.io.clk_out2 + val clk37_5 = vcu118_sys_clock_mmcm0.io.clk_out3 + val clk50 = vcu118_sys_clock_mmcm0.io.clk_out4 + val clk100 = vcu118_sys_clock_mmcm0.io.clk_out5 + val clk150 = vcu118_sys_clock_mmcm0.io.clk_out6 + val clk75 = vcu118_sys_clock_mmcm0.io.clk_out7 + val vcu118_sys_clock_mmcm0_locked = vcu118_sys_clock_mmcm0.io.locked + + //65MHz and multiples + val vcu118_sys_clock_mmcm1 = Module(new vcu118_sys_clock_mmcm1) + vcu118_sys_clock_mmcm1.io.clk_in1 := sys_clock.asUInt + vcu118_sys_clock_mmcm1.io.reset := reset + val clk32_5 = vcu118_sys_clock_mmcm1.io.clk_out1 + val clk65 = vcu118_sys_clock_mmcm1.io.clk_out2 + val vcu118_sys_clock_mmcm1_locked = vcu118_sys_clock_mmcm1.io.locked + + // DUT clock + dut_clock := clk37_5 + + //----------------------------------------------------------------------- + // System reset + //----------------------------------------------------------------------- + + do_reset := !mig_mmcm_locked || !mmcm_lock_pcie || mig_sys_reset || !vcu118_sys_clock_mmcm0_locked || + !vcu118_sys_clock_mmcm1_locked + mig_resetn := !mig_reset + dut_resetn := !dut_reset + pcie_dat_resetn := !pcie_dat_reset + pcie_cfg_resetn := !pcie_cfg_reset + + + val safe_reset = Module(new vcu118reset) + + safe_reset.io.areset := do_reset + safe_reset.io.clock1 := mig_clock + mig_reset := safe_reset.io.reset1 + safe_reset.io.clock2 := pcie_dat_clock + pcie_dat_reset := safe_reset.io.reset2 + safe_reset.io.clock3 := pcie_cfg_clock + pcie_cfg_reset := safe_reset.io.reset3 + safe_reset.io.clock4 := dut_clock + dut_reset := safe_reset.io.reset4 + + //overrided in connectMIG and connect PCIe + //provide defaults to allow above reset sequencing logic to work without both + mig_clock := dut_clock + pcie_dat_clock := dut_clock + pcie_cfg_clock := dut_clock + mig_mmcm_locked := UInt("b1") + mmcm_lock_pcie := UInt("b1") + + //--------------------------------------------------------------------- + // Debug JTAG + //--------------------------------------------------------------------- + + def connectDebugJTAG(dut: HasPeripheryDebugModuleImp): SystemJTAGIO = { + require(dut.debug.isDefined, "Connecting JTAG requires that debug module exists") + val djtag = dut.debug.get.systemjtag.get + djtag.jtag.TCK := jtag_TCK + djtag.jtag.TMS := jtag_TMS + djtag.jtag.TDI := jtag_TDI + jtag_TDO := djtag.jtag.TDO.data + + djtag.mfr_id := p(JtagDTMKey).idcodeManufId.U(11.W) + djtag.part_number := p(JtagDTMKey).idcodePartNum.U(16.W) + djtag.version := p(JtagDTMKey).idcodeVersion.U(4.W) + + djtag.reset := PowerOnResetFPGAOnly(dut_clock) + dut_ndreset := dut.debug.get.ndreset + djtag + } + + //----------------------------------------------------------------------- + // UART + //----------------------------------------------------------------------- + + uart_rtsn := false.B + + def connectUART(dut: HasPeripheryUARTModuleImp): Unit = dut.uart.headOption.foreach(connectUART) + + def connectUART(uart: UARTPortIO): Unit = { + uart.rxd := SyncResetSynchronizerShiftReg(uart_rx, 2, init = Bool(true), name=Some("uart_rxd_sync")) + uart_tx := uart.txd + } + + //----------------------------------------------------------------------- + // SPI + //----------------------------------------------------------------------- + + def connectSPI(dut: HasPeripherySPIModuleImp): Unit = dut.spi.headOption.foreach(connectSPI) + + def connectSPI(spi: SPIPortIO): Unit = { + // SPI + sd_spi_sck := spi.sck + sd_spi_cs := spi.cs(0) + + spi.dq.zipWithIndex.foreach { + case(pin, idx) => + sd_spi_dq_o(idx) := pin.o + pin.i := sd_spi_dq_i(idx) + } + + //------------------------------------------------------------------- + // SDIO <> SPI Bridge + //------------------------------------------------------------------- + + val ip_sdio_spi = Module(new sdio_spi_bridge()) + + ip_sdio_spi.io.clk := dut_clock + ip_sdio_spi.io.reset := dut_reset + + // SDIO + attach(sdio_dat, ip_sdio_spi.io.sd_dat) + attach(sdio_cmd, ip_sdio_spi.io.sd_cmd) + sdio_clk := ip_sdio_spi.io.spi_sck + + // SPI + ip_sdio_spi.io.spi_sck := sd_spi_sck + ip_sdio_spi.io.spi_cs := sd_spi_cs + sd_spi_dq_i := ip_sdio_spi.io.spi_dq_i.asBools + ip_sdio_spi.io.spi_dq_o := sd_spi_dq_o.asUInt + } + +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/XilinxShell.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/XilinxShell.scala new file mode 100644 index 0000000..4ee22b8 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/XilinxShell.scala @@ -0,0 +1,83 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell.xilinx + +import chisel3._ +import freechips.rocketchip.config._ +import freechips.rocketchip.diplomacy._ +import freechips.rocketchip.util._ +import sifive.fpgashells.clocks._ +import sifive.fpgashells.ip.xilinx._ +import sifive.fpgashells.shell._ + +class XDC(val name: String) +{ + private var constraints: Seq[() => String] = Nil + protected def addConstraint(command: => String) { constraints = (() => command) +: constraints } + ElaborationArtefacts.add(name, constraints.map(_()).reverse.mkString("\n") + "\n") + + def addBoardPin(io: IOPin, pin: String) { + addConstraint(s"set_property BOARD_PIN {${pin}} ${io.sdcPin}") + } + def addPackagePin(io: IOPin, pin: String) { + addConstraint(s"set_property PACKAGE_PIN {${pin}} ${io.sdcPin}") + } + def addIOStandard(io: IOPin, standard: String) { + addConstraint(s"set_property IOSTANDARD {${standard}} ${io.sdcPin}") + } + def addPullup(io: IOPin) { + addConstraint(s"set_property PULLUP {TRUE} ${io.sdcPin}") + } + def addIOB(io: IOPin) { + if (io.isOutput) { + addConstraint(s"set_property IOB {TRUE} [ get_cells -of_objects [ all_fanin -flat -startpoints_only ${io.sdcPin}]]") + } else { + addConstraint(s"set_property IOB {TRUE} [ get_cells -of_objects [ all_fanout -flat -endpoints_only ${io.sdcPin}]]") + } + } + def addSlew(io: IOPin, speed: String) { + addConstraint(s"set_property SLEW {${speed}} ${io.sdcPin}") + } + def addTermination(io: IOPin, kind: String) { + addConstraint(s"set_property OFFCHIP_TERM {${kind}} ${io.sdcPin}") + } + def clockDedicatedRouteFalse(io: IOPin) { + addConstraint(s"set_property CLOCK_DEDICATED_ROUTE {FALSE} [get_nets ${io.sdcPin}]") + } +} + +abstract class XilinxShell()(implicit p: Parameters) extends IOShell +{ + val sdc = new SDC("shell.sdc") + val xdc = new XDC("shell.xdc") + def pllReset: ModuleValue[Bool] + + ElaborationArtefacts.add("shell.vivado.tcl", + """set shell_vivado_tcl [file normalize [info script]] + |set shell_vivado_idx [string last ".shell.vivado.tcl" $shell_vivado_tcl] + |add_files -fileset [current_fileset -constrset] [string replace $shell_vivado_tcl $shell_vivado_idx 999 ".shell.sdc"] + |add_files -fileset [current_fileset -constrset] [string replace $shell_vivado_tcl $shell_vivado_idx 999 ".shell.xdc"] + |set extra_constr [string replace $shell_vivado_tcl $shell_vivado_idx 999 ".extra.shell.xdc"] + |if [file exist $extra_constr] { + | add_files -fileset [current_fileset -constrset] [string replace $shell_vivado_tcl $shell_vivado_idx 999 ".extra.shell.xdc"] + |} + |""".stripMargin) + + //Including the extra .xdc file in this way is a bit of a hack since ElaborationArtefacts can't append, and this tcl will only read specific + // files. The long term solution is to make an overlay that does nothing but include .xdc constraints +} + +abstract class Series7Shell()(implicit p: Parameters) extends XilinxShell +{ + val pllFactory = new PLLFactory(this, 7, p => Module(new Series7MMCM(p))) + override def designParameters = super.designParameters.alterPartial { + case PLLFactoryKey => pllFactory + } +} + +abstract class UltraScaleShell()(implicit p: Parameters) extends XilinxShell +{ + val pllFactory = new PLLFactory(this, 7, p => Module(new Series7MMCM(p))) + override def designParameters = super.designParameters.alterPartial { + case PLLFactoryKey => pllFactory + } +} diff --git a/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/cJTAGDebugOverlay.scala b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/cJTAGDebugOverlay.scala new file mode 100644 index 0000000..e611240 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/src/main/scala/shell/xilinx/cJTAGDebugOverlay.scala @@ -0,0 +1,13 @@ +// See LICENSE for license details. +package sifive.fpgashells.shell.xilinx + +import chisel3._ +import freechips.rocketchip.diplomacy._ +import sifive.fpgashells.shell._ +import sifive.fpgashells.ip.xilinx._ + +abstract class cJTAGDebugXilinxPlacedOverlay(name: String, di: cJTAGDebugDesignInput, si: cJTAGDebugShellInput) + extends cJTAGDebugPlacedOverlay(name, di, si) +{ + def shell: XilinxShell +} diff --git a/hdl_cores/freedom/fpga-shells/vsrc/nfmac10g/axis2xgmii.v b/hdl_cores/freedom/fpga-shells/vsrc/nfmac10g/axis2xgmii.v new file mode 100644 index 0000000..ba9612e --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/vsrc/nfmac10g/axis2xgmii.v @@ -0,0 +1,499 @@ +// +// Copyright (c) 2016 University of Cambridge All rights reserved. +// +// Author: Marco Forconesi +// +// This software was developed with the support of +// Prof. Gustavo Sutter and Prof. Sergio Lopez-Buedo and +// University of Cambridge Computer Laboratory NetFPGA team. +// +// @NETFPGA_LICENSE_HEADER_START@ +// +// Licensed to NetFPGA C.I.C. (NetFPGA) under one or more +// contributor license agreements. See the NOTICE file distributed with this +// work for additional information regarding copyright ownership. NetFPGA +// licenses this file to you under the NetFPGA Hardware-Software License, +// Version 1.0 (the "License"); you may not use this file except in compliance +// with the License. You may obtain a copy of the License at: +// +// http://www.netfpga-cic.org +// +// Unless required by applicable law or agreed to in writing, Work distributed +// under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR +// CONDITIONS OF ANY KIND, either express or implied. See the License for the +// specific language governing permissions and limitations under the License. +// +// @NETFPGA_LICENSE_HEADER_END@ + +////////////////////////////////////////////////////////////////////////////// +////////////////////////////////////////////////////////////////////////////// +`timescale 1ns / 1ps +//`default_nettype none + +module axis2xgmii ( + + // Clks and resets + input clk, + input rst, + + // Stats + output reg [31:0] good_frames, + output reg [31:0] bad_frames, + + // Conf vectors + input [79:0] configuration_vector, + + // internal + output reg lane4_start, + output [1:0] dic_o, + + // XGMII + output [63:0] xgmii_d, + output [7:0] xgmii_c, + + // AXIS + input [63:0] tdata, + input [7:0] tkeep, + input tvalid, + output reg tready, + input tlast, + input [0:0] tuser + ); + + `include "xgmii_includes.vh" + // localparam + localparam SRES = 24'b000000000000000000000001; + localparam IDLE_L0 = 24'b000000000000000000000010; + localparam ST_LANE0 = 24'b000000000000000000000100; + localparam QW_IDLE = 24'b000000000000000000001000; + localparam L0_FIN_8B = 24'b000000000000000000100000; + localparam T_LANE4 = 24'b000000000000000001000000; + localparam L0_FIN_7B_6B_5B = 24'b000000000000000010000000; + localparam T_LANE3 = 24'b000000000000000100000000; + localparam DW_IDLE = 24'b000000000000001000000000; + localparam T_LANE2 = 24'b000000000000010000000000; + localparam T_LANE1 = 24'b000000000000100000000000; + localparam L0_FIN_4B = 24'b000000000001000000000000; + localparam T_LANE0 = 24'b000000000010000000000000; + localparam L0_FIN_3B_2B_1B = 24'b000000000100000000000000; + localparam T_LANE7 = 24'b000000001000000000000000; + localparam T_LANE6 = 24'b000000010000000000000000; + localparam T_LANE5 = 24'b000000100000000000000000; + localparam ST_LANE4 = 24'b000001000000000000000000; + localparam ST_LANE4_D = 24'b000010000000000000000000; + localparam L4_FIN_8B = 24'b000100000000000000000000; + localparam L4_FIN_7B_6B_5B = 24'b001000000000000000000000; + localparam L4_FIN_4B = 24'b010000000000000000000000; + localparam L4_FIN_3B_2B_1B = 24'b100000000000000000000000; + + //------------------------------------------------------- + // Local adapter + //------------------------------------------------------- + reg [23:0] fsm = 'b1; + reg [63:0] tdata_i; + reg [7:0] tkeep_i; + reg [63:0] d; + reg [7:0] c; + reg [31:0] aux_dw; + reg [1:0] dic; + + //------------------------------------------------------- + // Local CRC32 + //------------------------------------------------------- + reg [31:0] crc_32; + reg [31:0] crc_32_7B; + reg [31:0] crc_32_6B; + reg [31:0] crc_32_5B; + reg [31:0] crc_32_4B; + reg [31:0] crc_32_3B; + reg [31:0] crc_32_2B; + reg [31:0] crc_32_1B; + reg [31:0] aux_var_crc; + reg [31:0] calcted_crc4B; + reg [31:0] crc_reg; + + //------------------------------------------------------- + // assigns + //------------------------------------------------------- + assign xgmii_d = d; + assign xgmii_c = c; + assign dic_o = dic; + + //////////////////////////////////////////////// + // adapter + //////////////////////////////////////////////// + always @(posedge clk) begin + + if (rst) begin // rst + d <= QW_IDLE_D; + c <= QW_IDLE_C; + tready <= 1'b0; + fsm <= SRES; + end + + else begin // not rst + + case (fsm) + + SRES : begin + dic <= 'b0; + tready <= 1'b1; + fsm <= IDLE_L0; + end + + IDLE_L0 : begin + d <= QW_IDLE_D; + c <= QW_IDLE_C; + tdata_i <= tdata; + tkeep_i <= tkeep; + lane4_start <= 1'b0; + if (tvalid) begin + crc_32 <= crc8B(CRC802_3_PRESET,tdata); + d <= PREAMBLE_LANE0_D; + c <= PREAMBLE_LANE0_C; + fsm <= ST_LANE0; + end + else begin + if (dic) begin + dic <= dic - 1; + end + end + end + + ST_LANE0 : begin + tready <= 1'b0; + tdata_i <= tdata; + tkeep_i <= tkeep; + d <= tdata_i; + c <= 8'b0; + crc_32 <= crc8B(crc_32,tdata); + crc_32_7B <= crc7B(crc_32,tdata[55:0]); + crc_32_6B <= crc6B(crc_32,tdata[47:0]); + crc_32_5B <= crc5B(crc_32,tdata[39:0]); + crc_32_4B <= crc4B(crc_32,tdata[31:0]); + crc_32_3B <= crc3B(crc_32,tdata[23:0]); + crc_32_2B <= crc2B(crc_32,tdata[15:0]); + crc_32_1B <= crc1B(crc_32,tdata[7:0]); + + casex ({tuser[0], tlast, tkeep[7:3]}) + {2'b1x, 5'hxx} : begin + d[7:0] <= XGMII_ERROR_L0_D; + d[63:56] <= T; + c <= XGMII_ERROR_L0_C; + c[7] <= 1'b1; + fsm <= QW_IDLE; + end + {2'b00, 5'hxx} : begin + tready <= 1'b1; + end + {2'b01, 5'b1xxxx} : begin + fsm <= L0_FIN_8B; + end + {2'b01, 5'b0xx1x} : begin + fsm <= L0_FIN_7B_6B_5B; + end + {2'b01, 5'bxxx01} : begin + fsm <= L0_FIN_4B; + end + {2'b01, 5'bxxxx0} : begin + fsm <= L0_FIN_3B_2B_1B; + end + endcase + end + + QW_IDLE : begin + d <= QW_IDLE_D; + c <= QW_IDLE_C; + tready <= 1'b1; + fsm <= IDLE_L0; + end + + L0_FIN_8B : begin + d <= tdata_i; + c <= 8'h00; + calcted_crc4B <= ~crc_rev(crc_32); + fsm <= T_LANE4; + end + + T_LANE4 : begin + d <= {{3{I}}, T, calcted_crc4B}; + c <= 8'hF0; + fsm <= QW_IDLE; + end + + L0_FIN_7B_6B_5B : begin + casex (tkeep_i[6:4]) + 3'b1xx : begin + aux_var_crc = ~crc_rev(crc_32_7B); + d <= {aux_var_crc[7:0], tdata_i[55:0]}; + fsm <= T_LANE3; + end + 3'b01x : begin + aux_var_crc = ~crc_rev(crc_32_6B); + d <= {aux_var_crc[15:0], tdata_i[47:0]}; + fsm <= T_LANE2; + end + 3'b001 : begin + aux_var_crc = ~crc_rev(crc_32_5B); + d <= {aux_var_crc[23:0], tdata_i[39:0]}; + fsm <= T_LANE1; + end + endcase + c <= 8'b0; + crc_reg <= aux_var_crc; + end + + T_LANE3 : begin + d <= {{4{I}}, T, crc_reg[31:8]}; + c <= 8'hF8; + if (!dic) begin + dic <= 'h3; + tready <= 1'b1; + fsm <= DW_IDLE; + end + else begin + dic <= dic - 1; + fsm <= QW_IDLE; + end + end + + DW_IDLE : begin + d <= QW_IDLE_D; + c <= QW_IDLE_C; + tdata_i <= tdata; + tkeep_i <= tkeep; + if (tvalid) begin + crc_32 <= crc8B(CRC802_3_PRESET,tdata); + d <= PREAMBLE_LANE4_D; + c <= PREAMBLE_LANE4_C; + fsm <= ST_LANE4; + end + else begin + fsm <= IDLE_L0; + end + end + + T_LANE2 : begin + d <= {{5{I}}, T, crc_reg[31:16]}; + c <= 8'hFC; + if (dic < 2) begin + dic <= dic + 2; + tready <= 1'b1; + fsm <= DW_IDLE; + end + else begin + dic <= dic - 2; + fsm <= QW_IDLE; + end + end + + T_LANE1 : begin + d <= {{6{I}}, T, crc_reg[31:24]}; + c <= 8'hFE; + if (dic < 3) begin + dic <= dic + 1; + tready <= 1'b1; + fsm <= DW_IDLE; + end + else begin + dic <= 'b0; + fsm <= QW_IDLE; + end + end + + L0_FIN_4B : begin + d <= {~crc_rev(crc_32_4B), tdata_i[31:0]}; + c <= 8'b0; + fsm <= T_LANE0; + end + + T_LANE0 : begin + d <= {{7{I}}, T}; + c <= 8'hFF; + tready <= 1'b1; + fsm <= DW_IDLE; + end + + L0_FIN_3B_2B_1B : begin + casex (tkeep_i[2:0]) + 3'b1xx : begin + d <= {T, ~crc_rev(crc_32_3B), tdata_i[23:0]}; + c <= 8'h80; + fsm <= T_LANE7; + end + 3'b01x : begin + d <= {I, T, ~crc_rev(crc_32_2B), tdata_i[15:0]}; + c <= 8'hC0; + fsm <= T_LANE6; + end + 3'b001 : begin + d <= {{2{I}}, T, ~crc_rev(crc_32_1B), tdata_i[7:0]}; + c <= 8'hE0; + fsm <= T_LANE5; + end + endcase + end + + T_LANE7 : begin + d <= QW_IDLE_D; + c <= QW_IDLE_C; + tready <= 1'b1; + if (!dic) begin + dic <= 'h3; + fsm <= IDLE_L0; + end + else begin + dic <= dic - 1; + fsm <= DW_IDLE; + end + end + + T_LANE6 : begin + d <= QW_IDLE_D; + c <= QW_IDLE_C; + tready <= 1'b1; + if (dic < 2) begin + dic <= dic + 2; + fsm <= IDLE_L0; + end + else begin + dic <= dic - 2; + fsm <= DW_IDLE; + end + end + + T_LANE5 : begin + d <= QW_IDLE_D; + c <= QW_IDLE_C; + tready <= 1'b1; + if (dic < 3) begin + dic <= dic + 1; + fsm <= IDLE_L0; + end + else begin + dic <= 'b0; + fsm <= DW_IDLE; + end + end + + ST_LANE4 : begin + tdata_i <= tdata; + tkeep_i <= tkeep; + aux_dw <= tdata_i[63:32]; + d <= {tdata_i[31:0], PREAMBLE_LANE4_END_D}; + c <= PREAMBLE_LANE4_END_C; + crc_32 <= crc8B(crc_32,tdata); + lane4_start <= 1'b1; + if (tuser[0]) begin + d[7:0] <= XGMII_ERROR_L0_D; + d[63:56] <= T; + c <= XGMII_ERROR_L0_C; + c[7] <= 1'b1; + tready <= 1'b0; + fsm <= QW_IDLE; + end + else begin + fsm <= ST_LANE4_D; + end + end + + ST_LANE4_D : begin + tready <= 1'b0; + tdata_i <= tdata; + tkeep_i <= tkeep; + aux_dw <= tdata_i[63:32]; + d <= {tdata_i[31:0], aux_dw}; + c <= 8'b0; + crc_32 <= crc8B(crc_32,tdata); + crc_32_7B <= crc7B(crc_32,tdata[55:0]); + crc_32_6B <= crc6B(crc_32,tdata[47:0]); + crc_32_5B <= crc5B(crc_32,tdata[39:0]); + crc_32_4B <= crc4B(crc_32,tdata[31:0]); + crc_32_3B <= crc3B(crc_32,tdata[23:0]); + crc_32_2B <= crc2B(crc_32,tdata[15:0]); + crc_32_1B <= crc1B(crc_32,tdata[7:0]); + + casex ({tuser[0], tlast, tkeep[7:3]}) + {2'b1x, 5'hxx} : begin + d[39:32] <= XGMII_ERROR_L4_D; + c <= XGMII_ERROR_L4_C; + fsm <= QW_IDLE; + end + {2'b00, 5'hxx} : begin + tready <= 1'b1; + end + {2'b01, 5'b1xxxx} : begin + fsm <= L4_FIN_8B; + end + {2'b01, 5'b0xx1x} : begin + fsm <= L4_FIN_7B_6B_5B; + end + {2'b01, 5'bxxx01} : begin + fsm <= L4_FIN_4B; + end + {2'b01, 5'bxxxx0} : begin + fsm <= L4_FIN_3B_2B_1B; + end + endcase + end + + L4_FIN_8B : begin + d <= {tdata_i[31:0], aux_dw}; + c <= 8'b0; + tdata_i[31:0] <= tdata_i[63:32]; + crc_32_4B <= crc_32; + fsm <= L0_FIN_4B; + end + + L4_FIN_7B_6B_5B : begin + c <= 8'b0; + crc_32_1B <= crc_32_5B; + crc_32_2B <= crc_32_6B; + crc_32_3B <= crc_32_7B; + tdata_i[31:0] <= tdata_i[63:32]; + tkeep_i[2:0] <= tkeep_i[6:4]; + d <= {tdata_i[31:0], aux_dw}; + fsm <= L0_FIN_3B_2B_1B; + end + + L4_FIN_4B : begin + d <= {tdata_i[31:0], aux_dw}; + c <= 8'b0; + calcted_crc4B <= ~crc_rev(crc_32_4B); + fsm <= T_LANE4; + end + + L4_FIN_3B_2B_1B : begin + casex (tkeep_i[2:0]) + 3'b1xx : begin + aux_var_crc = ~crc_rev(crc_32_3B); + d <= {aux_var_crc[7:0], tdata_i[23:0], aux_dw}; + fsm <= T_LANE3; + end + 3'b01x : begin + aux_var_crc = ~crc_rev(crc_32_2B); + d <= {aux_var_crc[15:0], tdata_i[15:0], aux_dw}; + fsm <= T_LANE2; + end + 3'b001 : begin + aux_var_crc = ~crc_rev(crc_32_1B); + d <= {aux_var_crc[23:0], tdata_i[7:0], aux_dw}; + fsm <= T_LANE1; + end + endcase + c <= 8'b0; + crc_reg <= aux_var_crc; + end + + default : begin + fsm <= SRES; + end + + endcase + end // not rst + end //always + +endmodule // axis2xgmii + +////////////////////////////////////////////////////////////////////////////// +////////////////////////////////////////////////////////////////////////////// \ No newline at end of file diff --git a/hdl_cores/freedom/fpga-shells/vsrc/nfmac10g/nfmac10g.v b/hdl_cores/freedom/fpga-shells/vsrc/nfmac10g/nfmac10g.v new file mode 100644 index 0000000..d5dec34 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/vsrc/nfmac10g/nfmac10g.v @@ -0,0 +1,195 @@ +// +// Copyright (c) 2016 University of Cambridge All rights reserved. +// +// Author: Marco Forconesi +// +// This software was developed with the support of +// Prof. Gustavo Sutter and Prof. Sergio Lopez-Buedo and +// University of Cambridge Computer Laboratory NetFPGA team. +// +// @NETFPGA_LICENSE_HEADER_START@ +// +// Licensed to NetFPGA C.I.C. (NetFPGA) under one or more +// contributor license agreements. See the NOTICE file distributed with this +// work for additional information regarding copyright ownership. NetFPGA +// licenses this file to you under the NetFPGA Hardware-Software License, +// Version 1.0 (the "License"); you may not use this file except in compliance +// with the License. You may obtain a copy of the License at: +// +// http://www.netfpga-cic.org +// +// Unless required by applicable law or agreed to in writing, Work distributed +// under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR +// CONDITIONS OF ANY KIND, either express or implied. See the License for the +// specific language governing permissions and limitations under the License. +// +// @NETFPGA_LICENSE_HEADER_END@ + +////////////////////////////////////////////////////////////////////////////// +////////////////////////////////////////////////////////////////////////////// +`timescale 1ns / 1ps +//`default_nettype none + +module nfmac10g # ( + parameter C_TX_SUBSYS_EN = 1, + parameter C_RX_SUBSYS_EN = 1 + ) ( + + // Clks and resets + input tx_clk0, + input rx_clk0, + input reset, + input tx_dcm_locked, + input rx_dcm_locked, + + // Flow control + input [7:0] tx_ifg_delay, + input [15:0] pause_val, + input pause_req, + + // Conf and status vectors + input [79:0] tx_configuration_vector, + input [79:0] rx_configuration_vector, + output [1:0] status_vector, + + // Statistic Vector Signals + output [25:0] tx_statistics_vector, + output tx_statistics_valid, + output [29:0] rx_statistics_vector, + output rx_statistics_valid, + + // XGMII + output [63:0] xgmii_txd, + output [7:0] xgmii_txc, + input [63:0] xgmii_rxd, + input [7:0] xgmii_rxc, + + // Tx AXIS + input tx_axis_aresetn, + input [63:0] tx_axis_tdata, + input [7:0] tx_axis_tkeep, + input tx_axis_tvalid, + output tx_axis_tready, + input tx_axis_tlast, + input [0:0] tx_axis_tuser, + + // Rx AXIS + input rx_axis_aresetn, + output [63:0] rx_axis_tdata, + output [7:0] rx_axis_tkeep, + output rx_axis_tvalid, + output rx_axis_tlast, + output [0:0] rx_axis_tuser + ); + + //------------------------------------------------------- + // Local clk + //------------------------------------------------------- + wire tx_clk; + wire rx_clk; + wire tx_rst; + wire rx_rst; + + //------------------------------------------------------- + // Local Rx + //------------------------------------------------------- + wire [31:0] rx_good_frames; + wire [31:0] rx_bad_frames; + + //------------------------------------------------------- + // tx_rst_mod + //------------------------------------------------------- + rst_mod tx_rst_mod ( + .clk(tx_clk), // I + .reset(reset), // I + .dcm_locked(tx_dcm_locked), // I + .rst(tx_rst) // O + ); + + //------------------------------------------------------- + // rx_rst_mod + //------------------------------------------------------- + rst_mod rx_rst_mod ( + .clk(rx_clk), // I + .reset(reset), // I + .dcm_locked(rx_dcm_locked), // I + .rst(rx_rst) // O + ); + + //------------------------------------------------------- + // assigns + //------------------------------------------------------- + assign tx_clk = tx_clk0; + assign rx_clk = rx_clk0; + assign status_vector = 'b0; + assign tx_statistics_vector = 'b0; + assign tx_statistics_valid = 'b0; + assign rx_statistics_vector = 'b0; + assign rx_statistics_valid = 'b0; + + //------------------------------------------------------- + // Tx + //------------------------------------------------------- + generate if (C_TX_SUBSYS_EN == 1) begin + tx tx_mod ( + .clk(tx_clk), // I + .rst(tx_rst), // I + // Conf vectors + .configuration_vector(tx_configuration_vector), // I [79:0] + // XGMII + .xgmii_txd(xgmii_txd), // I [63:0] + .xgmii_txc(xgmii_txc), // I [7:0] + // AXIS + .axis_aresetn(tx_axis_aresetn), // I + .axis_tdata(tx_axis_tdata), // I [63:0] + .axis_tkeep(tx_axis_tkeep), // I [7:0] + .axis_tvalid(tx_axis_tvalid), // I + .axis_tready(tx_axis_tready), // O + .axis_tlast(tx_axis_tlast), // I + .axis_tuser(tx_axis_tuser) // I [0:0] + ); + end + else begin // C_TX_SUBSYS_EN + assign xgmii_txd = 64'h0707070707070707; + assign xgmii_txc = 8'hFF; + assign tx_axis_tready = 1'b0; + end endgenerate + + //------------------------------------------------------- + // Rx + //------------------------------------------------------- + generate if (C_RX_SUBSYS_EN == 1) begin + rx rx_mod ( + .clk(rx_clk), // I + .rst(rx_rst), // I + // Stats + .good_frames(rx_good_frames), // O [31:0] + .bad_frames(rx_bad_frames), // O [31:0] + // Conf vectors + .configuration_vector(rx_configuration_vector), // I [79:0] + // XGMII + .xgmii_rxd(xgmii_rxd), // I [63:0] + .xgmii_rxc(xgmii_rxc), // I [7:0] + // AXIS + .axis_aresetn(rx_axis_aresetn), // I + .axis_tdata(rx_axis_tdata), // O [63:0] + .axis_tkeep(rx_axis_tkeep), // O [7:0] + .axis_tvalid(rx_axis_tvalid), // O + .axis_tlast(rx_axis_tlast), // O + .axis_tuser(rx_axis_tuser) // O [0:0] + ); + end + else begin // C_RX_SUBSYS_EN + assign rx_good_frames = 'b0; + assign rx_bad_frames = 'b0; + assign rx_axis_tdata = 'b0; + assign rx_axis_tkeep = 'b0; + assign rx_axis_tvalid = 1'b0; + assign rx_axis_tlast = 1'b0; + assign rx_axis_tuser = 'b0; + end endgenerate + +endmodule // nfmac10g + +////////////////////////////////////////////////////////////////////////////// +////////////////////////////////////////////////////////////////////////////// \ No newline at end of file diff --git a/hdl_cores/freedom/fpga-shells/vsrc/nfmac10g/padding_ctrl.v b/hdl_cores/freedom/fpga-shells/vsrc/nfmac10g/padding_ctrl.v new file mode 100644 index 0000000..789e470 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/vsrc/nfmac10g/padding_ctrl.v @@ -0,0 +1,288 @@ +// +// Copyright (c) 2016 University of Cambridge All rights reserved. +// +// Author: Marco Forconesi +// +// This software was developed with the support of +// Prof. Gustavo Sutter and Prof. Sergio Lopez-Buedo and +// University of Cambridge Computer Laboratory NetFPGA team. +// +// @NETFPGA_LICENSE_HEADER_START@ +// +// Licensed to NetFPGA C.I.C. (NetFPGA) under one or more +// contributor license agreements. See the NOTICE file distributed with this +// work for additional information regarding copyright ownership. NetFPGA +// licenses this file to you under the NetFPGA Hardware-Software License, +// Version 1.0 (the "License"); you may not use this file except in compliance +// with the License. You may obtain a copy of the License at: +// +// http://www.netfpga-cic.org +// +// Unless required by applicable law or agreed to in writing, Work distributed +// under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR +// CONDITIONS OF ANY KIND, either express or implied. See the License for the +// specific language governing permissions and limitations under the License. +// +// @NETFPGA_LICENSE_HEADER_END@ + +////////////////////////////////////////////////////////////////////////////// +////////////////////////////////////////////////////////////////////////////// +`timescale 1ns / 1ps +//`default_nettype none + +module padding_ctrl ( + + // Clks and resets + input clk, + input rst, + + // AXIS In + input aresetn, + input [63:0] s_axis_tdata, + input [7:0] s_axis_tkeep, + input s_axis_tvalid, + output reg s_axis_tready, + input s_axis_tlast, + input [0:0] s_axis_tuser, + + // AXIS Out + output reg [63:0] m_axis_tdata, + output reg [7:0] m_axis_tkeep, + output reg m_axis_tvalid, + input m_axis_tready, + output reg m_axis_tlast, + output reg [0:0] m_axis_tuser, + + // internal + input lane4_start, + input [1:0] dic + ); + + `include "xgmii_includes.vh" + // localparam + localparam SRES = 8'b00000001; + localparam IDLE = 8'b00000010; + localparam ST = 8'b00000100; + localparam PAD_CHK = 8'b00001000; + localparam W3 = 8'b00010000; + localparam W2 = 8'b00100000; + localparam ERR_W_LAST = 8'b01000000; + localparam s7 = 8'b10000000; + + //------------------------------------------------------- + // Local + //------------------------------------------------------- + wire inv_aresetn; + + //------------------------------------------------------- + // Local adapter + //------------------------------------------------------- + reg [7:0] fsm = 'b1; + reg [4:0] trn; + reg [63:0] m_axis_tdata_d0; + reg m_axis_tvalid_d0; + reg [7:0] last_tkeep; + + //------------------------------------------------------- + // assigns + //------------------------------------------------------- + assign inv_aresetn = ~aresetn; + + //////////////////////////////////////////////// + // adapter + //////////////////////////////////////////////// + always @(posedge clk) begin + + if (inv_aresetn) begin // rst + s_axis_tready <= 1'b0; + m_axis_tvalid <= 1'b0; + fsm <= SRES; + end + + else begin // not rst + + m_axis_tdata <= m_axis_tdata_d0; + m_axis_tvalid <= m_axis_tvalid_d0; + m_axis_tlast <= 1'b0; + m_axis_tuser[0] <= 1'b0; + + case (fsm) + + SRES : begin + m_axis_tuser <= 'b0; + if (m_axis_tready) begin + s_axis_tready <= 1'b1; + fsm <= IDLE; + end + end + + IDLE : begin + m_axis_tdata_d0 <= s_axis_tdata; + m_axis_tkeep <= 8'hFF; + trn <= 1; + if (s_axis_tvalid) begin + m_axis_tvalid_d0 <= 1'b1; + fsm <= ST; + end + end + + ST : begin + m_axis_tdata_d0 <= s_axis_tdata; + s_axis_tready <= 1'b0; + if (!trn[4]) begin + trn[3:0] <= trn[3:0] + 1; + end + if (trn[3]) begin + trn[4] <= 1'b1; + end + fsm <= PAD_CHK; + + casex ({s_axis_tvalid, s_axis_tlast, s_axis_tuser[0], s_axis_tkeep}) + {3'b0xx, 8'hxx} : begin + m_axis_tuser[0] <= 1'b1; + m_axis_tvalid_d0 <= 1'b0; + fsm <= W2; + end + {3'b101, 8'hxx} : begin + m_axis_tuser[0] <= 1'b1; + m_axis_tvalid_d0 <= 1'b0; + s_axis_tready <= 1'b1; + fsm <= ERR_W_LAST; + end + {3'b111, 8'hxx} : begin + m_axis_tuser[0] <= 1'b1; + m_axis_tvalid_d0 <= 1'b0; + fsm <= W2; + end + {3'b100, 8'bxxxxxxxx} : begin + s_axis_tready <= 1'b1; + fsm <= ST; + end + {3'b110, 8'b1xxxxxxx} : begin + last_tkeep <= 8'hFF; + end + {3'b110, 8'b01xxxxxx} : begin + m_axis_tdata_d0 <= {8'b0, s_axis_tdata[55:0]}; + last_tkeep <= 8'h7F; + end + {3'b110, 8'bx01xxxxx} : begin + m_axis_tdata_d0 <= {16'b0, s_axis_tdata[47:0]}; + last_tkeep <= 8'h3F; + end + {3'b110, 8'bxx01xxxx} : begin + m_axis_tdata_d0 <= {24'b0, s_axis_tdata[39:0]}; + last_tkeep <= 8'h1F; + end + {3'b110, 8'bxxx01xxx} : begin + m_axis_tdata_d0 <= {32'b0, s_axis_tdata[31:0]}; + last_tkeep <= 8'h0F; + end + {3'b110, 8'bxxxx01xx} : begin + m_axis_tdata_d0 <= {40'b0, s_axis_tdata[23:0]}; + last_tkeep <= 8'h07; + end + {3'b110, 8'bxxxxx01x} : begin + m_axis_tdata_d0 <= {48'b0, s_axis_tdata[15:0]}; + last_tkeep <= 8'h03; + end + {3'b110, 8'bxxxxxx01} : begin + m_axis_tdata_d0 <= {56'b0, s_axis_tdata[7:0]}; + last_tkeep <= 8'h01; + end + endcase + end + + PAD_CHK : begin + m_axis_tdata_d0 <= 'b0; + last_tkeep <= 8'h0F; + trn <= trn + 1; + if (trn >= 8) begin + m_axis_tvalid_d0 <= 1'b0; + m_axis_tlast <= 1'b1; + m_axis_tkeep <= last_tkeep; + casex ({lane4_start, dic, last_tkeep, trn[4]}) + // L0 + {1'b0, 2'b00, 8'b01xxxxxx, 1'bx} : begin // 7f + fsm <= W2; + end + {1'b0, 2'b00, 8'bx01xxxxx, 1'bx} : begin // 3f + fsm <= W2; + end + {1'b0, 2'b01, 8'bx01xxxxx, 1'bx} : begin // 3f + fsm <= W2; + end + {1'b0, 2'b00, 8'bxx01xxxx, 1'bx} : begin // 1f + fsm <= W2; + end + {1'b0, 2'b01, 8'bxx01xxxx, 1'bx} : begin // 1f + fsm <= W2; + end + {1'b0, 2'b10, 8'bxx01xxxx, 1'bx} : begin // 1f + fsm <= W2; + end + {1'b0, 2'bxx, 8'bxxx0xxxx, 1'b1} : begin // 0f, 07, 03, 01 + fsm <= W2; + end + + // L4 + {1'b1, 2'b00, 8'bxxxx01xx, 1'b1} : begin // 07 + fsm <= W2; + end + {1'b1, 2'b00, 8'bxxxxx01x, 1'b1} : begin // 03 + fsm <= W2; + end + {1'b1, 2'b01, 8'bxxxxx01x, 1'b1} : begin // 03 + fsm <= W2; + end + {1'b1, 2'b00, 8'bxxxxxx01, 1'b1} : begin // 01 + fsm <= W2; + end + {1'b1, 2'b01, 8'bxxxxxx01, 1'b1} : begin // 01 + fsm <= W2; + end + {1'b1, 2'b10, 8'bxxxxxx01, 1'b1} : begin // 01 + fsm <= W2; + end + + // 8-trn + {1'b0, 2'bxx, 8'bxxx0xxxx, 1'b0} : begin // 0f, 07, 03, 01 + m_axis_tkeep <= 8'h0F; + fsm <= W2; + end + {1'bx, 2'bxx, 8'bxxxx0xxx, 1'b0} : begin // 07, 03, 01 + m_axis_tkeep <= 8'h0F; + fsm <= W3; + end + default : begin + fsm <= W3; + end + endcase + end + end + + W3 : fsm <= W2; + + W2 : begin + s_axis_tready <= 1'b1; + fsm <= IDLE; + end + + ERR_W_LAST : begin + if (!s_axis_tvalid || s_axis_tlast) begin + s_axis_tready <= 1'b0; + fsm <= W2; + end + end + + default : begin + fsm <= SRES; + end + + endcase + end // not rst + end //always + +endmodule // padding_ctrl + +////////////////////////////////////////////////////////////////////////////// +////////////////////////////////////////////////////////////////////////////// \ No newline at end of file diff --git a/hdl_cores/freedom/fpga-shells/vsrc/nfmac10g/rst_mod.v b/hdl_cores/freedom/fpga-shells/vsrc/nfmac10g/rst_mod.v new file mode 100644 index 0000000..59b4637 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/vsrc/nfmac10g/rst_mod.v @@ -0,0 +1,103 @@ +// +// Copyright (c) 2016 University of Cambridge All rights reserved. +// +// Author: Marco Forconesi +// +// This software was developed with the support of +// Prof. Gustavo Sutter and Prof. Sergio Lopez-Buedo and +// University of Cambridge Computer Laboratory NetFPGA team. +// +// @NETFPGA_LICENSE_HEADER_START@ +// +// Licensed to NetFPGA C.I.C. (NetFPGA) under one or more +// contributor license agreements. See the NOTICE file distributed with this +// work for additional information regarding copyright ownership. NetFPGA +// licenses this file to you under the NetFPGA Hardware-Software License, +// Version 1.0 (the "License"); you may not use this file except in compliance +// with the License. You may obtain a copy of the License at: +// +// http://www.netfpga-cic.org +// +// Unless required by applicable law or agreed to in writing, Work distributed +// under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR +// CONDITIONS OF ANY KIND, either express or implied. See the License for the +// specific language governing permissions and limitations under the License. +// +// @NETFPGA_LICENSE_HEADER_END@ + +////////////////////////////////////////////////////////////////////////////// +////////////////////////////////////////////////////////////////////////////// +`timescale 1ns / 1ps +//`default_nettype none + +module rst_mod ( + + // Clks and resets + input clk, + input reset, + input dcm_locked, + + // Output + output reg rst + ); + + // localparam + localparam s0 = 8'b00000001; + localparam s1 = 8'b00000010; + localparam s2 = 8'b00000100; + localparam s3 = 8'b00001000; + localparam s4 = 8'b00010000; + localparam s5 = 8'b00100000; + localparam s6 = 8'b01000000; + localparam s7 = 8'b10000000; + + //------------------------------------------------------- + // Local gen_rst + //------------------------------------------------------- + reg [7:0] fsm = 'b1; + + //////////////////////////////////////////////// + // gen_rst + //////////////////////////////////////////////// + always @(posedge clk or posedge reset) begin + + if (reset) begin // reset + rst <= 1'b1; + fsm <= s0; + end + + else begin // not reset + + case (fsm) + + s0 : begin + rst <= 1'b1; + fsm <= s1; + end + + s1 : fsm <= s2; + s2 : fsm <= s3; + s3 : fsm <= s4; + + s4 : begin + if (dcm_locked) begin + fsm <= s5; + end + end + + s5 : begin + rst <= 1'b0; + end + + default : begin + fsm <= s0; + end + + endcase + end // not reset + end //always + +endmodule // rst_mod + +////////////////////////////////////////////////////////////////////////////// +////////////////////////////////////////////////////////////////////////////// \ No newline at end of file diff --git a/hdl_cores/freedom/fpga-shells/vsrc/nfmac10g/rx.v b/hdl_cores/freedom/fpga-shells/vsrc/nfmac10g/rx.v new file mode 100644 index 0000000..a493378 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/vsrc/nfmac10g/rx.v @@ -0,0 +1,99 @@ +// +// Copyright (c) 2016 University of Cambridge All rights reserved. +// +// Author: Marco Forconesi +// +// This software was developed with the support of +// Prof. Gustavo Sutter and Prof. Sergio Lopez-Buedo and +// University of Cambridge Computer Laboratory NetFPGA team. +// +// @NETFPGA_LICENSE_HEADER_START@ +// +// Licensed to NetFPGA C.I.C. (NetFPGA) under one or more +// contributor license agreements. See the NOTICE file distributed with this +// work for additional information regarding copyright ownership. NetFPGA +// licenses this file to you under the NetFPGA Hardware-Software License, +// Version 1.0 (the "License"); you may not use this file except in compliance +// with the License. You may obtain a copy of the License at: +// +// http://www.netfpga-cic.org +// +// Unless required by applicable law or agreed to in writing, Work distributed +// under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR +// CONDITIONS OF ANY KIND, either express or implied. See the License for the +// specific language governing permissions and limitations under the License. +// +// @NETFPGA_LICENSE_HEADER_END@ + +////////////////////////////////////////////////////////////////////////////// +////////////////////////////////////////////////////////////////////////////// +`timescale 1ns / 1ps +//`default_nettype none + +module rx ( + + // Clks and resets + input clk, + input rst, + + // Stats + output [31:0] good_frames, + output [31:0] bad_frames, + + // Conf vectors + input [79:0] configuration_vector, + + // XGMII + input [63:0] xgmii_rxd, + input [7:0] xgmii_rxc, + + // AXIS + input axis_aresetn, + output [63:0] axis_tdata, + output [7:0] axis_tkeep, + output axis_tvalid, + output axis_tlast, + output [0:0] axis_tuser + ); + + //------------------------------------------------------- + // Local xgmii2axis + //------------------------------------------------------- + //wire ??; + + //------------------------------------------------------- + // Local + //------------------------------------------------------- + //wire [31:0] ??; + + //------------------------------------------------------- + // assigns + //------------------------------------------------------- + + //------------------------------------------------------- + // xgmii2axis + //------------------------------------------------------- + xgmii2axis xgmii2axis_mod ( + .clk(clk), // I + .rst(rst), // I + // Stats + .good_frames(good_frames), // O [31:0] + .bad_frames(bad_frames), // O [31:0] + // Conf vectors + .configuration_vector(configuration_vector), // I [79:0] + // XGMII + .xgmii_d(xgmii_rxd), // I [63:0] + .xgmii_c(xgmii_rxc), // I [7:0] + // AXIS + .aresetn(axis_aresetn), // I + .tdata(axis_tdata), // O [63:0] + .tkeep(axis_tkeep), // O [7:0] + .tvalid(axis_tvalid), // O + .tlast(axis_tlast), // O + .tuser(axis_tuser) // O [0:0] + ); + +endmodule // rx + +////////////////////////////////////////////////////////////////////////////// +////////////////////////////////////////////////////////////////////////////// \ No newline at end of file diff --git a/hdl_cores/freedom/fpga-shells/vsrc/nfmac10g/tx.v b/hdl_cores/freedom/fpga-shells/vsrc/nfmac10g/tx.v new file mode 100644 index 0000000..dcf59bc --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/vsrc/nfmac10g/tx.v @@ -0,0 +1,139 @@ +// +// Copyright (c) 2016 University of Cambridge All rights reserved. +// +// Author: Marco Forconesi +// +// This software was developed with the support of +// Prof. Gustavo Sutter and Prof. Sergio Lopez-Buedo and +// University of Cambridge Computer Laboratory NetFPGA team. +// +// @NETFPGA_LICENSE_HEADER_START@ +// +// Licensed to NetFPGA C.I.C. (NetFPGA) under one or more +// contributor license agreements. See the NOTICE file distributed with this +// work for additional information regarding copyright ownership. NetFPGA +// licenses this file to you under the NetFPGA Hardware-Software License, +// Version 1.0 (the "License"); you may not use this file except in compliance +// with the License. You may obtain a copy of the License at: +// +// http://www.netfpga-cic.org +// +// Unless required by applicable law or agreed to in writing, Work distributed +// under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR +// CONDITIONS OF ANY KIND, either express or implied. See the License for the +// specific language governing permissions and limitations under the License. +// +// @NETFPGA_LICENSE_HEADER_END@ + +////////////////////////////////////////////////////////////////////////////// +////////////////////////////////////////////////////////////////////////////// +`timescale 1ns / 1ps +//`default_nettype none + +module tx ( + + // Clks and resets + input clk, + input rst, + + // Conf vectors + input [79:0] configuration_vector, + + // XGMII + output [63:0] xgmii_txd, + output [7:0] xgmii_txc, + + // AXIS + input axis_aresetn, + input [63:0] axis_tdata, + input [7:0] axis_tkeep, + input axis_tvalid, + output axis_tready, + input axis_tlast, + input [0:0] axis_tuser + ); + + //------------------------------------------------------- + // Local padding_ctrl + //------------------------------------------------------- + // S + wire [63:0] s_axis_tdata; + wire [7:0] s_axis_tkeep; + wire s_axis_tvalid; + wire s_axis_tready; + wire s_axis_tlast; + wire [0:0] s_axis_tuser; + // M + wire [63:0] m_axis_tdata; + wire [7:0] m_axis_tkeep; + wire m_axis_tvalid; + wire m_axis_tready; + wire m_axis_tlast; + wire [0:0] m_axis_tuser; + // internal + wire lane4_start; + wire [1:0] dic; + + //------------------------------------------------------- + // assigns + //------------------------------------------------------- + assign s_axis_tdata = axis_tdata; + assign s_axis_tkeep = axis_tkeep; + assign s_axis_tvalid = axis_tvalid; + assign axis_tready = s_axis_tready; + assign s_axis_tlast = axis_tlast; + assign s_axis_tuser = axis_tuser; + + //------------------------------------------------------- + // padding_ctrl + //------------------------------------------------------- + padding_ctrl padding_ctrl_mod ( + .clk(clk), // I + .rst(rst), // I + // AXIS In + .aresetn(axis_aresetn), // I + .s_axis_tdata(s_axis_tdata), // I [63:0] + .s_axis_tkeep(s_axis_tkeep), // I [7:0] + .s_axis_tvalid(s_axis_tvalid), // I + .s_axis_tready(s_axis_tready), // O + .s_axis_tlast(s_axis_tlast), // I + .s_axis_tuser(s_axis_tuser), // I [0:0] + // AXIS Out + .m_axis_tdata(m_axis_tdata), // O [63:0] + .m_axis_tkeep(m_axis_tkeep), // O [7:0] + .m_axis_tvalid(m_axis_tvalid), // O + .m_axis_tready(m_axis_tready), // I + .m_axis_tlast(m_axis_tlast), // O + .m_axis_tuser(m_axis_tuser), // O [0:0] + // internal + .lane4_start(lane4_start), // I + .dic(dic) // I [1:0] + ); + + //------------------------------------------------------- + // axis2xgmii + //------------------------------------------------------- + axis2xgmii axis2xgmii_mod ( + .clk(clk), // I + .rst(rst), // I + // Conf vectors + .configuration_vector(configuration_vector), // I [79:0] + // internal + .lane4_start(lane4_start), // O + .dic_o(dic), // O [1:0] + // XGMII + .xgmii_d(xgmii_txd), // O [63:0] + .xgmii_c(xgmii_txc), // O [7:0] + // AXIS + .tdata(m_axis_tdata), // I [63:0] + .tkeep(m_axis_tkeep), // I [7:0] + .tvalid(m_axis_tvalid), // I + .tready(m_axis_tready), // O + .tlast(m_axis_tlast), // I + .tuser(m_axis_tuser) // I [0:0] + ); + +endmodule // tx + +////////////////////////////////////////////////////////////////////////////// +////////////////////////////////////////////////////////////////////////////// \ No newline at end of file diff --git a/hdl_cores/freedom/fpga-shells/vsrc/nfmac10g/xgmii2axis.v b/hdl_cores/freedom/fpga-shells/vsrc/nfmac10g/xgmii2axis.v new file mode 100644 index 0000000..04c4f3d --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/vsrc/nfmac10g/xgmii2axis.v @@ -0,0 +1,448 @@ +// +// Copyright (c) 2016 University of Cambridge All rights reserved. +// +// Author: Marco Forconesi +// +// This software was developed with the support of +// Prof. Gustavo Sutter and Prof. Sergio Lopez-Buedo and +// University of Cambridge Computer Laboratory NetFPGA team. +// +// @NETFPGA_LICENSE_HEADER_START@ +// +// Licensed to NetFPGA C.I.C. (NetFPGA) under one or more +// contributor license agreements. See the NOTICE file distributed with this +// work for additional information regarding copyright ownership. NetFPGA +// licenses this file to you under the NetFPGA Hardware-Software License, +// Version 1.0 (the "License"); you may not use this file except in compliance +// with the License. You may obtain a copy of the License at: +// +// http://www.netfpga-cic.org +// +// Unless required by applicable law or agreed to in writing, Work distributed +// under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR +// CONDITIONS OF ANY KIND, either express or implied. See the License for the +// specific language governing permissions and limitations under the License. +// +// @NETFPGA_LICENSE_HEADER_END@ + +////////////////////////////////////////////////////////////////////////////// +////////////////////////////////////////////////////////////////////////////// +`timescale 1ns / 1ps +//`default_nettype none + +module xgmii2axis ( + + // Clks and resets + input clk, + input rst, + + // Stats + output reg [31:0] good_frames, + output reg [31:0] bad_frames, + + // Conf vectors + input [79:0] configuration_vector, + + // XGMII + input [63:0] xgmii_d, + input [7:0] xgmii_c, + + // AXIS + input aresetn, + output reg [63:0] tdata, + output reg [7:0] tkeep, + output reg tvalid, + output reg tlast, + output reg [0:0] tuser + ); + + `include "xgmii_includes.vh" + // localparam + localparam SRES = 8'b00000001; + localparam IDLE = 8'b00000010; + localparam ST_LANE0 = 8'b00000100; + localparam ST_LANE4 = 8'b00001000; + localparam FIN = 8'b00010000; + localparam D_LANE4 = 8'b00100000; + localparam FINL4 = 8'b01000000; + localparam s7 = 8'b10000000; + + //------------------------------------------------------- + // Local output + //------------------------------------------------------- + reg synch; + wire inv_aresetn; + + //------------------------------------------------------- + // Local adapter + //------------------------------------------------------- + reg [7:0] fsm = 'b1; + reg [63:0] tdata_i; + reg [7:0] tkeep_i; + reg [7:0] last_tkeep_i; + reg tvalid_i; + reg tlast_i; + reg [0:0] tuser_i; + reg [63:0] tdata_d0; + reg tvalid_d0; + wire [63:0] d; + wire [7:0] c; + reg [63:0] d_reg; + reg [7:0] c_reg; + reg inbound_frame; + reg [15:0] len; + reg [31:0] aux_dw; + reg chk_tchar; + + //------------------------------------------------------- + // Local CRC32 + //------------------------------------------------------- + reg [31:0] crc_32; + reg [31:0] crc_32_7B; + reg [31:0] crc_32_6B; + reg [31:0] crc_32_5B; + reg [31:0] crc_32_4B; + reg [31:0] crc_32_3B; + reg [31:0] crc_32_2B; + reg [31:0] crc_32_1B; + reg [31:0] rcved_crc; + reg [31:0] calcted_crc; + + //------------------------------------------------------- + // assigns + //------------------------------------------------------- + assign d = xgmii_d; + assign c = xgmii_c; + assign inv_aresetn = ~aresetn; + + //////////////////////////////////////////////// + // output + //////////////////////////////////////////////// + always @(posedge clk) begin + + if (inv_aresetn) begin // aresetn + tvalid <= 1'b0; + synch <= 1'b0; + end + + else begin // not aresetn + + if (!inbound_frame || synch) begin + synch <= 1'b1; + tdata <= tdata_i; + tkeep <= tkeep_i; + tvalid <= tvalid_i; + tlast <= tlast_i; + tuser <= tuser_i; + end + else begin + tvalid <= 1'b0; + end + + end // not aresetn + end //always + + //////////////////////////////////////////////// + // adapter + //////////////////////////////////////////////// + always @(posedge clk) begin + + if (rst) begin // rst + tvalid_i <= 1'b0; + tvalid_d0 <= 1'b0; + fsm <= SRES; + end + + else begin // not rst + + if (tvalid && tlast && tuser[0]) begin + good_frames <= good_frames + 1; + end + + if (tvalid && tlast && ~tuser[0]) begin + bad_frames <= bad_frames + 1; + end + + tdata_i <= tdata_d0; + tvalid_i <= tvalid_d0; + + case (fsm) + + SRES : begin + good_frames <= 'b0; + bad_frames <= 'b0; + fsm <= IDLE; + end + + IDLE : begin + tvalid_d0 <= 1'b0; + tlast_i <= 1'b0; + tuser_i <= 'b0; + crc_32 <= CRC802_3_PRESET; + inbound_frame <= 1'b0; + d_reg <= d; + c_reg <= c; + len <= 0; + if (sof_lane0(d,c)) begin + inbound_frame <= 1'b1; + fsm <= ST_LANE0; + end + else if (sof_lane4(d,c)) begin + inbound_frame <= 1'b1; + fsm <= ST_LANE4; + end + end + + ST_LANE0 : begin + tdata_d0 <= d; + tvalid_d0 <= 1'b1; + tkeep_i <= 8'hFF; + tlast_i <= 1'b0; + tuser_i <= 'b0; + d_reg <= d; + c_reg <= c; + crc_32 <= crc8B(crc_32,d); + crc_32_7B <= crc7B(crc_32,d[55:0]); + crc_32_6B <= crc6B(crc_32,d[47:0]); + crc_32_5B <= crc5B(crc_32,d[39:0]); + crc_32_4B <= crc4B(crc_32,d[31:0]); + + case (c) + 8'h0 : begin + len <= len + 8; + end + 8'hFF : begin + len <= len; + tkeep_i <= 8'h0F; + tvalid_d0 <= 1'b0; + tlast_i <= 1'b1; + if ((~crc_rev(crc_32_4B) == d_reg[63:32]) && is_tchar(d[7:0])) begin + tuser_i[0] <= 1'b1; + end + fsm <= IDLE; + end + 8'hFE : begin + len <= len + 1; + tkeep_i <= 8'h1F; + tvalid_d0 <= 1'b0; + tlast_i <= 1'b1; + if ((~crc_rev(crc_32_5B) == {d[7:0], d_reg[63:40]}) && is_tchar(d[15:8])) begin + tuser_i[0] <= 1'b1; + end + fsm <= IDLE; + end + 8'hFC : begin + len <= len + 2; + tkeep_i <= 8'h3F; + tvalid_d0 <= 1'b0; + tlast_i <= 1'b1; + if ((~crc_rev(crc_32_6B) == {d[15:0], d_reg[63:48]}) && is_tchar(d[23:16])) begin + tuser_i[0] <= 1'b1; + end + fsm <= IDLE; + end + 8'hF8 : begin + len <= len + 3; + tkeep_i <= 8'h7F; + tvalid_d0 <= 1'b0; + tlast_i <= 1'b1; + if ((~crc_rev(crc_32_7B) == {d[23:0], d_reg[63:56]}) && is_tchar(d[31:24])) begin + tuser_i[0] <= 1'b1; + end + fsm <= IDLE; + end + 8'hF0 : begin + len <= len + 4; + tvalid_d0 <= 1'b0; + tlast_i <= 1'b1; + if ((~crc_rev(crc_32) == d[31:0]) && is_tchar(d[39:32])) begin + tuser_i[0] <= 1'b1; + end + fsm <= IDLE; + end + 8'hE0 : begin + len <= len + 5; + last_tkeep_i <= 8'h01; + rcved_crc <= d[39:8]; + calcted_crc <= crc1B(crc_32,d[7:0]); + chk_tchar <= is_tchar(d[47:40]); + fsm <= FIN; + end + 8'hC0 : begin + len <= len + 6; + last_tkeep_i <= 8'h03; + rcved_crc <= d[47:16]; + calcted_crc <= crc2B(crc_32,d[15:0]); + chk_tchar <= is_tchar(d[55:48]); + fsm <= FIN; + end + 8'h80 : begin + len <= len + 7; + last_tkeep_i <= 8'h07; + rcved_crc <= d[55:24]; + calcted_crc <= crc3B(crc_32,d[23:0]); + chk_tchar <= is_tchar(d[63:56]); + fsm <= FIN; + end + default : begin + tlast_i <= 1'b1; + tvalid_d0 <= 1'b0; + tvalid_i <= 1'b1; + fsm <= IDLE; + end + endcase + end + + FIN : begin + tkeep_i <= last_tkeep_i; + tlast_i <= 1'b1; + tvalid_d0 <= 1'b0; + crc_32 <= CRC802_3_PRESET; + if ((~crc_rev(calcted_crc) == rcved_crc) && chk_tchar) begin + tuser_i[0] <= 1'b1; + end + if (sof_lane4(d,c)) begin + fsm <= ST_LANE4; + end + else begin + fsm <= IDLE; + end + end + + ST_LANE4 : begin + len <= 4; + tlast_i <= 1'b0; + tuser_i <= 'b0; + crc_32 <= crc4B(crc_32,d[63:32]); + aux_dw <= d[63:32]; + if (!c) begin + fsm <= D_LANE4; + end + else begin + fsm <= IDLE; + end + end + + D_LANE4 : begin + tdata_d0 <= {d[31:0], aux_dw}; + tvalid_d0 <= 1'b1; + tkeep_i <= 8'hFF; + aux_dw <= d[63:32]; + d_reg <= d; + c_reg <= c; + crc_32 <= crc8B(crc_32,d); + crc_32_4B <= crc4B(crc_32,d[31:0]); + crc_32_5B <= crc5B(crc_32,d[39:0]); + crc_32_6B <= crc6B(crc_32,d[47:0]); + crc_32_7B <= crc7B(crc_32,d[55:0]); + + case (c) + 8'h0 : begin + len <= len + 8; + end + 8'hFF : begin + len <= len; + tvalid_d0 <= 1'b0; + tlast_i <= 1'b1; + if ((~crc_rev(crc_32_4B) == d_reg[63:32]) && is_tchar(d[7:0])) begin + tuser_i[0] <= 1'b1; + end + fsm <= IDLE; + end + 8'hFE : begin + len <= len + 1; + last_tkeep_i <= 8'h01; + rcved_crc <= {d[7:0], aux_dw[31:8]}; + calcted_crc <= crc_32_5B; + chk_tchar <= is_tchar(d[15:8]); + fsm <= FINL4; + end + 8'hFC : begin + len <= len + 2; + last_tkeep_i <= 8'h03; + rcved_crc <= {d[15:0], aux_dw[31:16]}; + calcted_crc <= crc_32_6B; + chk_tchar <= is_tchar(d[23:16]); + fsm <= FINL4; + end + 8'hF8 : begin + len <= len + 3; + last_tkeep_i <= 8'h07; + rcved_crc <= {d[23:0], aux_dw[31:24]}; + calcted_crc <= crc_32_7B; + chk_tchar <= is_tchar(d[31:24]); + fsm <= FINL4; + end + 8'hF0 : begin + len <= len + 4; + last_tkeep_i <= 8'h0F; + rcved_crc <= d[31:0]; + calcted_crc <= crc_32; + chk_tchar <= is_tchar(d[39:32]); + fsm <= FIN; + end + 8'hE0 : begin + len <= len + 5; + last_tkeep_i <= 8'h1F; + rcved_crc <= d[39:8]; + calcted_crc <= crc1B(crc_32,d[7:0]); + chk_tchar <= is_tchar(d[47:40]); + fsm <= FIN; + end + 8'hC0 : begin + len <= len + 6; + last_tkeep_i <= 8'h3F; + rcved_crc <= d[47:16]; + calcted_crc <= crc2B(crc_32,d[15:0]); + chk_tchar <= is_tchar(d[55:48]); + fsm <= FIN; + end + 8'h80 : begin + len <= len + 7; + last_tkeep_i <= 8'h7F; + rcved_crc <= d[55:24]; + calcted_crc <= crc3B(crc_32,d[23:0]); + chk_tchar <= is_tchar(d[63:56]); + fsm <= FIN; + end + default : begin + tlast_i <= 1'b1; + tvalid_d0 <= 1'b0; + tvalid_i <= 1'b1; + fsm <= IDLE; + end + endcase + end + + FINL4 : begin + len <= 0; + tkeep_i <= last_tkeep_i; + tlast_i <= 1'b1; + tvalid_d0 <= 1'b0; + crc_32 <= CRC802_3_PRESET; + if ((~crc_rev(calcted_crc) == rcved_crc) && chk_tchar) begin + tuser_i[0] <= 1'b1; + end + if (sof_lane0(d,c)) begin + fsm <= ST_LANE0; + end + else if (sof_lane4(d,c)) begin + fsm <= ST_LANE4; + end + else begin + fsm <= IDLE; + end + end + + default : begin + fsm <= IDLE; + end + + endcase + end // not rst + end //always + +endmodule // xgmii2axis + +////////////////////////////////////////////////////////////////////////////// +////////////////////////////////////////////////////////////////////////////// \ No newline at end of file diff --git a/hdl_cores/freedom/fpga-shells/vsrc/nfmac10g/xgmii_includes.vh b/hdl_cores/freedom/fpga-shells/vsrc/nfmac10g/xgmii_includes.vh new file mode 100644 index 0000000..50c4a81 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/vsrc/nfmac10g/xgmii_includes.vh @@ -0,0 +1,494 @@ +// +// Copyright (c) 2016 University of Cambridge All rights reserved. +// +// Author: Marco Forconesi +// +// This software was developed with the support of +// Prof. Gustavo Sutter and Prof. Sergio Lopez-Buedo and +// University of Cambridge Computer Laboratory NetFPGA team. +// +// @NETFPGA_LICENSE_HEADER_START@ +// +// Licensed to NetFPGA C.I.C. (NetFPGA) under one or more +// contributor license agreements. See the NOTICE file distributed with this +// work for additional information regarding copyright ownership. NetFPGA +// licenses this file to you under the NetFPGA Hardware-Software License, +// Version 1.0 (the "License"); you may not use this file except in compliance +// with the License. You may obtain a copy of the License at: +// +// http://www.netfpga-cic.org +// +// Unless required by applicable law or agreed to in writing, Work distributed +// under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR +// CONDITIONS OF ANY KIND, either express or implied. See the License for the +// specific language governing permissions and limitations under the License. +// +// @NETFPGA_LICENSE_HEADER_END@ + +////////////////////////////////////////////////////////////////////////////// +////////////////////////////////////////////////////////////////////////////// + + // XGMII characters + localparam S = 8'hFB; + localparam T = 8'hFD; + localparam E = 8'hFE; + localparam I = 8'h07; + + localparam PREAMBLE_LANE0_D = {56'hD5555555555555, S}; + localparam PREAMBLE_LANE0_C = 8'h01; + + localparam PREAMBLE_LANE4_D = {24'h555555, S, {4{I}}}; + localparam PREAMBLE_LANE4_C = 8'h1F; + + localparam PREAMBLE_LANE4_END_D = 32'hD5555555; + localparam PREAMBLE_LANE4_END_C = 8'b0; + + localparam QW_IDLE_D = {8{I}}; + localparam QW_IDLE_C = 8'hFF; + + localparam XGMII_ERROR_L0_D = E; + localparam XGMII_ERROR_L0_C = 8'h01; + + localparam XGMII_ERROR_L4_D = E; + localparam XGMII_ERROR_L4_C = 8'h10; + + localparam CRC802_3_PRESET = 32'hFFFFFFFF; + + //////////////////////////////////////////////// + // sof_lane0 + //////////////////////////////////////////////// + function sof_lane0 ( + input [63:0] xgmii_d, + input [7:0] xgmii_c + ); + begin + if ((xgmii_d[7:0] == S) && xgmii_c[0]) + sof_lane0 = 1'b1; + else + sof_lane0 = 1'b0; + end + endfunction // sof_lane0 + + //////////////////////////////////////////////// + // sof_lane4 + //////////////////////////////////////////////// + function sof_lane4 ( + input [63:0] xgmii_d, + input [7:0] xgmii_c + ); + begin + if ((xgmii_d[39:32] == S) && xgmii_c[4]) + sof_lane4 = 1'b1; + else + sof_lane4 = 1'b0; + end + endfunction // sof_lane4 + + //////////////////////////////////////////////// + // crc_rev + //////////////////////////////////////////////// + function [31:0] crc_rev ( + input [31:0] crc + ); + integer i; + reg [31:0] o; + begin + for (i = 0; i < 32; i = i + 1) begin + o[i] = crc[31-i]; + end + crc_rev = o; + end + endfunction // crc_rev + + //////////////////////////////////////////////// + // byte_rev + //////////////////////////////////////////////// + function [7:0] byte_rev ( + input [7:0] b + ); + integer i; + reg [7:0] o; + begin + for (i = 0; i < 8; i = i + 1) begin + o[i] = b[7-i]; + end + byte_rev = o; + end + endfunction // byte_rev + + //////////////////////////////////////////////// + // is_tchar + //////////////////////////////////////////////// + function is_tchar ( + input [7:0] bytez + ); + begin + if (bytez == T) + is_tchar = 1'b1; + else + is_tchar = 1'b0; + end + endfunction // is_tchar + + //////////////////////////////////////////////// + // crc8B + //////////////////////////////////////////////// + function [31:0] crc8B ( + input [31:0] c, + input [63:0] d + ); + reg [31:0] o; + begin +o[0] = d[15] ^ c[12] ^ d[63] ^ d[47] ^ d[39] ^ d[5] ^ d[32] ^ c[28] ^ d[16] ^ c[21] ^ c[13] ^ c[0] ^ d[33] ^ c[29] ^ c[22] ^ d[10] ^ d[57] ^ d[34] ^ d[0] ^ d[26] ^ c[31] ^ d[18] ^ c[23] ^ c[15] ^ d[51] ^ c[2] ^ d[8] ^ d[35] ^ d[19] ^ c[16] ^ d[9] ^ d[2] ^ d[13] ^ d[53] ^ d[37] ^ d[3] ^ d[29] ^ c[26] ^ c[18] ^ d[54] ^ c[5] ^ d[38] ^ d[31] ; +o[1] = c[27] ^ c[19] ^ c[12] ^ d[63] ^ c[6] ^ d[47] ^ d[39] ^ d[5] ^ c[28] ^ d[16] ^ c[21] ^ d[56] ^ d[25] ^ c[30] ^ d[17] ^ d[10] ^ c[14] ^ d[57] ^ d[50] ^ c[1] ^ d[7] ^ d[0] ^ d[26] ^ c[31] ^ c[15] ^ d[51] ^ c[2] ^ d[35] ^ d[1] ^ d[19] ^ d[12] ^ c[24] ^ d[52] ^ c[3] ^ d[36] ^ d[28] ^ d[13] ^ c[17] ^ d[3] ^ d[30] ^ d[29] ^ c[26] ^ d[14] ^ c[18] ^ d[62] ^ d[54] ^ c[5] ^ d[46] ^ d[4] ; +o[2] = c[27] ^ c[19] ^ c[20] ^ c[12] ^ d[63] ^ d[55] ^ c[6] ^ d[47] ^ d[39] ^ d[5] ^ d[32] ^ d[24] ^ c[21] ^ d[56] ^ c[7] ^ c[0] ^ d[33] ^ d[6] ^ d[25] ^ d[10] ^ d[57] ^ d[50] ^ d[49] ^ d[26] ^ d[11] ^ c[23] ^ d[8] ^ d[27] ^ d[19] ^ d[12] ^ c[3] ^ d[28] ^ c[25] ^ d[61] ^ d[45] ^ c[4] ^ d[37] ^ c[26] ^ d[62] ^ d[54] ^ c[5] ^ d[46] ^ d[4] ^ d[31] ; +o[3] = d[23] ^ c[27] ^ c[20] ^ d[55] ^ c[6] ^ d[32] ^ d[5] ^ d[24] ^ c[28] ^ c[21] ^ c[13] ^ d[56] ^ c[7] ^ d[48] ^ c[0] ^ d[25] ^ d[10] ^ c[22] ^ c[8] ^ d[49] ^ c[1] ^ d[7] ^ d[26] ^ d[18] ^ d[11] ^ d[27] ^ c[24] ^ d[60] ^ d[44] ^ d[9] ^ d[36] ^ d[61] ^ d[53] ^ c[4] ^ d[45] ^ d[3] ^ d[30] ^ c[26] ^ d[62] ^ d[54] ^ c[5] ^ d[46] ^ d[38] ^ d[4] ^ d[31] ; +o[4] = d[23] ^ d[15] ^ c[27] ^ c[12] ^ d[63] ^ d[55] ^ c[6] ^ d[39] ^ d[5] ^ d[32] ^ d[24] ^ d[16] ^ c[13] ^ c[7] ^ d[48] ^ d[33] ^ d[6] ^ d[25] ^ d[17] ^ c[14] ^ d[57] ^ c[8] ^ c[1] ^ d[34] ^ d[0] ^ c[31] ^ d[18] ^ c[15] ^ d[51] ^ c[9] ^ d[43] ^ d[19] ^ c[16] ^ d[60] ^ d[59] ^ d[52] ^ d[44] ^ c[25] ^ d[13] ^ d[61] ^ d[45] ^ d[30] ^ d[22] ^ c[26] ^ c[18] ^ d[38] ^ d[4] ; +o[5] = d[23] ^ c[27] ^ c[19] ^ c[12] ^ d[63] ^ d[39] ^ d[24] ^ c[21] ^ d[56] ^ c[7] ^ c[29] ^ d[17] ^ c[22] ^ d[10] ^ c[14] ^ d[57] ^ c[8] ^ d[50] ^ d[42] ^ d[34] ^ d[0] ^ d[26] ^ c[31] ^ c[23] ^ d[58] ^ c[9] ^ d[43] ^ d[8] ^ d[35] ^ d[19] ^ d[12] ^ d[60] ^ d[59] ^ d[44] ^ d[9] ^ d[2] ^ d[21] ^ d[13] ^ c[17] ^ c[10] ^ d[53] ^ d[22] ^ d[14] ^ c[18] ^ d[62] ^ c[5] ^ d[4] ; +o[6] = d[23] ^ c[20] ^ c[19] ^ d[55] ^ c[6] ^ d[16] ^ c[28] ^ c[13] ^ d[56] ^ d[41] ^ d[33] ^ d[25] ^ c[30] ^ c[22] ^ d[57] ^ c[8] ^ d[49] ^ d[42] ^ d[7] ^ d[34] ^ d[18] ^ c[23] ^ d[11] ^ c[15] ^ d[58] ^ c[9] ^ d[43] ^ d[8] ^ d[1] ^ d[20] ^ c[24] ^ d[12] ^ d[59] ^ d[52] ^ d[9] ^ d[21] ^ d[13] ^ c[10] ^ d[61] ^ d[3] ^ d[22] ^ c[18] ^ c[11] ^ d[62] ^ d[38] ; +o[7] = c[19] ^ c[20] ^ d[63] ^ d[55] ^ d[47] ^ d[39] ^ d[40] ^ d[5] ^ d[24] ^ c[28] ^ d[16] ^ c[13] ^ d[56] ^ c[7] ^ d[48] ^ d[41] ^ c[0] ^ d[6] ^ d[17] ^ c[22] ^ c[14] ^ d[42] ^ d[7] ^ d[34] ^ d[26] ^ d[18] ^ d[11] ^ c[15] ^ d[58] ^ c[9] ^ c[2] ^ d[35] ^ d[20] ^ d[12] ^ c[24] ^ d[60] ^ d[9] ^ d[21] ^ c[25] ^ d[13] ^ c[10] ^ d[61] ^ d[53] ^ d[3] ^ d[29] ^ d[22] ^ c[26] ^ c[18] ^ c[11] ^ c[5] ^ d[38] ^ d[31] ; +o[8] = d[23] ^ c[27] ^ c[19] ^ c[20] ^ d[63] ^ d[55] ^ c[6] ^ d[40] ^ d[32] ^ c[28] ^ c[13] ^ d[41] ^ c[0] ^ d[6] ^ d[25] ^ d[17] ^ c[22] ^ c[14] ^ c[8] ^ c[1] ^ d[0] ^ d[26] ^ c[31] ^ d[18] ^ d[11] ^ d[51] ^ c[2] ^ d[35] ^ d[20] ^ d[12] ^ d[60] ^ d[59] ^ d[52] ^ c[3] ^ d[9] ^ d[28] ^ d[21] ^ c[25] ^ d[13] ^ c[10] ^ d[53] ^ d[3] ^ d[30] ^ d[29] ^ c[18] ^ c[11] ^ d[62] ^ c[5] ^ d[46] ^ d[4] ^ d[31] ; +o[9] = c[20] ^ c[19] ^ c[12] ^ c[6] ^ d[40] ^ d[39] ^ d[5] ^ d[24] ^ d[16] ^ c[28] ^ c[21] ^ c[7] ^ c[0] ^ d[25] ^ c[29] ^ d[17] ^ d[10] ^ c[14] ^ d[50] ^ c[1] ^ d[34] ^ c[23] ^ d[11] ^ c[15] ^ d[58] ^ c[9] ^ d[51] ^ c[2] ^ d[8] ^ d[27] ^ d[20] ^ d[19] ^ d[12] ^ d[59] ^ d[52] ^ c[3] ^ d[2] ^ d[28] ^ d[61] ^ c[4] ^ d[45] ^ d[3] ^ d[29] ^ d[30] ^ d[22] ^ c[26] ^ c[11] ^ d[62] ^ d[54] ^ d[31] ; +o[10] = d[23] ^ c[27] ^ c[20] ^ d[63] ^ d[47] ^ d[5] ^ d[32] ^ d[24] ^ c[28] ^ c[7] ^ c[0] ^ c[30] ^ c[8] ^ d[49] ^ d[50] ^ c[1] ^ d[7] ^ d[34] ^ d[0] ^ c[31] ^ d[11] ^ c[23] ^ d[58] ^ d[8] ^ d[35] ^ d[27] ^ d[1] ^ c[24] ^ d[60] ^ c[3] ^ d[44] ^ d[28] ^ d[21] ^ d[13] ^ c[10] ^ d[61] ^ c[4] ^ d[37] ^ d[3] ^ d[30] ^ c[26] ^ c[18] ^ d[54] ^ d[4] ^ d[31] ; +o[11] = d[23] ^ d[15] ^ c[27] ^ c[19] ^ c[12] ^ d[63] ^ d[47] ^ d[39] ^ d[5] ^ d[32] ^ d[16] ^ c[13] ^ d[48] ^ d[6] ^ c[22] ^ c[8] ^ d[49] ^ c[1] ^ d[7] ^ d[18] ^ c[23] ^ c[15] ^ d[51] ^ c[9] ^ d[43] ^ d[8] ^ d[35] ^ d[27] ^ d[20] ^ d[19] ^ d[12] ^ c[24] ^ c[16] ^ d[60] ^ d[59] ^ d[9] ^ d[36] ^ c[25] ^ d[13] ^ c[4] ^ d[37] ^ d[30] ^ d[22] ^ c[26] ^ c[18] ^ c[11] ^ d[62] ^ d[54] ^ d[46] ^ d[38] ^ d[4] ; +o[12] = c[27] ^ c[19] ^ c[20] ^ d[63] ^ d[39] ^ d[32] ^ d[16] ^ c[21] ^ d[48] ^ d[33] ^ d[6] ^ c[29] ^ d[17] ^ c[22] ^ d[10] ^ c[14] ^ d[57] ^ d[50] ^ d[42] ^ d[7] ^ d[0] ^ c[31] ^ d[11] ^ c[15] ^ d[58] ^ d[51] ^ c[9] ^ d[12] ^ c[24] ^ d[59] ^ d[9] ^ d[36] ^ d[2] ^ d[21] ^ c[25] ^ d[13] ^ c[17] ^ c[10] ^ d[61] ^ d[45] ^ d[22] ^ d[14] ^ c[18] ^ d[62] ^ d[54] ^ d[46] ^ d[4] ; +o[13] = d[15] ^ c[20] ^ c[19] ^ d[47] ^ d[32] ^ d[5] ^ d[16] ^ c[28] ^ c[21] ^ d[56] ^ d[41] ^ c[0] ^ d[6] ^ c[30] ^ d[10] ^ c[22] ^ d[57] ^ d[50] ^ d[49] ^ c[23] ^ d[11] ^ c[15] ^ d[58] ^ d[8] ^ d[35] ^ d[1] ^ d[20] ^ d[12] ^ c[16] ^ d[60] ^ d[44] ^ d[9] ^ d[21] ^ c[25] ^ d[13] ^ c[10] ^ d[61] ^ d[53] ^ d[45] ^ d[3] ^ c[26] ^ c[18] ^ c[11] ^ d[62] ^ d[38] ^ d[31] ; +o[14] = c[27] ^ d[15] ^ c[19] ^ c[20] ^ c[12] ^ d[55] ^ d[40] ^ d[5] ^ c[21] ^ d[56] ^ d[48] ^ c[0] ^ c[29] ^ d[10] ^ c[22] ^ d[57] ^ d[49] ^ c[1] ^ d[7] ^ d[34] ^ d[0] ^ c[31] ^ d[11] ^ c[23] ^ d[43] ^ d[8] ^ d[19] ^ d[20] ^ c[24] ^ d[12] ^ c[16] ^ d[60] ^ d[59] ^ d[52] ^ d[44] ^ d[9] ^ d[2] ^ c[17] ^ d[61] ^ d[37] ^ d[30] ^ c[26] ^ d[14] ^ c[11] ^ d[46] ^ d[31] ^ d[4] ; +o[15] = c[27] ^ c[20] ^ c[12] ^ d[55] ^ d[47] ^ d[39] ^ c[28] ^ c[21] ^ c[13] ^ d[56] ^ d[48] ^ d[6] ^ d[33] ^ c[30] ^ c[22] ^ d[10] ^ d[42] ^ c[1] ^ d[7] ^ d[18] ^ c[23] ^ d[11] ^ d[58] ^ d[51] ^ c[2] ^ d[43] ^ d[8] ^ d[1] ^ d[19] ^ c[24] ^ d[60] ^ d[59] ^ d[36] ^ d[9] ^ c[25] ^ d[13] ^ c[17] ^ d[45] ^ d[30] ^ d[3] ^ d[29] ^ d[14] ^ c[18] ^ d[54] ^ d[4] ; +o[16] = d[15] ^ c[19] ^ c[12] ^ d[63] ^ d[55] ^ d[39] ^ d[16] ^ d[41] ^ c[0] ^ d[33] ^ d[6] ^ d[17] ^ c[14] ^ d[50] ^ d[42] ^ d[7] ^ d[34] ^ d[26] ^ c[15] ^ d[58] ^ d[51] ^ d[19] ^ d[12] ^ c[24] ^ c[16] ^ d[59] ^ c[3] ^ d[44] ^ d[28] ^ c[25] ^ d[37] ^ c[5] ^ d[46] ^ d[31] ; +o[17] = d[15] ^ c[20] ^ c[6] ^ d[40] ^ d[32] ^ d[5] ^ d[16] ^ c[13] ^ d[41] ^ d[6] ^ d[33] ^ d[25] ^ d[57] ^ d[50] ^ d[49] ^ c[1] ^ d[18] ^ d[11] ^ c[15] ^ d[58] ^ d[43] ^ d[27] ^ c[16] ^ d[36] ^ c[25] ^ c[17] ^ c[4] ^ d[45] ^ d[30] ^ d[14] ^ c[26] ^ d[62] ^ d[54] ^ d[38] ; +o[18] = c[27] ^ d[15] ^ d[40] ^ d[39] ^ d[5] ^ d[32] ^ d[24] ^ c[21] ^ d[56] ^ c[7] ^ d[48] ^ c[0] ^ d[17] ^ d[10] ^ c[14] ^ d[57] ^ d[49] ^ d[42] ^ d[26] ^ c[2] ^ d[35] ^ c[16] ^ d[44] ^ d[13] ^ c[17] ^ d[61] ^ d[53] ^ d[37] ^ d[29] ^ c[26] ^ d[14] ^ c[18] ^ c[5] ^ d[31] ^ d[4] ; +o[19] = d[23] ^ c[27] ^ c[19] ^ d[55] ^ c[6] ^ d[47] ^ d[39] ^ c[28] ^ d[16] ^ d[56] ^ d[48] ^ d[41] ^ c[0] ^ d[25] ^ c[22] ^ c[8] ^ c[1] ^ d[34] ^ c[15] ^ d[43] ^ d[12] ^ d[60] ^ d[52] ^ c[3] ^ d[36] ^ d[9] ^ d[28] ^ d[13] ^ c[17] ^ d[30] ^ d[3] ^ d[14] ^ c[18] ^ d[38] ^ d[4] ^ d[31] ; +o[20] = d[15] ^ c[20] ^ c[19] ^ d[55] ^ d[47] ^ d[40] ^ d[24] ^ c[28] ^ c[7] ^ d[33] ^ c[29] ^ c[1] ^ d[42] ^ d[11] ^ c[23] ^ c[9] ^ d[51] ^ c[2] ^ d[35] ^ d[8] ^ d[27] ^ d[12] ^ c[16] ^ d[59] ^ d[2] ^ d[13] ^ c[4] ^ d[37] ^ d[29] ^ d[3] ^ d[30] ^ d[22] ^ c[18] ^ d[54] ^ d[46] ^ d[38] ; +o[21] = d[23] ^ c[19] ^ c[20] ^ d[39] ^ d[32] ^ c[21] ^ d[41] ^ c[30] ^ c[29] ^ d[10] ^ c[8] ^ d[50] ^ d[34] ^ d[7] ^ d[26] ^ d[11] ^ d[58] ^ c[2] ^ d[1] ^ c[24] ^ d[12] ^ c[3] ^ d[36] ^ d[28] ^ d[2] ^ d[21] ^ c[17] ^ c[10] ^ d[53] ^ d[45] ^ d[37] ^ d[29] ^ d[14] ^ d[54] ^ d[46] ^ c[5] ; +o[22] = d[15] ^ c[20] ^ c[12] ^ d[63] ^ c[6] ^ d[47] ^ d[39] ^ d[40] ^ d[5] ^ d[32] ^ c[28] ^ d[16] ^ c[13] ^ d[6] ^ d[25] ^ c[29] ^ c[30] ^ d[49] ^ d[34] ^ d[26] ^ d[18] ^ d[11] ^ c[23] ^ c[15] ^ d[51] ^ c[9] ^ c[2] ^ d[8] ^ d[27] ^ d[1] ^ d[20] ^ d[19] ^ c[16] ^ d[52] ^ c[3] ^ d[44] ^ d[36] ^ d[2] ^ d[28] ^ c[25] ^ d[45] ^ c[4] ^ d[37] ^ d[3] ^ d[29] ^ d[22] ^ c[26] ^ c[11] ^ d[54] ^ c[5] ; +o[23] = c[27] ^ d[63] ^ c[6] ^ d[47] ^ d[32] ^ d[24] ^ c[28] ^ d[16] ^ c[7] ^ d[48] ^ d[25] ^ c[30] ^ d[17] ^ c[22] ^ c[14] ^ d[57] ^ d[50] ^ d[7] ^ d[34] ^ c[23] ^ c[15] ^ c[2] ^ d[43] ^ d[8] ^ d[27] ^ d[1] ^ c[24] ^ c[3] ^ d[44] ^ d[9] ^ d[36] ^ d[28] ^ d[21] ^ d[13] ^ c[17] ^ c[10] ^ c[4] ^ d[37] ^ d[3] ^ d[29] ^ d[14] ^ c[18] ^ d[62] ^ d[54] ^ d[46] ^ d[4] ; +o[24] = d[23] ^ d[15] ^ c[19] ^ d[47] ^ d[24] ^ d[16] ^ c[28] ^ d[56] ^ c[7] ^ c[0] ^ d[6] ^ d[33] ^ c[29] ^ c[8] ^ d[49] ^ d[42] ^ d[7] ^ d[26] ^ d[0] ^ c[31] ^ c[23] ^ c[15] ^ d[43] ^ d[8] ^ d[35] ^ d[27] ^ d[20] ^ c[24] ^ d[12] ^ c[16] ^ c[3] ^ d[36] ^ d[2] ^ d[28] ^ c[25] ^ d[13] ^ d[61] ^ d[53] ^ c[4] ^ d[45] ^ d[3] ^ c[18] ^ c[11] ^ d[62] ^ c[5] ^ d[46] ^ d[31] ; +o[25] = d[23] ^ d[15] ^ c[19] ^ c[20] ^ c[12] ^ d[55] ^ c[6] ^ d[5] ^ d[32] ^ d[48] ^ d[41] ^ d[6] ^ d[25] ^ c[30] ^ c[29] ^ c[8] ^ c[1] ^ d[42] ^ d[7] ^ d[34] ^ d[26] ^ d[11] ^ c[9] ^ d[35] ^ d[1] ^ d[27] ^ d[19] ^ c[24] ^ d[12] ^ c[16] ^ d[60] ^ d[52] ^ d[44] ^ d[2] ^ c[25] ^ c[17] ^ d[61] ^ c[4] ^ d[45] ^ d[30] ^ d[22] ^ c[26] ^ d[14] ^ d[46] ^ c[5] ; +o[26] = d[15] ^ c[27] ^ c[20] ^ c[12] ^ d[63] ^ c[6] ^ d[39] ^ d[40] ^ d[32] ^ d[24] ^ c[28] ^ d[16] ^ c[7] ^ d[41] ^ d[6] ^ d[25] ^ c[29] ^ c[30] ^ c[22] ^ d[57] ^ d[11] ^ c[23] ^ c[15] ^ c[9] ^ d[43] ^ d[8] ^ d[35] ^ d[1] ^ d[19] ^ c[16] ^ d[60] ^ d[59] ^ d[44] ^ d[9] ^ d[2] ^ d[21] ^ c[25] ^ c[17] ^ c[10] ^ d[53] ^ d[45] ^ d[37] ^ d[3] ^ d[22] ^ d[14] ^ d[38] ^ d[4] ; +o[27] = d[23] ^ d[15] ^ d[40] ^ d[39] ^ d[5] ^ d[24] ^ c[28] ^ c[21] ^ c[13] ^ d[56] ^ c[7] ^ c[0] ^ c[29] ^ c[30] ^ d[10] ^ c[8] ^ d[42] ^ d[7] ^ d[34] ^ d[0] ^ c[31] ^ d[18] ^ c[23] ^ d[58] ^ d[43] ^ d[8] ^ d[1] ^ d[20] ^ c[24] ^ c[16] ^ d[59] ^ d[52] ^ d[44] ^ d[36] ^ d[2] ^ d[21] ^ d[13] ^ c[17] ^ c[10] ^ d[37] ^ d[3] ^ d[14] ^ c[26] ^ c[18] ^ c[11] ^ d[62] ^ d[38] ^ d[31] ; +o[28] = d[23] ^ c[27] ^ c[19] ^ c[12] ^ d[55] ^ d[39] ^ d[41] ^ d[6] ^ d[33] ^ c[30] ^ c[29] ^ d[17] ^ c[22] ^ c[14] ^ d[57] ^ c[8] ^ c[1] ^ d[42] ^ d[7] ^ d[0] ^ c[31] ^ d[58] ^ c[9] ^ d[51] ^ d[43] ^ d[35] ^ d[1] ^ d[19] ^ d[20] ^ c[24] ^ d[12] ^ d[9] ^ d[36] ^ d[2] ^ d[13] ^ c[25] ^ c[17] ^ d[61] ^ d[37] ^ d[30] ^ d[22] ^ d[14] ^ c[18] ^ c[11] ^ d[38] ^ d[4] ; +o[29] = c[19] ^ c[20] ^ c[12] ^ d[40] ^ d[5] ^ d[32] ^ c[28] ^ d[16] ^ c[13] ^ d[56] ^ d[41] ^ d[6] ^ c[30] ^ d[57] ^ d[50] ^ d[42] ^ d[34] ^ d[0] ^ d[18] ^ c[31] ^ c[23] ^ d[11] ^ c[15] ^ c[9] ^ c[2] ^ d[8] ^ d[35] ^ d[1] ^ d[19] ^ d[12] ^ d[60] ^ d[36] ^ d[21] ^ c[25] ^ d[13] ^ c[10] ^ d[37] ^ d[3] ^ d[29] ^ d[22] ^ c[26] ^ c[18] ^ d[54] ^ d[38] ; +o[30] = c[27] ^ d[15] ^ c[20] ^ c[19] ^ d[55] ^ d[40] ^ d[39] ^ d[5] ^ c[21] ^ c[13] ^ d[56] ^ d[41] ^ c[0] ^ d[33] ^ d[17] ^ c[29] ^ d[10] ^ c[14] ^ d[49] ^ d[7] ^ d[34] ^ d[0] ^ c[31] ^ d[18] ^ d[11] ^ d[35] ^ d[20] ^ c[24] ^ d[12] ^ c[16] ^ d[59] ^ c[3] ^ d[36] ^ d[2] ^ d[28] ^ d[21] ^ c[10] ^ d[53] ^ d[37] ^ c[26] ^ c[11] ^ d[4] ^ d[31] ; +o[31] = c[27] ^ c[20] ^ c[12] ^ d[55] ^ d[40] ^ d[39] ^ d[32] ^ d[16] ^ c[28] ^ c[21] ^ d[48] ^ d[6] ^ d[33] ^ c[30] ^ d[17] ^ d[10] ^ c[22] ^ c[14] ^ c[1] ^ d[34] ^ d[11] ^ c[15] ^ d[58] ^ d[35] ^ d[1] ^ d[27] ^ d[19] ^ d[20] ^ d[52] ^ d[9] ^ d[36] ^ c[25] ^ c[17] ^ c[4] ^ d[3] ^ d[30] ^ d[14] ^ c[11] ^ d[54] ^ d[38] ^ d[4] ; + crc8B = o; + end + endfunction // crc8B + + //////////////////////////////////////////////// + // crc7B + //////////////////////////////////////////////// + function [31:0] crc7B ( + input [31:0] c, + input [55:0] d + ); + reg [31:0] o; + begin +o[0] = d[23] ^ c[20] ^ d[55] ^ c[6] ^ d[39] ^ d[5] ^ d[24] ^ c[21] ^ c[13] ^ c[7] ^ c[0] ^ d[25] ^ c[30] ^ c[29] ^ d[10] ^ d[49] ^ c[8] ^ c[1] ^ d[7] ^ d[0] ^ d[26] ^ c[31] ^ d[18] ^ d[11] ^ c[23] ^ d[43] ^ c[2] ^ d[8] ^ d[1] ^ d[27] ^ c[24] ^ d[2] ^ d[21] ^ c[10] ^ c[4] ^ d[45] ^ d[30] ^ d[29] ^ c[26] ^ d[46] ^ c[5] ^ d[31] ; +o[1] = c[27] ^ c[20] ^ d[55] ^ d[39] ^ d[5] ^ c[13] ^ d[48] ^ c[0] ^ d[6] ^ c[29] ^ d[17] ^ c[22] ^ c[14] ^ d[49] ^ d[42] ^ d[18] ^ d[11] ^ c[23] ^ c[9] ^ d[43] ^ d[8] ^ d[27] ^ d[20] ^ c[3] ^ d[44] ^ d[9] ^ d[2] ^ d[28] ^ d[21] ^ c[25] ^ c[10] ^ c[4] ^ d[22] ^ c[26] ^ c[11] ^ d[54] ^ d[46] ^ d[38] ^ d[31] ^ d[4] ; +o[2] = d[23] ^ c[27] ^ c[20] ^ c[12] ^ d[55] ^ c[6] ^ d[47] ^ d[39] ^ d[24] ^ c[28] ^ d[16] ^ c[13] ^ c[7] ^ d[48] ^ c[0] ^ d[41] ^ d[25] ^ c[29] ^ d[17] ^ c[14] ^ d[49] ^ c[8] ^ d[42] ^ d[0] ^ c[31] ^ d[18] ^ d[11] ^ c[15] ^ c[2] ^ d[19] ^ d[20] ^ d[2] ^ d[53] ^ d[37] ^ d[3] ^ d[29] ^ c[11] ^ d[54] ^ d[46] ^ d[38] ^ d[31] ^ d[4] ; +o[3] = d[23] ^ d[15] ^ c[12] ^ d[47] ^ d[40] ^ d[24] ^ c[28] ^ d[16] ^ c[21] ^ c[13] ^ d[48] ^ c[7] ^ d[41] ^ c[29] ^ c[30] ^ d[17] ^ d[10] ^ c[14] ^ c[8] ^ c[1] ^ d[18] ^ c[15] ^ c[9] ^ d[1] ^ d[19] ^ c[16] ^ d[52] ^ c[3] ^ d[36] ^ d[2] ^ d[28] ^ d[53] ^ d[45] ^ d[37] ^ d[30] ^ d[3] ^ d[22] ^ d[54] ^ d[46] ^ d[38] ; +o[4] = d[15] ^ c[20] ^ d[55] ^ c[6] ^ d[47] ^ d[40] ^ d[5] ^ d[24] ^ d[16] ^ c[21] ^ c[7] ^ c[0] ^ d[25] ^ d[17] ^ d[10] ^ c[22] ^ c[14] ^ d[49] ^ c[1] ^ d[7] ^ d[26] ^ d[11] ^ c[23] ^ c[15] ^ c[9] ^ d[51] ^ d[43] ^ d[8] ^ d[35] ^ c[24] ^ c[16] ^ d[52] ^ d[44] ^ d[9] ^ d[36] ^ c[17] ^ d[53] ^ d[37] ^ d[30] ^ d[22] ^ c[26] ^ d[14] ^ c[5] ^ d[31] ; +o[5] = c[27] ^ d[15] ^ c[20] ^ d[55] ^ d[5] ^ d[16] ^ c[13] ^ d[48] ^ c[0] ^ d[6] ^ c[30] ^ c[29] ^ c[22] ^ d[49] ^ d[50] ^ d[42] ^ d[34] ^ d[0] ^ d[26] ^ c[31] ^ d[18] ^ d[11] ^ c[15] ^ d[51] ^ d[35] ^ d[1] ^ d[27] ^ c[16] ^ d[52] ^ d[9] ^ d[36] ^ d[2] ^ d[13] ^ c[25] ^ c[17] ^ c[4] ^ d[45] ^ c[26] ^ d[14] ^ c[18] ^ d[54] ^ c[5] ^ d[31] ^ d[4] ; +o[6] = d[15] ^ c[27] ^ c[19] ^ c[6] ^ d[47] ^ d[5] ^ c[28] ^ c[21] ^ d[48] ^ d[41] ^ d[33] ^ d[25] ^ c[30] ^ d[17] ^ d[10] ^ c[14] ^ d[50] ^ d[49] ^ c[1] ^ d[34] ^ d[0] ^ d[26] ^ c[31] ^ c[23] ^ d[51] ^ d[8] ^ d[35] ^ d[1] ^ d[12] ^ c[16] ^ d[44] ^ d[13] ^ c[17] ^ d[53] ^ d[30] ^ d[3] ^ c[26] ^ d[14] ^ c[18] ^ d[54] ^ c[5] ^ d[4] ; +o[7] = d[23] ^ c[27] ^ c[19] ^ d[55] ^ d[47] ^ d[40] ^ d[39] ^ d[5] ^ d[32] ^ c[28] ^ d[16] ^ c[21] ^ c[13] ^ d[48] ^ c[0] ^ d[33] ^ c[30] ^ d[10] ^ c[22] ^ c[8] ^ d[50] ^ c[1] ^ d[34] ^ d[26] ^ d[18] ^ c[23] ^ c[15] ^ d[8] ^ d[1] ^ d[27] ^ d[12] ^ d[52] ^ d[9] ^ d[21] ^ d[13] ^ c[17] ^ c[10] ^ d[53] ^ c[4] ^ d[45] ^ d[3] ^ d[30] ^ c[26] ^ d[14] ^ c[18] ^ c[5] ^ d[31] ^ d[4] ; +o[8] = d[23] ^ c[27] ^ d[15] ^ c[19] ^ d[55] ^ d[47] ^ d[5] ^ d[32] ^ d[24] ^ c[28] ^ c[21] ^ c[13] ^ c[7] ^ d[33] ^ c[30] ^ d[17] ^ d[10] ^ c[22] ^ c[14] ^ c[8] ^ d[18] ^ c[9] ^ d[51] ^ d[43] ^ d[1] ^ d[27] ^ d[20] ^ d[12] ^ c[16] ^ d[52] ^ d[44] ^ d[9] ^ d[21] ^ d[13] ^ c[10] ^ c[4] ^ d[45] ^ d[3] ^ d[22] ^ c[26] ^ c[18] ^ c[11] ^ d[54] ^ d[38] ^ d[4] ; +o[9] = d[23] ^ c[27] ^ c[19] ^ c[20] ^ c[12] ^ d[32] ^ c[28] ^ d[16] ^ c[0] ^ c[29] ^ d[17] ^ c[22] ^ c[14] ^ c[8] ^ d[50] ^ d[42] ^ d[0] ^ d[26] ^ c[31] ^ c[23] ^ d[11] ^ c[15] ^ c[9] ^ d[51] ^ d[43] ^ d[8] ^ d[20] ^ d[19] ^ d[12] ^ d[44] ^ d[9] ^ d[2] ^ d[21] ^ c[17] ^ c[10] ^ d[53] ^ d[37] ^ d[3] ^ d[22] ^ d[14] ^ c[11] ^ d[54] ^ c[5] ^ d[46] ^ d[4] ^ d[31] ; +o[10] = d[23] ^ d[15] ^ c[12] ^ d[55] ^ d[39] ^ d[5] ^ d[24] ^ c[28] ^ d[16] ^ c[7] ^ d[41] ^ c[8] ^ d[50] ^ d[42] ^ d[0] ^ d[26] ^ c[31] ^ c[15] ^ c[9] ^ c[2] ^ d[27] ^ d[19] ^ d[20] ^ c[16] ^ d[52] ^ d[36] ^ d[13] ^ d[53] ^ c[4] ^ d[3] ^ d[29] ^ d[22] ^ c[26] ^ c[18] ^ c[11] ^ d[46] ^ c[5] ; +o[11] = c[27] ^ d[15] ^ c[19] ^ c[20] ^ c[12] ^ d[55] ^ d[40] ^ d[39] ^ d[5] ^ d[24] ^ c[21] ^ c[7] ^ c[0] ^ d[41] ^ c[30] ^ d[10] ^ c[1] ^ d[7] ^ d[0] ^ c[31] ^ d[11] ^ c[23] ^ c[9] ^ d[51] ^ d[43] ^ c[2] ^ d[8] ^ d[35] ^ d[1] ^ d[27] ^ d[19] ^ c[24] ^ d[12] ^ c[16] ^ d[52] ^ c[3] ^ d[28] ^ c[17] ^ c[4] ^ d[30] ^ d[29] ^ d[22] ^ c[26] ^ d[14] ^ d[54] ^ d[46] ^ d[38] ^ d[31] ^ d[4] ; +o[12] = c[27] ^ d[55] ^ c[6] ^ d[40] ^ d[5] ^ d[24] ^ c[28] ^ c[7] ^ c[0] ^ d[6] ^ d[25] ^ c[30] ^ c[29] ^ c[22] ^ d[49] ^ d[50] ^ d[42] ^ d[34] ^ c[23] ^ d[51] ^ d[43] ^ d[8] ^ d[1] ^ c[3] ^ d[9] ^ d[2] ^ d[28] ^ d[13] ^ c[25] ^ c[17] ^ d[53] ^ d[37] ^ d[3] ^ c[26] ^ d[14] ^ c[18] ^ d[54] ^ d[46] ^ d[38] ^ d[31] ^ d[4] ; +o[13] = d[23] ^ c[27] ^ c[19] ^ d[39] ^ d[5] ^ d[24] ^ c[28] ^ d[48] ^ c[7] ^ d[41] ^ d[33] ^ c[29] ^ c[30] ^ c[8] ^ d[50] ^ d[49] ^ d[42] ^ c[1] ^ d[7] ^ d[0] ^ c[31] ^ c[23] ^ d[8] ^ d[1] ^ d[27] ^ d[12] ^ c[24] ^ d[52] ^ d[36] ^ d[2] ^ d[13] ^ d[53] ^ c[4] ^ d[45] ^ d[37] ^ d[30] ^ d[3] ^ c[26] ^ c[18] ^ d[54] ^ d[4] ; +o[14] = d[23] ^ c[27] ^ c[20] ^ c[19] ^ d[47] ^ d[40] ^ d[32] ^ c[28] ^ d[48] ^ d[41] ^ d[6] ^ c[29] ^ c[30] ^ c[8] ^ d[49] ^ d[7] ^ d[0] ^ d[26] ^ c[31] ^ d[11] ^ c[9] ^ d[51] ^ c[2] ^ d[35] ^ d[1] ^ c[24] ^ d[12] ^ d[52] ^ d[44] ^ d[36] ^ d[2] ^ c[25] ^ d[53] ^ d[29] ^ d[3] ^ d[22] ^ c[5] ^ d[38] ^ d[4] ; +o[15] = c[20] ^ c[6] ^ d[47] ^ d[40] ^ d[39] ^ d[5] ^ c[28] ^ c[21] ^ d[48] ^ c[0] ^ d[6] ^ d[25] ^ c[30] ^ c[29] ^ d[10] ^ d[50] ^ d[34] ^ d[0] ^ c[31] ^ d[11] ^ c[9] ^ d[51] ^ d[43] ^ d[35] ^ d[1] ^ d[52] ^ c[3] ^ d[28] ^ d[2] ^ d[21] ^ c[25] ^ c[10] ^ d[37] ^ d[3] ^ d[22] ^ c[26] ^ d[46] ^ d[31] ; +o[16] = d[23] ^ c[27] ^ c[20] ^ d[55] ^ c[6] ^ d[47] ^ c[13] ^ c[0] ^ d[33] ^ d[25] ^ c[22] ^ c[8] ^ d[50] ^ d[42] ^ d[7] ^ d[34] ^ d[26] ^ d[18] ^ d[11] ^ c[23] ^ d[51] ^ d[43] ^ c[2] ^ d[8] ^ d[20] ^ c[24] ^ d[9] ^ d[36] ^ d[29] ^ c[11] ^ c[5] ^ d[38] ^ d[31] ^ d[4] ; +o[17] = c[12] ^ c[6] ^ d[32] ^ d[24] ^ c[28] ^ c[21] ^ c[7] ^ d[41] ^ d[6] ^ d[33] ^ d[25] ^ d[17] ^ d[10] ^ c[14] ^ d[50] ^ d[49] ^ d[42] ^ c[1] ^ d[7] ^ c[23] ^ c[9] ^ d[8] ^ d[35] ^ d[19] ^ c[24] ^ c[3] ^ d[28] ^ c[25] ^ d[37] ^ d[30] ^ d[3] ^ d[22] ^ d[54] ^ d[46] ; +o[18] = d[23] ^ d[40] ^ d[5] ^ d[32] ^ d[24] ^ d[16] ^ c[13] ^ c[7] ^ d[48] ^ d[41] ^ c[0] ^ d[6] ^ c[29] ^ c[22] ^ c[8] ^ d[49] ^ d[7] ^ d[34] ^ d[18] ^ c[15] ^ c[2] ^ d[27] ^ c[24] ^ d[9] ^ d[36] ^ d[2] ^ d[21] ^ c[25] ^ c[10] ^ d[53] ^ c[4] ^ d[45] ^ d[29] ^ c[26] ^ d[31] ; +o[19] = d[23] ^ c[27] ^ d[15] ^ d[47] ^ d[40] ^ d[39] ^ d[5] ^ d[48] ^ c[0] ^ d[6] ^ d[33] ^ c[30] ^ d[17] ^ c[14] ^ c[8] ^ c[1] ^ d[26] ^ c[23] ^ c[9] ^ d[8] ^ d[35] ^ d[1] ^ d[20] ^ c[16] ^ d[52] ^ c[3] ^ d[44] ^ d[28] ^ c[25] ^ d[30] ^ d[22] ^ c[26] ^ c[11] ^ c[5] ^ d[4] ^ d[31] ; +o[20] = c[27] ^ c[12] ^ c[6] ^ d[47] ^ d[39] ^ d[5] ^ d[32] ^ c[28] ^ d[16] ^ d[25] ^ c[1] ^ d[7] ^ d[34] ^ d[0] ^ c[31] ^ c[15] ^ d[51] ^ c[9] ^ c[2] ^ d[43] ^ d[27] ^ d[19] ^ c[24] ^ d[21] ^ c[17] ^ c[10] ^ c[4] ^ d[3] ^ d[30] ^ d[29] ^ d[22] ^ c[26] ^ d[14] ^ d[46] ^ d[38] ^ d[4] ; +o[21] = c[27] ^ d[15] ^ d[24] ^ c[28] ^ c[13] ^ c[7] ^ c[0] ^ d[6] ^ d[33] ^ c[29] ^ d[50] ^ d[42] ^ d[26] ^ d[18] ^ c[2] ^ d[20] ^ c[16] ^ c[3] ^ d[2] ^ d[28] ^ d[21] ^ c[25] ^ d[13] ^ c[10] ^ d[45] ^ d[37] ^ d[3] ^ d[29] ^ c[18] ^ c[11] ^ c[5] ^ d[46] ^ d[38] ^ d[4] ^ d[31] ; +o[22] = c[19] ^ c[20] ^ c[12] ^ d[55] ^ d[39] ^ d[32] ^ d[24] ^ c[28] ^ c[21] ^ c[13] ^ c[7] ^ c[0] ^ d[41] ^ d[17] ^ d[10] ^ c[14] ^ d[7] ^ d[0] ^ d[26] ^ c[31] ^ d[18] ^ d[11] ^ c[23] ^ d[43] ^ c[2] ^ d[8] ^ d[19] ^ d[20] ^ c[24] ^ d[12] ^ c[3] ^ d[44] ^ d[36] ^ d[28] ^ d[21] ^ c[17] ^ c[10] ^ d[37] ^ d[3] ^ d[29] ^ d[14] ^ c[11] ^ d[46] ^ c[5] ^ d[31] ; +o[23] = c[12] ^ d[55] ^ d[40] ^ d[39] ^ d[5] ^ d[24] ^ d[16] ^ c[7] ^ d[6] ^ c[30] ^ d[17] ^ c[22] ^ c[14] ^ d[49] ^ d[42] ^ d[0] ^ d[26] ^ c[31] ^ c[23] ^ c[15] ^ c[2] ^ d[8] ^ d[35] ^ d[1] ^ d[19] ^ d[20] ^ c[3] ^ d[9] ^ d[36] ^ d[28] ^ d[21] ^ d[13] ^ c[25] ^ c[10] ^ d[29] ^ c[26] ^ c[18] ^ c[11] ^ d[54] ^ d[46] ^ c[5] ^ d[38] ; +o[24] = d[23] ^ d[15] ^ c[27] ^ c[19] ^ c[12] ^ c[6] ^ d[39] ^ d[5] ^ d[16] ^ c[13] ^ d[48] ^ d[41] ^ d[25] ^ c[8] ^ d[7] ^ d[34] ^ d[0] ^ d[18] ^ c[31] ^ c[23] ^ c[15] ^ d[8] ^ d[35] ^ d[27] ^ d[20] ^ d[19] ^ d[12] ^ c[24] ^ c[16] ^ c[3] ^ d[28] ^ d[53] ^ c[4] ^ d[45] ^ d[37] ^ c[26] ^ c[11] ^ d[54] ^ d[38] ^ d[4] ; +o[25] = c[27] ^ d[15] ^ c[20] ^ c[12] ^ d[47] ^ d[40] ^ d[24] ^ c[28] ^ c[13] ^ c[7] ^ d[6] ^ d[33] ^ d[17] ^ c[14] ^ d[7] ^ d[34] ^ d[26] ^ d[18] ^ d[11] ^ c[9] ^ d[27] ^ d[19] ^ c[24] ^ c[16] ^ d[52] ^ d[44] ^ d[36] ^ c[25] ^ c[17] ^ d[53] ^ c[4] ^ d[37] ^ d[3] ^ d[22] ^ d[14] ^ c[5] ^ d[38] ^ d[4] ; +o[26] = c[20] ^ d[55] ^ d[32] ^ d[24] ^ c[28] ^ d[16] ^ c[7] ^ c[0] ^ d[6] ^ d[33] ^ c[30] ^ d[17] ^ c[14] ^ d[49] ^ c[1] ^ d[7] ^ d[0] ^ c[31] ^ d[11] ^ c[23] ^ c[15] ^ d[51] ^ c[2] ^ d[8] ^ d[35] ^ d[1] ^ d[27] ^ c[24] ^ d[52] ^ d[36] ^ d[13] ^ c[25] ^ c[17] ^ c[4] ^ d[45] ^ d[37] ^ d[3] ^ d[30] ^ d[29] ^ d[14] ^ c[18] ^ d[31] ; +o[27] = d[23] ^ d[15] ^ c[19] ^ d[5] ^ d[32] ^ d[16] ^ c[21] ^ d[48] ^ c[0] ^ d[6] ^ c[29] ^ d[10] ^ c[8] ^ d[50] ^ c[1] ^ d[7] ^ d[34] ^ d[0] ^ d[26] ^ c[31] ^ c[15] ^ d[51] ^ c[2] ^ d[35] ^ d[12] ^ c[24] ^ c[16] ^ c[3] ^ d[44] ^ d[36] ^ d[2] ^ d[28] ^ c[25] ^ d[13] ^ d[30] ^ d[29] ^ c[26] ^ c[18] ^ d[54] ^ c[5] ^ d[31] ; +o[28] = c[27] ^ d[15] ^ c[20] ^ c[19] ^ d[47] ^ c[6] ^ d[5] ^ c[0] ^ d[6] ^ d[33] ^ d[25] ^ c[30] ^ c[22] ^ d[50] ^ d[49] ^ c[1] ^ d[34] ^ d[11] ^ c[9] ^ c[2] ^ d[43] ^ d[35] ^ d[1] ^ d[27] ^ d[12] ^ c[16] ^ c[3] ^ d[9] ^ d[28] ^ c[25] ^ c[17] ^ d[53] ^ c[4] ^ d[29] ^ d[30] ^ d[22] ^ c[26] ^ d[14] ^ d[4] ^ d[31] ; +o[29] = c[27] ^ c[20] ^ d[5] ^ d[32] ^ d[24] ^ c[28] ^ c[21] ^ c[7] ^ d[48] ^ d[33] ^ d[10] ^ d[49] ^ c[1] ^ d[42] ^ d[34] ^ d[0] ^ d[26] ^ c[31] ^ c[23] ^ d[11] ^ c[2] ^ d[8] ^ d[27] ^ d[52] ^ c[3] ^ d[28] ^ d[21] ^ d[13] ^ c[17] ^ c[10] ^ c[4] ^ d[3] ^ d[30] ^ d[29] ^ c[26] ^ d[14] ^ c[18] ^ d[46] ^ c[5] ^ d[4] ; +o[30] = d[23] ^ c[27] ^ c[19] ^ c[6] ^ d[47] ^ d[32] ^ c[28] ^ c[21] ^ d[48] ^ d[41] ^ c[0] ^ d[33] ^ d[25] ^ c[29] ^ c[22] ^ d[10] ^ c[8] ^ d[7] ^ d[26] ^ d[51] ^ c[2] ^ d[27] ^ d[20] ^ d[12] ^ c[24] ^ c[3] ^ d[9] ^ d[2] ^ d[28] ^ d[13] ^ d[45] ^ c[4] ^ d[3] ^ d[29] ^ c[18] ^ c[11] ^ c[5] ^ d[4] ^ d[31] ; +o[31] = c[20] ^ c[19] ^ c[12] ^ c[6] ^ d[47] ^ d[40] ^ d[32] ^ d[24] ^ c[28] ^ c[7] ^ c[0] ^ d[6] ^ d[25] ^ c[29] ^ c[30] ^ c[22] ^ d[50] ^ c[1] ^ d[26] ^ c[23] ^ d[11] ^ c[9] ^ d[8] ^ d[1] ^ d[27] ^ d[19] ^ d[12] ^ d[44] ^ c[3] ^ d[9] ^ d[2] ^ d[28] ^ c[25] ^ c[4] ^ d[3] ^ d[30] ^ d[22] ^ c[5] ^ d[46] ^ d[31] ; + crc7B = o; + end + endfunction // crc7B + + //////////////////////////////////////////////// + // crc6B + //////////////////////////////////////////////// + function [31:0] crc6B ( + input [31:0] c, + input [47:0] d + ); + reg [31:0] o; + begin +o[0] = d[41] ^ d[23] ^ c[0] ^ d[15] ^ c[9] ^ c[10] ^ d[35] ^ d[17] ^ c[29] ^ c[12] ^ d[10] ^ c[14] ^ d[19] ^ d[37] ^ d[47] ^ d[3] ^ c[16] ^ d[22] ^ c[8] ^ c[18] ^ c[28] ^ d[16] ^ d[0] ^ c[21] ^ c[31] ^ d[18] ^ c[13] ^ d[2] ^ c[15] ^ d[21] ^ d[38] ^ d[13] ^ d[31] ; +o[1] = d[23] ^ c[19] ^ c[12] ^ d[47] ^ d[40] ^ c[28] ^ c[21] ^ d[41] ^ c[0] ^ c[30] ^ d[10] ^ c[22] ^ c[8] ^ c[1] ^ d[34] ^ d[0] ^ c[31] ^ d[35] ^ d[1] ^ d[20] ^ d[19] ^ d[12] ^ d[9] ^ d[36] ^ d[13] ^ c[17] ^ d[3] ^ d[30] ^ d[14] ^ c[18] ^ c[11] ^ d[46] ^ d[38] ^ d[31] ; +o[2] = d[23] ^ d[15] ^ c[20] ^ c[19] ^ d[47] ^ d[40] ^ d[39] ^ c[28] ^ d[16] ^ c[21] ^ d[41] ^ c[0] ^ d[33] ^ d[17] ^ d[10] ^ c[22] ^ c[14] ^ c[8] ^ c[1] ^ d[34] ^ d[11] ^ c[23] ^ c[15] ^ c[2] ^ d[8] ^ d[12] ^ c[16] ^ d[9] ^ d[21] ^ c[10] ^ d[45] ^ d[29] ^ d[3] ^ d[30] ^ d[46] ^ d[38] ^ d[31] ; +o[3] = d[15] ^ c[20] ^ d[40] ^ d[39] ^ d[32] ^ d[16] ^ c[21] ^ d[33] ^ c[29] ^ d[10] ^ c[22] ^ c[1] ^ d[7] ^ c[23] ^ d[11] ^ c[15] ^ c[9] ^ c[2] ^ d[8] ^ d[20] ^ c[24] ^ c[16] ^ c[3] ^ d[44] ^ d[9] ^ d[28] ^ d[2] ^ c[17] ^ d[45] ^ d[37] ^ d[30] ^ d[29] ^ d[22] ^ d[14] ^ c[11] ^ d[46] ^ d[38] ; +o[4] = d[23] ^ d[47] ^ d[39] ^ d[32] ^ c[28] ^ d[16] ^ c[13] ^ d[41] ^ d[6] ^ d[17] ^ c[29] ^ c[30] ^ c[22] ^ c[14] ^ c[8] ^ d[7] ^ d[0] ^ c[31] ^ d[18] ^ c[23] ^ c[15] ^ c[9] ^ c[2] ^ d[43] ^ d[35] ^ d[8] ^ d[1] ^ d[27] ^ c[24] ^ c[3] ^ d[44] ^ d[9] ^ d[36] ^ d[2] ^ d[28] ^ c[25] ^ c[17] ^ c[4] ^ d[45] ^ d[29] ^ d[3] ^ d[22] ^ d[14] ; +o[5] = d[23] ^ c[12] ^ d[47] ^ d[40] ^ d[5] ^ c[28] ^ c[21] ^ c[13] ^ d[41] ^ d[6] ^ c[30] ^ d[10] ^ c[8] ^ d[42] ^ d[7] ^ d[34] ^ d[26] ^ d[18] ^ c[23] ^ d[43] ^ d[8] ^ d[1] ^ d[27] ^ d[19] ^ c[24] ^ c[3] ^ d[44] ^ d[28] ^ c[25] ^ c[4] ^ d[37] ^ d[3] ^ c[26] ^ c[5] ^ d[46] ; +o[6] = c[27] ^ c[6] ^ d[40] ^ d[39] ^ d[5] ^ c[13] ^ d[41] ^ d[6] ^ d[33] ^ d[25] ^ c[29] ^ d[17] ^ c[22] ^ c[14] ^ d[42] ^ d[7] ^ d[0] ^ d[26] ^ c[31] ^ d[18] ^ c[9] ^ d[43] ^ d[27] ^ c[24] ^ d[9] ^ d[36] ^ d[2] ^ c[25] ^ c[4] ^ d[45] ^ d[22] ^ c[26] ^ d[46] ^ c[5] ^ d[4] ; +o[7] = d[23] ^ c[27] ^ d[15] ^ c[12] ^ d[47] ^ c[6] ^ d[39] ^ d[40] ^ d[5] ^ d[32] ^ d[24] ^ c[21] ^ c[13] ^ c[7] ^ c[0] ^ d[6] ^ d[25] ^ c[29] ^ c[30] ^ d[10] ^ c[8] ^ d[42] ^ d[0] ^ d[26] ^ c[31] ^ d[18] ^ c[23] ^ c[9] ^ d[8] ^ d[1] ^ d[19] ^ c[16] ^ d[44] ^ d[2] ^ d[13] ^ c[25] ^ d[45] ^ d[37] ^ d[22] ^ c[26] ^ c[18] ^ c[5] ^ d[4] ^ d[31] ; +o[8] = c[27] ^ d[15] ^ c[19] ^ c[12] ^ d[47] ^ c[6] ^ d[39] ^ d[5] ^ d[24] ^ d[16] ^ c[21] ^ c[7] ^ d[25] ^ c[29] ^ c[30] ^ d[10] ^ c[22] ^ c[1] ^ d[7] ^ c[15] ^ d[43] ^ d[35] ^ d[1] ^ d[19] ^ c[24] ^ d[12] ^ c[16] ^ d[44] ^ d[9] ^ d[36] ^ d[2] ^ d[13] ^ c[17] ^ d[37] ^ d[30] ^ c[26] ^ d[14] ^ c[18] ^ d[46] ^ d[4] ; +o[9] = d[23] ^ c[27] ^ d[15] ^ c[19] ^ c[20] ^ d[24] ^ c[28] ^ c[13] ^ c[7] ^ d[6] ^ c[30] ^ c[22] ^ c[8] ^ d[42] ^ d[34] ^ d[0] ^ c[31] ^ d[18] ^ c[23] ^ d[11] ^ c[2] ^ d[43] ^ d[8] ^ d[35] ^ d[1] ^ d[12] ^ c[16] ^ d[9] ^ d[36] ^ c[25] ^ d[13] ^ c[17] ^ d[45] ^ d[3] ^ d[29] ^ d[14] ^ c[18] ^ d[46] ^ d[38] ^ d[4] ; +o[10] = d[15] ^ c[20] ^ c[19] ^ c[12] ^ d[47] ^ d[5] ^ d[16] ^ c[13] ^ c[0] ^ d[33] ^ d[42] ^ d[7] ^ d[34] ^ d[18] ^ d[11] ^ c[23] ^ c[15] ^ d[8] ^ d[19] ^ c[24] ^ d[12] ^ c[16] ^ c[3] ^ d[44] ^ d[28] ^ d[21] ^ c[17] ^ c[10] ^ d[45] ^ c[26] ^ d[14] ^ d[38] ^ d[31] ; +o[11] = d[23] ^ c[27] ^ c[20] ^ c[12] ^ d[47] ^ d[32] ^ c[28] ^ d[16] ^ c[0] ^ d[6] ^ d[33] ^ c[29] ^ c[8] ^ c[1] ^ d[7] ^ d[0] ^ c[31] ^ d[11] ^ c[15] ^ c[9] ^ d[43] ^ d[35] ^ d[27] ^ d[20] ^ d[19] ^ c[24] ^ d[44] ^ d[2] ^ d[21] ^ c[25] ^ c[17] ^ c[10] ^ c[4] ^ d[3] ^ d[30] ^ d[22] ^ d[14] ^ c[11] ^ d[46] ^ d[38] ^ d[4] ^ d[31] ; +o[12] = d[23] ^ d[47] ^ d[5] ^ d[32] ^ d[16] ^ d[41] ^ d[6] ^ d[17] ^ c[30] ^ c[14] ^ c[8] ^ c[1] ^ d[42] ^ d[34] ^ d[0] ^ d[26] ^ c[31] ^ c[15] ^ c[2] ^ d[43] ^ d[35] ^ d[1] ^ d[20] ^ c[25] ^ d[45] ^ d[29] ^ d[30] ^ c[26] ^ c[11] ^ c[5] ^ d[46] ^ d[38] ; +o[13] = c[27] ^ d[15] ^ c[12] ^ c[6] ^ d[40] ^ d[5] ^ d[16] ^ c[0] ^ d[41] ^ d[33] ^ d[25] ^ d[42] ^ d[34] ^ d[0] ^ c[31] ^ c[15] ^ c[9] ^ c[2] ^ d[19] ^ c[16] ^ c[3] ^ d[44] ^ d[28] ^ d[45] ^ d[37] ^ d[29] ^ d[22] ^ c[26] ^ d[46] ^ d[4] ^ d[31] ; +o[14] = d[15] ^ c[27] ^ d[39] ^ d[40] ^ d[32] ^ d[24] ^ c[28] ^ c[13] ^ c[7] ^ d[41] ^ d[33] ^ c[1] ^ d[18] ^ d[43] ^ d[27] ^ c[16] ^ d[44] ^ c[3] ^ d[36] ^ d[28] ^ d[21] ^ c[17] ^ c[10] ^ d[45] ^ c[4] ^ d[3] ^ d[30] ^ d[14] ^ d[4] ; +o[15] = d[23] ^ d[40] ^ d[39] ^ d[32] ^ c[28] ^ c[0] ^ c[29] ^ d[17] ^ c[14] ^ c[8] ^ d[42] ^ d[26] ^ c[2] ^ d[43] ^ d[35] ^ d[27] ^ d[20] ^ d[44] ^ d[2] ^ d[13] ^ c[17] ^ c[4] ^ d[3] ^ d[29] ^ d[14] ^ c[18] ^ c[11] ^ c[5] ^ d[38] ^ d[31] ; +o[16] = d[23] ^ d[15] ^ c[19] ^ d[47] ^ c[6] ^ d[39] ^ c[28] ^ c[21] ^ c[13] ^ d[25] ^ d[17] ^ c[30] ^ d[10] ^ c[14] ^ c[8] ^ d[42] ^ c[1] ^ d[34] ^ d[0] ^ d[26] ^ c[31] ^ d[18] ^ d[43] ^ d[35] ^ d[1] ^ d[12] ^ c[16] ^ c[3] ^ d[28] ^ d[21] ^ c[10] ^ d[3] ^ d[30] ^ c[5] ; +o[17] = c[20] ^ c[6] ^ d[24] ^ d[16] ^ c[7] ^ d[41] ^ d[33] ^ d[25] ^ c[29] ^ d[17] ^ c[22] ^ c[14] ^ d[42] ^ d[34] ^ d[0] ^ c[31] ^ d[11] ^ c[15] ^ c[9] ^ c[2] ^ d[27] ^ d[20] ^ d[9] ^ d[2] ^ c[17] ^ c[4] ^ d[29] ^ d[22] ^ d[14] ^ c[11] ^ d[46] ^ d[38] ; +o[18] = d[23] ^ d[15] ^ c[12] ^ d[40] ^ d[32] ^ d[24] ^ d[16] ^ c[21] ^ c[7] ^ d[41] ^ d[33] ^ c[30] ^ d[10] ^ c[8] ^ d[26] ^ c[23] ^ c[15] ^ d[8] ^ d[1] ^ d[19] ^ c[16] ^ c[3] ^ d[28] ^ d[21] ^ d[13] ^ c[10] ^ d[45] ^ d[37] ^ c[18] ^ c[5] ; +o[19] = d[23] ^ d[15] ^ c[19] ^ c[6] ^ d[39] ^ d[40] ^ d[32] ^ c[13] ^ c[0] ^ d[25] ^ c[22] ^ c[8] ^ d[7] ^ d[0] ^ c[31] ^ d[18] ^ c[9] ^ d[27] ^ d[20] ^ c[24] ^ d[12] ^ c[16] ^ d[44] ^ d[9] ^ d[36] ^ c[17] ^ c[4] ^ d[22] ^ d[14] ^ c[11] ^ d[31] ; +o[20] = c[20] ^ c[12] ^ d[39] ^ d[24] ^ c[7] ^ c[0] ^ d[6] ^ d[17] ^ c[14] ^ c[1] ^ d[26] ^ d[11] ^ c[23] ^ c[9] ^ d[43] ^ d[8] ^ d[35] ^ d[19] ^ d[21] ^ d[13] ^ c[25] ^ c[17] ^ c[10] ^ d[30] ^ d[22] ^ d[14] ^ c[18] ^ c[5] ^ d[38] ^ d[31] ; +o[21] = d[23] ^ c[19] ^ c[6] ^ d[5] ^ d[16] ^ c[21] ^ c[13] ^ d[25] ^ d[10] ^ c[8] ^ d[42] ^ c[1] ^ d[7] ^ d[34] ^ d[18] ^ c[15] ^ c[2] ^ d[20] ^ d[12] ^ c[24] ^ d[21] ^ d[13] ^ c[10] ^ d[37] ^ d[30] ^ d[29] ^ c[26] ^ c[18] ^ c[11] ^ d[38] ; +o[22] = d[23] ^ c[27] ^ c[20] ^ c[19] ^ d[47] ^ d[24] ^ c[28] ^ d[16] ^ c[21] ^ c[13] ^ c[7] ^ c[0] ^ d[6] ^ d[33] ^ c[29] ^ d[10] ^ c[22] ^ c[8] ^ d[0] ^ c[31] ^ d[18] ^ d[11] ^ c[15] ^ c[2] ^ d[35] ^ d[20] ^ d[12] ^ c[3] ^ d[9] ^ d[36] ^ d[2] ^ d[28] ^ d[21] ^ d[13] ^ c[25] ^ c[10] ^ d[29] ^ d[3] ^ c[18] ^ c[11] ^ d[38] ^ d[4] ^ d[31] ; +o[23] = c[20] ^ c[19] ^ d[47] ^ d[5] ^ d[32] ^ d[16] ^ c[13] ^ d[41] ^ c[0] ^ c[30] ^ c[22] ^ c[1] ^ d[34] ^ d[0] ^ c[31] ^ d[18] ^ d[11] ^ c[23] ^ c[15] ^ d[8] ^ d[1] ^ d[27] ^ d[20] ^ d[12] ^ c[3] ^ d[9] ^ d[28] ^ d[21] ^ d[13] ^ c[10] ^ c[4] ^ d[30] ^ c[26] ^ c[18] ^ c[11] ^ d[46] ^ d[38] ^ d[31] ; +o[24] = c[27] ^ d[15] ^ c[19] ^ c[20] ^ c[12] ^ d[40] ^ c[21] ^ c[0] ^ d[33] ^ d[17] ^ d[10] ^ c[14] ^ c[1] ^ d[7] ^ d[0] ^ d[26] ^ c[31] ^ c[23] ^ d[11] ^ c[2] ^ d[8] ^ d[27] ^ d[19] ^ d[20] ^ c[24] ^ d[12] ^ c[16] ^ c[4] ^ d[45] ^ d[37] ^ d[30] ^ d[29] ^ c[11] ^ d[46] ^ c[5] ^ d[4] ^ d[31] ; +o[25] = c[20] ^ c[12] ^ c[6] ^ d[39] ^ d[32] ^ c[28] ^ d[16] ^ c[21] ^ c[13] ^ d[6] ^ d[25] ^ c[22] ^ d[10] ^ c[1] ^ d[7] ^ d[26] ^ d[18] ^ d[11] ^ c[15] ^ c[2] ^ d[19] ^ c[24] ^ d[44] ^ c[3] ^ d[9] ^ d[36] ^ d[28] ^ c[25] ^ c[17] ^ d[45] ^ d[3] ^ d[30] ^ d[29] ^ d[14] ^ c[5] ; +o[26] = d[23] ^ c[12] ^ d[47] ^ c[6] ^ d[5] ^ d[24] ^ c[28] ^ d[16] ^ c[7] ^ d[41] ^ d[6] ^ d[25] ^ c[22] ^ c[8] ^ d[0] ^ c[31] ^ c[23] ^ c[15] ^ c[9] ^ c[2] ^ d[43] ^ d[8] ^ d[27] ^ d[19] ^ c[3] ^ d[44] ^ d[9] ^ d[28] ^ d[21] ^ c[25] ^ c[10] ^ c[4] ^ d[37] ^ d[29] ^ d[3] ^ d[22] ^ c[26] ; +o[27] = d[23] ^ c[27] ^ d[15] ^ d[40] ^ d[5] ^ d[24] ^ c[13] ^ c[7] ^ c[29] ^ c[8] ^ d[42] ^ d[7] ^ d[26] ^ d[18] ^ c[23] ^ c[9] ^ d[43] ^ d[8] ^ d[27] ^ d[20] ^ c[24] ^ c[16] ^ c[3] ^ d[36] ^ d[28] ^ d[2] ^ d[21] ^ c[10] ^ c[4] ^ d[22] ^ c[26] ^ c[11] ^ d[46] ^ c[5] ^ d[4] ; +o[28] = d[23] ^ c[27] ^ c[12] ^ c[6] ^ d[39] ^ c[28] ^ d[41] ^ d[6] ^ d[25] ^ c[30] ^ d[17] ^ c[14] ^ c[8] ^ d[42] ^ d[7] ^ d[26] ^ c[9] ^ d[35] ^ d[27] ^ d[1] ^ d[20] ^ d[19] ^ c[24] ^ d[21] ^ c[25] ^ c[17] ^ c[10] ^ d[45] ^ c[4] ^ d[3] ^ d[22] ^ d[14] ^ c[11] ^ c[5] ^ d[4] ; +o[29] = c[12] ^ c[6] ^ d[40] ^ d[5] ^ d[24] ^ d[16] ^ c[28] ^ c[13] ^ c[7] ^ d[41] ^ d[6] ^ d[25] ^ c[29] ^ d[34] ^ d[26] ^ d[0] ^ c[31] ^ d[18] ^ c[15] ^ c[9] ^ d[20] ^ d[19] ^ d[44] ^ d[2] ^ d[21] ^ c[25] ^ d[13] ^ c[10] ^ d[3] ^ d[22] ^ c[26] ^ c[18] ^ c[11] ^ c[5] ^ d[38] ; +o[30] = d[23] ^ c[27] ^ d[15] ^ c[19] ^ c[12] ^ c[6] ^ d[40] ^ d[39] ^ d[5] ^ d[24] ^ c[13] ^ c[7] ^ d[33] ^ d[25] ^ c[30] ^ c[29] ^ d[17] ^ c[14] ^ c[8] ^ d[18] ^ d[43] ^ d[1] ^ d[19] ^ d[20] ^ d[12] ^ c[16] ^ d[2] ^ d[21] ^ c[10] ^ d[37] ^ c[26] ^ c[11] ^ d[4] ; +o[31] = c[17] ^ d[23] ^ c[27] ^ c[9] ^ c[20] ^ c[30] ^ d[17] ^ c[12] ^ d[1] ^ d[20] ^ c[14] ^ d[19] ^ d[3] ^ d[22] ^ d[39] ^ d[14] ^ c[8] ^ d[32] ^ d[42] ^ d[24] ^ c[28] ^ c[11] ^ d[16] ^ d[0] ^ d[36] ^ d[18] ^ c[31] ^ c[13] ^ d[11] ^ c[15] ^ d[38] ^ d[4] ^ c[7] ; + crc6B = o; + end + endfunction // crc6B + + //////////////////////////////////////////////// + // crc5B + //////////////////////////////////////////////// + function [31:0] crc5B ( + input [31:0] c, + input [39:0] d + ); + reg [31:0] o; + begin +o[0] = c[17] ^ d[23] ^ d[33] ^ d[15] ^ c[20] ^ c[2] ^ c[29] ^ d[8] ^ d[27] ^ c[22] ^ c[4] ^ d[10] ^ c[24] ^ d[30] ^ d[29] ^ d[39] ^ c[16] ^ d[5] ^ c[26] ^ d[14] ^ c[8] ^ c[18] ^ c[1] ^ d[7] ^ c[21] ^ d[9] ^ d[2] ^ d[11] ^ c[23] ^ d[13] ; +o[1] = d[23] ^ d[33] ^ d[15] ^ d[6] ^ c[27] ^ c[9] ^ c[19] ^ c[20] ^ c[29] ^ c[30] ^ d[27] ^ d[1] ^ c[4] ^ d[12] ^ d[30] ^ d[39] ^ c[16] ^ d[22] ^ d[5] ^ c[26] ^ c[8] ^ d[32] ^ c[1] ^ d[26] ^ c[3] ^ d[2] ^ d[11] ^ c[5] ^ d[28] ^ d[38] ^ c[25] ^ d[4] ; +o[2] = d[23] ^ c[0] ^ d[33] ^ d[15] ^ c[10] ^ c[27] ^ c[9] ^ d[25] ^ c[29] ^ c[30] ^ d[8] ^ c[22] ^ d[1] ^ d[37] ^ d[3] ^ c[24] ^ d[30] ^ c[6] ^ d[39] ^ c[16] ^ d[22] ^ c[8] ^ d[32] ^ c[18] ^ c[1] ^ c[28] ^ d[7] ^ d[0] ^ d[26] ^ d[9] ^ c[31] ^ d[2] ^ c[23] ^ c[5] ^ d[21] ^ d[38] ^ d[4] ^ d[13] ^ d[31] ; +o[3] = c[17] ^ c[0] ^ d[6] ^ c[9] ^ c[10] ^ c[19] ^ c[2] ^ d[25] ^ d[8] ^ c[29] ^ c[30] ^ d[1] ^ d[20] ^ d[37] ^ c[24] ^ d[3] ^ d[12] ^ d[29] ^ c[6] ^ d[30] ^ d[22] ^ d[32] ^ d[14] ^ d[24] ^ c[1] ^ c[11] ^ d[7] ^ c[28] ^ d[0] ^ c[31] ^ d[36] ^ d[2] ^ c[23] ^ d[38] ^ d[21] ^ c[25] ^ d[31] ^ c[7] ; +o[4] = d[15] ^ c[12] ^ d[39] ^ d[24] ^ c[21] ^ c[7] ^ c[0] ^ d[33] ^ d[6] ^ c[30] ^ c[22] ^ d[10] ^ d[0] ^ c[31] ^ c[23] ^ d[8] ^ d[35] ^ d[27] ^ d[1] ^ d[20] ^ d[19] ^ c[16] ^ c[3] ^ d[9] ^ d[36] ^ d[28] ^ d[21] ^ c[25] ^ c[17] ^ c[10] ^ c[4] ^ d[37] ^ d[14] ^ c[11] ^ d[31] ; +o[5] = d[15] ^ c[20] ^ c[12] ^ d[39] ^ d[32] ^ c[21] ^ c[13] ^ d[33] ^ c[29] ^ d[10] ^ d[34] ^ d[0] ^ d[26] ^ c[31] ^ d[18] ^ d[11] ^ c[2] ^ d[35] ^ d[20] ^ d[19] ^ c[16] ^ d[36] ^ d[2] ^ d[29] ^ c[11] ^ c[5] ^ d[38] ; +o[6] = c[12] ^ c[6] ^ d[32] ^ c[21] ^ c[13] ^ c[0] ^ d[33] ^ d[25] ^ c[30] ^ d[17] ^ d[10] ^ c[22] ^ c[14] ^ d[34] ^ d[18] ^ d[35] ^ d[1] ^ d[19] ^ c[3] ^ d[9] ^ d[28] ^ c[17] ^ d[37] ^ d[14] ^ d[38] ^ d[31] ; +o[7] = d[23] ^ d[15] ^ c[20] ^ d[39] ^ d[5] ^ d[32] ^ d[24] ^ d[16] ^ c[21] ^ c[13] ^ c[7] ^ c[0] ^ c[29] ^ d[17] ^ d[10] ^ c[14] ^ c[8] ^ d[7] ^ d[34] ^ d[0] ^ c[31] ^ d[18] ^ d[11] ^ c[15] ^ c[2] ^ c[24] ^ c[16] ^ d[36] ^ d[2] ^ c[17] ^ d[37] ^ d[29] ^ c[26] ^ d[14] ^ d[31] ; +o[8] = c[0] ^ d[6] ^ c[27] ^ c[9] ^ c[20] ^ c[2] ^ c[29] ^ c[30] ^ d[8] ^ d[17] ^ d[35] ^ d[27] ^ d[1] ^ c[4] ^ c[14] ^ c[24] ^ d[29] ^ d[39] ^ d[22] ^ d[5] ^ c[26] ^ d[7] ^ d[16] ^ c[3] ^ d[36] ^ d[2] ^ d[11] ^ c[23] ^ d[28] ^ d[38] ^ c[15] ^ c[25] ^ d[4] ^ d[31] ; +o[9] = c[27] ^ d[6] ^ d[15] ^ c[10] ^ c[30] ^ d[35] ^ d[1] ^ d[10] ^ d[27] ^ c[4] ^ d[37] ^ c[24] ^ d[3] ^ d[30] ^ c[16] ^ d[5] ^ c[26] ^ c[1] ^ d[7] ^ d[16] ^ c[28] ^ d[34] ^ d[26] ^ d[0] ^ c[21] ^ c[3] ^ c[31] ^ c[5] ^ d[28] ^ d[38] ^ c[15] ^ d[21] ^ d[4] ^ c[25] ; +o[10] = d[23] ^ c[27] ^ c[20] ^ c[6] ^ d[39] ^ c[28] ^ c[21] ^ d[6] ^ d[25] ^ d[10] ^ c[8] ^ c[1] ^ d[7] ^ d[34] ^ d[0] ^ d[26] ^ c[31] ^ d[11] ^ c[23] ^ d[8] ^ d[20] ^ c[24] ^ d[36] ^ c[25] ^ d[13] ^ d[37] ^ d[3] ^ d[30] ^ c[18] ^ c[11] ^ c[5] ^ d[4] ; +o[11] = c[17] ^ d[23] ^ d[15] ^ d[6] ^ c[9] ^ c[19] ^ c[20] ^ d[25] ^ d[8] ^ c[12] ^ d[35] ^ d[27] ^ c[4] ^ d[19] ^ d[3] ^ d[12] ^ d[30] ^ c[6] ^ d[39] ^ c[16] ^ d[22] ^ d[14] ^ c[8] ^ d[24] ^ c[18] ^ c[1] ^ c[28] ^ d[36] ^ d[11] ^ c[23] ^ d[38] ^ c[25] ^ c[7] ^ d[13] ; +o[12] = d[33] ^ d[15] ^ c[10] ^ c[9] ^ c[19] ^ d[8] ^ d[35] ^ d[27] ^ c[22] ^ c[4] ^ d[37] ^ d[12] ^ d[30] ^ d[39] ^ c[16] ^ d[22] ^ d[24] ^ c[1] ^ d[34] ^ d[26] ^ d[9] ^ d[18] ^ c[13] ^ c[23] ^ c[5] ^ d[21] ^ d[38] ^ c[7] ; +o[13] = c[17] ^ d[23] ^ c[10] ^ d[33] ^ c[20] ^ c[2] ^ d[25] ^ d[8] ^ d[17] ^ d[20] ^ c[14] ^ d[37] ^ c[24] ^ d[29] ^ c[6] ^ d[32] ^ d[14] ^ c[8] ^ c[11] ^ d[7] ^ d[34] ^ d[26] ^ d[36] ^ c[23] ^ d[11] ^ c[5] ^ d[38] ^ d[21] ; +o[14] = c[0] ^ d[6] ^ c[9] ^ d[33] ^ d[25] ^ c[12] ^ d[35] ^ d[10] ^ d[37] ^ d[19] ^ d[20] ^ c[24] ^ c[6] ^ d[22] ^ d[32] ^ c[18] ^ d[24] ^ d[7] ^ d[16] ^ c[11] ^ c[21] ^ c[3] ^ d[36] ^ d[28] ^ c[15] ^ d[31] ^ d[13] ^ c[25] ^ c[7] ; +o[15] = d[23] ^ c[0] ^ d[6] ^ d[15] ^ c[10] ^ c[19] ^ d[35] ^ c[12] ^ c[22] ^ d[27] ^ c[4] ^ d[19] ^ d[30] ^ d[12] ^ c[16] ^ d[5] ^ c[26] ^ c[8] ^ d[32] ^ d[24] ^ c[1] ^ d[34] ^ d[36] ^ d[18] ^ d[9] ^ c[13] ^ d[21] ^ c[25] ^ c[7] ^ d[31] ; +o[16] = d[15] ^ c[27] ^ d[39] ^ c[21] ^ c[13] ^ c[0] ^ c[29] ^ d[17] ^ c[22] ^ d[10] ^ c[14] ^ d[7] ^ d[34] ^ d[26] ^ d[18] ^ c[9] ^ d[35] ^ d[27] ^ d[20] ^ c[24] ^ c[16] ^ d[9] ^ d[2] ^ d[13] ^ c[4] ^ d[22] ^ c[18] ^ c[11] ^ c[5] ^ d[4] ^ d[31] ; +o[17] = c[17] ^ d[6] ^ d[33] ^ c[10] ^ c[19] ^ d[25] ^ d[8] ^ c[30] ^ d[17] ^ c[12] ^ d[1] ^ c[22] ^ c[14] ^ d[19] ^ d[3] ^ d[12] ^ c[6] ^ d[30] ^ d[14] ^ c[1] ^ d[16] ^ c[28] ^ d[34] ^ d[26] ^ d[9] ^ c[23] ^ c[5] ^ d[38] ^ c[15] ^ d[21] ^ c[25] ; +o[18] = d[15] ^ d[33] ^ d[25] ^ c[20] ^ c[2] ^ c[29] ^ d[8] ^ d[37] ^ d[20] ^ c[24] ^ c[6] ^ d[29] ^ c[16] ^ d[5] ^ c[26] ^ d[32] ^ c[18] ^ d[24] ^ d[7] ^ d[16] ^ c[11] ^ d[0] ^ c[31] ^ d[18] ^ c[13] ^ d[2] ^ d[11] ^ c[23] ^ c[15] ^ d[13] ^ c[7] ; +o[19] = c[17] ^ d[23] ^ c[0] ^ d[6] ^ d[15] ^ c[27] ^ c[19] ^ c[30] ^ d[17] ^ c[12] ^ d[1] ^ d[10] ^ c[14] ^ d[19] ^ d[12] ^ c[24] ^ c[16] ^ d[14] ^ d[32] ^ c[8] ^ d[24] ^ d[7] ^ c[21] ^ c[3] ^ d[36] ^ d[28] ^ c[25] ^ d[4] ^ c[7] ^ d[31] ; +o[20] = d[23] ^ c[17] ^ c[0] ^ d[6] ^ c[9] ^ c[20] ^ d[35] ^ c[22] ^ d[27] ^ c[4] ^ d[3] ^ d[30] ^ d[22] ^ d[5] ^ c[26] ^ d[14] ^ c[8] ^ c[18] ^ c[1] ^ c[28] ^ d[16] ^ d[0] ^ c[31] ^ d[9] ^ d[18] ^ c[13] ^ d[11] ^ c[15] ^ d[13] ^ c[25] ^ d[31] ; +o[21] = c[27] ^ c[9] ^ d[15] ^ c[10] ^ c[19] ^ c[2] ^ c[29] ^ d[8] ^ d[17] ^ d[10] ^ c[14] ^ d[12] ^ d[30] ^ d[29] ^ d[22] ^ c[16] ^ d[5] ^ c[26] ^ c[18] ^ c[1] ^ d[34] ^ c[21] ^ d[26] ^ d[2] ^ c[23] ^ c[5] ^ d[21] ^ d[4] ^ d[13] ; +o[22] = d[23] ^ d[15] ^ c[10] ^ c[27] ^ c[19] ^ d[25] ^ c[29] ^ c[30] ^ d[8] ^ d[27] ^ d[1] ^ c[4] ^ d[10] ^ d[20] ^ d[3] ^ d[12] ^ d[30] ^ c[6] ^ d[39] ^ c[16] ^ d[5] ^ c[26] ^ c[8] ^ c[18] ^ c[1] ^ c[28] ^ c[11] ^ d[16] ^ c[21] ^ c[3] ^ d[2] ^ c[23] ^ d[28] ^ d[21] ^ c[15] ^ d[4] ^ d[13] ; +o[23] = d[23] ^ d[33] ^ c[27] ^ c[9] ^ c[19] ^ c[30] ^ d[8] ^ c[12] ^ d[1] ^ d[10] ^ d[20] ^ d[19] ^ d[3] ^ d[12] ^ d[30] ^ d[39] ^ d[22] ^ d[5] ^ c[26] ^ c[8] ^ d[24] ^ c[18] ^ c[1] ^ c[28] ^ c[11] ^ d[0] ^ c[21] ^ d[26] ^ c[31] ^ c[23] ^ c[5] ^ d[38] ^ d[4] ^ c[7] ^ d[13] ; +o[24] = d[23] ^ c[27] ^ c[9] ^ c[10] ^ c[20] ^ c[19] ^ c[2] ^ d[25] ^ c[29] ^ c[12] ^ c[22] ^ d[19] ^ d[37] ^ c[24] ^ d[3] ^ d[12] ^ d[29] ^ c[6] ^ d[22] ^ d[32] ^ c[8] ^ d[7] ^ c[28] ^ d[0] ^ c[31] ^ d[9] ^ d[18] ^ c[13] ^ d[2] ^ d[11] ^ d[38] ^ d[21] ^ d[4] ; +o[25] = c[0] ^ d[6] ^ c[9] ^ c[10] ^ c[20] ^ c[30] ^ c[29] ^ d[8] ^ d[17] ^ d[1] ^ d[10] ^ d[37] ^ c[14] ^ d[20] ^ d[3] ^ d[22] ^ d[24] ^ c[28] ^ c[11] ^ c[21] ^ c[3] ^ d[18] ^ c[13] ^ d[36] ^ d[2] ^ d[11] ^ d[28] ^ c[23] ^ d[21] ^ d[31] ^ c[25] ^ c[7] ; +o[26] = c[17] ^ d[33] ^ d[15] ^ c[10] ^ c[20] ^ c[2] ^ c[30] ^ d[8] ^ d[17] ^ c[12] ^ d[35] ^ d[1] ^ c[14] ^ d[20] ^ d[19] ^ d[29] ^ d[39] ^ c[16] ^ d[14] ^ c[18] ^ c[11] ^ d[16] ^ d[0] ^ c[31] ^ d[36] ^ d[11] ^ c[23] ^ d[21] ^ c[15] ^ d[13] ; +o[27] = c[17] ^ d[15] ^ c[19] ^ c[12] ^ d[35] ^ d[10] ^ d[20] ^ d[19] ^ c[24] ^ d[12] ^ c[16] ^ d[32] ^ d[14] ^ c[18] ^ c[11] ^ d[7] ^ d[16] ^ d[34] ^ d[0] ^ c[21] ^ c[3] ^ c[31] ^ d[18] ^ c[13] ^ d[28] ^ d[38] ^ c[15] ^ d[13] ; +o[28] = c[0] ^ c[17] ^ d[6] ^ d[15] ^ d[33] ^ c[19] ^ c[20] ^ c[12] ^ d[17] ^ c[22] ^ d[27] ^ c[4] ^ d[37] ^ d[19] ^ c[14] ^ d[12] ^ c[16] ^ d[14] ^ c[18] ^ d[34] ^ d[9] ^ d[18] ^ c[13] ^ d[11] ^ d[31] ^ d[13] ^ c[25] ; +o[29] = c[17] ^ d[33] ^ c[19] ^ c[20] ^ d[8] ^ d[17] ^ d[10] ^ c[14] ^ d[30] ^ d[12] ^ d[5] ^ c[26] ^ d[14] ^ d[32] ^ c[1] ^ c[18] ^ d[16] ^ c[21] ^ d[26] ^ d[36] ^ d[18] ^ c[13] ^ c[23] ^ d[11] ^ c[5] ^ c[15] ^ d[13] ; +o[30] = c[0] ^ c[27] ^ d[15] ^ c[20] ^ c[2] ^ d[25] ^ c[19] ^ d[35] ^ d[17] ^ d[10] ^ c[22] ^ c[14] ^ d[29] ^ c[24] ^ c[6] ^ d[12] ^ c[16] ^ d[32] ^ c[18] ^ d[7] ^ d[16] ^ c[21] ^ d[9] ^ d[11] ^ c[15] ^ d[4] ^ d[13] ^ d[31] ; +o[31] = c[17] ^ c[0] ^ d[6] ^ d[15] ^ c[19] ^ c[20] ^ d[8] ^ d[10] ^ c[22] ^ d[3] ^ d[12] ^ d[30] ^ c[16] ^ d[14] ^ d[24] ^ c[1] ^ d[34] ^ d[16] ^ c[28] ^ c[21] ^ c[3] ^ d[9] ^ d[28] ^ c[23] ^ d[11] ^ c[15] ^ c[25] ^ c[7] ^ d[31] ; + crc5B = o; + end + endfunction // crc5B + + //////////////////////////////////////////////// + // crc4B + //////////////////////////////////////////////// + function [31:0] crc4B ( + input [31:0] c, + input [31:0] d + ); + reg [31:0] o; + begin +o[0] = c[0] ^ d[6] ^ d[15] ^ c[9] ^ c[10] ^ d[25] ^ c[30] ^ c[12] ^ c[29] ^ d[1] ^ d[19] ^ c[24] ^ d[3] ^ c[6] ^ c[16] ^ d[22] ^ d[5] ^ c[26] ^ d[7] ^ c[28] ^ d[0] ^ c[31] ^ d[2] ^ d[21] ^ d[31] ^ c[25] ; +o[1] = c[0] ^ c[17] ^ c[27] ^ d[15] ^ c[9] ^ d[25] ^ c[12] ^ d[19] ^ d[20] ^ c[24] ^ d[3] ^ c[6] ^ d[30] ^ c[16] ^ d[22] ^ d[14] ^ d[24] ^ c[1] ^ d[7] ^ c[28] ^ c[11] ^ d[18] ^ c[13] ^ d[31] ^ d[4] ^ c[7] ; +o[2] = c[0] ^ c[17] ^ d[23] ^ d[15] ^ c[9] ^ d[25] ^ c[2] ^ c[30] ^ d[17] ^ d[1] ^ c[14] ^ c[24] ^ c[6] ^ d[30] ^ d[29] ^ c[16] ^ d[22] ^ d[5] ^ c[26] ^ d[14] ^ c[8] ^ c[18] ^ d[24] ^ c[1] ^ d[7] ^ d[0] ^ c[31] ^ d[18] ^ c[13] ^ d[31] ^ d[13] ^ c[7] ; +o[3] = c[17] ^ d[23] ^ d[6] ^ c[27] ^ c[10] ^ c[9] ^ c[19] ^ c[2] ^ d[17] ^ c[14] ^ d[30] ^ d[12] ^ d[29] ^ d[22] ^ d[14] ^ c[8] ^ d[24] ^ c[1] ^ c[18] ^ d[16] ^ d[0] ^ c[3] ^ c[31] ^ d[28] ^ d[21] ^ c[15] ^ c[25] ^ d[4] ^ c[7] ^ d[13] ; +o[4] = c[0] ^ d[23] ^ d[6] ^ d[25] ^ c[19] ^ c[20] ^ c[2] ^ c[30] ^ c[12] ^ c[29] ^ d[1] ^ d[27] ^ c[4] ^ d[19] ^ d[20] ^ c[24] ^ c[6] ^ d[12] ^ d[29] ^ c[8] ^ c[18] ^ d[7] ^ d[16] ^ c[11] ^ d[0] ^ c[3] ^ c[31] ^ d[2] ^ d[11] ^ d[28] ^ c[15] ^ d[31] ^ d[13] ^ c[25] ; +o[5] = c[0] ^ c[10] ^ d[25] ^ c[19] ^ c[20] ^ c[29] ^ d[10] ^ d[27] ^ c[4] ^ c[24] ^ d[3] ^ c[6] ^ d[12] ^ d[30] ^ d[24] ^ c[1] ^ d[7] ^ c[28] ^ c[21] ^ c[3] ^ d[26] ^ d[18] ^ c[13] ^ d[2] ^ d[11] ^ d[28] ^ c[5] ^ d[21] ^ d[31] ^ c[7] ; +o[6] = d[23] ^ d[6] ^ c[20] ^ c[2] ^ d[25] ^ c[29] ^ c[30] ^ d[17] ^ c[22] ^ d[1] ^ d[10] ^ d[27] ^ c[4] ^ d[20] ^ c[14] ^ d[30] ^ d[29] ^ c[6] ^ c[8] ^ d[24] ^ c[1] ^ c[11] ^ c[21] ^ d[26] ^ d[9] ^ d[2] ^ d[11] ^ c[5] ^ c[25] ^ c[7] ; +o[7] = c[0] ^ d[23] ^ d[6] ^ d[15] ^ c[10] ^ c[2] ^ c[29] ^ d[8] ^ d[10] ^ c[22] ^ c[24] ^ d[3] ^ d[29] ^ c[16] ^ c[8] ^ d[24] ^ d[7] ^ c[28] ^ d[16] ^ c[21] ^ c[3] ^ d[26] ^ d[9] ^ d[2] ^ c[23] ^ d[28] ^ c[5] ^ c[15] ^ d[21] ^ d[31] ^ c[25] ^ c[7] ; +o[8] = c[0] ^ c[17] ^ d[23] ^ c[10] ^ c[12] ^ d[8] ^ c[22] ^ d[27] ^ c[4] ^ d[19] ^ d[20] ^ d[3] ^ d[30] ^ d[14] ^ c[8] ^ c[1] ^ c[28] ^ c[11] ^ d[0] ^ c[3] ^ c[31] ^ d[9] ^ c[23] ^ d[28] ^ d[21] ^ d[31] ; +o[9] = c[9] ^ c[2] ^ c[29] ^ d[8] ^ c[12] ^ d[27] ^ c[4] ^ d[20] ^ d[19] ^ d[30] ^ d[29] ^ c[24] ^ d[22] ^ c[1] ^ c[18] ^ c[11] ^ d[7] ^ d[26] ^ d[18] ^ c[13] ^ d[2] ^ c[23] ^ c[5] ^ d[13] ; +o[10] = c[0] ^ d[15] ^ c[9] ^ c[19] ^ c[2] ^ c[29] ^ d[17] ^ c[14] ^ d[3] ^ d[12] ^ d[29] ^ c[16] ^ d[22] ^ d[5] ^ c[26] ^ c[28] ^ d[0] ^ c[3] ^ d[26] ^ c[31] ^ d[18] ^ c[13] ^ d[2] ^ d[28] ^ c[5] ^ d[31] ; +o[11] = c[0] ^ c[17] ^ c[27] ^ d[6] ^ d[15] ^ c[9] ^ c[20] ^ c[12] ^ d[17] ^ d[27] ^ c[4] ^ d[19] ^ c[14] ^ c[24] ^ d[3] ^ d[30] ^ c[16] ^ d[22] ^ d[5] ^ c[26] ^ d[14] ^ c[1] ^ d[7] ^ c[28] ^ d[16] ^ d[0] ^ c[3] ^ c[31] ^ d[11] ^ d[28] ^ c[15] ^ d[31] ^ d[4] ^ c[25] ; +o[12] = c[0] ^ c[17] ^ c[27] ^ c[9] ^ d[25] ^ c[2] ^ c[30] ^ c[12] ^ d[1] ^ d[10] ^ d[27] ^ c[4] ^ d[19] ^ c[24] ^ c[6] ^ d[30] ^ d[29] ^ d[22] ^ d[14] ^ c[18] ^ c[1] ^ d[7] ^ d[16] ^ d[0] ^ c[21] ^ d[26] ^ c[31] ^ d[18] ^ c[13] ^ c[5] ^ c[15] ^ d[31] ^ d[13] ^ d[4] ; +o[13] = d[6] ^ d[15] ^ c[10] ^ c[19] ^ c[2] ^ d[25] ^ d[17] ^ c[22] ^ c[14] ^ d[30] ^ d[12] ^ d[3] ^ d[29] ^ c[6] ^ c[16] ^ d[24] ^ c[1] ^ c[18] ^ c[28] ^ d[0] ^ c[3] ^ d[26] ^ d[18] ^ c[31] ^ d[9] ^ c[13] ^ d[28] ^ c[5] ^ d[21] ^ c[25] ^ c[7] ^ d[13] ; +o[14] = d[23] ^ c[17] ^ c[20] ^ c[2] ^ c[19] ^ d[25] ^ d[17] ^ c[29] ^ d[8] ^ d[27] ^ c[4] ^ c[14] ^ d[20] ^ d[29] ^ d[12] ^ c[6] ^ d[5] ^ c[26] ^ d[14] ^ c[8] ^ d[24] ^ c[11] ^ d[16] ^ c[3] ^ d[11] ^ d[2] ^ c[23] ^ d[28] ^ c[15] ^ c[7] ; +o[15] = d[23] ^ c[27] ^ c[9] ^ d[15] ^ c[20] ^ c[30] ^ c[12] ^ d[10] ^ d[1] ^ d[27] ^ c[4] ^ d[19] ^ c[24] ^ d[22] ^ c[16] ^ c[8] ^ c[18] ^ d[24] ^ d[16] ^ d[7] ^ c[21] ^ c[3] ^ d[26] ^ d[28] ^ d[11] ^ c[5] ^ c[15] ^ d[4] ^ d[13] ^ c[7] ; +o[16] = c[0] ^ c[17] ^ d[23] ^ c[19] ^ c[30] ^ c[12] ^ c[29] ^ d[1] ^ d[10] ^ c[22] ^ d[27] ^ c[4] ^ d[19] ^ c[24] ^ d[12] ^ d[5] ^ c[26] ^ d[14] ^ c[8] ^ d[7] ^ c[21] ^ d[26] ^ d[9] ^ d[18] ^ c[13] ^ d[2] ^ c[5] ^ d[31] ; +o[17] = d[6] ^ c[27] ^ c[9] ^ c[20] ^ d[25] ^ d[8] ^ c[30] ^ d[17] ^ c[22] ^ d[1] ^ c[14] ^ d[30] ^ c[6] ^ d[22] ^ c[1] ^ c[18] ^ d[0] ^ d[26] ^ d[18] ^ c[31] ^ d[9] ^ c[13] ^ c[23] ^ d[11] ^ c[5] ^ c[25] ^ d[4] ^ d[13] ; +o[18] = c[10] ^ c[2] ^ d[25] ^ c[19] ^ d[17] ^ d[8] ^ d[10] ^ c[14] ^ d[29] ^ c[24] ^ d[3] ^ c[6] ^ d[12] ^ d[5] ^ c[26] ^ d[24] ^ d[7] ^ c[28] ^ d[16] ^ d[0] ^ c[21] ^ c[31] ^ c[23] ^ c[15] ^ d[21] ^ c[7] ; +o[19] = d[23] ^ c[27] ^ d[6] ^ d[15] ^ c[20] ^ c[29] ^ c[22] ^ d[20] ^ c[24] ^ c[16] ^ c[8] ^ d[24] ^ d[16] ^ d[7] ^ c[11] ^ c[3] ^ d[9] ^ d[28] ^ d[2] ^ d[11] ^ c[15] ^ d[4] ^ c[25] ^ c[7] ; +o[20] = d[23] ^ c[17] ^ d[15] ^ d[6] ^ c[9] ^ c[30] ^ d[8] ^ c[12] ^ d[27] ^ d[1] ^ c[4] ^ d[10] ^ d[19] ^ d[3] ^ c[16] ^ d[22] ^ d[5] ^ c[26] ^ d[14] ^ c[8] ^ c[28] ^ c[21] ^ c[23] ^ c[25] ; +o[21] = c[17] ^ c[27] ^ c[9] ^ c[10] ^ c[29] ^ c[22] ^ c[24] ^ d[22] ^ d[14] ^ d[5] ^ c[26] ^ c[18] ^ d[7] ^ d[26] ^ d[0] ^ c[31] ^ d[9] ^ d[18] ^ c[13] ^ d[2] ^ c[5] ^ d[21] ^ d[4] ^ d[13] ; +o[22] = c[0] ^ c[27] ^ d[15] ^ c[9] ^ c[19] ^ c[12] ^ c[29] ^ d[8] ^ d[17] ^ d[19] ^ d[20] ^ c[14] ^ c[24] ^ d[12] ^ c[16] ^ d[22] ^ d[5] ^ c[26] ^ c[18] ^ d[7] ^ c[11] ^ d[0] ^ c[31] ^ d[2] ^ c[23] ^ d[31] ^ d[13] ^ d[4] ; +o[23] = c[0] ^ c[17] ^ c[27] ^ d[15] ^ c[9] ^ d[25] ^ c[19] ^ c[20] ^ c[29] ^ c[6] ^ d[12] ^ d[30] ^ c[16] ^ d[22] ^ d[5] ^ c[26] ^ d[14] ^ c[1] ^ d[16] ^ d[0] ^ c[31] ^ d[18] ^ c[13] ^ d[2] ^ d[11] ^ c[15] ^ d[31] ^ d[4] ; +o[24] = c[17] ^ d[15] ^ c[27] ^ c[10] ^ c[20] ^ c[2] ^ c[30] ^ d[17] ^ d[1] ^ d[10] ^ c[14] ^ d[30] ^ d[3] ^ d[29] ^ c[16] ^ d[14] ^ d[24] ^ c[1] ^ c[18] ^ c[28] ^ c[21] ^ d[11] ^ d[21] ^ d[4] ^ c[7] ^ d[13] ; +o[25] = d[23] ^ c[17] ^ c[2] ^ c[19] ^ c[29] ^ d[10] ^ c[22] ^ d[20] ^ d[29] ^ d[3] ^ d[12] ^ d[14] ^ c[8] ^ c[18] ^ c[28] ^ c[11] ^ d[16] ^ d[0] ^ c[21] ^ c[3] ^ c[31] ^ d[9] ^ d[2] ^ d[28] ^ c[15] ^ d[13] ; +o[26] = c[0] ^ d[6] ^ c[10] ^ d[25] ^ c[19] ^ c[20] ^ d[8] ^ c[22] ^ d[27] ^ c[4] ^ c[24] ^ d[3] ^ c[6] ^ d[12] ^ d[5] ^ c[26] ^ c[18] ^ d[7] ^ c[28] ^ d[0] ^ c[3] ^ c[31] ^ d[9] ^ d[11] ^ d[28] ^ c[23] ^ d[21] ^ d[31] ^ d[13] ^ c[25] ; +o[27] = d[6] ^ c[27] ^ c[19] ^ c[20] ^ c[29] ^ d[8] ^ d[10] ^ d[27] ^ c[4] ^ d[20] ^ d[30] ^ d[12] ^ c[24] ^ d[5] ^ c[26] ^ d[24] ^ c[1] ^ c[11] ^ d[7] ^ c[21] ^ d[26] ^ d[2] ^ c[23] ^ d[11] ^ c[5] ^ c[25] ^ d[4] ^ c[7] ; +o[28] = d[23] ^ c[27] ^ d[6] ^ c[20] ^ c[2] ^ d[25] ^ c[30] ^ c[12] ^ d[1] ^ d[10] ^ c[22] ^ d[19] ^ d[29] ^ c[24] ^ d[3] ^ c[6] ^ d[5] ^ c[26] ^ c[8] ^ d[7] ^ c[28] ^ c[21] ^ d[26] ^ d[9] ^ d[11] ^ c[5] ^ d[4] ^ c[25] ; +o[29] = c[27] ^ d[6] ^ c[9] ^ d[25] ^ c[29] ^ d[8] ^ d[10] ^ c[22] ^ d[3] ^ c[6] ^ d[22] ^ d[5] ^ c[26] ^ d[24] ^ c[28] ^ d[0] ^ c[21] ^ c[3] ^ c[31] ^ d[9] ^ d[18] ^ c[13] ^ d[28] ^ d[2] ^ c[23] ^ d[4] ^ c[25] ^ c[7] ; +o[30] = d[23] ^ c[10] ^ c[27] ^ c[29] ^ c[30] ^ d[8] ^ d[17] ^ d[27] ^ c[22] ^ d[1] ^ c[4] ^ c[14] ^ d[3] ^ c[24] ^ d[5] ^ c[26] ^ c[8] ^ d[24] ^ c[28] ^ d[7] ^ d[9] ^ d[2] ^ c[23] ^ d[21] ^ d[4] ^ c[7] ; +o[31] = d[23] ^ c[27] ^ d[6] ^ c[9] ^ d[8] ^ c[29] ^ c[30] ^ d[1] ^ d[20] ^ c[24] ^ d[3] ^ d[22] ^ c[8] ^ c[11] ^ d[7] ^ d[16] ^ c[28] ^ d[26] ^ d[0] ^ c[31] ^ d[2] ^ c[23] ^ c[5] ^ c[15] ^ d[4] ^ c[25] ; + crc4B = o; + end + endfunction // crc4B + + //////////////////////////////////////////////// + // crc3B + //////////////////////////////////////////////// + function [31:0] crc3B ( + input [31:0] c, + input [23:0] d + ); + reg [31:0] o; + begin +o[0] = d[23] ^ c[17] ^ c[20] ^ d[17] ^ c[14] ^ c[24] ^ c[8] ^ d[14] ^ c[18] ^ d[7] ^ d[11] ^ d[13] ; +o[1] = d[23] ^ c[17] ^ d[6] ^ c[9] ^ c[20] ^ c[19] ^ d[17] ^ d[10] ^ c[14] ^ c[24] ^ d[12] ^ d[22] ^ d[14] ^ c[8] ^ d[7] ^ d[16] ^ c[21] ^ d[11] ^ c[15] ^ c[25] ; +o[2] = d[23] ^ c[17] ^ d[6] ^ c[9] ^ d[15] ^ c[10] ^ d[17] ^ d[10] ^ c[22] ^ c[14] ^ c[24] ^ d[22] ^ c[16] ^ d[5] ^ c[26] ^ d[14] ^ c[8] ^ d[7] ^ d[16] ^ c[21] ^ d[9] ^ c[15] ^ d[21] ^ c[25] ; +o[3] = c[17] ^ c[27] ^ d[6] ^ c[9] ^ d[15] ^ c[10] ^ d[8] ^ c[22] ^ d[20] ^ d[22] ^ c[16] ^ d[5] ^ c[26] ^ d[14] ^ c[18] ^ d[16] ^ c[11] ^ d[9] ^ c[23] ^ c[15] ^ d[21] ^ d[4] ^ c[25] ^ d[13] ; +o[4] = d[23] ^ c[27] ^ d[15] ^ c[10] ^ c[20] ^ c[19] ^ d[17] ^ d[8] ^ c[12] ^ c[14] ^ d[20] ^ d[19] ^ d[3] ^ d[12] ^ c[16] ^ d[5] ^ c[26] ^ c[8] ^ c[28] ^ c[11] ^ d[11] ^ c[23] ^ d[21] ^ d[4] ; +o[5] = d[23] ^ c[27] ^ c[9] ^ d[17] ^ c[29] ^ c[12] ^ d[10] ^ c[14] ^ d[20] ^ d[19] ^ d[3] ^ d[22] ^ c[8] ^ c[18] ^ c[28] ^ d[16] ^ c[11] ^ c[21] ^ d[18] ^ c[13] ^ d[2] ^ c[15] ^ d[4] ^ d[13] ; +o[6] = c[9] ^ d[15] ^ c[10] ^ c[19] ^ c[30] ^ c[29] ^ c[12] ^ d[17] ^ d[1] ^ c[22] ^ d[19] ^ c[14] ^ d[3] ^ d[12] ^ d[22] ^ c[16] ^ d[16] ^ c[28] ^ d[9] ^ d[18] ^ c[13] ^ d[2] ^ c[15] ^ d[21] ; +o[7] = d[23] ^ d[15] ^ c[10] ^ c[29] ^ c[30] ^ d[8] ^ d[1] ^ d[20] ^ c[24] ^ c[16] ^ c[8] ^ c[18] ^ d[7] ^ c[11] ^ d[16] ^ d[0] ^ c[31] ^ d[18] ^ c[13] ^ d[2] ^ c[23] ^ d[21] ^ c[15] ^ d[13] ; +o[8] = d[23] ^ d[6] ^ c[9] ^ d[15] ^ c[20] ^ c[19] ^ c[30] ^ c[12] ^ d[1] ^ d[20] ^ d[19] ^ d[12] ^ d[22] ^ c[16] ^ c[8] ^ c[18] ^ c[11] ^ d[0] ^ c[31] ^ d[11] ^ d[13] ^ c[25] ; +o[9] = c[17] ^ c[9] ^ c[10] ^ c[19] ^ c[20] ^ c[12] ^ d[10] ^ d[19] ^ d[12] ^ d[22] ^ d[5] ^ c[26] ^ d[14] ^ d[0] ^ c[21] ^ c[31] ^ d[18] ^ c[13] ^ d[11] ^ d[21] ; +o[10] = d[23] ^ c[17] ^ c[27] ^ c[10] ^ c[22] ^ d[10] ^ d[20] ^ c[24] ^ d[14] ^ c[8] ^ d[7] ^ c[11] ^ c[21] ^ d[9] ^ d[18] ^ c[13] ^ d[21] ^ d[4] ; +o[11] = d[23] ^ c[17] ^ d[6] ^ c[9] ^ c[20] ^ d[8] ^ c[12] ^ c[22] ^ d[20] ^ d[19] ^ c[24] ^ d[3] ^ d[22] ^ d[14] ^ c[8] ^ d[7] ^ c[28] ^ c[11] ^ d[9] ^ d[11] ^ c[23] ^ c[25] ; +o[12] = d[23] ^ c[17] ^ d[6] ^ c[9] ^ c[10] ^ c[20] ^ d[17] ^ c[29] ^ d[8] ^ c[12] ^ d[10] ^ c[14] ^ d[19] ^ d[22] ^ d[5] ^ c[26] ^ d[14] ^ c[8] ^ c[21] ^ d[18] ^ c[13] ^ d[11] ^ d[2] ^ c[23] ^ d[21] ^ c[25] ; +o[13] = c[27] ^ c[9] ^ c[10] ^ c[30] ^ d[17] ^ d[10] ^ d[1] ^ c[22] ^ d[20] ^ c[14] ^ c[24] ^ d[22] ^ d[5] ^ c[26] ^ c[18] ^ d[16] ^ d[7] ^ c[11] ^ c[21] ^ d[9] ^ d[18] ^ c[13] ^ c[15] ^ d[21] ^ d[4] ^ d[13] ; +o[14] = d[15] ^ d[6] ^ c[10] ^ c[27] ^ c[19] ^ d[8] ^ c[12] ^ d[17] ^ c[22] ^ d[20] ^ d[19] ^ c[14] ^ d[3] ^ d[12] ^ c[16] ^ c[28] ^ c[11] ^ d[16] ^ d[0] ^ d[9] ^ c[31] ^ c[23] ^ d[21] ^ c[15] ^ c[25] ^ d[4] ; +o[15] = c[17] ^ d[15] ^ c[20] ^ d[8] ^ c[29] ^ c[12] ^ d[20] ^ d[19] ^ c[24] ^ d[3] ^ c[16] ^ d[14] ^ d[5] ^ c[26] ^ c[11] ^ d[7] ^ c[28] ^ d[16] ^ d[18] ^ c[13] ^ d[2] ^ c[23] ^ d[11] ^ c[15] ; +o[16] = d[23] ^ c[27] ^ d[6] ^ d[15] ^ c[20] ^ c[29] ^ c[30] ^ c[12] ^ d[1] ^ d[10] ^ d[19] ^ c[16] ^ c[8] ^ c[21] ^ d[18] ^ c[13] ^ d[11] ^ d[2] ^ d[4] ^ c[25] ; +o[17] = c[17] ^ c[9] ^ c[30] ^ d[17] ^ d[10] ^ d[1] ^ c[22] ^ c[14] ^ d[3] ^ d[22] ^ d[5] ^ c[26] ^ d[14] ^ c[28] ^ d[0] ^ c[21] ^ c[31] ^ d[18] ^ d[9] ^ c[13] ; +o[18] = c[10] ^ c[27] ^ c[29] ^ d[17] ^ d[8] ^ c[22] ^ c[14] ^ c[18] ^ d[16] ^ d[0] ^ d[9] ^ c[31] ^ d[2] ^ c[23] ^ d[21] ^ c[15] ^ d[4] ^ d[13] ; +o[19] = d[15] ^ c[19] ^ d[8] ^ c[30] ^ d[1] ^ d[20] ^ c[24] ^ d[3] ^ d[12] ^ c[16] ^ c[11] ^ d[16] ^ d[7] ^ c[28] ^ c[23] ^ c[15] ; +o[20] = c[17] ^ d[15] ^ d[6] ^ c[20] ^ c[12] ^ c[29] ^ d[19] ^ c[24] ^ c[16] ^ d[14] ^ d[7] ^ d[0] ^ c[31] ^ d[2] ^ d[11] ^ c[25] ; +o[21] = c[17] ^ d[6] ^ c[30] ^ d[1] ^ d[10] ^ d[14] ^ d[5] ^ c[26] ^ c[18] ^ c[21] ^ d[18] ^ c[13] ^ c[25] ^ d[13] ; +o[22] = d[23] ^ c[17] ^ c[27] ^ c[20] ^ c[19] ^ c[22] ^ c[24] ^ d[12] ^ d[5] ^ c[26] ^ d[14] ^ c[8] ^ d[7] ^ d[0] ^ c[31] ^ d[9] ^ d[11] ^ d[4] ; +o[23] = d[23] ^ c[17] ^ c[27] ^ d[6] ^ c[9] ^ d[17] ^ d[8] ^ d[10] ^ c[14] ^ c[24] ^ d[3] ^ d[22] ^ d[14] ^ c[8] ^ d[7] ^ c[28] ^ c[21] ^ c[23] ^ d[4] ^ c[25] ; +o[24] = c[0] ^ d[6] ^ c[9] ^ c[10] ^ c[29] ^ c[22] ^ c[24] ^ d[3] ^ d[22] ^ d[5] ^ c[26] ^ c[18] ^ d[16] ^ d[7] ^ c[28] ^ d[9] ^ d[2] ^ c[15] ^ d[21] ^ c[25] ^ d[13] ; +o[25] = d[15] ^ d[6] ^ c[10] ^ c[27] ^ c[19] ^ c[29] ^ c[30] ^ d[8] ^ d[1] ^ d[20] ^ d[12] ^ c[16] ^ d[5] ^ c[26] ^ c[1] ^ c[11] ^ d[2] ^ c[23] ^ d[21] ^ c[25] ^ d[4] ; +o[26] = d[23] ^ c[27] ^ c[2] ^ d[17] ^ c[30] ^ c[12] ^ d[1] ^ c[14] ^ d[20] ^ d[19] ^ d[3] ^ d[5] ^ c[26] ^ c[8] ^ c[18] ^ c[28] ^ c[11] ^ d[0] ^ c[31] ^ d[4] ^ d[13] ; +o[27] = c[27] ^ c[9] ^ c[19] ^ c[29] ^ c[12] ^ d[19] ^ d[3] ^ d[12] ^ d[22] ^ d[16] ^ c[28] ^ d[0] ^ c[3] ^ c[31] ^ d[18] ^ c[13] ^ d[2] ^ c[15] ^ d[4] ; +o[28] = d[15] ^ c[10] ^ c[20] ^ c[29] ^ c[30] ^ d[17] ^ d[1] ^ c[4] ^ c[14] ^ d[3] ^ c[16] ^ c[28] ^ d[18] ^ c[13] ^ d[2] ^ d[11] ^ d[21] ; +o[29] = c[17] ^ c[29] ^ c[30] ^ d[17] ^ d[1] ^ d[10] ^ d[20] ^ c[14] ^ d[14] ^ c[11] ^ d[16] ^ d[0] ^ c[21] ^ c[31] ^ d[2] ^ c[5] ^ c[15] ; +o[30] = d[15] ^ c[30] ^ c[12] ^ d[1] ^ c[22] ^ d[19] ^ c[6] ^ c[16] ^ c[18] ^ d[16] ^ d[0] ^ c[31] ^ d[9] ^ c[15] ^ d[13] ; +o[31] = c[17] ^ d[15] ^ c[19] ^ d[8] ^ d[12] ^ c[16] ^ d[14] ^ d[0] ^ d[18] ^ c[31] ^ c[13] ^ c[23] ^ c[7] ; + crc3B = o; + end + endfunction // crc3B + + //////////////////////////////////////////////// + // crc2B + //////////////////////////////////////////////// + function [31:0] crc2B ( + input [31:0] c, + input [15:0] d + ); + reg [31:0] o; + begin +o[0] = d[9] ^ c[22] ^ d[5] ^ c[26] ^ d[15] ^ d[6] ^ d[3] ^ c[28] ^ c[25] ^ c[16] ; +o[1] = c[17] ^ d[15] ^ d[6] ^ c[27] ^ c[29] ^ d[8] ^ c[22] ^ d[3] ^ c[16] ^ d[14] ^ c[28] ^ d[9] ^ c[23] ^ d[2] ^ d[4] ^ c[25] ; +o[2] = c[17] ^ d[15] ^ d[6] ^ d[8] ^ c[29] ^ c[30] ^ c[22] ^ d[1] ^ c[24] ^ c[16] ^ d[14] ^ c[18] ^ d[7] ^ d[9] ^ d[2] ^ c[23] ^ c[25] ^ d[13] ; +o[3] = c[17] ^ d[6] ^ c[19] ^ d[8] ^ c[30] ^ d[1] ^ c[24] ^ d[12] ^ d[14] ^ d[5] ^ c[26] ^ c[18] ^ d[7] ^ d[0] ^ c[31] ^ c[23] ^ d[13] ^ c[25] ; +o[4] = d[15] ^ c[27] ^ c[20] ^ c[19] ^ c[22] ^ d[3] ^ c[24] ^ d[12] ^ c[16] ^ c[18] ^ c[28] ^ d[7] ^ d[0] ^ d[9] ^ c[31] ^ d[11] ^ d[13] ^ d[4] ; +o[5] = c[17] ^ d[15] ^ c[19] ^ c[20] ^ d[8] ^ c[29] ^ c[22] ^ d[10] ^ d[12] ^ c[16] ^ d[5] ^ c[26] ^ d[14] ^ c[21] ^ d[9] ^ d[2] ^ c[23] ^ d[11] ; +o[6] = c[17] ^ c[27] ^ c[20] ^ d[8] ^ c[30] ^ d[1] ^ c[22] ^ d[10] ^ c[24] ^ d[14] ^ c[18] ^ d[7] ^ c[21] ^ d[9] ^ c[23] ^ d[11] ^ d[4] ^ d[13] ; +o[7] = d[15] ^ c[19] ^ d[8] ^ d[10] ^ c[24] ^ d[12] ^ c[16] ^ d[5] ^ c[26] ^ c[18] ^ d[7] ^ d[0] ^ c[21] ^ c[31] ^ c[23] ^ d[13] ; +o[8] = c[17] ^ d[15] ^ c[27] ^ c[19] ^ c[20] ^ d[3] ^ d[12] ^ c[24] ^ c[16] ^ d[5] ^ c[26] ^ d[14] ^ c[28] ^ d[7] ^ d[11] ^ d[4] ; +o[9] = c[17] ^ c[27] ^ d[6] ^ c[20] ^ c[29] ^ d[10] ^ d[3] ^ d[14] ^ c[18] ^ c[28] ^ c[21] ^ d[2] ^ d[11] ^ d[4] ^ d[13] ^ c[25] ; +o[10] = d[15] ^ d[6] ^ c[19] ^ c[30] ^ c[29] ^ d[1] ^ d[10] ^ d[12] ^ c[16] ^ c[18] ^ c[21] ^ d[2] ^ c[25] ^ d[13] ; +o[11] = c[17] ^ d[15] ^ d[6] ^ c[19] ^ c[20] ^ c[30] ^ d[1] ^ d[3] ^ d[12] ^ c[16] ^ d[14] ^ c[28] ^ d[0] ^ c[31] ^ d[11] ^ c[25] ; +o[12] = c[17] ^ d[15] ^ d[6] ^ c[20] ^ c[29] ^ c[22] ^ d[10] ^ d[3] ^ c[16] ^ d[14] ^ c[18] ^ c[28] ^ d[0] ^ c[21] ^ d[9] ^ c[31] ^ d[2] ^ d[11] ^ c[25] ^ d[13] ; +o[13] = c[17] ^ c[19] ^ d[8] ^ c[29] ^ c[30] ^ d[1] ^ d[10] ^ c[22] ^ d[12] ^ d[14] ^ d[5] ^ c[26] ^ c[18] ^ c[21] ^ d[9] ^ d[2] ^ c[23] ^ d[13] ; +o[14] = c[27] ^ c[19] ^ c[20] ^ c[30] ^ d[8] ^ d[1] ^ c[22] ^ c[24] ^ d[12] ^ c[18] ^ d[7] ^ d[0] ^ c[31] ^ d[9] ^ d[11] ^ c[23] ^ d[13] ^ d[4] ; +o[15] = d[6] ^ c[20] ^ c[19] ^ d[8] ^ d[10] ^ d[12] ^ c[24] ^ d[3] ^ d[7] ^ c[28] ^ d[0] ^ c[21] ^ c[31] ^ c[23] ^ d[11] ^ c[25] ; +o[16] = c[0] ^ d[15] ^ c[20] ^ c[29] ^ d[10] ^ d[3] ^ c[24] ^ c[16] ^ c[28] ^ d[7] ^ c[21] ^ d[11] ^ d[2] ; +o[17] = c[17] ^ d[6] ^ c[29] ^ c[30] ^ d[10] ^ d[1] ^ c[22] ^ d[14] ^ c[1] ^ c[21] ^ d[9] ^ d[2] ^ c[25] ; +o[18] = c[2] ^ c[30] ^ d[8] ^ d[1] ^ c[22] ^ c[26] ^ d[5] ^ c[18] ^ d[0] ^ d[9] ^ c[31] ^ c[23] ^ d[13] ; +o[19] = c[27] ^ c[19] ^ d[8] ^ d[12] ^ c[24] ^ d[7] ^ d[0] ^ c[3] ^ c[31] ^ c[23] ^ d[4] ; +o[20] = d[6] ^ c[20] ^ c[4] ^ d[3] ^ c[24] ^ d[7] ^ c[28] ^ d[11] ^ c[25] ; +o[21] = d[6] ^ c[29] ^ d[10] ^ c[26] ^ d[5] ^ c[21] ^ c[5] ^ d[2] ^ c[25] ; +o[22] = d[15] ^ d[6] ^ c[27] ^ c[30] ^ d[1] ^ d[3] ^ c[6] ^ c[16] ^ c[28] ^ c[25] ^ d[4] ; +o[23] = c[17] ^ d[15] ^ d[6] ^ c[29] ^ c[22] ^ c[16] ^ d[14] ^ d[0] ^ d[9] ^ c[31] ^ d[2] ^ c[25] ^ c[7] ; +o[24] = d[14] ^ d[5] ^ c[26] ^ c[17] ^ d[1] ^ c[8] ^ c[23] ^ c[18] ^ d[8] ^ d[13] ^ c[30] ; +o[25] = c[31] ^ c[27] ^ c[18] ^ c[9] ^ d[7] ^ c[24] ^ d[12] ^ c[19] ^ d[13] ^ d[4] ^ d[0] ; +o[26] = d[15] ^ c[10] ^ c[20] ^ c[19] ^ c[22] ^ d[12] ^ c[16] ^ d[5] ^ c[26] ^ d[9] ^ d[11] ; +o[27] = c[17] ^ c[27] ^ c[20] ^ d[8] ^ d[10] ^ d[14] ^ c[11] ^ c[21] ^ c[23] ^ d[11] ^ d[4] ; +o[28] = c[12] ^ c[22] ^ d[10] ^ c[24] ^ d[3] ^ c[18] ^ d[7] ^ c[28] ^ c[21] ^ d[9] ^ d[13] ; +o[29] = d[6] ^ c[19] ^ d[8] ^ c[29] ^ c[22] ^ d[12] ^ c[13] ^ d[9] ^ d[2] ^ c[23] ^ c[25] ; +o[30] = d[5] ^ c[26] ^ d[1] ^ d[11] ^ c[23] ^ c[14] ^ c[20] ^ d[7] ^ c[24] ^ c[30] ^ d[8] ; +o[31] = d[10] ^ c[31] ^ c[27] ^ d[6] ^ d[7] ^ c[24] ^ c[15] ^ d[4] ^ d[0] ^ c[21] ^ c[25] ; + crc2B = o; + end + endfunction // crc2B + + //////////////////////////////////////////////// + // crc1B + //////////////////////////////////////////////// + function [31:0] crc1B ( + input [31:0] c, + input [7:0] d + ); + reg [31:0] o; + begin +o[0] = d[1] ^ d[7] ^ c[24] ^ c[30] ; +o[1] = d[1] ^ c[31] ^ d[6] ^ d[7] ^ c[24] ^ c[30] ^ d[0] ^ c[25] ; +o[2] = d[1] ^ c[31] ^ d[5] ^ c[26] ^ d[6] ^ d[7] ^ c[24] ^ c[30] ^ d[0] ^ c[25] ; +o[3] = c[31] ^ d[5] ^ c[26] ^ d[6] ^ c[27] ^ d[0] ^ c[25] ^ d[4] ; +o[4] = d[1] ^ d[5] ^ c[26] ^ c[27] ^ d[7] ^ c[24] ^ d[3] ^ c[28] ^ c[30] ^ d[4] ; +o[5] = c[27] ^ d[6] ^ c[30] ^ c[29] ^ d[1] ^ d[3] ^ c[24] ^ d[7] ^ c[28] ^ d[0] ^ c[31] ^ d[2] ^ d[4] ^ c[25] ; +o[6] = d[6] ^ c[30] ^ c[29] ^ d[1] ^ d[3] ^ c[26] ^ d[5] ^ c[28] ^ d[0] ^ c[31] ^ d[2] ^ c[25] ; +o[7] = d[5] ^ c[26] ^ c[31] ^ c[27] ^ d[2] ^ d[7] ^ c[24] ^ d[4] ^ c[29] ^ d[0] ; +o[8] = c[0] ^ d[6] ^ c[27] ^ d[7] ^ c[24] ^ d[3] ^ c[28] ^ c[25] ^ d[4] ; +o[9] = d[5] ^ c[26] ^ d[6] ^ d[2] ^ c[1] ^ d[3] ^ c[28] ^ c[25] ^ c[29] ; +o[10] = d[5] ^ c[26] ^ c[27] ^ d[2] ^ d[7] ^ c[24] ^ c[2] ^ d[4] ^ c[29] ; +o[11] = d[6] ^ c[27] ^ d[7] ^ c[24] ^ d[3] ^ c[28] ^ c[25] ^ d[4] ^ c[3] ; +o[12] = d[6] ^ c[29] ^ c[30] ^ d[1] ^ c[4] ^ d[3] ^ c[24] ^ c[26] ^ d[5] ^ d[7] ^ c[28] ^ d[2] ^ c[25] ; +o[13] = d[6] ^ c[27] ^ c[30] ^ c[29] ^ d[1] ^ c[26] ^ d[5] ^ d[0] ^ c[31] ^ c[5] ^ d[2] ^ d[4] ^ c[25] ; +o[14] = d[5] ^ c[26] ^ d[1] ^ c[31] ^ c[27] ^ d[3] ^ c[28] ^ c[6] ^ d[4] ^ c[30] ^ d[0] ; +o[15] = c[31] ^ c[27] ^ d[2] ^ d[3] ^ c[28] ^ d[4] ^ c[29] ^ d[0] ^ c[7] ; +o[16] = c[8] ^ d[2] ^ d[7] ^ c[24] ^ d[3] ^ c[28] ^ c[29] ; +o[17] = d[1] ^ d[6] ^ d[2] ^ c[9] ^ c[25] ^ c[29] ^ c[30] ; +o[18] = d[5] ^ c[26] ^ d[1] ^ c[31] ^ c[10] ^ c[30] ^ d[0] ; +o[19] = c[31] ^ c[27] ^ c[11] ^ d[4] ^ d[0] ; +o[20] = d[3] ^ c[28] ^ c[12] ; +o[21] = c[13] ^ d[2] ^ c[29] ; +o[22] = c[14] ^ d[7] ^ c[24] ; +o[23] = d[1] ^ d[6] ^ d[7] ^ c[24] ^ c[15] ^ c[30] ^ c[25] ; +o[24] = c[31] ^ d[5] ^ c[26] ^ d[6] ^ d[0] ^ c[25] ^ c[16] ; +o[25] = d[5] ^ c[26] ^ c[17] ^ c[27] ^ d[4] ; +o[26] = d[1] ^ c[27] ^ c[18] ^ d[7] ^ c[24] ^ d[3] ^ c[28] ^ c[30] ^ d[4] ; +o[27] = c[31] ^ d[6] ^ d[2] ^ d[3] ^ c[28] ^ c[19] ^ d[0] ^ c[25] ^ c[29] ; +o[28] = d[5] ^ c[26] ^ d[1] ^ d[2] ^ c[20] ^ c[29] ^ c[30] ; +o[29] = d[1] ^ c[31] ^ c[27] ^ d[4] ^ c[30] ^ d[0] ^ c[21] ; +o[30] = c[31] ^ c[22] ^ d[3] ^ c[28] ^ d[0] ; +o[31] = d[2] ^ c[23] ^ c[29] ; + crc1B = o; + end + endfunction // crc1B + +////////////////////////////////////////////////////////////////////////////// +////////////////////////////////////////////////////////////////////////////// \ No newline at end of file diff --git a/hdl_cores/freedom/fpga-shells/wit-manifest.json b/hdl_cores/freedom/fpga-shells/wit-manifest.json new file mode 100644 index 0000000..56bd80b --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/wit-manifest.json @@ -0,0 +1,32 @@ +[ + { + "commit": "50b9d6ffdfbff683fa25045d7f1ef3585a34f2dc", + "name": "api-generator-sifive", + "source": "git@github.com:sifive/api-generator-sifive.git" + }, + { + "commit": "4374e58fc282f9670605ce5a741436d18242e520", + "name": "sifive-blocks", + "source": "git@github.com:sifive/sifive-blocks.git" + }, + { + "commit": "e44e22beccdd5e1e43fd8a35f7c9c5687c821326", + "name": "rocket-chip", + "source": "git@github.com:chipsalliance/rocket-chip.git" + }, + { + "commit": "e1aa5f3f5c0cdeb204047c3ca50801d9f7ea25f1", + "name": "chisel3", + "source": "git@github.com:freechipsproject/chisel3.git" + }, + { + "commit": "228c9a4b7432ac52178d63b8f27fe064aec71e9c", + "name": "firrtl", + "source": "git@github.com:freechipsproject/firrtl.git" + }, + { + "commit": "9c4bcd00b1d3c2ca667e330303ee8fa26432d687", + "name": "api-scala-sifive", + "source": "git@github.com:sifive/api-scala-sifive.git" + } +] diff --git a/hdl_cores/freedom/fpga-shells/xilinx/Makefile b/hdl_cores/freedom/fpga-shells/xilinx/Makefile new file mode 100644 index 0000000..1416927 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/xilinx/Makefile @@ -0,0 +1,42 @@ +VIVADO ?= vivado +VIVADOFLAGS := \ + -nojournal -mode batch \ + -source $(fpga_board_script_dir)/board.tcl \ + -source $(fpga_common_script_dir)/prologue.tcl + +# Path to a program in raw binary format to be flashed into the address that the +# bootrom jumps to. +# FIXME: This variable should probably be communicated by a higher-level Makefile +FLASHED_PROGRAM ?= + +# Init project +init = $(FPGA_BUILD_DIR)/.init +$(init): $(fpga_common_script_dir)/init.tcl + mkdir -p $(FPGA_BUILD_DIR) && \ + cd $(FPGA_BUILD_DIR) && \ + VSRCS="$(VSRCS)" IPVIVADOTCLS="$(IPVIVADOTCLS)" $(VIVADO) $(VIVADOFLAGS) -source $< + +.PHONY: init +init: $(init) + +# Generate bitstream +bit := $(FPGA_BUILD_DIR)/obj/$(FPGA_TOP_SYSTEM).bit +$(bit): $(fpga_common_script_dir)/vivado.tcl $(init) + cd $(FPGA_BUILD_DIR) && \ + VSRCS="$(VSRCS)" $(VIVADO) $(VIVADOFLAGS) -source $< + +.PHONY: bit +bit: $(bit) + +# Generate mcs +mcs := $(FPGA_BUILD_DIR)/obj/system.mcs +$(mcs): $(bit) + cd $(FPGA_BUILD_DIR) && \ + $(VIVADO) $(VIVADOFLAGS) $(fpga_common_script_dir)/write_cfgmem.tcl -tclargs $(BOARD) $@ $^ $(FLASHED_PROGRAM) + +.PHONY: mcs +mcs: $(mcs) + +.PHONY: clean +clean:: + rm -rf $(FPGA_BUILD_DIR) diff --git a/hdl_cores/freedom/fpga-shells/xilinx/arty/constraints/arty-config.xdc b/hdl_cores/freedom/fpga-shells/xilinx/arty/constraints/arty-config.xdc new file mode 100644 index 0000000..a455c22 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/xilinx/arty/constraints/arty-config.xdc @@ -0,0 +1,5 @@ +set_property -dict [list \ + CONFIG_VOLTAGE {3.3} \ + CFGBVS {VCCO} \ + BITSTREAM.CONFIG.SPI_BUSWIDTH {4} \ + ] [current_design] diff --git a/hdl_cores/freedom/fpga-shells/xilinx/arty/constraints/arty-master.xdc b/hdl_cores/freedom/fpga-shells/xilinx/arty/constraints/arty-master.xdc new file mode 100644 index 0000000..c434697 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/xilinx/arty/constraints/arty-master.xdc @@ -0,0 +1,240 @@ +## This file is a general .xdc for the ARTY Rev. B +## To use it in a project: +## - uncomment the lines corresponding to used pins +## - rename the used ports (in each line, after get_ports) according to the top level signal names in the project + +## Clock signal + +set_property -dict { PACKAGE_PIN E3 IOSTANDARD LVCMOS33 } [get_ports { CLK100MHZ }]; #IO_L12P_T1_MRCC_35 Sch=gclk[100] +create_clock -add -name sys_clk_pin -period 10.00 -waveform {0 5} [get_ports {CLK100MHZ}]; +create_clock -add -name JTCK -period 100 -waveform {0 50} [get_ports {jd_2}]; + +##Switches + +set_property -dict { PACKAGE_PIN A8 IOSTANDARD LVCMOS33 } [get_ports { sw_0 }]; #IO_L12N_T1_MRCC_16 Sch=sw[0] +set_property -dict { PACKAGE_PIN C11 IOSTANDARD LVCMOS33 } [get_ports { sw_1 }]; #IO_L13P_T2_MRCC_16 Sch=sw[1] +set_property -dict { PACKAGE_PIN C10 IOSTANDARD LVCMOS33 } [get_ports { sw_2 }]; #IO_L13N_T2_MRCC_16 Sch=sw[2] +set_property -dict { PACKAGE_PIN A10 IOSTANDARD LVCMOS33 } [get_ports { sw_3 }]; #IO_L14P_T2_SRCC_16 Sch=sw[3] + +##RGB LEDs + +set_property -dict { PACKAGE_PIN E1 IOSTANDARD LVCMOS33 } [get_ports { led0_b }]; #IO_L18N_T2_35 Sch=led0_b +set_property -dict { PACKAGE_PIN F6 IOSTANDARD LVCMOS33 } [get_ports { led0_g }]; #IO_L19N_T3_VREF_35 Sch=led0_g +set_property -dict { PACKAGE_PIN G6 IOSTANDARD LVCMOS33 } [get_ports { led0_r }]; #IO_L19P_T3_35 Sch=led0_r +set_property -dict { PACKAGE_PIN G4 IOSTANDARD LVCMOS33 } [get_ports { led1_b }]; #IO_L20P_T3_35 Sch=led1_b +set_property -dict { PACKAGE_PIN J4 IOSTANDARD LVCMOS33 } [get_ports { led1_g }]; #IO_L21P_T3_DQS_35 Sch=led1_g +set_property -dict { PACKAGE_PIN G3 IOSTANDARD LVCMOS33 } [get_ports { led1_r }]; #IO_L20N_T3_35 Sch=led1_r +set_property -dict { PACKAGE_PIN H4 IOSTANDARD LVCMOS33 } [get_ports { led2_b }]; #IO_L21N_T3_DQS_35 Sch=led2_b +set_property -dict { PACKAGE_PIN J2 IOSTANDARD LVCMOS33 } [get_ports { led2_g }]; #IO_L22N_T3_35 Sch=led2_g +set_property -dict { PACKAGE_PIN J3 IOSTANDARD LVCMOS33 } [get_ports { led2_r }]; #IO_L22P_T3_35 Sch=led2_r +#set_property -dict { PACKAGE_PIN K2 IOSTANDARD LVCMOS33 } [get_ports { led3_b }]; #IO_L23P_T3_35 Sch=led3_b +#set_property -dict { PACKAGE_PIN H6 IOSTANDARD LVCMOS33 } [get_ports { led3_g }]; #IO_L24P_T3_35 Sch=led3_g +#set_property -dict { PACKAGE_PIN K1 IOSTANDARD LVCMOS33 } [get_ports { led3_r }]; #IO_L23N_T3_35 Sch=led3_r + +##LEDs + +set_property -dict { PACKAGE_PIN H5 IOSTANDARD LVCMOS33 } [get_ports { led_0 }]; #IO_L24N_T3_35 Sch=led[4] +set_property -dict { PACKAGE_PIN J5 IOSTANDARD LVCMOS33 } [get_ports { led_1 }]; #IO_25_35 Sch=led[5] +set_property -dict { PACKAGE_PIN T9 IOSTANDARD LVCMOS33 } [get_ports { led_2 }]; #IO_L24P_T3_A01_D17_14 Sch=led[6] +set_property -dict { PACKAGE_PIN T10 IOSTANDARD LVCMOS33 } [get_ports { led_3 }]; #IO_L24N_T3_A00_D16_14 Sch=led[7] + +##Buttons + +set_property -dict { PACKAGE_PIN D9 IOSTANDARD LVCMOS33 } [get_ports { btn_0 }]; #IO_L6N_T0_VREF_16 Sch=btn[0] +set_property -dict { PACKAGE_PIN C9 IOSTANDARD LVCMOS33 } [get_ports { btn_1 }]; #IO_L11P_T1_SRCC_16 Sch=btn[1] +set_property -dict { PACKAGE_PIN B9 IOSTANDARD LVCMOS33 } [get_ports { btn_2 }]; #IO_L11N_T1_SRCC_16 Sch=btn[2] +set_property -dict { PACKAGE_PIN B8 IOSTANDARD LVCMOS33 } [get_ports { btn_3 }]; #IO_L12P_T1_MRCC_16 Sch=btn[3] + +##Pmod Header JA + +set_property -dict { PACKAGE_PIN G13 IOSTANDARD LVCMOS33 } [get_ports { ja_0 }]; #IO_0_15 Sch=ja[1] +set_property -dict { PACKAGE_PIN B11 IOSTANDARD LVCMOS33 } [get_ports { ja_1 }]; #IO_L4P_T0_15 Sch=ja[2] +set_property -dict { PACKAGE_PIN A11 IOSTANDARD LVCMOS33 } [get_ports { ja_2 }]; #IO_L4N_T0_15 Sch=ja[3] +set_property -dict { PACKAGE_PIN D12 IOSTANDARD LVCMOS33 } [get_ports { ja_3 }]; #IO_L6P_T0_15 Sch=ja[4] +set_property -dict { PACKAGE_PIN D13 IOSTANDARD LVCMOS33 } [get_ports { ja_4 }]; #IO_L6N_T0_VREF_15 Sch=ja[7] +set_property -dict { PACKAGE_PIN B18 IOSTANDARD LVCMOS33 } [get_ports { ja_5 }]; #IO_L10P_T1_AD11P_15 Sch=ja[8] +set_property -dict { PACKAGE_PIN A18 IOSTANDARD LVCMOS33 } [get_ports { ja_6 }]; #IO_L10N_T1_AD11N_15 Sch=ja[9] +set_property -dict { PACKAGE_PIN K16 IOSTANDARD LVCMOS33 } [get_ports { ja_7 }]; #IO_25_15 Sch=ja[10] + +##Pmod Header JB + +#set_property -dict { PACKAGE_PIN E15 IOSTANDARD LVCMOS33 } [get_ports { jb_0 }]; #IO_L11P_T1_SRCC_15 Sch=jb_p[1] +#set_property -dict { PACKAGE_PIN E16 IOSTANDARD LVCMOS33 } [get_ports { jb_1 }]; #IO_L11N_T1_SRCC_15 Sch=jb_n[1] +#set_property -dict { PACKAGE_PIN D15 IOSTANDARD LVCMOS33 } [get_ports { jb_2 }]; #IO_L12P_T1_MRCC_15 Sch=jb_p[2] +#set_property -dict { PACKAGE_PIN C15 IOSTANDARD LVCMOS33 } [get_ports { jb_3 }]; #IO_L12N_T1_MRCC_15 Sch=jb_n[2] +#set_property -dict { PACKAGE_PIN J17 IOSTANDARD LVCMOS33 } [get_ports { jb_4 }]; #IO_L23P_T3_FOE_B_15 Sch=jb_p[3] +#set_property -dict { PACKAGE_PIN J18 IOSTANDARD LVCMOS33 } [get_ports { jb_5 }]; #IO_L23N_T3_FWE_B_15 Sch=jb_n[3] +#set_property -dict { PACKAGE_PIN K15 IOSTANDARD LVCMOS33 } [get_ports { jb_6 }]; #IO_L24P_T3_RS1_15 Sch=jb_p[4] +#set_property -dict { PACKAGE_PIN J15 IOSTANDARD LVCMOS33 } [get_ports { jb_7 }]; #IO_L24N_T3_RS0_15 Sch=jb_n[4] + +##Pmod Header JC + +set_property -dict { PACKAGE_PIN U12 IOSTANDARD LVCMOS33 } [get_ports { jc_0 }]; #IO_L20P_T3_A08_D24_14 Sch=jc_p[1] +set_property -dict { PACKAGE_PIN V12 IOSTANDARD LVCMOS33 } [get_ports { jc_1 }]; #IO_L20N_T3_A07_D23_14 Sch=jc_n[1] +set_property -dict { PACKAGE_PIN V10 IOSTANDARD LVCMOS33 } [get_ports { jc_2 }]; #IO_L21P_T3_DQS_14 Sch=jc_p[2] +set_property -dict { PACKAGE_PIN V11 IOSTANDARD LVCMOS33 } [get_ports { jc_3 }]; #IO_L21N_T3_DQS_A06_D22_14 Sch=jc_n[2] +set_property -dict { PACKAGE_PIN U14 IOSTANDARD LVCMOS33 } [get_ports { jc_4 }]; #IO_L22P_T3_A05_D21_14 Sch=jc_p[3] +set_property -dict { PACKAGE_PIN V14 IOSTANDARD LVCMOS33 } [get_ports { jc_5 }]; #IO_L22N_T3_A04_D20_14 Sch=jc_n[3] +set_property -dict { PACKAGE_PIN T13 IOSTANDARD LVCMOS33 } [get_ports { jc_6 }]; #IO_L23P_T3_A03_D19_14 Sch=jc_p[4] +set_property -dict { PACKAGE_PIN U13 IOSTANDARD LVCMOS33 } [get_ports { jc_7 }]; #IO_L23N_T3_A02_D18_14 Sch=jc_n[4] + +##Pmod Header JD + +set_property -dict { PACKAGE_PIN D4 IOSTANDARD LVCMOS33 } [get_ports { jd_0 }]; #IO_L11N_T1_SRCC_35 Sch=jd[1] +set_property -dict { PACKAGE_PIN D3 IOSTANDARD LVCMOS33 } [get_ports { jd_1 }]; #IO_L12N_T1_MRCC_35 Sch=jd[2] +set_property -dict { PACKAGE_PIN F4 IOSTANDARD LVCMOS33 } [get_ports { jd_2 }]; #IO_L13P_T2_MRCC_35 Sch=jd[3] +#set_property -dict { PACKAGE_PIN F3 IOSTANDARD LVCMOS33 } [get_ports { jd_3 }]; #IO_L13N_T2_MRCC_35 Sch=jd[4] +set_property -dict { PACKAGE_PIN E2 IOSTANDARD LVCMOS33 } [get_ports { jd_4 }]; #IO_L14P_T2_SRCC_35 Sch=jd[7] +set_property -dict { PACKAGE_PIN D2 IOSTANDARD LVCMOS33 } [get_ports { jd_5 }]; #IO_L14N_T2_SRCC_35 Sch=jd[8] +set_property -dict { PACKAGE_PIN H2 IOSTANDARD LVCMOS33 } [get_ports { jd_6 }]; #IO_L15P_T2_DQS_35 Sch=jd[9] +#set_property -dict { PACKAGE_PIN G2 IOSTANDARD LVCMOS33 } [get_ports { jd_7 }]; #IO_L15N_T2_DQS_35 Sch=jd[10] + +##USB-UART Interface (FTDI FT2232H) + +set_property -dict { PACKAGE_PIN D10 IOSTANDARD LVCMOS33 } [get_ports { uart_rxd_out }]; #IO_L19N_T3_VREF_16 Sch=uart_rxd_out +set_property -dict { PACKAGE_PIN A9 IOSTANDARD LVCMOS33 } [get_ports { uart_txd_in }]; #IO_L14N_T2_SRCC_16 Sch=uart_txd_in + + +##ChipKit Single Ended Analog Inputs +##NOTE: The ck_an_p pins can be used as single ended analog inputs with voltages from 0-3.3V (Chipkit Analog pins A0-A5). +## These signals should only be connected to the XADC core. When using these pins as digital I/O, use pins ck_io[14-19]. + +#set_property -dict { PACKAGE_PIN C5 IOSTANDARD LVCMOS33 } [get_ports { ck_an_n[0] }]; #IO_L1N_T0_AD4N_35 Sch=ck_an_n[0] +#set_property -dict { PACKAGE_PIN C6 IOSTANDARD LVCMOS33 } [get_ports { ck_an_p[0] }]; #IO_L1P_T0_AD4P_35 Sch=ck_an_p[0] +#set_property -dict { PACKAGE_PIN A5 IOSTANDARD LVCMOS33 } [get_ports { ck_an_n[1] }]; #IO_L3N_T0_DQS_AD5N_35 Sch=ck_an_n[1] +#set_property -dict { PACKAGE_PIN A6 IOSTANDARD LVCMOS33 } [get_ports { ck_an_p[1] }]; #IO_L3P_T0_DQS_AD5P_35 Sch=ck_an_p[1] +#set_property -dict { PACKAGE_PIN B4 IOSTANDARD LVCMOS33 } [get_ports { ck_an_n[2] }]; #IO_L7N_T1_AD6N_35 Sch=ck_an_n[2] +#set_property -dict { PACKAGE_PIN C4 IOSTANDARD LVCMOS33 } [get_ports { ck_an_p[2] }]; #IO_L7P_T1_AD6P_35 Sch=ck_an_p[2] +#set_property -dict { PACKAGE_PIN A1 IOSTANDARD LVCMOS33 } [get_ports { ck_an_n[3] }]; #IO_L9N_T1_DQS_AD7N_35 Sch=ck_an_n[3] +#set_property -dict { PACKAGE_PIN B1 IOSTANDARD LVCMOS33 } [get_ports { ck_an_p[3] }]; #IO_L9P_T1_DQS_AD7P_35 Sch=ck_an_p[3] +#set_property -dict { PACKAGE_PIN B2 IOSTANDARD LVCMOS33 } [get_ports { ck_an_n[4] }]; #IO_L10N_T1_AD15N_35 Sch=ck_an_n[4] +#set_property -dict { PACKAGE_PIN B3 IOSTANDARD LVCMOS33 } [get_ports { ck_an_p[4] }]; #IO_L10P_T1_AD15P_35 Sch=ck_an_p[4] +#set_property -dict { PACKAGE_PIN C14 IOSTANDARD LVCMOS33 } [get_ports { ck_an_n[5] }]; #IO_L1N_T0_AD0N_15 Sch=ck_an_n[5] +#set_property -dict { PACKAGE_PIN D14 IOSTANDARD LVCMOS33 } [get_ports { ck_an_p[5] }]; #IO_L1P_T0_AD0P_15 Sch=ck_an_p[5] + +##ChipKit Digital I/O Low + +set_property -dict { PACKAGE_PIN V15 IOSTANDARD LVCMOS33 } [get_ports { ck_io_0 }]; #IO_L16P_T2_CSI_B_14 Sch=ck_io[0] +set_property -dict { PACKAGE_PIN U16 IOSTANDARD LVCMOS33 } [get_ports { ck_io_1 }]; #IO_L18P_T2_A12_D28_14 Sch=ck_io[1] +set_property -dict { PACKAGE_PIN P14 IOSTANDARD LVCMOS33 } [get_ports { ck_io_2 }]; #IO_L8N_T1_D12_14 Sch=ck_io[2] +set_property -dict { PACKAGE_PIN T11 IOSTANDARD LVCMOS33 } [get_ports { ck_io_3 }]; #IO_L19P_T3_A10_D26_14 Sch=ck_io[3] +set_property -dict { PACKAGE_PIN R12 IOSTANDARD LVCMOS33 } [get_ports { ck_io_4 }]; #IO_L5P_T0_D06_14 Sch=ck_io[4] +set_property -dict { PACKAGE_PIN T14 IOSTANDARD LVCMOS33 } [get_ports { ck_io_5 }]; #IO_L14P_T2_SRCC_14 Sch=ck_io[5] +set_property -dict { PACKAGE_PIN T15 IOSTANDARD LVCMOS33 } [get_ports { ck_io_6 }]; #IO_L14N_T2_SRCC_14 Sch=ck_io[6] +set_property -dict { PACKAGE_PIN T16 IOSTANDARD LVCMOS33 } [get_ports { ck_io_7 }]; #IO_L15N_T2_DQS_DOUT_CSO_B_14 Sch=ck_io[7] +set_property -dict { PACKAGE_PIN N15 IOSTANDARD LVCMOS33 } [get_ports { ck_io_8 }]; #IO_L11P_T1_SRCC_14 Sch=ck_io[8] +set_property -dict { PACKAGE_PIN M16 IOSTANDARD LVCMOS33 } [get_ports { ck_io_9 }]; #IO_L10P_T1_D14_14 Sch=ck_io[9] +set_property -dict { PACKAGE_PIN V17 IOSTANDARD LVCMOS33 } [get_ports { ck_io_10 }]; #IO_L18N_T2_A11_D27_14 Sch=ck_io[10] +set_property -dict { PACKAGE_PIN U18 IOSTANDARD LVCMOS33 } [get_ports { ck_io_11 }]; #IO_L17N_T2_A13_D29_14 Sch=ck_io[11] +set_property -dict { PACKAGE_PIN R17 IOSTANDARD LVCMOS33 } [get_ports { ck_io_12 }]; #IO_L12N_T1_MRCC_14 Sch=ck_io[12] +set_property -dict { PACKAGE_PIN P17 IOSTANDARD LVCMOS33 } [get_ports { ck_io_13 }]; #IO_L12P_T1_MRCC_14 Sch=ck_io[13] + +##ChipKit Digital I/O On Outer Analog Header +##NOTE: These pins should be used when using the analog header signals A0-A5 as digital I/O (Chipkit digital pins 14-19) + +set_property -dict { PACKAGE_PIN F5 IOSTANDARD LVCMOS33 } [get_ports { ck_io_14 }]; #IO_0_35 Sch=ck_a[0] +set_property -dict { PACKAGE_PIN D8 IOSTANDARD LVCMOS33 } [get_ports { ck_io_15 }]; #IO_L4P_T0_35 Sch=ck_a[1] +set_property -dict { PACKAGE_PIN C7 IOSTANDARD LVCMOS33 } [get_ports { ck_io_16 }]; #IO_L4N_T0_35 Sch=ck_a[2] +set_property -dict { PACKAGE_PIN E7 IOSTANDARD LVCMOS33 } [get_ports { ck_io_17 }]; #IO_L6P_T0_35 Sch=ck_a[3] +set_property -dict { PACKAGE_PIN D7 IOSTANDARD LVCMOS33 } [get_ports { ck_io_18 }]; #IO_L6N_T0_VREF_35 Sch=ck_a[4] +set_property -dict { PACKAGE_PIN D5 IOSTANDARD LVCMOS33 } [get_ports { ck_io_19 }]; #IO_L11P_T1_SRCC_35 Sch=ck_a[5] + +##ChipKit Digital I/O On Inner Analog Header +##NOTE: These pins will need to be connected to the XADC core when used as differential analog inputs (Chipkit analog pins A6-A11) + +#set_property -dict { PACKAGE_PIN B7 IOSTANDARD LVCMOS33 } [get_ports { ck_io[20] }]; #IO_L2P_T0_AD12P_35 Sch=ad_p[12] +#set_property -dict { PACKAGE_PIN B6 IOSTANDARD LVCMOS33 } [get_ports { ck_io[21] }]; #IO_L2N_T0_AD12N_35 Sch=ad_n[12] +#set_property -dict { PACKAGE_PIN E6 IOSTANDARD LVCMOS33 } [get_ports { ck_io[22] }]; #IO_L5P_T0_AD13P_35 Sch=ad_p[13] +#set_property -dict { PACKAGE_PIN E5 IOSTANDARD LVCMOS33 } [get_ports { ck_io[23] }]; #IO_L5N_T0_AD13N_35 Sch=ad_n[13] +#set_property -dict { PACKAGE_PIN A4 IOSTANDARD LVCMOS33 } [get_ports { ck_io[24] }]; #IO_L8P_T1_AD14P_35 Sch=ad_p[14] +#set_property -dict { PACKAGE_PIN A3 IOSTANDARD LVCMOS33 } [get_ports { ck_io[25] }]; #IO_L8N_T1_AD14N_35 Sch=ad_n[14] + +##ChipKit Digital I/O High + +#set_property -dict { PACKAGE_PIN U11 IOSTANDARD LVCMOS33 } [get_ports { ck_io[26] }]; #IO_L19N_T3_A09_D25_VREF_14 Sch=ck_io[26] +#set_property -dict { PACKAGE_PIN V16 IOSTANDARD LVCMOS33 } [get_ports { ck_io[27] }]; #IO_L16N_T2_A15_D31_14 Sch=ck_io[27] +#set_property -dict { PACKAGE_PIN M13 IOSTANDARD LVCMOS33 } [get_ports { ck_io[28] }]; #IO_L6N_T0_D08_VREF_14 Sch=ck_io[28] +#set_property -dict { PACKAGE_PIN R10 IOSTANDARD LVCMOS33 } [get_ports { ck_io[29] }]; #IO_25_14 Sch=ck_io[29] +#set_property -dict { PACKAGE_PIN R11 IOSTANDARD LVCMOS33 } [get_ports { ck_io[30] }]; #IO_0_14 Sch=ck_io[30] +#set_property -dict { PACKAGE_PIN R13 IOSTANDARD LVCMOS33 } [get_ports { ck_io[31] }]; #IO_L5N_T0_D07_14 Sch=ck_io[31] +#set_property -dict { PACKAGE_PIN R15 IOSTANDARD LVCMOS33 } [get_ports { ck_io[32] }]; #IO_L13N_T2_MRCC_14 Sch=ck_io[32] +#set_property -dict { PACKAGE_PIN P15 IOSTANDARD LVCMOS33 } [get_ports { ck_io[33] }]; #IO_L13P_T2_MRCC_14 Sch=ck_io[33] +#set_property -dict { PACKAGE_PIN R16 IOSTANDARD LVCMOS33 } [get_ports { ck_io[34] }]; #IO_L15P_T2_DQS_RDWR_B_14 Sch=ck_io[34] +#set_property -dict { PACKAGE_PIN N16 IOSTANDARD LVCMOS33 } [get_ports { ck_io[35] }]; #IO_L11N_T1_SRCC_14 Sch=ck_io[35] +#set_property -dict { PACKAGE_PIN N14 IOSTANDARD LVCMOS33 } [get_ports { ck_io[36] }]; #IO_L8P_T1_D11_14 Sch=ck_io[36] +#set_property -dict { PACKAGE_PIN U17 IOSTANDARD LVCMOS33 } [get_ports { ck_io[37] }]; #IO_L17P_T2_A14_D30_14 Sch=ck_io[37] +#set_property -dict { PACKAGE_PIN T18 IOSTANDARD LVCMOS33 } [get_ports { ck_io[38] }]; #IO_L7N_T1_D10_14 Sch=ck_io[38] +#set_property -dict { PACKAGE_PIN R18 IOSTANDARD LVCMOS33 } [get_ports { ck_io[39] }]; #IO_L7P_T1_D09_14 Sch=ck_io[39] +#set_property -dict { PACKAGE_PIN P18 IOSTANDARD LVCMOS33 } [get_ports { ck_io[40] }]; #IO_L9N_T1_DQS_D13_14 Sch=ck_io[40] +#set_property -dict { PACKAGE_PIN N17 IOSTANDARD LVCMOS33 } [get_ports { ck_io[41] }]; #IO_L9P_T1_DQS_14 Sch=ck_io[41] + +## ChipKit SPI + +set_property -dict { PACKAGE_PIN G1 IOSTANDARD LVCMOS33 } [get_ports { ck_miso }]; #IO_L17N_T2_35 Sch=ck_miso +set_property -dict { PACKAGE_PIN H1 IOSTANDARD LVCMOS33 } [get_ports { ck_mosi }]; #IO_L17P_T2_35 Sch=ck_mosi +set_property -dict { PACKAGE_PIN F1 IOSTANDARD LVCMOS33 } [get_ports { ck_sck }]; #IO_L18P_T2_35 Sch=ck_sck +set_property -dict { PACKAGE_PIN C1 IOSTANDARD LVCMOS33 } [get_ports { ck_ss }]; #IO_L16N_T2_35 Sch=ck_ss + +## ChipKit I2C + +#set_property -dict { PACKAGE_PIN L18 IOSTANDARD LVCMOS33 } [get_ports { ck_scl }]; #IO_L4P_T0_D04_14 Sch=ck_scl +#set_property -dict { PACKAGE_PIN M18 IOSTANDARD LVCMOS33 } [get_ports { ck_sda }]; #IO_L4N_T0_D05_14 Sch=ck_sda +#set_property -dict { PACKAGE_PIN A14 IOSTANDARD LVCMOS33 } [get_ports { scl_pup }]; #IO_L9N_T1_DQS_AD3N_15 Sch=scl_pup +#set_property -dict { PACKAGE_PIN A13 IOSTANDARD LVCMOS33 } [get_ports { sda_pup }]; #IO_L9P_T1_DQS_AD3P_15 Sch=sda_pup + +##Misc. ChipKit signals + +#set_property -dict { PACKAGE_PIN M17 IOSTANDARD LVCMOS33 } [get_ports { ck_ioa }]; #IO_L10N_T1_D15_14 Sch=ck_ioa +set_property -dict { PACKAGE_PIN C2 IOSTANDARD LVCMOS33 } [get_ports { ck_rst }]; #IO_L16P_T2_35 Sch=ck_rst + +##SMSC Ethernet PHY + +#set_property -dict { PACKAGE_PIN D17 IOSTANDARD LVCMOS33 } [get_ports { eth_col }]; #IO_L16N_T2_A27_15 Sch=eth_col +#set_property -dict { PACKAGE_PIN G14 IOSTANDARD LVCMOS33 } [get_ports { eth_crs }]; #IO_L15N_T2_DQS_ADV_B_15 Sch=eth_crs +#set_property -dict { PACKAGE_PIN F16 IOSTANDARD LVCMOS33 } [get_ports { eth_mdc }]; #IO_L14N_T2_SRCC_15 Sch=eth_mdc +#set_property -dict { PACKAGE_PIN K13 IOSTANDARD LVCMOS33 } [get_ports { eth_mdio }]; #IO_L17P_T2_A26_15 Sch=eth_mdio +#set_property -dict { PACKAGE_PIN G18 IOSTANDARD LVCMOS33 } [get_ports { eth_ref_clk }]; #IO_L22P_T3_A17_15 Sch=eth_ref_clk +#set_property -dict { PACKAGE_PIN C16 IOSTANDARD LVCMOS33 } [get_ports { eth_rstn }]; #IO_L20P_T3_A20_15 Sch=eth_rstn +#set_property -dict { PACKAGE_PIN F15 IOSTANDARD LVCMOS33 } [get_ports { eth_rx_clk }]; #IO_L14P_T2_SRCC_15 Sch=eth_rx_clk +#set_property -dict { PACKAGE_PIN G16 IOSTANDARD LVCMOS33 } [get_ports { eth_rx_dv }]; #IO_L13N_T2_MRCC_15 Sch=eth_rx_dv +#set_property -dict { PACKAGE_PIN D18 IOSTANDARD LVCMOS33 } [get_ports { eth_rxd[0] }]; #IO_L21N_T3_DQS_A18_15 Sch=eth_rxd[0] +#set_property -dict { PACKAGE_PIN E17 IOSTANDARD LVCMOS33 } [get_ports { eth_rxd[1] }]; #IO_L16P_T2_A28_15 Sch=eth_rxd[1] +#set_property -dict { PACKAGE_PIN E18 IOSTANDARD LVCMOS33 } [get_ports { eth_rxd[2] }]; #IO_L21P_T3_DQS_15 Sch=eth_rxd[2] +#set_property -dict { PACKAGE_PIN G17 IOSTANDARD LVCMOS33 } [get_ports { eth_rxd[3] }]; #IO_L18N_T2_A23_15 Sch=eth_rxd[3] +#set_property -dict { PACKAGE_PIN C17 IOSTANDARD LVCMOS33 } [get_ports { eth_rxerr }]; #IO_L20N_T3_A19_15 Sch=eth_rxerr +#set_property -dict { PACKAGE_PIN H16 IOSTANDARD LVCMOS33 } [get_ports { eth_tx_clk }]; #IO_L13P_T2_MRCC_15 Sch=eth_tx_clk +#set_property -dict { PACKAGE_PIN H15 IOSTANDARD LVCMOS33 } [get_ports { eth_tx_en }]; #IO_L19N_T3_A21_VREF_15 Sch=eth_tx_en +#set_property -dict { PACKAGE_PIN H14 IOSTANDARD LVCMOS33 } [get_ports { eth_txd[0] }]; #IO_L15P_T2_DQS_15 Sch=eth_txd[0] +#set_property -dict { PACKAGE_PIN J14 IOSTANDARD LVCMOS33 } [get_ports { eth_txd[1] }]; #IO_L19P_T3_A22_15 Sch=eth_txd[1] +#set_property -dict { PACKAGE_PIN J13 IOSTANDARD LVCMOS33 } [get_ports { eth_txd[2] }]; #IO_L17N_T2_A25_15 Sch=eth_txd[2] +#set_property -dict { PACKAGE_PIN H17 IOSTANDARD LVCMOS33 } [get_ports { eth_txd[3] }]; #IO_L18P_T2_A24_15 Sch=eth_txd[3] + +##Quad SPI Flash + +set_property -dict { PACKAGE_PIN L16 IOSTANDARD LVCMOS33 IOB TRUE } [get_ports { qspi_sck }]; +create_clock -add -name qspi_sck_pin -period 20.00 -waveform {0 10} [get_ports { qspi_sck }]; +set_property -dict { PACKAGE_PIN L13 IOSTANDARD LVCMOS33 IOB TRUE } [get_ports { qspi_cs }]; #IO_L6P_T0_FCS_B_14 Sch=qspi_cs +set_property -dict { PACKAGE_PIN K17 IOSTANDARD LVCMOS33 IOB TRUE PULLUP TRUE } [get_ports { qspi_dq_0 }]; #IO_L1P_T0_D00_MOSI_14 Sch=qspi_dq[0] +set_property -dict { PACKAGE_PIN K18 IOSTANDARD LVCMOS33 IOB TRUE PULLUP TRUE } [get_ports { qspi_dq_1 }]; #IO_L1N_T0_D01_DIN_14 Sch=qspi_dq[1] +set_property -dict { PACKAGE_PIN L14 IOSTANDARD LVCMOS33 IOB TRUE PULLUP TRUE } [get_ports { qspi_dq_2 }]; #IO_L2P_T0_D02_14 Sch=qspi_dq[2] +set_property -dict { PACKAGE_PIN M14 IOSTANDARD LVCMOS33 IOB TRUE PULLUP TRUE } [get_ports { qspi_dq_3 }]; #IO_L2N_T0_D03_14 Sch=qspi_dq[3] + +##Power Measurements + +#set_property -dict { PACKAGE_PIN B17 IOSTANDARD LVCMOS33 } [get_ports { vsnsvu_n }]; #IO_L7N_T1_AD2N_15 Sch=ad_n[2] +#set_property -dict { PACKAGE_PIN B16 IOSTANDARD LVCMOS33 } [get_ports { vsnsvu_p }]; #IO_L7P_T1_AD2P_15 Sch=ad_p[2] +#set_property -dict { PACKAGE_PIN B12 IOSTANDARD LVCMOS33 } [get_ports { vsns5v0_n }]; #IO_L3N_T0_DQS_AD1N_15 Sch=ad_n[1] +#set_property -dict { PACKAGE_PIN C12 IOSTANDARD LVCMOS33 } [get_ports { vsns5v0_p }]; #IO_L3P_T0_DQS_AD1P_15 Sch=ad_p[1] +#set_property -dict { PACKAGE_PIN F14 IOSTANDARD LVCMOS33 } [get_ports { isns5v0_n }]; #IO_L5N_T0_AD9N_15 Sch=ad_n[9] +#set_property -dict { PACKAGE_PIN F13 IOSTANDARD LVCMOS33 } [get_ports { isns5v0_p }]; #IO_L5P_T0_AD9P_15 Sch=ad_p[9] +#set_property -dict { PACKAGE_PIN A16 IOSTANDARD LVCMOS33 } [get_ports { isns0v95_n }]; #IO_L8N_T1_AD10N_15 Sch=ad_n[10] +#set_property -dict { PACKAGE_PIN A15 IOSTANDARD LVCMOS33 } [get_ports { isns0v95_p }]; #IO_L8P_T1_AD10P_15 Sch=ad_p[10] + +set_clock_groups -asynchronous \ + -group [list \ + [get_clocks -include_generated_clocks -of_objects [get_ports jd_2]]] \ + -group [list \ + [get_clocks -of_objects [get_pins ip_mmcm/inst/mmcm_adv_inst/CLKOUT0]]] \ + -group [list \ + [get_clocks -of_objects [get_pins ip_mmcm/inst/mmcm_adv_inst/CLKOUT1]] \ + [get_clocks -of_objects [get_pins ip_mmcm/inst/mmcm_adv_inst/CLKOUT2]]] diff --git a/hdl_cores/freedom/fpga-shells/xilinx/arty/tcl/board.tcl b/hdl_cores/freedom/fpga-shells/xilinx/arty/tcl/board.tcl new file mode 100644 index 0000000..4eaed96 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/xilinx/arty/tcl/board.tcl @@ -0,0 +1,5 @@ +# See LICENSE for license details. +set name {arty} +set part_fpga {xc7a35ticsg324-1L} +set part_board {digilentinc.com:arty:part0:1.1} +set bootrom_inst {rom} diff --git a/hdl_cores/freedom/fpga-shells/xilinx/arty/tcl/ip.tcl b/hdl_cores/freedom/fpga-shells/xilinx/arty/tcl/ip.tcl new file mode 100644 index 0000000..fe07c37 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/xilinx/arty/tcl/ip.tcl @@ -0,0 +1,44 @@ +# See LICENSE for license details. + +create_ip -vendor xilinx.com -library ip -name clk_wiz -module_name mmcm -dir $ipdir -force +set_property -dict [list \ + CONFIG.PRIMITIVE {MMCM} \ + CONFIG.RESET_TYPE {ACTIVE_LOW} \ + CONFIG.CLKOUT1_USED {true} \ + CONFIG.CLKOUT2_USED {true} \ + CONFIG.CLKOUT3_USED {true} \ + CONFIG.CLKOUT1_REQUESTED_OUT_FREQ {8.388} \ + CONFIG.CLKOUT2_REQUESTED_OUT_FREQ {65.000} \ + CONFIG.CLKOUT3_REQUESTED_OUT_FREQ {32.500} \ + ] [get_ips mmcm] + +create_ip -vendor xilinx.com -library ip -name proc_sys_reset -module_name reset_sys -dir $ipdir -force +set_property -dict [list \ + CONFIG.C_EXT_RESET_HIGH {false} \ + CONFIG.C_AUX_RESET_HIGH {false} \ + CONFIG.C_NUM_BUS_RST {1} \ + CONFIG.C_NUM_PERP_RST {1} \ + CONFIG.C_NUM_INTERCONNECT_ARESETN {1} \ + CONFIG.C_NUM_PERP_ARESETN {1} \ + ] [get_ips reset_sys] + +create_ip -vendor xilinx.com -library ip -name ila -module_name ila -dir $ipdir -force +set_property -dict [list \ + CONFIG.C_NUM_OF_PROBES {1} \ + CONFIG.C_TRIGOUT_EN {false} \ + CONFIG.C_TRIGIN_EN {false} \ + CONFIG.C_MONITOR_TYPE {Native} \ + CONFIG.C_ENABLE_ILA_AXI_MON {false} \ + CONFIG.C_PROBE0_WIDTH {4} \ + CONFIG.C_PROBE10_TYPE {1} \ + CONFIG.C_PROBE10_WIDTH {32} \ + CONFIG.C_PROBE11_TYPE {1} \ + CONFIG.C_PROBE11_WIDTH {32} \ + CONFIG.C_PROBE12_TYPE {1} \ + CONFIG.C_PROBE12_WIDTH {64} \ + CONFIG.C_PROBE13_TYPE {1} \ + CONFIG.C_PROBE13_WIDTH {64} \ + CONFIG.C_PROBE14_TYPE {1} \ + CONFIG.C_PROBE14_WIDTH {97} \ + ] [get_ips ila] + diff --git a/hdl_cores/freedom/fpga-shells/xilinx/arty_a7_100/constraints/arty-config.xdc b/hdl_cores/freedom/fpga-shells/xilinx/arty_a7_100/constraints/arty-config.xdc new file mode 100644 index 0000000..a455c22 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/xilinx/arty_a7_100/constraints/arty-config.xdc @@ -0,0 +1,5 @@ +set_property -dict [list \ + CONFIG_VOLTAGE {3.3} \ + CFGBVS {VCCO} \ + BITSTREAM.CONFIG.SPI_BUSWIDTH {4} \ + ] [current_design] diff --git a/hdl_cores/freedom/fpga-shells/xilinx/arty_a7_100/constraints/arty-master.xdc b/hdl_cores/freedom/fpga-shells/xilinx/arty_a7_100/constraints/arty-master.xdc new file mode 100644 index 0000000..c434697 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/xilinx/arty_a7_100/constraints/arty-master.xdc @@ -0,0 +1,240 @@ +## This file is a general .xdc for the ARTY Rev. B +## To use it in a project: +## - uncomment the lines corresponding to used pins +## - rename the used ports (in each line, after get_ports) according to the top level signal names in the project + +## Clock signal + +set_property -dict { PACKAGE_PIN E3 IOSTANDARD LVCMOS33 } [get_ports { CLK100MHZ }]; #IO_L12P_T1_MRCC_35 Sch=gclk[100] +create_clock -add -name sys_clk_pin -period 10.00 -waveform {0 5} [get_ports {CLK100MHZ}]; +create_clock -add -name JTCK -period 100 -waveform {0 50} [get_ports {jd_2}]; + +##Switches + +set_property -dict { PACKAGE_PIN A8 IOSTANDARD LVCMOS33 } [get_ports { sw_0 }]; #IO_L12N_T1_MRCC_16 Sch=sw[0] +set_property -dict { PACKAGE_PIN C11 IOSTANDARD LVCMOS33 } [get_ports { sw_1 }]; #IO_L13P_T2_MRCC_16 Sch=sw[1] +set_property -dict { PACKAGE_PIN C10 IOSTANDARD LVCMOS33 } [get_ports { sw_2 }]; #IO_L13N_T2_MRCC_16 Sch=sw[2] +set_property -dict { PACKAGE_PIN A10 IOSTANDARD LVCMOS33 } [get_ports { sw_3 }]; #IO_L14P_T2_SRCC_16 Sch=sw[3] + +##RGB LEDs + +set_property -dict { PACKAGE_PIN E1 IOSTANDARD LVCMOS33 } [get_ports { led0_b }]; #IO_L18N_T2_35 Sch=led0_b +set_property -dict { PACKAGE_PIN F6 IOSTANDARD LVCMOS33 } [get_ports { led0_g }]; #IO_L19N_T3_VREF_35 Sch=led0_g +set_property -dict { PACKAGE_PIN G6 IOSTANDARD LVCMOS33 } [get_ports { led0_r }]; #IO_L19P_T3_35 Sch=led0_r +set_property -dict { PACKAGE_PIN G4 IOSTANDARD LVCMOS33 } [get_ports { led1_b }]; #IO_L20P_T3_35 Sch=led1_b +set_property -dict { PACKAGE_PIN J4 IOSTANDARD LVCMOS33 } [get_ports { led1_g }]; #IO_L21P_T3_DQS_35 Sch=led1_g +set_property -dict { PACKAGE_PIN G3 IOSTANDARD LVCMOS33 } [get_ports { led1_r }]; #IO_L20N_T3_35 Sch=led1_r +set_property -dict { PACKAGE_PIN H4 IOSTANDARD LVCMOS33 } [get_ports { led2_b }]; #IO_L21N_T3_DQS_35 Sch=led2_b +set_property -dict { PACKAGE_PIN J2 IOSTANDARD LVCMOS33 } [get_ports { led2_g }]; #IO_L22N_T3_35 Sch=led2_g +set_property -dict { PACKAGE_PIN J3 IOSTANDARD LVCMOS33 } [get_ports { led2_r }]; #IO_L22P_T3_35 Sch=led2_r +#set_property -dict { PACKAGE_PIN K2 IOSTANDARD LVCMOS33 } [get_ports { led3_b }]; #IO_L23P_T3_35 Sch=led3_b +#set_property -dict { PACKAGE_PIN H6 IOSTANDARD LVCMOS33 } [get_ports { led3_g }]; #IO_L24P_T3_35 Sch=led3_g +#set_property -dict { PACKAGE_PIN K1 IOSTANDARD LVCMOS33 } [get_ports { led3_r }]; #IO_L23N_T3_35 Sch=led3_r + +##LEDs + +set_property -dict { PACKAGE_PIN H5 IOSTANDARD LVCMOS33 } [get_ports { led_0 }]; #IO_L24N_T3_35 Sch=led[4] +set_property -dict { PACKAGE_PIN J5 IOSTANDARD LVCMOS33 } [get_ports { led_1 }]; #IO_25_35 Sch=led[5] +set_property -dict { PACKAGE_PIN T9 IOSTANDARD LVCMOS33 } [get_ports { led_2 }]; #IO_L24P_T3_A01_D17_14 Sch=led[6] +set_property -dict { PACKAGE_PIN T10 IOSTANDARD LVCMOS33 } [get_ports { led_3 }]; #IO_L24N_T3_A00_D16_14 Sch=led[7] + +##Buttons + +set_property -dict { PACKAGE_PIN D9 IOSTANDARD LVCMOS33 } [get_ports { btn_0 }]; #IO_L6N_T0_VREF_16 Sch=btn[0] +set_property -dict { PACKAGE_PIN C9 IOSTANDARD LVCMOS33 } [get_ports { btn_1 }]; #IO_L11P_T1_SRCC_16 Sch=btn[1] +set_property -dict { PACKAGE_PIN B9 IOSTANDARD LVCMOS33 } [get_ports { btn_2 }]; #IO_L11N_T1_SRCC_16 Sch=btn[2] +set_property -dict { PACKAGE_PIN B8 IOSTANDARD LVCMOS33 } [get_ports { btn_3 }]; #IO_L12P_T1_MRCC_16 Sch=btn[3] + +##Pmod Header JA + +set_property -dict { PACKAGE_PIN G13 IOSTANDARD LVCMOS33 } [get_ports { ja_0 }]; #IO_0_15 Sch=ja[1] +set_property -dict { PACKAGE_PIN B11 IOSTANDARD LVCMOS33 } [get_ports { ja_1 }]; #IO_L4P_T0_15 Sch=ja[2] +set_property -dict { PACKAGE_PIN A11 IOSTANDARD LVCMOS33 } [get_ports { ja_2 }]; #IO_L4N_T0_15 Sch=ja[3] +set_property -dict { PACKAGE_PIN D12 IOSTANDARD LVCMOS33 } [get_ports { ja_3 }]; #IO_L6P_T0_15 Sch=ja[4] +set_property -dict { PACKAGE_PIN D13 IOSTANDARD LVCMOS33 } [get_ports { ja_4 }]; #IO_L6N_T0_VREF_15 Sch=ja[7] +set_property -dict { PACKAGE_PIN B18 IOSTANDARD LVCMOS33 } [get_ports { ja_5 }]; #IO_L10P_T1_AD11P_15 Sch=ja[8] +set_property -dict { PACKAGE_PIN A18 IOSTANDARD LVCMOS33 } [get_ports { ja_6 }]; #IO_L10N_T1_AD11N_15 Sch=ja[9] +set_property -dict { PACKAGE_PIN K16 IOSTANDARD LVCMOS33 } [get_ports { ja_7 }]; #IO_25_15 Sch=ja[10] + +##Pmod Header JB + +#set_property -dict { PACKAGE_PIN E15 IOSTANDARD LVCMOS33 } [get_ports { jb_0 }]; #IO_L11P_T1_SRCC_15 Sch=jb_p[1] +#set_property -dict { PACKAGE_PIN E16 IOSTANDARD LVCMOS33 } [get_ports { jb_1 }]; #IO_L11N_T1_SRCC_15 Sch=jb_n[1] +#set_property -dict { PACKAGE_PIN D15 IOSTANDARD LVCMOS33 } [get_ports { jb_2 }]; #IO_L12P_T1_MRCC_15 Sch=jb_p[2] +#set_property -dict { PACKAGE_PIN C15 IOSTANDARD LVCMOS33 } [get_ports { jb_3 }]; #IO_L12N_T1_MRCC_15 Sch=jb_n[2] +#set_property -dict { PACKAGE_PIN J17 IOSTANDARD LVCMOS33 } [get_ports { jb_4 }]; #IO_L23P_T3_FOE_B_15 Sch=jb_p[3] +#set_property -dict { PACKAGE_PIN J18 IOSTANDARD LVCMOS33 } [get_ports { jb_5 }]; #IO_L23N_T3_FWE_B_15 Sch=jb_n[3] +#set_property -dict { PACKAGE_PIN K15 IOSTANDARD LVCMOS33 } [get_ports { jb_6 }]; #IO_L24P_T3_RS1_15 Sch=jb_p[4] +#set_property -dict { PACKAGE_PIN J15 IOSTANDARD LVCMOS33 } [get_ports { jb_7 }]; #IO_L24N_T3_RS0_15 Sch=jb_n[4] + +##Pmod Header JC + +set_property -dict { PACKAGE_PIN U12 IOSTANDARD LVCMOS33 } [get_ports { jc_0 }]; #IO_L20P_T3_A08_D24_14 Sch=jc_p[1] +set_property -dict { PACKAGE_PIN V12 IOSTANDARD LVCMOS33 } [get_ports { jc_1 }]; #IO_L20N_T3_A07_D23_14 Sch=jc_n[1] +set_property -dict { PACKAGE_PIN V10 IOSTANDARD LVCMOS33 } [get_ports { jc_2 }]; #IO_L21P_T3_DQS_14 Sch=jc_p[2] +set_property -dict { PACKAGE_PIN V11 IOSTANDARD LVCMOS33 } [get_ports { jc_3 }]; #IO_L21N_T3_DQS_A06_D22_14 Sch=jc_n[2] +set_property -dict { PACKAGE_PIN U14 IOSTANDARD LVCMOS33 } [get_ports { jc_4 }]; #IO_L22P_T3_A05_D21_14 Sch=jc_p[3] +set_property -dict { PACKAGE_PIN V14 IOSTANDARD LVCMOS33 } [get_ports { jc_5 }]; #IO_L22N_T3_A04_D20_14 Sch=jc_n[3] +set_property -dict { PACKAGE_PIN T13 IOSTANDARD LVCMOS33 } [get_ports { jc_6 }]; #IO_L23P_T3_A03_D19_14 Sch=jc_p[4] +set_property -dict { PACKAGE_PIN U13 IOSTANDARD LVCMOS33 } [get_ports { jc_7 }]; #IO_L23N_T3_A02_D18_14 Sch=jc_n[4] + +##Pmod Header JD + +set_property -dict { PACKAGE_PIN D4 IOSTANDARD LVCMOS33 } [get_ports { jd_0 }]; #IO_L11N_T1_SRCC_35 Sch=jd[1] +set_property -dict { PACKAGE_PIN D3 IOSTANDARD LVCMOS33 } [get_ports { jd_1 }]; #IO_L12N_T1_MRCC_35 Sch=jd[2] +set_property -dict { PACKAGE_PIN F4 IOSTANDARD LVCMOS33 } [get_ports { jd_2 }]; #IO_L13P_T2_MRCC_35 Sch=jd[3] +#set_property -dict { PACKAGE_PIN F3 IOSTANDARD LVCMOS33 } [get_ports { jd_3 }]; #IO_L13N_T2_MRCC_35 Sch=jd[4] +set_property -dict { PACKAGE_PIN E2 IOSTANDARD LVCMOS33 } [get_ports { jd_4 }]; #IO_L14P_T2_SRCC_35 Sch=jd[7] +set_property -dict { PACKAGE_PIN D2 IOSTANDARD LVCMOS33 } [get_ports { jd_5 }]; #IO_L14N_T2_SRCC_35 Sch=jd[8] +set_property -dict { PACKAGE_PIN H2 IOSTANDARD LVCMOS33 } [get_ports { jd_6 }]; #IO_L15P_T2_DQS_35 Sch=jd[9] +#set_property -dict { PACKAGE_PIN G2 IOSTANDARD LVCMOS33 } [get_ports { jd_7 }]; #IO_L15N_T2_DQS_35 Sch=jd[10] + +##USB-UART Interface (FTDI FT2232H) + +set_property -dict { PACKAGE_PIN D10 IOSTANDARD LVCMOS33 } [get_ports { uart_rxd_out }]; #IO_L19N_T3_VREF_16 Sch=uart_rxd_out +set_property -dict { PACKAGE_PIN A9 IOSTANDARD LVCMOS33 } [get_ports { uart_txd_in }]; #IO_L14N_T2_SRCC_16 Sch=uart_txd_in + + +##ChipKit Single Ended Analog Inputs +##NOTE: The ck_an_p pins can be used as single ended analog inputs with voltages from 0-3.3V (Chipkit Analog pins A0-A5). +## These signals should only be connected to the XADC core. When using these pins as digital I/O, use pins ck_io[14-19]. + +#set_property -dict { PACKAGE_PIN C5 IOSTANDARD LVCMOS33 } [get_ports { ck_an_n[0] }]; #IO_L1N_T0_AD4N_35 Sch=ck_an_n[0] +#set_property -dict { PACKAGE_PIN C6 IOSTANDARD LVCMOS33 } [get_ports { ck_an_p[0] }]; #IO_L1P_T0_AD4P_35 Sch=ck_an_p[0] +#set_property -dict { PACKAGE_PIN A5 IOSTANDARD LVCMOS33 } [get_ports { ck_an_n[1] }]; #IO_L3N_T0_DQS_AD5N_35 Sch=ck_an_n[1] +#set_property -dict { PACKAGE_PIN A6 IOSTANDARD LVCMOS33 } [get_ports { ck_an_p[1] }]; #IO_L3P_T0_DQS_AD5P_35 Sch=ck_an_p[1] +#set_property -dict { PACKAGE_PIN B4 IOSTANDARD LVCMOS33 } [get_ports { ck_an_n[2] }]; #IO_L7N_T1_AD6N_35 Sch=ck_an_n[2] +#set_property -dict { PACKAGE_PIN C4 IOSTANDARD LVCMOS33 } [get_ports { ck_an_p[2] }]; #IO_L7P_T1_AD6P_35 Sch=ck_an_p[2] +#set_property -dict { PACKAGE_PIN A1 IOSTANDARD LVCMOS33 } [get_ports { ck_an_n[3] }]; #IO_L9N_T1_DQS_AD7N_35 Sch=ck_an_n[3] +#set_property -dict { PACKAGE_PIN B1 IOSTANDARD LVCMOS33 } [get_ports { ck_an_p[3] }]; #IO_L9P_T1_DQS_AD7P_35 Sch=ck_an_p[3] +#set_property -dict { PACKAGE_PIN B2 IOSTANDARD LVCMOS33 } [get_ports { ck_an_n[4] }]; #IO_L10N_T1_AD15N_35 Sch=ck_an_n[4] +#set_property -dict { PACKAGE_PIN B3 IOSTANDARD LVCMOS33 } [get_ports { ck_an_p[4] }]; #IO_L10P_T1_AD15P_35 Sch=ck_an_p[4] +#set_property -dict { PACKAGE_PIN C14 IOSTANDARD LVCMOS33 } [get_ports { ck_an_n[5] }]; #IO_L1N_T0_AD0N_15 Sch=ck_an_n[5] +#set_property -dict { PACKAGE_PIN D14 IOSTANDARD LVCMOS33 } [get_ports { ck_an_p[5] }]; #IO_L1P_T0_AD0P_15 Sch=ck_an_p[5] + +##ChipKit Digital I/O Low + +set_property -dict { PACKAGE_PIN V15 IOSTANDARD LVCMOS33 } [get_ports { ck_io_0 }]; #IO_L16P_T2_CSI_B_14 Sch=ck_io[0] +set_property -dict { PACKAGE_PIN U16 IOSTANDARD LVCMOS33 } [get_ports { ck_io_1 }]; #IO_L18P_T2_A12_D28_14 Sch=ck_io[1] +set_property -dict { PACKAGE_PIN P14 IOSTANDARD LVCMOS33 } [get_ports { ck_io_2 }]; #IO_L8N_T1_D12_14 Sch=ck_io[2] +set_property -dict { PACKAGE_PIN T11 IOSTANDARD LVCMOS33 } [get_ports { ck_io_3 }]; #IO_L19P_T3_A10_D26_14 Sch=ck_io[3] +set_property -dict { PACKAGE_PIN R12 IOSTANDARD LVCMOS33 } [get_ports { ck_io_4 }]; #IO_L5P_T0_D06_14 Sch=ck_io[4] +set_property -dict { PACKAGE_PIN T14 IOSTANDARD LVCMOS33 } [get_ports { ck_io_5 }]; #IO_L14P_T2_SRCC_14 Sch=ck_io[5] +set_property -dict { PACKAGE_PIN T15 IOSTANDARD LVCMOS33 } [get_ports { ck_io_6 }]; #IO_L14N_T2_SRCC_14 Sch=ck_io[6] +set_property -dict { PACKAGE_PIN T16 IOSTANDARD LVCMOS33 } [get_ports { ck_io_7 }]; #IO_L15N_T2_DQS_DOUT_CSO_B_14 Sch=ck_io[7] +set_property -dict { PACKAGE_PIN N15 IOSTANDARD LVCMOS33 } [get_ports { ck_io_8 }]; #IO_L11P_T1_SRCC_14 Sch=ck_io[8] +set_property -dict { PACKAGE_PIN M16 IOSTANDARD LVCMOS33 } [get_ports { ck_io_9 }]; #IO_L10P_T1_D14_14 Sch=ck_io[9] +set_property -dict { PACKAGE_PIN V17 IOSTANDARD LVCMOS33 } [get_ports { ck_io_10 }]; #IO_L18N_T2_A11_D27_14 Sch=ck_io[10] +set_property -dict { PACKAGE_PIN U18 IOSTANDARD LVCMOS33 } [get_ports { ck_io_11 }]; #IO_L17N_T2_A13_D29_14 Sch=ck_io[11] +set_property -dict { PACKAGE_PIN R17 IOSTANDARD LVCMOS33 } [get_ports { ck_io_12 }]; #IO_L12N_T1_MRCC_14 Sch=ck_io[12] +set_property -dict { PACKAGE_PIN P17 IOSTANDARD LVCMOS33 } [get_ports { ck_io_13 }]; #IO_L12P_T1_MRCC_14 Sch=ck_io[13] + +##ChipKit Digital I/O On Outer Analog Header +##NOTE: These pins should be used when using the analog header signals A0-A5 as digital I/O (Chipkit digital pins 14-19) + +set_property -dict { PACKAGE_PIN F5 IOSTANDARD LVCMOS33 } [get_ports { ck_io_14 }]; #IO_0_35 Sch=ck_a[0] +set_property -dict { PACKAGE_PIN D8 IOSTANDARD LVCMOS33 } [get_ports { ck_io_15 }]; #IO_L4P_T0_35 Sch=ck_a[1] +set_property -dict { PACKAGE_PIN C7 IOSTANDARD LVCMOS33 } [get_ports { ck_io_16 }]; #IO_L4N_T0_35 Sch=ck_a[2] +set_property -dict { PACKAGE_PIN E7 IOSTANDARD LVCMOS33 } [get_ports { ck_io_17 }]; #IO_L6P_T0_35 Sch=ck_a[3] +set_property -dict { PACKAGE_PIN D7 IOSTANDARD LVCMOS33 } [get_ports { ck_io_18 }]; #IO_L6N_T0_VREF_35 Sch=ck_a[4] +set_property -dict { PACKAGE_PIN D5 IOSTANDARD LVCMOS33 } [get_ports { ck_io_19 }]; #IO_L11P_T1_SRCC_35 Sch=ck_a[5] + +##ChipKit Digital I/O On Inner Analog Header +##NOTE: These pins will need to be connected to the XADC core when used as differential analog inputs (Chipkit analog pins A6-A11) + +#set_property -dict { PACKAGE_PIN B7 IOSTANDARD LVCMOS33 } [get_ports { ck_io[20] }]; #IO_L2P_T0_AD12P_35 Sch=ad_p[12] +#set_property -dict { PACKAGE_PIN B6 IOSTANDARD LVCMOS33 } [get_ports { ck_io[21] }]; #IO_L2N_T0_AD12N_35 Sch=ad_n[12] +#set_property -dict { PACKAGE_PIN E6 IOSTANDARD LVCMOS33 } [get_ports { ck_io[22] }]; #IO_L5P_T0_AD13P_35 Sch=ad_p[13] +#set_property -dict { PACKAGE_PIN E5 IOSTANDARD LVCMOS33 } [get_ports { ck_io[23] }]; #IO_L5N_T0_AD13N_35 Sch=ad_n[13] +#set_property -dict { PACKAGE_PIN A4 IOSTANDARD LVCMOS33 } [get_ports { ck_io[24] }]; #IO_L8P_T1_AD14P_35 Sch=ad_p[14] +#set_property -dict { PACKAGE_PIN A3 IOSTANDARD LVCMOS33 } [get_ports { ck_io[25] }]; #IO_L8N_T1_AD14N_35 Sch=ad_n[14] + +##ChipKit Digital I/O High + +#set_property -dict { PACKAGE_PIN U11 IOSTANDARD LVCMOS33 } [get_ports { ck_io[26] }]; #IO_L19N_T3_A09_D25_VREF_14 Sch=ck_io[26] +#set_property -dict { PACKAGE_PIN V16 IOSTANDARD LVCMOS33 } [get_ports { ck_io[27] }]; #IO_L16N_T2_A15_D31_14 Sch=ck_io[27] +#set_property -dict { PACKAGE_PIN M13 IOSTANDARD LVCMOS33 } [get_ports { ck_io[28] }]; #IO_L6N_T0_D08_VREF_14 Sch=ck_io[28] +#set_property -dict { PACKAGE_PIN R10 IOSTANDARD LVCMOS33 } [get_ports { ck_io[29] }]; #IO_25_14 Sch=ck_io[29] +#set_property -dict { PACKAGE_PIN R11 IOSTANDARD LVCMOS33 } [get_ports { ck_io[30] }]; #IO_0_14 Sch=ck_io[30] +#set_property -dict { PACKAGE_PIN R13 IOSTANDARD LVCMOS33 } [get_ports { ck_io[31] }]; #IO_L5N_T0_D07_14 Sch=ck_io[31] +#set_property -dict { PACKAGE_PIN R15 IOSTANDARD LVCMOS33 } [get_ports { ck_io[32] }]; #IO_L13N_T2_MRCC_14 Sch=ck_io[32] +#set_property -dict { PACKAGE_PIN P15 IOSTANDARD LVCMOS33 } [get_ports { ck_io[33] }]; #IO_L13P_T2_MRCC_14 Sch=ck_io[33] +#set_property -dict { PACKAGE_PIN R16 IOSTANDARD LVCMOS33 } [get_ports { ck_io[34] }]; #IO_L15P_T2_DQS_RDWR_B_14 Sch=ck_io[34] +#set_property -dict { PACKAGE_PIN N16 IOSTANDARD LVCMOS33 } [get_ports { ck_io[35] }]; #IO_L11N_T1_SRCC_14 Sch=ck_io[35] +#set_property -dict { PACKAGE_PIN N14 IOSTANDARD LVCMOS33 } [get_ports { ck_io[36] }]; #IO_L8P_T1_D11_14 Sch=ck_io[36] +#set_property -dict { PACKAGE_PIN U17 IOSTANDARD LVCMOS33 } [get_ports { ck_io[37] }]; #IO_L17P_T2_A14_D30_14 Sch=ck_io[37] +#set_property -dict { PACKAGE_PIN T18 IOSTANDARD LVCMOS33 } [get_ports { ck_io[38] }]; #IO_L7N_T1_D10_14 Sch=ck_io[38] +#set_property -dict { PACKAGE_PIN R18 IOSTANDARD LVCMOS33 } [get_ports { ck_io[39] }]; #IO_L7P_T1_D09_14 Sch=ck_io[39] +#set_property -dict { PACKAGE_PIN P18 IOSTANDARD LVCMOS33 } [get_ports { ck_io[40] }]; #IO_L9N_T1_DQS_D13_14 Sch=ck_io[40] +#set_property -dict { PACKAGE_PIN N17 IOSTANDARD LVCMOS33 } [get_ports { ck_io[41] }]; #IO_L9P_T1_DQS_14 Sch=ck_io[41] + +## ChipKit SPI + +set_property -dict { PACKAGE_PIN G1 IOSTANDARD LVCMOS33 } [get_ports { ck_miso }]; #IO_L17N_T2_35 Sch=ck_miso +set_property -dict { PACKAGE_PIN H1 IOSTANDARD LVCMOS33 } [get_ports { ck_mosi }]; #IO_L17P_T2_35 Sch=ck_mosi +set_property -dict { PACKAGE_PIN F1 IOSTANDARD LVCMOS33 } [get_ports { ck_sck }]; #IO_L18P_T2_35 Sch=ck_sck +set_property -dict { PACKAGE_PIN C1 IOSTANDARD LVCMOS33 } [get_ports { ck_ss }]; #IO_L16N_T2_35 Sch=ck_ss + +## ChipKit I2C + +#set_property -dict { PACKAGE_PIN L18 IOSTANDARD LVCMOS33 } [get_ports { ck_scl }]; #IO_L4P_T0_D04_14 Sch=ck_scl +#set_property -dict { PACKAGE_PIN M18 IOSTANDARD LVCMOS33 } [get_ports { ck_sda }]; #IO_L4N_T0_D05_14 Sch=ck_sda +#set_property -dict { PACKAGE_PIN A14 IOSTANDARD LVCMOS33 } [get_ports { scl_pup }]; #IO_L9N_T1_DQS_AD3N_15 Sch=scl_pup +#set_property -dict { PACKAGE_PIN A13 IOSTANDARD LVCMOS33 } [get_ports { sda_pup }]; #IO_L9P_T1_DQS_AD3P_15 Sch=sda_pup + +##Misc. ChipKit signals + +#set_property -dict { PACKAGE_PIN M17 IOSTANDARD LVCMOS33 } [get_ports { ck_ioa }]; #IO_L10N_T1_D15_14 Sch=ck_ioa +set_property -dict { PACKAGE_PIN C2 IOSTANDARD LVCMOS33 } [get_ports { ck_rst }]; #IO_L16P_T2_35 Sch=ck_rst + +##SMSC Ethernet PHY + +#set_property -dict { PACKAGE_PIN D17 IOSTANDARD LVCMOS33 } [get_ports { eth_col }]; #IO_L16N_T2_A27_15 Sch=eth_col +#set_property -dict { PACKAGE_PIN G14 IOSTANDARD LVCMOS33 } [get_ports { eth_crs }]; #IO_L15N_T2_DQS_ADV_B_15 Sch=eth_crs +#set_property -dict { PACKAGE_PIN F16 IOSTANDARD LVCMOS33 } [get_ports { eth_mdc }]; #IO_L14N_T2_SRCC_15 Sch=eth_mdc +#set_property -dict { PACKAGE_PIN K13 IOSTANDARD LVCMOS33 } [get_ports { eth_mdio }]; #IO_L17P_T2_A26_15 Sch=eth_mdio +#set_property -dict { PACKAGE_PIN G18 IOSTANDARD LVCMOS33 } [get_ports { eth_ref_clk }]; #IO_L22P_T3_A17_15 Sch=eth_ref_clk +#set_property -dict { PACKAGE_PIN C16 IOSTANDARD LVCMOS33 } [get_ports { eth_rstn }]; #IO_L20P_T3_A20_15 Sch=eth_rstn +#set_property -dict { PACKAGE_PIN F15 IOSTANDARD LVCMOS33 } [get_ports { eth_rx_clk }]; #IO_L14P_T2_SRCC_15 Sch=eth_rx_clk +#set_property -dict { PACKAGE_PIN G16 IOSTANDARD LVCMOS33 } [get_ports { eth_rx_dv }]; #IO_L13N_T2_MRCC_15 Sch=eth_rx_dv +#set_property -dict { PACKAGE_PIN D18 IOSTANDARD LVCMOS33 } [get_ports { eth_rxd[0] }]; #IO_L21N_T3_DQS_A18_15 Sch=eth_rxd[0] +#set_property -dict { PACKAGE_PIN E17 IOSTANDARD LVCMOS33 } [get_ports { eth_rxd[1] }]; #IO_L16P_T2_A28_15 Sch=eth_rxd[1] +#set_property -dict { PACKAGE_PIN E18 IOSTANDARD LVCMOS33 } [get_ports { eth_rxd[2] }]; #IO_L21P_T3_DQS_15 Sch=eth_rxd[2] +#set_property -dict { PACKAGE_PIN G17 IOSTANDARD LVCMOS33 } [get_ports { eth_rxd[3] }]; #IO_L18N_T2_A23_15 Sch=eth_rxd[3] +#set_property -dict { PACKAGE_PIN C17 IOSTANDARD LVCMOS33 } [get_ports { eth_rxerr }]; #IO_L20N_T3_A19_15 Sch=eth_rxerr +#set_property -dict { PACKAGE_PIN H16 IOSTANDARD LVCMOS33 } [get_ports { eth_tx_clk }]; #IO_L13P_T2_MRCC_15 Sch=eth_tx_clk +#set_property -dict { PACKAGE_PIN H15 IOSTANDARD LVCMOS33 } [get_ports { eth_tx_en }]; #IO_L19N_T3_A21_VREF_15 Sch=eth_tx_en +#set_property -dict { PACKAGE_PIN H14 IOSTANDARD LVCMOS33 } [get_ports { eth_txd[0] }]; #IO_L15P_T2_DQS_15 Sch=eth_txd[0] +#set_property -dict { PACKAGE_PIN J14 IOSTANDARD LVCMOS33 } [get_ports { eth_txd[1] }]; #IO_L19P_T3_A22_15 Sch=eth_txd[1] +#set_property -dict { PACKAGE_PIN J13 IOSTANDARD LVCMOS33 } [get_ports { eth_txd[2] }]; #IO_L17N_T2_A25_15 Sch=eth_txd[2] +#set_property -dict { PACKAGE_PIN H17 IOSTANDARD LVCMOS33 } [get_ports { eth_txd[3] }]; #IO_L18P_T2_A24_15 Sch=eth_txd[3] + +##Quad SPI Flash + +set_property -dict { PACKAGE_PIN L16 IOSTANDARD LVCMOS33 IOB TRUE } [get_ports { qspi_sck }]; +create_clock -add -name qspi_sck_pin -period 20.00 -waveform {0 10} [get_ports { qspi_sck }]; +set_property -dict { PACKAGE_PIN L13 IOSTANDARD LVCMOS33 IOB TRUE } [get_ports { qspi_cs }]; #IO_L6P_T0_FCS_B_14 Sch=qspi_cs +set_property -dict { PACKAGE_PIN K17 IOSTANDARD LVCMOS33 IOB TRUE PULLUP TRUE } [get_ports { qspi_dq_0 }]; #IO_L1P_T0_D00_MOSI_14 Sch=qspi_dq[0] +set_property -dict { PACKAGE_PIN K18 IOSTANDARD LVCMOS33 IOB TRUE PULLUP TRUE } [get_ports { qspi_dq_1 }]; #IO_L1N_T0_D01_DIN_14 Sch=qspi_dq[1] +set_property -dict { PACKAGE_PIN L14 IOSTANDARD LVCMOS33 IOB TRUE PULLUP TRUE } [get_ports { qspi_dq_2 }]; #IO_L2P_T0_D02_14 Sch=qspi_dq[2] +set_property -dict { PACKAGE_PIN M14 IOSTANDARD LVCMOS33 IOB TRUE PULLUP TRUE } [get_ports { qspi_dq_3 }]; #IO_L2N_T0_D03_14 Sch=qspi_dq[3] + +##Power Measurements + +#set_property -dict { PACKAGE_PIN B17 IOSTANDARD LVCMOS33 } [get_ports { vsnsvu_n }]; #IO_L7N_T1_AD2N_15 Sch=ad_n[2] +#set_property -dict { PACKAGE_PIN B16 IOSTANDARD LVCMOS33 } [get_ports { vsnsvu_p }]; #IO_L7P_T1_AD2P_15 Sch=ad_p[2] +#set_property -dict { PACKAGE_PIN B12 IOSTANDARD LVCMOS33 } [get_ports { vsns5v0_n }]; #IO_L3N_T0_DQS_AD1N_15 Sch=ad_n[1] +#set_property -dict { PACKAGE_PIN C12 IOSTANDARD LVCMOS33 } [get_ports { vsns5v0_p }]; #IO_L3P_T0_DQS_AD1P_15 Sch=ad_p[1] +#set_property -dict { PACKAGE_PIN F14 IOSTANDARD LVCMOS33 } [get_ports { isns5v0_n }]; #IO_L5N_T0_AD9N_15 Sch=ad_n[9] +#set_property -dict { PACKAGE_PIN F13 IOSTANDARD LVCMOS33 } [get_ports { isns5v0_p }]; #IO_L5P_T0_AD9P_15 Sch=ad_p[9] +#set_property -dict { PACKAGE_PIN A16 IOSTANDARD LVCMOS33 } [get_ports { isns0v95_n }]; #IO_L8N_T1_AD10N_15 Sch=ad_n[10] +#set_property -dict { PACKAGE_PIN A15 IOSTANDARD LVCMOS33 } [get_ports { isns0v95_p }]; #IO_L8P_T1_AD10P_15 Sch=ad_p[10] + +set_clock_groups -asynchronous \ + -group [list \ + [get_clocks -include_generated_clocks -of_objects [get_ports jd_2]]] \ + -group [list \ + [get_clocks -of_objects [get_pins ip_mmcm/inst/mmcm_adv_inst/CLKOUT0]]] \ + -group [list \ + [get_clocks -of_objects [get_pins ip_mmcm/inst/mmcm_adv_inst/CLKOUT1]] \ + [get_clocks -of_objects [get_pins ip_mmcm/inst/mmcm_adv_inst/CLKOUT2]]] diff --git a/hdl_cores/freedom/fpga-shells/xilinx/arty_a7_100/tcl/board.tcl b/hdl_cores/freedom/fpga-shells/xilinx/arty_a7_100/tcl/board.tcl new file mode 100644 index 0000000..70635da --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/xilinx/arty_a7_100/tcl/board.tcl @@ -0,0 +1,5 @@ +# See LICENSE for license details. +set name {arty-a7-100} +set part_fpga {xc7a100ticsg324-1L} +set part_board {digilentinc.com:arty-a7-100:part0:1.0} +set bootrom_inst {rom} diff --git a/hdl_cores/freedom/fpga-shells/xilinx/arty_a7_100/tcl/ip.tcl b/hdl_cores/freedom/fpga-shells/xilinx/arty_a7_100/tcl/ip.tcl new file mode 100644 index 0000000..3dc9faa --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/xilinx/arty_a7_100/tcl/ip.tcl @@ -0,0 +1,43 @@ +# See LICENSE for license details. + +create_ip -vendor xilinx.com -library ip -name clk_wiz -module_name mmcm -dir $ipdir -force +set_property -dict [list \ + CONFIG.PRIMITIVE {MMCM} \ + CONFIG.RESET_TYPE {ACTIVE_LOW} \ + CONFIG.CLKOUT1_USED {true} \ + CONFIG.CLKOUT2_USED {true} \ + CONFIG.CLKOUT3_USED {true} \ + CONFIG.CLKOUT1_REQUESTED_OUT_FREQ {8.388} \ + CONFIG.CLKOUT2_REQUESTED_OUT_FREQ {65.000} \ + CONFIG.CLKOUT3_REQUESTED_OUT_FREQ {32.500} \ + ] [get_ips mmcm] + +create_ip -vendor xilinx.com -library ip -name proc_sys_reset -module_name reset_sys -dir $ipdir -force +set_property -dict [list \ + CONFIG.C_EXT_RESET_HIGH {false} \ + CONFIG.C_AUX_RESET_HIGH {false} \ + CONFIG.C_NUM_BUS_RST {1} \ + CONFIG.C_NUM_PERP_RST {1} \ + CONFIG.C_NUM_INTERCONNECT_ARESETN {1} \ + CONFIG.C_NUM_PERP_ARESETN {1} \ + ] [get_ips reset_sys] + +create_ip -vendor xilinx.com -library ip -name ila -module_name ila -dir $ipdir -force +set_property -dict [list \ + CONFIG.C_NUM_OF_PROBES {1} \ + CONFIG.C_TRIGOUT_EN {false} \ + CONFIG.C_TRIGIN_EN {false} \ + CONFIG.C_MONITOR_TYPE {Native} \ + CONFIG.C_ENABLE_ILA_AXI_MON {false} \ + CONFIG.C_PROBE0_WIDTH {4} \ + CONFIG.C_PROBE10_TYPE {1} \ + CONFIG.C_PROBE10_WIDTH {32} \ + CONFIG.C_PROBE11_TYPE {1} \ + CONFIG.C_PROBE11_WIDTH {32} \ + CONFIG.C_PROBE12_TYPE {1} \ + CONFIG.C_PROBE12_WIDTH {64} \ + CONFIG.C_PROBE13_TYPE {1} \ + CONFIG.C_PROBE13_WIDTH {64} \ + CONFIG.C_PROBE14_TYPE {1} \ + CONFIG.C_PROBE14_WIDTH {97} \ + ] [get_ips ila] diff --git a/hdl_cores/freedom/fpga-shells/xilinx/common/tcl/bitstream.tcl b/hdl_cores/freedom/fpga-shells/xilinx/common/tcl/bitstream.tcl new file mode 100644 index 0000000..bf223f6 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/xilinx/common/tcl/bitstream.tcl @@ -0,0 +1,10 @@ +# See LICENSE for license details. + +# Write a bitstream for the current design +write_bitstream -force [file join $wrkdir "${top}.bit"] + +# Save the timing delays for cells in the design in SDF format +write_sdf -force [file join $wrkdir "${top}.sdf"] + +# Export the current netlist in verilog format +write_verilog -mode timesim -force [file join ${wrkdir} "${top}.v"] diff --git a/hdl_cores/freedom/fpga-shells/xilinx/common/tcl/boards.tcl b/hdl_cores/freedom/fpga-shells/xilinx/common/tcl/boards.tcl new file mode 100644 index 0000000..af1c686 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/xilinx/common/tcl/boards.tcl @@ -0,0 +1,9 @@ +# See LICENSE for license details. + +namespace eval ::program::boards {} + +set ::program::boards::spec [dict create \ + arty [dict create iface spix4 size 16 bitaddr 0x0 memdev {n25q128-3.3v-spi-x1_x2_x4}] \ + arty_a7_100 [dict create iface spix4 size 16 bitaddr 0x0 memdev {s25fl128sxxxxxx0-spi-x1_x2_x4}] \ + vc707 [dict create iface bpix16 size 128 bitaddr 0x3000000 ] \ + vcu118 [dict create iface spix8 size 256 bitaddr 0x0 memdev {mt25qu01g-spi-x1_x2_x4_x8}]] diff --git a/hdl_cores/freedom/fpga-shells/xilinx/common/tcl/init.tcl b/hdl_cores/freedom/fpga-shells/xilinx/common/tcl/init.tcl new file mode 100644 index 0000000..1ea645f --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/xilinx/common/tcl/init.tcl @@ -0,0 +1,48 @@ +# See LICENSE for license details. + +# Include helper functions +source [file join $scriptdir "util.tcl"] + +# Create the directory for IPs +file mkdir $ipdir + +# Update the IP catalog +update_ip_catalog -rebuild + +# Generate IP implementations. Vivado TCL emitted from Chisel Blackboxes +foreach ip_vivado_tcl $ip_vivado_tcls { + source $ip_vivado_tcl +} +# Optional board-specific ip script +set boardiptcl [file join $boarddir tcl ip.tcl] +if {[file exists $boardiptcl]} { + source $boardiptcl +} + +# AR 58526 +set xci_files [get_files -all {*.xci}] +foreach xci_file $xci_files { + set_property GENERATE_SYNTH_CHECKPOINT {false} -quiet $xci_file +} + +# Get a list of IPs in the current design +set obj [get_ips] + +# Generate target data for the included IPs in the design +generate_target all $obj + +# Export the IP user files +export_ip_user_files -of_objects $obj -no_script -force + +# Get the list of active source and constraint files +set obj [current_fileset] + +#Xilinx bug workaround +#scrape IP tree for directories containing .vh files +#[get_property include_dirs] misses all IP core subdirectory includes if user has specified -dir flag in create_ip +set property_include_dirs [get_property include_dirs $obj] + +# Include generated files for the IPs in the design +set ip_include_dirs [concat $property_include_dirs [findincludedir $ipdir "*.vh"]] +set ip_include_dirs [concat $ip_include_dirs [findincludedir $srcdir "*.h"]] +set ip_include_dirs [concat $ip_include_dirs [findincludedir $srcdir "*.vh"]] diff --git a/hdl_cores/freedom/fpga-shells/xilinx/common/tcl/opt.tcl b/hdl_cores/freedom/fpga-shells/xilinx/common/tcl/opt.tcl new file mode 100644 index 0000000..81bf4ad --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/xilinx/common/tcl/opt.tcl @@ -0,0 +1,7 @@ +# See LICENSE for license details. + +# Optimize the netlist +opt_design -directive Explore + +# Checkpoint the current design +write_checkpoint -force [file join $wrkdir post_opt] diff --git a/hdl_cores/freedom/fpga-shells/xilinx/common/tcl/place.tcl b/hdl_cores/freedom/fpga-shells/xilinx/common/tcl/place.tcl new file mode 100644 index 0000000..ccc862a --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/xilinx/common/tcl/place.tcl @@ -0,0 +1,13 @@ +# See LICENSE for license details. + +# Place the current design +place_design -directive Explore + +# Optimize the current placed netlist +phys_opt_design -directive Explore + +# Optimize dynamic power using intelligent clock gating +power_opt_design + +# Checkpoint the current design +write_checkpoint -force [file join $wrkdir post_place] diff --git a/hdl_cores/freedom/fpga-shells/xilinx/common/tcl/prologue.tcl b/hdl_cores/freedom/fpga-shells/xilinx/common/tcl/prologue.tcl new file mode 100644 index 0000000..b513f41 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/xilinx/common/tcl/prologue.tcl @@ -0,0 +1,138 @@ +# See LICENSE for license details. + +# Process command line arguments +# http://wiki.tcl.tk/1730 +set ip_vivado_tcls {} + +while {[llength $argv]} { + set argv [lassign $argv[set argv {}] flag] + switch -glob $flag { + -top-module { + set argv [lassign $argv[set argv {}] top] + } + -F { + # This should be a simple file format with one filepath per line + set argv [lassign $argv[set argv {}] vsrc_manifest] + } + -include_dirs { + # This should be a simple file format with one filepath per line + set argv [lassign $argv[set argv {}] incdir_manifest] + } + + -board { + set argv [lassign $argv[set argv {}] board] + } + -ip-vivado-tcls { + set argv [lassign $argv[set argv {}] ip_vivado_tcls] + } + -pre-impl-debug-tcl { + set argv [lassign $argv[set argv {}] pre_impl_debug_tcl] + } + -post-impl-debug-tcl { + set argv [lassign $argv[set argv {}] post_impl_debug_tcl] + } + -env-var-srcs { + set argv [lassign $argv[set argv {}] env_var_srcs] + } + default { + return -code error [list {unknown option} $flag] + } + } +} +# tcl-env-srcs: Command line argument to pass the name of an environment variable that contains additional vsrcs +# (from what is contained in .F file) that you want to have read in + +if {![info exists top]} { + return -code error [list {--top-module option is required}] +} + +if {![info exists vsrc_manifest]} { + return -code error [list {-F option is required}] +} + +if {![info exists board]} { + return -code error [list {--board option is required}] +} + +# Set the variable for all the common files +set commondir [file dirname $scriptdir] + +# Set the variable that points to board specific files +set boarddir [file join [file dirname $commondir] $board] +source [file join $boarddir tcl board.tcl] + +# Set the variable that points to board constraint files +set constraintsdir [file join $boarddir constraints] + +# Set the variable that points to common verilog sources +set srcdir [file join $commondir vsrc] + +# Creates a work directory +set wrkdir [file join [pwd] obj] + +# Create the directory for IPs +set ipdir [file join $wrkdir ip] + +# Create an in-memory project +create_project -part $part_fpga -force $top + +set_param messaging.defaultLimit 1000000 + +# Set the board part, target language, default library, and IP directory +# paths for the current project +set_property -dict [list \ + BOARD_PART $part_board \ + TARGET_LANGUAGE {Verilog} \ + DEFAULT_LIB {xil_defaultlib} \ + IP_REPO_PATHS $ipdir \ + ] [current_project] + +if {[get_filesets -quiet sources_1] eq ""} { + create_fileset -srcset sources_1 +} +set obj [current_fileset] + +# Add verilog files from manifest +proc load_vsrc_manifest {obj vsrc_manifest} { + set fp [open $vsrc_manifest r] + set files [lsearch -not -exact -all -inline [split [read $fp] "\n"] {}] + set relative_files {} + foreach path $files { + if {[string match {/*} $path]} { + lappend relative_files $path + } elseif {![string match {#*} $path]} { + lappend relative_files [file join [file dirname $vsrc_manifest] $path] + } + } + # Read environment variable vsrcs and append to relative_files + if {[info exists env_var_srcs)]} { + if {[info exists ::env($env_var_srcs)]} { + set resources [split $::env($env_var_srcs) :] + set relative_files [list {*}$relative_files {*}$resources] + } + } + add_files -norecurse -fileset $obj {*}$relative_files + close $fp +} + +load_vsrc_manifest $obj $vsrc_manifest + +# Add IP Vivado TCL +if {$ip_vivado_tcls ne {}} { + # Split string into words even with multiple consecutive spaces + # http://wiki.tcl.tk/989 + set ip_vivado_tcls [regexp -inline -all -- {\S+} $ip_vivado_tcls] +} + +if {[get_filesets -quiet sim_1] eq ""} { + create_fileset -simset sim_1 +} +set obj [current_fileset -simset] + +if {[get_filesets -quiet constrs_1] eq ""} { + create_fileset -constrset constrs_1 +} + +set obj [current_fileset -constrset] +add_files -quiet -norecurse -fileset $obj [lsort [glob -directory $constraintsdir -nocomplain {*.tcl}]] +add_files -quiet -norecurse -fileset $obj [lsort [glob -directory $constraintsdir -nocomplain {*.xdc}]] diff --git a/hdl_cores/freedom/fpga-shells/xilinx/common/tcl/report.tcl b/hdl_cores/freedom/fpga-shells/xilinx/common/tcl/report.tcl new file mode 100644 index 0000000..a499537 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/xilinx/common/tcl/report.tcl @@ -0,0 +1,44 @@ +# See LICENSE for license details. + +# Create a report directory +set rptdir [file join $wrkdir report] +file mkdir $rptdir + +# Create a datasheet for the current design +report_datasheet -file [file join $rptdir datasheet.txt] + +# Report utilization of the current device +set rptutil [file join $rptdir utilization.txt] +report_utilization -hierarchical -file $rptutil + +# Report information about clock nets in the design +report_clock_utilization -file $rptutil -append + +# Report the RAM resources utilized in the implemented design +report_ram_utilization -file $rptutil -append -detail + +# Report timing summary for a max of 10 paths per group +report_timing_summary -file [file join $rptdir timing.txt] -max_paths 10 + +# Report the highest fanout of nets in the implemented design +report_high_fanout_nets -file [file join $rptdir fanout.txt] -timing -load_types -max_nets 25 + +# Run DRC +report_drc -file [file join $rptdir drc.txt] + +# Report details of the IO banks in the design +report_io -file [file join $rptdir io.txt] + +# Report a table of all clocks in the design +report_clocks -file [file join $rptdir clocks.txt] + +# Fail loudly if timing not met +# +# We would ideally elevate critical warning Route 35-39 to an error, but it is +# currently not being emitted with our flow for some reason. +# https://forums.xilinx.com/t5/Implementation/Making-timing-violations-fatal-to-the-Vivado-build/m-p/716957#M15979 +set timing_slack [get_property SLACK [get_timing_paths]] +if {$timing_slack < 0} { + puts "Failed to meet timing by $timing_slack, see [file join $rptdir timing.txt]" + exit 1 +} diff --git a/hdl_cores/freedom/fpga-shells/xilinx/common/tcl/route.tcl b/hdl_cores/freedom/fpga-shells/xilinx/common/tcl/route.tcl new file mode 100644 index 0000000..68fc84a --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/xilinx/common/tcl/route.tcl @@ -0,0 +1,10 @@ +# See LICENSE for license details. + +# Route the current design +route_design -directive Explore + +# Optimize the current design post routing +phys_opt_design -directive Explore + +# Checkpoint the current design +write_checkpoint -force [file join $wrkdir post_route] diff --git a/hdl_cores/freedom/fpga-shells/xilinx/common/tcl/synth.tcl b/hdl_cores/freedom/fpga-shells/xilinx/common/tcl/synth.tcl new file mode 100644 index 0000000..14be6ba --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/xilinx/common/tcl/synth.tcl @@ -0,0 +1,25 @@ +# See LICENSE for license details. + +# Create the include dirs +proc load_incdirs_manifest {incdir_manifest} { + set fp [open $incdir_manifest r] + set files [lsearch -not -exact -all -inline [split [read $fp] "\n"] {}] + + close $fp + return $files + +} + +# Read the specified list of IP files +read_ip [glob -directory $ipdir [file join * {*.xci}]] + +# Capture the include directories +set include_directories [load_incdirs_manifest $incdir_manifest] + +puts "DEBUG: include_directories = $include_directories" + +# Synthesize the design +synth_design -top $top -flatten_hierarchy rebuilt -include_dirs $include_directories + +# Checkpoint the current design +write_checkpoint -force [file join $wrkdir post_synth] diff --git a/hdl_cores/freedom/fpga-shells/xilinx/common/tcl/util.tcl b/hdl_cores/freedom/fpga-shells/xilinx/common/tcl/util.tcl new file mode 100644 index 0000000..eda723f --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/xilinx/common/tcl/util.tcl @@ -0,0 +1,24 @@ +# See LICENSE for license details. + +# Helper function that recursively includes files given a directory and a +# pattern/suffix extensions +proc recglob { basedir pattern } { + set dirlist [glob -nocomplain -directory $basedir -type d *] + set findlist [glob -nocomplain -directory $basedir $pattern] + foreach dir $dirlist { + set reclist [recglob $dir $pattern] + set findlist [concat $findlist $reclist] + } + return $findlist +} + +# Helper function to find all subdirectories containing ".vh" files +proc findincludedir { basedir pattern } { + set vhfiles [recglob $basedir $pattern] + set vhdirs {} + foreach match $vhfiles { + lappend vhdirs [file dir $match] + } + set uniquevhdirs [lsort -unique $vhdirs] + return $uniquevhdirs +} diff --git a/hdl_cores/freedom/fpga-shells/xilinx/common/tcl/vivado.tcl b/hdl_cores/freedom/fpga-shells/xilinx/common/tcl/vivado.tcl new file mode 100644 index 0000000..46f2614 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/xilinx/common/tcl/vivado.tcl @@ -0,0 +1,43 @@ +# See LICENSE for license details. + +# Set the variable for the directory that includes all scripts +set scriptdir [file dirname [info script]] + +# Set up variables and Vivado objects +source [file join $scriptdir "prologue.tcl"] + +# Initialize Vivado project files +source [file join $scriptdir "init.tcl"] + +# Synthesize the design +source [file join $scriptdir "synth.tcl"] + +# Pre-implementation debug +if {[info exists pre_impl_debug_tcl]} { + source [file join $scriptdir $pre_impl_debug_tcl] +} + +# Post synthesis optimization +source [file join $scriptdir "opt.tcl"] + +# Post-opt debug +if {[info exists post_opt_debug_tcl]} { + source [file join $scriptdir $post_opt_debug_tcl] +} + +# Place the design +source [file join $scriptdir "place.tcl"] + +# Route the design +source [file join $scriptdir "route.tcl"] + +# Generate bitstream and save verilog netlist +source [file join $scriptdir "bitstream.tcl"] + +# Post-implementation debug +if {[info exists post_impl_debug_tcl]} { + source [file join $scriptdir $post_impl_debug_tcl] +} + +# Create reports for the current implementation +source [file join $scriptdir "report.tcl"] diff --git a/hdl_cores/freedom/fpga-shells/xilinx/common/tcl/write_cfgmem.tcl b/hdl_cores/freedom/fpga-shells/xilinx/common/tcl/write_cfgmem.tcl new file mode 100644 index 0000000..ebce010 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/xilinx/common/tcl/write_cfgmem.tcl @@ -0,0 +1,26 @@ +# See LICENSE for license details. +# +# Create an MCS-format memory configuration file from a bitstream and an +# optional data file. + +set script_program_dir [file dirname [info script]] +source [file join $script_program_dir {boards.tcl}] + +if {$argc < 3 || $argc > 4} { + puts $argc + puts {Error: Invalid number of arguments} + puts {Usage: write_cfgmem.tcl board mcsfile bitfile [datafile]} + exit 1 +} +lassign $argv board mcsfile bitfile datafile + +if {![dict exists $::program::boards::spec $board]} { + puts {Unsupported board} + exit 1 +} +set board [dict get $::program::boards::spec $board] + +write_cfgmem -format mcs -interface [dict get $board iface] -size [dict get $board size] \ + -loadbit "up [dict get $board bitaddr] $bitfile" \ + -loaddata [expr {$datafile ne "" ? "up 0x400000 $datafile" : ""}] \ + -file $mcsfile -force diff --git a/hdl_cores/freedom/fpga-shells/xilinx/common/vsrc/PowerOnResetFPGAOnly.v b/hdl_cores/freedom/fpga-shells/xilinx/common/vsrc/PowerOnResetFPGAOnly.v new file mode 100644 index 0000000..0355596 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/xilinx/common/vsrc/PowerOnResetFPGAOnly.v @@ -0,0 +1,16 @@ +// See LICENSE file for license details. +(* keep_hierarchy = "yes" *) module PowerOnResetFPGAOnly( + input clock, + (* dont_touch = "true" *) output power_on_reset +); + reg reset; + assign power_on_reset = reset; + + initial begin + reset <= 1'b1; + end + + always @(posedge clock) begin + reset <= 1'b0; + end +endmodule diff --git a/hdl_cores/freedom/fpga-shells/xilinx/vc707/constraints/vc707-master.xdc b/hdl_cores/freedom/fpga-shells/xilinx/vc707/constraints/vc707-master.xdc new file mode 100644 index 0000000..b972196 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/xilinx/vc707/constraints/vc707-master.xdc @@ -0,0 +1,6 @@ +#-------------- MCS Generation ---------------------- +set_property CFGBVS GND [current_design] +set_property CONFIG_VOLTAGE 1.8 [current_design] + +set_property EXTRACT_ENABLE YES [get_cells dut_/spi_0_1/mac/phy/txd_reg*] +set_property EXTRACT_ENABLE YES [get_cells dut_/spi_0_1/mac/phy/sck_reg] diff --git a/hdl_cores/freedom/fpga-shells/xilinx/vc707/tcl/board.tcl b/hdl_cores/freedom/fpga-shells/xilinx/vc707/tcl/board.tcl new file mode 100644 index 0000000..1043fa2 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/xilinx/vc707/tcl/board.tcl @@ -0,0 +1,4 @@ +# See LICENSE for license details. +set name {vc707} +set part_fpga {xc7vx485tffg1761-2} +set part_board {xilinx.com:vc707:part0:1.3} diff --git a/hdl_cores/freedom/fpga-shells/xilinx/vc707/tcl/clocks.tcl b/hdl_cores/freedom/fpga-shells/xilinx/vc707/tcl/clocks.tcl new file mode 100644 index 0000000..c62158d --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/xilinx/vc707/tcl/clocks.tcl @@ -0,0 +1,60 @@ +if { [llength [get_ports -quiet chiplink_b2c_clk]] > 0 } { + create_clock -name chiplink_b2c_clock -period 10 [get_ports chiplink_b2c_clk] + create_generated_clock -name {chiplink_c2b_clock} \ + -divide_by 1 \ + -source [ get_pins { vc707_sys_clock_mmcm0/inst/mmcm_adv_inst/CLKOUT6 } ] \ + [ get_ports { chiplink_c2b_clk } ] + + # RX side: want to latch almost anywhere except on the rising edge of the clock + # The data signals coming from Aloe have: clock - 1.2 <= transition <= clock + 0.8 + # Let's add 0.6ns of safety for trace jitter+skew on both sides: + # min = hold = - 1.2 - 0.6 + # max = period - setup = 0.8 + 0.6 + set_input_delay -min -1.8 -clock {chiplink_b2c_clock} [ get_ports { chiplink_b2c_data* chiplink_b2c_rst chiplink_b2c_send } ] + set_input_delay -max 1.4 -clock {chiplink_b2c_clock} [ get_ports { chiplink_b2c_data* chiplink_b2c_rst chiplink_b2c_send } ] + + # TX side: want to transition almost anywhere except on the rising edge of the clock + # The data signals going to Aloe must have: clock - 1.85 <= NO transition <= clock + 0.65 + # Let's add 1ns of safey for trace jitter+skew on both sides: + # min = -hold = -0.65 - 0.6 + # max = setup = 1.85 + 0.6 + set_output_delay -min -1.25 -clock {chiplink_c2b_clock} [ get_ports { chiplink_c2b_data* chiplink_c2b_rst chiplink_c2b_send } ] + set_output_delay -max 2.45 -clock {chiplink_c2b_clock} [ get_ports { chiplink_c2b_data* chiplink_c2b_rst chiplink_c2b_send } ] +} + +set group_mem [get_clocks -quiet {clk_pll_i}] +set group_sys [get_clocks -quiet {sys_diff_clk \ + clk_out*_vc707_sys_clock_mmcm1 \ + clk_out*_vc707_sys_clock_mmcm2 \ + chiplink_c2b_clock}] +set group_cl [get_clocks -quiet {chiplink_b2c_clock \ + clk_out*_vc707_sys_clock_mmcm3}] +set group_pci [get_clocks -quiet {userclk1 txoutclk}] + +create_clock -add -name JTCK -period 100 -waveform {0 50} [get_ports {jtag_TCK}] +if { [llength [get_ports -quiet {ulpi_clk}]] > 0 } { create_clock -add -name ULPI_CLK -period 16.667 [get_ports {ulpi_clk}] } + +set group_jtag [get_clocks -quiet {JTCK}] + +if { [llength [get_ports -quiet {ulpi_clk}]] > 0 } { set group_ulpi [get_clocks -quiet {ULPI_CLK}] } +else {set group_ulpi {} } + +puts "group_mem: $group_mem" +puts "group_sys: $group_sys" +puts "group_pci: $group_pci" +puts "group_cl: $group_cl" +puts "group_jtag: $group_jtag" +puts "group_ulpi: $group_ulpi" + +set groups [list] +if { [llength $group_mem] > 0 } { lappend groups -group $group_mem } +if { [llength $group_sys] > 0 } { lappend groups -group $group_sys } +if { [llength $group_pci] > 0 } { lappend groups -group $group_pci } +if { [llength $group_cl] > 0 } { lappend groups -group $group_cl } +if { [llength $group_jtag] > 0 } { lappend groups -group $group_jtag } +if { [llength $group_ulpi] > 0 } { lappend groups -group $group_ulpi } + +puts "set_clock_groups -asynchronous $groups" +set_clock_groups -asynchronous {*}$groups + +set_false_path -from [get_clocks JTCK] -to [get_clocks -of_objects [get_pins lazysys/xilinxvc707mig_1/island/blackbox/u_vc707mig4gb_mig/u_iodelay_ctrl/clk_ref_mmcm_gen.mmcm_i/CLKOUT1]] diff --git a/hdl_cores/freedom/fpga-shells/xilinx/vc707/tcl/ios.tcl b/hdl_cores/freedom/fpga-shells/xilinx/vc707/tcl/ios.tcl new file mode 100644 index 0000000..915b683 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/xilinx/vc707/tcl/ios.tcl @@ -0,0 +1,68 @@ +#---------------Physical Constraints----------------- + +#get_port_part_pins +#clk_n clk_p dip_switches_tri_i_0 dip_switches_tri_i_1 dip_switches_tri_i_2 dip_switches_tri_i_3 dip_switches_tri_i_4 dip_switches_tri_i_5 dip_switches_tri_i_6 dip_switches_tri_i_7 iic_main_scl_i iic_main_sda_i lcd_7bits_tri_o_0 lcd_7bits_tri_o_1 lcd_7bits_tri_o_2 lcd_7bits_tri_o_3 lcd_7bits_tri_o_4 lcd_7bits_tri_o_5 lcd_7bits_tri_o_6 leds_8bits_tri_o_0 leds_8bits_tri_o_1 leds_8bits_tri_o_2 leds_8bits_tri_o_3 leds_8bits_tri_o_4 leds_8bits_tri_o_5 leds_8bits_tri_o_6 leds_8bits_tri_o_7 linear_flash_addr_1 linear_flash_addr_10 linear_flash_addr_11 linear_flash_addr_12 linear_flash_addr_13 linear_flash_addr_14 linear_flash_addr_15 linear_flash_addr_16 linear_flash_addr_17 linear_flash_addr_18 linear_flash_addr_19 linear_flash_addr_2 linear_flash_addr_20 linear_flash_addr_21 linear_flash_addr_22 linear_flash_addr_23 linear_flash_addr_24 linear_flash_addr_25 linear_flash_addr_26 linear_flash_addr_3 linear_flash_addr_4 linear_flash_addr_5 linear_flash_addr_6 linear_flash_addr_7 linear_flash_addr_8 linear_flash_addr_9 linear_flash_adv_ldn linear_flash_ce_n linear_flash_dq_i_0 linear_flash_dq_i_1 linear_flash_dq_i_10 linear_flash_dq_i_11 linear_flash_dq_i_12 linear_flash_dq_i_13 linear_flash_dq_i_14 linear_flash_dq_i_15 linear_flash_dq_i_2 linear_flash_dq_i_3 linear_flash_dq_i_4 linear_flash_dq_i_5 linear_flash_dq_i_6 linear_flash_dq_i_7 linear_flash_dq_i_8 linear_flash_dq_i_9 linear_flash_oen linear_flash_wen mdc mdio_i phy_rst_out push_buttons_5bits_tri_i_0 push_buttons_5bits_tri_i_1 push_buttons_5bits_tri_i_2 push_buttons_5bits_tri_i_3 push_buttons_5bits_tri_i_4 reset rotary_inca_push_incb_tri_i_0 rotary_inca_push_incb_tri_i_1 rotary_inca_push_incb_tri_i_2 rs232_uart_rxd rs232_uart_txd sfp_rxn sfp_rxp sfp_sgmii_txn sfp_sgmii_txp sgmii_mgt_clkn sgmii_mgt_clkp sgmii_rxn sgmii_rxp sgmii_txn sgmii_txp sma_lvds_rxn sma_lvds_rxp sma_lvds_txn sma_lvds_txp sma_mgt_clkn sma_mgt_clkp sma_sfp_rxn sma_sfp_rxp sma_sfp_txn sma_sfp_txp + +set_property BOARD_PIN {clk_p} [get_ports sys_diff_clock_clk_p] +set_property BOARD_PIN {clk_n} [get_ports sys_diff_clock_clk_n] +set_property BOARD_PIN {reset} [get_ports reset] + +create_clock -name sys_diff_clk -period 5.0 [get_ports sys_diff_clock_clk_p] +set_input_jitter [get_clocks -of_objects [get_ports sys_diff_clock_clk_p]] 0.5 + +set_property BOARD_PIN {leds_8bits_tri_o_0} [get_ports led_0] +set_property BOARD_PIN {leds_8bits_tri_o_1} [get_ports led_1] +set_property BOARD_PIN {leds_8bits_tri_o_2} [get_ports led_2] +set_property BOARD_PIN {leds_8bits_tri_o_3} [get_ports led_3] +set_property BOARD_PIN {leds_8bits_tri_o_4} [get_ports led_4] +set_property BOARD_PIN {leds_8bits_tri_o_5} [get_ports led_5] +set_property BOARD_PIN {leds_8bits_tri_o_6} [get_ports led_6] +set_property BOARD_PIN {leds_8bits_tri_o_7} [get_ports led_7] + +set_property BOARD_PIN {push_buttons_5bits_tri_i_0} [get_ports btn_0] +set_property BOARD_PIN {push_buttons_5bits_tri_i_1} [get_ports btn_1] +set_property BOARD_PIN {push_buttons_5bits_tri_i_2} [get_ports btn_2] +set_property BOARD_PIN {push_buttons_5bits_tri_i_3} [get_ports btn_3] + +set_property BOARD_PIN {dip_switches_tri_i_0} [get_ports sw_0] +set_property BOARD_PIN {dip_switches_tri_i_1} [get_ports sw_1] +set_property BOARD_PIN {dip_switches_tri_i_2} [get_ports sw_2] +set_property BOARD_PIN {dip_switches_tri_i_3} [get_ports sw_3] +set_property BOARD_PIN {dip_switches_tri_i_4} [get_ports sw_4] +set_property BOARD_PIN {dip_switches_tri_i_5} [get_ports sw_5] +set_property BOARD_PIN {dip_switches_tri_i_6} [get_ports sw_6] +set_property BOARD_PIN {dip_switches_tri_i_7} [get_ports sw_7] + +set_property PACKAGE_PIN AU33 [get_ports uart_rx] +set_property IOSTANDARD LVCMOS18 [get_ports uart_rx] +set_property IOB TRUE [get_cells -of_objects [all_fanout -flat -endpoints_only [get_ports uart_rx]]] +set_property PACKAGE_PIN AT32 [get_ports uart_ctsn] +set_property IOSTANDARD LVCMOS18 [get_ports uart_ctsn] +set_property IOB TRUE [get_ports uart_ctsn] +set_property PACKAGE_PIN AU36 [get_ports uart_tx] +set_property IOSTANDARD LVCMOS18 [get_ports uart_tx] +set_property IOB TRUE [get_cells -of_objects [all_fanin -flat -startpoints_only [get_ports uart_tx]]] +set_property PACKAGE_PIN AR34 [get_ports uart_rtsn] +set_property IOSTANDARD LVCMOS18 [get_ports uart_rtsn] +set_property IOB TRUE [get_ports uart_rtsn] + +# PCI Express +#FMC 1 refclk +set_property PACKAGE_PIN A10 [get_ports {pcie_REFCLK_rxp}] +set_property PACKAGE_PIN A9 [get_ports {pcie_REFCLK_rxn}] +create_clock -name pcie_ref_clk -period 10 [get_ports pcie_REFCLK_rxp] +set_input_jitter [get_clocks -of_objects [get_ports pcie_REFCLK_rxp]] 0.5 + +set_property PACKAGE_PIN H4 [get_ports {pcie_pci_exp_txp}] +set_property PACKAGE_PIN H3 [get_ports {pcie_pci_exp_txn}] + +set_property PACKAGE_PIN G6 [get_ports {pcie_pci_exp_rxp}] +set_property PACKAGE_PIN G5 [get_ports {pcie_pci_exp_rxn}] + +# SDIO +set_property -dict { PACKAGE_PIN AN30 IOSTANDARD LVCMOS18 IOB TRUE } [get_ports {sdio_clk}] +set_property -dict { PACKAGE_PIN AP30 IOSTANDARD LVCMOS18 IOB TRUE PULLUP TRUE } [get_ports {sdio_cmd}] +set_property -dict { PACKAGE_PIN AR30 IOSTANDARD LVCMOS18 IOB TRUE PULLUP TRUE } [get_ports {sdio_dat[0]}] +set_property -dict { PACKAGE_PIN AU31 IOSTANDARD LVCMOS18 IOB TRUE PULLUP TRUE } [get_ports {sdio_dat[1]}] +set_property -dict { PACKAGE_PIN AV31 IOSTANDARD LVCMOS18 IOB TRUE PULLUP TRUE } [get_ports {sdio_dat[2]}] +set_property -dict { PACKAGE_PIN AT30 IOSTANDARD LVCMOS18 IOB TRUE PULLUP TRUE } [get_ports {sdio_dat[3]}] diff --git a/hdl_cores/freedom/fpga-shells/xilinx/vc707/vsrc/sdio.v b/hdl_cores/freedom/fpga-shells/xilinx/vc707/vsrc/sdio.v new file mode 100644 index 0000000..9528410 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/xilinx/vc707/vsrc/sdio.v @@ -0,0 +1,58 @@ +// See LICENSE for license details. +`timescale 1ns/1ps +`default_nettype none + +module sdio_spi_bridge ( + input wire clk, + input wire reset, + // SDIO + inout wire sd_cmd, + inout wire [3:0] sd_dat, + output wire sd_sck, + // QUAD SPI + input wire spi_sck, + input wire [3:0] spi_dq_o, + output wire [3:0] spi_dq_i, + output wire spi_cs +); + + wire mosi, miso; +(* extract_reset = "yes" *) reg miso_sync [1:0]; + assign mosi = spi_dq_o[0]; + assign spi_dq_i = {2'b00, miso_sync[1], 1'b0}; + + assign sd_sck = spi_sck; + + IOBUF buf_cmd ( + .IO(sd_cmd), + .I(mosi), + .O(), + .T(1'b0) + ); + + IOBUF buf_dat0 ( + .IO(sd_dat[0]), + .I(), + .O(miso), + .T(1'b1) + ); + + IOBUF buf_dat3 ( + .IO(sd_dat[3]), + .I(spi_cs), + .O(), + .T(1'b0) + ); + + always @(posedge clk) begin + if (reset) begin + miso_sync[0] <= 1'b0; + miso_sync[1] <= 1'b0; + end else begin + miso_sync[0] <= miso; + miso_sync[1] <= miso_sync[0]; + end + end +endmodule + +`default_nettype wire diff --git a/hdl_cores/freedom/fpga-shells/xilinx/vc707/vsrc/vc707reset.v b/hdl_cores/freedom/fpga-shells/xilinx/vc707/vsrc/vc707reset.v new file mode 100644 index 0000000..8501027 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/xilinx/vc707/vsrc/vc707reset.v @@ -0,0 +1,78 @@ +// See LICENSE for license details. +`timescale 1ns/1ps +`default_nettype none +`define RESET_SYNC 4 +`define DEBOUNCE_BITS 8 + +module vc707reset( + // Asynchronous reset input, should be held high until + // all clocks are locked and power is stable. + input wire areset, + // Clock domains are brought up in increasing order + // All clocks are reset for at least 2^DEBOUNCE_BITS * period(clock1) + input wire clock1, + output wire reset1, + input wire clock2, + output wire reset2, + input wire clock3, + output wire reset3, + input wire clock4, + output wire reset4 +); + sifive_reset_hold hold_clock0(areset, clock1, reset1); + sifive_reset_sync sync_clock2(reset1, clock2, reset2); + sifive_reset_sync sync_clock3(reset2, clock3, reset3); + sifive_reset_sync sync_clock4(reset3, clock4, reset4); +endmodule + +// Assumes that areset is held for more than one clock +// Allows areset to be deasserted asynchronously +module sifive_reset_sync( + input wire areset, + input wire clock, + output wire reset +); + reg [`RESET_SYNC-1:0] gen_reset = {`RESET_SYNC{1'b1}}; + always @(posedge clock, posedge areset) begin + if (areset) begin + gen_reset <= {`RESET_SYNC{1'b1}}; + end else begin + gen_reset <= {1'b0,gen_reset[`RESET_SYNC-1:1]}; + end + end + assign reset = gen_reset[0]; +endmodule + +module sifive_reset_hold( + input wire areset, + input wire clock, + output wire reset +); + wire raw_reset; + reg [`RESET_SYNC-1:0] sync_reset = {`RESET_SYNC{1'b1}}; + reg [`DEBOUNCE_BITS:0] debounce_reset = {`DEBOUNCE_BITS{1'b1}}; + wire out_reset; + + // Captures reset even if clock is not running + sifive_reset_sync capture(areset, clock, raw_reset); + + // Remove any glitches due to runt areset + always @(posedge clock) begin + sync_reset <= {raw_reset,sync_reset[`RESET_SYNC-1:1]}; + end + + // Debounce the reset + assign out_reset = debounce_reset[`DEBOUNCE_BITS]; + always @(posedge clock) begin + if (sync_reset[0]) begin + debounce_reset <= {(`DEBOUNCE_BITS+1){1'b1}}; + end else begin + debounce_reset <= debounce_reset - out_reset; + end + end + + assign reset = out_reset; + +endmodule + +`default_nettype wire diff --git a/hdl_cores/freedom/fpga-shells/xilinx/vcu118/constraints/vcu118-master.xdc b/hdl_cores/freedom/fpga-shells/xilinx/vcu118/constraints/vcu118-master.xdc new file mode 100644 index 0000000..87d2324 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/xilinx/vcu118/constraints/vcu118-master.xdc @@ -0,0 +1,12 @@ +#-------------- MCS Generation ---------------------- +set_property BITSTREAM.CONFIG.EXTMASTERCCLK_EN div-1 [current_design] +set_property BITSTREAM.CONFIG.SPI_FALL_EDGE YES [current_design] +set_property BITSTREAM.CONFIG.SPI_BUSWIDTH 8 [current_design] +set_property BITSTREAM.GENERAL.COMPRESS TRUE [current_design] +set_property BITSTREAM.CONFIG.UNUSEDPIN Pullnone [current_design] +set_property CFGBVS GND [current_design] +set_property CONFIG_VOLTAGE 1.8 [current_design] +set_property CONFIG_MODE SPIx8 [current_design] + + + diff --git a/hdl_cores/freedom/fpga-shells/xilinx/vcu118/tcl/board.tcl b/hdl_cores/freedom/fpga-shells/xilinx/vcu118/tcl/board.tcl new file mode 100644 index 0000000..d2b3b9c --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/xilinx/vcu118/tcl/board.tcl @@ -0,0 +1,6 @@ +# See LICENSE for license details. +set name {vcu118} +set part_fpga {xcvu9p-flga2104-2L-e} +# Board: xilinx.com:vcu118:part0:2.0 +# However, if we set this we cannot control PCIe locations +set part_board {} diff --git a/hdl_cores/freedom/fpga-shells/xilinx/vcu118/vsrc/sdio.v b/hdl_cores/freedom/fpga-shells/xilinx/vcu118/vsrc/sdio.v new file mode 100644 index 0000000..ff7ebc8 --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/xilinx/vcu118/vsrc/sdio.v @@ -0,0 +1,59 @@ +// See LICENSE for license details. +`timescale 1ns/1ps +`default_nettype none + +module sdio_spi_bridge ( + input wire clk, + input wire reset, + // SDIO + inout wire sd_cmd, + inout wire [3:0] sd_dat, + output wire sd_sck, + // QUAD SPI + input wire spi_sck, + input wire [3:0] spi_dq_o, + output wire [3:0] spi_dq_i, + output wire spi_cs +); + + wire mosi, miso; + reg miso_sync [1:0]; + + assign mosi = spi_dq_o[0]; + assign spi_dq_i = {2'b00, miso_sync[1], 1'b0}; + + assign sd_sck = spi_sck; + + IOBUF buf_cmd ( + .IO(sd_cmd), + .I(mosi), + .O(), + .T(1'b0) + ); + + IOBUF buf_dat0 ( + .IO(sd_dat[0]), + .I(), + .O(miso), + .T(1'b1) + ); + + IOBUF buf_dat3 ( + .IO(sd_dat[3]), + .I(spi_cs), + .O(), + .T(1'b0) + ); + + always @(posedge clk) begin + if (reset) begin + miso_sync[0] <= 1'b0; + miso_sync[1] <= 1'b0; + end else begin + miso_sync[0] <= miso; + miso_sync[1] <= miso_sync[0]; + end + end +endmodule + +`default_nettype wire diff --git a/hdl_cores/freedom/fpga-shells/xilinx/vcu118/vsrc/vcu118reset.v b/hdl_cores/freedom/fpga-shells/xilinx/vcu118/vsrc/vcu118reset.v new file mode 100644 index 0000000..1e7d42d --- /dev/null +++ b/hdl_cores/freedom/fpga-shells/xilinx/vcu118/vsrc/vcu118reset.v @@ -0,0 +1,78 @@ +// See LICENSE for license details. +`timescale 1ns/1ps +`default_nettype none +`define RESET_SYNC 4 +`define DEBOUNCE_BITS 8 + +module vcu118reset( + // Asynchronous reset input, should be held high until + // all clocks are locked and power is stable. + input wire areset, + // Clock domains are brought up in increasing order + // All clocks are reset for at least 2^DEBOUNCE_BITS * period(clock1) + input wire clock1, + output wire reset1, + input wire clock2, + output wire reset2, + input wire clock3, + output wire reset3, + input wire clock4, + output wire reset4 +); + sifive_reset_hold hold_clock0(areset, clock1, reset1); + sifive_reset_sync sync_clock2(reset1, clock2, reset2); + sifive_reset_sync sync_clock3(reset2, clock3, reset3); + sifive_reset_sync sync_clock4(reset3, clock4, reset4); +endmodule + +// Assumes that areset is held for more than one clock +// Allows areset to be deasserted asynchronously +module sifive_reset_sync( + input wire areset, + input wire clock, + output wire reset +); + reg [`RESET_SYNC-1:0] gen_reset = {`RESET_SYNC{1'b1}}; + always @(posedge clock, posedge areset) begin + if (areset) begin + gen_reset <= {`RESET_SYNC{1'b1}}; + end else begin + gen_reset <= {1'b0,gen_reset[`RESET_SYNC-1:1]}; + end + end + assign reset = gen_reset[0]; +endmodule + +module sifive_reset_hold( + input wire areset, + input wire clock, + output wire reset +); + wire raw_reset; + reg [`RESET_SYNC-1:0] sync_reset = {`RESET_SYNC{1'b1}}; + reg [`DEBOUNCE_BITS:0] debounce_reset = {`DEBOUNCE_BITS{1'b1}}; + wire out_reset; + + // Captures reset even if clock is not running + sifive_reset_sync capture(areset, clock, raw_reset); + + // Remove any glitches due to runt areset + always @(posedge clock) begin + sync_reset <= {raw_reset,sync_reset[`RESET_SYNC-1:1]}; + end + + // Debounce the reset + assign out_reset = debounce_reset[`DEBOUNCE_BITS]; + always @(posedge clock) begin + if (sync_reset[0]) begin + debounce_reset <= {(`DEBOUNCE_BITS+1){1'b1}}; + end else begin + debounce_reset <= debounce_reset - out_reset; + end + end + + assign reset = out_reset; + +endmodule + +`default_nettype wire diff --git a/hdl_cores/freedom/mitll-blocks/src/main/scala/aes.scala b/hdl_cores/freedom/mitll-blocks/src/main/scala/aes.scala index a8d7c57..480ae7b 100644 --- a/hdl_cores/freedom/mitll-blocks/src/main/scala/aes.scala +++ b/hdl_cores/freedom/mitll-blocks/src/main/scala/aes.scala @@ -9,7 +9,9 @@ //-------------------------------------------------------------------------------------- package mitllBlocks.aes -import Chisel._ +import chisel3._ +import chisel3.util._ +import chisel3.experimental.{IntParam, BaseModule} import freechips.rocketchip.config.Field import freechips.rocketchip.subsystem.{BaseSubsystem, PeripheryBusKey} import freechips.rocketchip.config.Parameters @@ -20,43 +22,62 @@ import freechips.rocketchip.tilelink._ import mitllBlocks.cep_addresses._ //-------------------------------------------------------------------------------------- -// BEGIN: Classes, Objects, and Traits to support connecting to TileLink +// BEGIN: AES "Periphery" connections //-------------------------------------------------------------------------------------- -case object PeripheryAESKey extends Field[Seq[AESParams]] -trait HasPeripheryAES { this: BaseSubsystem => - val AESNodes = p(PeripheryAESKey).map { ps => - AES.attach(AESAttachParams(ps, pbus)) - } -} +// The following class is used to pass paramaters down into the core +case class COREParams( + slave_base_addr : BigInt, + slave_depth : BigInt, + llki_base_addr : BigInt, + llki_depth : BigInt, + dev_name : String +) -case class AESParams(address: BigInt) +// The following parameter pass attachment info to the lower level objects/classes/etc. +case class COREAttachParams( + coreparams : COREParams, + llki_bus : TLBusWrapper, + slave_bus : TLBusWrapper, +) -case class AESAttachParams( - aesparams : AESParams, - controlBus : TLBusWrapper) - (implicit val p : Parameters) +// Parameters associated with the core +case object PeripheryAESKey extends Field[Seq[COREParams]] -class TLAES(busWidthBytes: Int, params: AESParams)(implicit p: Parameters) - extends AES(busWidthBytes, params) with HasTLControlRegMap +// This trait "connects" the core to the Rocket Chip and passes the parameters down +// to the instantiation +trait HasPeripheryAES { this: BaseSubsystem => + val node = p(PeripheryAESKey).map { params => -object AES { + // Initialize the attachment parameters + val coreattachparams = COREAttachParams( + coreparams = params, + llki_bus = pbus, + slave_bus = pbus + ) - def attach(params: AESAttachParams): TLAES = { - implicit val p = params.p - val aes = LazyModule(new TLAES(params.controlBus.beatBytes, params.aesparams)) + // Instantiate th TL module. Note: This name shows up in the generated verilog hiearchy + // and thus should be unique to this core and NOT a verilog reserved keyword + val aesmodule = LazyModule(new TLModule(coreattachparams)(p)) - params.controlBus.coupleTo(s"slave_named_aes") { - aes.controlXing(NoCrossing) := TLFragmenter(params.controlBus.beatBytes, params.controlBus.blockBytes) := _ + // Perform the slave "attachments" to the slave bus + coreattachparams.slave_bus.coupleTo(coreattachparams.coreparams.dev_name + "_slave") { + aesmodule.slave_node :*= + TLFragmenter(coreattachparams.slave_bus.beatBytes, coreattachparams.slave_bus.blockBytes) :*= _ } - InModuleBody { aes.module.clock := params.controlBus.module.clock } - InModuleBody { aes.module.reset := params.controlBus.module.reset } + // Perform the slave "attachments" to the llki bus + coreattachparams.llki_bus.coupleTo(coreattachparams.coreparams.dev_name + "_llki_slave") { + aesmodule.llki_node :*= + TLSourceShrinker(16) :*= _ + } - aes - } + // Explicitly connect the clock and reset (the module will be clocked off of the slave bus) + InModuleBody { aesmodule.module.reset := coreattachparams.slave_bus.module.reset } + InModuleBody { aesmodule.module.clock := coreattachparams.slave_bus.module.clock } + +}} -} //-------------------------------------------------------------------------------------- // END: Classes, Objects, and Traits to support connecting to TileLink //-------------------------------------------------------------------------------------- @@ -65,130 +86,216 @@ object AES { //-------------------------------------------------------------------------------------- // BEGIN: AES TileLink Module //-------------------------------------------------------------------------------------- -abstract class AES(busWidthBytes: Int, val c: AESParams)(implicit p: Parameters) - extends RegisterRouter ( - RegisterRouterParams( - name = "aes", - compat = Seq("mitll,aes"), - base = c.address, - size = 0x10000, // Size should be an even power of two, otherwise the compilation causes an undefined exception - beatBytes = busWidthBytes)) - { - - ResourceBinding {Resource(ResourceAnchors.aliases, "aes").bind(ResourceAlias(device.label))} - - lazy val module = new LazyModuleImp(this) { - - // Instantitate the AES blackbox - val blackbox = Module(new aes_192) - - // Instantiate registers for the blackbox inputs - val start = RegInit(0.U(1.W)) - - // Class and companion Object to support instantiation and initialization of - // state due to the need to have subword assignment for vectors > 64-bits - // - // Fields in the bundle enumerate from to low. When converting this bundle - // to UInt it is equivalent to Cat(Word1, Word0) or if subword assignment - // was supported: - // - // state(127,64) := word0 - // state(63,0) := word1 - // - class State_Class extends Bundle { - val word0 = UInt(64.W) - val word1 = UInt(64.W) - } - object State_Class { - def init: State_Class = { - val wire = Wire(new State_Class) - wire.word0 := 0.U - wire.word1 := 0.U - wire - } - } - val state = RegInit(State_Class.init) - - // Class and companion Object to support instantiation and initialization of - // key due to the need to have subword assignment for vectors > 64-bits - class Key_Class extends Bundle { - val word0 = UInt(64.W) - val word1 = UInt(64.W) - val word2 = UInt(64.W) - } - object Key_Class { - def init: Key_Class = { - val wire = Wire(new Key_Class) - wire.word0 := 0.U - wire.word1 := 0.U - wire.word2 := 0.U - wire - } - } - val key = RegInit(Key_Class.init) - - // Instantiate wires for the blackbox outputs - val out0 = Wire(UInt(64.W)) - val out1 = Wire(UInt(64.W)) - val out_valid = Wire(Bool()) - - // Map the blackbox I/O - blackbox.io.clk := clock // Implicit module clock - blackbox.io.rst := reset // Implicit module reset - blackbox.io.start := start // Positive edge already exists in AES core (aes_192.v) - blackbox.io.state := state.asUInt // Convert State_Class bundle to UInt(bit vector) - blackbox.io.key := key.asUInt // Convert Key_Class bundle to UInt(bit vector) - out0 := blackbox.io.out(127,64) // Reading subwords in Chisel is OK - out1 := blackbox.io.out(63,0) // Reading subwords in Chisel is OK - out_valid := blackbox.io.out_valid // Out is valid until start is again asserted - - // Define the register map - // Registers with .r suffix to RegField are Read Only (otherwise, Chisel will assume they are R/W) - regmap ( - AESAddresses.aes_ctrlstatus_addr -> RegFieldGroup("aes_ctrlstatus", Some("AES Control/Status Register"),Seq( - RegField (1, start, RegFieldDesc("start", "")), - RegField.r (1, out_valid, RegFieldDesc("out_valid", "", volatile=true)))), - AESAddresses.aes_pt0_addr -> RegFieldGroup("aes_pt1", Some("AES Plaintext Word 1"), Seq(RegField(64, state.word0))), - AESAddresses.aes_pt1_addr -> RegFieldGroup("aes_pt1", Some("AES Plaintext Word 1"), Seq(RegField(64, state.word1))), - AESAddresses.aes_ct0_addr -> RegFieldGroup("aes_ct0", Some("AES Ciphertext Word 0"), Seq(RegField.r(64, out0))), - AESAddresses.aes_ct1_addr -> RegFieldGroup("aes_ct1", Some("AES Ciphertext Word 1"), Seq(RegField.r(64, out1))), - AESAddresses.aes_key0_addr -> RegFieldGroup("aes_key0", Some("AES Key Word 0"), Seq(RegField(64, key.word0))), - AESAddresses.aes_key1_addr -> RegFieldGroup("aes_key1", Some("AES Key Word 1"), Seq(RegField(64, key.word1))), - AESAddresses.aes_key2_addr -> RegFieldGroup("aes_key2", Some("AES Key Word 2"), Seq(RegField(64, key.word2))) - ) // regmap - - } // lazy val module - } // abstract class AES -//-------------------------------------------------------------------------------------- -// END: AES TileLink Module -//-------------------------------------------------------------------------------------- +class TLModule(coreattachparams: COREAttachParams)(implicit p: Parameters) extends LazyModule { + // Create a Manager / Slave / Sink node + // The OpenTitan-based Tilelink interfaces support 4 beatbytes only + val llki_node = TLManagerNode(Seq(TLSlavePortParameters.v1( + Seq(TLSlaveParameters.v1( + address = Seq(AddressSet( + coreattachparams.coreparams.llki_base_addr, + coreattachparams.coreparams.llki_depth)), + resources = new SimpleDevice(coreattachparams.coreparams.dev_name + "-llki-slave", + Seq("mitll," + coreattachparams.coreparams.dev_name + "-llki-slave")).reg, + regionType = RegionType.IDEMPOTENT, + supportsGet = TransferSizes(1, coreattachparams.llki_bus.blockBytes), + supportsPutFull = TransferSizes(1, coreattachparams.llki_bus.blockBytes), + supportsPutPartial = TransferSizes(1, coreattachparams.llki_bus.blockBytes), + fifoId = Some(0))), // requests are handled in order + beatBytes = coreattachparams.llki_bus.beatBytes))) -//-------------------------------------------------------------------------------------- -// BEGIN: Black box wrapper for Verilog Module -// -// Note: Name must match Verilog module name, signal names -// declared within much match the name, width, and direction of -// the Verilog module. -//-------------------------------------------------------------------------------------- -class aes_192() extends BlackBox { + // Create the RegisterRouter node + val slave_node = TLRegisterNode( + address = Seq(AddressSet( + coreattachparams.coreparams.slave_base_addr, + coreattachparams.coreparams.slave_depth)), + device = new SimpleDevice(coreattachparams.coreparams.dev_name + "-slave", + Seq("mitll," + coreattachparams.coreparams.dev_name + "-slave")), + beatBytes = coreattachparams.slave_bus.beatBytes + ) + + // Instantiate the implementation + lazy val module = new TLModuleImp(coreattachparams.coreparams, this) + +} + +class TLModuleImp(coreparams: COREParams, outer: TLModule) extends LazyModuleImp(outer) { + + // "Connect" to llki node's signals and parameters + val (llki, llkiEdge) = outer.llki_node.in(0) + + // Define the LLKI Protocol Processing blackbox and its associated IO + class llki_pp_wrapper(val llki_ctrlsts_addr: BigInt, llki_sendrecv_addr: BigInt) extends BlackBox( + Map( + "CTRLSTS_ADDR" -> IntParam(llki_ctrlsts_addr), // Base address of the TL slave + "SENDRECV_ADDR" -> IntParam(llki_sendrecv_addr) // Address depth of the TL slave + ) + ) { + + val io = IO(new Bundle { + // Clock and Reset + val clk = Input(Clock()) + val rst = Input(Bool()) + + // Slave - Tilelink A Channel (Signal order/names from Tilelink Specification v1.8.0) + val slave_a_opcode = Input(UInt(3.W)) + val slave_a_param = Input(UInt(3.W)) + val slave_a_size = Input(UInt(LLKITilelinkParameters.SizeBits.W)) + val slave_a_source = Input(UInt(LLKITilelinkParameters.SourceBits.W)) + val slave_a_address = Input(UInt(LLKITilelinkParameters.AddressBits.W)) + val slave_a_mask = Input(UInt(LLKITilelinkParameters.BeatBytes.W)) + val slave_a_data = Input(UInt((LLKITilelinkParameters.BeatBytes * 8).W)) + val slave_a_corrupt = Input(Bool()) + val slave_a_valid = Input(Bool()) + val slave_a_ready = Output(Bool()) - val io = IO(new Bundle { - // Clock and Reset - val clk = Clock(INPUT) - val rst = Bool(INPUT) + // Slave - Tilelink D Channel (Signal order/names from Tilelink Specification v1.8.0) + val slave_d_opcode = Output(UInt(3.W)) + val slave_d_param = Output(UInt(3.W)) + val slave_d_size = Output(UInt(LLKITilelinkParameters.SizeBits.W)) + val slave_d_source = Output(UInt(LLKITilelinkParameters.SourceBits.W)) + val slave_d_sink = Output(UInt(LLKITilelinkParameters.SinkBits.W)) + val slave_d_denied = Output(Bool()) + val slave_d_data = Output(UInt((LLKITilelinkParameters.BeatBytes * 8).W)) + val slave_d_corrupt = Output(Bool()) + val slave_d_valid = Output(Bool()) + val slave_d_ready = Input(Bool()) - // Inputs - val start = Bool(INPUT) - val state = Bits(INPUT,128) - val key = Bits(INPUT,192) + // LLKI discrete interface + val llkid_key_data = Output(UInt(64.W)) + val llkid_key_valid = Output(Bool()) + val llkid_key_ready = Input(Bool()) + val llkid_key_complete = Input(Bool()) + val llkid_clear_key = Output(Bool()) + val llkid_clear_key_ack = Input(Bool()) + + }) + } // end class llki_pp_wrapper + + // Instantiate the LLKI Protocol Processing Block with CORE SPECIFIC decode constants + val llki_pp_inst = Module(new llki_pp_wrapper(CEPBaseAddresses.aes_llki_ctrlsts_addr, + CEPBaseAddresses.aes_llki_sendrecv_addr)) + + // The following "requires" are included to avoid size mismatches between the + // the Rocket Chip buses and the SRoT Black Box. The expected values are inhereited + // from the cep_addresses package and must match those in "top_pkg.sv", borrowed from OpenTitan + // + // Exceptions: + // - llkiEdge address gets optimized down to 31-bits during chisel generation + // - llkiEdge sink bits are 1, but masterEdge sink bits are 2 + // - llkiEdge size bits are 3, but masterEdge size bits are 4 + // + require(llkiEdge.bundle.addressBits == LLKITilelinkParameters.AddressBits - 1, s"SROT: llkiEdge addressBits exp/act ${LLKITilelinkParameters.AddressBits - 1}/${llkiEdge.bundle.addressBits}") + require(llkiEdge.bundle.dataBits == LLKITilelinkParameters.BeatBytes * 8, s"SROT: llkiEdge dataBits exp/act ${LLKITilelinkParameters.BeatBytes * 8}/${llkiEdge.bundle.dataBits}") + require(llkiEdge.bundle.sourceBits == LLKITilelinkParameters.SourceBits, s"SROT: llkiEdge sourceBits exp/act ${LLKITilelinkParameters.SourceBits}/${llkiEdge.bundle.sourceBits}") + require(llkiEdge.bundle.sinkBits == LLKITilelinkParameters.SinkBits - 1, s"SROT: llkiEdge sinkBits exp/act ${LLKITilelinkParameters.SinkBits - 1}/${llkiEdge.bundle.sinkBits}") + require(llkiEdge.bundle.sizeBits == LLKITilelinkParameters.SizeBits, s"SROT: llkiEdge sizeBits exp/act ${LLKITilelinkParameters.SizeBits}/${llkiEdge.bundle.sizeBits}") + + // Connect the Clock and Reset + llki_pp_inst.io.clk := clock + llki_pp_inst.io.rst := reset + + // Connect the Slave A Channel to the Black box IO + llki_pp_inst.io.slave_a_opcode := llki.a.bits.opcode + llki_pp_inst.io.slave_a_param := llki.a.bits.param + llki_pp_inst.io.slave_a_size := llki.a.bits.size + llki_pp_inst.io.slave_a_source := llki.a.bits.source + llki_pp_inst.io.slave_a_address := Cat(0.U(1.W), llki.a.bits.address) + llki_pp_inst.io.slave_a_mask := llki.a.bits.mask + llki_pp_inst.io.slave_a_data := llki.a.bits.data + llki_pp_inst.io.slave_a_corrupt := llki.a.bits.corrupt + llki_pp_inst.io.slave_a_valid := llki.a.valid + llki.a.ready := llki_pp_inst.io.slave_a_ready + + // Connect the Slave D Channel to the Black Box IO + llki.d.bits.opcode := llki_pp_inst.io.slave_d_opcode + llki.d.bits.param := llki_pp_inst.io.slave_d_param + llki.d.bits.size := llki_pp_inst.io.slave_d_size + llki.d.bits.source := llki_pp_inst.io.slave_d_source + llki.d.bits.sink := llki_pp_inst.io.slave_d_sink(0) + llki.d.bits.denied := llki_pp_inst.io.slave_d_denied + llki.d.bits.data := llki_pp_inst.io.slave_d_data + llki.d.bits.corrupt := llki_pp_inst.io.slave_d_corrupt + llki.d.valid := llki_pp_inst.io.slave_d_valid + llki_pp_inst.io.slave_d_ready := llki.d.ready + + // Define blackbox and its associated IO + class aes_192_mock_tss() extends BlackBox { + + val io = IO(new Bundle { + // Clock and Reset + val clk = Input(Clock()) + val rst = Input(Bool()) + + // Inputs + val start = Input(Bool()) + val state = Input(UInt(128.W)) + val key = Input(UInt(192.W)) // Outputs - val out = Bits(OUTPUT,128) - val out_valid = Bool(OUTPUT) - }) + val out = Output(UInt(128.W)) + val out_valid = Output(Bool()) -} + // LLKI discrete interface + val llkid_key_data = Input(UInt(64.W)) + val llkid_key_valid = Input(Bool()) + val llkid_key_ready = Output(Bool()) + val llkid_key_complete = Output(Bool()) + val llkid_clear_key = Input(Bool()) + val llkid_clear_key_ack = Output(Bool()) + + }) + + } + + // Instantiate the blackbox + val aes_192_mock_tss_inst = Module(new aes_192_mock_tss()) + + // Map the LLKI discrete blackbox IO between the core_inst and llki_pp_inst + aes_192_mock_tss_inst.io.llkid_key_data := llki_pp_inst.io.llkid_key_data + aes_192_mock_tss_inst.io.llkid_key_valid := llki_pp_inst.io.llkid_key_valid + llki_pp_inst.io.llkid_key_ready := aes_192_mock_tss_inst.io.llkid_key_ready + llki_pp_inst.io.llkid_key_complete := aes_192_mock_tss_inst.io.llkid_key_complete + aes_192_mock_tss_inst.io.llkid_clear_key := llki_pp_inst.io.llkid_clear_key + llki_pp_inst.io.llkid_clear_key_ack := aes_192_mock_tss_inst.io.llkid_clear_key_ack + + // Instantiate registers for the blackbox inputs + val start = RegInit(0.U(1.W)) + val state0 = RegInit(0.U(64.W)) + val state1 = RegInit(0.U(64.W)) + val key0 = RegInit(0.U(64.W)) + val key1 = RegInit(0.U(64.W)) + val key2 = RegInit(0.U(64.W)) + val out = Wire(UInt(128.W)) + val out_valid = Wire(Bool()) + + // Map the core specific blackbox IO + aes_192_mock_tss_inst.io.clk := clock + aes_192_mock_tss_inst.io.rst := reset + aes_192_mock_tss_inst.io.start := start + aes_192_mock_tss_inst.io.state := Cat(state0, state1) + aes_192_mock_tss_inst.io.key := Cat(key0, key1, key2) + out := aes_192_mock_tss_inst.io.out + out_valid := aes_192_mock_tss_inst.io.out_valid + + // Define the register map + // Registers with .r suffix to RegField are Read Only (otherwise, Chisel will assume they are R/W) + outer.slave_node.regmap ( + AESAddresses.aes_ctrlstatus_addr -> RegFieldGroup("aes_ctrlstatus", Some("AES Control/Status Register"),Seq( + RegField (1, start, RegFieldDesc("start", "")), + RegField.r (1, out_valid, RegFieldDesc("out_valid", "", volatile=true)))), + AESAddresses.aes_pt0_addr -> RegFieldGroup("aes_pt0", Some("AES Plaintext Word 0"), Seq(RegField(64, state0))), + AESAddresses.aes_pt1_addr -> RegFieldGroup("aes_pt1", Some("AES Plaintext Word 1"), Seq(RegField(64, state1))), + AESAddresses.aes_ct0_addr -> RegFieldGroup("aes_ct0", Some("AES Ciphertext Word 0"), Seq(RegField.r(64, out(127,64)))), + AESAddresses.aes_ct1_addr -> RegFieldGroup("aes_ct1", Some("AES Ciphertext Word 1"), Seq(RegField.r(64, out(63,0)))), + AESAddresses.aes_key0_addr -> RegFieldGroup("aes_key0", Some("AES Key Word 0"), Seq(RegField(64, key0))), + AESAddresses.aes_key1_addr -> RegFieldGroup("aes_key1", Some("AES Key Word 1"), Seq(RegField(64, key1))), + AESAddresses.aes_key2_addr -> RegFieldGroup("aes_key2", Some("AES Key Word 2"), Seq(RegField(64, key2))) + ) // regmap + +} // end TLAESModuleImp //-------------------------------------------------------------------------------------- -// END: Black box wrapper for Verilog Module +// END: AES TileLink Module //-------------------------------------------------------------------------------------- + + diff --git a/hdl_cores/freedom/mitll-blocks/src/main/scala/cep_addresses.scala b/hdl_cores/freedom/mitll-blocks/src/main/scala/cep_addresses.scala index 61fa234..bb69061 100644 --- a/hdl_cores/freedom/mitll-blocks/src/main/scala/cep_addresses.scala +++ b/hdl_cores/freedom/mitll-blocks/src/main/scala/cep_addresses.scala @@ -5,17 +5,42 @@ // File : cep_addresses.scala // Project : Common Evaluation Platform (CEP) // Description : Defines the addresses used within CEP Cores +// Constants related to "Functional" register decode, which occurrs in +// the Chisel world, can be found in this package. +// For each CEP core, there are the following two pairs of constants: +// - _base_addr - Functional registers base address +// - _base_depth - Functional registers address depth/size +// - _llki_base_addr - LLKI interface base address +// - _llki_base_depth - LLKI interface address depth/size +// +// Additional address constants related to the functional registers can +// be found in this file, within the relevant object (e.g., AESAddresses) +// +// LLKI related address constants can be found in llki_pkg.sv as all LLKI +// functionality exists in the SystemVerilog world. // //-------------------------------------------------------------------------------------- package mitllBlocks.cep_addresses +import freechips.rocketchip.diplomacy._ + object CEPVersion { - val CEP_MAJOR_VERSION = 0x02 - val CEP_MINOR_VERSION = 0x71 + val CEP_MAJOR_VERSION = 0x03 + val CEP_MINOR_VERSION = 0x00 } object CEPBaseAddresses { - val aes_base_addr = 0x70000000L + val cep_cores_base_addr = 0x70000000L + + // New (v3.0+) Address constants related to the AES Core + val aes_base_addr = 0x70000000L + val aes_depth = 0x00007fffL + val aes_llki_base_addr = 0x70008000L + val aes_llki_ctrlsts_addr = 0x70008000L + val aes_llki_sendrecv_addr = 0x70008008L + val aes_llki_depth = 0x000000ffL + + // Legacy (pre-v3.0 address constants) val md5_base_addr = 0x70010000L val sha256_base_addr = 0x70020000L val rsa_base_addr = 0x70030000L @@ -23,13 +48,16 @@ object CEPBaseAddresses { val dft_base_addr = 0x70050000L val idft_base_addr = 0x70060000L val fir_base_addr = 0x70070000L - val iir_base_addr = 0x70080000L + val iir_base_addr = 0x70080000L val gps_base_addr = 0x70090000L val cepregisters_base_addr = 0x700F0000L + val cep_cores_depth = 0x000FFFFFL + val srot_base_addr = 0x70100000L + val srot_base_depth = 0x00007fffL } object AESAddresses { - val aes_ctrlstatus_addr = 0x0000 + val aes_ctrlstatus_addr = 0x0000 val aes_pt0_addr = 0x0008 val aes_pt1_addr = 0x0010 val aes_ct0_addr = 0x0018 @@ -69,20 +97,20 @@ object MD5Addresses { } object SHA256Addresses{ - val sha256_ctrlstatus_addr = 0x0000 - val sha256_block_w0 = 0x0008 - val sha256_block_w1 = 0x0010 - val sha256_block_w2 = 0x0018 - val sha256_block_w3 = 0x0020 - val sha256_block_w4 = 0x0028 - val sha256_block_w5 = 0x0030 - val sha256_block_w6 = 0x0038 - val sha256_block_w7 = 0x0040 - val sha256_done = 0x0048 - val sha256_digest_w0 = 0x0050 - val sha256_digest_w1 = 0x0058 - val sha256_digest_w2 = 0x0060 - val sha256_digest_w3 = 0x0068 + val sha256_ctrlstatus_addr = 0x0000 + val sha256_block_w0 = 0x0008 + val sha256_block_w1 = 0x0010 + val sha256_block_w2 = 0x0018 + val sha256_block_w3 = 0x0020 + val sha256_block_w4 = 0x0028 + val sha256_block_w5 = 0x0030 + val sha256_block_w6 = 0x0038 + val sha256_block_w7 = 0x0040 + val sha256_done = 0x0048 + val sha256_digest_w0 = 0x0050 + val sha256_digest_w1 = 0x0058 + val sha256_digest_w2 = 0x0060 + val sha256_digest_w3 = 0x0068 } object RSAAddresses{ @@ -144,12 +172,12 @@ object IIRAddresses{ } object FIRAddresses { - val fir_ctrlstatus_addr = 0x0000 - val fir_datain_addr_addr = 0x0008 - val fir_datain_data_addr = 0x0010 - val fir_dataout_addr_addr = 0x0018 - val fir_dataout_data_addr = 0x0020 - val fir_reset_addr = 0x0028 + val fir_ctrlstatus_addr = 0x0000 + val fir_datain_addr_addr = 0x0008 + val fir_datain_data_addr = 0x0010 + val fir_dataout_addr_addr = 0x0018 + val fir_dataout_data_addr = 0x0020 + val fir_reset_addr = 0x0028 } object CEPRegisterAddresses { @@ -168,4 +196,18 @@ object CEPRegisterAddresses { val core1_status = 0x0208 val core2_status = 0x0210 val core3_status = 0x0218 + val scratch32_w0 = 0x0220 +} + +// These are intended to be the universal TL parameters +// for all the LLKI-enabled cores (including the SRoT). +// They need to match those values called out in top_pkg.sv +// Exceptions (when needed) are explictly coded into +// the specific TLModuleImp +object LLKITilelinkParameters { + val BeatBytes = 8 // Should be = TL_DW / 8 + val AddressBits = 32 // Should be = TL_DW + val SourceBits = 4 // Should be = TL_AIW + val SinkBits = 2 // Should be = TL_DIW + val SizeBits = 3 // Should be = TL_SZW } \ No newline at end of file diff --git a/hdl_cores/freedom/mitll-blocks/src/main/scala/cep_registers.scala b/hdl_cores/freedom/mitll-blocks/src/main/scala/cep_registers.scala index d1d2660..d018064 100644 --- a/hdl_cores/freedom/mitll-blocks/src/main/scala/cep_registers.scala +++ b/hdl_cores/freedom/mitll-blocks/src/main/scala/cep_registers.scala @@ -109,6 +109,7 @@ abstract class CEPREGS(busWidthBytes: Int, val c: CEPREGSParams)(implicit p: Par val word5 = UInt(64.W) val word6 = UInt(64.W) val word7 = UInt(64.W) + val word32_0 = UInt(32.W) } object scratch_Class { def init: scratch_Class = { @@ -121,6 +122,7 @@ abstract class CEPREGS(busWidthBytes: Int, val c: CEPREGSParams)(implicit p: Par wire.word5 := 0.U wire.word6 := 0.U wire.word7 := 0.U + wire.word32_0 := 0.U wire } } @@ -241,7 +243,7 @@ abstract class CEPREGS(busWidthBytes: Int, val c: CEPREGSParams)(implicit p: Par CEPRegisterAddresses.core0_status -> RegFieldGroup("core0 Status", Some("core0 status"), Seq(RegField (64, core0_status))), CEPRegisterAddresses.core1_status -> RegFieldGroup("core1 Status", Some("core0 status"), Seq(RegField (64, core1_status))), CEPRegisterAddresses.core2_status -> RegFieldGroup("core2 Status", Some("core0 status"), Seq(RegField (64, core2_status))), - CEPRegisterAddresses.core3_status -> RegFieldGroup("core3 Status", Some("core0 status"), Seq(RegField (64, core3_status))), + CEPRegisterAddresses.core3_status -> RegFieldGroup("core3 Status", Some("core0 status"), Seq(RegField (64, core3_status))) ) } } diff --git a/hdl_cores/freedom/mitll-blocks/src/main/scala/srot.scala b/hdl_cores/freedom/mitll-blocks/src/main/scala/srot.scala new file mode 100644 index 0000000..09bf1ef --- /dev/null +++ b/hdl_cores/freedom/mitll-blocks/src/main/scala/srot.scala @@ -0,0 +1,280 @@ +//-------------------------------------------------------------------------------------- +// Copyright (C) 2020 Massachusetts Institute of Technology +// SPDX short identifier: BSD-2-Clause +// +// File : srot.scala +// Project : Common Evaluation Platform (CEP) +// Description : TileLink interface to the Surrogate Root of Trust (SRoT) +// The Surrogate Root of Trust serves as a slave on the periphery +// bus AND a master on the Front Bus +// +//-------------------------------------------------------------------------------------- +package mitllBlocks.srot + +import chisel3._ +import chisel3.util._ +import chisel3.experimental.{IntParam, BaseModule} +import freechips.rocketchip.config.Field +import freechips.rocketchip.subsystem.{BaseSubsystem, PeripheryBusKey} +import freechips.rocketchip.config.Parameters +import freechips.rocketchip.diplomacy._ +import freechips.rocketchip.regmapper._ +import freechips.rocketchip.tilelink._ + +import mitllBlocks.cep_addresses._ + +//-------------------------------------------------------------------------------------- +// BEGIN: SRoT "Periphery" connections +//-------------------------------------------------------------------------------------- + +// The following class is used to pass paramaters down into the SROT +case class SROTParams( + slave_address : BigInt, + slave_depth : BigInt +) + +// The following parameter pass attachment info to the lower level objects/classes/etc. +case class SROTAttachParams( + srotparams : SROTParams, + slave_bus : TLBusWrapper, + master_bus : TLBusWrapper +) + +// Parameters associated with the SROT +case object SROTKey extends Field[Seq[SROTParams]] + +// This trait "connects" the SRoT to the Rocket Chip and passes the parameters down +// to the instantiation +trait HasSROT { this: BaseSubsystem => + val SROTNodes = p(SROTKey).map { params => + + // Initialize the attachment parameters + val srotattachparams = SROTAttachParams( + srotparams = params, + slave_bus = pbus, + master_bus = fbus + ) + + // Define the SRoT Tilelink module + val srotModule = LazyModule(new TLSROTModule(srotattachparams)(p)) + + // Perform the slave "attachments" to the periphery bus + srotattachparams.slave_bus.coupleTo("srot_slave") { + srotModule.slave_node :*= + TLSourceShrinker(16) :*= _ + } + + // Perform the master "attachments" to the front bus + srotattachparams.master_bus.coupleFrom("srot_master") { + _ := + srotModule.master_node + } + + // Explicitly connect the clock and reset (the module will be clocked off of the slave bus) + InModuleBody { srotModule.module.clock := srotattachparams.slave_bus.module.clock } + InModuleBody { srotModule.module.reset := srotattachparams.slave_bus.module.reset } + +}} + +//-------------------------------------------------------------------------------------- +// END: SRoT "Periphery" connections +//-------------------------------------------------------------------------------------- + + +//-------------------------------------------------------------------------------------- +// BEGIN: Tilelink SROT Module and Module Implementation Declerations +// +// Note: If one does not explicitly put "supportsPutFull" and/or "supportsPullPartial" +// in the slave parameters, the manager will be instantiated as Read Only (and will +// show up as such in the device tree. Also, the chisel optimization that gets +// "kicked off" because of the inclusion of diplomacy widgets will result in the A +// channel data bus being tied to ZERO. +//-------------------------------------------------------------------------------------- +class TLSROTModule(srotattachparams: SROTAttachParams)(implicit p: Parameters) extends LazyModule { + + // Create a Manager / Slave / Sink node + val slave_node = TLManagerNode(Seq(TLSlavePortParameters.v1( + Seq(TLSlaveParameters.v1( + address = Seq(AddressSet( + srotattachparams.srotparams.slave_address, + srotattachparams.srotparams.slave_depth)), + resources = new SimpleDevice("srot-slave", Seq("mitll,srot-slave")).reg, + regionType = RegionType.IDEMPOTENT, + supportsGet = TransferSizes(1, srotattachparams.slave_bus.blockBytes), + supportsPutFull = TransferSizes(1, srotattachparams.slave_bus.blockBytes), + supportsPutPartial = TransferSizes(1, srotattachparams.slave_bus.blockBytes), + fifoId = Some(0))), // requests are handled in order + beatBytes = LLKITilelinkParameters.BeatBytes))) + + // Create a Client / Master / Source node + // The sourceID paramater assumes there are two masters on the fbus (Debug Module, SRoT) + // This client node is "constained" to only talk to the CEP cores (via the visibility + // parameter) + val master_node = TLClientNode(Seq(TLMasterPortParameters.v1( + Seq(TLMasterParameters.v1( + name = "srot_master0", + sourceId = IdRange(0, 15), + requestFifo = true, + visibility = Seq(AddressSet(CEPBaseAddresses.cep_cores_base_addr, CEPBaseAddresses.cep_cores_depth)) + )) + ))) + + // Instantiate the implementation + lazy val module = new TLSROTModuleImp(srotattachparams.srotparams, this) + +} // end TLSROTModule + +class TLSROTModuleImp(srotparams: SROTParams, outer: TLSROTModule) extends LazyModuleImp(outer) { + + // "Connect" to Slave Node's signals and parameters + val (slave, slaveEdge) = outer.slave_node.in(0) + + // "Connect" to Master Node's signals and parameters + val (master, masterEdge) = outer.master_node.out(0) + + // Define srot_wrapper blackbox and its associated IO + class srot_wrapper(val address: BigInt, depth: BigInt) extends BlackBox( + Map( + "ADDRESS" -> IntParam(address), // Base address of the TL slave + "DEPTH" -> IntParam(depth) // Address depth of the TL slave + ) + ) { + + val io = IO(new Bundle { + // Clock and Reset + val clk = Input(Clock()) + val rst = Input(Bool()) + + // Slave - Tilelink A Channel (Signal order/names from Tilelink Specification v1.8.0) + val slave_a_opcode = Input(UInt(3.W)) + val slave_a_param = Input(UInt(3.W)) + val slave_a_size = Input(UInt(LLKITilelinkParameters.SizeBits.W)) + val slave_a_source = Input(UInt(LLKITilelinkParameters.SourceBits.W)) + val slave_a_address = Input(UInt(LLKITilelinkParameters.AddressBits.W)) + val slave_a_mask = Input(UInt(LLKITilelinkParameters.BeatBytes.W)) + val slave_a_data = Input(UInt((LLKITilelinkParameters.BeatBytes * 8).W)) + val slave_a_corrupt = Input(Bool()) + val slave_a_valid = Input(Bool()) + val slave_a_ready = Output(Bool()) + + // Slave - Tilelink D Channel (Signal order/names from Tilelink Specification v1.8.0) + val slave_d_opcode = Output(UInt(3.W)) + val slave_d_param = Output(UInt(3.W)) + val slave_d_size = Output(UInt(LLKITilelinkParameters.SizeBits.W)) + val slave_d_source = Output(UInt(LLKITilelinkParameters.SourceBits.W)) + val slave_d_sink = Output(UInt(LLKITilelinkParameters.SinkBits.W)) + val slave_d_denied = Output(Bool()) + val slave_d_data = Output(UInt((LLKITilelinkParameters.BeatBytes * 8).W)) + val slave_d_corrupt = Output(Bool()) + val slave_d_valid = Output(Bool()) + val slave_d_ready = Input(Bool()) + + // Master - Tilelink A Channel (Signal order/names from Tilelink Specification v1.8.0) + val master_a_opcode = Output(UInt(3.W)) + val master_a_param = Output(UInt(3.W)) + val master_a_size = Output(UInt(LLKITilelinkParameters.SizeBits.W)) + val master_a_source = Output(UInt(LLKITilelinkParameters.SourceBits.W)) + val master_a_address = Output(UInt(LLKITilelinkParameters.AddressBits.W)) + val master_a_mask = Output(UInt(LLKITilelinkParameters.BeatBytes.W)) + val master_a_data = Output(UInt((LLKITilelinkParameters.BeatBytes * 8).W)) + val master_a_corrupt = Output(Bool()) + val master_a_valid = Output(Bool()) + val master_a_ready = Input(Bool()) + + // Master - Tilelink D Channel (Signal order/names from Tilelink Specification v1.8.0) + val master_d_opcode = Input(UInt(3.W)) + val master_d_param = Input(UInt(3.W)) + val master_d_size = Input(UInt(LLKITilelinkParameters.SizeBits.W)) + val master_d_source = Input(UInt(LLKITilelinkParameters.SourceBits.W)) + val master_d_sink = Input(UInt(LLKITilelinkParameters.SinkBits.W)) + val master_d_denied = Input(Bool()) + val master_d_data = Input(UInt((LLKITilelinkParameters.BeatBytes * 8).W)) + val master_d_corrupt = Input(Bool()) + val master_d_valid = Input(Bool()) + val master_d_ready = Output(Bool()) + + }) + } // end class srot_wrapper + + + // Instantiate the srot_wrapper + val srot_wrapper_inst = Module(new srot_wrapper(srotparams.slave_address, srotparams.slave_depth)) + + // The following "requires" are included to avoid size mismatches between the + // the Rocket Chip buses and the SRoT Black Box. The expected values are inhereited + // from the cep_addresses package and must match those in "top_pkg.sv", borrowed from OpenTitan + // + // Exceptions: + // - slaveEdge address gets optimized down to 31-bits during chisel generation + // - slaveEdge sink bits are 1, but masterEdge sink bits are 2 + // - slaveEdge size bits are 3, but masterEdge size bits are 4 + // + require(slaveEdge.bundle.addressBits == LLKITilelinkParameters.AddressBits - 1, s"SROT: slaveEdge addressBits exp/act ${LLKITilelinkParameters.AddressBits - 1}/${slaveEdge.bundle.addressBits}") + require(slaveEdge.bundle.dataBits == LLKITilelinkParameters.BeatBytes * 8, s"SROT: slaveEdge dataBits exp/act ${LLKITilelinkParameters.BeatBytes * 8}/${slaveEdge.bundle.dataBits}") + require(slaveEdge.bundle.sourceBits == LLKITilelinkParameters.SourceBits, s"SROT: slaveEdge sourceBits exp/act ${LLKITilelinkParameters.SourceBits}/${slaveEdge.bundle.sourceBits}") + require(slaveEdge.bundle.sinkBits == LLKITilelinkParameters.SinkBits - 1, s"SROT: slaveEdge sinkBits exp/act ${LLKITilelinkParameters.SinkBits - 1}/${slaveEdge.bundle.sinkBits}") + require(slaveEdge.bundle.sizeBits == LLKITilelinkParameters.SizeBits, s"SROT: slaveEdge sizeBits exp/act ${LLKITilelinkParameters.SizeBits}/${slaveEdge.bundle.sizeBits}") + + require(masterEdge.bundle.addressBits == LLKITilelinkParameters.AddressBits, s"SROT: masterEdge addressBits exp/act ${LLKITilelinkParameters.AddressBits}/${masterEdge.bundle.addressBits}") + require(masterEdge.bundle.dataBits == LLKITilelinkParameters.BeatBytes * 8, s"SROT: masterEdge dataBits exp/act ${LLKITilelinkParameters.BeatBytes * 8}/${masterEdge.bundle.dataBits}") + require(masterEdge.bundle.sourceBits == LLKITilelinkParameters.SourceBits, s"SROT: masterEdge sourceBits exp/act ${LLKITilelinkParameters.SourceBits}/${masterEdge.bundle.sourceBits}") + require(masterEdge.bundle.sinkBits == LLKITilelinkParameters.SinkBits, s"SROT: masterEdge sinkBits exp/act ${LLKITilelinkParameters.SinkBits}/${masterEdge.bundle.sinkBits}") + require(masterEdge.bundle.sizeBits == LLKITilelinkParameters.SizeBits + 1, s"SROT: masterEdge sizeBits exp/act ${LLKITilelinkParameters.SizeBits + 1}/${masterEdge.bundle.sizeBits}") + + // Connect the Clock and Reset + srot_wrapper_inst.io.clk := clock + srot_wrapper_inst.io.rst := reset + + // Connect the Slave A Channel to the Black box IO + srot_wrapper_inst.io.slave_a_opcode := slave.a.bits.opcode + srot_wrapper_inst.io.slave_a_param := slave.a.bits.param + srot_wrapper_inst.io.slave_a_size := slave.a.bits.size + srot_wrapper_inst.io.slave_a_source := slave.a.bits.source + srot_wrapper_inst.io.slave_a_address := Cat(0.U(1.W), slave.a.bits.address) + srot_wrapper_inst.io.slave_a_mask := slave.a.bits.mask + srot_wrapper_inst.io.slave_a_data := slave.a.bits.data + srot_wrapper_inst.io.slave_a_corrupt := slave.a.bits.corrupt + srot_wrapper_inst.io.slave_a_valid := slave.a.valid + slave.a.ready := srot_wrapper_inst.io.slave_a_ready + + // Connect the Slave D Channel to the Black Box IO + slave.d.bits.opcode := srot_wrapper_inst.io.slave_d_opcode + slave.d.bits.param := srot_wrapper_inst.io.slave_d_param + slave.d.bits.size := srot_wrapper_inst.io.slave_d_size + slave.d.bits.source := srot_wrapper_inst.io.slave_d_source + slave.d.bits.sink := srot_wrapper_inst.io.slave_d_sink(0) + slave.d.bits.denied := srot_wrapper_inst.io.slave_d_denied + slave.d.bits.data := srot_wrapper_inst.io.slave_d_data + slave.d.bits.corrupt := srot_wrapper_inst.io.slave_d_corrupt + slave.d.valid := srot_wrapper_inst.io.slave_d_valid + srot_wrapper_inst.io.slave_d_ready := slave.d.ready + + // Connect the Master A channel to the Black Box IO + master.a.bits.opcode := srot_wrapper_inst.io.master_a_opcode + master.a.bits.param := srot_wrapper_inst.io.master_a_param + master.a.bits.size := Cat(0.U(1.W), srot_wrapper_inst.io.master_a_size) + master.a.bits.source := srot_wrapper_inst.io.master_a_source + master.a.bits.address := srot_wrapper_inst.io.master_a_address + master.a.bits.mask := srot_wrapper_inst.io.master_a_mask + master.a.bits.data := srot_wrapper_inst.io.master_a_data + master.a.bits.corrupt := srot_wrapper_inst.io.master_a_corrupt + master.a.valid := srot_wrapper_inst.io.master_a_valid + srot_wrapper_inst.io.master_a_ready := master.a.ready + + // Connect the Master D channel to the Black Box IO + srot_wrapper_inst.io.master_d_opcode := master.d.bits.opcode + srot_wrapper_inst.io.master_d_param := master.d.bits.param + srot_wrapper_inst.io.master_d_size := master.d.bits.size(2,0) + srot_wrapper_inst.io.master_d_source := master.d.bits.source + srot_wrapper_inst.io.master_d_sink := master.d.bits.sink + srot_wrapper_inst.io.master_d_denied := master.d.bits.denied + srot_wrapper_inst.io.master_d_data := master.d.bits.data + srot_wrapper_inst.io.master_d_corrupt := master.d.bits.corrupt + srot_wrapper_inst.io.master_d_valid := master.d.valid + master.d.ready := srot_wrapper_inst.io.master_d_ready + +} // end TLSROTModuleImp +//-------------------------------------------------------------------------------------- +// END: Tilelink SROT Module and Module Implementation Declerations +//-------------------------------------------------------------------------------------- + diff --git a/hdl_cores/freedom/src/main/scala/unleashed/DevKitConfigs.scala b/hdl_cores/freedom/src/main/scala/unleashed/DevKitConfigs.scala index 3c2cf47..3381f85 100644 --- a/hdl_cores/freedom/src/main/scala/unleashed/DevKitConfigs.scala +++ b/hdl_cores/freedom/src/main/scala/unleashed/DevKitConfigs.scala @@ -26,12 +26,15 @@ import mitllBlocks.des3._ import mitllBlocks.md5._ import mitllBlocks.gps._ import mitllBlocks.dft._ +import mitllBlocks.srot._ // Default FreedomU500Config class FreedomU500Config extends Config( new WithJtagDTM ++ new WithNMemoryChannels(1) ++ new WithNBigCores(4) ++ + new WithoutTLMonitors ++ + new WithDTS("mit-ll,rocketchip-cep", Nil) ++ new BaseConfig ) @@ -45,10 +48,16 @@ class U500DevKitPeripherals extends Config((site, here, up) => { GPIOParams(address = BigInt(0x64002000L), width = 4)) case PeripheryMaskROMKey => List( MaskROMParams(address = 0x10000, name = "BootROM", depth = 4096)) -case PeripheryDES3Key => List( + case PeripheryDES3Key => List( DES3Params(address = BigInt(CEPBaseAddresses.des3_base_addr))) case PeripheryAESKey => List( - AESParams(address = BigInt(CEPBaseAddresses.aes_base_addr))) + COREParams( + slave_base_addr = BigInt(CEPBaseAddresses.aes_base_addr), + slave_depth = BigInt(CEPBaseAddresses.aes_depth), + llki_base_addr = BigInt(CEPBaseAddresses.aes_llki_base_addr), + llki_depth = BigInt(CEPBaseAddresses.aes_llki_depth), + dev_name = s"aes" + )) case PeripheryIIRKey => List( IIRParams(address = BigInt(CEPBaseAddresses.iir_base_addr))) case PeripheryIDFTKey => List( @@ -67,6 +76,11 @@ case PeripheryDES3Key => List( RSAParams(address = BigInt(CEPBaseAddresses.rsa_base_addr))) case PeripheryCEPRegistersKey => List( CEPREGSParams(address = BigInt(CEPBaseAddresses.cepregisters_base_addr))) + case SROTKey => List( + SROTParams( + slave_address = BigInt(CEPBaseAddresses.srot_base_addr), + slave_depth = BigInt(CEPBaseAddresses.srot_base_depth) + )) }) // Freedom U500 Dev Kit diff --git a/hdl_cores/freedom/src/main/scala/unleashed/DevKitFPGADesign.scala b/hdl_cores/freedom/src/main/scala/unleashed/DevKitFPGADesign.scala index 87105c3..9b213aa 100644 --- a/hdl_cores/freedom/src/main/scala/unleashed/DevKitFPGADesign.scala +++ b/hdl_cores/freedom/src/main/scala/unleashed/DevKitFPGADesign.scala @@ -38,6 +38,7 @@ import mitllBlocks.des3._ import mitllBlocks.md5._ import mitllBlocks.gps._ import mitllBlocks.dft._ +import mitllBlocks.srot._ object PinGen { def apply(): BasePin = { @@ -92,6 +93,7 @@ class DevKitFPGADesign(wranglerNode: ClockAdapterNode, corePLL: PLLNode)(implici with HasPeripheryDES3 with HasPeripheryGPS with HasPeripheryMD5 + with HasSROT { val tlclock = new FixedClockResource("tlclk", p(DevKitFPGAFrequencyKey)) diff --git a/hdl_cores/gps/gps_clkgen.v b/hdl_cores/gps/gps_clkgen.v index dcf4df1..1803789 100644 --- a/hdl_cores/gps/gps_clkgen.v +++ b/hdl_cores/gps/gps_clkgen.v @@ -23,6 +23,8 @@ output gps_clk_fast; output gps_clk_slow; output gps_rst; +reg [2:0] count = 3'h0; +reg enable_slow_clk; `ifdef SYNTHESIS wire clk_fb; diff --git a/hdl_cores/llki/llki_pkg.sv b/hdl_cores/llki/llki_pkg.sv new file mode 100644 index 0000000..c3e390d --- /dev/null +++ b/hdl_cores/llki/llki_pkg.sv @@ -0,0 +1,258 @@ +//************************************************************************ +// Copyright (C) 2020 Massachusetts Institute of Technology +// SPDX short identifier: BSD-2-Clause +// +// File Name: llki_pkg.sv +// Program: Common Evaluation Platform (CEP) +// Description: LLKI related parameters and such. +// Notes: Addresses must reside "within" the corresponding +// range as specified in cep_addresses.scala. +// +// Example: For the Surrogate Root of Trust (SRoT) +// cep_addresses.scala specifies +// val srot_base_addr = 0x70100000L +// val srot_base_depth = 0x00007fffL +// As a result, the SROT_XXXX addresses must +// reside in this ranges (due to hierarchical decode) +// +// The address and bitmappings here should match +// those in CEP.h (to allow for SW access) +// +//************************************************************************ + +package llki_pkg; + + // SROT Control / Status Register + localparam SROT_CTRLSTS_ADDR = 32'h7010_0000; + localparam SROT_CTRLSTS_MODEBIT_0 = 0; // If either mode bit is set, TileLink access to the Key and Key Index RAMs are disabled + localparam SROT_CTRLSTS_MODEBIT_1 = 1; // These bits are SET ONLY + localparam SROT_CTRLSTS_RESP_WAITING = 2; // Indicates that a message/response is available in the SROT_RESPONSE_ADDR register + localparam SROT_LLKIC2_SENDRECV_ADDR = 32'h7010_0008; + + // All LLKI Protocol Processing blocks will use the same SystemVerilog code, and thus + // will have their decode addresses uniquified through module parameters. These will be + // passed down from the Chisel level of the design (and ths the addresses are contained + // in cep_addresses.scala). Common parameters (such as the LLKI_CTRLSTS_RESP_WAITING + // bit mapped will be contained here) + + localparam LLKIKL_CTRLSTS_RESP_WAITING = 0; // Indicates that a message/response is available + // in the LLKI PP control/status register + localparam LLKIKL_CTRLSTS_READY_FOR_KEY = 1; // The LLKI-PP provides minimal buffering for + // messages (and key words) received from + // Thus, the SRoT can poll the ready for key + // bit in the LLKI-PP Control/Status register + // to determine that the LLKI-PP (and TSS) is + // ready to receive the next key word + + + // The Key Index RAM holds single word identifiers that contain + // metadata for all the keys stored in the Key RAM + // + // 63 62 40 39 32 31 16 15 0 + // +-+---------------------+-----------+----------------+----------------+ + // |V| Reserved | Core Indx | High Pointer | Low Pointer | + // +-+---------------------+-----------+----------------+----------------+ + // + // Field descriptions: + // - Valid : Indicates a valid key index and valid key material in the + // range identified to by the high and low pointers + // - Core Indx : Pointer to an entry in LLKI_CORE_INDEX_ROM that determines + // which LLKI-enabled core is the target of the current operation + // - High Pointer : Upper Key RAM addr + // - Low Pointer : Lower Key RAM addr + // + // For a valid key index, the key data words should be located in the + // Key RAM as described here: Higher Pointer >= Key#N >= Low Pointer + // + // This error condition as well as other are checked in the ST_RETRIEVE_KEY_INDEX state + // of the SRoT state machine (in srot_wrapper.sv) + // + localparam SROT_KEYINDEXRAM_ADDR = 32'h7010_0100; + localparam SROT_KEYINDEXRAM_SIZE = 32'h0000_0020; + + // Holds the LLKI keys as referenced by the those words in the KeyIndex RAM + localparam SROT_KEYRAM_ADDR = 32'h7010_0120; + localparam SROT_KEYRAM_SIZE = 32'h0000_0100; + + // Generate a list of all the valid LLKI Key Load interface + // address pairs: One for send/receive, one for control/status + // Ensure these match the equivalent constants in cep_addresses.scala + localparam AES_LLKIKL_CTRLSTS_ADDR = 32'h7000_8000; + localparam AES_LLKIKL_SENDRECV_ADDR = 32'h7000_8008; + + localparam LLKI_CTRLSTS_INDEX = 0; + localparam LLKI_SENDRECV_INDEX = 1; + + localparam [31:0] LLKI_CORE_INDEX_ARRAY [0:0][0:1] = '{ + {AES_LLKIKL_CTRLSTS_ADDR, AES_LLKIKL_SENDRECV_ADDR} + }; + + // + // The LLKI is comprised of the following three interface types: + // LLKI-C2 : Using Tilelink, it supports the following message types: + // C2LoadKeyReq : Load a key into the specified Core + // C2ClearKeyReq : Clear the key from the specified Core + // C2KeyStatusReq : Request key status from the specified Core + // C2LoadKeyAck : Load key acknowledgement + // C2ClearKeyAck : Clear key acknowledgement + // C2KeyStatusResp : Response to the Key Status Requests + // LLKI-KL : Using Tilelink, it supports the following message types: + // KLLoadKeyReq : Load a key into the specified Core + // KLClearKeyReq : Clear the key from the specified Core + // KLKeyStatusReq : Request key status from the specified Core + // KLLoadKeyAck : Load key acknowledgement + // KLClearKeyAck : Clear key acknowledgement + // KLKeyStatusResp : Response to the Key Status Requests + // LLKI-Discrete : Discrete signals for connecting the LLKI to Technique Specific Shims + // llkid_key_data : Key Data Bits, greater key widths loaded over multiple clock cycles + // llkid_key_valid : Indicates that the key data is valid + // llkid_key_ready : Indicates that the TSS is ready to receive key data + // llkid_key_complete : Indicates that the TSS has received all the required key bits + // llkid_clear_key : Assert to instruct the TSS to clear its internal key-state, thus "locking" the core + // llkid_clear_key_ack : When asserted by the TSS, it indicates that the key has been cleared + // + // + // LLKI C2 RISCV -> SRoT Message Format + // + // Word# + // 63 32 31 24 23 16 15 8 7 0 + // +----------------------------------+-------+---------+--------+--------+ + // | Reserved |Key Idx| MSG LEN | STATUS | MSG ID | 1 + // +----------------------------------+-------+---------+--------+--------+ + + // + // MSG ID : Only the following message IDs are valid on the LLKIC2 request interface: + // - LLKI_MID_C2LOADKEYREQ + // - LLKI_MID_C2CLEARKEYREQ + // - LLKI_MID_C2KEYSTATUSREQ + // + // STATUS : + // - Unused for C2 RISCV -> SRoT Messages + // + // MSG LEN : + // - Should be 1 for all C2 RISCV -> SRoT Messages + // + // Key Idx : Specifies the index of the key to be referenced by the request. This + // becomes a direct index into the Key Index RAM, which contains all the key + // specific metadata. See Key Index RAM format above for more information. + // LLKI Message ID constants + localparam LLKI_MID_C2LOADKEYREQ = 8'h00; + localparam LLKI_MID_C2CLEARKEYREQ = 8'h01; + localparam LLKI_MID_C2KEYSTATUSREQ = 8'h02; + localparam LLKI_MID_C2LOADKEYACK = 8'h03; + localparam LLKI_MID_C2CLEARKEYACK = 8'h04; + localparam LLKI_MID_C2KEYSTATUSRESP = 8'h05; + localparam LLKI_MID_C2ERRORRESP = 8'h06; + + + // LLKI KL SRoT -> LLKI PP Message Format + // NOTE: Each word transferred is a SEPERATE Tilelink transaction + // + // Word# + // 63 24 23 16 15 8 7 0 + // +------------------------------------------+---------+--------+--------+ + // | Reserved | MSG LEN | STATUS | MSG ID | 1 + // +------------------------------------------+---------+--------+--------+ + // ... + // +----------------------------------------------------------------------+ + // | Key Word #1 (LLKI_MID_KLLOADKEYREQ message only) | 2 + // +----------------------------------------------------------------------+ + // ... + // +----------------------------------------------------------------------+ + // | Key Word #N (LLKI_MID_KLLOADKEYREQ message only) | N + 1 + // +----------------------------------------------------------------------+ + // + // + // MSG ID : Only the following message IDs are valid on the LLKIC2 request interface: + // - LLKI_MID_C2LOADKEYREQ + // - LLKI_MID_C2CLEARKEYREQ + // - LLKI_MID_C2KEYSTATUSREQ + localparam LLKI_MID_KLLOADKEYREQ = 8'h07; + localparam LLKI_MID_KLCLEARKEYREQ = 8'h08; + localparam LLKI_MID_KLKEYSTATUSREQ = 8'h09; + localparam LLKI_MID_KLLOADKEYACK = 8'h0A; + localparam LLKI_MID_KLCLEARKEYACK = 8'h0B; + localparam LLKI_MID_KLKEYSTATUSRESP = 8'h0C; + localparam LLKI_MID_KLERRORRESP = 8'h06; + + // LLKI Status Constants + localparam LLKI_STATUS_GOOD = 8'h00; + localparam LLKI_STATUS_KEY_PRESENT = 8'h01; + localparam LLKI_STATUS_KEY_NOT_PRESENT = 9'h02; + + localparam LLKI_STATUS_BAD_MSG_ID = 8'h20; + localparam LLKI_STATUS_BAD_MSG_LEN = 8'h21; + localparam LLKI_STATUS_KEY_INDX_EXCEED = 8'h22; // Specified key index exceeds size + // of key index ram + localparam LLKI_STATUS_KEY_INDEX_INVALID = 8'h23; + localparam LLKI_STATUS_BAD_POINTER_PAIR = 8'h24; + localparam LLKI_STATUS_BAD_CORE_INDEX = 8'h25; + localparam LLKI_STATUS_KL_REQ_BAD_MSG_ID = 8'h26; // The LLKI PP received a bad message ID from the SRoT + localparam LLKI_STATUS_KL_REQ_BAD_MSG_LEN = 8'h27; + localparam LLKI_STATUS_KL_RESP_BAD_MSG_ID = 8'h28; // The LLKI PP response had a bad message ID + localparam LLKI_STATUS_KL_TILELINK_ERROR = 8'h29; + localparam LLKI_STATUS_KL_LOSS_OF_SYNC = 8'h30; + localparam LLKI_STATUS_UNKNOWN_ERROR = 8'hFF; + + // Value is used to initalize the SRoT STM wait state + // counter. This mitigates spamming the SRoT host + // interface while waiting for a response from the + // selected LLKI-KP + localparam SROT_WAIT_STATE_COUNTER_INIT = 8'h0A; + + // Enumerated type for Surrogate Root of Trust state machine. State + // decscriptions can be found in srot_wrapper.sv + typedef enum { + ST_SROT_IDLE, + ST_SROT_MESSAGE_CHECK, + ST_SROT_RETRIEVE_KEY_INDEX, + + ST_SROT_KL_REQ_HEADER, + ST_SROT_KL_REQ_ISSUE, + ST_SROT_KL_REQ_WAIT_FOR_ACK, + + ST_SROT_KL_READ_READY_STATUS, + ST_SROT_KL_CHECK_READY_STATUS, + ST_SROT_KL_READY_WAIT_STATE, + ST_SROT_KL_LOAD_KEY_WORD, + ST_SROT_KL_LOAD_KEY_WORD_WAIT_FOR_ACK, + + ST_SROT_KL_READ_RESP_STATUS, + ST_SROT_KL_CHECK_RESP_STATUS, + ST_SROT_KL_RESP_WAIT_STATE, + + ST_SROT_KL_RESP_READ, + + ST_SROT_C2_RESPONSE + } SROT_STATE_TYPE; + + // Enumerate type for the LLKI Protocol Processing block state machine + typedef enum { + ST_LLKIPP_IDLE, + ST_LLKIPP_MESSAGE_CHECK, + ST_LLKIPP_LOAD_KEY_WORDS, + ST_LLKIPP_CLEAR_KEY, + ST_LLKIPP_RESPONSE + } LLKIPP_STATE_TYPE; + + // The following parameters are XOR'd with the key words loaded + // into the corresponding mock TSS + localparam AES_MOCK_TSS_KEY_0 = 64'h0123456789ABCDEF; + localparam AES_MOCK_TSS_KEY_1 = 64'hFEDCBA9876543210; + + // The Mock TSS introduces artificial wait states to demonstrate + // a delay when loading or clearing keys + typedef enum { + ST_MOCKTSS_IDLE, + ST_MOCKTSS_WAIT_STATE0, + ST_MOCKTSS_KEY0_LOADED, + ST_MOCKTSS_WAIT_STATE1, + ST_MOCKTSS_KEY1_LOADED, + ST_MOCKTSS_CLEAR_KEY, + ST_MOCKTSS_WAIT_STATE2 + } MOCKTSS_STATE_TYPE; + + localparam MOCKTSS_WAIT_STATE_COUNTER_INIT = 8'h0A; + + +endpackage diff --git a/hdl_cores/llki/llki_pp_wrapper.sv b/hdl_cores/llki/llki_pp_wrapper.sv new file mode 100644 index 0000000..95a7c80 --- /dev/null +++ b/hdl_cores/llki/llki_pp_wrapper.sv @@ -0,0 +1,466 @@ +//************************************************************************ +// Copyright (C) 2020 Massachusetts Institute of Technology +// SPDX License Identifier: MIT +// +// File Name: llki_pp_wrapper.sv +// Program: Common Evaluation Platform (CEP) +// Description: This file provides a Verilog <-> SystemVerilog adapter +// allowing connection of TL-UL interface to the Chisel +// blackbox. +// +// It also implements the LLKI Protocol Processing +// block's State Machine. +// Notes: The underlying TL-UL package is from the OpenTitan +// project +// +// The "tl" parameters have been taken from the +// OpenTitan ecosystem +// +// Send / Recv FIFOs have specifically NOT been +// implemented here in an effort to minimize the number +// of memory blocks that ever touch key material. +// +// The LLKI Protocol Procesing block is intended to be +// common across ALL LLKI enabled cores. Unique address +// decoding will be facilitated through the use of the +// CTRLSTS_ADDR and SENDRECV_ADDR parameters (which are +// passed down from Chisel) +// +//************************************************************************ +`timescale 1ns/1ns + +module llki_pp_wrapper import tlul_pkg::*; import llki_pkg::*; #( + parameter int CTRLSTS_ADDR = 32'h00000000, // These default values MUST be overwritten + parameter int SENDRECV_ADDR = 32'h00000008 // These default values MUST be overwritten + ) ( + + // Clock and reset + input clk, + input rst, + + // Slave Interface - A channel + input [2:0] slave_a_opcode, + input [2:0] slave_a_param, + input [top_pkg::TL_SZW-1:0] slave_a_size, + input [top_pkg::TL_AIW-1:0] slave_a_source, + input [top_pkg::TL_AW-1:00] slave_a_address, + input [top_pkg::TL_DBW-1:0] slave_a_mask, + input [top_pkg::TL_DW-1:0] slave_a_data, + input slave_a_corrupt, + input slave_a_valid, + output slave_a_ready, + + // Slave interface D channel + output [2:0] slave_d_opcode, + output [2:0] slave_d_param, + output [top_pkg::TL_SZW-1:0] slave_d_size, + output [top_pkg::TL_AIW-1:0] slave_d_source, + output [top_pkg::TL_DIW-1:0] slave_d_sink, + output slave_d_denied, + output [top_pkg::TL_DW-1:0] slave_d_data, + output slave_d_corrupt, + output slave_d_valid, + input slave_d_ready, + + // LLKI discrete I/O + output reg [63:0] llkid_key_data, + output reg llkid_key_valid, + input llkid_key_ready, + input llkid_key_complete, + output reg llkid_clear_key, + input llkid_clear_key_ack + +); + + // Create the structures for communicating with OpenTitan-based Tilelink + tl_h2d_t slave_tl_h2d; + tl_d2h_t slave_tl_d2h; + + // Make Slave A channel connections + assign slave_tl_h2d.a_valid = slave_a_valid; + assign slave_tl_h2d.a_opcode = ( slave_a_opcode == 3'h0) ? PutFullData : + ((slave_a_opcode == 3'h1) ? PutPartialData : + ((slave_a_opcode == 3'h4) ? Get : + Get)); + assign slave_tl_h2d.a_param = slave_a_param; + assign slave_tl_h2d.a_size = slave_a_size; + assign slave_tl_h2d.a_source = slave_a_source; + assign slave_tl_h2d.a_address = slave_a_address; + assign slave_tl_h2d.a_mask = slave_a_mask; + assign slave_tl_h2d.a_data = slave_a_data; + assign slave_tl_h2d.a_user = tl_a_user_t'('0); // User field is unused by Rocket Chip + assign slave_tl_h2d.d_ready = slave_d_ready; + + // Make Slave D channel connections + // Converting from the OpenTitan enumerated type to specific bit mappings + assign slave_d_opcode = ( slave_tl_d2h.d_opcode == AccessAck) ? 3'h0 : + ((slave_tl_d2h.d_opcode == AccessAckData) ? 3'h1 : + 3'h0); + assign slave_d_param = slave_tl_d2h.d_param; + assign slave_d_size = slave_tl_d2h.d_size; + assign slave_d_source = slave_tl_d2h.d_source; + assign slave_d_sink = slave_tl_d2h.d_sink; + assign slave_d_denied = slave_tl_d2h.d_error; // Open + assign slave_d_data = slave_tl_d2h.d_data; + assign slave_d_corrupt = slave_tl_d2h.d_error; + assign slave_d_valid = slave_tl_d2h.d_valid; + assign slave_a_ready = slave_tl_d2h.a_ready; + + // Define some of the wires and registers associated with the tlul_adapter_reg + wire reg_we_o; + wire reg_re_o; + wire [top_pkg::TL_AW-1:0] reg_addr_o; + wire [top_pkg::TL_DW-1:0] reg_wdata_o; + reg [top_pkg::TL_DW-1:0] reg_rdata_i; + reg reg_error_i; + + // Misc. signals + reg [top_pkg::TL_DW-1:0] llkipp_ctrlstatus_register; // Bit definition can be found in llki_pkg.sv + reg write_error; + reg read_error; + + //------------------------------------------------------------------------ + // Instantitate a tlul_adapter_reg to adapt the TL Slave Interface + //------------------------------------------------------------------------ + tlul_adapter_reg #( + .RegAw (top_pkg::TL_AW ), + .RegDw (top_pkg::TL_DW ) + ) u_tlul_adapter_reg_inst ( + .clk_i (clk ), + .rst_ni (~rst ), + + .tl_i (slave_tl_h2d ), + .tl_o (slave_tl_d2h ), + + .we_o (reg_we_o ), + .re_o (reg_re_o ), + .addr_o (reg_addr_o ), + .wdata_o (reg_wdata_o ), + .be_o ( ), // Accesses are assumed to be word-wide + .rdata_i (reg_rdata_i ), + .error_i (reg_error_i ) + ); + + // The reg_error_i will be asserted if either a read or write error occurs + assign reg_error_i = read_error || write_error; + //------------------------------------------------------------------------ + + + + //------------------------------------------------------------------------ + // Write Decode Process (writing to the state machine sendrecv address + // be handled in the LLKI PP state machine) + //------------------------------------------------------------------------ + reg llkipp_response_waiting; + reg [top_pkg::TL_DW-1:0] llkipp_response_word; + + always @(posedge clk or posedge rst) + begin + if (rst) begin + llkipp_ctrlstatus_register <= '0; + write_error <= 1'b0; + end else begin + + // Default signal assignments + write_error <= 1'b0; + + // Capture the message available state (setting and clearing + // of the source bit will occur within the state machine always block) + llkipp_ctrlstatus_register[LLKIKL_CTRLSTS_RESP_WAITING] <= llkipp_response_waiting; + + // The LLKI-PP provides minimal buffering for messages (and key words) received from + // Thus, the SRoT can poll the ready for key bit in the LLKI-PP Control/Status register + // to determine that the LLKI-PP (and TSS) is ready to receive the next key word + llkipp_ctrlstatus_register[LLKIKL_CTRLSTS_READY_FOR_KEY] <= llkid_key_ready; + + if (reg_we_o) begin + case (reg_addr_o) + // Currently, no Ctrl/Status bits are writeable via TileLink + CTRLSTS_ADDR : begin + ; + end + // Write to Send/Recv Address - Data "capture" occurs within the + // LLKI PP State Machine block, thus we have a null action here + SENDRECV_ADDR : begin + ; + end + // Trap State - Currently, the control/status register has no + // LLKI-PP writable bits and thus c + default : begin + write_error <= 1'b1; + end + endcase + end // end if (reg_we_o) + + end // end if (rst) + end // end always + //------------------------------------------------------------------------ + + + + //------------------------------------------------------------------------ + // Read decode process + //------------------------------------------------------------------------ + always @* + begin + + // Default signal assignments + reg_rdata_i = '0; + read_error = 1'b0; + + if (reg_re_o) begin + case (reg_addr_o) + // Currently, no Ctrl/Status bits are writeable via TileLink + CTRLSTS_ADDR : begin + reg_rdata_i = llkipp_ctrlstatus_register; + end + // Write to Send/Recv Address - Data "capture" occurs within the + // LLKI PP State Machine block, thus we have a null action here + SENDRECV_ADDR : begin + reg_rdata_i = llkipp_response_word; + end + // Trap State - Currently, the control/status register has no + // LLKI-PP writable bits and thus c + default : begin + read_error = 1'b1; + end + endcase + end // end if (reg_re_o) + end // end always + //------------------------------------------------------------------------ + + + + //------------------------------------------------------------------------ + // LLKI PP State Machine + //------------------------------------------------------------------------ + LLKIPP_STATE_TYPE llkipp_current_state; + reg [7:0] msg_id; + reg [7:0] status; + reg [7:0] msg_len; + + always @(posedge clk or posedge rst) + begin + if (rst) begin + llkid_key_data <= '0; + llkid_key_valid <= '0; + llkid_clear_key <= '0; + llkipp_response_waiting <= '0; + llkipp_response_word <= '0; + msg_id <= '0; + status <= '0; + msg_len <= '0; + llkipp_current_state <= ST_LLKIPP_IDLE; + end else begin + case (llkipp_current_state) + //------------------------------------------------------------------ + // IDLE State + //------------------------------------------------------------------ + ST_LLKIPP_IDLE : begin + // Default signal assignments + llkid_key_data <= '0; + llkid_key_valid <= '0; + llkid_clear_key <= '0; + llkipp_response_waiting <= '0; + llkipp_response_word <= '0; + msg_id <= '0; + status <= '0; + msg_len <= '0; + llkipp_current_state <= ST_LLKIPP_IDLE; + + // If a write occurs AND it's to the SENDRECV_ADDR + if (reg_we_o && reg_addr_o == SENDRECV_ADDR) begin + msg_id <= reg_wdata_o[7:0]; + status <= reg_wdata_o[15:8]; + msg_len <= reg_wdata_o[23:16]; + + // Now that we have captured the message, time to process + llkipp_current_state <= ST_LLKIPP_MESSAGE_CHECK; + + end // end if (reg_we_o && reg_addr_o == SENDRECV_ADDR) + + end // ST_LLKIPP_IDLE + //------------------------------------------------------------------ + // Message Check State + //------------------------------------------------------------------ + ST_LLKIPP_MESSAGE_CHECK : begin + // Default signal assignments + llkid_key_data <= '0; + llkid_key_valid <= '0; + llkid_clear_key <= '0; + llkipp_response_waiting <= '0; + llkipp_response_word <= '0; + llkipp_current_state <= ST_LLKIPP_MESSAGE_CHECK; + + // Make some checks and decision based on the Message ID + case (msg_id) + LLKI_MID_KLLOADKEYREQ : begin + // A message length of 1 (or zero) for a load key request + // is invalid + if (msg_len <= 1) begin + msg_id <= LLKI_MID_KLERRORRESP; + status <= LLKI_STATUS_KL_REQ_BAD_MSG_LEN; + llkipp_current_state <= ST_LLKIPP_RESPONSE; + // A load key request has been issued, jump to the + // load key words and wait for the next word (which + // will be treated as a key word) + end else + llkipp_current_state <= ST_LLKIPP_LOAD_KEY_WORDS; + end + LLKI_MID_KLCLEARKEYREQ : begin + // The only valid message length is 1 + if (msg_len != 1) begin + msg_id <= LLKI_MID_KLERRORRESP; + status <= LLKI_STATUS_KL_REQ_BAD_MSG_LEN; + llkipp_current_state <= ST_LLKIPP_RESPONSE; + end else + llkipp_current_state <= ST_LLKIPP_CLEAR_KEY; + end + LLKI_MID_KLKEYSTATUSREQ : begin + // The only valid message length is 1 + if (msg_len != 1) begin + msg_id <= LLKI_MID_KLERRORRESP; + status <= LLKI_STATUS_KL_REQ_BAD_MSG_LEN; + llkipp_current_state <= ST_LLKIPP_RESPONSE; + end else begin + msg_id <= LLKI_MID_KLKEYSTATUSRESP; + // Set the status based on what state the LLKI-Discrete + // interface indicates + if (llkid_key_complete) + status <= LLKI_STATUS_KEY_PRESENT; + else + status <= LLKI_STATUS_KEY_NOT_PRESENT; + llkipp_current_state <= ST_LLKIPP_RESPONSE; + end + end + // All other message ID (error condition) + default : begin + msg_id <= LLKI_MID_KLERRORRESP; + status <= LLKI_STATUS_KL_REQ_BAD_MSG_ID; + llkipp_current_state <= ST_LLKIPP_RESPONSE; + end + endcase // msg id + end // ST_LLKIPP_MESSAGE_CHECK + //------------------------------------------------------------------ + // Load Key Words State - This state will "pass" the key words + // received over the LLKI-PP TileLink interface and pass them + // to the LLKI-Discrete interface. + // + // It is the responsibility of the SRoT to read the status of the + // key ready bit between EACH KEY WORD before sending the next one + //------------------------------------------------------------------ + ST_LLKIPP_LOAD_KEY_WORDS : begin + // Default signal assignments + llkid_key_data <= '0; + llkid_key_valid <= '0; + llkid_clear_key <= '0; + llkipp_response_waiting <= '0; + llkipp_response_word <= '0; + llkipp_current_state <= ST_LLKIPP_LOAD_KEY_WORDS; + + // Another key word has been received, time to do some checks + if (reg_we_o && reg_addr_o == SENDRECV_ADDR) begin + + // If for some reason, the LLKI-Discrete is not ready, we'll + // ignore the key word, and send an error response (which the + // SRoT will need to check for) + if (~llkid_key_ready) begin + msg_id <= LLKI_MID_KLERRORRESP; + status <= LLKI_STATUS_KL_LOSS_OF_SYNC; + llkipp_current_state <= ST_LLKIPP_RESPONSE; + // If a key word has been received and msg_len == 2, then this + // is the LAST word of the load key request (understanding the + // msg_len also includes the header and we are using it for + // a counter. + end else if (msg_len == 2) begin + llkid_key_data <= reg_wdata_o; + llkid_key_valid <= 1; + + msg_id <= LLKI_MID_KLLOADKEYACK; + status <= LLKI_STATUS_GOOD; + llkipp_current_state <= ST_LLKIPP_RESPONSE; + // This is not the last word of the key load, load the key word + // via the LLKI-Discrete and just wait for the next word + end else begin + llkid_key_data <= reg_wdata_o; + llkid_key_valid <= 1; + + // Decrement the message length (be used to count the remaining + // number of key words to load) + msg_len <= msg_len - 1; + end // end if (~llkid_key_ready) + end // end if (reg_we_o && reg_addr_o == SENDRECV_ADDR) + + end // ST_LLKIPP_LOAD_KEY_WORDS + //------------------------------------------------------------------ + // Clear Key State + //------------------------------------------------------------------ + ST_LLKIPP_CLEAR_KEY : begin + // Default signal assignments + llkid_key_data <= '0; + llkid_key_valid <= '0; + llkid_clear_key <= '1; // Instruct TSS to clear the key + llkipp_response_waiting <= '0; + llkipp_response_word <= '0; + llkipp_current_state <= ST_LLKIPP_CLEAR_KEY; + + // Clear Key has been acknowledged, time to send the response + if (llkid_clear_key_ack) begin + msg_id <= LLKI_MID_KLCLEARKEYACK; + status <= LLKI_STATUS_GOOD; + llkipp_current_state <= ST_LLKIPP_RESPONSE; + end + + end + //------------------------------------------------------------------ + // Response Message state + // + // As there is no FIFO in the LLKI-PP, the State Machine more + // closurely tracks the message exchange. Here, when we are + // sending a response, the STM will advance when the response + // is read. + // + //------------------------------------------------------------------ + ST_LLKIPP_RESPONSE : begin + // Default signal assignments + llkid_key_data <= '0; + llkid_key_valid <= '0; + llkid_clear_key <= '0; + llkipp_response_waiting <= '0; + llkipp_response_word <= '0; + llkipp_current_state <= ST_LLKIPP_RESPONSE; + + // Build the response word and indicate that a response is waiting (remember, no FIFOs) + llkipp_response_word[7:0] <= msg_id; + llkipp_response_word[15:8] <= status; + llkipp_response_word[23:16] <= 1; // All responses have a message len of 1 + llkipp_response_waiting <= '1; + + // When the SEND/RECV address is read via the register interface, we can return to idle + if (reg_re_o && reg_addr_o == SENDRECV_ADDR) begin + llkipp_current_state <= ST_LLKIPP_IDLE; + end // end if (reg_re_o && reg_addr_o == SENDRECV_ADDR) + + end + //------------------------------------------------------------------ + // Trap State + //------------------------------------------------------------------ + default : begin + // Default signal assignments + llkid_key_data <= '0; + llkid_key_valid <= '0; + llkid_clear_key <= '0; + llkipp_response_waiting <= '0; + llkipp_response_word <= '0; + msg_id <= '0; + status <= '0; + msg_len <= '0; + llkipp_current_state <= ST_LLKIPP_IDLE; + end + endcase // llkipp_current_state + end // end if (rst) + end // end always + //------------------------------------------------------------------------ + + +endmodule // endmodule llki_pp_wrapper diff --git a/hdl_cores/llki/srot_wrapper.sv b/hdl_cores/llki/srot_wrapper.sv new file mode 100644 index 0000000..43b89a5 --- /dev/null +++ b/hdl_cores/llki/srot_wrapper.sv @@ -0,0 +1,1304 @@ +//************************************************************************ +// Copyright (C) 2020 Massachusetts Institute of Technology +// SPDX short identifier: BSD-2-Clause +// +// File Name: srot_wrapper.sv +// Program: Common Evaluation Platform (CEP) +// Description: This file provides a Verilog <-> SystemVerilog adapter +// allowing connection of TL-UL interface to the Chisel +// blackbox. +// Notes: The underlying TL-UL package is from the OpenTitan +// project +// +// The "tl" parameters have been taken from the +// OpenTitan ecosystem +//************************************************************************ +`timescale 1ns/1ns + +module srot_wrapper import tlul_pkg::*; import llki_pkg::*; #( + parameter int ADDRESS = 32'h00000000, // Currently unused as address selected occurs @ the SRoT Chisel Code + parameter int DEPTH = 32'h00000100, // Currently unused as address selected occurs @ the SRoT Chisel Code + parameter int FIFO_DEPTH = 8, // Define the depth of the LLKI FIFOs + + // Derived parameters + localparam int DepthW = prim_util_pkg::vbits(FIFO_DEPTH + 1) + ) ( + + // Clock and reset + input clk, + input rst, + + // Slave interface A channel + input [2:0] slave_a_opcode, + input [2:0] slave_a_param, + input [top_pkg::TL_SZW-1:0] slave_a_size, + input [top_pkg::TL_AIW-1:0] slave_a_source, + input [top_pkg::TL_AW-1:00] slave_a_address, + input [top_pkg::TL_DBW-1:0] slave_a_mask, + input [top_pkg::TL_DW-1:0] slave_a_data, + input slave_a_corrupt, + input slave_a_valid, + output slave_a_ready, + + // Slave interface D channel + output [2:0] slave_d_opcode, + output [2:0] slave_d_param, + output [top_pkg::TL_SZW-1:0] slave_d_size, + output [top_pkg::TL_AIW-1:0] slave_d_source, + output [top_pkg::TL_DIW-1:0] slave_d_sink, + output slave_d_denied, + output [top_pkg::TL_DW-1:0] slave_d_data, + output slave_d_corrupt, + output slave_d_valid, + input slave_d_ready, + + // Master interface A channel + output [2:0] master_a_opcode, + output [2:0] master_a_param, + output [top_pkg::TL_SZW-1:0] master_a_size, + output [top_pkg::TL_AIW-1:0] master_a_source, + output [top_pkg::TL_AW-1:00] master_a_address, + output [top_pkg::TL_DBW-1:0] master_a_mask, + output [top_pkg::TL_DW-1:0] master_a_data, + output master_a_corrupt, + output master_a_valid, + input master_a_ready, + + // Master interface D channel + input [2:0] master_d_opcode, + input [2:0] master_d_param, + input [top_pkg::TL_SZW-1:0] master_d_size, + input [top_pkg::TL_AIW-1:0] master_d_source, + input [top_pkg::TL_DIW-1:0] master_d_sink, + input master_d_denied, + input [top_pkg::TL_DW-1:0] master_d_data, + input master_d_corrupt, + input master_d_valid, + output master_d_ready + +); + + // Create the structures for communicating with OpenTitan-based Tilelink + tl_h2d_t slave_tl_h2d; + tl_d2h_t slave_tl_d2h; + tl_h2d_t master_tl_h2d; + tl_d2h_t master_tl_d2h; + + // Make Slave A channel connections + assign slave_tl_h2d.a_valid = slave_a_valid; + assign slave_tl_h2d.a_opcode = ( slave_a_opcode == 3'h0) ? PutFullData : + ((slave_a_opcode == 3'h1) ? PutPartialData : + ((slave_a_opcode == 3'h4) ? Get : + Get)); + assign slave_tl_h2d.a_param = slave_a_param; + assign slave_tl_h2d.a_size = slave_a_size; + assign slave_tl_h2d.a_source = slave_a_source; + assign slave_tl_h2d.a_address = slave_a_address; + assign slave_tl_h2d.a_mask = slave_a_mask; + assign slave_tl_h2d.a_data = slave_a_data; + assign slave_tl_h2d.a_user = tl_a_user_t'('0); // User field is unused by Rocket Chip + assign slave_tl_h2d.d_ready = slave_d_ready; + + // Make Slave D channel connections + // Converting from the OpenTitan enumerated type to specific bit mappings + assign slave_d_opcode = ( slave_tl_d2h.d_opcode == AccessAck) ? 3'h0 : + ((slave_tl_d2h.d_opcode == AccessAckData) ? 3'h1 : + 3'h0); + assign slave_d_param = slave_tl_d2h.d_param; + assign slave_d_size = slave_tl_d2h.d_size; + assign slave_d_source = slave_tl_d2h.d_source; + assign slave_d_sink = slave_tl_d2h.d_sink; + assign slave_d_denied = slave_tl_d2h.d_error; // Open + assign slave_d_data = slave_tl_d2h.d_data; + assign slave_d_corrupt = slave_tl_d2h.d_error; + assign slave_d_valid = slave_tl_d2h.d_valid; + assign slave_a_ready = slave_tl_d2h.a_ready; + + // Make Master A channel connections + assign master_a_opcode = ( master_tl_h2d.a_opcode == PutFullData) ? 3'h0 : + ((master_tl_h2d.a_opcode == PutPartialData) ? 3'h1 : + ((master_tl_h2d.a_opcode == Get) ? 3'h4 : + 3'h4)); + assign master_a_param = master_tl_h2d.a_param; + assign master_a_size = master_tl_h2d.a_size; + assign master_a_source = master_tl_h2d.a_source; + assign master_a_address = master_tl_h2d.a_address; + assign master_a_mask = master_tl_h2d.a_mask; + assign master_a_data = master_tl_h2d.a_data; + assign master_a_corrupt = 0; + assign master_a_valid = master_tl_h2d.a_valid; + assign master_d_ready = master_tl_h2d.d_ready; + + // Make Master D channel connections + assign master_tl_d2h.d_opcode = ( master_d_opcode == 3'h0) ? AccessAck : + ((master_d_opcode == 3'h1) ? AccessAckData : + AccessAck); + assign master_tl_d2h.d_param = master_d_param; + assign master_tl_d2h.d_size = master_d_size; + assign master_tl_d2h.d_source = master_d_source; + assign master_tl_d2h.d_sink = master_d_sink; + assign master_tl_d2h.d_data = master_d_data; + assign master_tl_d2h.d_user = tl_a_user_t'('0); + assign master_tl_d2h.d_error = master_d_corrupt || master_d_denied; + assign master_tl_d2h.d_valid = master_d_valid; + assign master_tl_d2h.a_ready = master_a_ready; + + // Define some of the wires and registers associated with the tlul_adapter_reg + wire reg_we_o; + wire reg_re_o; + wire [top_pkg::TL_AW-1:0] reg_addr_o; + wire [top_pkg::TL_DW-1:0] reg_wdata_o; + reg [top_pkg::TL_DW-1:0] reg_rdata_i; + reg reg_error_i; + + // Define some of the wires and registers associated with the tlul_adapter_host + reg host_req_i; + wire host_gnt_o; + reg host_we_i; + reg [top_pkg::TL_AW-1:0] host_addr_i; + reg [top_pkg::TL_DW-1:0] host_wdata_i; + wire host_valid_o; + wire [top_pkg::TL_DW-1:0] host_rdata_o; + wire host_err_o; + + // Misc. signals + reg [top_pkg::TL_DW-1:0] srot_ctrlstatus_register; // Bit definition can be found in llki_pkg.sv + reg write_error; + reg read_error; + + //------------------------------------------------------------------------ + // Instantitate a tlul_adapter_reg to adapt the TL Slave Interface + //------------------------------------------------------------------------ + tlul_adapter_reg #( + .RegAw (top_pkg::TL_AW ), + .RegDw (top_pkg::TL_DW ) + ) u_tlul_adapter_reg_inst ( + .clk_i (clk ), + .rst_ni (~rst ), + + .tl_i (slave_tl_h2d ), + .tl_o (slave_tl_d2h ), + + .we_o (reg_we_o ), + .re_o (reg_re_o ), + .addr_o (reg_addr_o ), + .wdata_o (reg_wdata_o ), + .be_o ( ), // Accesses are assumed to be word-wide + .rdata_i (reg_rdata_i ), + .error_i (reg_error_i ) + ); + + // The reg_error_i will be asserted if either a read or write error occurs + assign reg_error_i = read_error || write_error; + //------------------------------------------------------------------------ + + + + //------------------------------------------------------------------------ + // Instantiate a tlul_adapter_host fo connecting to the master interface + // + // Per the notes in tlul_adapter_host.sv, setting MAX_REQS = 1 results + // in a purely combinatorial component. + //------------------------------------------------------------------------ + tlul_adapter_host #( + .MAX_REQS(1) + ) u_tlul_adapter_host_inst ( + .clk_i (clk ), + .rst_ni (~rst ), + .req_i (host_req_i ), + .gnt_o (host_gnt_o ), + .addr_i (host_addr_i ), + .we_i (host_we_i ), + .wdata_i (host_wdata_i ), + .be_i ('1 ), // All bytes always enabled + .valid_o (host_valid_o ), + .rdata_o (host_rdata_o ), + .err_o (host_err_o ), + .tl_o (master_tl_h2d ), + .tl_i (master_tl_d2h ) + ); + //------------------------------------------------------------------------ + + + + //------------------------------------------------------------------------ + // Instantiate the LLKI C2 Send Message FIFO + //------------------------------------------------------------------------ + // Define signals associated with the LLKI C2 Send Message FIFO + reg llkic2_reqfifo_clr_i; + reg llkic2_reqfifo_wvalid_i; + wire llkic2_reqfifo_wready_o; + reg [top_pkg::TL_DW - 1:0] llkic2_reqfifo_wdata_i; + wire llkic2_reqfifo_rvalid_o; + reg llkic2_reqfifo_rready_i; + wire [top_pkg::TL_DW - 1:0] llkic2_reqfifo_rdata_o; + wire [DepthW - 1 :0] llkic2_reqfifo_depth_o; + wire llkic2_reqfifo_empty; + wire llkic2_reqfifo_full; + + // Instantiate the FIFO + prim_fifo_sync #( + .Width (top_pkg::TL_DW), + .Pass (1'b0), + .Depth (FIFO_DEPTH), + .OutputZeroIfEmpty (1'b0) // Enables "first word fall through" + ) llkic2_reqfifo_inst ( + .clk_i (clk), + .rst_ni (~rst), + + // Synchronous clear/flush + .clr_i (llkic2_reqfifo_clr_i), + + // Write Port + .wvalid_i (llkic2_reqfifo_wvalid_i), + .wready_o (llkic2_reqfifo_wready_o), + .wdata_i (llkic2_reqfifo_wdata_i), + + // Read Port + .rvalid_o (llkic2_reqfifo_rvalid_o), + .rready_i (llkic2_reqfifo_rready_i), + .rdata_o (llkic2_reqfifo_rdata_o), + + // Occupancy + .depth_o (llkic2_reqfifo_depth_o) + ); + + // Generate the full and empty signals for the LLKIC2 Send FIFO + assign llkic2_reqfifo_empty = llkic2_reqfifo_depth_o == '0; + assign llkic2_reqfifo_full = llkic2_reqfifo_depth_o == FIFO_DEPTH; + //------------------------------------------------------------------------ + + + + //------------------------------------------------------------------------ + // Instantiate the LLKI C2 Receive Message FIFO + //------------------------------------------------------------------------ + // Define signals associated with the LLKI C2 Received Message FIFO + reg llkic2_respfifo_clr_i; + reg llkic2_respfifo_wvalid_i; + wire llkic2_respfifo_wready_o; + reg [top_pkg::TL_DW - 1:0] llkic2_respfifo_wdata_i; + wire llkic2_respfifo_rvalid_o; + reg llkic2_respfifo_rready_i; + reg [top_pkg::TL_DW - 1:0] llkic2_respfifo_rdata_o; + wire [DepthW - 1:0] llkic2_respfifo_depth_o; + wire llkic2_respfifo_empty; + wire llkic2_respfifo_full; + + // Instantiate the FIFO + prim_fifo_sync #( + .Width (top_pkg::TL_DW), + .Pass (1'b0), + .Depth (FIFO_DEPTH), + .OutputZeroIfEmpty (1'b0) // Enables "first word fall through" + ) llkic2_respfifo_inst ( + .clk_i (clk), + .rst_ni (~rst), + + // Synchronous clear/flush + .clr_i (llkic2_respfifo_clr_i), + + // Write Port + .wvalid_i (llkic2_respfifo_wvalid_i), + .wready_o (llkic2_respfifo_wready_o), + .wdata_i (llkic2_respfifo_wdata_i), + + // Read Port + .rvalid_o (llkic2_respfifo_rvalid_o), + .rready_i (llkic2_respfifo_rready_i), + .rdata_o (llkic2_respfifo_rdata_o), + + // Occupancy + .depth_o (llkic2_respfifo_depth_o) + ); + + // Generate the full and empty signals for the Rx FIFO + assign llkic2_respfifo_empty = llkic2_respfifo_depth_o == '0; + assign llkic2_respfifo_full = llkic2_respfifo_depth_o == FIFO_DEPTH; + //------------------------------------------------------------------------ + + + + //------------------------------------------------------------------------ + // Key Index RAM + //------------------------------------------------------------------------ + reg keyindexram_a_write_i; + reg [top_pkg::TL_AW-1:0] keyindexram_a_addr_i; + reg [top_pkg::TL_DW-1:0] keyindexram_a_wdata_i; + wire [top_pkg::TL_DW-1:0] keyindexram_a_rdata_o; + + reg [top_pkg::TL_AW-1:0] keyindexram_b_addr_i; + wire [top_pkg::TL_DW-1:0] keyindexram_b_rdata_o; + + prim_generic_ram_2p #( + .Width (top_pkg::TL_DW), + .Depth (SROT_KEYINDEXRAM_SIZE) + ) key_index_ram_inst ( + .clk_a_i (clk), + .clk_b_i (clk), + + .a_req_i (1'b1), // Always selected + .a_write_i (keyindexram_a_write_i), + .a_addr_i (keyindexram_a_addr_i[$clog2(SROT_KEYINDEXRAM_SIZE) - 1:0]), + .a_wdata_i (keyindexram_a_wdata_i), + .a_wmask_i ('1), // Mask is unused + .a_rdata_o (keyindexram_a_rdata_o), + + .b_req_i (1'b1), // Always selected + .b_write_i (1'b0), // Port B is Read Only + .b_addr_i (keyindexram_b_addr_i[$clog2(SROT_KEYINDEXRAM_SIZE) - 1:0]), + .b_wdata_i ('0), // Port B is Read Only + .b_wmask_i ('1), // Mask is unused + .b_rdata_o (keyindexram_b_rdata_o) + + ); + //------------------------------------------------------------------------ + + + + //------------------------------------------------------------------------ + // Key RAM + //------------------------------------------------------------------------ + reg keyram_a_write_i; + reg [top_pkg::TL_AW-1:0] keyram_a_addr_i; + reg [top_pkg::TL_DW-1:0] keyram_a_wdata_i; + wire [top_pkg::TL_DW-1:0] keyram_a_rdata_o; + + reg [top_pkg::TL_AW-1:0] keyram_b_addr_i; + wire [top_pkg::TL_DW-1:0] keyram_b_rdata_o; + + prim_generic_ram_2p #( + .Width (top_pkg::TL_DW), + .Depth (SROT_KEYRAM_SIZE) + ) key_ram_inst ( + .clk_a_i (clk), + .clk_b_i (clk), + + .a_req_i (1'b1), // Always selected + .a_write_i (keyram_a_write_i), + .a_addr_i (keyram_a_addr_i[$clog2(SROT_KEYRAM_SIZE) - 1:0]), + .a_wdata_i (keyram_a_wdata_i), + .a_wmask_i ('1), // Mask is unused + .a_rdata_o (keyram_a_rdata_o), + + .b_req_i (1'b1), // Always selected + .b_write_i (1'b0), // Port B is Read Only + .b_addr_i (keyram_b_addr_i[$clog2(SROT_KEYRAM_SIZE) - 1:0]), + .b_wdata_i ('0), // Port B is Read Only + .b_wmask_i ('1), // Mask is unused + .b_rdata_o (keyram_b_rdata_o) + + ); + //------------------------------------------------------------------------ + + + + //------------------------------------------------------------------------ + // Write Decode Process + //------------------------------------------------------------------------ + always @(posedge clk or posedge rst) + begin + if (rst) begin + srot_ctrlstatus_register <= '0; + write_error <= 1'b0; + keyindexram_a_write_i <= 1'b0; + keyram_a_write_i <= 1'b0; + keyindexram_a_addr_i <= '0; + keyindexram_a_wdata_i <= '0; + keyram_a_addr_i <= '0; + keyram_a_wdata_i <= '0; + llkic2_reqfifo_wvalid_i <= 1'b0; + llkic2_reqfifo_wdata_i <= 1'b0; + end else begin + + // Default signal assignments + write_error <= 1'b0; + keyindexram_a_write_i <= 1'b0; + keyram_a_write_i <= 1'b0; + llkic2_reqfifo_wvalid_i <= 1'b0; + llkic2_reqfifo_wdata_i <= 1'b0; + + // The Key Index and Key RAM A ports are registered to + // align them with the corresponding write enables + keyindexram_a_addr_i <= (reg_addr_o - SROT_KEYINDEXRAM_ADDR) >> 3; + keyindexram_a_wdata_i <= reg_wdata_o; + keyram_a_addr_i <= (reg_addr_o - SROT_KEYRAM_ADDR) >> 3; + keyram_a_wdata_i <= reg_wdata_o; + + // Implement other bits of the Control / Status Register + srot_ctrlstatus_register[SROT_CTRLSTS_RESP_WAITING] <= ~llkic2_respfifo_empty; + + // A write has been requested + if (reg_we_o) begin + + // Read or Writes to either RAMs while in operational mode should cause an error of some + // sort, but we do not currently have a means of handling tilelink errors. Thus, the + // acccess will just be ignored + + // Decode to the Key RAM + // Note: Addresses are in terms of bytes and the datapath is 64-bit wide + if (reg_addr_o >= SROT_KEYRAM_ADDR && reg_addr_o <= (SROT_KEYRAM_ADDR + (SROT_KEYRAM_SIZE * 8) - 1)) begin + + // Both mode bits MUST BE ZERO to allow access to the key and key index RAMs + if (srot_ctrlstatus_register[SROT_CTRLSTS_MODEBIT_0] || srot_ctrlstatus_register[SROT_CTRLSTS_MODEBIT_1]) + ; + else + keyram_a_write_i <= 1'b1; + + // Decode to the Key Index RAM + end else if (reg_addr_o >= SROT_KEYINDEXRAM_ADDR && reg_addr_o <= (SROT_KEYINDEXRAM_ADDR + (SROT_KEYINDEXRAM_SIZE * 8) - 1)) begin + + // Both mode bits MUST BE ZERO to allow access to the key and key index RAMs + if (srot_ctrlstatus_register[SROT_CTRLSTS_MODEBIT_0] || srot_ctrlstatus_register[SROT_CTRLSTS_MODEBIT_1]) + ; + else + keyindexram_a_write_i <= 1'b1; + + // All other write decode events + end else begin + case (reg_addr_o) + // + // SROT Control Status Register + // + SROT_CTRLSTS_ADDR : begin + if (reg_wdata_o[SROT_CTRLSTS_MODEBIT_0]) srot_ctrlstatus_register[SROT_CTRLSTS_MODEBIT_0] <= 1'b1; + if (reg_wdata_o[SROT_CTRLSTS_MODEBIT_1]) srot_ctrlstatus_register[SROT_CTRLSTS_MODEBIT_1] <= 1'b1; + end // end SROT_CTRLSTS_ADDR + + // Write to the LLKIC2 Send FIFO (writing to a full FIFO will cause an error) + SROT_LLKIC2_SENDRECV_ADDR : begin + // Overflow condition + if (llkic2_reqfifo_full) begin + write_error <= 1'b1; + end else begin + llkic2_reqfifo_wdata_i <= reg_wdata_o; + llkic2_reqfifo_wvalid_i <= 1'b1; + end // end else llkic2_reqfifo_full + end // end SROT_LLKIC2_SEND_ADDR + + // + // All other decodes + // + default : + write_error <= 1'b1; + endcase // endcase reg_addr_o + end // end if aaddress decode + end else begin + + // No writes, no errors. + write_error <= 1'b0; + + end // end if reg_we_o + end // end else if (rst) + end // end always + //------------------------------------------------------------------------ + + + + //------------------------------------------------------------------------ + // Read decode process + //------------------------------------------------------------------------ + always @* + begin + + // Default signal assignments + reg_rdata_i = '0; + read_error = 1'b0; + llkic2_respfifo_clr_i = 1'b0; + llkic2_respfifo_rready_i = 1'b0; + + // A read has been requested + if (reg_re_o) begin + + // Read or Writes to either RAMs while in operational mode should cause an error of some + // sort, but we do not currently have a means of handling tilelink errors. Thus, the + // acccess will just be ignored + + // Decode to the Key RAM + // Note: Addresses are in terms of bytes and the datapath is 64-bit wide + if (reg_addr_o >= SROT_KEYRAM_ADDR && reg_addr_o <= (SROT_KEYRAM_ADDR + (SROT_KEYRAM_SIZE * 8) - 1)) begin + + // Both mode bits MUST BE ZERO to allow access to the key and key index RAMs + if (srot_ctrlstatus_register[SROT_CTRLSTS_MODEBIT_0] || srot_ctrlstatus_register[SROT_CTRLSTS_MODEBIT_1]) + ; + else + reg_rdata_i = keyram_a_rdata_o; + + // Decode to the Key Index RAM + end else if (reg_addr_o >= SROT_KEYINDEXRAM_ADDR && reg_addr_o <= (SROT_KEYINDEXRAM_ADDR + (SROT_KEYINDEXRAM_SIZE * 8) - 1)) begin + + // Both mode bits MUST BE ZERO to allow access to the key and key index RAMs + if (srot_ctrlstatus_register[SROT_CTRLSTS_MODEBIT_0] || srot_ctrlstatus_register[SROT_CTRLSTS_MODEBIT_1]) + ; + else + reg_rdata_i = keyindexram_a_rdata_o; + + // All other write decode events + end else begin + case (reg_addr_o) + // + // SROT Control Status Register + // + SROT_CTRLSTS_ADDR : begin + reg_rdata_i = srot_ctrlstatus_register; + end // end SROT_CTRLSTS_ADDR + // + // Decode to the Receive FIFO + // + SROT_LLKIC2_SENDRECV_ADDR : begin + if (llkic2_respfifo_empty) begin + read_error = 1'b1; + end else begin + llkic2_respfifo_rready_i = 1'b1; + reg_rdata_i = llkic2_respfifo_rdata_o; + end // end llkic2_respfifo_empty + end // SROT_LLKIC2_RECV_ADDR + // + // All other decodes + // + default : begin + read_error <= 1'b1; + end // end default + endcase // endcase reg_addr_o + end // end if address decode + end // end if (reg_re_o) + end // end always @(reg_addr_o or reg_re_o) + //------------------------------------------------------------------------ + + + + //------------------------------------------------------------------------ + // SRoT State Machine + // Processes messages received via the SEND message FIFO, initiates + // transactions with downstream LLKI Protocol Processing blocks via the + // TL host interface, receives downstream responses, then generates the + // responses back to the RISC-V. Once the RISC-V initiates an LLKIC2 + // request, it should poll the SROT_CTRLSTS_RESP_WAITING bit in the + // SROT_CTRLSTS_ADDR register to determine when a response has been + // received. + //------------------------------------------------------------------------ + SROT_STATE_TYPE srot_current_state; + reg [31:0] rsvd; + reg [7:0] msg_id; + reg [7:0] status; + reg [7:0] msg_len; + reg [7:0] key_index; + reg [15:0] low_pointer; + reg [15:0] high_pointer; + reg [15:0] current_pointer; // Used to track the currently selected + // Key RAM word + reg [7:0] core_index; + reg index_valid; + reg [7:0] wait_state_counter; + + // Perform a continuous assignment of the key index RAM fields, + // making conding of the SRoT STM a bit cleaner + always @* + begin + low_pointer = keyindexram_b_rdata_o[15:0]; + high_pointer = keyindexram_b_rdata_o[31:16]; + core_index = keyindexram_b_rdata_o[39:32]; + index_valid = keyindexram_b_rdata_o[63]; + end // end always @* + + + always @(posedge clk or posedge rst) + begin + if (rst) begin + host_req_i <= '0; + host_addr_i <= '0; + host_we_i <= '0; + host_wdata_i <= '0; + keyindexram_b_addr_i <= '0; + keyram_b_addr_i <= '0; + llkic2_reqfifo_clr_i <= 1'b0; + llkic2_reqfifo_rready_i <= 1'b0; + llkic2_respfifo_wvalid_i <= 1'b0; + llkic2_respfifo_wdata_i <= '0; + rsvd <= '0; + msg_id <= '0; + status <= '0; + msg_len <= '0; + key_index <= '0; + current_pointer <= '0; + wait_state_counter <= SROT_WAIT_STATE_COUNTER_INIT; + srot_current_state <= ST_SROT_IDLE; + end else begin + + // Case for the SRoT STM + case (srot_current_state) + //------------------------------------------------------------------ + // IDLE State + //------------------------------------------------------------------ + ST_SROT_IDLE : begin + // Default signal assignment + host_req_i <= '0; + host_addr_i <= '0; + host_we_i <= '0; + host_wdata_i <= '0; + keyindexram_b_addr_i <= '0; + keyram_b_addr_i <= '0; + llkic2_reqfifo_rready_i <= 1'b0; + llkic2_respfifo_wvalid_i <= 1'b0; + llkic2_respfifo_wdata_i <= '0; + rsvd <= '0; + msg_id <= '0; + status <= '0; + msg_len <= '0; + key_index <= '0; + current_pointer <= '0; + wait_state_counter <= SROT_WAIT_STATE_COUNTER_INIT; + srot_current_state <= ST_SROT_IDLE; + + // The SRoT STM will stay idle until it determines that a message is + // present in the Send FIFO. All messages from RISC-V are expect to + // be one 64-bit word in length. + if (~llkic2_reqfifo_empty && llkic2_reqfifo_rvalid_o) begin + + // Capture the message elements (incoming status is ignored) + msg_id <= llkic2_reqfifo_rdata_o[7:0]; + msg_len <= llkic2_reqfifo_rdata_o[23:16]; + key_index <= llkic2_reqfifo_rdata_o[31:24]; + rsvd <= llkic2_reqfifo_rdata_o[63:32]; + + // Assert the Send FIFO read enable + llkic2_reqfifo_rready_i <= 1'b1; + + // Jump to the next state + srot_current_state <= ST_SROT_MESSAGE_CHECK; + end // end if (~llkic2_reqfifo_empty) + + end // end ST_SROT_IDLE + //------------------------------------------------------------------ + // Message Check State + //------------------------------------------------------------------ + ST_SROT_MESSAGE_CHECK : begin + // Default signal assignment + host_req_i <= '0; + host_addr_i <= '0; + host_we_i <= '0; + host_wdata_i <= '0; + keyindexram_b_addr_i <= '0; + keyram_b_addr_i <= '0; + llkic2_reqfifo_rready_i <= '0; + llkic2_respfifo_wvalid_i <= '0; + llkic2_respfifo_wdata_i <= '0; + current_pointer <= '0; + wait_state_counter <= SROT_WAIT_STATE_COUNTER_INIT; + srot_current_state <= ST_SROT_IDLE; + + case (msg_id) + // A valid request haas been received via the C2 RISCV -> SRoT Inteface + LLKI_MID_C2LOADKEYREQ, + LLKI_MID_C2CLEARKEYREQ, + LLKI_MID_C2KEYSTATUSREQ : begin + keyindexram_b_addr_i <= key_index; + srot_current_state <= ST_SROT_RETRIEVE_KEY_INDEX; + ; + end + // All other message ID (error condition) + // Clear the send FIFO as a precaution + default : begin + llkic2_reqfifo_clr_i <= 1'b1; + status <= LLKI_STATUS_BAD_MSG_ID; + srot_current_state <= ST_SROT_C2_RESPONSE; + end + endcase // end case (msg_id) + + // The only valid message length for requests is one + if (msg_len != 1) begin + llkic2_reqfifo_clr_i <= 1'b1; + status <= LLKI_STATUS_BAD_MSG_LEN; + srot_current_state <= ST_SROT_C2_RESPONSE; + end // end if (msg_len != 1) + + // The Key Index must >= 0 and < SROT_KEYINDEXRAM_SIZE + if (key_index >= SROT_KEYINDEXRAM_SIZE) begin + llkic2_reqfifo_clr_i <= 1'b1; + status <= LLKI_STATUS_KEY_INDX_EXCEED; + srot_current_state <= ST_SROT_C2_RESPONSE; + end // end if (key_index >= SROT_KEYINDEXRAM_SIZE) + + end // end ST_SROT_MESSAGE_CHECK + //------------------------------------------------------------------ + // Retrieve (and check) key index State + //------------------------------------------------------------------ + ST_SROT_RETRIEVE_KEY_INDEX : begin + // Default signal assignment + host_req_i <= '0; + host_addr_i <= '0; + host_we_i <= '0; + host_wdata_i <= '0; + keyram_b_addr_i <= '0; + llkic2_reqfifo_rready_i <= '0; + llkic2_respfifo_wvalid_i <= '0; + llkic2_respfifo_wdata_i <= '0; + current_pointer <= '0; + wait_state_counter <= SROT_WAIT_STATE_COUNTER_INIT; + srot_current_state <= ST_SROT_RETRIEVE_KEY_INDEX; + + // Perform some error checking on the Key Index + // currently being referenced. Error checking + // is somewhat "hierchical in nature" + // + // Key Index is NOT valid + if (!index_valid) begin + llkic2_reqfifo_clr_i <= 1'b1; + status <= LLKI_STATUS_KEY_INDEX_INVALID; + srot_current_state <= ST_SROT_C2_RESPONSE; + // Pointer related checks + end else if (low_pointer >= SROT_KEYRAM_SIZE || // Low pointer exceeds the key RAM + high_pointer >= SROT_KEYRAM_SIZE || // High pointer exceeds the key RAM + low_pointer > high_pointer) begin // Low pointer > high pointer + llkic2_reqfifo_clr_i <= 1'b1; + status <= LLKI_STATUS_BAD_POINTER_PAIR; + srot_current_state <= ST_SROT_C2_RESPONSE; + // The specified target core index exceeds the maximum entry + // in the LLKI Core Index Array + end else if (core_index > $high(LLKI_CORE_INDEX_ARRAY)) begin + llkic2_reqfifo_clr_i <= 1'b1; + status <= LLKI_STATUS_BAD_CORE_INDEX; + srot_current_state <= ST_SROT_C2_RESPONSE; + // The received message has been checked for errors and the selected key + // index looks ok. + end else begin + // Save the low pointer, as it will used to determine how many key + // words we will be sending + current_pointer <= low_pointer; + + // Jump to the next state + srot_current_state <= ST_SROT_KL_REQ_HEADER; + end // end if (!index_valid) + + end // ST_RETRIEVE_KEY_INDEX + //------------------------------------------------------------------ + // Create Header for the request to the specified LLKI-PP + //------------------------------------------------------------------ + ST_SROT_KL_REQ_HEADER : begin + // Default signal assignment + host_req_i <= '0; + host_addr_i <= '0; + host_we_i <= '0; + host_wdata_i <= '0; + keyram_b_addr_i <= '0; + llkic2_reqfifo_rready_i <= '0; + llkic2_respfifo_wvalid_i <= '0; + llkic2_respfifo_wdata_i <= '0; + wait_state_counter <= SROT_WAIT_STATE_COUNTER_INIT; + srot_current_state <= ST_SROT_KL_REQ_ISSUE; + + // Header generation is message specific + case (msg_id) + LLKI_MID_C2LOADKEYREQ : begin + host_wdata_i[7:0] <= LLKI_MID_KLLOADKEYREQ; + // For the Load Key Request Message length is equal + // to the 2 + (high_pointer - low pointer). + host_wdata_i[23:16] <= (high_pointer - low_pointer) + 2; + host_addr_i <= LLKI_CORE_INDEX_ARRAY[core_index][LLKI_SENDRECV_INDEX]; + // Assert write enable and req (indicates a TL PutFullData operation) + host_req_i <= 1'b1; + host_we_i <= 1'b1; + + end + LLKI_MID_C2CLEARKEYREQ : begin + host_wdata_i[7:0] <= LLKI_MID_KLCLEARKEYREQ; + host_wdata_i[23:16] <= 8'h01; + host_addr_i <= LLKI_CORE_INDEX_ARRAY[core_index][LLKI_SENDRECV_INDEX]; + // Assert write enable and req (indicates a TL PutFullData operation) + host_req_i <= 1'b1; + host_we_i <= 1'b1; + end + LLKI_MID_C2KEYSTATUSREQ : begin + host_wdata_i[7:0] <= LLKI_MID_KLKEYSTATUSREQ; + host_wdata_i[23:16] <= 8'h01; + host_addr_i <= LLKI_CORE_INDEX_ARRAY[core_index][LLKI_SENDRECV_INDEX]; + // Assert write enable and req (indicates a TL PutFullData operation) + host_req_i <= 1'b1; + host_we_i <= 1'b1; + end + // Since we already checked for valid message IDs, + // this truely is a trap condition + default : begin + llkic2_reqfifo_clr_i <= 1'b1; + status <= LLKI_STATUS_BAD_CORE_INDEX; + srot_current_state <= ST_SROT_C2_RESPONSE; + end + endcase + + end // ST_SROT_KL_CREATE_HEADER + //------------------------------------------------------------------ + // Assert host request in order to send the LLKI-PP Request + //------------------------------------------------------------------ + ST_SROT_KL_REQ_ISSUE : begin + // Default signal assignment + host_req_i <= '0; + host_we_i <= '0; + keyram_b_addr_i <= '0; + llkic2_reqfifo_rready_i <= '0; + llkic2_respfifo_wvalid_i <= '0; + llkic2_respfifo_wdata_i <= '0; + wait_state_counter <= SROT_WAIT_STATE_COUNTER_INIT; + srot_current_state <= ST_SROT_KL_REQ_ISSUE; + + // Continue to assert write enable and req (indicates a TL PutFullData operation) + host_req_i <= 1'b1; + host_we_i <= 1'b1; + + // Wait for grant indicating the write has been sent + if (host_gnt_o) begin + host_req_i <= 1'b0; + host_we_i <= 1'b0; + + // Jump to the Request Wait for Ack state + srot_current_state <= ST_SROT_KL_REQ_WAIT_FOR_ACK; + + // Did an error get asserted? + if (host_err_o) begin + msg_id <= LLKI_MID_C2ERRORRESP; + status <= LLKI_STATUS_KL_TILELINK_ERROR; + msg_len <= 8'h01; + srot_current_state <= ST_SROT_C2_RESPONSE; + end + end // end if (host_gnt_o) + end // ST_SROT_KL_REQ_WAIT_FOR_GRANT + //------------------------------------------------------------------ + // Using the OpenTitan tlul_adapter_host module, even writes get + // "acknowledged" through the assertion of the valid_o bit, which + // is directly mapped from the TL-UL D channel valid bit + //------------------------------------------------------------------ + ST_SROT_KL_REQ_WAIT_FOR_ACK : begin + // Default signal assignment + host_req_i <= '0; + host_we_i <= '0; + keyram_b_addr_i <= '0; + llkic2_reqfifo_rready_i <= '0; + llkic2_respfifo_wvalid_i <= '0; + llkic2_respfifo_wdata_i <= '0; + wait_state_counter <= SROT_WAIT_STATE_COUNTER_INIT; + srot_current_state <= ST_SROT_KL_REQ_WAIT_FOR_ACK; + + // The request has been acknowledged + if (host_valid_o) begin + + // If this is a Load Key request, then we need to begin + // the cycle of reading the ready bit from the selected + // LLKI-PP block. When ready, we can issue a key word + // write. Once all the key words have be written, then + // we should look for a standard response from the LLKI-PP + if (msg_id == LLKI_MID_C2LOADKEYREQ) + srot_current_state <= ST_SROT_KL_READ_READY_STATUS; + else + srot_current_state <= ST_SROT_KL_READ_RESP_STATUS; + + end // end if (host_valid_o) + end // ST_SROT_KL_REQ_WAIT_FOR_ACK + //------------------------------------------------------------------ + // Before writing a key word to the select LLKI-PP block, we need + // read the ready bit + //------------------------------------------------------------------ + ST_SROT_KL_READ_READY_STATUS : begin + // Default signal assignment + host_req_i <= '0; + host_addr_i <= '0; + host_we_i <= '0; + host_wdata_i <= '0; + keyram_b_addr_i <= '0; + llkic2_reqfifo_rready_i <= '0; + llkic2_respfifo_wvalid_i <= '0; + llkic2_respfifo_wdata_i <= '0; + wait_state_counter <= SROT_WAIT_STATE_COUNTER_INIT; + srot_current_state <= ST_SROT_KL_READ_READY_STATUS; + + // We want to read the selected LLKI-PP Control/Status Register + host_addr_i <= LLKI_CORE_INDEX_ARRAY[core_index][LLKI_CTRLSTS_INDEX]; + host_req_i <= 1'b1; + + // Did an error get asserted? + if (host_err_o) begin + msg_id <= LLKI_MID_C2ERRORRESP; + status <= LLKI_STATUS_KL_TILELINK_ERROR; + msg_len <= 8'h01; + srot_current_state <= ST_SROT_C2_RESPONSE; + // Wait until the request has been granted, then jump to + // the check status state + end else if (host_gnt_o) begin + // Point the Key RAM to the current word + keyram_b_addr_i <= current_pointer; + + // Jump to next + srot_current_state <= ST_SROT_KL_CHECK_READY_STATUS; + end + end // ST_SROT_KL_READ_READY_STATUS + //------------------------------------------------------------------ + // The Ready Status has been read, now time to check it + //------------------------------------------------------------------ + ST_SROT_KL_CHECK_READY_STATUS : begin + // Default signal assignment + host_req_i <= '0; + host_addr_i <= '0; + host_we_i <= '0; + host_wdata_i <= '0; + llkic2_reqfifo_rready_i <= '0; + llkic2_respfifo_wvalid_i <= '0; + llkic2_respfifo_wdata_i <= '0; + wait_state_counter <= SROT_WAIT_STATE_COUNTER_INIT; + srot_current_state <= ST_SROT_KL_CHECK_READY_STATUS; + + // Valid data has been returned + if (host_valid_o) begin + + // The select LLKI-PP is ready for a key + if (host_rdata_o[LLKIKL_CTRLSTS_READY_FOR_KEY] == 1'b1) begin + // Issue the key write, understanding that if host_gnt_o is + // already asserted, this will only be set for a single clock cycle + host_addr_i <= LLKI_CORE_INDEX_ARRAY[core_index][LLKI_SENDRECV_INDEX]; + host_wdata_i <= keyram_b_rdata_o; + host_req_i <= 1'b1; + host_we_i <= 1'b1; + + srot_current_state <= ST_SROT_KL_LOAD_KEY_WORD; + // Response is NOT waiting, jump to wait state + end else begin + srot_current_state <= ST_SROT_KL_READY_WAIT_STATE; + end + end // end else if (host_err_o) + end // ST_SROT_KL_CHECK_READY_STATUS + //------------------------------------------------------------------ + // Wait state to avoid spamming the LLKI-PP with requests + //------------------------------------------------------------------ + ST_SROT_KL_READY_WAIT_STATE : begin + // Default signal assignment + host_req_i <= '0; + host_addr_i <= '0; + host_we_i <= '0; + host_wdata_i <= '0; + llkic2_reqfifo_rready_i <= '0; + llkic2_respfifo_wvalid_i <= '0; + llkic2_respfifo_wdata_i <= '0; + srot_current_state <= ST_SROT_KL_READY_WAIT_STATE; + + // Decrement the wait state counter + wait_state_counter <= wait_state_counter - 1; + + // Did an error get asserted? + if (host_err_o) begin + msg_id <= LLKI_MID_C2ERRORRESP; + status <= LLKI_STATUS_KL_TILELINK_ERROR; + msg_len <= 8'h01; + srot_current_state <= ST_SROT_C2_RESPONSE; + end else if (wait_state_counter == 0) begin + srot_current_state <= ST_SROT_KL_READ_READY_STATUS; + end + + end // ST_SROT_KL_READY_WAIT_STATE + //------------------------------------------------------------------ + // We know the LLKI-PP is ready for a key word, so let's send it + //------------------------------------------------------------------ + ST_SROT_KL_LOAD_KEY_WORD : begin + // Default signal assignment + host_req_i <= '0; + host_we_i <= '0; + host_wdata_i <= '0; + wait_state_counter <= SROT_WAIT_STATE_COUNTER_INIT; + srot_current_state <= ST_SROT_KL_LOAD_KEY_WORD; + + // Hold the signals, until host_gnt_o is issued + host_addr_i <= LLKI_CORE_INDEX_ARRAY[core_index][LLKI_SENDRECV_INDEX]; + host_wdata_i <= keyram_b_rdata_o; + host_req_i <= 1'b1; + host_we_i <= 1'b1; + + // The write request has been granted + if (host_gnt_o) begin + // Clear up some signals + host_addr_i <= '0; + host_wdata_i <= '0; + host_req_i <= '0; + host_we_i <= '0; + + // Jump to the next state + srot_current_state <= ST_SROT_KL_LOAD_KEY_WORD_WAIT_FOR_ACK; + end + end // ST_SROT_KL_LOAD_KEY_WORD + //------------------------------------------------------------------ + // The key word write has been issued, we need to wait until it + // is acknowledged + //------------------------------------------------------------------ + ST_SROT_KL_LOAD_KEY_WORD_WAIT_FOR_ACK : begin + // Default signal assignment + host_req_i <= '0; + host_we_i <= '0; + host_wdata_i <= '0; + wait_state_counter <= SROT_WAIT_STATE_COUNTER_INIT; + srot_current_state <= ST_SROT_KL_LOAD_KEY_WORD_WAIT_FOR_ACK; + + // The write has been acknowledged + if (host_valid_o) begin + + // Is this the last word of the load? If yes, then jump to the + // read response status state + if (current_pointer == high_pointer) begin + srot_current_state <= ST_SROT_KL_READ_RESP_STATUS; + // We have more words. Increment the current pointer and + // read the LLKI-PP ready status + end else begin + current_pointer <= current_pointer + 1; + srot_current_state <= ST_SROT_KL_READ_READY_STATUS; + end // end if (current_pointer == high_pointer) + + end + end // ST_SROT_KL_LOAD_KEY_WORD_WAIT_FOR_ACK + //------------------------------------------------------------------ + // Now, the request has been sent, it is time to poll the response + // waiting bit in the target LLKI-PP + //------------------------------------------------------------------ + ST_SROT_KL_READ_RESP_STATUS : begin + // Default signal assignment + host_req_i <= '0; + host_addr_i <= '0; + host_we_i <= '0; + host_wdata_i <= '0; + keyram_b_addr_i <= '0; + llkic2_reqfifo_rready_i <= '0; + llkic2_respfifo_wvalid_i <= '0; + llkic2_respfifo_wdata_i <= '0; + current_pointer <= '0; + wait_state_counter <= SROT_WAIT_STATE_COUNTER_INIT; + srot_current_state <= ST_SROT_KL_READ_RESP_STATUS; + + // We want to read the selected LLKI-PP Control/Status Register + host_addr_i <= LLKI_CORE_INDEX_ARRAY[core_index][LLKI_CTRLSTS_INDEX]; + host_req_i <= 1'b1; + + // Did an error get asserted? + if (host_err_o) begin + msg_id <= LLKI_MID_C2ERRORRESP; + status <= LLKI_STATUS_KL_TILELINK_ERROR; + msg_len <= 8'h01; + srot_current_state <= ST_SROT_C2_RESPONSE; + // Wait until the request has been granted, then jump to + // the check status state + end else if (host_gnt_o) begin + srot_current_state <= ST_SROT_KL_CHECK_RESP_STATUS; + end + end // ST_SROT_KL_RESP_READ_STATUS + //------------------------------------------------------------------ + // The read request has been issued and granted, but now we need + // to wait until valid data is returned + //------------------------------------------------------------------ + ST_SROT_KL_CHECK_RESP_STATUS : begin + // Default signal assignment + host_req_i <= '0; + host_addr_i <= '0; + host_we_i <= '0; + host_wdata_i <= '0; + keyram_b_addr_i <= '0; + llkic2_reqfifo_rready_i <= '0; + llkic2_respfifo_wvalid_i <= '0; + llkic2_respfifo_wdata_i <= '0; + current_pointer <= '0; + wait_state_counter <= SROT_WAIT_STATE_COUNTER_INIT; + srot_current_state <= ST_SROT_KL_CHECK_RESP_STATUS; + + // Valid data has been returned + if (host_valid_o) begin + + // Response is waiting in the LLKI PP. Initiate the request + // as we tranisition to the next state + if (host_rdata_o[LLKIKL_CTRLSTS_RESP_WAITING] == 1'b1) begin + // We want to read the selected LLKI-PP Send/Receive Queue + host_addr_i <= LLKI_CORE_INDEX_ARRAY[core_index][LLKI_SENDRECV_INDEX]; + host_req_i <= 1'b1; + + srot_current_state <= ST_SROT_KL_RESP_READ; + // Response is NOT waiting, jump to wait state + end else begin + srot_current_state <= ST_SROT_KL_RESP_WAIT_STATE; + end + end // end else if (host_err_o) + end // ST_SROT_KL_RESP_CHECK_STATUS + //------------------------------------------------------------------ + // This wait state is used to avoid spaming the Host interface + // while waiting for the select LLKI-PP block to process a message + //------------------------------------------------------------------ + ST_SROT_KL_RESP_WAIT_STATE : begin + // Default signal assignment + host_req_i <= '0; + host_addr_i <= '0; + host_we_i <= '0; + host_wdata_i <= '0; + keyram_b_addr_i <= '0; + llkic2_reqfifo_rready_i <= '0; + llkic2_respfifo_wvalid_i <= '0; + llkic2_respfifo_wdata_i <= '0; + current_pointer <= '0; + srot_current_state <= ST_SROT_KL_RESP_WAIT_STATE; + + // Decrement the wait state counter + wait_state_counter <= wait_state_counter - 1; + + // Did an error get asserted? + if (host_err_o) begin + msg_id <= LLKI_MID_C2ERRORRESP; + status <= LLKI_STATUS_KL_TILELINK_ERROR; + msg_len <= 8'h01; + srot_current_state <= ST_SROT_C2_RESPONSE; + end else if (wait_state_counter == 0) begin + srot_current_state <= ST_SROT_KL_READ_RESP_STATUS; + end + + end // ST_SROT_KL_RESP_WAIT_STATE + //------------------------------------------------------------------ + // Read LLKI-PP Reponse + //------------------------------------------------------------------ + ST_SROT_KL_RESP_READ : begin + // Default signal assignment + host_req_i <= '0; + host_addr_i <= '0; + host_we_i <= '0; + host_wdata_i <= '0; + keyram_b_addr_i <= '0; + llkic2_reqfifo_rready_i <= 1'b0; + llkic2_respfifo_wvalid_i <= 1'b0; + llkic2_respfifo_wdata_i <= '0; + current_pointer <= '0; + wait_state_counter <= SROT_WAIT_STATE_COUNTER_INIT; + srot_current_state <= ST_SROT_KL_RESP_READ; + + // Did an error get asserted? + if (host_err_o) begin + msg_id <= LLKI_MID_C2ERRORRESP; + status <= LLKI_STATUS_KL_TILELINK_ERROR; + msg_len <= 8'h01; + srot_current_state <= ST_SROT_C2_RESPONSE; + // Valid data has been received + end else if (host_valid_o) begin + + // Deassert request and address signals + host_req_i <= '0; + host_addr_i <= '0; + + // Capture the reponse fields from the LLKI-PP block + msg_id <= host_rdata_o[7:0]; + status <= host_rdata_o[15:8]; + msg_len <= host_rdata_o[23:16]; + + // Just to creating a C2 Response message + srot_current_state <= ST_SROT_C2_RESPONSE; + + end // end else if (host_err_o) + end // end ST_SROT_KL_RESP_READ + //------------------------------------------------------------------ + // Generate the LLKI C2 Response Message + //------------------------------------------------------------------ + ST_SROT_C2_RESPONSE : begin + // Default signal states + host_req_i <= '0; + host_addr_i <= '0; + host_we_i <= '0; + host_wdata_i <= '0; + keyindexram_b_addr_i <= '0; + keyram_b_addr_i <= '0; + llkic2_reqfifo_rready_i <= 1'b0; + llkic2_respfifo_wdata_i <= '0; + llkic2_respfifo_wvalid_i <= 1'b0; + key_index <= '0; + current_pointer <= '0; + wait_state_counter <= SROT_WAIT_STATE_COUNTER_INIT; + srot_current_state <= ST_SROT_IDLE; + + // Create the response message. Errors can be generated + // in the following ways: + // - LLKIC2 message is bad + // - The reference key index is bad + // - A response received via the LLKI-KL interface indicates an error + // - A tilelink error is indicated on the LLKI-KL interface + case (status) + //------------------------------------------------------------------ + // Processing a good response received via the LLKI-KL interface + //------------------------------------------------------------------ + LLKI_STATUS_GOOD, + LLKI_STATUS_KEY_PRESENT, + LLKI_STATUS_KEY_NOT_PRESENT : begin + + // Set most of the LLKI-C2 response fields + llkic2_respfifo_wdata_i[15:8] <= status; + llkic2_respfifo_wdata_i[23:16] <= 8'h01; + llkic2_respfifo_wdata_i[63:32] <= rsvd; + llkic2_respfifo_wvalid_i <= 1'b1; + + // Determine the LLKI C2 Response ID + case (msg_id) + LLKI_MID_KLLOADKEYACK : llkic2_respfifo_wdata_i[7:0] <= LLKI_MID_C2LOADKEYACK; + LLKI_MID_KLCLEARKEYACK : llkic2_respfifo_wdata_i[7:0] <= LLKI_MID_C2CLEARKEYACK; + LLKI_MID_KLKEYSTATUSRESP : llkic2_respfifo_wdata_i[7:0] <= LLKI_MID_C2KEYSTATUSRESP; + default : begin + llkic2_respfifo_wdata_i[7:0] <= LLKI_MID_KLERRORRESP; + llkic2_respfifo_wdata_i[15:8] <= LLKI_STATUS_KL_RESP_BAD_MSG_ID; + end + endcase + end + //------------------------------------------------------------------ + // An expected error has occurred + //------------------------------------------------------------------ + LLKI_STATUS_BAD_MSG_ID, + LLKI_STATUS_BAD_MSG_LEN, + LLKI_STATUS_KEY_INDX_EXCEED, + LLKI_STATUS_KEY_INDEX_INVALID, + LLKI_STATUS_BAD_POINTER_PAIR, + LLKI_STATUS_BAD_CORE_INDEX, + LLKI_STATUS_KL_REQ_BAD_MSG_ID, + LLKI_STATUS_KL_REQ_BAD_MSG_LEN, + LLKI_STATUS_KL_RESP_BAD_MSG_ID, + LLKI_STATUS_KL_TILELINK_ERROR : begin + llkic2_respfifo_wdata_i[7:0] <= LLKI_MID_C2ERRORRESP; + llkic2_respfifo_wdata_i[15:8] <= status; + llkic2_respfifo_wdata_i[23:16] <= 8'h01; + llkic2_respfifo_wdata_i[63:32] <= rsvd; + llkic2_respfifo_wvalid_i <= 1'b1; + end + //------------------------------------------------------------------ + // Trap state - Create an LLKI-C2 message with an unknown error + //------------------------------------------------------------------ + default : begin + llkic2_respfifo_wdata_i[7:0] <= LLKI_MID_C2ERRORRESP; + llkic2_respfifo_wdata_i[15:8] <= LLKI_STATUS_UNKNOWN_ERROR; + llkic2_respfifo_wdata_i[23:16] <= 8'h01; + llkic2_respfifo_wdata_i[63:32] <= rsvd; + llkic2_respfifo_wvalid_i <= 1'b1; + end + endcase // case (status) + + // Return to IDLE + srot_current_state <= ST_SROT_IDLE; + end // ST_SROT_ERROR_RESPONSE + //------------------------------------------------------------------ + // Trap State + //------------------------------------------------------------------ + default : begin + host_req_i <= '0; + host_addr_i <= '0; + host_we_i <= '0; + host_wdata_i <= '0; + keyindexram_b_addr_i <= '0; + keyram_b_addr_i <= '0; + llkic2_reqfifo_clr_i <= '0; + llkic2_reqfifo_rready_i <= '0; + llkic2_respfifo_wvalid_i <= '0; + llkic2_respfifo_wdata_i <= '0; + rsvd <= '0; + msg_id <= '0; + status <= '0; + msg_len <= '0; + key_index <= '0; + current_pointer <= '0; + wait_state_counter <= SROT_WAIT_STATE_COUNTER_INIT; + srot_current_state <= ST_SROT_IDLE; + end + //------------------------------------------------------------------ + endcase // endcase srot_current_state + + end // end if rst + end // end always + +endmodule // endmodule srot_wrapper diff --git a/hdl_cores/llki/tlul_err.sv b/hdl_cores/llki/tlul_err.sv new file mode 100644 index 0000000..d028524 --- /dev/null +++ b/hdl_cores/llki/tlul_err.sv @@ -0,0 +1,113 @@ +// Copyright lowRISC contributors. +// Licensed under the Apache License, Version 2.0, see LICENSE for details. +// SPDX-License-Identifier: Apache-2.0 +// +//************************************************************************ +// Copyright (C) 2020 Massachusetts Institute of Technology +// SPDX License Identifier: MIT +// +// File Name: tlul_err.sv +// Program: Common Evaluation Platform (CEP) +// Description: OpenTitan tlul_err.sv customized for the Common +// Evaluation Plafform +// Notes: Updated to support 8-byte transfers +//************************************************************************ + + + +`include "prim_assert.sv" + +module tlul_err import tlul_pkg::*; ( + input clk_i, + input rst_ni, + + input tl_h2d_t tl_i, + + output logic err_o +); + + localparam int IW = $bits(tl_i.a_source); + localparam int SZW = $bits(tl_i.a_size); + localparam int DW = $bits(tl_i.a_data); + localparam int MW = $bits(tl_i.a_mask); + localparam int SubAW = $clog2(DW/8); + + logic opcode_allowed, a_config_allowed; + + logic op_full, op_partial, op_get; + assign op_full = (tl_i.a_opcode == PutFullData); + assign op_partial = (tl_i.a_opcode == PutPartialData); + assign op_get = (tl_i.a_opcode == Get); + + // Anything that doesn't fall into the permitted category, it raises an error + assign err_o = ~(opcode_allowed & a_config_allowed); + + // opcode check + assign opcode_allowed = (tl_i.a_opcode == PutFullData) + | (tl_i.a_opcode == PutPartialData) + | (tl_i.a_opcode == Get); + + // a channel configuration check + logic addr_sz_chk; // address and size alignment check + logic mask_chk; // inactive lane a_mask check + logic fulldata_chk; // PutFullData should have size match to mask + + logic [MW-1:0] mask; + + assign mask = (1 << tl_i.a_address[SubAW-1:0]); + + always_comb begin + addr_sz_chk = 1'b0; + mask_chk = 1'b0; + fulldata_chk = 1'b0; // Only valid when opcode is PutFullData + + if (tl_i.a_valid) begin + unique case (tl_i.a_size) + 'h0: begin // 1 Byte + addr_sz_chk = 1'b1; + mask_chk = ~|(tl_i.a_mask & ~mask); + fulldata_chk = |(tl_i.a_mask & mask); + end + + 'h1: begin // 2 Byte + addr_sz_chk = ~tl_i.a_address[0]; + // check inactive lanes if lower 2B, check a_mask[3:2], if uppwer 2B, a_mask[1:0] + mask_chk = (tl_i.a_address[1]) ? ~|(tl_i.a_mask & 4'b0011) + : ~|(tl_i.a_mask & 4'b1100); + fulldata_chk = (tl_i.a_address[1]) ? &tl_i.a_mask[3:2] : &tl_i.a_mask[1:0] ; + end + + 'h2: begin // 4 Byte + addr_sz_chk = ~|tl_i.a_address[SubAW-1:0]; + mask_chk = 1'b1; + fulldata_chk = &tl_i.a_mask[3:0]; + end + + 'h3: begin // 8 Byte + addr_sz_chk = ~|tl_i.a_address[SubAW-1:0]; + mask_chk = 1'b1; + fulldata_chk = &tl_i.a_mask[7:0]; + end + + default: begin // else + addr_sz_chk = 1'b0; + mask_chk = 1'b0; + fulldata_chk = 1'b0; + end + endcase + end else begin + addr_sz_chk = 1'b0; + mask_chk = 1'b0; + fulldata_chk = 1'b0; + end + end + + assign a_config_allowed = addr_sz_chk + & mask_chk + & (op_get | op_partial | fulldata_chk) ; + + // Only 32 bit data width for current tlul_err + `ASSERT_INIT(dataWidthOnly32_A, DW == 32) + +endmodule + diff --git a/hdl_cores/llki/top_pkg.sv b/hdl_cores/llki/top_pkg.sv new file mode 100644 index 0000000..bd93bdc --- /dev/null +++ b/hdl_cores/llki/top_pkg.sv @@ -0,0 +1,42 @@ +// Copyright lowRISC contributors. +// Licensed under the Apache License, Version 2.0, see LICENSE for details. +// SPDX-License-Identifier: Apache-2.0 + +//************************************************************************ +// Copyright (C) 2020 Massachusetts Institute of Technology +// SPDX License Identifier: MIT +// +// File Name: top_pkg.sv +// Program: Common Evaluation Platform (CEP) +// Description: OpenTitan top_pkg customized for the Common +// Evaluation Plafform +// Notes: +//************************************************************************ + +package top_pkg; + +// These should match the SROTTilelinkParameters called out in cep_addresses.scala +localparam int TL_DW=64; // = TL_DBW * 8; TL_DBW must be a power-of-two +localparam int TL_AW=32; +localparam int TL_AIW=4; // a_source, d_source +localparam int TL_DIW=2; // d_sink +localparam int TL_SZW=3; + + +localparam int TL_DUW=16; // d_user (unused in the CEP) +localparam int TL_DBW=(TL_DW>>3); +//localparam int TL_SZW=$clog2($clog2(TL_DBW)+1); +localparam int FLASH_BANKS=2; +localparam int FLASH_PAGES_PER_BANK=256; +localparam int FLASH_WORDS_PER_PAGE=128; +localparam int FLASH_INFO_TYPES = 2; +localparam int FLASH_INFO_PER_BANK [FLASH_INFO_TYPES] = '{4, 4}; +localparam int FLASH_DATA_WIDTH=64; +localparam int FLASH_METADATA_WIDTH=12; +localparam int NUM_AST_ALERTS=7; +localparam int NUM_IO_RAILS=2; +localparam int ENTROPY_STREAM=4; +localparam int ADC_CHANNELS=2; +localparam int ADC_DATAW=10; + +endpackage diff --git a/licenseLog.txt b/licenseLog.txt index 8ddaff0..d69f948 100644 --- a/licenseLog.txt +++ b/licenseLog.txt @@ -166,3 +166,10 @@ License terms : // ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. Function : This core provides a standard SHA hash function, where the resulting hash value is 256 bits. It will be integrated as a HW accelerator into the SoC. +Title : opentitan +Source : https://github.com/lowRISC/opentitan +CEP Directory : ./opentitan +License Description : Apache License v2.0 +License Terms : https://github.com/lowRISC/opentitan/blob/master/LICENSE +Function : OpenTitan is the first open source project building a transparent, high-quality reference design and integration guidelines for silicon root of trust (RoT) chips. + Main website: www.opentitan.org diff --git a/unit_simulation/llki_supports/llki_discrete.sv b/unit_simulation/llki_supports/llki_discrete.sv index 95ec206..4dcc359 100644 --- a/unit_simulation/llki_supports/llki_discrete.sv +++ b/unit_simulation/llki_supports/llki_discrete.sv @@ -1,6 +1,6 @@ //************************************************************************ // Copyright (C) 2020 Massachusetts Institute of Technology -// SPDX License Identifier: MIT +// SPDX short identifier: BSD-2-Clause // // File Name: llki_discrete.sv // Program: Common Evaluation Platform (CEP) diff --git a/unit_simulation/llki_supports/llki_rom.sv b/unit_simulation/llki_supports/llki_rom.sv index b426ec5..6cb0b6b 100644 --- a/unit_simulation/llki_supports/llki_rom.sv +++ b/unit_simulation/llki_supports/llki_rom.sv @@ -1,5 +1,6 @@ //************************************************************************ // Copyright (C) 2020 Massachusetts Institute of Technology +// SPDX short identifier: BSD-2-Clause // // File Name: llki_rom.sv // Program: Common Evaluation Platform (CEP) diff --git a/unit_simulation/llki_supports/llki_struct.h b/unit_simulation/llki_supports/llki_struct.h index d8f091f..1a87f2e 100644 --- a/unit_simulation/llki_supports/llki_struct.h +++ b/unit_simulation/llki_supports/llki_struct.h @@ -1,6 +1,6 @@ //************************************************************************ // Copyright (C) 2020 Massachusetts Institute of Technology -// SPDX License Identifier: MIT +// SPDX short identifier: BSD-2-Clause // // File Name: llki_struct.h // Program: Common Evaluation Platform (CEP) diff --git a/unit_simulation/llki_supports/llki_tl.sv b/unit_simulation/llki_supports/llki_tl.sv index bbc493a..9a883a5 100644 --- a/unit_simulation/llki_supports/llki_tl.sv +++ b/unit_simulation/llki_supports/llki_tl.sv @@ -1,6 +1,6 @@ //************************************************************************ // Copyright (C) 2020 Massachusetts Institute of Technology -// SPDX License Identifier: MIT +// SPDX short identifier: BSD-2-Clause // // File Name: llki_tl.sv // Program: Common Evaluation Platform (CEP) diff --git a/unit_simulation/llki_supports/tlul_pkg.sv b/unit_simulation/llki_supports/tlul_pkg.sv index 10096db..ef94162 100644 --- a/unit_simulation/llki_supports/tlul_pkg.sv +++ b/unit_simulation/llki_supports/tlul_pkg.sv @@ -1,5 +1,6 @@ //************************************************************************ // Copyright (C) 2020 Massachusetts Institute of Technology +// SPDX short identifier: BSD-2-Clause // // File Name: tlul_pkg.sv // Program: Common Evaluation Platform (CEP)