123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109 |
- /* 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
|