staging: brcm80211: clarified fullmac io and event codes
authorRoland Vossen <rvossen@broadcom.com>
Fri, 23 Sep 2011 00:07:54 +0000 (17:07 -0700)
committerGreg Kroah-Hartman <gregkh@suse.de>
Mon, 26 Sep 2011 23:55:36 +0000 (16:55 -0700)
Added comments to make code more readable.

Reported-by: Johannes Berg <johannes@sipsolutions.net>
Reviewed-by: Arend van Spriel <arend@broadcom.com>
Reviewed-by: Franky Lin <frankyl@broadcom.com>
Signed-off-by: Franky Lin <frankyl@broadcom.com>
Signed-off-by: Greg Kroah-Hartman <gregkh@suse.de>
drivers/staging/brcm80211/brcmfmac/dhd.h
drivers/staging/brcm80211/brcmfmac/dhd_cdc.c
drivers/staging/brcm80211/brcmfmac/wl_cfg80211.c

index 7ca917203a95eacc9f22ed9fb19fb07acfffdd3b..7ab45d90c038160135f7bffea9ca73d30ac08db6 100644 (file)
@@ -27,6 +27,9 @@
 #define BRCMF_C_IOCTL_MEDLEN   1536    /* "med" ioctl buffer required */
 #define        BRCMF_C_IOCTL_MAXLEN    8192
 
+/*******************************************************************************
+ * IO codes that are interpreted by dongle firmware
+ ******************************************************************************/
 #define BRCMF_C_UP                             2
 #define BRCMF_C_SET_PROMISC                    10
 #define BRCMF_C_GET_RATE                       12
@@ -171,6 +174,7 @@ struct dngl_stats {
        unsigned long multicast;        /* multicast packets received */
 };
 
+/* event codes sent by the dongle to this driver */
 #define BRCMF_E_SET_SSID                       0
 #define BRCMF_E_JOIN                           1
 #define BRCMF_E_START                          2
index 91b4d3cd319a1760bce520f4d77317fb3527789d..4c171a3062853562f37643555417831fbca5c63e 100644 (file)
  * CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  */
 
+/*******************************************************************************
+ * Communicates with the dongle by using Broadcom specific ioctl codes.
+ * For certain ioctl codes, the dongle interprets string data from the host.
+ ******************************************************************************/
+
 #include <linux/types.h>
 #include <linux/netdevice.h>
 #include <linux/sched.h>
index d0ae2b6d3e90539d85f1958c6ef84fe9bb40bf1b..45c9e7819538a7ce574ba1894a971fea43d3a0f1 100644 (file)
@@ -14,6 +14,8 @@
  * CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  */
 
+/* Toplevel file. Relies on dhd_linux.c to send ioctls to the dongle. */
+
 #include <linux/kernel.h>
 #include <linux/if_arp.h>
 #include <linux/sched.h>