GNUnet  0.19.4
microphone.c
Go to the documentation of this file.
1 /*
2  This file is part of GNUnet
3  Copyright (C) 2013 GNUnet e.V.
4 
5  GNUnet is free software: you can redistribute it and/or modify it
6  under the terms of the GNU Affero General Public License as published
7  by the Free Software Foundation, either version 3 of the License,
8  or (at your option) any later version.
9 
10  GNUnet is distributed in the hope that it will be useful, but
11  WITHOUT ANY WARRANTY; without even the implied warranty of
12  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13  Affero General Public License for more details.
14 
15  You should have received a copy of the GNU Affero General Public License
16  along with this program. If not, see <http://www.gnu.org/licenses/>.
17 
18  SPDX-License-Identifier: AGPL3.0-or-later
19  */
20 
29 #include "platform.h"
30 #include "gnunet_microphone_lib.h"
31 #include "conversation.h"
32 
33 
37 struct Microphone
38 {
43 
48 
53 
57  void *rdc_cls;
58 };
59 
60 
70 static int
72  const struct GNUNET_MessageHeader *msg)
73 {
74  struct Microphone *mic = cls;
75  const struct AudioMessage *am;
76 
78  {
79  GNUNET_break (0);
80  return GNUNET_SYSERR;
81  }
82  am = (const struct AudioMessage *) msg;
83  mic->rdc (mic->rdc_cls,
84  ntohs (msg->size) - sizeof(struct AudioMessage),
85  &am[1]);
86  return GNUNET_OK;
87 }
88 
89 
97 static int
98 enable (void *cls,
100  void *rdc_cls)
101 {
102  struct Microphone *mic = cls;
103  static char *const record_helper_argv[] = {
104  "gnunet-helper-audio-record",
105  NULL
106  };
107 
108  mic->rdc = rdc;
109  mic->rdc_cls = rdc_cls;
110  mic->record_helper = GNUNET_HELPER_start (GNUNET_NO,
111  "gnunet-helper-audio-record",
112  record_helper_argv,
114  NULL, mic);
115  if (NULL == mic->record_helper)
116  {
118  _ ("Could not start record audio helper\n"));
119  return GNUNET_SYSERR;
120  }
121  return GNUNET_OK;
122 }
123 
124 
130 static void
131 disable (void *cls)
132 {
133  struct Microphone *mic = cls;
134 
135  if (NULL == mic->record_helper)
136  {
137  GNUNET_break (0);
138  return;
139  }
141  GNUNET_HELPER_kill (mic->record_helper, GNUNET_NO));
142  GNUNET_HELPER_destroy (mic->record_helper);
143  mic->record_helper = NULL;
144 }
145 
146 
152 static void
153 destroy (void *cls)
154 {
155  struct Microphone *mic = cls;
156 
157  if (NULL != mic->record_helper)
158  disable (mic);
159 }
160 
161 
172 {
174  struct Microphone *mic;
175 
176  mic = GNUNET_new (struct Microphone);
177  mic->cfg = cfg;
179  microphone->cls = mic;
183  return microphone;
184 }
185 
186 
192 void
194 {
197 }
198 
199 
200 /* end of microphone.c */
struct GNUNET_MessageHeader * msg
Definition: 005.c:2
constants for network protocols
static const struct GNUNET_CONFIGURATION_Handle * cfg
Configuration we are using.
Definition: gnunet-abd.c:36
static struct GNUNET_MICROPHONE_Handle * microphone
Handle to the microphone.
static struct GNUNET_MICROPHONE_Handle * mic
Our microphone.
API to access an audio microphone; provides access to hardware microphones.
int GNUNET_HELPER_kill(struct GNUNET_HELPER_Handle *h, int soft_kill)
Sends termination signal to the helper process.
Definition: helper.c:167
struct GNUNET_HELPER_Handle * GNUNET_HELPER_start(int with_control_pipe, const char *binary_name, char *const binary_argv[], GNUNET_MessageTokenizerCallback cb, GNUNET_HELPER_ExceptionCallback exp_cb, void *cb_cls)
Starts a helper and begins reading from it.
Definition: helper.c:461
void GNUNET_HELPER_destroy(struct GNUNET_HELPER_Handle *h)
Free's the resources occupied by the helper handle.
Definition: helper.c:500
#define GNUNET_log(kind,...)
@ GNUNET_OK
@ GNUNET_NO
@ GNUNET_SYSERR
#define GNUNET_break(cond)
Use this for internal assertion violations that are not fatal (can be handled) but should not occur.
@ GNUNET_ERROR_TYPE_ERROR
#define GNUNET_new(type)
Allocate a struct or union of the given type.
#define GNUNET_free(ptr)
Wrapper around free.
void GNUNET_MICROPHONE_destroy(struct GNUNET_MICROPHONE_Handle *microphone)
Destroy a microphone.
Definition: microphone.c:193
void(* GNUNET_MICROPHONE_RecordedDataCallback)(void *cls, size_t data_size, const void *data)
Process recorded audio data.
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.
Definition: microphone.c:170
#define GNUNET_MESSAGE_TYPE_CONVERSATION_AUDIO
Message to transmit the audio between helper and speaker/microphone library.
static int process_record_messages(void *cls, const struct GNUNET_MessageHeader *msg)
Function to process the audio from the record helper.
Definition: microphone.c:71
static void disable(void *cls)
Function that disables a microphone.
Definition: microphone.c:131
static int enable(void *cls, GNUNET_MICROPHONE_RecordedDataCallback rdc, void *rdc_cls)
Enable a microphone.
Definition: microphone.c:98
static void destroy(void *cls)
Function to destroy a microphone.
Definition: microphone.c:153
#define _(String)
GNU gettext support macro.
Definition: platform.h:177
Message to transmit the audio (between client and helpers).
Definition: conversation.h:59
The handle to a helper process.
Definition: helper.c:78
A microphone is a device that can capture or otherwise produce audio data.
void * cls
Closure for the callbacks.
GNUNET_MICROPHONE_DisableCallback disable_microphone
Turn the microphone off.
GNUNET_MICROPHONE_DestroyCallback destroy_microphone
Destroy the microphone.
GNUNET_MICROPHONE_EnableCallback enable_microphone
Turn on the microphone.
Header for all communications.
uint16_t type
The type of the message (GNUNET_MESSAGE_TYPE_XXXX), in big-endian format.
uint16_t size
The length of the struct (in bytes, including the length field itself), in big-endian format.
Internal data structures for the microphone.
Definition: microphone.c:38
struct GNUNET_HELPER_Handle * record_helper
Handle for the record helper.
Definition: microphone.c:47
void * rdc_cls
Closure for rdc.
Definition: microphone.c:57
const struct GNUNET_CONFIGURATION_Handle * cfg
Our configuration.
Definition: microphone.c:42
GNUNET_MICROPHONE_RecordedDataCallback rdc
Function to call with audio data (if we are enabled).
Definition: microphone.c:52