Página Principal Explorar Ajuda
Iniciar Sessão
RT-Thread-packages
/
esp-idf
mirror de https://github-proxy.rt-thread.io/RT-Thread-packages/esp-idf.git
2
0
Fork 0
Ficheiros Problemas 0 Wiki
Ramo: master
Ramos Etiquetas
esp-idf
/
components
/
esp-tls
/
esp_tls_errors.h

esp_tls_errors.h 6.3 KB
Link permanente Histórico Em bruto

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103 
  1. /*
    2. 

  2.  * SPDX-FileCopyrightText: 2021-22 Espressif Systems (Shanghai) CO LTD
    3. 

  3.  *
    4. 

  4.  * SPDX-License-Identifier: Apache-2.0
    5. 

  5.  */
    6. 

  6. 

  7. #ifndef _ESP_TLS_ERRORS_H_
    8. 

  8. #define _ESP_TLS_ERRORS_H_
    9. 

  9. 

  10. #include "esp_err.h"
    11. 

  11. #ifdef CONFIG_ESP_TLS_USING_MBEDTLS
    12. 

  12. #include "mbedtls/error.h"
    13. 

  13. #endif
    14. 

  14. /* For wolfSSL, errors are included through ssl.h which is included by default by esp_tls.h */
    15. 

  15. 

  16. #ifdef __cplusplus
    17. 

  17. extern "C" {
    18. 

  18. #endif
    19. 

  19. 

  20. #define ESP_ERR_ESP_TLS_BASE           0x8000             /*!< Starting number of ESP-TLS error codes */
    21. 

  21. 

  22. /* generic esp-tls error codes */
    23. 

  23. #define ESP_ERR_ESP_TLS_CANNOT_RESOLVE_HOSTNAME           (ESP_ERR_ESP_TLS_BASE + 0x01)  /*!< Error if hostname couldn't be resolved upon tls connection */
    24. 

  24. #define ESP_ERR_ESP_TLS_CANNOT_CREATE_SOCKET              (ESP_ERR_ESP_TLS_BASE + 0x02)  /*!< Failed to create socket */
    25. 

  25. #define ESP_ERR_ESP_TLS_UNSUPPORTED_PROTOCOL_FAMILY       (ESP_ERR_ESP_TLS_BASE + 0x03)  /*!< Unsupported protocol family */
    26. 

  26. #define ESP_ERR_ESP_TLS_FAILED_CONNECT_TO_HOST            (ESP_ERR_ESP_TLS_BASE + 0x04)  /*!< Failed to connect to host */
    27. 

  27. #define ESP_ERR_ESP_TLS_SOCKET_SETOPT_FAILED              (ESP_ERR_ESP_TLS_BASE + 0x05)  /*!< failed to set/get socket option */
    28. 

  28. #define ESP_ERR_ESP_TLS_CONNECTION_TIMEOUT                (ESP_ERR_ESP_TLS_BASE + 0x06)  /*!< new connection in esp_tls_low_level_conn connection timeouted */
    29. 

  29. #define ESP_ERR_ESP_TLS_SE_FAILED                         (ESP_ERR_ESP_TLS_BASE + 0x07)  /*< esp-tls use Secure Element returned failed */
    30. 

  30. #define ESP_ERR_ESP_TLS_TCP_CLOSED_FIN                    (ESP_ERR_ESP_TLS_BASE + 0x08)  /*< esp-tls's TPC transport connection has benn closed (in a clean way) */
    31. 

  31. 

  32. /* mbedtls specific error codes */
    33. 

  33. #define ESP_ERR_MBEDTLS_CERT_PARTLY_OK                    (ESP_ERR_ESP_TLS_BASE + 0x10)  /*!< mbedtls parse certificates was partly successful */
    34. 

  34. #define ESP_ERR_MBEDTLS_CTR_DRBG_SEED_FAILED              (ESP_ERR_ESP_TLS_BASE + 0x11)  /*!< mbedtls api returned error */
    35. 

  35. #define ESP_ERR_MBEDTLS_SSL_SET_HOSTNAME_FAILED           (ESP_ERR_ESP_TLS_BASE + 0x12)  /*!< mbedtls api returned error */
    36. 

  36. #define ESP_ERR_MBEDTLS_SSL_CONFIG_DEFAULTS_FAILED        (ESP_ERR_ESP_TLS_BASE + 0x13)  /*!< mbedtls api returned error */
    37. 

  37. #define ESP_ERR_MBEDTLS_SSL_CONF_ALPN_PROTOCOLS_FAILED    (ESP_ERR_ESP_TLS_BASE + 0x14)  /*!< mbedtls api returned error */
    38. 

  38. #define ESP_ERR_MBEDTLS_X509_CRT_PARSE_FAILED             (ESP_ERR_ESP_TLS_BASE + 0x15)  /*!< mbedtls api returned error */
    39. 

  39. #define ESP_ERR_MBEDTLS_SSL_CONF_OWN_CERT_FAILED          (ESP_ERR_ESP_TLS_BASE + 0x16)  /*!< mbedtls api returned error */
    40. 

  40. #define ESP_ERR_MBEDTLS_SSL_SETUP_FAILED                  (ESP_ERR_ESP_TLS_BASE + 0x17)  /*!< mbedtls api returned error */
    41. 

  41. #define ESP_ERR_MBEDTLS_SSL_WRITE_FAILED                  (ESP_ERR_ESP_TLS_BASE + 0x18)  /*!< mbedtls api returned error */
    42. 

  42. #define ESP_ERR_MBEDTLS_PK_PARSE_KEY_FAILED               (ESP_ERR_ESP_TLS_BASE + 0x19)  /*!< mbedtls api returned failed  */
    43. 

  43. #define ESP_ERR_MBEDTLS_SSL_HANDSHAKE_FAILED              (ESP_ERR_ESP_TLS_BASE + 0x1A)  /*!< mbedtls api returned failed  */
    44. 

  44. #define ESP_ERR_MBEDTLS_SSL_CONF_PSK_FAILED               (ESP_ERR_ESP_TLS_BASE + 0x1B)  /*!< mbedtls api returned failed  */
    45. 

  45. #define ESP_ERR_MBEDTLS_SSL_TICKET_SETUP_FAILED           (ESP_ERR_ESP_TLS_BASE + 0x1C)  /*!< mbedtls api returned failed  */
    46. 

  46. 

  47. /* wolfssl specific error codes */
    48. 

  48. #define ESP_ERR_WOLFSSL_SSL_SET_HOSTNAME_FAILED           (ESP_ERR_ESP_TLS_BASE + 0x31)  /*!< wolfSSL api returned error */
    49. 

  49. #define ESP_ERR_WOLFSSL_SSL_CONF_ALPN_PROTOCOLS_FAILED    (ESP_ERR_ESP_TLS_BASE + 0x32)  /*!< wolfSSL api returned error */
    50. 

  50. #define ESP_ERR_WOLFSSL_CERT_VERIFY_SETUP_FAILED          (ESP_ERR_ESP_TLS_BASE + 0x33)  /*!< wolfSSL api returned error */
    51. 

  51. #define ESP_ERR_WOLFSSL_KEY_VERIFY_SETUP_FAILED           (ESP_ERR_ESP_TLS_BASE + 0x34)  /*!< wolfSSL api returned error */
    52. 

  52. #define ESP_ERR_WOLFSSL_SSL_HANDSHAKE_FAILED              (ESP_ERR_ESP_TLS_BASE + 0x35)  /*!< wolfSSL api returned failed  */
    53. 

  53. #define ESP_ERR_WOLFSSL_CTX_SETUP_FAILED                  (ESP_ERR_ESP_TLS_BASE + 0x36)  /*!< wolfSSL api returned failed */
    54. 

  54. #define ESP_ERR_WOLFSSL_SSL_SETUP_FAILED                  (ESP_ERR_ESP_TLS_BASE + 0x37)  /*!< wolfSSL api returned failed */
    55. 

  55. #define ESP_ERR_WOLFSSL_SSL_WRITE_FAILED                  (ESP_ERR_ESP_TLS_BASE + 0x38)  /*!< wolfSSL api returned failed */
    56. 

  56. 

  57. 

  58. /**
    59. 

  59. * Definition of errors reported from IO API (potentially non-blocking) in case of error:
    60. 

  60. * - esp_tls_conn_read()
    61. 

  61. * - esp_tls_conn_write()
    62. 

  62. */
    63. 

  63. #ifdef CONFIG_ESP_TLS_USING_MBEDTLS
    64. 

  64. #define ESP_TLS_ERR_SSL_WANT_READ                          MBEDTLS_ERR_SSL_WANT_READ
    65. 

  65. #define ESP_TLS_ERR_SSL_WANT_WRITE                         MBEDTLS_ERR_SSL_WANT_WRITE
    66. 

  66. #define ESP_TLS_ERR_SSL_TIMEOUT                            MBEDTLS_ERR_SSL_TIMEOUT
    67. 

  67. #elif CONFIG_ESP_TLS_USING_WOLFSSL /* CONFIG_ESP_TLS_USING_MBEDTLS */
    68. 

  68. #define ESP_TLS_ERR_SSL_WANT_READ                          -0x6900
    69. 

  69. #define ESP_TLS_ERR_SSL_WANT_WRITE                         -0x6880
    70. 

  70. #define ESP_TLS_ERR_SSL_TIMEOUT                            WOLFSSL_CBIO_ERR_TIMEOUT
    71. 

  71. #endif /*CONFIG_ESP_TLS_USING_WOLFSSL */
    72. 

  72. 

  73. /**
    74. 

  74. * Definition of different types/sources of error codes reported
    75. 

  75. * from different components
    76. 

  76. */
    77. 

  77. typedef enum {
    78. 

  78.     ESP_TLS_ERR_TYPE_UNKNOWN = 0,
    79. 

  79.     ESP_TLS_ERR_TYPE_SYSTEM,                /*!< System error -- errno */
    80. 

  80.     ESP_TLS_ERR_TYPE_MBEDTLS,               /*!< Error code from mbedTLS library */
    81. 

  81.     ESP_TLS_ERR_TYPE_MBEDTLS_CERT_FLAGS,    /*!< Certificate flags defined in mbedTLS */
    82. 

  82.     ESP_TLS_ERR_TYPE_ESP,                   /*!< ESP-IDF error type -- esp_err_t  */
    83. 

  83.     ESP_TLS_ERR_TYPE_WOLFSSL,               /*!< Error code from wolfSSL library */
    84. 

  84.     ESP_TLS_ERR_TYPE_WOLFSSL_CERT_FLAGS,    /*!< Certificate flags defined in wolfSSL */
    85. 

  85.     ESP_TLS_ERR_TYPE_MAX,                   /*!< Last err type -- invalid entry */
    86. 

  86. } esp_tls_error_type_t;
    87. 

  87. 

  88. typedef struct esp_tls_last_error* esp_tls_error_handle_t;
    89. 

  89. 

  90. /**
    91. 

  91. *  @brief Error structure containing relevant errors in case tls error occurred
    92. 

  92. */
    93. 

  93. typedef struct esp_tls_last_error {
    94. 

  94.     esp_err_t last_error;               /*!< error code (based on ESP_ERR_ESP_TLS_BASE) of the last occurred error */
    95. 

  95.     int       esp_tls_error_code;       /*!< esp_tls error code from last esp_tls failed api */
    96. 

  96.     int       esp_tls_flags;            /*!< last certification verification flags */
    97. 

  97. } esp_tls_last_error_t;
    98. 

  98. 

  99. #ifdef __cplusplus
    100. 

  100. }
    101. 

  101. #endif
    102. 

  102. 

  103. #endif //_ESP_TLS_ERRORS_H_
    104.