Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit c0248d70 authored by Puneet Mishra's avatar Puneet Mishra
Browse files

NFC: Fix function descriptions 



Fix function description comments according to kernel-doc. Also,
remove unnecessary arguments.

Change-Id: I66c9e47ee5cd6fe6ae8676256e4b6ee30fe2d61f
Acked-by: default avatarAfroditi Ilioudi <ailioudi@qti.qualcomm.com>
Signed-off-by: default avatarPuneet Mishra <puneetm@codeaurora.org>
parent 150dbf11

drivers/nfc/nq-nci.c

+16 −21
Original line number Diff line number Diff line
@@ -254,22 +254,20 @@ static int nfc_open(struct inode *inode, struct file *filp) 
	return ret;

}



/*

 * Inside nfc_ioctl_power_states

 *

 * @brief	ioctl functions

 *

/**

 * nfc_ioctl_power_states() - power control

 * @filp:	pointer to the file descriptor

 * @arg:	mode that we want to move to

 *

 * Device control

 * remove control via ioctl

 * Device power control. Depending on the arg value, device moves to

 * different states

 * (arg = 0): NFC_ENABLE	GPIO = 0, FW_DL GPIO = 0

 * (arg = 1): NFC_ENABLE	GPIO = 1, FW_DL GPIO = 0

 * (arg = 2): FW_DL GPIO = 1

 *

 *

 * Return: -ENOIOCTLCMD if arg is not supported, 0 in any other case

 */

int nfc_ioctl_power_states(struct file *filp, unsigned int cmd,

							unsigned long arg)

int nfc_ioctl_power_states(struct file *filp, unsigned long arg)

{

	int r = 0;

	struct nqx_dev *nqx_dev = filp->private_data;
@@ -324,7 +322,7 @@ static long nfc_compat_ioctl(struct file *pfile, unsigned int cmd, 
	arg = (compat_u64)arg;

	switch (cmd) {

	case NFC_SET_PWR:

		nfc_ioctl_power_states(pfile, cmd, arg);

		nfc_ioctl_power_states(pfile, arg);

		break;

	case SET_RX_BLOCK:

		break;
@@ -337,18 +335,15 @@ static long nfc_compat_ioctl(struct file *pfile, unsigned int cmd, 
}

#endif



/*

 * Inside nfc_ioctl_core_reset_ntf

 *

 * @brief	nfc_ioctl_core_reset_ntf

/**

 * nfc_ioctl_core_reset_ntf()

 * @filp:       pointer to the file descriptor

 *

 * Allows callers to determine if a CORE_RESET_NTF has arrived

 *

 * Returns the value of variable core_reset_ntf

 *

 * Return: the value of variable core_reset_ntf

 */

int nfc_ioctl_core_reset_ntf(struct file *filp, unsigned int cmd,

				unsigned long arg)

int nfc_ioctl_core_reset_ntf(struct file *filp)

{

	struct nqx_dev *nqx_dev = filp->private_data;
@@ -364,7 +359,7 @@ static long nfc_ioctl(struct file *pfile, unsigned int cmd, 


	switch (cmd) {

	case NFC_SET_PWR:

		r = nfc_ioctl_power_states(pfile, cmd, arg);

		r = nfc_ioctl_power_states(pfile, arg);

		break;

	case NFC_CLK_REQ:

		break;
@@ -373,7 +368,7 @@ static long nfc_ioctl(struct file *pfile, unsigned int cmd, 
	case SET_EMULATOR_TEST_POINT:

		break;

	case NFCC_INITIAL_CORE_RESET_NTF:

		r = nfc_ioctl_core_reset_ntf(pfile, cmd, arg);

		r = nfc_ioctl_core_reset_ntf(pfile);

		break;

	default:

		r = -ENOIOCTLCMD;