ussSwLib.h

Go to the documentation of this file.

/* --COPYRIGHT--,TI
 *MSP Source and Object Code Software License Agreement
 *
 *
 **IMPORTANT - PLEASE CAREFULLY READ THE FOLLOWING LICENSE AGREEMENT, WHICH IS LEGALLY BINDING.  AFTER YOU READ IT, YOU WILL BE ASKED WHETHER YOU ACCEPT AND AGREE TO ITS TERMS.  DO NOT CLICK  "I ACCEPT" UNLESS: (1) YOU WILL USE THE LICENSED MATERIALS FOR YOUR OWN BENEFIT AND PERSONALLY ACCEPT, AGREE TO AND INTEND TO BE BOUND BY THESE TERMS; OR (2) YOU ARE AUTHORIZED TO, AND INTEND TO BE BOUND BY, THESE TERMS ON BEHALF OF YOUR COMPANY.
 *
 *
 **Important - Read carefully: This Source and Object Code Software License Agreement ("Agreement") is a legal agreement between you and Texas Instruments Incorporated ("TI").  In this Agreement "you" means you personally if you will exercise the rights granted for your own benefit, but it means your company (or you on behalf of your company) if you will exercise the rights granted for your company's benefit.  The "Licensed Materials" subject to this Agreement include the software programs and any associated electronic documentation (in each case, in whole or in part) that accompany this Agreement, are set forth in the applicable software manifest and you access "on-line", as well as any updates or upgrades to such software programs or documentation, if any, provided to you at TI's sole discretion.  The Licensed Materials are specifically designed and licensed for use solely and exclusively with MSP microcontroller devices manufactured by or for TI ("TI Devices").  By installing, copying or otherwise using the Licensed Materials you agree to abide by the provisions set forth herein.  This Agreement is displayed for you to read prior to using the Licensed Materials.  If you choose not to accept or agree with these provisions, do not download or install the Licensed Materials.
 *
 **Note Regarding Possible Access to Other Licensed Materials:  The Licensed Materials may be bundled with software and associated electronic documentation, if any, licensed under terms other than the terms of this Agreement (in whole or in part, "Other Licensed Materials"), including, for example Open Source Software and/or TI-owned or third party Proprietary Software licensed under such other terms.  "Open Source Software" means any software licensed under terms requiring that (A) other software ("Proprietary Software") incorporated, combined or distributed with such software or developed using such software: (i) be disclosed or distributed in source code form; or (ii) otherwise be licensed on terms inconsistent with the terms of this Agreement, including but not limited to permitting use of the Proprietary Software on or with devices other than TI Devices, or (B) require the owner of Proprietary Software to license any of its patents to users of the Open Source Software and/or Proprietary Software incorporated, combined or distributed with such Open Source Software or developed using such Open Source Software.
 *
 **If by accepting this Agreement, you gain access to Other Licensed Materials, they will be listed in the applicable software manifest.  Your use of the Other Licensed Materials is subject to the applicable other licensing terms acknowledgements and disclaimers as specified in the applicable software manifest and/or identified or included with the Other Licensed Materials in the software bundle.  For clarification, this Agreement does not limit your rights under, or grant you rights that supersede, the terms of any applicable Other Licensed Materials license agreement.  If any of the Other Licensed Materials is Open Source Software that has been provided to you in object code only under terms that obligate TI to provide to you or show you where you can access the source code versions of such Open Source Software, TI will provide to you, or show you where you can access, such source code if you contact TI at Texas Instruments Incorporated, 12500 TI Boulevard, Mail Station 8638, Dallas, Texas 75243, Attention: Contracts Manager, Embedded Processing.  In the event you choose not to accept or agree with the terms in any applicable Other Licensed Materials license agreement, you must terminate this Agreement.
 *
 **1.    License Grant and Use Restrictions.
 *
 **a.    Licensed Materials License Grant.  Subject to the terms of this Agreement, TI hereby grants to you a limited, non-transferable, non-exclusive, non-assignable, non-sublicensable, fully paid-up and royalty-free license to:
 *
 *            i.    Limited Source Code License:  make copies, prepare derivative works, display internally and use internally the Licensed Materials provided to you in source code for the sole purpose of developing object and executable versions of such Licensed Materials, or any derivative thereof, that execute solely and exclusively on TI Devices, for end use in Licensee Products, and maintaining and supporting such Licensed Materials, or any derivative thereof, and Licensee Products.  For purposes of this Agreement, "Licensee Product" means a product that consists of both hardware, including one or more TI Devices, and software components, including only executable versions of the Licensed Materials that execute solely and exclusively on such TI Devices.
 *
 *            ii.    Object Code Evaluation, Testing and Use License:  make copies, display internally, distribute internally and use internally the Licensed Materials in object code for the sole purposes of evaluating and testing the Licensed Materials and designing and developing Licensee Products, and maintaining and supporting the Licensee Products;
 *
 *            iii.    Demonstration License:  demonstrate to third parties the Licensed Materials executing solely and exclusively on TI Devices as they are used in Licensee Products, provided that such Licensed Materials are demonstrated in object or executable versions only and
 *
 *        iv.    Production and Distribution License:  make, use, import, export and otherwise distribute the Licensed Materials as part of a Licensee Product, provided that such Licensee Products include only embedded executable copies of such Licensed Materials that execute solely and exclusively on TI Devices.
 *
 *    b.    Contractors.  The licenses granted to you hereunder shall include your on-site and off-site contractors (either an individual or entity), while such contractors are performing work for or providing services to you, provided that such contractors have executed work-for-hire agreements with you containing applicable terms and conditions consistent with the terms and conditions set forth in this Agreement and provided further that you shall be liable to TI for any breach by your contractors of this Agreement to the same extent as you would be if you had breached the Agreement yourself.
 *
 *    c.    No Other License.  Nothing in this Agreement shall be construed as a license to any intellectual property rights of TI other than those rights embodied in the Licensed Materials provided to you by TI.  EXCEPT AS PROVIDED HEREIN, NO OTHER LICENSE, EXPRESS OR IMPLIED, BY ESTOPPEL OR OTHERWISE, TO ANY OTHER TI INTELLECTUAL PROPERTY RIGHTS IS GRANTED HEREIN.
 *
 *    d.    Covenant not to Sue.  During the term of this Agreement, you agree not to assert a claim against TI or its licensees that the Licensed Materials infringe your intellectual property rights.
 *
 *    e.    Restrictions.  You shall maintain the source code versions of the Licensed Materials under password control protection and shall not disclose such source code versions of the Licensed Materials, to any person other than your employees and contractors whose job performance requires access.  You shall not use the Licensed Materials with a processing device other than a TI Device, and you agree that any such unauthorized use of the Licensed Materials is a material breach of this Agreement.  You shall not use the Licensed Materials for the purpose of analyzing or proving infringement of any of your patents by either TI or TI's customers.  Except as expressly provided in this Agreement, you shall not copy, publish, disclose, display, provide, transfer or make available the Licensed Materials to any third party and you shall not sublicense, transfer, or assign the Licensed Materials or your rights under this Agreement to any third party.  You shall not mortgage, pledge or encumber the Licensed Materials in any way.  You may use the Licensed Materials with Open Source Software or with software developed using Open Source Software tools provided you do not incorporate, combine or distribute the Licensed Materials in a manner that subjects the Licensed Materials to any license obligations or any other intellectual property related terms of any license governing such Open Source Software.
 *
 *    f.    Termination.  This Agreement is effective on the date the Licensed Materials are delivered to you together with this Agreement and will remain in full force and effect until terminated.  You may terminate this Agreement at any time by written notice to TI.  Without prejudice to any other rights, if you fail to comply with the terms of this Agreement or you are acquired, TI may terminate your right to use the Licensed Materials upon written notice to you.  Upon termination of this Agreement, you will destroy any and all copies of the Licensed Materials in your possession, custody or control and provide to TI a written statement signed by your authorized representative certifying such destruction. Except for Sections 1(a), 1(b) and 1(d), all provisions of this Agreement shall survive termination of this Agreement.
 *
 **2.    Licensed Materials Ownership.  The Licensed Materials are licensed, not sold to you, and can only be used in accordance with the terms of this Agreement.  Subject to the licenses granted to you pursuant to this Agreement, TI and its licensors own and shall continue to own all right, title and interest in and to the Licensed Materials, including all copies thereof.  You agree that all fixes, modifications and improvements to the Licensed Materials conceived of or made by TI that are based, either in whole or in part, on your feedback, suggestions or recommendations are the exclusive property of TI and all right, title and interest in and to such fixes, modifications or improvements to the Licensed Materials will vest solely in TI.  Moreover, you acknowledge and agree that when your independently developed software or hardware components are combined, in whole or in part, with the Licensed Materials, your right to use the combined work that includes the Licensed Materials remains subject to the terms and conditions of this Agreement.
 *
 **3.    Intellectual Property Rights.
 *
 *    a.    The Licensed Materials contain copyrighted material, trade secrets and other proprietary information of TI and its licensors and are protected by copyright laws, international copyright treaties, and trade secret laws, as well as other intellectual property laws.  To protect TI's and its licensors' rights in the Licensed Materials, you agree, except as specifically permitted by statute by a provision that cannot be waived by contract, not to "unlock", decompile, reverse engineer, disassemble or otherwise translate to a human-perceivable form any portions of the Licensed Materials provided to you in object code format only, nor permit any person or entity to do so.  You shall not remove, alter, cover, or obscure any confidentiality, trade secret, trade mark, patent, copyright or other proprietary notice or other identifying marks or designs from any component of the Licensed Materials and you shall reproduce and include in all copies of the Licensed Materials the copyright notice(s) and proprietary legend(s) of TI and its licensors as they appear in the Licensed Materials.  TI reserves all rights not specifically granted under this Agreement.
 *
 *    b.    Certain Licensed Materials may be based on industry recognized standards or software programs published by industry recognized standards bodies and certain third parties may claim to own patents, copyrights, and other intellectual property rights that cover implementation of those standards.  You acknowledge and agree that this Agreement does not convey a license to any such third party patents, copyrights, and other intellectual property rights and that you are solely responsible for any patent, copyright, or other intellectual property right claim that relates to your use or distribution of the Licensed Materials or your use or distribution of your products that include or incorporate the Licensed Materials.  Moreover, you acknowledge that you are responsible for any fees or royalties that may be payable to any third party based on such third party's interests in the Licensed Materials or any intellectual property rights that cover implementation of any industry recognized standard, any software program published by any industry recognized standards bodies or any other proprietary technology.
 *
 **4.    Confidential Information.  You acknowledge and agree that the Licensed Materials contain trade secrets and other confidential information of TI and its licensors.  You agree to use the Licensed Materials solely within the scope of the licenses set forth herein, to maintain the Licensed Materials in strict confidence, to use at least the same procedures and degree of care that you use to prevent disclosure of your own confidential information of like importance but in no instance less than reasonable care, and to prevent disclosure of the Licensed Materials to any third party, except as may be necessary and required in connection with your rights and obligations hereunder; provided, however, that you may not provide the Licensed Materials to any business organization or group within your company or to customers or contractors that design or manufacture semiconductors unless TI gives written consent.  You agree to obtain executed confidentiality agreements with your employees and contractors having access to the Licensed Materials and to diligently take steps to enforce such agreements in this respect.  TI may disclose your contact information to TI's licensors.
 *
 **5.    Warranties and Limitations.  THE LICENSED MATERIALS ARE PROVIDED "AS IS".  FURTHERMORE, YOU ACKNOWLEDGE AND AGREE THAT THE LICENSED MATERIALS HAVE NOT BEEN TESTED OR CERTIFIED BY ANY GOVERNMENT AGENCY OR INDUSTRY REGULATORY ORGANIZATION OR ANY OTHER THIRD PARTY ORGANIZATION.  YOU AGREE THAT PRIOR TO USING, INCORPORATING OR DISTRIBUTING THE LICENSED MATERIALS IN OR WITH ANY COMMERCIAL PRODUCT THAT YOU WILL THOROUGHLY TEST THE PRODUCT AND THE FUNCTIONALITY OF THE LICENSED MATERIALS IN OR WITH THAT PRODUCT AND BE SOLELY RESPONSIBLE FOR ANY PROBLEMS OR FAILURES.
 *
 **TI AND ITS LICENSORS MAKE NO WARRANTY OR REPRESENTATION, EITHER EXPRESS, IMPLIED OR STATUTORY, REGARDING THE LICENSED MATERIALS, INCLUDING BUT NOT LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT OF ANY THIRD PARTY PATENTS, COPYRIGHTS, TRADE SECRETS OR OTHER INTELLECTUAL PROPERTY RIGHTS.  YOU AGREE TO USE YOUR INDEPENDENT JUDGMENT IN DEVELOPING YOUR PRODUCTS.  NOTHING CONTAINED IN THIS AGREEMENT WILL BE CONSTRUED AS A WARRANTY OR REPRESENTATION BY TI TO MAINTAIN PRODUCTION OF ANY TI SEMICONDUCTOR DEVICE OR OTHER HARDWARE OR SOFTWARE WITH WHICH THE LICENSED MATERIALS MAY BE USED.
 *
 **IN NO EVENT SHALL TI OR ITS LICENSORS, BE LIABLE FOR ANY SPECIAL, INDIRECT, INCIDENTAL, PUNITIVE OR CONSEQUENTIAL DAMAGES, HOWEVER CAUSED, ON ANY THEORY OF LIABILITY, IN CONNECTION WITH OR ARISING OUT OF THIS AGREEMENT OR THE USE OF THE LICENSED MATERIALS REGARDLESS OF WHETHER TI HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.  EXCLUDED DAMAGES INCLUDE, BUT ARE NOT LIMITED TO, COST OF REMOVAL OR REINSTALLATION, OUTSIDE COMPUTER TIME, LABOR COSTS, LOSS OF DATA, LOSS OF GOODWILL, LOSS OF PROFITS, LOSS OF SAVINGS, OR LOSS OF USE OR INTERRUPTION OF BUSINESS.  IN NO EVENT WILL TI'S OR ITS LICENSORS' AGGREGATE LIABILITY UNDER THIS AGREEMENT OR ARISING OUT OF YOUR USE OF THE LICENSED MATERIALS EXCEED FIVE HUNDRED U.S. DOLLARS (US$500).
 *
 *    Because some jurisdictions do not allow the exclusion or limitation of incidental or consequential damages or limitation on how long an implied warranty lasts, the above limitations or exclusions may not apply to you.
 *
 **6.    Indemnification Disclaimer.  YOU ACKNOWLEDGE AND AGREE THAT TI SHALL NOT BE LIABLE FOR AND SHALL NOT DEFEND OR INDEMNIFY YOU AGAINST ANY THIRD PARTY INFRINGEMENT CLAIM THAT RELATES TO OR IS BASED ON YOUR MANUFACTURE, USE, OR DISTRIBUTION OF THE LICENSED MATERIALS OR YOUR MANUFACTURE, USE, OFFER FOR SALE, SALE, IMPORTATION OR DISTRIBUTION OF YOUR PRODUCTS THAT INCLUDE OR INCORPORATE THE LICENSED MATERIALS.
 *
 **7.    No Technical Support.  TI and its licensors are under no obligation to install, maintain or support the Licensed Materials.
 *
 **8.    Notices.  All notices to TI hereunder shall be delivered to Texas Instruments Incorporated, 12500 TI Boulevard, Mail Station 8638, Dallas, Texas 75243, Attention: Contracts Manager - Embedded Processing, with a copy to Texas Instruments Incorporated, 13588 N. Central Expressway, Mail Station 3999, Dallas, Texas 75243, Attention: Law Department - Embedded Processing.  All notices shall be deemed served when received by TI.
 *
 **9.    Export Control.  The Licensed Materials are subject to export control under the U.S. Commerce Department's Export Administration Regulations ("EAR").  Unless prior authorization is obtained from the U.S. Commerce Department, neither you nor your subsidiaries shall export, re-export, or release, directly or indirectly (including, without limitation, by permitting the Licensed Materials to be downloaded), any technology, software, or software source code, received from TI, or export, directly or indirectly, any direct product of such technology, software, or software source code, to any person, destination or country to which the export, re-export, or release of the technology, software, or software source code, or direct product is prohibited by the EAR.  You represent and warrant that you (i) are not located in, or under the control of, a national or resident of Cuba, Iran, North Korea, Sudan and Syria or any other country subject to a U.S. goods embargo; (ii) are not on the U.S. Treasury Department's List of Specially Designated Nationals or the U.S. Commerce Department's Denied Persons List or Entity List; and (iii) will not use the Licensed Materials or transfer the Licensed Materials for use in any military, nuclear, chemical or biological weapons, or missile technology end-uses.  Any software export classification made by TI shall not be construed as a representation or warranty regarding the proper export classification for such software or whether an export license or other documentation is required for the exportation of such software.
 *
 **10.    Governing Law and Severability; Waiver.  This Agreement will be governed by and interpreted in accordance with the laws of the State of Texas, without reference to conflict of laws principles.  If for any reason a court of competent jurisdiction finds any provision of the Agreement to be unenforceable, that provision will be enforced to the maximum extent possible to effectuate the intent of the parties, and the remainder of the Agreement shall continue in full force and effect.  This Agreement shall not be governed by the United Nations Convention on Contracts for the International Sale of Goods, or by the Uniform Computer Information Transactions Act (UCITA).  The parties agree that non-exclusive jurisdiction for any dispute arising out of or relating to this Agreement lies within the courts located in the State of Texas.  Notwithstanding the foregoing, any judgment may be enforced in any United States or foreign court, and either party may seek injunctive relief in any United States or foreign court.  Failure by TI to enforce any provision of this Agreement shall not be deemed a waiver of future enforcement of that or any other provision in this Agreement or any other agreement that may be in place between the parties.
 *
 **11.    PRC Provisions.  If you are located in the People's Republic of China ("PRC") or if the Licensed Materials will be sent to the PRC, the following provisions shall apply:
 *
 *    a.    Registration Requirements.  You shall be solely responsible for performing all acts and obtaining all approvals that may be required in connection with this Agreement by the government of the PRC, including but not limited to registering pursuant to, and otherwise complying with, the PRC Measures on the Administration of Software Products, Management Regulations on Technology Import-Export, and Technology Import and Export Contract Registration Management Rules.  Upon receipt of such approvals from the government authorities, you shall forward evidence of all such approvals to TI for its records.  In the event that you fail to obtain any such approval or registration, you shall be solely responsible for any and all losses, damages or costs resulting therefrom, and shall indemnify TI for all such losses, damages or costs.
 *
 **b.    Governing Language.  This Agreement is written and executed in the English language and shall be authoritative and controlling, whether or not translated into a language other than English to comply with law or for reference purposes.  If a translation of this Agreement is required for any purpose, including but not limited to registration of the Agreement pursuant to any governmental laws, regulations or rules, you shall be solely responsible for creating such translation.
 *
 **12.    Contingencies.    TI shall not be in breach of this Agreement and shall not be liable for any non-performance or delay in performance if such non-performance or delay is due to a force majeure event or other circumstances beyond TI's reasonable control.
 *
 **13.        Entire Agreement.  This is the entire agreement between you and TI and this Agreement supersedes any prior agreement between the parties related to the subject matter of this Agreement.  Notwithstanding the foregoing, any signed and effective software license agreement relating to the subject matter hereof and stating expressly that such agreement shall control regardless of any subsequent click-wrap, shrink-wrap or web-wrap, shall supersede the terms of this Agreement.  No amendment or modification of this Agreement will be effective unless in writing and signed by a duly authorized representative of TI.  You hereby warrant and represent that you have obtained all authorizations and other applicable consents required empowering you to enter into this Agreement.
 *
 *
 *
 * --/COPYRIGHT--*/

#ifndef _USSSWLIB_H_
#define _USSSWLIB_H_

//#############################################################################
//
//
//  Group:          MSP
//  Target Device:  __DEVICE_NAME__
//
//  (C) Copyright 2018, Texas Instruments, Inc.
//#############################################################################
// TI Release: __PRODUCT_NAME__ 
// Release Date: __PACKAGE_RELEASE_DATE__
//#############################################################################


//*****************************************************************************
// includes
//*****************************************************************************
#include <msp430.h>

#include <stdint.h>
#include <stdbool.h>
#include <QmathLib.h>
#include <IQmathLib.h>

#ifdef __cplusplus

extern "C" {
#endif

//*****************************************************************************
// defines
//*****************************************************************************

#define USS_UUPS_PWR_REQ_IGN_INTERRUPT                    BIT0

#define USS_UUPS_PWR_UP_TM_OUT_INTERRUPT                BIT1

#define USS_SAPH_DATA_ERR_ABORT_INTERRUPT                BIT2

#define USS_SAPH_TMF_TM_OUT_INTERRUPT                    BIT3

#define USS_SAPH_SEQ_ACQ_DN_INTERRUPT                    BIT4

#define USS_SAPH_PING_DN_INTERRUPT                        BIT5

#define USS_HSPLL_PLL_UNLOCK_INTERRUPT                    BIT6
#define USS_SDHS_WINLO_INTERRUPT                        BIT7

#define USS_SDHS_WINHI_INTERRUPT                        BIT8

#define USS_SDHS_DTRDY_INTERRUPT                        BIT9

#define USS_SDHS_SSTRG_INTERRUPT                        BITA

#define USS_SDHS_ACQDONE_INTERRUPT                        BITB

#define USS_SDHS_OVF_INTERRUPT                            BITC

#define USS_TIMER_EXPIRED_INTERRUPT                        BITD

#define USS_SAPH_SEQUENCE_STOPPED                        BITE

#define USS_UUPS_STOPPED_BY_DEBUGGER                    BITF

 #define USS_TIMER_EXPIRED_EVENT1_INTERRUPT             0x10000

 #define USS_SAPH_DMA_ACK_VIOLATION                   (0x00010000)

#define HARDWAREWREG16(x)    (*((volatile uint16_t *)((uint16_t)x)))


// Backwards compatibility defines
// This backwards compatibility layer might be removed in future releases

#define USS_Alg_dToF_Calculation_Option_gas USS_Alg_dToF_Calculation_Option_estimate


//*****************************************************************************
// typedefs
//*****************************************************************************

typedef enum _USS_message_code_
{

        USS_message_code_no_error = 0,

        // 1-20 reserved for SAPH messages
        USS_message_code_SAPH_pulseLowPhasePeriod_error = 1,
        USS_message_code_SAPH_pulseHighPhasePeriod_error = 2,
        USS_message_code_SAPH_numOfExcitationPulses_error = 3,
        USS_message_code_SAPH_numOfStopPulses_error = 4,
        USS_message_code_SAPH_update_error_ongoing_conversion = 5,
        USS_message_code_SAPH_time_startPPGCount_error = 6,
        USS_message_code_SAPH_time_turnOnADCCount_error = 7,
        USS_message_code_SAPH_time_startADCsamplingCount_error = 8,
        USS_message_code_SAPH_time_restartCaptureCount_error = 9,
        USS_message_code_SAPH_time_captureTimeOutCount_error = 10,
        USS_message_code_SAPH_time_startPGAandINBiasCount_error = 11,
        USS_message_code_SAPH_invalid_bias_impedance_error=12,
    USS_message_code_SAPH_invalid_rx_charge_pump_mode_error=13,
    USS_message_code_SAPH_invalid_pulse_configuration_error=14,

        //    21-40 reserved for HSPLL messages
        USS_message_code_HSPLL_pllXtalFreq_inHz_error = 21,
        USS_message_code_HSPLL_pllOutputFreq_inHz_error = 22,
        USS_message_code_HSPLL_plllock_error =23,
        USS_message_code_HSPLL_pll_unlock_error = 24,
        USS_message_code_HSPLL_update_error_ongoing_conversion = 26,
        USS_message_code_HSPLL_verification_expected_count_error=27,
        USS_message_code_HSPLL_invalid_settling_count_error=28,

        // 41-60 reserved for SDHS messages
        USS_message_code_SDHS_threshold_error = 41,
        USS_message_code_SDHS_conversion_overflow_error = 43,
        USS_message_code_SDHS_sample_size_error = 44,
        USS_message_code_SDHS_update_error_ongoing_conversion = 45,
        USS_message_code_SDHS_window_low_threshold_reached = 46,
        USS_message_code_SDHS_window_high_threshold_reached = 47,
        USS_message_code_SDHS_max_size_error = 48,

        // 61-80 reserved for UUPS messages
        USS_message_code_UUPS_update_error_ongoing_conversion = 61,
        USS_message_code_UUPS_power_up_time_out_error = 62,
        USS_message_code_UUPS_power_up_error = 63,
        USS_message_code_UUPS_power_down_error = 64,


        // 81-100 reserved for measurement messages
        USS_message_code_data_error_abort = 81,
        USS_message_code_ASQ_time_out= 82,

        // 101- 120 reserved for stop error messages
        USS_message_code_measurement_stopped = 101,
        USS_message_code_error_conversion_stopped_by_debugger = 102,

        // 121 - 140 reserved for algorithms messages
        USS_message_code_parameter_check_failed = 121,
        USS_message_code_valid_results = 122,
        USS_message_code_algorithm_error = 123,
        USS_message_code_algorithm_error_invalid_iteration_value = 124,
        USS_message_code_algorithm_error_no_signal_detected_ups_channel = 125,
        USS_message_code_algorithm_error_no_signal_detected_ups_dns_channel = 126,
        USS_message_code_algorithm_error_no_signal_detected_dns_channel = 127,
        USS_message_code_algorithm_captures_accumulated = 128,
        USS_message_code_algorithm_error_invalid_clock_relative_error = 129,
        USS_message_code_algorithm_error_invalid_filter_length = 130,
    USS_message_code_algorithm_error_generating_binary_pattern = 131,
    USS_message_code_algorithm_error_invalid_absToF_computation_option = 132,
    USS_message_code_algorithm_error_invalid_meter_constant_calib_data = 133,
    USS_message_code_algorithm_error_meter_constant_calib = 134,

        // 141 - 160 reserved for algorithms messages
        USS_message_code_interrupt_update_error_ongoing_conversion = 142,

        //161-170 reserved for ISTOP messages
        USS_message_code_invalid_conversion_data = 161,

        //171-180 reserved for calibration messages
        USS_message_code_Calibration_DAC_success = 171,
        USS_message_code_Calibration_DAC_error = 172,
        USS_message_code_Calibration_Gain_error = 173,
        USS_message_code_Calibration_DCO_error = 174,
        USS_message_code_Signal_Gain_Calibration_timeout= 175,
        USS_message_code_Signal_Gain_Calibration_settling= 176,
        USS_message_code_Signal_Gain_Calibration_successful =177,
        USS_message_code_Calibration_DAC_timeout_error = 178,
        USS_message_code_Calibration_ToF_Offset_error = 179,
        USS_message_code_Calibration_Offset_invalid_configuration = 180,

        //240-255 error
        USS_message_code_ACLK_settling_time_out =240,
        USS_meesage_code_silicon_version_does_not_support_this_functionality = 241,
        USS_message_code_USS_ongoing_active_conversion_error =254,
        USS_message_code_error_occurred =255
} USS_message_code;

typedef enum _USS_diagnostics_mode_
{
        USS_diagnostics_mode_0 = 0,
        USS_diagnostics_mode_1 = 1,
        USS_diagnostics_mode_2 = 2
} USS_diagnostics_mode;

typedef enum _USS_capture_power_mode_
{
        USS_capture_power_mode_active = (GIE),
        USS_capture_power_mode_low_power_mode_0 = (LPM0_bits | GIE),
} USS_capture_power_mode_option;


typedef enum _USS_stop_measurement_state_
{
        USS_stop_measurement_turn_off_USS = 0,
        USS_stop_measurement_state_ready = 1
} USS_stop_measurement_state;

typedef enum _USS_measurement_drive_strength_
{
        USS_measurement_drive_strength_pre_trimmed_drive = 0,
        USS_measurement_drive_strength_max_strength = 0x0100
} USS_measurement_drive_strength;

typedef enum _USS_measurement_pause_state_
{
        USS_measurement_pause_state_high_impedance = 0,
        USS_measurement_pause_state_low = 1,
        USS_measurement_pause_state_high = 2
} USS_measurement_pause_state;

typedef enum _USS_measurement_pulse_polarity_
{
        USS_measurement_pulse_polarity_excitation_starts_on_high_pulse = 0x0000,
        USS_measurement_pulse_polarity_excitation_starts_on_low_pulse = 0x000F
} USS_measurement_pulse_polarity;

typedef enum _USS_measurement_ULP_bias_delay_
{
    USS_measurement_ULP_bias_delay_no_delay,
    USS_measurement_ULP_bias_delay_100_usec,
    USS_measurement_ULP_bias_delay_200_usec,
    USS_measurement_ULP_bias_delay_300_usec,
}USS_measurement_ULP_bias_delay;

typedef enum _USS_measurement_bias_impedance_
{
    USS_measurement_bias_impedance_200_Ohms,
    USS_measurement_bias_impedance_600_Ohms,
    USS_measurement_bias_impedance_1200_Ohms,
    USS_measurement_bias_impedance_2800_Ohms,
}USS_measurement_bias_impedance;


typedef enum _USS_measurement_mux_charge_pump_
{
    USS_measurement_mux_charge_pump_always_on,
    USS_measurement_mux_charge_pump_always_off,
}USS_measurement_mux_charge_pump;


typedef enum _USS_measurement_pulse_generation_mode_
{
    USS_measurement_pulse_generation_mode_single_tone,
    USS_measurement_pulse_generation_mode_dual_tone,
    USS_measurement_pulse_generation_mode_multi_tone,
} USS_measurement_pulse_generation_mode;

typedef enum _USS_test_channel_
{
        USS_test_channel_0 = 0x0000,
        USS_test_channel_1 = 0x0001
} USS_test_channel;

typedef enum _USS_measurement_capture_sequence_
{
        USS_measurement_capture_sequence_ch0 = 0,
        USS_measurement_capture_sequence_ch1 = 1,
        USS_measurement_capture_sequence_ch0_ch1 = 2,
        USS_measurement_capture_sequence_ch1_ch0 = 3,
        USS_measurement_capture_sequence_ch0_ch0 = 4,
        USS_measurement_capture_sequence_ch1_ch1 = 5,
        USS_measurement_capture_sequence_ch0_ch1_ch0 = 6,
        USS_measurement_capture_sequence_ch1_ch0_ch1 = 7,
        USS_measurement_capture_sequence_ch0_ch0_ch0 = 8,
        USS_measurement_capture_sequence_ch1_ch1_ch1 = 9,
        USS_measurement_capture_sequence_ch0_ch1_ch0_ch1 = 10,
        USS_measurement_capture_sequence_ch1_ch0_ch1_ch0 = 11,
        USS_measurement_capture_sequence_ch0_ch0_ch0_ch0 = 12,
        USS_measurement_capture_sequence_ch1_ch1_ch1_ch1 = 13
} USS_measurement_capture_sequence;

typedef enum _USS_measurement_end_of_sequence_state_
{
        USS_measurement_end_of_sequence_state_standby = 0,
        USS_measurement_end_of_sequence_state_power_off = ESOFF,
        USS_measurement_end_of_sequence_state_ready = STDBY+ ESOFF
} USS_measurement_end_of_sequence_state;

typedef enum _USS_Capture_Over_Sample_Rate_
{
        USS_Capture_Over_Sample_Rate_10 = 0x0000,
        USS_Capture_Over_Sample_Rate_20 = 0x0001,
        USS_Capture_Over_Sample_Rate_40 = 0x0002,
        USS_Capture_Over_Sample_Rate_80 = 0x0003,
        USS_Capture_Over_Sample_Rate_160 = 0x0004
} USS_Capture_Over_Sample_Rate;

typedef enum _USS_Capture_Gain_Range_
{
        USS_Capture_Gain_Range_minus_6_5 = 17,
        USS_Capture_Gain_Range_minus_5_5 = 18,
        USS_Capture_Gain_Range_minus_4_6 = 19,
        USS_Capture_Gain_Range_minus_4_1 = 20,
        USS_Capture_Gain_Range_minus_3_3 = 21,
        USS_Capture_Gain_Range_minus_2_3 = 22,
        USS_Capture_Gain_Range_minus_1_4 = 23,
        USS_Capture_Gain_Range_minus_0_8 = 24,
        USS_Capture_Gain_Range_0_1 = 25,
        USS_Capture_Gain_Range_1_0 = 26,
        USS_Capture_Gain_Range_1_9 = 27,
        USS_Capture_Gain_Range_2_6 = 28,
        USS_Capture_Gain_Range_3_5 = 29,
        USS_Capture_Gain_Range_4_4 = 30,
        USS_Capture_Gain_Range_5_2 = 31,
        USS_Capture_Gain_Range_6_0 = 32,
        USS_Capture_Gain_Range_6_8 = 33,
        USS_Capture_Gain_Range_7_7 = 34,
        USS_Capture_Gain_Range_8_7 = 35,
        USS_Capture_Gain_Range_9_0 = 36,
        USS_Capture_Gain_Range_9_8 = 37,
        USS_Capture_Gain_Range_10_7 = 38,
        USS_Capture_Gain_Range_11_7 = 39,
        USS_Capture_Gain_Range_12_2 = 40,
        USS_Capture_Gain_Range_13_0 = 41,
        USS_Capture_Gain_Range_13_9 = 42,
        USS_Capture_Gain_Range_14_9 = 43,
        USS_Capture_Gain_Range_15_5 = 44,
        USS_Capture_Gain_Range_16_3 = 45,
        USS_Capture_Gain_Range_17_2 = 46,
        USS_Capture_Gain_Range_18_2 = 47,
        USS_Capture_Gain_Range_18_8 = 48,
        USS_Capture_Gain_Range_19_6 = 49,
        USS_Capture_Gain_Range_20_5 = 50,
        USS_Capture_Gain_Range_21_5 = 51,
        USS_Capture_Gain_Range_22_0 = 52,
        USS_Capture_Gain_Range_22_8 = 53,
        USS_Capture_Gain_Range_23_6 = 54,
        USS_Capture_Gain_Range_24_6 = 55,
        USS_Capture_Gain_Range_25_0 = 56,
        USS_Capture_Gain_Range_25_8 = 57,
        USS_Capture_Gain_Range_26_7 = 58,
        USS_Capture_Gain_Range_27_7 = 59,
        USS_Capture_Gain_Range_28_1 = 60,
        USS_Capture_Gain_Range_28_9 = 61,
        USS_Capture_Gain_Range_29_8 = 62,
        USS_Capture_Gain_Range_30_8 = 63
} USS_Capture_Gain_Range;

typedef enum _USS_Capture_Calibration_
{
        USS_Capture_Calibration_disabled =0x0100,
        USS_Capture_Calibration_enabled = 0x8100
} USS_Capture_Calibration;

typedef enum _USS_Trigger_Configuration_Trigger_
{
        USS_Triger_Configuration_Software_Trigger = 0x00,
} USS_Trigger_Configuration_Trigger;

typedef enum _USS_HSPLL_input_clock_freq_
{
    USS_HSPLL_input_clock_freq_4_MHz,
    USS_HSPLL_input_clock_freq_8_MHz,
} USS_HSPLL_input_clock_freq;

typedef enum _USS_HSPLL_input_clock_type_
{
        USS_HSPLL_input_clock_type_crystal = 0x0000,
        USS_HSPLL_input_clock_type_ceramic_resonator = 0x0200
} USS_HSPLL_input_clock_type;


typedef enum _USS_HSPLL_output_clk_freq_
{
        USS_HSPLL_output_clk_freq_80_MHz = 0,
        USS_HSPLL_output_clk_freq_79_MHz = 1,
        USS_HSPLL_output_clk_freq_78_MHz = 2,
        USS_HSPLL_output_clk_freq_77_MHz = 3,
        USS_HSPLL_output_clk_freq_76_MHz = 4,
        USS_HSPLL_output_clk_freq_75_MHz = 5,
        USS_HSPLL_output_clk_freq_74_MHz = 6,
        USS_HSPLL_output_clk_freq_73_MHz = 7,
        USS_HSPLL_output_clk_freq_72_MHz = 8,
        USS_HSPLL_output_clk_freq_71_MHz = 9,
        USS_HSPLL_output_clk_freq_70_MHz = 10,
        USS_HSPLL_output_clk_freq_69_MHz = 11,
        USS_HSPLL_output_clk_freq_68_MHz = 12,
} USS_HSPLL_output_clk_freq;


typedef enum USS_SDHS_Interrupt
{
        USS_SDHS_Interrupt_OVF= 0,
        USS_SDHS_Interrupt_ACQDONE= 1,
        USS_SDHS_Interrupt_SSTRG= 3,
        USS_SDHS_Interrupt_DTRDY = 4,
        USS_SDHS_Interrupt_WINHI = 5,
        USS_SDHS_Interrupt_WINLO = 6
} USS_SDHS_Interrupt;


typedef enum USS_SAPH_Interrupt
{
        USS_SAPH_Interrupt_DATAERR= 0, 
        USS_SAPH_Interrupt_TMFTO= 1,  
        USS_SAPH_Interrupt_SEQDN= 2,   
        USS_SAPH_Interrupt_PNGDN= 3    
} USS_SAPH_Interrupt;

typedef enum USS_UUPS_Interrupt
{
        USS_UUPS_Interrupt_PREQIG = 0,  
        USS_UUPS_Interrupt_PTMOUT = 1,
        USS_UUPS_Interrupt_STPBYDB = 2
} USS_UUPS_Interrupt;


typedef enum USS_HSPLL_Interrupt
{
        USS_HSPLL_Interrupt_PLLUNLOCK = 0,  
} USS_HSPLL_Interrupt;

typedef enum _USS_highFlow_option_ {
    USS_highFlow_option_disabled = 0,
    USS_highFlow_option_version1 = 1,
    USS_highFlow_option_version2 = 2
} USS_highFlow_option;

typedef enum _USS_low_power_mode_option_
{

        USS_low_power_mode_option_low_power_mode_0 = LPM0_bits,
        USS_low_power_mode_option_low_power_mode_1 = LPM1_bits,
        USS_low_power_mode_option_low_power_mode_2 = LPM2_bits,
        USS_low_power_mode_option_low_power_mode_3 = LPM3_bits
} USS_low_power_mode_option;

typedef enum _USS_dtof_volume_flow_calculation_interval_
{
        USS_dtof_volume_flow_calculation_interval_1 = 1,
        USS_dtof_volume_flow_calculation_interval_2 = 2,
        USS_dtof_volume_flow_calculation_interval_4 = 4,
        USS_dtof_volume_flow_calculation_interval_8 = 8
} USS_dtof_volume_flow_calculation_interval;

typedef enum _USS_dcOffEst_Calc_Mode_
{
    USS_dcOffEst_Calc_Mode_use_existing_UPS_DNS_capture,
    USS_dcOffEst_Calc_Mode_trigger_UPS_DNS_capture_controlled_by_ASQ,
    USS_dcOffEst_Calc_Mode_trigger_UPS_DNS_capture_using_LPM_capture,
} USS_dcOffEst_Calc_Mode;


typedef enum _USS_Alg_AbsToF_Calculation_Option_{
    USS_Alg_AbsToF_Calculation_Option_lobe = 0,
    USS_Alg_AbsToF_Calculation_Option_hilbert = 1,
    USS_Alg_AbsToF_Calculation_Option_lobeWide = 2,
    USS_Alg_AbsToF_Calculation_Option_hilbertWide = 3
} USS_Alg_AbsToF_Calculation_Option;

typedef enum _USS_Alg_dToF_Calculation_Option_{
    USS_Alg_dToF_Calculation_Option_estimate = 0,
    USS_Alg_dToF_Calculation_Option_water,
} USS_Alg_dToF_Calculation_Option;

typedef enum _USS_Alg_volume_flow_Calculation_Option_{
    USS_Alg_volume_flow_Calculation_Option_water = 0,
    USS_Alg_volume_flow_Calculation_Option_gas = 1,
    USS_Alg_volume_flow_Calculation_Option_generic = 1,
} USS_Alg_volume_flow_Calculation_Option;

typedef struct _USS_Algorithms_Meter_Constant_Calib_
{
    float  alphaMin;
    float slope;
    float offset;
}USS_Algorithms_Meter_Constant_Calib;


typedef struct _USS_System_Configuration_
{
        uint32_t mCLKFrequency;
        uint16_t LFXTFrequency;
        uint16_t timerBaseAddress;
        USS_diagnostics_mode diagMode;
} USS_System_Configuration;

typedef struct _USS_Pulse_Additional_End_of_Sequence_Configuration_
{
    uint16_t numOfTrillcycles;
    uint16_t * pNumOfEPulsArray;
    uint16_t * pEPulsLPerArray;
    uint16_t * pEPulsHPerArray;
    uint16_t * pNumOfXPulsArray;
    uint16_t * pXPulsLPerArray;
    uint16_t * pXPulsHPerArray;
}USS_Pulse_Additional_End_of_Sequence_Configuration;

typedef struct _USS_Pulse_Multitone_Configuration_
{
    uint16_t origNumOfThrillCycles;
    uint16_t numOfTrillcycles;
    uint16_t * pNumOfEPulsArray;
    uint16_t * pEPulsLPerArray;
    uint16_t * pEPulsHPerArray;
    uint16_t * pNumOfXPulsArray;
    uint16_t * pXPulsLPerArray;
    uint16_t * pXPulsHPerArray;
    uint16_t * pRAMPulseConfigArray;
    uint16_t * pRAMDMAConfigArray;
    USS_Pulse_Additional_End_of_Sequence_Configuration *pEOFSeqConfig;
}USS_Pulse_Multitone_Configuration;

typedef struct _USS_Pulse_Single_Dual_Tone_Configuration_
{
    uint8_t F1DutyCycle;
    uint8_t F2DutyCycle;
    uint8_t numOfF1Cycles;
    uint8_t numOfF2Cycles;
}USS_Pulse_Single_Dual_Tone_Configuration;

typedef struct _USS_Pulse_Configuration_
{
    USS_measurement_pulse_generation_mode pulseGenMode;
    USS_measurement_pause_state pauseState;
    USS_measurement_pulse_polarity pulsePolarity;
    uint32_t F1Frequency;
    uint32_t F2Frequency;
    void *pToneConfig;
    uint8_t numOfStopPulses;
}USS_Pulse_Configuration;


typedef struct _USS_Meter_Configuration_
{
        float volumeScaleFactor; 
        float acousticLength;    
        uint32_t transducerFreq; 
} USS_Meter_Configuration;


typedef struct _USS_Measurement_Configuration_
{
        USS_measurement_capture_sequence sequenceSelection;
        USS_measurement_end_of_sequence_state eofSequenceState;
        USS_measurement_drive_strength ch0DriveStrength;
        USS_measurement_drive_strength ch1DriveStrength;
        USS_Pulse_Configuration *pulseConfig;
        uint_least16_t startPPGCount;
        uint_least16_t turnOnADCCount;
        uint_least16_t startPGAandINBiasCount;
        uint_least16_t startADCsamplingCount;
        uint_least16_t restartCaptureCount;
        uint_least16_t captureTimeOutCount;
        uint_least16_t restartLowPowerCaptureCount;
        USS_measurement_ULP_bias_delay ulpBiasDelay;
        USS_measurement_bias_impedance biasImpedance;
        USS_measurement_mux_charge_pump muxChargePumpMode;
        uint16_t startRxEnCount;
} USS_Measurement_Configuration;

typedef struct _USS_HSPLL_Configuration_
{
    USS_HSPLL_input_clock_freq ussXtalFreq;
        USS_HSPLL_input_clock_type HSPLLInputCLKType;
        USS_HSPLL_output_clk_freq pllOutputFreq;
        bool outputPLLXtal;
        uint16_t hspllTolerance;
        uint16_t ussXTALsettlingCount;
} USS_HSPLL_Configuration;

typedef struct _USS_dTof_absTof_offset_test_config_
{
    uint16_t numOfTestIterations;
    bool isUseLPMCapture;
    bool isCalculateUpsAbsTofOffset;
    bool isCalculateDnsAbsTofOffset;
    bool isCalculateDToFOffset;
} USS_dTof_absTof_offset_test_config;

typedef struct _USS_dTof_absTof_offset_results_
{
    float upsAbsToFOffset;
    float dnsAbsToFOffset;
    float dToFOffset;
} USS_dTof_absTof_offset_results;


typedef struct _USS_calibration_hspll_results_
{
    uint32_t expectedResult;
    uint32_t actualTestCount;
    int32_t    difference;
} USS_calibration_hspll_results;

typedef struct _USS_Capture_Configuration_
{
        USS_Capture_Over_Sample_Rate overSampleRate;
        uint16_t sampleSize;
        USS_Capture_Gain_Range gainRange;
        bool enableWindowHiComp;
        bool enableWindowLoComp;
        int16_t windowHighThreshold;
        int16_t windowLowThreshold;
        uint16_t agcConstant;
        int16_t *pCapturesBuffer;
        uint16_t maxCapture;
        bool isCapAccumulationEnabled;
        int16_t *pAccCaptureBuffer;
} USS_Capture_Configuration;

typedef struct _USS_Trigger_Configuration_
{
        USS_Trigger_Configuration_Trigger triggerConfig;
} USS_Trigger_Configuration;

typedef struct _USS_Interrupt_Configuration_
{
        bool enableUUPSPREQIGInterrupt;
        bool enableSAPHPingTransmitDoneInterrupt;
} USS_Interrupt_Configuration;


typedef struct _USS_Algorithms_User_Configuration_
{
    uint16_t absTOFInterval;

        float ADCAdditionalCaptureDelay;
        float  dcOffset;
        float  ratioOfTrackLobeToPeak;
        uint8_t  numPulsesBeforeThreshold;
        bool  enableWindowing;
        float  signalValueThresholdCheck;
        uint8_t  numCycleSearchCorrPeak;
        uint16_t  searchLobeSampleSteps;
        float  maxRatioPeak2PeakVariation;
        uint8_t  winStartIndexBackOffNumCycles;
        uint8_t  winTrapzRampOverNumCycles;
        float  corrValueThresholdCheckFactor;
        int16_t calibratedDCOffsetUPS;
        int16_t calibratedDCOffsetDNS;
        bool isInitAlgorithms;
        USS_dtof_volume_flow_calculation_interval dtofVolInterval;
        int16_t *pLEAMemBuffer1;
        int32_t *pNvMemBuffer;
        USS_highFlow_option highFlowOption;
        float cycleSlipThreshold;
        int32_t thresholdX1X3;
        _iq27 clockRelativeError;
        uint32_t winNumCycles;
        bool enableFilter;
        uint16_t filterLength;
        int16_t *filterCoeffs;
        USS_Alg_AbsToF_Calculation_Option absToFOption;
        int16_t *pLEAMemBuffer2;
        int16_t *hilbertTransformCoeffs;
        uint16_t hilbertTransformCoeffsLength;
        int16_t negSearchRange;
        int16_t posSearchRange;
        float crossThreshold;
        int16_t *pBinaryPattern;
        uint16_t binaryPatternLength;
        uint16_t maxBinaryPatternLenght;
        int16_t *pAdditionalBinaryPattern;
        uint16_t additionalPatternLength;
        uint16_t maxAdditionalBinaryPatternLength;
        USS_Alg_dToF_Calculation_Option dtoFCalcOption;
        USS_Alg_volume_flow_Calculation_Option volumeCalOption;
        int16_t maxSampleShift;
        const int16_t (*pInterpCorrectionTablePtr)[2];
        int16_t interpCorrectionTableLenght;
        USS_Algorithms_Meter_Constant_Calib *pMeterConfiguration;
        uint8_t numOfMeterCalibrationRanges;
}USS_Algorithms_User_Configuration;

typedef struct _USS_Algorithms_Results_
{
        USS_message_code messageCode;
        float deltaTOF;
        float totalTOF_UPS;
        float totalTOF_DNS;
        float volumeFlowRate;
}USS_Algorithms_Results;

typedef struct _USS_Algorithms_Results_fixed_point_
{
        USS_message_code messageCode;
        int32_t iq44DeltaTOF;
        int32_t iq40TotalTOF_UPS;
        int32_t iq40TotalTOF_DNS;
        int32_t iq16VolumeFlowRate;
}USS_Algorithms_Results_fixed_point;


typedef struct _USS_SW_Library_configuration_
{
        USS_System_Configuration *systemConfig;
        USS_Meter_Configuration *meterConfig;
        USS_Measurement_Configuration *measurementConfig;
        USS_HSPLL_Configuration *pllConfiguration;
        USS_Capture_Configuration *captureConfig;
        USS_Trigger_Configuration *triggerConfig;
        USS_Algorithms_User_Configuration *algorithmsConfig;
        USS_Interrupt_Configuration *interruptConfig;
//      USS_Algorithms_Object *algorithmsObject;
//      //!< Pointer to USS_Algorithms_Handle handle
        uint16_t validationKey;
} USS_SW_Library_configuration;

//*****************************************************************************
// globals
//*****************************************************************************
extern volatile uint32_t USSSWLIB_USS_interrupt_status;

#ifdef USS_CALIBRATE_SIGNAL_GAIN_TEST
extern int16_t ussMaxSignal[5];
#endif
//*****************************************************************************
// the function prototypes
//*****************************************************************************

//*****************************************************************************
//
//
//******************************************************************************
/*******************************************************************************
 * USS SW LIBRARY MEASUREMENT APIS
 ******************************************************************************/
extern USS_message_code USS_configureUltrasonicMeasurement(
                USS_SW_Library_configuration *config);


extern USS_message_code USS_startUltrasonicMeasurement(
                USS_SW_Library_configuration *config,
                USS_capture_power_mode_option powerMode);

extern USS_message_code USS_startLowPowerUltrasonicCapture(
                USS_SW_Library_configuration *config);

extern USS_message_code USS_stopUltrasonicMeasurement(
                USS_SW_Library_configuration *config,
                USS_stop_measurement_state stopMeasurementState);

extern void USS_generateLPMDelay(
                USS_SW_Library_configuration *config,
                USS_low_power_mode_option lpmMode,
                uint16_t count);

//******************************************************************************
//
// Close the Doxygen group.
//
//******************************************************************************

/*******************************************************************************
 * USS SW LIBRARY CONFIGURATION UPDATE APIS
 ******************************************************************************/
//*****************************************************************************
//
//
//******************************************************************************
extern inline USS_message_code USS_updateSDHSConfiguration(
                USS_SW_Library_configuration *config);

extern inline USS_message_code USS_updateHSPLLConfiguration(
                USS_SW_Library_configuration *config);

extern inline USS_message_code USS_updateSAPHConfiguration(
                USS_SW_Library_configuration *config);

extern inline USS_message_code USS_updateUUPSConfiguration(
                USS_SW_Library_configuration *config);

extern inline USS_message_code USS_updateUSSInterruptsConfiguration(
                USS_SW_Library_configuration *config);

extern inline USS_message_code USS_resetUSSModule(
        USS_SW_Library_configuration *config, bool reconfigUSSModule);

extern inline USS_message_code USS_swapCaptureChannels(
        USS_SW_Library_configuration *config);

//******************************************************************************
//
// Close the Doxygen group.
//
//******************************************************************************

/*******************************************************************************
 * USS SW LIBRARY CALIBRATION APIS
 ******************************************************************************/
//*****************************************************************************
//
//
//****************************************************************************** 
extern USS_message_code USS_verifyHSPLLFrequency(
                USS_SW_Library_configuration *config,
                USS_calibration_hspll_results *testResults);

extern USS_message_code USS_calibrateSignalGain(USS_SW_Library_configuration *config);


extern USS_message_code USS_estimateDCoffset(
                USS_SW_Library_configuration *config, USS_dcOffEst_Calc_Mode mode);

extern USS_message_code USS_calculateOffsets(USS_SW_Library_configuration *config,
                          USS_dTof_absTof_offset_results *testResults,
                          USS_dTof_absTof_offset_test_config *testConfig);

//******************************************************************************
//
// Close the Doxygen group.
//
//******************************************************************************

/*******************************************************************************
 * USS SW LIBRARY ALGORITHMS APIS
 ******************************************************************************/
//*****************************************************************************
//
//
//******************************************************************************
extern USS_message_code USS_initAlgorithms(USS_SW_Library_configuration *config);


extern USS_message_code USS_runAlgorithmsFixedPoint(
                USS_SW_Library_configuration *config,
                USS_Algorithms_Results_fixed_point *results);


extern USS_message_code USS_runAlgorithms(USS_SW_Library_configuration *config,
                USS_Algorithms_Results *results);



extern USS_message_code USS_generateMonoDualToneBinaryPattern(
        USS_SW_Library_configuration *config);

extern USS_message_code USS_generateMultiToneBinaryPattern(
        USS_SW_Library_configuration *config);

extern USS_message_code USS_updateABSTOFCalculationIteration(
                USS_SW_Library_configuration *config);


extern USS_message_code USS_updateClockRelativeError(
                USS_SW_Library_configuration *config);

extern USS_message_code USS_getResultsInFloat(
                USS_Algorithms_Results_fixed_point *pFixedResults,
                USS_Algorithms_Results *pFloatResults);

extern USS_message_code USS_swapAlgorithmsCaptureBuffers(
        USS_SW_Library_configuration *config);

extern bool USS_isAlgorithmChannelsSwapped(void);

extern USS_message_code USS_updateAdditionalCaptureDelay(
        USS_SW_Library_configuration *config, float additionalCaptureDelay);

extern USS_message_code USS_updateDtoFOffset(
        USS_SW_Library_configuration *config, float dTofOffset);

//******************************************************************************
//
// Close the Doxygen group.
//
//******************************************************************************

/*******************************************************************************
 * USS SW LIBRARY APPLICATION DEBUG APIS
 ******************************************************************************/
//*****************************************************************************
//
//
//****************************************************************************** 

extern USS_message_code USS_testPPGconfiguration(
                USS_SW_Library_configuration *config,
                USS_test_channel PPGChannel);


extern USS_message_code USS_testSDHSconversion(
                USS_SW_Library_configuration *config, USS_test_channel SDHSChannel,
                USS_capture_power_mode_option mode);


extern USS_message_code USS_startPPGToneGeneration(
                USS_SW_Library_configuration *config,
                USS_test_channel PPGChannel);

extern USS_message_code USS_stopPPGToneGeneration(
                USS_SW_Library_configuration *config);

extern int16_t* USS_getUPSPtr(USS_SW_Library_configuration *config);


extern int16_t* USS_getDNSPtr(USS_SW_Library_configuration *config);

//******************************************************************************
//
// Close the Doxygen group.
//
//******************************************************************************

/*******************************************************************************
 * USS SW LIBRARY INTERRUPT CALLBACK REGISTER/UNREGISTER APIS
 ******************************************************************************/
//*****************************************************************************
//
//
//******************************************************************************
extern void USS_registerSDHSInterruptCallback(USS_SDHS_Interrupt interruptNum,
                void function(void));
extern void USS_registerSAPHInterruptCallback(USS_SAPH_Interrupt interruptNum,
                void function(void));

extern void USS_registerUUPSInterruptCallback(USS_UUPS_Interrupt interruptNum,
                void function(void));

extern void USS_registerHSPLLInterruptCallback(USS_HSPLL_Interrupt interruptNum,
                void function(void));

extern void USS_unregisterSDHSInterruptCallback(
                USS_SDHS_Interrupt interruptNum);
extern void USS_unregisterSAPHInterruptCallback(
                USS_SAPH_Interrupt interruptNum);

extern void USS_unregisterUUPSInterruptCallback(
                USS_UUPS_Interrupt interruptNum);

extern void USS_unregisterHSPLLInterruptCallback(
                USS_HSPLL_Interrupt interruptNum);

//******************************************************************************
//
// Close the Doxygen group.
//
//******************************************************************************

#ifdef __cplusplus
}
#endif // extern "C"

#endif // end of  _USSSWLIB_H_ definition