/*-
 * Copyright (c) 2016 Microsoft Corp.
 * 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 unmodified, 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 ``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.
 *
 * $FreeBSD: stable/11/sys/dev/hyperv/include/vmbus.h 307459 2016-10-17 02:44:27Z sephe $
 */

#ifndef _VMBUS_H_
#define _VMBUS_H_

#include <sys/param.h>

/*
 * GPA stuffs.
 */
struct vmbus_gpa_range {
	uint32_t	gpa_len;
	uint32_t	gpa_ofs;
	uint64_t	gpa_page[0];
} __packed;

/* This is actually vmbus_gpa_range.gpa_page[1] */
struct vmbus_gpa {
	uint32_t	gpa_len;
	uint32_t	gpa_ofs;
	uint64_t	gpa_page;
} __packed;

#define VMBUS_CHANPKT_SIZE_SHIFT	3

#define VMBUS_CHANPKT_GETLEN(pktlen)	\
	(((int)(pktlen)) << VMBUS_CHANPKT_SIZE_SHIFT)

struct vmbus_chanpkt_hdr {
	uint16_t	cph_type;	/* VMBUS_CHANPKT_TYPE_ */
	uint16_t	cph_hlen;	/* header len, in 8 bytes */
	uint16_t	cph_tlen;	/* total len, in 8 bytes */
	uint16_t	cph_flags;	/* VMBUS_CHANPKT_FLAG_ */
	uint64_t	cph_xactid;
} __packed;

#define VMBUS_CHANPKT_TYPE_INBAND	0x0006
#define VMBUS_CHANPKT_TYPE_RXBUF	0x0007
#define VMBUS_CHANPKT_TYPE_GPA		0x0009
#define VMBUS_CHANPKT_TYPE_COMP		0x000b

#define VMBUS_CHANPKT_FLAG_RC		0x0001	/* report completion */

#define VMBUS_CHANPKT_CONST_DATA(pkt)		\
	(const void *)((const uint8_t *)(pkt) +	\
	VMBUS_CHANPKT_GETLEN((pkt)->cph_hlen))

struct vmbus_rxbuf_desc {
	uint32_t	rb_len;
	uint32_t	rb_ofs;
} __packed;

struct vmbus_chanpkt_rxbuf {
	struct vmbus_chanpkt_hdr cp_hdr;
	uint16_t	cp_rxbuf_id;
	uint16_t	cp_rsvd;
	uint32_t	cp_rxbuf_cnt;
	struct vmbus_rxbuf_desc cp_rxbuf[];
} __packed;

#define VMBUS_CHAN_SGLIST_MAX		32
#define VMBUS_CHAN_PRPLIST_MAX		32

struct hv_vmbus_channel;

int	vmbus_chan_open(struct hv_vmbus_channel *chan,
	    int txbr_size, int rxbr_size, const void *udata, int udlen,
	    vmbus_chan_callback_t cb, void *cbarg);
void	vmbus_chan_close(struct hv_vmbus_channel *chan);

int	vmbus_chan_gpadl_connect(struct hv_vmbus_channel *chan,
	    bus_addr_t paddr, int size, uint32_t *gpadl);
int	vmbus_chan_gpadl_disconnect(struct hv_vmbus_channel *chan,
	    uint32_t gpadl);

void	vmbus_chan_cpu_set(struct hv_vmbus_channel *chan, int cpu);
void	vmbus_chan_cpu_rr(struct hv_vmbus_channel *chan);
struct hv_vmbus_channel *
	vmbus_chan_cpu2chan(struct hv_vmbus_channel *chan, int cpu);
void	vmbus_chan_set_readbatch(struct hv_vmbus_channel *chan, bool on);

struct hv_vmbus_channel **
	vmbus_subchan_get(struct hv_vmbus_channel *pri_chan, int subchan_cnt);
void	vmbus_subchan_rel(struct hv_vmbus_channel **subchan, int subchan_cnt);
void	vmbus_subchan_drain(struct hv_vmbus_channel *pri_chan);

int	vmbus_chan_recv(struct hv_vmbus_channel *chan, void *data, int *dlen,
	    uint64_t *xactid);
int	vmbus_chan_recv_pkt(struct hv_vmbus_channel *chan,
	    struct vmbus_chanpkt_hdr *pkt, int *pktlen);

int	vmbus_chan_send(struct hv_vmbus_channel *chan, uint16_t type,
	    uint16_t flags, void *data, int dlen, uint64_t xactid);
int	vmbus_chan_send_sglist(struct hv_vmbus_channel *chan,
	    struct vmbus_gpa sg[], int sglen, void *data, int dlen,
	    uint64_t xactid);
int	vmbus_chan_send_prplist(struct hv_vmbus_channel *chan,
	    struct vmbus_gpa_range *prp, int prp_cnt, void *data, int dlen,
	    uint64_t xactid);

#endif	/* !_VMBUS_H_ */