source: trunk/src/os2ahci/os2ahci.h@ 71

Last change on this file since 71 was 71, checked in by chris, 15 years ago
  • Added minimum NCQ depth for SATA devices which don't support NCQ at all
  • Removed ATAPI devices from the flush cache queue as they caused timeouts with a DVD drive in an HP test box
  • Various cosmetic changes to debug levels, etc.
File size: 23.0 KB
Line 
1/******************************************************************************
2 * os2ahci.h - main header file for os2ahci driver
3 *
4 * Copyright (c) 2010 Christian Mueller. Parts copied from/inspired by the
5 * Linux AHCI driver; those parts are (c) Linux AHCI/ATA maintainers
6 *
7 * This program is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License as published by
9 * the Free Software Foundation; either version 2 of the License, or
10 * (at your option) any later version.
11 *
12 * This program is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU General Public License for more details.
16 *
17 * You should have received a copy of the GNU General Public License
18 * along with this program; if not, write to the Free Software
19 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
20 */
21
22/* ----------------------------- include files ----------------------------- */
23
24/* IMPORTANT NOTE: The DDK headers require tight structure packing and this
25 * is controlled via compiler parameters. Thus, all stuctures in os2ahci.sys
26 * are expected to be byte-aligned without the need of explicit pragma pack()
27 * directives. Where possible, the structures are layed out such that words
28 * and dwords are aligned at least on 2-byte boundaries.
29 */
30
31#define INCL_NOPMAPI
32#define INCL_DOSINFOSEG
33#define INCL_NO_SCB
34#define INCL_DOSERRORS
35#include <os2.h>
36#include <dos.h>
37#include <bseerr.h>
38#include <dskinit.h>
39#include <scb.h>
40
41#include <devhdr.h>
42#include <iorb.h>
43#include <strat2.h>
44#include <reqpkt.h>
45
46#ifdef __WATCOMC__
47/* include WATCOM specific DEVHELP stubs */
48#include <devhelp.h>
49#else
50#include <dhcalls.h>
51#endif
52
53#include <addcalls.h>
54#include <rmcalls.h>
55#include <devclass.h>
56#include <devcmd.h>
57#include <rmbase.h>
58
59#include "ahci.h"
60#include "version.h"
61
62/* -------------------------- macros and constants ------------------------- */
63
64#define MAX_AD 8 /* maximum number of adapters */
65
66/* Timer pool size. In theory, we need one timer per outstanding command plus
67 * a few miscellaneous timers but it's unlikely we'll ever have outstanding
68 * commands on all devices on all ports on all apapters -- this would be
69 * 8 * 32 * 32 = 8192 outstanding commands on a maximum of 8 * 32 * 15 = 3840
70 * devices and that's a bit of an exaggeration. It should be more than enough
71 * to have 128 timers.
72 */
73#define TIMER_COUNT 128
74#define TIMER_POOL_SIZE (sizeof(ADD_TIMER_POOL) + \
75 TIMER_COUNT * sizeof(ADD_TIMER_DATA))
76
77/* default command timeout (can be overwritten in the IORB) */
78#define DEFAULT_TIMEOUT 30000
79
80/* max/min macros */
81#define max(a, b) (a) > (b) ? (a) : (b)
82#define min(a, b) (a) < (b) ? (a) : (b)
83
84/* debug output macros */
85#define dprintf if (debug > 0) printf
86#define dphex if (debug > 0) phex
87#define ddprintf if (debug > 1) printf
88#define ddphex if (debug > 1) phex
89#define dddprintf if (debug > 2) printf
90#define dddphex if (debug > 2) phex
91
92/* adapter number from AD_INFO pointer; mainly for dprintf() purposes */
93#define ad_no(ai) (((u16) ai - (u16) ad_infos) / sizeof(*ai))
94
95/* Convert far function address into NPFN (the DDK needs this all over the
96 * place and just casting to NPFN will produce a "segment lost in conversion"
97 * warning. Since casting to a u32 is a bit nasty for function pointers and
98 * might have to be revised for different compilers, we'll use a central
99 * macro for this crap.
100 */
101#define mk_NPFN(func) (NPFN) (u32) (func)
102
103/* stdarg.h macros with explicit far pointers
104 *
105 * NOTE: The compiler pushes fixed arguments with 16 bits minimum, thus
106 * the last fixed argument (i.e. the one passed to va_start) must
107 * have at least 16 bits. Otherwise, the address calculation in
108 * va_start() will fail.
109 */
110typedef char _far *va_list;
111#define va_start(va, last) va = (va_list) (&last + 1)
112#define va_arg(va, type) ((type _far *) (va += sizeof(type)))[-1]
113#define va_end(va) va = 0
114
115/* ctype macros */
116#define isupper(ch) ((ch) >= 'A' && (ch) <= 'Z')
117#define tolower(ch) (isupper(ch) ? (ch) - ('a' - 'A') : (ch))
118
119/* stddef macros */
120#define offsetof(s, e) ((u16) &((s *) 0)->e)
121
122/* SMP spinlock compatibility macros for older DDKs using CLI/STI */
123#ifndef OS2AHCI_SMP
124#define DevHelp_CreateSpinLock(sph) *(sph) = 0
125#define DevHelp_FreeSpinLock(sph) 0
126
127#define DevHelp_AquireSpinLock(sph) if ((sph) != 0) \
128 panic("recursive spinlock"); \
129 (sph) = disable()
130
131#define DevHelp_ReleaseSpinLock(sph) if (sph) { \
132 (sph) = 0; \
133 enable(); \
134 }
135#endif
136
137/* shortcut macros */
138#define spin_lock(sl) DevHelp_AquireSpinLock(sl)
139#define spin_unlock(sl) DevHelp_ReleaseSpinLock(sl)
140
141/* Get AHCI port MMIO base from AD_INFO and port number. For the time being,
142 * MMIO addresses are assumed to be valid 16:16 pointers which implies
143 * that one GDT selector is allocated per adapter.
144 */
145#define port_base(ai, p) ((u8 _far *) (ai)->mmio + 0x100 + (p) * 0x80)
146
147/* Get address of port-specific DMA scratch buffer. The total size of all DMA
148 * buffers required for 32 ports exceeds 65536 bytes, thus we need multiple
149 * GDT selectors to access all port DMA scratch buffers and some logic to map
150 * a port number to the corresponding DMA scratch buffer address.
151 */
152#define PORT_DMA_BUFS_PER_SEG ((size_t) (65536UL / AHCI_PORT_PRIV_DMA_SZ))
153#define PORT_DMA_BUF_SEGS ((AHCI_MAX_PORTS + PORT_DMA_BUFS_PER_SEG - 1) \
154 / PORT_DMA_BUFS_PER_SEG)
155#define PORT_DMA_SEG_SIZE ((u32) PORT_DMA_BUFS_PER_SEG * \
156 (u32) AHCI_PORT_PRIV_DMA_SZ)
157
158#define port_dma_base(ai, p) \
159 ((AHCI_PORT_DMA _far *) ((ai)->dma_buf[(p) / PORT_DMA_BUFS_PER_SEG] + \
160 ((p) % PORT_DMA_BUFS_PER_SEG) * AHCI_PORT_PRIV_DMA_SZ))
161
162#define port_dma_base_phys(ai, p) \
163 ((ai)->dma_buf_phys + (u32) (p) * AHCI_PORT_PRIV_DMA_SZ)
164
165/* Convert an SATA adapter/port/device address into a 16-bit IORB unit handle
166 * (and the other way round). The mapping looks like this:
167 *
168 * mapping comment
169 * -----------------------------------------------------------------------
170 * 4 bits for the adapter current max is 8 adapters
171 * 4 bits for the port AHCI spec defines up to 32 ports
172 * 4 bits for the device SATA spec defines up to 15 devices behind PMP
173 */
174#define iorb_unit(a, p, d) ((((u16) (a) & 0x0fU) << 8) | \
175 (((u16) (p) & 0x0fU) << 4) | \
176 (((u16) (d) & 0x0fU)))
177#define iorb_unit_adapter(iorb) (((u16) (iorb)->UnitHandle >> 8) & 0x07U)
178#define iorb_unit_port(iorb) (((u16) (iorb)->UnitHandle >> 4) & 0x0fU)
179#define iorb_unit_device(iorb) ((u16) (iorb)->UnitHandle & 0x0fU)
180
181/*******************************************************************************
182 * Convenience macros for IORB processing functions
183 */
184/* is this IORB on driver or port level? */
185#define iorb_driver_level(iorb) ((iorb)->CommandCode == IOCC_CONFIGURATION)
186
187/* is this IORB to be inserted at the beginnig of the IORB queue? */
188#define iorb_priority(iorb) ((iorb)->CommandCode == IOCC_DEVICE_CONTROL && \
189 (iorb)->CommandModifier == IOCM_ABORT))
190
191/* access IORB ADD workspace */
192#define add_workspace(iorb) ((ADD_WORKSPACE _far *) &(iorb)->ADDWorkSpace)
193
194/* free resources in ADD workspace (timer, buffer, ...) */
195#define aws_free(aws) if ((aws)->timer != 0) { \
196 ADD_CancelTimer((aws)->timer); \
197 (aws)->timer = 0; \
198 } \
199 if ((aws)->buf != NULL) { \
200 free((aws)->buf); \
201 (aws)->buf = NULL; \
202 }
203
204/******************************************************************************
205 * PCI generic IDs and macros
206 */
207#define PCI_ANY_ID 0xffffU
208#define PCI_VDEVICE(vendor, device) PCI_VENDOR_ID_##vendor, (device), \
209 PCI_ANY_ID, PCI_ANY_ID, 0, 0
210
211/******************************************************************************
212 * PCI vendor IDs for AHCI adapters known to this driver (copied from Linux
213 * pci_ids.h)
214 */
215#define PCI_VENDOR_ID_AL 0x10b9
216#define PCI_VENDOR_ID_AMD 0x1022
217#define PCI_VENDOR_ID_AT 0x1259
218#define PCI_VENDOR_ID_ATI 0x1002
219#define PCI_VENDOR_ID_ATT 0x11c1
220#define PCI_VENDOR_ID_CMD 0x1095
221#define PCI_VENDOR_ID_CT 0x102c
222#define PCI_VENDOR_ID_INTEL 0x8086
223#define PCI_VENDOR_ID_INITIO 0x1101
224#define PCI_VENDOR_ID_JMICRON 0x197B
225#define PCI_VENDOR_ID_MARVELL 0x11ab
226#define PCI_VENDOR_ID_NVIDIA 0x10de
227#define PCI_VENDOR_ID_PROMISE 0x105a
228#define PCI_VENDOR_ID_SI 0x1039
229#define PCI_VENDOR_ID_VIA 0x1106
230
231/******************************************************************************
232 * PCI class IDs we're interested in (copied from Linux pci_ids.h)
233 */
234#define PCI_BASE_CLASS_STORAGE 0x01
235#define PCI_CLASS_STORAGE_SCSI 0x0100
236#define PCI_CLASS_STORAGE_IDE 0x0101
237#define PCI_CLASS_STORAGE_FLOPPY 0x0102
238#define PCI_CLASS_STORAGE_IPI 0x0103
239#define PCI_CLASS_STORAGE_RAID 0x0104
240#define PCI_CLASS_STORAGE_SATA 0x0106
241#define PCI_CLASS_STORAGE_SATA_AHCI 0x010601
242#define PCI_CLASS_STORAGE_SAS 0x0107
243#define PCI_CLASS_STORAGE_OTHER 0x0180
244
245/******************************************************************************
246 * ANSI color code constants
247 */
248#define ANSI_CLR_BRIGHT "\x1b[1m"
249#define ANSI_CLR_RED "\x1b[31m"
250#define ANSI_CLR_GREEN "\x1b[32m"
251#define ANSI_CLR_BLUE "\x1b[34m"
252#define ANSI_CLR_CYAN "\x1b[36m"
253#define ANSI_CLR_WHITE "\x1b[37m"
254#define ANSI_RESET "\x1b[0m"
255
256
257/* ------------------------ typedefs and structures ------------------------ */
258
259typedef unsigned int size_t;
260
261/* PCI device information structure; this is used both for scanning and for
262 * identification purposes in 'AD_INFO'; based on the Linux pci_device_id
263 * structure but hard-wired to use board_* constants for 'driver_data'
264 */
265typedef struct {
266 u16 vendor; /* PCI device vendor/manufacturer */
267 u16 device; /* PCI device ID inside vendor scope */
268 u16 subvendor; /* subsystem vendor (unused so far) */
269 u16 subdevice; /* subsystem device (unused so far) */
270 u32 class; /* PCI device class */
271 u32 class_mask; /* bits to match when scanning for 'class' */
272 u32 board; /* AHCI controller board type (board_* constants) */
273 char *chipname; /* human readable chip ID string */
274} PCI_ID;
275
276/* IORB queue; since IORB queues are updated at interrupt time, the
277 * corresponding pointers (not the data they point to) need to be volatile.
278 */
279typedef struct {
280 IORBH _far *volatile root; /* root of request list */
281 IORBH _far *volatile tail; /* tail of request list */
282} IORB_QUEUE;
283
284/* port information structure */
285typedef struct {
286 IORB_QUEUE iorb_queue; /* IORB queue for this port */
287 unsigned dev_max : 4; /* maximum device number on this port (0-15) */
288 unsigned cmd_slot : 5; /* current command slot index (using round-
289 * robin indexes to prevent starvation) */
290
291 volatile u32 ncq_cmds; /* bitmap for NCQ commands issued */
292 volatile u32 reg_cmds; /* bitmap for regular commands issued */
293
294 struct {
295 unsigned allocated : 1; /* if != 0, device is allocated */
296 unsigned present : 1; /* if != 0, device is present */
297 unsigned lba48 : 1; /* if != 0, device supports 48-bit LBA */
298 unsigned atapi : 1; /* if != 0, this is an ATAPI device */
299 unsigned atapi_16 : 1; /* if != 0, device suports 16-byte cmds */
300 unsigned removable : 1; /* if != 0, device has removable media */
301 unsigned dev_type : 5; /* device type (UIB_TYPE_* in iorb.h) */
302 unsigned ncq_max : 5; /* maximum tag number for queued commands */
303 UNITINFO _far *unit_info; /* pointer to modified unit info */
304 } devs[15];
305} P_INFO;
306
307/* adapter information structure */
308typedef struct {
309 PCI_ID *pci; /* pointer to corresponding PCI ID */
310
311 unsigned port_max : 5; /* maximum port number (0-31) */
312 unsigned cmd_max : 5; /* maximum cmd slot number (0-31) */
313 unsigned port_scan_done : 1; /* if != 0, port scan already done */
314 unsigned busy : 1; /* if != 0, adapter is busy */
315
316 u32 port_map; /* bitmap of active ports */
317
318 /* initial adapter configuration from BIOS */
319 u32 bios_config[HOST_CAP2 / sizeof(u32) + 1];
320
321 u32 cap; /* working copy of CAP register */
322 u32 cap2; /* working copy of CAP2 register */
323 u32 flags; /* adapter flags */
324
325 HRESOURCE rm_adh; /* resource handle for adapter */
326 HRESOURCE rm_mmio; /* resource handle for MMIO */
327 HRESOURCE rm_irq; /* resource handle for IRQ */
328
329 u8 bus; /* PCI bus number */
330 u8 dev_func; /* PCI device and function number */
331 u16 irq; /* interrupt number */
332
333 u32 mmio_phys; /* physical address of MMIO region */
334 u8 _far *mmio; /* pointer to this adapter's MMIO region */
335
336 u32 dma_buf_phys; /* physical address of DMA scratch buffer */
337 u8 _far *dma_buf[PORT_DMA_BUF_SEGS]; /* DMA scatch buffer */
338
339 P_INFO ports[AHCI_MAX_PORTS]; /* SATA ports on this adapter */
340} AD_INFO;
341
342/* ADD workspace in IORB (must not exceed 16 bytes) */
343typedef struct {
344 void (*ppfunc)(IORBH _far *iorb); /* post-processing function */
345 void *buf; /* response buffer (e.g. for identify cmds) */
346 ULONG timer; /* timer for timeout procesing */
347 USHORT blocks; /* number of blocks to be transferred */
348 unsigned processing : 1; /* IORB is being processd */
349 unsigned idempotent : 1; /* IORB is idempotent (can be retried) */
350 unsigned queued_hw : 1; /* IORB has been queued to hardware */
351 unsigned no_ncq : 1; /* must not use native command queuing */
352 unsigned is_ncq : 1; /* should use native command queueing */
353 unsigned complete : 1; /* IORB has completed processing */
354 unsigned cmd_slot : 5; /* AHCI command slot for this IORB */
355} ADD_WORKSPACE;
356
357/* -------------------------- function prototypes -------------------------- */
358
359/* init.asm */
360extern u32 _cdecl readl (void _far *addr);
361extern u32 _cdecl writel (void _far *addr, u32 val);
362extern void _far * _cdecl memcpy (void _far *v_dst, void _far *v_src, int len);
363extern void _far * _cdecl memset (void _far *p, int ch, size_t len);
364extern void _cdecl _far restart_hook (void);
365extern void _cdecl _far reset_hook (void);
366extern void _cdecl _far engine_hook (void);
367
368/* os2ahci.c */
369extern USHORT init_drv (RPINITIN _far *req);
370extern USHORT exit_drv (int func);
371extern void _cdecl _far _loadds add_entry (IORBH _far *iorb);
372extern void trigger_engine (void);
373extern int trigger_engine_1 (void);
374extern void send_iorb (IORBH _far *iorb);
375extern void iocc_configuration (IORBH _far *iorb);
376extern void iocc_device_control (IORBH _far *iorb);
377extern void iocc_unit_control (IORBH _far *iorb);
378extern void iocm_device_table (IORBH _far *iorb);
379extern void iocc_geometry (IORBH _far *iorb);
380extern void iocc_execute_io (IORBH _far *iorb);
381extern void iocc_unit_status (IORBH _far *iorb);
382extern void iocc_adapter_passthru (IORBH _far *iorb);
383extern void iorb_queue_add (IORB_QUEUE _far *queue, IORBH _far *iorb);
384extern int iorb_queue_del (IORB_QUEUE _far *queue, IORBH _far *iorb);
385extern void iorb_seterr (IORBH _far *iorb, USHORT error_code);
386extern void iorb_done (IORBH _far *iorb);
387extern void iorb_requeue (IORBH _far *iorb);
388extern void _cdecl _far timeout_callback (ULONG timer_handle, ULONG p1, ULONG p2);
389
390/* ahci.c */
391extern int ahci_save_bios_config (AD_INFO *ai);
392extern int ahci_restore_bios_config (AD_INFO *ai);
393extern int ahci_restore_initial_config (AD_INFO *ai);
394extern AHCI_PORT_CFG *ahci_save_port_config (AD_INFO *ai, int p);
395extern void ahci_restore_port_config (AD_INFO *ai, int p,
396 AHCI_PORT_CFG *pc);
397extern int ahci_enable_ahci (AD_INFO *ai);
398extern int ahci_scan_ports (AD_INFO *ai);
399extern int ahci_complete_init (AD_INFO *ai);
400extern int ahci_reset_port (AD_INFO *ai, int p, int ei);
401extern int ahci_start_port (AD_INFO *ai, int p, int ei);
402extern void ahci_start_fis_rx (AD_INFO *ai, int p);
403extern void ahci_start_engine (AD_INFO *ai, int p);
404extern int ahci_stop_port (AD_INFO *ai, int p);
405extern int ahci_stop_fis_rx (AD_INFO *ai, int p);
406extern int ahci_stop_engine (AD_INFO *ai, int p);
407extern void ahci_exec_iorb (IORBH _far *iorb, int ncq_capable,
408 int (*func)(IORBH _far *, int));
409extern void ahci_exec_polled_iorb (IORBH _far *iorb,
410 int (*func)(IORBH _far *, int),
411 ULONG timeout);
412extern int ahci_exec_polled_cmd (AD_INFO *ai, int p, int d,
413 int timeout, int cmd, ...);
414extern int ahci_set_dev_idle (AD_INFO *ai, int p, int d, int idle);
415extern int ahci_flush_cache (AD_INFO *ai, int p, int d);
416
417extern int ahci_intr (u16 irq);
418extern void ahci_port_intr (AD_INFO *ai, int p);
419extern void ahci_error_intr (AD_INFO *ai, int p, u32 irq_stat);
420
421extern void ahci_get_geometry (IORBH _far *iorb);
422extern void ahci_unit_ready (IORBH _far *iorb);
423extern void ahci_read (IORBH _far *iorb);
424extern void ahci_verify (IORBH _far *iorb);
425extern void ahci_write (IORBH _far *iorb);
426extern void ahci_execute_cdb (IORBH _far *iorb);
427extern void ahci_execute_ata (IORBH _far *iorb);
428
429/* libc.c */
430extern void init_com1 (void);
431extern int vsprintf (char _far *buf, const char *fmt, va_list va);
432extern int sprintf (char _far *buf, const char *fmt, ...);
433extern void vfprintf (const char *fmt, va_list va);
434extern void _cdecl printf (const char *fmt, ...);
435extern void cprintf (const char *fmt, ...);
436extern void phex (const void _far *p, int len,
437 const char *fmt, ...);
438extern size_t strlen (const char _far *s);
439extern char _far *strcpy (char _far *dst, const char _far *src);
440extern int memcmp (void _far *p1, void _far *p2, size_t len);
441extern long strtol (const char _far *buf,
442 const char _far * _far *ep, int base);
443extern void *malloc (size_t len);
444extern void free (void *ptr);
445extern void mdelay_cal (void);
446extern void mdelay (u32 millies);
447extern void msleep (u32 millies);
448extern void panic (char *msg);
449extern int disable (void);
450extern void enable (void);
451
452/* pci.c */
453extern int add_pci_id (u16 vendor, u16 device);
454extern void scan_pci_bus (void);
455extern int pci_enable_int (UCHAR bus, UCHAR dev_func);
456extern void pci_hack_virtualbox(void);
457extern char *vendor_from_id (u16 vendor);
458extern char *device_from_id (u16 device);
459
460/* ctxhook.c */
461extern void _cdecl restart_ctxhook (ULONG parm);
462extern void _cdecl reset_ctxhook (ULONG parm);
463extern void _cdecl engine_ctxhook (ULONG parm);
464
465/* ---------------------------- global variables --------------------------- */
466
467extern char _cdecl end_of_data; /* label at the end of all data segments */
468extern void _cdecl _near end_of_code(); /* label at the end of all code segments */
469
470extern int debug; /* if != 0, print debug messages to COM1 */
471extern int thorough_scan; /* if != 0, perform thorough PCI scan */
472extern int init_reset; /* if != 0, reset ports during init */
473
474extern HDRIVER rm_drvh; /* resource manager driver handle */
475extern USHORT add_handle; /* adapter device driver handle */
476extern UCHAR timer_pool[]; /* timer pool */
477
478extern PCI_ID pci_ids[]; /* SATA adapter PCI IDs */
479extern ULONG drv_lock; /* driver-level spinlock */
480extern IORB_QUEUE driver_queue; /* driver-level IORB queue */
481extern AD_INFO ad_infos[]; /* adapter information list */
482extern int ad_info_cnt; /* number of entries in ad_infos[] */
483extern int init_complete; /* if != 0, initialization has completed */
484
485extern u16 com_base; /* debug COM port base address */
486
487/* port restart context hook and input data */
488extern ULONG restart_ctxhook_h;
489extern volatile u32 ports_to_restart[MAX_AD];
490
491/* port reset context hook and input data */
492extern ULONG reset_ctxhook_h;
493extern volatile u32 ports_to_reset[MAX_AD];
494extern IORB_QUEUE abort_queue;
495
496/* trigger engine context hook and input data */
497extern ULONG engine_ctxhook_h;
498
499/* apapter/port-specific options saved when parsing the command line */
500extern u8 link_speed[MAX_AD][AHCI_MAX_PORTS];
501extern u8 disable_ncq[MAX_AD][AHCI_MAX_PORTS];
502
Note: See TracBrowser for help on using the repository browser.