---

floppy.c File Reference

Floppy disk driver. More...

#include <const.h>
#include <arch/i386.h>
#include <arch/interrupt.h>
#include <arch/mem.h>
#include <arch/paging.h>
#include <kernel/clock.h>
#include <kernel/console.h>
#include <kernel/dma.h>
#include <kernel/task.h>
#include <kernel/floppy.h>

Go to the source code of this file.

Functions
void	fdc_sendbyte (byte b)
	Send a byte to the FDC controller. Parameters: b  The byte to send.
int	fdc_getbyte ()
	Get a byte from the FDC controller. Returns: The byte read from the controller. Exceptions: NULL  If timeout is elapsed.
void	fdc_motor_on ()
	Turn the floppy motor on.
void	fdc_motor_off ()
	Starts the FDC motor kill countdown.
bool	fdc_wait (bool sensei)
	Wait for a FDC operation. Parameters: sensei  TRUE if a "sense interrupt status" command is required; FALSE for a simple timeout wait. Returns: TRUE if the operation has successfully done; FALSE if the timeout has been elapsed.
void	fdc_recalibrate ()
	Recalibrate the floppy drive.
bool	fdc_seek (int track)
	Seek a track. Parameters: track  The track to seek. Returns: TRUE on success; FALSE if an error occurs.
void	fdc_reset ()
	Reset the floppy disk controller.
void	lba2chs (int lba, int *track, int *head, int *sector)
	Convert from a LBA (Linear Block Address) address to a CHS (Cylinder, Head, Sector) coordinates. Parameters: lba  The LBA address. track  A pointer to the track coordinate. head  A pointer to the head coordinate. sector  A pointer to the sector coordinate.
bool	fdc_rw (int block, byte *buffer, bool do_read)
	Perform a read/write operation with the floppy drive using the DMA (Direct Memory Access). Parameters: block  The LBA address of the block on the floppy. buffer  The address of the buffer in memory for the transfer operation. It must have a size of at least FDC_SECTOR_SIZE bytes. do_read  TRUE to perform a read operation (from disk to memory); FALSE to perform a write operation (from memory to disk). Returns: TRUE on success; FALSE if an error occurs.
bool	fdc_read (int block, byte *buffer, uint32_t count)
	Read some contiguous blocks from the floppy disk. Parameters: block  The starting block to read. buffer  The destination buffer in memory where the blocks will be copied. count  How many blocks to read. Returns: TRUE on success; FALSE if an error occurs.
bool	fdc_write (int block, byte *buffer, uint32_t count)
	Write some contiguous blocks to the floppy disk. Parameters: block  The starting block to write. buffer  The address in memory from which the data will be copied. count  How many blocks to write. Returns: TRUE on success; FALSE if an error occurs.
bool	fdc_is_changed ()
	Check if the floppy disk was changed. Returns: TRUE if the disk was changed; FALSE otherwise.
void	floppy_thread ()
	This is a routine called from clock_thread() at every clock tick to perform the floppy motor kill countdown and to control the floppy timeouts.
void	floppy_handler ()
	This is the floppy interrupt handler routine. It is invoked every time that a floppy operation successfully completes.
bool	init_floppy ()
	Initialize the floppy driver. Returns: TRUE on success; FALSE if an error occurs.
Variables
volatile bool	fdc_motor = FALSE
	Motor on flag.
volatile int	fdc_timeout = 0
	FDC timeout.
volatile int	fdc_motor_countdown = 0
	Floppy motor kill countdown.
volatile bool	fdc_done = FALSE
	FDC operation finish.
volatile bool	fdc_change = FALSE
	Disk change flag.
volatile byte	fdc_status [7] = { 0 }
	FDC status (result output).
volatile byte	fdc_track = 0xFF
	Current head position.
volatile byte	ST0 = 0
	Status register 0.
floppy_struct	floppy_type []
	Floppy types known from the system.
byte	fdc_geometry = 0
	Current floppy geometry.
byte *	fdc_buffer
	Floppy r/w buffer.

---

Detailed Description

Floppy disk driver.

Author:

Andrea Righi <drizzt@inwind.it>

Date:

Last update: 2003-11-08

Note:

Copyright (©) 2003 Andrea Righi

Definition in file floppy.c.

---

Function Documentation

bool fdc_is_changed (    )

Check if the floppy disk was changed. Returns: TRUE if the disk was changed; FALSE otherwise. Definition at line 411 of file floppy.c. { return(fdc_change); }

void fdc_motor_off (    )

Starts the FDC motor kill countdown. Definition at line 116 of file floppy.c. { if (fdc_motor && (fdc_motor_countdown==-1)) fdc_motor_countdown = FDC_TIME_MOTOR_OFF/1000*HZ; }

void fdc_motor_on (    )

Turn the floppy motor on. Definition at line 104 of file floppy.c. { if (!fdc_motor) { outportb(FDC_DOR, 0x1C); delay(FDC_TIME_MOTOR_SPINUP); fdc_motor = TRUE; } fdc_motor_countdown = -1; }

bool fdc_read (  int    block, byte *    buffer, uint32_t    count )

Read some contiguous blocks from the floppy disk. Parameters: block  The starting block to read. buffer  The destination buffer in memory where the blocks will be copied. count  How many blocks to read. Returns: TRUE on success; FALSE if an error occurs. Definition at line 376 of file floppy.c. { register int i; for(i=0; i<count; i++) if (!(fdc_rw(block+i, buffer+(FDC_SECTOR_SIZE*i), TRUE))) return(FALSE); // Read operation OK! // return(TRUE); }

void fdc_recalibrate (    )

Recalibrate the floppy drive. Definition at line 178 of file floppy.c. { // Turn the motor on // fdc_motor_on(); // Send recalibrate command // fdc_sendbyte(CMD_RECAL); fdc_sendbyte(0); // Wait until recalibrate command is finished // fdc_wait(TRUE); // Turn the motor off // fdc_motor_off(); }

bool fdc_seek (  int    track )

Seek a track. Parameters: track  The track to seek. Returns: TRUE on success; FALSE if an error occurs. Definition at line 199 of file floppy.c. { // If already threre return // if (fdc_track == track) return(TRUE); // Turn the motor on // fdc_motor_on(); // Send seek command // fdc_sendbyte(CMD_SEEK); fdc_sendbyte(0); fdc_sendbyte(track); // Wait until seek is finished // if (!fdc_wait(TRUE)) { // Timeout! // fdc_motor_off(); return(FALSE); } // Let the head settle for 15msec // delay(15); // Turn off the motor // fdc_motor_off(); // Check if seek worked // if ((ST0 != 0x20) || (fdc_track != track)) return(FALSE); else return(TRUE); }

bool fdc_write (  int    block, byte *    buffer, uint32_t    count )

Write some contiguous blocks to the floppy disk. Parameters: block  The starting block to write. buffer  The address in memory from which the data will be copied. count  How many blocks to write. Returns: TRUE on success; FALSE if an error occurs. Definition at line 396 of file floppy.c. { register int i; for(i=0; i<count; i++) if (!(fdc_rw(block+i, buffer+(FDC_SECTOR_SIZE*i), FALSE))) return(FALSE); // Write operation OK! // return(TRUE); }

void floppy_handler (    )

This is the floppy interrupt handler routine. It is invoked every time that a floppy operation successfully completes. Definition at line 440 of file floppy.c. { fdc_done = TRUE; }

void floppy_thread (    )

This is a routine called from clock_thread() at every clock tick to perform the floppy motor kill countdown and to control the floppy timeouts. Definition at line 422 of file floppy.c. { if (fdc_timeout > 0) fdc_timeout--; if (fdc_motor_countdown > 0) fdc_motor_countdown--; else if (fdc_motor && !fdc_motor_countdown) { outportb(FDC_DOR, 0x0C); fdc_motor = FALSE; } }

bool init_floppy (    )

Initialize the floppy driver. Returns: TRUE on success; FALSE if an error occurs. Definition at line 451 of file floppy.c. { int v; // Install the interrupt handler routine // install_irq_handler( FLOPPY_IRQ, (void *)floppy_handler ); // Create the FDC buffer // fdc_buffer = PHYSICAL( dma_phys_alloc(PAGE_SIZE) ); // Reset the controller // fdc_reset(); // Get floppy controller version // fdc_sendbyte(CMD_VERSION); v = fdc_getbyte(); switch ( v ) { case 0xFF: return( FALSE ); break; case 0x90: kprintf("\n\rEnhanced controller found!"); return( TRUE ); break; default: kprintf("\n\r8272A/765A controller found! (cmd_version=%02X)", v); return( TRUE ); break; } }

---