-
Notifications
You must be signed in to change notification settings - Fork 0
/
draft-ietf-ccamp-dwdm-if-param-yang-11.xml
1471 lines (1203 loc) · 46.2 KB
/
draft-ietf-ccamp-dwdm-if-param-yang-11.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
<?xml version="1.0" encoding="US-ASCII"?>
<!-- this is version 0 of this xml2rfc template, and was used to generate the text templates found in draft-harrington-text-mib-doc-template-04.txt -->
<!--
DOCTYPE processing
To use this XML template, the rfc2629.dtd from the xml2rfc distribution should
be in the local directory. The xml2rfc distribution is available from
http://xml.resource.org/
The ENTITY clauses create an include of the named XML files, which
contains references written in xml2rfc format.
XML2RFC offers an include feature described in the XML2RFC README
file. That syntax, however, contradicts the DTD requirements to
have <reference> elements within the <references> element, so an
XML parser is likely to find your XML file invalid. It may be
possible that XML2RFC will change their DTD so that the XML file
remains valid when their style of include is used.
Some editors, such as XXE, resolve the ENTITY clauses before displaying the
document to be edited.
-->
<!DOCTYPE rfc SYSTEM "rfc2629.dtd" [
<!ENTITY rfc2863 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.2863.xml">
<!ENTITY rfc2119 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.2119.xml">
<!ENTITY rfc2578 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.2578.xml">
<!ENTITY rfc2579 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.2579.xml">
<!ENTITY rfc2580 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.2580.xml">
<!ENTITY rfc2629 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.2629.xml">
<!ENTITY rfc7991 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.7991.xml">
<!ENTITY rfc3410 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.3410.xml">
<!ENTITY rfc4181 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.4181.xml">
<!ENTITY rfc3591 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.3591.xml">
<!ENTITY rfc6205 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.6205.xml">
<!ENTITY rfc4054 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.4054.xml">
]>
<?rfc toc="yes"?>
<?rfc symrefs="yes"?>
<?rfc compact="yes"?>
<?rfc subcompact="no"?>
<?rfc strict="no"?>
<?rfc rfcedstyle="no"?>
<?rfc comments="no"?>
<?rfc inline="yes"?>
<!-- Document section
Specify the category attribute per RFC2026
options are info, std, bcp, or exp.
docname is the name of the output document. This is optional;
the default is to use the base portion of the XML file name.
For Internet-drafts, indicate which intellectual property notice
to use per the rules of RFC3978. The value (as of this template) can be:
full3978 -
noModification3978 -
noDerivatives3978 -
The Intellectual Property section will be generated automatically by
XML2RFC, based on the ipr attribute in the rfc element.
If this document obsoletes an RFC, specify the RFC in the "obsoletes" attribute
If this document updates an RFC, specify the RFC in the "updates" attribute
-->
<rfc category="std" docName="draft-ietf-ccamp-dwdm-if-param-yang-11" ipr="trust200902">
<front>
<!--
Enter the full document title and an abbreviated version
to use in the page header.
-->
<title abbrev="draft-ietf-ccamp-dwdm-if-param-yang-11"> A YANG model to manage
the optical interface parameters for an external transponder in a WDM network
</title>
<!-- copy the author block as many times as needed, one for each author.-->
<!-- If the author is acting as editor, use the <role=editor> attribute-->
<!-- see RFC2223 for guidelines regarding author names -->
<author fullname="Gabriele Galimberti" role="editor"
surname="G. Galimberti">
<organization>C</organization>
<address>
<postal>
<street>Via Melgacciata 13 c</street>
<city>20813 - Bovisio Masciago</city>
<country>Italy</country>
</postal>
<phone>+393357481947</phone>
<email>[email protected]</email>
</address>
</author>
<author fullname="Dharini Hiremagalur" role="editor"
surname="D. Hiremagalur">
<organization>Juniper</organization>
<address>
<postal>
<street> 1133 Innovation Way</street>
<city>Sunnyvale - 94089 California</city>
<country>USA</country>
</postal>
<phone></phone>
<email>[email protected]</email>
</address>
</author>
<author fullname="Gert Grammel" initials="G" role="editor"
surname="Grammel">
<organization>Juniper</organization>
<address>
<postal>
<street> Oskar-Schlemmer Str. 15</street>
<city>80807 Muenchen</city>
<country>Germany</country>
</postal>
<phone>+49 1725186386</phone>
<email>[email protected]</email>
</address>
</author>
<author fullname="Roberto Manzotti" initials="R" role="editor"
surname="Manzotti">
<organization>Cisco</organization>
<address>
<postal>
<street> Santa Maria Molgora 48 C</street>
<city>20871 Vimercate</city>
<country>Italy</country>
</postal>
<phone>+390392091280</phone>
<email>[email protected]</email>
</address>
</author>
<author fullname="Dirk Breuer" initials="D" role="editor"
surname="Breuer">
<organization>DEUTSCHE TELEKOM AG</organization>
<address>
<postal>
<street> Winterfeldtstr 21</street>
<city>10781 Berlin</city>
<country>Germany</country>
</postal>
<phone>+4930835358828</phone>
<email>[email protected]</email>
</address>
</author>
<!-- month and day will be generated automatically by XML2RFC;
be sure the year is current.-->
<date day="3" month="July" year="2024" />
<!-- IETF area is optional -->
<area>Operations & Management Area</area>
<!--WG name at the upper left corner of the doc,
IETF is fine for non-WG IETF submissions -->
<workgroup>Internet Engineering Task Force</workgroup>
<keyword>Network Management</keyword>
<keyword>External transponder in a WDM network Yang model</keyword>
<keyword>Yang</keyword>
<!--add additional keywords here for IETF website search engine -->
<abstract>
<t>
This memo defines a Yang model related to the Optical Transceiver
parameters characterising coherent 100G and above interfaces.
100G and above Transceivers support coherent modulation, multiple
modulation formats, multiple FEC codes including some not yet specified
(or in phase of specification by) ITU-T G.698.2 or any other ITU-T
recommendation. Use cases are described in RFC7698. Is to be noted
that the Transceivers can be located on the Transponders (optical
layer) or on the Router (in general packet layer) in form of Pluggable
modules.
</t>
<t> The Yang model defined in this memo can be used for Optical Parameters
monitoring and/or configuration of the endpoints of a multi-vendor
IaDI optical link.
The use of this model does not guarantee interworking of transceivers
over a DWDM. Optical path feasibility and interoperability has to be
determined by tools and algorithms outside the scope of this document.
The purpose of this model is to program interface parameters to
consistently configure the mode of operation of transceivers.
</t>
</abstract>
<note title="Copyright Notice">
<t> Copyright (c) 2014 IETF Trust and the persons identified as the
document authors. All rights reserved.
</t>
</note>
</front>
<middle>
<section title="Introduction">
<!--You can echo the abstract in the Introduction, providing citations here,
but you should provide more than just the abstract. -->
<t>This memo defines a Yang model for managing single
channel optical interface parameters of DWDM applications, using the
approach specified in G.698.2.
This model supports parameters to characterize coherent transceivers
found in current implementations to specify the mode of operation.
As application identifiers like those specified in
ITU-T G.874 <xref target="ITU.G874"/> ITU-T G.698.2 <xref target="ITU.G698.2"/>
may not be available we use mode templates instead.
A mode template describes transceiver characteristics in
detail and can be identified by a mode-id.
</t>
<t>This draft refers and supports the RFC7698 and is alignet to the
definition of RFC9093 and its extension FRC9093-bis.
Finally the models described in this draft are compliant with the
models described in draft-ietf-ccamp-optical-impairment-topology-yang
and draft-ietf-ccamp-flexigrid-tunnel-yang.
</t>
<t>The YANG model describing and extending the optical
parameters allows different vendors and operators to retrieve, provision
and exchange information across the multi-vendor IaDI interfaces in
an abstract manner.
</t>
<t>The concept introduced by this YANG model is the notion of a mode.
A mode is a combination of parameters or parameter ranges that is supported
by a transceiver. As an example, operating a device in QPSK mode may use
a different FEC and requires less OSNR to reach the FEC limit than the same
transceiver operating in QAM16 mode. Given the number of parameters and
their possible combinations it is important for vendors to be able to
qualify a set of combinations which is the basis to define a mode.
The YANG model furthermore provides means to select one mode as
current-mode from that pre-defined list of modes supported by the
transceiver module.
Once selected, current-opt-if-och-mode-params provide the means to configure
specific parameters at run time and retrieve actual parameters from the
module. For example, the frequency is a parameter that can be set within
min/max boundaries set by the current mode. Laser Temperature however
is a ro parameter available at run-time that can be checked against the
mode boundaries and may trigger an event.
</t>
</section>
<section title="The Internet-Standard Management Framework">
<t><cref>The title and text for this section has been copied from the
official boilerplate, and should not be modified unless the boilerplate text
at http;//ops.ietf.org/mib-boilerplate.html has changed. See RFC4818
section 3.1 for a discussion of the boilerplate section.</cref></t>
<t>For a detailed overview of the documents that describe the current
Internet-Standard Management Framework, please refer to section 7 of RFC
3410 <xref target="RFC3410"></xref>.</t>
<t> This memo specifies a Yang model for optical interfaces. </t>
</section>
<section title="Conventions">
<t><cref>TEMPLATE TODO This boilerplate should be used if the
RFC2119 key words are used in the internet draft. The text in
this section has been copied from the official boilerplate, and
should not be modified. </cref></t>
<t>The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL
NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and
"OPTIONAL" in this document are to be interpreted as described
in RFC 2119 <xref target="RFC2119"></xref> In the description of
OIDs the convention: Set (S) Get (G) and Trap (T) conventions
will describe the action allowed by the parameter.</t>
</section>
<!-- ********************************************* -->
<section title="Overview">
<t><cref>TEMPLATE TODO The narrative part should include an
overview section that describes the scope and field of application
of the MIB modules defined by the specification. See RFC4181
section 3.2 for a discussion of the Narrative section. </cref></t>
<figure anchor="my_figure" title="External transponder in WDM netwoks">
<preamble> <xref target="my_figure"/> shows a set of reference points, for
single-channel connection between transmitters (Tx) and receivers (Rx).
Here the DWDM network elements include an OM (Optical Multiplexer)
and an OD (Optical Demultiplexer) which are used
as a pair with the opposing element, one or more optical amplifiers
and may also include one or more ROADMs.
Is to be noted that the TX L1 and RX L1 may be located outside the
DWDM network and fitted in the packet layer network elements as
pluggable modules.</preamble>
<artwork><![CDATA[
Ss +-------------------------------------------------+ Rs
| | DWDM Network Elements | |
+---+ | | | \ / | | | +---+
Tx L1---|->| \ +------+ +------+ / |--|-->Rx L1
+---+ | | | | | +------+ | | | | | +---+
+---+ | | | | | | | | | | | | +---+
Tx L2---|->| OM |-->|------|->|ROADM |--|------|->| OD |--|-->Rx L2
+---+ | | | | | | | | | | | | +---+
+---+ | | | | | +------+ | | | | | +---+
Tx L3---|->| / | DWDM | | ^ | DWDM | \ |--|-->Rx L4
+---+ | | / | Link +----|--|----+ Link | \ | | +---+
+-----------+ | | +----------+
+----+ +----+
| |
Rs v | Ss
+-----+ +-----+
|RxL3 | |TxL4 |
+-----+ +-----+
Ss = reference point at the DWDM network element tributary output
Rs = reference point at the DWDM network element tributary input
Lx = Lambda x
OM = Optical Mux
OD = Optical Demux
ROADM = Reconfigurable Optical Add Drop Multiplexer
]]></artwork>
<postamble> from Fig. 5.1/G.698.2 </postamble>
</figure>
<section title="Optical Parameters Description">
<t>The link between the external transponders through a WDM network media
channels are managed at the edges, i.e. at the transmitters (Tx) and
receivers (Rx) attached to the S and R reference points respectively.
</t>
<t>Definitions of the optical parameters are provided below to
increase the readability of the document.</t>
<section title="Parameters at Ss ">
<t>
<list style='hanging'>
<t hangText="output-power:"> <vspace blankLines="0" />
The mean launched power at Ss is the average power (in dBm) of a
pseudo-random data sequence coupled into the DWDM link.</t>
<t hangText="central frequency:"> <vspace blankLines="0" />
This parameter indicates the Central frequency value that Ss and Rs will be
set to work (in THz)</t>
</list>
</t>
</section>
<section title="Interface at point Rs ">
<t>
<list style='hanging'>
<t hangText="input-power:"> <vspace blankLines="0" />
The average received power (in dBm) at point Rs.</t>
<t hangText="Curr-OSNR:"> <vspace blankLines="0" />
Current Optical Signal to Noise Ratio (OSNR) estimated at Rx Transceiver port. </t>
<t hangText="Curr-q-factor:"> <vspace blankLines="0" />
"Q" factor estimated at Rx Transceiver port. </t>
</list>
</t>
</section>
</section>
<section title="Use Cases">
<!--You can echo the abstract in the Introduction, providing citations here,
but you should provide more than just the abstract. -->
<t>
The use cases are described in
draft-ietf-ccamp-optical-impairment-topology-yang (Section 2.5),
draft-ietf-teas-actn-poi-applicability and draft-poidt-ccamp-actn-poi-pluggable.
</t>
</section>
<section title="Optical Interface for external transponder in a WDM network">
<t>
The ietf-ext-xponder-wdm-if is an augment to the ietf-interface. It
allows the user to set the operating mode of transceivers as well as other
operational parameters.
The module provides also treshold settings and notifications to supervise
measured parameters and notify the client.
</t>
<figure align='left'>
<artwork><![CDATA[
module: ietf-ext-xponder-wdm-if
augment /if:interfaces:
+--rw optIf-templates
+--rw explicit-transceiver-modes
+--rw explicit-transceiver-mode*
[explicit-transceiver-mode-id]
+--rw explicit-transceiver-mode-id string
+--ro line-coding-bitrate? identityref
+--ro bitrate? uint16
+--ro max-diff-group-delay? decimal-2
+--ro max-chromatic-dispersion? decimal-2
+--ro cd-penalty* [cd-value]
| +--ro cd-value decimal-2
| +--ro penalty-value union
+--ro max-polarization-mode-dispersion? decimal-2
+--ro pmd-penalty* [pmd-value]
| +--ro pmd-value decimal-2
| +--ro penalty-value union
+--ro max-polarization-dependent-loss
| power-loss-or-null
+--ro pdl-penalty* [pdl-value]
| +--ro pdl-value power-loss
| +--ro penalty-value union
+--ro available-modulation-type? identityref
+--ro min-OSNR? snr
+--ro rx-ref-channel-power? power-dbm
+--ro rx-channel-power-penalty* [rx-channel-power-value]
| +--ro rx-channel-power-value power-dbm
| +--ro penalty-value union
+--ro min-Q-factor? decimal-2
+--ro available-baud-rate? decimal64
+--ro roll-off? decimal64
+--ro min-carrier-spacing? frequency-ghz
+--ro available-fec-type? identityref
+--ro fec-code-rate? decimal64
+--ro fec-threshold? decimal64
+--ro in-band-osnr? snr
+--ro out-of-band-osnr? snr
+--ro tx-polarization-power-difference? power-ratio
+--ro polarization-skew? decimal-2
augment /if:interfaces/if:interface:
+--rw optIfOChRsSs
+--rw supported-modes!
| +--ro supported-mode* [mode-id]
| +--ro mode-id string
| +--ro (mode)
| +--:(G.698.2)
| | +--ro standard-mode? standard-mode
| | +--ro line-coding-bitrate* identityref
| | +--ro min-central-frequency? frequency-thz
| | +--ro max-central-frequency? frequency-thz
| | +--ro transceiver-tunability? frequency-ghz
| | +--ro tx-channel-power-min? power-dbm
| | +--ro tx-channel-power-max? power-dbm
| | +--ro rx-channel-power-min? power-dbm
| | +--ro rx-channel-power-max? power-dbm
| | +--ro rx-total-power-max? power-dbm
| +--:(organizational-mode)
| | +--ro organizational-mode
| | +--ro operational-mode?
| | | operational-mode
| | +--ro organization-identifier?
| | | organization-identifier
| | +--ro line-coding-bitrate* identityref
| | +--ro min-central-frequency? frequency-thz
| | +--ro max-central-frequency? frequency-thz
| | +--ro transceiver-tunability? frequency-ghz
| | +--ro tx-channel-power-min? power-dbm
| | +--ro tx-channel-power-max? power-dbm
| | +--ro rx-channel-power-min? power-dbm
| | +--ro rx-channel-power-max? power-dbm
| | +--ro rx-total-power-max? power-dbm
| +--:(explicit-mode)
| +--ro explicit-mode
| +--ro min-central-frequency?
| | frequency-thz
| +--ro max-central-frequency?
| | frequency-thz
| +--ro transceiver-tunability?
| | frequency-ghz
| +--ro tx-channel-power-min?
| | power-dbm
| +--ro tx-channel-power-max?
| | power-dbm
| +--ro rx-channel-power-min?
| | power-dbm
| +--ro rx-channel-power-max?
| | power-dbm
| +--ro rx-total-power-max?
| | power-dbm
| +--ro compatible-modes
| | +--ro supported-application-codes*
| | | -> ../../../../supported-mode/mode-id
| | +--ro supported-organizational-modes*
| | -> ../../../../supported-mode/mode-id
| +--ro explicit-transceiver-mode-ref? leafref
+--rw current-opt-if-och-mode-params
+--rw configured-mode? union
+--rw line-coding-bitrate? identityref
+--rw tx-channel-power? power-dbm-or-null
+--ro rx-channel-power? power-dbm-or-null
+--ro rx-total-power? power-dbm-or-null
+--ro min-osnr-margin? l0-types:snr-or-null
+--ro q-margin? int32
+--rw central-frequency? l0-types:frequency-thz
+--rw number-of-tcas-supported? uint32
+--rw tca-list* [tca-type]
| +--rw tca-type opt-if-och-tca-types
| +--rw min-threshold? int32
| +--rw max-threshold? int32
| +--rw threshold-hysteresis? int32
+--ro cur-osnr? l0-types:snr
+--ro cur-q-factor? int32
+--ro uncorrected-words? uint64
+--ro pre-fec-ber? decimal64
notifications:
+---n opt-if-och-central-frequency-change
| +--ro if-name?
| | -> /if:interfaces/interface/name
| +--ro new-opt-if-och-central-frequency
| +--ro central-frequency? l0-types:frequency-thz
+---n opt-if-och-mode-change
| +--ro if-name? -> /if:interfaces/interface/name
| +--ro mode-id? string
+---n opt-if-och-min-tca
+--ro if-name? -> /if:interfaces/interface/name
+--ro tca-type? opt-if-och-tca-types
]]></artwork>
</figure>
</section>
</section>
<section title="Structure of the Yang Module">
<t>ietf-ext-xponder-wdm-if is a top level model for the support
of this feature.
</t>
</section>
<section title="Yang Module">
<t>The ietf-ext-xponder-wdm-if is defined as an extension to
ietf interfaces.
</t>
<figure align='left'>
<artwork><![CDATA[
<CODE BEGINS> file "ietf-ext-xponder-wdm-if.yang"
module ietf-ext-xponder-wdm-if {
yang-version 1.1;
namespace "urn:ietf:params:xml:ns:yang:ietf-ext-xponder-wdm-if";
prefix wdm-if;
import ietf-interfaces {
prefix if;
}
import ietf-layer0-types {
prefix "l0-types";
}
organization
"IETF CCAMP Working Group";
contact
"WG Web: <http://tools.ietf.org/wg/ccamp/>
WG List: <mailto:[email protected]>
Editor: Dharini Hiremagalur
<mailto:[email protected]>
Editor: Gabriele Galimberti
<mailto: [email protected]>
Editor: Gert Grammel
<mailto:[email protected]>
Editor: Roberto Manzotti
<mailto:[email protected]>";
description
"This module contains a collection of YANG definitions for
configuring Optical interfaces.
Copyright (c) 2016 IETF Trust and the persons identified
as authors of the code. All rights reserved.
Redistribution and use in source and binary forms, with or
without modification, is permitted pursuant to, and
subject to the license terms contained in, the Revised
BSD License set forth in Section 4.c of the IETF Trust's
Legal Provisions Relating to IETF Documents
(http://trustee.ietf.org/license-info).
This version of this YANG module is part of RFC XXXX
(https://www.rfc-editor.org/info/rfcXXXX); see the RFC itself
for full legal notices.";
revision "2024-07-03" {
description
"Revision 1.11";
reference
"This version of this YANG module is part of RFC XXXX
(https://www.rfc-editor.org/info/rfcXXXX); see the RFC itself
for full legal notices.";
}
revision "2023-10-23" {
description
"Revision 1.10";
reference
"";
}
revision "2023-03-13" {
description
"Revision 1.9";
reference
"";
}
revision "2022-10-24" {
description
"Revision 1.8";
reference
"";
}
revision "2022-01-10" {
description
"Revision 1.7";
reference
"";
}
revision "2021-06-28" {
description
"Revision 1.6";
reference
"";
}
revision "2020-03-09" {
description
"Revision 1.5";
reference
"";
}
revision "2019-11-04" {
description
"Revision 1.4";
reference
"";
}
revision "2019-07-08" {
description
"Revision 1.3";
reference
"";
}
revision "2018-10-22" {
description
"Revision 1.2";
reference
"";
}
revision "2018-03-06" {
description
"Revision 1.1";
reference
"";
}
revision "2017-03-06" {
description
"Revision 1.0";
reference
"";
}
revision "2016-03-17" {
description
"Initial revision.";
reference
"";
}
<CODE ENDS>
]]></artwork>
</figure>
<figure align='left'>
<artwork><![CDATA[
<CODE BEGINS>
typedef opt-if-och-tca-types {
type enumeration {
enum laser-linewdt {
description "The laser linewidth";
}
enum tx-power-tca {
description "The tx power TCA";
}
enum rx-power-tca {
description "The tx power TCA";
}
enum pol-power-diff-tca {
description "The power difference between polarization
TCA";
}
enum pol-skew-diff-tca {
description "The skew between the two polarization TCA";
}
enum cd-tca {
description "The chromatic dispersion TCA";
}
enum frequency-offset-tca {
description "Frequency offset TCA";
}
enum osnr-tca {
description "OSNR TCA";
}
enum laser-temperature-tca {
description "Laser temperature TCA";
}
enum pre-fec-ber-tca {
description "Pre Fec BER TCA";
}
enum uncorrected-words-tca {
description "Uncorrected words TCA";
}
enum q-factor-tca{
description "Q Factor TCA";
}
}
description "The different types of TCA's";
}
grouping opt-if-och-power {
description "Interface optical Power";
leaf channel-output-power {
type l0-types:power-dbm-or-null;
description "The output power for this interface in dBm.
The setting of the output power is optional";
}
leaf channel-input-power {
type l0-types:power-dbm-or-null;
config false;
description "The current channel input power of this
interface";
}
leaf total-input-power {
type l0-types:power-dbm-or-null;
config false;
description "The total input power of this interface";
}
}
grouping opt-if-och-tca-thresholds {
description "Thresholds for TCA's";
leaf tca-type {
type opt-if-och-tca-types;
description "type of the TCA eg TX Power";
}
leaf min-threshold {
type int32;
description "A TCA is generated if the variable is less than
this value";
}
leaf max-threshold {
type int32;
description "A TCA is generated if the variable is more than
this value";
}
leaf threshold-hysteresis {
type int32;
description "The TCA raise/clear hysteresisis around the
threshold value to avoi alert flikering";
}
}
grouping opt-if-och-central-frequency {
description "Interface Central Frequency";
leaf central-frequency {
type l0-types:frequency-thz;
description "This parameter indicates the frequency of this
interface ";
}
}
grouping opt-if-och-tca-list {
description "List of TCA's";
leaf number-of-tcas-supported {
type uint32;
description "Number of TCAs supported by this interface";
}
list tca-list {
key "tca-type";
description "List of the TCAs";
uses opt-if-och-tca-thresholds;
}
}
grouping opt-if-och-mode-params {
description "OCh mode parameters";
leaf min-osnr-margin {
type l0-types:snr-or-null;
units "dB";
config false;
description "OSNR margin to FEC threshold";
}
leaf q-margin {
type int32;
units "dB";
config false;
description "Q-Factor margin to FEC threshold";
}
uses opt-if-och-central-frequency;
// uses opt-if-och-fec-tca-thresholds;
uses opt-if-och-tca-list;
}
grouping opt-if-och-statistics {
description "OCh statistics";
leaf cur-osnr {
type l0-types:snr;
units "dB";
config false;
description "OSNR margin to FEC threshold";
}
leaf cur-q-factor {
type int32;
units "dB";
config false;
description "Q-Factor of the interface";
}
leaf uncorrected-words {
type uint64;
config false;
description "Post-FEC errored words";
}
leaf pre-fec-ber {
type decimal64 {
fraction-digits 18;
}
config false;
description "Pre-FEC errored words";
}
}
notification opt-if-och-central-frequency-change {
description "A change of Central Frequency has been detected";
leaf "if-name" {
type leafref { path "/if:interfaces/if:interface/if:name"; }
description "Interface name";
}
container new-opt-if-och-central-frequency {
description "The new Central Frequency of the interface";
uses opt-if-och-central-frequency;
}
}
notification opt-if-och-mode-change {
description "A change of Mode Template has been detected";
leaf "if-name" {
type leafref { path "/if:interfaces/if:interface/if:name"; }
description "Interface name";
}
leaf mode-id {
type string { length "1..255"; }
description "ID for the OCh mode template";
}
}
notification opt-if-och-min-tca {
description "A min output TCA notification";
leaf "if-name" {
type leafref { path "/if:interfaces/if:interface/if:name"; }
description "Interface name";
}
leaf tca-type {
type opt-if-och-tca-types;
description "Type of TCA for eg min tx power TCA";
}
}
augment "/if:interfaces" {
description
"Template definition for Optical Interface explicit-modes";
container "optIf-templates" {
description "Optical Interface explicit-mode templates";
container explicit-transceiver-modes {
description
"The top level container for the list of the
transceivers' explicit modes.";
list explicit-transceiver-mode {
key explicit-transceiver-mode-id;
description
"The list of the transceivers' explicit modes.";
leaf explicit-transceiver-mode-id {
type string;
description
"The identifier of the transceivers' explicit mode.";
}
uses l0-types:explicit-mode;
} // list explicit-transceiver-mode
} // container explicit-transceiver-modes
}
}
augment "/if:interfaces/if:interface" {
description "Parameters for an optical interface";
container optIfOChRsSs {
description "RsSs path configuration for an interface";
uses l0-types:transceiver-capabilities {
augment "supported-modes/supported-mode/mode/"
+ "explicit-mode/explicit-mode" {
description
"Augment the explicit-mode container with the
proper leafref.";
leaf explicit-transceiver-mode-ref {
type leafref {
path "../../../../../../wdm-if:optIf-templates"
+ "/wdm-if:explicit-transceiver-modes"
+ "/wdm-if:explicit-transceiver-mode"
+ "/wdm-if:explicit-transceiver-mode-id";
}
description
"The refernce to the explicit transceiver
mode template.";
}
}
}
container current-opt-if-och-mode-params {
leaf configured-mode {
type union {
type empty;
type leafref {
path "../../supported-modes/supported-mode/mode-id";
}
}
description
"Reference to the configured mode for transceiver
compatibility approach.