18  * * Neither the name Texas Instruments nor the names of its
47  * struct resource_table - firmware resource table header
55  * If needed, the remote processor firmware should contain this table
61  * is expected, where the firmware requests a resource, and once allocated,
81  * struct fw_rsc_hdr - firmware resource entry header
95  * enum fw_resource_type - types of resource entries
99  * @RSC_DEVMEM:     request to iommu_map a memory-based peripheral.
126 #define FW_RSC_ADDR_ANY (-1)
129  * struct fw_rsc_carveout - physically contiguous memory request
135  * @name: human-readable name of the requested memory region
140  * These request entries should precede other firmware resource entries,
149  * If the firmware is compiled with static addresses, then @da should specify
167  * @flags is used to provide IOMMU protection flags, and @name should
168  * (optionally) contain a human readable name of this carveout region
177 	u8 name[32];  member
181  * struct fw_rsc_devmem - iommu mapping request
187  * @name: human-readable name of the requested region to be mapped
191  * access to certain memory-based peripherals; _never_ use it to access
199  * the mapping and @flags is the IOMMU protection flags. As always, @name may
200  * (optionally) contain a human readable name of this mapping (mainly for
206  * the firmware is allowed to request, and not allow firmwares to request
215 	u8 name[32];  member
219  * struct fw_rsc_trace - trace buffer declaration
223  * @name: human-readable name of the trace buffer
229  * its size, and @name may contain a human readable name of the trace buffer.
238 	u8 name[32];  member
242  * struct fw_rsc_vdev_vring - vring descriptor entry
246  * @notifyid is a unique rproc-wide notify index for this vring. This notify
267  * struct fw_rsc_vdev - virtio device header
269  * @notifyid is a unique rproc-wide notify index for this vdev. This notify
272  * @dfeatures specifies the virtio device features supported by the firmware
286  * By providing this resource entry, the firmware essentially asks remoteproc
292  * processors. We use the name 'gfeatures' to comply with virtio's terms,
316  * struct rproc_mem_entry - memory entry descriptor
324  * @name: associated memory region name (optional)
338 	char name[32];  member
347 struct firmware;
350  * enum rsc_handling_status - return status of rproc_ops handle_rsc hook
360  * struct rproc_ops - platform-specific device handlers
368  * @parse_fw:	parse firmware to extract information (e.g. resource table)
372  * @load_rsc_table:	load resource table from firmware image
374  * @load:		load firmware to memory, where the remote processor
377  * @get_boot_addr:	get boot address to entry point specified in firmware
380  * @coredump:	  collect firmware dump after the subsystem is shutdown
390 	int (*parse_fw)(struct rproc *rproc, const struct firmware *fw);
394 				struct rproc *rproc, const struct firmware *fw);
395 	int (*load)(struct rproc *rproc, const struct firmware *fw);
396 	int (*sanity_check)(struct rproc *rproc, const struct firmware *fw);
397 	u64 (*get_boot_addr)(struct rproc *rproc, const struct firmware *fw);
403  * enum rproc_state - remote processor states
415  * to rproc_state_string, a state-to-name lookup table,
431  * enum rproc_crash_type - remote processor crash types
448  * enum rproc_dump_mechanism - Coredump options for core
462  * struct rproc_dump_segment - segment info from ELF header
483  * struct rproc - represents a physical remote processor device
486  * @name: human readable name of the rproc
487  * @firmware: name of firmware file to be loaded
488  * @priv: private data which belongs to the platform-specific rproc module
489  * @ops: platform-specific start/stop rproc handlers
503  * @notifyids: idr for dynamically assigning rproc-wide unique notify ids
513  * @auto_boot: flag to indicate if remote processor should be auto-started
515  * @dump_segments: list of segments in the firmware
523 	const char *name;  member
524 	const char *firmware;  member
561  * struct rproc_subdev - subdevice tied to a remoteproc
583  * struct rproc_vring - remoteproc vring state
588  * @notifyid: rproc-specific unique vring index
603  * struct rproc_vdev - remoteproc state for a supported virtio device
631 struct rproc *rproc_alloc(struct device *dev, const char *name,
633 			  const char *firmware, int len);
640 struct rproc *devm_rproc_alloc(struct device *dev, const char *name,
642 			       const char *firmware, int len);
652 		     const char *name, ...);
656 			     u32 da, const char *name, ...);
679 	return container_of(vdev->dev.parent, struct rproc_vdev, dev);  in vdev_to_rvdev()
686 	return rvdev->rproc;  in vdev_to_rproc()