Input: psmouse - fix comment style

 * psmouse_process_byte() analyzes the PS/2 data stream and reports

 * relevant events to the input module once full packet has arrived.

 */

psmouse_ret_t psmouse_process_byte(struct psmouse *psmouse)

{

	struct input_dev *dev = psmouse->dev;

/*

 * __psmouse_set_state() sets new psmouse state and resets all flags.

 */

static inline void __psmouse_set_state(struct psmouse *psmouse, enum psmouse_state new_state)

{

	psmouse->state = new_state;

	psmouse->last = jiffies;

}

/*

 * psmouse_set_state() sets new psmouse state and resets all flags and

 * counters while holding serio lock so fighting with interrupt handler

 * is not a concern.

 */

void psmouse_set_state(struct psmouse *psmouse, enum psmouse_state new_state)

{

	serio_pause_rx(psmouse->ps2dev.serio);

 * psmouse_handle_byte() processes one byte of the input data stream

 * by calling corresponding protocol handler.

 */

static int psmouse_handle_byte(struct psmouse *psmouse)

{

	psmouse_ret_t rc = psmouse->protocol_handler(psmouse);

 * psmouse_interrupt() handles incoming characters, either passing them

 * for normal processing or gathering them as command response.

 */

static irqreturn_t psmouse_interrupt(struct serio *serio,

		unsigned char data, unsigned int flags)

{

	}

	psmouse->packet[psmouse->pktcnt++] = data;

/*

 * Check if this is a new device announcement (0xAA 0x00)

 */

	/* Check if this is a new device announcement (0xAA 0x00) */

	if (unlikely(psmouse->packet[0] == PSMOUSE_RET_BAT && psmouse->pktcnt <= 2)) {

		if (psmouse->pktcnt == 1) {

			psmouse->last = jiffies;

			serio_reconnect(serio);

			goto out;

		}

/*

 * Not a new device, try processing first byte normally

 */

		/* Not a new device, try processing first byte normally */

		psmouse->pktcnt = 1;

		if (psmouse_handle_byte(psmouse))

			goto out;

	}

	/*

 * See if we need to force resync because mouse was idle for too long

	 * See if we need to force resync because mouse was idle for

	 * too long.

	 */

	if (psmouse->state == PSMOUSE_ACTIVATED &&

	    psmouse->pktcnt == 1 && psmouse->resync_time &&

	return IRQ_HANDLED;

}

/*

 * psmouse_sliced_command() sends an extended PS/2 command to the mouse

 * using sliced syntax, understood by advanced devices, such as Logitech

	return 0;

}

/*

 * psmouse_reset() resets the mouse into power-on state.

 */

/*

 * Here we set the mouse resolution.

 */

void psmouse_set_resolution(struct psmouse *psmouse, unsigned int resolution)

{

	static const unsigned char params[] = { 0, 1, 2, 2, 3 };

/*

 * Here we set the mouse report rate.

 */

static void psmouse_set_rate(struct psmouse *psmouse, unsigned int rate)

{

	static const unsigned char rates[] = { 200, 100, 80, 60, 40, 20, 10, 0 };

/*

 * Here we set the mouse scaling.

 */

static void psmouse_set_scale(struct psmouse *psmouse, enum psmouse_scale scale)

{

	ps2_command(&psmouse->ps2dev, NULL,

/*

 * psmouse_poll() - default poll handler. Everyone except for ALPS uses it.

 */

static int psmouse_poll(struct psmouse *psmouse)

{

	return ps2_command(&psmouse->ps2dev, psmouse->packet,

 * Apply default settings to the psmouse structure. Most of them will

 * be overridden by individual protocol initialization routines.

 */

static void psmouse_apply_defaults(struct psmouse *psmouse)

{

	struct input_dev *input_dev = psmouse->dev;

 * psmouse_extensions() probes for any extensions to the basic PS/2 protocol

 * the mouse may have.

 */

static int psmouse_extensions(struct psmouse *psmouse,

			      unsigned int max_proto, bool set_properties)

{

	bool synaptics_hardware = false;

/* Always check for focaltech, this is safe as it uses pnp-id matching */

	/*

	 * Always check for focaltech, this is safe as it uses pnp-id

	 * matching.

	 */

	if (psmouse_do_detect(focaltech_detect, psmouse, set_properties) == 0) {

		if (max_proto > PSMOUSE_IMEX) {

			if (!set_properties || focaltech_init(psmouse) == 0) {

	}

	/*

 * We always check for lifebook because it does not disturb mouse

	 * We always check for LifeBook because it does not disturb mouse

	 * (it only checks DMI information).

	 */

	if (psmouse_do_detect(lifebook_detect, psmouse, set_properties) == 0) {

	}

	/*

 * Try Kensington ThinkingMouse (we try first, because synaptics probe

 * upsets the thinkingmouse).

	 * Try Kensington ThinkingMouse (we try first, because Synaptics

	 * probe upsets the ThinkingMouse).

	 */

	if (max_proto > PSMOUSE_IMEX &&

	    psmouse_do_detect(thinking_detect, psmouse, set_properties) == 0) {

		return PSMOUSE_THINKPS;

	}

	/*

 * Try Synaptics TouchPad. Note that probing is done even if Synaptics protocol

 * support is disabled in config - we need to know if it is synaptics so we

 * can reset it properly after probing for intellimouse.

	 * Try Synaptics TouchPad. Note that probing is done even if

	 * Synaptics protocol support is disabled in config - we need to

	 * know if it is Synaptics so we can reset it properly after

	 * probing for IntelliMouse.

	 */

	if (max_proto > PSMOUSE_PS2 &&

	    psmouse_do_detect(synaptics_detect, psmouse, set_properties) == 0) {

		if (max_proto > PSMOUSE_IMEX) {

			/*

 * Try activating protocol, but check if support is enabled first, since

 * we try detecting Synaptics even when protocol is disabled.

			 * Try activating protocol, but check if support is

			 * enabled first, since we try detecting Synaptics

			 * even when protocol is disabled.

			 */

			if (IS_ENABLED(CONFIG_MOUSE_PS2_SYNAPTICS) &&

			    (!set_properties || synaptics_init(psmouse) == 0)) {

			}

			/*

 * Some Synaptics touchpads can emulate extended protocols (like IMPS/2).

 * Unfortunately Logitech/Genius probes confuse some firmware versions so

 * we'll have to skip them.

			 * Some Synaptics touchpads can emulate extended

			 * protocols (like IMPS/2).  Unfortunately

			 * Logitech/Genius probes confuse some firmware

			 * versions so we'll have to skip them.

			 */

			max_proto = PSMOUSE_IMEX;

		}

		/*

 * Make sure that touchpad is in relative mode, gestures (taps) are enabled

		 * Make sure that touchpad is in relative mode, gestures

		 * (taps) are enabled.

		 */

		synaptics_reset(psmouse);

	}

	/*

 * Try Cypress Trackpad.

 * Must try it before Finger Sensing Pad because Finger Sensing Pad probe

 * upsets some modules of Cypress Trackpads.

	 * Try Cypress Trackpad. We must try it before Finger Sensing Pad

	 * because Finger Sensing Pad probe upsets some modules of Cypress

	 * Trackpads.

	 */

	if (max_proto > PSMOUSE_IMEX &&

			cypress_detect(psmouse, set_properties) == 0) {

		max_proto = PSMOUSE_IMEX;

	}

/*

 * Try ALPS TouchPad

 */

	/* Try ALPS TouchPad */

	if (max_proto > PSMOUSE_IMEX) {

		ps2_command(&psmouse->ps2dev, NULL, PSMOUSE_CMD_RESET_DIS);

		if (psmouse_do_detect(alps_detect,

				      psmouse, set_properties) == 0) {

			if (!set_properties || alps_init(psmouse) == 0)

				return PSMOUSE_ALPS;

/*

 * Init failed, try basic relative protocols

 */

			/* Init failed, try basic relative protocols */

			max_proto = PSMOUSE_IMEX;

		}

	}

/*

 * Try OLPC HGPK touchpad.

 */

	/* Try OLPC HGPK touchpad */

	if (max_proto > PSMOUSE_IMEX &&

	    psmouse_do_detect(hgpk_detect, psmouse, set_properties) == 0) {

		if (!set_properties || hgpk_init(psmouse) == 0)

			return PSMOUSE_HGPK;

/*

 * Init failed, try basic relative protocols

 */

			/* Init failed, try basic relative protocols */

		max_proto = PSMOUSE_IMEX;

	}

/*

 * Try Elantech touchpad.

 */

	/* Try Elantech touchpad */

	if (max_proto > PSMOUSE_IMEX &&

	    psmouse_do_detect(elantech_detect, psmouse, set_properties) == 0) {

		if (!set_properties || elantech_init(psmouse) == 0)

			return PSMOUSE_ELANTECH;

/*

 * Init failed, try basic relative protocols

 */

		/* Init failed, try basic relative protocols */

		max_proto = PSMOUSE_IMEX;

	}

				      psmouse, set_properties) == 0) {

			if (!set_properties || fsp_init(psmouse) == 0)

				return PSMOUSE_FSP;

/*

 * Init failed, try basic relative protocols

 */

			/* Init failed, try basic relative protocols */

			max_proto = PSMOUSE_IMEX;

		}

	}

	}

	/*

 * Okay, all failed, we have a standard mouse here. The number of the buttons

 * is still a question, though. We assume 3.

	 * Okay, all failed, we have a standard mouse here. The number of

	 * the buttons is still a question, though. We assume 3.

	 */

	psmouse_do_detect(ps2bare_detect, psmouse, set_properties);

	if (synaptics_hardware) {

		/*

 * We detected Synaptics hardware but it did not respond to IMPS/2 probes.

 * We need to reset the touchpad because if there is a track point on the

 * pass through port it could get disabled while probing for protocol

 * extensions.

		 * We detected Synaptics hardware but it did not respond to

		 * IMPS/2 probes.  We need to reset the touchpad because if

		 * there is a track point on the pass through port it could

		 * get disabled while probing for protocol extensions.

		 */

		psmouse_reset(psmouse);

	}

/*

 * psmouse_probe() probes for a PS/2 mouse.

 */

static int psmouse_probe(struct psmouse *psmouse)

{

	struct ps2dev *ps2dev = &psmouse->ps2dev;

	unsigned char param[2];

	/*

 * First, we check if it's a mouse. It should send 0x00 or 0x03

 * in case of an IntelliMouse in 4-byte mode or 0x04 for IM Explorer.

 * Sunrex K8561 IR Keyboard/Mouse reports 0xff on second and subsequent

 * ID queries, probably due to a firmware bug.

	 * First, we check if it's a mouse. It should send 0x00 or 0x03 in

	 * case of an IntelliMouse in 4-byte mode or 0x04 for IM Explorer.

	 * Sunrex K8561 IR Keyboard/Mouse reports 0xff on second and

	 * subsequent ID queries, probably due to a firmware bug.

	 */

	param[0] = 0xa5;

	if (ps2_command(ps2dev, param, PSMOUSE_CMD_GETID))

		return -1;

		return -1;

	/*

 * Then we reset and disable the mouse so that it doesn't generate events.

	 * Then we reset and disable the mouse so that it doesn't generate

	 * events.

	 */

	if (ps2_command(ps2dev, NULL, PSMOUSE_CMD_RESET_DIS))

		psmouse_warn(psmouse, "Failed to reset mouse on %s\n",

			     ps2dev->serio->phys);

/*

 * psmouse_initialize() initializes the mouse to a sane state.

 */

static void psmouse_initialize(struct psmouse *psmouse)

{

	/*

	 * We set the mouse report rate, resolution and scaling.

	 */

	if (psmouse_max_proto != PSMOUSE_PS2) {

		psmouse->set_rate(psmouse, psmouse->rate);

		psmouse->set_resolution(psmouse, psmouse->resolution);

/*

 * psmouse_activate() enables the mouse so that we get motion reports from it.

 */

int psmouse_activate(struct psmouse *psmouse)

{

	if (ps2_command(&psmouse->ps2dev, NULL, PSMOUSE_CMD_ENABLE)) {

}

/*

 * psmouse_deactivate() puts the mouse into poll mode so that we don't get motion

 * reports from it unless we explicitly request it.

 * psmouse_deactivate() puts the mouse into poll mode so that we don't get

 * motion reports from it unless we explicitly request it.

 */

int psmouse_deactivate(struct psmouse *psmouse)

{

	if (ps2_command(&psmouse->ps2dev, NULL, PSMOUSE_CMD_DISABLE)) {

	return 0;

}

/*

 * psmouse_resync() attempts to re-validate current protocol.

 */

static void psmouse_resync(struct work_struct *work)

{

	struct psmouse *parent = NULL, *psmouse =

			psmouse_set_state(psmouse, PSMOUSE_RESYNCING);

		}

	}

	/*

 * Now try to enable mouse. We try to do that even if poll failed and also

 * repeat our attempts 5 times, otherwise we may be left out with disabled

 * mouse.

	 * Now try to enable mouse. We try to do that even if poll failed

	 * and also repeat our attempts 5 times, otherwise we may be left

	 * out with disabled mouse.

	 */

	for (i = 0; i < 5; i++) {

		if (!ps2_command(&psmouse->ps2dev, NULL, PSMOUSE_CMD_ENABLE)) {

/*

 * psmouse_cleanup() resets the mouse into power-on state.

 */

static void psmouse_cleanup(struct serio *serio)

{

	struct psmouse *psmouse = serio_get_drvdata(serio);

/*

 * psmouse_disconnect() closes and frees.

 */

static void psmouse_disconnect(struct serio *serio)

{

	struct psmouse *psmouse, *parent = NULL;

	goto out;

}

static int psmouse_reconnect(struct serio *serio)

{

	struct psmouse *psmouse = serio_get_drvdata(serio);