The Design and Implementation of the FreeBSD Operating System, Second Edition
Now available: The Design and Implementation of the FreeBSD Operating System (Second Edition)


[ source navigation ] [ diff markup ] [ identifier search ] [ freetext search ] [ file search ] [ list types ] [ track identifier ]

FreeBSD/Linux Kernel Cross Reference
sys/dev/twa/tw_cl_externs.h

Version: -  FREEBSD  -  FREEBSD-13-STABLE  -  FREEBSD-13-0  -  FREEBSD-12-STABLE  -  FREEBSD-12-0  -  FREEBSD-11-STABLE  -  FREEBSD-11-0  -  FREEBSD-10-STABLE  -  FREEBSD-10-0  -  FREEBSD-9-STABLE  -  FREEBSD-9-0  -  FREEBSD-8-STABLE  -  FREEBSD-8-0  -  FREEBSD-7-STABLE  -  FREEBSD-7-0  -  FREEBSD-6-STABLE  -  FREEBSD-6-0  -  FREEBSD-5-STABLE  -  FREEBSD-5-0  -  FREEBSD-4-STABLE  -  FREEBSD-3-STABLE  -  FREEBSD22  -  l41  -  OPENBSD  -  linux-2.6  -  MK84  -  PLAN9  -  xnu-8792 
SearchContext: -  none  -  3  -  10 

    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$
   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 
   48 extern TW_INT8                  tw_cli_fw_img[];
   49 extern TW_INT32                 tw_cli_fw_img_size;
   50 extern 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. */
   58 extern TW_INT32 tw_cli_flash_firmware(struct tw_cli_ctlr_context *ctlr);
   59 
   60 /* Hard reset the controller. */
   61 extern TW_INT32 tw_cli_hard_reset(struct tw_cli_ctlr_context *ctlr);
   62 
   63 #endif /* TW_OSL_FLASH_FIRMWARE */
   64 
   65 /* Do controller initialization. */
   66 extern TW_INT32 tw_cli_start_ctlr(struct tw_cli_ctlr_context *ctlr);
   67 
   68 /* Establish a logical connection with the firmware on the controller. */
   69 extern 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. */
   82 extern TW_INT32 tw_cli_submit_cmd(struct tw_cli_req_context *req);
   83 
   84 /* Get a firmware parameter. */
   85 extern 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. */
   90 extern 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. */
   95 extern TW_INT32 tw_cli_submit_and_poll_request(struct tw_cli_req_context *req,
   96         TW_UINT32 timeout);
   97 
   98 /* Soft reset the controller. */
   99 extern 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. */
  102 extern 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). */
  106 extern TW_INT32 tw_cli_get_aen(struct tw_cli_ctlr_context *ctlr);
  107 
  108 /* Fill in the scatter/gather list. */
  109 extern 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. */
  117 extern TW_VOID  tw_cli_process_host_intr(struct tw_cli_ctlr_context *ctlr);
  118 
  119 /* Process an attention interrupt. */
  120 extern TW_VOID  tw_cli_process_attn_intr(struct tw_cli_ctlr_context *ctlr);
  121 
  122 /* Process a command interrupt. */
  123 extern TW_VOID  tw_cli_process_cmd_intr(struct tw_cli_ctlr_context *ctlr);
  124 
  125 /* Process a response interrupt from the controller. */
  126 extern 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. */
  129 extern TW_INT32 tw_cli_submit_pending_queue(struct tw_cli_ctlr_context *ctlr);
  130 
  131 /* Process all requests in the complete queue. */
  132 extern TW_VOID  tw_cli_process_complete_queue(struct tw_cli_ctlr_context *ctlr);
  133 
  134 /* CL internal callback for SCSI/fw passthru requests. */
  135 extern TW_VOID  tw_cli_complete_io(struct tw_cli_req_context *req);
  136 
  137 /* Completion routine for SCSI requests. */
  138 extern TW_VOID  tw_cli_scsi_complete(struct tw_cli_req_context *req);
  139 
  140 /* Callback for get/set param requests. */
  141 extern TW_VOID  tw_cli_param_callback(struct tw_cli_req_context *req);
  142 
  143 /* Callback for Req Sense commands to get AEN's. */
  144 extern TW_VOID  tw_cli_aen_callback(struct tw_cli_req_context *req);
  145 
  146 /* Decide what to do with a retrieved AEN. */
  147 extern TW_UINT16        tw_cli_manage_aen(struct tw_cli_ctlr_context *ctlr,
  148         struct tw_cli_req_context *req);
  149 
  150 /* Enable controller interrupts. */
  151 extern TW_VOID
  152         tw_cli_enable_interrupts(struct tw_cli_ctlr_context *ctlr_handle);
  153 
  154 /* Disable controller interrupts. */
  155 extern 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). */
  163 extern 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. */
  168 extern 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. */
  171 extern 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. */
  174 extern 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. */
  177 extern TW_VOID  tw_cli_drain_pending_queue(struct tw_cli_ctlr_context *ctlr);
  178 
  179 /* Drain the controller response queue. */
  180 extern TW_INT32 tw_cli_drain_response_queue(struct tw_cli_ctlr_context *ctlr);
  181 
  182 /* Find a particular response in the controller response queue. */
  183 extern TW_INT32 tw_cli_find_response(struct tw_cli_ctlr_context *ctlr,
  184         TW_INT32 req_id);
  185 
  186 /* Drain the controller AEN queue. */
  187 extern TW_INT32 tw_cli_drain_aen_queue(struct tw_cli_ctlr_context *ctlr);
  188 
  189 /* Determine if a given AEN has been posted by the firmware. */
  190 extern TW_INT32 tw_cli_find_aen(struct tw_cli_ctlr_context *ctlr,
  191         TW_UINT16 aen_code);
  192 
  193 /* Poll for a given status to show up in the firmware status register. */
  194 extern TW_INT32 tw_cli_poll_status(struct tw_cli_ctlr_context *ctlr,
  195         TW_UINT32 status, TW_UINT32 timeout);
  196 
  197 /* Get a free CL internal request context packet. */
  198 extern struct tw_cli_req_context *
  199         tw_cli_get_request(struct tw_cli_ctlr_context *ctlr
  200 #ifdef TW_OSL_NON_DMA_MEM_ALLOC_PER_REQUEST
  201         , struct tw_cl_req_packet *req_pkt
  202 #endif /* TW_OSL_NON_DMA_MEM_ALLOC_PER_REQUEST */
  203         );
  204 
  205 /* Notify OSL of controller info (fw/BIOS versions, etc.). */
  206 extern TW_VOID  tw_cli_notify_ctlr_info(struct tw_cli_ctlr_context *ctlr);
  207 
  208 /* Make sure that the firmware status register reports a proper status. */
  209 extern TW_INT32 tw_cli_check_ctlr_state(struct tw_cli_ctlr_context *ctlr,
  210         TW_UINT32 status_reg);
  211 
  212 
  213 
  214 #endif /* TW_CL_EXTERNS_H */

Cache object: 96ad6c0e658d32ccf91ab521e42b40f5


[ source navigation ] [ diff markup ] [ identifier search ] [ freetext search ] [ file search ] [ list types ] [ track identifier ]


This page is part of the FreeBSD/Linux Linux Kernel Cross-Reference, and was automatically generated using a modified version of the LXR engine.