Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

YANG Doctor LC comments #135

Merged
merged 18 commits into from Jul 7, 2023
Merged

YANG Doctor LC comments #135

merged 18 commits into from Jul 7, 2023

Conversation

italobusi
Copy link
Member

@italobusi italobusi commented May 15, 2023

YANG model updates to address YD last call comments: fix #133

Aligned YANG description with latest terminology (e2e-MC instead of NMC): fix #137

Added YANG description to actual-gain, out-voa, in-voa and loss attributes: fix #141

Updated the data type of the total-output-power attribute: fix #142

Aligned the measurement units for the PMD attributes: fix #143

Added references for imported modules: fix #146

Addressed Tom Petch comment on 1 versus one: fix #147


Pending merge of PR ietf-ccamp-wg/ietf-ccamp-layer0-types-ext-RFC9093-bis#70

Co-authored-by: sergio belotti sergio.belotti@nokia.com

Co-authored-by: italobusi <italo.busi@huawei.com>
@sergiobelotti
Copy link
Collaborator

sergiobelotti commented May 29, 2023

See the reply from YANG doctor to our proposed modifications https://mailarchive.ietf.org/arch/msg/ccamp/mOSVChPuvpWdH24xTvY_0FLKjuM/

There are just a few minor updates to do before merging

  • Line 657: i seems like a really bad name, I would suggest index or at least idx.

  • [Belotti, Sergio-Italo Busi] The usage of “empty” type in the module is described on top of the module, in the description :… ” Within this module, if the value of a mandatory attribute is unknown, it MUST be reported using the empty type. If an optional attribute is applicable but its value is unknown, it MUST be reported using the empty type.”.

MV: Okay, I suppose, but then it should be consistent, no specific
empty type explanations because that is what actually confused me. I
still think it more user-friendly to have it repeated for every leaf,
though.

  • [Belotti, Sergio-Italo Busi] This model is augmenting ietf- te-topology , that is also augmenting ietf-network. For this augmentation related to the type of network both are following the guideline in section 4.3 of RFC8345 that, among other things says: “….First, a new network type needs to be defined; this is done by defining a presence container that represents the new network type. The new network type is inserted, by means of augmentation, below the network-types container……”

So the augmentation with adding an empty presence container has its own meaning.
The other augmentation you mention have a different xpath , so they cannot be put together with the first augmentation.
MV: Alright, makes sense, so add a reference to the other RFC for it to
be clear to everyone.

  • MV: My point is that otsi has the exact same meaning or clarity as

otsi-information, in my opinion. That makes information redundant. I
cannot help with coming up with a better name as this is not my
expertise at all.

italobusi and others added 6 commits June 23, 2023 10:22
Co-authored-by: sergio belotti <sergio.belotti@nokia.com>
…MC): fix #137

Co-authored-by: sergio belotti <sergio.belotti@nokia.com>
…butes: fix #141

Co-authored-by: sergio belotti <sergio.belotti@nokia.com>
Co-authored-by: sergio belotti <sergio.belotti@nokia.com>
Co-authored-by: sergio belotti <sergio.belotti@nokia.com>
@italobusi italobusi mentioned this pull request Jul 3, 2023
9 tasks
@@ -182,13 +182,13 @@ module: ietf-optical-impairment-topology
| | +--ro lower-frequency frequency-thz
| | +--ro upper-frequency frequency-thz
| +--ro actual-gain
| | l0-types:ratio-in-db-or-null
| | l0-types:gain-in-db-or-null
| +--ro tilt-target
| | l0-types:decimal-2-digits-or-null
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

tilt target isusually a value in dB I suggest to add the unit in the yang description, and/or to change the type into ratio-in-db-or-null: because it can be positive or negative

Copy link
Member Author

@italobusi italobusi Jul 6, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We have removed the ratio-in-db-or-null data type from l0-types: maybe better to keep it as a decimal-2-digits-or-null type and add units "dB"

I assume the values can be positive or negative so we do not need to define any range

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Addressed in 62ec336

Co-authored-by: sergio belotti sergio.belotti@nokia.com

| +--ro roadm-inband-crosstalk?
| | l0-types:ratio-in-db-or-null
| | l0-types:loss-in-db-or-null
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

no, inband crosstalk is not a loss, I prefer to keep ratio-in-db-or-null

Copy link
Member Author

@italobusi italobusi Jul 6, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We have removed the ratio-in-db-or-null data type from l0-types: maybe better to defined it as a decimal-2-digits-or-null type with units "dB"

I assume the values can be positive or negative so we do not need to define any range

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

hello, crosstalk is usually a positive value . if you remove the ratio-in-db, then definig decimal-2-digits is ok for me.
I think that using loss in the type for this one is too far from its physical meaning.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Addressed in 62ec336

Co-authored-by: sergio belotti sergio.belotti@nokia.com

| +--ro roadm-inband-crosstalk?
| | l0-types:ratio-in-db-or-null
| | l0-types:loss-in-db-or-null
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

no, inband crosstalk is not a loss, I prefer to keep ratio-in-db-or-null

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@EstherLerouzic: we have removed ratio-in-db-or-null, adding
Gain-in-db
Gain-in-db-or-null
Loss-in-db
Loss-in-db-or-null.

In this case what do you recommend?

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

then decimal-2, and put db in the units?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Addressed in 62ec336

Co-authored-by: sergio belotti sergio.belotti@nokia.com

+--ro roadm-inband-crosstalk?
| l0-types:ratio-in-db-or-null
| l0-types:loss-in-db-or-null
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

no, inband crosstalk is not a loss, I prefer to keep ratio-in-db-or-null

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The same as above

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

same comment

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Addressed in 62ec336

Co-authored-by: sergio belotti sergio.belotti@nokia.com

description "Polarization Dependent Loss (PDL)";
}
leaf roadm-inband-crosstalk {
type l0-types:ratio-in-db-or-null;
type l0-types:loss-in-db-or-null;
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

no, inband crosstalk is not a loss, I prefer to keep ratio-in-db-or-null

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The same as above

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

same comment

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Addressed in 62ec336

Co-authored-by: sergio belotti sergio.belotti@nokia.com

| | | +--ro penalty-value
| | | union
| | +--ro max-pdl-penalty* []
| | | +--ro max-pdl-value
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'd like to remove the max here because it is misleading (and not similar to pmd, cd penalties):
and we miss a max-pdl attribute:
| | +--ro max-polarization-dependant-loss ? loss-in-db-or-null
| | +--ro pdl-penalty* []
| | | +--ro pdl-value loss-in-db-or-null
| | | +--ro penalty-value union

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@@ -99,7 +94,7 @@ module: ietf-optical-impairment-topology
| | +--ro out-of-band-osnr?
| | | snr
| | +--ro tx-polarization-power-difference?
| | | power-in-db
| | | power-in-dbm
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

if its a power difference it is in db

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We have removed the power-in-db data type from l0-types: maybe better to defined it as a decimal-2-digits-or-null type with units "dB"

I assume the values can be positive or negative so we do not need to define any range

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

yes decimal-2-digits-or-null type with units "dB" works fine

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

| +--ro configured-mode? union
| +--ro line-coding-bitrate? identityref
| +--ro tx-channel-power? union
| +--ro rx-channel-power? union
| +--ro rx-total-power? union
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

tx-channel-power, rx-channel-power, rx-total-power should be of type power-in-dbm-or-null

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Collaborator

@ju7ien ju7ien left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Some in-dB/dBm leaf types to be adjusted.

Co-authored-by: sergio belotti <sergio.belotti@nokia.com>
italobusi added a commit to ietf-ccamp-wg/ietf-ccamp-layer0-types-ext-RFC9093-bis that referenced this pull request Jul 7, 2023
@italobusi
Copy link
Member Author

Some in-dB/dBm leaf types to be adjusted.

Addressed in 62ec336

Co-authored-by: sergio belotti sergio.belotti@nokia.com

Copy link
Collaborator

@EstherLerouzic EstherLerouzic left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

looks good to me!
thanks !

@italobusi italobusi merged commit 58cef8c into master Jul 7, 2023
2 checks passed
dieterbeller added a commit that referenced this pull request Jul 9, 2023
…ssues #139 and #141 addressed

This I-D update is addressing PR #135 and Open Issues #139 and #141,  - major changes:

- latest YANG model tree view and YANG code updated based on PR #135
- Reference to RFC8776 replaced by I-D.ietf-teas-rfc8776-update ( #139 )
- Paragraph added to the Optical Amplifier section addressing #141
- some pure editorial changes
dieterbeller added a commit that referenced this pull request Jul 10, 2023
* I-D Text Proposal for Open Issues #132 and #136

This I-D update provides text proposals addressing:

- #132
- #136

+ a few pure editorial changes

* I-D Update: Note added addressing comment on Open Issues #132 from 2023-06-20

This I-D update is addressing:

- the latest comment on #132
describing the agreement reached during the weekly call on 2023-06-20:
#132 (comment)

* I-D Update: addressing PR #138 review comments

This I-D update is addressing PR #138 review comments - major change:

- Some Figures illustrating protection architectures were updated showing the two directions separately.
- The text was aligned with the updated figures
- The note added added by the previous commit was removed (see 3ceaa84)
- Table entry for RFC9093 was removed   (RFC9093bis is needed for the YANG model in this I-D)

* I-D Update: latest YANG model update incorporated ( PR #135 ), Open Issues #139 and #141 addressed

This I-D update is addressing PR #135 and Open Issues #139 and #141,  - major changes:

- latest YANG model tree view and YANG code updated based on PR #135
- Reference to RFC8776 replaced by I-D.ietf-teas-rfc8776-update ( #139 )
- Paragraph added to the Optical Amplifier section addressing #141
- some pure editorial changes
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
4 participants