2 * Remote Processor Framework
4 * Copyright (C) 2011 Texas Instruments, Inc.
5 * Copyright (C) 2011 Google, Inc.
7 * Ohad Ben-Cohen <ohad@wizery.com>
8 * Mark Grosen <mgrosen@ti.com>
9 * Brian Swetland <swetland@google.com>
10 * Fernando Guzman Lugo <fernando.lugo@ti.com>
11 * Suman Anna <s-anna@ti.com>
12 * Robert Tivy <rtivy@ti.com>
13 * Armando Uribe De Leon <x0095078@ti.com>
15 * This program is free software; you can redistribute it and/or
16 * modify it under the terms of the GNU General Public License
17 * version 2 as published by the Free Software Foundation.
19 * This program is distributed in the hope that it will be useful,
20 * but WITHOUT ANY WARRANTY; without even the implied warranty of
21 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
22 * GNU General Public License for more details.
25 #define pr_fmt(fmt) "%s: " fmt, __func__
27 #include <linux/kernel.h>
28 #include <linux/debugfs.h>
29 #include <linux/remoteproc.h>
30 #include <linux/device.h>
31 #include <linux/uaccess.h>
33 #include "remoteproc_internal.h"
35 /* remoteproc debugfs parent dir */
36 static struct dentry
*rproc_dbg
;
39 * Some remote processors may support dumping trace logs into a shared
40 * memory buffer. We expose this trace buffer using debugfs, so users
41 * can easily tell what's going on remotely.
43 * We will most probably improve the rproc tracing facilities later on,
44 * but this kind of lightweight and simple mechanism is always good to have,
45 * as it provides very early tracing with little to no dependencies at all.
47 static ssize_t
rproc_trace_read(struct file
*filp
, char __user
*userbuf
,
48 size_t count
, loff_t
*ppos
)
50 struct rproc_debug_trace
*data
= filp
->private_data
;
51 struct rproc_mem_entry
*trace
= &data
->trace_mem
;
56 va
= rproc_da_to_va(data
->rproc
, trace
->da
, trace
->len
);
59 len
= scnprintf(buf
, sizeof(buf
), "Trace %s not available\n",
63 len
= strnlen(va
, trace
->len
);
66 return simple_read_from_buffer(userbuf
, count
, ppos
, va
, len
);
69 static const struct file_operations trace_rproc_ops
= {
70 .read
= rproc_trace_read
,
72 .llseek
= generic_file_llseek
,
75 /* expose the name of the remote processor via debugfs */
76 static ssize_t
rproc_name_read(struct file
*filp
, char __user
*userbuf
,
77 size_t count
, loff_t
*ppos
)
79 struct rproc
*rproc
= filp
->private_data
;
80 /* need room for the name, a newline and a terminating null */
84 i
= scnprintf(buf
, sizeof(buf
), "%.98s\n", rproc
->name
);
86 return simple_read_from_buffer(userbuf
, count
, ppos
, buf
, i
);
89 static const struct file_operations rproc_name_ops
= {
90 .read
= rproc_name_read
,
92 .llseek
= generic_file_llseek
,
95 /* expose recovery flag via debugfs */
96 static ssize_t
rproc_recovery_read(struct file
*filp
, char __user
*userbuf
,
97 size_t count
, loff_t
*ppos
)
99 struct rproc
*rproc
= filp
->private_data
;
100 char *buf
= rproc
->recovery_disabled
? "disabled\n" : "enabled\n";
102 return simple_read_from_buffer(userbuf
, count
, ppos
, buf
, strlen(buf
));
106 * By writing to the 'recovery' debugfs entry, we control the behavior of the
107 * recovery mechanism dynamically. The default value of this entry is "enabled".
109 * The 'recovery' debugfs entry supports these commands:
111 * enabled: When enabled, the remote processor will be automatically
112 * recovered whenever it crashes. Moreover, if the remote
113 * processor crashes while recovery is disabled, it will
114 * be automatically recovered too as soon as recovery is enabled.
116 * disabled: When disabled, a remote processor will remain in a crashed
117 * state if it crashes. This is useful for debugging purposes;
118 * without it, debugging a crash is substantially harder.
120 * recover: This function will trigger an immediate recovery if the
121 * remote processor is in a crashed state, without changing
122 * or checking the recovery state (enabled/disabled).
123 * This is useful during debugging sessions, when one expects
124 * additional crashes to happen after enabling recovery. In this
125 * case, enabling recovery will make it hard to debug subsequent
126 * crashes, so it's recommended to keep recovery disabled, and
127 * instead use the "recover" command as needed.
130 rproc_recovery_write(struct file
*filp
, const char __user
*user_buf
,
131 size_t count
, loff_t
*ppos
)
133 struct rproc
*rproc
= filp
->private_data
;
137 if (count
< 1 || count
> sizeof(buf
))
140 ret
= copy_from_user(buf
, user_buf
, count
);
144 /* remove end of line */
145 if (buf
[count
- 1] == '\n')
146 buf
[count
- 1] = '\0';
148 if (!strncmp(buf
, "enabled", count
)) {
149 rproc
->recovery_disabled
= false;
150 /* if rproc has crashed, trigger recovery */
151 if (rproc
->state
== RPROC_CRASHED
)
152 rproc_trigger_recovery(rproc
);
153 } else if (!strncmp(buf
, "disabled", count
)) {
154 rproc
->recovery_disabled
= true;
155 } else if (!strncmp(buf
, "recover", count
)) {
156 /* if rproc has crashed, trigger recovery */
157 if (rproc
->state
== RPROC_CRASHED
)
158 rproc_trigger_recovery(rproc
);
164 static const struct file_operations rproc_recovery_ops
= {
165 .read
= rproc_recovery_read
,
166 .write
= rproc_recovery_write
,
168 .llseek
= generic_file_llseek
,
171 /* expose the crash trigger via debugfs */
173 rproc_crash_write(struct file
*filp
, const char __user
*user_buf
,
174 size_t count
, loff_t
*ppos
)
176 struct rproc
*rproc
= filp
->private_data
;
180 ret
= kstrtouint_from_user(user_buf
, count
, 0, &type
);
184 rproc_report_crash(rproc
, type
);
189 static const struct file_operations rproc_crash_ops
= {
190 .write
= rproc_crash_write
,
192 .llseek
= generic_file_llseek
,
195 /* Expose resource table content via debugfs */
196 static int rproc_rsc_table_show(struct seq_file
*seq
, void *p
)
198 static const char * const types
[] = {"carveout", "devmem", "trace", "vdev"};
199 struct rproc
*rproc
= seq
->private;
200 struct resource_table
*table
= rproc
->table_ptr
;
201 struct fw_rsc_carveout
*c
;
202 struct fw_rsc_devmem
*d
;
203 struct fw_rsc_trace
*t
;
204 struct fw_rsc_vdev
*v
;
208 seq_puts(seq
, "No resource table found\n");
212 for (i
= 0; i
< table
->num
; i
++) {
213 int offset
= table
->offset
[i
];
214 struct fw_rsc_hdr
*hdr
= (void *)table
+ offset
;
215 void *rsc
= (void *)hdr
+ sizeof(*hdr
);
220 seq_printf(seq
, "Entry %d is of type %s\n", i
, types
[hdr
->type
]);
221 seq_printf(seq
, " Device Address 0x%x\n", c
->da
);
222 seq_printf(seq
, " Physical Address 0x%x\n", c
->pa
);
223 seq_printf(seq
, " Length 0x%x Bytes\n", c
->len
);
224 seq_printf(seq
, " Flags 0x%x\n", c
->flags
);
225 seq_printf(seq
, " Reserved (should be zero) [%d]\n", c
->reserved
);
226 seq_printf(seq
, " Name %s\n\n", c
->name
);
230 seq_printf(seq
, "Entry %d is of type %s\n", i
, types
[hdr
->type
]);
231 seq_printf(seq
, " Device Address 0x%x\n", d
->da
);
232 seq_printf(seq
, " Physical Address 0x%x\n", d
->pa
);
233 seq_printf(seq
, " Length 0x%x Bytes\n", d
->len
);
234 seq_printf(seq
, " Flags 0x%x\n", d
->flags
);
235 seq_printf(seq
, " Reserved (should be zero) [%d]\n", d
->reserved
);
236 seq_printf(seq
, " Name %s\n\n", d
->name
);
240 seq_printf(seq
, "Entry %d is of type %s\n", i
, types
[hdr
->type
]);
241 seq_printf(seq
, " Device Address 0x%x\n", t
->da
);
242 seq_printf(seq
, " Length 0x%x Bytes\n", t
->len
);
243 seq_printf(seq
, " Reserved (should be zero) [%d]\n", t
->reserved
);
244 seq_printf(seq
, " Name %s\n\n", t
->name
);
248 seq_printf(seq
, "Entry %d is of type %s\n", i
, types
[hdr
->type
]);
250 seq_printf(seq
, " ID %d\n", v
->id
);
251 seq_printf(seq
, " Notify ID %d\n", v
->notifyid
);
252 seq_printf(seq
, " Device features 0x%x\n", v
->dfeatures
);
253 seq_printf(seq
, " Guest features 0x%x\n", v
->gfeatures
);
254 seq_printf(seq
, " Config length 0x%x\n", v
->config_len
);
255 seq_printf(seq
, " Status 0x%x\n", v
->status
);
256 seq_printf(seq
, " Number of vrings %d\n", v
->num_of_vrings
);
257 seq_printf(seq
, " Reserved (should be zero) [%d][%d]\n\n",
258 v
->reserved
[0], v
->reserved
[1]);
260 for (j
= 0; j
< v
->num_of_vrings
; j
++) {
261 seq_printf(seq
, " Vring %d\n", j
);
262 seq_printf(seq
, " Device Address 0x%x\n", v
->vring
[j
].da
);
263 seq_printf(seq
, " Alignment %d\n", v
->vring
[j
].align
);
264 seq_printf(seq
, " Number of buffers %d\n", v
->vring
[j
].num
);
265 seq_printf(seq
, " Notify ID %d\n", v
->vring
[j
].notifyid
);
266 seq_printf(seq
, " Physical Address 0x%x\n\n",
271 seq_printf(seq
, "Unknown resource type found: %d [hdr: %pK]\n",
280 static int rproc_rsc_table_open(struct inode
*inode
, struct file
*file
)
282 return single_open(file
, rproc_rsc_table_show
, inode
->i_private
);
285 static const struct file_operations rproc_rsc_table_ops
= {
286 .open
= rproc_rsc_table_open
,
289 .release
= single_release
,
292 /* Expose carveout content via debugfs */
293 static int rproc_carveouts_show(struct seq_file
*seq
, void *p
)
295 struct rproc
*rproc
= seq
->private;
296 struct rproc_mem_entry
*carveout
;
298 list_for_each_entry(carveout
, &rproc
->carveouts
, node
) {
299 seq_puts(seq
, "Carveout memory entry:\n");
300 seq_printf(seq
, "\tName: %s\n", carveout
->name
);
301 seq_printf(seq
, "\tVirtual address: %pK\n", carveout
->va
);
302 seq_printf(seq
, "\tDMA address: %pad\n", &carveout
->dma
);
303 seq_printf(seq
, "\tDevice address: 0x%x\n", carveout
->da
);
304 seq_printf(seq
, "\tLength: 0x%x Bytes\n\n", carveout
->len
);
310 static int rproc_carveouts_open(struct inode
*inode
, struct file
*file
)
312 return single_open(file
, rproc_carveouts_show
, inode
->i_private
);
315 static const struct file_operations rproc_carveouts_ops
= {
316 .open
= rproc_carveouts_open
,
319 .release
= single_release
,
322 void rproc_remove_trace_file(struct dentry
*tfile
)
324 debugfs_remove(tfile
);
327 struct dentry
*rproc_create_trace_file(const char *name
, struct rproc
*rproc
,
328 struct rproc_debug_trace
*trace
)
330 struct dentry
*tfile
;
332 tfile
= debugfs_create_file(name
, 0400, rproc
->dbg_dir
, trace
,
335 dev_err(&rproc
->dev
, "failed to create debugfs trace entry\n");
342 void rproc_delete_debug_dir(struct rproc
*rproc
)
347 debugfs_remove_recursive(rproc
->dbg_dir
);
350 void rproc_create_debug_dir(struct rproc
*rproc
)
352 struct device
*dev
= &rproc
->dev
;
357 rproc
->dbg_dir
= debugfs_create_dir(dev_name(dev
), rproc_dbg
);
361 debugfs_create_file("name", 0400, rproc
->dbg_dir
,
362 rproc
, &rproc_name_ops
);
363 debugfs_create_file("recovery", 0400, rproc
->dbg_dir
,
364 rproc
, &rproc_recovery_ops
);
365 debugfs_create_file("crash", 0200, rproc
->dbg_dir
,
366 rproc
, &rproc_crash_ops
);
367 debugfs_create_file("resource_table", 0400, rproc
->dbg_dir
,
368 rproc
, &rproc_rsc_table_ops
);
369 debugfs_create_file("carveout_memories", 0400, rproc
->dbg_dir
,
370 rproc
, &rproc_carveouts_ops
);
373 void __init
rproc_init_debugfs(void)
375 if (debugfs_initialized()) {
376 rproc_dbg
= debugfs_create_dir(KBUILD_MODNAME
, NULL
);
378 pr_err("can't create debugfs dir\n");
382 void __exit
rproc_exit_debugfs(void)
384 debugfs_remove(rproc_dbg
);