.. _everest_modules_EvseSlac:

########
EvseSlac
########
| Implementation of SLAC data link negotiation according to ISO15118-3.


For a detailed handwritten documentation see :ref:`here <everest_modules_handwritten_EvseSlac>`


********
Provides
********
| **main**::ref:`slac <everest_interfaces_slac>`
|  SLAC interface implementation.
|  config:
|   device:
|    description:Ethernet device used for PLC.
|    type:string
|    default:eth1
|   number_of_sounds:
|    description:SLAC number of sounds.
|    type:integer
|   ac_mode_five_percent:
|    description:Use 5% mode in AC (true). Set to false for DC. The only difference is the handling of retries.
|    type:boolean
|   set_key_timeout_ms:
|    description:Timeout for CM_SET_KEY.REQ. Default works for QCA7000/QCA7005/CG5317.
|    type:integer
|   sounding_attenuation_adjustment:
|    description:Offset in dB that should be added to the calculated sounding attenuation
|    type:integer
|   publish_mac_on_match_cnf:
|    description:Publish the EV MAC address on the token_provider interface when matching is confirmed (CM_SLAC_MATCH.CNF). This can be used for autocharge as an alternative to the EVCCID derived from HLC and published by EvseManager.  This can be used for AC autocharge on cars that do not support actual HLC on AC.
|    type:boolean
|   publish_mac_on_first_parm_req:
|    description:Publish the EV MAC address when the first CM_SLAC_PARM.REQ. This should not be used as it is quite error prone: The MAC address might be from another car via cross talk. It is better to wait for the matching to be done.
|    type:boolean
|   do_chip_reset:
|    description:Perform a chip reset after setting NMK using the RS_DEV.REQ Vendor MME Extension (Only works on Qualcomm chips)
|    type:boolean
|   chip_reset_delay_ms:
|    description:Delay between SET_KEY.CNF and RS_DEV.REQ
|    type:integer
|   chip_reset_timeout_ms:
|    description:Timeout for RS_DEV.REQ (waiting for RS_DEV.CNF)
|    type:integer
|   link_status_detection:
|    description:After matching.cnf, wait for link to come up before sending out d_link_ready=connected using LINK_STATUS Vendor MME Extension (Works on Qualcomm and Lumissil chips)
|    type:boolean
|   link_status_retry_ms:
|    description:Delay between retries of LINK_STATUS requests after matching request
|    type:integer
|   link_status_timeout_ms:
|    description:Timeout for Link to come up after matching request
|    type:integer
|   debug_simulate_failed_matching:
|    description:Only for debugging. Simulate failed matching by sending a wrong NMK to the EV.
|    type:boolean
|  config:
|   **device**:*string* <optional>
|   *default: "eth1"*
|    Ethernet device used for PLC.
|   **number_of_sounds**:*integer* <optional>
|   *default: 10*
|    SLAC number of sounds.
|   **ac_mode_five_percent**:*boolean* <optional>
|   *default: False*
|    Use 5% mode in AC (true). Set to false for DC. The only difference is the handling of retries.
|   **set_key_timeout_ms**:*integer* <optional>
|   *default: 1000*
|    Timeout for CM_SET_KEY.REQ. Default works for QCA7000/QCA7005/CG5317.
|   **sounding_attenuation_adjustment**:*integer* <optional>
|   *default: 0*
|    Offset in dB that should be added to the calculated sounding attenuation
|   **publish_mac_on_match_cnf**:*boolean* <optional>
|   *default: True*
|    Publish the EV MAC address on the token_provider interface when matching is confirmed (CM_SLAC_MATCH.CNF). This can be used for autocharge as an alternative to the EVCCID derived from HLC and published by EvseManager.  This can be used for AC autocharge on cars that do not support actual HLC on AC.
|   **publish_mac_on_first_parm_req**:*boolean* <optional>
|   *default: False*
|    Publish the EV MAC address when the first CM_SLAC_PARM.REQ. This should not be used as it is quite error prone: The MAC address might be from another car via cross talk. It is better to wait for the matching to be done.
|   **do_chip_reset**:*boolean* <optional>
|   *default: False*
|    Perform a chip reset after setting NMK using the RS_DEV.REQ Vendor MME Extension (Only works on Qualcomm chips)
|   **chip_reset_delay_ms**:*integer* <optional>
|   *default: 100*
|    Delay between SET_KEY.CNF and RS_DEV.REQ
|   **chip_reset_timeout_ms**:*integer* <optional>
|   *default: 500*
|    Timeout for RS_DEV.REQ (waiting for RS_DEV.CNF)
|   **link_status_detection**:*boolean* <optional>
|   *default: False*
|    After matching.cnf, wait for link to come up before sending out d_link_ready=connected using LINK_STATUS Vendor MME Extension (Works on Qualcomm and Lumissil chips)
|   **link_status_retry_ms**:*integer* <optional>
|   *default: 100*
|    Delay between retries of LINK_STATUS requests after matching request
|   **link_status_timeout_ms**:*integer* <optional>
|   *default: 10000*
|    Timeout for Link to come up after matching request
|   **debug_simulate_failed_matching**:*boolean* <optional>
|   *default: False*
|    Only for debugging. Simulate failed matching by sending a wrong NMK to the EV.


********
Metadata
********
Authors
=======
| aw@pionix.de
| Cornelius Claussen (Pionix GmbH)

License
=======
| https://opensource.org/licenses/Apache-2.0

Misc
====
|  base_license:https://directory.fsf.org/wiki/License:BSD-3-Clause-Clear