3e8841c49dfc7c57b1a95954df55dc32fba84366
[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 README.devlib 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.6  2005/11/04 16:20:02  bernie
31  *#* Fix reference to README.devlib in header.
32  *#*
33  *#* Revision 1.5  2004/12/08 09:43:41  bernie
34  *#* Add a todo item.
35  *#*
36  *#* Revision 1.4  2004/08/25 14:12:08  rasky
37  *#* Aggiornato il comment block dei log RCS
38  *#*
39  *#* Revision 1.3  2004/07/14 14:04:29  rasky
40  *#* Merge da SC: spostata bld_set inline perché si ottimizza parecchio tramite propagazione di costanti
41  *#*
42  *#* Revision 1.2  2004/06/03 11:27:09  bernie
43  *#* Add dual-license information.
44  *#*
45  *#* Revision 1.1  2004/05/23 18:36:05  bernie
46  *#* Import buzzerled driver.
47  *#*
48  *#*/
49
50 #include "buzzerled.h"
51 #include "timer.h"
52
53 static struct Timer timers[NUM_BLDS];
54 static bool timer_go[NUM_BLDS];
55
56 INLINE enum BLD_DEVICE hook_parm_to_device(void* parm)
57 {
58         struct Timer* t = (struct Timer*)parm;
59         int num_bld = t - &timers[0];
60
61         ASSERT(num_bld >= 0);
62         ASSERT(num_bld < NUM_BLDS);
63
64         return (enum BLD_DEVICE)num_bld;
65 }
66
67 static void hook_turn_off(void* parm)
68 {
69         enum BLD_DEVICE num_bld = hook_parm_to_device(parm);
70         bld_set(num_bld, false);
71 }
72
73 void bld_init(void)
74 {
75         bld_hw_init();
76 }
77
78 void bld_beep(enum BLD_DEVICE device, uint16_t duration)
79 {
80         // \todo This is not reentrant for the same device. FIXME!
81         struct Timer *t = &timers[device];
82         timer_set_delay(t, duration);
83         timer_set_event_softint(t, hook_turn_off, t);
84         timer_add(t);
85
86         bld_set(device, true);
87 }
88
89 void bld_beep_and_wait(enum BLD_DEVICE device, uint16_t duration)
90 {
91         bld_set(device, true);
92         timer_delay(duration);
93         bld_set(device, false);
94 }
95