This section covers functions related to the piezo buzzer embedded in the F-91W's back plate. More...

Typedefs
typedef enum BuzzerNote	BuzzerNote
	87 notes for use with watch_buzzer_play_note

Enumerations
enum	BuzzerNote { BUZZER_NOTE_A1 , BUZZER_NOTE_A1SHARP_B1FLAT , BUZZER_NOTE_B1 , BUZZER_NOTE_C2 , BUZZER_NOTE_C2SHARP_D2FLAT , BUZZER_NOTE_D2 , BUZZER_NOTE_D2SHARP_E2FLAT , BUZZER_NOTE_E2 , BUZZER_NOTE_F2 , BUZZER_NOTE_F2SHARP_G2FLAT , BUZZER_NOTE_G2 , BUZZER_NOTE_G2SHARP_A2FLAT , BUZZER_NOTE_A2 , BUZZER_NOTE_A2SHARP_B2FLAT , BUZZER_NOTE_B2 , BUZZER_NOTE_C3 , BUZZER_NOTE_C3SHARP_D3FLAT , BUZZER_NOTE_D3 , BUZZER_NOTE_D3SHARP_E3FLAT , BUZZER_NOTE_E3 , BUZZER_NOTE_F3 , BUZZER_NOTE_F3SHARP_G3FLAT , BUZZER_NOTE_G3 , BUZZER_NOTE_G3SHARP_A3FLAT , BUZZER_NOTE_A3 , BUZZER_NOTE_A3SHARP_B3FLAT , BUZZER_NOTE_B3 , BUZZER_NOTE_C4 , BUZZER_NOTE_C4SHARP_D4FLAT , BUZZER_NOTE_D4 , BUZZER_NOTE_D4SHARP_E4FLAT , BUZZER_NOTE_E4 , BUZZER_NOTE_F4 , BUZZER_NOTE_F4SHARP_G4FLAT , BUZZER_NOTE_G4 , BUZZER_NOTE_G4SHARP_A4FLAT , BUZZER_NOTE_A4 , BUZZER_NOTE_A4SHARP_B4FLAT , BUZZER_NOTE_B4 , BUZZER_NOTE_C5 , BUZZER_NOTE_C5SHARP_D5FLAT , BUZZER_NOTE_D5 , BUZZER_NOTE_D5SHARP_E5FLAT , BUZZER_NOTE_E5 , BUZZER_NOTE_F5 , BUZZER_NOTE_F5SHARP_G5FLAT , BUZZER_NOTE_G5 , BUZZER_NOTE_G5SHARP_A5FLAT , BUZZER_NOTE_A5 , BUZZER_NOTE_A5SHARP_B5FLAT , BUZZER_NOTE_B5 , BUZZER_NOTE_C6 , BUZZER_NOTE_C6SHARP_D6FLAT , BUZZER_NOTE_D6 , BUZZER_NOTE_D6SHARP_E6FLAT , BUZZER_NOTE_E6 , BUZZER_NOTE_F6 , BUZZER_NOTE_F6SHARP_G6FLAT , BUZZER_NOTE_G6 , BUZZER_NOTE_G6SHARP_A6FLAT , BUZZER_NOTE_A6 , BUZZER_NOTE_A6SHARP_B6FLAT , BUZZER_NOTE_B6 , BUZZER_NOTE_C7 , BUZZER_NOTE_C7SHARP_D7FLAT , BUZZER_NOTE_D7 , BUZZER_NOTE_D7SHARP_E7FLAT , BUZZER_NOTE_E7 , BUZZER_NOTE_F7 , BUZZER_NOTE_F7SHARP_G7FLAT , BUZZER_NOTE_G7 , BUZZER_NOTE_G7SHARP_A7FLAT , BUZZER_NOTE_A7 , BUZZER_NOTE_A7SHARP_B7FLAT , BUZZER_NOTE_B7 , BUZZER_NOTE_C8 , BUZZER_NOTE_C8SHARP_D8FLAT , BUZZER_NOTE_D8 , BUZZER_NOTE_D8SHARP_E8FLAT , BUZZER_NOTE_E8 , BUZZER_NOTE_F8 , BUZZER_NOTE_F8SHARP_G8FLAT , BUZZER_NOTE_G8 , BUZZER_NOTE_G8SHARP_A8FLAT , BUZZER_NOTE_A8 , BUZZER_NOTE_A8SHARP_B8FLAT , BUZZER_NOTE_B8 , BUZZER_NOTE_REST }
	87 notes for use with watch_buzzer_play_note More...

Functions
void	watch_enable_buzzer (void)
	Enables the TCC peripheral, which drives the buzzer.

void	watch_set_buzzer_period (uint32_t period)
	Sets the period of the buzzer.

void	watch_disable_buzzer (void)
	Disables the TCC peripheral that drives the buzzer.

void	watch_set_buzzer_on (void)
	Turns the buzzer output on. It will emit a continuous sound at the given frequency.

void	watch_set_buzzer_off (void)
	Turns the buzzer output off.

void	watch_buzzer_play_note (BuzzerNote note, uint16_t duration_ms)
	Plays the given note for a set duration.

void	watch_buzzer_play_sequence (int8_t note_sequence, void(callback_on_end)(void))
	Plays the given sequence of notes in a non-blocking way.

uint16_t	sequence_length (int8_t *sequence)

void	watch_buzzer_abort_sequence (void)
	Aborts a playing sequence.

void	TC3_Handler (void)

Variables
const uint16_t	NotePeriods [108]
	An array of periods for all the notes on a piano, corresponding to the names in BuzzerNote.

Detailed Description

This section covers functions related to the piezo buzzer embedded in the F-91W's back plate.

Enumeration Type Documentation

◆ BuzzerNote

enum BuzzerNote

87 notes for use with watch_buzzer_play_note

Enumerator
BUZZER_NOTE_A1	55.00 Hz
BUZZER_NOTE_A1SHARP_B1FLAT	58.27 Hz
BUZZER_NOTE_B1	61.74 Hz
BUZZER_NOTE_C2	65.41 Hz
BUZZER_NOTE_C2SHARP_D2FLAT	69.30 Hz
BUZZER_NOTE_D2	73.42 Hz
BUZZER_NOTE_D2SHARP_E2FLAT	77.78 Hz
BUZZER_NOTE_E2	82.41 Hz
BUZZER_NOTE_F2	87.31 Hz
BUZZER_NOTE_F2SHARP_G2FLAT	92.50 Hz
BUZZER_NOTE_G2	98.00 Hz
BUZZER_NOTE_G2SHARP_A2FLAT	103.83 Hz
BUZZER_NOTE_A2	110.00 Hz
BUZZER_NOTE_A2SHARP_B2FLAT	116.54 Hz
BUZZER_NOTE_B2	123.47 Hz
BUZZER_NOTE_C3	130.81 Hz
BUZZER_NOTE_C3SHARP_D3FLAT	138.59 Hz
BUZZER_NOTE_D3	146.83 Hz
BUZZER_NOTE_D3SHARP_E3FLAT	155.56 Hz
BUZZER_NOTE_E3	164.81 Hz
BUZZER_NOTE_F3	174.61 Hz
BUZZER_NOTE_F3SHARP_G3FLAT	185.00 Hz
BUZZER_NOTE_G3	196.00 Hz
BUZZER_NOTE_G3SHARP_A3FLAT	207.65 Hz
BUZZER_NOTE_A3	220.00 Hz
BUZZER_NOTE_A3SHARP_B3FLAT	233.08 Hz
BUZZER_NOTE_B3	246.94 Hz
BUZZER_NOTE_C4	261.63 Hz
BUZZER_NOTE_C4SHARP_D4FLAT	277.18 Hz
BUZZER_NOTE_D4	293.66 Hz
BUZZER_NOTE_D4SHARP_E4FLAT	311.13 Hz
BUZZER_NOTE_E4	329.63 Hz
BUZZER_NOTE_F4	349.23 Hz
BUZZER_NOTE_F4SHARP_G4FLAT	369.99 Hz
BUZZER_NOTE_G4	392.00 Hz
BUZZER_NOTE_G4SHARP_A4FLAT	415.30 Hz
BUZZER_NOTE_A4	440.00 Hz
BUZZER_NOTE_A4SHARP_B4FLAT	466.16 Hz
BUZZER_NOTE_B4	493.88 Hz
BUZZER_NOTE_C5	523.25 Hz
BUZZER_NOTE_C5SHARP_D5FLAT	554.37 Hz
BUZZER_NOTE_D5	587.33 Hz
BUZZER_NOTE_D5SHARP_E5FLAT	622.25 Hz
BUZZER_NOTE_E5	659.25 Hz
BUZZER_NOTE_F5	698.46 Hz
BUZZER_NOTE_F5SHARP_G5FLAT	739.99 Hz
BUZZER_NOTE_G5	783.99 Hz
BUZZER_NOTE_G5SHARP_A5FLAT	830.61 Hz
BUZZER_NOTE_A5	880.00 Hz
BUZZER_NOTE_A5SHARP_B5FLAT	932.33 Hz
BUZZER_NOTE_B5	987.77 Hz
BUZZER_NOTE_C6	1046.50 Hz
BUZZER_NOTE_C6SHARP_D6FLAT	1108.73 Hz
BUZZER_NOTE_D6	1174.66 Hz
BUZZER_NOTE_D6SHARP_E6FLAT	1244.51 Hz
BUZZER_NOTE_E6	1318.51 Hz
BUZZER_NOTE_F6	1396.91 Hz
BUZZER_NOTE_F6SHARP_G6FLAT	1479.98 Hz
BUZZER_NOTE_G6	1567.98 Hz
BUZZER_NOTE_G6SHARP_A6FLAT	1661.22 Hz
BUZZER_NOTE_A6	1760.00 Hz
BUZZER_NOTE_A6SHARP_B6FLAT	1864.66 Hz
BUZZER_NOTE_B6	1975.53 Hz
BUZZER_NOTE_C7	2093.00 Hz
BUZZER_NOTE_C7SHARP_D7FLAT	2217.46 Hz
BUZZER_NOTE_D7	2349.32 Hz
BUZZER_NOTE_D7SHARP_E7FLAT	2489.02 Hz
BUZZER_NOTE_E7	2637.02 Hz
BUZZER_NOTE_F7	2793.83 Hz
BUZZER_NOTE_F7SHARP_G7FLAT	2959.96 Hz
BUZZER_NOTE_G7	3135.96 Hz
BUZZER_NOTE_G7SHARP_A7FLAT	3322.44 Hz
BUZZER_NOTE_A7	3520.00 Hz
BUZZER_NOTE_A7SHARP_B7FLAT	3729.31 Hz
BUZZER_NOTE_B7	3951.07 Hz
BUZZER_NOTE_C8	4186.01 Hz
BUZZER_NOTE_C8SHARP_D8FLAT	4434.92 Hz
BUZZER_NOTE_D8	4698.63 Hz
BUZZER_NOTE_D8SHARP_E8FLAT	4978.03 Hz
BUZZER_NOTE_E8	5274.04 Hz
BUZZER_NOTE_F8	5587.65 Hz
BUZZER_NOTE_F8SHARP_G8FLAT	5919.91 Hz
BUZZER_NOTE_G8	6271.93 Hz
BUZZER_NOTE_G8SHARP_A8FLAT	6644.88 Hz
BUZZER_NOTE_A8	7040.00 Hz
BUZZER_NOTE_A8SHARP_B8FLAT	7458.62 Hz
BUZZER_NOTE_B8	7902.13 Hz
BUZZER_NOTE_REST	no sound

Function Documentation

◆ watch_buzzer_play_note()

void watch_buzzer_play_note	(	BuzzerNote	note,
		uint16_t	duration_ms
	)

Plays the given note for a set duration.

Parameters

note	The note you wish to play, or BUZZER_NOTE_REST to disable output for the given duration.
duration_ms	The duration of the note.

Note: Note that this will block your UI for the duration of the note's play time, and it will after this call, the buzzer period will be set to the period of this note.

◆ watch_buzzer_play_sequence()

void watch_buzzer_play_sequence	(	int8_t *	note_sequence,
		void(*)(void)	callback_on_end
	)

Plays the given sequence of notes in a non-blocking way.

Parameters

note_sequence A pointer to the sequence of buzzer note & duration tuples, ending with a zero. A simple RLE logic is implemented: a negative number instead of a buzzer note means that the sequence is rewound by the given number of notes. The byte following a negative number determines the number of loops. I.e. if you want to repeat the last three notes of the sequence one time, you should provide the tuple -3, 1. The repeated notes must not contain any other repeat markers, or you will end up with an eternal loop.

callback_on_end A pointer to a callback function to be invoked when the sequence has finished playing.

Note: This function plays the sequence asynchronously, so the UI will not be blocked. Hint: It is not possible to play the lowest note BUZZER_NOTE_A1 (55.00 Hz). The note is represented by a zero byte, which is used here as the end-of-sequence marker. But hey, a frequency that low cannot be played properly by the watch's buzzer, anyway.

◆ watch_disable_buzzer()

void watch_disable_buzzer ( void )

Disables the TCC peripheral that drives the buzzer.

Note: If you are using PWM to set custom LED colors, this method will also disable the LED PWM driver, since the buzzer and LED both make use of the same peripheral to drive their PWM behavior.

◆ watch_set_buzzer_on()

void watch_set_buzzer_on ( void )

Turns the buzzer output on. It will emit a continuous sound at the given frequency.

Note: The TCC peripheral that drives the buzzer does not run in standby mode; if you wish for buzzer output to continue, you should prevent your app from going to sleep.

◆ watch_set_buzzer_period()

void watch_set_buzzer_period ( uint32_t period )

Sets the period of the buzzer.

Parameters

period The period of a single cycle for the TCC peripheral. You can determine the period for a desired frequency with the following formula: period = 1000000 / freq

Typedefs

Enumerations

Functions

Variables

Detailed Description

Enumeration Type Documentation

◆ BuzzerNote

Function Documentation

◆ watch_buzzer_play_note()

◆ watch_buzzer_play_sequence()

◆ watch_disable_buzzer()

◆ watch_set_buzzer_on()

◆ watch_set_buzzer_period()