ntsimulator/deploy/o-ran-ru-fh/yang/o-ran-beamforming@2020-04-17.yang

   1 module o-ran-beamforming {
   2   yang-version 1.1;
   3   namespace "urn:o-ran:beamforming:1.0";
   4   prefix "o-ran-bf";
   5
   6   import o-ran-uplane-conf {
   7     prefix "up";
   8   }
   9
  10   import o-ran-module-cap {
  11     prefix "mcap";
  12   }
  13
  14   import o-ran-compression-factors {
  15     prefix "cf";
  16     revision-date 2020-08-10;
  17   }
  18
  19   organization "O-RAN Alliance";
  20
  21   contact
  22     "www.o-ran.org";
  23
  24   description
  25     "This module defines the beamforming capabilitites of an O-RU.
  26     Only O-RUs that support beamforming shall support this module.
  27
  28     Copyright 2020 the O-RAN Alliance.
  29
  30     THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 'AS IS'
  31     AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  32     IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  33     ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
  34     LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  35     CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  36     SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  37     INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  38     CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  39     ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  40     POSSIBILITY OF SUCH DAMAGE.
  41
  42     Redistribution and use in source and binary forms, with or without
  43     modification, are permitted provided that the following conditions are met:
  44
  45     * Redistributions of source code must retain the above copyright notice,
  46     this list of conditions and the above disclaimer.
  47     * Redistributions in binary form must reproduce the above copyright notice,
  48     this list of conditions and the above disclaimer in the documentation
  49     and/or other materials provided with the distribution.
  50     * Neither the Members of the O-RAN Alliance nor the names of its
  51     contributors may be used to endorse or promote products derived from
  52     this software without specific prior written permission.";
  53
  54   revision "2020-04-17" {
  55     description
  56       "version 2.1.0
  57
  58       1) corrected error where typedef refers to deprecated beam-id by
  59       introducing new typedef and deprecating leafs defining coarse/fine
  60       relationships that refer to beam-id and replacing with new ones based
  61       on capability grouping";
  62
  63     reference "ORAN-WG4.M.0-v02.00";
  64   }
  65
  66   revision "2019-07-03" {
  67     description
  68       "version 2.0.0
  69
  70       1) re-designed/switched from per band to per capabilities-group for
  71       addition flexibility
  72       2) added in new beam tilt feature
  73       3) adding possibilities to provide more compression types for beamforming
  74       4) Adding possibility to configure beamforming per capabilities group
  75       5) corrected xPATH boolean check from TRUE to true";
  76
  77     reference "ORAN-WG4.M.0-v02.00";
  78   }
  79
  80   revision "2019-02-04" {
  81     description
  82       "version 1.0.0
  83
  84       1) imported model from xRAN
  85       2) changed namespace and reference from xran to o-ran";
  86
  87     reference "ORAN-WG4.M.0-v01.00";
  88   }
  89
  90
  91   feature MODIFY-BF-CONFIG {
  92     description
  93       "This feature indicates that the O-RU supports an optional feature to
  94       modify beamforming configuration information";
  95   }
  96
  97   feature BEAM-TILT {
  98     description
  99       "This feature indicates that the O-RU supports an optional feature to
 100       allows to shift beam characteristic of all predefined-beams in elevation
 101       and/or azimuth direction (i.e. changing the service area or sector
 102       coverage) while preserving the beam adjacency among the beams within
 103       the service area ";
 104   }
 105
 106   typedef beam-reference {
 107     type leafref {
 108       path "/o-ran-bf:beamforming-config/o-ran-bf:per-band-config/o-ran-bf:beam-information/o-ran-bf:beamforming-properties/o-ran-bf:beam-id";
 109     }
 110     description
 111       "This type is used by data models that need to reference a beam.";
 112   }
 113
 114   typedef beam-capabilities-reference {
 115     type leafref {
 116       path "/o-ran-bf:beamforming-config/o-ran-bf:capabilities-groups/o-ran-bf:beam-information/o-ran-bf:beamforming-properties/o-ran-bf:beam-id";
 117     }
 118     description
 119       "This type is used by data models that need to reference a beam based on capability group.";
 120   }
 121
 122   grouping beamforming-parameters {
 123     leaf max-number-of-beam-ids {
 124       type uint16;
 125       mandatory true;
 126       description
 127         "Maximum number of supported Beam ID assigned to domain beamforming control";
 128     }
 129
 130     leaf initial-beam-id {
 131       type uint16;
 132       mandatory true;
 133       description
 134         "First Beam ID that can be used for addressing of domain beams";
 135     }
 136
 137     description "Group of common beamforming parameters";
 138   }
 139
 140   grouping granularity-parameters {
 141     leaf frequency-granularity {
 142       type enumeration {
 143         enum CC {
 144           description
 145             "Frequency granularity: per carrier component";
 146         }
 147
 148         enum BAND {
 149           description
 150             "Frequency granularity: per band";
 151         }
 152       }
 153       mandatory true;
 154       description "Supported time granularity of time-domain beamforming.";
 155     }
 156
 157     leaf time-granularity {
 158       type enumeration {
 159         enum SLOT {
 160           description
 161             "Time granularity: per slot";
 162         }
 163
 164         enum SYMBOL {
 165           description
 166             "Time granularity: per symbol";
 167         }
 168       }
 169       mandatory true;
 170       description "Supported time granularity of time-domain beamforming.";
 171     }
 172     description "";
 173   }
 174
 175   grouping array-lists {
 176     description
 177       "Grouping for array lists";
 178
 179     leaf-list tx-array {
 180       type leafref {
 181         path "/up:user-plane-configuration/up:tx-arrays/up:name";
 182       }
 183       description "tx arrays belonging to this band number";
 184     }
 185     leaf-list rx-array {
 186       type leafref {
 187         path "/up:user-plane-configuration/up:rx-arrays/up:name";
 188       }
 189       description "rx arrays belonging to this band number";
 190     }
 191   }
 192
 193   grouping static-properties {
 194     description
 195       "Grouping for static beamforming properties";
 196
 197     leaf rt-bf-weights-update-support {
 198       type boolean;
 199       description
 200         "The parameter informs if O-RU supports real time beamforming weights update through C-Plane messaging";
 201     }
 202
 203     choice beamforming-type {
 204       case frequency {
 205         container frequency-domain-beams {
 206           when "../rt-bf-weights-update-support = 'true'";
 207           uses beamforming-parameters;
 208           uses cf:compression-details;
 209
 210           list additional-compression-method-supported {
 211             uses cf:compression-details;
 212
 213             description
 214               "List of additional supported compression methods by O-RU";
 215           }
 216
 217           description "";
 218         }
 219         description "Set of parameters valid for O-RU, that supports beamforming in frequency domain.";
 220       }
 221
 222       case time {
 223         container time-domain-beams {
 224           when "../rt-bf-weights-update-support = 'true'";
 225           uses beamforming-parameters;
 226           uses granularity-parameters;
 227           uses cf:compression-details;
 228
 229           list additional-compression-method-supported {
 230             uses cf:compression-details;
 231
 232             description
 233               "List of additional supported compression methods by O-RU";
 234           }
 235
 236           description "";
 237         }
 238         description "Set of parameters valid for O-RU, that supports beamforming in time domain.";
 239       }
 240
 241       case hybrid {
 242         container hybrid-beams {
 243           when "../rt-bf-weights-update-support = 'true'";
 244           uses beamforming-parameters;
 245           uses granularity-parameters;
 246           uses cf:compression-details;
 247
 248           list additional-compression-method-supported {
 249             uses cf:compression-details;
 250
 251             description
 252               "List of additional supported compression methods by O-RU";
 253           }
 254
 255           description "";
 256         }
 257         description "Set of parameters valid for O-RU, that supports hybrid beamforming - in both time and frequency domain.";
 258       }
 259       description
 260         "This value indicates beamforming type supported by O-RU";
 261     }
 262
 263     leaf number-of-beams {
 264       type uint16;
 265       description
 266         "This value indicates the max number of beam patterns O-RU can generate
 267         and apply to the signal of each O-RU port (both DL and UL).
 268         This value is equivalent to the maximum number of used beam IDs.";
 269     }
 270   }
 271
 272   grouping beamforming-property {
 273     description
 274       "Grouping for beamforming property";
 275
 276     leaf beam-type {
 277       type enumeration {
 278         enum COARSE {
 279           description "the beam-id corresponds to a coarse beam";
 280         }
 281         enum FINE {
 282           description "the beam-id corresponds to a fine beam";
 283         }
 284       }
 285       description
 286         "This value indicates the beam resolution.";
 287     }
 288
 289     leaf beam-group-id {
 290       type uint16;
 291       description
 292         "Beams with same beamGroupsID can be transmitted simultaneously.";
 293     }
 294
 295     leaf-list coarse-fine-beam-relation {
 296       type beam-reference;
 297       status deprecated;
 298       description
 299         "List of related coarse/fine beam.";
 300     }
 301
 302     leaf-list neighbour-beams {
 303       type beam-reference;
 304       status deprecated;
 305       description
 306         "A list of neighbor beams which might restrict co-scheduling due
 307         to interference.";
 308     }
 309
 310     leaf-list coarse-fine-beam-capability-based-relation {
 311       type beam-capabilities-reference;
 312       description
 313         "List of related coarse/fine beam.";
 314     }
 315
 316     leaf-list neighbour-beams-capability-based {
 317       type beam-capabilities-reference;
 318       description
 319         "A list of neighbor beams which might restrict co-scheduling due
 320         to interference.";
 321     }
 322   }
 323
 324   grouping beamforming-properties-element {
 325     description
 326       "Grouping for beamforming-properties element";
 327
 328     leaf beam-id {
 329       type uint16;
 330       description
 331         "This value indicates the beam ID whose beamforming properties are
 332         described in the container.";
 333     }
 334
 335     container beamforming-property {
 336       description
 337         "Structure containing single set of beamforming properties.";
 338
 339       uses beamforming-property;
 340     }
 341   }
 342
 343   grouping band-num {
 344     description
 345       "Band information for the beamforming
 346        related to the band number from module capabilities";
 347
 348     leaf band-number {
 349       type leafref {
 350         path "/mcap:module-capability/mcap:band-capabilities/mcap:band-number";
 351       }
 352       description
 353         "band information for the beamforming information
 354          related to the band number of module capabilities";
 355     }
 356   }
 357
 358   grouping cap-group {
 359     description
 360       "Capabilities group grouping";
 361
 362     leaf capabilities-group {
 363       type leafref {
 364         path "/o-ran-bf:beamforming-config/o-ran-bf:capabilities-groups/o-ran-bf:capabilities-group";
 365       }
 366       mandatory true;
 367       description
 368         "Capabilities group identification number to which it refers.";
 369     }
 370
 371   }
 372
 373   grouping per-band-config-element {
 374     description
 375       "Grouping for per band config element";
 376
 377     uses band-num;
 378     uses array-lists;
 379
 380     container static-properties {
 381       description
 382         "the static beamforming related information";
 383
 384       uses static-properties;
 385     }
 386
 387     container beam-information {
 388       description
 389         "Beam information which exposes beamforming related O-RU capabilities.";
 390       leaf number-of-beamforming-properties {
 391         type uint16;
 392         description
 393           "This parameter indicates the number of beamFormingProperties entries.";
 394       }
 395
 396       list beamforming-properties {
 397         key beam-id;
 398         description
 399           "Array for the beamforming properties at O-RU.
 400           These parameters can be used by the beamforming control by the NETCONF client.
 401           'numberOfBeamformingProperties' indicaets the size of the array.";
 402
 403         uses beamforming-properties-element;
 404       }
 405     }
 406   }
 407
 408   grouping operational-properties {
 409     description
 410       "Grouping for operational properties";
 411
 412     leaf number-of-writeable-beamforming-files {
 413       type uint8  {
 414         range "1 .. max";
 415       }
 416       mandatory true;
 417       description
 418         "This leaf indicates the maximum number of writeable beamforming files
 419         containing beamweights and/or attributes that the O-RU can store, taking
 420         into account the maximum number of beam-IDs as defined by 3GPP
 421         TS38.214 v15.x.x";
 422     }
 423
 424     leaf update-bf-non-delete {
 425       type boolean;
 426       default false;
 427       description
 428         "When set to TRUE, indicates that an O-RU supports the capability
 429         to apply the modified beamforming weight information by using rpc
 430         activate-beamforming-weight without deletion of tx-array-carriers and
 431         rx-array-carriers in advance, i.e., to a deactivated carrier";
 432     }
 433
 434     leaf persistent-bf-files {
 435       type boolean;
 436       default false;
 437       description
 438         "When set to TRUE, indicates that the O-RU supports the capability
 439          to store the modified beamforming weight information file in the
 440          reset persistent memory";
 441     }
 442   }
 443
 444   grouping beamforming-supported-type {
 445     description
 446       "Grouping for type of beamforming supported";
 447
 448     leaf beamforming-trough-attributes-supported {
 449       type boolean;
 450       config false;
 451       description
 452         "Informs if beamforming can be controlled providing attributes to O-RU
 453           (like angles, beamwidth).";
 454     }
 455
 456     leaf beamforming-trough-ue-channel-info-supported {
 457       type boolean;
 458       config false;
 459       description
 460         "Informs if beamforming can be controlled by UE information.";
 461     }
 462   }
 463
 464   grouping beamforming-config {
 465     description
 466       "Grouping for beamforming configuration";
 467
 468     list per-band-config {
 469       key band-number;
 470       config false;
 471       status deprecated;
 472       description "beamforming information per band";
 473       uses per-band-config-element;
 474     }
 475
 476     list capabilities-groups {
 477       key capabilities-group;
 478       description
 479         "Capabilities groups identification number assigned to be referenced by operations
 480          and notifications.
 481          This also help to group particular beamforming capabilities and bind it with arrays";
 482
 483       leaf capabilities-group {
 484         type uint16;
 485         description
 486           "Capabilities group identification number. Number which is used just for reference in RPC
 487            and notification";
 488       }
 489       uses per-band-config-element;
 490     }
 491
 492     container ue-specific-beamforming {
 493       presence
 494         "Indicates that the O-RU supports optional Section Type '6' Fields
 495         (used for sending channel information for a specific UE)";
 496       config false;
 497       description
 498         "Information related to supput by the O-RU of Section Type 6 for
 499         signalling UE-specific channel information to the O-RU";
 500       leaf max-number-of-ues {
 501         type uint8;
 502         description
 503           "Indicates tha maximum number of UE -specific channel information
 504           data sets supported by the O-RU";
 505       }
 506     }
 507     container operational-properties {
 508       if-feature MODIFY-BF-CONFIG;
 509       config false;
 510       description "properties for dynamic beam weight/attribute support";
 511
 512       uses operational-properties;
 513     }
 514   }
 515
 516   grouping beam-tilt-configuration {
 517     description "grouping for beam-tilt feature";
 518     list predefined-beam-tilt-offset {
 519       if-feature BEAM-TILT;
 520       key capabilities-group;
 521       description "Configuration of the predefined-beam-tilt-offset per capabilities-group";
 522       leaf capabilities-group {
 523         type leafref {
 524           path "/o-ran-bf:beamforming-config/o-ran-bf:capabilities-groups/o-ran-bf:capabilities-group";
 525           require-instance false;
 526         }
 527         mandatory true;
 528         description
 529           "Capabilities group identification number for which
 530           the predefined-beam-tilt-offset relates to";
 531       }
 532       leaf elevation-tilt-offset-angle {
 533         type int16 {
 534           range "-90..90";
 535         }
 536         units degrees;
 537         default 0;
 538         description
 539           "Value 0 represents the default service area of the predefined-beams
 540           in elevation domain, i.e. no tilt offset.
 541
 542           Values smaller than 0 represents an up-shift of the default service area
 543           towards the zenith (i.e., corresponding to a decrease in zenith angle) and
 544           values larger than 0 represent a down-shift of the default service area
 545           away from the zenith (i.e., corresponding to an increase in zenith angle).
 546
 547           If the value is greater than the maximum supported angle, then the maximum
 548           angle is used for configuration.
 549           If the value is less than the minimum supported angle, then the minimum
 550           angle is used for configuration.
 551           The actual angle used is (angle DIV granularity) * granularity.
 552
 553           Any O-RU which is reset using the o-ran-operations:reset RPC shall reset
 554           its offset angle to its default value.";
 555       }
 556       leaf azimuth-tilt-offset-angle {
 557         type int16 {
 558           range "-90..90";
 559         }
 560         units degrees;
 561         default 0;
 562         description
 563           "Value 0 represents the default service area of the predefined-beams
 564           in azimuth domain, i.e., no tile offset.
 565
 566           Azimuth tilt offset angle, represents counter-clockwise rotation around
 567           z-axis. I.e., assuming view from the UE (observation of the O-RU
 568           from the front), value larger than 0 and smaller than 0
 569           respectively represent right-shifted and left-shifted of the default
 570           service area in azimuth domain.
 571
 572           If the value is greater than the maximum supported angle, then the maximum
 573           angle is used for configuration.
 574           If the value is less than the minimum supported angle, then the minimum
 575           angle is used for configuration.
 576           The actual angle used is (angle DIV granularity) * granularity.
 577
 578           Any O-RU which is reset using the o-ran-operations:reset RPC shall reset
 579           its offset angle to its default value.";
 580       }
 581     }
 582   }
 583
 584   grouping beam-tilt-state {
 585     description
 586       "Grouping for beam tilt state";
 587
 588     list predefined-beam-tilt-offset-information {
 589       key capabilities-group;
 590       config false;
 591       description
 592         "Information which exposes predefined-beam-tilt-offset related O-RU capabilities.";
 593       leaf capabilities-group {
 594         type leafref {
 595           path "/o-ran-bf:beamforming-config/o-ran-bf:capabilities-groups/o-ran-bf:capabilities-group";
 596         }
 597         mandatory true;
 598         description
 599           "Capabilities group identification number for which
 600           the predefined-beam-tilt-offset-information relates to";
 601       }
 602       leaf elevation-tilt-offset-granularity {
 603         type uint8 {
 604           range "0..30";
 605         }
 606         units Degrees;
 607         mandatory true;
 608         description
 609           "Indication of the supported granularity for the
 610           predefined-beam-tilt-offset in elevation domain.
 611
 612           Value 0 represents that the O-RU doesn't support
 613           the predefined-beam-tilt-offset in elevation domain.";
 614       }
 615       leaf azimuth-tilt-offset-granularity {
 616         type uint8 {
 617           range "0..30";
 618         }
 619         units Degrees;
 620         mandatory true;
 621         description
 622           "Indication of the supported granularity for the
 623           predefined-beam-tilt-offset in azimuth domain.
 624
 625           Value '0' represents that the O-RU doesn't support
 626           the predefined-beam-tilt-offset in azimuth domain.";
 627       }
 628       leaf minimum-supported-elevation-tilt-offset {
 629         type int16 {
 630           range "-90..0";
 631         }
 632         units Degrees;
 633         mandatory true;
 634         description
 635           "The minimum value which can be configured for
 636           'elevation-tilt-offset-angle'.";
 637       }
 638       leaf maximum-supported-elevation-tilt-offset {
 639         type int16 {
 640           range "0..90";
 641         }
 642         units Degrees;
 643         mandatory true;
 644         description
 645           "The maximum value which can be configured for
 646           'elevation-tilt-offset-angle'.";
 647       }
 648       leaf minimum-supported-azimuth-tilt-offset {
 649         type int16 {
 650           range "-90..0";
 651         }
 652         units Degrees;
 653         mandatory true;
 654         description
 655           "The minimum value which can be configured for
 656           'azimuth-tilt-offset-angle'.";
 657       }
 658       leaf maximum-supported-azimuth-tilt-offset {
 659         type int16 {
 660           range "0..90";
 661         }
 662         units Degrees;
 663         mandatory true;
 664         description
 665           "The maximum value which can be configured for
 666           'azimuth-tilt-offset-angle'.";
 667       }
 668       leaf run-time-tilt-offset-supported {
 669         type boolean;
 670         mandatory true;
 671         description
 672           "If 'run-time-tilt-offset-supported' is FALSE, changing the values in
 673           'predefined-beam-tilt-offset' for a specific band shall be allowed only
 674           if all 'tx-array-carriers' and 'rx-array-carriers' corresponding
 675           to the band are INACTIVE.";
 676       }
 677     }
 678
 679   }
 680
 681   grouping beam-tilt-report {
 682     description
 683       "Grouping for beam tilt report";
 684
 685     list predefined-beam-tilt-state {
 686       key capabilities-group;
 687       config false;
 688       description
 689         "Information which exposes state of predefined-beam-tilt-offset.";
 690       leaf capabilities-group {
 691         type leafref {
 692           path "/o-ran-bf:beamforming-config/o-ran-bf:capabilities-groups/o-ran-bf:capabilities-group";
 693         }
 694         mandatory true;
 695         description
 696           "Capabilities group identification number for which
 697           the predefined-beam-tilt-state relates to";
 698       }
 699       leaf elevation-tilt-offset-angle {
 700         type int16 {
 701           range "-90..90";
 702         }
 703         units Degrees;
 704         mandatory true;
 705         description
 706           "Value 'zero' represents the default service area of the
 707           predefined-beams in elevation domain.
 708
 709           Values smaller than 0 represents an up-shift of the default service area
 710           towards the zenith (i.e., corresponding to a decrease in zenith angle) and
 711           values larger than 0 represent a down-shift of the default service area
 712           away from the zenith (i.e., corresponding to an increase in zenith angle).";
 713       }
 714       leaf azimuth-tilt-offset-angle {
 715         type int16 {
 716           range "-90..90";
 717         }
 718         units Degrees;
 719         mandatory true;
 720         description
 721           "Value 'zero' represents the default service area of the
 722           predefined-beams in azimuth domain.
 723
 724           Azimuth tilt offset angle, represents counter-clockwise rotation around
 725           z-axis. I.e., assuming view from the UE (observation of the O-RU from
 726           the front), value larger than 'zero' and smaller than 'zero'
 727           respectively represent right-shifted and left-shifted of the default
 728           service area in azimuth domain.";
 729       }
 730     }
 731
 732   }
 733
 734   container beamforming-config {
 735     config false;
 736     description
 737       "A set of configuration data for the O-RU's beam forming functionality";
 738
 739     uses beamforming-config;
 740     uses beamforming-supported-type;
 741     container beam-tilt {
 742       if-feature BEAM-TILT;
 743       description "container for pre-defined beam tilt feature";
 744       uses beam-tilt-state;
 745       uses beam-tilt-report;
 746     }
 747   }
 748
 749
 750   rpc activate-beamforming-config {
 751     if-feature MODIFY-BF-CONFIG;
 752     description
 753       "rpc to activate beamforming config information by indicating the file
 754       stored in the folder O-RAN/beam-weights in advance";
 755     input {
 756       leaf beamforming-config-file {
 757         type string;
 758         mandatory true;
 759         description
 760           "file name stored in O-RAN/beamforming/ folder is indicated";
 761       }
 762
 763       uses band-num;
 764     }
 765     output {
 766       leaf status {
 767         type enumeration {
 768           enum ACCEPTED {
 769             description "O-RU has accepted the beamforming weight/attribute file";
 770           }
 771           enum REJECTED {
 772             description
 773               "O-RU has rejected the beamforming weight/attribute file. The O-RU
 774               should then use the default beamforming file.";
 775           }
 776         }
 777         mandatory true;
 778         description "Status of activation of beamforming config information";
 779       }
 780       leaf error-message {
 781         when "../status='REJECTED'";
 782         type string;
 783         description
 784           "Detailed error Message when the status is rejected, e.g.,
 785            because new beam forming file is attempted to be applied to a
 786            carrier which is still active, or the beam-id does not exist.";
 787       }
 788     }
 789   }
 790
 791   rpc activate-beamforming-config-by-capability-group {
 792     if-feature MODIFY-BF-CONFIG;
 793     description
 794       "rpc to activate beamforming config information by indicating the file
 795       stored in the folder O-RAN/beam-weights in advance";
 796     input {
 797       leaf beamforming-config-file {
 798         type string;
 799         mandatory true;
 800         description
 801           "file name stored in O-RAN/beamforming/ folder is indicated";
 802       }
 803
 804       uses cap-group;
 805     }
 806     output {
 807       leaf status {
 808         type enumeration {
 809           enum ACCEPTED {
 810             description "O-RU has accepted the beamforming weight/attribute file";
 811           }
 812           enum REJECTED {
 813             description
 814               "O-RU has rejected the beamforming weight/attribute file. The O-RU
 815               should then use the default beamforming file.";
 816           }
 817         }
 818         mandatory true;
 819         description "Status of activation of beamforming config information";
 820       }
 821       leaf error-message {
 822         when "../status='REJECTED'";
 823         type string;
 824         description
 825           "Detailed error Message when the status is rejected, e.g.,
 826            because new beam forming file is attempted to be applied to a
 827            carrier which is still active, or the beam-id does not exist.";
 828       }
 829     }
 830   }
 831
 832
 833   rpc modify-predefined-beam-tilt-offset {
 834     if-feature BEAM-TILT;
 835     description
 836       "rpc to trigger the modification of the predefined beam tilt offset";
 837     input {
 838       uses beam-tilt-configuration;
 839     }
 840     output {
 841       leaf status {
 842         type enumeration {
 843           enum ACCEPTED {
 844             description "O-RU has accepted the predefind beamtilt offset configuration";
 845           }
 846           enum REJECTED {
 847             description
 848               "O-RU has rejected the predefind beamtilt offset configuration.";
 849           }
 850         }
 851         mandatory true;
 852         description "Status of acceptance of pre-defined beamtilt offset configuration";
 853       }
 854       leaf error-message {
 855         when "../status='REJECTED'";
 856         type string;
 857         description
 858           "Detailed error message when the pre-defined beam tilt configuration
 859           is rejected, e.g., used when 'run-time-tilt-offset-supported' is FALSE and the
 860           NETCONF client is attempting to modify the beam tilt on a band where
 861           one or more array-carriers are still ACTIVE.";
 862       }
 863     }
 864   }
 865
 866
 867   //notification statement
 868   notification beamforming-information-update {
 869     uses band-num;
 870     description
 871       "this notification indicates that the beamforming properties are updated for particular band";
 872   }
 873
 874   notification capability-group-beamforming-information-update {
 875     uses cap-group;
 876     description
 877       "this notification indicates that the beamforming properties are updated for particular band
 878        or capability group";
 879   }
 880
 881   notification predefined-beam-tilt-offset-complete {
 882     if-feature BEAM-TILT;
 883     uses beam-tilt-report;
 884     description
 885       "this notification indicates that the re-generation of the predefined
 886       beams is completed";
 887   }
 888 }