audio: stream: Introduce audio stream state

Add enum describing the state of a audio stream. Change the
hw_params_configured field to state. A stream is initially in the
STREAM_STATE_INITIAL state. After configuring the parameters,
it transitions to the STREAM_STATE_READY state.

Signed-off-by: Adrian Warecki <adrian.warecki@intel.com>

Author: softwarecki

src/include/module/audio/audio_stream.h

@@ -13,6 +13,20 @@
 #include <stdbool.h>
 #include "../ipc/stream.h"
 
+
+/**
+ * @enum sof_audio_buffer_state
+ * @brief Define states of an audio stream buffer connecting two components.
+ *
+ * This enum represents the lifecycle of an audio stream, including its
+ * initialization, readiness, and end-of-stream handling. It is used to
+ * track and manage the state transitions of the stream during audio processing.
+ */
+enum sof_audio_buffer_state {
+	AUDIOBUF_STATE_INITIAL,			/* Initial state, hw params not configured. */
+	AUDIOBUF_STATE_READY,			/* Stream ready, hw params configured */
+};
+
 /**
  * set of parameters describing audio stream
  * this structure is shared between audio_stream.h and sink/source interface
@@ -53,7 +67,7 @@ struct sof_audio_stream_params {
 
 	uint16_t chmap[SOF_IPC_MAX_CHANNELS];	/**< channel map - SOF_CHMAP_ */
 
-	bool hw_params_configured; /**< indicates whether hw params were set */
+	enum sof_audio_buffer_state state;	/**< audio stream state */
 };
 
 #endif /* __MODULE_AUDIO_AUDIO_STREAM_H__ */

src/include/sof/audio/audio_buffer.h

@@ -214,17 +214,17 @@ static inline bool audio_buffer_is_shared(struct sof_audio_buffer *buffer)
 
 static inline bool audio_buffer_hw_params_configured(struct sof_audio_buffer *buffer)
 {
-	return buffer->audio_stream_params->hw_params_configured;
+	return buffer->audio_stream_params->state != AUDIOBUF_STATE_INITIAL;
 }
 
 static inline void audio_buffer_set_hw_params_configured(struct sof_audio_buffer *buffer)
 {
-	buffer->audio_stream_params->hw_params_configured = true;
+	buffer->audio_stream_params->state = AUDIOBUF_STATE_READY;
 }
 
 static inline void audio_buffer_reset_params(struct sof_audio_buffer *buffer)
 {
-	buffer->audio_stream_params->hw_params_configured = false;
+	buffer->audio_stream_params->state = AUDIOBUF_STATE_INITIAL;
 }
 
 static inline uint16_t audio_buffer_get_chmap(struct sof_audio_buffer *buffer, size_t index)