Add dual-license information.
[bertos.git] / drv / buzzerled.c
1 /*!
2  * \file
3  * <!--
4  * Copyright 2004 Develer S.r.l. (http://www.develer.com/)
5  * Copyright 2004 Giovanni Bajo
6  * This file is part of DevLib - See devlib/README for information.
7  * -->
8  *
9  * \brief Generic library to handle buzzers and leds
10  *
11  * This library is divided into three different layers:
12  *
13  *  - The topmost portable layer is buzzerled.[ch] which exposes a common API
14  *    enable/disable the devices. Basically, it handles the asynchronism to
15  *    implement bld_beep and bld_repeat.
16  *  - The middle layer is CPU-specific and exposes a single main function which
17  *    turns on/off each device.
18  *  - The lower layer is board-specific and communicates with the middle layer
19  *    with any required API. The idea is that devices can be tied to the CPU in
20  *    many different ways (many different pins), so this part should describe
21  *    which devices are present, and how they are connected.
22  *
23  * \version $Id$
24  *
25  * \author Giovanni Bajo <rasky@develer.com>
26  */
27
28 /*
29  * $Log$
30  * Revision 1.2  2004/06/03 11:27:09  bernie
31  * Add dual-license information.
32  *
33  * Revision 1.1  2004/05/23 18:36:05  bernie
34  * Import buzzerled driver.
35  *
36  */
37
38 #include "buzzerled.h"
39 #include "timer.h"
40
41 #if defined(__m56800__)
42         #include "buzzerled_dsp56k.h"
43 #else
44         #error Unsupported architecture
45 #endif
46
47 static struct Timer timers[NUM_BLDS];
48 static bool timer_go[NUM_BLDS];
49
50 INLINE enum BLD_DEVICE hook_parm_to_device(void* parm)
51 {
52         struct Timer* t = (struct Timer*)parm;
53         int num_bld = t - &timers[0];
54
55         ASSERT(num_bld >= 0);
56         ASSERT(num_bld < NUM_BLDS);
57
58         return (enum BLD_DEVICE)num_bld;
59 }
60
61 static void hook_turn_off(void* parm)
62 {
63         enum BLD_DEVICE num_bld = hook_parm_to_device(parm);
64         bld_set(num_bld, false);
65 }
66
67 void bld_init(void)
68 {
69         bld_hw_init();
70 }
71
72 void bld_set(enum BLD_DEVICE device, bool enable)
73 {
74         bld_hw_set(device, enable);
75 }
76
77 void bld_beep(enum BLD_DEVICE device, uint16_t duration)
78 {
79         struct Timer* t = &timers[device];
80         timer_set_delay(t, duration);
81         timer_set_event_softint(t, hook_turn_off, t);
82         timer_add(t);
83
84         bld_set(device, true);
85 }
86
87 void bld_beep_and_wait(enum BLD_DEVICE device, uint16_t duration)
88 {
89         bld_set(device, true);
90         timer_delay(duration);
91         bld_set(device, false);
92 }
93