Parcourir la source

ReadMe中,添加串口超时结构体的详细使用方法.

sat23 il y a 3 ans
Parent
commit
47579854ac
1 fichiers modifiés avec 38 ajouts et 1 suppressions
  1. 38 1
      TCLCommand/TCLCommand/ReadMe.txt

+ 38 - 1
TCLCommand/TCLCommand/ReadMe.txt

@@ -45,6 +45,43 @@ StdAfx.h, StdAfx.cpp
 
 应用程序向导使用“TODO:”注释来指示应添加或自定义的源代码部分。
 
+
+/////////////////////////////////////////////////////////////////////////////
+读写超时是在   调用  ReadFile 和  WriteFile   函数读写串口的时候系统提供的超时机制
+
+typedef struct _COMMTIMEOUTS {
+    DWORD ReadIntervalTimeout;          /* Maximum time between read chars. */
+    DWORD ReadTotalTimeoutMultiplier;   /* Multiplier of characters.        */
+    DWORD ReadTotalTimeoutConstant;     /* Constant in milliseconds.        */
+    DWORD WriteTotalTimeoutMultiplier;  /* Multiplier of characters.        */
+    DWORD WriteTotalTimeoutConstant;    /* Constant in milliseconds.        */
+} COMMTIMEOUTS,*LPCOMMTIMEOUTS;
+
+读超时 有两只计算方法
+1:(间隔超时)ReadIntervalTimeout 指定了在接收字符间的最大时间,如果超过了这个时间,ReadFile立即返回。
+2:(总超时)基于要接收的字符数量
+ReadTotalTimeoutMultiplier表示平均读一个字节的时间上限
+ReadTotalTimeoutConstant表示读数据总时间常量
+读数据总超时:ReadTotalTimeoutConstant +(ReadTotalTimeoutMultiplier*要读的字节数)
+读数据超时,两种超时同时有效,当出现任何一种超时时,ReadFile都将返回。
+
+写超时:
+WriteTotalTimeoutMultiplier表示平均写一个字节的时间上限
+WriteTotalTimeoutConstant表示写数据总超时常量
+
+写数据总超时 :WriteTotalTimeoutConstatn +(WriteTotalTimeoutMultiplier *要写的字节数)
+
+具体超时设置
+1:有读间隔超时、读总超时、写总超时,将COMMTIMEOUTS结构5个成员设置为对应值。
+2:没有读间隔超时,有读总超时和写总超时,将RealIntervalTimeou设置为0,其他参数设置为对应值。
+3:不管是否有数据要读取,ReadFile立即返回,将RealIntervalTimeout设置为MAX_DWORD,
+将ReadTotalTimeoutMultiplier和ReadTotalTimeoutConstant都设置为0
+(不立即返回的时候,可以在超时时间内等串口中有新的数据?然后读取,直到超时时间)
+4:ReadFile没有超时设置,直到有适当的字符数返回或者错误发生,函数才返回。
+将 ReadIntervalTimeout、ReadTotalTimeoutMultiplier、ReadTotalTimeoutConstant都设置为0
+5:WriteFile没有超时设置:将WriteTotalTimeoutMultiplier和WriteTotalTimeoutConstant设置为0
+
+
 /////////////////////////////////////////////////////////////////////////////
 Command.data文件格式说明,键值对形式存在[key=value]:
 Key说明:
@@ -55,7 +92,7 @@ option			表示命令类型
 				3、None 表示指令不是查询指令,不用传入外部数据,无查询结果返回;也不是设置指令,不用传入外部数据,无设置结果返回。
 				
 				更确切的说,Get不用传数据,Set要传入数据;
-				Get和Set都要返回除“AB 05 0A DF 4E”外的第二段串口数据(失败除外),而None只返回一段类似“AB 05 0A DF 4E”的数据。
+				Get和Set都要返回除“AB 05 0A DF 4E”外的第二段串口数据(失败除外),而None只返回一段“AB 05 0A DF 4E”的数据。
 				
 head			表示命令的协议头,以十六进制字符表示,多个字节以空格隔开;
 cmd				表示命令的具体指令,以十六进制字符表示,只有有且一个字节;