MSP430UltrasonicLibrary
02_20_00_16
|
Functions | |
USS_message_code | USS_configureUltrasonicMeasurement (USS_SW_Library_configuration *config) |
The following API configures USS module based on user configuration files "ussSwLib_userConfig.c" and "ussSwLib_userConfig.h". This API will internally invoke all USS Configuration APIs. In addition, this API will initialize the timer which will be used to generate delays such as the delay to stabilize PLL XTAL. More... | |
USS_message_code | USS_startUltrasonicMeasurement (USS_SW_Library_configuration *config, USS_capture_power_mode_option powerMode) |
The following API can be used to trigger a USS Capture via software trigger. NOTE: User must call "USS_configureUltrasonicMeasurement" before calling this API and USS trigger must be set to USS_Triger_Configuration_Software_Trigger. The API will perform the following operations: More... | |
USS_message_code | USS_startLowPowerUltrasonicCapture (USS_SW_Library_configuration *config) |
The following API has been power optimized for ultrasonic capture. The API controls the capture sequence selected by the user via the sequenceSelection member in USS_Measurement_Configuration structure. NOTE the API has been optimized for USS_measurement_capture_sequence_ch0_ch1 capture mode. NOTE_1: User must call "USS_configureUltrasonicMeasurement" before calling this API and USS trigger must be set to USS_Triger_Configuration_Software_Trigger. To reduce power consumption between captures the device will: More... | |
USS_message_code | USS_stopUltrasonicMeasurement (USS_SW_Library_configuration *config, USS_stop_measurement_state stopMeasurementState) |
The following API can be used to stop any active USS capture. The user has the option to select USS state after conversion is stopped. The API will report if capture was successfully stopped or if any errors occurs while stopping the measurement. More... | |
void | USS_generateLPMDelay (USS_SW_Library_configuration *config, USS_low_power_mode_option lpmMode, uint16_t count) |
The following API can be used to generate a Low Power Mode Delay. The API allows to select the desired Low Power Mode. Global interrupts remain enable. The timer clock source for this delay is ACLK. Therefore the delay generate will be determined based on ACLK frequency (e.g. for count = 30 and ACLK freq = 32768 HZ a delay of ~915 msec will be generated. More... | |
USS_message_code USS_configureUltrasonicMeasurement | ( | USS_SW_Library_configuration * | config | ) |
The following API configures USS module based on user configuration files "ussSwLib_userConfig.c" and "ussSwLib_userConfig.h". This API will internally invoke all USS Configuration APIs. In addition, this API will initialize the timer which will be used to generate delays such as the delay to stabilize PLL XTAL.
[in] | config | is a pointer to the USS SW Library user configuration |
References BENCHMARK_ENTRY_USS_LIB, _USS_SW_Library_configuration_::measurementConfig, _USS_Measurement_Configuration_::startRxEnCount, USS_registerSAPHInterruptCallback(), USS_SAPH_Interrupt_SEQDN, USSLIB_HAL_configureRxEnTimer(), and USSLIB_HAL_initGPIO().
Referenced by USS_resetUSSModule().
USS_message_code USS_startUltrasonicMeasurement | ( | USS_SW_Library_configuration * | config, |
USS_capture_power_mode_option | powerMode | ||
) |
The following API can be used to trigger a USS Capture via software trigger.
NOTE: User must call "USS_configureUltrasonicMeasurement" before calling this API and USS trigger must be set to USS_Triger_Configuration_Software_Trigger.
The API will perform the following operations:
[in] | config | is a pointer to the USS SW Library user configuration |
[in] | powerMode | The following are valid options:
|
References commonClearUSSInterrupts(), commonEnableCaptureInterrupts(), commonIsconversionSuccessfull(), commonPowerUpUSS(), commonPrepareForUSSPowerUp(), commonSDHSRestoreSDHSDTCA(), commonWaitForconversion(), _USS_Measurement_Configuration_::eofSequenceState, _USS_SW_Library_configuration_::measurementConfig, _USS_Trigger_Configuration_::triggerConfig, _USS_SW_Library_configuration_::triggerConfig, USS_measurement_end_of_sequence_state_power_off, USS_message_code_no_error, USS_Triger_Configuration_Software_Trigger, and USSSWLIB_USS_interrupt_status.
Referenced by USS_calculateOffsets(), and USS_estimateDCoffset().
USS_message_code USS_startLowPowerUltrasonicCapture | ( | USS_SW_Library_configuration * | config | ) |
The following API has been power optimized for ultrasonic capture. The API controls the capture sequence selected by the user via the sequenceSelection member in USS_Measurement_Configuration structure. NOTE the API has been optimized for USS_measurement_capture_sequence_ch0_ch1 capture mode.
NOTE_1: User must call "USS_configureUltrasonicMeasurement" before calling this API and USS trigger must be set to USS_Triger_Configuration_Software_Trigger. To reduce power consumption between captures the device will:
NOTE2: The total delay between Channel acquisition sequences will be determined by the following USS SW library and USS module configurations:
[in] | config | is a pointer to the USS SW Library user configuration |
References commonSDHSRestoreSDHSDTCA(), _USS_Measurement_Configuration_::eofSequenceState, GENERIC_SAPH_ASCTL0, GENERIC_SAPH_ASCTL1, GENERIC_SAPH_KEY, _USS_SW_Library_configuration_::measurementConfig, _USS_Measurement_Configuration_::restartLowPowerCaptureCount, _USS_Measurement_Configuration_::sequenceSelection, USS_commonTriggerSingleCapture(), USS_measurement_capture_sequence_ch0, USS_measurement_capture_sequence_ch0_ch0, USS_measurement_capture_sequence_ch0_ch0_ch0, USS_measurement_capture_sequence_ch0_ch0_ch0_ch0, USS_measurement_capture_sequence_ch0_ch1, USS_measurement_capture_sequence_ch0_ch1_ch0, USS_measurement_capture_sequence_ch0_ch1_ch0_ch1, USS_measurement_capture_sequence_ch1, USS_measurement_capture_sequence_ch1_ch0, USS_measurement_capture_sequence_ch1_ch0_ch1, USS_measurement_capture_sequence_ch1_ch0_ch1_ch0, USS_measurement_capture_sequence_ch1_ch1, USS_measurement_capture_sequence_ch1_ch1_ch1, USS_measurement_capture_sequence_ch1_ch1_ch1_ch1, and USS_message_code_no_error.
Referenced by USS_calculateOffsets(), USS_calibrateSignalGain(), and USS_estimateDCoffset().
USS_message_code USS_stopUltrasonicMeasurement | ( | USS_SW_Library_configuration * | config, |
USS_stop_measurement_state | stopMeasurementState | ||
) |
The following API can be used to stop any active USS capture. The user has the option to select USS state after conversion is stopped. The API will report if capture was successfully stopped or if any errors occurs while stopping the measurement.
[in] | config | is a pointer to the USS SW Library user configuration |
[in] | stopMeasurementState | specifies USS state after sequence is stopped. Possible values are:
|
References commonEnableCaptureInterrupts(), commonTimerGenerateLowPowerDelay(), USS_low_power_mode_option_low_power_mode_1, USS_message_code_error_occurred, USS_message_code_no_error, USS_SAPH_SEQ_ACQ_DN_INTERRUPT, USS_SAPH_SEQUENCE_STOPPED, USS_stop_measurement_turn_off_USS, USS_TIMER_EXPIRED_INTERRUPT, and USSSWLIB_USS_interrupt_status.
void USS_generateLPMDelay | ( | USS_SW_Library_configuration * | config, |
USS_low_power_mode_option | lpmMode, | ||
uint16_t | count | ||
) |
The following API can be used to generate a Low Power Mode Delay. The API allows to select the desired Low Power Mode. Global interrupts remain enable. The timer clock source for this delay is ACLK. Therefore the delay generate will be determined based on ACLK frequency (e.g. for count = 30 and ACLK freq = 32768 HZ a delay of ~915 msec will be generated.
[in] | config | is a pointer to the USS SW Library user configuration |
[in] | lpmMode | selects the low power mode Possible values are:
|
[in] | count | Determines the delay duration |
References commonTimerGenerateLowPowerDelay().