/* $NetBSD: oosiopvar.h,v 1.6 2008/03/29 09:11:35 tsutsui Exp $ */

/*
* Copyright (c) 2001 Shuichiro URATA.  All rights reserved.
*
* 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.
* 3. The name of the author may not be used to endorse or promote products
*    derived from this software without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``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 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.
*/

#define OOSIOP_NTGT     8               /* Max targets */
#define OOSIOP_NCB      32              /* Initial command buffers */
#define OOSIOP_NSG      (MIN(btoc(MAXPHYS) + 1, 32)) /* Max S/G operation */
#define OOSIOP_MAX_XFER ctob(OOSIOP_NSG - 1)

struct oosiop_xfer {
       /* script for scatter/gather DMA (move*nsg+jump) */
       uint32_t datain_scr[(OOSIOP_NSG + 1) * 2];
       uint32_t dataout_scr[(OOSIOP_NSG + 1) * 2];

       uint8_t msgin[8];
       uint8_t msgout[8];
       uint8_t status;
       uint8_t pad[7];
} __packed;

#define SCSI_OOSIOP_NOSTATUS    0xff    /* device didn't report status */

#define OOSIOP_XFEROFF(x)       offsetof(struct oosiop_xfer, x)
#define OOSIOP_DINSCROFF        OOSIOP_XFEROFF(datain_scr[0])
#define OOSIOP_DOUTSCROFF       OOSIOP_XFEROFF(dataout_scr[0])
#define OOSIOP_MSGINOFF         OOSIOP_XFEROFF(msgin[0])
#define OOSIOP_MSGOUTOFF        OOSIOP_XFEROFF(msgout[0])

#define OOSIOP_XFERSCR_SYNC(sc, cb, ops)                                \
       bus_dmamap_sync((sc)->sc_dmat, (cb)->xferdma, OOSIOP_DINSCROFF, \
           OOSIOP_MSGINOFF - OOSIOP_DINSCROFF, (ops))
#define OOSIOP_DINSCR_SYNC(sc, cb, ops)                                 \
       bus_dmamap_sync((sc)->sc_dmat, (cb)->xferdma, OOSIOP_DINSCROFF, \
           OOSIOP_DOUTSCROFF - OOSIOP_DINSCROFF, (ops))
#define OOSIOP_DOUTSCR_SYNC(sc, cb, ops)                                \
       bus_dmamap_sync((sc)->sc_dmat, (cb)->xferdma, OOSIOP_DOUTSCROFF,\
           OOSIOP_MSGINOFF - OOSIOP_DOUTSCROFF, (ops))
#define OOSIOP_XFERMSG_SYNC(sc, cb, ops)                                \
       bus_dmamap_sync((sc)->sc_dmat, (cb)->xferdma, OOSIOP_MSGINOFF,  \
           sizeof(struct oosiop_xfer) - OOSIOP_MSGINOFF, (ops))

#define OOSIOP_SCRIPT_SYNC(sc, ops)                                     \
       bus_dmamap_sync((sc)->sc_dmat, (sc)->sc_scrdma,                 \
           0, sizeof(oosiop_script), (ops))

struct oosiop_cb {
       TAILQ_ENTRY(oosiop_cb) chain;

       struct scsipi_xfer *xs;         /* SCSI xfer ctrl block from above */
       int flags;
       int id;                         /* target scsi id */
       int lun;                        /* target lun */

       bus_dmamap_t cmddma;            /* DMA map for command out */
       bus_dmamap_t datadma;           /* DMA map for data I/O */
       bus_dmamap_t xferdma;           /* DMA map for xfer block */

       int curdp;                      /* current data pointer */
       int savedp;                     /* saved data pointer */
       int msgoutlen;

       struct oosiop_xfer *xfer;       /* DMA xfer block */
};

/* oosiop_cb flags */
#define CBF_SELTOUT     0x01    /* Selection timeout */
#define CBF_TIMEOUT     0x02    /* Command timeout */

TAILQ_HEAD(oosiop_cb_queue, oosiop_cb);

struct oosiop_target {
       struct oosiop_cb *nexus;
       int flags;
       uint8_t scf;            /* synchronous clock divisor */
       uint8_t sxfer;          /* synchronous period and offset */
};

/* target flags */
#define TGTF_SYNCNEG    0x01    /* Trigger synchronous negotiation */
#define TGTF_WAITSDTR   0x02    /* Waiting SDTR from target */

struct oosiop_softc {
       device_t sc_dev;

       bus_space_tag_t sc_bst;         /* bus space tag */
       bus_space_handle_t sc_bsh;      /* bus space handle */

       bus_dma_tag_t sc_dmat;          /* bus DMA tag */
       bus_dmamap_t sc_scrdma;         /* script DMA map */

       bus_addr_t sc_scrbase;          /* script DMA base address */
       uint32_t *sc_scr;               /* ptr to script memory */

       int sc_chip;                    /* 700 or 700-66 */
#define OOSIOP_700      0
#define OOSIOP_700_66   1

       int             sc_id;          /* SCSI ID of this interface */
       int             sc_freq;        /* SCLK frequency */
       int             sc_ccf;         /* asynchronous divisor (*10) */
       uint8_t         sc_dcntl;
       uint8_t         sc_minperiod;

       struct oosiop_target sc_tgt[OOSIOP_NTGT];

       struct scsipi_adapter sc_adapter;
       struct scsipi_channel sc_channel;

       /* Lists of command blocks */
       struct oosiop_cb_queue sc_free_cb;
       struct oosiop_cb_queue sc_cbq;  /* command issue queue */
       struct oosiop_cb *sc_curcb;     /* current command */
       struct oosiop_cb *sc_lastcb;    /* last activated command */

       bus_addr_t sc_reselbuf;         /* msgin buffer for reselection */
       int sc_resid;                   /* reselected target id */

       int sc_active;
       int sc_nextdsp;
};

#define oosiop_read_1(sc, addr)                                         \
   bus_space_read_1((sc)->sc_bst, (sc)->sc_bsh, (addr))
#define oosiop_write_1(sc, addr, data)                                  \
   bus_space_write_1((sc)->sc_bst, (sc)->sc_bsh, (addr), (data))
/* XXX byte swapping should be handled by MD bus_space(9)? */
#define oosiop_read_4(sc, addr)                                         \
   le32toh(bus_space_read_4((sc)->sc_bst, (sc)->sc_bsh, (addr)))
#define oosiop_write_4(sc, addr, data)                                  \
   bus_space_write_4((sc)->sc_bst, (sc)->sc_bsh, (addr), htole32(data))

void oosiop_attach(struct oosiop_softc *);
int oosiop_intr(struct oosiop_softc *);