2 * Copyright (c) 2010 Atheros Communications Inc.
4 * Permission to use, copy, modify, and/or distribute this software for any
5 * purpose with or without fee is hereby granted, provided that the above
6 * copyright notice and this permission notice appear in all copies.
8 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
9 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
10 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
11 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
12 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
13 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
14 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
20 struct ath9k_htc_priv
;
22 struct ath9k_htc_tx_ctl
;
24 enum ath9k_hif_transports
{
28 struct ath9k_htc_hif
{
29 struct list_head list
;
30 const enum ath9k_hif_transports transport
;
36 void (*start
) (void *hif_handle
, u8 pipe
);
37 void (*stop
) (void *hif_handle
, u8 pipe
);
38 int (*send
) (void *hif_handle
, u8 pipe
, struct sk_buff
*buf
,
39 struct ath9k_htc_tx_ctl
*tx_ctl
);
42 enum htc_endpoint_id
{
56 /* Htc frame hdr flags */
57 #define HTC_FLAGS_RECV_TRAILER (1 << 1)
59 struct htc_frame_hdr
{
66 struct htc_ready_msg
{
74 struct htc_config_pipe_msg
{
94 struct htc_ep_callbacks
{
96 void (*tx
) (void *, struct sk_buff
*, enum htc_endpoint_id
, bool txok
);
97 void (*rx
) (void *, struct sk_buff
*, enum htc_endpoint_id
);
100 #define HTC_TX_QUEUE_SIZE 256
103 struct sk_buff
*buf
[HTC_TX_QUEUE_SIZE
];
110 struct htc_endpoint
{
113 struct htc_ep_callbacks ep_callbacks
;
114 struct htc_txq htc_txq
;
122 #define HTC_MAX_CONTROL_MESSAGE_LENGTH 255
123 #define HTC_CONTROL_BUFFER_SIZE \
124 (HTC_MAX_CONTROL_MESSAGE_LENGTH + sizeof(struct htc_frame_hdr))
126 struct htc_control_buf
{
127 struct htc_packet htc_pkt
;
128 u8 buf
[HTC_CONTROL_BUFFER_SIZE
];
131 #define HTC_OP_START_WAIT BIT(0)
132 #define HTC_OP_CONFIG_PIPE_CREDITS BIT(1)
136 struct ath9k_htc_priv
*drv_priv
;
138 struct ath9k_htc_hif
*hif
;
139 struct htc_endpoint endpoint
[ENDPOINT_MAX
];
140 struct completion target_wait
;
141 struct completion cmd_wait
;
142 struct list_head list
;
143 enum htc_endpoint_id conn_rsp_epid
;
151 HTC_MSG_READY_ID
= 1,
152 HTC_MSG_CONNECT_SERVICE_ID
,
153 HTC_MSG_CONNECT_SERVICE_RESPONSE_ID
,
154 HTC_MSG_SETUP_COMPLETE_ID
,
155 HTC_MSG_CONFIG_PIPE_ID
,
156 HTC_MSG_CONFIG_PIPE_RESPONSE_ID
,
159 struct htc_service_connreq
{
163 struct htc_ep_callbacks ep_callbacks
;
166 /* Current service IDs */
168 enum htc_service_group_ids
{
169 RSVD_SERVICE_GROUP
= 0,
170 WMI_SERVICE_GROUP
= 1,
172 HTC_SERVICE_GROUP_LAST
= 255
175 #define MAKE_SERVICE_ID(group, index) \
176 (int)(((int)group << 8) | (int)(index))
178 /* NOTE: service ID of 0x0000 is reserved and should never be used */
179 #define HTC_CTRL_RSVD_SVC MAKE_SERVICE_ID(RSVD_SERVICE_GROUP, 1)
180 #define HTC_LOOPBACK_RSVD_SVC MAKE_SERVICE_ID(RSVD_SERVICE_GROUP, 2)
182 #define WMI_CONTROL_SVC MAKE_SERVICE_ID(WMI_SERVICE_GROUP, 0)
183 #define WMI_BEACON_SVC MAKE_SERVICE_ID(WMI_SERVICE_GROUP, 1)
184 #define WMI_CAB_SVC MAKE_SERVICE_ID(WMI_SERVICE_GROUP, 2)
185 #define WMI_UAPSD_SVC MAKE_SERVICE_ID(WMI_SERVICE_GROUP, 3)
186 #define WMI_MGMT_SVC MAKE_SERVICE_ID(WMI_SERVICE_GROUP, 4)
187 #define WMI_DATA_VO_SVC MAKE_SERVICE_ID(WMI_SERVICE_GROUP, 5)
188 #define WMI_DATA_VI_SVC MAKE_SERVICE_ID(WMI_SERVICE_GROUP, 6)
189 #define WMI_DATA_BE_SVC MAKE_SERVICE_ID(WMI_SERVICE_GROUP, 7)
190 #define WMI_DATA_BK_SVC MAKE_SERVICE_ID(WMI_SERVICE_GROUP, 8)
192 struct htc_conn_svc_msg
{
202 /* connect response status codes */
203 #define HTC_SERVICE_SUCCESS 0
204 #define HTC_SERVICE_NOT_FOUND 1
205 #define HTC_SERVICE_FAILED 2
206 #define HTC_SERVICE_NO_RESOURCES 3
207 #define HTC_SERVICE_NO_MORE_EP 4
209 struct htc_conn_svc_rspmsg
{
219 struct htc_comp_msg
{
223 int htc_init(struct htc_target
*target
);
224 int htc_connect_service(struct htc_target
*target
,
225 struct htc_service_connreq
*service_connreq
,
226 enum htc_endpoint_id
*conn_rsp_eid
);
227 int htc_send(struct htc_target
*target
, struct sk_buff
*skb
,
228 enum htc_endpoint_id eid
, struct ath9k_htc_tx_ctl
*tx_ctl
);
229 void htc_stop(struct htc_target
*target
);
230 void htc_start(struct htc_target
*target
);
232 void ath9k_htc_rx_msg(struct htc_target
*htc_handle
,
233 struct sk_buff
*skb
, u32 len
, u8 pipe_id
);
234 void ath9k_htc_txcompletion_cb(struct htc_target
*htc_handle
,
235 struct sk_buff
*skb
, bool txok
);
237 struct htc_target
*ath9k_htc_hw_alloc(void *hif_handle
,
238 struct ath9k_htc_hif
*hif
,
240 void ath9k_htc_hw_free(struct htc_target
*htc
);
241 int ath9k_htc_hw_init(struct htc_target
*target
,
242 struct device
*dev
, u16 devid
);
243 void ath9k_htc_hw_deinit(struct htc_target
*target
, bool hot_unplug
);
245 #endif /* HTC_HST_H */