1 module o-ran-transceiver {
3 namespace "urn:o-ran:transceiver:1.0";
4 prefix "o-ran-transceiver";
6 import o-ran-interfaces {
10 import ietf-interfaces {
14 organization "O-RAN Alliance";
20 "This module defines the operational state data for SFP transceivers used in
23 Copyright 2019 the O-RAN Alliance.
25 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 'AS IS'
26 AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
27 IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
28 ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
29 LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
30 CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
31 SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
32 INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
33 CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
34 ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
35 POSSIBILITY OF SUCH DAMAGE.
37 Redistribution and use in source and binary forms, with or without
38 modification, are permitted provided that the following conditions are met:
40 * Redistributions of source code must retain the above copyright notice,
41 this list of conditions and the above disclaimer.
42 * Redistributions in binary form must reproduce the above copyright notice,
43 this list of conditions and the above disclaimer in the documentation
44 and/or other materials provided with the distribution.
45 * Neither the Members of the O-RAN Alliance nor the names of its
46 contributors may be used to endorse or promote products derived from
47 this software without specific prior written permission.";
49 revision "2019-03-07" {
53 1) backward compatible changes to introduce groupings.";
55 reference "ORAN-WG4.M.0-v01.00";
58 revision "2019-02-04" {
62 1) imported model from xRAN
63 2) changed namespace and reference from xran to o-ran";
65 reference "ORAN-WG4.M.0-v01.00";
70 grouping transceiver-group {
71 list port-transceiver-data {
72 key "interface-name port-number";
73 description "data recovered from port transceivers";
76 path "/if:interfaces/if:interface/if:name";
78 description "Name of interface";
82 path "/if:interfaces/if:interface[if:name = current()/../interface-name]" + "/o-ran-int:port-reference/o-ran-int:port-number";
85 "A number which identifies a port. In case of SFP/SFP+
86 port, port number value is 0 to N-1 where N is number of ports
87 in the device. Numbers 0 to N-1 are assigned to ports in order
88 following order of labels on the device (labels for ports are
89 not necessarily numbers starting from zero)";
97 "A name that is unique across the O-RU that identifies a transceiver instance.
98 This name may be used in fault management to refer to a fault source
107 "Indicates if pluggable transceiver module is present.";
116 "Name of the transciever vendor Full name of transceiver vendor,
117 that contains ASCII characters, left-aligned with
118 any padding on the right with ASCII spaces (20h), or ASCII nul
119 (00h) removed, and ASCII less-than (3Ch) replaced with ASCII
120 open-brace (7Bh) and ASCII more-than (3Eh) replaced with ASCII
123 Optional node included when the NETCONF Server has determined
133 "Transceiver vendors part number, that contains ASCII characters,
134 left-aligned with any padding on the right with ASCII spaces
135 (20h), or ASCII nul (00h) removed, and ASCII less-than (3Ch)
136 replaced with ASCII open-brace (7Bh) and ASCII more-than (3Eh)
137 replaced with ASCII close-brace (7Dh).
139 Optional node included when the NETCONF Server has determined
140 the vendor part number.";
149 "Transceiver vendors revision number. 2-octet field that
150 contains ASCII characters.
152 Optional node included when the NETCONF Server has determined
153 the vendor revision number";
162 "Transceiver serial number encoded using ASCII characters,
163 left-aligned with any padding on the right with ASCII spaces
164 (20h), or ASCII nul (00h) removed, and ASCII less-than (3Ch)
165 replaced with ASCII open-brace (7Bh) and ASCII more-than (3Eh)
166 replaced with ASCII close-brace (7Dh).
168 Optional node included when the NETCONF Server has determined
172 leaf SFF8472-compliance-code {
174 enum diagnostics-undefined {
175 description "undefined compliance code";
177 enum rev9.3-diagnostics {
178 description "diagnostics published 08-01-02";
180 enum rev9.5-diagnostics{
181 description "diagnostics published 06-01-04";
183 enum rev10.2-diagnostics{
184 description "diagnostics published 06-01-07";
186 enum rev11.0-diagnostics{
187 description "diagnostics published 05-21-10";
189 enum rev11.3-diagnostics{
190 description "diagnostics published 06-11-13";
192 enum rev11.4-diagnostics{
193 description "diagnostics published 07-24-14";
195 enum rev12.0-diagnostics{
196 description "diagnostics published 08-28-14";
201 "Indication of which feature set(s) are
202 implemented in the transceiver from Byte 94 of address A0h
203 https://ta.snia.org/higherlogic/ws/public/download/294/SFF-8472.PDF
205 Optional node included when the NETCONF Server has determined
206 the compliance code.";
208 reference "https://ta.snia.org/higherlogic/ws/public/download/294/SFF-8472.PDF";
211 leaf connector-type {
214 description "encoded as 00h in Table 4-3 of SFF-8024";
216 enum subscrber-connector {
217 description "encoded as 01h in Table 4-3 of SFF-8024";
220 description "encoded as 06h in Table 4-3 of SFF-8024";
222 enum lucent-connector {
223 description "encoded as 07h in Table 4-3 of SFF-8024";
226 description "encoded as 08h in Table 4-3 of SFF-8024";
228 enum multiple-optical {
229 description "encoded as 09h in Table 4-3 of SFF-8024";
232 description "encoded as 0Ah in Table 4-3 of SFF-8024";
234 enum optical-pigtail {
235 description "encoded as 0Bh in Table 4-3 of SFF-8024";
237 enum multi-fiber-parralel-optic-1x12 {
238 description "encoded as 0Ch in Table 4-3 of SFF-8024";
240 enum multi-fiber-parralel-optic-2x16 {
241 description "encoded as 0Dh in Table 4-3 of SFF-8024";
244 description "encoded as 20h in Table 4-3 of SFF-8024";
247 description "encoded as 21h in Table 4-3 of SFF-8024";
250 description "encoded as 22h in Table 4-3 of SFF-8024";
252 enum no-separable-connector{
253 description "encoded as 23h in Table 4-3 of SFF-8024";
256 description "encoded as 24h in Table 4-3 of SFF-8024";
260 // TOCHECK: Remove any enumerations which are not applicable
262 "Connector-type indicates the external optical or electrical cable
263 connector provided as the media interface as defined in the connector
264 types derived from table 4-3 in SFF-8024.
266 Optional node included when the NETCONF Server has determined
267 the connector type.";
268 reference "https://ta.snia.org/higherlogic/ws/public/document?document_id=944";
271 leaf nominal-bitrate {
275 "Nominal bitrate in Mb/s (10^6 bits per second).
276 If needed actual value is rounded to nearest integer.
278 Optional node included when the NETCONF Server has determined
279 the nominal bit rate.";
282 leaf low-bitrate-margin {
286 "Minimum supported bitrate as percentage of nominal bitrate
287 below nominal bitrate.
289 Optional node included when the NETCONF Server has determined
290 the low bit rate margin";
293 leaf high-bitrate-margin {
297 "Maximum supported bitrate as percentage of nominal bitrate
298 above nominal bitrate.
300 Optional node included when the NETCONF Server has determined
301 the high bitrate margin.";
307 description "oma = optical modulation amplitude";
310 description "avp = average power";
315 "Receieved power measurement type
316 oma = optical modulation amplitude
319 Optional node included when the NETCONF Server has determined
329 "Measured RX input power in mW.
331 Optional node included when the NETCONF Server has determined
332 the measured RX power.";
341 "Measured coupled TX output power in mW.
343 Optional node included when the NETCONF Server has determined
344 the measured coupled TX power.";
347 leaf tx-bias-current {
353 "Measured transmitter laser bias current in mA.
355 Optional node included when the NETCONF Server has determined
356 the tx bias current.";
365 "Internally measured supply voltage in mV.
367 Optional node included when the NETCONF Server has determined
368 the internally measured voltage.";
377 "Internally measured module temperature in degrees Celcius.
379 Optional node included when the NETCONF Server has determined
385 // Top Level Container
387 container port-transceivers {
389 "Container for Port transceiver information.
390 Leaf nodes providing parameters status and diagnostic
391 information for pluggable transceiver module (like SFP,
394 uses transceiver-group;