haiku/headers/os/device/scsi.h

/******************************************************************************
/
/	File:		scsi.h
/
/	Description:	Data structures and control calls for using the scsi driver.
/
/	Copyright 1992-98, Be Incorporated
/
*******************************************************************************/


#ifndef _SCSI_H
#define _SCSI_H

#include <SupportDefs.h>
#include <OS.h>
#include <Drivers.h>


/* scsi device types */
/*------------------------*/
#define B_SCSI_DISK		0x00
#define B_SCSI_TAPE		0x01
#define B_SCSI_PRINTER	0x02
#define B_SCSI_CPU		0x03
#define B_SCSI_WORM		0x04
#define B_SCSI_CD		0x05
#define B_SCSI_SCANNER	0x06
#define B_SCSI_OPTICAL	0x07
#define B_SCSI_JUKEBOX	0x08
#define B_SCSI_NETWORK	0x09


/* scsi device masks */
/*----------------------------------*/
#define B_SCSI_ALL_DEVICES_MASK	0xffffffff
#define B_SCSI_DISK_MASK			(1 << (B_SCSI_DISK))
#define B_SCSI_TAPE_MASK			(1 << (B_SCSI_TAPE))
#define B_SCSI_PRINTER_MASK			(1 << (B_SCSI_PRINTER))
#define B_SCSI_CPU_MASK				(1 << (B_SCSI_CPU))
#define B_SCSI_WORM_MASK			(1 << (B_SCSI_WORM))
#define B_SCSI_CD_MASK				(1 << (B_SCSI_CD))
#define B_SCSI_SCANNER_MASK			(1 << (B_SCSI_SCANNER))
#define B_SCSI_OPTICAL_MASK			(1 << (B_SCSI_OPTICAL))
#define B_SCSI_JUKEBOX_MASK			(1 << (B_SCSI_JUKEBOX))
#define B_SCSI_NETWORK_MASK			(1 << (B_SCSI_NETWORK))

/* control call codes for rescan scsi driver (/dev/scsi/rescan) */
/*-----------------------------------------------------*/
enum {
	B_SCSI_SCAN_FOR_DEVICES = B_DEVICE_OP_CODES_END + 1,
	B_SCSI_ENABLE_PROFILING
};


/* control calls for all individual scsi device drivers */
/*------------------------------------------------------*/
enum {
	B_SCSI_INQUIRY = B_DEVICE_OP_CODES_END + 100,
	B_SCSI_EJECT,
	B_SCSI_PREVENT_ALLOW,
	B_RAW_DEVICE_COMMAND
};

typedef struct {
	uchar	inquiry_data[36];	/* inquiry data (see SCSI standard) */
} scsi_inquiry;


/* control calls for scsi cd-rom driver */
/*--------------------------------------*/
enum {
	B_SCSI_GET_TOC = B_DEVICE_OP_CODES_END + 200,
	B_SCSI_PLAY_TRACK,
	B_SCSI_PLAY_POSITION,
	B_SCSI_STOP_AUDIO,
	B_SCSI_PAUSE_AUDIO,
	B_SCSI_RESUME_AUDIO,
	B_SCSI_GET_POSITION,
	B_SCSI_SET_VOLUME,
	B_SCSI_GET_VOLUME,
	B_SCSI_READ_CD,
	B_SCSI_SCAN,
	B_SCSI_DATA_MODE
};

typedef struct {
	uchar	toc_data[804];	/* table of contents data (see SCSI standard) */
} scsi_toc;

typedef struct {
	uchar	start_track;	/* starting track */
	uchar	start_index;	/* starting index */
	uchar	end_track;		/* ending track */
	uchar	end_index;		/* ending index */
} scsi_play_track;

typedef struct {
	uchar	start_m;		/* starting minute */
	uchar	start_s;		/* starting second */
	uchar	start_f;		/* starting frame */
	uchar	end_m;			/* ending minute */
	uchar	end_s;			/* ending second */
	uchar	end_f;			/* ending frame */
} scsi_play_position;

typedef struct {
	uchar	position[16];	/* position data (see SCSI standard) */
} scsi_position;

typedef struct {
	uchar	flags;			/* A 1 in any position means change that field  */
							/* with port0_channel as bit 0 and port3_volume */
							/* as bit 7. */
	uchar	port0_channel;
	uchar	port0_volume;
	uchar	port1_channel;
	uchar	port1_volume;
	uchar	port2_channel;
	uchar	port2_volume;
	uchar	port3_channel;
	uchar	port3_volume;
} scsi_volume;

#define B_SCSI_PORT0_CHANNEL	0x01
#define B_SCSI_PORT0_VOLUME		0x02
#define B_SCSI_PORT1_CHANNEL	0x04
#define B_SCSI_PORT1_VOLUME		0x08
#define B_SCSI_PORT2_CHANNEL	0x10
#define B_SCSI_PORT2_VOLUME		0x20
#define B_SCSI_PORT3_CHANNEL	0x40
#define B_SCSI_PORT3_VOLUME		0x80

typedef struct {
	uchar	start_m;		/* starting minute */
	uchar	start_s;		/* starting second */
	uchar	start_f;		/* starting frame */
	uchar	length_m;		/* transfer length minute */
	uchar	length_s;		/* transfer length second */
	uchar	length_f;		/* transfer length frame */
	long	buffer_length;	/* size of read buffer */
	char*	buffer;			/* buffer to hold requested data */
	bool	play;			/* FALSE = don't play, TRUE = play */
} scsi_read_cd;

typedef struct {
	char	speed;			/* 0 = slow - 5x, 1 = fast - 12x */
	char	direction;		/* 1 = forward, 0 = stop scan, -1 = backward */
} scsi_scan;

typedef struct {
	off_t	block;
	int32	mode;
} scsi_data_mode;

/* raw device commands */

typedef struct {
	uint8		command[16];
	uint8		command_length;
	uint8		flags;
	uint8   	scsi_status;        /* SCSI Status Byte */
									/* (0 = success, 2 = check cond, ... */
	uint8   	cam_status;         /* CAM_* status conditions from CAM.h */
	void		*data;
	size_t		data_length;
	void		*sense_data;		/* buffer to return mode sense data in */
	size_t		sense_data_length;	/* size of optional buffer for mode sense */
	bigtime_t	timeout;
} raw_device_command;

enum {
	B_RAW_DEVICE_DATA_IN          = 0x01,
	B_RAW_DEVICE_REPORT_RESIDUAL  = 0x02,
	B_RAW_DEVICE_SHORT_READ_VALID = 0x04
};

#endif