Home | History | Annotate | Line # | Download | only in ic
nvmevar.h revision 1.9
      1 /*	$NetBSD: nvmevar.h,v 1.9 2016/10/20 19:20:40 jdolecek Exp $	*/
      2 /*	$OpenBSD: nvmevar.h,v 1.8 2016/04/14 11:18:32 dlg Exp $ */
      3 
      4 /*
      5  * Copyright (c) 2014 David Gwynne <dlg (at) openbsd.org>
      6  *
      7  * Permission to use, copy, modify, and distribute this software for any
      8  * purpose with or without fee is hereby granted, provided that the above
      9  * copyright notice and this permission notice appear in all copies.
     10  *
     11  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
     12  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
     13  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
     14  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
     15  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
     16  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
     17  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
     18  */
     19 
     20 #include <sys/bus.h>
     21 #include <sys/cpu.h>
     22 #include <sys/device.h>
     23 #include <sys/mutex.h>
     24 #include <sys/pool.h>
     25 #include <sys/queue.h>
     26 
     27 struct nvme_dmamem {
     28 	bus_dmamap_t		ndm_map;
     29 	bus_dma_segment_t	ndm_seg;
     30 	size_t			ndm_size;
     31 	void			*ndm_kva;
     32 };
     33 #define NVME_DMA_MAP(_ndm)	((_ndm)->ndm_map)
     34 #define NVME_DMA_LEN(_ndm)	((_ndm)->ndm_map->dm_segs[0].ds_len)
     35 #define NVME_DMA_DVA(_ndm)	((uint64_t)(_ndm)->ndm_map->dm_segs[0].ds_addr)
     36 #define NVME_DMA_KVA(_ndm)	((void *)(_ndm)->ndm_kva)
     37 
     38 struct nvme_softc;
     39 struct nvme_queue;
     40 
     41 typedef void (*nvme_nnc_done)(void *, struct buf *, uint16_t);
     42 
     43 struct nvme_ccb {
     44 	SIMPLEQ_ENTRY(nvme_ccb)	ccb_entry;
     45 
     46 	/* DMA handles */
     47 	bus_dmamap_t		ccb_dmamap;
     48 
     49 	bus_addr_t		ccb_prpl_off;
     50 	uint64_t		ccb_prpl_dva;
     51 	uint64_t		*ccb_prpl;
     52 
     53 	/* command context */
     54 	uint16_t		ccb_id;
     55 	void			*ccb_cookie;
     56 #define NVME_CCB_FREE	0xbeefdeed
     57 	void			(*ccb_done)(struct nvme_queue *,
     58 				    struct nvme_ccb *, struct nvme_cqe *);
     59 
     60 	/* namespace context */
     61 	void		*nnc_cookie;
     62 	nvme_nnc_done	nnc_done;
     63 	uint16_t	nnc_nsid;
     64 	uint16_t	nnc_flags;
     65 #define	NVME_NS_CTX_F_READ	__BIT(0)
     66 #define	NVME_NS_CTX_F_POLL	__BIT(1)
     67 
     68 	struct buf	*nnc_buf;
     69 	daddr_t		nnc_blkno;
     70 	size_t		nnc_datasize;
     71 	int		nnc_secsize;
     72 };
     73 
     74 struct nvme_queue {
     75 	struct nvme_softc	*q_sc;
     76 	kmutex_t		q_sq_mtx;
     77 	kmutex_t		q_cq_mtx;
     78 	struct nvme_dmamem	*q_sq_dmamem;
     79 	struct nvme_dmamem	*q_cq_dmamem;
     80 	bus_size_t 		q_sqtdbl; /* submission queue tail doorbell */
     81 	bus_size_t 		q_cqhdbl; /* completion queue head doorbell */
     82 	uint16_t		q_id;
     83 	uint32_t		q_entries;
     84 	uint32_t		q_sq_tail;
     85 	uint32_t		q_cq_head;
     86 	uint16_t		q_cq_phase;
     87 
     88 	kmutex_t		q_ccb_mtx;
     89 	u_int			q_nccbs;
     90 	struct nvme_ccb		*q_ccbs;
     91 	SIMPLEQ_HEAD(, nvme_ccb) q_ccb_list;
     92 	struct nvme_dmamem	*q_ccb_prpls;
     93 };
     94 
     95 struct nvme_namespace {
     96 	struct nvm_identify_namespace *ident;
     97 	device_t dev;
     98 	uint32_t flags;
     99 #define	NVME_NS_F_OPEN	__BIT(0)
    100 };
    101 
    102 struct nvme_softc {
    103 	device_t		sc_dev;
    104 
    105 	bus_space_tag_t		sc_iot;
    106 	bus_space_handle_t	sc_ioh;
    107 	bus_size_t		sc_ios;
    108 	bus_dma_tag_t		sc_dmat;
    109 
    110 	int			(*sc_intr_establish)(struct nvme_softc *,
    111 				    uint16_t qid, struct nvme_queue *);
    112 	int			(*sc_intr_disestablish)(struct nvme_softc *,
    113 				    uint16_t qid);
    114 	void			**sc_ih;	/* interrupt handlers */
    115 	void			**sc_softih;	/* softintr handlers */
    116 
    117 	u_int			sc_rdy_to;	/* RDY timeout */
    118 	size_t			sc_mps;		/* memory page size */
    119 	size_t			sc_mdts;	/* max data trasfer size */
    120 	u_int			sc_max_sgl;	/* max S/G segments */
    121 
    122 	struct nvm_identify_controller
    123 				sc_identify;
    124 
    125 	u_int			sc_nn;		/* namespace count */
    126 	struct nvme_namespace	*sc_namespaces;
    127 
    128 	bool			sc_use_mq;
    129 	u_int			sc_nq;		/* # of io queue (sc_q) */
    130 	struct nvme_queue	*sc_admin_q;
    131 	struct nvme_queue	**sc_q;
    132 
    133 	uint32_t		sc_flags;
    134 #define	NVME_F_ATTACHED	__BIT(0)
    135 #define	NVME_F_OPEN	__BIT(1)
    136 };
    137 
    138 #define	lemtoh16(p)	le16toh(*((uint16_t *)(p)))
    139 #define	lemtoh32(p)	le32toh(*((uint32_t *)(p)))
    140 #define	lemtoh64(p)	le64toh(*((uint64_t *)(p)))
    141 #define	htolem16(p, x)	(*((uint16_t *)(p)) = htole16(x))
    142 #define	htolem32(p, x)	(*((uint32_t *)(p)) = htole32(x))
    143 #define	htolem64(p, x)	(*((uint64_t *)(p)) = htole64(x))
    144 
    145 struct nvme_attach_args {
    146 	uint16_t	naa_nsid;
    147 	uint32_t	naa_qentries;
    148 };
    149 
    150 int	nvme_attach(struct nvme_softc *);
    151 int	nvme_detach(struct nvme_softc *, int flags);
    152 int	nvme_rescan(device_t, const char *, const int *);
    153 void	nvme_childdet(device_t, device_t);
    154 int	nvme_intr(void *);
    155 void	nvme_softintr_intx(void *);
    156 int	nvme_intr_msi(void *);
    157 void	nvme_softintr_msi(void *);
    158 
    159 static inline struct nvme_queue *
    160 nvme_get_q(struct nvme_softc *sc)
    161 {
    162 	return sc->sc_q[cpu_index(curcpu()) % sc->sc_nq];
    163 }
    164 
    165 /*
    166  * namespace
    167  */
    168 static inline struct nvme_namespace *
    169 nvme_ns_get(struct nvme_softc *sc, uint16_t nsid)
    170 {
    171 	if (nsid == 0 || nsid - 1 >= sc->sc_nn)
    172 		return NULL;
    173 	return &sc->sc_namespaces[nsid - 1];
    174 }
    175 
    176 int	nvme_ns_identify(struct nvme_softc *, uint16_t);
    177 void	nvme_ns_free(struct nvme_softc *, uint16_t);
    178 int	nvme_ns_dobio(struct nvme_softc *, uint16_t, void *,
    179     struct buf *, void *, size_t, int, daddr_t, int, nvme_nnc_done);
    180 int	nvme_ns_sync(struct nvme_softc *, uint16_t, void *, int, nvme_nnc_done);
    181