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