105 lines
		
	
	
		
			3.3 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
			
		
		
	
	
			105 lines
		
	
	
		
			3.3 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
What:		/sys/class/remoteproc/.../firmware
 | 
						|
Date:		October 2016
 | 
						|
Contact:	Matt Redfearn <matt.redfearn@mips.com>
 | 
						|
Description:	Remote processor firmware
 | 
						|
 | 
						|
		Reports the name of the firmware currently loaded to the
 | 
						|
		remote processor.
 | 
						|
 | 
						|
		To change the running firmware, ensure the remote processor is
 | 
						|
		stopped (using /sys/class/remoteproc/.../state) and write a new filename.
 | 
						|
 | 
						|
What:		/sys/class/remoteproc/.../state
 | 
						|
Date:		October 2016
 | 
						|
Contact:	Matt Redfearn <matt.redfearn@mips.com>
 | 
						|
Description:	Remote processor state
 | 
						|
 | 
						|
		Reports the state of the remote processor, which will be one of:
 | 
						|
 | 
						|
		- "offline"
 | 
						|
		- "suspended"
 | 
						|
		- "running"
 | 
						|
		- "crashed"
 | 
						|
		- "invalid"
 | 
						|
 | 
						|
		"offline" means the remote processor is powered off.
 | 
						|
 | 
						|
		"suspended" means that the remote processor is suspended and
 | 
						|
		must be woken to receive messages.
 | 
						|
 | 
						|
		"running" is the normal state of an available remote processor
 | 
						|
 | 
						|
		"crashed" indicates that a problem/crash has been detected on
 | 
						|
		the remote processor.
 | 
						|
 | 
						|
		"invalid" is returned if the remote processor is in an
 | 
						|
		unknown state.
 | 
						|
 | 
						|
		Writing this file controls the state of the remote processor.
 | 
						|
		The following states can be written:
 | 
						|
 | 
						|
		- "start"
 | 
						|
		- "stop"
 | 
						|
 | 
						|
		Writing "start" will attempt to start the processor running the
 | 
						|
		firmware indicated by, or written to,
 | 
						|
		/sys/class/remoteproc/.../firmware. The remote processor should
 | 
						|
		transition to "running" state.
 | 
						|
 | 
						|
		Writing "stop" will attempt to halt the remote processor and
 | 
						|
		return it to the "offline" state.
 | 
						|
 | 
						|
What:		/sys/class/remoteproc/.../name
 | 
						|
Date:		August 2019
 | 
						|
KernelVersion:	5.4
 | 
						|
Contact:	Suman Anna <s-anna@ti.com>
 | 
						|
Description:	Remote processor name
 | 
						|
 | 
						|
		Reports the name of the remote processor. This can be used by
 | 
						|
		userspace in exactly identifying a remote processor and ease
 | 
						|
		up the usage in modifying the 'firmware' or 'state' files.
 | 
						|
 | 
						|
What:		/sys/class/remoteproc/.../coredump
 | 
						|
Date:		July 2020
 | 
						|
Contact:	Bjorn Andersson <bjorn.andersson@linaro.org>, Ohad Ben-Cohen <ohad@wizery.com>
 | 
						|
Description:	Remote processor coredump configuration
 | 
						|
 | 
						|
		Reports the coredump configuration of the remote processor,
 | 
						|
		which will be one of:
 | 
						|
 | 
						|
		"disabled"
 | 
						|
		"enabled"
 | 
						|
		"inline"
 | 
						|
 | 
						|
		"disabled" means no dump will be collected.
 | 
						|
 | 
						|
		"enabled" means when the remote processor's coredump is
 | 
						|
		collected it will be copied to a separate buffer and that
 | 
						|
		buffer is exposed to userspace.
 | 
						|
 | 
						|
		"inline" means when the remote processor's coredump is
 | 
						|
		collected userspace will directly read from the remote
 | 
						|
		processor's device memory. Extra buffer will not be used to
 | 
						|
		copy the dump. Also recovery process will not proceed until
 | 
						|
		all data is read by usersapce.
 | 
						|
 | 
						|
What:		/sys/class/remoteproc/.../recovery
 | 
						|
Date:		July 2020
 | 
						|
Contact:	Bjorn Andersson <bjorn.andersson@linaro.org>, Ohad Ben-Cohen <ohad@wizery.com>
 | 
						|
Description:	Remote processor recovery mechanism
 | 
						|
 | 
						|
		Reports the recovery mechanism of the remote processor,
 | 
						|
		which will be one of:
 | 
						|
 | 
						|
		"enabled"
 | 
						|
		"disabled"
 | 
						|
 | 
						|
		"enabled" means, the remote processor will be automatically
 | 
						|
		recovered whenever it crashes. Moreover, if the remote
 | 
						|
		processor crashes while recovery is disabled, it will
 | 
						|
		be automatically recovered too as soon as recovery is enabled.
 | 
						|
 | 
						|
		"disabled" means, a remote processor will remain in a crashed
 | 
						|
		state if it crashes. This is useful for debugging purposes;
 | 
						|
		without it, debugging a crash is substantially harder.
 |