xref: /arm-trusted-firmware/plat/intel/soc/common/drivers/ddr/ddr.h (revision 91f16700b400a8c0651d24a598fc48ee2997a0d7)

/*
 * Copyright (c) 2022-2023, Intel Corporation. All rights reserved.
 *
 * SPDX-License-Identifier: BSD-3-Clause
 */

#ifndef DDR_H
#define DDR_H

#include <lib/mmio.h>
#include "socfpga_handoff.h"

/* MACRO DEFINATION */
#define IO96B_0_REG_BASE				0x18400000
#define IO96B_1_REG_BASE				0x18800000
#define IO96B_CSR_BASE					0x05000000
#define IO96B_CSR_REG(reg)				(IO96B_CSR_BASE + reg)

#define IOSSM_CMD_MAX_WORD_SIZE				7U
#define IOSSM_RESP_MAX_WORD_SIZE			4U

#define CCU_REG_BASE					0x1C000000
#define DMI0_DMIUSMCTCR					0x7300
#define DMI1_DMIUSMCTCR					0x8300
#define CCU_DMI_ALLOCEN					BIT(1)
#define CCU_DMI_LOOKUPEN				BIT(2)
#define CCU_REG(reg)					(CCU_REG_BASE + reg)

// CMD_RESPONSE_STATUS Register
#define CMD_RESPONSE_STATUS				0x45C
#define CMD_RESPONSE_OFFSET				0x4
#define CMD_RESPONSE_DATA_SHORT_MASK			GENMASK(31, 16)
#define CMD_RESPONSE_DATA_SHORT_OFFSET			16
#define STATUS_CMD_RESPONSE_ERROR_MASK			GENMASK(7, 5)
#define STATUS_CMD_RESPONSE_ERROR_OFFSET		5
#define STATUS_GENERAL_ERROR_MASK			GENMASK(4, 1)
#define STATUS_GENERAL_ERROR_OFFSET			1
#define STATUS_COMMAND_RESPONSE_READY			0x1
#define STATUS_COMMAND_RESPONSE_READY_CLEAR		0x0
#define STATUS_COMMAND_RESPONSE_READY_MASK		0x1
#define STATUS_COMMAND_RESPONSE_READY_OFFSET		0
#define STATUS_COMMAND_RESPONSE(x)			(((x) & \
							STATUS_COMMAND_RESPONSE_READY_MASK) >> \
							STATUS_COMMAND_RESPONSE_READY_OFFSET)

// CMD_REQ Register
#define CMD_STATUS					0x400
#define CMD_PARAM					0x438
#define CMD_REQ						0x43C
#define CMD_PARAM_OFFSET				0x4
#define CMD_TARGET_IP_TYPE_MASK				GENMASK(31, 29)
#define CMD_TARGET_IP_TYPE_OFFSET			29
#define CMD_TARGET_IP_INSTANCE_ID_MASK			GENMASK(28, 24)
#define CMD_TARGET_IP_INSTANCE_ID_OFFSET		24
#define CMD_TYPE_MASK					GENMASK(23, 16)
#define CMD_TYPE_OFFSET					16
#define CMD_OPCODE_MASK					GENMASK(15, 0)
#define CMD_OPCODE_OFFSET				0

#define CMD_INIT					0

#define OPCODE_GET_MEM_INTF_INFO			0x0001
#define OPCODE_GET_MEM_TECHNOLOGY			0x0002
#define OPCODE_GET_MEM_WIDTH_INFO			0x0004
#define OPCODE_TRIG_MEM_CAL				0x000A
#define OPCODE_ECC_ENABLE_STATUS			0x0102
#define OPCODE_ECC_INTERRUPT_MASK			0x0105
#define OPCODE_ECC_SCRUB_MODE_0_START			0x0202
#define OPCODE_ECC_SCRUB_MODE_1_START			0x0203
#define OPCODE_BIST_RESULTS_STATUS			0x0302
#define OPCODE_BIST_MEM_INIT_START			0x0303
// Please update according to IOSSM mailbox spec
#define MBOX_ID_IOSSM					0x00
#define MBOX_CMD_GET_SYS_INFO				0x01
// Please update according to IOSSM mailbox spec
#define MBOX_CMD_GET_MEM_INFO				0x02
#define MBOX_CMD_TRIG_CONTROLLER_OP			0x04
#define MBOX_CMD_TRIG_MEM_CAL_OP			0x05
#define MBOX_CMD_POKE_REG				0xFD
#define MBOX_CMD_PEEK_REG				0xFE
#define MBOX_CMD_GET_DEBUG_LOG				0xFF
// Please update according to IOSSM mailbox spec
#define MBOX_CMD_DIRECT					0x00

#define SOCFPGA_SYSMGR_BOOT_SCRATCH_POR_0_MASK		0x01

#define IOSSM_MB_WRITE(addr, data)			mmio_write_32(addr, data)

/* FUNCTION DEFINATION */
int ddr_calibration_check(void);

int iossm_mb_init(void);

int iossm_mb_read_response(void);

int iossm_mb_send(uint32_t cmd_target_ip_type, uint32_t cmd_target_ip_instance_id,
			uint32_t cmd_type, uint32_t cmd_opcode, uint32_t *args,
			unsigned int len);

int ddr_iossm_mailbox_cmd(uint32_t cmd);

int ddr_init(void);

int ddr_config_handoff(handoff *hoff_ptr);

void ddr_enable_ns_access(void);

void ddr_enable_firewall(void);

bool is_ddr_init_in_progress(void);

#endif