| /* SPDX-License-Identifier: BSD-3-Clause */ |
| /* |
| * Copyright Altera Corporation (C) 2012-2015 |
| */ |
| |
| #ifndef _SEQUENCER_H_ |
| #define _SEQUENCER_H_ |
| |
| #define RW_MGR_NUM_DM_PER_WRITE_GROUP (seq->rwcfg->mem_data_mask_width \ |
| / seq->rwcfg->mem_if_write_dqs_width) |
| #define RW_MGR_NUM_TRUE_DM_PER_WRITE_GROUP ( \ |
| seq->rwcfg->true_mem_data_mask_width \ |
| / seq->rwcfg->mem_if_write_dqs_width) |
| |
| #define RW_MGR_NUM_DQS_PER_WRITE_GROUP (seq->rwcfg->mem_if_read_dqs_width \ |
| / seq->rwcfg->mem_if_write_dqs_width) |
| #define NUM_RANKS_PER_SHADOW_REG (seq->rwcfg->mem_number_of_ranks \ |
| / NUM_SHADOW_REGS) |
| |
| #define RW_MGR_RUN_SINGLE_GROUP_OFFSET 0x0 |
| #define RW_MGR_RUN_ALL_GROUPS_OFFSET 0x0400 |
| #define RW_MGR_RESET_READ_DATAPATH_OFFSET 0x1000 |
| #define RW_MGR_SET_CS_AND_ODT_MASK_OFFSET 0x1400 |
| #define RW_MGR_INST_ROM_WRITE_OFFSET 0x1800 |
| #define RW_MGR_AC_ROM_WRITE_OFFSET 0x1C00 |
| |
| #define NUM_SHADOW_REGS 1 |
| |
| #define RW_MGR_RANK_NONE 0xFF |
| #define RW_MGR_RANK_ALL 0x00 |
| |
| #define RW_MGR_ODT_MODE_OFF 0 |
| #define RW_MGR_ODT_MODE_READ_WRITE 1 |
| |
| #define NUM_CALIB_REPEAT 1 |
| |
| #define NUM_READ_TESTS 7 |
| #define NUM_READ_PB_TESTS 7 |
| #define NUM_WRITE_TESTS 15 |
| #define NUM_WRITE_PB_TESTS 31 |
| |
| #define PASS_ALL_BITS 1 |
| #define PASS_ONE_BIT 0 |
| |
| /* calibration stages */ |
| #define CAL_STAGE_NIL 0 |
| #define CAL_STAGE_VFIFO 1 |
| #define CAL_STAGE_WLEVEL 2 |
| #define CAL_STAGE_LFIFO 3 |
| #define CAL_STAGE_WRITES 4 |
| #define CAL_STAGE_FULLTEST 5 |
| #define CAL_STAGE_REFRESH 6 |
| #define CAL_STAGE_CAL_SKIPPED 7 |
| #define CAL_STAGE_CAL_ABORTED 8 |
| #define CAL_STAGE_VFIFO_AFTER_WRITES 9 |
| |
| /* calibration substages */ |
| #define CAL_SUBSTAGE_NIL 0 |
| #define CAL_SUBSTAGE_GUARANTEED_READ 1 |
| #define CAL_SUBSTAGE_DQS_EN_PHASE 2 |
| #define CAL_SUBSTAGE_VFIFO_CENTER 3 |
| #define CAL_SUBSTAGE_WORKING_DELAY 1 |
| #define CAL_SUBSTAGE_LAST_WORKING_DELAY 2 |
| #define CAL_SUBSTAGE_WLEVEL_COPY 3 |
| #define CAL_SUBSTAGE_WRITES_CENTER 1 |
| #define CAL_SUBSTAGE_READ_LATENCY 1 |
| #define CAL_SUBSTAGE_REFRESH 1 |
| |
| #define SCC_MGR_GROUP_COUNTER_OFFSET 0x0000 |
| #define SCC_MGR_DQS_IN_DELAY_OFFSET 0x0100 |
| #define SCC_MGR_DQS_EN_PHASE_OFFSET 0x0200 |
| #define SCC_MGR_DQS_EN_DELAY_OFFSET 0x0300 |
| #define SCC_MGR_DQDQS_OUT_PHASE_OFFSET 0x0400 |
| #define SCC_MGR_OCT_OUT1_DELAY_OFFSET 0x0500 |
| #define SCC_MGR_IO_OUT1_DELAY_OFFSET 0x0700 |
| #define SCC_MGR_IO_IN_DELAY_OFFSET 0x0900 |
| |
| /* HHP-HPS-specific versions of some commands */ |
| #define SCC_MGR_DQS_EN_DELAY_GATE_OFFSET 0x0600 |
| #define SCC_MGR_IO_OE_DELAY_OFFSET 0x0800 |
| #define SCC_MGR_HHP_GLOBALS_OFFSET 0x0A00 |
| #define SCC_MGR_HHP_RFILE_OFFSET 0x0B00 |
| #define SCC_MGR_AFI_CAL_INIT_OFFSET 0x0D00 |
| |
| #define SDR_PHYGRP_SCCGRP_ADDRESS (SOCFPGA_SDR_ADDRESS | 0x0) |
| #define SDR_PHYGRP_PHYMGRGRP_ADDRESS (SOCFPGA_SDR_ADDRESS | 0x1000) |
| #define SDR_PHYGRP_RWMGRGRP_ADDRESS (SOCFPGA_SDR_ADDRESS | 0x2000) |
| #define SDR_PHYGRP_DATAMGRGRP_ADDRESS (SOCFPGA_SDR_ADDRESS | 0x4000) |
| #define SDR_PHYGRP_REGFILEGRP_ADDRESS (SOCFPGA_SDR_ADDRESS | 0x4800) |
| |
| #define PHY_MGR_CAL_RESET (0) |
| #define PHY_MGR_CAL_SUCCESS (1) |
| #define PHY_MGR_CAL_FAIL (2) |
| |
| #define CALIB_SKIP_DELAY_LOOPS (1 << 0) |
| #define CALIB_SKIP_ALL_BITS_CHK (1 << 1) |
| #define CALIB_SKIP_DELAY_SWEEPS (1 << 2) |
| #define CALIB_SKIP_VFIFO (1 << 3) |
| #define CALIB_SKIP_LFIFO (1 << 4) |
| #define CALIB_SKIP_WLEVEL (1 << 5) |
| #define CALIB_SKIP_WRITES (1 << 6) |
| #define CALIB_SKIP_FULL_TEST (1 << 7) |
| #define CALIB_SKIP_ALL (CALIB_SKIP_VFIFO | \ |
| CALIB_SKIP_LFIFO | CALIB_SKIP_WLEVEL | \ |
| CALIB_SKIP_WRITES | CALIB_SKIP_FULL_TEST) |
| #define CALIB_IN_RTL_SIM (1 << 8) |
| |
| /* Scan chain manager command addresses */ |
| #define READ_SCC_OCT_OUT2_DELAY 0 |
| #define READ_SCC_DQ_OUT2_DELAY 0 |
| #define READ_SCC_DQS_IO_OUT2_DELAY 0 |
| #define READ_SCC_DM_IO_OUT2_DELAY 0 |
| |
| /* HHP-HPS-specific values */ |
| #define SCC_MGR_HHP_EXTRAS_OFFSET 0 |
| #define SCC_MGR_HHP_DQSE_MAP_OFFSET 1 |
| |
| /* PHY Debug mode flag constants */ |
| #define PHY_DEBUG_IN_DEBUG_MODE 0x00000001 |
| #define PHY_DEBUG_ENABLE_CAL_RPT 0x00000002 |
| #define PHY_DEBUG_ENABLE_MARGIN_RPT 0x00000004 |
| #define PHY_DEBUG_SWEEP_ALL_GROUPS 0x00000008 |
| #define PHY_DEBUG_DISABLE_GUARANTEED_READ 0x00000010 |
| #define PHY_DEBUG_ENABLE_NON_DESTRUCTIVE_CALIBRATION 0x00000020 |
| |
| struct socfpga_sdr_rw_load_manager { |
| u32 load_cntr0; |
| u32 load_cntr1; |
| u32 load_cntr2; |
| u32 load_cntr3; |
| }; |
| |
| struct socfpga_sdr_rw_load_jump_manager { |
| u32 load_jump_add0; |
| u32 load_jump_add1; |
| u32 load_jump_add2; |
| u32 load_jump_add3; |
| }; |
| |
| struct socfpga_sdr_reg_file { |
| u32 signature; |
| u32 debug_data_addr; |
| u32 cur_stage; |
| u32 fom; |
| u32 failing_stage; |
| u32 debug1; |
| u32 debug2; |
| u32 dtaps_per_ptap; |
| u32 trk_sample_count; |
| u32 trk_longidle; |
| u32 delays; |
| u32 trk_rw_mgr_addr; |
| u32 trk_read_dqs_width; |
| u32 trk_rfsh; |
| }; |
| |
| /* parameter variable holder */ |
| struct param_type { |
| u32 read_correct_mask; |
| u32 read_correct_mask_vg; |
| u32 write_correct_mask; |
| u32 write_correct_mask_vg; |
| }; |
| |
| |
| /* global variable holder */ |
| struct gbl_type { |
| uint32_t phy_debug_mode_flags; |
| |
| /* current read latency */ |
| |
| uint32_t curr_read_lat; |
| |
| /* error code */ |
| |
| uint32_t error_substage; |
| uint32_t error_stage; |
| uint32_t error_group; |
| |
| /* figure-of-merit in, figure-of-merit out */ |
| |
| uint32_t fom_in; |
| uint32_t fom_out; |
| |
| /*USER Number of RW Mgr NOP cycles between |
| write command and write data */ |
| uint32_t rw_wl_nop_cycles; |
| }; |
| |
| struct socfpga_sdr_scc_mgr { |
| u32 dqs_ena; |
| u32 dqs_io_ena; |
| u32 dq_ena; |
| u32 dm_ena; |
| u32 __padding1[4]; |
| u32 update; |
| u32 __padding2[7]; |
| u32 active_rank; |
| }; |
| |
| /* PHY manager configuration registers. */ |
| struct socfpga_phy_mgr_cfg { |
| u32 phy_rlat; |
| u32 reset_mem_stbl; |
| u32 mux_sel; |
| u32 cal_status; |
| u32 cal_debug_info; |
| u32 vfifo_rd_en_ovrd; |
| u32 afi_wlat; |
| u32 afi_rlat; |
| }; |
| |
| /* PHY manager command addresses. */ |
| struct socfpga_phy_mgr_cmd { |
| u32 inc_vfifo_fr; |
| u32 inc_vfifo_hard_phy; |
| u32 fifo_reset; |
| u32 inc_vfifo_fr_hr; |
| u32 inc_vfifo_qr; |
| }; |
| |
| struct socfpga_data_mgr { |
| u32 __padding1; |
| u32 t_wl_add; |
| u32 mem_t_add; |
| u32 t_rl_add; |
| }; |
| |
| /* This struct describes the controller @ SOCFPGA_SDR_ADDRESS */ |
| struct socfpga_sdr { |
| /* SDR_PHYGRP_SCCGRP_ADDRESS */ |
| u8 _align1[0xe00]; |
| /* SDR_PHYGRP_SCCGRP_ADDRESS | 0xe00 */ |
| struct socfpga_sdr_scc_mgr sdr_scc_mgr; |
| u8 _align2[0x1bc]; |
| /* SDR_PHYGRP_PHYMGRGRP_ADDRESS */ |
| struct socfpga_phy_mgr_cmd phy_mgr_cmd; |
| u8 _align3[0x2c]; |
| /* SDR_PHYGRP_PHYMGRGRP_ADDRESS | 0x40 */ |
| struct socfpga_phy_mgr_cfg phy_mgr_cfg; |
| u8 _align4[0xfa0]; |
| /* SDR_PHYGRP_RWMGRGRP_ADDRESS */ |
| u8 rwmgr_grp[0x800]; |
| /* SDR_PHYGRP_RWMGRGRP_ADDRESS | 0x800 */ |
| struct socfpga_sdr_rw_load_manager sdr_rw_load_mgr_regs; |
| u8 _align5[0x3f0]; |
| /* SDR_PHYGRP_RWMGRGRP_ADDRESS | 0xC00 */ |
| struct socfpga_sdr_rw_load_jump_manager sdr_rw_load_jump_mgr_regs; |
| u8 _align6[0x13f0]; |
| /* SDR_PHYGRP_DATAMGRGRP_ADDRESS */ |
| struct socfpga_data_mgr data_mgr; |
| u8 _align7[0x7f0]; |
| /* SDR_PHYGRP_REGFILEGRP_ADDRESS */ |
| struct socfpga_sdr_reg_file sdr_reg_file; |
| u8 _align8[0x7c8]; |
| /* SDR_CTRLGRP_ADDRESS */ |
| struct socfpga_sdr_ctrl sdr_ctrl; |
| u8 _align9[0xea4]; |
| }; |
| |
| struct socfpga_sdrseq { |
| const struct socfpga_sdram_rw_mgr_config *rwcfg; |
| const struct socfpga_sdram_io_config *iocfg; |
| const struct socfpga_sdram_misc_config *misccfg; |
| /* calibration steps requested by the rtl */ |
| u16 dyn_calib_steps; |
| /* |
| * To make CALIB_SKIP_DELAY_LOOPS a dynamic conditional option |
| * instead of static, we use boolean logic to select between |
| * non-skip and skip values |
| * |
| * The mask is set to include all bits when not-skipping, but is |
| * zero when skipping |
| */ |
| |
| u16 skip_delay_mask; /* mask off bits when skipping/not-skipping */ |
| struct gbl_type gbl; |
| struct param_type param; |
| }; |
| |
| int sdram_calibration_full(struct socfpga_sdr *sdr); |
| |
| #endif /* _SEQUENCER_H_ */ |