audio: buffer: use add BUFFER_USAGE_ flags to improve readability

Passing boolean parameters to key functions results in hard to read
code. Add BUFFER_USAGE_SHARED and BUFFER_USAGE_NOT_SHARED definitions
to make code allocating buffers easier to read and maintain.

No functional change.

Signed-off-by: Kai Vehmanen <kai.vehmanen@linux.intel.com>

Author: kv2019i

src/audio/chain_dma.c

@@ -592,7 +592,7 @@ __cold static int chain_task_init(struct comp_dev *dev, uint8_t host_dma_id, uin
 	fifo_size = ALIGN_UP_INTERNAL(fifo_size, addr_align);
 	/* allocate not shared buffer */
 	cd->dma_buffer = buffer_alloc(fifo_size, SOF_MEM_FLAG_USER | SOF_MEM_FLAG_DMA,
-				      addr_align, false);
+				      addr_align, BUFFER_USAGE_NOT_SHARED);
 
 	if (!cd->dma_buffer) {
 		comp_err(dev, "failed to alloc dma buffer");

src/audio/dai-legacy.c

@@ -562,7 +562,7 @@ int dai_common_params(struct dai_data *dd, struct comp_dev *dev,
 		}
 	} else {
 		dd->dma_buffer = buffer_alloc(buffer_size, SOF_MEM_FLAG_USER | SOF_MEM_FLAG_DMA,
-					      addr_align, false);
+					      addr_align, BUFFER_USAGE_NOT_SHARED);
 		if (!dd->dma_buffer) {
 			comp_err(dev, "failed to alloc dma buffer");
 			return -ENOMEM;

src/audio/dai-zephyr.c

@@ -1020,7 +1020,8 @@ static int dai_set_dma_buffer(struct dai_data *dd, struct comp_dev *dev,
 		}
 	} else {
 		dd->dma_buffer = buffer_alloc_range(buffer_size_preferred, buffer_size,
-						    SOF_MEM_FLAG_USER | SOF_MEM_FLAG_DMA, addr_align, false);
+						    SOF_MEM_FLAG_USER | SOF_MEM_FLAG_DMA,
+						    addr_align, BUFFER_USAGE_NOT_SHARED);
 		if (!dd->dma_buffer) {
 			comp_err(dev, "failed to alloc dma buffer");
 			return -ENOMEM;

src/audio/host-legacy.c

@@ -760,7 +760,7 @@ int host_common_params(struct host_data *hd, struct comp_dev *dev,
 		}
 	} else {
 		hd->dma_buffer = buffer_alloc(buffer_size, SOF_MEM_FLAG_USER | SOF_MEM_FLAG_DMA,
-					      addr_align, false);
+					      addr_align, BUFFER_USAGE_NOT_SHARED);
 		if (!hd->dma_buffer) {
 			comp_err(dev, "failed to alloc dma buffer");
 			err = -ENOMEM;

src/audio/host-zephyr.c

@@ -921,7 +921,8 @@ int host_common_params(struct host_data *hd, struct comp_dev *dev,
 	} else {
 		/* allocate not shared buffer */
 		hd->dma_buffer = buffer_alloc_range(buffer_size_preferred, buffer_size,
-						    SOF_MEM_FLAG_USER | SOF_MEM_FLAG_DMA, addr_align, false);
+						    SOF_MEM_FLAG_USER | SOF_MEM_FLAG_DMA,
+						    addr_align, BUFFER_USAGE_NOT_SHARED);
 		if (!hd->dma_buffer) {
 			comp_err(dev, "failed to alloc dma buffer");
 			return -ENOMEM;

src/audio/module_adapter/module_adapter.c

@@ -451,7 +451,8 @@ int module_adapter_prepare(struct comp_dev *dev)
 		for (i = 0; i < mod->num_of_sinks; i++) {
 			/* allocate not shared buffer */
 			struct comp_buffer *buffer = buffer_alloc(buff_size, memory_flags,
-								  PLATFORM_DCACHE_ALIGN, false);
+								  PLATFORM_DCACHE_ALIGN,
+								  BUFFER_USAGE_NOT_SHARED);
 			uint32_t flags;
 
 			if (!buffer) {

src/include/sof/audio/buffer.h

@@ -117,6 +117,10 @@ extern struct tr_ctx buffer_tr;
 #define BUFF_PARAMS_RATE	BIT(2)
 #define BUFF_PARAMS_CHANNELS	BIT(3)
 
+/* buffer usage */
+#define BUFFER_USAGE_SHARED	true	/* buffer used by multiple DSP core and/or HW blocks */
+#define BUFFER_USAGE_NOT_SHARED false	/* buffer only used by one HW block */
+
 /*
  * audio component buffer - connects 2 audio components together in pipeline.
  *