root/sys/dev/ic/pcf8584.c
/*      $NetBSD: pcf8584.c,v 1.25 2026/07/09 14:55:03 thorpej Exp $     */
/*      $OpenBSD: pcf8584.c,v 1.9 2007/10/20 18:46:21 kettenis Exp $ */

/*
 * Copyright (c) 2006 David Gwynne <dlg@openbsd.org>
 *
 * Permission to use, copy, modify, and distribute this software for any
 * purpose with or without fee is hereby granted, provided that the above
 * copyright notice and this permission notice appear in all copies.
 *
 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 */

#include <sys/param.h>
#include <sys/systm.h>
#include <sys/device.h>
#include <sys/kernel.h>
#include <sys/proc.h>
#include <sys/bus.h>

#include <dev/i2c/i2cvar.h>

#include <dev/ic/pcf8584var.h>
#include <dev/ic/pcf8584reg.h>

/* Write then read */
#define REPEAT_START            1

void            pcfiic_init(struct pcfiic_softc *);
int             pcfiic_i2c_acquire_bus(void *, int);
void            pcfiic_i2c_release_bus(void *, int);
int             pcfiic_i2c_exec(void *, i2c_op_t, i2c_addr_t, const void *,
                    size_t, void *, size_t, int);

int             pcfiic_xmit(struct pcfiic_softc *, u_int8_t, const u_int8_t *,
                    size_t, const u_int8_t *, size_t, int);
int             pcfiic_recv(struct pcfiic_softc *, u_int8_t, u_int8_t *,
                    size_t, int);

u_int8_t        pcfiic_read(struct pcfiic_softc *, bus_size_t);
void            pcfiic_write(struct pcfiic_softc *, bus_size_t, u_int8_t);
void            pcfiic_choose_bus(struct pcfiic_softc *, u_int8_t);
int             pcfiic_wait_BBN(struct pcfiic_softc *);
int             pcfiic_wait_pin(struct pcfiic_softc *, volatile u_int8_t *);

void
pcfiic_init(struct pcfiic_softc *sc)
{
        /* init S1 */
        pcfiic_write(sc, PCF8584_S1, PCF8584_CTRL_PIN);
        /* own address */
        pcfiic_write(sc, PCF8584_S0, sc->sc_addr);

        /* select clock reg */
        pcfiic_write(sc, PCF8584_S1, PCF8584_CTRL_PIN | PCF8584_CTRL_ES1);
        pcfiic_write(sc, PCF8584_S0, sc->sc_clock);

        pcfiic_write(sc, PCF8584_S1, PCF8584_CMD_IDLE);

        delay(200000);  /* Multi-Master mode, wait for longest i2c message */
}

void
pcfiic_attach(struct pcfiic_softc *sc, i2c_addr_t addr, u_int8_t clock)
{
        sc->sc_clock = clock;
        sc->sc_addr = addr;

        pcfiic_init(sc);

        if (sc->sc_has_mux)
                pcfiic_choose_bus(sc, 0);

        iic_tag_init(&sc->sc_i2c);
        sc->sc_i2c.ic_cookie = sc;
        sc->sc_i2c.ic_exec = pcfiic_i2c_exec;

        /*
         * Note: This driver ALWAYS polls, at the moment anyway.
         * It's not exactly in a performance-critical path, and
         * we're only only operating in master mode in any case.
         */
        sc->sc_poll = true;

        iicbus_attach(sc->sc_dev, &sc->sc_i2c);
}

int
pcfiic_intr(void *arg)
{
        return (0);
}

int
pcfiic_i2c_exec(void *arg, i2c_op_t op, i2c_addr_t addr,
    const void *cmdbuf, size_t cmdlen, void *buf, size_t len, int flags)
{
        struct pcfiic_softc     *sc = arg;
        int                     ret = 0;

#if 0
        printf("%s: exec op: %d addr: 0x%x cmdlen: %d len: %d flags 0x%x\n",
            device_xname(sc->sc_dev), op, addr, (int)cmdlen, (int)len, flags);
#endif

        if (sc->sc_poll)
                flags |= I2C_F_POLL;

        if (sc->sc_has_mux)
                pcfiic_choose_bus(sc, addr >> 7);

        /*
         * If we are writing, write address, cmdbuf, buf.
         * If we are reading, either:
         *   write addr, cmdbuf, repeat-start, then read addr to buf, or:
         *   read addr to buf.
         */
        if (I2C_OP_WRITE_P(op)) {
                ret = pcfiic_xmit(sc, addr & 0x7f, cmdbuf, cmdlen,
                    buf, len, 0);
        } else {
                if(cmdlen > 0) {
                        if (pcfiic_xmit(sc, addr & 0x7f, cmdbuf, cmdlen,
                            NULL, 0, REPEAT_START) != 0)
                                return (1);
                        ret = pcfiic_recv(sc, addr & 0x7f, buf, len,
                            REPEAT_START);
                } else
                        ret = pcfiic_recv(sc, addr & 0x7f, buf, len,
                            0);
        }
        return (ret);
}

int
pcfiic_xmit(struct pcfiic_softc *sc, u_int8_t addr, const u_int8_t *cmdbuf,
    size_t cmdlen, const u_int8_t *buf, size_t len, int flags)
{
        int                     i;
        volatile u_int8_t       r;

        if (pcfiic_wait_BBN(sc) != 0) {
                printf("%s: transmit failed (BBN)\n", device_xname(sc->sc_dev));
                return (1);
        }

        pcfiic_write(sc, PCF8584_S0, addr << 1);
        pcfiic_write(sc, PCF8584_S1, PCF8584_CMD_START);

        for (i = 0; i <= cmdlen + len; i++) {
                if (pcfiic_wait_pin(sc, &r) != 0) {
                        pcfiic_write(sc, PCF8584_S1, PCF8584_CMD_STOP);
                        printf("%s: transmit failed at %d (PIN)\n",
                            device_xname(sc->sc_dev), i);
                        return (1);
                }

                if (r & PCF8584_STATUS_LRB) {
                        pcfiic_write(sc, PCF8584_S1, PCF8584_CMD_STOP);
                        return (1);
                }

                if (i < cmdlen)
                        pcfiic_write(sc, PCF8584_S0, cmdbuf[i]);
                else if (i < cmdlen + len)
                        pcfiic_write(sc, PCF8584_S0, buf[i - cmdlen]);
        }
        if (flags != REPEAT_START)
                pcfiic_write(sc, PCF8584_S1, PCF8584_CMD_STOP);
        return (0);
}

int
pcfiic_recv(struct pcfiic_softc *sc, u_int8_t addr, u_int8_t *buf, size_t len,
    int flags)
{
        int                     i = 0, err = 0;
        volatile u_int8_t       r;

        if (flags != REPEAT_START) {
                if (pcfiic_wait_BBN(sc) != 0) {
                        printf("%s: receive failed (BBN)\n",
                            device_xname(sc->sc_dev));
                        return (1);
                }
                pcfiic_write(sc, PCF8584_S0, (addr << 1) | 0x01);
                pcfiic_write(sc, PCF8584_S1, PCF8584_CMD_START);
        } else {
                pcfiic_write(sc, PCF8584_S1, PCF8584_CMD_REPSTART);
                pcfiic_write(sc, PCF8584_S0, (addr << 1) | 0x01);
        }

        for (i = 0; i <= len; i++) {
                if (pcfiic_wait_pin(sc, &r) != 0) {
                        pcfiic_write(sc, PCF8584_S1, PCF8584_CMD_STOP);
                        printf("%s: receive failed at %d (PIN)\n",
                            device_xname(sc->sc_dev), i);
                        return (1);
                }

                if ((i != len) && (r & PCF8584_STATUS_LRB)) {
                        pcfiic_write(sc, PCF8584_S1, PCF8584_CMD_STOP);
                        pcfiic_read(sc, PCF8584_S0);
                        return (1);
                }

                if (i == len - 1) {
                        pcfiic_write(sc, PCF8584_S1, PCF8584_CMD_NAK);
                } else if (i == len) {
                        pcfiic_write(sc, PCF8584_S1, PCF8584_CMD_STOP);
                }

                r = pcfiic_read(sc, PCF8584_S0);
                if (i > 0)
                        buf[i - 1] = r;
        }
        return (err);
}

static inline void
pcfiic_delay(struct pcfiic_softc *sc)
{
        if (sc->sc_delay) {
                delay(sc->sc_delay);
        }
}

u_int8_t
pcfiic_read(struct pcfiic_softc *sc, bus_size_t r)
{
        u_int8_t val;

        bus_space_barrier(sc->sc_iot, sc->sc_ioh, sc->sc_regmap[r], 1,
            BUS_SPACE_BARRIER_READ);
        val = bus_space_read_1(sc->sc_iot, sc->sc_ioh, sc->sc_regmap[r]);
        pcfiic_delay(sc);
        return val;
}

void
pcfiic_write(struct pcfiic_softc *sc, bus_size_t r, u_int8_t v)
{
        bus_space_write_1(sc->sc_iot, sc->sc_ioh, sc->sc_regmap[r], v);
        pcfiic_delay(sc);
        bus_space_barrier(sc->sc_iot, sc->sc_ioh, sc->sc_regmap[PCF8584_S1], 1,
            BUS_SPACE_BARRIER_WRITE | BUS_SPACE_BARRIER_READ);
        (void)bus_space_read_1(sc->sc_iot, sc->sc_ioh,
            sc->sc_regmap[PCF8584_S1]);
        pcfiic_delay(sc);
}

void
pcfiic_choose_bus(struct pcfiic_softc *sc, u_int8_t bus)
{
        bus_space_write_1(sc->sc_iot, sc->sc_mux_ioh, 0, bus);
        bus_space_barrier(sc->sc_iot, sc->sc_mux_ioh, 0, 1,
            BUS_SPACE_BARRIER_WRITE);
}

int
pcfiic_wait_BBN(struct pcfiic_softc *sc)
{
        int             i;

        for (i = 0; i < 1000; i++) {
                if (pcfiic_read(sc, PCF8584_S1) & PCF8584_STATUS_BBN)
                        return (0);
                delay(1000);
        }
        return (1);
}

int
pcfiic_wait_pin(struct pcfiic_softc *sc, volatile u_int8_t *r)
{
        int             i;

        for (i = 0; i < 1000; i++) {
                *r = pcfiic_read(sc, PCF8584_S1);
                if ((*r & PCF8584_STATUS_PIN) == 0)
                        return (0);
                delay(1000);
        }
        return (1);
}