/* $NetBSD: wsbell.c,v 1.14 2022/03/31 19:30:17 pgoyette Exp $ */

/*-
* Copyright (c) 2017 Nathanial Sloss <[email protected]>
* All rights reserved.
*
* Copyright (c) 2006 The NetBSD Foundation, Inc.
* All rights reserved.
*
* This code is derived from software contributed to The NetBSD Foundation
* by Julio M. Merino Vidal.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
*    notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
*    notice, this list of conditions and the following disclaimer in the
*    documentation and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
* ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
* TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
* PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
* BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGE.
*/

/*
* Copyright (c) 1996, 1997 Christopher G. Demetriou.  All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
*    notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
*    notice, this list of conditions and the following disclaimer in the
*    documentation and/or other materials provided with the distribution.
* 3. All advertising materials mentioning features or use of this software
*    must display the following acknowledgement:
*      This product includes software developed by Christopher G. Demetriou
*      for the NetBSD Project.
* 4. The name of the author may not be used to endorse or promote products
*    derived from this software without specific prior written permission
*
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
* IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
* IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
* NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
* THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*/

/*
* Copyright (c) 1992, 1993
*      The Regents of the University of California.  All rights reserved.
*
* This software was developed by the Computer Systems Engineering group
* at Lawrence Berkeley Laboratory under DARPA contract BG 91-66 and
* contributed to Berkeley.
*
* All advertising materials mentioning features or use of this software
* must display the following acknowledgement:
*      This product includes software developed by the University of
*      California, Lawrence Berkeley Laboratory.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
*    notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
*    notice, this list of conditions and the following disclaimer in the
*    documentation and/or other materials provided with the distribution.
* 3. Neither the name of the University nor the names of its contributors
*    may be used to endorse or promote products derived from this software
*    without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
* ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
* SUCH DAMAGE.
*
*      @(#)ms.c        8.1 (Berkeley) 6/11/93
*/

/*
* Keyboard Bell driver.
*/

#include <sys/cdefs.h>
__KERNEL_RCSID(0, "$NetBSD: wsbell.c,v 1.14 2022/03/31 19:30:17 pgoyette Exp $");

#if defined(_KERNEL_OPT)
#include "wsmux.h"
#endif

#include <sys/param.h>
#include <sys/conf.h>
#include <sys/ioctl.h>
#include <sys/poll.h>
#include <sys/fcntl.h>
#include <sys/kernel.h>
#include <sys/condvar.h>
#include <sys/mutex.h>
#include <sys/kauth.h>
#include <sys/kthread.h>
#include <sys/proc.h>
#include <sys/syslog.h>
#include <sys/systm.h>
#include <sys/tty.h>
#include <sys/signalvar.h>
#include <sys/device.h>
#include <sys/vnode.h>
#include <sys/callout.h>
#include <sys/module.h>

#include <dev/wscons/wsconsio.h>
#include <dev/wscons/wsbellvar.h>
#include <dev/wscons/wsbellmuxvar.h>
#include <dev/wscons/wsbelldata.h>

#include <dev/spkrio.h>

#include "ioconf.h"

#if defined(WSMUX_DEBUG) && NWSMUX > 0
#define DPRINTF(x)      if (wsmuxdebug) printf x
#define DPRINTFN(n,x)   if (wsmuxdebug > (n)) printf x
extern int wsmuxdebug;
#else
#define DPRINTF(x)
#define DPRINTFN(n,x)
#endif

static void bell_thread(void *);
static inline void spkr_audio_play(struct wsbell_softc *, u_int, u_int, u_int);

static int  wsbell_match(device_t, cfdata_t, void *);
static void wsbell_attach(device_t, device_t, void *);
static int  wsbell_detach(device_t, int);
static int  wsbell_activate(device_t, enum devact);

#if NWSMUX > 0
static int  wsbell_mux_open(struct wsevsrc *, struct wseventvar *);
static int  wsbell_mux_close(struct wsevsrc *);

static int  wsbelldoopen(struct wsbell_softc *, struct wseventvar *);
static int  wsbelldoioctl(device_t, u_long, void *, int, struct lwp *);

static int  wsbell_do_ioctl(struct wsbell_softc *, u_long, void *,
                            int, struct lwp *);

#endif

CFATTACH_DECL_NEW(wsbell, sizeof (struct wsbell_softc),
   wsbell_match, wsbell_attach, wsbell_detach, wsbell_activate);

extern dev_type_open(spkropen);
extern dev_type_close(spkrclose);
extern dev_type_ioctl(spkrioctl);

const struct cdevsw wsbell_cdevsw = {
       .d_open = noopen,
       .d_close = noclose,
       .d_read = noread,
       .d_write = nowrite,
       .d_ioctl = noioctl,
       .d_stop = nostop,
       .d_tty = notty,
       .d_poll = nopoll,
       .d_mmap = nommap,
       .d_kqfilter = nokqfilter,
       .d_discard = nodiscard,
       .d_flag = D_OTHER
};

#if NWSMUX > 0
struct wssrcops wsbell_srcops = {
       WSMUX_BELL,
       wsbell_mux_open, wsbell_mux_close, wsbelldoioctl, wsbelldoioctl, NULL
};
#endif

int
wsbell_match(device_t parent, cfdata_t match, void *aux)
{
       return (1);
}

void
wsbell_attach(device_t parent, device_t self, void *aux)
{
       struct wsbell_softc *sc = device_private(self);
       struct wsbelldev_attach_args *ap = aux;
#if NWSMUX > 0
       int mux, error;
#endif

       sc->sc_base.me_dv = self;
       sc->sc_accesscookie = ap->accesscookie;

       sc->sc_dying = false;
       sc->sc_spkr = device_unit(parent);
       sc->sc_bell_data = wskbd_default_bell_data;
#if NWSMUX > 0
       sc->sc_base.me_ops = &wsbell_srcops;
       mux = device_cfdata(self)->wsbelldevcf_mux;
       if (mux >= 0) {
               error = wsmux_attach_sc(wsmux_getmux(mux), &sc->sc_base);
               if (error)
                       aprint_error(" attach error=%d", error);
               else
                       aprint_normal(" mux %d", mux);
       }
#else
       if (device_cfdata(self)->wsbelldevcf_mux >= 0)
               aprint_normal(" (mux ignored)");
#endif

       aprint_naive("\n");
       aprint_normal("\n");

       if (!pmf_device_register(self, NULL, NULL))
               aprint_error_dev(self, "couldn't establish power handler\n");

       mutex_init(&sc->sc_bellock, MUTEX_DEFAULT, IPL_SCHED);
       cv_init(&sc->sc_bellcv, "bellcv");

       kthread_create(PRI_BIO, KTHREAD_MPSAFE | KTHREAD_MUSTJOIN, NULL,
           bell_thread, sc, &sc->sc_bellthread, "%s", device_xname(self));
}

int
wsbell_activate(device_t self, enum devact act)
{
       struct wsbell_softc *sc = device_private(self);

       if (act == DVACT_DEACTIVATE)
               sc->sc_dying = true;
       return (0);
}

int
wsbell_detach(device_t self, int flags)
{
       struct wsbell_softc *sc = device_private(self);
       struct wseventvar *evar;
       int maj, mn;
       int s;

#if NWSMUX > 0
       /* Tell parent mux we're leaving. */
       if (sc->sc_base.me_parent != NULL) {
               DPRINTF(("wsbell_detach:\n"));
               wsmux_detach_sc(&sc->sc_base);
       }
#endif

       /* If we're open ... */
       evar = sc->sc_base.me_evp;
       if (evar != NULL && evar->io != NULL) {
               s = spltty();
               if (--sc->sc_refcnt >= 0) {
                       struct wscons_event event;

                       /* Wake everyone by generating a dummy event. */
                       event.type = 0;
                       event.value = 0;
                       if (wsevent_inject(evar, &event, 1) != 0)
                               wsevent_wakeup(evar);

                       /* Wait for processes to go away. */
                       if (tsleep(sc, PZERO, "wsmdet", hz * 60))
                               printf("wsbell_detach: %s didn't detach\n",
                                      device_xname(self));
               }
               splx(s);
       }

       /* locate the major number */
       maj = cdevsw_lookup_major(&wsbell_cdevsw);

       /* Nuke the vnodes for any open instances (calls close). */
       mn = device_unit(self);
       vdevgone(maj, mn, mn, VCHR);

       mutex_enter(&sc->sc_bellock);
       sc->sc_dying = true;

       cv_broadcast(&sc->sc_bellcv);
       mutex_exit(&sc->sc_bellock);

       kthread_join(sc->sc_bellthread);
       cv_destroy(&sc->sc_bellcv);
       mutex_destroy(&sc->sc_bellock);

       return (0);
}

#if NWSMUX > 0
int
wsbelldoopen(struct wsbell_softc *sc, struct wseventvar *evp)
{
       return (0);
}

/* A wrapper around the ioctl() workhorse to make reference counting easy. */
int
wsbelldoioctl(device_t dv, u_long cmd, void *data, int flag,
              struct lwp *l)
{
       struct wsbell_softc *sc = device_private(dv);
       int error;

       sc->sc_refcnt++;
       error = wsbell_do_ioctl(sc, cmd, data, flag, l);
       if (--sc->sc_refcnt < 0)
               wakeup(sc);
       return (error);
}

int
wsbell_do_ioctl(struct wsbell_softc *sc, u_long cmd, void *data,
                int flag, struct lwp *l)
{
       struct wskbd_bell_data *ubdp, *kbdp;
       int error;

       if (sc->sc_dying == true)
               return (EIO);

       /*
        * Try the wsbell specific ioctls.
        */
       switch (cmd) {
       case WSKBDIO_SETBELL:
               if ((flag & FWRITE) == 0)
                       return (EACCES);
               kbdp = &sc->sc_bell_data;
setbell:
               ubdp = (struct wskbd_bell_data *)data;
               SETBELL(kbdp, ubdp, kbdp);
               return (0);

       case WSKBDIO_GETBELL:
               kbdp = &sc->sc_bell_data;
getbell:
               ubdp = (struct wskbd_bell_data *)data;
               SETBELL(ubdp, kbdp, kbdp);
               return (0);

       case WSKBDIO_SETDEFAULTBELL:
               if ((error = kauth_authorize_device(l->l_cred,
                   KAUTH_DEVICE_WSCONS_KEYBOARD_BELL, NULL, NULL,
                   NULL, NULL)) != 0)
                       return (error);
               kbdp = &wskbd_default_bell_data;
               goto setbell;


       case WSKBDIO_GETDEFAULTBELL:
               kbdp = &wskbd_default_bell_data;
               goto getbell;

       case WSKBDIO_BELL:
               if ((flag & FWRITE) == 0)
                       return (EACCES);
               spkr_audio_play(sc, sc->sc_bell_data.pitch,
                   sc->sc_bell_data.period, sc->sc_bell_data.volume);

               return 0;

       case WSKBDIO_COMPLEXBELL:
               if ((flag & FWRITE) == 0)
                       return (EACCES);
               if (data == NULL)
                       return 0;
               ubdp = (struct wskbd_bell_data *)data;
               SETBELL(ubdp, ubdp, &sc->sc_bell_data);
               spkr_audio_play(sc, ubdp->pitch, ubdp->period, ubdp->volume);
               return 0;
       }

       return (EPASSTHROUGH);
}
#endif

static void
bell_thread(void *arg)
{
       struct wsbell_softc *sc = arg;
       struct vbell_args *vb = &sc->sc_bell_args;
       tone_t tone;
       u_int vol;

       for (;;) {
               mutex_enter(&sc->sc_bellock);
               cv_wait_sig(&sc->sc_bellcv, &sc->sc_bellock);

               if (sc->sc_dying == true) {
                       mutex_exit(&sc->sc_bellock);
                       kthread_exit(0);
               }

               tone.frequency = vb->pitch;
               /*
                * period (derived from wskbd) is in msec.
                * duration (derived from spkr) is in units of 10msec.
                */
               tone.duration = vb->period / 10;
               vol = vb->volume;
               mutex_exit(&sc->sc_bellock);

               if (spkropen(sc->sc_spkr, FWRITE, 0, NULL) != 0)
                       continue;
               spkrioctl(sc->sc_spkr, SPKRSETVOL, &vol, 0, curlwp);
               spkrioctl(sc->sc_spkr, SPKRTONE, &tone, 0, curlwp);
               spkrclose(sc->sc_spkr, FWRITE, 0, curlwp);
       }
}

static inline void
spkr_audio_play(struct wsbell_softc *sc, u_int pitch, u_int period, u_int volume)
{

       mutex_enter(&sc->sc_bellock);
       sc->sc_bell_args.pitch = pitch;
       sc->sc_bell_args.period = period;
       sc->sc_bell_args.volume = volume;

       cv_broadcast(&sc->sc_bellcv);
       mutex_exit(&sc->sc_bellock);
}

#if NWSMUX > 0
int
wsbell_mux_open(struct wsevsrc *me, struct wseventvar *evp)
{
       struct wsbell_softc *sc = (struct wsbell_softc *)me;

       if (sc->sc_base.me_evp != NULL)
               return (EBUSY);

       return wsbelldoopen(sc, evp);
}

int
wsbell_mux_close(struct wsevsrc *me)
{
       struct wsbell_softc *sc = (struct wsbell_softc *)me;

       sc->sc_base.me_evp = NULL;

       return (0);
}
#endif /* NWSMUX > 0 */

MODULE(MODULE_CLASS_DRIVER, wsbell, "spkr");

#ifdef _MODULE
int wsbell_bmajor = -1, wsbell_cmajor = -1;

#include "ioconf.c"
#endif

static int
wsbell_modcmd(modcmd_t cmd, void *arg)
{
       int error = 0;

       switch (cmd) {
       case MODULE_CMD_INIT:
#ifdef _MODULE
               error = devsw_attach("wsbell", NULL, &wsbell_bmajor,
                   &wsbell_cdevsw, &wsbell_cmajor);
               if (error)
                       break;

               error = config_init_component(cfdriver_ioconf_wsbell,
                   cfattach_ioconf_wsbell, cfdata_ioconf_wsbell);
               if (error)
                       devsw_detach(NULL, &wsbell_cdevsw);
#endif
               break;

       case MODULE_CMD_FINI:
#ifdef _MODULE
               error = config_fini_component(cfdriver_ioconf_wsbell,
                   cfattach_ioconf_wsbell, cfdata_ioconf_wsbell);
               if (error == 0)
                       devsw_detach(NULL, &wsbell_cdevsw);
#endif
               break;

       default:
               error = ENOTTY;
               break;
       }

       return error;
}