Change in osmo-gsm-manuals[master]: TRXDv2: add primary/shadow classification for VAMOS PDUs

historical

fixeria has submitted this change. ( https://gerrit.osmocom.org/c/osmo-gsm-manuals/+/24508 )

Change subject: TRXDv2: add primary/shadow classification for VAMOS PDUs
......................................................................

TRXDv2: add primary/shadow classification for VAMOS PDUs

Introduce a new flag (1-bit field) indicating whether a VAMOS PDU
is for a _primary_ ('0'B) or for a _shadow_ ('1'B) timeslot.  This
field shall be present only in the Uplink VAMOS PDUs, which unlike
the Downlink (AQPSK) PDUs are sent separately.  This will simplify
routing of such PDUs in osmo-bts.

Change-Id: Ie00a12824938c6a65480bde1af364dcc9febb8f7
Related: SYS#4895, OS#4941, OS#4006
---
M common/chapters/trx_if.adoc
1 file changed, 23 insertions(+), 17 deletions(-)

Approvals:
  Jenkins Builder: Verified
  pespin: Looks good to me, but someone else must approve
  fixeria: Looks good to me, approved

diff --git a/common/chapters/trx_if.adoc b/common/chapters/trx_if.adoc
index f4884f0..9638133 100644
--- a/common/chapters/trx_if.adoc
+++ b/common/chapters/trx_if.adoc
@@ -398,6 +398,7 @@
 ** Introduced the concept of burst batching (many bursts in one message);
 ** Changed the field ordering (facilitating aligned access);
 ** New field: batching indicator;
+** New field: shadow indicator;
 ** New field: TRX number;
 ** New field: SCPIR for VAMOS.
 
@@ -496,7 +497,7 @@
 	0-4:	RFU
 	5-7:	TN
 	8:	BATCH
-	9:	RFU
+	9:	SHADOW
 	10-15:	TRXN
 	16-23:	MTS
 	24-31:	RSSI
@@ -519,6 +520,9 @@
 BATCH: 1 bit::
 This bit indicates whether a batched PDU follows (see <<trx_if_pdu_batching>>).
 
+SHADOW: 1 bit::
+This bit indicates whether this is a _shadow PDU_ (see <<trx_if_pdu_vamos>>).
+
 TRXN: 6 bits::
 The transceiver (PHY channel) number this PDU is coming from.
 
@@ -823,27 +827,29 @@
 In the Uplink direction though, one or even both of the two bursts may be lost
 (e.g. due to high noise figures), so they shall always be sent in two separate
 PDUs.  The missing bursts shall be substituted by NOPE indications, so it's
-always a pair of _batched PDUs_.  The `MTS` field shall indicate the use of
-`GMSK` modulation.
+always a pair of _batched PDUs_.  First PDU in a pair is called _primary PDU_,
+the second is called _shadow PDU_.  This is additionally indicated by the
+`SHADOW` field, which is set to {bit-zero} and {bit-one}, respectively.  The
+`MTS` field shall indicate the use of `GMSK` modulation if the burst is present.
 
 .Example: Uplink datagram containing batched VAMOS PDUs (both present)
 ----
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-+--------+----------------+----------+----------------------------------------+
-| TRXN=N | TDMA FN=F TN=T | Mod=GMSK | Soft-bits for V0 (148 bytes)           |
-+--------+----------------+----------+----------------------------------------+
-| TRXN=N | TDMA FN=F TN=T | Mod=GMSK | Soft-bits for V1 (148 bytes)           |
-+--------+----------------+----------+----------------------------------------+
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
++--------+----------------+----------+----------+------------------------------+
+| TRXN=N | TDMA FN=F TN=T | SHADOW=0 | Mod=GMSK | Soft-bits for V0 (148 bytes) |
++--------+----------------+----------+----------+------------------------------+
+| TRXN=N | TDMA FN=F TN=T | SHADOW=1 | Mod=GMSK | Soft-bits for V1 (148 bytes) |
++--------+----------------+----------+----------+------------------------------+
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 ----
 
 .Example: Uplink datagram containing batched VAMOS PDUs (one lost)
 ----
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-+--------+----------------+----------+----------------------------------------+
-| TRXN=N | TDMA FN=F TN=T | Mod=GMSK | Soft-bits for V0 (148 bytes)           |
-+--------+----------------+----------+----------------------------------------+
-| TRXN=N | TDMA FN=F TN=T | NOPE.ind |
-+--------+----------------+----------+
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
++--------+----------------+----------+----------+------------------------------+
+| TRXN=N | TDMA FN=F TN=T | SHADOW=0 | Mod=GMSK | Soft-bits for V0 (148 bytes) |
++--------+----------------+----------+----------+------------------------------+
+| TRXN=N | TDMA FN=F TN=T | SHADOW=1 | NOPE.ind |
++--------+----------------+----------+----------+
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 ----

-- 
To view, visit https://gerrit.osmocom.org/c/osmo-gsm-manuals/+/24508
To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings

Gerrit-Project: osmo-gsm-manuals
Gerrit-Branch: master
Gerrit-Change-Id: Ie00a12824938c6a65480bde1af364dcc9febb8f7
Gerrit-Change-Number: 24508
Gerrit-PatchSet: 2
Gerrit-Owner: fixeria <vyanitskiy at sysmocom.de>
Gerrit-Reviewer: Jenkins Builder
Gerrit-Reviewer: fixeria <vyanitskiy at sysmocom.de>
Gerrit-Reviewer: laforge <laforge at osmocom.org>
Gerrit-Reviewer: neels <nhofmeyr at sysmocom.de>
Gerrit-Reviewer: pespin <pespin at sysmocom.de>
Gerrit-MessageType: merged
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osmocom.org/pipermail/gerrit-log/attachments/20210606/e6422cae/attachment.htm>
