/** * \file control/cards.c * \author Jaroslav Kysela * \date 1998-2001 */ /* * Control Interface - main file * Copyright (c) 1998 by Jaroslav Kysela * * * This library is free software; you can redistribute it and/or modify * it under the terms of the GNU Library General Public License as * published by the Free Software Foundation; either version 2 of * the License, or (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU Library General Public License for more details. * * You should have received a copy of the GNU Library General Public * License along with this library; if not, write to the Free Software * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. * */ #include #include #include #include #include #include #include #include "control_local.h" #ifndef DOC_HIDDEN #define SND_FILE_CONTROL "/dev/snd/controlC%i" #define SND_FILE_LOAD "/dev/aloadC%i" #endif /** * \brief Try to load the driver for a card. * \param card Card number. * \return 1 if driver is present, zero if driver is not present */ int snd_card_load(int card) { int open_dev; char control[32]; sprintf(control, SND_FILE_CONTROL, card); if ((open_dev=open(control, O_RDONLY)) < 0) { char aload[32]; sprintf(aload, SND_FILE_LOAD, card); open_dev = open(aload, O_RDONLY); } if (open_dev >= 0) { close (open_dev); return 0; } return open_dev ? 1 : 0; } /** * \brief Try to determine the next card. * \param rcard pointer to card number * \result zero if success, otherwise a negative error code * * Tries to determine the next card from given card number. * If card number is -1, then the first available card is * returned. If the result card number is -1, no more cards * are available. */ int snd_card_next(int *rcard) { int card; if (rcard == NULL) return -EINVAL; card = *rcard; card = card < 0 ? 0 : card + 1; for (; card < 32; card++) { if (!snd_card_load(card)) { *rcard = card; return 0; } } *rcard = -1; return 0; } /** * \brief Convert card string to an integer value. * \param string String containing card identifier * \return zero if success, otherwise a negative error code * * The accepted format is an integer value in ASCII representation * or the card identifier (snd_id parameter for soundcard drivers). */ int snd_card_get_index(const char *string) { int card; snd_ctl_t *handle; snd_ctl_card_info_t info; if (!string || *string == '\0') return -EINVAL; if ((isdigit(*string) && *(string + 1) == 0) || (isdigit(*string) && isdigit(*(string + 1)) && *(string + 2) == 0)) { sscanf(string, "%i", &card); if (card < 0 || card > 31) return -EINVAL; if (snd_card_load(card) >= 0) return card; return -EINVAL; } for (card = 0; card < 32; card++) { if (snd_card_load(card) < 0) continue; if (snd_ctl_hw_open(&handle, NULL, card, 0) < 0) continue; if (snd_ctl_card_info(handle, &info) < 0) { snd_ctl_close(handle); continue; } snd_ctl_close(handle); if (!strcmp(info.id, string)) return card; } return -ENODEV; } /** * \brief Obtain the card name. * \param card Card number * \param name Result - card name corresponding to card number * \result zero if success, otherwise a negative error code */ int snd_card_get_name(int card, char **name) { snd_ctl_t *handle; snd_ctl_card_info_t info; int err; if (name == NULL) return -EINVAL; if ((err = snd_ctl_hw_open(&handle, NULL, card, 0)) < 0) return err; if ((err = snd_ctl_card_info(handle, &info)) < 0) { snd_ctl_close(handle); return err; } snd_ctl_close(handle); *name = strdup(info.name); if (*name == NULL) return -ENOMEM; return 0; } /** * \brief Obtain the card long name. * \param card Card number * \param name Result - card long name corresponding to card number * \result zero if success, otherwise a negative error code */ int snd_card_get_longname(int card, char **name) { snd_ctl_t *handle; snd_ctl_card_info_t info; int err; if (name == NULL) return -EINVAL; if ((err = snd_ctl_hw_open(&handle, NULL, card, 0)) < 0) return err; if ((err = snd_ctl_card_info(handle, &info)) < 0) { snd_ctl_close(handle); return err; } snd_ctl_close(handle); *name = strdup(info.longname); if (*name == NULL) return -ENOMEM; return 0; }