/* Copyright (C) Charles Forsyth
 * See /doc/license/NOTICE.Plan9-9k.txt for details about the licensing.
 */
/* Portions of this file are Copyright (C) 9front's team.
 * See /doc/license/9front-mit for details about the licensing.
 * See http://code.9front.org/hg/plan9front/ for a list of authors.
 */
#pragma	lib	"libfis.a"
#pragma	src	"/sys/src/libfis"

/* ata errors */
enum {
	Emed	= 1<<0,		/* media error */
	Enm	= 1<<1,		/* no media */
	Eabrt	= 1<<2,		/* abort */
	Emcr	= 1<<3,		/* media change request */
	Eidnf	= 1<<4,		/* no user-accessible address */
	Emc	= 1<<5,		/* media change */
	Eunc	= 1<<6,		/* data error */
	Ewp	= 1<<6,		/* write protect */
	Eicrc	= 1<<7,		/* interface crc error */

	Efatal	= Eidnf|Eicrc,	/* must sw reset */
};

/* ata status */
enum {
	ASerr	= 1<<0,		/* error */
	ASdrq	= 1<<3,		/* request */
	ASdf	= 1<<5,		/* fault */
	ASdrdy	= 1<<6,		/* ready */
	ASbsy	= 1<<7,		/* busy */

	ASobs	= 1<<1|1<<2|1<<4,
};

enum {
	/* fis types */
	H2dev		= 0x27,
	D2host		= 0x34,

	/* fis flags bits */
	Fiscmd		= 0x80,

	/* ata bits */
	Ataobs		= 0xa0,
	Atalba		= 0x40,

	/* nominal fis size (fits any fis) */
	Fissize		= 0x20,
};

/* sata device-to-host (0x27) fis layout */
enum {
	Ftype,
	Fflags,
	Fcmd,
	Ffeat,
	Flba0,
	Flba8,
	Flba16,
	Fdev,
	Flba24,
	Flba32,
	Flba40,
	Ffeat8,
	Fsc,
	Fsc8,
	Ficc,		/* isochronous cmd completion */
	Fcontrol,
};

/* sata host-to-device fis (0x34) differences */
enum{
	Fioport	= 1,
	Fstatus,
	Frerror,
};

/* ata protcol type */
enum{
	Pnd	= 0<<0,	/* data direction */
	Pin	= 1<<0,
	Pout	= 2<<0,
	Pdatam	= 3<<0,

	Ppio	= 1<<2,	/* ata protocol */
	Pdma	= 2<<2,
	Pdmq	= 3<<2,
	Preset	= 4<<2,
	Pdiag	= 5<<2,
	Ppkt	= 6<<2,
	Pprotom	= 7<<2,

	P48	= 0<<5,	/* command “size” */
	P28	= 1<<5,
	Pcmdszm	= 1<<5,

	Pssn	= 0<<6,	/* sector size */
	P512	= 1<<6,
	Pssm	= 1<<6,
};

typedef struct Sfis Sfis;
struct Sfis {
	uint16_t	feat;
	uint8_t	udma;
	uint8_t	speeds;
	uint32_t	sig;
	uint32_t	lsectsz;
	uint32_t	physshift;	/* log2(log/phys) */
	uint32_t	c;		/* disgusting, no? */
	uint32_t	h;
	uint32_t	s;
};

enum {
	Dlba	= 1<<0,	/* required for sata */
	Dllba 	= 1<<1,
	Dsmart	= 1<<2,
	Dpower	= 1<<3,
	Dnop	= 1<<4,
	Datapi	= 1<<5,
	Datapi16= 1<<6,
	Data8	= 1<<7,
	Dsct	= 1<<8,
	Dnflag	= 9,
};

enum {
	Pspinup	= 1<<0,
	Pidready	= 1<<1,
};

void	setfissig(Sfis*, uint32_t);
int	txmodefis(Sfis*, uint8_t*, uint8_t);
int	atapirwfis(Sfis*, uint8_t*, uint8_t*, int, int);
int	featfis(Sfis*, uint8_t*, uint8_t);
int	flushcachefis(Sfis*, uint8_t*);
int	identifyfis(Sfis*, uint8_t*);
int	nopfis(Sfis*, uint8_t*, int);
int	rwfis(Sfis*, uint8_t*, int, int, uint64_t);
void	skelfis(uint8_t*);
void	sigtofis(Sfis*, uint8_t*);
uint64_t	fisrw(Sfis*, uint8_t*, int*);

void	idmove(char*, uint16_t*, int);
int64_t	idfeat(Sfis*, uint16_t*);
uint64_t	idwwn(Sfis*, uint16_t*);
int	idss(Sfis*, uint16_t*);
int	idpuis(uint16_t*);
uint16_t	id16(uint16_t*, int);
uint32_t	id32(uint16_t*, int);
uint64_t	id64(uint16_t*, int);
char	*pflag(char*, char*, Sfis*);
uint32_t	fistosig(uint8_t*);

/* scsi */
typedef struct Cfis Cfis;
struct Cfis {
	uint8_t	phyid;
	uint8_t	encid[8];
	uint8_t	tsasaddr[8];
	uint8_t	ssasaddr[8];
	uint8_t	ict[2];
};

void	smpskelframe(Cfis*, uint8_t*, int);
uint32_t	sashash(uint64_t);
uint8_t	*sasbhash(uint8_t*, uint8_t*);