root/sys/dev/mailbox/arm/arm_doorbell.c
/*-
 * SPDX-License-Identifier: BSD-2-Clause
 *
 * Copyright (c) 2022 Ruslan Bukin <br@bsdpad.com>
 *
 * This work was supported by Innovate UK project 105694, "Digital Security
 * by Design (DSbD) Technology Platform Prototype".
 *
 * 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.
 */

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

#include <machine/bus.h>

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

#include "arm_doorbell.h"

#define MHU_CHAN_RX_LP          0x000   /* Low priority channel */
#define MHU_CHAN_RX_HP          0x020   /* High priority channel */
#define MHU_CHAN_RX_SEC         0x200   /* Secure channel */
#define  MHU_INTR_STAT          0x00
#define  MHU_INTR_SET           0x08
#define  MHU_INTR_CLEAR         0x10

#define MHU_TX_REG_OFFSET       0x100

#define DOORBELL_N_CHANNELS     3
#define DOORBELL_N_DOORBELLS    (DOORBELL_N_CHANNELS * 32)

struct arm_doorbell dbells[DOORBELL_N_DOORBELLS];

static struct resource_spec arm_doorbell_spec[] = {
        { SYS_RES_MEMORY,       0,      RF_ACTIVE },
        { SYS_RES_IRQ,          0,      RF_ACTIVE },
        { SYS_RES_IRQ,          1,      RF_ACTIVE },
        { -1, 0 }
};

struct arm_doorbell_softc {
        struct resource         *res[3];
        void                    *lp_intr_cookie;
        void                    *hp_intr_cookie;
        device_t                dev;
};

static void
arm_doorbell_lp_intr(void *arg)
{
        struct arm_doorbell_softc *sc;
        struct arm_doorbell *db;
        uint32_t reg;
        int i;

        sc = arg;

        reg = bus_read_4(sc->res[0], MHU_CHAN_RX_LP + MHU_INTR_STAT);
        for (i = 0; i < 32; i++) {
                if (reg & (1 << i)) {
                        db = &dbells[i];
                        bus_write_4(sc->res[0], MHU_CHAN_RX_LP + MHU_INTR_CLEAR,
                            (1 << i));
                        if (db->func != NULL)
                                db->func(db->arg);
                }
        }
}

static void
arm_doorbell_hp_intr(void *arg)
{
        struct arm_doorbell_softc *sc;
        struct arm_doorbell *db;
        uint32_t reg;
        int i;

        sc = arg;

        reg = bus_read_4(sc->res[0], MHU_CHAN_RX_HP + MHU_INTR_STAT);
        for (i = 0; i < 32; i++) {
                if (reg & (1 << i)) {
                        db = &dbells[i];
                        bus_write_4(sc->res[0], MHU_CHAN_RX_HP + MHU_INTR_CLEAR,
                            (1 << i));
                        if (db->func != NULL)
                                db->func(db->arg);
                }
        }
}

static int
arm_doorbell_probe(device_t dev)
{

        if (!ofw_bus_is_compatible(dev, "arm,mhu-doorbell"))
                return (ENXIO);

        if (!ofw_bus_status_okay(dev))
                return (ENXIO);

        device_set_desc(dev, "ARM MHU Doorbell");

        return (BUS_PROBE_DEFAULT);
}

static int
arm_doorbell_attach(device_t dev)
{
        struct arm_doorbell_softc *sc;
        phandle_t node;
        int error;

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

        node = ofw_bus_get_node(dev);
        if (node == -1)
                return (ENXIO);

        if (bus_alloc_resources(dev, arm_doorbell_spec, sc->res) != 0) {
                device_printf(dev, "Can't allocate resources for device.\n");
                return (ENXIO);
        }

        /* Setup interrupt handlers. */
        error = bus_setup_intr(dev, sc->res[1], INTR_TYPE_MISC | INTR_MPSAFE,
            NULL, arm_doorbell_lp_intr, sc, &sc->lp_intr_cookie);
        if (error != 0) {
                device_printf(dev, "Can't setup LP interrupt handler.\n");
                bus_release_resources(dev, arm_doorbell_spec, sc->res);
                return (ENXIO);
        }

        error = bus_setup_intr(dev, sc->res[2], INTR_TYPE_MISC | INTR_MPSAFE,
            NULL, arm_doorbell_hp_intr, sc, &sc->hp_intr_cookie);
        if (error != 0) {
                device_printf(dev, "Can't setup HP interrupt handler.\n");
                bus_release_resources(dev, arm_doorbell_spec, sc->res);
                return (ENXIO);
        }

        OF_device_register_xref(OF_xref_from_node(node), dev);

        return (0);
}

static int
arm_doorbell_detach(device_t dev)
{

        return (EBUSY);
}

struct arm_doorbell *
arm_doorbell_ofw_get(device_t dev, const char *name)
{
        phandle_t node, parent;
        struct arm_doorbell *db;
        device_t db_dev;
        pcell_t *cells;
        int nmboxes;
        int ncells;
        int idx;
        int db_id;
        int error;
        int chan;

        node = ofw_bus_get_node(dev);

        error = ofw_bus_parse_xref_list_get_length(node, "mboxes",
            "#mbox-cells", &nmboxes);
        if (error) {
                device_printf(dev, "%s can't get mboxes list.\n", __func__);
                return (NULL);
        }

        if (nmboxes == 0) {
                device_printf(dev, "%s mbox list is empty.\n", __func__);
                return (NULL);
        }

        error = ofw_bus_find_string_index(node, "mbox-names", name, &idx);
        if (error != 0) {
                device_printf(dev, "%s can't find string index.\n",
                    __func__);
                return (NULL);
        }

        error = ofw_bus_parse_xref_list_alloc(node, "mboxes", "#mbox-cells",
            idx, &parent, &ncells, &cells);
        if (error != 0) {
                device_printf(dev, "%s can't get mbox device xref\n",
                    __func__);
                return (NULL);
        }

        if (ncells != 2) {
                device_printf(dev, "Unexpected data size.\n");
                OF_prop_free(cells);
                return (NULL);
        }

        db_dev = OF_device_from_xref(parent);
        if (db_dev == NULL) {
                device_printf(dev, "%s: Can't get arm_doorbell device\n",
                    __func__);
                OF_prop_free(cells);
                return (NULL);
        }

        chan = cells[0];
        if (chan >= DOORBELL_N_CHANNELS) {
                device_printf(dev, "Unexpected channel number.\n");
                OF_prop_free(cells);
                return (NULL);
        }

        db_id = cells[1];
        if (db_id >= 32) {
                device_printf(dev, "Unexpected channel bit.\n");
                OF_prop_free(cells);
                return (NULL);
        }

        db = &dbells[chan * db_id];
        db->dev = dev;
        db->db_dev = db_dev;
        db->chan = chan;
        db->db = db_id;

        OF_prop_free(cells);

        return (db);
}

void
arm_doorbell_set(struct arm_doorbell *db)
{
        struct arm_doorbell_softc *sc;
        uint32_t offset;

        sc = device_get_softc(db->db_dev);

        switch (db->chan) {
        case 0:
                offset = MHU_CHAN_RX_LP;
                break;
        case 1:
                offset = MHU_CHAN_RX_HP;
                break;
        case 2:
                offset = MHU_CHAN_RX_SEC;
                break;
        default:
                panic("not reached");
        };

        offset |= MHU_TX_REG_OFFSET;

        bus_write_4(sc->res[0], offset + MHU_INTR_SET, (1 << db->db));
}

int
arm_doorbell_get(struct arm_doorbell *db)
{
        struct arm_doorbell_softc *sc;
        uint32_t offset;
        uint32_t reg;

        sc = device_get_softc(db->db_dev);

        switch (db->chan) {
        case 0:
                offset = MHU_CHAN_RX_LP;
                break;
        case 1:
                offset = MHU_CHAN_RX_HP;
                break;
        case 2:
                offset = MHU_CHAN_RX_SEC;
                break;
        default:
                panic("not reached");
        };

        reg = bus_read_4(sc->res[0], offset + MHU_INTR_STAT);
        if (reg & (1 << db->db)) {
                bus_write_4(sc->res[0], offset + MHU_INTR_CLEAR,
                    (1 << db->db));
                return (1);
        }

        return (0);
}

void
arm_doorbell_set_handler(struct arm_doorbell *db, void (*func)(void *),
    void *arg)
{

        db->func = func;
        db->arg = arg;
}

static device_method_t arm_doorbell_methods[] = {
        DEVMETHOD(device_probe,         arm_doorbell_probe),
        DEVMETHOD(device_attach,        arm_doorbell_attach),
        DEVMETHOD(device_detach,        arm_doorbell_detach),
        DEVMETHOD_END
};

DEFINE_CLASS_1(arm_doorbell, arm_doorbell_driver, arm_doorbell_methods,
    sizeof(struct arm_doorbell_softc), simplebus_driver);

EARLY_DRIVER_MODULE(arm_doorbell, simplebus, arm_doorbell_driver, 0, 0,
    BUS_PASS_INTERRUPT + BUS_PASS_ORDER_MIDDLE);
MODULE_VERSION(arm_doorbell, 1);