openBackhaul / airInterface

Technology specific interface definition for microwave air interfaces
Apache License 2.0
3 stars 0 forks source link

Mandatory Attributes #56

Open PrathibaJee opened 1 year ago

PrathibaJee commented 1 year ago

The latest UML2YANG tool will include mandatory substatement to attributes that has "Multiplicity 1 + no default values defined". The following attributes which are formerly optional will be changed to mandatory in the upcoming YANG.

Further , if an attribute is decided to be optional , we shall handle it in the UML modelling by either introducing a default value or by modifying the Multiplicity to 0..1.

S.no grouping/datatype attribute Mandatory optional
1 object-creation-notification object-id-ref
2 object-deletion-notification object-id-ref
3 attribute-value-changed-notification object-id-ref
4 current-performance granularity-period
5 historical-performance granularity-period
6 period-end-time
7 air-interface-configuration transmission-mode-min
8 air-interface-status transmission-mode-cur
9 transmission-mode transmission-mode-name
10 g-826-threshold-cross-alarm-type g-826-value-kind
11 granularity-period
12 xlts-threshold-cross-alarm-type level-threshold-second-kind
13 granularity-period
14 xlts-threshold-cross-alarm-definition-number
15 acm-threshold-cross-alarm-type acm-threshold-cross-alarm-definition-number
16 transmission-mode
17 granularity-period
18 time-xstates-type time-xstate-sequence-number
19 transmission-mode
openBackhaul commented 1 year ago

Decision made during the 5G-xhaul call on 26th of July 2023:

UML2YANG tool will include mandatory substatements to attributes marked as mandatory.

S.no grouping/datatype attribute Mandatory optional
1 object-creation-notification object-id-ref X
2 object-deletion-notification object-id-ref X
3 attribute-value-changed-notification object-id-ref X
4 current-performance granularity-period X 1)
5 historical-performance granularity-period X 1)
6 period-end-time X 1)
7 air-interface-configuration transmission-mode-min X
8 air-interface-status transmission-mode-cur X
9 transmission-mode transmission-mode-name X 1)
10 g-826-threshold-cross-alarm-type g-826-value-kind X 1)
11 granularity-period X 1)
12 xlts-threshold-cross-alarm-type level-threshold-second-kind X 1)
13 granularity-period X 1)
14 xlts-threshold-cross-alarm-definition-number X 1)
15 acm-threshold-cross-alarm-type acm-threshold-cross-alarm-definition-number X 1)
16 transmission-mode X
17 granularity-period X 1)
18 time-xstates-type time-xstate-sequence-number X 1)
19 transmission-mode X

1) It is a key attribute

michbin commented 1 year ago

Values for transmission-mode-min and transmission-mode-cur might not be available if the air interface is down. Making transmission-mode-min mandatory might force clients to provide this attribute in each configuration request.