src/dev/ide_disk.hh

   1 /*
   2  * Copyright (c) 2004-2005 The Regents of The University of Michigan
   3  * All rights reserved.
   4  *
   5  * Redistribution and use in source and binary forms, with or without
   6  * modification, are permitted provided that the following conditions are
   7  * met: redistributions of source code must retain the above copyright
   8  * notice, this list of conditions and the following disclaimer;
   9  * redistributions in binary form must reproduce the above copyright
  10  * notice, this list of conditions and the following disclaimer in the
  11  * documentation and/or other materials provided with the distribution;
  12  * neither the name of the copyright holders nor the names of its
  13  * contributors may be used to endorse or promote products derived from
  14  * this software without specific prior written permission.
  15  *
  16  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  17  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  18  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  19  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  20  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  21  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  22  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  23  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  24  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  25  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  26  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  27  *
  28  * Authors: Andrew Schultz
  29  */
  30
  31 /** @file
  32  * Device model for an IDE disk
  33  */
  34
  35 #ifndef __IDE_DISK_HH__
  36 #define __IDE_DISK_HH__
  37
  38 #include "base/statistics.hh"
  39 #include "dev/disk_image.hh"
  40 #include "dev/ide_atareg.h"
  41 #include "dev/ide_ctrl.hh"
  42 #include "dev/ide_wdcreg.h"
  43 #include "dev/io_device.hh"
  44 #include "sim/eventq.hh"
  45 #include "params/IdeDisk.hh"
  46
  47
  48 class ChunkGenerator;
  49
  50 #define DMA_BACKOFF_PERIOD 200
  51
  52 #define MAX_DMA_SIZE    (131072)  // 128K
  53 #define MAX_MULTSECT    (128)
  54
  55 #define PRD_BASE_MASK  0xfffffffe
  56 #define PRD_COUNT_MASK 0xfffe
  57 #define PRD_EOT_MASK   0x8000
  58
  59 typedef struct PrdEntry {
  60     uint32_t baseAddr;
  61     uint16_t byteCount;
  62     uint16_t endOfTable;
  63 } PrdEntry_t;
  64
  65 class PrdTableEntry {
  66   public:
  67     PrdEntry_t entry;
  68
  69     uint32_t getBaseAddr()
  70     {
  71         return (entry.baseAddr & PRD_BASE_MASK);
  72     }
  73
  74     uint32_t getByteCount()
  75     {
  76         return ((entry.byteCount == 0) ? MAX_DMA_SIZE :
  77                 (entry.byteCount & PRD_COUNT_MASK));
  78     }
  79
  80     uint16_t getEOT()
  81     {
  82         return (entry.endOfTable & PRD_EOT_MASK);
  83     }
  84 };
  85
  86 #define DATA_OFFSET     (0)
  87 #define ERROR_OFFSET    (1)
  88 #define FEATURES_OFFSET (1)
  89 #define NSECTOR_OFFSET  (2)
  90 #define SECTOR_OFFSET   (3)
  91 #define LCYL_OFFSET     (4)
  92 #define HCYL_OFFSET     (5)
  93 #define SELECT_OFFSET   (6)
  94 #define DRIVE_OFFSET    (6)
  95 #define STATUS_OFFSET   (7)
  96 #define COMMAND_OFFSET  (7)
  97
  98 #define CONTROL_OFFSET  (2)
  99 #define ALTSTAT_OFFSET  (2)
 100
 101 #define SELECT_DEV_BIT  0x10
 102 #define CONTROL_RST_BIT 0x04
 103 #define CONTROL_IEN_BIT 0x02
 104 #define STATUS_BSY_BIT  0x80
 105 #define STATUS_DRDY_BIT 0x40
 106 #define STATUS_DRQ_BIT  0x08
 107 #define STATUS_SEEK_BIT 0x10
 108 #define STATUS_DF_BIT   0x20
 109 #define DRIVE_LBA_BIT   0x40
 110
 111 #define DEV0 (0)
 112 #define DEV1 (1)
 113
 114 typedef struct CommandReg {
 115     uint16_t data;
 116     uint8_t error;
 117     uint8_t sec_count;
 118     uint8_t sec_num;
 119     uint8_t cyl_low;
 120     uint8_t cyl_high;
 121     union {
 122         uint8_t drive;
 123         uint8_t head;
 124     };
 125     uint8_t command;
 126 } CommandReg_t;
 127
 128 typedef enum Events {
 129     None = 0,
 130     Transfer,
 131     ReadWait,
 132     WriteWait,
 133     PrdRead,
 134     DmaRead,
 135     DmaWrite
 136 } Events_t;
 137
 138 typedef enum DevAction {
 139     ACT_NONE = 0,
 140     ACT_CMD_WRITE,
 141     ACT_CMD_COMPLETE,
 142     ACT_CMD_ERROR,
 143     ACT_SELECT_WRITE,
 144     ACT_STAT_READ,
 145     ACT_DATA_READY,
 146     ACT_DATA_READ_BYTE,
 147     ACT_DATA_READ_SHORT,
 148     ACT_DATA_WRITE_BYTE,
 149     ACT_DATA_WRITE_SHORT,
 150     ACT_DMA_READY,
 151     ACT_DMA_DONE,
 152     ACT_SRST_SET,
 153     ACT_SRST_CLEAR
 154 } DevAction_t;
 155
 156 typedef enum DevState {
 157     // Device idle
 158     Device_Idle_S = 0,
 159     Device_Idle_SI,
 160     Device_Idle_NS,
 161
 162     // Software reset
 163     Device_Srst,
 164
 165     // Non-data commands
 166     Command_Execution,
 167
 168     // PIO data-in (data to host)
 169     Prepare_Data_In,
 170     Data_Ready_INTRQ_In,
 171     Transfer_Data_In,
 172
 173     // PIO data-out (data from host)
 174     Prepare_Data_Out,
 175     Data_Ready_INTRQ_Out,
 176     Transfer_Data_Out,
 177
 178     // DMA protocol
 179     Prepare_Data_Dma,
 180     Transfer_Data_Dma
 181 } DevState_t;
 182
 183 typedef enum DmaState {
 184     Dma_Idle = 0,
 185     Dma_Start,
 186     Dma_Transfer
 187 } DmaState_t;
 188
 189 class PhysicalMemory;
 190 class IdeController;
 191
 192 /**
 193  * IDE Disk device model
 194  */
 195 class IdeDisk : public SimObject
 196 {
 197   protected:
 198     /** The IDE controller for this disk. */
 199     IdeController *ctrl;
 200     /** The image that contains the data of this disk. */
 201     DiskImage *image;
 202
 203   protected:
 204     /** The disk delay in microseconds. */
 205     int diskDelay;
 206
 207   private:
 208     /** Drive identification structure for this disk */
 209     struct ataparams driveID;
 210     /** Data buffer for transfers */
 211     uint8_t *dataBuffer;
 212     /** Number of bytes in command data transfer */
 213     uint32_t cmdBytes;
 214     /** Number of bytes left in command data transfer */
 215     uint32_t cmdBytesLeft;
 216     /** Number of bytes left in DRQ block */
 217     uint32_t drqBytesLeft;
 218     /** Current sector in access */
 219     uint32_t curSector;
 220     /** Command block registers */
 221     CommandReg_t cmdReg;
 222     /** Status register */
 223     uint8_t status;
 224     /** Interrupt enable bit */
 225     bool nIENBit;
 226     /** Device state */
 227     DevState_t devState;
 228     /** Dma state */
 229     DmaState_t dmaState;
 230     /** Dma transaction is a read */
 231     bool dmaRead;
 232     /** PRD table base address */
 233     uint32_t curPrdAddr;
 234     /** PRD entry */
 235     PrdTableEntry curPrd;
 236     /** Device ID (master=0/slave=1) */
 237     int devID;
 238     /** Interrupt pending */
 239     bool intrPending;
 240
 241     Stats::Scalar<> dmaReadFullPages;
 242     Stats::Scalar<> dmaReadBytes;
 243     Stats::Scalar<> dmaReadTxs;
 244     Stats::Scalar<> dmaWriteFullPages;
 245     Stats::Scalar<> dmaWriteBytes;
 246     Stats::Scalar<> dmaWriteTxs;
 247     Stats::Formula rdBandwidth;
 248     Stats::Formula wrBandwidth;
 249     Stats::Formula totBandwidth;
 250     Stats::Formula totBytes;
 251
 252   public:
 253     typedef IdeDiskParams Params;
 254     IdeDisk(const Params *p);
 255
 256     /**
 257      * Delete the data buffer.
 258      */
 259     ~IdeDisk();
 260
 261     /**
 262      * Reset the device state
 263      */
 264     void reset(int id);
 265
 266     /**
 267      * Register Statistics
 268      */
 269     void regStats();
 270
 271     /**
 272      * Set the controller for this device
 273      * @param c The IDE controller
 274      */
 275     void setController(IdeController *c) {
 276         if (ctrl) panic("Cannot change the controller once set!\n");
 277         ctrl = c;
 278     }
 279
 280     // Device register read/write
 281     void readCommand(const Addr offset, int size, uint8_t *data);
 282     void readControl(const Addr offset, int size, uint8_t *data);
 283     void writeCommand(const Addr offset, int size, const uint8_t *data);
 284     void writeControl(const Addr offset, int size, const uint8_t *data);
 285
 286     // Start/abort functions
 287     void startDma(const uint32_t &prdTableBase);
 288     void abortDma();
 289
 290   private:
 291     void startCommand();
 292
 293     // Interrupt management
 294     void intrPost();
 295     void intrClear();
 296
 297     // DMA stuff
 298     void doDmaTransfer();
 299     friend class EventWrapper<IdeDisk, &IdeDisk::doDmaTransfer>;
 300     EventWrapper<IdeDisk, &IdeDisk::doDmaTransfer> dmaTransferEvent;
 301
 302     void doDmaDataRead();
 303
 304     void doDmaRead();
 305     ChunkGenerator *dmaReadCG;
 306     friend class EventWrapper<IdeDisk, &IdeDisk::doDmaRead>;
 307     EventWrapper<IdeDisk, &IdeDisk::doDmaRead> dmaReadWaitEvent;
 308
 309     void doDmaDataWrite();
 310
 311     void doDmaWrite();
 312     ChunkGenerator *dmaWriteCG;
 313     friend class EventWrapper<IdeDisk, &IdeDisk::doDmaWrite>;
 314     EventWrapper<IdeDisk, &IdeDisk::doDmaWrite> dmaWriteWaitEvent;
 315
 316     void dmaPrdReadDone();
 317     friend class EventWrapper<IdeDisk, &IdeDisk::dmaPrdReadDone>;
 318     EventWrapper<IdeDisk, &IdeDisk::dmaPrdReadDone> dmaPrdReadEvent;
 319
 320     void dmaReadDone();
 321     friend class EventWrapper<IdeDisk, &IdeDisk::dmaReadDone>;
 322     EventWrapper<IdeDisk, &IdeDisk::dmaReadDone> dmaReadEvent;
 323
 324     void dmaWriteDone();
 325     friend class EventWrapper<IdeDisk, &IdeDisk::dmaWriteDone>;
 326     EventWrapper<IdeDisk, &IdeDisk::dmaWriteDone> dmaWriteEvent;
 327
 328     // Disk image read/write
 329     void readDisk(uint32_t sector, uint8_t *data);
 330     void writeDisk(uint32_t sector, uint8_t *data);
 331
 332     // State machine management
 333     void updateState(DevAction_t action);
 334
 335     // Utility functions
 336     bool isBSYSet() { return (status & STATUS_BSY_BIT); }
 337     bool isIENSet() { return nIENBit; }
 338     bool isDEVSelect();
 339
 340     void setComplete()
 341     {
 342         // clear out the status byte
 343         status = 0;
 344         // set the DRDY bit
 345         status |= STATUS_DRDY_BIT;
 346         // set the SEEK bit
 347         status |= STATUS_SEEK_BIT;
 348     }
 349
 350     uint32_t getLBABase()
 351     {
 352         return  (Addr)(((cmdReg.head & 0xf) << 24) | (cmdReg.cyl_high << 16) |
 353                        (cmdReg.cyl_low << 8) | (cmdReg.sec_num));
 354     }
 355
 356     inline Addr pciToDma(Addr pciAddr);
 357
 358     /**
 359      * Serialize this object to the given output stream.
 360      * @param os The stream to serialize to.
 361      */
 362     void serialize(std::ostream &os);
 363
 364     /**
 365      * Reconstruct the state of this object from a checkpoint.
 366      * @param cp The checkpoint to use.
 367      * @param section The section name describing this object.
 368      */
 369     void unserialize(Checkpoint *cp, const std::string &section);
 370 };
 371
 372
 373 #endif // __IDE_DISK_HH__