121 lines
		
	
	
		
			3.3 KiB
		
	
	
	
		
			C
		
	
	
	
			
		
		
	
	
			121 lines
		
	
	
		
			3.3 KiB
		
	
	
	
		
			C
		
	
	
	
/*
 | 
						|
 * (C) Copyright 2002
 | 
						|
 * Rich Ireland, Enterasys Networks, rireland@enterasys.com.
 | 
						|
 *
 | 
						|
 * SPDX-License-Identifier:	GPL-2.0+
 | 
						|
 */
 | 
						|
 | 
						|
#include <fpga.h>
 | 
						|
 | 
						|
#ifndef _ALTERA_H_
 | 
						|
#define _ALTERA_H_
 | 
						|
 | 
						|
/*
 | 
						|
 * For the StratixV FPGA programming via SPI, the following
 | 
						|
 * information is coded in the 32bit cookie:
 | 
						|
 * Bit 31 ... Bit 0
 | 
						|
 * SPI-Bus | SPI-Dev | Config-Pin | Done-Pin
 | 
						|
 */
 | 
						|
#define FPGA_COOKIE(bus, dev, config, done)			\
 | 
						|
	(((bus) << 24) | ((dev) << 16) | ((config) << 8) | (done))
 | 
						|
#define COOKIE2SPI_BUS(c)	(((c) >> 24) & 0xff)
 | 
						|
#define COOKIE2SPI_DEV(c)	(((c) >> 16) & 0xff)
 | 
						|
#define COOKIE2CONFIG(c)	(((c) >> 8) & 0xff)
 | 
						|
#define COOKIE2DONE(c)		((c) & 0xff)
 | 
						|
 | 
						|
enum altera_iface {
 | 
						|
	/* insert all new types after this */
 | 
						|
	min_altera_iface_type,
 | 
						|
	/* serial data and external clock */
 | 
						|
	passive_serial,
 | 
						|
	/* parallel data */
 | 
						|
	passive_parallel_synchronous,
 | 
						|
	/* parallel data */
 | 
						|
	passive_parallel_asynchronous,
 | 
						|
	/* serial data w/ internal clock (not used) */
 | 
						|
	passive_serial_asynchronous,
 | 
						|
	/* jtag/tap serial (not used ) */
 | 
						|
	altera_jtag_mode,
 | 
						|
	/* fast passive parallel (FPP) */
 | 
						|
	fast_passive_parallel,
 | 
						|
	/* fast passive parallel with security (FPPS) */
 | 
						|
	fast_passive_parallel_security,
 | 
						|
	/* insert all new types before this */
 | 
						|
	max_altera_iface_type,
 | 
						|
};
 | 
						|
 | 
						|
enum altera_family {
 | 
						|
	/* insert all new types after this */
 | 
						|
	min_altera_type,
 | 
						|
	/* ACEX1K Family */
 | 
						|
	Altera_ACEX1K,
 | 
						|
	/* CYCLONII Family */
 | 
						|
	Altera_CYC2,
 | 
						|
	/* StratixII Family */
 | 
						|
	Altera_StratixII,
 | 
						|
	/* StratixV Family */
 | 
						|
	Altera_StratixV,
 | 
						|
	/* SoCFPGA Family */
 | 
						|
	Altera_SoCFPGA,
 | 
						|
 | 
						|
	/* Add new models here */
 | 
						|
 | 
						|
	/* insert all new types before this */
 | 
						|
	max_altera_type,
 | 
						|
};
 | 
						|
 | 
						|
typedef struct {
 | 
						|
	/* part type */
 | 
						|
	enum altera_family	family;
 | 
						|
	/* interface type */
 | 
						|
	enum altera_iface	iface;
 | 
						|
	/* bytes of data part can accept */
 | 
						|
	size_t			size;
 | 
						|
	/* interface function table */
 | 
						|
	void			*iface_fns;
 | 
						|
	/* base interface address */
 | 
						|
	void			*base;
 | 
						|
	/* implementation specific cookie */
 | 
						|
	int			cookie;
 | 
						|
} Altera_desc;
 | 
						|
 | 
						|
/* Generic Altera Functions
 | 
						|
 *********************************************************************/
 | 
						|
extern int altera_load(Altera_desc *desc, const void *image, size_t size);
 | 
						|
extern int altera_dump(Altera_desc *desc, const void *buf, size_t bsize);
 | 
						|
extern int altera_info(Altera_desc *desc);
 | 
						|
 | 
						|
/* Board specific implementation specific function types
 | 
						|
 *********************************************************************/
 | 
						|
typedef int (*Altera_pre_fn)( int cookie );
 | 
						|
typedef int (*Altera_config_fn)( int assert_config, int flush, int cookie );
 | 
						|
typedef int (*Altera_status_fn)( int cookie );
 | 
						|
typedef int (*Altera_done_fn)( int cookie );
 | 
						|
typedef int (*Altera_clk_fn)( int assert_clk, int flush, int cookie );
 | 
						|
typedef int (*Altera_data_fn)( int assert_data, int flush, int cookie );
 | 
						|
typedef int(*Altera_write_fn)(const void *buf, size_t len, int flush, int cookie);
 | 
						|
typedef int (*Altera_abort_fn)( int cookie );
 | 
						|
typedef int (*Altera_post_fn)( int cookie );
 | 
						|
 | 
						|
typedef struct {
 | 
						|
	Altera_pre_fn pre;
 | 
						|
	Altera_config_fn config;
 | 
						|
	Altera_status_fn status;
 | 
						|
	Altera_done_fn done;
 | 
						|
	Altera_clk_fn clk;
 | 
						|
	Altera_data_fn data;
 | 
						|
	Altera_write_fn write;
 | 
						|
	Altera_abort_fn abort;
 | 
						|
	Altera_post_fn post;
 | 
						|
} altera_board_specific_func;
 | 
						|
 | 
						|
#ifdef CONFIG_FPGA_SOCFPGA
 | 
						|
int socfpga_load(Altera_desc *desc, const void *rbf_data, size_t rbf_size);
 | 
						|
#endif
 | 
						|
 | 
						|
#ifdef CONFIG_FPGA_STRATIX_V
 | 
						|
int stratixv_load(Altera_desc *desc, const void *rbf_data, size_t rbf_size);
 | 
						|
#endif
 | 
						|
 | 
						|
#endif /* _ALTERA_H_ */
 |