mirror of
https://github.com/Telecominfraproject/OpenCellular.git
synced 2025-12-28 10:45:22 +00:00
855646e36b
Previously the Producer and Consumer interfaces tracked the Consumer and Producer respectively at the other end of the queue that they interacted with. This was done to avoid modifying the queue implementation, but resulted in a rougher interface that required additional initialization steps and prevented alternative configurations; many producers and one consumer for example. This commit uses the new queue policies to track this information. The new direct policy behaves as the old producer and consumers did. Now the producers and consumers are just named references to the queue that they work on and a convenient location for a notification callback when the queue is updated in a way that is relevent to the producer or consumer. All users of Producer and Consumer have been updated including the stream adaptors which are in use by the echo test code and the mcdp28x0 driver. Use of the stream adaptors has also been simplified. Signed-off-by: Anton Staaf <robotboy@chromium.org> BRANCH=None BUG=None TEST=make buildall -j Manual testing of Ryu (P5) and discovery board echo task Change-Id: I704be6378a31b4e20f5063295eff9943e4900409 Reviewed-on: https://chromium-review.googlesource.com/271792 Reviewed-by: Anton Staaf <robotboy@chromium.org> Commit-Queue: Anton Staaf <robotboy@chromium.org> Trybot-Ready: Anton Staaf <robotboy@chromium.org> Tested-by: Anton Staaf <robotboy@chromium.org>
48 lines
1.2 KiB
C
48 lines
1.2 KiB
C
/* Copyright 2015 The Chromium OS Authors. All rights reserved.
|
|
* Use of this source code is governed by a BSD-style license that can be
|
|
* found in the LICENSE file.
|
|
*
|
|
* Consumer interface
|
|
*
|
|
* The consumer abstraction allows for code that wants to be able to read from
|
|
* a queue, and be notified of new additions to the queue, or of requests to
|
|
* flush (empty) the queue.
|
|
*/
|
|
#ifndef INCLUDE_CONSUMER_H
|
|
#define INCLUDE_CONSUMER_H
|
|
|
|
#include "queue.h"
|
|
|
|
#include <stddef.h>
|
|
#include <stdint.h>
|
|
|
|
struct consumer;
|
|
struct producer;
|
|
|
|
struct consumer_ops {
|
|
/*
|
|
* Inform the consumer that count units were written to the queue.
|
|
* This gives it the oportunity to read additional units from the queue
|
|
* or to wake up a task or interrupt to do the same. If a consumer has
|
|
* no need for this information it can set this to NULL.
|
|
*/
|
|
void (*written)(struct consumer const *consumer, size_t count);
|
|
|
|
/*
|
|
* Flush (read) everything from the associated queue. This call blocks
|
|
* until the consumer has flushed the queue.
|
|
*/
|
|
void (*flush)(struct consumer const *consumer);
|
|
};
|
|
|
|
struct consumer {
|
|
/*
|
|
* A consumer references the queue that it is reading from.
|
|
*/
|
|
struct queue const *queue;
|
|
|
|
struct consumer_ops const *ops;
|
|
};
|
|
|
|
#endif /* INCLUDE_CONSUMER_H */
|