1 #ifndef _SPARC64_LDC_H
2 #define _SPARC64_LDC_H
3
4 #include <asm/hypervisor.h>
5
6 extern int ldom_domaining_enabled;
7 void ldom_set_var(const char *var, const char *value);
8 void ldom_reboot(const char *boot_command);
9 void ldom_power_off(void);
10
11 /* The event handler will be evoked when link state changes
12 * or data becomes available on the receive side.
13 *
14 * For non-RAW links, if the LDC_EVENT_RESET event arrives the
15 * driver should reset all of it's internal state and reinvoke
16 * ldc_connect() to try and bring the link up again.
17 *
18 * For RAW links, ldc_connect() is not used. Instead the driver
19 * just waits for the LDC_EVENT_UP event.
20 */
21 struct ldc_channel_config {
22 void (*event)(void *arg, int event);
23
24 u32 mtu;
25 unsigned int rx_irq;
26 unsigned int tx_irq;
27 u8 mode;
28 #define LDC_MODE_RAW 0x00
29 #define LDC_MODE_UNRELIABLE 0x01
30 #define LDC_MODE_RESERVED 0x02
31 #define LDC_MODE_STREAM 0x03
32
33 u8 debug;
34 #define LDC_DEBUG_HS 0x01
35 #define LDC_DEBUG_STATE 0x02
36 #define LDC_DEBUG_RX 0x04
37 #define LDC_DEBUG_TX 0x08
38 #define LDC_DEBUG_DATA 0x10
39 };
40
41 #define LDC_EVENT_RESET 0x01
42 #define LDC_EVENT_UP 0x02
43 #define LDC_EVENT_DATA_READY 0x04
44
45 #define LDC_STATE_INVALID 0x00
46 #define LDC_STATE_INIT 0x01
47 #define LDC_STATE_BOUND 0x02
48 #define LDC_STATE_READY 0x03
49 #define LDC_STATE_CONNECTED 0x04
50
51 struct ldc_channel;
52
53 /* Allocate state for a channel. */
54 struct ldc_channel *ldc_alloc(unsigned long id,
55 const struct ldc_channel_config *cfgp,
56 void *event_arg,
57 const char *name);
58
59 /* Shut down and free state for a channel. */
60 void ldc_free(struct ldc_channel *lp);
61
62 /* Register TX and RX queues of the link with the hypervisor. */
63 int ldc_bind(struct ldc_channel *lp);
64
65 /* For non-RAW protocols we need to complete a handshake before
66 * communication can proceed. ldc_connect() does that, if the
67 * handshake completes successfully, an LDC_EVENT_UP event will
68 * be sent up to the driver.
69 */
70 int ldc_connect(struct ldc_channel *lp);
71 int ldc_disconnect(struct ldc_channel *lp);
72
73 int ldc_state(struct ldc_channel *lp);
74
75 /* Read and write operations. Only valid when the link is up. */
76 int ldc_write(struct ldc_channel *lp, const void *buf,
77 unsigned int size);
78 int ldc_read(struct ldc_channel *lp, void *buf, unsigned int size);
79
80 #define LDC_MAP_SHADOW 0x01
81 #define LDC_MAP_DIRECT 0x02
82 #define LDC_MAP_IO 0x04
83 #define LDC_MAP_R 0x08
84 #define LDC_MAP_W 0x10
85 #define LDC_MAP_X 0x20
86 #define LDC_MAP_RW (LDC_MAP_R | LDC_MAP_W)
87 #define LDC_MAP_RWX (LDC_MAP_R | LDC_MAP_W | LDC_MAP_X)
88 #define LDC_MAP_ALL 0x03f
89
90 struct ldc_trans_cookie {
91 u64 cookie_addr;
92 u64 cookie_size;
93 };
94
95 struct scatterlist;
96 int ldc_map_sg(struct ldc_channel *lp,
97 struct scatterlist *sg, int num_sg,
98 struct ldc_trans_cookie *cookies, int ncookies,
99 unsigned int map_perm);
100
101 int ldc_map_single(struct ldc_channel *lp,
102 void *buf, unsigned int len,
103 struct ldc_trans_cookie *cookies, int ncookies,
104 unsigned int map_perm);
105
106 void ldc_unmap(struct ldc_channel *lp, struct ldc_trans_cookie *cookies,
107 int ncookies);
108
109 int ldc_copy(struct ldc_channel *lp, int copy_dir,
110 void *buf, unsigned int len, unsigned long offset,
111 struct ldc_trans_cookie *cookies, int ncookies);
112
ldc_get_dring_entry(struct ldc_channel * lp,void * buf,unsigned int len,unsigned long offset,struct ldc_trans_cookie * cookies,int ncookies)113 static inline int ldc_get_dring_entry(struct ldc_channel *lp,
114 void *buf, unsigned int len,
115 unsigned long offset,
116 struct ldc_trans_cookie *cookies,
117 int ncookies)
118 {
119 return ldc_copy(lp, LDC_COPY_IN, buf, len, offset, cookies, ncookies);
120 }
121
ldc_put_dring_entry(struct ldc_channel * lp,void * buf,unsigned int len,unsigned long offset,struct ldc_trans_cookie * cookies,int ncookies)122 static inline int ldc_put_dring_entry(struct ldc_channel *lp,
123 void *buf, unsigned int len,
124 unsigned long offset,
125 struct ldc_trans_cookie *cookies,
126 int ncookies)
127 {
128 return ldc_copy(lp, LDC_COPY_OUT, buf, len, offset, cookies, ncookies);
129 }
130
131 void *ldc_alloc_exp_dring(struct ldc_channel *lp, unsigned int len,
132 struct ldc_trans_cookie *cookies,
133 int *ncookies, unsigned int map_perm);
134
135 void ldc_free_exp_dring(struct ldc_channel *lp, void *buf,
136 unsigned int len,
137 struct ldc_trans_cookie *cookies, int ncookies);
138
139 #endif /* _SPARC64_LDC_H */
140