SDP
+++

.. admonition:: Description.
   :class: seealso

   Used to setup TCP/TLS server when Josev's UDP server is disabled. The request includes the evse_id and the requested server to be setup (tls/no_tls).
   The response indicates the details of the tls/tcp server (if successful). This includes the details required build the SDP response - ip address, port and security.
   An empty payload with just the evse_id is returned if setting up the server was not successful.

   .. warning::
      This message is to be used only if Josev pro's UDP server is disabled.

.. jsonschema:: ../../../mqtt_api/schemas/SdpRequest.json
   :hide_key: /**/additionalProperties

Example::

    message = {
        "id": "2b0aa109-21a1-4f2f-bdbd-6cdf139e7bb1",
        "name": "sdp",
        "type": "request",
        "data": {
            "evse_id": "GB*SEV*E123456789",
            "security": "no_tls" # or "tls"
            }
    }

.. jsonschema:: ../../../mqtt_api/schemas/SdpResponse.json
   :hide_key: /**/additionalProperties

Example::

    message = {
        "id": "2b0aa109-21a1-4f2f-bdbd-6cdf139e7bb1",
        "name": "sdp",
        "type": "response",
        "data": {
            "evse_id": "GB*SEV*E123456789",
            "ip_address": "fe80::8bc:79df:3848:6eda",
            "port": "5891",
            "security": "no_tls",
        }
    }

    message = {
        "id": "2b0aa109-21a1-4f2f-bdbd-6cdf139e7bb1",
        "name": "sdp",
        "type": "response",
        "data": {
            "evse_id": "GB*SEV*E123456789",
            "error": "Error creating server:" # Optional - will be present if TLS/TCP server couldn't be created.
        }
    }

--------