User manual

430
mikoC PRO for PIC32
MikroElektronika
Sound Library
The mikroC PRO for PIC32 provides a Sound Library to supply users with routines necessary for sound signalization
in their applications. Sound generation needs additional hardware, such as piezo-speaker (example of piezo-speaker
interface is given on the schematic at the bottom of this page).
Library Routines
- Sound_Init
- Sound_Play
Sound_Init
Sound_Play
Prototype
void Sound_Init(unsigned int *snd_port, unsigned< int/b> snd_pin);
Description Congures the appropriate MCU pin for sound generation.
Parameters - snd_port: sound output port address
- snd_pin: sound output pin
Returns Nothing.
Requires Nothing.
Example
// Initialize the pin RC3 for playing sound
Sound_Init(&PORTD, 3);
Notes None.
Prototype
void Sound_Play(unsigned int freq_in_hz, unsigned< int/b> duration_ms);
Description Generates the square wave signal on the appropriate pin.
Parameters - freq_in_hz: signal frequency in Hertz (Hz)
- duration_ms: signal duration in miliseconds (ms)
Returns Nothing.
Requires In order to hear the sound, you need a piezo speaker (or other hardware) on designated port. Also, you
must call Sound_Init to prepare hardware for output before using this function.
Example
// Play sound of 1KHz in duration of 100ms
Sound_Play(1000, 100);
Notes None.