dln2.h

/* SPDX-License-Identifier: GPL-2.0 */
#ifndef __LINUX_USB_DLN2_H
#define __LINUX_USB_DLN2_H

#define DLN2_CMD(cmd, id)		((cmd) | ((id) << 8))

struct dln2_platform_data {
	u16 handle;		/* sub-driver handle (internally used only) */
	u8 port;		/* I2C/SPI port */
};

/**
 * dln2_event_cb_t - event callback function signature
 *
 * @pdev - the sub-device that registered this callback
 * @echo - the echo header field received in the message
 * @data - the data payload
 * @len  - the data payload length
 *
 * The callback function is called in interrupt context and the data payload is
 * only valid during the call. If the user needs later access of the data, it
 * must copy it.
 */

typedef void (*dln2_event_cb_t)(struct platform_device *pdev, u16 echo,
				const void *data, int len);

/**
 * dl2n_register_event_cb - register a callback function for an event
 *
 * @pdev - the sub-device that registers the callback
 * @event - the event for which to register a callback
 * @event_cb - the callback function
 *
 * @return 0 in case of success, negative value in case of error
 */
int dln2_register_event_cb(struct platform_device *pdev, u16 event,
			   dln2_event_cb_t event_cb);

/**
 * dln2_unregister_event_cb - unregister the callback function for an event
 *
 * @pdev - the sub-device that registered the callback
 * @event - the event for which to register a callback
 */
void dln2_unregister_event_cb(struct platform_device *pdev, u16 event);

/**
 * dln2_transfer - issue a DLN2 command and wait for a response and the
 * associated data
 *
 * @pdev - the sub-device which is issuing this transfer
 * @cmd - the command to be sent to the device
 * @obuf - the buffer to be sent to the device; it can be NULL if the user
 *	doesn't need to transmit data with this command
 * @obuf_len - the size of the buffer to be sent to the device
 * @ibuf - any data associated with the response will be copied here; it can be
 *	NULL if the user doesn't need the response data
 * @ibuf_len - must be initialized to the input buffer size; it will be modified
 *	to indicate the actual data transferred;
 *
 * @return 0 for success, negative value for errors
 */
int dln2_transfer(struct platform_device *pdev, u16 cmd,
		  const void *obuf, unsigned obuf_len,
		  void *ibuf, unsigned *ibuf_len);

/**
 * dln2_transfer_rx - variant of @dln2_transfer() where TX buffer is not needed
 *
 * @pdev - the sub-device which is issuing this transfer
 * @cmd - the command to be sent to the device
 * @ibuf - any data associated with the response will be copied here; it can be
 *	NULL if the user doesn't need the response data
 * @ibuf_len - must be initialized to the input buffer size; it will be modified
 *	to indicate the actual data transferred;
 *
 * @return 0 for success, negative value for errors
 */

static inline int dln2_transfer_rx(struct platform_device *pdev, u16 cmd,
				   void *ibuf, unsigned *ibuf_len)
{
	return dln2_transfer(pdev, cmd, NULL, 0, ibuf, ibuf_len);
}

/**
 * dln2_transfer_tx - variant of @dln2_transfer() where RX buffer is not needed
 *
 * @pdev - the sub-device which is issuing this transfer
 * @cmd - the command to be sent to the device
 * @obuf - the buffer to be sent to the device; it can be NULL if the
 *	user doesn't need to transmit data with this command
 * @obuf_len - the size of the buffer to be sent to the device
 *
 * @return 0 for success, negative value for errors
 */
static inline int dln2_transfer_tx(struct platform_device *pdev, u16 cmd,
				   const void *obuf, unsigned obuf_len)
{
	return dln2_transfer(pdev, cmd, obuf, obuf_len, NULL, NULL);
}

#endif

docroot: /var/www/469ed2f6-4d4b-4a8a-9f5e-ee4ef04d3bc8/public_html

curdir: /usr/src/linux-headers-6.8.0-117/include/linux/mfd

	.	12288
	..	69632
X	88pm80x.h	10080
X	88pm860x.h	13266
X	aat2870.h	4014
	abx500	4096
X	abx500.h	2401
X	ac100.h	6121
X	adp5520.h	8506
X	altera-a10sr.h	2955
X	altera-sysmgr.h	725
	arizona	4096
X	as3711.h	2808
X	as3722.h	14879
	atc260x	4096
X	atmel-hlcdc.h	2094
X	axp20x.h	22450
X	bcm2835-pm.h	262
X	bcm590xx.h	618
X	bd9571mwv.h	3537
X	core.h	4300
X	cs42l43-regs.h	46818
X	cs42l43.h	2298
X	da8xx-cfgchip.h	7046
X	da903x.h	7218
	da9052	4096
	da9055	4096
	da9062	4096
	da9063	4096
	da9150	4096
X	davinci_voicecodec.h	2658
X	db8500-prcmu.h	21842
X	dbx500-prcmu.h	13088
X	dln2.h	3617
X	ds1wm.h	817
X	ezx-pcap.h	7932
X	gsc.h	1818
X	hi6421-pmic.h	1184
X	hi655x-pmic.h	1959
X	idt82p33_reg.h	3087
X	idt8a340_reg.h	31071
X	imx25-tsadc.h	4972
X	ingenic-tcu.h	1753
X	intel-m10-bmc.h	10079
X	intel_pmc_bxt.h	1542
X	intel_soc_pmic.h	1908
X	intel_soc_pmic_bxtwc.h	1641
X	intel_soc_pmic_mrfld.h	2288
X	ipaq-micro.h	3749
X	iqs62x.h	2974
X	janz.h	846
X	kempld.h	4122
X	khadas-mcu.h	3545
X	lm3533.h	2440
X	lochnagar.h	1624
X	lochnagar1_regs.h	7896
X	lochnagar2_regs.h	15550
X	lp3943.h	2598
X	lp873x.h	8493
X	lp87565.h	7588
X	lp8788-isink.h	1069
X	lp8788.h	8424
X	lpc_ich.h	754
	madera	4096
X	max14577-private.h	15776
X	max14577.h	2281
X	max5970.h	2776
X	max77541.h	2839
X	max77620.h	10967
X	max77650.h	1887
X	max77686-private.h	12658
X	max77686.h	2033
X	max77693-common.h	1088
X	max77693-private.h	17706
X	max77693.h	1619
X	max77714.h	1743
X	max77843-private.h	15588
X	max8907.h	7555
X	max8925.h	7204
X	max8997-private.h	12057
X	max8997.h	5394
X	max8998-private.h	4450
X	max8998.h	2983
X	mc13783.h	2756
X	mc13892.h	792
X	mc13xxx.h	7769
X	mcp.h	1647
X	menelaus.h	1284
X	motorola-cpcap.h	12651
X	mp2629.h	422
	mt6323	4096
	mt6331	4096
	mt6332	4096
	mt6357	4096
	mt6358	4096
	mt6359	4096
	mt6359p	4096
	mt6397	4096
X	mxs-lradc.h	5736
X	ntxec.h	1009
X	ocelot.h	1536
X	palmas.h	152133
	pcf50633	4096
X	qcom_rpm.h	293
X	rave-sp.h	1448
X	rc5t583.h	9501
X	rdc321x.h	591
X	retu.h	723
X	rk808.h	34742
X	rn5t618.h	8141
X	rohm-bd71815.h	15608
X	rohm-bd71828.h	13084
X	rohm-bd718x7.h	9038
X	rohm-bd957x.h	4362
X	rohm-generic.h	2700
X	rohm-shared.h	631
X	rsmu.h	967
X	rt5033-private.h	8852
X	rt5033.h	598
X	rz-mtu3.h	6759
	samsung	4096
X	sc27xx-pmic.h	228
X	si476x-core.h	15192
X	si476x-platform.h	6190
X	si476x-reports.h	4596
X	sky81452.h	354
X	sta2x11-mfd.h	18565
X	stm32-lptimer.h	2102
X	stm32-timers.h	6316
X	stmfx.h	4027
X	stmpe.h	4083
X	stpmic1.h	5719
X	stw481x.h	1422
X	sun4i-gpadc.h	3564
X	sy7636a.h	1061
	syscon	4096
X	syscon.h	2044
X	tc3589x.h	4123
X	ti-lmu-register.h	5666
X	ti-lmu.h	1857
X	ti_am335x_tscadc.h	5875
X	tmio.h	3582
X	tps6105x.h	3079
X	tps65010.h	6576
X	tps6507x.h	5055
X	tps65086.h	3476
X	tps65090.h	3814
X	tps65217.h	8033
X	tps65218.h	7803
X	tps65219.h	11849
X	tps6586x.h	2802
X	tps65910.h	30094
X	tps65912.h	9731
X	tps6594.h	36691
X	tps68470.h	3377
X	twl.h	23435
X	twl4030-audio.h	8129
X	twl6040.h	5979
X	ucb1x00.h	6590
X	viperboard.h	2802
	wcd934x	4096
X	wl1273-core.h	7887
	wm831x	4096
	wm8350	4096
X	wm8400-audio.h	70819
X	wm8400-private.h	58492
X	wm8400.h	561
	wm8994	4096
X	wm97xx.h	369