/*      $NetBSD: mlxvar.h,v 1.16 2016/09/27 03:33:32 pgoyette Exp $     */

/*-
* Copyright (c) 2001 The NetBSD Foundation, Inc.
* All rights reserved.
*
* This code is derived from software contributed to The NetBSD Foundation
* by Andrew Doran.
*
* 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 NETBSD FOUNDATION, INC. 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 FOUNDATION 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.
*/

/*-
* Copyright (c) 1999 Michael Smith
* 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.
*
* 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.
*
* from FreeBSD: mlxvar.h,v 1.5.2.2 2000/04/24 19:40:50 msmith Exp
*/

#ifndef _IC_MLXVAR_H_
#define _IC_MLXVAR_H_

/* Older boards allow up to 17 segments and 64kB transfers. */
#define MLX_MAX_SEGS            17
#define MLX_MAX_XFER            65536
#define MLX_SGL_SIZE            (sizeof(struct mlx_sgentry) * MLX_MAX_SEGS)

/* This shouldn't be ajusted lightly... */
#define MLX_MAX_DRIVES          32

/* Maximum queue depth, matching the older controllers. */
#define MLX_MAX_QUEUECNT        63

/* Number of CCBs to reserve for control operations. */
#define MLX_NCCBS_CONTROL       7

/* Structure describing a system drive as attached to the controller. */
struct mlx_sysdrive {
       u_int32_t       ms_size;
       u_short         ms_state;
       u_short         ms_raidlevel;
       device_t        ms_dv;
};

/* Optional per-CCB context. */
struct mlx_ccb;
struct mlx_context {
       void    (*mx_handler)(struct mlx_ccb *);
       void    *mx_context;
       device_t        mx_dv;
};

/* Command control block. */
struct mlx_ccb {
       union {
               SIMPLEQ_ENTRY(mlx_ccb) simpleq;
               SLIST_ENTRY(mlx_ccb) slist;
               TAILQ_ENTRY(mlx_ccb) tailq;
       } mc_chain;
       u_int           mc_flags;
       u_int           mc_status;
       u_int           mc_ident;
       time_t          mc_expiry;
       u_int           mc_nsgent;
       u_int           mc_xfer_size;
       bus_addr_t      mc_xfer_phys;
       bus_dmamap_t    mc_xfer_map;
       struct mlx_context mc_mx;
       u_int8_t        mc_mbox[16];
};
#define MC_XFER_IN      MU_XFER_IN      /* Map describes inbound xfer */
#define MC_XFER_OUT     MU_XFER_OUT     /* Map describes outbound xfer */
#define MC_WAITING      0x0400          /* We have waiters */
#define MC_CONTROL      0x0800          /* Control operation */

/*
* Per-controller state.
*/
struct mlx_softc {
       device_t                mlx_dv;
       bus_space_tag_t         mlx_iot;
       bus_space_handle_t      mlx_ioh;
       bus_dma_tag_t           mlx_dmat;
       bus_dmamap_t            mlx_dmamap;
       void                    *mlx_ih;

       SLIST_HEAD(, mlx_ccb)   mlx_ccb_freelist;
       TAILQ_HEAD(, mlx_ccb)   mlx_ccb_worklist;
       SIMPLEQ_HEAD(, mlx_ccb) mlx_ccb_queue;
       struct mlx_ccb          *mlx_ccbs;
       int                     mlx_nccbs;
       int                     mlx_nccbs_ctrl;

       void *                  mlx_sgls;
       bus_addr_t              mlx_sgls_paddr;

       int     (*mlx_submit)(struct mlx_softc *, struct mlx_ccb *);
       int     (*mlx_findcomplete)(struct mlx_softc *, u_int *, u_int *);
       void    (*mlx_intaction)(struct mlx_softc *, int);
       int     (*mlx_fw_handshake)(struct mlx_softc *, int *, int *, int *);
       int     (*mlx_reset)(struct mlx_softc *);

       int                     mlx_max_queuecnt;
       struct mlx_cinfo        mlx_ci;

       time_t                  mlx_lastpoll;
       u_int                   mlx_lastevent;
       u_int                   mlx_currevent;
       u_int                   mlx_bg;
       struct mlx_rebuild_status mlx_rebuildstat;
       struct mlx_pause        mlx_pause;
       int                     mlx_flags;

       struct mlx_sysdrive     mlx_sysdrive[MLX_MAX_DRIVES];
       int                     mlx_numsysdrives;
};

#define MLX_BG_CHECK            1       /* we started a check */
#define MLX_BG_REBUILD          2       /* we started a rebuild */
#define MLX_BG_SPONTANEOUS      3       /* it just happened somehow */

#define MLXF_SPINUP_REPORTED    0x0001  /* "spinning up drives" displayed */
#define MLXF_EVENTLOG_BUSY      0x0002  /* currently reading event log */
#define MLXF_FW_INITTED         0x0004  /* firmware init crap done */
#define MLXF_PAUSEWORKS         0x0008  /* channel pause works as expected */
#define MLXF_OPEN               0x0010  /* control device is open */
#define MLXF_INITOK             0x0020  /* controller initialised OK */
#define MLXF_PERIODIC_CTLR      0x0040  /* periodic check running */
#define MLXF_PERIODIC_DRIVE     0x0080  /* periodic check running */
#define MLXF_PERIODIC_REBUILD   0x0100  /* periodic check running */
#define MLXF_RESCANNING         0x0400  /* rescanning drive table */

struct mlx_attach_args {
       int             mlxa_unit;
};

int     mlx_flush(struct mlx_softc *, int);
void    mlx_init(struct mlx_softc *, const char *);
int     mlx_intr(void *);
int     mlx_configure(struct mlx_softc *, int);

int     mlx_ccb_alloc(struct mlx_softc *, struct mlx_ccb **, int);
const char *mlx_ccb_diagnose(struct mlx_ccb *);
void    mlx_ccb_enqueue(struct mlx_softc *, struct mlx_ccb *);
void    mlx_ccb_free(struct mlx_softc *, struct mlx_ccb *);
int     mlx_ccb_map(struct mlx_softc *, struct mlx_ccb *, void *, int, int);
int     mlx_ccb_poll(struct mlx_softc *, struct mlx_ccb *, int);
void    mlx_ccb_unmap(struct mlx_softc *, struct mlx_ccb *);
int     mlx_ccb_wait(struct mlx_softc *, struct mlx_ccb *);

static __inline void    mlx_make_type1(struct mlx_ccb *, u_int8_t, u_int16_t,
                                      u_int32_t, u_int8_t, u_int32_t,
                                      u_int8_t);
static __inline void    mlx_make_type2(struct mlx_ccb *, u_int8_t, u_int8_t,
                                      u_int8_t, u_int8_t, u_int8_t,
                                      u_int8_t, u_int8_t, u_int32_t,
                                      u_int8_t);
static __inline void    mlx_make_type3(struct mlx_ccb *, u_int8_t, u_int8_t,
                                      u_int8_t, u_int16_t, u_int8_t,
                                      u_int8_t, u_int32_t, u_int8_t);
static __inline void    mlx_make_type4(struct mlx_ccb *, u_int8_t, u_int16_t,
                                      u_int32_t, u_int32_t, u_int8_t);
static __inline void    mlx_make_type5(struct mlx_ccb *, u_int8_t,  u_int8_t,
                                      u_int8_t, u_int32_t, u_int32_t,
                                      u_int8_t);

static __inline u_int8_t        mlx_inb(struct mlx_softc *, int);
static __inline u_int16_t       mlx_inw(struct mlx_softc *, int);
static __inline u_int32_t       mlx_inl(struct mlx_softc *, int);
static __inline void            mlx_outb(struct mlx_softc *, int, u_int8_t);
static __inline void            mlx_outw(struct mlx_softc *, int, u_int16_t);
static __inline void            mlx_outl(struct mlx_softc *, int, u_int32_t);

static __inline void
mlx_make_type1(struct mlx_ccb *mc, u_int8_t code, u_int16_t f1, u_int32_t f2,
              u_int8_t f3, u_int32_t f4, u_int8_t f5)
{

       mc->mc_mbox[0x0] = code;
       mc->mc_mbox[0x2] = f1;
       mc->mc_mbox[0x3] = ((f2 >> 18) & 0xc0) | ((f1 >> 8) & 0x3f);
       mc->mc_mbox[0x4] = f2;
       mc->mc_mbox[0x5] = (f2 >> 8);
       mc->mc_mbox[0x6] = (f2 >> 16);
       mc->mc_mbox[0x7] = f3;
       mc->mc_mbox[0x8] = f4;
       mc->mc_mbox[0x9] = (f4 >> 8);
       mc->mc_mbox[0xa] = (f4 >> 16);
       mc->mc_mbox[0xb] = (f4 >> 24);
       mc->mc_mbox[0xc] = f5;
}

static __inline void
mlx_make_type2(struct mlx_ccb *mc, u_int8_t code, u_int8_t f1, u_int8_t f2,
              u_int8_t f3, u_int8_t f4, u_int8_t f5, u_int8_t f6,
              u_int32_t f7, u_int8_t f8)
{

       mc->mc_mbox[0x0] = code;
       mc->mc_mbox[0x2] = f1;
       mc->mc_mbox[0x3] = f2;
       mc->mc_mbox[0x4] = f3;
       mc->mc_mbox[0x5] = f4;
       mc->mc_mbox[0x6] = f5;
       mc->mc_mbox[0x7] = f6;
       mc->mc_mbox[0x8] = f7;
       mc->mc_mbox[0x9] = (f7 >> 8);
       mc->mc_mbox[0xa] = (f7 >> 16);
       mc->mc_mbox[0xb] = (f7 >> 24);
       mc->mc_mbox[0xc] = f8;
}

static __inline void
mlx_make_type3(struct mlx_ccb *mc, u_int8_t code, u_int8_t f1, u_int8_t f2,
              u_int16_t f3, u_int8_t f4, u_int8_t f5, u_int32_t f6,
              u_int8_t f7)
{

       mc->mc_mbox[0x0] = code;
       mc->mc_mbox[0x2] = f1;
       mc->mc_mbox[0x3] = f2;
       mc->mc_mbox[0x4] = f3;
       mc->mc_mbox[0x5] = (f3 >> 8);
       mc->mc_mbox[0x6] = f4;
       mc->mc_mbox[0x7] = f5;
       mc->mc_mbox[0x8] = f6;
       mc->mc_mbox[0x9] = (f6 >> 8);
       mc->mc_mbox[0xa] = (f6 >> 16);
       mc->mc_mbox[0xb] = (f6 >> 24);
       mc->mc_mbox[0xc] = f7;
}

static __inline void
mlx_make_type4(struct mlx_ccb *mc, u_int8_t code,  u_int16_t f1, u_int32_t f2,
              u_int32_t f3, u_int8_t f4)
{

       mc->mc_mbox[0x0] = code;
       mc->mc_mbox[0x2] = f1;
       mc->mc_mbox[0x3] = (f1 >> 8);
       mc->mc_mbox[0x4] = f2;
       mc->mc_mbox[0x5] = (f2 >> 8);
       mc->mc_mbox[0x6] = (f2 >> 16);
       mc->mc_mbox[0x7] = (f2 >> 24);
       mc->mc_mbox[0x8] = f3;
       mc->mc_mbox[0x9] = (f3 >> 8);
       mc->mc_mbox[0xa] = (f3 >> 16);
       mc->mc_mbox[0xb] = (f3 >> 24);
       mc->mc_mbox[0xc] = f4;
}

static __inline void
mlx_make_type5(struct mlx_ccb *mc, u_int8_t code, u_int8_t f1, u_int8_t f2,
              u_int32_t f3, u_int32_t f4, u_int8_t f5)
{

       mc->mc_mbox[0x0] = code;
       mc->mc_mbox[0x2] = f1;
       mc->mc_mbox[0x3] = f2;
       mc->mc_mbox[0x4] = f3;
       mc->mc_mbox[0x5] = (f3 >> 8);
       mc->mc_mbox[0x6] = (f3 >> 16);
       mc->mc_mbox[0x7] = (f3 >> 24);
       mc->mc_mbox[0x8] = f4;
       mc->mc_mbox[0x9] = (f4 >> 8);
       mc->mc_mbox[0xa] = (f4 >> 16);
       mc->mc_mbox[0xb] = (f4 >> 24);
       mc->mc_mbox[0xc] = f5;
}

static __inline u_int8_t
mlx_inb(struct mlx_softc *mlx, int off)
{

       bus_space_barrier(mlx->mlx_iot, mlx->mlx_ioh, off, 1,
           BUS_SPACE_BARRIER_WRITE | BUS_SPACE_BARRIER_READ);
       return (bus_space_read_1(mlx->mlx_iot, mlx->mlx_ioh, off));
}

static __inline u_int16_t
mlx_inw(struct mlx_softc *mlx, int off)
{

       bus_space_barrier(mlx->mlx_iot, mlx->mlx_ioh, off, 2,
           BUS_SPACE_BARRIER_WRITE | BUS_SPACE_BARRIER_READ);
       return (bus_space_read_2(mlx->mlx_iot, mlx->mlx_ioh, off));
}

static __inline u_int32_t
mlx_inl(struct mlx_softc *mlx, int off)
{

       bus_space_barrier(mlx->mlx_iot, mlx->mlx_ioh, off, 4,
           BUS_SPACE_BARRIER_WRITE | BUS_SPACE_BARRIER_READ);
       return (bus_space_read_4(mlx->mlx_iot, mlx->mlx_ioh, off));
}

static __inline void
mlx_outb(struct mlx_softc *mlx, int off, u_int8_t val)
{

       bus_space_write_1(mlx->mlx_iot, mlx->mlx_ioh, off, val);
       bus_space_barrier(mlx->mlx_iot, mlx->mlx_ioh, off, 1,
           BUS_SPACE_BARRIER_WRITE);
}

static __inline void
mlx_outw(struct mlx_softc *mlx, int off, u_int16_t val)
{

       bus_space_write_2(mlx->mlx_iot, mlx->mlx_ioh, off, val);
       bus_space_barrier(mlx->mlx_iot, mlx->mlx_ioh, off, 2,
           BUS_SPACE_BARRIER_WRITE);
}

static __inline void
mlx_outl(struct mlx_softc *mlx, int off, u_int32_t val)
{

       bus_space_write_4(mlx->mlx_iot, mlx->mlx_ioh, off, val);
       bus_space_barrier(mlx->mlx_iot, mlx->mlx_ioh, off, 4,
           BUS_SPACE_BARRIER_WRITE);
}

#endif  /* !_IC_MLXVAR_H_ */