En esta página

Qt CoAP Descripción general

El Protocolo de Aplicaciones con Recursos Limitados (CoAP) es un protocolo de IoT diseñado específicamente para el intercambio de datos M2M entre dispositivos con recursos limitados (como los microcontroladores) en redes con recursos limitados.

El modelo de interacción de CoAP es similar al modelo cliente/servidor de HTTP, pero, a diferencia de este, utiliza un transporte sin conexión orientado a datagramas, como el UDP, lo que se traduce en una sobrecarga muy baja y permite utilizar la difusión y la multidifusión UDP para el direccionamiento. Al mismo tiempo, proporciona mecanismos ligeros de fiabilidad y seguridad.

Qt CoAP implementa el lado cliente de CoAP. El transporte predeterminado se basa en QUdpSocket, y QDtls proporciona seguridad únicamente cuando se selecciona un modo seguro; por defecto, no hay ningún modo de seguridad habilitado (véase Seguridad). Se pueden utilizar transportes alternativos implementando la interfaz QCoapConnection.

Modelo de mensajería

El modelo de mensajería de CoAP se basa en el intercambio de mensajes entre puntos finales: los clientes realizan solicitudes a los servidores; los servidores envían respuestas. Los clientes pueden realizar operaciones GET, PUT, POST y DELETE sobre los recursos. También pueden descubrir recursos en un servidor mediante solicitudes de descubrimiento, o en la red local, mediante solicitudes de descubrimiento por multidifusión. Asimismo, es posible suscribirse a un recurso mediante una solicitud de observación.

La fiabilidad de la transferencia se consigue marcando un mensaje como confirmable (CON). Un mensaje confirmable se retransmite utilizando un tiempo de espera predeterminado y un retroceso exponencial entre retransmisiones, hasta que el destinatario envía un mensaje de acuse de recibo (ACK). Cuando el destinatario no puede procesar un mensaje confirmable, responde con un mensaje de reinicio (RST) en lugar de un acuse de recibo.

Un mensaje que no requiera una transmisión fiable puede enviarse como mensaje no confirmable (NON).

Uso de la API « Qt CoAP »

La comunicación del cliente con el servidor CoAP se realiza mediante la clase ` QCoapClient `. Esta contiene los métodos para enviar diferentes solicitudes CoAP y las señales que se activan cuando llegan las respuestas a la solicitud enviada. La clase ` QCoapRequest ` se utiliza para crear solicitudes CoAP. La respuesta del servidor se devuelve en un objeto ` QCoapReply `. Por ejemplo:

QCoapClient *client = new QCoapClient();
connect(client, &QCoapClient::finished, this, &MyClass::onFinished);
connect(client, &QCoapClient::error, this, &MyClass::onError);

QCoapRequest request(QUrl("coap://127.0.0.1/test"), QCoapMessage::Confirmable);
client->get(request);
client->put(request, QByteArray("payload"));

Funcionalidades compatibles

Descubrimiento de recursos

Las solicitudes de descubrimiento CoAP se utilizan para consultar los recursos disponibles en un punto final o en toda la red. Esto es realmente importante para las aplicaciones M2M, en las que no interviene el ser humano. Por ejemplo, en la domótica o la automatización de edificios, es necesario que los clientes y servidores locales se localicen e interactúen entre sí sin intervención humana. El descubrimiento de recursos permite a los clientes conocer los puntos finales disponibles en la red.

Qt CoAP Admite solicitudes de descubrimiento dirigidas a un único punto final y a grupos de multidifusión. Por ejemplo, una solicitud de descubrimiento dirigida a /.well-known/core, que es el punto de entrada predeterminado para el descubrimiento de recursos, puede devolver algo como:

RES: 2.05 Content
</sensors/temp>;rt="temperature-c";if="sensor";obs,
</sensors/light>;rt="light-lux";if="sensor",
</firmware/v2.1>;rt="firmware";sz=262144

Lo que indica que hay recursos para sensores de temperatura y de luz, así como un recurso de firmware, disponibles en la red. La respuesta se representa en formato CoRE Link.

La clase especializada QCoapResourceDiscoveryReply se utiliza para obtener las respuestas de descubrimiento:

// This will make a multicast discovery request to the CoAP IPv4 multicast group.
QCoapResourceDiscoveryReply *discoverReply = client->discover();
connect(discoverReply, &QCoapResourceDiscoveryReply::discovered, this, &MyClass::onDiscovered);

QCoapResourceDiscoveryReply::discovered devolverá la lista de recursos CoAP encontrados en la red.

Observación de recursos

Las solicitudes de observación se utilizan para recibir notificaciones automáticas del servidor sobre un recurso. El cliente se convierte en observador de un recurso observable al enviar una solicitud de observación a dicho recurso. Por ejemplo, el sensor de temperatura del ejemplo anterior es observable, ya que cuenta con el atributo « obs ». Así, el cliente puede suscribirse a las actualizaciones de temperatura enviándole una solicitud de observación.

El siguiente código de ejemplo muestra cómo enviar solicitudes de observación utilizando Qt CoAP:

QCoapReply *reply = client->observe(QUrl("127.0.0.1/temp"));
connect(reply, &QCoapReply::notified, this, &MyClass::onNotified);

En el caso concreto de las solicitudes «observe», puedes utilizar la señal « QCoapReply::notified » para gestionar las notificaciones del servidor CoAP.

Transferencias por bloques

Dado que CoAP se basa en transportes de datagramas como UDP, existen límites en cuanto al tamaño que puede tener la representación de un recurso para que se transfiera sin que la fragmentación cause problemas. Qt CoAP admite transferencias por bloques para situaciones en las que la representación de un recurso es mayor de lo que se puede transferir cómodamente en la carga útil de un único datagrama CoAP.

Seguridad

Se definen los siguientes modos de seguridad para CoAP:

  • Clave precompartida: en este modo, el cliente debe enviar al servidor su identidad y la clave precompartida.
  • Clave pública sin certificar: el cliente dispone de un par de claves asimétricas sin certificado (una clave pública sin certificar). El cliente también dispone de una identidad calculada a partir de la clave pública y de una lista de identidades de los nodos con los que puede comunicarse. Qt CoAP aún no ha implementado este modo.
  • Certificado: el cliente dispone de un par de claves asimétricas con un certificado X.509 firmado por una raíz de confianza común.

Dado que CoAP está diseñado para ser un protocolo basado en UDP, el módulo Qt CoAP implementa la seguridad basándose en Datagram TLS (DTLS) sobre UDP. Sin embargo, como se ha mencionado anteriormente, es posible proporcionar un transporte personalizado con otro tipo de seguridad.

Nota: Cuando se proporciona un transporte personalizado, la protección DTLS aquí descrita deja de ser aplicable. La seguridad del intercambio pasa entonces a ser responsabilidad de dicho transporte, que debe proporcionar cifrado, autenticación de pares y estructuración de mensajes adecuados al protocolo en el que se basa. Un transporte que omita cualquiera de estos elementos deja las solicitudes y respuestas desprotegidas, y esta pérdida no es visible para el resto de la aplicación.

Advertencia: Por defecto, Qt CoAP funciona sin seguridad de transporte. A menos que se seleccione un modo seguro, las solicitudes y respuestas se envían como datagramas UDP sin cifrar. Utilice el valor por defecto (QtCoap::NoSecurity) únicamente en redes de plena confianza; en cualquier red no fiable, configure QCoapClient con un modo seguro.

Para proteger el cliente CoAP, se debe especificar uno de los modos de seguridad admitidos al crear el cliente:

QCoapClient *client = new QCoapClient(this, QtCoap::PreSharedKey);

La clase ` QCoapSecurityConfiguration ` se utiliza para especificar los parámetros de seguridad. Por ejemplo, en el modo de clave precompartida, se puede utilizar el siguiente código de ejemplo:

QCoapSecurityConfiguration config;
config.setPreSharedKey("secretPSK");
config.setIdentity("Client_identity");
client->setSecurityConfiguration(config);

Y en el modo de certificado:

QCoapClient *client = new QCoapClient(this, QtCoap::Certificate);
QList<QSslCertificate> localCertificates, caCertificates;
QCoapPrivateKey key;
// Initialize the key and certificates
QCoapSecurityConfiguration config;
config.setLocalCertificateChain(localCertificates);
config.setCaCertificates(caCertificates)
config.setPrivateKey(key);
client->setSecurityConfiguration(config);

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