xref: /linux/drivers/fpga/altera-freeze-bridge.c (revision 06d07429858317ded2db7986113a9e0129cd599b)
1 // SPDX-License-Identifier: GPL-2.0
2 /*
3  * FPGA Freeze Bridge Controller
4  *
5  *  Copyright (C) 2016 Altera Corporation. All rights reserved.
6  */
7 #include <linux/delay.h>
8 #include <linux/io.h>
9 #include <linux/kernel.h>
10 #include <linux/mod_devicetable.h>
11 #include <linux/module.h>
12 #include <linux/platform_device.h>
13 #include <linux/fpga/fpga-bridge.h>
14 
15 #define FREEZE_CSR_STATUS_OFFSET		0
16 #define FREEZE_CSR_CTRL_OFFSET			4
17 #define FREEZE_CSR_ILLEGAL_REQ_OFFSET		8
18 #define FREEZE_CSR_REG_VERSION			12
19 
20 #define FREEZE_CSR_SUPPORTED_VERSION		2
21 #define FREEZE_CSR_OFFICIAL_VERSION		0xad000003
22 
23 #define FREEZE_CSR_STATUS_FREEZE_REQ_DONE	BIT(0)
24 #define FREEZE_CSR_STATUS_UNFREEZE_REQ_DONE	BIT(1)
25 
26 #define FREEZE_CSR_CTRL_FREEZE_REQ		BIT(0)
27 #define FREEZE_CSR_CTRL_RESET_REQ		BIT(1)
28 #define FREEZE_CSR_CTRL_UNFREEZE_REQ		BIT(2)
29 
30 #define FREEZE_BRIDGE_NAME			"freeze"
31 
32 struct altera_freeze_br_data {
33 	struct device *dev;
34 	void __iomem *base_addr;
35 	bool enable;
36 };
37 
38 /*
39  * Poll status until status bit is set or we have a timeout.
40  */
altera_freeze_br_req_ack(struct altera_freeze_br_data * priv,u32 timeout,u32 req_ack)41 static int altera_freeze_br_req_ack(struct altera_freeze_br_data *priv,
42 				    u32 timeout, u32 req_ack)
43 {
44 	struct device *dev = priv->dev;
45 	void __iomem *csr_illegal_req_addr = priv->base_addr +
46 					     FREEZE_CSR_ILLEGAL_REQ_OFFSET;
47 	u32 status, illegal, ctrl;
48 	int ret = -ETIMEDOUT;
49 
50 	do {
51 		illegal = readl(csr_illegal_req_addr);
52 		if (illegal) {
53 			dev_err(dev, "illegal request detected 0x%x", illegal);
54 
55 			writel(1, csr_illegal_req_addr);
56 
57 			illegal = readl(csr_illegal_req_addr);
58 			if (illegal)
59 				dev_err(dev, "illegal request not cleared 0x%x",
60 					illegal);
61 
62 			ret = -EINVAL;
63 			break;
64 		}
65 
66 		status = readl(priv->base_addr + FREEZE_CSR_STATUS_OFFSET);
67 		dev_dbg(dev, "%s %x %x\n", __func__, status, req_ack);
68 		status &= req_ack;
69 		if (status) {
70 			ctrl = readl(priv->base_addr + FREEZE_CSR_CTRL_OFFSET);
71 			dev_dbg(dev, "%s request %x acknowledged %x %x\n",
72 				__func__, req_ack, status, ctrl);
73 			ret = 0;
74 			break;
75 		}
76 
77 		udelay(1);
78 	} while (timeout--);
79 
80 	if (ret == -ETIMEDOUT)
81 		dev_err(dev, "%s timeout waiting for 0x%x\n",
82 			__func__, req_ack);
83 
84 	return ret;
85 }
86 
altera_freeze_br_do_freeze(struct altera_freeze_br_data * priv,u32 timeout)87 static int altera_freeze_br_do_freeze(struct altera_freeze_br_data *priv,
88 				      u32 timeout)
89 {
90 	struct device *dev = priv->dev;
91 	void __iomem *csr_ctrl_addr = priv->base_addr +
92 				      FREEZE_CSR_CTRL_OFFSET;
93 	u32 status;
94 	int ret;
95 
96 	status = readl(priv->base_addr + FREEZE_CSR_STATUS_OFFSET);
97 
98 	dev_dbg(dev, "%s %d %d\n", __func__, status, readl(csr_ctrl_addr));
99 
100 	if (status & FREEZE_CSR_STATUS_FREEZE_REQ_DONE) {
101 		dev_dbg(dev, "%s bridge already disabled %d\n",
102 			__func__, status);
103 		return 0;
104 	} else if (!(status & FREEZE_CSR_STATUS_UNFREEZE_REQ_DONE)) {
105 		dev_err(dev, "%s bridge not enabled %d\n", __func__, status);
106 		return -EINVAL;
107 	}
108 
109 	writel(FREEZE_CSR_CTRL_FREEZE_REQ, csr_ctrl_addr);
110 
111 	ret = altera_freeze_br_req_ack(priv, timeout,
112 				       FREEZE_CSR_STATUS_FREEZE_REQ_DONE);
113 
114 	if (ret)
115 		writel(0, csr_ctrl_addr);
116 	else
117 		writel(FREEZE_CSR_CTRL_RESET_REQ, csr_ctrl_addr);
118 
119 	return ret;
120 }
121 
altera_freeze_br_do_unfreeze(struct altera_freeze_br_data * priv,u32 timeout)122 static int altera_freeze_br_do_unfreeze(struct altera_freeze_br_data *priv,
123 					u32 timeout)
124 {
125 	struct device *dev = priv->dev;
126 	void __iomem *csr_ctrl_addr = priv->base_addr +
127 				      FREEZE_CSR_CTRL_OFFSET;
128 	u32 status;
129 	int ret;
130 
131 	writel(0, csr_ctrl_addr);
132 
133 	status = readl(priv->base_addr + FREEZE_CSR_STATUS_OFFSET);
134 
135 	dev_dbg(dev, "%s %d %d\n", __func__, status, readl(csr_ctrl_addr));
136 
137 	if (status & FREEZE_CSR_STATUS_UNFREEZE_REQ_DONE) {
138 		dev_dbg(dev, "%s bridge already enabled %d\n",
139 			__func__, status);
140 		return 0;
141 	} else if (!(status & FREEZE_CSR_STATUS_FREEZE_REQ_DONE)) {
142 		dev_err(dev, "%s bridge not frozen %d\n", __func__, status);
143 		return -EINVAL;
144 	}
145 
146 	writel(FREEZE_CSR_CTRL_UNFREEZE_REQ, csr_ctrl_addr);
147 
148 	ret = altera_freeze_br_req_ack(priv, timeout,
149 				       FREEZE_CSR_STATUS_UNFREEZE_REQ_DONE);
150 
151 	status = readl(priv->base_addr + FREEZE_CSR_STATUS_OFFSET);
152 
153 	dev_dbg(dev, "%s %d %d\n", __func__, status, readl(csr_ctrl_addr));
154 
155 	writel(0, csr_ctrl_addr);
156 
157 	return ret;
158 }
159 
160 /*
161  * enable = 1 : allow traffic through the bridge
162  * enable = 0 : disable traffic through the bridge
163  */
altera_freeze_br_enable_set(struct fpga_bridge * bridge,bool enable)164 static int altera_freeze_br_enable_set(struct fpga_bridge *bridge,
165 				       bool enable)
166 {
167 	struct altera_freeze_br_data *priv = bridge->priv;
168 	struct fpga_image_info *info = bridge->info;
169 	u32 timeout = 0;
170 	int ret;
171 
172 	if (enable) {
173 		if (info)
174 			timeout = info->enable_timeout_us;
175 
176 		ret = altera_freeze_br_do_unfreeze(bridge->priv, timeout);
177 	} else {
178 		if (info)
179 			timeout = info->disable_timeout_us;
180 
181 		ret = altera_freeze_br_do_freeze(bridge->priv, timeout);
182 	}
183 
184 	if (!ret)
185 		priv->enable = enable;
186 
187 	return ret;
188 }
189 
altera_freeze_br_enable_show(struct fpga_bridge * bridge)190 static int altera_freeze_br_enable_show(struct fpga_bridge *bridge)
191 {
192 	struct altera_freeze_br_data *priv = bridge->priv;
193 
194 	return priv->enable;
195 }
196 
197 static const struct fpga_bridge_ops altera_freeze_br_br_ops = {
198 	.enable_set = altera_freeze_br_enable_set,
199 	.enable_show = altera_freeze_br_enable_show,
200 };
201 
202 static const struct of_device_id altera_freeze_br_of_match[] = {
203 	{ .compatible = "altr,freeze-bridge-controller", },
204 	{},
205 };
206 MODULE_DEVICE_TABLE(of, altera_freeze_br_of_match);
207 
altera_freeze_br_probe(struct platform_device * pdev)208 static int altera_freeze_br_probe(struct platform_device *pdev)
209 {
210 	struct device *dev = &pdev->dev;
211 	struct device_node *np = pdev->dev.of_node;
212 	void __iomem *base_addr;
213 	struct altera_freeze_br_data *priv;
214 	struct fpga_bridge *br;
215 	u32 status, revision;
216 
217 	if (!np)
218 		return -ENODEV;
219 
220 	base_addr = devm_platform_ioremap_resource(pdev, 0);
221 	if (IS_ERR(base_addr))
222 		return PTR_ERR(base_addr);
223 
224 	revision = readl(base_addr + FREEZE_CSR_REG_VERSION);
225 	if ((revision != FREEZE_CSR_SUPPORTED_VERSION) &&
226 	    (revision != FREEZE_CSR_OFFICIAL_VERSION)) {
227 		dev_err(dev,
228 			"%s unexpected revision 0x%x != 0x%x != 0x%x\n",
229 			__func__, revision, FREEZE_CSR_SUPPORTED_VERSION,
230 			FREEZE_CSR_OFFICIAL_VERSION);
231 		return -EINVAL;
232 	}
233 
234 	priv = devm_kzalloc(dev, sizeof(*priv), GFP_KERNEL);
235 	if (!priv)
236 		return -ENOMEM;
237 
238 	priv->dev = dev;
239 
240 	status = readl(base_addr + FREEZE_CSR_STATUS_OFFSET);
241 	if (status & FREEZE_CSR_STATUS_UNFREEZE_REQ_DONE)
242 		priv->enable = 1;
243 
244 	priv->base_addr = base_addr;
245 
246 	br = fpga_bridge_register(dev, FREEZE_BRIDGE_NAME,
247 				  &altera_freeze_br_br_ops, priv);
248 	if (IS_ERR(br))
249 		return PTR_ERR(br);
250 
251 	platform_set_drvdata(pdev, br);
252 
253 	return 0;
254 }
255 
altera_freeze_br_remove(struct platform_device * pdev)256 static void altera_freeze_br_remove(struct platform_device *pdev)
257 {
258 	struct fpga_bridge *br = platform_get_drvdata(pdev);
259 
260 	fpga_bridge_unregister(br);
261 }
262 
263 static struct platform_driver altera_freeze_br_driver = {
264 	.probe = altera_freeze_br_probe,
265 	.remove_new = altera_freeze_br_remove,
266 	.driver = {
267 		.name	= "altera_freeze_br",
268 		.of_match_table = altera_freeze_br_of_match,
269 	},
270 };
271 
272 module_platform_driver(altera_freeze_br_driver);
273 
274 MODULE_DESCRIPTION("Altera Freeze Bridge");
275 MODULE_AUTHOR("Alan Tull <atull@opensource.altera.com>");
276 MODULE_LICENSE("GPL v2");
277