2 * Copyright (c) 2016 Microsoft Corp.
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
8 * 1. Redistributions of source code must retain the above copyright
9 * notice unmodified, this list of conditions, and the following
11 * 2. Redistributions in binary form must reproduce the above copyright
12 * notice, this list of conditions and the following disclaimer in the
13 * documentation and/or other materials provided with the distribution.
15 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
16 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
17 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
18 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
19 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
20 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
21 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
22 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
23 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
24 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
32 #include <sys/param.h>
34 #include <machine/bus.h>
37 * VMBUS version is 32 bit, upper 16 bit for major_number and lower
38 * 16 bit for minor_number.
40 * 0.13 -- Windows Server 2008
45 #define VMBUS_VERSION_WS2008 ((0 << 16) | (13))
46 #define VMBUS_VERSION_WIN7 ((1 << 16) | (1))
47 #define VMBUS_VERSION_WIN8 ((2 << 16) | (4))
48 #define VMBUS_VERSION_WIN8_1 ((3 << 16) | (0))
50 #define VMBUS_VERSION_MAJOR(ver) (((uint32_t)(ver)) >> 16)
51 #define VMBUS_VERSION_MINOR(ver) (((uint32_t)(ver)) & 0xffff)
53 #define VMBUS_CHAN_POLLHZ_MIN 100 /* 10ms interval */
54 #define VMBUS_CHAN_POLLHZ_MAX 1000000 /* 1us interval */
59 struct vmbus_gpa_range {
65 /* This is actually vmbus_gpa_range.gpa_page[1] */
72 #define VMBUS_CHANPKT_SIZE_SHIFT 3
74 #define VMBUS_CHANPKT_GETLEN(pktlen) \
75 (((int)(pktlen)) << VMBUS_CHANPKT_SIZE_SHIFT)
77 struct vmbus_chanpkt_hdr {
78 uint16_t cph_type; /* VMBUS_CHANPKT_TYPE_ */
79 uint16_t cph_hlen; /* header len, in 8 bytes */
80 uint16_t cph_tlen; /* total len, in 8 bytes */
81 uint16_t cph_flags; /* VMBUS_CHANPKT_FLAG_ */
85 #define VMBUS_CHANPKT_TYPE_INBAND 0x0006
86 #define VMBUS_CHANPKT_TYPE_RXBUF 0x0007
87 #define VMBUS_CHANPKT_TYPE_GPA 0x0009
88 #define VMBUS_CHANPKT_TYPE_COMP 0x000b
90 #define VMBUS_CHANPKT_FLAG_NONE 0
91 #define VMBUS_CHANPKT_FLAG_RC 0x0001 /* report completion */
93 #define VMBUS_CHANPKT_CONST_DATA(pkt) \
94 (const void *)((const uint8_t *)(pkt) + \
95 VMBUS_CHANPKT_GETLEN((pkt)->cph_hlen))
98 #define VMBUS_CHANPKT_DATALEN(pkt) \
99 (VMBUS_CHANPKT_GETLEN((pkt)->cph_tlen) -\
100 VMBUS_CHANPKT_GETLEN((pkt)->cph_hlen))
102 struct vmbus_rxbuf_desc {
107 struct vmbus_chanpkt_rxbuf {
108 struct vmbus_chanpkt_hdr cp_hdr;
109 uint16_t cp_rxbuf_id;
111 uint32_t cp_rxbuf_cnt;
112 struct vmbus_rxbuf_desc cp_rxbuf[];
115 struct vmbus_chan_br {
117 bus_addr_t cbr_paddr;
122 struct vmbus_channel;
124 struct vmbus_xact_ctx;
129 typedef void (*vmbus_chan_callback_t)(struct vmbus_channel *, void *);
131 static __inline struct vmbus_channel *
132 vmbus_get_channel(device_t dev)
134 return device_get_ivars(dev);
138 * vmbus_chan_open_br()
142 * EISCONN Failed, and the memory passed through 'br' is still
143 * connected. Callers must _not_ free the the memory
144 * passed through 'br', if this error happens.
145 * other values Failed. The memory passed through 'br' is no longer
146 * connected. Callers are free to do anything with the
147 * memory passed through 'br'.
151 * vmbus_chan_close_direct()
154 * Callers of this function _must_ make sure to close all sub-channels before
155 * closing the primary channel.
159 * EISCONN Failed, and the memory associated with the bufring
160 * is still connected. Callers must _not_ free the the
161 * memory associated with the bufring, if this error
163 * other values Failed. The memory associated with the bufring is
164 * no longer connected. Callers are free to do anything
165 * with the memory associated with the bufring.
167 int vmbus_chan_open(struct vmbus_channel *chan,
168 int txbr_size, int rxbr_size, const void *udata, int udlen,
169 vmbus_chan_callback_t cb, void *cbarg);
170 int vmbus_chan_open_br(struct vmbus_channel *chan,
171 const struct vmbus_chan_br *cbr, const void *udata,
172 int udlen, vmbus_chan_callback_t cb, void *cbarg);
173 void vmbus_chan_close(struct vmbus_channel *chan);
174 int vmbus_chan_close_direct(struct vmbus_channel *chan);
175 void vmbus_chan_intr_drain(struct vmbus_channel *chan);
176 void vmbus_chan_run_task(struct vmbus_channel *chan,
178 void vmbus_chan_set_orphan(struct vmbus_channel *chan,
179 struct vmbus_xact_ctx *);
180 void vmbus_chan_unset_orphan(struct vmbus_channel *chan);
181 const void *vmbus_chan_xact_wait(const struct vmbus_channel *chan,
182 struct vmbus_xact *xact, size_t *resp_len, bool can_sleep);
184 int vmbus_chan_gpadl_connect(struct vmbus_channel *chan,
185 bus_addr_t paddr, int size, uint32_t *gpadl);
186 int vmbus_chan_gpadl_disconnect(struct vmbus_channel *chan,
189 void vmbus_chan_cpu_set(struct vmbus_channel *chan, int cpu);
190 void vmbus_chan_cpu_rr(struct vmbus_channel *chan);
191 void vmbus_chan_set_readbatch(struct vmbus_channel *chan, bool on);
193 struct vmbus_channel **
194 vmbus_subchan_get(struct vmbus_channel *pri_chan,
196 void vmbus_subchan_rel(struct vmbus_channel **subchan,
198 void vmbus_subchan_drain(struct vmbus_channel *pri_chan);
200 int vmbus_chan_recv(struct vmbus_channel *chan, void *data, int *dlen,
202 int vmbus_chan_recv_pkt(struct vmbus_channel *chan,
203 struct vmbus_chanpkt_hdr *pkt, int *pktlen);
205 int vmbus_chan_send(struct vmbus_channel *chan, uint16_t type,
206 uint16_t flags, void *data, int dlen, uint64_t xactid);
207 int vmbus_chan_send_sglist(struct vmbus_channel *chan,
208 struct vmbus_gpa sg[], int sglen, void *data, int dlen,
210 int vmbus_chan_send_prplist(struct vmbus_channel *chan,
211 struct vmbus_gpa_range *prp, int prp_cnt, void *data,
212 int dlen, uint64_t xactid);
214 uint32_t vmbus_chan_id(const struct vmbus_channel *chan);
215 uint32_t vmbus_chan_subidx(const struct vmbus_channel *chan);
216 bool vmbus_chan_is_primary(const struct vmbus_channel *chan);
217 bool vmbus_chan_is_revoked(const struct vmbus_channel *chan);
218 const struct hyperv_guid *
219 vmbus_chan_guid_inst(const struct vmbus_channel *chan);
220 int vmbus_chan_prplist_nelem(int br_size, int prpcnt_max,
222 bool vmbus_chan_rx_empty(const struct vmbus_channel *chan);
223 bool vmbus_chan_tx_empty(const struct vmbus_channel *chan);
225 vmbus_chan_mgmt_tq(const struct vmbus_channel *chan);
227 void vmbus_chan_poll_enable(struct vmbus_channel *chan,
229 void vmbus_chan_poll_disable(struct vmbus_channel *chan);
231 #endif /* !_VMBUS_H_ */