/*
 * CDDL HEADER START
 *
 * The contents of this file are subject to the terms of the
 * Common Development and Distribution License (the "License").
 * You may not use this file except in compliance with the License.
 *
 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
 * or http://www.opensolaris.org/os/licensing.
 * See the License for the specific language governing permissions
 * and limitations under the License.
 *
 * When distributing Covered Code, include this CDDL HEADER in each
 * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
 * If applicable, add the following below this CDDL HEADER, with the
 * fields enclosed by brackets "[]" replaced with your own identifying
 * information: Portions Copyright [yyyy] [name of copyright owner]
 *
 * CDDL HEADER END
 */
/*
 * Copyright 2007 Sun Microsystems, Inc.  All rights reserved.
 * Use is subject to license terms.
 */

#ifndef _SYS_BEEP_H
#define _SYS_BEEP_H

#include <sys/mutex.h>

/*
 * Interface to the system beeper.
 *
 * (This is the API, not the hardware interface.)
 */

#ifdef __cplusplus
extern "C" {
#endif

#if     defined(_KERNEL)

/* beep_entry structure */

typedef struct beep_entry {
        unsigned short  frequency;
        unsigned short  duration;
} beep_entry_t;

typedef void (*beep_on_func_t)(void *arg);

typedef void (*beep_off_func_t)(void *arg);

typedef void (*beep_freq_func_t)(void *arg, int freq);

/* beep_state structure */

typedef struct beep_state {

        /* Private data for beep_freq, beep_on, and beep_off functions */
        void            *arg;

        /* Indicates if a beep command is already in progress */
        enum            {BEEP_UNINIT = 0, BEEP_OFF = 1,
                            BEEP_TIMED = 2, BEEP_ON = 3} mode;

        /* Address of the hw-dependent beep_freq function */
        beep_freq_func_t beep_freq;

        /* Address of the hw-dependent beep_on function */
        beep_on_func_t  beep_on;

        /* Address of the hw-dependent beep_off function */
        beep_off_func_t beep_off;

        /* Timeout id for the beep_timeout() function */
        timeout_id_t    timeout_id;

        /* Mutex protecting mode, timeout_id, queue_head, queue_tail, */
        /* and queue */
        kmutex_t        mutex;

        /* Index of head of queue */
        int             queue_head;

        /* Index of tail of queue */
        int             queue_tail;

        /* Max queue size */
        int             queue_size;

        /* Circular ring buffer */
        beep_entry_t    *queue;
} beep_state_t;

#define BEEP_QUEUE_SIZE 1000

/* BEEP_DEFAULT is a sentinel for the beep_param table. */
enum beep_type { BEEP_DEFAULT = 0, BEEP_CONSOLE = 1, BEEP_TYPE4 = 2 };

typedef struct beep_params {
        enum beep_type  type;
        int             frequency;      /* Hz */
        int             duration;       /* milliseconds */
} beep_params_t;


extern int beep_init(void *arg,
    beep_on_func_t beep_on_func,
    beep_off_func_t beep_off_func,
    beep_freq_func_t beep_freq_func);

extern int beep_fini(void);

extern int beeper_off(void);

extern int beeper_freq(enum beep_type type, int freq);

extern int beep(enum beep_type type);

extern int beep_polled(enum beep_type type);

extern int beeper_on(enum beep_type type);

extern int beep_mktone(int frequency, int duration);

extern void beep_timeout(void *arg);

extern int beep_busy(void);

#endif  /* _KERNEL */

#ifdef __cplusplus
}
#endif

#endif /* _SYS_BEEP_H */