dhd_bus.h 3.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100
  1. /*
  2. * Header file describing the internal (inter-module) DHD interfaces.
  3. *
  4. * Provides type definitions and function prototypes used to link the
  5. * DHD OS, bus, and protocol modules.
  6. *
  7. * Copyright (C) 1999-2011, Broadcom Corporation
  8. *
  9. * Unless you and Broadcom execute a separate written software license
  10. * agreement governing use of this software, this software is licensed to you
  11. * under the terms of the GNU General Public License version 2 (the "GPL"),
  12. * available at http://www.broadcom.com/licenses/GPLv2.php, with the
  13. * following added to such license:
  14. *
  15. * As a special exception, the copyright holders of this software give you
  16. * permission to link this software with independent modules, and to copy and
  17. * distribute the resulting executable under terms of your choice, provided that
  18. * you also meet, for each linked independent module, the terms and conditions of
  19. * the license of that module. An independent module is a module which is not
  20. * derived from this software. The special exception does not apply to any
  21. * modifications of the software.
  22. *
  23. * Notwithstanding the above, under no circumstances may you combine this
  24. * software in any way with any other Broadcom software provided under a license
  25. * other than the GPL, without Broadcom's express prior written consent.
  26. *
  27. * $Id: dhd_bus.h,v 1.14.28.1 2010-12-23 01:13:17 Exp $
  28. */
  29. #ifndef _dhd_bus_h_
  30. #define _dhd_bus_h_
  31. /*
  32. * Exported from dhd bus module (dhd_usb, dhd_sdio)
  33. */
  34. /* Indicate (dis)interest in finding dongles. */
  35. extern int dhd_bus_register(void);
  36. extern void dhd_bus_unregister(void);
  37. /* Download firmware image and nvram image */
  38. extern bool dhd_bus_download_firmware(struct dhd_bus *bus, osl_t *osh,
  39. char *fw_path, char *nv_path);
  40. /* Stop bus module: clear pending frames, disable data flow */
  41. extern void dhd_bus_stop(struct dhd_bus *bus, bool enforce_mutex);
  42. /* Initialize bus module: prepare for communication w/dongle */
  43. extern int dhd_bus_init(dhd_pub_t *dhdp, bool enforce_mutex);
  44. /* Get the Bus Idle Time */
  45. extern void dhd_bus_getidletime(dhd_pub_t *dhdp, int *idletime);
  46. /* Set the Bus Idle Time*/
  47. extern void dhd_bus_setidletime(dhd_pub_t *dhdp, int idle_time);
  48. /* Send a data frame to the dongle. Callee disposes of txp. */
  49. extern int dhd_bus_txdata(struct dhd_bus *bus, void *txp);
  50. /* Send/receive a control message to/from the dongle.
  51. * Expects caller to enforce a single outstanding transaction.
  52. */
  53. extern int dhd_bus_txctl(struct dhd_bus *bus, uchar *msg, uint msglen);
  54. extern int dhd_bus_rxctl(struct dhd_bus *bus, uchar *msg, uint msglen);
  55. /* Watchdog timer function */
  56. extern bool dhd_bus_watchdog(dhd_pub_t *dhd);
  57. extern void dhd_disable_intr(dhd_pub_t *dhd);
  58. #if defined(DHD_DEBUG)
  59. /* Device console input function */
  60. extern int dhd_bus_console_in(dhd_pub_t *dhd, uchar *msg, uint msglen);
  61. #endif /* defined(DHD_DEBUG) */
  62. /* Deferred processing for the bus, return TRUE requests reschedule */
  63. extern bool dhd_bus_dpc(struct dhd_bus *bus);
  64. extern void dhd_bus_isr(bool * InterruptRecognized, bool * QueueMiniportHandleInterrupt, void *arg);
  65. /* Check for and handle local prot-specific iovar commands */
  66. extern int dhd_bus_iovar_op(dhd_pub_t *dhdp, const char *name,
  67. void *params, int plen, void *arg, int len, bool set);
  68. /* Add bus dump output to a buffer */
  69. extern void dhd_bus_dump(dhd_pub_t *dhdp, struct bcmstrbuf *strbuf);
  70. /* Clear any bus counters */
  71. extern void dhd_bus_clearcounts(dhd_pub_t *dhdp);
  72. /* return the dongle chipid */
  73. extern uint dhd_bus_chip(struct dhd_bus *bus);
  74. /* Set user-specified nvram parameters. */
  75. extern void dhd_bus_set_nvram_params(struct dhd_bus * bus, const char *nvram_params);
  76. extern void *dhd_bus_pub(struct dhd_bus *bus);
  77. extern void *dhd_bus_txq(struct dhd_bus *bus);
  78. extern uint dhd_bus_hdrlen(struct dhd_bus *bus);
  79. #endif /* _dhd_bus_h_ */