1 /*
2  * Copyright (c) 2017 - 2024, Nordic Semiconductor ASA
3  * All rights reserved.
4  *
5  * SPDX-License-Identifier: BSD-3-Clause
6  *
7  * Redistribution and use in source and binary forms, with or without
8  * modification, are permitted provided that the following conditions are met:
9  *
10  * 1. Redistributions of source code must retain the above copyright notice, this
11  *    list of conditions and the following disclaimer.
12  *
13  * 2. Redistributions in binary form must reproduce the above copyright
14  *    notice, this list of conditions and the following disclaimer in the
15  *    documentation and/or other materials provided with the distribution.
16  *
17  * 3. Neither the name of the copyright holder nor the names of its
18  *    contributors may be used to endorse or promote products derived from this
19  *    software without specific prior written permission.
20  *
21  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
22  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
23  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
24  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
25  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
26  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
27  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
28  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
29  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
30  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
31  * POSSIBILITY OF SUCH DAMAGE.
32  */
33 
34 #ifndef NRFX_ERRORS_H__
35 #define NRFX_ERRORS_H__
36 
37 #if !NRFX_CHECK(NRFX_CUSTOM_ERROR_CODES)
38 
39 /**
40  * @defgroup nrfx_error_codes Global Error Codes
41  * @{
42  * @ingroup nrfx
43  *
44  * @brief Global error code definitions.
45  */
46 
47 /** @brief Base number of error codes. */
48 #define NRFX_ERROR_BASE_NUM         0x0BAD0000
49 
50 /** @brief Base number of driver error codes. */
51 #define NRFX_ERROR_DRIVERS_BASE_NUM (NRFX_ERROR_BASE_NUM + 0x10000)
52 
53 /** @brief Enumerated type for error codes. */
54 typedef enum {
55     NRFX_SUCCESS                   = (NRFX_ERROR_BASE_NUM + 0),  ///< Operation performed successfully.
56     NRFX_ERROR_INTERNAL            = (NRFX_ERROR_BASE_NUM + 1),  ///< Internal error.
57     NRFX_ERROR_NO_MEM              = (NRFX_ERROR_BASE_NUM + 2),  ///< No memory for operation.
58     NRFX_ERROR_NOT_SUPPORTED       = (NRFX_ERROR_BASE_NUM + 3),  ///< Not supported.
59     NRFX_ERROR_INVALID_PARAM       = (NRFX_ERROR_BASE_NUM + 4),  ///< Invalid parameter.
60     NRFX_ERROR_INVALID_STATE       = (NRFX_ERROR_BASE_NUM + 5),  ///< Invalid state, operation disallowed in this state.
61     NRFX_ERROR_INVALID_LENGTH      = (NRFX_ERROR_BASE_NUM + 6),  ///< Invalid length.
62     NRFX_ERROR_TIMEOUT             = (NRFX_ERROR_BASE_NUM + 7),  ///< Operation timed out.
63     NRFX_ERROR_FORBIDDEN           = (NRFX_ERROR_BASE_NUM + 8),  ///< Operation is forbidden.
64     NRFX_ERROR_NULL                = (NRFX_ERROR_BASE_NUM + 9),  ///< Null pointer.
65     NRFX_ERROR_INVALID_ADDR        = (NRFX_ERROR_BASE_NUM + 10), ///< Bad memory address.
66     NRFX_ERROR_BUSY                = (NRFX_ERROR_BASE_NUM + 11), ///< Busy.
67     NRFX_ERROR_ALREADY             = (NRFX_ERROR_BASE_NUM + 12), ///< Operation already done.
68     NRFX_ERROR_ALREADY_INITIALIZED = NRFX_ERROR_ALREADY,         ///< @deprecated Use @ref NRFX_ERROR_ALREADY instead.
69 
70     NRFX_ERROR_DRV_TWI_ERR_OVERRUN = (NRFX_ERROR_DRIVERS_BASE_NUM + 0), ///< TWI error: Overrun.
71     NRFX_ERROR_DRV_TWI_ERR_ANACK   = (NRFX_ERROR_DRIVERS_BASE_NUM + 1), ///< TWI error: Address not acknowledged.
72     NRFX_ERROR_DRV_TWI_ERR_DNACK   = (NRFX_ERROR_DRIVERS_BASE_NUM + 2)  ///< TWI error: Data not acknowledged.
73 } nrfx_err_t;
74 
75 /** @} */
76 
77 #endif // !NRFX_CHECK(NRFX_CUSTOM_ERROR_CODES)
78 
79 #endif // NRFX_ERRORS_H__
80