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.
|