1 module xran-transceiver {
3 namespace "urn:xran:transceiver:1.0";
4 prefix "xran-transceiver";
6 import xran-interfaces {
10 import ietf-interfaces {
14 organization "xRAN Forum";
20 "This module defines the operational state data for SFP transceivers used in
23 Copyright 2018 the xRAN Forum.
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 xRAN Forum 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 "2018-07-20" {
51 "version 1.0.0 - First release of the xRAN YANG M-Plane models.
53 This version of the model supports v01.00 of the corrsponding xRAN
54 M-Plane Specification.";
55 reference "XRAN-FH.MP.0-v01.00";
58 container port-transceivers {
60 "Container for Port transceiver information.
61 Leaf nodes providing parameters status and diagnostic
62 information for pluggable transceiver module (like SFP,
64 list port-transceiver-data {
65 key "interface-name port-number";
66 description "data recovered from port transceivers";
69 path "/if:interfaces/if:interface/if:name";
71 description "Name of interface";
75 //checkAL added prefix to interface-name
76 path "/if:interfaces/if:interface[if:name = current()/../xran-transceiver:interface-name]/xran-int:port-reference/xran-int:xran-port-number";
79 "A number which identifies a port. In case of SFP/SFP+
80 port, port number value is 0 to N-1 where N is number of ports
81 in the device. Numbers 0 to N-1 are assigned to ports in order
82 following order of labels on the device (labels for ports are
83 not necessarily numbers starting from zero)";
91 "A name that is unique across the RU that identifies a transceiver instance.
92 This name may be used in fault management to refer to a fault source
101 "Indicates if pluggable transceiver module is present.";
110 "Name of the transciever vendor Full name of transceiver vendor,
111 that contains ASCII characters, left-aligned with
112 any padding on the right with ASCII spaces (20h), or ASCII nul
113 (00h) removed, and ASCII less-than (3Ch) replaced with ASCII
114 open-brace (7Bh) and ASCII more-than (3Eh) replaced with ASCII
117 Optional node included when the NETCONF Server has determined
127 "Transceiver vendors part number, that contains ASCII characters,
128 left-aligned with any padding on the right with ASCII spaces
129 (20h), or ASCII nul (00h) removed, and ASCII less-than (3Ch)
130 replaced with ASCII open-brace (7Bh) and ASCII more-than (3Eh)
131 replaced with ASCII close-brace (7Dh).
133 Optional node included when the NETCONF Server has determined
134 the vendor part number.";
143 "Transceiver vendors revision number. 2-octet field that
144 contains ASCII characters.
146 Optional node included when the NETCONF Server has determined
147 the vendor revision number";
156 "Transceiver serial number encoded using ASCII characters,
157 left-aligned with any padding on the right with ASCII spaces
158 (20h), or ASCII nul (00h) removed, and ASCII less-than (3Ch)
159 replaced with ASCII open-brace (7Bh) and ASCII more-than (3Eh)
160 replaced with ASCII close-brace (7Dh).
162 Optional node included when the NETCONF Server has determined
166 leaf SFF8472-compliance-code {
168 enum diagnostics-undefined {
169 description "undefined compliance code";
171 enum rev9.3-diagnostics {
172 description "diagnostics published 08-01-02";
174 enum rev9.5-diagnostics{
175 description "diagnostics published 06-01-04";
177 enum rev10.2-diagnostics{
178 description "diagnostics published 06-01-07";
180 enum rev11.0-diagnostics{
181 description "diagnostics published 05-21-10";
183 enum rev11.3-diagnostics{
184 description "diagnostics published 06-11-13";
186 enum rev11.4-diagnostics{
187 description "diagnostics published 07-24-14";
189 enum rev12.0-diagnostics{
190 description "diagnostics published 08-28-14";
195 "Indication of which feature set(s) are
196 implemented in the transceiver from Byte 94 of address A0h
197 https://ta.snia.org/higherlogic/ws/public/download/294/SFF-8472.PDF";
199 // FIXME is this optional or mandatory?
200 reference "https://ta.snia.org/higherlogic/ws/public/download/294/SFF-8472.PDF";
203 leaf connector-type {
206 description "encoded as 00h in Table 4-3 of SFF-8024";
208 enum subscrber-connector {
209 description "encoded as 01h in Table 4-3 of SFF-8024";
212 description "encoded as 06h in Table 4-3 of SFF-8024";
214 enum lucent-connector {
215 description "encoded as 07h in Table 4-3 of SFF-8024";
218 description "encoded as 08h in Table 4-3 of SFF-8024";
220 enum multiple-optical {
221 description "encoded as 09h in Table 4-3 of SFF-8024";
224 description "encoded as 0Ah in Table 4-3 of SFF-8024";
226 enum optical-pigtail {
227 description "encoded as 0Bh in Table 4-3 of SFF-8024";
229 enum multi-fiber-parralel-optic-1x12 {
230 description "encoded as 0Ch in Table 4-3 of SFF-8024";
232 enum multi-fiber-parralel-optic-2x16 {
233 description "encoded as 0Dh in Table 4-3 of SFF-8024";
236 description "encoded as 20h in Table 4-3 of SFF-8024";
239 description "encoded as 21h in Table 4-3 of SFF-8024";
242 description "encoded as 22h in Table 4-3 of SFF-8024";
244 enum no-separable-connector{
245 description "encoded as 23h in Table 4-3 of SFF-8024";
248 description "encoded as 24h in Table 4-3 of SFF-8024";
252 // TOCHECK: Remove any enumerations which are not applicable
254 "Connector-type indicates the external optical or electrical cable
255 connector provided as the media interface as defined in the connector
256 types derived from table 4-3 in SFF-8024.";
257 // FIXME is this optional or mandatory?
258 reference "https://ta.snia.org/higherlogic/ws/public/document?document_id=944";
261 leaf nominal-bitrate {
265 "Nominal bitrate in Mb/s (10^6 bits per second).
266 If needed actual value is rounded to nearest integer.
268 Optional node included when the NETCONF Server has determined
269 the nominal bit rate.";
272 leaf low-bitrate-margin {
276 "Minimum supported bitrate as percentage of nominal bitrate
277 below nominal bitrate.
279 Optional node included when the NETCONF Server has determined
280 the low bit rate margin";
283 leaf high-bitrate-margin {
287 "Maximum supported bitrate as percentage of nominal bitrate
288 above nominal bitrate.
290 Optional node included when the NETCONF Server has determined
291 the high bitrate margin.";
297 description "oma = optical modulation amplitude";
300 description "avp = average power";
305 "Receieved power measurement type
306 oma = optical modulation amplitude
307 avp = average power";
308 // FIXME is this optional or mandatory?
317 "Measured RX input power in mW.
319 Optional node included when the NETCONF Server has determined
320 the measured RX power.";
329 "Measured coupled TX output power in mW.
331 Optional node included when the NETCONF Server has determined
332 the measured coupled TX power.";
335 leaf tx-bias-current {
341 "Measured transmitter laser bias current in mA.
343 Optional node included when the NETCONF Server has determined
344 the tx bias current.";
353 "Internally measured supply voltage in mV.
355 Optional node included when the NETCONF Server has determined
356 the internally measured voltage.";
365 "Internally measured module temperature in degrees Celcius.";
366 // FIXME is this optional or mandatory?