Add optional error callback parameter to serial interface functions

- Enhanced multiple serial interface functions by adding an optional `error_callback` parameter, allowing users to handle errors more effectively.
- Updated documentation across various headers to reflect the new parameter, ensuring clarity and consistency.

This change improves the robustness of the serial API by providing better error handling capabilities.

Author: Katze719

include/cpp_core/interface/serial_abort_read.h

@@ -15,6 +15,7 @@ extern "C"
      * ::cpp_core::StatusCodes::kAbortReadError.
      *
      * @param handle Port handle.
+     * @param error_callback [optional] Callback to invoke on error. Defined in error_callback.h. Default is `nullptr`.
      * @return 0 on success or a negative error code on failure.
      */
     MODULE_API auto serialAbortRead(

include/cpp_core/interface/serial_abort_write.h

@@ -15,6 +15,7 @@ extern "C"
      * ::cpp_core::StatusCodes::kAbortWriteError.
      *
      * @param handle Port handle.
+     * @param error_callback [optional] Callback to invoke on error. Defined in error_callback.h. Default is `nullptr`.
      * @return 0 on success or a negative error code on failure.
      */
     MODULE_API auto serialAbortWrite(

include/cpp_core/interface/serial_clear_buffer_in.h

@@ -15,6 +15,7 @@ extern "C"
      * has not yet read.
      *
      * @param handle Port handle.
+     * @param error_callback [optional] Callback to invoke on error. Defined in error_callback.h. Default is `nullptr`.
      * @return 0 on success or a negative error code on failure.
      */
     MODULE_API auto serialClearBufferIn(

include/cpp_core/interface/serial_clear_buffer_out.h

@@ -15,6 +15,7 @@ extern "C"
      * remaining data.
      *
      * @param handle Port handle.
+     * @param error_callback [optional] Callback to invoke on error. Defined in error_callback.h. Default is `nullptr`.
      * @return 0 on success or a negative error code on failure.
      */
     MODULE_API auto serialClearBufferOut(

include/cpp_core/interface/serial_close.h

@@ -15,6 +15,7 @@ extern "C"
      * (≤ 0) handle is a no-op.
      *
      * @param handle Handle obtained from serialOpen().
+     * @param error_callback [optional] Callback to invoke on error. Defined in error_callback.h. Default is `nullptr`.
      * @return 0 on success or a negative error code on failure.
      */
     MODULE_API auto serialClose(

include/cpp_core/interface/serial_drain.h

@@ -28,6 +28,7 @@ extern "C"
      * @endcode
      *
      * @param handle Port handle.
+     * @param error_callback [optional] Callback to invoke on error. Defined in error_callback.h. Default is `nullptr`.
      * @return 0 on success; negative ::cpp_core::StatusCodes value on error.
      */
     MODULE_API auto serialDrain(

include/cpp_core/interface/serial_get_ports_info.h

@@ -13,7 +13,8 @@ extern "C"
      * The supplied callback is invoked once for every discovered port. All string
      * parameters may be `nullptr` if the information is unknown.
      *
-     * @param function Callback receiving port information.
+     * @param callback_fn Callback receiving port information.
+     * @param error_callback [optional] Callback to invoke on error. Defined in error_callback.h. Default is `nullptr`.
      * @return Number of ports found or a negative error code.
      */
     MODULE_API auto serialGetPortsInfo(

include/cpp_core/interface/serial_in_bytes_total.h

@@ -1,4 +1,5 @@
 #pragma once
+#include "../error_callback.h"
 #include "../module_api.h"
 #include <cstdint>
 
@@ -11,9 +12,13 @@ extern "C"
      * @brief Total number of bytes received since the port was opened.
      *
      * @param handle Port handle.
+     * @param error_callback [optional] Callback to invoke on error. Defined in error_callback.h. Default is `nullptr`.
      * @return Total number of bytes read or a negative error code.
      */
-    MODULE_API auto serialInBytesTotal(int64_t handle) -> int64_t;
+    MODULE_API auto serialInBytesTotal(
+        int64_t        handle,
+        ErrorCallbackT error_callback = nullptr
+    ) -> int64_t;
 
 #ifdef __cplusplus
 }

include/cpp_core/interface/serial_in_bytes_waiting.h

@@ -23,6 +23,7 @@ extern "C"
      * @endcode
      *
      * @param handle Port handle.
+     * @param error_callback [optional] Callback to invoke on error. Defined in error_callback.h. Default is `nullptr`.
      * @return Bytes available for instant reading or a negative error code.
      */
     MODULE_API auto serialInBytesWaiting(

include/cpp_core/interface/serial_open.h

@@ -22,6 +22,7 @@ extern "C"
      * @param data_bits Number of data bits (5–8).
      * @param parity 0 = none, 1 = even, 2 = odd.
      * @param stop_bits 0 = 1 stop bit, 2 = 2 stop bits.
+     * @param error_callback [optional] Callback to invoke on error. Defined in error_callback.h. Default is `nullptr`.
      * @return A positive opaque handle on success or a negative value from ::cpp_core::StatusCodes on failure.
      */
     MODULE_API auto serialOpen(