ProHoster > Blog > administração > Explorando o mecanismo VoIP do Mediastreamer2. Parte 5

Explorando o mecanismo VoIP do Mediastreamer2. Parte 5

O material do artigo foi retirado do meu canal zen.

Detector de tom

No passado статье Criamos um medidor de nível de sinal. Neste aprenderemos como detectar um sinal de tom.

Explorando o mecanismo VoIP do Mediastreamer2. Parte 5

Antigamente, quando nem toda família tinha TV e metade delas trocava de canal com um alicate, surgiram notícias intrigantes nas resenhas da imprensa técnica estrangeira de que um fabricante de TV equipava seus aparelhos com um controle remoto sem fio. Pelos detalhes sabia-se que o controle remoto funcionava sem pilhas graças ao uso de uma abordagem inusitada - o controle remoto era mecânico e era um híbrido de um instrumento musical - um metalofone e um revólver. O tambor do revólver continha cilindros de metal de diferentes comprimentos e, quando o percutor atingiu um deles, o cilindro começou a tocar em sua própria frequência. Provavelmente no ultrassom. A eletrônica da TV ouviu esse sinal e, tendo determinado sua frequência, realizou a ação apropriada - mudar de canal, mudar o volume, desligar a TV.

Hoje tentaremos reconstruir esse sistema de transmissão de comandos, utilizando nosso conhecimento do streamer de mídia.

Para simular um controle remoto, usaremos o texto do nosso exemplo de gerador de tons. Adicionaremos a ele o controle da frequência do gerador a partir das teclas digitadas e um receptor com um decodificador que enviará os comandos recebidos para o console. Após a mudança, o gerador deverá produzir tons de 6 frequências, com os quais codificaremos comandos para aumentar/diminuir o volume, mudar de canal, ligar/desligar a TV. Para configurar o detector, é utilizada a seguinte estrutura:

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;

Um detector pode receber 10 dessas estruturas, portanto, um detector pode ser configurado para detectar dez sinais de dois tons. Mas usaremos apenas seis sinais de tom único. Para transferir as configurações para o detector, o método MS_TONE_DETECTOR_ADD_SCAN é usado.

Para que o detector nos avise que um sinal com as componentes de frequência desejadas chegou à sua entrada, devemos fornecer-lhe uma função de retorno de chamada que neste caso será lançada. Isso é feito usando a função ms_filter_set_notify_callback(). Como argumentos, ele recebe um ponteiro para o filtro, um ponteiro para a função de retorno de chamada e um ponteiro para os dados que gostaríamos de passar para a função de retorno de chamada (dados do usuário).

Quando o detector é acionado, a função de retorno de chamada receberá dados do usuário, um ponteiro para o filtro do detector, um identificador de evento e uma estrutura que descreve o evento:


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

O diagrama de blocos do processamento de sinal é mostrado na imagem do título.

Bem, agora o próprio código do programa com comentários.

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

Compilamos e executamos o programa. Se tudo funcionar corretamente, após o lançamento devemos obter algo parecido com este comportamento do programa:

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

Pressione qualquer tecla de “1” a “6”, confirmando com a tecla “Enter”, você deverá obter algo parecido com esta listagem:


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

Vemos que os tons de comando foram enviados com sucesso e o detector os detecta.

No próximo artigo passaremos a transmitir um sinal de áudio através de uma rede Ethernet usando o protocolo RTP e aplicá-lo imediatamente em nosso controle remoto.

Fonte: habr.com

Adicionar um comentário