Library Description

The library initializes and defines the UART bus driver and drivers that offer a choice for writing data on UART. The library includes the function for initialization device, TVG, communication, and Thresholds, configuration chip and enabling device. The user also has the function for set Ambient temperature which depends on the speed of sound, the function for reading ultrasonic measurement and device diagnostics.

Key functions:

• void ultrasonic2_enable(uint8_t state) - Function for enable chip

• void ultrasonic2_getUltrasonicMeasurement(uint8_t numObj, float *distOUT, uint16_t *widthOUT, uint8_t *ampOUT) - Function for getting ultrasonic measurement

• void ultrasonic2_getDiagnostics(float *freqOUT, float *periodOUT, float *tempOUT, float *noiceOUT) - Function for reading diagnostics

Examples description

The application is composed of the three sections :

• System Initialization - Initializes UART module and sets CS and AN pins as OUTPUT
• Application Initialization - Driver initialization for powering the Click board, chip configuration and reading the sensor diagnosis.
• Application Task - (code snippet) - Starts measuring and measures the distance of an object every 500 ms.

void applicationTask()
{
    ultrasonic2_startUltrasonicMeasurement(_ULTRASONIC2_DETECT_OBJECT_1);

    for (cnt = 0; cnt < _ULTRASONIC2_DETECT_OBJECT_1; cnt++)
    {
        ultrasonic2_getUltrasonicMeasurement(cnt, &distance, &width, &peak);
        Delay_ms(10);

        distance = distance * 100;
        if(distance < 300)
        {
            FloatToStr(distance, demoText);
            demoText[ 6 ] = 0;
            mikrobus_logWrite(" Distance (cm): ",_LOG_TEXT);
            mikrobus_logWrite(demoText,_LOG_LINE);
        }
    }
    Delay_ms( 500 );
}

• An additional function is used to store responses.

void UART_RX_ISR()iv IVT_INT_USART3 ics ICS_AUTO
{
    if( RXNE_USART3_SR_bit )
    {
        char tmp = USART3_DR;
        ultrasonic2_getc(tmp);
    }
}

• Notes: Bear in mind that any change in device initialization drastically changes the workload of the device and its measurement pattern. This library has been made according to Texas Instruments PGA460 chip library.

Other mikroE Libraries used in the example:

• UART

Additional notes and information

Depending on the development board you are using, you may need USB UART click, USB UART 2 click or RS232 click to connect to your PC, for development systems with no UART to USB interface available on the board. The terminal available in all MikroElektronika compilers, or any other terminal application of your choice, can be used to read the message.