Use a function from library

[Viki]

Hello!

I am working on a project of sound source localization and want to lit an individual ws2812 Led in the direction of the sound source.

I came across an expansion software package x-cube-memsmic1 which uses Acoustic SL library to estimate the angle of the sound source and send the angle along with some other things to PC via USB. The description says that the audio_application.c and usbd_audio_if.c contains some functions to get the angle from the source and send it.

Now I don't know which function does this and how?

/**
  ******************************************************************************
  * @file    audio_application.c
  * @author  SRA
  * @version v1.3.0
  * @date    17-Sep-2021
  * @brief   Source localization example.
  ******************************************************************************
  * @attention
  *
  * Copyright (c) 2022 STMicroelectronics.
  * All rights reserved.
  *
  * This software is licensed under terms that can be found in the LICENSE file
  * in the root directory of this software component.
  * If no LICENSE file comes with this software, it is provided AS-IS.
  *
  *
  ******************************************************************************
  */
 
/* Includes ------------------------------------------------------------------*/
#include "audio_application.h"
#include "acoustic_sl.h"
 
/** @addtogroup X_CUBE_MEMSMIC1_Applications
  * @{
  */
 
/** @addtogroup ACOUSTIC_SL_Example
  * @{
  */
 
/** @defgroup AUDIO_APPLICATION
  * @{
  */
 
/* Private typedef -----------------------------------------------------------*/
/* Private define ------------------------------------------------------------*/
/* Private macro -------------------------------------------------------------*/
 
/** @defgroup AUDIO_APPLICATION_Exported_Variables
  * @{
  */
uint16_t PDM_Buffer[((((AUDIO_IN_CHANNELS * AUDIO_IN_SAMPLING_FREQUENCY) / 1000) * MAX_DECIMATION_FACTOR) / 16)* N_MS ];
/**
  * @}
  */
 
/** @defgroup AUDIO_APPLICATION_Private_Variables
  * @{
  */
 
/* Private variables ---------------------------------------------------------*/
 
/*Handler and Config structure for Source Localization*/
AcousticSL_Handler_t libSoundSourceLoc_Handler_Instance;
AcousticSL_Config_t  libSoundSourceLoc_Config_Instance;
volatile int16_t  SOURCE_Angle_Value = 0;
volatile uint16_t SOURCE_Enable_Value = 1;
extern UART_HandleTypeDef UartHandle;
volatile int32_t result[2];
 
static uint16_t PCM_Buffer[AUDIO_IN_CHANNELS * AUDIO_IN_SAMPLING_FREQUENCY / 1000];
/**
  * @}
  */
 
/** @defgroup AUDIO_APPLICATION_Exported_Function
  * @{
  */
 
/**
  * @brief  Half Transfer user callback, called by BSP functions.
  * @param  None
  * @retval None
  */
void CCA02M2_AUDIO_IN_HalfTransfer_CallBack(uint32_t Instance)
{
  UNUSED(Instance);
  AudioProcess();
}
 
/**
  * @brief  Transfer Complete user callback, called by BSP functions.
  * @param  None
  * @retval None
  */
void CCA02M2_AUDIO_IN_TransferComplete_CallBack(uint32_t Instance)
{
  UNUSED(Instance);
  AudioProcess();
}
 
/**
  * @brief  User function that is called when 1 ms of PDM data is available.
  *       In this application only PDM to PCM conversion and USB streaming
  *                  is performed.
  *       User can add his own code here to perform some DSP or audio analysis.
  *                In this case audio libraries are used
  * @param  none
  * @retval None
  */
void AudioProcess(void)
{
  if (CCA02M2_AUDIO_IN_PDMToPCM(CCA02M2_AUDIO_INSTANCE, (uint16_t *)PDM_Buffer, PCM_Buffer) != BSP_ERROR_NONE)
  {
    Error_Handler();
  }
 
  if (AcousticSL_Data_Input((int16_t *)&PCM_Buffer[BOTTOM_LEFT_MIC], (int16_t *)&PCM_Buffer[TOP_RIGHT_MIC],
                            (int16_t *)&PCM_Buffer[BOTTOM_RIGHT_MIC], (int16_t *)&PCM_Buffer[TOP_LEFT_MIC], &libSoundSourceLoc_Handler_Instance) == 1U)
  {
    SW_Task2_Start(); /*Localization Processing Task*/
  }
 
  Send_Audio_to_USB((int16_t *)PCM_Buffer, AUDIO_IN_SAMPLING_FREQUENCY / 1000 * AUDIO_IN_CHANNELS);
}
 
/**
  * @brief  Initialize the audio libraries adopted
  * @param  None
  * @retval None
  */
void Audio_Libraries_Init(void)
{
  __IO uint32_t error_value = 0;
  /* Enable CRC peripheral to unlock the library */
  __CRC_CLK_ENABLE();
 
  /*Setup Source Localization static parameters*/
  libSoundSourceLoc_Handler_Instance.channel_number = 4;
  libSoundSourceLoc_Handler_Instance.M12_distance = DIAGONAL;
  libSoundSourceLoc_Handler_Instance.M34_distance = DIAGONAL;
  libSoundSourceLoc_Handler_Instance.sampling_frequency = AUDIO_IN_SAMPLING_FREQUENCY;
  libSoundSourceLoc_Handler_Instance.algorithm = ACOUSTIC_SL_ALGORITHM_GCCP;
  libSoundSourceLoc_Handler_Instance.ptr_M1_channels = 4;
  libSoundSourceLoc_Handler_Instance.ptr_M2_channels = 4;
  libSoundSourceLoc_Handler_Instance.ptr_M3_channels = 4;
  libSoundSourceLoc_Handler_Instance.ptr_M4_channels = 4;
  libSoundSourceLoc_Handler_Instance.samples_to_process = 512;
  (void)AcousticSL_getMemorySize(&libSoundSourceLoc_Handler_Instance);
  libSoundSourceLoc_Handler_Instance.pInternalMemory = (uint32_t *)malloc(libSoundSourceLoc_Handler_Instance.internal_memory_size);
  error_value += AcousticSL_Init(&libSoundSourceLoc_Handler_Instance);
 
  /*Setup Source Localization dynamic parameters*/
  libSoundSourceLoc_Config_Instance.resolution = 10;
  libSoundSourceLoc_Config_Instance.threshold = 24;
  error_value += AcousticSL_setConfig(&libSoundSourceLoc_Handler_Instance, &libSoundSourceLoc_Config_Instance);
 
  /*Error Management*/
  if (error_value != 0U)
  {
    Error_Handler();
  }
 
  /*Malloc Failure*/
  if (libSoundSourceLoc_Handler_Instance.pInternalMemory == NULL)
  {
    Error_Handler();
  }
 
}
 
/**
  * @brief  Initializes two SW interrupt with different priorities
  * @param  None
  * @retval None
  */
void SW_IRQ_Tasks_Init(void)
{
  HAL_NVIC_SetPriority((IRQn_Type)EXTI1_IRQn, 0x0D, 0);
  HAL_NVIC_EnableIRQ((IRQn_Type)EXTI1_IRQn);
 
  HAL_NVIC_SetPriority((IRQn_Type)EXTI2_IRQn, 0x0E, 0);
  HAL_NVIC_EnableIRQ((IRQn_Type)EXTI2_IRQn);
 
}
 
 
/**
  * @brief  Highest priority interrupt handler routine
  * @param  None
  * @retval None
  */
void SW_Task1_Callback(void)
{
 
}
 
/**
  * @brief Lower priority interrupt handler routine
  * @param  None
  * @retval None
  */
 
void SW_Task2_Callback(void)
{
  (void)AcousticSL_Process((int32_t *)&result, &libSoundSourceLoc_Handler_Instance);
 
  if (result[0] == ACOUSTIC_SL_NO_AUDIO_DETECTED)
  {
    result[0] = -1;
  }
 
  if (result[0] != -1)
  {
    char output[4];
    int32_t n = sprintf(output, "%li", (int32_t)result[0]);
    (void)HAL_UART_Transmit(&UartHandle, (uint8_t *)"    ", 4, 0xFFFF);
    (void)HAL_UART_Transmit(&UartHandle, (uint8_t *)"\r", 1, 0xFFFF);
    (void)HAL_UART_Transmit(&UartHandle, (uint8_t *)output, (uint16_t)n, 0xFFFF);
  }
}
 
 
/**
  * @brief Throws Highest priority interrupt
  * @param  None
  * @retval None
  */
void SW_Task1_Start(void)
{
  HAL_NVIC_SetPendingIRQ(EXTI1_IRQn);
}
 
void SW_Task2_Start(void)
{
  HAL_NVIC_SetPendingIRQ(EXTI2_IRQn);
}
 
 
void Error_Handler(void)
{
  while (1);
}
 
 
/**
  * @}
  */
 
/**
  * @}
  */
 
/**
  * @}
  */
 
/**
  * @}
  */

Can someone tell me how can I get that specific function so I can put it in main loop?

Thanks

Viki

[SimonePradolini · Accepted solution]

Hello @Community member​ 

The function your are searching for is the SW_Task2_Callback, the software interrupt callback where AcousticSL_Process is called, angle data is saved into result variable and then sent via UART through UART_Trasmit.

To build up a fully working application, have a look on the entire AcousticSL example, where we are showing the complete procedure to initialize the library, setup its parameter correctly, feed the audio data and then get the estimated angle.

Simply calling the AcousticSL_Process function without instantiating the library properly will not work.

I advise you also to have a look also to acoustic_sl.h file, where you can find all the function declarations for the AcousticSL library.

For each function you can find a brief description, the required parameters and the meaning of return values.

Let us updated on your development and feel free to ask for further support.

Best regards

[Viki]

Thank you!

I have been waiting for so long but no one answered me.

[Viki]

Actually I want to get the angle and with that angle I want to Light up an Neopixel LED, I have 12 WS2812 Leds and I want to light each according to the angle of the sound source.