X-Git-Url: https://codewiz.org/gitweb?a=blobdiff_plain;f=drv%2Fbuzzerled.h;h=14fab03088d18074dd92a48da10d19266c814096;hb=33d48af0258dd55e1d2b51a4ae2f87401dcb00e9;hp=dd3d8697b9bbd7fb9bf1d154a7f810e704f2f953;hpb=96f0ef786b54356c56cc3d4e4f0838df2505cfcc;p=bertos.git diff --git a/drv/buzzerled.h b/drv/buzzerled.h old mode 100755 new mode 100644 index dd3d8697..14fab030 --- a/drv/buzzerled.h +++ b/drv/buzzerled.h @@ -1,9 +1,34 @@ -/*! +/** * \file * * * \brief Generic library to handle buzzers and leds @@ -13,39 +38,41 @@ * \author Giovanni Bajo */ -/* - * $Log$ - * Revision 1.2 2004/06/03 11:27:09 bernie - * Add dual-license information. - * - * Revision 1.1 2004/05/23 18:36:05 bernie - * Import buzzerled driver. - * - */ - #ifndef DRV_BUZZERLED_H #define DRV_BUZZERLED_H -/*! Include hw.h. We expect hw.h to define enum BLD_DEVICE, which must contain +#include + +/** Include hw.h. We expect hw.h to define enum BLD_DEVICE, which must contain * an enumarator for each device, plus a special symbol NUM_BLDS containing the * number of devices. */ #include -/*! Initialize the buzzerled library. + +/* Include hw-level implementation. This allows inlining of bld_set, which in turns + * should allow fast constant propagation for the common case (where the parameter + * device is a constant). + */ +#include CPU_HEADER(buzzerled) + + +/** Initialize the buzzerled library. * * \note This function must be called before any other function in the library. */ void bld_init(void); -/*! Set or reset a device. + +/** Set or reset a device. * * \param device Device to be set * \param enable Enable/disable status */ -void bld_set(enum BLD_DEVICE device, bool enable); +#define bld_set(device, enable) bld_hw_set(device, enable) + -/*! Enable a device for a certain interval of time +/** Enable a device for a certain interval of time * * \param device Device to be enabled * \param duration Number of milliseconds the device must be enabled @@ -55,7 +82,7 @@ void bld_set(enum BLD_DEVICE device, bool enable); void bld_beep(enum BLD_DEVICE device, uint16_t duration); -/*! Enable a device for a certain interval of time and wait. +/** Enable a device for a certain interval of time and wait. * * \param device Device to be enabled * \param duration Number of milliseconds the device must be enabled