[TSG开发日志2]串口通信?VS下FaroSDK编译环境?一文搞定

发布时间 2023-06-11 21:15:16作者: 轩先生。

艹,不知道为什么我之前写的法如sdk没有保存,总而言之就是莫名其妙整个工程没有了,后来我想了想,也有可能就是我自己删掉了,因为在配置法如工程的时候遇到了一些小问题,不过现在也解决了。

一、关于串口通信:

Qt的确有自己的串口通信类,就是QSerialPort,但是我们在使用过程中因为要更加定制化的使用串口通信类减小开发的难度,所以我们会提供一个串口通信类,也就是这个SerialPortHelper类。

首先我们要知道什么是串口,串口通信就是机器和系统之间的一个通信协议,你可以将它理解为共享内存,可以根据需要向其中写入内容,然后在需要的时候从中读取数据。不过需要注意的是,在Qt的封装下,你不需要知道串口内的数据是否是给你的,还是你发的,因为统统都是你的。

串口通信什么?

大概了解了一下什么是串口通信,那么我们来看一下串口通信的通信手册大概是什么样。

image

由上我们可以看到,串口通信消息大概就是一串16进制的字符按照特定的规定,然后向串口中写入这些消息就可以了。比如前面这三个41 54 64这三个数字就是固定写死的,而36则是这个协议的通信号,是用于区分不同消息码的,比如上述这条指令的消息码是36,另外一条消息

然后后续标了颜色的内容就是实际上这条消息码中具体携带的数据,这个就不过多介绍了。

不过需要注意的是,硬件返回的数据或者向硬件发送的数据不一定都是像人一样的从左到右,有些命令特别是偏长的命令很多都是要求从右到左,也就是常说的小端序,低字节在前高字节在后,比如:
image

给出两端函数示例(实际上这两个函数在Qt中都有,这里只是展示一下具体是什么意思而已):

//将接收到的小端字节序数据转换为无符号整数
QString SerialPortHelper::getLittleEnd(const QByteArray& data)
{
	if (data.size() > 8) return "";
	qulonglong result = 0;
	for (int i = 0; i < data.size(); ++i)
	{
		qulonglong tmp = (uchar)data[i];
		result += tmp <<= i * 8;
	}
	return QString::number(result);
}

//大端字节序数据转换为浮点数
QString SerialPortHelper::getBigEndFlt(const QByteArray& data)
{
	const int fltLen = 4;
	if (data.size() != fltLen) return "null";
	float result = 0;
	uchar fltArr[fltLen];
	for (int i = 0; i < fltLen; ++i)
	{
		fltArr[fltLen - i - 1] = data.at(i);
	}
	return QString::number(*(float*)fltArr, 'f', 9);
}

ok,接下来还有四位数字,这个要分开来说前两位和后两位。

其中前两位是CRC校验码,这个是需要对前面的数字进行一个基本的校验,具体我就不太懂了,这里提供一个函数,供参考:

void SerialPortHelper::CRC16_2(const QByteArray& ba, uchar* crcBuf)
{
	int pos, i;
	uchar* buf = (uchar*)ba.data();
	int len = ba.size();
	unsigned int crc = 0xFFFF;
	for (pos = 0; pos < len; pos++)
	{
		crc ^= (unsigned int)buf[pos]; // XOR byte into least sig. byte of crc
		for (i = 8; i != 0; i--) // Loop over each bit
		{
			if ((crc & 0x0001) != 0) // If the LSB is set
			{
				crc >>= 1; // Shift right and XOR 0xA001
				crc ^= 0xA001;
			}
			else // Else LSB is not set
			{
				crc >>= 1; // Just shift right
			}
		}
	}
	//高低字节转换
	crc = ((crc & 0x00ff) << 8) | ((crc & 0xff00) >> 8);
	//qDebug() << QString().sprintf("CRC:%04x", crc);
	crcBuf[0] = crc >> 8;
	crcBuf[1] = crc;
}

最后两位就是固定的了,用两个固定搭配来分割各种字符段

串口通信使用流程

我们一般使用串口类,主要流程如下:

1.获得基本参数:
我们需要获得这个串口的一些基本参数,其中包含内容如下:

QString portName = "NULL";
int baudRate = 921600;
QSerialPort::DataBits dataBits = QSerialPort::Data8;
QSerialPort::StopBits stopBits = QSerialPort::OneStop;
QSerialPort::Parity parity = QSerialPort::NoParity;

我们需要在启动这个端口调用的时候设置好这些属性,才能获取正确的COM口消息和发送消息,给出一个启动串口的示例:

serialPort = new QSerialPort();
serialPort->setPortName(param.portName);
if (serialPort->open(QIODevice::ReadWrite))
{
	serialPort->setBaudRate(param.baudRate);
	serialPort->setDataBits(param.dataBits);
	serialPort->setStopBits(param.stopBits);
	serialPort->setParity(param.parity);
	//通知串口接收到消息的信号函数
	connect(serialPort, &QSerialPort::readyRead, this, &CarControlModel::dataReceive);	
	qDebug() << "connect:" << param.portName;
	emit checkConnableRetSig(true);

	setStartTime();
	//emit comConnStatus(true);
	return true;

See?其实很简单的的,这个对象实际上就做了一件事,通知你现在来数据了。注意,这个readyRead 并不是发给你接到的数据,而是通知你现在串口接到消息了,而且这个消息还很有可能不是一条一条的,可能是一段一段的,就是消息可能不完整,这里给出一个示例。

void CarControlModel::dataReceive()
{
	if (serialPort != nullptr && serialPort->isOpen())
	{

		QByteArray buffer = serialPort->readAll();
		analysisData(buffer);
	}
}

void CarControlModel::analysisData(const QByteArray& dataArr)
{
	//消息断开的情况
	qDebug() << "recv data: " << dataArr.toHex(' ');
	dataBuff.append(dataArr);
	QList<QByteArray> dataList;
	for (;;)
	{
		int index = dataBuff.indexOf(QByteArray(gEnd, gEndLen));
		if (index == -1) break;
		dataList.append(dataBuff.mid(0, index + gEndLen));
		dataBuff = dataBuff.right(dataBuff.size() - index - gEndLen);
	}
	if (dataList.size() == 0) return;
	。。。。

也就是说,接到串口指令之后可能还需要你做一个解析,把接到的消息拆分出来处理。

向串口发送指令:

发送指令的话,就比较简单了,比如:

qint64 CarControlModel::startCentralCMD()
{
	QByteArray allArr, funDataArr;
	funDataArr.clear();
	funDataArr.append(0x32);
	funDataArr.append(0x01);  //0x01启动中心码盘
	code(allArr, funDataArr);
	return writeData(allArr);
}

//传入功能码数据区,组合成完整的指令存入数组
void CarControlModel::code(QByteArray& allArr, const QByteArray& funDataArr)
{
	allArr.clear();
	allArr.append(gId, gIdLen);
	allArr.append(gAddress, gAddressLen);
	allArr.append(funDataArr);
	uchar crcBuf[gCrcLen];
	CRC16_2(allArr, crcBuf);
	allArr.append((char*)crcBuf, gCrcLen);
	allArr.append(gEnd, gEndLen);
}
//串口发送消息出去
qint64 CarControlModel::writeData(const QByteArray& data)
{
	qDebug() << "send data: " << data.toHex(' ');
	qint64 ret = -1;
	if (serialPort != nullptr && serialPort->isOpen())
	{
		ret = serialPort->write(data);
		if (!serialPort->waitForBytesWritten(10000))
		{
			//emit sendWarningSig("发送失败:" + data.toHex(' '));
			qDebug() << QString("发送失败:" + data.toHex(' '));
		}
	}
	else
	{
		emit sendWarningSig("工控主串口未连接");
	}
	return ret;
}

FaroSDK编译环境 Visual Studio

法如提供的是一套基于Windows COM组件的SDK,这个说实话是有点逆天的,因为实际上很多公司实际上是相当抵触COM组件形式开发的接口,因为这种东西怎么说呢,虽然技术相当成熟而且稳定,但是它是仅限于Windows平台上的接口,这也导致老版FaroSDK只能在Windows平台下进行开发,这导致我们的开发机只能在重型Windows平台下使用,不过也无所谓,因为本身这套系统涉及的IO就大,没必要说一定要在linux下开发。

然后我们来说一下现在这个环境下我们是怎么开发这个东西的。

我们上次看了示例,如下:
image

这个import是什么鬼???不用急,你先这么写着。实际上我们并不是直接去引用系统中的COM组件目录(安装法如SDK实际上就是解压了一个COM组件包,然后把这两个玩意放在一个特定的系统目录下。我们不用这样,先把这两个DLL找出来)

配置环境需要以下几个东西:

faro.ls.sdk.tlh
faro.ls.sdk.tli
faro.ls.sdk.dll

iqopen.dll
iqopen.tli
iqopen.tlh

然后我们需要把.tli 和 .tlh文件 放到Release文件夹下.tlh 文件是 Microsoft Visual Studio 中的类型库头文件。它是由 Visual C++ 编译器根据 COM 类型库自动生成的。

类型库是一种用于描述组件公开的对象、接口和方法的框架,以及如何使用它们的信息。当您创建或使用 COM 组件时,可以选择将其作为类型库公开。

当编译器构建应用程序时,需要了解类型库才能正确地调用组件中的方法。这就是 tlh 文件发挥作用的地方——它包含有关类型库的信息,并允许编译器了解组件中可用的对象、接口和方法。

在 Visual Studio 中,.tlh 文件通常与 .tli 文件配对出现。.tli 文件包含 COM 组件的实现代码。通过引用 .tlh 和 .tli 文件,您可以轻松地使用 COM 组件提供的功能,并加快应用程序构建的速度。

总之,.tlh 文件是一种存储 COM 类型库信息的文件,它由编译器自动生成,并用于编译 COM 组件。

我们在引用这两个DLL 的时候需要在项目属性->c/c++->常规->附加包含目录 中添加上这两个DLL,所以一般我们把这俩玩意放到一个文件夹内,比如:

image

image

ok,一般这个时候就可以编译了