Fix retval order in API description 64/290264/4
authorTaeminYeom <taemin.yeom@samsung.com>
Wed, 22 Mar 2023 07:20:02 +0000 (16:20 +0900)
committerTaeminYeom <taemin.yeom@samsung.com>
Fri, 24 Mar 2023 01:24:12 +0000 (10:24 +0900)
Native API Design Guidline of retval order is below.
-ERROR_NONE
-NOT_SUPPORTED
-PERMISSION_DENIED
-INVALID_PARAMETER
-(others)

Change-Id: I5d4598b87598ab83601e32d5d1f1e87796352bbc
Signed-off-by: TaeminYeom <taemin.yeom@samsung.com>
include/peripheral_io.h

index 0e5e94719ade0fa23ce7bc9e09a2ab2f6652e681..0df21a471338fcb0d2449a33fecebc5b6346bd80 100644 (file)
@@ -100,13 +100,13 @@ typedef struct _peripheral_gpio_s *peripheral_gpio_h;
  *
  * @return 0 on success, otherwise a negative error value
  * @retval #PERIPHERAL_ERROR_NONE Successful
+ * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
  * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
  * @retval #PERIPHERAL_ERROR_OUT_OF_MEMORY Memory allocation failed
- * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PERIPHERAL_ERROR_RESOURCE_BUSY Device is in use
- * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
  * @retval #PERIPHERAL_ERROR_UNKNOWN Unknown internal error
  *
  * @post peripheral_gpio_close()
@@ -124,11 +124,11 @@ EXPORT_API int peripheral_gpio_open(int gpio_pin, peripheral_gpio_h *gpio);
  *
  * @return 0 on success, otherwise a negative error value
  * @retval #PERIPHERAL_ERROR_NONE Successful
- * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
- * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
+ * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
  * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
+ * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
  * @retval #PERIPHERAL_ERROR_UNKNOWN Unknown internal error
  *
  * @pre peripheral_gpio_open()
@@ -148,11 +148,11 @@ EXPORT_API int peripheral_gpio_close(peripheral_gpio_h gpio);
  *
  * @return 0 on success, otherwise a negative error value
  * @retval #PERIPHERAL_ERROR_NONE Successful
- * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
- * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
+ * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
  * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
+ * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
  * @retval #PERIPHERAL_ERROR_UNKNOWN Unknown internal error
  *
  * @see peripheral_gpio_direction_e
@@ -173,11 +173,11 @@ EXPORT_API int peripheral_gpio_set_direction(peripheral_gpio_h gpio, peripheral_
  *
  * @return 0 on success, otherwise a negative error value
  * @retval #PERIPHERAL_ERROR_NONE Successful
- * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
- * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
+ * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
  * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
+ * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
  * @retval #PERIPHERAL_ERROR_UNKNOWN Unknown internal error
  *
  * @see peripheral_gpio_edge_e
@@ -190,14 +190,14 @@ EXPORT_API int peripheral_gpio_set_edge_mode(peripheral_gpio_h gpio, peripheral_
  * @brief The GPIO interrupted callback called when the GPIO interrupt is triggered.
  * @details The following errors can be received: \n
  * #PERIPHERAL_ERROR_NONE Successful \n
+ * #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported \n
+ * #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied \n
+ * #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter \n
  * #PERIPHERAL_ERROR_IO_ERROR I/O operation failed \n
  * #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed \n
  * #PERIPHERAL_ERROR_TRY_AGAIN Try again \n
  * #PERIPHERAL_ERROR_OUT_OF_MEMORY Memory allocation failed \n
- * #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied \n
  * #PERIPHERAL_ERROR_RESOURCE_BUSY Device is in use \n
- * #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter \n
- * #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported \n
  * #PERIPHERAL_ERROR_UNKNOWN Unknown internal error \n
  * @since_tizen 4.0
  *
@@ -223,9 +223,9 @@ typedef void(*peripheral_gpio_interrupted_cb)(peripheral_gpio_h gpio, peripheral
  *
  * @return 0 on success, otherwise a negative error value
  * @retval #PERIPHERAL_ERROR_NONE Successful
+ * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
  * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
  *
  * @post peripheral_gpio_unset_interrupted_cb()
  * @see peripheral_gpio_set_edge_mode()
@@ -243,9 +243,9 @@ EXPORT_API int peripheral_gpio_set_interrupted_cb(peripheral_gpio_h gpio, periph
  *
  * @return 0 on success, otherwise a negative error value
  * @retval #PERIPHERAL_ERROR_NONE Successful
+ * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
  * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
  *
  * @pre peripheral_gpio_set_interrupted_cb()
  */
@@ -263,11 +263,11 @@ EXPORT_API int peripheral_gpio_unset_interrupted_cb(peripheral_gpio_h gpio);
  *
  * @return 0 on success, otherwise a negative error value
  * @retval #PERIPHERAL_ERROR_NONE Successful
- * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
- * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
+ * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
  * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
+ * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
  * @retval #PERIPHERAL_ERROR_UNKNOWN Unknown internal error
  *
  * @see peripheral_gpio_write()
@@ -287,11 +287,11 @@ EXPORT_API int peripheral_gpio_read(peripheral_gpio_h gpio, uint32_t *value);
  *
  * @return 0 on success, otherwise a negative error value
  * @retval #PERIPHERAL_ERROR_NONE Successful
- * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
- * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
+ * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
  * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
+ * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
  * @retval #PERIPHERAL_ERROR_UNKNOWN Unknown internal error
  *
  * @see peripheral_gpio_read()
@@ -328,13 +328,13 @@ typedef struct _peripheral_i2c_s *peripheral_i2c_h;
  *
  * @return 0 on success, otherwise a negative error value
  * @retval #PERIPHERAL_ERROR_NONE Successful
+ * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
  * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
  * @retval #PERIPHERAL_ERROR_OUT_OF_MEMORY Memory allocation failed
- * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PERIPHERAL_ERROR_RESOURCE_BUSY Device is in use
- * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
  * @retval #PERIPHERAL_ERROR_UNKNOWN Unknown internal error
  *
  * @post peripheral_i2c_close()
@@ -373,13 +373,13 @@ typedef enum {
  *
  * @return 0 on success, otherwise a negative error value
  * @retval #PERIPHERAL_ERROR_NONE Successful
+ * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
  * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
  * @retval #PERIPHERAL_ERROR_OUT_OF_MEMORY Memory allocation failed
- * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PERIPHERAL_ERROR_RESOURCE_BUSY Device is in use
- * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
  * @retval #PERIPHERAL_ERROR_UNKNOWN Unknown internal error
  *
  * @post peripheral_i2c_close()
@@ -397,9 +397,9 @@ EXPORT_API int peripheral_i2c_open_flags(int bus, int address, peripheral_open_f
  *
  * @return 0 on success, otherwise a negative error value
  * @retval #PERIPHERAL_ERROR_NONE Successful
+ * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
  * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
  * @retval #PERIPHERAL_ERROR_UNKNOWN Unknown internal error
  *
  * @pre peripheral_i2c_open()
@@ -419,10 +419,10 @@ EXPORT_API int peripheral_i2c_close(peripheral_i2c_h i2c);
  *
  * @return 0 on success, otherwise a negative error value
  * @retval #PERIPHERAL_ERROR_NONE Successful
- * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
+ * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
  * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
  * @retval #PERIPHERAL_ERROR_UNKNOWN Unknown internal error
  *
  * @see peripheral_i2c_write()
@@ -442,10 +442,10 @@ EXPORT_API int peripheral_i2c_read(peripheral_i2c_h i2c, uint8_t *data, uint32_t
  *
  * @return 0 on success, otherwise a negative error value
  * @retval #PERIPHERAL_ERROR_NONE Successful
- * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
+ * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
  * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
  * @retval #PERIPHERAL_ERROR_UNKNOWN Unknown internal error
  *
  * @see peripheral_i2c_read()
@@ -465,10 +465,10 @@ EXPORT_API int peripheral_i2c_write(peripheral_i2c_h i2c, uint8_t *data, uint32_
  *
  * @return 0 on success, otherwise a negative error value
  * @retval #PERIPHERAL_ERROR_NONE Successful
- * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
+ * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
  * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
  * @retval #PERIPHERAL_ERROR_UNKNOWN Unknown internal error
  *
  * @see peripheral_i2c_write_register_byte()
@@ -488,10 +488,10 @@ EXPORT_API int peripheral_i2c_read_register_byte(peripheral_i2c_h i2c, uint8_t r
  *
  * @return 0 on success, otherwise a negative error value
  * @retval #PERIPHERAL_ERROR_NONE Successful
- * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
+ * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
  * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
  * @retval #PERIPHERAL_ERROR_UNKNOWN Unknown internal error
  *
  * @see peripheral_i2c_read_register_byte()
@@ -511,10 +511,10 @@ EXPORT_API int peripheral_i2c_write_register_byte(peripheral_i2c_h i2c, uint8_t
  *
  * @return 0 on success, otherwise a negative error value
  * @retval #PERIPHERAL_ERROR_NONE Successful
- * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
+ * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
  * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
  * @retval #PERIPHERAL_ERROR_UNKNOWN Unknown internal error
  *
  * @see peripheral_i2c_write_register_word()
@@ -534,10 +534,10 @@ EXPORT_API int peripheral_i2c_read_register_word(peripheral_i2c_h i2c, uint8_t r
  *
  * @return 0 on success, otherwise a negative error value
  * @retval #PERIPHERAL_ERROR_NONE Successful
- * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
+ * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
  * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
  * @retval #PERIPHERAL_ERROR_UNKNOWN Unknown internal error
  *
  * @see peripheral_i2c_read_register_word()
@@ -582,13 +582,13 @@ typedef enum {
  *
  * @return 0 on success, otherwise a negative error value
  * @retval #PERIPHERAL_ERROR_NONE Successful
+ * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
  * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
  * @retval #PERIPHERAL_ERROR_OUT_OF_MEMORY Memory allocation failed
- * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PERIPHERAL_ERROR_RESOURCE_BUSY Device is in use
- * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
  * @retval #PERIPHERAL_ERROR_UNKNOWN Unknown internal error
  *
  * @post peripheral_pwm_close()
@@ -606,11 +606,11 @@ EXPORT_API int peripheral_pwm_open(int chip, int pin, peripheral_pwm_h *pwm);
  *
  * @return 0 on success, otherwise a negative error value
  * @retval #PERIPHERAL_ERROR_NONE Successful
- * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
- * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
+ * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
  * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
+ * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
  * @retval #PERIPHERAL_ERROR_UNKNOWN Unknown internal error
  *
  * @pre peripheral_pwm_open()
@@ -629,11 +629,11 @@ EXPORT_API int peripheral_pwm_close(peripheral_pwm_h pwm);
  *
  * @return 0 on success, otherwise a negative error value
  * @retval #PERIPHERAL_ERROR_NONE Successful
- * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
- * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
+ * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
  * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
+ * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
  * @retval #PERIPHERAL_ERROR_UNKNOWN Unknown internal error
  */
 EXPORT_API int peripheral_pwm_set_period(peripheral_pwm_h pwm, uint32_t period_ns);
@@ -650,11 +650,11 @@ EXPORT_API int peripheral_pwm_set_period(peripheral_pwm_h pwm, uint32_t period_n
  *
  * @return 0 on success, otherwise a negative error value
  * @retval #PERIPHERAL_ERROR_NONE Successful
- * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
- * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
+ * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
  * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
+ * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
  * @retval #PERIPHERAL_ERROR_UNKNOWN Unknown internal error
  */
 EXPORT_API int peripheral_pwm_set_duty_cycle(peripheral_pwm_h pwm, uint32_t duty_cycle_ns);
@@ -671,11 +671,11 @@ EXPORT_API int peripheral_pwm_set_duty_cycle(peripheral_pwm_h pwm, uint32_t duty
  *
  * @return 0 on success, otherwise a negative error value
  * @retval #PERIPHERAL_ERROR_NONE Successful
- * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
- * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
+ * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
  * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
+ * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
  * @retval #PERIPHERAL_ERROR_UNKNOWN Unknown internal error
  *
  * @see peripheral_pwm_polarity_e
@@ -694,11 +694,11 @@ EXPORT_API int peripheral_pwm_set_polarity(peripheral_pwm_h pwm, peripheral_pwm_
  *
  * @return 0 on success, otherwise a negative error value
  * @retval #PERIPHERAL_ERROR_NONE Successful
- * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
- * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
+ * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
  * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
+ * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
  * @retval #PERIPHERAL_ERROR_UNKNOWN Unknown internal error
  */
 EXPORT_API int peripheral_pwm_set_enabled(peripheral_pwm_h pwm, bool enabled);
@@ -732,13 +732,13 @@ typedef struct _peripheral_adc_s *peripheral_adc_h;
  *
  * @return 0 on success, otherwise a negative error value
  * @retval #PERIPHERAL_ERROR_NONE Successful
+ * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
  * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
  * @retval #PERIPHERAL_ERROR_OUT_OF_MEMORY Memory allocation failed
- * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PERIPHERAL_ERROR_RESOURCE_BUSY Device is in use
- * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
  * @retval #PERIPHERAL_ERROR_UNKNOWN Unknown internal error
  *
  * @post peripheral_adc_close()
@@ -756,11 +756,11 @@ EXPORT_API int peripheral_adc_open(int device, int channel, peripheral_adc_h *ad
  *
  * @return 0 on success, otherwise a negative error value
  * @retval #PERIPHERAL_ERROR_NONE Successful
- * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
- * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
+ * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
  * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
+ * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
  * @retval #PERIPHERAL_ERROR_UNKNOWN Unknown internal error
  *
  * @pre peripheral_adc_open()
@@ -779,11 +779,11 @@ EXPORT_API int peripheral_adc_close(peripheral_adc_h adc);
  *
  * @return 0 on success, otherwise a negative error value
  * @retval #PERIPHERAL_ERROR_NONE Successful
- * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
- * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
+ * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
  * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
+ * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
  * @retval #PERIPHERAL_ERROR_UNKNOWN Unknown internal error
  *
  */
@@ -891,13 +891,13 @@ typedef enum {
  *
  * @return 0 on success, otherwise a negative error value
  * @retval #PERIPHERAL_ERROR_NONE Successful
+ * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
  * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
  * @retval #PERIPHERAL_ERROR_OUT_OF_MEMORY Memory allocation failed
- * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PERIPHERAL_ERROR_RESOURCE_BUSY Device is in use
- * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
  * @retval #PERIPHERAL_ERROR_UNKNOWN Unknown internal error
  *
  * @post peripheral_uart_close()
@@ -918,13 +918,13 @@ EXPORT_API int peripheral_uart_open(int port, peripheral_uart_h *uart);
  *
  * @return 0 on success, otherwise a negative error value
  * @retval #PERIPHERAL_ERROR_NONE Successful
+ * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
  * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
  * @retval #PERIPHERAL_ERROR_OUT_OF_MEMORY Memory allocation failed
- * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PERIPHERAL_ERROR_RESOURCE_BUSY Device is in use
- * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
  * @retval #PERIPHERAL_ERROR_UNKNOWN Unknown internal error
  *
  * @post peripheral_uart_close()
@@ -942,9 +942,9 @@ EXPORT_API int peripheral_uart_open_flags(int port, peripheral_open_flags_e flag
  *
  * @return 0 on success, otherwise a negative error value
  * @retval #PERIPHERAL_ERROR_NONE Successful
+ * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
  * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
  * @retval #PERIPHERAL_ERROR_UNKNOWN Unknown internal error
  *
  * @pre peripheral_uart_open()
@@ -963,11 +963,11 @@ EXPORT_API int peripheral_uart_close(peripheral_uart_h uart);
  *
  * @return 0 on success, otherwise a negative error value
  * @retval #PERIPHERAL_ERROR_NONE Successful
- * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
- * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
+ * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
  * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
+ * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
  * @retval #PERIPHERAL_ERROR_UNKNOWN Unknown internal error
  *
  * @see peripheral_uart_baud_rate_e
@@ -986,11 +986,11 @@ EXPORT_API int peripheral_uart_set_baud_rate(peripheral_uart_h uart, peripheral_
  *
  * @return 0 on success, otherwise a negative error value
  * @retval #PERIPHERAL_ERROR_NONE Successful
- * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
- * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
+ * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
  * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
+ * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
  * @retval #PERIPHERAL_ERROR_UNKNOWN Unknown internal error
  *
  * @see peripheral_uart_byte_size_e
@@ -1009,11 +1009,11 @@ EXPORT_API int peripheral_uart_set_byte_size(peripheral_uart_h uart, peripheral_
  *
  * @return 0 on success, otherwise a negative error value
  * @retval #PERIPHERAL_ERROR_NONE Successful
- * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
- * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
+ * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
  * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
+ * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
  * @retval #PERIPHERAL_ERROR_UNKNOWN Unknown internal error
  *
  * @see peripheral_uart_parity_e
@@ -1032,11 +1032,11 @@ EXPORT_API int peripheral_uart_set_parity(peripheral_uart_h uart, peripheral_uar
  *
  * @return 0 on success, otherwise a negative error value
  * @retval #PERIPHERAL_ERROR_NONE Successful
- * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
- * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
+ * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
  * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
+ * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
  * @retval #PERIPHERAL_ERROR_UNKNOWN Unknown internal error
  *
  * @see peripheral_uart_stop_bits_e
@@ -1056,11 +1056,11 @@ EXPORT_API int peripheral_uart_set_stop_bits(peripheral_uart_h uart, peripheral_
  *
  * @return 0 on success, otherwise a negative error value
  * @retval #PERIPHERAL_ERROR_NONE Successful
- * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
- * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
+ * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
  * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
+ * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
  * @retval #PERIPHERAL_ERROR_UNKNOWN Unknown internal error
  *
  * @see peripheral_uart_software_flow_control_e
@@ -1083,11 +1083,11 @@ EXPORT_API int peripheral_uart_set_flow_control(peripheral_uart_h uart,
  *
  * @return the number of bytes read on success, otherwise a negative error value
  * @retval #PERIPHERAL_ERROR_NONE Successful
- * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
- * @retval #PERIPHERAL_ERROR_TRY_AGAIN Try again
+ * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
  * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
+ * @retval #PERIPHERAL_ERROR_TRY_AGAIN Try again
  * @retval #PERIPHERAL_ERROR_UNKNOWN Unknown internal error
  *
  * @see peripheral_uart_write()
@@ -1106,11 +1106,11 @@ EXPORT_API int peripheral_uart_read(peripheral_uart_h uart, uint8_t *data, uint3
  *
  * @return #PERIPHERAL_ERROR_NONE on success, otherwise a negative error value
  * @retval #PERIPHERAL_ERROR_NONE Successful
- * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
- * @retval #PERIPHERAL_ERROR_TRY_AGAIN Try again
+ * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
  * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
+ * @retval #PERIPHERAL_ERROR_TRY_AGAIN Try again
  * @retval #PERIPHERAL_ERROR_UNKNOWN Unknown internal error
  *
  */
@@ -1127,11 +1127,11 @@ EXPORT_API int peripheral_uart_flush(peripheral_uart_h uart);
  *
  * @return #PERIPHERAL_ERROR_NONE on success, otherwise a negative error value
  * @retval #PERIPHERAL_ERROR_NONE Successful
- * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
- * @retval #PERIPHERAL_ERROR_TRY_AGAIN Try again
+ * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
  * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
+ * @retval #PERIPHERAL_ERROR_TRY_AGAIN Try again
  * @retval #PERIPHERAL_ERROR_UNKNOWN Unknown internal error
  *
  */
@@ -1150,11 +1150,11 @@ EXPORT_API int peripheral_uart_drain(peripheral_uart_h uart);
  *
  * @return the number of bytes write on success, otherwise a negative error value
  * @retval #PERIPHERAL_ERROR_NONE Successful
- * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
- * @retval #PERIPHERAL_ERROR_TRY_AGAIN Try again
+ * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
  * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
+ * @retval #PERIPHERAL_ERROR_TRY_AGAIN Try again
  * @retval #PERIPHERAL_ERROR_UNKNOWN Unknown internal error
  *
  * @see peripheral_uart_read()
@@ -1210,13 +1210,13 @@ typedef enum {
  *
  * @return 0 on success, otherwise a negative error value
  * @retval #PERIPHERAL_ERROR_NONE Successful
+ * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
  * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
  * @retval #PERIPHERAL_ERROR_OUT_OF_MEMORY Memory allocation failed
- * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PERIPHERAL_ERROR_RESOURCE_BUSY Device is in use
- * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
  * @retval #PERIPHERAL_ERROR_UNKNOWN Unknown internal error
  *
  * @post peripheral_spi_close()
@@ -1234,11 +1234,11 @@ EXPORT_API int peripheral_spi_open(int bus, int cs, peripheral_spi_h *spi);
  *
  * @return 0 on success, otherwise a negative error value
  * @retval #PERIPHERAL_ERROR_NONE Successful
- * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
- * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
+ * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
  * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
+ * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
  * @retval #PERIPHERAL_ERROR_UNKNOWN Unknown internal error
  *
  * @see peripheral_spi_open()
@@ -1257,11 +1257,11 @@ EXPORT_API int peripheral_spi_close(peripheral_spi_h spi);
  *
  * @return 0 on success, otherwise a negative error value
  * @retval #PERIPHERAL_ERROR_NONE Successful
- * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
- * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
+ * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
  * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
+ * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
  * @retval #PERIPHERAL_ERROR_UNKNOWN Unknown internal error
  *
  * @see peripheral_spi_mode_e
@@ -1281,11 +1281,11 @@ EXPORT_API int peripheral_spi_set_mode(peripheral_spi_h spi, peripheral_spi_mode
  *
  * @return 0 on success, otherwise a negative error value
  * @retval #PERIPHERAL_ERROR_NONE Successful
- * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
- * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
+ * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
  * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
+ * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
  * @retval #PERIPHERAL_ERROR_UNKNOWN Unknown internal error
  *
  * @see peripheral_spi_bit_order_e
@@ -1304,11 +1304,11 @@ EXPORT_API int peripheral_spi_set_bit_order(peripheral_spi_h spi, peripheral_spi
  *
  * @return 0 on success, otherwise a negative error value
  * @retval #PERIPHERAL_ERROR_NONE Successful
- * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
- * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
+ * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
  * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
+ * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
  * @retval #PERIPHERAL_ERROR_UNKNOWN Unknown internal error
  */
 EXPORT_API int peripheral_spi_set_bits_per_word(peripheral_spi_h spi, uint8_t bits);
@@ -1326,11 +1326,11 @@ EXPORT_API int peripheral_spi_set_bits_per_word(peripheral_spi_h spi, uint8_t bi
  *
  * @return 0 on success, otherwise a negative error value
  * @retval #PERIPHERAL_ERROR_NONE Successful
- * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
- * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
+ * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
  * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
+ * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
  * @retval #PERIPHERAL_ERROR_UNKNOWN Unknown internal error
  */
 EXPORT_API int peripheral_spi_set_frequency(peripheral_spi_h spi, uint32_t freq_hz);
@@ -1348,11 +1348,11 @@ EXPORT_API int peripheral_spi_set_frequency(peripheral_spi_h spi, uint32_t freq_
  *
  * @return 0 on success, otherwise a negative error value
  * @retval #PERIPHERAL_ERROR_NONE Successful
- * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
- * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
+ * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
  * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
+ * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
  * @retval #PERIPHERAL_ERROR_UNKNOWN Unknown internal error
  *
  * @see peripheral_spi_write()
@@ -1372,11 +1372,11 @@ EXPORT_API int peripheral_spi_read(peripheral_spi_h spi, uint8_t *data, uint32_t
  *
  * @return 0 on success, otherwise a negative error value
  * @retval #PERIPHERAL_ERROR_NONE Successful
- * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
- * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
+ * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
  * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
+ * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
  * @retval #PERIPHERAL_ERROR_UNKNOWN Unknown internal error
  *
  * @see peripheral_spi_read()
@@ -1397,11 +1397,11 @@ EXPORT_API int peripheral_spi_write(peripheral_spi_h spi, uint8_t *data, uint32_
  *
  * @return 0 on success, otherwise a negative error value
  * @retval #PERIPHERAL_ERROR_NONE Successful
- * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
- * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
+ * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
  * @retval #PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
  * @retval #PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
+ * @retval #PERIPHERAL_ERROR_IO_ERROR I/O operation failed
+ * @retval #PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
  * @retval #PERIPHERAL_ERROR_UNKNOWN Unknown internal error
  *
  * @see peripheral_spi_read()