Subversion Repositories shark

Rev

Rev 3 | Rev 1618 | Go to most recent revision | Blame | Compare with Previous | Last modification | View Log | RSS feed

/*
 * Project: S.Ha.R.K.
 *
 * Coordinators:
 *   Giorgio Buttazzo    <giorgio@sssup.it>
 *   Paolo Gai           <pj@gandalf.sssup.it>
 *
 * Authors     :
 *   Paolo Gai           <pj@gandalf.sssup.it>
 *   Massimiliano Giorgi <massy@gandalf.sssup.it>
 *   Luca Abeni          <luca@gandalf.sssup.it>
 *   (see the web pages for full authors list)
 *
 * ReTiS Lab (Scuola Superiore S.Anna - Pisa - Italy)
 *
 * http://www.sssup.it
 * http://retis.sssup.it
 * http://shark.sssup.it
 */



/***************************************

  CVS :        $Id: ide.h,v 1.2 2003-03-13 13:43:13 pj Exp $
 
  Revision:    $Revision: 1.2 $

  Last update: $Date: 2003-03-13 13:43:13 $

  Header file for all the modules of the IDE block device interface
  sub-system.

***************************************/


/*
 * Copyright (C) 1999,2000 Massimiliano Giorgi
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 *
 */


#ifndef __IDE_H__
#define __IDE_H__

#include "glue.h"
#include "bdev.h"
#include "bqueue.h"
#include "ll/sys/cdefs.h"

__BEGIN_DECLS

/*+ max number of ide interface (must be <= 8) +*/
#define MAXIDEINTERFACES 4

/*---*/

/*
 * CONSTANTS
 */


/*+ max number of "minor number" required +*/
#define MAXIDEMINOR (MAXIDEINTERFACES<<5)

/*+ max number of "logical partition" per hard disk +*/
#define MAXIDELODSK 16

/*+ number of physical region descriptors used by DMA bus master operations +*/
#define MAXPRDENTRIES 4

/*+ for a master hard disk +*/
#define IDE_MASTER 0x00
/*+ for a slave hard disk +*/
#define IDE_SLAVE  0x01

/*+ sector size in bytes +*/
#define IDE_SECTOR_SIZE 512

/*+ Log Level for errors +*/
#define IDEERRLOG   KERN_ERR
/*+ Log Level for log +*/
#define IDELOG      KERN_NOTICE
/*+ Log Level for debug purpose +*/
#define IDEDEBUGLOG KERN_DEBUG

/*
 * for result
 */


/*+
  This values are returned by the low level routine to indicate
  an error.
  +latex+ \\

  No error +*/

#define IDE_OK                0
/*+ there are too much request pending +*/
#define IDE_ERR_TOOMUCHREQ   -1
/*+ the interface is busy or can not do a command+*/
#define IDE_ERR_BUSY         -2
/*+ the following codes are from the IDE error register +*/
#define IDE_ERR_BADBLOCK     -3
#define IDE_ERR_CRCECC       -4
#define IDE_ERR_IDNOTFOUND   -5
#define IDE_ERR_ABORTCMD     -6
#define IDE_ERR_TRACK00      -7
#define IDE_ERR_DAMNOTFOUND  -8
/*+ generic error (when there are not other IDE_ERR_?? available) +*/
#define IDE_ERR_UNKNOWN      -9
/*+ there was an interrupt, we aspect data but there is not data +*/
#define IDE_ERR_NODATA      -10
/*+ there was an interrupt, we do not aspect data but there is data +*/
#define IDE_ERR_DATA        -11
/*+ interface not ready for a command +*/
#define IDE_ERR_NOTREADY    -12
/*+ a timeout waiting for a reply +*/
#define IDE_ERR_TIMEOUT     -13
/*+ the interface must be busy but it is not +*/
#define IDE_ERR_NOTBUSY     -14
/*+ device fault +*/
#define IDE_ERR_FAULT       -15
/*+ we aspect to send data but there is no data request +*/
#define IDE_ERR_NODATAREQ   -16
/*+ the DRDY signal is not preset +*/
#define IDE_ERR_NOTDRDY     -17
/*+ DMA cycle error +*/
#define IDE_ERR_DMA         -18

/*+ for the IDE_ERR_??? constants +*/
extern char *ide_error_msg[];

/*
 * DATA STRUCTURES
 */


/*+
  Information on IDE devices capabilities
  +*/

struct ide_diskinfo {
  __uint32_t use_lba:1;     /*+ use LBA address translation +*/
  __uint32_t use_dma:1;     /*+ use old dma operation +*/
  __uint32_t use_bm_dma:1;  /*+ use new bus master dma operation +*/
  __int8_t  max_pio_mode;   /*+ max pio mode supported (-1 no support) +*/
  __int8_t  max_dma_mode;   /*+ max multi word dma support (-1 no support) +*/
  __int8_t  max_udma_mode;  /*+ max ultra dma mode support (-1 no support) +*/
};

/*+
  Information on IDE interfaces
  +*/

struct ideinfo {

#ifdef _PARANOIA
  __uint32_t magic;        /*+ magic number +*/
#endif

  __uint16_t io_port;      /*+ I/O address +*/
  __uint16_t io_port2;     /*+ auxiliary I/O address +*/
  __uint8_t  irq;          /*+ irq number +*/
  __uint8_t  dma;          /*+ dma channel +*/
  __uint16_t io_bmdma;     /*+ I/O address for a bus master DMA cycle */

  /* this must be 4-bytes aligned */
  __uint32_t prd[MAXPRDENTRIES*2];
                           /*+ physical region descriptors (used by DMA) */
 
  struct phdskinfo    *pdisk[2]; /*+ physical disk pointer for master/slave +*/
  struct ide_diskinfo info[2];   /*+ more disk information for master/slave +*/

  bqueue_t   queue[2];
  int        actreq;       /*+ actual request that we are serving +*/
  int        actdrv;       /*+ drive id of the actual request +*/
 
  int        errors;       /*+ incremented for every error */
 
  /* for the glue routines (see ideglue.c) */
  __pid_t    server;       /*+ interface server pid +*/

} __attribute__ ((aligned (4)));

/*+
  Information on minor devices
  +*/

struct ideminorinfo {
 
#ifdef _PARANOIA
  __uint32_t  magic;     /*+ magic number +*/  
#endif
 
  __blkcnt_t  start;     /*+ first block of this logical disk (partition) +*/
  __blkcnt_t  size;      /*+ size of the logical disk (in sectors) +*/
 
  __uint16_t  used:1;    /*+ is this entry used? +*/
  __uint16_t  blocked:1; /*+ is this entry blocked? (is someone using it?) +*/
};

/*
 * DATA
 */


/* these are here because are used both ide.c and idelow.c */

extern struct ideinfo ide[MAXIDEINTERFACES];

extern int ide_showinfo_flag;

extern void *ide_parm_initserver;

/*
 * FUNCTIONS
 */


/* register an hardware interface on first free slot */
int ide_register(__uint16_t io_port, __uint16_t io_port2,
                 __uint8_t irq,
                 __uint8_t dma, __uint16_t io_bmdma);
/* release resource used by the ideif interface */
void ide_unregister(int ideif);

/* scan an interface to found device */
int ide_scan(int ideif);

/* scan an hard disk to found a partitions scheme */
int ide_scandisk(int hwif, int drv);


struct ata_diskid;
struct atapi_diskid;

int do_ide_softreset(int ideif);
int ide_read(int ideif, int id, __blkcnt_t lsector, __uint8_t *buffer);
int ide_write(int ideif, int id, __blkcnt_t lsector, __uint8_t *buffer);
int ide_seek(int ideif, int id, __blkcnt_t lsector);
int ide_pidentify(int ideif, int id, struct atapi_diskid *buffer);
int ide_identify(int ideif, int id, struct ata_diskid *buffer);
int ide_enablelookahead(int ideif, int id);
int ide_disablelookahead(int ideif, int id);
int ide_settransfertmode(int ideif, int id, int mode);

TASK ide_server(int ideif);

#define is_ide_free(ideif) (ide[(ideif)].io_port==0)
#define mark_ide_free(ideif) (ide[(ideif)].io_port=0)

static inline int nextideif(void)
{
  int ideif;
  for (ideif=0;ideif<MAXIDEINTERFACES;ideif++)
    if (is_ide_free(ideif)) break;
  return ideif;
}

/*
 * LOW LEVEL data structures
 */


/* ATA-4 */
/* obs: obsolete res: reserved ven: vendor specific */

/*+ IDENTIFY command response (from ATA 4 specifications) +*/
struct ata_diskid {
  __uint16_t  config;
  __uint16_t  def_cyls;
  __uint16_t  res2;
  __uint16_t  def_heads;
  __uint16_t  res4;
  __uint16_t  res5;
  __uint16_t  def_sects;
  __uint16_t  ven7;
  __uint16_t  ven8;
  __uint16_t  ven9;
  __uint8_t   serial[20];
  __uint16_t  ven20;
  __uint16_t  ven21;
  __uint16_t  obs22;
  __uint8_t   firmware[8];
  __uint8_t   model[40];
  __uint16_t  maxmulsect;
  __uint16_t  res48;
  __uint16_t  capabilities;
  __uint16_t  capabilities2;
  __uint8_t   ven51;
  __uint8_t   PIO_mode;
  __uint16_t  ven52;
  __uint16_t  fields_valid;
  __uint16_t  act_cyls;      // 54
  __uint16_t  act_heads;
  __uint16_t  act_sects;
  __uint16_t  cur_capacity0;
  __uint16_t  cur_capacity1; // 58
  __uint8_t   multsect;      
  __uint8_t   multsect_valid;
  __uint32_t  lba_capacity;
  __uint16_t  obs62;
  __uint16_t  DMA_mword;
  __uint8_t   eide_PIO_modes;
  __uint8_t   res64 ;
  __uint16_t  eide_dma_min;
  __uint16_t  eide_dma_time;
  __uint16_t  eide_pio;    
  __uint16_t  eide_pio_iordy;
  __uint16_t  res69;
  __uint16_t  res70;          // 70
  __uint16_t  res71;
  __uint16_t  res72;
  __uint16_t  res73;
  __uint16_t  res74;
  __uint16_t  queue_depth;
  __uint16_t  res76;
  __uint16_t  res77;
  __uint16_t  res78;
  __uint16_t  res79;  
  __uint16_t  major_version;
  __uint16_t  minor_version;
  __uint16_t  command_sets;
  __uint16_t  command_sets2;
  __uint16_t  command_sets_ext;
  __uint16_t  command_sets_ena;
  __uint16_t  command_sets_ena2;
  __uint16_t  command_sets_def;
  __uint16_t  UDMA_cap;
  __uint16_t  erase_time;
  __uint16_t  erase_time2;
  __uint16_t  current_power;
  __uint16_t  reservedA[126-92+1];
  __uint16_t  status_notification;
  __uint16_t  security;
  __uint16_t  vendor[159-129+1];
  __uint16_t  reservedB[255-160+1];
} __attribute__((packed));

#define is_ATAdevice(p)    ((p)->config&0x8000)
#define is_removable(p)    ((p)->config&0x0080)
#define is_notremovable(p) ((p)->config&0x0040)

// 54 -> 58
#define is_actcurvalid(p)  ((p)->fields_valid&0x0001)
// 64 -> 70
#define is_eidevalid(p)    ((p)->fields_valid&0x0002)
// 88
#define is_udmavalid(p)  ((p)->fields_valid&0x0004)

#define is_ATA(p)          ((p)->major_version&0x02)
#define is_ATA2(p)         ((p)->major_version&0x04)
#define is_ATA3(p)         ((p)->major_version&0x08)
#define is_ATA4(p)         ((p)->major_version&0x10)

#define is_LBAcapable(p)   ( \
                            ((p)->capabilities&0x0200) \
                            || is_ATA3(p) \
                            || is_ATA4(p) \
                           )


/*+ PIDENTIFY command response (for ATAPI device from ATA 4 specs) +*/
struct atapi_diskid {
  __uint16_t  config;
  __uint16_t  res1;
  __uint16_t  res2;
  __uint16_t  res3;
  __uint16_t  res4;
  __uint16_t  res5;
  __uint16_t  res6;
  __uint16_t  ven7;
  __uint16_t  ven8;
  __uint16_t  ven9;
  __uint8_t   serial[20];
  __uint16_t  res20;
  __uint16_t  res21;
  __uint16_t  res22;
  __uint8_t   firmware[8];
  __uint8_t   model[40];
  __uint16_t  res47;
  __uint16_t  res48;
  __uint16_t  capabilities;
  __uint16_t  res50;
  __uint8_t   ven51;
  __uint8_t   tPIO;
  __uint16_t  res52;
  __uint16_t  fields_valid;
  __uint16_t  res54;   //54
  __uint16_t  res55;
  __uint16_t  res56;
  __uint16_t  res57;
  __uint16_t  res58;  // 58
  __uint16_t  res59;
  __uint16_t  res60;
  __uint16_t  res61;
  __uint16_t  res62;
  __uint16_t  dma_mword;
  __uint16_t  eide_pio_modes; //64
  __uint16_t  eide_dma_min;
  __uint16_t  eide_dma_time;
  __uint16_t  eide_pio;    
  __uint16_t  eide_pio_iordy;
  __uint16_t  res69;
  __uint16_t  res70;          // 70
  __uint16_t  time_packet;
  __uint16_t  time_service;
  __uint16_t  res73;
  __uint16_t  res74;
  __uint16_t  queue_depth;
  __uint16_t  res76;
  __uint16_t  res77;
  __uint16_t  res78;
  __uint16_t  res79;  
  __uint16_t  major_version;
  __uint16_t  minor_version;
  __uint16_t  command_sets;
  __uint16_t  command_sets2;
  __uint16_t  command_sets_ext;
  __uint16_t  command_sets_ena;
  __uint16_t  command_sets_ena2;
  __uint16_t  command_sets_def;
  __uint16_t  udma;
  __uint16_t  reservedA[126-89+1];
  __uint16_t  status_notification;
  __uint16_t  security;
  __uint16_t  vendor[159-129+1];
  __uint16_t  reservedB[255-160+1];
} __attribute__((packed));

#define is_ATAPIdevice(p)  (((p)->config&0xc000)==0x8000)
//#define is_removable(p)    ((p)->config&0x0080)
#define is_packet12capable(p) (((p)->conig&0x0003)==0x0000)
#define is_packet16capable(p) (((p)->conig&0x0003)==0x0001)

#define is_directdev(p)        ((((p)->config&0x1f00)>>8)==0x00)
#define is_sequentialdev(p)    ((((p)->config&0x1f00)>>8)==0x01)
#define is_printerdev(p)       ((((p)->config&0x1f00)>>8)==0x02)
#define is_processordev(p)     ((((p)->config&0x1f00)>>8)==0x03)
#define is_writeoncedev(p)     ((((p)->config&0x1f00)>>8)==0x04)
#define is_cdromdev(p)         ((((p)->config&0x1f00)>>8)==0x05)
#define is_scannerdev(p)       ((((p)->config&0x1f00)>>8)==0x06)
#define is_opticalmemorydev(p) ((((p)->config&0x1f00)>>8)==0x07)
#define is_mediachengerdev(p)  ((((p)->config&0x1f00)>>8)==0x08)
#define is_communicatordev(p)  ((((p)->config&0x1f00)>>8)==0x09)
#define is_arraydev(p)         ((((p)->config&0x1f00)>>8)==0x0c)

__END_DECLS
#endif