#ifndef AUDIO_H
#define AUDIO_H

/**
 * @brief Initializes the audio subsystem
 *
 * @return 0 on success, negative error code on failure
 */
int audio_init(void);

/**
 * @brief Plays an audio file from the filesystem
 *
 * @param filename The path to the audio file to play
 */
void audio_play(const char *filename);

/**
 * @brief Stops the currently playing audio
 */
void audio_stop(void);

/**
 * @brief Signals the audio thread that the system is fully booted
 */
void audio_system_ready(void);

/**
 * @brief Refreshes the count of available audio files
 */
void audio_refresh_file_count(void);

/**
 * @brief Puts the QSPI flash into deep sleep mode to save power
 */
void flash_deep_sleep(void);

#endif // AUDIO_H