iwlagn: transport layer should receive iwl_trans
[deliverable/linux.git] / drivers / net / wireless / iwlwifi / iwl-trans.h
index 111acca07d75bc0e6626b07059b2970d0987c914..da6cc59dfa2b5288076989f9c28a5b78c055206f 100644 (file)
  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  *
  *****************************************************************************/
-static inline int trans_rx_init(struct iwl_priv *priv)
+#ifndef __iwl_trans_h__
+#define __iwl_trans_h__
+
+#include <linux/debugfs.h>
+
+ /*This file includes the declaration that are exported from the transport
+ * layer */
+
+struct iwl_priv;
+struct iwl_rxon_context;
+struct iwl_host_cmd;
+struct iwl_shared;
+
+/**
+ * struct iwl_trans_ops - transport specific operations
+ * @alloc: allocates the meta data (not the queues themselves)
+ * @request_irq: requests IRQ - will be called before the FW load in probe flow
+ * @start_device: allocates and inits all the resources for the transport
+ *                layer.
+ * @prepare_card_hw: claim the ownership on the HW. Will be called during
+ *                   probe.
+ * @tx_start: starts and configures all the Tx fifo - usually done once the fw
+ *           is alive.
+ * @stop_device:stops the whole device (embedded CPU put to reset)
+ * @rx_free: frees the rx memory
+ * @tx_free: frees the tx memory
+ * @send_cmd:send a host command
+ * @send_cmd_pdu:send a host command: flags can be CMD_*
+ * @get_tx_cmd: returns a pointer to a new Tx cmd for the upper layer use
+ * @tx: send an skb
+ * @reclaim: free packet until ssn. Returns a list of freed packets.
+ * @txq_agg_setup: setup a tx queue for AMPDU - will be called once the HW is
+ *                 ready and a successful ADDBA response has been received.
+ * @txq_agg_disable: de-configure a Tx queue to send AMPDUs
+ * @kick_nic: remove the RESET from the embedded CPU and let it run
+ * @disable_sync_irq: Disable and sync: after this handler returns, it is
+ *     guaranteed that all the ISR / tasklet etc... have finished running
+ *     and the transport layer shall not pass any Rx.
+ * @free: release all the ressource for the transport layer itself such as
+ *        irq, tasklet etc...
+ * @dbgfs_register: add the dbgfs files under this directory. Files will be
+ *     automatically deleted.
+ * @suspend: stop the device unless WoWLAN is configured
+ * @resume: resume activity of the device
+ */
+struct iwl_trans_ops {
+
+       struct iwl_trans *(*alloc)(struct iwl_shared *shrd);
+       int (*request_irq)(struct iwl_trans *iwl_trans);
+       int (*start_device)(struct iwl_trans *trans);
+       int (*prepare_card_hw)(struct iwl_trans *trans);
+       void (*stop_device)(struct iwl_trans *trans);
+       void (*tx_start)(struct iwl_trans *trans);
+       void (*tx_free)(struct iwl_trans *trans);
+       void (*rx_free)(struct iwl_trans *trans);
+
+       int (*send_cmd)(struct iwl_trans *trans, struct iwl_host_cmd *cmd);
+
+       int (*send_cmd_pdu)(struct iwl_trans *trans, u8 id, u32 flags, u16 len,
+                    const void *data);
+       struct iwl_tx_cmd * (*get_tx_cmd)(struct iwl_trans *trans, int txq_id);
+       int (*tx)(struct iwl_priv *priv, struct sk_buff *skb,
+               struct iwl_tx_cmd *tx_cmd, int txq_id, __le16 fc, bool ampdu,
+               struct iwl_rxon_context *ctx);
+       void (*reclaim)(struct iwl_trans *trans, int txq_id, int ssn,
+                       u32 status, struct sk_buff_head *skbs);
+
+       int (*txq_agg_disable)(struct iwl_priv *priv, u16 txq_id,
+                                 u16 ssn_idx, u8 tx_fifo);
+       void (*txq_agg_setup)(struct iwl_priv *priv, int sta_id, int tid,
+                                               int frame_limit);
+
+       void (*kick_nic)(struct iwl_trans *trans);
+
+       void (*disable_sync_irq)(struct iwl_trans *trans);
+       void (*free)(struct iwl_trans *trans);
+
+       int (*dbgfs_register)(struct iwl_trans *trans, struct dentry* dir);
+       int (*suspend)(struct iwl_trans *trans);
+       int (*resume)(struct iwl_trans *trans);
+};
+
+/**
+ * struct iwl_trans - transport common data
+ * @ops - pointer to iwl_trans_ops
+ * @shrd - pointer to iwl_shared which holds shared data from the upper layer
+ */
+struct iwl_trans {
+       const struct iwl_trans_ops *ops;
+       struct iwl_shared *shrd;
+
+       /* pointer to trans specific struct */
+       /*Ensure that this pointer will always be aligned to sizeof pointer */
+       char trans_specific[0] __attribute__((__aligned__(sizeof(void *))));
+};
+
+static inline int iwl_trans_request_irq(struct iwl_trans *trans)
+{
+       return trans->ops->request_irq(trans);
+}
+
+static inline int iwl_trans_start_device(struct iwl_trans *trans)
 {
-       return priv->trans.ops->rx_init(priv);
+       return trans->ops->start_device(trans);
 }
 
-static inline int trans_rx_stop(struct iwl_priv *priv)
+static inline int iwl_trans_prepare_card_hw(struct iwl_trans *trans)
 {
-       return priv->trans.ops->rx_stop(priv);
+       return trans->ops->prepare_card_hw(trans);
 }
 
-static inline void trans_rx_free(struct iwl_priv *priv)
+static inline void iwl_trans_stop_device(struct iwl_trans *trans)
 {
-       priv->trans.ops->rx_free(priv);
+       trans->ops->stop_device(trans);
 }
 
-static inline int trans_tx_init(struct iwl_priv *priv)
+static inline void iwl_trans_tx_start(struct iwl_trans *trans)
 {
-       return priv->trans.ops->tx_init(priv);
+       trans->ops->tx_start(trans);
 }
 
-static inline int trans_tx_stop(struct iwl_priv *priv)
+static inline void iwl_trans_rx_free(struct iwl_trans *trans)
 {
-       return priv->trans.ops->tx_stop(priv);
+       trans->ops->rx_free(trans);
 }
 
-static inline void trans_tx_free(struct iwl_priv *priv)
+static inline void iwl_trans_tx_free(struct iwl_trans *trans)
 {
-       priv->trans.ops->tx_free(priv);
+       trans->ops->tx_free(trans);
 }
 
-static inline int trans_send_cmd(struct iwl_priv *priv,
+static inline int iwl_trans_send_cmd(struct iwl_trans *trans,
                                struct iwl_host_cmd *cmd)
 {
-       return priv->trans.ops->send_cmd(priv, cmd);
+       return trans->ops->send_cmd(trans, cmd);
+}
+
+static inline int iwl_trans_send_cmd_pdu(struct iwl_trans *trans, u8 id,
+                                       u32 flags, u16 len, const void *data)
+{
+       return trans->ops->send_cmd_pdu(trans, id, flags, len, data);
+}
+
+static inline struct iwl_tx_cmd *iwl_trans_get_tx_cmd(struct iwl_trans *trans,
+                                       int txq_id)
+{
+       return trans->ops->get_tx_cmd(trans, txq_id);
+}
+
+static inline int iwl_trans_tx(struct iwl_trans *trans, struct sk_buff *skb,
+               struct iwl_tx_cmd *tx_cmd, int txq_id, __le16 fc, bool ampdu,
+               struct iwl_rxon_context *ctx)
+{
+       return trans->ops->tx(priv(trans), skb, tx_cmd, txq_id, fc, ampdu, ctx);
 }
 
-static inline int trans_send_cmd_pdu(struct iwl_priv *priv, u8 id, u32 flags,
-                                       u16 len, const void *data)
+static inline void iwl_trans_reclaim(struct iwl_trans *trans, int txq_id,
+                                int ssn, u32 status,
+                                struct sk_buff_head *skbs)
 {
-       return priv->trans.ops->send_cmd_pdu(priv, id, flags, len, data);
+       trans->ops->reclaim(trans, txq_id, ssn, status, skbs);
 }
 
-void iwl_trans_register(struct iwl_trans *trans);
+static inline int iwl_trans_txq_agg_disable(struct iwl_trans *trans, u16 txq_id,
+                         u16 ssn_idx, u8 tx_fifo)
+{
+       return trans->ops->txq_agg_disable(priv(trans), txq_id,
+                                          ssn_idx, tx_fifo);
+}
+
+static inline void iwl_trans_txq_agg_setup(struct iwl_trans *trans, int sta_id,
+                                               int tid, int frame_limit)
+{
+       trans->ops->txq_agg_setup(priv(trans), sta_id, tid, frame_limit);
+}
+
+static inline void iwl_trans_kick_nic(struct iwl_trans *trans)
+{
+       trans->ops->kick_nic(trans);
+}
+
+static inline void iwl_trans_disable_sync_irq(struct iwl_trans *trans)
+{
+       trans->ops->disable_sync_irq(trans);
+}
+
+static inline void iwl_trans_free(struct iwl_trans *trans)
+{
+       trans->ops->free(trans);
+}
+
+static inline int iwl_trans_dbgfs_register(struct iwl_trans *trans,
+                                           struct dentry *dir)
+{
+       return trans->ops->dbgfs_register(trans, dir);
+}
+
+static inline int iwl_trans_suspend(struct iwl_trans *trans)
+{
+       return trans->ops->suspend(trans);
+}
+
+static inline int iwl_trans_resume(struct iwl_trans *trans)
+{
+       return trans->ops->resume(trans);
+}
+
+/*****************************************************
+* Transport layers implementations
+******************************************************/
+extern const struct iwl_trans_ops trans_ops_pcie;
+
+#endif /* __iwl_trans_h__ */
This page took 0.035049 seconds and 5 git commands to generate.