Esplora u mutore VoIP Mediastreamer2. Parte 5

U materiale di l'articulu hè pigliatu da u mo canale zen.

Rilevatore di tonu

In l'ultimu articulu Avemu creatu un metru di livellu di signale. In questu avemu da amparà cumu detect un signalu di tonu.

Esplora u mutore VoIP Mediastreamer2. Parte 5

In i vechji tempi, quandu micca ogni famiglia avia una TV, è a mità di elli cambiavanu canali cù pinze, nutizie intriganti apparsu in recensioni di a stampa tecnica straniera chì un fabricatore di TV hà equipatu i so dispositi cun un telecomando wireless. Da i dettagli, era cunnisciutu chì u telecomando operatu senza batterie grazia à l'usu di un accostu inusual - u telecomando era miccanicu è era un hibridu di un strumentu musicale - un metallophone è un revolver. U tamburinu di revolver cuntene cilindri di metalli di diverse lunghezze, è quandu u percutore hà colpitu unu di elli, u cilindru cuminciò à sonà à a so propria freccia. Presumibilmente nantu à ultrasound. L'elettronica in a TV hà intesu stu signale è, dopu avè determinatu a so freccia, hà realizatu l'azzione adatta - cambia u canali, cambia u voluminu, apague a TV.

Oghje avemu da pruvà à ricustruisce stu sistema di trasmissione di cumandamenti, utilizendu a nostra cunniscenza di u media streamer.

Per simulà un cuntrollu remoto, avemu aduprà u testu di u nostru esempiu generatore di tonu. Aghjunghjemu u cuntrollu di a frequenza di u generatore da i tasti di tasti è un receptore cù un decodificatore chì pruducerà cumandamenti ricevuti à a cunsola. Dopu à u cambiamentu, u generatore deve pruducia toni di frequenze 6, cù quale codificà cumandamenti per aumentà / diminuite u voluminu, cambia u canali, accende / spegne a TV. Per cunfigurà u detector, a struttura seguente hè aduprata:

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;

Un detector pò esse datu 10 di sti strutture, cusì un detector pò esse cunfiguratu per detectà dece signali bi-tonu. Ma avemu aduprà solu sei signali unicu tonu. Per trasfiriri i paràmetri à u detector, u metudu MS_TONE_DETECTOR_ADD_SCAN hè utilizatu.

Per chì u detector ci notificà chì un signalu cù i cumpunenti di freccia desiderata hè ghjuntu à a so input, avemu da furnisce cù una funzione di callback chì lanciarà in questu casu. Questu hè fattu cù a funzione ms_filter_set_notify_callback(). Cum'è argumenti, riceve un punteru à u filtru, un punteru à a funzione di callback, è un punteru à e dati chì vulemu passà à a funzione di callback (dati d'utilizatore).

Quandu u detector hè attivatu, a funzione di callback riceverà dati di l'utilizatori, un puntatore à u filtru di detector, un identificatore di l'avvenimentu è una struttura chì descrive l'avvenimentu:


/** * 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;

U schema di bloccu di u processu di signale hè mostratu in a stampa di titulu.

Ebbè, avà u codice prugrammu stessu cù cumenti.

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

Cumpilemu è eseguimu u prugramma. Se tuttu funziona bè, dopu à u lanciu duvemu avè qualcosa cum'è stu cumpurtamentu di u prugramma:

$ ./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

Pulsà ogni chjave da "1" à "6", cunfirmendu cù a chjave "Enter", duvete ottene qualcosa cum'è questa lista:


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

Avemu vistu chì i toni di cumanda sò mandati cù successu è u detector li detecta.

In u prossimu articulu, vulteremu à trasmette un signalu audio nantu à una reta Ethernet utilizendu u protocolu RTP è l'applicà immediatamente in u nostru cuntrollu remoto.

Source: www.habr.com

Add a comment