ESP32: New feature: EspError exception - #6638

// Example how to raise ESP exception from C code

#include "esp_error.h"

ESP_EXCEPTIONS(pcnt_event_disable(self->unit, evt_type))

// is equivalent to

esp_err_t err = pcnt_event_disable(self->unit, evt_type);
if (err != ESP_OK)
    mp_raise_EspError(err);

#print('dir(EspError) =', dir(EspError))
print('1. help(EspError) =', help(EspError))
print('')
print('2. EspError.ESP_ERR_INVALID_ARG =', EspError.ESP_ERR_INVALID_ARG)
print('')
print('3. EspError.err_to_name(EspError(), EspError.ESP_FAIL) =', EspError.err_to_name(EspError(), EspError.ESP_FAIL))
print('')
print('4. EspError.err_to_name(e, 0x1205) =', EspError.err_to_name(EspError(), 0x1205))
print('')

#raise EspError()
#raise EspError(EspError.ESP_ERR_INVALID_SIZE)
#raise EspError(EspError.ESP_ERR_INVALID_ARG, '0x%X - ESP_ERR_INVALID_ARG' % EspError.ESP_ERR_INVALID_ARG)

try:
    raise EspError(EspError.ESP_ERR_INVALID_RESPONSE)

except EspError as e:
    print('5. EspError.err_to_name(e, e.args[0])=', EspError.err_to_name(e, e.args[0]))

>>> %Run -c $EDITOR_CONTENT -f esp_err
object <class 'EspError'> is of type type
  ESP_ERR_INVALID_ARG -- 258
  ESP_ERR_INVALID_CRC -- 265
  ESP_ERR_INVALID_MAC -- 267
  ESP_ERR_INVALID_RESPONSE -- 264
  ESP_ERR_INVALID_SIZE -- 260
  ESP_ERR_INVALID_STATE -- 259
  ESP_ERR_INVALID_VERSION -- 266
  ESP_ERR_MESH_BASE -- 16384
  ESP_ERR_NOT_FOUND -- 261
  ESP_ERR_NOT_SUPPORTED -- 262
  ESP_ERR_NO_MEM -- 257
  ESP_ERR_TIMEOUT -- 263
  ESP_ERR_WIFI_BASE -- 12288
  ESP_FAIL -- -1
  ESP_OK -- 0
  err_to_name -- <function>
1. help(EspError) = None

2. EspError.ESP_ERR_INVALID_ARG = 258

3. EspError.err_to_name(EspError(), EspError.ESP_FAIL) = ESP_FAIL

4. EspError.err_to_name(e, 0x1205) = ESP_ERR_ULP_BRANCH_OUT_OF_RANGE

5. EspError.err_to_name(e, e.args[0])= ESP_ERR_INVALID_RESPONSE
>>>