2 * Copyright (c) 2004-2011 Atheros Communications Inc.
3 * Copyright (c) 2011 Qualcomm Atheros, Inc.
5 * Permission to use, copy, modify, and/or distribute this software for any
6 * purpose with or without fee is hereby granted, provided that the above
7 * copyright notice and this permission notice appear in all copies.
9 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
23 /* frame header flags */
26 #define HTC_FLAGS_NEED_CREDIT_UPDATE (1 << 0)
27 #define HTC_FLAGS_SEND_BUNDLE (1 << 1)
28 #define HTC_FLAGS_TX_FIXUP_NETBUF (1 << 2)
30 /* receive direction */
31 #define HTC_FLG_RX_UNUSED (1 << 0)
32 #define HTC_FLG_RX_TRAILER (1 << 1)
33 /* Bundle count maske and shift */
34 #define HTC_FLG_RX_BNDL_CNT (0xF0)
35 #define HTC_FLG_RX_BNDL_CNT_S 4
37 #define HTC_HDR_LENGTH (sizeof(struct htc_frame_hdr))
38 #define HTC_MAX_PAYLOAD_LENGTH (4096 - sizeof(struct htc_frame_hdr))
40 /* HTC control message IDs */
42 #define HTC_MSG_READY_ID 1
43 #define HTC_MSG_CONN_SVC_ID 2
44 #define HTC_MSG_CONN_SVC_RESP_ID 3
45 #define HTC_MSG_SETUP_COMPLETE_ID 4
46 #define HTC_MSG_SETUP_COMPLETE_EX_ID 5
48 #define HTC_MAX_CTRL_MSG_LEN 256
50 #define HTC_VERSION_2P0 0x00
51 #define HTC_VERSION_2P1 0x01
53 #define HTC_SERVICE_META_DATA_MAX_LENGTH 128
55 #define HTC_CONN_FLGS_THRESH_LVL_QUAT 0x0
56 #define HTC_CONN_FLGS_THRESH_LVL_HALF 0x1
57 #define HTC_CONN_FLGS_THRESH_LVL_THREE_QUAT 0x2
58 #define HTC_CONN_FLGS_REDUCE_CRED_DRIB 0x4
59 #define HTC_CONN_FLGS_THRESH_MASK 0x3
60 /* disable credit flow control on a specific service */
61 #define HTC_CONN_FLGS_DISABLE_CRED_FLOW_CTRL (1 << 3)
62 #define HTC_CONN_FLGS_SET_RECV_ALLOC_SHIFT 8
63 #define HTC_CONN_FLGS_SET_RECV_ALLOC_MASK 0xFF00U
65 /* connect response status codes */
66 #define HTC_SERVICE_SUCCESS 0
67 #define HTC_SERVICE_NOT_FOUND 1
68 #define HTC_SERVICE_FAILED 2
70 /* no resources (i.e. no more endpoints) */
71 #define HTC_SERVICE_NO_RESOURCES 3
73 /* specific service is not allowing any more endpoints */
74 #define HTC_SERVICE_NO_MORE_EP 4
76 /* report record IDs */
77 #define HTC_RECORD_NULL 0
78 #define HTC_RECORD_CREDITS 1
79 #define HTC_RECORD_LOOKAHEAD 2
80 #define HTC_RECORD_LOOKAHEAD_BUNDLE 3
82 #define HTC_SETUP_COMP_FLG_RX_BNDL_EN (1 << 0)
83 #define HTC_SETUP_COMP_FLG_DISABLE_TX_CREDIT_FLOW (1 << 1)
85 #define MAKE_SERVICE_ID(group, index) \
86 (int)(((int)group << 8) | (int)(index))
88 /* NOTE: service ID of 0x0000 is reserved and should never be used */
89 #define HTC_CTRL_RSVD_SVC MAKE_SERVICE_ID(RSVD_SERVICE_GROUP, 1)
90 #define WMI_CONTROL_SVC MAKE_SERVICE_ID(WMI_SERVICE_GROUP, 0)
91 #define WMI_DATA_BE_SVC MAKE_SERVICE_ID(WMI_SERVICE_GROUP, 1)
92 #define WMI_DATA_BK_SVC MAKE_SERVICE_ID(WMI_SERVICE_GROUP, 2)
93 #define WMI_DATA_VI_SVC MAKE_SERVICE_ID(WMI_SERVICE_GROUP, 3)
94 #define WMI_DATA_VO_SVC MAKE_SERVICE_ID(WMI_SERVICE_GROUP, 4)
95 #define WMI_MAX_SERVICES 5
99 /* reserved and used to flush ALL packets */
100 #define HTC_TX_PACKET_TAG_ALL 0
101 #define HTC_SERVICE_TX_PACKET_TAG 1
102 #define HTC_TX_PACKET_TAG_USER_DEFINED (HTC_SERVICE_TX_PACKET_TAG + 9)
104 /* more packets on this endpoint are being fetched */
105 #define HTC_RX_FLAGS_INDICATE_MORE_PKTS (1 << 0)
109 /* TODO -remove me, but we have to fix BMI first */
110 #define HTC_MAILBOX_NUM_MAX 4
112 /* enable send bundle padding for this endpoint */
113 #define HTC_FLGS_TX_BNDL_PAD_EN (1 << 0)
114 #define HTC_EP_ACTIVE ((u32) (1u << 31))
116 /* HTC operational parameters */
117 #define HTC_TARGET_RESPONSE_TIMEOUT 2000 /* in ms */
118 #define HTC_TARGET_RESPONSE_POLL_WAIT 10
119 #define HTC_TARGET_RESPONSE_POLL_COUNT 200
120 #define HTC_TARGET_DEBUG_INTR_MASK 0x01
121 #define HTC_TARGET_CREDIT_INTR_MASK 0xF0
123 #define HTC_HOST_MAX_MSG_PER_BUNDLE 8
124 #define HTC_MIN_HTC_MSGS_TO_BUNDLE 2
128 #define HTC_RX_PKT_IGNORE_LOOKAHEAD (1 << 0)
129 #define HTC_RX_PKT_REFRESH_HDR (1 << 1)
130 #define HTC_RX_PKT_PART_OF_BUNDLE (1 << 2)
131 #define HTC_RX_PKT_NO_RECYCLE (1 << 3)
133 #define NUM_CONTROL_BUFFERS 8
134 #define NUM_CONTROL_TX_BUFFERS 2
135 #define NUM_CONTROL_RX_BUFFERS (NUM_CONTROL_BUFFERS - NUM_CONTROL_TX_BUFFERS)
137 #define HTC_RECV_WAIT_BUFFERS (1 << 0)
138 #define HTC_OP_STATE_STOPPING (1 << 0)
139 #define HTC_OP_STATE_SETUP_COMPLETE (1 << 1)
142 * The frame header length and message formats defined herein were selected
143 * to accommodate optimal alignment for target processing. This reduces
144 * code size and improves performance. Any changes to the header length may
145 * alter the alignment and cause exceptions on the target. When adding to
146 * the messagestructures insure that fields are properly aligned.
151 * NOTE: do not remove or re-arrange the fields, these are minimally
152 * required to take advantage of 4-byte lookaheads in some hardware
155 struct htc_frame_hdr
{
156 struct_group_tagged(htc_frame_look_ahead
, header
,
162 /* length of data (including trailer) that follows the header */
169 /* end of 4-byte lookahead */
174 /* HTC ready message */
175 struct htc_ready_msg
{
183 /* extended HTC ready message */
184 struct htc_ready_ext_msg
{
185 struct htc_ready_msg ver2_0_info
;
190 /* connect service */
191 struct htc_conn_service_msg
{
199 /* connect response */
200 struct htc_conn_service_resp
{
210 struct htc_setup_comp_msg
{
214 /* extended setup completion message */
215 struct htc_setup_comp_ext_msg
{
222 struct htc_record_hdr
{
227 struct htc_credit_report
{
233 * NOTE: The lk_ahd array is guarded by a pre_valid
234 * and Post Valid guard bytes. The pre_valid bytes must
235 * equal the inverse of the post_valid byte.
237 struct htc_lookahead_report
{
243 struct htc_bundle_lkahd_rpt
{
247 /* Current service IDs */
249 enum htc_service_grp_ids
{
250 RSVD_SERVICE_GROUP
= 0,
251 WMI_SERVICE_GROUP
= 1,
253 HTC_TEST_GROUP
= 254,
254 HTC_SERVICE_GROUP_LAST
= 255
257 /* ------ endpoint IDS ------ */
259 enum htc_endpoint_id
{
260 ENDPOINT_UNUSED
= -1,
273 struct htc_tx_packet_info
{
280 struct htc_rx_packet_info
{
288 /* wrapper around endpoint-specific packets */
290 struct list_head list
;
292 /* caller's per packet specific context */
296 * the true buffer start , the caller can store the real
297 * buffer start here. In receive callbacks, the HTC layer
298 * sets buf to the start of the payload past the header.
299 * This field allows the caller to reset buf when it recycles
300 * receive packets back to HTC.
305 * Pointer to the start of the buffer. In the transmit
306 * direction this points to the start of the payload. In the
307 * receive direction, however, the buffer when queued up
308 * points to the start of the HTC header but when returned
309 * to the caller points to the start of the payload
314 /* actual length of payload */
317 /* endpoint that this packet was sent/recv'd from */
318 enum htc_endpoint_id endpoint
;
320 /* completion status */
324 struct htc_tx_packet_info tx
;
325 struct htc_rx_packet_info rx
;
328 void (*completion
) (struct htc_target
*, struct htc_packet
*);
329 struct htc_target
*context
;
332 * optimization for network-oriented data, the HTC packet
333 * can pass the network buffer corresponding to the HTC packet
334 * lower layers may optimized the transfer knowing this is
340 enum htc_send_full_action
{
341 HTC_SEND_FULL_KEEP
= 0,
342 HTC_SEND_FULL_DROP
= 1,
345 struct htc_ep_callbacks
{
346 void (*tx_complete
) (struct htc_target
*, struct htc_packet
*);
347 void (*rx
) (struct htc_target
*, struct htc_packet
*);
348 void (*rx_refill
) (struct htc_target
*, enum htc_endpoint_id endpoint
);
349 enum htc_send_full_action (*tx_full
) (struct htc_target
*,
350 struct htc_packet
*);
351 struct htc_packet
*(*rx_allocthresh
) (struct htc_target
*,
352 enum htc_endpoint_id
, int);
353 void (*tx_comp_multi
) (struct htc_target
*, struct list_head
*);
355 int rx_refill_thresh
;
358 /* service connection information */
359 struct htc_service_connect_req
{
362 struct htc_ep_callbacks ep_cb
;
365 unsigned int max_rxmsg_sz
;
368 /* service connection response information */
369 struct htc_service_connect_resp
{
372 enum htc_endpoint_id endpoint
;
373 unsigned int len_max
;
377 /* endpoint distributionstructure */
378 struct htc_endpoint_credit_dist
{
379 struct list_head list
;
381 /* Service ID (set by HTC) */
384 /* endpoint for this distributionstruct (set by HTC) */
385 enum htc_endpoint_id endpoint
;
390 * credits for normal operation, anything above this
391 * indicates the endpoint is over-subscribed.
395 /* floor for credit distribution */
400 /* current credits available */
404 * pending credits to distribute on this endpoint, this
405 * is set by HTC when credit reports arrive. The credit
406 * distribution functions sets this to zero when it distributes
412 * the number of credits that the current pending TX packet needs
413 * to transmit. This is set by HTC when endpoint needs credits in
418 /* size in bytes of each credit */
421 /* credits required for a maximum sized messages */
424 /* reserved for HTC use */
425 struct htc_endpoint
*htc_ep
;
428 * current depth of TX queue , i.e. messages waiting for credits
429 * This field is valid only when HTC_CREDIT_DIST_ACTIVITY_CHANGE
430 * or HTC_CREDIT_DIST_SEND_COMPLETE is indicated on an endpoint
431 * that has non-zero credits to recover.
437 * credit distribution code that is passed into the distribution function,
438 * there are mandatory and optional codes that must be handled
440 enum htc_credit_dist_reason
{
441 HTC_CREDIT_DIST_SEND_COMPLETE
= 0,
442 HTC_CREDIT_DIST_ACTIVITY_CHANGE
= 1,
443 HTC_CREDIT_DIST_SEEK_CREDITS
,
446 struct ath6kl_htc_credit_info
{
447 int total_avail_credits
;
448 int cur_free_credits
;
450 /* list of lowest priority endpoints */
451 struct list_head lowestpri_ep_dist
;
454 /* endpoint statistics */
455 struct htc_endpoint_stats
{
457 * number of times the host set the credit-low flag in a send
458 * message on this endpoint
460 u32 cred_low_indicate
;
467 /* running count of total credit reports received for this endpoint */
470 /* credit reports received from this endpoint's RX packets */
471 u32 cred_rpt_from_rx
;
473 /* credit reports received from RX packets of other endpoints */
474 u32 cred_rpt_from_other
;
476 /* credit reports received from endpoint 0 RX packets */
479 /* count of credits received via Rx packets on this endpoint */
482 /* count of credits received via another endpoint */
485 /* count of credits received via another endpoint */
488 /* count of consummed credits */
491 /* count of credits returned */
496 /* count of lookahead records found in Rx msg */
499 /* count of recv packets received in a bundle */
502 /* count of number of bundled lookaheads */
505 /* count of the number of bundle indications from the HTC header */
506 u32 rx_bundle_from_hdr
;
508 /* the number of times the recv allocation threshold was hit */
509 u32 rx_alloc_thresh_hit
;
511 /* total number of bytes */
512 u32 rxalloc_thresh_byte
;
515 struct htc_endpoint
{
516 enum htc_endpoint_id eid
;
518 struct list_head txq
;
519 struct list_head rx_bufq
;
520 struct htc_endpoint_credit_dist cred_dist
;
521 struct htc_ep_callbacks ep_cb
;
526 struct htc_target
*target
;
529 struct htc_endpoint_stats ep_st
;
530 u16 tx_drop_packet_threshold
;
535 struct list_head tx_lookup_queue
;
536 bool tx_credit_flow_enabled
;
540 struct htc_control_buffer
{
541 struct htc_packet packet
;
545 struct htc_pipe_txcredit_alloc
{
550 enum htc_send_queue_result
{
551 HTC_SEND_QUEUE_OK
= 0, /* packet was queued */
552 HTC_SEND_QUEUE_DROP
= 1, /* this packet should be dropped */
555 struct ath6kl_htc_ops
{
556 void* (*create
)(struct ath6kl
*ar
);
557 int (*wait_target
)(struct htc_target
*target
);
558 int (*start
)(struct htc_target
*target
);
559 int (*conn_service
)(struct htc_target
*target
,
560 struct htc_service_connect_req
*req
,
561 struct htc_service_connect_resp
*resp
);
562 int (*tx
)(struct htc_target
*target
, struct htc_packet
*packet
);
563 void (*stop
)(struct htc_target
*target
);
564 void (*cleanup
)(struct htc_target
*target
);
565 void (*flush_txep
)(struct htc_target
*target
,
566 enum htc_endpoint_id endpoint
, u16 tag
);
567 void (*flush_rx_buf
)(struct htc_target
*target
);
568 void (*activity_changed
)(struct htc_target
*target
,
569 enum htc_endpoint_id endpoint
,
571 int (*get_rxbuf_num
)(struct htc_target
*target
,
572 enum htc_endpoint_id endpoint
);
573 int (*add_rxbuf_multiple
)(struct htc_target
*target
,
574 struct list_head
*pktq
);
575 int (*credit_setup
)(struct htc_target
*target
,
576 struct ath6kl_htc_credit_info
*cred_info
);
577 int (*tx_complete
)(struct ath6kl
*ar
, struct sk_buff
*skb
);
578 int (*rx_complete
)(struct ath6kl
*ar
, struct sk_buff
*skb
, u8 pipe
);
581 struct ath6kl_device
;
583 /* our HTC target state */
585 struct htc_endpoint endpoint
[ENDPOINT_MAX
];
587 /* contains struct htc_endpoint_credit_dist */
588 struct list_head cred_dist_list
;
590 struct list_head free_ctrl_txbuf
;
591 struct list_head free_ctrl_rxbuf
;
592 struct ath6kl_htc_credit_info
*credit_info
;
594 unsigned int tgt_cred_sz
;
596 /* protects free_ctrl_txbuf and free_ctrl_rxbuf */
599 /* FIXME: does this protext rx_bufq and endpoint structures or what? */
602 /* protects endpoint->txq */
605 struct ath6kl_device
*dev
;
608 enum htc_endpoint_id ep_waiting
;
611 /* max messages per bundle for HTC */
612 int msg_per_bndl_max
;
622 int max_scat_entries
;
623 int max_xfer_szper_scatreq
;
625 int chk_irq_status_cnt
;
627 /* counts the number of Tx without bundling continously per AC */
628 u32 ac_tx_count
[WMM_NUM_AC
];
631 struct htc_packet
*htc_packet_pool
;
632 u8 ctrl_response_buf
[HTC_MAX_CTRL_MSG_LEN
];
633 int ctrl_response_len
;
634 bool ctrl_response_valid
;
635 struct htc_pipe_txcredit_alloc txcredit_alloc
[ENDPOINT_MAX
];
639 int ath6kl_htc_rxmsg_pending_handler(struct htc_target
*target
,
640 u32 msg_look_ahead
, int *n_pkts
);
642 static inline void set_htc_pkt_info(struct htc_packet
*packet
, void *context
,
643 u8
*buf
, unsigned int len
,
644 enum htc_endpoint_id eid
, u16 tag
)
646 packet
->pkt_cntxt
= context
;
648 packet
->act_len
= len
;
649 packet
->endpoint
= eid
;
650 packet
->info
.tx
.tag
= tag
;
653 static inline void htc_rxpkt_reset(struct htc_packet
*packet
)
655 packet
->buf
= packet
->buf_start
;
659 static inline void set_htc_rxpkt_info(struct htc_packet
*packet
, void *context
,
660 u8
*buf
, unsigned long len
,
661 enum htc_endpoint_id eid
)
663 packet
->pkt_cntxt
= context
;
665 packet
->buf_start
= buf
;
666 packet
->buf_len
= len
;
667 packet
->endpoint
= eid
;
670 static inline int get_queue_depth(struct list_head
*queue
)
672 struct list_head
*tmp_list
;
675 list_for_each(tmp_list
, queue
)
681 void ath6kl_htc_pipe_attach(struct ath6kl
*ar
);
682 void ath6kl_htc_mbox_attach(struct ath6kl
*ar
);