En esta página

Uso del complemento SocketCAN

El complemento SocketCAN encapsula la API de sockets de Linux para acceder a los dispositivos CAN. Esta API es un conjunto de controladores CAN de código abierto y una pila de red aportados por Volkswagen Research al núcleo de Linux.

Este complemento requiere un núcleo de Linux compatible con SocketCAN y controladores de dispositivos SocketCAN para el hardware CAN utilizado.

Uso de SocketCAN

Para mostrar una lista de todas las interfaces de red (incluidas las no configuradas), se puede utilizar el comando « ifconfig -a ».

Para utilizar SocketCAN, es necesario cargar los módulos correspondientes del núcleo de Linux y configurar la interfaz de red.

Configuración del hardware CAN real

En esta sección se da por hecho que el controlador del dispositivo ya está cargado (lo más probable es que se haya cargado automáticamente al conectar el hardware CAN).

Configuración predeterminada

Para configurar el dispositivo can0 con una velocidad de transmisión de 250 kbit/s:

sudo ip link set up can0 type can bitrate 250000

Para recuperarse automáticamente de los errores de «bus desactivado» tras 100 milisegundos, se puede utilizar el siguiente comando:

sudo ip link set up can0 type can bitrate 250000 restart-ms 100

Configuración de CAN FD

Para configurar el dispositivo can0 con una velocidad de transmisión de arbitraje de 500 kBit/s y una velocidad de transmisión de datos de 4 MBit/s (para tramas con indicador de cambio de velocidad de transmisión):

sudo ip link set can0 up type can bitrate 500000 dbitrate 4000000 fd on

Configuración de un bus CAN virtual

Nota: Para el uso de CAN FD, la MTU (unidad máxima de transmisión) debe configurarse en 72 bytes.

sudo modprobe vcan
sudo ip link add dev vcan0 type vcan
sudo ip link set up vcan0 mtu 72

Los programas de prueba de línea de comandos que se utilizan a continuación proceden del paquete can-utils:

# Display received CAN messages with absolute timestamps and flags
candump -ta -x vcan0

# Send a CAN FD message with flags BRS and EFI set
cansend vcan0 123##3112233445566778899aabbccddeeff

# Generate random CAN messages
cangen vcan0

Creación de dispositivos de bus CAN

En primer lugar, es necesario comprobar que QCanBus ofrece el complemento deseado:

if (QCanBus::instance()->plugins().contains(QStringLiteral("socketcan"))) {
    // plugin available
}

Donde «socketcan» es el nombre del complemento.

A continuación, se puede establecer una conexión con una interfaz específica:

QString errorString;
QCanBusDevice*device = QCanBus::instance()->createDevice(
    QStringLiteral("socketcan"), QStringLiteral("can0"), &errorString);
if (!device) {
    // Aquí va el manejo de errores
    qDebug << errorString;
} else {
    device->connectDevice();
}

Donde «can0» es el nombre de la interfaz CAN activa. Las interfaces CAN funcionan como interfaces de red normales en los sistemas Linux y se pueden detectar mediante « ifconfig ». Además, el método « availableDevices()» devuelve una lista de los dispositivos disponibles en ese momento.

El dispositivo ya está abierto para escribir y leer tramas CAN:

QCanBusFrame frame;
frame.setFrameId(8);
QByteArray payload("A36E");
frame.setPayload(payload);
device->writeFrame(frame);

La lectura se puede realizar mediante el método ` readFrame()`. Se emite la señal ` framesReceived()` cuando hay al menos una nueva trama disponible para su lectura:

QCanBusFrame frame = device->readFrame();

SocketCAN admite las siguientes configuraciones, que pueden controlarse mediante setConfigurationParameter():

Clave del parámetro de configuraciónDescripción
QCanBusDevice::LoopbackKeyPara satisfacer las necesidades de múltiples usuarios, el bucle de retorno local está activado por defecto. Esto significa que, cada vez que se transmite una trama CAN por el bus CAN, se envía un eco local de dicha trama a todas las aplicaciones conectadas a este dispositivo CAN. Si se activa esta opción, las tramas recibidas se marcan con QCanBusFrame::hasLocalEcho()
QCanBusDevice::ReceiveOwnKeyLa recepción de tramas CAN en el mismo socket que las envió está desactivada por defecto. Al activar esta opción, todas las tramas CAN enviadas al bus CAN aparecen inmediatamente en el búfer de recepción. Esto puede utilizarse para comprobar si el envío se ha realizado correctamente. Si se activa esta opción, las tramas recibidas de este modo se marcan con QCanBusFrame::hasLocalEcho()
QCanBusDevice::ErrorFilterKeyUn controlador de interfaz CAN puede generar las denominadas tramas de mensaje de error, que opcionalmente pueden pasarse a la aplicación del usuario de la misma forma que otras tramas CAN. Los posibles errores se dividen en diferentes clases de error que pueden filtrarse utilizando la máscara de error adecuada. Los valores de la máscara de error se definen en linux/can/error.h.
QCanBusDevice::RawFilterKeyEsta configuración puede contener varios filtros de tipo QCanBusDevice::Filter. Por defecto, la conexión está configurada para aceptar cualquier mensaje del bus CAN.
QCanBusDevice::BitRateKeyDetermina la velocidad de transmisión de la conexión del bus CAN. Se admiten las siguientes velocidades de transmisión: 5000, 10000, 20000, 33000, 47000, 50000, 83000, 95000, 100000, 125 000, 250 000, 500 000, 800 000, 1 000 000. Ten en cuenta que este parámetro de configuración solo se puede ajustar mientras el conector de red CAN ( QCanBusDevice ) no esté conectado. Para configurar este parámetro, se necesita la biblioteca libsocketcan en tiempo de ejecución http://www.pengutronix.de/software/libsocketcan. Por lo general, se necesitan derechos de root para configurar la velocidad de transmisión del bus CAN.
QCanBusDevice::CanFdKeyEsta opción de configuración determina si se pueden enviar o recibir tramas CANFD. Por defecto, esta opción está desactivada. Controla la opción CAN_RAW_FD_FRAMES del socket CAN.
QCanBusDevice::DataBitRateKeyEsta configuración no es compatible con el complemento socketcan. Sin embargo, es posible establecer la velocidad de transmisión al configurar la interfaz de red CAN mediante el comando « ip link ».
QCanBusDevice::ProtocolKeyPermite utilizar otro protocolo dentro de la familia de protocolos PF_CAN. El valor por defecto de esta opción de configuración es CAN_RAW (1).

Por ejemplo:

QList<QCanBusDevice::Filter> list;
QCanBusDevice::Filter f;

// only accept odd numbered frame id of type remote request
// frame can utilize extended or base format
f.frameId = 0x1;
f.frameIdMask = 0x1;
f.format = QCanBusDevice::Filter::MatchBaseAndExtendedFormat;
f.type = QCanBusFrame::RemoteRequestFrame;
list.append(f);

device->setConfigurationParameter(QCanBusDevice::RawFilterKey, QVariant::fromValue(list));
device->setConfigurationParameter(QCanBusDevice::ErrorFilterKey,
                                  QVariant::fromValue(QCanBusFrame::FrameErrors(QCanBusFrame::AnyError)));

SocketCAN admite el formato de trama ampliado y la velocidad de transmisión flexible.

SocketCAN admite las siguientes funciones adicionales:

© 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.