Skip to content

Commit c00a511

Browse files
committed
Reword the feedback open/close time description
Signed-off-by: Michael Heimpold <michael.heimpold@chargebyte.com>
1 parent 9b7d3a0 commit c00a511

1 file changed

Lines changed: 10 additions & 10 deletions

File tree

docs/source/safety_controller_parameterization.rst

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -93,8 +93,8 @@ The range for `resistance-offset` is -32.0 Ω ... 32.0 Ω and these values are s
9393
Contactor and Contactor Feedback Configuration
9494
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
9595

96-
The safety controller allows to control up to 3 high-voltage contactors and can monitor corresponding mirror contacts.
97-
The mirror contacts support `Normally Closed` and `Normally Open` semantic, but customer must follow chargebyte's
96+
The safety controller allows to control up to 3 high-voltage contactors and can monitor corresponding feedback contacts.
97+
The feedback contacts support `Normally Closed` and `Normally Open` semantic, but customer must follow chargebyte's
9898
Charge SOM's EVB reference design otherwise the logic might be inverted.
9999

100100
.. figure:: _static/images/charge_som_contactor_feedback_evb-circuit.drawio.svg
@@ -103,10 +103,10 @@ Charge SOM's EVB reference design otherwise the logic might be inverted.
103103
Simplified Reference Circuit used on Charge SOM's EVB for Contactor Feedback Signal
104104

105105
In the YAML parameterization, it is possible to specify whether the safety controller should actually switch the
106-
corresponding output pin and whether to monitor the feedback input pins. When using the feedback, it is usually also
107-
required to specify the open and closing times of the used contactor. These times are expected in milliseconds and
108-
used by the Safety Firmware to check after the given time whether the feedback pin has expected level. If the level
109-
differs from the expectation, then Safety Firmware assumes a malfunction and thus enters safe state.
106+
corresponding output pin and whether to monitor the feedback input pins. When using the feedback, it is also
107+
required to specify the opening and closing times of the used contactor. These times are expected in milliseconds and
108+
used by the safety firmware to check after the given time whether the feedback pin has the expected level. If the level
109+
differs from the expectation, then the safety firmware assumes a malfunction and thus enters safe state.
110110

111111
The example YAML file above shows all allowed variants how to parameterize a contactor.
112112
Possible values for the `type` are:
@@ -118,11 +118,11 @@ Possible values for the `type` are:
118118

119119
Since the open/close timings make no sense in case of `disabled` or `without-feedback`, it is possible to use these
120120
tokens directly as array item (actually, it is also possible to use the `with-feedback...` ones, but then the timings
121-
are considered zero which will result in an error due to the latency in the contactor).
121+
are considered zero which will result in an error due to the physical latency in the contactor).
122122

123-
Both `close-time` and `open-time` accept integer values in the range 0 to 2550 ms, however the given value is
124-
divided by 10 before it is actually stored internally.
125-
(This division by 10 is necessary because the safety controller operates with internal time slots of 10 ms.)
123+
Both `close-time` and `open-time` accept integer values in the range 10 to 2550 ms. Internally, the
124+
safety controller operates with time slots of 10 ms, so the last digit of the given integer is just discarded.
125+
(In other words, the given integer is integer-divided by 10 before it is stored in the parameter block.)
126126

127127

128128
Emergency Input Configuration

0 commit comments

Comments
 (0)