Njelajah mesin Mediastreamer2 VoIP. Bagean 5

Materi artikel dijupuk saka sandi saluran zen.

Detektor nada

Ing pungkasan artikel Kita wis nggawe meter level sinyal. Ing siji iki kita bakal sinau carane ndeteksi sinyal nada.

Ing jaman biyen, nalika ora saben kulawarga duwe TV, lan setengah saka wong-wong mau ngalih saluran nggunakake tang, kabar sing nyenengake muncul ing review saka pers teknis manca sing siji produsen TV dilengkapi piranti karo remot kontrol nirkabel. Saka rincian dikenal sing remot kontrol dilakokno tanpa baterei amarga nggunakake pendekatan mboten umum - remot kontrol mechanical lan Sato saka piranti musik - metallophone lan revolver. Drum revolver ngemot silinder logam kanthi dawa sing beda-beda, lan nalika pin tembak kena salah sijine, silinder kasebut wiwit muni kanthi frekuensi dhewe. Mesthine ing ultrasonik. Elektronik ing TV krungu sinyal kasebut lan, sawise nemtokake frekuensi, nindakake tumindak sing cocog - ngalih saluran, ngganti volume, mateni TV.

Dina iki kita bakal nyoba kanggo mbangun maneh sistem transmisi printah iki, nggunakake kawruh saka streamer media.

Kanggo simulasi remot kontrol, kita bakal nggunakake teks conto generator nada kita. Kita bakal nambah kontrol frekuensi generator saka keystrokes lan panrima karo decoder sing bakal output printah ditampa kanggo console. Sawise owah-owahan, generator kudu ngasilake nada 6 frekuensi, sing bakal kita encode perintah kanggo nambah / nyuda volume, ngganti saluran, nguripake / mateni TV. Kanggo ngatur detektor, struktur ing ngisor iki digunakake:

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;

Detektor bisa diwenehi 10 saka struktur kasebut, mula siji detektor bisa dikonfigurasi kanggo ndeteksi sepuluh sinyal rong nada. Nanging kita bakal nggunakake mung enem sinyal siji-nada. Kanggo nransfer setelan menyang detektor, metode MS_TONE_DETECTOR_ADD_SCAN digunakake.

Supaya detektor menehi kabar yen sinyal karo komponen frekuensi sing dikarepake wis teka ing input, kita kudu menehi fungsi callback sing bakal diluncurake ing kasus iki. Iki ditindakake kanthi nggunakake fungsi kasebut ms_filter_set_notify_callback(). Minangka argumen, iku nampa pointer menyang Filter, pointer menyang fungsi callback, lan pointer menyang data sing kita arep kanggo pass menyang fungsi callback (data pangguna).

Nalika detektor dipicu, fungsi callback bakal nampa data pangguna, pointer menyang filter detektor, pengenal acara, lan struktur sing nggambarake acara kasebut:

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

Diagram blok pangolahan sinyal ditampilake ing gambar judhul.

Inggih, saiki kode program dhewe karo komentar.

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

Kita ngumpulake lan mbukak program kasebut. Yen kabeh bisa mlaku kanthi bener, banjur sawise diluncurake, kita kudu njaluk kaya prilaku program iki:

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

Pencet sembarang tombol saka "1" kanggo "6", konfirmasi karo tombol "Ketik", sampeyan kudu njaluk kaya dhaftar iki:

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

Kita weruh yen nada printah kasil dikirim lan detektor ndeteksi.

Ing artikel sabanjure kita bakal nguripake kanggo ngirim sinyal audio liwat jaringan Ethernet nggunakake protokol RTP lan langsung aplikasi ing remot kontrol.

Source: www.habr.com