TrafficDataSource_BluetoothLowEnergy.h

/***************************************************************************
 *   Copyright (C) 2025-2026 by Stefan Kebekus                             *
 *   stefan.kebekus@gmail.com                                              *
 *                                                                         *
 *   This program is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU General Public License as published by  *
 *   the Free Software Foundation; either version 3 of the License, or     *
 *   (at your option) any later version.                                   *
 *                                                                         *
 *   This program is distributed in the hope that it will be useful,       *
 *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
 *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
 *   GNU General Public License for more details.                          *
 *                                                                         *
 *   You should have received a copy of the GNU General Public License     *
 *   along with this program; if not, write to the                         *
 *   Free Software Foundation, Inc.,                                       *
 *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
 ***************************************************************************/
 
#pragma once
 
#include <QBluetoothDeviceDiscoveryAgent>
#include <QBluetoothDeviceInfo>
#include <QBluetoothLocalDevice>
#include <QBluetoothPermission>
#include <QBluetoothServiceInfo>
#include <QBluetoothSocket>
#include <QLowEnergyController>
 
#include "traffic/TrafficDataSource_AbstractSocket.h"
 
using namespace Qt::Literals::StringLiterals;
 
 
namespace Traffic {

 
class TrafficDataSource_BluetoothLowEnergy : public TrafficDataSource_AbstractSocket {
    Q_OBJECT
 
public:
    TrafficDataSource_BluetoothLowEnergy(bool isCanonical, const QBluetoothDeviceInfo& info, QObject* parent);
 
    // Standard destructor
    ~TrafficDataSource_BluetoothLowEnergy() override = default;
 
 
 
    //
    // Properties
    //

    Q_PROPERTY(QBluetoothDeviceInfo sourceInfo READ sourceInfo CONSTANT)
 
 
 
    //
    // Getter Methods
    //
 
    
    [[nodiscard]] QString dataFormat() const override { return u"FLARM/NMEA"_s; }

    [[nodiscard]] QString icon() const override { return u"/icons/material/ic_bluetooth.svg"_s; }

    [[nodiscard]] QString sourceName() const override;

    [[nodiscard]] QBluetoothDeviceInfo sourceInfo() const
    {
        return m_info;
    }
 
 
public slots:
    void connectToTrafficReceiver() override;

    void disconnectFromTrafficReceiver() override;
 
private slots:
    // Read and process NMEA sentences
    void onCharacteristicChanged(const QLowEnergyCharacteristic &characteristic, const QByteArray &newValue);
 
    // Device discovery slots
    void onDeviceDiscovered(const QBluetoothDeviceInfo &info);
    void onDiscoveryFinished();
 
    // Handle errors
    void onControlerError(QLowEnergyController::Error error);
 
    void onServiceDiscoveryFinished();
    void onDiscoveryError(QBluetoothDeviceDiscoveryAgent::Error error);
 
    void onServiceStateChanged(QLowEnergyService::ServiceState newState);
 
    void onStateChanged(QLowEnergyController::ControllerState state);
 
private:
    Q_DISABLE_COPY_MOVE(TrafficDataSource_BluetoothLowEnergy)
 
    // Permissions
    QBluetoothPermission m_bluetoothPermission;
 
    // Copied from the constructor
    QBluetoothDeviceInfo m_info;
 
    // Device discovery
    QBluetoothDeviceDiscoveryAgent* m_discoveryAgent = nullptr;
 
    // Helper to setup the controller since we'll recreate it often
    void setupController(const QBluetoothDeviceInfo &info);
    // Deletes and nulls the UART service objects (they are parented to this, not
    // to the controller, so they must be cleaned up explicitly).
    void cleanupServices();
    QLowEnergyController* m_control = nullptr;
 
    QLowEnergyService* m_nordicUARTService = nullptr;
    QBluetoothUuid const nordicUARTServiceUuid {"6e400001-b5a3-f393-e0a9-e50e24dcca9e"};
    QBluetoothUuid const nordicUARTTxCharacteristicID {"6e400003-b5a3-f393-e0a9-e50e24dcca9e"};
 
    QLowEnergyService* m_simpleUARTService = nullptr;
    QBluetoothUuid const simpleUARTServiceUuid {"0000ffe0-0000-1000-8000-00805f9b34fb"};
    QBluetoothUuid const simpleUARTCharacteristicID {"0000ffe1-0000-1000-8000-00805f9b34fb"};
};
 
} // namespace Traffic