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 250000Para 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 100Configuració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 onConfiguració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 72Los 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 vcan0Creació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ón | Descripción |
|---|---|
| QCanBusDevice::LoopbackKey | Para 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::ReceiveOwnKey | La 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::ErrorFilterKey | Un 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::RawFilterKey | Esta 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::BitRateKey | Determina 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::CanFdKey | Esta 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::DataBitRateKey | Esta 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::ProtocolKey | Permite 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:
- QCanBusDevice::resetController() (requiere libsocketcan)
- QCanBusDevice::busStatus() (requiere libsocketcan)
© 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.