SAMSerial 类 |
命名空间: HslCommunication.Profinet.IDCard
SAMSerial 类型公开以下成员。
名称 | 说明 | |
---|---|---|
BaudRate |
当前连接串口信息的波特率 (继承自 SerialBase。)Baud rate of current connection serial port information | |
CommunicationPipe | (继承自 SerialBase。) | |
ConnectionId |
当前连接的唯一ID号,默认为长度20的guid码加随机数组成,方便列表管理,也可以自己指定 (继承自 BinaryCommunication。)The unique ID number of the current connection. The default is a 20-digit guid code plus a random number. | |
IsClearCacheBeforeRead |
是否在发送数据前清空缓冲数据,默认是false (继承自 SerialBase。)Whether to empty the buffer before sending data, the default is false | |
LogNet |
组件的日志工具,支持日志记录,只要实例化后,当前网络的基本信息,就以DEBUG等级进行输出 (继承自 BinaryCommunication。)The component's logging tool supports logging. As long as the instantiation of the basic network information, the output will be output at DEBUG | |
PortName |
当前连接串口信息的端口号名称 (继承自 SerialBase。)The port name of the current connection serial port information | |
ReceiveEmptyDataCount |
获取或设置连续接收空的数据次数,在数据接收完成时有效,每个单位消耗的时间为SleepTime。 (继承自 SerialBase。)Obtain or set the number of consecutive times to receive empty data, which is valid when the data is received, and the time consumed by each unit is SleepTime | |
ReceiveTimeOut |
获取或设置接收服务器反馈的时间,如果为负数,则不接收反馈 (继承自 BinaryCommunication。)Gets or sets the time to receive server feedback, and if it is a negative number, does not receive feedback | |
RtsEnable |
获取或设置一个值,该值指示在串行通信中是否启用请求发送 (RTS) 信号。 (继承自 SerialBase。)Gets or sets a value indicating whether the request sending (RTS) signal is enabled in serial communication. | |
SendBeforeHex |
获取或设置在发送通信报文前追加发送的字节信息,HEX格式,通常用于lora组网时,需要携带 00 00 00 02 四个字节的站地址功能。 (继承自 BinaryCommunication。)Obtain or set the byte information sent before sending communication packets, HEX format, usually used for LORA networking, you need to carry 00 00 00 02 four-byte station address function. | |
SleepTime |
获取或设置在正式接收对方返回数据前的时候,需要休息的时间,当设置为0的时候,不需要休息。 (继承自 BinaryCommunication。)Get or set the time required to rest before officially receiving the data from the other party. When it is set to 0, no rest is required. |
名称 | 说明 | |
---|---|---|
BuildReadCommand |
根据SAM的实际的指令,来生成实际的指令信息
| |
CheckADSCommandAndSum |
检查当前的指令是否是正确的
| |
CheckADSCommandCompletion |
检查当前的接收数据信息是否一条完整的数据信息
| |
CheckSafeModuleStatus |
检测安全模块状态 Detecting Security Module Status | |
Close |
关闭当前的串口连接 (继承自 SerialBase。)Close the current serial connection | |
DecideWhetherQAMessage |
决定当前的消息是否是用于问答机制返回的消息,默认直接返回 true, 实际的情况需要根据协议进行重写方法 (继承自 BinaryCommunication。)To determine whether the current message is the message returned by the question answering mechanism, the default is true. In actual cases, the rewriting method needs to be performed according to the protocol | |
Dispose |
释放当前的对象
(继承自 SerialBase。) | |
Dispose(Boolean) |
释放当前的对象
(继承自 SerialBase。) | |
Equals | Determines whether the specified object is equal to the current object. (继承自 Object。) | |
ExtraAfterReadFromCoreServer |
和服务器交互完成的时候调用的方法,可以根据读写结果进行一些额外的操作,具体的操作需要根据实际的需求来重写实现 (继承自 BinaryCommunication。)The method called when the interaction with the server is completed can perform some additional operations based on the read and write results. The specific operations need to be rewritten according to actual needs. | |
ExtractIdentityCard |
从数据中提取出真实的身份证信息
| |
ExtractSafeModuleNumber |
提炼安全的模块数据信息
| |
ExtraOnDisconnect |
根据实际的协议选择是否重写本方法,有些协议在断开连接之前,需要发送一些报文来关闭当前的网络通道 (继承自 BinaryCommunication。)Select whether to rewrite this method according to the actual protocol. Some protocols need to send some packets to close the current network channel before disconnecting. | |
ExtraOnDisconnectAsync |
根据实际的协议选择是否重写本方法,有些协议在断开连接之前,需要发送一些报文来关闭当前的网络通道 (继承自 BinaryCommunication。)Select whether to rewrite this method according to the actual protocol. Some protocols need to send some packets to close the current network channel before disconnecting. | |
Finalize | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (继承自 Object。) | |
GetErrorDescription |
获取错误的文本信息
| |
GetHashCode | Serves as the default hash function. (继承自 Object。) | |
GetLogTextFromBinary |
获取当前的报文进行日志记录的时候,是否使用二进制的格式记录,默认返回 LogMsgFormatBinary,重写可以根据session对象分别返回不同记录模式 (继承自 BinaryCommunication。)Whether to log the current packet in binary format, the default return is LogMsgFormatBinary. If you want to override it, different recording modes can be returned according to session | |
GetNationEnumerator |
枚举当前的所有的民族信息,共计五十六个民族
| |
GetNationText |
根据民族的代号来获取到民族的文本描述信息
| |
GetNewNetMessage |
获取一个新的消息对象的方法,需要在继承类里面进行重写 (重写 BinaryCommunicationGetNewNetMessage.)The method to get a new message object needs to be overridden in the inheritance class | |
GetType | Gets the Type of the current instance. (继承自 Object。) | |
InitializationOnConnect |
根据实际的协议选择是否重写本方法,有些协议在创建连接之后,需要进行一些初始化的信号握手,才能最终建立网络通道。 (继承自 BinaryCommunication。)Whether to rewrite this method is based on the actual protocol. Some protocols require some initial signal handshake to establish a network channel after the connection is created. | |
InitializationOnConnectAsync |
根据实际的协议选择是否重写本方法,有些协议在创建连接之后,需要进行一些初始化的信号握手,才能最终建立网络通道。 (继承自 BinaryCommunication。)Whether to rewrite this method is based on the actual protocol. Some protocols require some initial signal handshake to establish a network channel after the connection is created. | |
IsOpen |
获取一个值,指示串口是否处于打开状态 (继承自 SerialBase。)Gets a value indicating whether the serial port is open | |
LogRevcMessage(Byte) |
使用日志记录一个接收的报文信息 (继承自 BinaryCommunication。)` Logs are used to record information about a received packet | |
LogRevcMessage(Byte, PipeSession) |
使用日志记录一个接收的报文信息 (继承自 BinaryCommunication。)` Logs are used to record information about a received packet | |
LogSendMessage(Byte) |
使用日志记录一个发送的报文信息 (继承自 BinaryCommunication。)Logs are used to record information about a send packet | |
LogSendMessage(Byte, PipeSession) |
使用日志记录一个发送的报文信息 (继承自 BinaryCommunication。)Logs are used to record information about a send packet | |
MemberwiseClone | Creates a shallow copy of the current Object. (继承自 Object。) | |
Open |
打开当前的管道信息,返回是否成功打开的结果对象,并通过属性 Content 指示当前是否为新创建的连接对象,如果是,则该值为 true (继承自 SerialBase。) | |
PackCommandWithHeader |
对当前的命令进行打包处理,通常是携带命令头内容,标记当前的命令的长度信息,需要进行重写,否则默认不打包 (继承自 BinaryCommunication。)The current command is packaged, usually carrying the content of the command header, marking the length of the current command, and it needs to be rewritten, otherwise it is not packaged by default | |
PackToSAMCommand |
将指令进行打包成可以发送的数据对象
| |
ReadCard |
读取卡片,如果成功的话,就返回身份证的所有的信息 Read the card, if successful, return all the information of the ID cards | |
ReadFromCoreServer(Byte) |
将二进制的数据发送到管道中去,然后从管道里接收二进制的数据回来,并返回是否成功的结果对象。 (继承自 BinaryCommunication。)Send binary data to the pipeline, and then receive binary data back from the pipeline, and return whether the success of the result object | |
ReadFromCoreServer(IEnumerableByte) |
将多个数据报文按顺序发到设备,并从设备接收返回的数据内容,然后拼接成一个Byte[]信息,需要重写UnpackResponseContent(Byte, Byte)方法才能返回正确的结果。 (继承自 BinaryCommunication。)Send multiple data packets to the device in sequence, and receive the returned data content from the device, and then splicing them into a Byte[] message, you need to rewrite UnpackResponseContent(Byte, Byte) method to return the correct result. | |
ReadFromCoreServer(Byte, Boolean, Boolean) |
将二进制的数据发送到管道中去,然后从管道里接收二进制的数据回来,并返回是否成功的结果对象。 (继承自 BinaryCommunication。)Send binary data to the pipeline, and then receive binary data back from the pipeline, and return whether the success of the result object | |
ReadFromCoreServer(CommunicationPipe, Byte, Boolean, Boolean) |
使用指定的管道来进行数据通信,发送原始数据到管道,然后从管道接收相关的数据返回,本方法无锁
(继承自 BinaryCommunication。) | |
ReadFromCoreServerAsync(Byte) |
将二进制的数据发送到管道中去,然后从管道里接收二进制的数据回来,并返回是否成功的结果对象。 (继承自 BinaryCommunication。)Send binary data to the pipeline, and then receive binary data back from the pipeline, and return whether the success of the result object | |
ReadFromCoreServerAsync(IEnumerableByte) |
将多个数据报文按顺序发到设备,并从设备接收返回的数据内容,然后拼接成一个Byte[]信息,需要重写UnpackResponseContent(Byte, Byte)方法才能返回正确的结果。 (继承自 BinaryCommunication。)Send multiple data packets to the device in sequence, and receive the returned data content from the device, and then splicing them into a Byte[] message, you need to rewrite UnpackResponseContent(Byte, Byte) method to return the correct result. | |
ReadFromCoreServerAsync(Byte, Boolean, Boolean) |
将二进制的数据发送到管道中去,然后从管道里接收二进制的数据回来,并返回是否成功的结果对象。 (继承自 BinaryCommunication。)Send binary data to the pipeline, and then receive binary data back from the pipeline, and return whether the success of the result object | |
ReadFromCoreServerAsync(CommunicationPipe, Byte, Boolean, Boolean) |
使用指定的管道来进行数据通信,发送原始数据到管道,然后从管道接收相关的数据返回,本方法无锁
(继承自 BinaryCommunication。) | |
ReadSafeModuleNumber |
读取身份证设备的安全模块号 Read the security module number of the ID device | |
SearchCard |
寻找卡片,并返回是否成功 Find cards and return success | |
SelectCard |
选择卡片,并返回是否成功 Select card and return success | |
SerialPortInni(ActionSerialPort) |
根据自定义初始化方法进行初始化串口信息 (继承自 SerialBase。)Initialize the serial port information according to the custom initialization method | |
SerialPortInni(String) |
初始化串口信息,9600波特率,8位数据位,1位停止位,无奇偶校验 (继承自 SerialBase。)Initial serial port information, 9600 baud rate, 8 data bits, 1 stop bit, no parity | |
SerialPortInni(String, Int32) |
初始化串口信息,波特率,8位数据位,1位停止位,无奇偶校验 (继承自 SerialBase。)Initializes serial port information, baud rate, 8-bit data bit, 1-bit stop bit, no parity | |
SerialPortInni(String, Int32, Int32, StopBits, Parity) |
初始化串口信息,波特率,数据位,停止位,奇偶校验需要全部自己来指定 (继承自 SerialBase。)Start serial port information, baud rate, data bit, stop bit, parity all need to be specified | |
SetDtuPipe |
将当前的通信对象设置DTU模式,允许传入现成的管道,并返回初始化结果,如果该设备重写了握手报文,就是返回握手结果 (继承自 BinaryCommunication。)Set the current communication object to DTU mode, allow the existing pipe to be passed in, and return the initialization result, if the device rewrites the handshake packet, the handshake result is returned | |
SetDtuPipeAsync |
将当前的通信对象设置DTU模式,允许传入现成的管道,并返回初始化结果,如果该设备重写了握手报文,就是返回握手结果 (继承自 BinaryCommunication。)Set the current communication object to DTU mode, allow the existing pipe to be passed in, and return the initialization result, if the device rewrites the handshake packet, the handshake result is returned | |
ToString | Returns a string that represents the current object. (重写 SerialBaseToString.) | |
UnpackResponseContent |
根据对方返回的报文命令,对命令进行基本的拆包,例如各种Modbus协议拆包为统一的核心报文,还支持对报文的验证 (继承自 BinaryCommunication。)According to the message command returned by the other party, the command is basically unpacked, for example, various Modbus protocols are unpacked into a unified core message, and the verification of the message is also supported |
名称 | 说明 | |
---|---|---|
LogMsgFormatBinary |
设置日志记录报文是否二进制,如果为False,那就使用ASCII码 (继承自 BinaryCommunication。)Set whether the log message is binary, if it is False, then use ASCII code |
名称 | 说明 | |
---|---|---|
ToJsonString |
获取当前对象的JSON格式表示的字符串。 (由 HslExtension 定义。)Gets the string represented by the JSON format of the current object. |
private SAMSerial sAMSerial = new SAMSerial( ); public void Open( ) { // 下面是初始化连接的代码,在读取身份证信息之前需要被调用一次 // The following is the code to initialize the connection. It needs to be called once before reading the ID information. try { sAMSerial.SerialPortInni( sp => { sp.PortName = "COM1"; sp.BaudRate = 115200; sp.DataBits = 0; sp.StopBits = System.IO.Ports.StopBits.None; sp.Parity = System.IO.Ports.Parity.None; } ); sAMSerial.Open( ); } catch (Exception ex) { Console.WriteLine( ex.Message ); } }
// 通常是放到后台进行循环扫描,此处举例开了一个线程的操作,实际上你在开发的时候需要注意GC回收垃圾的事 // Usually it is placed in the background for circular scanning. Here is an example of a thread operation. In fact, you need to pay attention to GC garbage collection when you develop public void StartRead( ) { new Thread( new ThreadStart( ThreadBackgroundReadCard ) ) { IsBackground = true }.Start( ); } private void ThreadBackgroundReadCard( ) { while (true) { Thread.Sleep( 100 ); // 首先进行寻卡,成功才进行下一步 // Find the card first, then proceed to the next step OperateResult search = sAMSerial.SearchCard( ); { if (!search.IsSuccess) { continue; } } Thread.Sleep( 100 ); // 寻卡成功后开始选卡,选卡成功才进行下一步 // Select card after successful card search, then proceed to the next step after successful card selection if (sAMSerial.SelectCard( ).IsSuccess) { OperateResult<IdentityCard> read = sAMSerial.ReadCard( ); if (read.IsSuccess) { // read.Content,详细的身份证信息,需要查看 IdentityCard 类型的定义,包含身份的名字, Console.WriteLine( read.Content.ToString( ) ); } else { Console.WriteLine( $"读卡失败:{read.Message}" ); } } } }