RomanoLorenzo/TrueSignal

1. Clone the repository:

   git clone https://github.com/RomanoLorenzo/TrueSignal.git
   https://github.com/RomanoLorenzo/TrueSignal
   

2. Create and activate a virtual environment (recommended):

   # For Windows
   python -m venv venv
   .\venv\Scripts\activate
   
   

3. Install the required dependencies:

   pip install -r requirements.txt
   

Running the Application

Once the installation is complete, you can run the SignaLab application from the project's root directory:

Ensure your TrueSignal oscilloscope hardware is connected to a USB port before starting the application.

Usage

Connect Hardware: Plug your TrueSignal oscilloscope into a USB port on your computer. Launch SignaLab: Run main.py as described above. Interface: Tabs: Select different views (Combined, Channel 1, Channel 2, Dual View). Controls Panel (Left Sidebar): View: Toggle between Time Domain and FFT for each channel. Trigger: Enable Positive/Negative edge triggers or Derivative trigger. Adjust the derivative threshold. Volt/Div & Time/Div: Use the custom spin boxes and combo boxes to adjust the display scales. Menu Bar: FILE: Save current plot, Quit. DEVICE: (Placeholder for future device-specific actions). VIEW: Quickly switch all plots to Time/Frequency domain, or reset V/Div, T/Div to default. RECORD: Start/Stop timed recording of raw signal data. HELP: View information file. Main Window Buttons (if implemented based on main_window.py): Start/Stop Recording (for on-screen overlay information). python main.py

Project Structure

• .
  • icons/ # Application icons
  • json-styles/ # UI theme files
  • src/ # Source code modules
    • Functions.py # Core GUI logic, signal source, oscilloscope setup
    • OscilloscopeWidget.py # Oscilloscope plot widget classes
    • MenuFunctions.py # Handles menu bar actions
    • trigger_handler.py # Logic for signal triggering
    • custom_spinbox.py # Custom QDoubleSpinBox for stepped values
    • ui_interface.py # Auto-generated UI from Qt Designer
    • ui_main.py # User interface class
  • main.py # Main application entry point
  • main_window.py # MainWindow class, sets up additional UI elements like trigger/recording controls
  • requirements.txt # Python package dependencies
  • README.md # This file

Acknowledgements

• Romano Lorenzo
• Massafra Alessandro