/*
 * This file and its contents are supplied under the terms of the
 * Common Development and Distribution License ("CDDL"), version 1.0.
 * You may only use this file in accordance with the terms of version
 * 1.0 of the CDDL.
 *
 * A full copy of the text of the CDDL should have accompanied this
 * source.  A copy of the CDDL is also available via the Internet at
 * http://www.illumos.org/license/CDDL.
 */

/*
 * Copyright 2022 Oxide Computer Company
 */

#ifndef _AMDZEN_CLIENT_H
#define	_AMDZEN_CLIENT_H

/*
 * This header provides client routines to clients of the amdzen nexus driver.
 */

#include <sys/types.h>
#include <sys/amdzen/df.h>

#ifdef __cplusplus
extern "C" {
#endif

/*
 * This enumeration is used to identify a given family of Zen era processors.
 * This is derived from a family/model/stepping range. In some cases such as
 * Dali, several different chips are covered that appear to be mostly the same
 * as far as we can tell for our purposes (e.g. Raven Ridge, Picasso, etc.).
 */
typedef enum {
	ZEN_FAMILY_UNKNOWN,
	ZEN_FAMILY_NAPLES,
	ZEN_FAMILY_DHYANA,
	ZEN_FAMILY_DALI,
	ZEN_FAMILY_ROME,
	ZEN_FAMILY_RENOIR,
	ZEN_FAMILY_MATISSE,
	ZEN_FAMILY_VAN_GOGH,
	ZEN_FAMILY_MENDOCINO,
	ZEN_FAMILY_MILAN,
	ZEN_FAMILY_GENOA,
	ZEN_FAMILY_VERMEER,
	ZEN_FAMILY_REMBRANDT,
	ZEN_FAMILY_CEZANNE,
	ZEN_FAMILY_RAPHAEL
} zen_family_t;

/*
 * This struct encodes enough information to later be used to compose and
 * decompose a fabric ID and component ID. A fabric ID is broken into its node
 * and component IDs and then a node ID is further decomposed into a socket and
 * die ID.
 */
typedef struct {
	uint32_t	dfd_sock_mask;
	uint32_t	dfd_die_mask;
	uint32_t	dfd_node_mask;
	uint32_t	dfd_comp_mask;
	uint8_t		dfd_sock_shift;
	uint8_t		dfd_die_shift;
	uint8_t		dfd_node_shift;
	uint8_t		dfd_comp_shift;
} df_fabric_decomp_t;

extern zen_family_t amdzen_c_family(void);
extern uint_t amdzen_c_df_count(void);
extern df_rev_t amdzen_c_df_rev(void);
extern int amdzen_c_df_fabric_decomp(df_fabric_decomp_t *);

/*
 * SMN and DF access routines.
 */
extern int amdzen_c_smn_read32(uint_t, uint32_t, uint32_t *);
extern int amdzen_c_smn_write32(uint_t, uint32_t, uint32_t);
extern int amdzen_c_df_read32(uint_t, uint8_t, const df_reg_def_t, uint32_t *);
extern int amdzen_c_df_read64(uint_t, uint8_t, const df_reg_def_t, uint64_t *);

/*
 * The following are logical types that we can iterate over. Note, that these
 * are a combination of a DF type and subtype. This is used to smooth over the
 * differences between different DF revisions and how they indicate these types.
 */
typedef enum {
	/*
	 * Iterate over only DDR memory controllers.
	 */
	ZEN_DF_TYPE_CS_UMC,
	/*
	 * Iterate only over CPU based CCMs.
	 */
	ZEN_DF_TYPE_CCM_CPU
} zen_df_type_t;

typedef int (*amdzen_c_iter_f)(uint_t, uint32_t, uint32_t, void *);
extern int amdzen_c_df_iter(uint_t, zen_df_type_t, amdzen_c_iter_f, void *);

#ifdef __cplusplus
}
#endif

#endif /* _AMDZEN_CLIENT_H */