Change in osmo-gsm-manuals[master]: TRXD: more information on PDU versioning and some highlights

This is merely a historical archive of years 2008-2021, before the migration to mailman3.

A maintained and still updated list archive can be found at https://lists.osmocom.org/hyperkitty/list/gerrit-log@lists.osmocom.org/.

fixeria gerrit-no-reply at lists.osmocom.org
Mon Feb 1 19:59:01 UTC 2021


fixeria has uploaded this change for review. ( https://gerrit.osmocom.org/c/osmo-gsm-manuals/+/22622 )


Change subject: TRXD: more information on PDU versioning and some highlights
......................................................................

TRXD: more information on PDU versioning and some highlights

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



  git pull ssh://gerrit.osmocom.org:29418/osmo-gsm-manuals refs/changes/22/22622/1

diff --git a/common/chapters/trx_if.adoc b/common/chapters/trx_if.adoc
index 5989258..222e434 100644
--- a/common/chapters/trx_if.adoc
+++ b/common/chapters/trx_if.adoc
@@ -299,15 +299,16 @@
 In the example for `HVHH`, legacy TCH/H0 does not belong to a _VAMOS pair_, so it can
 be configured to use any sequence from any set.
 
+[[trx_if_pdu_version_nego]]
 ==== TRXD header version negotiation
 
-Messages on DATA interface may have different header formats, defined by a
-version number, which can be negotiated on the control interface. By default,
-the Transceiver will use the legacy header version (0).
+Messages on DATA interface may have different formats, defined by a version number,
+which can be negotiated on the control interface.  By default, the Transceiver will
+use the legacy header version (0).  See <<trx_if_pdu_versioning>>.
 
-The header format negotiation can be initiated by the BTS using 'SETFORMAT'
-command. If the requested version is not supported by the transceiver, status
-code of the response message should indicate a preferred (basically, the latest)
+The format negotiation can be initiated by the BTS using 'SETFORMAT' command.
+If the requested version is not supported by the transceiver, status code of
+the response message should indicate a preferred (basically, the latest)
 version. The format of this message is the following:
 ----
 CMD SETFORMAT <ver_req>
@@ -386,6 +387,31 @@
 _hard-bits_ (to the modulator).  Length of the sequence depends on modulation
 type of the burst.
 
+[[trx_if_pdu_versioning]]
+==== PDU versioning
+
+The format of a PDU, i.e. presence and ordering of certain fields, is determined by
+the version number indicated in the first octet.  This is usually referred as
+`TRXDvN`, where `N` is the version number (e.g. TRXDv0 or TRXDv1).  A version number
+indicates the message format to be used for both directions: `TRX -> L1` and
+`L1 -> TRX`.  The same version shall be used for all messages in both directions,
+mixing in any way is not permitted.
+
+The version negotiation is optionally initiated by the `L1` on the control interface,
+and expected to be performed before starting the transceiver (i.e. sending 'POWERON'
+command).  See <<trx_if_pdu_version_nego>>.
+
+The current header allows to distinguish up to 16 different versions.
+The following versions are defined so far:
+
+* TRXDv0 - initial version of TRXD protocol, inherited as-is from OpenBTS project.
+* TRXDv1 (proposed in July 2019):
+** Introduced the concept of protocol versioning;
+** Introduced NOPE / IDLE indications;
+** New field: MTS (Modulation and Training Sequence);
+** New field: C/I (Carrier-to-interface) ratio;
+** Downlink messages mostly unchanged.
+
 ==== Uplink Data Burst
 
 Uplink data burst message structure differs from version 0 to 1. Basically,

-- 
To view, visit https://gerrit.osmocom.org/c/osmo-gsm-manuals/+/22622
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: Idac4a1c73cc92bf030ea80474c71688bfb706421
Gerrit-Change-Number: 22622
Gerrit-PatchSet: 1
Gerrit-Owner: fixeria <vyanitskiy at sysmocom.de>
Gerrit-MessageType: newchange
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osmocom.org/pipermail/gerrit-log/attachments/20210201/ada1d4ff/attachment.htm>


More information about the gerrit-log mailing list