QCanBus Class

成员函数文档

[since 6.8] QList<QCanBusDeviceInfo> QCanBus::availableDevices(QString *errorMessage = nullptr) const

返回所有插件的可用设备，即所有可用的 CAN 接口。

如果操作失败，可选参数errorMessage 将返回一条文本形式的错误描述。

此函数于 Qt 6.8 中引入。

另请参阅 createDevice()。

QList<QCanBusDeviceInfo> QCanBus::availableDevices(const QString &plugin, QString *errorMessage = nullptr) const

返回plugin 的可用接口。如果操作失败，可选参数errorMessage 将返回一个文本形式的错误描述。

例如，以下调用将返回所有可用 SocketCAN 接口的列表（这些接口可用于createDevice()）：

QString errorString;
constQList<QCanBusDeviceInfo>devices=QCanBus::instance()->availableDevices(
    QStringLiteral("socketcan"), &errorString);
if(!errorString.isEmpty())
    qDebug() << errorString;

另请参阅 createDevice()。

QCanBusDevice *QCanBus::createDevice(const QString &plugin, const QString &interfaceName, QString *errorMessage = nullptr) const

创建一个CAN总线设备。plugin 是plugins()方法返回的插件名称。interfaceName 是CAN总线接口名称。如果操作失败，可选参数errorMessage 将返回一条文本形式的错误描述。

返回的插件的所有权将转移给调用方。如果找不到合适的设备，则返回nullptr 。

例如，以下调用将连接到 SocketCAN 接口 vcan0：

QString errorString;
QCanBusDevice*device =QCanBus::instance()->createDevice(
    QStringLiteral("socketcan"), QStringLiteral("vcan0"), &errorString);
if(!device)
    qDebug() << errorString;
else
    device->connectDevice();

另请参阅 availableDevices()。

[static] QCanBus *QCanBus::instance()

返回指向QCanBus 类的指针。如有必要，将加载该对象。QCanBus 采用单例设计模式。

QStringList QCanBus::plugins() const

返回所有已加载插件的标识符列表。