Verken die Mediastreamer2 VoIP-enjin. Deel 5

Die materiaal van die artikel is geneem uit my zen-kanaal.

Toondetektor

In die laaste Artikel Ons het 'n seinvlakmeter geskep. In hierdie een sal ons leer hoe om 'n toonsein op te spoor.

In die ou dae, toe nie elke gesin 'n TV gehad het nie, en die helfte van hulle van kanale met 'n tang verander het, het intrige nuus in resensies van die buitelandse tegniese pers verskyn dat een TV-vervaardiger hul toestelle met 'n draadlose afstandbeheer toegerus het. Uit die besonderhede was dit bekend dat die afstandbeheerder sonder batterye werk danksy die gebruik van 'n ongewone benadering - die afstandbeheerder was meganies en was 'n baster van 'n musiekinstrument - 'n metallofoon en 'n rewolwer. Die rewolvertrom het metaalsilinders van verskillende lengtes bevat, en toe die slagpen een van hulle tref, het die silinder op sy eie frekwensie begin lui. Vermoedelik op ultraklank. Die elektronika in die TV het hierdie sein gehoor en, nadat die frekwensie daarvan bepaal is, die toepaslike aksie uitgevoer - skakel die kanaal, verander die volume, skakel die TV af.

Vandag sal ons probeer om hierdie opdrag-oordragstelsel te rekonstrueer deur ons kennis van die mediastreamer te gebruik.

Om 'n afstandbeheerder te simuleer, sal ons die teks van ons toongenerator-voorbeeld gebruik. Ons sal beheer oor die kragopwekkerfrekwensie daarby voeg vanaf toetsaanslagen en 'n ontvanger met 'n dekodeerder wat ontvangde opdragte na die konsole sal uitvoer. Na die verandering moet die kragopwekker toon van 6 frekwensies produseer, waarmee ons opdragte sal kodeer om die volume te verhoog/verlaag, die kanaal te verander, die TV aan/af te skakel. Om die detektor op te stel, word die volgende struktuur gebruik:

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;

'n Detektor kan 10 van hierdie strukture gegee word, so een detektor kan gekonfigureer word om tien tweetoon seine op te spoor. Maar ons sal slegs ses enkeltoon seine gebruik. Om instellings na die detektor oor te dra, word die MS_TONE_DETECTOR_ADD_SCAN-metode gebruik.

Ten einde die detektor ons in kennis te stel dat 'n sein met die verlangde frekwensiekomponente by sy inset aangekom het, moet ons dit voorsien van 'n terugbelfunksie wat dit in hierdie geval sal begin. Dit word gedoen met behulp van die funksie ms_filter_set_notify_callback(). As argumente ontvang dit 'n wyser na die filter, 'n wyser na die terugbelfunksie en 'n wyser na die data wat ons graag na die terugbelfunksie (gebruikersdata) wil deurgee.

Wanneer die detektor geaktiveer word, sal die terugbelfunksie gebruikersdata ontvang, 'n wyser na die detektorfilter, 'n gebeurtenisidentifiseerder en 'n struktuur wat die gebeurtenis beskryf:

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

Die blokdiagram van seinverwerking word in die titelprent getoon.

Wel, nou die programkode self met kommentaar.

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

Ons stel die program saam en voer dit uit. As alles reg werk, behoort ons na bekendstelling iets soos hierdie programgedrag te kry:

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

Druk enige sleutels van "1" tot "6", bevestig met die "Enter" sleutel, jy behoort iets soos hierdie lys te kry:

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

Ons sien dat die beveltone suksesvol gestuur word en die detektor bespeur dit.

In die volgende artikel gaan ons wend tot die oordrag van 'n oudiosein oor 'n Ethernet-netwerk met behulp van die RTP-protokol en dit onmiddellik in ons afstandbeheer toepas.

Bron: will.com