freebsd-src/sys/dev/sff/sfp_fdt.c

/*-
 * SPDX-License-Identifier: BSD-2-Clause
 *
 * Copyright © 2023 Dmitry Salychev
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 *
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 * SUCH DAMAGE.
 */

/*
 * Small Form Factor (SFF) Committee Pluggable (SFP) Transceiver (FDT-based).
 */

#include <sys/param.h>
#include <sys/kernel.h>
#include <sys/bus.h>
#include <sys/module.h>

#include <dev/ofw/ofw_bus.h>
#include <dev/ofw/ofw_bus_subr.h>
#include <dev/fdt/simplebus.h>

#include "sff_if.h"

struct sfp_fdt_softc {
	phandle_t	ofw_node;
	phandle_t	i2c_bus;

	phandle_t	mod_def;
	phandle_t	los;
	phandle_t	tx_fault;
	phandle_t	tx_disable;
	phandle_t	rx_rate;
	phandle_t	tx_rate;
	uint32_t	max_power; /* in mW */
};

static int
sfp_fdt_probe(device_t dev)
{
	phandle_t node;
	ssize_t s;

	node = ofw_bus_get_node(dev);
	if (!ofw_bus_node_is_compatible(node, "sff,sfp"))
		return (ENXIO);

	s = device_get_property(dev, "i2c-bus", &node, sizeof(node),
	    DEVICE_PROP_HANDLE);
	if (s == -1) {
		device_printf(dev, "%s: '%s' has no 'i2c-bus' property, s %zd\n",
		    __func__, ofw_bus_get_name(dev), s);
		return (ENXIO);
	}

	device_set_desc(dev, "Small Form-factor Pluggable Transceiver");
	return (BUS_PROBE_DEFAULT);
}

static int
sfp_fdt_attach(device_t dev)
{
	struct sfp_fdt_softc *sc;
	ssize_t s;
	int error;

	sc = device_get_softc(dev);
	sc->ofw_node = ofw_bus_get_node(dev);

	s = device_get_property(dev, "i2c-bus", &sc->i2c_bus,
	    sizeof(sc->i2c_bus), DEVICE_PROP_HANDLE);
	if (s == -1) {
		device_printf(dev, "%s: cannot find 'i2c-bus' property: %zd\n",
		    __func__, s);
		return (ENXIO);
	}

	/* Optional properties */
	(void)device_get_property(dev, "mod-def0-gpios", &sc->mod_def,
	    sizeof(sc->mod_def), DEVICE_PROP_HANDLE);
	(void)device_get_property(dev, "los-gpios", &sc->los, sizeof(sc->los),
	    DEVICE_PROP_HANDLE);
	(void)device_get_property(dev, "tx-fault-gpios", &sc->tx_fault,
	    sizeof(sc->tx_fault), DEVICE_PROP_HANDLE);
	(void)device_get_property(dev, "tx-disable-gpios", &sc->tx_disable,
	    sizeof(sc->tx_disable), DEVICE_PROP_HANDLE);
	(void)device_get_property(dev, "rate-select0-gpios", &sc->rx_rate,
	    sizeof(sc->rx_rate), DEVICE_PROP_HANDLE);
	(void)device_get_property(dev, "rate-select1-gpios", &sc->tx_rate,
	    sizeof(sc->tx_rate), DEVICE_PROP_HANDLE);
	(void)device_get_property(dev, "maximum-power-milliwatt", &sc->max_power,
	    sizeof(sc->max_power), DEVICE_PROP_UINT32);

	error = OF_device_register_xref(OF_xref_from_node(sc->ofw_node), dev);
	if (error != 0)
		device_printf(dev, "%s: failed to register xref %#x\n",
		    __func__, OF_xref_from_node(sc->ofw_node));

	return (error);
}

static int
sfp_fdt_get_i2c_bus(device_t dev, device_t *i2c_bus)
{
	struct sfp_fdt_softc *sc;
	device_t xdev;

	KASSERT(i2c_bus != NULL, ("%s: i2c_bus is NULL", __func__));

	sc = device_get_softc(dev);
	xdev = OF_device_from_xref(OF_xref_from_node(sc->i2c_bus));
	if (xdev == NULL)
		return (ENXIO);

	*i2c_bus = xdev;
	return (0);
}

static device_method_t sfp_fdt_methods[] = {
	/* Device interface */
	DEVMETHOD(device_probe,		sfp_fdt_probe),
	DEVMETHOD(device_attach,	sfp_fdt_attach),
	DEVMETHOD(device_detach,	bus_generic_detach),

	/* SFF */
	DEVMETHOD(sff_get_i2c_bus,	sfp_fdt_get_i2c_bus),

	DEVMETHOD_END
};

DEFINE_CLASS_0(sfp_fdt, sfp_fdt_driver, sfp_fdt_methods,
    sizeof(struct sfp_fdt_softc));

EARLY_DRIVER_MODULE(sfp_fdt, simplebus, sfp_fdt_driver, 0, 0,
    BUS_PASS_SUPPORTDEV);
EARLY_DRIVER_MODULE(sfp_fdt, ofwbus, sfp_fdt_driver, 0, 0,
    BUS_PASS_SUPPORTDEV);