3  * Remote Processor Framework
82  * IOMMU core will invoke this handler whenever the remote processor
166  * @rproc: handle of a remote processor
235  * @rproc: handle of a remote processor
247  * coprocessor address, length or processor virtual address.
279  * @rproc: handle of a remote processor
421 	 * table in the remote processor memory may no longer be accessible. As  in rproc_free_vring()
424 	 * only available when a remote processor has been booted by the  in rproc_free_vring()
450  * @rproc: the remote processor
462  * remote processor (temporary limitation). We might also want to consider
514 	 * When there is more than one remote processor, rproc->nb_vdev number is  in rproc_handle_vdev()
531  * @rproc: the remote processor
536  * In case the remote processor dumps trace logs into memory,
540  * where the remote processor is dumping the traces. Later we could also
594  * @rproc: remote processor handle
658 	 * We can't trust the remote processor not to change the resource  in rproc_handle_devmem()
728 	 * processor.  in rproc_alloc_carveout()
730 	 * Obviously such remote processor devices should not be configured  in rproc_alloc_carveout()
752 		 * We can't trust the remote processor not to change the  in rproc_alloc_carveout()
1019 /* handle firmware resource entries before booting the remote processor */
1146  * @rproc: the remote processor handle
1179 			 * remote M3 processor needs this so it can control  in rproc_alloc_registered_carveouts()
1186 			 * remote processor that _must_ have this (e.g. OMAP4's  in rproc_alloc_registered_carveouts()
1301 	/* power up the remote processor */  in rproc_start()
1308 	/* Start any subdevices for the remote processor */  in rproc_start()
1318 	dev_info(dev, "remote processor %s is now up\n", rproc->name);  in rproc_start()
1344 	/* Attach to the remote processor */  in __rproc_attach()
1352 	/* Start any subdevices for the remote processor */  in __rproc_attach()
1362 	dev_info(dev, "remote processor %s is now attached\n", rproc->name);  in __rproc_attach()
1375  * take a firmware and boot a remote processor with it.
1473 	 * If it is possible to detach the remote processor, keep an untouched  in rproc_set_rsc_table()
1475 	 * the remote processor is re-attached, that is:  in rproc_set_rsc_table()
1517 	 * If we made it here the remote processor was started by another  in rproc_reset_rsc_table_on_detach()
1519 	 * the resource table currently used by the remote processor and  in rproc_reset_rsc_table_on_detach()
1537 	 * processor the resource table is clean and ready to be used again.  in rproc_reset_rsc_table_on_detach()
1557 	 * If a cache table exists the remote processor was started by  in rproc_reset_rsc_table_on_stop()
1565 	 * If we made it here the remote processor was started by another  in rproc_reset_rsc_table_on_stop()
1567 	 * the resource table currently used by the remote processor and  in rproc_reset_rsc_table_on_stop()
1577 	 * Since the remote processor is being switched off the clean table  in rproc_reset_rsc_table_on_stop()
1592  * Attach to remote processor - similar to rproc_fw_boot() but without
1610 	/* Do anything that is needed to boot the remote processor */  in rproc_attach()
1630 	 * Handle firmware resources required to attach to a remote processor.  in rproc_attach()
1631 	 * Because we are attaching rather than booting the remote processor,  in rproc_attach()
1668  * remote processor (so we must wait until it completes before we try
1686 	 * Since the remote processor is in a detached state, it has already  in rproc_trigger_auto_boot()
1716 	/* Stop any subdevices for the remote processor */  in rproc_stop()
1727 	/* power off the remote processor */  in rproc_stop()
1738 	dev_info(dev, "stopped remote processor %s\n", rproc->name);  in rproc_stop()
1755 	/* Stop any subdevices for the remote processor */  in __rproc_detach()
1765 	/* Tell the remote processor the core isn't available anymore */  in __rproc_detach()
1776 	dev_info(dev, "detached remote processor %s\n", rproc->name);  in __rproc_detach()
1812 	/* boot the remote processor up again */  in rproc_boot_recovery()
1822  * @rproc: the remote processor
1825  * rpmsg drivers will be reseted along with the remote processor making the
1880 		/* Don't recover if the remote processor was stopped */  in rproc_crash_handler_work()
1899  * rproc_boot() - boot a remote processor
1900  * @rproc: handle of a remote processor
1902  * Boot a remote processor (i.e. load its firmware, power it on, ...).
1904  * If the remote processor is already powered on, this function immediately
1969  * rproc_shutdown() - power off the remote processor
1970  * @rproc: the remote processor
1972  * Power off a remote processor (previously booted with rproc_boot()).
2035  * rproc_detach() - Detach the remote processor from the
2038  * @rproc: the remote processor
2040  * Detach a remote processor (previously attached to with rproc_attach()).
2047  * processor know that services provided by the application processor are
2049  * platform driver and even power cycle the application processor (if the HW
2050  * supports it) without needing to switch off the remote processor.
2101  * rproc_get_by_phandle() - find a remote processor by phandle
2104  * Finds an rproc handle using the remote processor's phandle, and then
2107  * This function increments the remote processor's refcount, so always
2177  * registration. The function does not trigger a remote processor boot,
2179  * should also be called only when the remote processor is offline.
2184  * remote processor.
2238 		 * An offline processor without a start()  in rproc_validate()
2246 		 * A remote processor in a detached state without an  in rproc_validate()
2252 		 * When attaching to a remote processor the device memory  in rproc_validate()
2261 		 * When adding a remote processor, the state of the device  in rproc_validate()
2271  * rproc_add() - register a remote processor
2272  * @rproc: the remote processor handle to register
2278  * a new remote processor device is probed.
2285  * of registering this remote processor, additional virtio drivers might be
2346  * @rproc: the remote processor handle to register
2366  * rproc_type_release() - release a remote processor instance
2442  * rproc_alloc() - allocate a remote processor handle
2444  * @name: name of this remote processor
2449  * Allocates a new remote processor handle, but does not register
2453  * of the remote processor.
2457  * the registration of the remote processor.
2533  * @rproc: the remote processor handle
2548  * @rproc: the remote processor handle
2567  * rproc_del() - unregister a remote processor
2618  * @name: name of this remote processor
2693  * @rproc: remote processor
2742 	 * be used by the remoteproc drivers to give the remote processor time  in rproc_panic_handler()
2794 MODULE_DESCRIPTION("Generic Remote Processor Framework");