617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * Copyright 2009 Sun Microsystems, Inc. All rights reserved.
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * Use is subject to license terms.
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * Part of Intel(R) Manageability Engine Interface Linux driver
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * Copyright (c) 2003 - 2008 Intel Corp.
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * All rights reserved.
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * Redistribution and use in source and binary forms, with or without
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * modification, are permitted provided that the following conditions
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * 1. Redistributions of source code must retain the above copyright
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * notice, this list of conditions, and the following disclaimer,
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * without modification.
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * 2. Redistributions in binary form must reproduce at minimum a disclaimer
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * substantially similar to the "NO WARRANTY" disclaimer below
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * ("Disclaimer") and any redistribution must be conditioned upon
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * including a substantially similar Disclaimer requirement for further
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * binary redistribution.
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * 3. Neither the names of the above-listed copyright holders nor the names
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * of any contributors may be used to endorse or promote products derived
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * from this software without specific prior written permission.
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * Alternatively, this software may be distributed under the terms of the
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * GNU General Public License ("GPL") version 2 as published by the Free
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * Software Foundation.
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * NO WARRANTY
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * POSSIBILITY OF SUCH DAMAGES.
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * error code definition
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * Number of queue lists used by this driver
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * Maximum transmission unit (MTU) of heci messages
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * HECI HW Section
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan/* HECI registers */
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan/* H_CB_WW - Host Circular Buffer (CB) Write Window register */
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan/* H_CSR - Host Control Status register */
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan/* ME_CB_RW - ME Circular Buffer Read Window register (read only) */
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan/* ME_CSR_HA - ME Control Status Host Access register (read only) */
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan/* register bits of H_CSR (Host Control Status register) */
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan/* Host Circular Buffer Depth - maximum number of 32-bit entries in CB */
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan/* Host Circular Buffer Write Pointer */
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan/* Host Circular Buffer Read Pointer */
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan/* Host Reset */
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan/* Host Ready */
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan/* Host Interrupt Generate */
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan/* Host Interrupt Status */
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan/* Host Interrupt Enable */
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * register bits of ME_CSR_HA (ME Control Status Host Access register)
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * ME CB (Circular Buffer) Depth HRA (Host Read Access)
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * - host read only access to ME_CBD
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan/* ME CB Write Pointer HRA - host read only access to ME_CBWP */
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan/* ME CB Read Pointer HRA - host read only access to ME_CBRP */
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan/* ME Reset HRA - host read only access to ME_RST */
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan/* ME Ready HRA - host read only access to ME_RDY */
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan/* ME Interrupt Generate HRA - host read only access to ME_IG */
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan/* ME Interrupt Status HRA - host read only access to ME_IS */
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan/* ME Interrupt Enable HRA - host read only access to ME_IE */
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan/* #define HECI_PTHI_MINOR_NUMBER 0 */
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan#define MAKE_MINOR_NUM(minor, instance) (((uint_t)(minor) << 8) \
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan#define HECI_MINOR_TO_IFNUM(x) (((x) >> 8) & 0xFF)
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * debug kernel print macro define
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan cmn_err(CE_CONT, format"%s", __func__, __VA_ARGS__)
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan#define DBG(...) { if (heci_debug) PRN(__VA_ARGS__); }
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan cmn_err(CE_WARN, "Assertion failed! %s,%s,line=%d", #expr, \
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan p = n, n = list_next(p))
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan (ptr)->list_next = (ptr); (ptr)->list_prev = (ptr); \
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan#define list_del(p) { (p)->list_next->list_prev = (p)->list_prev; \
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan const __typeof(((type *)0)->member) *__tmpp = (ptr); \
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan (type *)(void *)((char *)__tmpp - ((size_t)&((type *)0)->member)); \
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan/* type unsafe version */
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan#define list_for_each_entry_safe(pos, n, head, member, type) \
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan for (pos = find_struct((head)->list_next, type, member), \
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan n = find_struct(pos->member.list_next, type, member); \
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan pos = n, n = find_struct(n->member.list_next, type, member))
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * time to wait HECI become ready after init
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * watch dog definition
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan#define HECI_WD_STATE_INDEPENDENCE_MSG_SENT (1 << 0)
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan/* File state */
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan/* HECI device states */
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan/* HECI CB */
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan/* HECI user data struct */
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan#define HECI_CONNECT_TIMEOUT 3 /* at least 2 seconds */
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * HECI BUS Interface Section
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan uint8_t reserved[HECI_FC_MESSAGE_RESERVED_LENGTH];
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan/* Private file struct */
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan /* ID of client connected */
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan/* private device struct */
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * lists of queues
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan /* array of pointers to aio lists */
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan struct io_heci_list *io_list_array[HECI_IO_LISTS_NUMBER];
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan struct io_heci_list read_list; /* driver read queue */
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan struct io_heci_list write_list; /* driver write queue */
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan struct io_heci_list write_waiting_list; /* write waiting queue */
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan struct io_heci_list ctrl_wr_list; /* managed write IOCTL list */
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan struct io_heci_list ctrl_rd_list; /* managed read IOCTL list */
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan struct io_heci_list pthi_cmd_list; /* PTHI list for cmd waiting */
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan /* driver managed PTHI list for reading completed pthi cmd data */
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * list of files
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * memory of device
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * lock for the device
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * hw states of host and fw(ME)
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * waiting queue for receive message from FW
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * heci device states
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan uint32_t rd_msg_buf[128]; /* used for control messages */
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan uint32_t wr_msg_buf[128]; /* used for control messages */
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan uint32_t ext_msg_buf[8]; /* for control responses */
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan struct heci_me_client *me_clients; /* Note: need to be allocated */
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan uint8_t heci_me_clients[32]; /* list of existing clients */
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan uint8_t heci_host_clients[32]; /* list of existing clients */
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan uint16_t wd_timeout; /* seconds ((wd_data[1] << 8) + wd_data[0]) */
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan int wd_bypass; /* if 1, don't refresh watchdog ME client */
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan struct heci_file files[256]; /* a file handle for each client */
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * read_heci_register - Read a byte from the heci device
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * @device: the device structure
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * @offset: offset from which to read the data
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * @return the byte read.
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Loganuint32_t read_heci_register(struct iamt_heci_device *device,
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan unsigned long offset);
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * write_heci_register - Write 4 bytes to the heci device
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * @device: the device structure
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * @offset: offset from which to write the data
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan * @value: the byte to write
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Loganvoid write_heci_register(struct iamt_heci_device *device, unsigned long offset,
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan#define UIO_OFFSET(p) (((struct uio *)p)->uio_offset)
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan#define UIO_LENGTH(p) (((struct uio *)p)->uio_resid)
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan#define UIO_BUFF(p) ((char *)((struct uio *)p)->uio_iov->iov_base)
617e2443dfc17fe44fd44c0675d6aad2ffc9df42Mark Logan#endif /* _HECI_DATA_STRUCTURES_H_ */