Mediastreamer2 VoIP motorra arakatzen. 4. zatia

Artikuluaren materiala niretik hartua da zen kanala.

Seinale maila-neurgailua sortzea

Azkenean Artikulu Media streamer erabiliz programen amaiera zuzena argitu dugu.

Artikulu honetan seinale-neurgailuaren zirkuitu bat muntatuko dugu eta iragazkiaren neurketaren emaitza nola irakurtzen ikasiko dugu. Ebalua dezagun neurketaren zehaztasuna.

Media streamer-ek eskaintzen duen iragazkien multzoak iragazki bat dauka, MS_VOLUME, bertatik pasatzen den seinalearen RMS maila neurtzeko gai dena, seinalea arintzeko eta funtzio erabilgarria eta ustekabeko asko betetzeko. Artikulu oso bat eskainiko diogu iragazki honi geroago. Baina oraingoz neurgailu gisa erabiliko dugu.

Seinale-iturburu gisa tonu-sorgailu bat erabiliko dugu, eta seinalea MS_VOLUME iragazkira bidaliko da, zeinaren irteerara soinu-txartela konektatuta dagoen.

Adibide honetan, sorgailu-iragazkia modu apur bat ezberdin batean erabiliko dugu - tonu bakarreko seinalea sortuko digu, hau da. oszilazio sinusoidal bakarra duen seinalea.

Maiztasunaz eta anplitudeaz gain, seinalea sortuko den denbora ezarri beharko dugu; nahikoa izan behar da MS_VOLUME iragazkitik lagin kopuru nahikoa igaro dadin neurtzeko. Ezarpenak sorgailura transferitzeko, MSDtmfGenCustomTone egitura erabiltzen da:

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;

Sorgailua abiarazteko, bere MS_DTMF_GEN_PLAY_CUSTOM metodoa erabiliko dugu.

Seinalearen prozesamenduaren bloke-diagrama:

Eskema hau inplementatzen duen programa-kodea behean agertzen da.

/* Файл 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);
}

Gure adibidea konpilatzen dugu, lehen egin genuen bezala, fitxategiaren izena soilik erabiliz mstest3. Exekutatu eta lortu dezagun emaitza:

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

Ikus dezakezunez, neurketaren emaitza hirugarren hamartarrekin bat egin zuen biren erro karratuaren balio teorikoarekin erditan zatituta: sqr(2)/2=0,7071067811865475

Emaitzaren benetako balioarekiko desbideratze erlatiboa %0.1ekoa izan zen. Neurketa-errorea seinale maila maximoan baloratu dugu. Horren arabera, maila jaisten den heinean, errorea handitu beharko litzateke. Zuk zeuk ebaluatzea gomendatzen dizut seinale maila baxuetarako.

Hurrengo artikuluan sarreran maiztasun jakin bateko tonu-seinale baten presentzia detektatzen duen zirkuitu bat muntatuko dugu tonu-detektagailu baten bidez. Iragazkiek sortutako gertaerak nola prozesatu ere ikasiko dugu.

Iturria: www.habr.com