串口通讯控件MyComm使用手册

串口通讯控件MyComm用于通过浏览器和串口通讯，目前主要用于和银行的POS机通讯。

 

• 报文格式
  • 报文的格式通常为：前缀 + 数据长度 + 数据 + 后缀。
  • MyComm参数含义
    • msgString：为发送到串口的数据（编码后的）；
    • lenDataStart为返回数据串中数据长度域起始位置（从1开始）；
    • lenDataEnd 为返回数据串中数据长度域结束位置（从1开始）；
    • appendLength 为附加数据长度（数据域之后的附加字符的长度）。
  • 报文示例：如返回报文~~00160400111111111111XXXXXXXX^^，其中~~为前缀，之后4位为数据长度域(数据0016)，数据为400111111111111，XXXXXXXX^^为后缀。则对应的参数值为lenDataStart=3 ,lenDataEnd=6 ,appendLength=10
• 使用方法
  • Request接口为:Public Function Request(ByVal msgString As String, ByVal lenDataStart As Integer, ByVal lenDataEnd As Integer, ByVal appendLength As Integer) As String
  • RequestWithLen接口为：Public Function RequestWithLen(ByVal msgString As String, ByVal lenDataStart As Integer, ByVal lenDataEnd As Integer, ByVal appendLength As Integer, ByVal customDataLen As Integer) As String
• 控件设置方法
  • 超时设置：Public Sub SetMaxTimeOut(maxTimeOut As Integer)。在JavaScript调用request向串口发送数据前调用，MyComm从发送数据给串口时开始计时，如果超过规定时间还没有收到完整应答，则抛出超时错误。由于银行的POS机一般设置超时时间为90秒至120秒，如果这段时间内银行内部服务还没有处理完毕，则POS抛出异常。所以MyComm设置的默认超时为120秒。
  • 编码方法设置：Public Sub SetHexEncode(hexEncodeMode As Boolean)。传入true时设置为16进制编码，传入false设置为Base64编码。
  • 中断控制：Public Sub BreakComm()。调用此方法即可以直接中断接收。
  • 通讯设置：
    • 设置端口号：Public Sub SetCommPort(commPortNo As Integer)。默认为Com1口
    • 设置波特率：Public Sub SetCommSettings(commSettingsString As String)。默认为"9600,N,8,1"，即使用9600 波特，无奇偶校验，8 位数据，一个停止位。
    • 设置输入长度：Public Sub SetCommInputLen(commInputLength As Integer)。默认为0，即读入整个缓冲区。
    • 设置传输数据类型：Public Sub SetCommInputMode(commInputModeType As Integer) 。默认为传输二进制数据。
• FAQ
  • 无返回数据时如何调用？
    • 如向串口发送数据，无返回数据时调用方法为RequestWithLen("XXX",0,0,0,0);
  • 如何自行变更端口号？
    • 在页面上新增一个域，输入端口号，利用Javascript改变控件的端口号，如访问Com2口代码为:SetCommPort(2)
  • 版本兼容么？
    • MyComm目前存在多个版本：17版本采用Base64编码数据，19版本采用16进制编码数据，27版本及以后同时支持Base64编码和16进制编码。(因为用js传送数据时，如果数据中存在加号'+',则后台收到的时候会变为空格' '，如此则解码时出现一位的不同。故17版本变为19版本) 
  • Base64如何编码解码？
    • 编码：String valueString = new BASE64Encoder().encode(values);
    • 解码：byte[] data = new BASE64Decoder().decodeBuffer(msg);
  • 16进制如何编码解码？
    • 编码：String valueString = CodeUtils.byteArrayToHexString(values, false);
    • 解码：byte[] data = CodeUtils.hexStringToByteArray(msg);