191 lines
6.2 KiB
C
191 lines
6.2 KiB
C
/*
|
|
* Copyright (c) 2007 Atheros Communications Inc.
|
|
* All rights reserved.
|
|
*
|
|
* $ATH_LICENSE_HOSTSDK0_C$
|
|
*
|
|
*/
|
|
|
|
|
|
#ifndef __HTC_H__
|
|
#define __HTC_H__
|
|
|
|
#ifndef ATH_TARGET
|
|
#include "athstartpack.h"
|
|
#endif
|
|
|
|
#define A_OFFSETOF(type,field) (int)(&(((type *)NULL)->field))
|
|
|
|
#define ASSEMBLE_UNALIGNED_UINT16(p,highbyte,lowbyte) \
|
|
(((A_UINT16)(((A_UINT8 *)(p))[(highbyte)])) << 8 | (A_UINT16)(((A_UINT8 *)(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) \
|
|
{ \
|
|
((A_UINT8 *)(p))[A_OFFSETOF(type,field)] = (A_UINT8)(value); \
|
|
((A_UINT8 *)(p))[A_OFFSETOF(type,field) + 1] = (A_UINT8)((value) >> 8); \
|
|
}
|
|
|
|
#define A_GET_UINT8_FIELD(p,type,field) \
|
|
((A_UINT8 *)(p))[A_OFFSETOF(type,field)]
|
|
|
|
#define A_SET_UINT8_FIELD(p,type,field,value) \
|
|
((A_UINT8 *)(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 */
|
|
typedef 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 */
|
|
A_UINT8 EndpointID;
|
|
A_UINT8 Flags;
|
|
A_UINT16 PayloadLen; /* length of data (including trailer) that follows the header */
|
|
|
|
/***** end of 4-byte lookahead ****/
|
|
|
|
A_UINT8 ControlBytes[2];
|
|
|
|
/* message payload starts after the header */
|
|
|
|
} POSTPACK HTC_FRAME_HDR;
|
|
|
|
/* frame header flags */
|
|
#define HTC_FLAGS_NEED_CREDIT_UPDATE (1 << 0)
|
|
#define HTC_FLAGS_RECV_TRAILER (1 << 1)
|
|
|
|
|
|
#define HTC_HDR_LENGTH (sizeof(HTC_FRAME_HDR))
|
|
#define HTC_MAX_TRAILER_LENGTH 255
|
|
#define HTC_MAX_PAYLOAD_LENGTH (2048 - sizeof(HTC_FRAME_HDR))
|
|
|
|
/* HTC control message IDs */
|
|
typedef enum {
|
|
HTC_MSG_READY_ID = 1,
|
|
HTC_MSG_CONNECT_SERVICE_ID = 2,
|
|
HTC_MSG_CONNECT_SERVICE_RESPONSE_ID = 3,
|
|
HTC_MSG_SETUP_COMPLETE_ID = 4,
|
|
} HTC_MSG_IDS;
|
|
|
|
#define HTC_MAX_CONTROL_MESSAGE_LENGTH 256
|
|
|
|
/* base message ID header */
|
|
typedef PREPACK struct {
|
|
A_UINT16 MessageID;
|
|
} POSTPACK HTC_UNKNOWN_MSG;
|
|
|
|
/* HTC ready message
|
|
* direction : target-to-host */
|
|
typedef PREPACK struct {
|
|
A_UINT16 MessageID; /* ID */
|
|
A_UINT16 CreditCount; /* number of credits the target can offer */
|
|
A_UINT16 CreditSize; /* size of each credit */
|
|
A_UINT8 MaxEndpoints; /* maximum number of endpoints the target has resources for */
|
|
A_UINT8 _Pad1;
|
|
} POSTPACK HTC_READY_MSG;
|
|
|
|
#define HTC_SERVICE_META_DATA_MAX_LENGTH 128
|
|
|
|
/* connect service
|
|
* direction : host-to-target */
|
|
typedef PREPACK struct {
|
|
A_UINT16 MessageID;
|
|
A_UINT16 ServiceID; /* service ID of the service to connect to */
|
|
A_UINT16 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
|
|
|
|
A_UINT8 ServiceMetaLength; /* length of meta data that follows */
|
|
A_UINT8 _Pad1;
|
|
|
|
/* service-specific meta data starts after the header */
|
|
|
|
} POSTPACK HTC_CONNECT_SERVICE_MSG;
|
|
|
|
/* connect response
|
|
* direction : target-to-host */
|
|
typedef PREPACK struct {
|
|
A_UINT16 MessageID;
|
|
A_UINT16 ServiceID; /* service ID that the connection request was made */
|
|
A_UINT8 Status; /* service connection status */
|
|
A_UINT8 EndpointID; /* assigned endpoint ID */
|
|
A_UINT16 MaxMsgSize; /* maximum expected message size on this endpoint */
|
|
A_UINT8 ServiceMetaLength; /* length of meta data that follows */
|
|
A_UINT8 _Pad1;
|
|
|
|
/* service-specific meta data starts after the header */
|
|
|
|
} POSTPACK HTC_CONNECT_SERVICE_RESPONSE_MSG;
|
|
|
|
typedef PREPACK struct {
|
|
A_UINT16 MessageID;
|
|
/* currently, no other fields */
|
|
} POSTPACK HTC_SETUP_COMPLETE_MSG;
|
|
|
|
|
|
/* 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 */
|
|
typedef enum {
|
|
HTC_RECORD_NULL = 0,
|
|
HTC_RECORD_CREDITS = 1,
|
|
HTC_RECORD_LOOKAHEAD = 2,
|
|
} HTC_RPT_IDS;
|
|
|
|
typedef PREPACK struct {
|
|
A_UINT8 RecordID; /* Record ID */
|
|
A_UINT8 Length; /* Length of record */
|
|
} POSTPACK HTC_RECORD_HDR;
|
|
|
|
typedef PREPACK struct {
|
|
A_UINT8 EndpointID; /* Endpoint that owns these credits */
|
|
A_UINT8 Credits; /* credits to report since last report */
|
|
} POSTPACK HTC_CREDIT_REPORT;
|
|
|
|
typedef PREPACK struct {
|
|
A_UINT8 PreValid; /* pre valid guard */
|
|
A_UINT8 LookAhead[4]; /* 4 byte lookahead */
|
|
A_UINT8 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;
|
|
|
|
#ifndef ATH_TARGET
|
|
#include "athendpack.h"
|
|
#endif
|
|
|
|
|
|
#endif /* __HTC_H__ */
|
|
|