scopesettings.h

Go to the documentation of this file.

// SPDX-License-Identifier: GPL-2.0-or-later

#pragma once

#include <QCoreApplication>
#include <QPointF>

#include "hantekdso/controlspecification.h"
#include "hantekdso/enums.h"
#include "hantekprotocol/definitions.h"
#include "viewconstants.h"
#include <vector>


struct DsoSettingsScopeCursor {
    enum CursorShape { NONE, HORIZONTAL, VERTICAL, RECTANGULAR } shape = NONE;
    QPointF pos[ 2 ] = { { -1.0, -1.0 }, { 1.0, 1.0 } }; 
};

struct DsoSettingsScopeHorizontal {
    Dso::GraphFormat format = Dso::GraphFormat::TY; 
    double frequencybase = 1e3;                     
    DsoSettingsScopeCursor cursor;

    int recordLength = 0;   
    double timebase = 1e-3; 
    double maxTimebase = 1; 
#ifdef Q_PROCESSOR_ARM
    // RPi: Not more often than every 10 ms
    double acquireInterval = 0.010; 
#else
    // other PC: Not more often than every 1 ms
    double acquireInterval = 0.001; 
#endif
    double samplerate = 1e6; 
    int dotsOnScreen = 0;
    double calfreq = 1e3; 
};

struct DsoSettingsScopeTrigger {
    Dso::TriggerMode mode = Dso::TriggerMode::AUTO; 
    double position = 0.5;                          
    Dso::Slope slope = Dso::Slope::Positive;        
    int source = 0;                                 
    int smooth = 0;                                 
};

struct DsoSettingsScopeChannel {
    QString name;         
    bool used = false;    
    bool visible = false; 
    DsoSettingsScopeCursor cursor;
};

struct DsoSettingsScopeSpectrum : public DsoSettingsScopeChannel {
    double offset = 0.0;     
    double magnitude = 20.0; 
};

struct DsoSettingsScopeAnalysis {
    double spectrumReference = 0.0; 
    bool calculateDummyLoad = false;
    unsigned dummyLoad = 50; 
    QString dBsuffixStrings[ 3 ] = { QCoreApplication::translate( "DsoSettingsScopeAnalysis", "V" ),
                                     QCoreApplication::translate( "DsoSettingsScopeAnalysis", "u" ),
                                     QCoreApplication::translate( "DsoSettingsScopeAnalysis", "m" ) };
    int dBsuffixIndex = 0; // dBV is default
    QString dBsuffix() {   // use current index
        return dBsuffixStrings[ dBsuffixIndex ];
    };
    QString dBsuffix( int index ) {
        if ( index >= 0 && index < 3 )       // valid suffix index
            return dBsuffixStrings[ index ]; // show this value
        else
            return QString();
    };
    bool calculateTHD = false;
    bool showNoteValue = false;
};

struct DsoSettingsScopeVoltage : public DsoSettingsScopeChannel {
    double offset = 0.0;              
    double trigger = 0.0;             
    unsigned gainStepIndex = 6;       
    unsigned couplingOrMathIndex = 0; 
    bool inverted = false;            
    double probeAttn = 1.0;           
};

struct DsoSettingsScope {
    std::vector< double > gainSteps = { 2e-2, 5e-2, 1e-1, 2e-1,
                                        5e-1, 1e0,  2e0,  5e0 }; 
    std::vector< DsoSettingsScopeSpectrum > spectrum;            
    std::vector< DsoSettingsScopeVoltage > voltage;              
    DsoSettingsScopeHorizontal horizontal;                       
    DsoSettingsScopeTrigger trigger;                             
    DsoSettingsScopeAnalysis analysis;                           

    int verboseLevel = 0;
    int toolTipVisible = 1; // show hints for beginners, can be disabled in settings dialog
    bool histogram = false;
    bool hasACcoupling = false;
    bool hasACmodification = false;
    bool liveCalibrationActive = false;

    double gain( unsigned channel ) const { return gainSteps[ voltage[ channel ].gainStepIndex ] * voltage[ channel ].probeAttn; }

    bool anyUsed( ChannelID channel ) const { return voltage[ channel ].used || spectrum[ channel ].used; }

    Dso::Coupling coupling( ChannelID channel, const Dso::ControlSpecification *deviceSpecification ) const {
        return deviceSpecification->couplings[ voltage[ channel ].couplingOrMathIndex ];
    }
    // Channels, including math channels
    ChannelID countChannels() const { return ChannelID( voltage.size() ); }

    double getMarker( int marker ) const {
        double x = qBound( MARGIN_LEFT, marker < 2 ? horizontal.cursor.pos[ marker ].x() : 0.0, MARGIN_RIGHT );
        return x;
    }

    void setMarker( unsigned int marker, double value ) {
        if ( marker < 2 )
            horizontal.cursor.pos[ marker ].setX( value );
    }
};