Questa è una dimostrazione di come creare un GATT s… Mbed (2023)

Contenuto del file dalla revisione 7:f6814152873c:

/* mbed Microcontroller Library * Copyright (c) 2006-2013 ARM Limited * * Licenza Apache, versione 2.0 (la "Licenza"); * non puoi utilizzare questo file se non in conformità con la Licenza. * È possibile ottenere una copia della Licenza all'indirizzo * * http://www.apache.org/licenses/LICENSE-2.0 * * A meno che non sia richiesto dalla legge applicabile o concordato per iscritto, il software * distribuito sotto la Licenza è distribuito su un "COSÌ COM'È", * SENZA GARANZIE O CONDIZIONI DI ALCUN TIPO, espresse o implicite. * Vedere la Licenza per la lingua specifica che regola le autorizzazioni e * le limitazioni previste dalla Licenza. */ #ifndef __BLE_HEART_RATE_SERVICE_H__#define __BLE_HEART_RATE_SERVICE_H__ #include "BLEDevice.h" /*** @class HeartRateService* @brief Servizio BLE per HeartRate. Questo servizio BLE contiene la posizione del sensore, la frequenza cardiaca in battiti al minuto. 
* Servizio: https://developer.bluetooth.org/gatt/services/Pages/ServiceViewer.aspx?u=org.bluetooth.service.heart_rate.xml 
* Carattere HRM: https://developer. bluetooth.org/gatt/characteristics/Pages/CharacteristicViewer.aspx?u=org.bluetooth.characteristic.heart_rate_measurement.xml 
* Posizione: https://developer.bluetooth.org/gatt/characteristics/Pages/CharacteristicViewer.aspx ?u=org.bluetooth.characteristic.body_sensor_location.xml*/class HeartRateService {public: /** * @enum SensorLocation * @brief Posizione del sensore di frequenza cardiaca sul corpo. */ enum { LOCATION_OTHER = 0, /*!< Altra posizione */ LOCATION_CHEST, /*!< Petto */ LOCATION_WRIST, /*!< Polso */ LOCATION_FINGER, /*!< Dito */ LOCATION_HAND, /*!< Mano */ LOCATION_EAR_LOBE, /*!< Lobo dell'orecchio */ LOCATION_FOOT, /*!< Piede */ }; public: /** * @brief Costruttore con valore del contatore HRM a 8 bit. * * @param[ref] _ble * Riferimento al BLEDevice sottostante. * @param[in] hrmCounter (8-bit) * valore iniziale per il contatore hrm. * @param[in] location * Posizione del sensore. */ HeartRateService(BLEDevice &_ble, uint8_t hrmCounter, uint8_t location) : ble(_ble), valueBytes(hrmCounter), hrmRate(GattCharacteristic::UUID_HEART_RATE_MEASUREMENT_CHAR, valueBytes.getPointer(), valueBytes.getNumValueBytes(), HeartRateValueBytes::MAX_VALUE_BYTES, Gatt Caratteristico: :BLE_GATT_CHAR_PROPERTIES_NOTIFY), hrmLocation(GattCharacteristic::UUID_BODY_SENSOR_LOCATION_CHAR, &posizione), controlPoint(GattCharacteristic::UUID_HEART_RATE_CONTROL_POINT_CHAR, &controlPointValue) { setupService(); } /** * @brief Costruttore con un valore contatore HRM a 16 bit. * * @param[in] _ble * Riferimento al BLEDevice sottostante. * @param[in] hrmCounter (8-bit) * valore iniziale per il contatore hrm. * @param[in] location * Posizione del sensore. */ HeartRateService(BLEDevice &_ble, uint16_t hrmCounter, uint8_t location) : ble(_ble), valueBytes(hrmCounter), hrmRate(GattCharacteristic::UUID_HEART_RATE_MEASUREMENT_CHAR, valueBytes.getPointer(), valueBytes.getNumValueBytes(), HeartRateValueBytes::MAX_VALUE_BYTES, G attCaratteristica: :BLE_GATT_CHAR_PROPERTIES_NOTIFY), hrmLocation(GattCharacteristic::UUID_BODY_SENSOR_LOCATION_CHAR, &posizione), controlPoint(GattCharacteristic::UUID_HEART_RATE_CONTROL_POINT_CHAR, &controlPointValue) { setupService(); } /** * @brief Imposta un nuovo valore a 8 bit per la frequenza cardiaca. * * @param[in] hrmCounter * Frequenza cardiaca in bpm. */ void updateHeartRate(uint8_t hrmCounter) { valueBytes.updateHeartRate(hrmCounter); ble.updateCharacteristicValue(hrmRate.getValueAttribute().getHandle(), valueBytes.getPointer(), valueBytes.getNumValueBytes()); } /** * Imposta un nuovo valore a 16 bit per la frequenza cardiaca. * * @param[in] hrmCounter * Frequenza cardiaca in bpm. */ void updateHeartRate(uint16_t hrmCounter) { valueBytes.updateHeartRate(hrmCounter); ble.updateCharacteristicValue(hrmRate.getValueAttribute().getHandle(), valueBytes.getPointer(), valueBytes.getNumValueBytes()); } /** * Questa richiamata consente a HeartRateService di ricevere aggiornamenti alla * caratteristica controlPoint. * * @param[in] params * Informazioni sulla caratteristica in fase di aggiornamento. */ virtual void onDataWritten(const GattCharacteristicWriteCBParams *params) { if (params->charHandle == controlPoint.getValueAttribute().getHandle()) { /* Fai qualcosa qui se il nuovo valore è 1; altrimenti puoi sovrascrivere questo metodo * estendendo questa classe. * @NOTA: se stai estendendo questa classe, assicurati di chiamare anche * ble.onDataWritten(this, &ExtendedHRService::onDataWritten); in * il tuo costruttore. */ } } private: void setupService(void) { static bool serviceAdded = false; /* Dovremmo aggiungere il servizio di frequenza cardiaca solo una volta. */ if (servizio aggiunto) { return; } GattCharacteristic *charTable[] = {&hrmRate, &hrmLocation, &controlPoint}; GattService hrmService(GattService::UUID_HEART_RATE_SERVICE, charTable, sizeof(charTable) / sizeof(GattCharacteristic *)); ble.addService(hrmService); servizioAggiunto = vero; ble.onDataWritten(this, &HeartRateService::onDataWritten); } private: /* Rappresentazione interna privata per i byte utilizzati per lavorare con il valore della caratteristica della frequenza cardiaca. */ struct HeartRateValueBytes { static const unsigned MAX_VALUE_BYTES = 3; /* FLAGS + fino a due byte per la frequenza cardiaca */ static const unsigned FLAGS_BYTE_INDEX = 0; const statico senza segno VALUE_FORMAT_BITNUM = 0; const statico uint8_t VALUE_FORMAT_FLAG = (1 << VALUE_FORMAT_BITNUM); HeartRateValueBytes(uint8_t hrmCounter) : valueBytes() { updateHeartRate(hrmCounter); } HeartRateValueBytes(uint16_t hrmCounter) : valueBytes() { updateHeartRate(hrmCounter); } void updateHeartRate(uint8_t hrmCounter) { valueBytes[FLAGS_BYTE_INDEX] &= ~VALUE_FORMAT_FLAG; valoreBytes[FLAGS_BYTE_INDEX + 1] = hrmCounter; } void updateHeartRate(uint16_t hrmCounter) { valueBytes[FLAGS_BYTE_INDEX] |= VALUE_FORMAT_FLAG; valoreBytes[FLAGS_BYTE_INDEX + 1] = (uint8_t)(hrmCounter & 0xFF); valoreBytes[FLAGS_BYTE_INDEX + 2] = (uint8_t)(hrmCounter >> 8); } uint8_t *getPointer(void) { return valueBytes; } const uint8_t *getPointer(void) const { return valueBytes; } unsigned getNumValueBytes(void) const { return 1 + ((valueBytes[FLAGS_BYTE_INDEX] & VALUE_FORMAT_FLAG) ? sizeof(uint16_t) : sizeof(uint8_t)); } private: /* Primo byte = valori a 8 bit, nessuna informazione aggiuntiva, Secondo byte = uint8_t Valore HRM */ /* Vedi --> https://developer.bluetooth.org/gatt/characteristics/Pages/CharacteristicViewer.aspx ?u=org.bluetooth.characteristic.heart_rate_measurement.xml */ uint8_t valueBytes[MAX_VALUE_BYTES]; }; privato: BLEDevice &ble; HeartRateValueBytes valoreBytes; uint8_t controlPointValue; GattCaratteristiche hrmRate; ReadOnlyGattCharacteristic hrmLocation; WriteOnlyGattCharacteristic controlPoint;}; #endif /* #ifndef __BLE_HEART_RATE_SERVICE_H__*/