man pages section 7: Device and Network Interfaces

fdio(7I)

Name | Synopsis | Description | ioctls | See Also

Name

fdio– floppy disk control operations

Synopsis

#include <sys/fdio.h>

Description

The Solaris floppy driver supports a set of ioctl(2) requests for getting and setting the floppy drive characteristics. Basic to these ioctl( ) requests are the definitions in <sys/fdio.h>.

ioctls

The following ioctl( ) requests are available on the Solaris floppy driver.

FDDEFGEOCHAR: x86 based systems: This ioctl( ) forces the floppy driver to restore the diskette and drive characteristics and geometry, and partition information to default values based on the device configuration.
FDGETCHANGE: The argument is a pointer to an int. This ioctl( ) returns the status of the diskette-changed signal from the floppy interface. The following defines are provided for cohesion.

Note: For x86 based systems, use FDGC_DETECTED (which is available only on x86 based systems) instead of FDGC_HISTORY.

/*
 * Used by FDGETCHANGE, returned state of the sense disk change bit.
 */
#define FDGC_HISTORY  0x01	 /* disk has changed since insertion or 
                                  last FDGETCHANGE call */
#define FDGC_CURRENT  0x02	 /* if set, indicates drive has floppy,
>                                 otherwise, drive is empty */
#define FDGC_CURWPROT 0x10	 /* current state of write protect */
#define FDGC_DETECTED 0x20	 /* previous state of DISK CHANGE */

FDIOGCHAR

The argument is a pointer to an fd_char structure (described below). This ioctl( ) gets the characteristics of the floppy diskette from the floppy controller.

FDIOSCHAR

The argument is a pointer to an fd_char structure (described below). This ioctl( ) sets the characteristics of the floppy diskette for the floppy controller. Typical values in the fd_char structure for a high density diskette:

field value
fdc_medium	0
fdc_transfer_rate	500
fdc_ncyl	80
fdc_nhead	2
fdc_sec_size	512
fdc_secptrack	18
fdc_steps	-1	{ This field doesn't apply. }

/*
 * Floppy characteristics
 */
struct fd_char {
 uchar_t fdc_medium;     /* equals 1 if floppy is medium density format */
 int fdc_transfer_rate;  /* transfer rate */
 int fdc_ncyl;           /* number of cylinders */
 int fdc_nhead;          /* number of heads */
 int fdc_sec_size;       /* sector size */
 int fdc_secptrack;      /* sectors per track */
 int fdc_steps;          /* no. of steps per data track */
};

FDGETDRIVECHAR: The argument to this ioctl( ) is a pointer to an fd_drive structure (described below). This ioctl( ) gets the characteristics of the floppy drive from the floppy controller.
FDSETDRIVECHAR: x86 based systems: The argument to this ioctl( ) is a pointer to an fd_drive structure (described below). This ioctl( ) sets the characteristics of the floppy drive for the floppy controller. Only fdd_steprate, fdd_headsettle, fdd_motoron, and fdd_motoroff are actually used by the floppy disk driver.

/*
 * Floppy Drive characteristics
 */
struct fd_drive {
	int	fdd_ejectable;    /* does the drive support eject? */
	int	fdd_maxsearch;    /* size of per-unit search table */
	int	fdd_writeprecomp; /* cyl to start write precompensation */
	int	fdd_writereduce;  /* cyl to start recucing write current */
	int	fdd_stepwidth;    /* width of step pulse in 1 us units */
	int	fdd_steprate;     /* step rate in 100 us units */
	int	fdd_headsettle;   /* delay, in 100 us units */
	int	fdd_headload;     /* delay, in 100 us units */
	int	fdd_headunload;   /* delay, in 100 us units */
	int	fdd_motoron;      /* delay, in 100 ms units */
	int	fdd_motoroff;     /* delay, in 100 ms units */
	int	fdd_precomplevel; /* bit shift, in nano-secs */
	int	fdd_pins;         /* defines meaning of pin 1, 2, 4 and 34 */
	int	fdd_flags;        /* TRUE READY, Starting Sector #, & Motor On */
};

FDGETSEARCH: Not available.
FDSETSEARCH: Not available.
FDEJECT: SPARC: This ioctl( ) requests the floppy drive to eject the diskette.
FDIOCMD: The argument is a pointer to an fd_cmd structure (described below). This ioctl( ) allows access to the floppy diskette using the floppy device driver. Only the FDCMD_WRITE, FDCMD_READ, and FDCMD_FORMAT_TRACK commands are currently available.

struct fd_cmd {
	ushort_t fdc_cmd;      /* command to be executed */
	int      fdc_flags;    /* execution flags (x86 only) */
	daddr_t  fdc_blkno;    /* disk address for command */
	int      fdc_secnt;    /* sector count for command */
	caddr_t  fdc_bufaddr;  /* user's buffer address */
	uint_t   fdc_buflen;   /* size of user's buffer */
};

Please note that the fdc_buflen field is currently unused. The fdc_secnt field is used to calculate the transfer size, and the buffer is assumed to be large enough to accommodate the transfer.

{
/* 
* Floppy commands
 */
#define	FDCMD_WRITE	1
#define	FDCMD_READ	2
#define	FDCMD_SEEK	3
#define	FDCMD_REZERO	4
#define	FDCMD_FORMAT_UNIT	5
#define	FDCMD_FORMAT_TRACK	6
};

FDRAW: The argument is a pointer to an fd_raw structure (described below). This ioctl( ) allows direct control of the floppy drive using the floppy controller. Refer to the appropriate floppy-controller data sheet for full details on required command bytes and returned result bytes. The following commands are supported.

/*
* Floppy raw commands
*/
#define FDRAW_SPECIFY	0x03
#define FDRAW_READID	0x0a	(x86 only)
#define FDRAW_SENSE_DRV	0x04
#define FDRAW_REZERO	0x07
#define FDRAW_SEEK	0x0f
#define FDRAW_SENSE_INT	0x08	(x86 only)
#define FDRAW_FORMAT	0x0d
#define FDRAW_READTRACK	0x02
#define FDRAW_WRCMD	0x05
#define FDRAW_RDCMD	0x06
#define FDRAW_WRITEDEL	0x09
#define FDRAW_READDEL   0x0c

Please note that when using FDRAW_SEEK or FDRAW_REZERO, the driver automatically issues a FDRAW_SENSE_INT command to clear the interrupt from the FDRAW_SEEK or the FDRAW_REZERO. The result bytes returned by these commands are the results from the FDRAW_SENSE_INT command. Please see the floppy-controller data sheet for more details on FDRAW_SENSE_INT.

/*
 * Used by FDRAW
 */
struct    fd_raw {
 char     fdr_cmd[10];     /* user-supplied command bytes */
 short    fdr_cnum;        /* number of command bytes */
 char     fdr_result[10];  /* controller-supplied result bytes */
 ushort_t fdr_nbytes;      /* number to transfer if read/write command */
 char     *fdr_addr;       /* where to transfer if read/write command */
};