ESP32 esp_err_t error codes

Every ESP_ERR_ code in ESP-IDF, by its hex value as ESP_ERROR_CHECK prints it. Search the page for the number in your log (Cmd+F or Ctrl+F).

ESP_ERROR_CHECK failed: esp_err_t 0x110d (ESP_ERR_NVS_NO_FREE_PAGES) at 0x400d2a4f

In code, esp_err_to_name(err) returns the name, as long as CONFIG_ESP_ERR_TO_NAME_LOOKUP is on (it is by default). Explained in detail: ESP_ERR_NVS_NO_FREE_PAGES, ESP_ERR_NO_MEM, ESP_ERR_INVALID_STATE, ESP_ERR_OTA_VALIDATE_FAILED.

HexDecimalNameMeaning
0x101257ESP_ERR_NO_MEMOut of memory
0x102258ESP_ERR_INVALID_ARGInvalid argument
0x103259ESP_ERR_INVALID_STATEInvalid state
0x104260ESP_ERR_INVALID_SIZEInvalid size
0x105261ESP_ERR_NOT_FOUNDRequested resource not found
0x106262ESP_ERR_NOT_SUPPORTEDOperation or feature not supported
0x107263ESP_ERR_TIMEOUTOperation timed out
0x108264ESP_ERR_INVALID_RESPONSEReceived response was invalid
0x109265ESP_ERR_INVALID_CRCCRC or checksum was invalid
0x10a266ESP_ERR_INVALID_VERSIONVersion was invalid
0x10b267ESP_ERR_INVALID_MACMAC address was invalid
0x10c268ESP_ERR_NOT_FINISHEDOperation has not fully completed
0x10d269ESP_ERR_NOT_ALLOWEDOperation is not allowed
0x11014353ESP_ERR_NVS_NOT_INITIALIZEDThe storage driver is not initialized
0x11024354ESP_ERR_NVS_NOT_FOUNDA requested entry couldn't be found or namespace doesn’t exist yet and mode is NVS_READONLY
0x11034355ESP_ERR_NVS_TYPE_MISMATCHThe type of set or get operation doesn't match the type of value stored in NVS
0x11044356ESP_ERR_NVS_READ_ONLYStorage handle was opened as read only
0x11054357ESP_ERR_NVS_NOT_ENOUGH_SPACEThere is not enough space in the underlying storage to save the value
0x11064358ESP_ERR_NVS_INVALID_NAMENamespace name doesn’t satisfy constraints
0x11074359ESP_ERR_NVS_INVALID_HANDLEHandle has been closed or is NULL
0x11084360ESP_ERR_NVS_REMOVE_FAILEDThe value wasn’t updated because flash write operation has failed. The value was written however, and update will be finished after re-initialization of nvs, provided that flash operation doesn’t fail again.
0x11094361ESP_ERR_NVS_KEY_TOO_LONGKey name is too long
0x110a4362ESP_ERR_NVS_PAGE_FULLInternal error; never returned by nvs API functions
0x110b4363ESP_ERR_NVS_INVALID_STATENVS is in an inconsistent state due to a previous error. Call nvs_flash_init and nvs_open again, then retry.
0x110c4364ESP_ERR_NVS_INVALID_LENGTHString or blob length is not sufficient to store data
0x110d4365ESP_ERR_NVS_NO_FREE_PAGESNVS partition doesn't contain any empty pages. This may happen if NVS partition was truncated. Erase the whole partition and call nvs_flash_init again.
0x110e4366ESP_ERR_NVS_VALUE_TOO_LONGValue doesn't fit into the entry or string or blob length is longer than supported by the implementation
0x110f4367ESP_ERR_NVS_PART_NOT_FOUNDPartition with specified name is not found in the partition table
0x11104368ESP_ERR_NVS_NEW_VERSION_FOUNDNVS partition contains data in new format and cannot be recognized by this version of code
0x11114369ESP_ERR_NVS_XTS_ENCR_FAILEDXTS encryption failed while writing NVS entry
0x11124370ESP_ERR_NVS_XTS_DECR_FAILEDXTS decryption failed while reading NVS entry
0x11134371ESP_ERR_NVS_XTS_CFG_FAILEDXTS configuration setting failed
0x11144372ESP_ERR_NVS_XTS_CFG_NOT_FOUNDXTS configuration not found
0x11154373ESP_ERR_NVS_ENCR_NOT_SUPPORTEDNVS encryption is not supported in this version
0x11164374ESP_ERR_NVS_KEYS_NOT_INITIALIZEDNVS key partition is uninitialized
0x11174375ESP_ERR_NVS_CORRUPT_KEY_PARTNVS key partition is corrupt
0x11184376ESP_ERR_NVS_CONTENT_DIFFERSInternal error; never returned by nvs API functions. NVS key is different in comparison
0x11194377ESP_ERR_NVS_WRONG_ENCRYPTIONNVS partition is marked as encrypted with generic flash encryption. This is forbidden since the NVS encryption works differently.
0x12014609ESP_ERR_ULP_SIZE_TOO_BIGProgram doesn't fit into RTC memory reserved for the ULP
0x12024610ESP_ERR_ULP_INVALID_LOAD_ADDRLoad address is outside of RTC memory reserved for the ULP
0x12034611ESP_ERR_ULP_DUPLICATE_LABELMore than one label with the same number was defined
0x12044612ESP_ERR_ULP_UNDEFINED_LABELBranch instructions references an undefined label
0x12054613ESP_ERR_ULP_BRANCH_OUT_OF_RANGEBranch target is out of range of B instruction (try replacing with BX)
0x15015377ESP_ERR_OTA_PARTITION_CONFLICTError if request was to write or erase the current running partition
0x15025378ESP_ERR_OTA_SELECT_INFO_INVALIDError if OTA data partition contains invalid content
0x15035379ESP_ERR_OTA_VALIDATE_FAILEDError if OTA app image is invalid
0x15045380ESP_ERR_OTA_SMALL_SEC_VERError if the firmware has a secure version less than the running firmware.
0x15055381ESP_ERR_OTA_ROLLBACK_FAILEDError if flash does not have valid firmware in passive partition and hence rollback is not possible
0x15065382ESP_ERR_OTA_ROLLBACK_INVALID_STATEError if current active firmware is still marked in pending validation state (ESP_OTA_IMG_PENDING_VERIFY), essentially first boot of firmware image post upgrade and hence firmware upgrade is not possible
0x16005632ESP_ERR_EFUSEBase error code for efuse api.
0x16015633ESP_OK_EFUSE_CNTOK the required number of bits is set.
0x16025634ESP_ERR_EFUSE_CNT_IS_FULLError field is full.
0x16035635ESP_ERR_EFUSE_REPEATED_PROGError repeated programming of programmed bits is strictly forbidden.
0x16045636ESP_ERR_CODINGError while a encoding operation.
0x16055637ESP_ERR_NOT_ENOUGH_UNUSED_KEY_BLOCKSError not enough unused key blocks available
0x16065638ESP_ERR_DAMAGED_READINGError. Burn or reset was done during a reading operation leads to damage read data. This error is internal to the efuse component and not returned by any public API.
0x20018193ESP_ERR_IMAGE_FLASH_FAIL
0x20028194ESP_ERR_IMAGE_INVALID
0x300112289ESP_ERR_WIFI_NOT_INITWiFi driver was not installed by esp_wifi_init
0x300212290ESP_ERR_WIFI_NOT_STARTEDWiFi driver was not started by esp_wifi_start
0x300312291ESP_ERR_WIFI_NOT_STOPPEDWiFi driver was not stopped by esp_wifi_stop
0x300412292ESP_ERR_WIFI_IFWiFi interface error
0x300512293ESP_ERR_WIFI_MODEWiFi mode error
0x300612294ESP_ERR_WIFI_STATEWiFi internal state error
0x300712295ESP_ERR_WIFI_CONNWiFi internal control block of station or soft-AP error
0x300812296ESP_ERR_WIFI_NVSWiFi internal NVS module error
0x300912297ESP_ERR_WIFI_MACMAC address is invalid
0x300a12298ESP_ERR_WIFI_SSIDSSID is invalid
0x300b12299ESP_ERR_WIFI_PASSWORDPassword is invalid
0x300c12300ESP_ERR_WIFI_TIMEOUTTimeout error
0x300d12301ESP_ERR_WIFI_WAKE_FAILWiFi is in sleep state(RF closed) and wakeup fail
0x300e12302ESP_ERR_WIFI_WOULD_BLOCKThe caller would block
0x300f12303ESP_ERR_WIFI_NOT_CONNECTStation still in disconnect status
0x301212306ESP_ERR_WIFI_POSTFailed to post the event to WiFi task
0x301312307ESP_ERR_WIFI_INIT_STATEInvalid WiFi state when init/deinit is called
0x301412308ESP_ERR_WIFI_STOP_STATEReturned when WiFi is stopping
0x301512309ESP_ERR_WIFI_NOT_ASSOCThe WiFi connection is not associated
0x301612310ESP_ERR_WIFI_TX_DISALLOWThe WiFi TX is disallowed
0x301712311ESP_ERR_WIFI_TWT_FULLno available flow id
0x301812312ESP_ERR_WIFI_TWT_SETUP_TIMEOUTTimeout of receiving twt setup response frame, timeout times can be set during twt setup
0x301912313ESP_ERR_WIFI_TWT_SETUP_TXFAILTWT setup frame tx failed
0x301a12314ESP_ERR_WIFI_TWT_SETUP_REJECTThe twt setup request was rejected by the AP
0x301b12315ESP_ERR_WIFI_DISCARDDiscard frame
0x301c12316ESP_ERR_WIFI_ROC_IN_PROGRESSROC op is in progress
0x303312339ESP_ERR_WIFI_REGISTRARWPS registrar is not supported
0x303412340ESP_ERR_WIFI_WPS_TYPEWPS type error
0x303512341ESP_ERR_WIFI_WPS_SMWPS state machine is not initialized
0x306512389ESP_ERR_ESPNOW_NOT_INITESPNOW is not initialized.
0x306612390ESP_ERR_ESPNOW_ARGInvalid argument
0x306712391ESP_ERR_ESPNOW_NO_MEMOut of memory
0x306812392ESP_ERR_ESPNOW_FULLESPNOW peer list is full
0x306912393ESP_ERR_ESPNOW_NOT_FOUNDESPNOW peer is not found
0x306a12394ESP_ERR_ESPNOW_INTERNALInternal error
0x306b12395ESP_ERR_ESPNOW_EXISTESPNOW peer has existed
0x306c12396ESP_ERR_ESPNOW_IFInterface error
0x306d12397ESP_ERR_ESPNOW_CHANChannel error
0x309712439ESP_ERR_DPP_FAILUREGeneric failure during DPP Operation
0x309812440ESP_ERR_DPP_TX_FAILUREDPP Frame Tx failed OR not Acked
0x309912441ESP_ERR_DPP_INVALID_ATTREncountered invalid DPP Attribute
0x309a12442ESP_ERR_DPP_AUTH_TIMEOUTDPP Auth response was not received in time
0x309b12443ESP_ERR_DPP_INVALID_LISTChannel list given in esp_supp_dpp_bootstrap_gen() is not valid or too big
0x309c12444ESP_ERR_DPP_CONF_TIMEOUTDPP Configuration was not received in time
0x400116385ESP_ERR_MESH_WIFI_NOT_START
0x400216386ESP_ERR_MESH_NOT_INIT
0x400316387ESP_ERR_MESH_NOT_CONFIG
0x400416388ESP_ERR_MESH_NOT_START
0x400516389ESP_ERR_MESH_NOT_SUPPORT
0x400616390ESP_ERR_MESH_NOT_ALLOWED
0x400716391ESP_ERR_MESH_NO_MEMORY
0x400816392ESP_ERR_MESH_ARGUMENT
0x400916393ESP_ERR_MESH_EXCEED_MTU
0x400a16394ESP_ERR_MESH_TIMEOUT
0x400b16395ESP_ERR_MESH_DISCONNECTED
0x400c16396ESP_ERR_MESH_QUEUE_FAIL
0x400d16397ESP_ERR_MESH_QUEUE_FULL
0x400e16398ESP_ERR_MESH_NO_PARENT_FOUND
0x400f16399ESP_ERR_MESH_NO_ROUTE_FOUND
0x401016400ESP_ERR_MESH_OPTION_NULL
0x401116401ESP_ERR_MESH_OPTION_UNKNOWN
0x401216402ESP_ERR_MESH_XON_NO_WINDOW
0x401316403ESP_ERR_MESH_INTERFACE
0x401416404ESP_ERR_MESH_DISCARD_DUPLICATE
0x401516405ESP_ERR_MESH_DISCARD
0x401616406ESP_ERR_MESH_VOTING
0x401716407ESP_ERR_MESH_XMIT
0x401816408ESP_ERR_MESH_QUEUE_READ
0x401916409ESP_ERR_MESH_PS
0x401a16410ESP_ERR_MESH_RECV_RELEASE
0x500120481ESP_ERR_ESP_NETIF_INVALID_PARAMS
0x500220482ESP_ERR_ESP_NETIF_IF_NOT_READY
0x500320483ESP_ERR_ESP_NETIF_DHCPC_START_FAILED
0x500420484ESP_ERR_ESP_NETIF_DHCP_ALREADY_STARTED
0x500520485ESP_ERR_ESP_NETIF_DHCP_ALREADY_STOPPED
0x500620486ESP_ERR_ESP_NETIF_NO_MEM
0x500720487ESP_ERR_ESP_NETIF_DHCP_NOT_STOPPED
0x500820488ESP_ERR_ESP_NETIF_DRIVER_ATTACH_FAILED
0x500920489ESP_ERR_ESP_NETIF_INIT_FAILED
0x500a20490ESP_ERR_ESP_NETIF_DNS_NOT_CONFIGURED
0x500b20491ESP_ERR_ESP_NETIF_MLD6_FAILED
0x500c20492ESP_ERR_ESP_NETIF_IP6_ADDR_FAILED
0x500d20493ESP_ERR_ESP_NETIF_DHCPS_START_FAILED
0x500e20494ESP_ERR_ESP_NETIF_TX_FAILED
0x600124577ESP_ERR_FLASH_OP_FAIL
0x600224578ESP_ERR_FLASH_OP_TIMEOUT
0x600324579ESP_ERR_FLASH_NOT_INITIALISED
0x600424580ESP_ERR_FLASH_UNSUPPORTED_HOST
0x600524581ESP_ERR_FLASH_UNSUPPORTED_CHIP
0x600624582ESP_ERR_FLASH_PROTECTED
0x700128673ESP_ERR_HTTP_MAX_REDIRECTThe error exceeds the number of HTTP redirects
0x700228674ESP_ERR_HTTP_CONNECTError open the HTTP connection
0x700328675ESP_ERR_HTTP_WRITE_DATAError write HTTP data
0x700428676ESP_ERR_HTTP_FETCH_HEADERError read HTTP header from server
0x700528677ESP_ERR_HTTP_INVALID_TRANSPORTThere are no transport support for the input scheme
0x700628678ESP_ERR_HTTP_CONNECTINGHTTP connection hasn't been established yet
0x700728679ESP_ERR_HTTP_EAGAINMapping of errno EAGAIN to esp_err_t
0x700828680ESP_ERR_HTTP_CONNECTION_CLOSEDRead FIN from peer and the connection closed
0x700928681ESP_ERR_HTTP_NOT_MODIFIEDHTTP 304 Not Modified, no update available
0x700a28682ESP_ERR_HTTP_RANGE_NOT_SATISFIABLEHTTP 416 Range Not Satisfiable, requested range in header is incorrect
0x700b28683ESP_ERR_HTTP_READ_TIMEOUTHTTP data read timeout
0x700c28684ESP_ERR_HTTP_INCOMPLETE_DATAIncomplete data received, less than Content-Length or last chunk
0x800132769ESP_ERR_ESP_TLS_CANNOT_RESOLVE_HOSTNAMEError if hostname couldn't be resolved upon tls connection
0x800232770ESP_ERR_ESP_TLS_CANNOT_CREATE_SOCKETFailed to create socket
0x800332771ESP_ERR_ESP_TLS_UNSUPPORTED_PROTOCOL_FAMILYUnsupported protocol family
0x800432772ESP_ERR_ESP_TLS_FAILED_CONNECT_TO_HOSTFailed to connect to host
0x800532773ESP_ERR_ESP_TLS_SOCKET_SETOPT_FAILEDfailed to set/get socket option
0x800632774ESP_ERR_ESP_TLS_CONNECTION_TIMEOUTnew connection in esp_tls_low_level_conn connection timeouted
0x800732775ESP_ERR_ESP_TLS_SE_FAILED
0x800832776ESP_ERR_ESP_TLS_TCP_CLOSED_FIN
0x800932777ESP_ERR_ESP_TLS_SERVER_HANDSHAKE_TIMEOUTTLS handshake timeout
0x801032784ESP_ERR_MBEDTLS_CERT_PARTLY_OKmbedtls parse certificates was partly successful
0x801132785ESP_ERR_MBEDTLS_CTR_DRBG_SEED_FAILEDmbedtls api returned error
0x801232786ESP_ERR_MBEDTLS_SSL_SET_HOSTNAME_FAILEDmbedtls api returned error
0x801332787ESP_ERR_MBEDTLS_SSL_CONFIG_DEFAULTS_FAILEDmbedtls api returned error
0x801432788ESP_ERR_MBEDTLS_SSL_CONF_ALPN_PROTOCOLS_FAILEDmbedtls api returned error
0x801532789ESP_ERR_MBEDTLS_X509_CRT_PARSE_FAILEDmbedtls api returned error
0x801632790ESP_ERR_MBEDTLS_SSL_CONF_OWN_CERT_FAILEDmbedtls api returned error
0x801732791ESP_ERR_MBEDTLS_SSL_SETUP_FAILEDmbedtls api returned error
0x801832792ESP_ERR_MBEDTLS_SSL_WRITE_FAILEDmbedtls api returned error
0x801932793ESP_ERR_MBEDTLS_PK_PARSE_KEY_FAILEDmbedtls api returned failed
0x801a32794ESP_ERR_MBEDTLS_SSL_HANDSHAKE_FAILEDmbedtls api returned failed
0x801b32795ESP_ERR_MBEDTLS_SSL_CONF_PSK_FAILEDmbedtls api returned failed
0x801c32796ESP_ERR_MBEDTLS_SSL_TICKET_SETUP_FAILEDmbedtls api returned failed
0x801d32797ESP_ERR_MBEDTLS_SSL_READ_FAILEDmbedtls api returned failed
0x803132817ESP_ERR_WOLFSSL_SSL_SET_HOSTNAME_FAILEDwolfSSL api returned error
0x803232818ESP_ERR_WOLFSSL_SSL_CONF_ALPN_PROTOCOLS_FAILEDwolfSSL api returned error
0x803332819ESP_ERR_WOLFSSL_CERT_VERIFY_SETUP_FAILEDwolfSSL api returned error
0x803432820ESP_ERR_WOLFSSL_KEY_VERIFY_SETUP_FAILEDwolfSSL api returned error
0x803532821ESP_ERR_WOLFSSL_SSL_HANDSHAKE_FAILEDwolfSSL api returned failed
0x803632822ESP_ERR_WOLFSSL_CTX_SETUP_FAILEDwolfSSL api returned failed
0x803732823ESP_ERR_WOLFSSL_SSL_SETUP_FAILEDwolfSSL api returned failed
0x803832824ESP_ERR_WOLFSSL_SSL_WRITE_FAILEDwolfSSL api returned failed
0x900136865ESP_ERR_HTTPS_OTA_IN_PROGRESS
0xa00140961ESP_ERR_PING_INVALID_PARAMS
0xa00240962ESP_ERR_PING_NO_MEM
0xb00145057ESP_ERR_HTTPD_HANDLERS_FULLAll slots for registering URI handlers have been consumed
0xb00245058ESP_ERR_HTTPD_HANDLER_EXISTSURI handler with same method and target URI already registered
0xb00345059ESP_ERR_HTTPD_INVALID_REQInvalid request pointer
0xb00445060ESP_ERR_HTTPD_RESULT_TRUNCResult string truncated
0xb00545061ESP_ERR_HTTPD_RESP_HDRResponse header field larger than supported
0xb00645062ESP_ERR_HTTPD_RESP_SENDError occurred while sending response packet
0xb00745063ESP_ERR_HTTPD_ALLOC_MEMFailed to dynamically allocate memory for resource
0xb00845064ESP_ERR_HTTPD_TASKFailed to launch server task/thread
0xc00149153ESP_ERR_HW_CRYPTO_DS_HMAC_FAILHMAC peripheral problem
0xc00249154ESP_ERR_HW_CRYPTO_DS_INVALID_KEY
0xc00449156ESP_ERR_HW_CRYPTO_DS_INVALID_DIGEST
0xc00549157ESP_ERR_HW_CRYPTO_DS_INVALID_PADDING
0xd00153249ESP_ERR_MEMPROT_MEMORY_TYPE_INVALID
0xd00253250ESP_ERR_MEMPROT_SPLIT_ADDR_INVALID
0xd00353251ESP_ERR_MEMPROT_SPLIT_ADDR_OUT_OF_RANGE
0xd00453252ESP_ERR_MEMPROT_SPLIT_ADDR_UNALIGNED
0xd00553253ESP_ERR_MEMPROT_UNIMGMT_BLOCK_INVALID
0xd00653254ESP_ERR_MEMPROT_WORLD_INVALID
0xd00753255ESP_ERR_MEMPROT_AREA_INVALID
0xd00853256ESP_ERR_MEMPROT_CPUID_INVALID
0xe00157345ESP_ERR_TCP_TRANSPORT_CONNECTION_TIMEOUTConnection has timed out
0xe00257346ESP_ERR_TCP_TRANSPORT_CONNECTION_CLOSED_BY_FINRead FIN from peer and the connection has closed (in a clean way)
0xe00357347ESP_ERR_TCP_TRANSPORT_CONNECTION_FAILEDFailed to connect to the peer
0xe00457348ESP_ERR_TCP_TRANSPORT_NO_MEMMemory allocation failed
0xf00161441ESP_ERR_NVS_SEC_HMAC_KEY_NOT_FOUNDHMAC Key required to generate the NVS encryption keys not found
0xf00261442ESP_ERR_NVS_SEC_HMAC_KEY_BLK_ALREADY_USEDProvided eFuse block for HMAC key generation is already in use
0xf00361443ESP_ERR_NVS_SEC_HMAC_KEY_GENERATION_FAILEDFailed to generate/write the HMAC key to eFuse
0xf00461444ESP_ERR_NVS_SEC_HMAC_XTS_KEYS_DERIV_FAILEDFailed to derive the NVS encryption keys based on the HMAC-based scheme

Related errors: ESP_ERR_NVS_NO_FREE_PAGES · ESP_ERR_NO_MEM · WiFi disconnect reasons. All ESP32 errors: the list. All codes from ESP-IDF 5.5.3's headers, as esp_err_to_name knows them. ESP-IDF's Error Handling guide.

More