-
Notifications
You must be signed in to change notification settings - Fork 0
/
draft-ietf-ccamp-dwdm-if-param-yang-06.xml
1624 lines (1356 loc) · 51.5 KB
/
draft-ietf-ccamp-dwdm-if-param-yang-06.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 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="exp" docName="draft-ietf-ccamp-dwdm-if-param-yang-06" 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-06"> 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>Cisco</organization>
<address>
<postal>
<street>Via Santa Maria Molgora, 48 c</street>
<city>20871 - Vimercate</city>
<country>Italy</country>
</postal>
<phone>+390392091462</phone>
<email>[email protected]</email>
</address>
</author>
<author fullname="Ruediger Kunze"
surname="R. Kunze">
<organization>Deutsche Telekom</organization>
<address>
<postal>
<street>Winterfeldtstr. 21-27</street>
<city>10781 Berlin</city>
<country>Germany</country>
</postal>
<phone>+491702275321</phone>
<email>[email protected]</email>
</address>
</author>
<author fullname="Andreas Burk"
surname="A. Burk">
<organization>Deutsche Telekom</organization>
<address>
<postal>
<street></street>
<city></city>
<country>Germany</country>
</postal>
<phone>+49</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>
<!-- month and day will be generated automatically by XML2RFC;
be sure the year is current.-->
<date month="July" year="2021" />
<!-- 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 by in phase of specification by)
ITU-T G.698.2 <xref target="ITU.G698.2"/> or any other ITU-T
recommendation.
More context about the state of the Coherent transceivers is
described in draft-many-coherent-DWDM-if-control. Use cases are described
in RFC7698.
</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 means 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 that translates and obsolete
the SNMP mib module
defined in draft-galikunze-ccamp-dwdm-if-snmp-mib 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.1 <xref target="ITU.G874.1"/> are not 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 draft-many-coherent-DWDM-if-control.
</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 they 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 selecting 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 and an OD (which are used
as a pair with the opposing element), one or more optical amplifiers
and may also include one or more OADMs. </preamble>
<artwork><![CDATA[
+-------------------------------------------------+
Ss | DWDM Network Elements | Rs
+--+ | | | \ / | | | +--+
Tx L1--|->| \ +------+ +------+ / |--|-->Rx L1
+---+ | | | | | +------+ | | | | | +--+
+---+ | | | | | | | | | | | | +--+
Tx L2--|->| OM |-->|------|->|ROADM |--|------|->| OD |--|-->Rx L2
+---+ | | | | | | | | | | | | +--+
+---+ | | | | | +------+ | | | | | +--+
Tx L3--|->| / | DWDM | | ^ | DWDM | \ |--|-->Rx L3
+---+ | | / | Link +----|--|----+ Link | \ | | +--+
+-----------+ | | +----------+
+--+ +--+
| |
Rs v | Ss
+-----+ +-----+
|RxLx | |TxLx |
+-----+ +-----+
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 Mux
]]></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-dwdm-if-mng-ctrl-fwk </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/if:interface:
+--rw optIfOChRsSs
+--rw if-current-mode
| +--ro mode-id? string
| +--ro (mode)
| +--:(G.698.2)
| | +--ro standard-mode? standard-mode
| +--:(organizational-mode)
| | +--ro organizational-mode
| | +--ro operational-mode?
| | | operational-mode
| | +--ro organization-identifier?
| | | organization-identifier
| | +--ro min-central-frequency?
| | | frequency-thz
| | +--ro max-central-frequency?
| | | frequency-thz
| | +--ro minimum-channel-spacing?
| | | frequency-ghz
| | +--ro tx-channel-power-min? dbm-t
| | +--ro tx-channel-power-max? dbm-t
| | +--ro rx-channel-power-min? dbm-t
| | +--ro rx-channel-power-max? dbm-t
| | +--ro rx-total-power-max?
| +--:(explicit-mode)
| +--ro explicit-mode
| +--ro supported-modes
| | +--ro supported-application-codes*
| | | -> ../../../mode-id
| | +--ro supported-organizational-modes*
| | | -> ../../../mode-id
| +--ro line-coding-bitrate?
| | identityref
| +--ro min-central-frequency?
| | layer0-types:frequency-thz
| +--ro max-central-frequency?
| | layer0-types:frequency-thz
| +--ro min-channel-input-power? dbm-t
| +--ro max-channel-input-power? dbm-t
| +--ro min-channel-output-power? dbm-t
| +--ro max-channel-output-power? dbm-t
| +--ro osnr-margin? int32
| +--ro q-margin? int32
| +--ro fec-info? string
| +--ro fec-bitrate? string
| +--ro fec-gain? string
| +--ro pre-fec-ber-mantissa-threshold? uint32
| +--ro pre-fec-ber-exponent-threshold? int32
| +--ro number-of-lanes? uint32
| +--ro min-laser-temperature? int32
| +--ro max-laser-temperature? int32
| +--ro max-total-rx-optical-power? dbm-t
| +--ro chromatic-and-polariz-disp-penal* []
| | +--ro chromatic-dispersion
| | | decimal64
| | +--ro polarization-mode-dispersion
| | | decimal64
| | +--ro penalty
| | decimal64
| +--ro max-chromatic-dispersion? int32
| +--ro max-diff-group-delay? int32
| +--ro max-polarization-dependent-loss?
| | decimal64
| +--ro modulation-format? string
| +--ro baud-rate? uint32
| +--ro bits-per-symbol? uint32
| +--ro num-symbols-in-alphabet? uint32
| +--ro symbols-index? uint32
+--ro if-supported-mode
| +--ro number-of-modes-supported? uint32
+--rw if-supported-modes*
| | +--ro mode-id? string
| +--ro (mode)
| +--:(G.698.2)
| | +--ro standard-mode? standard-mode
| +--:(organizational-mode)
| | +--ro organizational-mode
| | +--ro operational-mode?
| | | operational-mode
| | +--ro organization-identifier?
| | | organization-identifier
| | +--ro min-central-frequency?
| | | frequency-thz
| | +--ro max-central-frequency?
| | | frequency-thz
| | +--ro minimum-channel-spacing?
| | | frequency-ghz
| | +--ro tx-channel-power-min? dbm-t
| | +--ro tx-channel-power-max? dbm-t
| | +--ro rx-channel-power-min? dbm-t
| | +--ro rx-channel-power-max? dbm-t
| | +--ro rx-total-power-max?
| +--:(explicit-mode)
| +--ro explicit-mode
| +--ro supported-modes
| | +--ro supported-application-codes*
| | | -> ../../../mode-id
| | +--ro supported-organizational-modes*
| | | -> ../../../mode-id
| +--ro line-coding-bitrate?
| | | identityref
| +--ro min-central-frequency?
| | | layer0-types:frequency-thz
| +--ro max-central-frequency?
| | | layer0-types:frequency-thz
| +--ro min-channel-input-power? dbm-t
| +--ro max-channel-input-power? dbm-t
| +--ro min-channel-output-power? dbm-t
| +--ro max-channel-output-power? dbm-t
| +--ro osnr-margin? int32
| +--ro q-margin? int32
| +--ro fec-info? string
| +--ro fec-bitrate? string
| +--ro fec-gain? string
| +--ro pre-fec-ber-mantissa-threshold? uint32
| +--ro pre-fec-ber-exponent-threshold? int32
| +--ro number-of-lanes? uint32
| +--ro min-laser-temperature? int32
| +--ro max-laser-temperature? int32
| +--ro max-total-rx-optical-power? dbm-t
| +--ro chromatic-and-polariz-disp-penal* []
| | +--ro chromatic-dispersion
| | | decimal64
| | +--ro polarization-mode-dispersion
| | | decimal64
| | +--ro penalty
| | | decimal64
| +--ro max-chromatic-dispersion? int32
| +--ro max-diff-group-delay? int32
| +--ro max-polarization-dependent-loss?
| | decimal64
| +--ro modulation-format? string
| +--ro baud-rate? uint32
| +--ro bits-per-symbol? uint32
| +--ro num-symbols-in-alphabet? uint32
| +--ro symbols-index? uint32
+--rw provisioning-opt-if-och-mode-params
+--rw provisioning-opt-if-och-mode-params
+--rw mode-id? string
+--rw (mode)
+--rw central-frequency?
| layer0-types:frequency-thz
+--rw channel-output-power? dbm-t
+--ro channel-input-power? dbm-t
+--ro total-input-power? dbm-t
+--rw number-of-tcas-supported? uint32
+--rw mode-list* [tca-type]
| +--rw tca-type opt-if-och-tca-types
| +--rw min-threshold? int32
| +--rw max-threshold? int32
+--ro cur-osnr? int32
+--ro cur-q-factor? int32
+--ro uncorrected-words? uint64
+--ro pre-fec-ber-mantissa? uint32
+--ro pre-fec-ber-exponent? int32
+--ro cd-pmd-penalty
| layer0-types:cd-pmd-penalty
+--ro pdl-penalty
| layer0-types:pdl-penalty
+--ro diff-group-delay int32
+--rw explicit-mode-provisioning
+--rw fec string
+--rw pre-fec-ber-mantissa-threshold? uint32
+--rw pre-fec-ber-exponent-threshold? int32
+--rw number-of-lanes? uint32
+--rw modulation-format? string
+--rw baud-rate? uint32
+--rw bits-per-symbol? uint32
+--rw num-symbols-in-alphabet? uint32
+--rw symbols-index? uint32
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? layer0-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 {
namespace "urn:ietf:params:xml:ns:yang:ietf-ext-xponder-wdm-if";
prefix ietf-ext-xponder-wdm-if;
import ietf-interfaces {
prefix if;
}
import ietf-layer0-types {
prefix "layer0-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]>";
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 Simplified
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).";
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
"";
}
]]></artwork>
</figure>
<figure align='left'>
<artwork><![CDATA[
typedef dbm-t {
type int32;
units ".01dbm";
description "
Amplifiers and Transceivers Power in dBm";
}
typedef opt-if-och-tca-types {
type enumeration {
enum max-laser-linewdt {
description "The maximum laser linewidth";
}
enum min-tx-power-tca {
description "The min tx power TCA";
}
enum max-tx-power-tca {
description "The min tx power TCA";
}
enum min-rx-power-tca{
description "The min tx power TCA";
}
enum max-rx-power-tca{
description "The min tx power TCA";
}
enum max-pol-power-diff-tca{
description "The power difference between polarization
TCA";
}
enum max-pol-skew-diff-tca{
description "The skew between the two polarization TCA";
}
enum min-frequency-offset-tca{
description "Min Frequency offset TCA";
}
enum max-frequency-offset-tca{
description "Max Frequency offset TCA";
}
enum min-osnr-tca{
description "Min OSNR TCA";
}
enum max-osnr-tca{
description "Max OSNR TCA";
}
enum min-laser-temperature-tca{
description "The min tx power TCA";
}
enum max-laser-temperature-tca{
description "Temperature TCA";
}
enum min-fec-ber-tca{
description "Min Pre Fec BER TCA";
}
enum max-fec-ber-tca{
description "Max Pre Fec BER TCA";
}
enum min-q-tca{
description "Min Q TCA";
}
enum max-q-tca {
description "Max Q TCA";
}
}
description "The different types of TCA's";
}
grouping opt-if-och-power {
description "Interface optical Power";
leaf channel-output-power {
type dbm-t;
description "The output power for this interface in .01 dBm.
The setting of the output power is optional";
}
leaf channel-input-power {
type dbm-t;
config false;
description "The current channel input power of this
interface";
}
leaf total-input-power {
type dbm-t;
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";
}
}
grouping opt-if-och-fec {
description "FEC info";
leaf fec-info {
type string { length "1..255"; }
config false;
description "FEC Type - eg GFEC";
}
leaf fec-bitrate {
type string { length "1..255"; }
config false;
description "FEC Overhead rate ";
}
leaf fec-gain {
type string { length "1..255"; }
config false;
description "FEC Overhead rate ";
}
leaf pre-fec-ber-mantissa-threshold {
type uint32;
description "Mantissa of the FEC BER threshold";
}
leaf pre-fec-ber-exponent-threshold {
type int32;
description "Exponent of the FEC BER threshold";
}
}
grouping opt-if-och-central-frequency {
description "Interface Central Frequency";
leaf central-frequency {
type layer0-types:frequency-thz;
description "This parameter indicates the frequency of this
interface ";
}
}
grouping opt-if-och-modulation-params {
description "Optical modulation parameters for the lane";
leaf modulation-format {
type string { length "1..255"; }
config false;
description "Modulation format for this mode";
}
leaf baud-rate {
type uint32;
description "Baud-rate or symbol rate";
}
leaf bits-per-symbol {
type uint32;
description "This parameter the bits per symbol for this
mode";
}
leaf num-symbols-in-alphabet {
type uint32;
description "This parameter the bits per symbol for this
mode";
}
leaf symbols-index {
type uint32;
description "This parameter is the symbol index this mode";
}
}
grouping opt-if-och-lane-param {
description "Optical parameters for the lane";
leaf number-of-lanes {
type uint32;
config false;
description "Number of optical lanes of this interface";
}
leaf min-laser-temperature {
type int32;
units ".01C";
config false;
description "Minimum Laser Temperature of this mode for
this lane";
}
leaf max-laser-temperature {
type int32;
units ".01C";
config false;
description "Maximum Laser Temperature of this mode for
this lane";
}
leaf max-total-rx-optical-power {
type dbm-t;
config false;
description "Maximum rx optical power of this mode for this
lane";
}
leaf max-chromatic-dispersion {
type int32;
config false;
description "Maximum chromatic dispersion of this mode for
this lane";
}
leaf max-diff-group-delay {
type int32;
config false;
description "Maximum Differential group delay of this mode
for this lane";
}
uses opt-if-och-modulation-params;
}
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 mode-list {
key "tca-type";
description "List of the TCAs";
uses opt-if-och-tca-thresholds;
}
}
grouping opt-if-och-fec-tca-thresholds {
description "Pre FEC BER Thresholds for TCA's";
leaf min-fec-ber-mantissa-threshold {
type uint32;
description "Min Mantissa of the FEC BER threshold";
}
leaf min-fec-ber-exponent-threshold {
type int32;
description "Min Exponent of the FEC BER threshold";
}
leaf max-fec-ber-mantissa-threshold {
type uint32;
description "Max Mantissa of the FEC BER threshold";
}
leaf max-fec-ber-exponent-threshold {
type int32;
description "Max Exponent of the FEC BER threshold";
}
}
grouping opt-if-och-mode-params {
description "OCh mode parameters";
leaf mode-id {
type string { length "1..255"; }
description "ID for the OCh mode template";
}
leaf min-osnr-margin {
type int32;