Servidor de frecuencia cardíaca con Bluetooth de bajo consumo
Un ejemplo que muestra cómo configurar y anunciar un servicio GATT. El ejemplo ilustra el uso de las Qt Bluetooth clases de bajo consumo relacionadas con la funcionalidad de los periféricos (esclavos).
El servidor de frecuencia cardíaca Bluetooth Low Energy es una aplicación de línea de comandos que muestra cómo desarrollar un servidor GATT de Bluetooth utilizando el Qt Bluetooth API. La aplicación abarca la configuración de un servicio, su difusión y la notificación a los clientes de los cambios en los valores de las características.
El ejemplo utiliza las siguientes clases de Qt:
- QLowEnergyAdvertisingData
- QLowEnergyAdvertisingParameters
- QLowEnergyServiceData
- QLowEnergyCharacteristicData
- QLowEnergyDescriptorData
- QLowEnergyController
- QLowEnergyService
El ejemplo implementa una aplicación de servidor, lo que significa que no tiene interfaz gráfica de usuario. Para visualizar lo que está haciendo, puedes utilizar el ejemplo «Heart Rate Game», que es básicamente la contraparte del lado del cliente de esta aplicación.
Comprobación del permiso de Bluetooth
Antes de que la aplicación pueda crear un servicio y empezar a anunciarse, tenemos que comprobar si la aplicación tiene permiso para utilizar Bluetooth.
auto permissionStatus = app.checkPermission(QBluetoothPermission{});Solicitar permiso para el Bluetooth
Si el estado de autorización de Bluetooth es indeterminado, debemos solicitar permiso para utilizar Bluetooth.
if (permissionStatus== Qt::PermissionStatus::Undetermined) {
qInfo("Requesting Bluetooth permission ...");
app.requestPermission(QBluetoothPermission{}, [&permissionStatus](const QPermission&permission){
qApp->exit();
permissionStatus = permission.status();
});
// Ahora, esperamos a que se resuelva la solicitud de permiso.
app.exec();
}Configuración de los datos y parámetros publicitarios
Se utilizan dos clases para configurar el proceso de publicidad:
- QLowEnergyAdvertisingData especifica qué información se va a difundir
- QLowEnergyAdvertisingParameters se utiliza para aspectos específicos, como establecer el intervalo de publicidad o controlar qué dispositivos pueden conectarse.
En nuestro ejemplo, simplemente utilizamos los parámetros predeterminados.
La información contenida en el « QLowEnergyAdvertisingData » será visible para otros dispositivos que estén realizando un escaneo en ese momento. Estos pueden utilizarla para decidir si desean establecer una conexión o no. En nuestro ejemplo, incluimos el tipo de servicio que ofrecemos, un nombre que describa adecuadamente nuestro dispositivo para los usuarios y el nivel de potencia de transmisión del dispositivo. Este último dato suele ser útil para los clientes potenciales, ya que pueden calcular a qué distancia se encuentra nuestro dispositivo comparando la intensidad de la señal recibida con la anunciada.
Nota: El espacio para los datos de anuncio es muy limitado (solo 31 bytes en total), por lo que los datos de longitud variable, como el nombre del dispositivo, deben ser lo más breves posible.
QLowEnergyAdvertisingData advertisingData;
advertisingData.setDiscoverability(QLowEnergyAdvertisingData::DiscoverabilityGeneral);
advertisingData.setIncludePowerLevel(true);
advertisingData.setLocalName("HeartRateServer");
advertisingData.setServices(QList<QBluetoothUuid>() << QBluetoothUuid::ServiceClassUuid::HeartRate);Configuración de los datos de servicio
A continuación, configuramos el tipo de servicio que queremos ofrecer. Utilizamos el servicio « Heart Rate » tal y como se define en la especificación de Bluetooth en su forma mínima, es decir, compuesto únicamente por la característica « Heart Rate Measurement ». Esta característica debe admitir la propiedad « Notify » (y ninguna otra), y debe tener un descriptor « Client Characteristic Configuration », que permite a los clientes registrarse para recibir notificaciones sobre los cambios en los valores de las características. Establecemos el valor inicial de la frecuencia cardíaca en cero, ya que de todos modos no se puede leer (la única forma en que el cliente puede obtener el valor es a través de notificaciones).
QLowEnergyCharacteristicData charData;
charData.setUuid(QBluetoothUuid::CharacteristicType::HeartRateMeasurement);
charData.setValue(QByteArray(2, 0));
charData.setProperties(QLowEnergyCharacteristic::Notify);
const QLowEnergyDescriptorData clientConfig(QBluetoothUuid::DescriptorType::ClientCharacteristicConfiguration,
QByteArray(2, 0));
charData.addDescriptor(clientConfig);
QLowEnergyServiceData serviceData;
serviceData.setType(QLowEnergyServiceData::ServiceTypePrimary);
serviceData.setUuid(QBluetoothUuid::ServiceClassUuid::HeartRate);
serviceData.addCharacteristic(charData);Anuncio y escucha de conexiones entrantes
Ahora que ya se han configurado todos los datos, podemos empezar a anunciarnos. Primero creamos un objeto ` QLowEnergyController ` en ` peripheral role ` y lo utilizamos para crear un objeto ` QLowEnergyService ` (dinámico) a partir de nuestro ` QLowEnergyServiceData` (estático). A continuación, llamamos a ` QLowEnergyController::startAdvertising()`. Ten en cuenta que pasamos nuestro ` QLowEnergyAdvertisingData ` dos veces: el primer argumento actúa como los datos de publicidad propiamente dichos, y el segundo como los datos de respuesta al escaneo. Podrían transportar información diferente, pero en este caso no lo necesitamos. También pasamos una instancia de QLowEnergyAdvertisingParameters construida con los valores por defecto, ya que los parámetros de publicidad predeterminados nos sirven. Si un cliente está interesado en el servicio anunciado, ahora puede establecer una conexión con nuestro dispositivo. Cuando eso ocurre, el dispositivo deja de anunciarse y se emite la señal QLowEnergyController::connected().
Nota: Cuando un cliente se desconecta, la publicidad no se reanuda automáticamente. Si quieres que eso ocurra, debes conectarte a la señal « QLowEnergyController::disconnected()» y llamar a « QLowEnergyController::startAdvertising()» en el slot correspondiente.
bool errorOccurred = false;
const std::unique_ptr<QLowEnergyController> leController(QLowEnergyController::createPeripheral());
auto errorHandler = [&leController, &errorOccurred](QLowEnergyController::Error errorCode) {
qWarning().noquote().nospace() << errorCode << " occurred: "
<< leController->errorString();
if (errorCode != QLowEnergyController::RemoteHostClosedError) {
qWarning("Heartrate-server quitting due to the error.");
errorOccurred = true;
QCoreApplication::quit();
}
};
QObject::connect(leController.get(), &QLowEnergyController::errorOccurred, errorHandler);
std::unique_ptr<QLowEnergyService> service(leController->addService(serviceData));
leController->startAdvertising(QLowEnergyAdvertisingParameters(), advertisingData,
advertisingData);
if (errorOccurred)
return-1;Proporcionar la frecuencia cardíaca
Hasta aquí, todo bien. Pero, ¿cómo obtiene realmente un cliente la frecuencia cardíaca? Esto se consigue actualizando periódicamente el valor de la característica correspondiente en el objeto QLowEnergyService que hemos recibido del QLowEnergyController en el fragmento de código anterior. La fuente de la frecuencia cardíaca suele ser algún tipo de sensor, pero en nuestro ejemplo simplemente inventamos valores que oscilan entre 60 y 100. La parte más importante del siguiente fragmento de código es la llamada a QLowEnergyService::writeCharacteristic. Si un cliente está conectado en ese momento y ha habilitado las notificaciones escribiendo en el mencionado Client Characteristic Configuration, recibirá una notificación sobre el nuevo valor.
QTimer heartbeatTimer;
quint8 currentHeartRate = 60;
enum ValueChange { ValueUp, ValueDown } valueChange = ValueUp;
const auto heartbeatProvider = [&service, ¤tHeartRate, &valueChange]() {
QByteArray value;
value.append(char(0)); // Flags that specify the format of the value.
value.append(char(currentHeartRate)); // Actual value.
QLowEnergyCharacteristic characteristic
= service->characteristic(QBluetoothUuid::CharacteristicType::HeartRateMeasurement);
Q_ASSERT(characteristic.isValid());
service->writeCharacteristic(characteristic, value); // Potentially causes notification.
if (currentHeartRate == 60)
valueChange = ValueUp;
else if (currentHeartRate == 100)
valueChange = ValueDown;
if (valueChange == ValueUp)
++currentHeartRate;
else
--currentHeartRate;
};
QObject::connect(&heartbeatTimer, &QTimer::timeout, heartbeatProvider);
heartbeatTimer.start(1000);© 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.