/*                                                                   
 * mixer.c  
 * 對各種混音通道的增益進行調節，其所有的功能都通過讀寫/dev/mixer設備文件來完成                                                         
 */                                                                  
#include <unistd.h>                                                  
#include <stdlib.h>                                                  
#include <stdio.h>                                                   
#include <sys/ioctl.h>                                               
#include <fcntl.h>                                                   
#include <linux/soundcard.h>                                         
/* 用來存儲所有可用混音設備的名稱 */                                 
const char *sound_device_names[] = SOUND_DEVICE_NAMES;               
int fd;                  /* 混音設備所對應的文件描述符 */            
int devmask, stereodevs; /* 混音器信息對應的位圖掩碼 */              
char *name;                                                          
/* 顯示命令的使用方法及所有可用的混音設備 */                         
void usage()                                                         
{                                                                    
  int i;                                                             
  fprintf(stderr, "usage: %s <device> <left-gain%%> <right-gain%%>\n"
	  "       %s <device> <gain%%>\n\n"                                
	  "Where <device> is one of:\n", name, name);                      
  for (i = 0 ; i < SOUND_MIXER_NRDEVICES ; i++)                      
    if ((1 << i) & devmask) /* 只顯示有效的混音設備 */               
      fprintf(stderr, "%s ", sound_device_names[i]);                 
  fprintf(stderr, "\n");                                             
  exit(1);                                                           
}                                                                    
int main(int argc, char *argv[])                                     
{                                                                    
  int left, right, level;  /* 增益設置 */                            
  int status;              /* 系統調用的返回值 */                    
  int device;              /* 選用的混音設備 */                      
  char *dev;               /* 混音設備的名稱 */                      
  int i;                                                             
  name = argv[0];                                                    
  /* 以只讀方式打開混音設備 */                                       
  fd = open("/dev/mixer", O_RDONLY);                                 
  if (fd == -1) {                                                    
    perror("unable to open /dev/mixer");                             
    exit(1);                                                         
  }                                                                  
                                                                     
  /* 獲得所需要的信息 */                                             
  status = ioctl(fd, SOUND_MIXER_READ_DEVMASK, &devmask);            
  if (status == -1)                                                  
    perror("SOUND_MIXER_READ_DEVMASK ioctl failed");                 
  status = ioctl(fd, SOUND_MIXER_READ_STEREODEVS, &stereodevs);      
  if (status == -1)                                                  
    perror("SOUND_MIXER_READ_STEREODEVS ioctl failed");              
  /* 檢查用戶輸入 */                                                 
  if (argc != 3 && argc != 4)                                        
    usage();                                                         
  /* 保存用戶輸入的混音器名稱 */                                     
  dev = argv[1];                                                     
  /* 確定即將用到的混音設備 */                                       
  for (i = 0 ; i < SOUND_MIXER_NRDEVICES ; i++)                      
    if (((1 << i) & devmask) && !strcmp(dev, sound_device_names[i])) 
      break;                                                         
  if (i == SOUND_MIXER_NRDEVICES) { /* 沒有找到匹配項 */             
    fprintf(stderr, "%s is not a valid mixer device\n", dev);        
    usage();                                                         
  }                                                                  
  /* 查找到有效的混音設備 */                                         
  device = i;                                                        
  /* 獲取增益值 */                                                   
  if (argc == 4) {                                                   
    /* 左、右聲道均給定 */                                           
    left  = atoi(argv[2]);                                           
    right = atoi(argv[3]);                                           
  } else {                                                           
    /* 左、右聲道設為相等 */                                         
    left  = atoi(argv[2]);                                           
    right = atoi(argv[2]);                                           
  }                                                                  
                                                                     
  /* 對非立體聲設備給出警告信息 */                                   
  if ((left != right) && !((1 << i) & stereodevs)) {                 
    fprintf(stderr, "warning: %s is not a stereo device\n", dev);    
  }                                                                  
                                                                     
  /* 將兩個聲道的值合到同一變量中 */                                 
  level = (right << 8) + left;                                       
                                                                     
  /* 設置增益 */                                                     
  status = ioctl(fd, MIXER_WRITE(device), &level);                   
  if (status == -1) {                                                
    perror("MIXER_WRITE ioctl failed");                              
    exit(1);                                                         
  }                                                                  
  /* 獲得從驅動返回的左右聲道的增益 */                               
  left  = level & 0xff;                                              
  right = (level & 0xff00) >> 8;                                     
  /* 顯示實際設置的增益 */                                           
  fprintf(stderr, "%s gain set to %d%% / %d%%\n", dev, left, right); 
  /* 關閉混音設備 */                                                 
  close(fd);                                                         
  return 0;                                                          
}