xref: /OK3568_Linux_fs/kernel/drivers/i2c/busses/i2c-opal.c (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun // SPDX-License-Identifier: GPL-2.0-or-later
2*4882a593Smuzhiyun /*
3*4882a593Smuzhiyun  * IBM OPAL I2C driver
4*4882a593Smuzhiyun  * Copyright (C) 2014 IBM
5*4882a593Smuzhiyun  */
6*4882a593Smuzhiyun 
7*4882a593Smuzhiyun #include <linux/device.h>
8*4882a593Smuzhiyun #include <linux/i2c.h>
9*4882a593Smuzhiyun #include <linux/kernel.h>
10*4882a593Smuzhiyun #include <linux/mm.h>
11*4882a593Smuzhiyun #include <linux/module.h>
12*4882a593Smuzhiyun #include <linux/of.h>
13*4882a593Smuzhiyun #include <linux/platform_device.h>
14*4882a593Smuzhiyun #include <linux/slab.h>
15*4882a593Smuzhiyun 
16*4882a593Smuzhiyun #include <asm/firmware.h>
17*4882a593Smuzhiyun #include <asm/opal.h>
18*4882a593Smuzhiyun 
i2c_opal_translate_error(int rc)19*4882a593Smuzhiyun static int i2c_opal_translate_error(int rc)
20*4882a593Smuzhiyun {
21*4882a593Smuzhiyun 	switch (rc) {
22*4882a593Smuzhiyun 	case OPAL_NO_MEM:
23*4882a593Smuzhiyun 		return -ENOMEM;
24*4882a593Smuzhiyun 	case OPAL_PARAMETER:
25*4882a593Smuzhiyun 		return -EINVAL;
26*4882a593Smuzhiyun 	case OPAL_I2C_ARBT_LOST:
27*4882a593Smuzhiyun 		return -EAGAIN;
28*4882a593Smuzhiyun 	case OPAL_I2C_TIMEOUT:
29*4882a593Smuzhiyun 		return -ETIMEDOUT;
30*4882a593Smuzhiyun 	case OPAL_I2C_NACK_RCVD:
31*4882a593Smuzhiyun 		return -ENXIO;
32*4882a593Smuzhiyun 	case OPAL_I2C_STOP_ERR:
33*4882a593Smuzhiyun 		return -EBUSY;
34*4882a593Smuzhiyun 	default:
35*4882a593Smuzhiyun 		return -EIO;
36*4882a593Smuzhiyun 	}
37*4882a593Smuzhiyun }
38*4882a593Smuzhiyun 
i2c_opal_send_request(u32 bus_id,struct opal_i2c_request * req)39*4882a593Smuzhiyun static int i2c_opal_send_request(u32 bus_id, struct opal_i2c_request *req)
40*4882a593Smuzhiyun {
41*4882a593Smuzhiyun 	struct opal_msg msg;
42*4882a593Smuzhiyun 	int token, rc;
43*4882a593Smuzhiyun 
44*4882a593Smuzhiyun 	token = opal_async_get_token_interruptible();
45*4882a593Smuzhiyun 	if (token < 0) {
46*4882a593Smuzhiyun 		if (token != -ERESTARTSYS)
47*4882a593Smuzhiyun 			pr_err("Failed to get the async token\n");
48*4882a593Smuzhiyun 
49*4882a593Smuzhiyun 		return token;
50*4882a593Smuzhiyun 	}
51*4882a593Smuzhiyun 
52*4882a593Smuzhiyun 	rc = opal_i2c_request(token, bus_id, req);
53*4882a593Smuzhiyun 	if (rc != OPAL_ASYNC_COMPLETION) {
54*4882a593Smuzhiyun 		rc = i2c_opal_translate_error(rc);
55*4882a593Smuzhiyun 		goto exit;
56*4882a593Smuzhiyun 	}
57*4882a593Smuzhiyun 
58*4882a593Smuzhiyun 	rc = opal_async_wait_response(token, &msg);
59*4882a593Smuzhiyun 	if (rc)
60*4882a593Smuzhiyun 		goto exit;
61*4882a593Smuzhiyun 
62*4882a593Smuzhiyun 	rc = opal_get_async_rc(msg);
63*4882a593Smuzhiyun 	if (rc != OPAL_SUCCESS) {
64*4882a593Smuzhiyun 		rc = i2c_opal_translate_error(rc);
65*4882a593Smuzhiyun 		goto exit;
66*4882a593Smuzhiyun 	}
67*4882a593Smuzhiyun 
68*4882a593Smuzhiyun exit:
69*4882a593Smuzhiyun 	opal_async_release_token(token);
70*4882a593Smuzhiyun 	return rc;
71*4882a593Smuzhiyun }
72*4882a593Smuzhiyun 
i2c_opal_master_xfer(struct i2c_adapter * adap,struct i2c_msg * msgs,int num)73*4882a593Smuzhiyun static int i2c_opal_master_xfer(struct i2c_adapter *adap, struct i2c_msg *msgs,
74*4882a593Smuzhiyun 				int num)
75*4882a593Smuzhiyun {
76*4882a593Smuzhiyun 	unsigned long opal_id = (unsigned long)adap->algo_data;
77*4882a593Smuzhiyun 	struct opal_i2c_request req;
78*4882a593Smuzhiyun 	int rc, i;
79*4882a593Smuzhiyun 
80*4882a593Smuzhiyun 	/* We only support fairly simple combinations here of one
81*4882a593Smuzhiyun 	 * or two messages
82*4882a593Smuzhiyun 	 */
83*4882a593Smuzhiyun 	memset(&req, 0, sizeof(req));
84*4882a593Smuzhiyun 	switch(num) {
85*4882a593Smuzhiyun 	case 1:
86*4882a593Smuzhiyun 		req.type = (msgs[0].flags & I2C_M_RD) ?
87*4882a593Smuzhiyun 			OPAL_I2C_RAW_READ : OPAL_I2C_RAW_WRITE;
88*4882a593Smuzhiyun 		req.addr = cpu_to_be16(msgs[0].addr);
89*4882a593Smuzhiyun 		req.size = cpu_to_be32(msgs[0].len);
90*4882a593Smuzhiyun 		req.buffer_ra = cpu_to_be64(__pa(msgs[0].buf));
91*4882a593Smuzhiyun 		break;
92*4882a593Smuzhiyun 	case 2:
93*4882a593Smuzhiyun 		req.type = (msgs[1].flags & I2C_M_RD) ?
94*4882a593Smuzhiyun 			OPAL_I2C_SM_READ : OPAL_I2C_SM_WRITE;
95*4882a593Smuzhiyun 		req.addr = cpu_to_be16(msgs[0].addr);
96*4882a593Smuzhiyun 		req.subaddr_sz = msgs[0].len;
97*4882a593Smuzhiyun 		for (i = 0; i < msgs[0].len; i++)
98*4882a593Smuzhiyun 			req.subaddr = (req.subaddr << 8) | msgs[0].buf[i];
99*4882a593Smuzhiyun 		req.subaddr = cpu_to_be32(req.subaddr);
100*4882a593Smuzhiyun 		req.size = cpu_to_be32(msgs[1].len);
101*4882a593Smuzhiyun 		req.buffer_ra = cpu_to_be64(__pa(msgs[1].buf));
102*4882a593Smuzhiyun 		break;
103*4882a593Smuzhiyun 	}
104*4882a593Smuzhiyun 
105*4882a593Smuzhiyun 	rc = i2c_opal_send_request(opal_id, &req);
106*4882a593Smuzhiyun 	if (rc)
107*4882a593Smuzhiyun 		return rc;
108*4882a593Smuzhiyun 
109*4882a593Smuzhiyun 	return num;
110*4882a593Smuzhiyun }
111*4882a593Smuzhiyun 
i2c_opal_smbus_xfer(struct i2c_adapter * adap,u16 addr,unsigned short flags,char read_write,u8 command,int size,union i2c_smbus_data * data)112*4882a593Smuzhiyun static int i2c_opal_smbus_xfer(struct i2c_adapter *adap, u16 addr,
113*4882a593Smuzhiyun 			       unsigned short flags, char read_write,
114*4882a593Smuzhiyun 			       u8 command, int size, union i2c_smbus_data *data)
115*4882a593Smuzhiyun {
116*4882a593Smuzhiyun 	unsigned long opal_id = (unsigned long)adap->algo_data;
117*4882a593Smuzhiyun 	struct opal_i2c_request req;
118*4882a593Smuzhiyun 	u8 local[2];
119*4882a593Smuzhiyun 	int rc;
120*4882a593Smuzhiyun 
121*4882a593Smuzhiyun 	memset(&req, 0, sizeof(req));
122*4882a593Smuzhiyun 
123*4882a593Smuzhiyun 	req.addr = cpu_to_be16(addr);
124*4882a593Smuzhiyun 	switch (size) {
125*4882a593Smuzhiyun 	case I2C_SMBUS_BYTE:
126*4882a593Smuzhiyun 		req.buffer_ra = cpu_to_be64(__pa(&data->byte));
127*4882a593Smuzhiyun 		req.size = cpu_to_be32(1);
128*4882a593Smuzhiyun 		fallthrough;
129*4882a593Smuzhiyun 	case I2C_SMBUS_QUICK:
130*4882a593Smuzhiyun 		req.type = (read_write == I2C_SMBUS_READ) ?
131*4882a593Smuzhiyun 			OPAL_I2C_RAW_READ : OPAL_I2C_RAW_WRITE;
132*4882a593Smuzhiyun 		break;
133*4882a593Smuzhiyun 	case I2C_SMBUS_BYTE_DATA:
134*4882a593Smuzhiyun 		req.buffer_ra = cpu_to_be64(__pa(&data->byte));
135*4882a593Smuzhiyun 		req.size = cpu_to_be32(1);
136*4882a593Smuzhiyun 		req.subaddr = cpu_to_be32(command);
137*4882a593Smuzhiyun 		req.subaddr_sz = 1;
138*4882a593Smuzhiyun 		req.type = (read_write == I2C_SMBUS_READ) ?
139*4882a593Smuzhiyun 			OPAL_I2C_SM_READ : OPAL_I2C_SM_WRITE;
140*4882a593Smuzhiyun 		break;
141*4882a593Smuzhiyun 	case I2C_SMBUS_WORD_DATA:
142*4882a593Smuzhiyun 		if (!read_write) {
143*4882a593Smuzhiyun 			local[0] = data->word & 0xff;
144*4882a593Smuzhiyun 			local[1] = (data->word >> 8) & 0xff;
145*4882a593Smuzhiyun 		}
146*4882a593Smuzhiyun 		req.buffer_ra = cpu_to_be64(__pa(local));
147*4882a593Smuzhiyun 		req.size = cpu_to_be32(2);
148*4882a593Smuzhiyun 		req.subaddr = cpu_to_be32(command);
149*4882a593Smuzhiyun 		req.subaddr_sz = 1;
150*4882a593Smuzhiyun 		req.type = (read_write == I2C_SMBUS_READ) ?
151*4882a593Smuzhiyun 			OPAL_I2C_SM_READ : OPAL_I2C_SM_WRITE;
152*4882a593Smuzhiyun 		break;
153*4882a593Smuzhiyun 	case I2C_SMBUS_I2C_BLOCK_DATA:
154*4882a593Smuzhiyun 		req.buffer_ra = cpu_to_be64(__pa(&data->block[1]));
155*4882a593Smuzhiyun 		req.size = cpu_to_be32(data->block[0]);
156*4882a593Smuzhiyun 		req.subaddr = cpu_to_be32(command);
157*4882a593Smuzhiyun 		req.subaddr_sz = 1;
158*4882a593Smuzhiyun 		req.type = (read_write == I2C_SMBUS_READ) ?
159*4882a593Smuzhiyun 			OPAL_I2C_SM_READ : OPAL_I2C_SM_WRITE;
160*4882a593Smuzhiyun 		break;
161*4882a593Smuzhiyun 	default:
162*4882a593Smuzhiyun 		return -EINVAL;
163*4882a593Smuzhiyun 	}
164*4882a593Smuzhiyun 
165*4882a593Smuzhiyun 	rc = i2c_opal_send_request(opal_id, &req);
166*4882a593Smuzhiyun 	if (!rc && read_write && size == I2C_SMBUS_WORD_DATA) {
167*4882a593Smuzhiyun 		data->word = ((u16)local[1]) << 8;
168*4882a593Smuzhiyun 		data->word |= local[0];
169*4882a593Smuzhiyun 	}
170*4882a593Smuzhiyun 
171*4882a593Smuzhiyun 	return rc;
172*4882a593Smuzhiyun }
173*4882a593Smuzhiyun 
i2c_opal_func(struct i2c_adapter * adapter)174*4882a593Smuzhiyun static u32 i2c_opal_func(struct i2c_adapter *adapter)
175*4882a593Smuzhiyun {
176*4882a593Smuzhiyun 	return I2C_FUNC_I2C | I2C_FUNC_SMBUS_QUICK | I2C_FUNC_SMBUS_BYTE |
177*4882a593Smuzhiyun 	       I2C_FUNC_SMBUS_BYTE_DATA | I2C_FUNC_SMBUS_WORD_DATA |
178*4882a593Smuzhiyun 	       I2C_FUNC_SMBUS_I2C_BLOCK;
179*4882a593Smuzhiyun }
180*4882a593Smuzhiyun 
181*4882a593Smuzhiyun static const struct i2c_algorithm i2c_opal_algo = {
182*4882a593Smuzhiyun 	.master_xfer	= i2c_opal_master_xfer,
183*4882a593Smuzhiyun 	.smbus_xfer	= i2c_opal_smbus_xfer,
184*4882a593Smuzhiyun 	.functionality	= i2c_opal_func,
185*4882a593Smuzhiyun };
186*4882a593Smuzhiyun 
187*4882a593Smuzhiyun /*
188*4882a593Smuzhiyun  * For two messages, we basically support simple smbus transactions of a
189*4882a593Smuzhiyun  * write-then-anything.
190*4882a593Smuzhiyun  */
191*4882a593Smuzhiyun static const struct i2c_adapter_quirks i2c_opal_quirks = {
192*4882a593Smuzhiyun 	.flags = I2C_AQ_COMB | I2C_AQ_COMB_WRITE_FIRST | I2C_AQ_COMB_SAME_ADDR,
193*4882a593Smuzhiyun 	.max_comb_1st_msg_len = 4,
194*4882a593Smuzhiyun };
195*4882a593Smuzhiyun 
i2c_opal_probe(struct platform_device * pdev)196*4882a593Smuzhiyun static int i2c_opal_probe(struct platform_device *pdev)
197*4882a593Smuzhiyun {
198*4882a593Smuzhiyun 	struct i2c_adapter	*adapter;
199*4882a593Smuzhiyun 	const char		*pname;
200*4882a593Smuzhiyun 	u32			opal_id;
201*4882a593Smuzhiyun 	int			rc;
202*4882a593Smuzhiyun 
203*4882a593Smuzhiyun 	if (!pdev->dev.of_node)
204*4882a593Smuzhiyun 		return -ENODEV;
205*4882a593Smuzhiyun 
206*4882a593Smuzhiyun 	rc = of_property_read_u32(pdev->dev.of_node, "ibm,opal-id", &opal_id);
207*4882a593Smuzhiyun 	if (rc) {
208*4882a593Smuzhiyun 		dev_err(&pdev->dev, "Missing ibm,opal-id property !\n");
209*4882a593Smuzhiyun 		return -EIO;
210*4882a593Smuzhiyun 	}
211*4882a593Smuzhiyun 
212*4882a593Smuzhiyun 	adapter = devm_kzalloc(&pdev->dev, sizeof(*adapter), GFP_KERNEL);
213*4882a593Smuzhiyun 	if (!adapter)
214*4882a593Smuzhiyun 		return -ENOMEM;
215*4882a593Smuzhiyun 
216*4882a593Smuzhiyun 	adapter->algo = &i2c_opal_algo;
217*4882a593Smuzhiyun 	adapter->algo_data = (void *)(unsigned long)opal_id;
218*4882a593Smuzhiyun 	adapter->quirks = &i2c_opal_quirks;
219*4882a593Smuzhiyun 	adapter->dev.parent = &pdev->dev;
220*4882a593Smuzhiyun 	adapter->dev.of_node = of_node_get(pdev->dev.of_node);
221*4882a593Smuzhiyun 	pname = of_get_property(pdev->dev.of_node, "ibm,port-name", NULL);
222*4882a593Smuzhiyun 	if (pname)
223*4882a593Smuzhiyun 		strlcpy(adapter->name, pname, sizeof(adapter->name));
224*4882a593Smuzhiyun 	else
225*4882a593Smuzhiyun 		strlcpy(adapter->name, "opal", sizeof(adapter->name));
226*4882a593Smuzhiyun 
227*4882a593Smuzhiyun 	platform_set_drvdata(pdev, adapter);
228*4882a593Smuzhiyun 	rc = i2c_add_adapter(adapter);
229*4882a593Smuzhiyun 	if (rc)
230*4882a593Smuzhiyun 		dev_err(&pdev->dev, "Failed to register the i2c adapter\n");
231*4882a593Smuzhiyun 
232*4882a593Smuzhiyun 	return rc;
233*4882a593Smuzhiyun }
234*4882a593Smuzhiyun 
i2c_opal_remove(struct platform_device * pdev)235*4882a593Smuzhiyun static int i2c_opal_remove(struct platform_device *pdev)
236*4882a593Smuzhiyun {
237*4882a593Smuzhiyun 	struct i2c_adapter *adapter = platform_get_drvdata(pdev);
238*4882a593Smuzhiyun 
239*4882a593Smuzhiyun 	i2c_del_adapter(adapter);
240*4882a593Smuzhiyun 
241*4882a593Smuzhiyun 	return 0;
242*4882a593Smuzhiyun }
243*4882a593Smuzhiyun 
244*4882a593Smuzhiyun static const struct of_device_id i2c_opal_of_match[] = {
245*4882a593Smuzhiyun 	{
246*4882a593Smuzhiyun 		.compatible = "ibm,opal-i2c",
247*4882a593Smuzhiyun 	},
248*4882a593Smuzhiyun 	{ }
249*4882a593Smuzhiyun };
250*4882a593Smuzhiyun MODULE_DEVICE_TABLE(of, i2c_opal_of_match);
251*4882a593Smuzhiyun 
252*4882a593Smuzhiyun static struct platform_driver i2c_opal_driver = {
253*4882a593Smuzhiyun 	.probe	= i2c_opal_probe,
254*4882a593Smuzhiyun 	.remove	= i2c_opal_remove,
255*4882a593Smuzhiyun 	.driver	= {
256*4882a593Smuzhiyun 		.name		= "i2c-opal",
257*4882a593Smuzhiyun 		.of_match_table	= i2c_opal_of_match,
258*4882a593Smuzhiyun 	},
259*4882a593Smuzhiyun };
260*4882a593Smuzhiyun 
i2c_opal_init(void)261*4882a593Smuzhiyun static int __init i2c_opal_init(void)
262*4882a593Smuzhiyun {
263*4882a593Smuzhiyun 	if (!firmware_has_feature(FW_FEATURE_OPAL))
264*4882a593Smuzhiyun 		return -ENODEV;
265*4882a593Smuzhiyun 
266*4882a593Smuzhiyun 	return platform_driver_register(&i2c_opal_driver);
267*4882a593Smuzhiyun }
268*4882a593Smuzhiyun module_init(i2c_opal_init);
269*4882a593Smuzhiyun 
i2c_opal_exit(void)270*4882a593Smuzhiyun static void __exit i2c_opal_exit(void)
271*4882a593Smuzhiyun {
272*4882a593Smuzhiyun 	return platform_driver_unregister(&i2c_opal_driver);
273*4882a593Smuzhiyun }
274*4882a593Smuzhiyun module_exit(i2c_opal_exit);
275*4882a593Smuzhiyun 
276*4882a593Smuzhiyun MODULE_AUTHOR("Neelesh Gupta <neelegup@linux.vnet.ibm.com>");
277*4882a593Smuzhiyun MODULE_DESCRIPTION("IBM OPAL I2C driver");
278*4882a593Smuzhiyun MODULE_LICENSE("GPL");
279