From 6db28351eac118ecad81aca27b0b759bd99fc191 Mon Sep 17 00:00:00 2001 From: Cornelius Claussen Date: Tue, 1 Oct 2024 09:06:02 +0200 Subject: [PATCH] dc_power_supply intf: Improve description Signed-off-by: Cornelius Claussen --- interfaces/power_supply_DC.yaml | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/interfaces/power_supply_DC.yaml b/interfaces/power_supply_DC.yaml index 6f2ba9717..cecb3a327 100644 --- a/interfaces/power_supply_DC.yaml +++ b/interfaces/power_supply_DC.yaml @@ -12,7 +12,15 @@ description: >- (e.g. communication to the hardware is lost), the driver module shall cache the last mode and voltage/current settings. Once the PSU is back on-line (e.g. after a CommunicationFault), set the last mode and voltage/current value received and only after that clear the error. - 3) var voltage_current shall be published on regular intervals. The interval depends on the hardware, but it shall be at least once per second. If possible, + 3) setMode to Off requires special attention. To avoid switching the output relays of the charger off under full load, make sure to return + from the setMode function(Off) only when the current is below a safe threshold for switching off the relays (exact value is hardware dependent). + If communication is lost with the power supply, make sure to still return, the call must not block for a longer period of time. + EVerest will ensure the order of the calls is correct during shutdown, but will not wait for the power supply to actually turn off: + 1. call setMode(Off) on power_supply_DC + 2. call allow_power_on(false) on evse_board_support + If the setMode(Off) returns immediately, it may happen that the bsp implementation opens the relays before the power supply is shutdown. + + 4) var voltage_current shall be published on regular intervals. The interval depends on the hardware, but it shall be at least once per second. If possible, update at e.g. 4 Hertz is recommended. cmds: setMode: