Error codes

Errors related to hardware

Code Name Description
0x0501 ps_store_full Flash reserved for PS store is full
0x0502 ps_key_not_found PS key not found
0x0503 i2c_ack_missing Acknowledge for i2c was not received.
0x0504 i2c_timeout I2C read or write timed out.

Errors related to BGAPI protocol

Code Name Description
0x0101 invalid_conn_handle Invalid GATT connection handle.
0x0102 waiting_response Waiting response from GATT server to previous procedure.
0x0103 gatt_connection_timeout GATT connection is closed due procedure timeout.
0x0180 invalid_param Command contained invalid parameter
0x0181 wrong_state Device is in wrong state to receive command
0x0182 out_of_memory Device has run out of memory
0x0183 not_implemented Feature is not implemented
0x0184 invalid_command Command was not recognized
0x0185 timeout A command or procedure failed or a link lost due to timeout
0x0186 not_connected Connection handle passed is to command is not a valid handle
0x0187 flow Command would cause either underflow or overflow error
0x0188 user_attribute User attribute was accessed through API which is not supported
0x0189 invalid_license_key No valid license key found
0x018a command_too_long Command maximum length exceeded
0x018b out_of_bonds Bonding procedure can't be started because device has no space left for bond.
0x018c unspecified Unspecified error
0x018d hardware Hardware failure
0x018e buffers_full Command not accepted, because internal buffers are full
0x018f disconnected Command or Procedure failed due to disconnection
0x0190 too_many_requests Too many Simultaneous Requests
0x0191 not_supported Feature is not supported in this firmware build
0x0192 no_bonding The bonding does not exist.
0x0193 crypto Error using crypto functions
0x0194 data_corrupted Data was corrupted.
0x0195 command_incomplete Data received does not form a complete command
0x0196 not_initialized Feature or subsystem not initialized
0x0197 invalid_sync_handle Invalid periodic advertising sync handle
0x0198 invalid_module_action Bluetooth cannot be used on this hardware
0x0199 radio Error received from radio

Errors from Security Manager Protocol

Code Name Description
0x0301 passkey_entry_failed The user input of passkey failed, for example, the user cancelled the operation
0x0302 oob_not_available Out of Band data is not available for authentication
0x0303 authentication_requirements The pairing procedure cannot be performed as authentication requirements cannot be met due to IO capabilities of one or both devices
0x0304 confirm_value_failed The confirm value does not match the calculated compare value
0x0305 pairing_not_supported Pairing is not supported by the device
0x0306 encryption_key_size The resultant encryption key size is insufficient for the security requirements of this device
0x0307 command_not_supported The SMP command received is not supported on this device
0x0308 unspecified_reason Pairing failed due to an unspecified reason
0x0309 repeated_attempts Pairing or authentication procedure is disallowed because too little time has elapsed since last pairing request or security request
0x030a invalid_parameters The Invalid Parameters error code indicates: the command length is invalid or a parameter is outside of the specified range.
0x030b dhkey_check_failed Indicates to the remote device that the DHKey Check value received doesn't match the one calculated by the local device.
0x030c numeric_comparison_failed Indicates that the confirm values in the numeric comparison protocol do not match.
0x030d bredr_pairing_in_progress Indicates that the pairing over the LE transport failed due to a Pairing Request sent over the BR/EDR transport in process.
0x030e cross_transport_key_derivation_generation_not_allowed Indicates that the BR/EDR Link Key generated on the BR/EDR transport cannot be used to derive and distribute keys for the LE transport.

Bluetooth errors

Code Name Description
0x0202 unknown_connection_identifier Connection does not exist, or connection open request was cancelled.
0x0205 authentication_failure Pairing or authentication failed due to incorrect results in the pairing or authentication procedure. This could be due to an incorrect PIN or Link Key
0x0206 pin_or_key_missing Pairing failed because of missing PIN, or authentication failed because of missing Key
0x0207 memory_capacity_exceeded Controller is out of memory.
0x0208 connection_timeout Link supervision timeout has expired.
0x0209 connection_limit_exceeded Controller is at limit of connections it can support.
0x020a synchronous_connectiontion_limit_exceeded The Synchronous Connection Limit to a Device Exceeded error code indicates that the Controller has reached the limit to the number of synchronous connections that can be achieved to a device.
0x020b acl_connection_already_exists The ACL Connection Already Exists error code indicates that an attempt to create a new ACL Connection to a device when there is already a connection to this device.
0x020c command_disallowed Command requested cannot be executed because the Controller is in a state where it cannot process this command at this time.
0x020d connection_rejected_due_to_limited_resources The Connection Rejected Due To Limited Resources error code indicates that an incoming connection was rejected due to limited resources.
0x020e connection_rejected_due_to_security_reasons The Connection Rejected Due To Security Reasons error code indicates that a connection was rejected due to security requirements not being fulfilled, like authentication or pairing.
0x020f connection_rejected_due_to_unacceptable_bd_addr The Connection was rejected because this device does not accept the BD_ADDR. This may be because the device will only accept connections from specific BD_ADDRs.
0x0210 connection_accept_timeout_exceeded The Connection Accept Timeout has been exceeded for this connection attempt.
0x0211 unsupported_feature_or_parameter_value A feature or parameter value in the HCI command is not supported.
0x0212 invalid_command_parameters Command contained invalid parameters.
0x0213 remote_user_terminated User on the remote device terminated the connection.
0x0214 remote_device_terminated_connection_due_to_low_resources The remote device terminated the connection because of low resources
0x0215 remote_powering_off Remote Device Terminated Connection due to Power Off
0x0216 connection_terminated_by_local_host Local device terminated the connection.
0x0217 repeated_attempts The Controller is disallowing an authentication or pairing procedure because too little time has elapsed since the last authentication or pairing attempt failed.
0x0218 pairing_not_allowed The device does not allow pairing. This can be for example, when a device only allows pairing during a certain time window after some user input allows pairing
0x021a unsupported_remote_feature The remote device does not support the feature associated with the issued command.
0x021f unspecified_error No other error code specified is appropriate to use.
0x0222 ll_response_timeout Connection terminated due to link-layer procedure timeout.
0x0223 ll_procedure_collision LL procedure has collided with the same transaction or procedure that is already in progress.
0x0225 encryption_mode_not_acceptable The requested encryption mode is not acceptable at this time.
0x0226 link_key_cannot_be_changed Link key cannot be changed because a fixed unit key is being used.
0x0228 instant_passed LMP PDU or LL PDU that includes an instant cannot be performed because the instant when this would have occurred has passed.
0x0229 pairing_with_unit_key_not_supported It was not possible to pair as a unit key was requested and it is not supported.
0x022a different_transaction_collision LMP transaction was started that collides with an ongoing transaction.
0x022e channel_assessment_not_supported The Controller cannot perform channel assessment because it is not supported.
0x022f insufficient_security The HCI command or LMP PDU sent is only possible on an encrypted link.
0x0230 parameter_out_of_mandatory_range A parameter value requested is outside the mandatory range of parameters for the given HCI command or LMP PDU.
0x0237 simple_pairing_not_supported_by_host The IO capabilities request or response was rejected because the sending Host does not support Secure Simple Pairing even though the receiving Link Manager does.
0x0238 host_busy_pairing The Host is busy with another pairing operation and unable to support the requested pairing. The receiving device should retry pairing again later.
0x0239 connection_rejected_due_to_no_suitable_channel_found The Controller could not calculate an appropriate value for the Channel selection operation.
0x023a controller_busy Operation was rejected because the controller is busy and unable to process the request.
0x023b unacceptable_connection_interval Remote device terminated the connection because of an unacceptable connection interval.
0x023c advertising_timeout Ddvertising for a fixed duration completed or, for directed advertising, that advertising completed without a connection being created.
0x023d connection_terminated_due_to_mic_failure Connection was terminated because the Message Integrity Check (MIC) failed on a received packet.
0x023e connection_failed_to_be_established LL initiated a connection but the connection has failed to be established. Controller did not receive any packets from remote end.
0x023f mac_connection_failed The MAC of the 802.11 AMP was requested to connect to a peer, but the connection failed.
0x0240 coarse_clock_adjustment_rejected_but_will_try_to_adjust_using_clock_dragging The master, at this time, is unable to make a coarse adjustment to the piconet clock, using the supplied parameters. Instead the master will attempt to move the clock using clock dragging.
0x0242 unknown_advertising_identifier A command was sent from the Host that should identify an Advertising or Sync handle, but the Advertising or Sync handle does not exist.
0x0243 limit_reached Number of operations requested has been reached and has indicated the completion of the activity (e.g., advertising or scanning).
0x0244 operation_cancelled_by_host A request to the Controller issued by the Host and still pending was successfully canceled.
0x0245 packet_too_long An attempt was made to send or receive a packet that exceeds the maximum allowed packet length.

Application errors

Code Name Description
0x0a01 file_open_failed File open failed.
0x0a02 xml_parse_failed XML parsing failed.
0x0a03 device_connection_failed Device connection failed.
0x0a04 device_comunication_failed Device communication failed.
0x0a05 authentication_failed Device authentication failed.
0x0a06 incorrect_gatt_database Device has incorrect GATT database.
0x0a07 disconnected_due_to_procedure_collision Device disconnected due to procedure collision.
0x0a08 disconnected_due_to_secure_session_failed Device disconnected due to failure to establish or reestablish a secure session.
0x0a09 encryption_decryption_error Encrypion/decryption operation failed.
0x0a0a maximum_retries Maximum allowed retries exceeded.
0x0a0b data_parse_failed Data parsing failed.
0x0a0c pairing_removed Pairing established by the application layer protocol has been removed.
0x0a0d inactive_timeout Inactive timeout.
0x0a0e mismatched_or_insufficient_security Mismatched or insufficient security level

Errors from Attribute Protocol

Code Name Description
0x0401 invalid_handle The attribute handle given was not valid on this server
0x0402 read_not_permitted The attribute cannot be read
0x0403 write_not_permitted The attribute cannot be written
0x0404 invalid_pdu The attribute PDU was invalid
0x0405 insufficient_authentication The attribute requires authentication before it can be read or written.
0x0406 request_not_supported Attribute Server does not support the request received from the client.
0x0407 invalid_offset Offset specified was past the end of the attribute
0x0408 insufficient_authorization The attribute requires authorization before it can be read or written.
0x0409 prepare_queue_full Too many prepare writes have been queueud
0x040a att_not_found No attribute found within the given attribute handle range.
0x040b att_not_long The attribute cannot be read or written using the Read Blob Request
0x040c insufficient_enc_key_size The Encryption Key Size used for encrypting this link is insufficient.
0x040d invalid_att_length The attribute value length is invalid for the operation
0x040e unlikely_error The attribute request that was requested has encountered an error that was unlikely, and therefore could not be completed as requested.
0x040f insufficient_encryption The attribute requires encryption before it can be read or written.
0x0410 unsupported_group_type The attribute type is not a supported grouping attribute as defined by a higher layer specification.
0x0411 insufficient_resources Insufficient Resources to complete the request
0x0412 out_of_sync The server requests the client to rediscover the database.
0x0413 value_not_allowed The attribute parameter value was not allowed.
0x0480 application When this is returned in a BGAPI response, the application tried to read or write the value of a user attribute from the GATT database.

Bluetooth Mesh errors

Code Name Description
0x0c01 already_exists Returned when trying to add a key or some other unique resource with an ID which already exists
0x0c02 does_not_exist Returned when trying to manipulate a key or some other resource with an ID which does not exist
0x0c03 limit_reached Returned when an operation cannot be executed because a pre-configured limit for keys, key bindings, elements, models, virtual addresses, provisioned devices, or provisioning sessions is reached
0x0c04 invalid_address Returned when trying to use a reserved address or add a "pre-provisioned" device using an address already used by some other device
0x0c05 malformed_data In a BGAPI response, the user supplied malformed data; in a BGAPI event, the remote end responded with malformed or unrecognized data
0x0c06 already_initialized An attempt was made to initialize a subsystem that was already initialized.
0x0c07 not_initialized An attempt was made to use a subsystem that wasn't initialized yet. Call the subsystem's init function first.
0x0c08 no_friend_offer Returned when trying to establish a friendship as a Low Power Node, but no acceptable friend offer message was received.
0x0c09 prov_link_closed Provisioning link was unexpectedly closed before provisioning was complete.
0x0c0a prov_invalid_pdu An unrecognized provisioning PDU was received.
0x0c0b prov_invalid_pdu_format A provisioning PDU with wrong length or containing field values that are out of bounds was received.
0x0c0c prov_unexpected_pdu An unexpected (out of sequence) provisioning PDU was received.
0x0c0d prov_confirmation_failed The computed confirmation value did not match the expected value.
0x0c0e prov_out_of_resources Provisioning could not be continued due to unsufficient resources.
0x0c0f prov_decryption_failed The provisioning data block could not be decrypted.
0x0c10 prov_unexpected_error An unexpected error happened during provisioning.
0x0c11 prov_cannot_assign_addr Device could not assign unicast addresses to all of its elements.
0x0c12 address_temporarily_unavailable Returned when trying to reuse an address of a previously deleted device before an IV Index Update has been executed.
0x0c13 address_already_used Returned when trying to assign an address that is used by one of the devices in the Device Database, or by the Provisioner itself.

Bluetooth Mesh foundation errors

Code Name Description
0x0e01 invalid_address Returned when address in request was not valid
0x0e02 invalid_model Returned when model identified is not found for a given element
0x0e03 invalid_app_key Returned when the key identified by AppKeyIndex is not stored in the node
0x0e04 invalid_net_key Returned when the key identified by NetKeyIndex is not stored in the node
0x0e05 insufficient_resources Returned when The node cannot serve the request due to insufficient resources
0x0e06 key_index_exists Returned when the key identified is already stored in the node and the new NetKey value is different
0x0e07 invalid_publish_params Returned when the model does not support the publish mechanism
0x0e08 not_subscribe_model Returned when the model does not support the subscribe mechanism
0x0e09 storage_failure Returned when storing of the requested parameters failed
0x0e0a not_supported Returned when requested setting is not supported
0x0e0b cannot_update Returned when the requested update operation cannot be performed due to general constraints
0x0e0c cannot_remove Returned when the requested delete operation cannot be performed due to general constraints
0x0e0d cannot_bind Returned when the requested bind operation cannot be performed due to general constraints
0x0e0e temporarily_unable Returned when The node cannot start advertising with Node Identity or Proxy since the maximum number of parallel advertising is reached
0x0e0f cannot_set Returned when the requested state cannot be set
0x0e10 unspecified Returned when an unspecified error took place
0x0e11 invalid_binding Returned when the NetKeyIndex and AppKeyIndex combination is not valid for a Config AppKey Update

Filesystem errors

Code Name Description
0x0901 file_not_found File not found

Errors from Logical Link Control and Adaptation Protocol

Code Name Description
0x0d01 remote_disconnected Returned when remote disconnects the connection-oriented channel by sending disconnection request.
0x0d02 local_disconnected Returned when local host disconnect the connection-oriented channel by sending disconnection request.
0x0d03 cid_not_exist Returned when local host did not find a connection-oriented channel with given destination CID.
0x0d04 le_disconnected Returned when connection-oriented channel disconnected due to LE connection is dropped.
0x0d05 flow_control_violated Returned when connection-oriented channel disconnected due to remote end send data even without credit.
0x0d06 flow_control_credit_overflowed Returned when connection-oriented channel disconnected due to remote end send flow control credits exceed 65535.
0x0d07 no_flow_control_credit Returned when connection-oriented channel has run out of flow control credit and local application still trying to send data.
0x0d08 connection_request_timeout Returned when connection-oriented channel has not received connection response message within maximum timeout.
0x0d09 invalid_cid Returned when local host received a connection-oriented channel connection response with an invalid destination CID.
0x0d0a wrong_state Returned when local host application tries to send a command which is not suitable for L2CAP channel's current state.

Security errors

Code Name Description
0x0b01 image_signature_verification_failed Device firmware signature verification failed.
0x0b02 file_signature_verification_failed File signature verification failed.
0x0b03 image_checksum_error Device firmware checksum is not valid.