<p>laforge <strong>submitted</strong> this change.</p><p><a href="https://gerrit.osmocom.org/c/osmo-bts/+/23847">View Change</a></p><div style="white-space:pre-wrap">Approvals:
neels: Looks good to me, approved
fixeria: Looks good to me, but someone else must approve
Jenkins Builder: Verified
</div><pre style="font-family: monospace,monospace; white-space: pre-wrap;">Abis manual: add Get Attributes, add BTS features<br><br>Change-Id: I99631272334537ab49ba8c530240aaeb67dde9d7<br>---<br>M doc/manuals/abis/oml.adoc<br>1 file changed, 107 insertions(+), 5 deletions(-)<br><br></pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;"><span>diff --git a/doc/manuals/abis/oml.adoc b/doc/manuals/abis/oml.adoc</span><br><span>index 0fbd321..f6fd236 100644</span><br><span>--- a/doc/manuals/abis/oml.adoc</span><br><span>+++ b/doc/manuals/abis/oml.adoc</span><br><span>@@ -35,6 +35,10 @@</span><br><span> .3+.| 8.9.2 | 0x74 .3+.| <<opstart>> | Opstart | <- | Received</span><br><span> | 0x75 | Opstart Ack | -> | Sent</span><br><span> | 0x76 | Opstart Nack | -> | Sent</span><br><span style="color: hsl(120, 100%, 40%);">+6+<| *Other Messages:*</span><br><span style="color: hsl(120, 100%, 40%);">+.3+.| 8.11.1 | 0x81 | <<get_attributes>> | Get Attributes | <- | Received</span><br><span style="color: hsl(120, 100%, 40%);">+ | 8.11.3 | 0x82 | <<get_attr_resp>> | Get Attribute Response | -> | Sent</span><br><span style="color: hsl(120, 100%, 40%);">+ | 8.11.1 | 0x83 | | Get Attributes Nack | -> | Sent</span><br><span> |===</span><br><span> </span><br><span> </span><br><span>@@ -137,9 +141,6 @@</span><br><span> | 8.10.3 | 0x8C | Stop Measurement</span><br><span> | 8.10.4 | 0x8D | Start Measurement</span><br><span> 3+<| *Other Messages:*</span><br><span style="color: hsl(0, 100%, 40%);">- | 8.11.1 | 0x81 | Get Attributes</span><br><span style="color: hsl(0, 100%, 40%);">- | 8.11.3 | 0x82 | Get Attribute(s) Response</span><br><span style="color: hsl(0, 100%, 40%);">- | 8.11.1 | 0x83 | Get Attributes Nack</span><br><span> .3+.| 8.11.2 | 0x84 | Set Alarm Threshold</span><br><span> | 0x85 | Set Alarm Threshold Ack</span><br><span> | 0x86 | Set Alarm Threshold Nack</span><br><span>@@ -236,6 +237,26 @@</span><br><span> Object Classes defined in 3GPP TS 52.021 § 9.2 as well as</span><br><span> <<addnl_obj_classes>>.</span><br><span> </span><br><span style="color: hsl(120, 100%, 40%);">+[[get_attributes]]</span><br><span style="color: hsl(120, 100%, 40%);">+==== Get Attributes</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+This message is compliant with 3GPP TS 52.021 § 8.11.1.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+For a list of supported attributes, see <<get_attr_resp>>.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+[[get_attr_resp]]</span><br><span style="color: hsl(120, 100%, 40%);">+==== Get Attribute Response</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+This message is compliant with 3GPP TS 52.021 § 8.11.3.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+The following attributes are provided by OsmoBTS:</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+[options="header"]</span><br><span style="color: hsl(120, 100%, 40%);">+|===</span><br><span style="color: hsl(120, 100%, 40%);">+| 3GPP TS 52.021 chapter | description | see</span><br><span style="color: hsl(120, 100%, 40%);">+| 9.4.61 | SW Configuration | <<NM_ATT_SW_CONFIG>></span><br><span style="color: hsl(120, 100%, 40%);">+| 9.4.30 | Manufacturer Id | <<NM_ATT_MANUF_ID>></span><br><span style="color: hsl(120, 100%, 40%);">+|===</span><br><span> </span><br><span> === Details on OsmoBTS Specific Messages</span><br><span> </span><br><span>@@ -406,9 +427,9 @@</span><br><span> | 0x38 | 9.4.58 | VSWR Thresholds | | _ignored_</span><br><span> | 0x39 | 9.4.59 | Window Size | | _ignored_</span><br><span> | 0x40 | 9.4.60 | TSC | <- | Received, with limitations: see <<NM_ATT_TSC>></span><br><span style="color: hsl(0, 100%, 40%);">-| 0x41 | 9.4.61 | SW Configuration | | _ignored_</span><br><span style="color: hsl(120, 100%, 40%);">+| 0x41 | 9.4.61 | SW Configuration | -> | Sent, see <<NM_ATT_SW_CONFIG>></span><br><span> | 0x43 | 9.4.63 | Perceived Severity | | _ignored_</span><br><span style="color: hsl(0, 100%, 40%);">-| 0x44 | 9.4.64 | Get Attribute Response Info | | _ignored_</span><br><span style="color: hsl(120, 100%, 40%);">+| 0x44 | 9.4.64 | Get Attribute Response Info | -> | Sent, see <<NM_ATT_MANUF_ID>></span><br><span> | 0x45 | 9.4.65 | Outstanding Alarm Sequence | | _ignored_</span><br><span> | 0x46 | 9.4.66 | HW Conf Change Info | | _ignored_</span><br><span> | 0x47 | 9.4.32 | Measurement Result | | _ignored_</span><br><span>@@ -784,6 +805,87 @@</span><br><span> This attribute is not used by OsmoBTS, but</span><br><span> simply passed to OsmoPCU connected to the PCU socket.</span><br><span> </span><br><span style="color: hsl(120, 100%, 40%);">+[[NM_ATT_SW_CONFIG]]</span><br><span style="color: hsl(120, 100%, 40%);">+==== SW Configuration</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+The SW Configuration IE is compliant with 3GPP TS 52.021 9.4.61: it contains a</span><br><span style="color: hsl(120, 100%, 40%);">+number of SW Description IEs (9.4.62).</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+.Coding of SW Configuration IE</span><br><span style="color: hsl(120, 100%, 40%);">+[options="header",cols="20%,80%"]</span><br><span style="color: hsl(120, 100%, 40%);">+|===</span><br><span style="color: hsl(120, 100%, 40%);">+| octet | value</span><br><span style="color: hsl(120, 100%, 40%);">+| 1 | NM_ATT_SW_CONFIG IEI (0x41)</span><br><span style="color: hsl(120, 100%, 40%);">+| 2-3 | length of value part</span><br><span style="color: hsl(120, 100%, 40%);">+| 4 | NM_ATT_SW_DESCR IEI (0x42)</span><br><span style="color: hsl(120, 100%, 40%);">+| 5 | NM_ATT_FILE_ID IEI (0x12)</span><br><span style="color: hsl(120, 100%, 40%);">+| 6-7 | length of file name</span><br><span style="color: hsl(120, 100%, 40%);">+| 8-N | ASCII coded file name (without terminating nul)</span><br><span style="color: hsl(120, 100%, 40%);">+| N+1 | NM_ATT_FILE_VERSION IEI (0x13)</span><br><span style="color: hsl(120, 100%, 40%);">+| N+2 - N+3 | length of file content</span><br><span style="color: hsl(120, 100%, 40%);">+| N+4 - M | file content</span><br><span style="color: hsl(120, 100%, 40%);">+| M+1 | NM_ATT_SW_DESCR IEI (0x42)</span><br><span style="color: hsl(120, 100%, 40%);">+| M+2 | NM_ATT_FILE_ID IEI (0x12)</span><br><span style="color: hsl(120, 100%, 40%);">+2+| ...</span><br><span style="color: hsl(120, 100%, 40%);">+|===</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+.File names and content sent in the SW Configuration IE</span><br><span style="color: hsl(120, 100%, 40%);">+[options="header",cols="20%,80%"]</span><br><span style="color: hsl(120, 100%, 40%);">+|===</span><br><span style="color: hsl(120, 100%, 40%);">+| file name | content</span><br><span style="color: hsl(120, 100%, 40%);">+| 'osmobts' | ASCII coded OsmoBTS version number like "1.2.3" or "1.2.3.4-abcd"</span><br><span style="color: hsl(120, 100%, 40%);">+| 'BTS_TYPE_VARIANT' | one of "osmo-bts-lc15", "osmo-bts-oc2g", "osmo-bts-octphy",</span><br><span style="color: hsl(120, 100%, 40%);">+ "osmo-bts-omldummy", "osmo-bts-sysmo", "osmo-bts-trx", "osmo-bts-virtual"</span><br><span style="color: hsl(120, 100%, 40%);">+| 'BTS_SUB_MODEL' | This file may be omitted; if present, may contain an ASCII</span><br><span style="color: hsl(120, 100%, 40%);">+ coded model number like "sysmoBTS 1002"</span><br><span style="color: hsl(120, 100%, 40%);">+|===</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+[[NM_ATT_MANUF_ID]]</span><br><span style="color: hsl(120, 100%, 40%);">+==== Manufacturer Id</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+The coding of the Manufacturer Id attribute is a sequence of bit flags (a bit</span><br><span style="color: hsl(120, 100%, 40%);">+vector), where a zero flag indicates absence and a set flag indicates presence</span><br><span style="color: hsl(120, 100%, 40%);">+of a specific BTS feature.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+The number of flags transmitted depends on the software version of OsmoBTS and</span><br><span style="color: hsl(120, 100%, 40%);">+the BTS backend in use. More flags may be added in the future. The flag bits</span><br><span style="color: hsl(120, 100%, 40%);">+transmitted are followed by zero bits up to the next full octet boundary.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+These features are currently defined:</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+.coding of BTS feature flags sent in the Manufacturer Id attribute</span><br><span style="color: hsl(120, 100%, 40%);">+[options="header",cols="5%,5%,30%,60%"]</span><br><span style="color: hsl(120, 100%, 40%);">+|===</span><br><span style="color: hsl(120, 100%, 40%);">+| octet | bit | feature name | description</span><br><span style="color: hsl(120, 100%, 40%);">+.8+.| 0 | 7 | HSCSD | High-Speed Circuit-Switched Data</span><br><span style="color: hsl(120, 100%, 40%);">+ | 6 | GPRS | General Packet Radio Service</span><br><span style="color: hsl(120, 100%, 40%);">+ | 5 | EGPRS | Enhanced GPRS (EDGE)</span><br><span style="color: hsl(120, 100%, 40%);">+ | 4 | ECSD | Enhanced Circuit-Switched Data</span><br><span style="color: hsl(120, 100%, 40%);">+ | 3 | HOPPING | Frequency Hopping</span><br><span style="color: hsl(120, 100%, 40%);">+ | 2 | MULTI_TSC | Multi-TSC</span><br><span style="color: hsl(120, 100%, 40%);">+ | 1 | OML_ALERTS | OML Alerts</span><br><span style="color: hsl(120, 100%, 40%);">+ | 0 | AGCH_PCH_PROP | AGCH/PCH proportional allocation</span><br><span style="color: hsl(120, 100%, 40%);">+.8+.| 1 | 7 | CBCH | Cell Broadcast Channel</span><br><span style="color: hsl(120, 100%, 40%);">+ | 6 | SPEECH_F_V1 | Fullrate speech V1</span><br><span style="color: hsl(120, 100%, 40%);">+ | 5 | SPEECH_H_V1 | Halfrate speech V1</span><br><span style="color: hsl(120, 100%, 40%);">+ | 4 | SPEECH_F_EFR | Fullrate speech EFR</span><br><span style="color: hsl(120, 100%, 40%);">+ | 3 | SPEECH_F_AMR | Fullrate speech AMR</span><br><span style="color: hsl(120, 100%, 40%);">+ | 2 | SPEECH_H_AMR | Halfrate speech AMR</span><br><span style="color: hsl(120, 100%, 40%);">+ | 1 | ETWS_PN | ETWS Primary Notification via PCH</span><br><span style="color: hsl(120, 100%, 40%);">+ | 0 | PAGING_COORDINATION | BSS Paging Coordination</span><br><span style="color: hsl(120, 100%, 40%);">+.8+.| 2 | 7 | IPV6_NSVC | NSVC IPv6</span><br><span style="color: hsl(120, 100%, 40%);">+ | 6 | ACCH_REP | FACCH/SACCH Repetition</span><br><span style="color: hsl(120, 100%, 40%);">+ | 5 | CCN | Cell Change Notification</span><br><span style="color: hsl(120, 100%, 40%);">+ | 4 2.5+.| reserved for future use, sent as zero</span><br><span style="color: hsl(120, 100%, 40%);">+ | 3</span><br><span style="color: hsl(120, 100%, 40%);">+ | 2</span><br><span style="color: hsl(120, 100%, 40%);">+ | 1</span><br><span style="color: hsl(120, 100%, 40%);">+ | 0</span><br><span style="color: hsl(120, 100%, 40%);">+|===</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span> === A-bis OML Initialization / BTS bring-up</span><br><span> </span><br><span> At the time an Abis/IP BTS connects to via OML to the BSC, it is</span><br><span></span><br></pre><p>To view, visit <a href="https://gerrit.osmocom.org/c/osmo-bts/+/23847">change 23847</a>. To unsubscribe, or for help writing mail filters, visit <a href="https://gerrit.osmocom.org/settings">settings</a>.</p><div itemscope itemtype="http://schema.org/EmailMessage"><div itemscope itemprop="action" itemtype="http://schema.org/ViewAction"><link itemprop="url" href="https://gerrit.osmocom.org/c/osmo-bts/+/23847"/><meta itemprop="name" content="View Change"/></div></div>
<div style="display:none"> Gerrit-Project: osmo-bts </div>
<div style="display:none"> Gerrit-Branch: master </div>
<div style="display:none"> Gerrit-Change-Id: I99631272334537ab49ba8c530240aaeb67dde9d7 </div>
<div style="display:none"> Gerrit-Change-Number: 23847 </div>
<div style="display:none"> Gerrit-PatchSet: 2 </div>
<div style="display:none"> Gerrit-Owner: neels <nhofmeyr@sysmocom.de> </div>
<div style="display:none"> Gerrit-Reviewer: Jenkins Builder </div>
<div style="display:none"> Gerrit-Reviewer: fixeria <vyanitskiy@sysmocom.de> </div>
<div style="display:none"> Gerrit-Reviewer: laforge <laforge@osmocom.org> </div>
<div style="display:none"> Gerrit-Reviewer: neels <nhofmeyr@sysmocom.de> </div>
<div style="display:none"> Gerrit-Reviewer: pespin <pespin@sysmocom.de> </div>
<div style="display:none"> Gerrit-MessageType: merged </div>