blob: 45ff76a06c72bec26d18f3d8753686d0346a86c1 [file] [log] [blame]
Ohad Ben-Cohen400e64d2011-10-20 16:52:46 +02001/*
2 * Remote processor framework
3 *
4 * Copyright (C) 2011 Texas Instruments, Inc.
5 * Copyright (C) 2011 Google, Inc.
6 *
7 * Ohad Ben-Cohen <ohad@wizery.com>
8 * Brian Swetland <swetland@google.com>
9 *
10 * This software is licensed under the terms of the GNU General Public
11 * License version 2, as published by the Free Software Foundation, and
12 * may be copied, distributed, and modified under those terms.
13 *
14 * This program is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 * GNU General Public License for more details.
18 */
19
20#ifndef REMOTEPROC_INTERNAL_H
21#define REMOTEPROC_INTERNAL_H
22
23#include <linux/irqreturn.h>
Sjur Brændeland72854fb2012-07-15 11:25:27 +030024#include <linux/firmware.h>
Ohad Ben-Cohen400e64d2011-10-20 16:52:46 +020025
26struct rproc;
27
Loic Pallardya987e6b92019-01-10 14:49:10 +010028struct rproc_debug_trace {
29 struct rproc *rproc;
30 struct dentry *tfile;
31 struct list_head node;
32 struct rproc_mem_entry trace_mem;
33};
34
Ohad Ben-Cohen400e64d2011-10-20 16:52:46 +020035/* from remoteproc_core.c */
36void rproc_release(struct kref *kref);
37irqreturn_t rproc_vq_interrupt(struct rproc *rproc, int vq_id);
Bjorn Anderssonaab8d802016-10-19 19:40:06 -070038void rproc_vdev_release(struct kref *ref);
Ohad Ben-Cohen400e64d2011-10-20 16:52:46 +020039
Ohad Ben-Cohen7a186942012-02-13 22:30:39 +010040/* from remoteproc_virtio.c */
41int rproc_add_virtio_dev(struct rproc_vdev *rvdev, int id);
Loic Pallardyd4c036f2019-01-21 14:55:15 +010042int rproc_remove_virtio_dev(struct device *dev, void *data);
Ohad Ben-Cohen400e64d2011-10-20 16:52:46 +020043
44/* from remoteproc_debugfs.c */
45void rproc_remove_trace_file(struct dentry *tfile);
46struct dentry *rproc_create_trace_file(const char *name, struct rproc *rproc,
Loic Pallardya987e6b92019-01-10 14:49:10 +010047 struct rproc_debug_trace *trace);
Ohad Ben-Cohen400e64d2011-10-20 16:52:46 +020048void rproc_delete_debug_dir(struct rproc *rproc);
49void rproc_create_debug_dir(struct rproc *rproc);
50void rproc_init_debugfs(void);
51void rproc_exit_debugfs(void);
52
Matt Redfearn2aefbef2016-10-19 13:05:47 +010053/* from remoteproc_sysfs.c */
54extern struct class rproc_class;
55int rproc_init_sysfs(void);
56void rproc_exit_sysfs(void);
57
Ohad Ben-Cohen6db20ea2012-05-17 14:23:59 +030058void rproc_free_vring(struct rproc_vring *rvring);
59int rproc_alloc_vring(struct rproc_vdev *rvdev, int i);
Sjur Brændeland72854fb2012-07-15 11:25:27 +030060
61void *rproc_da_to_va(struct rproc *rproc, u64 da, int len);
Loic Pallardy086d0872019-01-10 14:50:49 +010062phys_addr_t rproc_va_to_pa(void *cpu_addr);
Fernando Guzman Lugo70b85ef2012-08-30 13:26:13 -050063int rproc_trigger_recovery(struct rproc *rproc);
Sjur Brændeland72854fb2012-07-15 11:25:27 +030064
Bjorn Andersson0f21f9c2018-01-05 15:58:01 -080065int rproc_elf_sanity_check(struct rproc *rproc, const struct firmware *fw);
66u32 rproc_elf_get_boot_addr(struct rproc *rproc, const struct firmware *fw);
67int rproc_elf_load_segments(struct rproc *rproc, const struct firmware *fw);
Bjorn Andersson58b64092018-01-05 15:58:03 -080068int rproc_elf_load_rsc_table(struct rproc *rproc, const struct firmware *fw);
Bjorn Andersson0f21f9c2018-01-05 15:58:01 -080069struct resource_table *rproc_elf_find_loaded_rsc_table(struct rproc *rproc,
70 const struct firmware *fw);
Loic Pallardyc6aed2382018-07-27 15:14:47 +020071struct rproc_mem_entry *
72rproc_find_carveout_by_name(struct rproc *rproc, const char *name, ...);
Bjorn Andersson0f21f9c2018-01-05 15:58:01 -080073
Sjur Brændeland4afc89d2012-06-19 10:08:18 +030074static inline
75int rproc_fw_sanity_check(struct rproc *rproc, const struct firmware *fw)
76{
Bjorn Andersson0f21f9c2018-01-05 15:58:01 -080077 if (rproc->ops->sanity_check)
78 return rproc->ops->sanity_check(rproc, fw);
Sjur Brændeland4afc89d2012-06-19 10:08:18 +030079
80 return 0;
81}
82
83static inline
84u32 rproc_get_boot_addr(struct rproc *rproc, const struct firmware *fw)
85{
Bjorn Andersson0f21f9c2018-01-05 15:58:01 -080086 if (rproc->ops->get_boot_addr)
87 return rproc->ops->get_boot_addr(rproc, fw);
Sjur Brændeland4afc89d2012-06-19 10:08:18 +030088
89 return 0;
90}
91
92static inline
93int rproc_load_segments(struct rproc *rproc, const struct firmware *fw)
94{
Bjorn Andersson0f21f9c2018-01-05 15:58:01 -080095 if (rproc->ops->load)
96 return rproc->ops->load(rproc, fw);
Sjur Brændeland4afc89d2012-06-19 10:08:18 +030097
98 return -EINVAL;
99}
100
Bjorn Anderssonc1d35c12018-01-05 16:04:18 -0800101static inline int rproc_parse_fw(struct rproc *rproc, const struct firmware *fw)
Sjur Brændeland4afc89d2012-06-19 10:08:18 +0300102{
Bjorn Anderssonc1d35c12018-01-05 16:04:18 -0800103 if (rproc->ops->parse_fw)
104 return rproc->ops->parse_fw(rproc, fw);
Sjur Brændeland4afc89d2012-06-19 10:08:18 +0300105
Bjorn Andersson58b64092018-01-05 15:58:03 -0800106 return 0;
Sjur Brændeland4afc89d2012-06-19 10:08:18 +0300107}
108
Sjur Brændeland95f95782013-02-21 18:15:34 +0100109static inline
110struct resource_table *rproc_find_loaded_rsc_table(struct rproc *rproc,
Anna, Suman730f84c2016-08-12 18:42:20 -0500111 const struct firmware *fw)
Sjur Brændeland95f95782013-02-21 18:15:34 +0100112{
Bjorn Andersson0f21f9c2018-01-05 15:58:01 -0800113 if (rproc->ops->find_loaded_rsc_table)
114 return rproc->ops->find_loaded_rsc_table(rproc, fw);
Sjur Brændeland95f95782013-02-21 18:15:34 +0100115
Suman Anna57971152013-06-30 11:33:05 +0300116 return NULL;
Sjur Brændeland95f95782013-02-21 18:15:34 +0100117}
118
Ohad Ben-Cohen400e64d2011-10-20 16:52:46 +0200119#endif /* REMOTEPROC_INTERNAL_H */