src/5gnrmac/rg_ptli.c

   1 /*******************************************************************************
   2 ################################################################################
   3 #   Copyright (c) [2017-2019] [Radisys]                                        #
   4 #                                                                              #
   5 #   Licensed under the Apache License, Version 2.0 (the "License");            #
   6 #   you may not use this file except in compliance with the License.           #
   7 #   You may obtain a copy of the License at                                    #
   8 #                                                                              #
   9 #       http://www.apache.org/licenses/LICENSE-2.0                             #
  10 #                                                                              #
  11 #   Unless required by applicable law or agreed to in writing, software        #
  12 #   distributed under the License is distributed on an "AS IS" BASIS,          #
  13 #   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.   #
  14 #   See the License for the specific language governing permissions and        #
  15 #   limitations under the License.                                             #
  16 ################################################################################
  17 *******************************************************************************/
  18
  19 /************************************************************************
  20
  21      Name:     LTE-MAC layer
  22
  23      Type:     C source file
  24
  25      Desc:     C source code for Entry point fucntions
  26
  27      File:     rg_ptli.c
  28
  29 **********************************************************************/
  30
  31 /** @file rg_dhm.c
  32 @brief APIs related to Downlink HARQ.
  33 */
  34
  35 /* header include files (.h) */
  36 #include "envopt.h"        /* environment options */
  37 #include "envdep.h"        /* environment dependent */
  38 #include "envind.h"        /* environment independent */
  39 #include "gen.h"           /* general */
  40 #include "ssi.h"           /* system services */
  41 #include "cm_tkns.h"       /* Common Token Defines */
  42 #include "cm_llist.h"      /* Common Link List Defines */
  43 #include "cm_hash.h"       /* Common Hash List Defines */
  44 #include "cm_mblk.h"
  45 #include "cm_lte.h"        /* Common LTE Defines */
  46 #include "tfu.h"           /* RGU Interface defines */
  47
  48 /* header/extern include files (.x) */
  49 #include "gen.x"           /* general */
  50 #include "ssi.x"           /* system services */
  51 #include "cm_tkns.x"       /* Common Token Definitions */
  52 #include "cm_llist.x"      /* Common Link List Definitions */
  53 #include "cm_lib.x"        /* Common Library Definitions */
  54 #include "cm_hash.x"       /* Common Hash List Definitions */
  55 #include "cm_mblk.x"
  56 #include "cm_lte.x"        /* Common LTE Defines */
  57 #include "tfu.x"           /* RGU Interface includes */
  58
  59
  60 #ifdef __cplusplus
  61 extern "C" {
  62 #endif /* __cplusplus */
  63
  64 #if !(defined(LCRGLITFU)  && defined(TF) && defined(LWLCRGLITFU))
  65 #define PTRGLITFU
  66 #endif
  67
  68
  69 /* MAX Number of Service Providers of RG */
  70 #define RG_MAX_TFU_PROV   3
  71
  72 #ifdef PTRGLITFU
  73 /** @brief This API is used to send a Bind Request from MAC to PHY.
  74  * @param pst Pointer to the post structure.
  75  * @param suId SAP ID of the service user.
  76  * @param spId SAP ID of the service provider.
  77  * @return ROK/RFAILED
  78  */
  79 EXTERN S16 PtLiTfuBndReq ARGS((Pst * pst, SuId suId, SpId spId));
  80 /** @brief This API is used to send a Bind Request from Scheduler to PHY.
  81  * @param pst Pointer to the post structure.
  82  * @param suId SAP ID of the service user.
  83  * @param spId SAP ID of the service provider.
  84  * @return ROK/RFAILED
  85  */
  86 EXTERN S16 PtLiTfuSchBndReq ARGS((Pst * pst, SuId suId, SpId spId));
  87 /** @brief This API is used to send an Unbind Request from MAC to PHY.
  88  * @param pst Pointer to the post structure.
  89  * @param suId SAP ID of the service provider.
  90  * @param reason Reason for Unbind request.
  91  * @return ROK/RFAILED
  92  */
  93 EXTERN S16 PtLiTfuUbndReq ARGS((Pst * pst, SpId spId, Reason reason));
  94 /** @brief This API is used to send an Unbind Request from Scheduler to PHY.
  95  * @param pst Pointer to the post structure.
  96  * @param suId SAP ID of the service provider.
  97  * @param reason Reason for Unbind request.
  98  * @return ROK/RFAILED
  99  */
 100 EXTERN S16 PtLiTfuSchUbndReq ARGS((Pst * pst, SpId spId, Reason reason));
 101 /** @brief This primitive is sent from Scheduler to PHY.
 102  * @details This primitive provides PHY with all the information required by
 103  * PHY to decode transmissions from the UE on either PUCCH or PUSCH.
 104  * -# On PUCCH UE can transmit the following
 105  *    -# SR
 106  *    -# HARQ feedback
 107  *    -# CQI report
 108  *    -# HARQ + CQI
 109  *    -# HARQ + SR
 110  * -# On PUSCH UE can transmit the following
 111  *    -# Data
 112  *    -# Data + CQI
 113  *    -# Data + HARQ Feedback
 114  * This primitive carries all the information for the expected subframe for all
 115  * the UEs that have been scheduled to transmit.
 116  * @param pst Pointer to the post structure.
 117  * @param spId SAP ID of the service provider.
 118  * @param recpReq Pointer to the TfuRecpReqInfo structure.
 119  * @return ROK/RFAILED
 120  */
 121 EXTERN S16 PtLiTfuRecpReq ARGS((Pst * pst, SpId spId, TfuRecpReqInfo * recpReq));
 122 /** @brief This Primitive is sent from Scheduler to PHY. It provides PHY with
 123   * all the control information
 124   * @details This primitive carries the information sent on the following
 125   * channels -
 126   * -# PDCCH
 127   * -# PHICH
 128   * -# PCFICH
 129   *
 130   * @param pst
 131   * @param spId
 132   * @param cntrlReq pointer to TfuCntrlReqInfo
 133   * @return ROK/RFAILED
 134   */
 135 EXTERN S16 PtLiTfuCntrlReq ARGS((Pst * pst, SpId spId, TfuCntrlReqInfo * cntrlReq));
 136 /** @brief This Primitive carries the Data PDUs from MAC to PHY for
 137   * transmission.
 138   * @details The data being sent in this primitive is meant to be transmitted on
 139   * the downlink channel PDSCH and PBCH (if present). To facilitate physical
 140   * layer processing, requisite control information is also sent along with the
 141   * data.
 142   * @sa TfUiTfuCntrlReq
 143   * @param pst
 144   * @param spId
 145   * @param tfuDatReq pointer to TfuDatReqInfo
 146   * @return
 147   */
 148 EXTERN S16 PtLiTfuDatReq ARGS((Pst * pst, SpId spId, TfuDatReqInfo * datReq));
 149 #ifdef L2_OPTMZ
 150 /** @brief This Primitive carries cellId and UeId for which datReq need to be deleted.
 151   * @details This primitive is used to send delDatReq to CL to delete the PDUs of
 152   * UE which has been deleted in MAC due to ueId change or anyother scenario
 153   * @details The data being sent in this primitive is meant to be transmitted on
 154   * @sa TfUiTfuDelDatReq
 155   * @param pst
 156   * @param spId
 157   * @param tfuDelDatReq pointer to TfuDelDatReqInfo
 158   * @return
 159  */
 160 EXTERN S16 PtLiTfuDelDatReq ARGS((Pst * pst, SpId spId, TfuDelDatReqInfo * datReq));
 161 #endif /*L2_OPTMZ*/
 162 #endif /*--#ifdef PTRGLITFU--*/
 163
 164 /** @brief This API is used to send a Bind Request from MAC to PHY.
 165  * @param pst Pointer to the post structure.
 166  * @param suId SAP ID of the service user.
 167  * @param spId SAP ID of the service provider.
 168  * @return ROK/RFAILED
 169  */
 170 PRIVATE CONSTANT TfuBndReq RgLiTfuBndReqMt[RG_MAX_TFU_PROV] =
 171 {
 172 #ifdef LCRGLITFU
 173    cmPkTfuBndReq,
 174 #else
 175    PtLiTfuBndReq,
 176 #endif
 177 #ifdef TF
 178    TfUiTfuBndReq,
 179 #else
 180    PtLiTfuBndReq,
 181 #endif
 182 #ifdef LWLCRGLITFU
 183    cmPkTfuBndReq
 184 #else
 185    PtLiTfuBndReq
 186 #endif
 187 };
 188
 189 /** @brief This API is used to send a Bind Request from Scheduler to PHY.
 190  * @param pst Pointer to the post structure.
 191  * @param suId SAP ID of the service user.
 192  * @param spId SAP ID of the service provider.
 193  * @return ROK/RFAILED
 194  */
 195 PRIVATE CONSTANT TfuSchBndReq RgLiTfuSchBndReqMt[RG_MAX_TFU_PROV] =
 196 {
 197 #ifdef LCRGLITFU
 198    cmPkTfuSchBndReq,
 199 #else
 200    PtLiTfuSchBndReq,
 201 #endif
 202 #ifdef TF
 203    TfUiTfuSchBndReq,
 204 #else
 205    PtLiTfuSchBndReq,
 206 #endif
 207 #ifdef LWLCRGLITFU
 208    cmPkTfuSchBndReq
 209 #else
 210    PtLiTfuSchBndReq
 211 #endif
 212 };
 213
 214 /** @brief This API is used to send an Unbind Request from MAC to PHY.
 215  * @param pst Pointer to the post structure.
 216  * @param suId SAP ID of the service provider.
 217  * @param reason Reason for Unbind request.
 218  * @return ROK/RFAILED
 219  */
 220 PRIVATE CONSTANT TfuUbndReq RgLiTfuUbndReqMt[RG_MAX_TFU_PROV] =
 221 {
 222 #ifdef LCRGLITFU
 223    cmPkTfuUbndReq,
 224 #else
 225    PtLiTfuUbndReq,
 226 #endif
 227 #ifdef TF
 228    TfUiTfuUbndReq,
 229 #else
 230    PtLiTfuUbndReq,
 231 #endif
 232 #ifdef LWLCRGLITFU
 233    cmPkTfuUbndReq
 234 #else
 235    PtLiTfuUbndReq
 236 #endif
 237 };
 238
 239 /** @brief This API is used to send an Unbind Request from Scheduler to PHY.
 240  * @param pst Pointer to the post structure.
 241  * @param suId SAP ID of the service provider.
 242  * @param reason Reason for Unbind request.
 243  * @return ROK/RFAILED
 244  */
 245 PRIVATE CONSTANT TfuSchUbndReq RgLiTfuSchUbndReqMt[RG_MAX_TFU_PROV] =
 246 {
 247 #ifdef LCRGLITFU
 248    cmPkTfuSchUbndReq,
 249 #else
 250    PtLiTfuSchUbndReq,
 251 #endif
 252 #ifdef TF
 253    TfUiTfuSchUbndReq,
 254 #else
 255    PtLiTfuSchUbndReq,
 256 #endif
 257 #ifdef LWLCRGLITFU
 258    cmPkTfuSchUbndReq
 259 #else
 260    PtLiTfuSchUbndReq
 261 #endif
 262 };
 263
 264 /** @brief This primitive is sent from Scheduler to PHY.
 265  * @details This primitive provides PHY with all the information required by
 266  * PHY to decode transmissions from the UE on either PUCCH or PUSCH.
 267  * -# On PUCCH UE can transmit the following
 268  *    -# SR
 269  *    -# HARQ feedback
 270  *    -# CQI report
 271  *    -# HARQ + CQI
 272  *    -# HARQ + SR
 273  * -# On PUSCH UE can transmit the following
 274  *    -# Data
 275  *    -# Data + CQI
 276  *    -# Data + HARQ Feedback
 277  * This primitive carries all the information for the expected subframe for all
 278  * the UEs that have been scheduled to transmit.
 279  * @param pst Pointer to the post structure.
 280  * @param spId SAP ID of the service provider.
 281  * @param recpReq Pointer to the TfuRecpReqInfo structure.
 282  * @return ROK/RFAILED
 283  */
 284 PRIVATE CONSTANT TfuRecpReq RgLiTfuRecpReqMt[RG_MAX_TFU_PROV] =
 285 {
 286 #ifdef LCRGLITFU
 287    cmPkTfuRecpReq,
 288 #else
 289    PtLiTfuRecpReq,
 290 #endif
 291 #ifdef TF
 292    TfUiTfuRecpReq,
 293 #else
 294    PtLiTfuRecpReq,
 295 #endif
 296 #ifdef LWLCRGLITFU
 297    cmPkTfuRecpReq
 298 #else
 299    PtLiTfuRecpReq
 300 #endif
 301 };
 302
 303 /** @brief This Primitive is sent from Scheduler to PHY. It provides PHY with
 304   * all the control information
 305   * @details This primitive carries the information sent on the following
 306   * channels -
 307   * -# PDCCH
 308   * -# PHICH
 309   * -# PCFICH
 310   *
 311   * @param pst
 312   * @param spId
 313   * @param cntrlReq pointer to TfuCntrlReqInfo
 314   * @return ROK/RFAILED
 315   */
 316 PRIVATE CONSTANT TfuCntrlReq RgLiTfuCntrlReqMt[RG_MAX_TFU_PROV] =
 317 {
 318 #ifdef LCRGLITFU
 319    cmPkTfuCntrlReq,
 320 #else
 321    PtLiTfuCntrlReq,
 322 #endif
 323 #ifdef TF
 324    TfUiTfuCntrlReq,
 325 #else
 326    PtLiTfuCntrlReq,
 327 #endif
 328 #ifdef LWLCRGLITFU
 329    cmPkTfuCntrlReq
 330 #else
 331    PtLiTfuCntrlReq
 332 #endif
 333 };
 334
 335 /** @brief This Primitive carries the Data PDUs from MAC to PHY for
 336   * transmission.
 337   * @details The data being sent in this primitive is meant to be transmitted on
 338   * the downlink channel PDSCH and PBCH (if present). To facilitate physical
 339   * layer processing, requisite control information is also sent along with the
 340   * data.
 341   * @sa TfUiTfuCntrlReq
 342   * @param pst
 343   * @param spId
 344   * @param tfuDatReq pointer to TfuDatReqInfo
 345   * @return
 346   */
 347 PRIVATE CONSTANT TfuDatReq RgLiTfuDatReqMt[RG_MAX_TFU_PROV] =
 348 {
 349 #ifdef LCRGLITFU
 350    cmPkTfuDatReq,
 351 #else
 352    PtLiTfuDatReq,
 353 #endif
 354 #ifdef TF
 355    TfUiTfuDatReq,
 356 #else
 357    PtLiTfuDatReq,
 358 #endif
 359 #ifdef LWLCRGLITFU
 360    cmPkTfuDatReq
 361 #else
 362    PtLiTfuDatReq
 363 #endif
 364 };
 365
 366 #ifdef L2_OPTMZ
 367 /** @brief This Primitive carries cellId and UeId for which datReq need to be deleted.
 368   * @details This primitive is used to send delDatReq to CL to delete the PDUs of
 369   * UE which has been deleted in MAC due to ueId change or anyother scenario
 370   * NOTE:: This API is only supported for TC because race condition issue
 371   *        happens only in case of TC
 372   * @sa TfUiTfuDelDatReq
 373   * @param pst
 374   * @param spId
 375   * @param tfuDelDatReq pointer to TfuDelDatReqInfo
 376   * @return
 377   */
 378 PRIVATE CONSTANT TfuDelDatReq RgLiTfuDelDatReqMt[RG_MAX_TFU_PROV] =
 379 {
 380 #ifdef LCRGLITFU
 381    PtLiTfuDelDatReq, /*calling dummy api as LC not required for this privitive*/
 382 #else
 383    PtLiTfuDelDatReq,
 384 #endif
 385 #ifdef TF
 386    TfUiTfuDelDatReq,
 387 #else
 388    PtLiTfuDelDatReq,
 389 #endif
 390 #ifdef LWLCRGLITFU
 391    PtLiTfuDelDatReq, /*calling dummy api as LWLC not required for this privitive*/
 392 #else
 393    PtLiTfuDelDatReq
 394 #endif
 395 };
 396 #endif /* L2_OPTMZ*/
 397
 398 #ifdef RG
 399
 400
 401 \f
 402 /***********************************************************
 403 *
 404 *     Func : RgLiTfuBndReq
 405 *
 406 *
 407 *     Desc : This API is used to send a Bind Request from MAC to PHY.
 408  * @param pst Pointer to the post structure.
 409  * @param suId SAP ID of the service user.
 410  * @param spId SAP ID of the service provider.
 411  * @return ROK/RFAILED
 412 *
 413 *
 414 *     Ret  : S16
 415 *
 416 *     Notes:
 417 *
 418 *     File  :
 419 *
 420 **********************************************************/
 421 #ifdef ANSI
 422 PUBLIC S16 RgLiTfuBndReq
 423 (
 424 Pst * pst,
 425 SuId suId,
 426 SpId spId
 427 )
 428 #else
 429 PUBLIC S16 RgLiTfuBndReq(pst, suId, spId)
 430 Pst * pst;
 431 SuId suId;
 432 SpId spId;
 433 #endif
 434 {
 435
 436    TRC3(RgLiTfuBndReq)
 437
 438    RETVALUE((*RgLiTfuBndReqMt[pst->selector])(pst, suId, spId));
 439
 440 }
 441
 442
 443 \f
 444 /***********************************************************
 445 *
 446 *     Func : RgLiTfuSchBndReq
 447 *
 448 *
 449 *     Desc : This API is used to send a Bind Request from Scheduler to PHY.
 450  * @param pst Pointer to the post structure.
 451  * @param suId SAP ID of the service user.
 452  * @param spId SAP ID of the service provider.
 453  * @return ROK/RFAILED
 454 *
 455 *
 456 *     Ret  : S16
 457 *
 458 *     Notes:
 459 *
 460 *     File  :
 461 *
 462 **********************************************************/
 463 #ifdef ANSI
 464 PUBLIC S16 RgLiTfuSchBndReq
 465 (
 466 Pst * pst,
 467 SuId suId,
 468 SpId spId
 469 )
 470 #else
 471 PUBLIC S16 RgLiTfuSchBndReq(pst, suId, spId)
 472 Pst * pst;
 473 SuId suId;
 474 SpId spId;
 475 #endif
 476 {
 477
 478    TRC3(RgLiTfuSchBndReq)
 479
 480    RETVALUE((*RgLiTfuSchBndReqMt[pst->selector])(pst, suId, spId));
 481
 482 }
 483
 484
 485 \f
 486 /***********************************************************
 487 *
 488 *     Func : RgLiTfuUbndReq
 489 *
 490 *
 491 *     Desc : This API is used to send an Unbind Request from MAC to PHY.
 492  * @param pst Pointer to the post structure.
 493  * @param suId SAP ID of the service provider.
 494  * @param reason Reason for Unbind request.
 495  * @return ROK/RFAILED
 496 *
 497 *
 498 *     Ret  : S16
 499 *
 500 *     Notes:
 501 *
 502 *     File  :
 503 *
 504 **********************************************************/
 505 #ifdef ANSI
 506 PUBLIC S16 RgLiTfuUbndReq
 507 (
 508 Pst * pst,
 509 SpId spId,
 510 Reason reason
 511 )
 512 #else
 513 PUBLIC S16 RgLiTfuUbndReq(pst, spId, reason)
 514 Pst * pst;
 515 SpId spId;
 516 Reason reason;
 517 #endif
 518 {
 519
 520    TRC3(RgLiTfuUbndReq)
 521
 522    RETVALUE((*RgLiTfuUbndReqMt[pst->selector])(pst, spId, reason));
 523
 524 }
 525
 526
 527 \f
 528 /***********************************************************
 529 *
 530 *     Func : RgLiTfuSchUbndReq
 531 *
 532 *
 533 *     Desc : This API is used to send an Unbind Request from Scheduler to PHY.
 534  * @param pst Pointer to the post structure.
 535  * @param suId SAP ID of the service provider.
 536  * @param reason Reason for Unbind request.
 537  * @return ROK/RFAILED
 538 *
 539 *
 540 *     Ret  : S16
 541 *
 542 *     Notes:
 543 *
 544 *     File  :
 545 *
 546 **********************************************************/
 547 #ifdef ANSI
 548 PUBLIC S16 RgLiTfuSchUbndReq
 549 (
 550 Pst * pst,
 551 SpId spId,
 552 Reason reason
 553 )
 554 #else
 555 PUBLIC S16 RgLiTfuSchUbndReq(pst, spId, reason)
 556 Pst * pst;
 557 SpId spId;
 558 Reason reason;
 559 #endif
 560 {
 561
 562    TRC3(RgLiTfuSchUbndReq)
 563
 564    RETVALUE((*RgLiTfuSchUbndReqMt[pst->selector])(pst, spId, reason));
 565
 566 }
 567
 568
 569 \f
 570 /***********************************************************
 571 *
 572 *     Func : RgLiTfuRecpReq
 573 *
 574 *
 575 *     Desc : This primitive is sent from Scheduler to PHY.
 576  * @details This primitive provides PHY with all the information required by
 577  * PHY to decode transmissions from the UE on either PUCCH or PUSCH.
 578  * -# On PUCCH UE can transmit the following
 579  *    -# SR
 580  *    -# HARQ feedback
 581  *    -# CQI report
 582  *    -# HARQ + CQI
 583  *    -# HARQ + SR
 584  * -# On PUSCH UE can transmit the following
 585  *    -# Data
 586  *    -# Data + CQI
 587  *    -# Data + HARQ Feedback
 588  * This primitive carries all the information for the expected subframe for all
 589  * the UEs that have been scheduled to transmit.
 590  * @param pst Pointer to the post structure.
 591  * @param spId SAP ID of the service provider.
 592  * @param recpReq Pointer to the TfuRecpReqInfo structure.
 593  * @return ROK/RFAILED
 594 *
 595 *
 596 *     Ret  : S16
 597 *
 598 *     Notes:
 599 *
 600 *     File  :
 601 *
 602 **********************************************************/
 603 #ifdef ANSI
 604 PUBLIC S16 RgLiTfuRecpReq
 605 (
 606 Pst * pst,
 607 SpId spId,
 608 TfuRecpReqInfo * recpReq
 609 )
 610 #else
 611 PUBLIC S16 RgLiTfuRecpReq(pst, spId, recpReq)
 612 Pst * pst;
 613 SpId spId;
 614 TfuRecpReqInfo * recpReq;
 615 #endif
 616 {
 617
 618    TRC3(RgLiTfuRecpReq)
 619
 620    RETVALUE((*RgLiTfuRecpReqMt[pst->selector])(pst, spId, recpReq));
 621
 622 }
 623
 624
 625 \f
 626 /***********************************************************
 627 *
 628 *     Func : RgLiTfuCntrlReq
 629 *
 630 *
 631 *     Desc : This Primitive is sent from Scheduler to PHY. It provides PHY with
 632   * all the control information
 633   * @details This primitive carries the information sent on the following
 634   * channels -
 635   * -# PDCCH
 636   * -# PHICH
 637   * -# PCFICH
 638   *
 639   * @param pst
 640   * @param spId
 641   * @param cntrlReq pointer to TfuCntrlReqInfo
 642   * @return ROK/RFAILED
 643 *
 644 *
 645 *     Ret  : S16
 646 *
 647 *     Notes:
 648 *
 649 *     File  :
 650 *
 651 **********************************************************/
 652 #ifdef ANSI
 653 PUBLIC S16 RgLiTfuCntrlReq
 654 (
 655 Pst * pst,
 656 SpId spId,
 657 TfuCntrlReqInfo * cntrlReq
 658 )
 659 #else
 660 PUBLIC S16 RgLiTfuCntrlReq(pst, spId, cntrlReq)
 661 Pst * pst;
 662 SpId spId;
 663 TfuCntrlReqInfo * cntrlReq;
 664 #endif
 665 {
 666
 667    TRC3(RgLiTfuCntrlReq)
 668
 669    RETVALUE((*RgLiTfuCntrlReqMt[pst->selector])(pst, spId, cntrlReq));
 670
 671 }
 672
 673
 674 \f
 675 /***********************************************************
 676 *
 677 *     Func : RgLiTfuDatReq
 678 *
 679 *
 680 *     Desc : This Primitive carries the Data PDUs from MAC to PHY for
 681   * transmission.
 682   * @details The data being sent in this primitive is meant to be transmitted on
 683   * the downlink channel PDSCH and PBCH (if present). To facilitate physical
 684   * layer processing, requisite control information is also sent along with the
 685   * data.
 686   * @sa TfUiTfuCntrlReq
 687   * @param pst
 688   * @param spId
 689   * @param tfuDatReq pointer to TfuDatReqInfo
 690   * @return
 691 *
 692 *
 693 *     Ret  : S16
 694 *
 695 *     Notes:
 696 *
 697 *     File  :
 698 *
 699 **********************************************************/
 700 #ifdef ANSI
 701 PUBLIC S16 RgLiTfuDatReq
 702 (
 703 Pst * pst,
 704 SpId spId,
 705 TfuDatReqInfo * datReq
 706 )
 707 #else
 708 PUBLIC S16 RgLiTfuDatReq(pst, spId, datReq)
 709 Pst * pst;
 710 SpId spId;
 711 TfuDatReqInfo * datReq;
 712 #endif
 713 {
 714
 715    TRC3(RgLiTfuDatReq)
 716
 717    RETVALUE((*RgLiTfuDatReqMt[pst->selector])(pst, spId, datReq));
 718
 719 }
 720
 721 #ifdef L2_OPTMZ
 722 \f
 723 /***********************************************************
 724 *
 725 *     Func : RgLiTfuDelDatReq
 726 *
 727 *
 728 *     Desc : This Primitive is used to delete datReq in CL when there is ueId change.
 729   * @details: This primitive is required when L2_OPMZ flag is elabed. this is required
 730   *           To delete datRq PDUs from CL for the Ue for which Ue Id got changed or
 731   *           anyother similar scenario
 732   * @sa TfUiTfuDelDatReq
 733   * @param pst
 734   * @param spId
 735   * @param tfuDelDatReq pointer to TfuDelDatReqInfo
 736   * @return
 737 *
 738 *
 739 *     Ret  : S16
 740 *
 741 *     Notes:
 742 *
 743 *     File  :
 744 *
 745 **********************************************************/
 746 #ifdef ANSI
 747 PUBLIC S16 RgLiTfuDelDatReq
 748 (
 749 Pst * pst,
 750 SpId spId,
 751 TfuDelDatReqInfo * delDatReq
 752 )
 753 #else
 754 PUBLIC S16 RgLiTfuDelDatReq(pst, spId, delDatReq)
 755 Pst * pst;
 756 SpId spId;
 757 TfuDelDatReqInfo * delDatReq;
 758 #endif
 759 {
 760
 761    TRC3(RgLiTfuDelDatReq)
 762
 763    RETVALUE((*RgLiTfuDelDatReqMt[pst->selector])(pst, spId, delDatReq));
 764
 765 }
 766 #endif /* L2_OPTMZ*/
 767
 768 #endif /*--ifdef RG--*/
 769
 770 #ifdef PTRGLITFU
 771
 772
 773 \f
 774 /***********************************************************
 775 *
 776 *     Func : PtLiTfuBndReq
 777 *
 778 *
 779 *     Desc : This API is used to send a Bind Request from MAC to PHY.
 780  * @param pst Pointer to the post structure.
 781  * @param suId SAP ID of the service user.
 782  * @param spId SAP ID of the service provider.
 783  * @return ROK/RFAILED
 784 *
 785 *
 786 *     Ret  : S16
 787 *
 788 *     Notes:
 789 *
 790 *     File  :
 791 *
 792 **********************************************************/
 793 #ifdef ANSI
 794 PUBLIC S16 PtLiTfuBndReq
 795 (
 796 Pst * pst,
 797 SuId suId,
 798 SpId spId
 799 )
 800 #else
 801 PUBLIC S16 PtLiTfuBndReq(pst, suId, spId)
 802 Pst * pst;
 803 SuId suId;
 804 SpId spId;
 805 #endif
 806 {
 807
 808    TRC3(PtLiTfuBndReq)
 809
 810    UNUSED(pst);
 811    UNUSED(suId);
 812    UNUSED(spId);
 813
 814    RETVALUE(ROK);
 815
 816 }
 817
 818
 819 \f
 820 /***********************************************************
 821 *
 822 *     Func : PtLiTfuSchBndReq
 823 *
 824 *
 825 *     Desc : This API is used to send a Bind Request from Scheduler to PHY.
 826  * @param pst Pointer to the post structure.
 827  * @param suId SAP ID of the service user.
 828  * @param spId SAP ID of the service provider.
 829  * @return ROK/RFAILED
 830 *
 831 *
 832 *     Ret  : S16
 833 *
 834 *     Notes:
 835 *
 836 *     File  :
 837 *
 838 **********************************************************/
 839 #ifdef ANSI
 840 PUBLIC S16 PtLiTfuSchBndReq
 841 (
 842 Pst * pst,
 843 SuId suId,
 844 SpId spId
 845 )
 846 #else
 847 PUBLIC S16 PtLiTfuSchBndReq(pst, suId, spId)
 848 Pst * pst;
 849 SuId suId;
 850 SpId spId;
 851 #endif
 852 {
 853
 854    TRC3(PtLiTfuSchBndReq)
 855
 856    UNUSED(pst);
 857    UNUSED(suId);
 858    UNUSED(spId);
 859
 860    RETVALUE(ROK);
 861
 862 }
 863
 864
 865 \f
 866 /***********************************************************
 867 *
 868 *     Func : PtLiTfuUbndReq
 869 *
 870 *
 871 *     Desc : This API is used to send an Unbind Request from MAC to PHY.
 872  * @param pst Pointer to the post structure.
 873  * @param suId SAP ID of the service provider.
 874  * @param reason Reason for Unbind request.
 875  * @return ROK/RFAILED
 876 *
 877 *
 878 *     Ret  : S16
 879 *
 880 *     Notes:
 881 *
 882 *     File  :
 883 *
 884 **********************************************************/
 885 #ifdef ANSI
 886 PUBLIC S16 PtLiTfuUbndReq
 887 (
 888 Pst * pst,
 889 SpId spId,
 890 Reason reason
 891 )
 892 #else
 893 PUBLIC S16 PtLiTfuUbndReq(pst, spId, reason)
 894 Pst * pst;
 895 SpId spId;
 896 Reason reason;
 897 #endif
 898 {
 899
 900    TRC3(PtLiTfuUbndReq)
 901
 902    UNUSED(pst);
 903    UNUSED(spId);
 904    UNUSED(reason);
 905
 906    RETVALUE(ROK);
 907
 908 }
 909
 910
 911 \f
 912 /***********************************************************
 913 *
 914 *     Func : PtLiTfuSchUbndReq
 915 *
 916 *
 917 *     Desc : This API is used to send an Unbind Request from Scheduler to PHY.
 918  * @param pst Pointer to the post structure.
 919  * @param suId SAP ID of the service provider.
 920  * @param reason Reason for Unbind request.
 921  * @return ROK/RFAILED
 922 *
 923 *
 924 *     Ret  : S16
 925 *
 926 *     Notes:
 927 *
 928 *     File  :
 929 *
 930 **********************************************************/
 931 #ifdef ANSI
 932 PUBLIC S16 PtLiTfuSchUbndReq
 933 (
 934 Pst * pst,
 935 SpId spId,
 936 Reason reason
 937 )
 938 #else
 939 PUBLIC S16 PtLiTfuSchUbndReq(pst, spId, reason)
 940 Pst * pst;
 941 SpId spId;
 942 Reason reason;
 943 #endif
 944 {
 945
 946    TRC3(PtLiTfuSchUbndReq)
 947
 948    UNUSED(pst);
 949    UNUSED(spId);
 950    UNUSED(reason);
 951
 952    RETVALUE(ROK);
 953
 954 }
 955
 956
 957 \f
 958 /***********************************************************
 959 *
 960 *     Func : PtLiTfuRecpReq
 961 *
 962 *
 963 *     Desc : This primitive is sent from Scheduler to PHY.
 964  * @details This primitive provides PHY with all the information required by
 965  * PHY to decode transmissions from the UE on either PUCCH or PUSCH.
 966  * -# On PUCCH UE can transmit the following
 967  *    -# SR
 968  *    -# HARQ feedback
 969  *    -# CQI report
 970  *    -# HARQ + CQI
 971  *    -# HARQ + SR
 972  * -# On PUSCH UE can transmit the following
 973  *    -# Data
 974  *    -# Data + CQI
 975  *    -# Data + HARQ Feedback
 976  * This primitive carries all the information for the expected subframe for all
 977  * the UEs that have been scheduled to transmit.
 978  * @param pst Pointer to the post structure.
 979  * @param spId SAP ID of the service provider.
 980  * @param recpReq Pointer to the TfuRecpReqInfo structure.
 981  * @return ROK/RFAILED
 982 *
 983 *
 984 *     Ret  : S16
 985 *
 986 *     Notes:
 987 *
 988 *     File  :
 989 *
 990 **********************************************************/
 991 #ifdef ANSI
 992 PUBLIC S16 PtLiTfuRecpReq
 993 (
 994 Pst * pst,
 995 SpId spId,
 996 TfuRecpReqInfo * recpReq
 997 )
 998 #else
 999 PUBLIC S16 PtLiTfuRecpReq(pst, spId, recpReq)
1000 Pst * pst;
1001 SpId spId;
1002 TfuRecpReqInfo * recpReq;
1003 #endif
1004 {
1005
1006    TRC3(PtLiTfuRecpReq)
1007
1008    UNUSED(pst);
1009    UNUSED(spId);
1010    UNUSED(recpReq);
1011
1012    RETVALUE(ROK);
1013
1014 }
1015
1016
1017 \f
1018 /***********************************************************
1019 *
1020 *     Func : PtLiTfuCntrlReq
1021 *
1022 *
1023 *     Desc : This Primitive is sent from Scheduler to PHY. It provides PHY with
1024   * all the control information
1025   * @details This primitive carries the information sent on the following
1026   * channels -
1027   * -# PDCCH
1028   * -# PHICH
1029   * -# PCFICH
1030   *
1031   * @param pst
1032   * @param spId
1033   * @param cntrlReq pointer to TfuCntrlReqInfo
1034   * @return ROK/RFAILED
1035 *
1036 *
1037 *     Ret  : S16
1038 *
1039 *     Notes:
1040 *
1041 *     File  :
1042 *
1043 **********************************************************/
1044 #ifdef ANSI
1045 PUBLIC S16 PtLiTfuCntrlReq
1046 (
1047 Pst * pst,
1048 SpId spId,
1049 TfuCntrlReqInfo * cntrlReq
1050 )
1051 #else
1052 PUBLIC S16 PtLiTfuCntrlReq(pst, spId, cntrlReq)
1053 Pst * pst;
1054 SpId spId;
1055 TfuCntrlReqInfo * cntrlReq;
1056 #endif
1057 {
1058
1059    TRC3(PtLiTfuCntrlReq)
1060
1061    UNUSED(pst);
1062    UNUSED(spId);
1063    UNUSED(cntrlReq);
1064
1065    RETVALUE(ROK);
1066
1067 }
1068
1069
1070 \f
1071 /***********************************************************
1072 *
1073 *     Func : PtLiTfuDatReq
1074 *
1075 *
1076 *     Desc : This Primitive carries the Data PDUs from MAC to PHY for
1077   * transmission.
1078   * @details The data being sent in this primitive is meant to be transmitted on
1079   * the downlink channel PDSCH and PBCH (if present). To facilitate physical
1080   * layer processing, requisite control information is also sent along with the
1081   * data.
1082   * @sa TfUiTfuCntrlReq
1083   * @param pst
1084   * @param spId
1085   * @param tfuDatReq pointer to TfuDatReqInfo
1086   * @return
1087 *
1088 *
1089 *     Ret  : S16
1090 *
1091 *     Notes:
1092 *
1093 *     File  :
1094 *
1095 **********************************************************/
1096 #ifdef ANSI
1097 PUBLIC S16 PtLiTfuDatReq
1098 (
1099 Pst * pst,
1100 SpId spId,
1101 TfuDatReqInfo * datReq
1102 )
1103 #else
1104 PUBLIC S16 PtLiTfuDatReq(pst, spId, datReq)
1105 Pst * pst;
1106 SpId spId;
1107 TfuDatReqInfo * datReq;
1108 #endif
1109 {
1110
1111    TRC3(PtLiTfuDatReq)
1112
1113    UNUSED(pst);
1114    UNUSED(spId);
1115    UNUSED(datReq);
1116
1117    RETVALUE(ROK);
1118
1119 }
1120
1121 \f
1122 #ifdef L2_OPTMZ
1123 /***********************************************************
1124 *
1125 *     Func : PtLiTfuDelDatReq
1126 *
1127 *
1128 *   @brief This Primitive carries cellId and UeId for which datReq need to be deleted.
1129   * @details This primitive is used to send delDatReq to CL to delete the PDUs of
1130     * UE which has been deleted in MAC due to ueId change or anyother scenario
1131
1132   * @details The data being sent in this primitive is meant to be transmitted on
1133   * @sa TfUiTfuDelDatReq
1134   * @param pst
1135   * @param spId
1136   * @param tfuDelDatReq pointer to TfuDelDatReqInfo
1137   * @return
1138 *
1139 *
1140 *     Ret  : S16
1141 *
1142 *     Notes:
1143 *
1144 *     File  :
1145 *
1146 **********************************************************/
1147 #ifdef ANSI
1148 PUBLIC S16 PtLiTfuDelDatReq
1149 (
1150 Pst * pst,
1151 SpId spId,
1152 TfuDelDatReqInfo * delDatReq
1153 )
1154 #else
1155 PUBLIC S16 PtLiTfuDelDatReq(pst, spId, delDatReq)
1156 Pst * pst;
1157 SpId spId;
1158 TfuDelDatReqInfo * DelDatReq;
1159 #endif
1160 {
1161
1162    TRC3(PtLiTfuDelDatReq)
1163
1164    UNUSED(pst);
1165    UNUSED(spId);
1166    UNUSED(delDatReq);
1167
1168    RETVALUE(ROK);
1169
1170 }
1171 #endif /*L2_OPTMZ*/
1172
1173 #endif /*--ifdef PTRGLITFU--*/
1174
1175 #ifdef __cplusplus
1176 }
1177 #endif /* __cplusplus */
1178 \f
1179 /**********************************************************************
1180
1181          End of file
1182 **********************************************************************/