En esta página

QCanBus Class

La clase QCanBus se encarga del registro y la creación de complementos de bus. Más información...

Encabezado: #include <QCanBus>
CMake: find_package(Qt6 REQUIRED COMPONENTS SerialBus)
target_link_libraries(mytarget PRIVATE Qt6::SerialBus)
qmake: QT += serialbus
Heredado de: QObject

Funciones públicas

(since 6.8) QList<QCanBusDeviceInfo> availableDevices(QString *errorMessage = nullptr) const
QList<QCanBusDeviceInfo> availableDevices(const QString &plugin, QString *errorMessage = nullptr) const
QCanBusDevice *createDevice(const QString &plugin, const QString &interfaceName, QString *errorMessage = nullptr) const
QStringList plugins() const

Miembros públicos estáticos

QCanBus *instance()

Descripción detallada

QCanBus carga los complementos de Qt CAN Bus en tiempo de ejecución. La propiedad de los complementos de bus serie se transfiere al cargador.

Documentación de las funciones de miembro

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

Devuelve los dispositivos disponibles para todos los complementos, es decir, todas las interfaces CAN disponibles.

En caso de fallo, el parámetro opcional « errorMessage » devuelve una descripción textual del error.

Nota: Es posible quealgunos complementos no admitan esta función o solo lo hagan parcialmente.

Esta función se introdujo en Qt 6.8.

Véase también createDevice().

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

Devuelve las interfaces disponibles para plugin. En caso de error, el parámetro opcional errorMessage devuelve una descripción textual del error.

Nota: Es posible quealgunos complementos no sean compatibles con esta función o que solo lo sean parcialmente.

Por ejemplo, la siguiente llamada devuelve una lista de todas las interfaces SocketCAN disponibles (que se pueden utilizar para createDevice()):

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

Véase también createDevice().

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

Crea un dispositivo de bus CAN. ` plugin ` es el nombre del complemento tal y como lo devuelve el método ` plugins()`. ` interfaceName ` es el nombre de la interfaz de bus CAN. En caso de error, el parámetro opcional ` errorMessage ` devuelve una descripción textual del error.

La propiedad del complemento devuelto se transfiere al llamante. Devuelve nullptr si no se encuentra ningún dispositivo adecuado.

Por ejemplo, la siguiente llamada se conectaría a la interfaz SocketCAN vcan0:

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

Nota: La función ` interfaceName ` depende del complemento. Consulte la documentación del complemento correspondiente para obtener más información: Complementos de bus CAN. Para obtener una lista de las interfaces disponibles, se puede utilizar ` availableDevices()`.

Véase también availableDevices().

[static] QCanBus *QCanBus::instance()

Devuelve un puntero a la clase ` QCanBus `. El objeto se carga si es necesario. ` QCanBus ` utiliza el patrón de diseño «singleton».

QStringList QCanBus::plugins() const

Devuelve una lista con los identificadores de todos los complementos cargados.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.