1 /* Copyright (c) 2011-2012, The Linux Foundation. All rights reserved.
3 * This program is free software; you can redistribute it and/or modify
4 * it under the terms of the GNU General Public License version 2 and
5 * only version 2 as published by the Free Software Foundation.
7 * This program is distributed in the hope that it will be useful,
8 * but WITHOUT ANY WARRANTY; without even the implied warranty of
9 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
10 * GNU General Public License for more details.
13 #include <asm/local.h>
14 #include <linux/kernel.h>
15 #include <linux/module.h>
16 #include <linux/init.h>
17 #include <linux/types.h>
18 #include <linux/device.h>
20 #include <linux/err.h>
22 #include <linux/miscdevice.h>
23 #include <linux/uaccess.h>
24 #include <linux/slab.h>
25 #include <linux/spinlock.h>
26 #include <linux/pm_runtime.h>
27 #include <linux/seq_file.h>
28 #include <linux/coresight.h>
29 #include <linux/amba/bus.h>
30 #include <linux/clk.h>
32 #include "coresight-priv.h"
34 #define ETB_RAM_DEPTH_REG 0x004
35 #define ETB_STATUS_REG 0x00c
36 #define ETB_RAM_READ_DATA_REG 0x010
37 #define ETB_RAM_READ_POINTER 0x014
38 #define ETB_RAM_WRITE_POINTER 0x018
40 #define ETB_CTL_REG 0x020
41 #define ETB_RWD_REG 0x024
42 #define ETB_FFSR 0x300
43 #define ETB_FFCR 0x304
44 #define ETB_ITMISCOP0 0xee0
45 #define ETB_ITTRFLINACK 0xee4
46 #define ETB_ITTRFLIN 0xee8
47 #define ETB_ITATBDATA0 0xeeC
48 #define ETB_ITATBCTR2 0xef0
49 #define ETB_ITATBCTR1 0xef4
50 #define ETB_ITATBCTR0 0xef8
52 /* register description */
54 #define ETB_STATUS_RAM_FULL BIT(0)
56 #define ETB_CTL_CAPT_EN BIT(0)
58 #define ETB_FFCR_EN_FTC BIT(0)
59 #define ETB_FFCR_FON_MAN BIT(6)
60 #define ETB_FFCR_STOP_FI BIT(12)
61 #define ETB_FFCR_STOP_TRIGGER BIT(13)
63 #define ETB_FFCR_BIT 6
64 #define ETB_FFSR_BIT 1
65 #define ETB_FRAME_SIZE_WORDS 4
68 * struct etb_drvdata - specifics associated to an ETB component
69 * @base: memory mapped base address for this component.
70 * @dev: the device entity associated to this component.
71 * @atclk: optional clock for the core parts of the ETB.
72 * @csdev: component vitals needed by the framework.
73 * @miscdev: specifics to handle "/dev/xyz.etb" entry.
74 * @spinlock: only one at a time pls.
75 * @reading: synchronise user space access to etb buffer.
76 * @buf: area of memory where ETB buffer content gets sent.
77 * @buffer_depth: size of @buf.
78 * @enable: this ETB is being used.
79 * @trigger_cntr: amount of words to store after a trigger.
85 struct coresight_device *csdev;
86 struct miscdevice miscdev;
95 static unsigned int etb_get_buffer_depth(struct etb_drvdata *drvdata)
99 pm_runtime_get_sync(drvdata->dev);
101 /* RO registers don't need locking */
102 depth = readl_relaxed(drvdata->base + ETB_RAM_DEPTH_REG);
104 pm_runtime_put(drvdata->dev);
108 static void etb_enable_hw(struct etb_drvdata *drvdata)
113 CS_UNLOCK(drvdata->base);
115 depth = drvdata->buffer_depth;
116 /* reset write RAM pointer address */
117 writel_relaxed(0x0, drvdata->base + ETB_RAM_WRITE_POINTER);
118 /* clear entire RAM buffer */
119 for (i = 0; i < depth; i++)
120 writel_relaxed(0x0, drvdata->base + ETB_RWD_REG);
122 /* reset write RAM pointer address */
123 writel_relaxed(0x0, drvdata->base + ETB_RAM_WRITE_POINTER);
124 /* reset read RAM pointer address */
125 writel_relaxed(0x0, drvdata->base + ETB_RAM_READ_POINTER);
127 writel_relaxed(drvdata->trigger_cntr, drvdata->base + ETB_TRG);
128 writel_relaxed(ETB_FFCR_EN_FTC | ETB_FFCR_STOP_TRIGGER,
129 drvdata->base + ETB_FFCR);
130 /* ETB trace capture enable */
131 writel_relaxed(ETB_CTL_CAPT_EN, drvdata->base + ETB_CTL_REG);
133 CS_LOCK(drvdata->base);
136 static int etb_enable(struct coresight_device *csdev)
138 struct etb_drvdata *drvdata = dev_get_drvdata(csdev->dev.parent);
141 spin_lock_irqsave(&drvdata->spinlock, flags);
142 etb_enable_hw(drvdata);
143 drvdata->enable = true;
144 spin_unlock_irqrestore(&drvdata->spinlock, flags);
146 dev_info(drvdata->dev, "ETB enabled\n");
150 static void etb_disable_hw(struct etb_drvdata *drvdata)
154 CS_UNLOCK(drvdata->base);
156 ffcr = readl_relaxed(drvdata->base + ETB_FFCR);
157 /* stop formatter when a stop has completed */
158 ffcr |= ETB_FFCR_STOP_FI;
159 writel_relaxed(ffcr, drvdata->base + ETB_FFCR);
160 /* manually generate a flush of the system */
161 ffcr |= ETB_FFCR_FON_MAN;
162 writel_relaxed(ffcr, drvdata->base + ETB_FFCR);
164 if (coresight_timeout(drvdata->base, ETB_FFCR, ETB_FFCR_BIT, 0)) {
165 dev_err(drvdata->dev,
166 "timeout observed when probing at offset %#x\n",
170 /* disable trace capture */
171 writel_relaxed(0x0, drvdata->base + ETB_CTL_REG);
173 if (coresight_timeout(drvdata->base, ETB_FFSR, ETB_FFSR_BIT, 1)) {
174 dev_err(drvdata->dev,
175 "timeout observed when probing at offset %#x\n",
179 CS_LOCK(drvdata->base);
182 static void etb_dump_hw(struct etb_drvdata *drvdata)
186 u32 read_data, depth;
187 u32 read_ptr, write_ptr;
188 u32 frame_off, frame_endoff;
190 CS_UNLOCK(drvdata->base);
192 read_ptr = readl_relaxed(drvdata->base + ETB_RAM_READ_POINTER);
193 write_ptr = readl_relaxed(drvdata->base + ETB_RAM_WRITE_POINTER);
195 frame_off = write_ptr % ETB_FRAME_SIZE_WORDS;
196 frame_endoff = ETB_FRAME_SIZE_WORDS - frame_off;
198 dev_err(drvdata->dev,
199 "write_ptr: %lu not aligned to formatter frame size\n",
200 (unsigned long)write_ptr);
201 dev_err(drvdata->dev, "frameoff: %lu, frame_endoff: %lu\n",
202 (unsigned long)frame_off, (unsigned long)frame_endoff);
203 write_ptr += frame_endoff;
206 if ((readl_relaxed(drvdata->base + ETB_STATUS_REG)
207 & ETB_STATUS_RAM_FULL) == 0)
208 writel_relaxed(0x0, drvdata->base + ETB_RAM_READ_POINTER);
210 writel_relaxed(write_ptr, drvdata->base + ETB_RAM_READ_POINTER);
212 depth = drvdata->buffer_depth;
213 buf_ptr = drvdata->buf;
214 for (i = 0; i < depth; i++) {
215 read_data = readl_relaxed(drvdata->base +
216 ETB_RAM_READ_DATA_REG);
217 *buf_ptr++ = read_data >> 0;
218 *buf_ptr++ = read_data >> 8;
219 *buf_ptr++ = read_data >> 16;
220 *buf_ptr++ = read_data >> 24;
224 buf_ptr -= (frame_endoff * 4);
225 for (i = 0; i < frame_endoff; i++) {
233 writel_relaxed(read_ptr, drvdata->base + ETB_RAM_READ_POINTER);
235 CS_LOCK(drvdata->base);
238 static void etb_disable(struct coresight_device *csdev)
240 struct etb_drvdata *drvdata = dev_get_drvdata(csdev->dev.parent);
243 spin_lock_irqsave(&drvdata->spinlock, flags);
244 etb_disable_hw(drvdata);
245 etb_dump_hw(drvdata);
246 drvdata->enable = false;
247 spin_unlock_irqrestore(&drvdata->spinlock, flags);
249 dev_info(drvdata->dev, "ETB disabled\n");
252 static const struct coresight_ops_sink etb_sink_ops = {
253 .enable = etb_enable,
254 .disable = etb_disable,
257 static const struct coresight_ops etb_cs_ops = {
258 .sink_ops = &etb_sink_ops,
261 static void etb_dump(struct etb_drvdata *drvdata)
265 spin_lock_irqsave(&drvdata->spinlock, flags);
266 if (drvdata->enable) {
267 etb_disable_hw(drvdata);
268 etb_dump_hw(drvdata);
269 etb_enable_hw(drvdata);
271 spin_unlock_irqrestore(&drvdata->spinlock, flags);
273 dev_info(drvdata->dev, "ETB dumped\n");
276 static int etb_open(struct inode *inode, struct file *file)
278 struct etb_drvdata *drvdata = container_of(file->private_data,
279 struct etb_drvdata, miscdev);
281 if (local_cmpxchg(&drvdata->reading, 0, 1))
284 dev_dbg(drvdata->dev, "%s: successfully opened\n", __func__);
288 static ssize_t etb_read(struct file *file, char __user *data,
289 size_t len, loff_t *ppos)
292 struct etb_drvdata *drvdata = container_of(file->private_data,
293 struct etb_drvdata, miscdev);
297 depth = drvdata->buffer_depth;
298 if (*ppos + len > depth * 4)
299 len = depth * 4 - *ppos;
301 if (copy_to_user(data, drvdata->buf + *ppos, len)) {
302 dev_dbg(drvdata->dev, "%s: copy_to_user failed\n", __func__);
308 dev_dbg(drvdata->dev, "%s: %zu bytes copied, %d bytes left\n",
309 __func__, len, (int)(depth * 4 - *ppos));
313 static int etb_release(struct inode *inode, struct file *file)
315 struct etb_drvdata *drvdata = container_of(file->private_data,
316 struct etb_drvdata, miscdev);
317 local_set(&drvdata->reading, 0);
319 dev_dbg(drvdata->dev, "%s: released\n", __func__);
323 static const struct file_operations etb_fops = {
324 .owner = THIS_MODULE,
327 .release = etb_release,
331 static ssize_t status_show(struct device *dev,
332 struct device_attribute *attr, char *buf)
335 u32 etb_rdr, etb_sr, etb_rrp, etb_rwp;
336 u32 etb_trg, etb_cr, etb_ffsr, etb_ffcr;
337 struct etb_drvdata *drvdata = dev_get_drvdata(dev->parent);
339 pm_runtime_get_sync(drvdata->dev);
340 spin_lock_irqsave(&drvdata->spinlock, flags);
341 CS_UNLOCK(drvdata->base);
343 etb_rdr = readl_relaxed(drvdata->base + ETB_RAM_DEPTH_REG);
344 etb_sr = readl_relaxed(drvdata->base + ETB_STATUS_REG);
345 etb_rrp = readl_relaxed(drvdata->base + ETB_RAM_READ_POINTER);
346 etb_rwp = readl_relaxed(drvdata->base + ETB_RAM_WRITE_POINTER);
347 etb_trg = readl_relaxed(drvdata->base + ETB_TRG);
348 etb_cr = readl_relaxed(drvdata->base + ETB_CTL_REG);
349 etb_ffsr = readl_relaxed(drvdata->base + ETB_FFSR);
350 etb_ffcr = readl_relaxed(drvdata->base + ETB_FFCR);
352 CS_LOCK(drvdata->base);
353 spin_unlock_irqrestore(&drvdata->spinlock, flags);
355 pm_runtime_put(drvdata->dev);
360 "RAM read ptr:\t0x%x\n"
361 "RAM wrt ptr:\t0x%x\n"
362 "Trigger cnt:\t0x%x\n"
364 "Flush status:\t0x%x\n"
365 "Flush ctrl:\t0x%x\n",
366 etb_rdr, etb_sr, etb_rrp, etb_rwp,
367 etb_trg, etb_cr, etb_ffsr, etb_ffcr);
371 static DEVICE_ATTR_RO(status);
373 static ssize_t trigger_cntr_show(struct device *dev,
374 struct device_attribute *attr, char *buf)
376 struct etb_drvdata *drvdata = dev_get_drvdata(dev->parent);
377 unsigned long val = drvdata->trigger_cntr;
379 return sprintf(buf, "%#lx\n", val);
382 static ssize_t trigger_cntr_store(struct device *dev,
383 struct device_attribute *attr,
384 const char *buf, size_t size)
388 struct etb_drvdata *drvdata = dev_get_drvdata(dev->parent);
390 ret = kstrtoul(buf, 16, &val);
394 drvdata->trigger_cntr = val;
397 static DEVICE_ATTR_RW(trigger_cntr);
399 static struct attribute *coresight_etb_attrs[] = {
400 &dev_attr_trigger_cntr.attr,
401 &dev_attr_status.attr,
404 ATTRIBUTE_GROUPS(coresight_etb);
406 static int etb_probe(struct amba_device *adev, const struct amba_id *id)
410 struct device *dev = &adev->dev;
411 struct coresight_platform_data *pdata = NULL;
412 struct etb_drvdata *drvdata;
413 struct resource *res = &adev->res;
414 struct coresight_desc *desc;
415 struct device_node *np = adev->dev.of_node;
418 pdata = of_get_coresight_platform_data(dev, np);
420 return PTR_ERR(pdata);
421 adev->dev.platform_data = pdata;
424 drvdata = devm_kzalloc(dev, sizeof(*drvdata), GFP_KERNEL);
428 drvdata->dev = &adev->dev;
429 drvdata->atclk = devm_clk_get(&adev->dev, "atclk"); /* optional */
430 if (!IS_ERR(drvdata->atclk)) {
431 ret = clk_prepare_enable(drvdata->atclk);
435 dev_set_drvdata(dev, drvdata);
437 /* validity for the resource is already checked by the AMBA core */
438 base = devm_ioremap_resource(dev, res);
440 return PTR_ERR(base);
442 drvdata->base = base;
444 spin_lock_init(&drvdata->spinlock);
446 drvdata->buffer_depth = etb_get_buffer_depth(drvdata);
447 pm_runtime_put(&adev->dev);
449 if (drvdata->buffer_depth & 0x80000000)
452 drvdata->buf = devm_kzalloc(dev,
453 drvdata->buffer_depth * 4, GFP_KERNEL);
455 dev_err(dev, "Failed to allocate %u bytes for buffer data\n",
456 drvdata->buffer_depth * 4);
460 desc = devm_kzalloc(dev, sizeof(*desc), GFP_KERNEL);
464 desc->type = CORESIGHT_DEV_TYPE_SINK;
465 desc->subtype.sink_subtype = CORESIGHT_DEV_SUBTYPE_SINK_BUFFER;
466 desc->ops = &etb_cs_ops;
469 desc->groups = coresight_etb_groups;
470 drvdata->csdev = coresight_register(desc);
471 if (IS_ERR(drvdata->csdev))
472 return PTR_ERR(drvdata->csdev);
474 drvdata->miscdev.name = pdata->name;
475 drvdata->miscdev.minor = MISC_DYNAMIC_MINOR;
476 drvdata->miscdev.fops = &etb_fops;
477 ret = misc_register(&drvdata->miscdev);
479 goto err_misc_register;
481 dev_info(dev, "ETB initialized\n");
485 coresight_unregister(drvdata->csdev);
490 static int etb_runtime_suspend(struct device *dev)
492 struct etb_drvdata *drvdata = dev_get_drvdata(dev);
494 if (drvdata && !IS_ERR(drvdata->atclk))
495 clk_disable_unprepare(drvdata->atclk);
500 static int etb_runtime_resume(struct device *dev)
502 struct etb_drvdata *drvdata = dev_get_drvdata(dev);
504 if (drvdata && !IS_ERR(drvdata->atclk))
505 clk_prepare_enable(drvdata->atclk);
511 static const struct dev_pm_ops etb_dev_pm_ops = {
512 SET_RUNTIME_PM_OPS(etb_runtime_suspend, etb_runtime_resume, NULL)
515 static struct amba_id etb_ids[] = {
523 static struct amba_driver etb_driver = {
525 .name = "coresight-etb10",
526 .owner = THIS_MODULE,
527 .pm = &etb_dev_pm_ops,
528 .suppress_bind_attrs = true,
535 module_amba_driver(etb_driver);
537 MODULE_LICENSE("GPL v2");
538 MODULE_DESCRIPTION("CoreSight Embedded Trace Buffer driver");