microphone.c File Reference

API to access an audio microphone; provides access to hardware microphones; actually just wraps the gnunet-helper-audio-record. More...

#include "platform.h"
#include "gnunet_microphone_lib.h"
#include "conversation.h"

Include dependency graph for microphone.c:

Go to the source code of this file.

Data Structures
struct	Microphone
	Internal data structures for the microphone. More...

Functions
static int	process_record_messages (void *cls, const struct GNUNET_MessageHeader *msg)
	Function to process the audio from the record helper. More...
static int	enable (void *cls, GNUNET_MICROPHONE_RecordedDataCallback rdc, void *rdc_cls)
	Enable a microphone. More...
static void	disable (void *cls)
	Function that disables a microphone. More...
static void	destroy (void *cls)
	Function to destroy a microphone. More...
struct GNUNET_MICROPHONE_Handle *	GNUNET_MICROPHONE_create_from_hardware (const struct GNUNET_CONFIGURATION_Handle *cfg)
	Create a microphone that corresponds to the microphone hardware of our system. More...
void	GNUNET_MICROPHONE_destroy (struct GNUNET_MICROPHONE_Handle *microphone)
	Destroy a microphone. More...

Detailed Description

API to access an audio microphone; provides access to hardware microphones; actually just wraps the gnunet-helper-audio-record.

Author

Simon Dieterle

Andreas Fuchs

Christian Grothoff

Definition in file microphone.c.

Function Documentation

process_record_messages()

static int process_record_messages ( void *  cls, const struct GNUNET_MessageHeader *  msg  )

static

Function to process the audio from the record helper.

Parameters

cls	clsoure with our struct Microphone
msg	the message from the helper

Returns

GNUNET_OK on success, GNUNET_NO to stop further processing (no error) GNUNET_SYSERR to stop further processing with error

Definition at line 72 of file microphone.c.

{
  struct Microphone *mic = cls;
  const struct AudioMessage *am;
 
  if (ntohs (msg->type) != GNUNET_MESSAGE_TYPE_CONVERSATION_AUDIO)
  {
    GNUNET_break (0);
    return GNUNET_SYSERR;
  }
  am = (const struct AudioMessage *) msg;
  mic->rdc (mic->rdc_cls,
            ntohs (msg->size) - sizeof(struct AudioMessage),
            &am[1]);
  return GNUNET_OK;
}

References GNUNET_break, GNUNET_MESSAGE_TYPE_CONVERSATION_AUDIO, GNUNET_OK, GNUNET_SYSERR, mic, msg, GNUNET_MessageHeader::size, and GNUNET_MessageHeader::type.

Referenced by enable().

Here is the caller graph for this function:

enable()

static int enable ( void *  cls, GNUNET_MICROPHONE_RecordedDataCallback  rdc, void *  rdc_cls  )

static

Enable a microphone.

Parameters

cls	clsoure with our struct Microphone
rdc	function to call with recorded data
rdc_cls	closure for dc

Definition at line 99 of file microphone.c.

{
  struct Microphone *mic = cls;
  static char *const record_helper_argv[] = {
    (char*) "gnunet-helper-audio-record",
    NULL
  };
 
  mic->rdc = rdc;
  mic->rdc_cls = rdc_cls;
  mic->record_helper = GNUNET_HELPER_start (GNUNET_OS_project_data_gnunet(),
                                            GNUNET_NO,
                                            "gnunet-helper-audio-record",
                                            record_helper_argv,
                                            &process_record_messages,
                                            NULL, mic);
  if (NULL == mic->record_helper)
  {
    GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
                _ ("Could not start record audio helper\n"));
    return GNUNET_SYSERR;
  }
  return GNUNET_OK;
}

References _, GNUNET_ERROR_TYPE_ERROR, GNUNET_HELPER_start(), GNUNET_log, GNUNET_NO, GNUNET_OK, GNUNET_OS_project_data_gnunet(), GNUNET_SYSERR, mic, process_record_messages(), Microphone::rdc, and Microphone::rdc_cls.

Referenced by GNUNET_MICROPHONE_create_from_hardware().

Here is the call graph for this function:

Here is the caller graph for this function:

disable()

static void disable ( void *  cls )

static

Function that disables a microphone.

Parameters

cls

clsoure

Definition at line 133 of file microphone.c.

{
  struct Microphone *mic = cls;
 
  if (NULL == mic->record_helper)
  {
    GNUNET_break (0);
    return;
  }
  GNUNET_break (GNUNET_OK ==
                GNUNET_HELPER_kill (mic->record_helper, GNUNET_NO));
  GNUNET_HELPER_destroy (mic->record_helper);
  mic->record_helper = NULL;
}

References GNUNET_break, GNUNET_HELPER_destroy(), GNUNET_HELPER_kill(), GNUNET_NO, GNUNET_OK, and mic.

Referenced by destroy(), and GNUNET_MICROPHONE_create_from_hardware().

Here is the call graph for this function:

Here is the caller graph for this function:

destroy()

static void destroy ( void *  cls )

static

Function to destroy a microphone.

Parameters

cls

clsoure

Definition at line 155 of file microphone.c.

{
  struct Microphone *mic = cls;
 
  if (NULL != mic->record_helper)
    disable (mic);
}

References disable(), and mic.

Referenced by GNUNET_MICROPHONE_create_from_hardware(), and GNUNET_MQ_queue_for_callbacks().

Here is the call graph for this function:

Here is the caller graph for this function: