Commit 4a2a867f authored by Shaily Sangwan's avatar Shaily Sangwan Committed by Greg Kroah-Hartman

staging: rtl8712: fix block comments

This patch fixes the following checkpatch.pl warning:
Block comments use * on subsequent lines
Signed-off-by: default avatarShaily Sangwan <shaily15297@yahoo.com>
Signed-off-by: default avatarGreg Kroah-Hartman <gregkh@linuxfoundation.org>
parent 12bc1d1e
...@@ -116,13 +116,13 @@ struct recv_buf { ...@@ -116,13 +116,13 @@ struct recv_buf {
}; };
/* /*
head -----> * head ----->
data -----> * data ----->
payload * payload
tail -----> * tail ----->
end -----> * end ----->
len = (unsigned int )(tail - data); * len = (unsigned int )(tail - data);
*/ */
struct recv_frame_hdr { struct recv_frame_hdr {
struct list_head list; struct list_head list;
_pkt *pkt; _pkt *pkt;
......
...@@ -217,15 +217,15 @@ struct SetMacAddr_param { ...@@ -217,15 +217,15 @@ struct SetMacAddr_param {
}; };
/* /*
Caller Ad-Hoc/AP * Caller Ad-Hoc/AP
*
Command -Rsp(AID == CAMID) mode * Command -Rsp(AID == CAMID) mode
*
This is to force fw to add an sta_data entry per driver's request. * This is to force fw to add an sta_data entry per driver's request.
*
FW will write an cam entry associated with it. * FW will write an cam entry associated with it.
*
*/ */
struct set_assocsta_parm { struct set_assocsta_parm {
u8 addr[ETH_ALEN]; u8 addr[ETH_ALEN];
}; };
...@@ -236,27 +236,27 @@ struct set_assocsta_rsp { ...@@ -236,27 +236,27 @@ struct set_assocsta_rsp {
}; };
/* /*
Caller Ad-Hoc/AP * Caller Ad-Hoc/AP
*
Command mode * Command mode
*
This is to force fw to del an sta_data entry per driver's request * This is to force fw to del an sta_data entry per driver's request
*
FW will invalidate the cam entry associated with it. * FW will invalidate the cam entry associated with it.
*
*/ */
struct del_assocsta_parm { struct del_assocsta_parm {
u8 addr[ETH_ALEN]; u8 addr[ETH_ALEN];
}; };
/* /*
Caller Mode: AP/Ad-HoC(M) * Caller Mode: AP/Ad-HoC(M)
*
Notes: To notify fw that given staid has changed its power state * Notes: To notify fw that given staid has changed its power state
*
Command Mode * Command Mode
*
*/ */
struct setstapwrstate_parm { struct setstapwrstate_parm {
u8 staid; u8 staid;
u8 status; u8 status;
...@@ -264,25 +264,25 @@ struct setstapwrstate_parm { ...@@ -264,25 +264,25 @@ struct setstapwrstate_parm {
}; };
/* /*
Caller Mode: Any * Caller Mode: Any
*
Notes: To setup the basic rate of RTL8711 * Notes: To setup the basic rate of RTL8711
*
Command Mode * Command Mode
*
*/ */
struct setbasicrate_parm { struct setbasicrate_parm {
u8 basicrates[NumRates]; u8 basicrates[NumRates];
}; };
/* /*
Caller Mode: Any * Caller Mode: Any
*
Notes: To read the current basic rate * Notes: To read the current basic rate
*
Command-Rsp Mode * Command-Rsp Mode
*
*/ */
struct getbasicrate_parm { struct getbasicrate_parm {
u32 rsvd; u32 rsvd;
}; };
...@@ -292,13 +292,13 @@ struct getbasicrate_rsp { ...@@ -292,13 +292,13 @@ struct getbasicrate_rsp {
}; };
/* /*
Caller Mode: Any * Caller Mode: Any
*
Notes: To setup the data rate of RTL8711 * Notes: To setup the data rate of RTL8711
*
Command Mode * Command Mode
*
*/ */
struct setdatarate_parm { struct setdatarate_parm {
u8 mac_id; u8 mac_id;
u8 datarates[NumRates]; u8 datarates[NumRates];
...@@ -334,13 +334,13 @@ struct SetChannelPlan_param { ...@@ -334,13 +334,13 @@ struct SetChannelPlan_param {
}; };
/* /*
Caller Mode: Any * Caller Mode: Any
*
Notes: To read the current data rate * Notes: To read the current data rate
*
Command-Rsp Mode * Command-Rsp Mode
*
*/ */
struct getdatarate_parm { struct getdatarate_parm {
u32 rsvd; u32 rsvd;
...@@ -351,36 +351,36 @@ struct getdatarate_rsp { ...@@ -351,36 +351,36 @@ struct getdatarate_rsp {
/* /*
Caller Mode: Any * Caller Mode: Any
AP: AP can use the info for the contents of beacon frame * AP: AP can use the info for the contents of beacon frame
Infra: STA can use the info when sitesurveying * Infra: STA can use the info when sitesurveying
Ad-HoC(M): Like AP * Ad-HoC(M): Like AP
Ad-HoC(C): Like STA * Ad-HoC(C): Like STA
*
*
Notes: To set the phy capability of the NIC * Notes: To set the phy capability of the NIC
*
Command Mode * Command Mode
*
*/ */
/* /*
Caller Mode: Any * Caller Mode: Any
*
Notes: To set the channel/modem/band * Notes: To set the channel/modem/band
This command will be used when channel/modem/band is changed. * This command will be used when channel/modem/band is changed.
*
Command Mode * Command Mode
*
*/ */
/* /*
Caller Mode: Any * Caller Mode: Any
*
Notes: To get the current setting of channel/modem/band * Notes: To get the current setting of channel/modem/band
*
Command-Rsp Mode * Command-Rsp Mode
*
*/ */
struct getphy_rsp { struct getphy_rsp {
u8 rfchannel; u8 rfchannel;
u8 modem; u8 modem;
...@@ -430,58 +430,58 @@ struct getrfintfs_parm { ...@@ -430,58 +430,58 @@ struct getrfintfs_parm {
}; };
/* /*
Notes: This command is used for H2C/C2H loopback testing * Notes: This command is used for H2C/C2H loopback testing
*
mac[0] == 0 * mac[0] == 0
==> CMD mode, return H2C_SUCCESS. * ==> CMD mode, return H2C_SUCCESS.
The following condition must be ture under CMD mode * The following condition must be ture under CMD mode
mac[1] == mac[4], mac[2] == mac[3], mac[0]=mac[5]= 0; * mac[1] == mac[4], mac[2] == mac[3], mac[0]=mac[5]= 0;
s0 == 0x1234, s1 == 0xabcd, w0 == 0x78563412, w1 == 0x5aa5def7; * s0 == 0x1234, s1 == 0xabcd, w0 == 0x78563412, w1 == 0x5aa5def7;
s2 == (b1 << 8 | b0); * s2 == (b1 << 8 | b0);
*
mac[0] == 1 * mac[0] == 1
==> CMD_RSP mode, return H2C_SUCCESS_RSP * ==> CMD_RSP mode, return H2C_SUCCESS_RSP
*
The rsp layout shall be: * The rsp layout shall be:
rsp: parm: * rsp: parm:
mac[0] = mac[5]; * mac[0] = mac[5];
mac[1] = mac[4]; * mac[1] = mac[4];
mac[2] = mac[3]; * mac[2] = mac[3];
mac[3] = mac[2]; * mac[3] = mac[2];
mac[4] = mac[1]; * mac[4] = mac[1];
mac[5] = mac[0]; * mac[5] = mac[0];
s0 = s1; * s0 = s1;
s1 = swap16(s0); * s1 = swap16(s0);
w0 = swap32(w1); * w0 = swap32(w1);
b0 = b1 * b0 = b1
s2 = s0 + s1 * s2 = s0 + s1
b1 = b0 * b1 = b0
w1 = w0 * w1 = w0
*
mac[0] == 2 * mac[0] == 2
==> CMD_EVENT mode, return H2C_SUCCESS * ==> CMD_EVENT mode, return H2C_SUCCESS
The event layout shall be: * The event layout shall be:
event: parm: * event: parm:
mac[0] = mac[5]; * mac[0] = mac[5];
mac[1] = mac[4]; * mac[1] = mac[4];
mac[2] = event's sequence number, starting from 1 to parm's marc[3] * mac[2] = event's sequence number, starting from 1 to parm's marc[3]
mac[3] = mac[2]; * mac[3] = mac[2];
mac[4] = mac[1]; * mac[4] = mac[1];
mac[5] = mac[0]; * mac[5] = mac[0];
s0 = swap16(s0) - event.mac[2]; * s0 = swap16(s0) - event.mac[2];
s1 = s1 + event.mac[2]; * s1 = s1 + event.mac[2];
w0 = swap32(w0); * w0 = swap32(w0);
b0 = b1 * b0 = b1
s2 = s0 + event.mac[2] * s2 = s0 + event.mac[2]
b1 = b0 * b1 = b0
w1 = swap32(w1) - event.mac[2]; * w1 = swap32(w1) - event.mac[2];
*
parm->mac[3] is the total event counts that host requested. * parm->mac[3] is the total event counts that host requested.
*
*
event will be the same with the cmd's param. * event will be the same with the cmd's param.
*
*/ */
/* CMD param Formart for DRV INTERNAL CMD HDL*/ /* CMD param Formart for DRV INTERNAL CMD HDL*/
struct drvint_cmd_parm { struct drvint_cmd_parm {
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment