1/*
2 * Copyright 2002-2003, Thomas Kurschel. All rights reserved.
3 * Copyright 2003-2009, Haiku, Inc. All rights reserved.
4 * Distributed under the terms of the MIT License.
5 */
6#ifndef __ATA_H__
7#define __ATA_H__
8
9#include <device_manager.h>
10#include <KernelExport.h>
11
12// Controller Driver Node
13
14// attributes:
15
16// node type
17#define ATA_BUS_TYPE_NAME "bus/ata/v1"
18// maximum number of devices connected to controller (uint8, optional, default:2)
19#define ATA_CONTROLLER_MAX_DEVICES_ITEM "ata/max_devices"
20// set to not-0 if DMA is supported (uint8, optional, default:0)
21#define ATA_CONTROLLER_CAN_DMA_ITEM "ata/can_DMA"
22// name of controller (string, required)
23#define ATA_CONTROLLER_CONTROLLER_NAME_ITEM "ata/controller_name"
24
25union ata_task_file;
26typedef unsigned int ata_reg_mask;
27
28// channel cookie, issued by ata bus manager
29typedef void* ata_channel;
30
31// interface of controller driver
32typedef struct {
33	driver_module_info info;
34
35	void (*set_channel)(void *cookie, ata_channel channel);
36
37	status_t (*write_command_block_regs)(void *channelCookie,
38		union ata_task_file *file, ata_reg_mask mask);
39	status_t (*read_command_block_regs)(void *channelCookie,
40		union ata_task_file *file, ata_reg_mask mask);
41
42	uint8 (*get_altstatus)(void *channelCookie);
43	status_t (*write_device_control)(void *channelCookie, uint8 val);
44
45	status_t (*write_pio)(void *channelCookie, uint16 *data, int count,
46		bool force16Bit);
47	status_t (*read_pio)(void *channelCookie, uint16 *data, int count,
48		bool force16Bit);
49
50	status_t (*prepare_dma)(void *channelCookie, const physical_entry *sg_list,
51		size_t sg_list_count, bool write);
52	status_t (*start_dma)(void *channelCookie);
53	status_t (*finish_dma)(void *channelCookie);
54} ata_controller_interface;
55
56
57// Interface for Controller Driver
58
59// interface of bus manager as seen from controller driver
60// use this interface as the fixed consumer of your controller driver
61typedef struct {
62	driver_module_info info;
63
64	// status - status read from controller (_not_ alt_status, as reading
65	//          normal status acknowledges IRQ request of device)
66	status_t	(*interrupt_handler)(ata_channel channel, uint8 status);
67} ata_for_controller_interface;
68
69#define ATA_FOR_CONTROLLER_MODULE_NAME "bus_managers/ata/controller/driver_v1"
70
71#endif	/* __ATA_H__ */
72