/*===========================================
*《Linux声音设备编程实例》
* 1. 对内部扬声器编程
*  内部扬声器是控制台的一部分,所以它对应的设备文件为/dev/console。
*    变量KIOCSOUND在头文件 /usr /include /linux /kd.h中声明,
*    ioctl函数使用它可以来控制扬声器的发声,使用规则为:
*      ioctl ( fd, KIOCSOUND, (int) tone);
*      fd为文件设备号,tone 是音频值。当tone为0时,终止发声。
*    必须一提的是它所理解的音频和我们平常以为的音频是不同的,
*    由于计算机主板定时器的时钟频率为1.19MHZ,所以要进行正确的发声,
*    必须进行如下的转换:
*  扬声器音频值=1190000/我们期望的音频值。
*  扬声器发声时间的长短我们通过函数usleep(unsigned long usec)来控制。
*    它是在头文件/usr /include /unistd.h中定义的,让程序睡眠usec微秒。
*    下面即是让扬声器按指定的长度和音频发声的程序的完整清单:
*========================================================*/
 
#include <fcntl.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <unistd.h>
#include <sys/ioctl.h>
#include <sys/types.h>
#include <linux/kd.h>
 
/* 设定默认值 */
#define DEFAULT_FREQ 440   /* 设定一个合适的频率 */
#define DEFAULT_LENGTH 200 /* 200 微秒,发声的长度是以微秒为单位的*/
#define DEFAULT_REPS 1     /* 默认不重复发声 */
#define DEFAULT_DELAY 100  /* 同样以微秒为单位*/
 
/* 定义一个结构,存储所需的数据*/
typedef struct {
 
    int freq;   /* 我们期望输出的频率,单位为Hz */
    int length; /* 发声长度,以微秒为单位*/
    int reps;   /* 重复的次数*/
    int delay;  /* 两次发声间隔,以微秒为单位*/
 
} beep_parms_t;
 
 
/* 打印帮助信息并退出*/
void usage_bail ( const char *executable_name ) {
 
    printf ( "Usage: \n \t%s [-f frequency] [-l length] [-r reps] [-d delay] \n ",
    executable_name );
    exit(1);
 
}
 
/*===================================
* 分析运行参数,各项意义如下:
* "-f <以HZ为单位的频率值 >"
* "-l <以毫秒为单位的发声时长 >"
* "-r <重复次数 >"
* "-d <以毫秒为单位的间歇时长 >"
* =====================================*/
void parse_command_line(char **argv, beep_parms_t *result) {
 
    char *arg0 = *(argv++);
    while ( *argv ) {
 
        if ( !strcmp( *argv,"-f" )) {
 /*频率*/
            int freq = atoi ( *( ++argv ) );
            if ( ( freq <= 0 ) || ( freq > 10000 ) ) {
 
                fprintf ( stderr, "Bad parameter: frequency must be from 1..10000\n" );
                exit (1) ;
             
} else {
 
                result->freq = freq;
                argv++;
             
}
         
} else if ( ! strcmp ( *argv, "-l" ) ) {
 /*时长*/
            int length = atoi ( *(++argv ) );
            if (length < 0) {
 
                fprintf(stderr, "Bad parameter: length must be >= 0\n");
                exit(1);
             
} else {
 
                result->length = length;
                argv++;
             
}
         
} else if (!strcmp(*argv, "-r")) {
 /*重复次数*/
            int reps = atoi(*(++argv));
            if (reps < 0) {
 
                fprintf(stderr, "Bad parameter: reps must be >= 0\n");
                exit(1);
             
} else {
 
                result->reps = reps;
                argv++;
             
}
         
} else if (!strcmp(*argv, "-d")) {
 /* 延时 */
            int delay = atoi(*(++argv));
            if (delay < 0) {
 
                fprintf(stderr, "Bad parameter: delay must be >= 0\n");
                exit(1);
             
} else {
 
                result->delay = delay;
                argv++;
             
}
         
} else {
 
            fprintf(stderr, "Bad parameter: %s\n", *argv);
            usage_bail(arg0);
         
}
     
}
 
}
 
int main(int argc, char **argv) {
 
    int console_fd;
    int i; /* 循环计数器 */
    /* 设发声参数为默认值*/
    beep_parms_t parms = {
DEFAULT_FREQ, DEFAULT_LENGTH, DEFAULT_REPS,
    DEFAULT_DELAY
};
    /* 分析参数,可能的话更新发声参数*/
    parse_command_line(argv, &parms);
 
    /* 打开控制台,失败则结束程序*/
    if ( ( console_fd = open ( "/dev/console", O_WRONLY ) ) == -1 ) {
 
        fprintf(stderr, "Failed to open console.\n");
        perror("open");
        exit(1);
     
}
 
    /* 真正开始让扬声器发声*/
    for (i = 0; i < parms.reps; i++) {
 
        /* 数字1190000从何而来,不得而知*/
        int magical_fairy_number = 1190000/parms.freq;
 
        ioctl(console_fd, KIOCSOUND, magical_fairy_number); /* 开始发声 */
        usleep(1000*parms.length);       /*等待... */
        ioctl(console_fd, KIOCSOUND, 0); /* 停止发声*/
        usleep(1000*parms.delay);        /* 等待... */
     
} /* 重复播放*/
    return EXIT_SUCCESS;
 
}