ecu: add is_dtx_pause() method

The ECU API of libosmocodec is unfortunately a peculiar non-3GPP
entity: an ECU by itself, severed from Rx DTX handler functions,
which is a logical/conceptual function with no place in the standard
3GPP architecture.  The closest thing that exists in the standard
architecture is the TFO spec (TS 28.062 section C.3.2.1.1) calling
for an ECU application, but not comfort noise generation, in the case
of destination leg doing DTXd - but even then it is not a totally
"pure" ECU like libosmocodec API, it is an ECU plus a SID preener,
and the SID preening transform is not possible within the constraints
of existing libosmocodec ECU API.  Hence truly correct handling of
corner cases, particularly invalid SID, is sadly impossible in the
current libosmocodec ECU framework.

The only current user of this API is the UL path in osmo-bts-trx;
however, as described in OS#6040, we would like to move that ECU call
from osmo-bts-trx model-specific code to the common layer of osmo-bts.
The current osmo-bts-trx incarnation avoids the SID handling problem
by suppressing the call to ECU frame_out() after any SID (valid or
invalid) was received on the air, thus pausing the RTP stream instead
of emitting ECU output during DTXu pauses.  We would like to retain
the same behavior when we move this ECU call to the common layer,
into its proper place _after_ the link quality check in l1sap - but
the current method of flagging post-SID state in osmo-bts-trx will
no longer work on the other side of that link quality check.

As a workaround, have the ECU remember via a separate Boolean flag
whether it is in post-SID state or not (was the most recent frame_in()
any kind of SID or not), and provide is_dtx_pause() method to
retrieve this flag - the relocated ECU call in osmo-bts UL path
will use this new is_dtx_pause() method call to decide if it should
call frame_out() or switch to pausing RTP output.

Related: OS#6040
Change-Id: I3857be84bba12aaca0c2cca91458b7e13c5a642a

1 files changed, 4 insertions, 0 deletions

diff --git a/include/osmocom/codec/ecu.h b/include/osmocom/codec/ecu.h
index 9307ea18..64928609 100644
--- a/include/osmocom/codec/ecu.h
+++ b/include/osmocom/codec/ecu.h
@@ -62,12 +62,16 @@ int osmo_ecu_frame_in(struct osmo_ecu_state *st, bool bfi,
 /* generate output data for a substitute/erroneous frame */
 int osmo_ecu_frame_out(struct osmo_ecu_state *st, uint8_t *frame_out);
 
+/* is the stream handled by this ECU currently in a DTX pause? */
+bool osmo_ecu_is_dtx_pause(struct osmo_ecu_state *st);
+
 struct osmo_ecu_ops {
 	struct osmo_ecu_state * (*init)(void *ctx, enum osmo_ecu_codec codec);
 	void (*destroy)(struct osmo_ecu_state *);
 	int (*frame_in)(struct osmo_ecu_state *st, bool bfi,
 			const uint8_t *frame, unsigned int frame_bytes);
 	int (*frame_out)(struct osmo_ecu_state *st, uint8_t *frame_out);
+	bool (*is_dtx_pause)(struct osmo_ecu_state *st);
 };
 
 int osmo_ecu_register(const struct osmo_ecu_ops *ops, enum osmo_ecu_codec codec);