2 * This file is part of the libsigrok project.
4 * Copyright (C) 2011 Daniel Ribeiro <drwyrm@gmail.com>
5 * Copyright (C) 2012 Uwe Hermann <uwe@hermann-uwe.de>
6 * Copyright (C) 2012 Alexandru Gagniuc <mr.nuke.me@gmail.com>
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation; either version 2 of the License, or
11 * (at your option) any later version.
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
18 * You should have received a copy of the GNU General Public License
19 * along with this program; if not, write to the Free Software
20 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
23 #include "libsigrok.h"
24 #include "libsigrok-internal.h"
28 * There is no way to get a list of supported samplerates from ALSA. We could
29 * use the 'plughw' interface of ALSA, in which case any format and/or
30 * samplerate conversion would be performed by ALSA. However, we are interested
31 * in the hardware capabilities, and have the infrastructure in sigrok to do so.
32 * We therefore use the 'hw' interface. The downside is that the code gets a
33 * little bulkier, as we have to keep track of the hardware capabilities, and
34 * only use those that the hardware supports. Case in point, ALSA will not give
35 * us a list of capabilities; we have to test for each one individually. Hence,
36 * we keep lists of the capabilities we are interested in.
38 static const unsigned int rates[] = {
55 768000, /* Yes, there are sound cards that go this high. */
58 static void alsa_scan_handle_dev(GSList **devices,
59 const char *cardname, const char *alsaname,
60 struct sr_dev_driver *di,
61 snd_pcm_info_t *pcminfo)
63 struct drv_context *drvc = NULL;
64 struct sr_dev_inst *sdi = NULL;
65 struct dev_context *devc = NULL;
66 struct sr_probe *probe;
68 unsigned int i, offset, channels, minrate, maxrate, rate;
69 uint64_t hwrates[ARRAY_SIZE(rates)];
70 uint64_t *devrates = NULL;
71 snd_pcm_t *temp_handle = NULL;
72 snd_pcm_hw_params_t *hw_params = NULL;
78 * Get hardware parameters:
79 * The number of channels, for example, are our sigrok probes. Getting
80 * this information needs a detour. We need to open the device, then
81 * query it and/or test different parameters. A side-effect of is that
82 * we create a snd_pcm_hw_params_t object. We take advantage of the
83 * situation, and pass this object in our dev_context->hw_params,
84 * eliminating the need to free() it and malloc() it later.
86 ret = snd_pcm_open(&temp_handle, alsaname, SND_PCM_STREAM_CAPTURE, 0);
88 sr_err("Cannot open device: %s.", snd_strerror(ret));
89 goto scan_error_cleanup;
92 ret = snd_pcm_hw_params_malloc(&hw_params);
94 sr_err("Error allocating hardware parameter structure: %s.",
96 goto scan_error_cleanup;
99 ret = snd_pcm_hw_params_any(temp_handle, hw_params);
101 sr_err("Error initializing hardware parameter structure: %s.",
103 goto scan_error_cleanup;
106 snd_pcm_hw_params_get_channels_max(hw_params, &channels);
109 * We need to test if each samplerate between min and max is supported.
110 * Unfortunately, ALSA won't just throw a list at us.
112 snd_pcm_hw_params_get_rate_min(hw_params, &minrate, 0);
113 snd_pcm_hw_params_get_rate_max(hw_params, &maxrate, 0);
114 for (i = 0, offset = 0; i < ARRAY_SIZE(rates); i++) {
120 ret = snd_pcm_hw_params_test_rate(temp_handle, hw_params,
123 hwrates[offset++] = rate;
125 hwrates[offset++] = 0;
127 if ((ret = snd_pcm_close(temp_handle)) < 0)
128 sr_err("Failed to close device: %s.", snd_strerror(ret));
132 * Now we are done querying the hardware parameters.
133 * If we made it here, we know everything we want to know, and it's
134 * time to create our sigrok device.
136 sr_info("Device %s has %d channels.", alsaname, channels);
137 if (!(sdi = sr_dev_inst_new(0, SR_ST_INACTIVE, "ALSA:",
138 cardname, snd_pcm_info_get_name(pcminfo)))) {
139 sr_err("Failed to create device instance.");
140 goto scan_error_cleanup;
142 if (!(devc = g_try_malloc0(sizeof(struct dev_context)))) {
143 sr_err("Device context malloc failed.");
144 goto scan_error_cleanup;
146 if (!(devrates = g_try_malloc(offset * sizeof(uint64_t)))) {
147 sr_err("Samplerate list malloc failed.");
148 goto scan_error_cleanup;
151 devc->hwdev = g_strdup(alsaname);
152 devc->num_probes = channels;
153 devc->hw_params = hw_params;
154 memcpy(devrates, hwrates, offset * sizeof(uint64_t));
155 devc->supp_rates.list = devrates;
160 for (i = 0; i < devc->num_probes; i++) {
161 snprintf(p_name, sizeof(p_name), "Ch_%d", i);
162 if (!(probe = sr_probe_new(0, SR_PROBE_ANALOG, TRUE, p_name)))
163 goto scan_error_cleanup;
164 sdi->probes = g_slist_append(sdi->probes, probe);
167 drvc->instances = g_slist_append(drvc->instances, sdi);
168 *devices = g_slist_append(*devices, sdi);
180 sr_dev_inst_free(sdi);
182 snd_pcm_hw_params_free(hw_params);
184 if ((ret = snd_pcm_close(temp_handle)) < 0) {
185 sr_err("Failed to close device: %s.",
191 * Scan all alsa devices, and translate them to sigrok devices.
193 * Each alsa device (not alsa card) gets its own sigrok device.
196 * hw:1,0 == sigrok device 0
197 * hw:1,1 == sigrok device 1
198 * hw:2,0 == sigrok device 2
199 * hw:2,1 == sigrok device 3
200 * hw:2,2 == sigrok device 4
203 * We don't currently look at alsa subdevices. We only use subdevice 0.
204 * Every input device will have its own channels (left, right, etc). Each of
205 * those channels gets mapped to a different sigrok probe. A device with 4
206 * channels will have 4 probes from sigrok's perspective.
208 SR_PRIV GSList *alsa_scan(GSList *options, struct sr_dev_driver *di)
210 GSList *devices = NULL;
213 snd_ctl_card_info_t *info;
214 snd_pcm_info_t *pcminfo;
215 const char *cardname;
216 char hwcard[32], hwdev[32];
221 if ((ret = snd_ctl_card_info_malloc(&info)) < 0) {
222 sr_dbg("Failed to malloc card info: %s.", snd_strerror(ret));
225 if ((ret = snd_pcm_info_malloc(&pcminfo) < 0)) {
226 sr_dbg("Cannot malloc pcm info: %s.", snd_strerror(ret));
231 while (snd_card_next(&card) >= 0 && card >= 0) {
232 snprintf(hwcard, sizeof(hwcard), "hw:%d", card);
233 if ((ret = snd_ctl_open(&handle, hwcard, 0)) < 0) {
234 sr_dbg("Cannot open (%d): %s.", card, snd_strerror(ret));
237 if ((ret = snd_ctl_card_info(handle, info)) < 0) {
238 sr_dbg("Cannot get hardware info (%d): %s.",
239 card, snd_strerror(ret));
240 if ((ret = snd_ctl_close(handle)) < 0) {
241 sr_dbg("Cannot close device (%d): %s.",
242 card, snd_strerror(ret));
247 while (snd_ctl_pcm_next_device(handle, &dev) >= 0 && dev >= 0) {
248 snprintf(hwdev, sizeof(hwdev), "%s,%d", hwcard, dev);
250 * TODO: We always use subdevice 0, but we have yet to
251 * explore the possibilities opened up by other
252 * subdevices. Most hardware only has subdevice 0.
254 snd_pcm_info_set_device(pcminfo, dev);
255 snd_pcm_info_set_subdevice(pcminfo, 0);
256 snd_pcm_info_set_stream(pcminfo,
257 SND_PCM_STREAM_CAPTURE);
258 if ((ret = snd_ctl_pcm_info(handle, pcminfo)) < 0) {
259 sr_dbg("Cannot get device info (%s): %s.",
260 hwdev, snd_strerror(ret));
264 cardname = snd_ctl_card_info_get_name(info);
265 sr_info("card %d: %s [%s], device %d: %s [%s]",
266 card, snd_ctl_card_info_get_id(info), cardname,
267 dev, snd_pcm_info_get_id(pcminfo),
268 snd_pcm_info_get_name(pcminfo));
270 alsa_scan_handle_dev(&devices, cardname, hwdev,
273 if ((ret = snd_ctl_close(handle)) < 0) {
274 sr_dbg("Cannot close device (%d): %s.",
275 card, snd_strerror(ret));
279 snd_pcm_info_free(pcminfo);
280 snd_ctl_card_info_free(info);
286 * Helper to be used with g_slist_free_full(); for properly freeing an alsa
289 SR_PRIV void alsa_dev_inst_clear(struct sr_dev_inst *sdi)
291 struct dev_context *devc;
293 if (!(devc = sdi->priv))
296 snd_pcm_hw_params_free(devc->hw_params);
297 g_free((void*)devc->supp_rates.list);
298 sr_dev_inst_free(sdi);
302 * Set the samplerate of the ALSA device.
304 * Changes the samplerate of the given ALSA device if the specified samplerate
305 * is supported by the hardware.
307 * The new samplerate is recorded, but it is not applied to the hardware. The
308 * samplerate is applied to the hardware only when acquisition is started via
309 * dev_acquisition_start(), and cannot be changed during acquisition. To change
310 * the samplerate, several steps are needed:
312 * 1) If acquisition is running, it must first be stopped.
313 * 2) dev_config_set() must be called with the new samplerate.
314 * 3) When starting a new acquisition, the new samplerate is applied.
317 SR_PRIV int alsa_set_samplerate(const struct sr_dev_inst *sdi,
320 struct dev_context *devc;
324 if (!(devc = sdi->priv))
329 if (newrate == devc->supp_rates.list[i]) {
333 } while (devc->supp_rates.list[i++] != 0);
336 sr_err("Sample rate %" PRIu64 " not supported.", newrate);
340 devc->cur_samplerate = rate;
344 SR_PRIV int alsa_receive_data(int fd, int revents, void *cb_data)
346 struct sr_dev_inst *sdi;
347 struct dev_context *devc;
348 struct sr_datafeed_packet packet;
349 struct sr_datafeed_analog analog;
351 int i, x, count, offset, samples_to_get;
353 const float s16norm = 1 / (float)(1 << 15);
361 memset(&analog, 0, sizeof(struct sr_datafeed_analog));
362 memset(inbuf, 0, sizeof(inbuf));
364 samples_to_get = MIN(4096 / 4, devc->limit_samples);
366 sr_spew("Getting %d samples from audio device.", samples_to_get);
367 count = snd_pcm_readi(devc->capture_handle, inbuf, samples_to_get);
370 sr_err("Failed to read samples: %s.", snd_strerror(count));
372 } else if (count != samples_to_get) {
373 sr_spew("Only got %d/%d samples.", count, samples_to_get);
376 analog.data = g_try_malloc0(count * sizeof(float) * devc->num_probes);
378 sr_err("Failed to malloc sample buffer.");
384 * It's impossible to know what voltage levels the soundcard handles.
385 * Some handle 0 dBV rms, some 0dBV peak-to-peak, +4dbmW (600 ohm), etc
386 * Each of these corresponds to a different voltage, and there is no
387 * mechanism to determine this voltage. The best solution is to send all
388 * audio data as a normalized float, and let the frontend or user worry
389 * about the calibration.
391 for (i = 0; i < count; i += devc->num_probes) {
392 for (x = 0; x < devc->num_probes; x++) {
393 tmp16 = inbuf[i + x];
394 analog.data[offset++] = tmp16 * s16norm;
398 /* Send a sample packet with the analog values. */
399 analog.probes = sdi->probes;
400 analog.num_samples = count;
401 analog.mq = SR_MQ_VOLTAGE; /* FIXME */
402 analog.unit = SR_UNIT_VOLT; /* FIXME */
403 packet.type = SR_DF_ANALOG;
404 packet.payload = &analog;
405 sr_session_send(devc->cb_data, &packet);
409 devc->num_samples += count;
411 /* Stop acquisition if we acquired enough samples. */
412 if (devc->limit_samples && devc->num_samples >= devc->limit_samples) {
413 sr_info("Requested number of samples reached.");
414 sdi->driver->dev_acquisition_stop(sdi, cb_data);