| Message ID | 20231026144824.4065145-5-o.rempel@pengutronix.de |
|---|---|
| State | Not Applicable |
| Headers | show |
| Series | regulator: add under-voltage support (part 2) | expand |
| Context | Check | Description |
|---|---|---|
| robh/patch-applied | success | |
| robh/checkpatch | success | |
| robh/dtbs-check | warning | build log |
| robh/dt-meta-schema | success |
On Thu, 26 Oct 2023 16:48:23 +0200, Oleksij Rempel wrote: > Introduces a new devicetree property to specifies the time window (in > milliseconds) following a critical under-voltage (UV) event during which > less critical actions can be safely carried out by the system. > > Less Critical Actions: > - Logging the under-voltage event for later analysis. > - Saving less critical data that may be useful for diagnosing issues or > for audit purposes. > > More Critical Actions (post the less critical window): > - Initiating procedures to properly shutdown hardware to prevent damage. > > The 'regulator-uv-less-critical-window-ms' property is crucial for > conveying board-specific hardware characteristics, not for enforcing a > certain policy. The time window represented by this property is derived > from the physical attributes of the hardware like the capacity of > on-board capacitors, the power consumption of the components, and the > time needed to safely shut down hardware to prevent damage. These > attributes can significantly vary between different boards, making it a > board-specific property rather than a policy directive. > > By providing a precise representation of the time available for less > critical actions post an under-voltage event, this property enables the > kernel to make informed decisions on action prioritization, ensuring > that essential preventative measures are taken to avoid hardware damage > while also allowing for data capture and analysis. > > Signed-off-by: Oleksij Rempel <o.rempel@pengutronix.de> > --- > .../devicetree/bindings/regulator/regulator.yaml | 8 ++++++++ > 1 file changed, 8 insertions(+) > Acked-by: Rob Herring <robh@kernel.org>
diff --git a/Documentation/devicetree/bindings/regulator/regulator.yaml b/Documentation/devicetree/bindings/regulator/regulator.yaml index 5b8d55f7c43b..1ef380d1515e 100644 --- a/Documentation/devicetree/bindings/regulator/regulator.yaml +++ b/Documentation/devicetree/bindings/regulator/regulator.yaml @@ -186,6 +186,14 @@ properties: be enabled but limit setting can be omitted. Limit is given as microvolt offset from voltage set to regulator. + regulator-uv-less-critical-window-ms: + description: Specifies the time window (in milliseconds) following a + critical under-voltage event during which the system can continue to + operate safely while performing less critical operations. This property + provides a defined duration before a more severe reaction to the + under-voltage event is needed, allowing for certain non-urgent actions to + be carried out in preparation for potential power loss. + regulator-temp-protection-kelvin: description: Set over temperature protection limit. This is a limit where hardware performs emergency shutdown. Zero can be passed to disable
Introduces a new devicetree property to specifies the time window (in milliseconds) following a critical under-voltage (UV) event during which less critical actions can be safely carried out by the system. Less Critical Actions: - Logging the under-voltage event for later analysis. - Saving less critical data that may be useful for diagnosing issues or for audit purposes. More Critical Actions (post the less critical window): - Initiating procedures to properly shutdown hardware to prevent damage. The 'regulator-uv-less-critical-window-ms' property is crucial for conveying board-specific hardware characteristics, not for enforcing a certain policy. The time window represented by this property is derived from the physical attributes of the hardware like the capacity of on-board capacitors, the power consumption of the components, and the time needed to safely shut down hardware to prevent damage. These attributes can significantly vary between different boards, making it a board-specific property rather than a policy directive. By providing a precise representation of the time available for less critical actions post an under-voltage event, this property enables the kernel to make informed decisions on action prioritization, ensuring that essential preventative measures are taken to avoid hardware damage while also allowing for data capture and analysis. Signed-off-by: Oleksij Rempel <o.rempel@pengutronix.de> --- .../devicetree/bindings/regulator/regulator.yaml | 8 ++++++++ 1 file changed, 8 insertions(+)