sys/cam/ata/ata_all.h

   1 /*-
   2  * Copyright (c) 2009 Alexander Motin <mav@FreeBSD.org>
   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
   7  * are met:
   8  * 1. Redistributions of source code must retain the above copyright
   9  *    notice, this list of conditions and the following disclaimer,
  10  *    without modification, immediately at the beginning of the file.
  11  * 2. Redistributions in binary form must reproduce the above copyright
  12  *    notice, this list of conditions and the following disclaimer in the
  13  *    documentation and/or other materials provided with the distribution.
  14  *
  15  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
  16  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  17  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  18  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
  19  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  20  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  21  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  22  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  23  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  24  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  25  *
  26  * $FreeBSD$
  27  */
  28
  29 #ifndef CAM_ATA_ALL_H
  30 #define CAM_ATA_ALL_H 1
  31
  32 #include <sys/ata.h>
  33
  34 struct ccb_ataio;
  35 struct cam_periph;
  36 union  ccb;
  37
  38 #define SID_DMA48       0x01 /* Abuse inq_flags bit to track enabled DMA48. */
  39 #define SID_AEN         0x04 /* Abuse inq_flags bit to track enabled AEN. */
  40 #define SID_DMA         0x10 /* Abuse inq_flags bit to track enabled DMA. */
  41
  42 struct ata_cmd {
  43         u_int8_t        flags;          /* ATA command flags */
  44 #define         CAM_ATAIO_48BIT         0x01    /* Command has 48-bit format */
  45 #define         CAM_ATAIO_FPDMA         0x02    /* FPDMA command */
  46 #define         CAM_ATAIO_CONTROL       0x04    /* Control, not a command */
  47 #define         CAM_ATAIO_NEEDRESULT    0x08    /* Request requires result. */
  48 #define         CAM_ATAIO_DMA           0x10    /* DMA command */
  49
  50         u_int8_t        command;
  51         u_int8_t        features;
  52
  53         u_int8_t        lba_low;
  54         u_int8_t        lba_mid;
  55         u_int8_t        lba_high;
  56         u_int8_t        device;
  57
  58         u_int8_t        lba_low_exp;
  59         u_int8_t        lba_mid_exp;
  60         u_int8_t        lba_high_exp;
  61         u_int8_t        features_exp;
  62
  63         u_int8_t        sector_count;
  64         u_int8_t        sector_count_exp;
  65         u_int8_t        control;
  66 };
  67
  68 struct ata_res {
  69         u_int8_t        flags;          /* ATA command flags */
  70 #define         CAM_ATAIO_48BIT         0x01    /* Command has 48-bit format */
  71
  72         u_int8_t        status;
  73         u_int8_t        error;
  74
  75         u_int8_t        lba_low;
  76         u_int8_t        lba_mid;
  77         u_int8_t        lba_high;
  78         u_int8_t        device;
  79
  80         u_int8_t        lba_low_exp;
  81         u_int8_t        lba_mid_exp;
  82         u_int8_t        lba_high_exp;
  83
  84         u_int8_t        sector_count;
  85         u_int8_t        sector_count_exp;
  86 };
  87
  88 struct sep_identify_data {
  89         uint8_t         length;         /* Enclosure descriptor length */
  90         uint8_t         subenc_id;      /* Sub-enclosure identifier */
  91         uint8_t         logical_id[8];  /* Enclosure logical identifier (WWN) */
  92         uint8_t         vendor_id[8];   /* Vendor identification string */
  93         uint8_t         product_id[16]; /* Product identification string */
  94         uint8_t         product_rev[4]; /* Product revision string */
  95         uint8_t         channel_id;     /* Channel identifier */
  96         uint8_t         firmware_rev[4];/* Firmware revision */
  97         uint8_t         interface_id[6];/* Interface spec ("S-E-S "/"SAF-TE")*/
  98         uint8_t         interface_rev[4];/* Interface spec revision */
  99         uint8_t         vend_spec[11];  /* Vendor specific information */
 100 };
 101
 102 int     ata_version(int ver);
 103
 104 char *  ata_op_string(struct ata_cmd *cmd);
 105 char *  ata_cmd_string(struct ata_cmd *cmd, char *cmd_string, size_t len);
 106 char *  ata_res_string(struct ata_res *res, char *res_string, size_t len);
 107 int     ata_command_sbuf(struct ccb_ataio *ataio, struct sbuf *sb);
 108 int     ata_status_sbuf(struct ccb_ataio *ataio, struct sbuf *sb);
 109 int     ata_res_sbuf(struct ccb_ataio *ataio, struct sbuf *sb);
 110
 111 void    ata_print_ident(struct ata_params *ident_data);
 112
 113 uint32_t        ata_logical_sector_size(struct ata_params *ident_data);
 114 uint64_t        ata_physical_sector_size(struct ata_params *ident_data);
 115 uint64_t        ata_logical_sector_offset(struct ata_params *ident_data);
 116
 117 void    ata_28bit_cmd(struct ccb_ataio *ataio, uint8_t cmd, uint8_t features,
 118     uint32_t lba, uint8_t sector_count);
 119 void    ata_48bit_cmd(struct ccb_ataio *ataio, uint8_t cmd, uint16_t features,
 120     uint64_t lba, uint16_t sector_count);
 121 void    ata_ncq_cmd(struct ccb_ataio *ataio, uint8_t cmd,
 122     uint64_t lba, uint16_t sector_count);
 123 void    ata_reset_cmd(struct ccb_ataio *ataio);
 124 void    ata_pm_read_cmd(struct ccb_ataio *ataio, int reg, int port);
 125 void    ata_pm_write_cmd(struct ccb_ataio *ataio, int reg, int port, uint32_t val);
 126
 127 void    ata_bswap(int8_t *buf, int len);
 128 void    ata_btrim(int8_t *buf, int len);
 129 void    ata_bpack(int8_t *src, int8_t *dst, int len);
 130
 131 int     ata_max_pmode(struct ata_params *ap);
 132 int     ata_max_wmode(struct ata_params *ap);
 133 int     ata_max_umode(struct ata_params *ap);
 134 int     ata_max_mode(struct ata_params *ap, int maxmode);
 135
 136 char *  ata_mode2string(int mode);
 137 int     ata_string2mode(char *str);
 138 u_int   ata_mode2speed(int mode);
 139 u_int   ata_revision2speed(int revision);
 140 int     ata_speed2revision(u_int speed);
 141
 142 int     ata_identify_match(caddr_t identbuffer, caddr_t table_entry);
 143 int     ata_static_identify_match(caddr_t identbuffer, caddr_t table_entry);
 144
 145 void    semb_print_ident(struct sep_identify_data *ident_data);
 146
 147 void semb_receive_diagnostic_results(struct ccb_ataio *ataio,
 148         u_int32_t retries, void (*cbfcnp)(struct cam_periph *, union ccb*),
 149         uint8_t tag_action, int pcv, uint8_t page_code,
 150         uint8_t *data_ptr, uint16_t allocation_length, uint32_t timeout);
 151
 152 void semb_send_diagnostic(struct ccb_ataio *ataio,
 153         u_int32_t retries, void (*cbfcnp)(struct cam_periph *, union ccb *),
 154         uint8_t tag_action, uint8_t *data_ptr, uint16_t param_list_length,
 155         uint32_t timeout);
 156
 157 void semb_read_buffer(struct ccb_ataio *ataio,
 158         u_int32_t retries, void (*cbfcnp)(struct cam_periph *, union ccb*),
 159         uint8_t tag_action, uint8_t page_code,
 160         uint8_t *data_ptr, uint16_t allocation_length, uint32_t timeout);
 161
 162 void semb_write_buffer(struct ccb_ataio *ataio,
 163         u_int32_t retries, void (*cbfcnp)(struct cam_periph *, union ccb *),
 164         uint8_t tag_action, uint8_t *data_ptr, uint16_t param_list_length,
 165         uint32_t timeout);
 166
 167 #endif