Select a version

Select a version

No results found. Please clear your search and try again.

USS-SWLIB-GAS

Ultrasonic sensing solution (USS) software library for gas metering

Select a version
No results found. Please clear your search and try again.
Latest version
Version: 02.30.00.03
Release date: 05 Feb 2020

Windows Installer for USSSWLib

Checksum

Linux Installer for USSSWLib

Checksum

macOS Installer for USSSWLib

Checksum

Windows Installer for USS Gas Demo for FR604x

Checksum

Linux Installer for USS Gas Demo for FR604x

Checksum

macOS Installer for USS Gas Demo for FR604x

Checksum
lock = Requires export approval (1 minute)
Products
MSP430 microcontrollers
MSP430FR5041 16-MHz MCU with 32 KB FRAM, 12-bit high speed 8 MSPS sigma-delta ADC and integrated sensor AFE MSP430FR5043 16-MHz MCU with 64 KB FRAM, 12-bit high speed 8-MSPS sigma-delta ADC and integrated sensor AFE MSP430FR50431 Ultrasonic Sensing MCU with 64KB FRAM, 12KB RAM, I2C Boot Loader for flow meters MSP430FR6041 16-MHz MCU with 32-KB FRAM, LCD, 12-bit high speed 8-MSPS sigma-delta ADC and integrated sensor AFE MSP430FR6043 Ultrasonic Sensing MCU with 64KB FRAM, 12KB RAM, LCD for gas and water metering applications MSP430FR60431 16-MHz MCU with 64-KB FRAM, LCD, 12-bit high speed 8-MSPS sigma-delta ADC and integrated sensor AFE MSP430FR6045 16-MHz MCU with 128-KB FRAM, LCD, 12-bit high speed 8-MSPS sigma-delta ADC and integrated sensor AFE MSP430FR6047 16-MHz MCU with 256-KB FRAM, LCD, 12-bit high speed 8-MSPS sigma-delta ADC and integrated sensor AFE MSP430FR60471 Ultrasonic Sensing MCU with 256KB FRAM, 8KB RAM, LCD, I2C Bootloader for flow meters
Hardware development
EVM430-FR6043 MSP430FR6043 ultrasonic sensing evaluation module

Documentation

What's new

  • Desing Center
    • Added Configuration->Calibration tab
    • Modified Calibration tab to include 3 new sub tabs:
      • General (new)
      • VFR Flow (updated xml file)
      • VFR Flow + Temperatures (new)
    • VFR Flow + Temperatures (new)
    • Updated generation of USS_userConfig.h
    • Fixed Volume flow rate plot y axis units in Waveform panel
    • Updated accumulated Volume Flow in Waveform panel
  • USS Desing Center Guide
    • Updated the Getting Started section with Water / Gas Quick Start Guides
    • Updated configuration section with new calibration configurations
    • Updated calibration section with 3 new sub tabs:
      • General
      • VFR Flow
      • VFR Flow + Temperatures
  • USS Library
    • Enhancements
      • Updated absTOF_lobeWide to use the same search and tracking method as absTOF_lobe
        • maximum lobe peak variation (gUssSWConfig.algorithmsConfig-maxRatioPeak2PeakVariation)is now used as part of absTOF_lobeWide configuration.
      • Updated absTOF_lobeWide to allow same interpolation correction used in absTOF_lobe vialook-up-tables
        • gUssSWConfig.algorithmsConfig-pInterpCorrectionTablePtr andgUssSWConfig.algorithmsConfig-interpCorrectionTableLenght are now used as part ofabsTOF_lobeWide configuration
      • Updated matlab code in User's Guide to generate Interpolation LUT to print the constants in amore legible format to a filename that is provided as an input to the function
      • Added support for new API USS_getAbsTOFStatus. New API allows users to obtain the internalAbsTOF status.
      • Added support for new API USS_setAbsTOFStatus. New API allows users to set the internal AbsTOFstatus.
      • New USS_Algorithms_User_Configuration parameters:
        • windowingMode: Parameter replacing gUssSWConfig.algorithmsConfig-enableWindowingparameter. Used to configure the windowing mode for Delta ToF estimate.
          • Valid Inputs are: 0 (disable), 1 (estimate), 2 (dynamic), and 3 (static)
            • For backwards compatibility,
              • if previously enableWindowing = false, set windowingMode = 0(disable)
              • if previously enableWindowing = true, set windowingMode = 1(estimate)
        • winPeakIndex2EdgeNumCyles: The number of cycles from peak of signal to edge (or start)of window down ramp (used for dynamic windowing)
      • Added new support for new API USS_getAlgorithmObjPtr. New API allow user to get access to thepointer of the internal library algorithm object.
      • Added new support for new API USS_getAlgorithmObjLength. New API allow user to get access to thelength in bytes of the internal library algorithm object.
      • Abstracted Flow VFR calibration into USS_calibrateVFRFlow API
      • Renamed algorithmsConfig->calibObject.linCalibObject->pMeterConfiguration.alphaMin toconfig->algorithmsConfig->calibObject.linCalibObject->pMeterConfiguration.iq16minimumVFR
      • Updated Flow VFR calibration to fixed point implementation to reduce cycle count
      • Added flow + temperature compensated volume flow rate calibration feature usingUSS_calibrateVFRFlowTemperature API
      • Added temperature estimation API
        • USS_computeTemperature used to estimate temperature using UPS and DNS
        • USS_setTemperature used to input temperature based on external temperature sensor
      • New USS_Algorithms_User_Configuration parameters:
        • volumeCalibrationOption: parameter used to define volume flow calibration mode:USS_Alg_volume_flow_Calibration_Option_disabledUSS_Alg_volume_flow_Calibration_Option_flowUSS_Alg_volume_flow_Calibration_Option_flow_temperature
        • calibObject: parameter used to initialize the calibration object based onvolumeCalibrationOption configuration
        • temperatureCalcOption: parameter used to define temperature estimation mode:USS_Alg_temperature_Calculation_Option_disabledUSS_Alg_temperature_Calculation_Option_enabled
        • tempCalcObject: parameter used to initialize the temperature estimation based on UPS andDNS object
      • Improved memory optimzation compilation for Water & Gas application
        • Removed USS_swapCaptureChannels API
        • Optimized code based on config->measurementConfig->sequenceSelection
        • Optimized code based on config->measurementConfig->pulseConfig->pulseGenMode
      • Added additional scale factor (config->meterConfig->volumeAddlScaleFactor) for larger pipes tobe used by the USS_scaleVolumeFlowRate API only required if volumeFlowRate is greater than 32768
      • Added 2 new APIs to enable accurate measurement rate using background timer
        • USS_configAppTimerPeriod - used to define period in ACLK cycles
        • USS_waitForAppTimerElapse - used to wait for timer to elapse
    • Bug fix
      • Fixed initialization of gUssSWConfig.algorithmsConfig-posSearchRange andgUssSWConfig.algorithmsConfig-negSearchRange to be initialized based on number of samples percycle (SignalSamplingFreqtransducer Freq)
      • Removed error code USS_message_code_algorithm_error_meter_constant_calib, this message wasreturned if the minimum volume flow rate falls outside the lowest alphaMin calibration point.The Flow VFR will now calibrate volumeFlowRate if it is below the lowest minimumVFR withoutreporting an error.
      • Fixed ADC capture USS Design Center packet bug
      • Fixed USS_userConfig.c dependency on intrtplCorrLUT.h compilation bug
      • Fixed tolerance used for USS_verifyHSPLLFrequency to estimate frequency error correctly
      • Removed workaround to scale back hilbert cross threshold
      • Fixed Delta TOF offset correction on DTOF value. Previously it would only impact volume flowrate calculation.
  • Library Example project
    • Enhancements
      • Updated while(1) loop to use new background timer synchronous measurement rate APIs
      • Added UART debug to template project
      • Updated memory allocation of gUSSLEARAMReservedBlock1 to be based on USS_ALG_DTOF_WINDOWING_MODEconfigruation.
    • Bug Fix:
      • None.
  • MSP430FR6043 EVM USS Gas Demo:
    • Enhancements
      • Updated USS_userConfig.h based on USS SW Library 2.30.00.
      • Added support for additional scale factor for VFR used in cases of larger pipes.
      • Updated application to use background timer for accurate periodic measurements.
      • Changed Design Center timer configuration from TIMER_A1 to TIMER_A2.
    • Bug Fix:
      • None
    • Known Issues:
      • Temperature estimation is not supported.

Release Information

The ultrasonic design center is a one stop resource for everything related to ultrasonic sensing technology using MSP430™ microcontrollers (MCUs). It includes tools, graphical user interface (GUI), documentation, software library and application examples for developers to get started with project developments. The ultrasonic design center GUI is a rapid development tool for configuring and customizing various parameters related to transducers, pipe size as well as analyzing and capturing waveforms.