feat(CSerialPort): #107 add function getErrorMsg

Signed-off-by: itas109 <itas109@qq.com>

Author: itas109

bindings/c/cserialport.cpp

@@ -429,6 +429,17 @@ const char *CSerialPortGetLastErrorMsg(i_handle_t handle)
     return "";
 }
 
+const char *CSerialPortGetErrorMsg(i_handle_t handle, int code)
+{
+    itas109::CSerialPort *pCSP = reinterpret_cast<itas109::CSerialPort *>(handle);
+    if (pCSP)
+    {
+        return pCSP->getErrorMsg(code);
+    }
+
+    return "";
+}
+
 void CSerialPortClearError(i_handle_t handle)
 {
     itas109::CSerialPort *pCSP = reinterpret_cast<itas109::CSerialPort *>(handle);

bindings/c/cserialport.h

@@ -72,6 +72,33 @@ enum FlowControl
     FlowSoftware = 2
 };
 
+enum SerialPortError
+{
+    ErrorOK = 0,
+
+    ErrorFail = -1,
+    ErrorNotImplemented = -2,
+    ErrorInner = -3,
+    ErrorNullPointer = -4,
+    ErrorInvalidParam = -5,
+    ErrorAccessDenied = -6,
+    ErrorOutOfMemory = -7,
+    ErrorTimeout = -8,
+
+    ErrorNotInit = -20,
+    ErrorInitFailed = -21,
+    ErrorAlreadyExist = -22,
+    ErrorNotExist = -23,
+    ErrorAlreadyOpen = -24,
+    ErrorNotOpen = -25,
+    ErrorOpenFailed = -26,
+    ErrorCloseFailed = -27,
+    ErrorWriteFailed = -28,
+    ErrorReadFailed = -29,
+
+    ErrorUnknown = -999,
+};
+
 #ifdef __cplusplus
 extern "C"
 {
@@ -149,6 +176,8 @@ extern "C"
 
     C_DLL_EXPORT const char *CSerialPortGetLastErrorMsg(i_handle_t handle);
 
+    C_DLL_EXPORT const char *CSerialPortGetErrorMsg(i_handle_t handle, int code);
+
     C_DLL_EXPORT void CSerialPortClearError(i_handle_t handle);
 
     C_DLL_EXPORT void CSerialPortSetPortName(i_handle_t handle, const char *portName);

include/CSerialPort/SerialPort.h

@@ -281,6 +281,13 @@ class DLL_EXPORT CSerialPort
      * @return return last error code message 返回错误码信息
      */
     const char *getLastErrorMsg() const;
+    /**
+     * @brief Get the Error Code Message 获取指定错误码信息
+     *
+     * @param code errorCode 错误码
+     * @return return error code message 返回指定错误码信息
+     */
+    const char *getErrorMsg(int code) const;
     /**
      * @brief clear error 清除错误信息
      *

include/CSerialPort/SerialPortBase.h

@@ -207,6 +207,14 @@ class CSerialPortBase
      */
     const char *getLastErrorMsg() const;
 
+    /**
+     * @brief Get the Error Code Message 获取指定错误码信息
+     *
+     * @param code errorCode 错误码
+     * @return return error code message 返回指定错误码信息
+     */
+    const char *getErrorMsg(int code) const;
+
     /**
      * @brief clear error 清除错误信息
      *

src/SerialPort.cpp

@@ -340,6 +340,18 @@ const char *itas109::CSerialPort::getLastErrorMsg() const
     }
 }
 
+const char *itas109::CSerialPort::getErrorMsg(int code) const
+{
+    if (p_serialPortBase)
+    {
+        return p_serialPortBase->getErrorMsg(code);
+    }
+    else
+    {
+        return "";
+    }
+}
+
 void itas109::CSerialPort::clearError()
 {
     if (p_serialPortBase)

src/SerialPortBase.cpp

@@ -69,7 +69,12 @@ int CSerialPortBase::getLastError() const
 
 const char *CSerialPortBase::getLastErrorMsg() const
 {
-    switch (m_lastError)
+    return getErrorMsg(m_lastError);
+}
+
+const char *CSerialPortBase::getErrorMsg(int code) const
+{
+    switch (code)
     {
         case itas109::ErrorOK:
             return "success";