Explorando o motor de VoIP Mediastreamer2. Parte 4

O material do artigo está tirado do meu canle zen.

Creación dun medidor de nivel de sinal

No último Artigo Aclaramos a correcta terminación dos programas que usan a transmisión multimedia.

Neste artigo montaremos un circuíto de medidor de nivel de sinal e aprenderemos a ler o resultado da medición do filtro. Imos avaliar a precisión da medición.

O conxunto de filtros proporcionados polo streamer multimedia inclúe un filtro, MS_VOLUME, que é capaz de medir o nivel RMS do sinal que pasa por el, atenuando o sinal e realizando moitas funcións útiles e inesperadas. Dedicaremos un artigo enteiro a este filtro máis adiante. Pero de momento imos empregalo como medidor.

Utilizaremos como fonte de sinal un xerador de tons, cuxo sinal se enviará ao filtro MS_VOLUME, a cuxa saída está conectada a tarxeta de son.

Neste exemplo, utilizaremos o filtro xerador nun modo lixeiramente diferente: xerará un sinal dun só ton para nós, é dicir. un sinal que contén só unha oscilación sinusoidal.

Ademais da frecuencia e amplitude, teremos que establecer o tempo durante o que se xerará o sinal; debe ser suficiente para que un número suficiente de mostras pasen polo filtro MS_VOLUME para a medición. Para transferir a configuración ao xerador, utilízase a estrutura MSDtmfGenCustomTone:

struct _MSDtmfGenCustomTone{
    char tone_name[8];     /* Текстовое название сигнала из 8 букв.*/
    int duration;          /* Длительность сигнала в миллисекундах.*/
    int frequencies[2];    /* Пара частот из которых должен состоять выходной сигнал. */
    float amplitude;       /* Амплитуда тонов, 1.0 соответствует уровню 0 дБ от милливатта на нагрузке 600 Ом.*/
    int interval;          /* Пауза в миллисекундах перед началом повторного проигрывания сигнала.*/
    int repeat_count;      /* Количество повторов.*/
};
typedef struct _MSDtmfGenCustomTone MSDtmfGenCustomTone;

Para iniciar o xerador, utilizaremos o seu método MS_DTMF_GEN_PLAY_CUSTOM.

Diagrama de bloques de procesamento de sinal:

Explorando o motor de VoIP Mediastreamer2. Parte 4

O código do programa que implementa este esquema móstrase a continuación.

/* Файл mstest3.c */

#include <mediastreamer2/msfilter.h>
#include <mediastreamer2/msticker.h>
#include <mediastreamer2/dtmfgen.h>
#include <mediastreamer2/mssndcard.h>
#include <mediastreamer2/msvolume.h>

int main()
{
    ms_init();
    /* Создаем экземпляры фильтров. */
    MSFilter  *voidsource=ms_filter_new(MS_VOID_SOURCE_ID);
    MSFilter  *dtmfgen=ms_filter_new(MS_DTMF_GEN_ID);
    MSFilter  *volume=ms_filter_new(MS_VOLUME_ID);
    MSSndCard *card_playback=ms_snd_card_manager_get_default_card(ms_snd_card_manager_get());
    MSFilter  *snd_card_write=ms_snd_card_create_writer(card_playback);

    /* Создаем тикер. */
    MSTicker *ticker=ms_ticker_new();

    /* Соединяем фильтры в цепочку. */
    ms_filter_link(voidsource, 0, dtmfgen, 0);
    ms_filter_link(dtmfgen, 0, volume, 0);
    ms_filter_link(volume, 0, snd_card_write, 0);

    /* Подключаем источник тактов. */
    ms_ticker_attach(ticker,voidsource);

    MSDtmfGenCustomTone dtmf_cfg;

   /* Устанавливаем имя нашего сигнала, помня о том, что в массиве мы должны
    оставить место для нуля, который обозначает конец строки. */
    strncpy(dtmf_cfg.tone_name, "busy", sizeof(dtmf_cfg.tone_name));
    dtmf_cfg.duration=1000;
    dtmf_cfg.frequencies[0]=440; /* Будем генерировать один тон, частоту второго тона установим в 0.*/
    dtmf_cfg.frequencies[1]=0;
    dtmf_cfg.amplitude=1.0; /* Такой амплитуде синуса должен соответствовать результат измерения 0.707.*/
    dtmf_cfg.interval=0.;
    dtmf_cfg.repeat_count=0.;

   /* Включаем звуковой генератор. */
   ms_filter_call_method(dtmfgen, MS_DTMF_GEN_PLAY_CUSTOM, (void*)&dtmf_cfg);

   /* Даем, время половину секунды, чтобы измеритель накопил данные. */
   ms_usleep(500000);

   /* Читаем результат измерения. */
  float level=0;
   ms_filter_call_method(volume, MS_VOLUME_GET_LINEAR,&level);
   printf("Амплитуде синуса %f вольт  соответствует среднеквадратическое значение %f вольт.n", dtmf_cfg.amplitude, level);
}

Compilamos o noso exemplo, como fixemos antes, só usando o nome do ficheiro mstest3. Imos executalo e obter o resultado:

Амплитуде синуса 1.000000 вольт  соответствует среднеквадратическое значение 0.707733 вольт.

Como podes ver, o resultado da medición coincidiu co terceiro decimal co valor teórico igual á raíz cadrada de dous dividido á metade: sqr(2)/2=0,7071067811865475

A desviación relativa do resultado do valor verdadeiro foi do 0.1%. Avaliamos o erro de medición ao nivel máximo de sinal. En consecuencia, a medida que o nivel diminúe, o erro debería aumentar. Suxírolle que o avalíe vostede mesmo para os niveis de sinal baixos.

No seguinte artigo montaremos un circuíto que detecta a presenza dun sinal de ton dunha determinada frecuencia na entrada mediante un detector de tons. Tamén aprenderemos a procesar eventos xerados polos filtros.

Fonte: www.habr.com

Engadir un comentario