Send feedback
  
   
 
  
    
    
       
    
    
      
      Stay organized with collections
     
    
      
      Save and categorize content based on your preferences.
     
    
  
    
  
  
   
  
    
  
  
    
    
  
  Error 
  This module includes error definitions used in OpenThread. 
  Summary 
  
    
      
        Enumerations 
       
     
    
      
        otError {   OT_ERROR_NONE  = 0,   OT_ERROR_FAILED  = 1,   OT_ERROR_DROP  = 2,   OT_ERROR_NO_BUFS  = 3,   OT_ERROR_NO_ROUTE  = 4,   OT_ERROR_BUSY  = 5,   OT_ERROR_PARSE  = 6,   OT_ERROR_INVALID_ARGS  = 7,   OT_ERROR_SECURITY  = 8,   OT_ERROR_ADDRESS_QUERY  = 9,   OT_ERROR_NO_ADDRESS  = 10,   OT_ERROR_ABORT  = 11,   OT_ERROR_NOT_IMPLEMENTED  = 12,   OT_ERROR_INVALID_STATE  = 13,   OT_ERROR_NO_ACK  = 14,   OT_ERROR_CHANNEL_ACCESS_FAILURE  = 15,   OT_ERROR_DETACHED  = 16,   OT_ERROR_FCS  = 17,   OT_ERROR_NO_FRAME_RECEIVED  = 18,   OT_ERROR_UNKNOWN_NEIGHBOR  = 19,   OT_ERROR_INVALID_SOURCE_ADDRESS  = 20,   OT_ERROR_ADDRESS_FILTERED  = 21,   OT_ERROR_DESTINATION_ADDRESS_FILTERED  = 22,   OT_ERROR_NOT_FOUND  = 23,   OT_ERROR_ALREADY  = 24,   OT_ERROR_IP6_ADDRESS_CREATION_FAILURE  = 26,   OT_ERROR_NOT_CAPABLE  = 27,   OT_ERROR_RESPONSE_TIMEOUT  = 28,   OT_ERROR_DUPLICATED  = 29,   OT_ERROR_REASSEMBLY_TIMEOUT  = 30,   OT_ERROR_NOT_TMF  = 31,   OT_ERROR_NOT_LOWPAN_DATA_FRAME  = 32,   OT_ERROR_LINK_MARGIN_LOW  = 34,   OT_ERROR_INVALID_COMMAND  = 35,   OT_ERROR_PENDING  = 36,   OT_ERROR_REJECTED  = 37,   OT_NUM_ERRORS ,   OT_ERROR_GENERIC  = 255 }
       
      enumRepresents error codes used throughout OpenThread. 
 
     
  
  
    
      
        Typedefs 
       
     
    
      
        otError 
       
      typedefRepresents error codes used throughout OpenThread. 
 
     
  
  
  Enumerations 
  
    otError 
    
 otError  
    
      Represents error codes used throughout OpenThread. 
      
        
          Properties 
         
        
          
             OT_ERROR_ABORT
           
          
            Operation was aborted. 
           
         
        
          
             OT_ERROR_ADDRESS_FILTERED
           
          
            Received a frame filtered by the address filter (allowlisted or denylisted). 
           
         
        
          
             OT_ERROR_ADDRESS_QUERY
           
          
            Address resolution requires an address query operation. 
           
         
        
          
             OT_ERROR_ALREADY
           
          
            The operation is already in progress. 
           
         
        
          
             OT_ERROR_BUSY
           
          
            Service is busy and could not service the operation. 
           
         
        
          
             OT_ERROR_CHANNEL_ACCESS_FAILURE
           
          
            A transmission could not take place due to activity on the channel, i.e., the CSMA-CA mechanism has failed (IEEE 802.15.4-2006). 
           
         
        
          
             OT_ERROR_DESTINATION_ADDRESS_FILTERED
           
          
            Received a frame filtered by the destination address check. 
           
         
        
          
             OT_ERROR_DETACHED
           
          
            Not currently attached to a Thread Partition. 
           
         
        
          
             OT_ERROR_DROP
           
          
            Message was dropped. 
           
         
        
          
             OT_ERROR_DUPLICATED
           
          
            Received a duplicated frame. 
           
         
        
          
             OT_ERROR_FAILED
           
          
            Operational failed. 
           
         
        
          
             OT_ERROR_FCS
           
          
            FCS check failure while receiving. 
           
         
        
          
             OT_ERROR_GENERIC
           
          
            Generic error (should not use). 
           
         
        
          
             OT_ERROR_INVALID_ARGS
           
          
            Input arguments are invalid. 
           
         
        
          
             OT_ERROR_INVALID_COMMAND
           
          
            Input (CLI) command is invalid. 
           
         
        
          
             OT_ERROR_INVALID_SOURCE_ADDRESS
           
          
            Received a frame from an invalid source address. 
           
         
        
          
             OT_ERROR_INVALID_STATE
           
          
            Cannot complete due to invalid state. 
           
         
        
          
             OT_ERROR_IP6_ADDRESS_CREATION_FAILURE
           
          
            The creation of IPv6 address failed. 
           
         
        
          
             OT_ERROR_LINK_MARGIN_LOW
           
          
            The link margin was too low. 
           
         
        
          
             OT_ERROR_NONE
           
          
            No error. 
           
         
        
          
             OT_ERROR_NOT_CAPABLE
           
          
            Operation prevented by mode flags. 
           
         
        
          
             OT_ERROR_NOT_FOUND
           
          
            The requested item could not be found. 
           
         
        
          
             OT_ERROR_NOT_IMPLEMENTED
           
          
            Function or method is not implemented. 
           
         
        
          
             OT_ERROR_NOT_LOWPAN_DATA_FRAME
           
          
            Received a non-lowpan data frame. 
           
         
        
          
             OT_ERROR_NOT_TMF
           
          
            Message is not a TMF Message. 
           
         
        
          
             OT_ERROR_NO_ACK
           
          
            No acknowledgment was received after macMaxFrameRetries (IEEE 802.15.4-2006). 
           
         
        
          
             OT_ERROR_NO_ADDRESS
           
          
            Address is not in the source match table. 
           
         
        
          
             OT_ERROR_NO_BUFS
           
          
            Insufficient buffers. 
           
         
        
          
             OT_ERROR_NO_FRAME_RECEIVED
           
          
            No frame received. 
           
         
        
          
             OT_ERROR_NO_ROUTE
           
          
            No route available. 
           
         
        
          
             OT_ERROR_PARSE
           
          
            Failed to parse message. 
           
         
        
          
             OT_ERROR_PENDING
           
          
            Special error code used to indicate success/error status is pending and not yet known. 
           
         
        
          
             OT_ERROR_REASSEMBLY_TIMEOUT
           
          
            Message is being dropped from reassembly list due to timeout. 
           
         
        
          
             OT_ERROR_REJECTED
           
          
            Request rejected. 
           
         
        
          
             OT_ERROR_RESPONSE_TIMEOUT
           
          
            Coap response or acknowledgment or DNS, SNTP response not received. 
           
         
        
          
             OT_ERROR_SECURITY
           
          
            Security checks failed. 
           
         
        
          
             OT_ERROR_UNKNOWN_NEIGHBOR
           
          
            Received a frame from an unknown neighbor. 
           
         
        
          
             OT_NUM_ERRORS
           
          
            The number of defined errors. 
           
         
      
     
   
  Typedefs 
  
    otError 
    
enum   otError   otError  
    
      Represents error codes used throughout OpenThread. 
     
   
  Functions 
  
    otThreadErrorToString 
    
const   char   *   otThreadErrorToString ( 
   otError   aError 
)  
    
      Converts an otError enum into a string. 
      
      
        
          Details 
         
        
          
            Parameters 
            
              
                
                  
                    
                      [in] aError
                     
                    
                      An otError enum.
                     
                   
                 
              
             
           
          
            
              Returns 
             
            
              A string representation of an otError. 
             
           
         
      
     
   
  Resources 
  OpenThread API Reference topics originate from the source code, available
    on GitHub .
    For more information, or to contribute to our documentation, refer to
    Resources .
  
  
 
  
    
    
    
  
  
 
  Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates. The OPENTHREAD and related marks are trademarks of the Thread Group and are used under license.
  Last updated 2024-01-02 UTC.
 
 
  
  
    
    
    
      
  
  
    Need to tell us more?
  
   
 
     
  
  
    
      [[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-01-02 UTC."],[],[]]