drivers/staging/tidspbridge/pmgr/chnl.c

   1 /*
   2  * chnl.c
   3  *
   4  * DSP-BIOS Bridge driver support functions for TI OMAP processors.
   5  *
   6  * DSP API channel interface: multiplexes data streams through the single
   7  * physical link managed by a Bridge Bridge driver.
   8  *
   9  * Copyright (C) 2005-2006 Texas Instruments, Inc.
  10  *
  11  * This package is free software; you can redistribute it and/or modify
  12  * it under the terms of the GNU General Public License version 2 as
  13  * published by the Free Software Foundation.
  14  *
  15  * THIS PACKAGE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
  16  * IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
  17  * WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  18  */
  19
  20 #include <linux/types.h>
  21 /*  ----------------------------------- Host OS */
  22 #include <dspbridge/host_os.h>
  23
  24 /*  ----------------------------------- DSP/BIOS Bridge */
  25 #include <dspbridge/dbdefs.h>
  26
  27 /*  ----------------------------------- OS Adaptation Layer */
  28 #include <dspbridge/sync.h>
  29
  30 /*  ----------------------------------- Platform Manager */
  31 #include <dspbridge/proc.h>
  32 #include <dspbridge/dev.h>
  33
  34 /*  ----------------------------------- Others */
  35 #include <dspbridge/chnlpriv.h>
  36 #include <chnlobj.h>
  37
  38 /*  ----------------------------------- This */
  39 #include <dspbridge/chnl.h>
  40
  41 /*
  42  *  ======== chnl_create ========
  43  *  Purpose:
  44  *      Create a channel manager object, responsible for opening new channels
  45  *      and closing old ones for a given 'Bridge board.
  46  */
  47 int chnl_create(struct chnl_mgr **channel_mgr,
  48                        struct dev_object *hdev_obj,
  49                        const struct chnl_mgrattrs *mgr_attrts)
  50 {
  51         int status;
  52         struct chnl_mgr *hchnl_mgr;
  53         struct chnl_mgr_ *chnl_mgr_obj = NULL;
  54
  55         *channel_mgr = NULL;
  56
  57         /* Validate args: */
  58         if ((0 < mgr_attrts->max_channels) &&
  59             (mgr_attrts->max_channels <= CHNL_MAXCHANNELS))
  60                 status = 0;
  61         else if (mgr_attrts->max_channels == 0)
  62                 status = -EINVAL;
  63         else
  64                 status = -ECHRNG;
  65
  66         if (mgr_attrts->word_size == 0)
  67                 status = -EINVAL;
  68
  69         if (!status) {
  70                 status = dev_get_chnl_mgr(hdev_obj, &hchnl_mgr);
  71                 if (!status && hchnl_mgr != NULL)
  72                         status = -EEXIST;
  73
  74         }
  75
  76         if (!status) {
  77                 struct bridge_drv_interface *intf_fxns;
  78                 dev_get_intf_fxns(hdev_obj, &intf_fxns);
  79                 /* Let Bridge channel module finish the create: */
  80                 status = (*intf_fxns->chnl_create) (&hchnl_mgr, hdev_obj,
  81                                                         mgr_attrts);
  82                 if (!status) {
  83                         /* Fill in DSP API channel module's fields of the
  84                          * chnl_mgr structure */
  85                         chnl_mgr_obj = (struct chnl_mgr_ *)hchnl_mgr;
  86                         chnl_mgr_obj->intf_fxns = intf_fxns;
  87                         /* Finally, return the new channel manager handle: */
  88                         *channel_mgr = hchnl_mgr;
  89                 }
  90         }
  91
  92         return status;
  93 }
  94
  95 /*
  96  *  ======== chnl_destroy ========
  97  *  Purpose:
  98  *      Close all open channels, and destroy the channel manager.
  99  */
 100 int chnl_destroy(struct chnl_mgr *hchnl_mgr)
 101 {
 102         struct chnl_mgr_ *chnl_mgr_obj = (struct chnl_mgr_ *)hchnl_mgr;
 103         struct bridge_drv_interface *intf_fxns;
 104         int status;
 105
 106         if (chnl_mgr_obj) {
 107                 intf_fxns = chnl_mgr_obj->intf_fxns;
 108                 /* Let Bridge channel module destroy the chnl_mgr: */
 109                 status = (*intf_fxns->chnl_destroy) (hchnl_mgr);
 110         } else {
 111                 status = -EFAULT;
 112         }
 113
 114         return status;
 115 }