Pagsuhid sa Mediastreamer2 VoIP engine. Bahin 5

Ang materyal sa artikulo gikuha gikan sa akong zen channel.

Detektor sa signal sa tono

Sa ulahi artikulo Naghimo kita og signal level meter. Niini nga tutorial, atong tun-an unsaon pag-detect sa tone signal.

Sa karaang panahon, sa dihang dili tanang pamilya adunay telebisyon, ug katunga kanila nag-ilis og mga channel gamit ang pliers, ang langyaw nga teknikal nga prensa nagtaho sa makapainteres nga balita nga ang usa ka tiggama og telebisyon nagsangkap sa ilang mga set og wireless remote control. Ang mga detalye nagpadayag nga ang remote naglihok nga walay baterya tungod sa usa ka talagsaon nga pamaagi—kini mekanikal ug usa ka hybrid sa usa ka instrumento sa musika—usa ka glockenspiel ug usa ka revolver. Ang tambol sa revolver adunay mga silindro nga metal nga lainlain ang gitas-on, ug sa dihang ang striker moigo sa usa niini, ang silindro magsugod sa pag-ring sa kaugalingon nga frequency, lagmit ultrasonic. Ang mga electronics sa telebisyon nakadungog niini nga signal ug, human mahibal-an ang frequency niini, naghimo sa angay nga aksyon—usba ang channel, i-adjust ang volume, o i-off ang telebisyon.

Karon atong sulayan pag-usab pagtukod kini nga sistema sa pagpadala sa mando gamit ang atong kahibalo sa media streamer.

Aron ma-simulate ang usa ka remote control, atong gamiton ang code gikan sa atong ehemplo sa tone generator. Atong idugang ang kontrol sa frequency sa tone generator base sa mga keystroke ug usa ka receiver nga adunay decoder nga mo-output sa nadawat nga mga command ngadto sa console. Human sa pag-modify, ang tone generator kinahanglan nga mo-emit og unom ka frequency tones, nga atong gamiton sa pag-encode sa mga command para sa volume up/down, channel change, ug TV on/off. Aron ma-configure ang detector, gamita ang mosunod nga istruktura:

struct _MSToneDetectorDef{  
     char tone_name[8];     
     int frequency; /**<Expected frequency of the tone*/ 
     int min_duration; /**<Min duration of the tone in milliseconds */ 
     float min_amplitude; /**<Minimum amplitude of the tone, 1.0 corresponding to the normalized 0dbm level */
};

typedef struct _MSToneDetectorDef MSToneDetectorDef;

Ang detector mahimong ma-configure aron maka-detect og 10 ka ingon nga mga istruktura, nagpasabot nga ang usa ka detector mahimong ma-configure aron maka-detect og 10 ka two-tone signals. Apan, mogamit lang kita og unom ka single-tone signals. Ang MS_TONE_DETECTOR_ADD_SCAN nga pamaagi gigamit aron ma-configure ang detector.

Aron mapahibalo kita sa detector nga ang usa ka signal nga adunay gitinguha nga mga sangkap sa frequency miabot na sa input niini, kinahanglan natong hatagan kini og callback function nga ipatuman niini sa kini nga kaso. Gihimo kini gamit ang function ms_filter_set_notify_callback()Isip mga argumento, makadawat kini og pointer ngadto sa filter, usa ka pointer ngadto sa callback function, ug usa ka pointer ngadto sa data nga gusto natong ipasa ngadto sa callback function (user data).

Kung ma-trigger ang detector, ang callback function makadawat og user data, pointer sa detector filter, event identifier, ug istruktura nga naghulagway sa event:

/** * Structure carried as argument of the MS_TONE_DETECTOR_EVENT**/
struct _MSToneDetectorEvent{ 
      char tone_name[8];       /* Имя тона которое мы ему назначили при настройке детектора. */
      uint64_t tone_start_time;   /* Время в миллисекундах, когда тон был обнаружен. */
};

typedef struct _MSToneDetectorEvent MSToneDetectorEvent;

Ang estruktural nga dayagram sa pagproseso sa signal gipakita sa hulagway sa titulo.

Aw, karon ang programa mismo nag-code gamit ang mga komento.

/* Файл mstest4.c Имитатор пульта управления и приемника. */
#include <mediastreamer2/msfilter.h>
#include <mediastreamer2/msticker.h>
#include <mediastreamer2/dtmfgen.h>
#include <mediastreamer2/mssndcard.h>
#include <mediastreamer2/msvolume.h>
#include <mediastreamer2/mstonedetector.h>

/* Подключаем заголовочный файл с функциями управления событиями
 * медиастримера. */
#include <mediastreamer2/mseventqueue.h>

/* Функция обратного вызова, она будет вызвана фильтром, как только он
 * обнаружит совпадение характеристик входного сигнала с заданными. */
static void tone_detected_cb(void *data, MSFilter *f, unsigned int event_id,
        MSToneDetectorEvent *ev)
{
    printf("                      Принята команда: %sn", ev->tone_name);
}

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);
    MSFilter  *detector = ms_filter_new(MS_TONE_DETECTOR_ID);

    /* Очищаем массив находящийся внутри детектора тонов, он описывает
     * особые приметы разыскиваемых сигналов.*/
    ms_filter_call_method(detector, MS_TONE_DETECTOR_CLEAR_SCANS, 0);

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

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

    /* Подключаем к фильтру функцию обратного вызова. */
    ms_filter_set_notify_callback(detector,
            (MSFilterNotifyFunc)tone_detected_cb, NULL);

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

    /* Создаем массив, каждый элемент которого описывает характеристику
     * одного из тонов, который требуется обнаруживать: Текстовое имя
     * данного элемента, частота в герцах, длительность в миллисекундах,
     * минимальный уровень относительно 0,775В. */  
    MSToneDetectorDef  scan[6]=
    {
        {"V+",  440, 100, 0.1}, /* Команда "Увеличить громкость". */
        {"V-",  540, 100, 0.1}, /* Команда "Уменьшить громкость". */
        {"C+",  640, 100, 0.1}, /* Команда "Увеличить номер канала". */
        {"C-",  740, 100, 0.1}, /* Команда "Уменьшить номер канала". */
        {"ON",  840, 100, 0.1}, /* Команда "Включить телевизор". */
        {"OFF", 940, 100, 0.1}  /* Команда "Выключить телевизор". */
    };

    /* Передаем в детектор тонов приметы сигналов. */
    int i;
    for (i = 0; i < 6; i++)
    {
        ms_filter_call_method(detector, MS_TONE_DETECTOR_ADD_SCAN,
                &scan[i]);
    }

    /* Настраиваем структуру, управляющую выходным сигналом генератора.*/
    MSDtmfGenCustomTone dtmf_cfg;
    dtmf_cfg.tone_name[0] = 0;
    dtmf_cfg.duration = 1000;
    dtmf_cfg.frequencies[0] = 440;
    /* Будем генерировать один тон, частоту второго тона установим в 0.*/
    dtmf_cfg.frequencies[1] = 0;
    dtmf_cfg.amplitude = 1.0;
    dtmf_cfg.interval = 0.;
    dtmf_cfg.repeat_count = 0.;

    /* Организуем цикл сканирования нажатых клавиш. Ввод нуля завершает
     * цикл и работу программы. */
    char key='9';
    printf("Нажмите клавишу команды, затем ввод.n"
        "Для завершения программы введите 0.n");
    while(key != '0')
    {
        key = getchar();
        if ((key >= 49) && (key <= 54))
        {
                printf("Отправлена команда: %cn", key);
            /* Устанавливаем частоту генератора в соответствии с
             * кодом нажатой клавиши.*/
            dtmf_cfg.frequencies[0] = 440 + 100*(key-49);

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

I-compile ug padagana ang programa. Kon ang tanan molihok sa husto, makita nimo ang sama niini human kini padagana:

$ ./mstest4
ALSA lib conf.c:4738:(snd_config_expand) Unknown parameters 0
ALSA lib control.c:954:(snd_ctl_open_noupdate) Invalid CTL default:0
ortp-warning-Could not attach mixer to card: Invalid argument
ALSA lib conf.c:4738:(snd_config_expand) Unknown parameters 0
ALSA lib pcm.c:2266:(snd_pcm_open_noupdate) Unknown PCM default:0
ALSA lib conf.c:4738:(snd_config_expand) Unknown parameters 0
ALSA lib pcm.c:2266:(snd_pcm_open_noupdate) Unknown PCM default:0
ortp-warning-Strange, sound card Intel 82801AA-ICH does not seems to be capable of anything, retrying with plughw...
Нажмите клавишу команды, затем ввод.
Для завершения программы введите 0.
ortp-warning-alsa_set_params: periodsize:256 Using 256
ortp-warning-alsa_set_params: period:8 Using 8

Pindota ang bisan unsang mga buton gikan sa "1" hangtod sa "6", ug kumpirmahi gamit ang "Enter" nga buton, makakuha ka usa ka lista nga ingon niini:

2
Отправлена команда: 2
                      Принята команда: V-
1
Отправлена команда: 1
                      Принята команда: V+
3
Отправлена команда: 3
                      Принята команда: C+
4
Отправлена команда: 4
                      Принята команда: C-
0
$

Atong makita nga ang mga tono sa sugo malampusong napadala ug kini namatikdan sa detektor.

Sa sunod nga artikulo, atong tan-awon ang pagpadala sa audio pinaagi sa Ethernet network gamit ang RTP protocol ug dayon natong gamiton kini sa atong remote control.

Source: www.habr.com