/drivers/staging/ath6kl/include/common/htc.h
https://bitbucket.org/cyanogenmod/android_kernel_asus_tf300t · C Header · 227 lines · 117 code · 46 blank · 64 comment · 0 complexity · e018039fd5964311a638a5f657d8dcdd MD5 · raw file
- //------------------------------------------------------------------------------
- // <copyright file="htc.h" company="Atheros">
- // Copyright (c) 2004-2010 Atheros Corporation. All rights reserved.
- //
- //
- // Permission to use, copy, modify, and/or distribute this software for any
- // purpose with or without fee is hereby granted, provided that the above
- // copyright notice and this permission notice appear in all copies.
- //
- // THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
- // WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
- // MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
- // ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
- // WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
- // ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
- // OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
- //
- //
- //------------------------------------------------------------------------------
- //==============================================================================
- // Author(s): ="Atheros"
- //==============================================================================
- #ifndef __HTC_H__
- #define __HTC_H__
- #define A_OFFSETOF(type,field) (unsigned long)(&(((type *)NULL)->field))
- #define ASSEMBLE_UNALIGNED_UINT16(p,highbyte,lowbyte) \
- (((u16)(((u8 *)(p))[(highbyte)])) << 8 | (u16)(((u8 *)(p))[(lowbyte)]))
-
- /* alignment independent macros (little-endian) to fetch UINT16s or UINT8s from a
- * structure using only the type and field name.
- * Use these macros if there is the potential for unaligned buffer accesses. */
- #define A_GET_UINT16_FIELD(p,type,field) \
- ASSEMBLE_UNALIGNED_UINT16(p,\
- A_OFFSETOF(type,field) + 1, \
- A_OFFSETOF(type,field))
- #define A_SET_UINT16_FIELD(p,type,field,value) \
- { \
- ((u8 *)(p))[A_OFFSETOF(type,field)] = (u8)(value); \
- ((u8 *)(p))[A_OFFSETOF(type,field) + 1] = (u8)((value) >> 8); \
- }
-
- #define A_GET_UINT8_FIELD(p,type,field) \
- ((u8 *)(p))[A_OFFSETOF(type,field)]
-
- #define A_SET_UINT8_FIELD(p,type,field,value) \
- ((u8 *)(p))[A_OFFSETOF(type,field)] = (value)
- /****** DANGER DANGER ***************
- *
- * The frame header length and message formats defined herein were
- * selected to accommodate optimal alignment for target processing. This reduces code
- * size and improves performance.
- *
- * Any changes to the header length may alter the alignment and cause exceptions
- * on the target. When adding to the message structures insure that fields are
- * properly aligned.
- *
- */
- /* HTC frame header */
- PREPACK struct htc_frame_hdr {
- /* do not remove or re-arrange these fields, these are minimally required
- * to take advantage of 4-byte lookaheads in some hardware implementations */
- u8 EndpointID;
- u8 Flags;
- u16 PayloadLen; /* length of data (including trailer) that follows the header */
-
- /***** end of 4-byte lookahead ****/
-
- u8 ControlBytes[2];
-
- /* message payload starts after the header */
-
- } POSTPACK;
- /* frame header flags */
- /* send direction */
- #define HTC_FLAGS_NEED_CREDIT_UPDATE (1 << 0)
- #define HTC_FLAGS_SEND_BUNDLE (1 << 1) /* start or part of bundle */
- /* receive direction */
- #define HTC_FLAGS_RECV_UNUSED_0 (1 << 0) /* bit 0 unused */
- #define HTC_FLAGS_RECV_TRAILER (1 << 1) /* bit 1 trailer data present */
- #define HTC_FLAGS_RECV_UNUSED_2 (1 << 0) /* bit 2 unused */
- #define HTC_FLAGS_RECV_UNUSED_3 (1 << 0) /* bit 3 unused */
- #define HTC_FLAGS_RECV_BUNDLE_CNT_MASK (0xF0) /* bits 7..4 */
- #define HTC_FLAGS_RECV_BUNDLE_CNT_SHIFT 4
- #define HTC_HDR_LENGTH (sizeof(struct htc_frame_hdr))
- #define HTC_MAX_TRAILER_LENGTH 255
- #define HTC_MAX_PAYLOAD_LENGTH (4096 - sizeof(struct htc_frame_hdr))
- /* HTC control message IDs */
- #define HTC_MSG_READY_ID 1
- #define HTC_MSG_CONNECT_SERVICE_ID 2
- #define HTC_MSG_CONNECT_SERVICE_RESPONSE_ID 3
- #define HTC_MSG_SETUP_COMPLETE_ID 4
- #define HTC_MSG_SETUP_COMPLETE_EX_ID 5
- #define HTC_MAX_CONTROL_MESSAGE_LENGTH 256
-
- /* base message ID header */
- typedef PREPACK struct {
- u16 MessageID;
- } POSTPACK HTC_UNKNOWN_MSG;
-
- /* HTC ready message
- * direction : target-to-host */
- typedef PREPACK struct {
- u16 MessageID; /* ID */
- u16 CreditCount; /* number of credits the target can offer */
- u16 CreditSize; /* size of each credit */
- u8 MaxEndpoints; /* maximum number of endpoints the target has resources for */
- u8 _Pad1;
- } POSTPACK HTC_READY_MSG;
- /* extended HTC ready message */
- typedef PREPACK struct {
- HTC_READY_MSG Version2_0_Info; /* legacy version 2.0 information at the front... */
- /* extended information */
- u8 HTCVersion;
- u8 MaxMsgsPerHTCBundle;
- } POSTPACK HTC_READY_EX_MSG;
- #define HTC_VERSION_2P0 0x00
- #define HTC_VERSION_2P1 0x01 /* HTC 2.1 */
- #define HTC_SERVICE_META_DATA_MAX_LENGTH 128
- /* connect service
- * direction : host-to-target */
- typedef PREPACK struct {
- u16 MessageID;
- u16 ServiceID; /* service ID of the service to connect to */
- u16 ConnectionFlags; /* connection flags */
- #define HTC_CONNECT_FLAGS_REDUCE_CREDIT_DRIBBLE (1 << 2) /* reduce credit dribbling when
- the host needs credits */
- #define HTC_CONNECT_FLAGS_THRESHOLD_LEVEL_MASK (0x3)
- #define HTC_CONNECT_FLAGS_THRESHOLD_LEVEL_ONE_FOURTH 0x0
- #define HTC_CONNECT_FLAGS_THRESHOLD_LEVEL_ONE_HALF 0x1
- #define HTC_CONNECT_FLAGS_THRESHOLD_LEVEL_THREE_FOURTHS 0x2
- #define HTC_CONNECT_FLAGS_THRESHOLD_LEVEL_UNITY 0x3
-
- u8 ServiceMetaLength; /* length of meta data that follows */
- u8 _Pad1;
-
- /* service-specific meta data starts after the header */
-
- } POSTPACK HTC_CONNECT_SERVICE_MSG;
- /* connect response
- * direction : target-to-host */
- typedef PREPACK struct {
- u16 MessageID;
- u16 ServiceID; /* service ID that the connection request was made */
- u8 Status; /* service connection status */
- u8 EndpointID; /* assigned endpoint ID */
- u16 MaxMsgSize; /* maximum expected message size on this endpoint */
- u8 ServiceMetaLength; /* length of meta data that follows */
- u8 _Pad1;
-
- /* service-specific meta data starts after the header */
-
- } POSTPACK HTC_CONNECT_SERVICE_RESPONSE_MSG;
- typedef PREPACK struct {
- u16 MessageID;
- /* currently, no other fields */
- } POSTPACK HTC_SETUP_COMPLETE_MSG;
- /* extended setup completion message */
- typedef PREPACK struct {
- u16 MessageID;
- u32 SetupFlags;
- u8 MaxMsgsPerBundledRecv;
- u8 Rsvd[3];
- } POSTPACK HTC_SETUP_COMPLETE_EX_MSG;
- #define HTC_SETUP_COMPLETE_FLAGS_ENABLE_BUNDLE_RECV (1 << 0)
- /* connect response status codes */
- #define HTC_SERVICE_SUCCESS 0 /* success */
- #define HTC_SERVICE_NOT_FOUND 1 /* service could not be found */
- #define HTC_SERVICE_FAILED 2 /* specific service failed the connect */
- #define HTC_SERVICE_NO_RESOURCES 3 /* no resources (i.e. no more endpoints) */
- #define HTC_SERVICE_NO_MORE_EP 4 /* specific service is not allowing any more
- endpoints */
- /* report record IDs */
- #define HTC_RECORD_NULL 0
- #define HTC_RECORD_CREDITS 1
- #define HTC_RECORD_LOOKAHEAD 2
- #define HTC_RECORD_LOOKAHEAD_BUNDLE 3
- typedef PREPACK struct {
- u8 RecordID; /* Record ID */
- u8 Length; /* Length of record */
- } POSTPACK HTC_RECORD_HDR;
- typedef PREPACK struct {
- u8 EndpointID; /* Endpoint that owns these credits */
- u8 Credits; /* credits to report since last report */
- } POSTPACK HTC_CREDIT_REPORT;
- typedef PREPACK struct {
- u8 PreValid; /* pre valid guard */
- u8 LookAhead[4]; /* 4 byte lookahead */
- u8 PostValid; /* post valid guard */
-
- /* NOTE: the LookAhead array is guarded by a PreValid and Post Valid guard bytes.
- * The PreValid bytes must equal the inverse of the PostValid byte */
-
- } POSTPACK HTC_LOOKAHEAD_REPORT;
- typedef PREPACK struct {
- u8 LookAhead[4]; /* 4 byte lookahead */
- } POSTPACK HTC_BUNDLED_LOOKAHEAD_REPORT;
- #endif /* __HTC_H__ */