BionxControl/bcvalue.h

/***************************************************************************

  BionxControl
  © 2025 -2026 christoph holzheuer
  christoph.holzheuer@gmail.com

  Using:

  mhsMEMBER _canMEMBER _drv.c
  © 2011 - 2023 by MHS-Elektronik GmbH & Co. KG, Germany
  Klaus Demlehner, klaus@mhs-elektronik.de
  @see www.mhs-elektronik.de

  Based on Bionx data type descriptions from:

  BigXionFlasher USB V 0.2.4 rev. 97
  © 2011-2013 by Thomas Koenig <info@bigxionflasher.org>
  @see www.bigxionflasher.org

  Bionx Bike Info
  © 2018 Thorsten Schmidt (tschmidt@ts-soft.de)
  @see www.ts-soft.de

  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.
  @see https://github.com/bikemike/bionx-bikeinfo

 ***************************************************************************/


#ifndef BC_VALUEMEMBER_H
#define BC_VALUEMEMBER_H

#include <expected>


#include <bc.h>

/*
  Werte haben verschiedene Längen (1,2 und 4 Byte) und werder auf unterschiedliche Art und Weise
  ausgelesen und geschrieben (Siehe BCValueTypeWord). Sie können also Wert-Typen zugeordnet werden. Ein Werttyp
  lässet über eine ID identifizieren, die mit der phyikalische Einheit des Wertes überschneiden kann,
  aber nicht muss: : Km/h, kWh, BCValueTypeWord ... bilden eigene Typen, SoC, Assistence Level sind auch eigene Typen,
  Teilen sich jedoch die Einheit '%'.

  Das ist natürlich annalog zu den ItemTypes:
  - ein Value hat einen ValueType, der bestimmt folgendes:
    - long or short or quad
    - unit (mm, km/h, odo ... )
    -
*/

using OptDouble = std::optional<double>;

// Enthält den gelesenen Wert oder einen Fehlerstring
using TransmitResult = std::expected<uint32_t,QString>;
// Funktionsobject, um Werte aus der Transmitterschicht zu holden
//using ReadValueFunc = std::function<TransmitResult( const BCAbstractTransmitter& transmitter, uint32MEMBER _t deviceID, uint8MEMBER _t registerID )>;

class BCValue
{
  Q_GADGET

  friend class BCXmlLoader;

public:

  // Aus dem Type ergibt sich
  // später der Editor
  enum class ValueType : uint8_t
  {
    Plain, // nur lesen, sowas wie SerialNo
    Bool,
    Number,
    Float
  };

  enum class Flag : uint8_t
  {
    NoFlag   = 0x00,
    ReadMe   = 0x01,
    WriteMe  = 0x02,
    ReadOnly = 0x04,
    Locked   = 0x08,
    Failed   = 0x10,
    InSync   = 0x20,
    OK       = 0x40,
    IsWord   = 0x80
  };
  Q_DECLARE_FLAGS(Flags, Flag )
  Q_FLAG(Flags)

  //Q_PROPERTY(Flags        valueFlags MEMBER _valueFlags )
  Q_PROPERTY(BCDevice::ID deviceID    MEMBER _deviceID READ deviceID )
  Q_PROPERTY(BC::ID       registerID  MEMBER _registerID READ registerID )
  Q_PROPERTY(ValueType    valueType   MEMBER _valueType READ valueType )
  Q_PROPERTY(int          indexRow    MEMBER _indexRow READ indexRow)
  Q_PROPERTY(QString      label       MEMBER _label READ label )
  Q_PROPERTY(uint32_t     rawValue    MEMBER _rawValue READ rawValue )
  Q_PROPERTY(QString      unitLabel   MEMBER _unitLabel READ unitLabel )
  Q_PROPERTY(double       factor      MEMBER _factor )
  //QMEMBER _PROPERTY(OptDouble        MEMBER _optMin)
  //QMEMBER _PROPERTY(OptDouble        MEMBER _optMax)

  struct ValueRange
  {
    int    value{0};
    int    min{0};
    int    max{0};
    double ratio{1};
  };

  BCValue( BCDevice::ID deviceID, BC::ID registerID );

  QString         formatValue() const;
  double          calcMinMaxRatio() const;
  void            dumpValue() const;
  bool            isWord() const;
  bool            isReadOnly() const;

  bool            testFlag( Flag flag ) const;
  void            setFlag( Flag flag, bool state=true ) const;

  BCDevice::ID    deviceID() const noexcept;
  BC::ID          registerID() const noexcept;

  uint32_t        rawValue() const noexcept;
  void            setRawValue(uint32_t newRawValue) const;
  void            setFromDouble( double value );

  ValueType       valueType() const noexcept;
  int             indexRow() const noexcept;

  void            setIndexRow(int newIndexRow);
  QString         label() const;
  QString         unitLabel() const;

  bool            valuesForSlider( ValueRange& valueRange ) const;

  QString         toString() const;

protected:

  mutable Flags    _valueFlags{BCValue::Flag::NoFlag};
  BCDevice::ID     _deviceID{BCDevice::ID::Invalid};
  BC::ID           _registerID{BC::ID::Invalid};
  ValueType        _valueType{ValueType::Plain};
  int              _indexRow{-1};
  QString          _label;
  mutable uint32_t _rawValue{};
  QString          _unitLabel;
  double           _factor{1};
  OptDouble        _optMin;
  OptDouble        _optMax;

};
Q_DECLARE_OPERATORS_FOR_FLAGS(BCValue::Flags)
Q_DECLARE_METATYPE(BCValue::Flags)

using BCValuePtr      = std::shared_ptr<BCValue>;
using BCValuePtrConst = std::shared_ptr<const BCValue>;
//using BCValueList = QList<BCValue>;
using BCValueList = QList<BCValuePtr>;

Q_DECLARE_METATYPE(const BCValuePtr)
Q_DECLARE_METATYPE(BCValueList)

// Generischer Operator für ALLE GADGETs
inline QTextStream& operator<<(QTextStream& out, const BCValue& obj);

#endif // BCVALUE_H