tw_cl_externs.h revision 144966
1/* 2 * Copyright (c) 2004-05 Applied Micro Circuits Corporation. 3 * Copyright (c) 2004-05 Vinod Kashyap 4 * All rights reserved. 5 * 6 * Redistribution and use in source and binary forms, with or without 7 * modification, are permitted provided that the following conditions 8 * are met: 9 * 1. Redistributions of source code must retain the above copyright 10 * notice, this list of conditions and the following disclaimer. 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 AND CONTRIBUTORS ``AS IS'' AND 16 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 17 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 18 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 19 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 20 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 21 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 22 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 23 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 24 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 25 * SUCH DAMAGE. 26 * 27 * $FreeBSD: head/sys/dev/twa/tw_cl_externs.h 144966 2005-04-12 22:07:11Z vkashyap $ 28 */ 29 30/* 31 * AMCC'S 3ware driver for 9000 series storage controllers. 32 * 33 * Author: Vinod Kashyap 34 */ 35 36 37 38#ifndef TW_CL_EXTERNS_H 39 40#define TW_CL_EXTERNS_H 41 42 43/* 44 * Data structures and functions global to the Common Layer. 45 */ 46 47 48extern TW_INT8 tw_cli_fw_img[]; 49extern TW_INT32 tw_cli_fw_img_size; 50extern TW_INT8 *tw_cli_severity_string_table[]; 51 52 53#ifdef TW_OSL_FLASH_FIRMWARE 54 55/* Functions in tw_cl_init.c */ 56 57/* Flash bundled firmware image onto controller. */ 58extern TW_INT32 tw_cli_flash_firmware(struct tw_cli_ctlr_context *ctlr); 59 60/* Hard reset the controller. */ 61extern TW_INT32 tw_cli_hard_reset(struct tw_cli_ctlr_context *ctlr); 62 63#endif /* TW_OSL_FLASH_FIRMWARE */ 64 65/* Do controller initialization. */ 66extern TW_INT32 tw_cli_start_ctlr(struct tw_cli_ctlr_context *ctlr); 67 68/* Establish a logical connection with the firmware on the controller. */ 69extern TW_INT32 tw_cli_init_connection(struct tw_cli_ctlr_context *ctlr, 70 TW_UINT16 message_credits, TW_UINT32 set_features, 71 TW_UINT16 current_fw_srl, TW_UINT16 current_fw_arch_id, 72 TW_UINT16 current_fw_branch, TW_UINT16 current_fw_build, 73 TW_UINT16 *fw_on_ctlr_srl, TW_UINT16 *fw_on_ctlr_arch_id, 74 TW_UINT16 *fw_on_ctlr_branch, TW_UINT16 *fw_on_ctlr_build, 75 TW_UINT32 *init_connect_result); 76 77 78 79/* Functions in tw_cl_io.c */ 80 81/* Submit a command packet to the firmware on the controller. */ 82extern TW_INT32 tw_cli_submit_cmd(struct tw_cli_req_context *req); 83 84/* Get a firmware parameter. */ 85extern TW_INT32 tw_cli_get_param(struct tw_cli_ctlr_context *ctlr, 86 TW_INT32 table_id, TW_INT32 parameter_id, TW_VOID *param_data, 87 TW_INT32 size, TW_VOID (* callback)(struct tw_cli_req_context *req)); 88 89/* Set a firmware parameter. */ 90extern TW_INT32 tw_cli_set_param(struct tw_cli_ctlr_context *ctlr, 91 TW_INT32 table_id, TW_INT32 param_id, TW_INT32 param_size, 92 TW_VOID *data, TW_VOID (* callback)(struct tw_cli_req_context *req)); 93 94/* Submit a command to the firmware and poll for completion. */ 95extern TW_INT32 tw_cli_submit_and_poll_request(struct tw_cli_req_context *req, 96 TW_UINT32 timeout); 97 98/* Soft reset the controller. */ 99extern TW_INT32 tw_cli_soft_reset(struct tw_cli_ctlr_context *ctlr); 100 101/* Send down a SCSI command to the firmware (usually, an internal Req Sense. */ 102extern TW_INT32 tw_cli_send_scsi_cmd(struct tw_cli_req_context *req, 103 TW_INT32 cmd); 104 105/* Get an AEN from the firmware (by sending down a Req Sense). */ 106extern TW_INT32 tw_cli_get_aen(struct tw_cli_ctlr_context *ctlr); 107 108/* Fill in the scatter/gather list. */ 109extern TW_VOID tw_cli_fill_sg_list(struct tw_cli_ctlr_context *ctlr, 110 TW_VOID *sgl_src, TW_VOID *sgl_dest, TW_INT32 num_sgl_entries); 111 112 113 114/* Functions in tw_cl_intr.c */ 115 116/* Process a host interrupt. */ 117extern TW_VOID tw_cli_process_host_intr(struct tw_cli_ctlr_context *ctlr); 118 119/* Process an attention interrupt. */ 120extern TW_VOID tw_cli_process_attn_intr(struct tw_cli_ctlr_context *ctlr); 121 122/* Process a command interrupt. */ 123extern TW_VOID tw_cli_process_cmd_intr(struct tw_cli_ctlr_context *ctlr); 124 125/* Process a response interrupt from the controller. */ 126extern TW_INT32 tw_cli_process_resp_intr(struct tw_cli_ctlr_context *ctlr); 127 128/* Submit any requests in the pending queue to the firmware. */ 129extern TW_INT32 tw_cli_submit_pending_queue(struct tw_cli_ctlr_context *ctlr); 130 131/* Process all requests in the complete queue. */ 132extern TW_VOID tw_cli_process_complete_queue(struct tw_cli_ctlr_context *ctlr); 133 134/* CL internal callback for SCSI/fw passthru requests. */ 135extern TW_VOID tw_cli_complete_io(struct tw_cli_req_context *req); 136 137/* Completion routine for SCSI requests. */ 138extern TW_VOID tw_cli_scsi_complete(struct tw_cli_req_context *req); 139 140/* Callback for get/set param requests. */ 141extern TW_VOID tw_cli_param_callback(struct tw_cli_req_context *req); 142 143/* Callback for Req Sense commands to get AEN's. */ 144extern TW_VOID tw_cli_aen_callback(struct tw_cli_req_context *req); 145 146/* Decide what to do with a retrieved AEN. */ 147extern TW_UINT16 tw_cli_manage_aen(struct tw_cli_ctlr_context *ctlr, 148 struct tw_cli_req_context *req); 149 150/* Enable controller interrupts. */ 151extern TW_VOID 152 tw_cli_enable_interrupts(struct tw_cli_ctlr_context *ctlr_handle); 153 154/* Disable controller interrupts. */ 155extern TW_VOID 156 tw_cli_disable_interrupts(struct tw_cli_ctlr_context *ctlr_handle); 157 158 159 160/* Functions in tw_cl_misc.c */ 161 162/* Print if dbg_level is appropriate (by calling OS Layer). */ 163extern TW_VOID tw_cli_dbg_printf(TW_UINT8 dbg_level, 164 struct tw_cl_ctlr_handle *ctlr_handle, const TW_INT8 *cur_func, 165 TW_INT8 *fmt, ...); 166 167/* Describe meaning of each set bit in the given register. */ 168extern TW_INT8 *tw_cli_describe_bits(TW_UINT32 reg, TW_INT8 *str); 169 170/* Complete all requests in the complete queue with a RESET status. */ 171extern TW_VOID tw_cli_drain_complete_queue(struct tw_cli_ctlr_context *ctlr); 172 173/* Complete all requests in the busy queue with a RESET status. */ 174extern TW_VOID tw_cli_drain_busy_queue(struct tw_cli_ctlr_context *ctlr); 175 176/* Complete all requests in the pending queue with a RESET status. */ 177extern TW_VOID tw_cli_drain_pending_queue(struct tw_cli_ctlr_context *ctlr); 178 179/* Drain the controller response queue. */ 180extern TW_INT32 tw_cli_drain_response_queue(struct tw_cli_ctlr_context *ctlr); 181 182/* Drain the controller AEN queue. */ 183extern TW_INT32 tw_cli_drain_aen_queue(struct tw_cli_ctlr_context *ctlr); 184 185/* Determine if a given AEN has been posted by the firmware. */ 186extern TW_INT32 tw_cli_find_aen(struct tw_cli_ctlr_context *ctlr, 187 TW_UINT16 aen_code); 188 189/* Poll for a given status to show up in the firmware status register. */ 190extern TW_INT32 tw_cli_poll_status(struct tw_cli_ctlr_context *ctlr, 191 TW_UINT32 status, TW_UINT32 timeout); 192 193/* Get a free CL internal request context packet. */ 194extern struct tw_cli_req_context * 195 tw_cli_get_request(struct tw_cli_ctlr_context *ctlr 196#ifdef TW_OSL_NON_DMA_MEM_ALLOC_PER_REQUEST 197 , struct tw_cl_req_packet *req_pkt 198#endif /* TW_OSL_NON_DMA_MEM_ALLOC_PER_REQUEST */ 199 ); 200 201/* Notify OSL of controller info (fw/BIOS versions, etc.). */ 202extern TW_VOID tw_cli_notify_ctlr_info(struct tw_cli_ctlr_context *ctlr); 203 204/* Make sure that the firmware status register reports a proper status. */ 205extern TW_INT32 tw_cli_check_ctlr_state(struct tw_cli_ctlr_context *ctlr, 206 TW_UINT32 status_reg); 207 208 209 210#endif /* TW_CL_EXTERNS_H */ 211