include/mux-internal.h

/* SPDX-License-Identifier: GPL-2.0+ */
/*
 * Based on the linux multiplexer framework
 *
 * Copyright (C) 2017 Axentia Technologies AB
 * Author: Peter Rosin <peda@axentia.se>
 *
 * Copyright (C) 2017-2018 Texas Instruments Incorporated - http://www.ti.com/
 * Jean-Jacques Hiblot <jjhiblot@ti.com>
 */

#ifndef _MUX_INTERNAL_H
#define _MUX_INTERNAL_H

/* See mux.h for background documentation. */

struct ofnode_phandle_args;

/**
 * struct mux_chip -	Represents a chip holding mux controllers.
 * @controllers:	Number of mux controllers handled by the chip.
 * @mux:		Array of mux controllers that are handled.
 *
 * This a per-device uclass-private data.
 */
struct mux_chip {
	unsigned int controllers;
	struct mux_control *mux;
};

/**
 * struct mux_control_ops -	Mux controller operations for a mux chip.
 * @set:			Set the state of the given mux controller.
 */
struct mux_control_ops {
	/**
	 * set - Apply a state to a multiplexer control
	 *
	 * @mux:	A multiplexer control
	 * @return 0 if OK, or a negative error code.
	 */
	int (*set)(struct mux_control *mux, int state);

	/**
	 * of_xlate - Translate a client's device-tree (OF) multiplexer
	 * specifier.
	 *
	 * If this function pointer is set to NULL, the multiplexer core will
	 * use a default implementation, which assumes #mux-control-cells = <1>
	 * and that the DT cell contains a simple integer channel ID.
	 *
	 * @dev_mux:	The multiplexer device. A single device may handle
	 *              several multiplexer controls.
	 * @args:	The multiplexer specifier values from device tree.
	 * @muxp:	(out) A multiplexer control
	 * @return 0 if OK, or a negative error code.
	 */
	int (*of_xlate)(struct mux_chip *dev_mux,
			struct ofnode_phandle_args *args,
			struct mux_control **muxp);
};

/**
 * struct mux_control -	Represents a mux controller.
 * @in_use:		Whether the mux controller is in use or not.
 * @dev:		The client device.
 * @cached_state:	The current mux controller state, or -1 if none.
 * @states:		The number of mux controller states.
 * @idle_state:		The mux controller state to use when inactive, or one
 *			of MUX_IDLE_AS_IS and MUX_IDLE_DISCONNECT.
 * @id:			The index of the mux controller within the mux chip
 *			it is a part of.
 *
 * Mux drivers may only change @states and @idle_state, and may only do so
 * between allocation and registration of the mux controller. Specifically,
 * @cached_state is internal to the mux core and should never be written by
 * mux drivers.
 */
struct mux_control {
	bool	in_use;
	struct udevice *dev;
	int cached_state;
	unsigned int states;
	int idle_state;
	int id;
};

/**
 * mux_control_get_index() - Get the index of the given mux controller
 * @mux:		The mux-control to get the index for.
 *
 * Return: The index of the mux controller within the mux chip the mux
 * controller is a part of.
 */
static inline unsigned int mux_control_get_index(struct mux_control *mux)
{
	return mux->id;
}

/**
 * mux_alloc_controllers() - Allocate the given number of mux controllers.
 * @dev:		The client device.
 * controllers:		Number of controllers to allocate.
 *
 * Return: 0 of OK, -errno otherwise.
 */
int mux_alloc_controllers(struct udevice *dev, unsigned int controllers);

#endif