Ohad Ben-Cohen | 400e64d | 2011-10-20 16:52:46 +0200 | [diff] [blame] | 1 | /* |
| 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ændeland | 72854fb | 2012-07-15 11:25:27 +0300 | [diff] [blame] | 24 | #include <linux/firmware.h> |
Ohad Ben-Cohen | 400e64d | 2011-10-20 16:52:46 +0200 | [diff] [blame] | 25 | |
| 26 | struct rproc; |
| 27 | |
Loic Pallardy | a987e6b9 | 2019-01-10 14:49:10 +0100 | [diff] [blame] | 28 | struct 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-Cohen | 400e64d | 2011-10-20 16:52:46 +0200 | [diff] [blame] | 35 | /* from remoteproc_core.c */ |
| 36 | void rproc_release(struct kref *kref); |
| 37 | irqreturn_t rproc_vq_interrupt(struct rproc *rproc, int vq_id); |
Bjorn Andersson | aab8d80 | 2016-10-19 19:40:06 -0700 | [diff] [blame] | 38 | void rproc_vdev_release(struct kref *ref); |
Ohad Ben-Cohen | 400e64d | 2011-10-20 16:52:46 +0200 | [diff] [blame] | 39 | |
Ohad Ben-Cohen | 7a18694 | 2012-02-13 22:30:39 +0100 | [diff] [blame] | 40 | /* from remoteproc_virtio.c */ |
| 41 | int rproc_add_virtio_dev(struct rproc_vdev *rvdev, int id); |
Loic Pallardy | d4c036f | 2019-01-21 14:55:15 +0100 | [diff] [blame] | 42 | int rproc_remove_virtio_dev(struct device *dev, void *data); |
Ohad Ben-Cohen | 400e64d | 2011-10-20 16:52:46 +0200 | [diff] [blame] | 43 | |
| 44 | /* from remoteproc_debugfs.c */ |
| 45 | void rproc_remove_trace_file(struct dentry *tfile); |
| 46 | struct dentry *rproc_create_trace_file(const char *name, struct rproc *rproc, |
Loic Pallardy | a987e6b9 | 2019-01-10 14:49:10 +0100 | [diff] [blame] | 47 | struct rproc_debug_trace *trace); |
Ohad Ben-Cohen | 400e64d | 2011-10-20 16:52:46 +0200 | [diff] [blame] | 48 | void rproc_delete_debug_dir(struct rproc *rproc); |
| 49 | void rproc_create_debug_dir(struct rproc *rproc); |
| 50 | void rproc_init_debugfs(void); |
| 51 | void rproc_exit_debugfs(void); |
| 52 | |
Matt Redfearn | 2aefbef | 2016-10-19 13:05:47 +0100 | [diff] [blame] | 53 | /* from remoteproc_sysfs.c */ |
| 54 | extern struct class rproc_class; |
| 55 | int rproc_init_sysfs(void); |
| 56 | void rproc_exit_sysfs(void); |
| 57 | |
Ohad Ben-Cohen | 6db20ea | 2012-05-17 14:23:59 +0300 | [diff] [blame] | 58 | void rproc_free_vring(struct rproc_vring *rvring); |
| 59 | int rproc_alloc_vring(struct rproc_vdev *rvdev, int i); |
Sjur Brændeland | 72854fb | 2012-07-15 11:25:27 +0300 | [diff] [blame] | 60 | |
| 61 | void *rproc_da_to_va(struct rproc *rproc, u64 da, int len); |
Loic Pallardy | 086d087 | 2019-01-10 14:50:49 +0100 | [diff] [blame] | 62 | phys_addr_t rproc_va_to_pa(void *cpu_addr); |
Fernando Guzman Lugo | 70b85ef | 2012-08-30 13:26:13 -0500 | [diff] [blame] | 63 | int rproc_trigger_recovery(struct rproc *rproc); |
Sjur Brændeland | 72854fb | 2012-07-15 11:25:27 +0300 | [diff] [blame] | 64 | |
Bjorn Andersson | 0f21f9c | 2018-01-05 15:58:01 -0800 | [diff] [blame] | 65 | int rproc_elf_sanity_check(struct rproc *rproc, const struct firmware *fw); |
| 66 | u32 rproc_elf_get_boot_addr(struct rproc *rproc, const struct firmware *fw); |
| 67 | int rproc_elf_load_segments(struct rproc *rproc, const struct firmware *fw); |
Bjorn Andersson | 58b6409 | 2018-01-05 15:58:03 -0800 | [diff] [blame] | 68 | int rproc_elf_load_rsc_table(struct rproc *rproc, const struct firmware *fw); |
Bjorn Andersson | 0f21f9c | 2018-01-05 15:58:01 -0800 | [diff] [blame] | 69 | struct resource_table *rproc_elf_find_loaded_rsc_table(struct rproc *rproc, |
| 70 | const struct firmware *fw); |
Loic Pallardy | c6aed238 | 2018-07-27 15:14:47 +0200 | [diff] [blame] | 71 | struct rproc_mem_entry * |
| 72 | rproc_find_carveout_by_name(struct rproc *rproc, const char *name, ...); |
Bjorn Andersson | 0f21f9c | 2018-01-05 15:58:01 -0800 | [diff] [blame] | 73 | |
Sjur Brændeland | 4afc89d | 2012-06-19 10:08:18 +0300 | [diff] [blame] | 74 | static inline |
| 75 | int rproc_fw_sanity_check(struct rproc *rproc, const struct firmware *fw) |
| 76 | { |
Bjorn Andersson | 0f21f9c | 2018-01-05 15:58:01 -0800 | [diff] [blame] | 77 | if (rproc->ops->sanity_check) |
| 78 | return rproc->ops->sanity_check(rproc, fw); |
Sjur Brændeland | 4afc89d | 2012-06-19 10:08:18 +0300 | [diff] [blame] | 79 | |
| 80 | return 0; |
| 81 | } |
| 82 | |
| 83 | static inline |
| 84 | u32 rproc_get_boot_addr(struct rproc *rproc, const struct firmware *fw) |
| 85 | { |
Bjorn Andersson | 0f21f9c | 2018-01-05 15:58:01 -0800 | [diff] [blame] | 86 | if (rproc->ops->get_boot_addr) |
| 87 | return rproc->ops->get_boot_addr(rproc, fw); |
Sjur Brændeland | 4afc89d | 2012-06-19 10:08:18 +0300 | [diff] [blame] | 88 | |
| 89 | return 0; |
| 90 | } |
| 91 | |
| 92 | static inline |
| 93 | int rproc_load_segments(struct rproc *rproc, const struct firmware *fw) |
| 94 | { |
Bjorn Andersson | 0f21f9c | 2018-01-05 15:58:01 -0800 | [diff] [blame] | 95 | if (rproc->ops->load) |
| 96 | return rproc->ops->load(rproc, fw); |
Sjur Brændeland | 4afc89d | 2012-06-19 10:08:18 +0300 | [diff] [blame] | 97 | |
| 98 | return -EINVAL; |
| 99 | } |
| 100 | |
Bjorn Andersson | c1d35c1 | 2018-01-05 16:04:18 -0800 | [diff] [blame] | 101 | static inline int rproc_parse_fw(struct rproc *rproc, const struct firmware *fw) |
Sjur Brændeland | 4afc89d | 2012-06-19 10:08:18 +0300 | [diff] [blame] | 102 | { |
Bjorn Andersson | c1d35c1 | 2018-01-05 16:04:18 -0800 | [diff] [blame] | 103 | if (rproc->ops->parse_fw) |
| 104 | return rproc->ops->parse_fw(rproc, fw); |
Sjur Brændeland | 4afc89d | 2012-06-19 10:08:18 +0300 | [diff] [blame] | 105 | |
Bjorn Andersson | 58b6409 | 2018-01-05 15:58:03 -0800 | [diff] [blame] | 106 | return 0; |
Sjur Brændeland | 4afc89d | 2012-06-19 10:08:18 +0300 | [diff] [blame] | 107 | } |
| 108 | |
Sjur Brændeland | 95f9578 | 2013-02-21 18:15:34 +0100 | [diff] [blame] | 109 | static inline |
| 110 | struct resource_table *rproc_find_loaded_rsc_table(struct rproc *rproc, |
Anna, Suman | 730f84c | 2016-08-12 18:42:20 -0500 | [diff] [blame] | 111 | const struct firmware *fw) |
Sjur Brændeland | 95f9578 | 2013-02-21 18:15:34 +0100 | [diff] [blame] | 112 | { |
Bjorn Andersson | 0f21f9c | 2018-01-05 15:58:01 -0800 | [diff] [blame] | 113 | if (rproc->ops->find_loaded_rsc_table) |
| 114 | return rproc->ops->find_loaded_rsc_table(rproc, fw); |
Sjur Brændeland | 95f9578 | 2013-02-21 18:15:34 +0100 | [diff] [blame] | 115 | |
Suman Anna | 5797115 | 2013-06-30 11:33:05 +0300 | [diff] [blame] | 116 | return NULL; |
Sjur Brændeland | 95f9578 | 2013-02-21 18:15:34 +0100 | [diff] [blame] | 117 | } |
| 118 | |
Ohad Ben-Cohen | 400e64d | 2011-10-20 16:52:46 +0200 | [diff] [blame] | 119 | #endif /* REMOTEPROC_INTERNAL_H */ |