|Top Previous Next|
The beep object allows you to generate "beep" patters using the beeper (buzzer) attached to the CO pin of your device. "CO" stands for "clock output" and its output can be actually used for anything, not just controlling beeper. Frequency available on the CO pin is defined by the beep.divider property.
When the pattern starts playing, the CO line becomes an output automatically. Therefore, you do not need to use the io.enabled property to configure this line as output. When the pattern stops playing, the line will return to the input/output and HIGH/LOW state that it had before the pattern started playing.
The pattern you play can be up to 16 steps long. Each "step" can be either "-" (buzzer off), or "B" (buzzer on). You can also define whether the pattern will only execute one or loop and play indefinitely. Additionally, you can make the pattern play at "normal" or double speed.
You load the new pattern to play with the beep.play method. If the pattern is looped it will continue playing until you changed it. If the pattern is not looped it will play once and then the on_beep event will be generated.
Buzzer patters offer a convenient way to tell the user what your system is doing. You can devise different patterns for different states of your device. You can use these patterns together with LED patterns generated by the pat object.
Here is a simple example in which we generate three beeps on power up of the device.
To obtain a permanent, non-stop square wave on CO pin load the following pattern: