Play an arbitrary stream on the buzzer without blocking

watch-library/shared/watch/watch_tcc.h

@@ -126,6 +126,10 @@ typedef enum {
     BUZZER_NOTE_REST             ///< no sound
 } watch_buzzer_note_t;
 
+#define WATCH_BUZZER_PERIOD_REST 0
+
+typedef bool (*watch_buzzer_raw_source_t)(uint16_t position, void* userdata, uint16_t* period, uint16_t* duration);
+
 /** @brief Returns true if either the buzzer or the LED driver is enabled.
   * @details Both the buzzer and the LED use the TCC peripheral to drive their behavior. This function returns true if that
   *          peripheral is enabled. You can use this function to determine whether you need to call the watch_enable_leds or
@@ -210,6 +214,51 @@ void watch_buzzer_play_sequence(int8_t *note_sequence, void (*callback_on_end)(v
   */
 void watch_buzzer_play_sequence_with_volume(int8_t *note_sequence, void (*callback_on_end)(void), watch_buzzer_volume_t volume);
 
+/** @brief Plays the given raw buzzer source function in a non-blocking way.
+  *
+  *  @details This function plays audio data generated by a raw source callback function,
+  *           allowing for precise control over buzzer timing and frequency. The raw source
+  *           function is called repeatedly to generate audio samples, each containing a
+  *           period and duration for the buzzer tone.
+  *           Useful for applications such as chirpy, so that they won't need to allocate a
+  *           long note sequence, and we will also take care of all the timing logic.
+  *
+  * @param raw_source Pointer to the callback function that generates raw buzzer data.
+  *                   The function should take a position parameter and return true if
+  *                   more data is available, false if end of sequence is reached.
+  *                   Parameters:
+  *                   - position: Current position in the audio sequence (0-based)
+  *                   - userdata: User-provided data passed through to the callback
+  *                   - period: Pointer to store the period (in microseconds) for the tone
+  *                   - duration: Pointer to store the duration (in microseconds) for the tone
+  * @param userdata Pointer to user data that will be passed to the raw_source callback
+  * @param callback_on_end A pointer to a callback function to be invoked when the sequence has finished playing.
+  */
+void watch_buzzer_play_raw_source(watch_buzzer_raw_source_t raw_source, void* userdata, watch_cb_t callback_on_end);
+
+/** @brief Plays the given raw buzzer source function in a non-blocking way.
+  *
+  *  @details This function plays audio data generated by a raw source callback function,
+  *           allowing for precise control over buzzer timing and frequency. The raw source
+  *           function is called repeatedly to generate audio samples, each containing a
+  *           period and duration for the buzzer tone.
+  *           Useful for applications such as chirpy, so that they won't need to allocate a
+  *           long note sequence, and we will also take care of all the timing logic.
+  *
+  * @param raw_source Pointer to the callback function that generates raw buzzer data.
+  *                   The function should take a position parameter and return true if
+  *                   more data is available, false if end of sequence is reached.
+  *                   Parameters:
+  *                   - position: Current position in the audio sequence (0-based)
+  *                   - userdata: User-provided data passed through to the callback
+  *                   - period: Pointer to store the period (in microseconds) for the tone
+  *                   - duration: Pointer to store the duration (in microseconds) for the tone
+  * @param userdata Pointer to user data that will be passed to the raw_source callback
+  * @param callback_on_end A pointer to a callback function to be invoked when the sequence has finished playing.
+  * @param volume either WATCH_BUZZER_VOLUME_SOFT or WATCH_BUZZER_VOLUME_LOUD
+  */
+void watch_buzzer_play_raw_source_with_volume(watch_buzzer_raw_source_t raw_source, void* userdata, watch_cb_t callback_on_end, watch_buzzer_volume_t volume);
+
 /** @brief Aborts a playing sequence.
   */
 void watch_buzzer_abort_sequence(void);