4 * DSP-BIOS Bridge driver support functions for TI OMAP processors.
6 * Processor interface at the driver level.
8 * Copyright (C) 2005-2006 Texas Instruments, Inc.
10 * This package is free software; you can redistribute it and/or modify
11 * it under the terms of the GNU General Public License version 2 as
12 * published by the Free Software Foundation.
14 * THIS PACKAGE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
15 * IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
16 * WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
19 #include <linux/types.h>
20 /* ------------------------------------ Host OS */
21 #include <linux/dma-mapping.h>
22 #include <linux/scatterlist.h>
23 #include <dspbridge/host_os.h>
25 /* ----------------------------------- DSP/BIOS Bridge */
26 #include <dspbridge/dbdefs.h>
28 /* ----------------------------------- OS Adaptation Layer */
29 #include <dspbridge/ntfy.h>
30 #include <dspbridge/sync.h>
31 /* ----------------------------------- Bridge Driver */
32 #include <dspbridge/dspdefs.h>
33 #include <dspbridge/dspdeh.h>
34 /* ----------------------------------- Platform Manager */
35 #include <dspbridge/cod.h>
36 #include <dspbridge/dev.h>
37 #include <dspbridge/procpriv.h>
38 #include <dspbridge/dmm.h>
40 /* ----------------------------------- Resource Manager */
41 #include <dspbridge/mgr.h>
42 #include <dspbridge/node.h>
43 #include <dspbridge/nldr.h>
44 #include <dspbridge/rmm.h>
46 /* ----------------------------------- Others */
47 #include <dspbridge/dbdcd.h>
48 #include <dspbridge/msg.h>
49 #include <dspbridge/dspioctl.h>
50 #include <dspbridge/drv.h>
52 /* ----------------------------------- This */
53 #include <dspbridge/proc.h>
54 #include <dspbridge/pwr.h>
56 #include <dspbridge/resourcecleanup.h>
57 /* ----------------------------------- Defines, Data Structures, Typedefs */
58 #define MAXCMDLINELEN 255
59 #define PROC_ENVPROCID "PROC_ID=%d"
60 #define MAXPROCIDLEN (8 + 5)
61 #define PROC_DFLT_TIMEOUT 10000 /* Time out in milliseconds */
62 #define PWR_TIMEOUT 500 /* Sleep/wake timout in msec */
63 #define EXTEND "_EXT_END" /* Extmem end addr in DSP binary */
65 #define DSP_CACHE_LINE 128
67 #define BUFMODE_MASK (3 << 14)
69 /* Buffer modes from DSP perspective */
70 #define RBUF 0x4000 /* Input buffer */
71 #define WBUF 0x8000 /* Output Buffer */
73 extern struct device *bridge;
75 /* ----------------------------------- Globals */
77 /* The proc_object structure. */
79 struct list_head link; /* Link to next proc_object */
80 struct dev_object *dev_obj; /* Device this PROC represents */
81 u32 process; /* Process owning this Processor */
82 struct mgr_object *mgr_obj; /* Manager Object Handle */
83 u32 attach_count; /* Processor attach count */
84 u32 processor_id; /* Processor number */
85 u32 timeout; /* Time out count */
86 enum dsp_procstate proc_state; /* Processor state */
87 u32 unit; /* DDSP unit number */
88 bool is_already_attached; /*
89 * True if the Device below has
92 struct ntfy_object *ntfy_obj; /* Manages notifications */
93 /* Bridge Context Handle */
94 struct bridge_dev_context *bridge_context;
95 /* Function interface to Bridge driver */
96 struct bridge_drv_interface *intf_fxns;
98 struct list_head proc_list;
101 DEFINE_MUTEX(proc_lock); /* For critical sections */
103 /* ----------------------------------- Function Prototypes */
104 static int proc_monitor(struct proc_object *proc_obj);
105 static s32 get_envp_count(char **envp);
106 static char **prepend_envp(char **new_envp, char **envp, s32 envp_elems,
107 s32 cnew_envp, char *sz_var);
109 /* remember mapping information */
110 static struct dmm_map_object *add_mapping_info(struct process_context *pr_ctxt,
111 u32 mpu_addr, u32 dsp_addr, u32 size)
113 struct dmm_map_object *map_obj;
115 u32 num_usr_pgs = size / PG_SIZE4K;
117 pr_debug("%s: adding map info: mpu_addr 0x%x virt 0x%x size 0x%x\n",
121 map_obj = kzalloc(sizeof(struct dmm_map_object), GFP_KERNEL);
123 pr_err("%s: kzalloc failed\n", __func__);
126 INIT_LIST_HEAD(&map_obj->link);
128 map_obj->pages = kcalloc(num_usr_pgs, sizeof(struct page *),
130 if (!map_obj->pages) {
131 pr_err("%s: kzalloc failed\n", __func__);
136 map_obj->mpu_addr = mpu_addr;
137 map_obj->dsp_addr = dsp_addr;
138 map_obj->size = size;
139 map_obj->num_usr_pgs = num_usr_pgs;
141 spin_lock(&pr_ctxt->dmm_map_lock);
142 list_add(&map_obj->link, &pr_ctxt->dmm_map_list);
143 spin_unlock(&pr_ctxt->dmm_map_lock);
148 static int match_exact_map_obj(struct dmm_map_object *map_obj,
149 u32 dsp_addr, u32 size)
151 if (map_obj->dsp_addr == dsp_addr && map_obj->size != size)
152 pr_err("%s: addr match (0x%x), size don't (0x%x != 0x%x)\n",
153 __func__, dsp_addr, map_obj->size, size);
155 return map_obj->dsp_addr == dsp_addr &&
156 map_obj->size == size;
159 static void remove_mapping_information(struct process_context *pr_ctxt,
160 u32 dsp_addr, u32 size)
162 struct dmm_map_object *map_obj;
164 pr_debug("%s: looking for virt 0x%x size 0x%x\n", __func__,
167 spin_lock(&pr_ctxt->dmm_map_lock);
168 list_for_each_entry(map_obj, &pr_ctxt->dmm_map_list, link) {
169 pr_debug("%s: candidate: mpu_addr 0x%x virt 0x%x size 0x%x\n",
175 if (match_exact_map_obj(map_obj, dsp_addr, size)) {
176 pr_debug("%s: match, deleting map info\n", __func__);
177 list_del(&map_obj->link);
178 kfree(map_obj->dma_info.sg);
179 kfree(map_obj->pages);
183 pr_debug("%s: candidate didn't match\n", __func__);
186 pr_err("%s: failed to find given map info\n", __func__);
188 spin_unlock(&pr_ctxt->dmm_map_lock);
191 static int match_containing_map_obj(struct dmm_map_object *map_obj,
192 u32 mpu_addr, u32 size)
194 u32 map_obj_end = map_obj->mpu_addr + map_obj->size;
196 return mpu_addr >= map_obj->mpu_addr &&
197 mpu_addr + size <= map_obj_end;
200 static struct dmm_map_object *find_containing_mapping(
201 struct process_context *pr_ctxt,
202 u32 mpu_addr, u32 size)
204 struct dmm_map_object *map_obj;
205 pr_debug("%s: looking for mpu_addr 0x%x size 0x%x\n", __func__,
208 spin_lock(&pr_ctxt->dmm_map_lock);
209 list_for_each_entry(map_obj, &pr_ctxt->dmm_map_list, link) {
210 pr_debug("%s: candidate: mpu_addr 0x%x virt 0x%x size 0x%x\n",
215 if (match_containing_map_obj(map_obj, mpu_addr, size)) {
216 pr_debug("%s: match!\n", __func__);
220 pr_debug("%s: no match!\n", __func__);
225 spin_unlock(&pr_ctxt->dmm_map_lock);
229 static int find_first_page_in_cache(struct dmm_map_object *map_obj,
230 unsigned long mpu_addr)
232 u32 mapped_base_page = map_obj->mpu_addr >> PAGE_SHIFT;
233 u32 requested_base_page = mpu_addr >> PAGE_SHIFT;
234 int pg_index = requested_base_page - mapped_base_page;
236 if (pg_index < 0 || pg_index >= map_obj->num_usr_pgs) {
237 pr_err("%s: failed (got %d)\n", __func__, pg_index);
241 pr_debug("%s: first page is %d\n", __func__, pg_index);
245 static inline struct page *get_mapping_page(struct dmm_map_object *map_obj,
248 pr_debug("%s: looking for pg_i %d, num_usr_pgs: %d\n", __func__,
249 pg_i, map_obj->num_usr_pgs);
251 if (pg_i < 0 || pg_i >= map_obj->num_usr_pgs) {
252 pr_err("%s: requested pg_i %d is out of mapped range\n",
257 return map_obj->pages[pg_i];
261 * ======== proc_attach ========
263 * Prepare for communication with a particular DSP processor, and return
264 * a handle to the processor object.
267 proc_attach(u32 processor_id,
268 const struct dsp_processorattrin *attr_in,
269 void **ph_processor, struct process_context *pr_ctxt)
272 struct dev_object *hdev_obj;
273 struct proc_object *p_proc_object = NULL;
274 struct mgr_object *hmgr_obj = NULL;
275 struct drv_object *hdrv_obj = NULL;
276 struct drv_data *drv_datap = dev_get_drvdata(bridge);
279 if (pr_ctxt->processor) {
280 *ph_processor = pr_ctxt->processor;
284 /* Get the Driver and Manager Object Handles */
285 if (!drv_datap || !drv_datap->drv_object || !drv_datap->mgr_object) {
287 pr_err("%s: Failed to get object handles\n", __func__);
289 hdrv_obj = drv_datap->drv_object;
290 hmgr_obj = drv_datap->mgr_object;
294 /* Get the Device Object */
295 status = drv_get_dev_object(processor_id, hdrv_obj, &hdev_obj);
298 status = dev_get_dev_type(hdev_obj, &dev_type);
303 /* If we made it this far, create the Processor object: */
304 p_proc_object = kzalloc(sizeof(struct proc_object), GFP_KERNEL);
305 /* Fill out the Processor Object: */
306 if (p_proc_object == NULL) {
310 p_proc_object->dev_obj = hdev_obj;
311 p_proc_object->mgr_obj = hmgr_obj;
312 p_proc_object->processor_id = dev_type;
313 /* Store TGID instead of process handle */
314 p_proc_object->process = current->tgid;
316 INIT_LIST_HEAD(&p_proc_object->proc_list);
319 p_proc_object->timeout = attr_in->timeout;
321 p_proc_object->timeout = PROC_DFLT_TIMEOUT;
323 status = dev_get_intf_fxns(hdev_obj, &p_proc_object->intf_fxns);
325 status = dev_get_bridge_context(hdev_obj,
326 &p_proc_object->bridge_context);
328 kfree(p_proc_object);
330 kfree(p_proc_object);
335 /* Create the Notification Object */
336 /* This is created with no event mask, no notify mask
337 * and no valid handle to the notification. They all get
338 * filled up when proc_register_notify is called */
339 p_proc_object->ntfy_obj = kmalloc(sizeof(struct ntfy_object),
341 if (p_proc_object->ntfy_obj)
342 ntfy_init(p_proc_object->ntfy_obj);
347 /* Insert the Processor Object into the DEV List.
348 * Return handle to this Processor Object:
349 * Find out if the Device is already attached to a
350 * Processor. If so, return AlreadyAttached status */
351 status = dev_insert_proc_object(p_proc_object->dev_obj,
354 is_already_attached);
356 if (p_proc_object->is_already_attached)
359 if (p_proc_object->ntfy_obj) {
360 ntfy_delete(p_proc_object->ntfy_obj);
361 kfree(p_proc_object->ntfy_obj);
364 kfree(p_proc_object);
367 *ph_processor = (void *)p_proc_object;
368 pr_ctxt->processor = *ph_processor;
369 (void)proc_notify_clients(p_proc_object,
370 DSP_PROCESSORATTACH);
373 /* Don't leak memory if status is failed */
374 kfree(p_proc_object);
380 static int get_exec_file(struct cfg_devnode *dev_node_obj,
381 struct dev_object *hdev_obj,
382 u32 size, char *exec_file)
386 struct drv_data *drv_datap = dev_get_drvdata(bridge);
388 dev_get_dev_type(hdev_obj, (u8 *) &dev_type);
393 if (dev_type == DSP_UNIT) {
394 if (!drv_datap || !drv_datap->base_img)
397 if (strlen(drv_datap->base_img) > size)
400 strcpy(exec_file, drv_datap->base_img);
401 } else if (dev_type == IVA_UNIT && iva_img) {
402 len = strlen(iva_img);
403 strncpy(exec_file, iva_img, len + 1);
412 * ======== proc_auto_start ======== =
414 * A Particular device gets loaded with the default image
415 * if the AutoStart flag is set.
417 * hdev_obj: Handle to the Device
419 * 0: On Successful Loading
420 * -EPERM General Failure
425 int proc_auto_start(struct cfg_devnode *dev_node_obj,
426 struct dev_object *hdev_obj)
429 struct proc_object *p_proc_object;
430 char sz_exec_file[MAXCMDLINELEN];
432 struct mgr_object *hmgr_obj = NULL;
433 struct drv_data *drv_datap = dev_get_drvdata(bridge);
436 /* Create a Dummy PROC Object */
437 if (!drv_datap || !drv_datap->mgr_object) {
439 pr_err("%s: Failed to retrieve the object handle\n", __func__);
442 hmgr_obj = drv_datap->mgr_object;
445 p_proc_object = kzalloc(sizeof(struct proc_object), GFP_KERNEL);
446 if (p_proc_object == NULL) {
450 p_proc_object->dev_obj = hdev_obj;
451 p_proc_object->mgr_obj = hmgr_obj;
452 status = dev_get_intf_fxns(hdev_obj, &p_proc_object->intf_fxns);
454 status = dev_get_bridge_context(hdev_obj,
455 &p_proc_object->bridge_context);
459 /* Stop the Device, put it into standby mode */
460 status = proc_stop(p_proc_object);
465 /* Get the default executable for this board... */
466 dev_get_dev_type(hdev_obj, (u8 *) &dev_type);
467 p_proc_object->processor_id = dev_type;
468 status = get_exec_file(dev_node_obj, hdev_obj, sizeof(sz_exec_file),
471 argv[0] = sz_exec_file;
473 /* ...and try to load it: */
474 status = proc_load(p_proc_object, 1, (const char **)argv, NULL);
476 status = proc_start(p_proc_object);
478 kfree(p_proc_object->last_coff);
479 p_proc_object->last_coff = NULL;
481 kfree(p_proc_object);
487 * ======== proc_ctrl ========
489 * Pass control information to the GPP device driver managing the
492 * This will be an OEM-only function, and not part of the DSP/BIOS Bridge
493 * application developer's API.
494 * Call the bridge_dev_ctrl fxn with the Argument. This is a Synchronous
495 * Operation. arg can be null.
497 int proc_ctrl(void *hprocessor, u32 dw_cmd, struct dsp_cbdata * arg)
500 struct proc_object *p_proc_object = hprocessor;
504 /* intercept PWR deep sleep command */
505 if (dw_cmd == BRDIOCTL_DEEPSLEEP) {
506 timeout = arg->cb_data;
507 status = pwr_sleep_dsp(PWR_DEEPSLEEP, timeout);
509 /* intercept PWR emergency sleep command */
510 else if (dw_cmd == BRDIOCTL_EMERGENCYSLEEP) {
511 timeout = arg->cb_data;
512 status = pwr_sleep_dsp(PWR_EMERGENCYDEEPSLEEP, timeout);
513 } else if (dw_cmd == PWR_DEEPSLEEP) {
514 /* timeout = arg->cb_data; */
515 status = pwr_sleep_dsp(PWR_DEEPSLEEP, timeout);
517 /* intercept PWR wake commands */
518 else if (dw_cmd == BRDIOCTL_WAKEUP) {
519 timeout = arg->cb_data;
520 status = pwr_wake_dsp(timeout);
521 } else if (dw_cmd == PWR_WAKEUP) {
522 /* timeout = arg->cb_data; */
523 status = pwr_wake_dsp(timeout);
525 if (!((*p_proc_object->intf_fxns->dev_cntrl)
526 (p_proc_object->bridge_context, dw_cmd,
540 * ======== proc_detach ========
542 * Destroys the Processor Object. Removes the notification from the Dev
545 int proc_detach(struct process_context *pr_ctxt)
548 struct proc_object *p_proc_object = NULL;
550 p_proc_object = (struct proc_object *)pr_ctxt->processor;
553 /* Notify the Client */
554 ntfy_notify(p_proc_object->ntfy_obj, DSP_PROCESSORDETACH);
555 /* Remove the notification memory */
556 if (p_proc_object->ntfy_obj) {
557 ntfy_delete(p_proc_object->ntfy_obj);
558 kfree(p_proc_object->ntfy_obj);
561 kfree(p_proc_object->last_coff);
562 p_proc_object->last_coff = NULL;
563 /* Remove the Proc from the DEV List */
564 (void)dev_remove_proc_object(p_proc_object->dev_obj,
565 (u32) p_proc_object);
566 /* Free the Processor Object */
567 kfree(p_proc_object);
568 pr_ctxt->processor = NULL;
577 * ======== proc_enum_nodes ========
579 * Enumerate and get configuration information about nodes allocated
580 * on a DSP processor.
582 int proc_enum_nodes(void *hprocessor, void **node_tab,
583 u32 node_tab_size, u32 *pu_num_nodes,
587 struct proc_object *p_proc_object = (struct proc_object *)hprocessor;
588 struct node_mgr *hnode_mgr = NULL;
591 if (!(dev_get_node_manager(p_proc_object->dev_obj,
594 status = node_enum_nodes(hnode_mgr, node_tab,
607 /* Cache operation against kernel address instead of users */
608 static int build_dma_sg(struct dmm_map_object *map_obj, unsigned long start,
609 ssize_t len, int pg_i)
612 unsigned long offset;
615 struct scatterlist *sg = map_obj->dma_info.sg;
618 page = get_mapping_page(map_obj, pg_i);
620 pr_err("%s: no page for %08lx\n", __func__, start);
623 } else if (IS_ERR(page)) {
624 pr_err("%s: err page for %08lx(%lu)\n", __func__, start,
630 offset = start & ~PAGE_MASK;
631 rest = min_t(ssize_t, PAGE_SIZE - offset, len);
633 sg_set_page(&sg[i], page, rest, offset);
640 if (i != map_obj->dma_info.num_pages) {
641 pr_err("%s: bad number of sg iterations\n", __func__);
650 static int memory_regain_ownership(struct dmm_map_object *map_obj,
651 unsigned long start, ssize_t len, enum dma_data_direction dir)
654 unsigned long first_data_page = start >> PAGE_SHIFT;
655 unsigned long last_data_page = ((u32)(start + len - 1) >> PAGE_SHIFT);
656 /* calculating the number of pages this area spans */
657 unsigned long num_pages = last_data_page - first_data_page + 1;
658 struct bridge_dma_map_info *dma_info = &map_obj->dma_info;
663 if (dma_info->dir != dir || dma_info->num_pages != num_pages) {
664 pr_err("%s: dma info doesn't match given params\n", __func__);
668 dma_unmap_sg(bridge, dma_info->sg, num_pages, dma_info->dir);
670 pr_debug("%s: dma_map_sg unmapped\n", __func__);
674 map_obj->dma_info.sg = NULL;
680 /* Cache operation against kernel address instead of users */
681 static int memory_give_ownership(struct dmm_map_object *map_obj,
682 unsigned long start, ssize_t len, enum dma_data_direction dir)
684 int pg_i, ret, sg_num;
685 struct scatterlist *sg;
686 unsigned long first_data_page = start >> PAGE_SHIFT;
687 unsigned long last_data_page = ((u32)(start + len - 1) >> PAGE_SHIFT);
688 /* calculating the number of pages this area spans */
689 unsigned long num_pages = last_data_page - first_data_page + 1;
691 pg_i = find_first_page_in_cache(map_obj, start);
693 pr_err("%s: failed to find first page in cache\n", __func__);
698 sg = kcalloc(num_pages, sizeof(*sg), GFP_KERNEL);
700 pr_err("%s: kcalloc failed\n", __func__);
705 sg_init_table(sg, num_pages);
707 /* cleanup a previous sg allocation */
708 /* this may happen if application doesn't signal for e/o DMA */
709 kfree(map_obj->dma_info.sg);
711 map_obj->dma_info.sg = sg;
712 map_obj->dma_info.dir = dir;
713 map_obj->dma_info.num_pages = num_pages;
715 ret = build_dma_sg(map_obj, start, len, pg_i);
719 sg_num = dma_map_sg(bridge, sg, num_pages, dir);
721 pr_err("%s: dma_map_sg failed: %d\n", __func__, sg_num);
726 pr_debug("%s: dma_map_sg mapped %d elements\n", __func__, sg_num);
727 map_obj->dma_info.sg_num = sg_num;
733 map_obj->dma_info.sg = NULL;
738 int proc_begin_dma(void *hprocessor, void *pmpu_addr, u32 ul_size,
739 enum dma_data_direction dir)
741 /* Keep STATUS here for future additions to this function */
743 struct process_context *pr_ctxt = (struct process_context *) hprocessor;
744 struct dmm_map_object *map_obj;
751 pr_debug("%s: addr 0x%x, size 0x%x, type %d\n", __func__,
755 mutex_lock(&proc_lock);
757 /* find requested memory are in cached mapping information */
758 map_obj = find_containing_mapping(pr_ctxt, (u32) pmpu_addr, ul_size);
760 pr_err("%s: find_containing_mapping failed\n", __func__);
765 if (memory_give_ownership(map_obj, (u32) pmpu_addr, ul_size, dir)) {
766 pr_err("%s: InValid address parameters %p %x\n",
767 __func__, pmpu_addr, ul_size);
772 mutex_unlock(&proc_lock);
778 int proc_end_dma(void *hprocessor, void *pmpu_addr, u32 ul_size,
779 enum dma_data_direction dir)
781 /* Keep STATUS here for future additions to this function */
783 struct process_context *pr_ctxt = (struct process_context *) hprocessor;
784 struct dmm_map_object *map_obj;
791 pr_debug("%s: addr 0x%x, size 0x%x, type %d\n", __func__,
795 mutex_lock(&proc_lock);
797 /* find requested memory are in cached mapping information */
798 map_obj = find_containing_mapping(pr_ctxt, (u32) pmpu_addr, ul_size);
800 pr_err("%s: find_containing_mapping failed\n", __func__);
805 if (memory_regain_ownership(map_obj, (u32) pmpu_addr, ul_size, dir)) {
806 pr_err("%s: InValid address parameters %p %x\n",
807 __func__, pmpu_addr, ul_size);
812 mutex_unlock(&proc_lock);
818 * ======== proc_flush_memory ========
822 int proc_flush_memory(void *hprocessor, void *pmpu_addr,
823 u32 ul_size, u32 ul_flags)
825 enum dma_data_direction dir = DMA_BIDIRECTIONAL;
827 return proc_begin_dma(hprocessor, pmpu_addr, ul_size, dir);
831 * ======== proc_invalidate_memory ========
833 * Invalidates the memory specified
835 int proc_invalidate_memory(void *hprocessor, void *pmpu_addr, u32 size)
837 enum dma_data_direction dir = DMA_FROM_DEVICE;
839 return proc_begin_dma(hprocessor, pmpu_addr, size, dir);
843 * ======== proc_get_resource_info ========
845 * Enumerate the resources currently available on a processor.
847 int proc_get_resource_info(void *hprocessor, u32 resource_type,
848 struct dsp_resourceinfo *resource_info,
849 u32 resource_info_size)
852 struct proc_object *p_proc_object = (struct proc_object *)hprocessor;
853 struct node_mgr *hnode_mgr = NULL;
854 struct nldr_object *nldr_obj = NULL;
855 struct rmm_target_obj *rmm = NULL;
856 struct io_mgr *hio_mgr = NULL; /* IO manager handle */
858 if (!p_proc_object) {
862 switch (resource_type) {
863 case DSP_RESOURCE_DYNDARAM:
864 case DSP_RESOURCE_DYNSARAM:
865 case DSP_RESOURCE_DYNEXTERNAL:
866 case DSP_RESOURCE_DYNSRAM:
867 status = dev_get_node_manager(p_proc_object->dev_obj,
874 status = node_get_nldr_obj(hnode_mgr, &nldr_obj);
876 status = nldr_get_rmm_manager(nldr_obj, &rmm);
879 (enum dsp_memtype)resource_type,
880 (struct dsp_memstat *)
881 &(resource_info->result.
889 case DSP_RESOURCE_PROCLOAD:
890 status = dev_get_io_mgr(p_proc_object->dev_obj, &hio_mgr);
893 p_proc_object->intf_fxns->
894 io_get_proc_load(hio_mgr,
895 (struct dsp_procloadstat *)
896 &(resource_info->result.
910 * ======== proc_get_dev_object ========
912 * Return the Dev Object handle for a given Processor.
915 int proc_get_dev_object(void *hprocessor,
916 struct dev_object **device_obj)
919 struct proc_object *p_proc_object = (struct proc_object *)hprocessor;
922 *device_obj = p_proc_object->dev_obj;
933 * ======== proc_get_state ========
935 * Report the state of the specified DSP processor.
937 int proc_get_state(void *hprocessor,
938 struct dsp_processorstate *proc_state_obj,
942 struct proc_object *p_proc_object = (struct proc_object *)hprocessor;
946 /* First, retrieve BRD state information */
947 status = (*p_proc_object->intf_fxns->brd_status)
948 (p_proc_object->bridge_context, &brd_status);
950 switch (brd_status) {
952 proc_state_obj->proc_state = PROC_STOPPED;
954 case BRD_SLEEP_TRANSITION:
955 case BRD_DSP_HIBERNATION:
958 proc_state_obj->proc_state = PROC_RUNNING;
961 proc_state_obj->proc_state = PROC_LOADED;
964 proc_state_obj->proc_state = PROC_ERROR;
967 proc_state_obj->proc_state = 0xFF;
975 dev_dbg(bridge, "%s, results: status: 0x%x proc_state_obj: 0x%x\n",
976 __func__, status, proc_state_obj->proc_state);
981 * ======== proc_get_trace ========
983 * Retrieve the current contents of the trace buffer, located on the
984 * Processor. Predefined symbols for the trace buffer must have been
985 * configured into the DSP executable.
987 * We support using the symbols SYS_PUTCBEG and SYS_PUTCEND to define a
988 * trace buffer, only. Treat it as an undocumented feature.
989 * This call is destructive, meaning the processor is placed in the monitor
990 * state as a result of this function.
992 int proc_get_trace(void *hprocessor, u8 * pbuf, u32 max_size)
1000 * ======== proc_load ========
1002 * Reset a processor and load a new base program image.
1003 * This will be an OEM-only function, and not part of the DSP/BIOS Bridge
1004 * application developer's API.
1006 int proc_load(void *hprocessor, const s32 argc_index,
1007 const char **user_args, const char **user_envp)
1010 struct proc_object *p_proc_object = (struct proc_object *)hprocessor;
1011 struct io_mgr *hio_mgr; /* IO manager handle */
1012 struct msg_mgr *hmsg_mgr;
1013 struct cod_manager *cod_mgr; /* Code manager handle */
1014 char *pargv0; /* temp argv[0] ptr */
1015 char **new_envp; /* Updated envp[] array. */
1016 char sz_proc_id[MAXPROCIDLEN]; /* Size of "PROC_ID=<n>" */
1017 s32 envp_elems; /* Num elements in envp[]. */
1018 s32 cnew_envp; /* " " in new_envp[] */
1019 s32 nproc_id = 0; /* Anticipate MP version. */
1020 struct dcd_manager *hdcd_handle;
1021 struct dmm_object *dmm_mgr;
1025 struct drv_data *drv_datap = dev_get_drvdata(bridge);
1027 #ifdef OPT_LOAD_TIME_INSTRUMENTATION
1032 #if defined(CONFIG_TIDSPBRIDGE_DVFS) && !defined(CONFIG_CPU_FREQ)
1033 struct dspbridge_platform_data *pdata =
1034 omap_dspbridge_dev->dev.platform_data;
1037 #ifdef OPT_LOAD_TIME_INSTRUMENTATION
1038 do_gettimeofday(&tv1);
1040 if (!p_proc_object) {
1044 dev_get_cod_mgr(p_proc_object->dev_obj, &cod_mgr);
1049 status = proc_stop(hprocessor);
1053 /* Place the board in the monitor state. */
1054 status = proc_monitor(hprocessor);
1058 /* Save ptr to original argv[0]. */
1059 pargv0 = (char *)user_args[0];
1060 /*Prepend "PROC_ID=<nproc_id>"to envp array for target. */
1061 envp_elems = get_envp_count((char **)user_envp);
1062 cnew_envp = (envp_elems ? (envp_elems + 1) : (envp_elems + 2));
1063 new_envp = kzalloc(cnew_envp * sizeof(char **), GFP_KERNEL);
1065 status = snprintf(sz_proc_id, MAXPROCIDLEN, PROC_ENVPROCID,
1068 dev_dbg(bridge, "%s: Proc ID string overflow\n",
1073 prepend_envp(new_envp, (char **)user_envp,
1074 envp_elems, cnew_envp, sz_proc_id);
1075 /* Get the DCD Handle */
1076 status = mgr_get_dcd_handle(p_proc_object->mgr_obj,
1077 (u32 *) &hdcd_handle);
1079 /* Before proceeding with new load,
1080 * check if a previously registered COFF
1082 * If yes, unregister nodes in previously
1083 * registered COFF. If any error occurred,
1084 * set previously registered COFF to NULL. */
1085 if (p_proc_object->last_coff != NULL) {
1087 dcd_auto_unregister(hdcd_handle,
1090 /* Regardless of auto unregister status,
1091 * free previously allocated
1093 kfree(p_proc_object->last_coff);
1094 p_proc_object->last_coff = NULL;
1097 /* On success, do cod_open_base() */
1098 status = cod_open_base(cod_mgr, (char *)user_args[0],
1105 /* Auto-register data base */
1106 /* Get the DCD Handle */
1107 status = mgr_get_dcd_handle(p_proc_object->mgr_obj,
1108 (u32 *) &hdcd_handle);
1110 /* Auto register nodes in specified COFF
1111 * file. If registration did not fail,
1112 * (status = 0 or -EACCES)
1113 * save the name of the COFF file for
1114 * de-registration in the future. */
1116 dcd_auto_register(hdcd_handle,
1117 (char *)user_args[0]);
1118 if (status == -EACCES)
1124 /* Allocate memory for pszLastCoff */
1125 p_proc_object->last_coff =
1126 kzalloc((strlen(user_args[0]) +
1128 /* If memory allocated, save COFF file name */
1129 if (p_proc_object->last_coff) {
1130 strncpy(p_proc_object->last_coff,
1131 (char *)user_args[0],
1132 (strlen((char *)user_args[0]) +
1138 /* Update shared memory address and size */
1140 /* Create the message manager. This must be done
1141 * before calling the IOOnLoaded function. */
1142 dev_get_msg_mgr(p_proc_object->dev_obj, &hmsg_mgr);
1144 status = msg_create(&hmsg_mgr, p_proc_object->dev_obj,
1145 (msg_onexit) node_on_exit);
1146 dev_set_msg_mgr(p_proc_object->dev_obj, hmsg_mgr);
1150 /* Set the Device object's message manager */
1151 status = dev_get_io_mgr(p_proc_object->dev_obj, &hio_mgr);
1153 status = (*p_proc_object->intf_fxns->io_on_loaded)
1159 /* Now, attempt to load an exec: */
1161 /* Boost the OPP level to Maximum level supported by baseport */
1162 #if defined(CONFIG_TIDSPBRIDGE_DVFS) && !defined(CONFIG_CPU_FREQ)
1163 if (pdata->cpu_set_freq)
1164 (*pdata->cpu_set_freq) (pdata->mpu_speed[VDD1_OPP5]);
1166 status = cod_load_base(cod_mgr, argc_index, (char **)user_args,
1168 p_proc_object->dev_obj, NULL);
1170 if (status == -EBADF) {
1171 dev_dbg(bridge, "%s: Failure to Load the EXE\n",
1174 if (status == -ESPIPE) {
1175 pr_err("%s: Couldn't parse the file\n",
1179 /* Requesting the lowest opp supported */
1180 #if defined(CONFIG_TIDSPBRIDGE_DVFS) && !defined(CONFIG_CPU_FREQ)
1181 if (pdata->cpu_set_freq)
1182 (*pdata->cpu_set_freq) (pdata->mpu_speed[VDD1_OPP1]);
1187 /* Update the Processor status to loaded */
1188 status = (*p_proc_object->intf_fxns->brd_set_state)
1189 (p_proc_object->bridge_context, BRD_LOADED);
1191 p_proc_object->proc_state = PROC_LOADED;
1192 if (p_proc_object->ntfy_obj)
1193 proc_notify_clients(p_proc_object,
1194 DSP_PROCESSORSTATECHANGE);
1198 status = proc_get_processor_id(hprocessor, &proc_id);
1199 if (proc_id == DSP_UNIT) {
1200 /* Use all available DSP address space after EXTMEM
1203 status = cod_get_sym_value(cod_mgr, EXTEND,
1206 /* Reset DMM structs and add an initial free chunk */
1209 dev_get_dmm_mgr(p_proc_object->dev_obj,
1212 /* Set dw_ext_end to DMM START u8
1215 (dw_ext_end + 1) * DSPWORDSIZE;
1216 /* DMM memory is from EXT_END */
1217 status = dmm_create_tables(dmm_mgr,
1226 /* Restore the original argv[0] */
1228 user_args[0] = pargv0;
1230 if (!((*p_proc_object->intf_fxns->brd_status)
1231 (p_proc_object->bridge_context, &brd_state))) {
1232 pr_info("%s: Processor Loaded %s\n", __func__, pargv0);
1233 kfree(drv_datap->base_img);
1234 drv_datap->base_img = kmalloc(strlen(pargv0) + 1,
1236 if (drv_datap->base_img)
1237 strncpy(drv_datap->base_img, pargv0,
1238 strlen(pargv0) + 1);
1246 pr_err("%s: Processor failed to load\n", __func__);
1247 proc_stop(p_proc_object);
1249 #ifdef OPT_LOAD_TIME_INSTRUMENTATION
1250 do_gettimeofday(&tv2);
1251 if (tv2.tv_usec < tv1.tv_usec) {
1252 tv2.tv_usec += 1000000;
1255 dev_dbg(bridge, "%s: time to load %d sec and %d usec\n", __func__,
1256 tv2.tv_sec - tv1.tv_sec, tv2.tv_usec - tv1.tv_usec);
1262 * ======== proc_map ========
1264 * Maps a MPU buffer to DSP address space.
1266 int proc_map(void *hprocessor, void *pmpu_addr, u32 ul_size,
1267 void *req_addr, void **pp_map_addr, u32 ul_map_attr,
1268 struct process_context *pr_ctxt)
1272 struct dmm_object *dmm_mgr;
1275 struct proc_object *p_proc_object = (struct proc_object *)hprocessor;
1276 struct dmm_map_object *map_obj;
1279 #ifdef CONFIG_TIDSPBRIDGE_CACHE_LINE_CHECK
1280 if ((ul_map_attr & BUFMODE_MASK) != RBUF) {
1281 if (!IS_ALIGNED((u32)pmpu_addr, DSP_CACHE_LINE) ||
1282 !IS_ALIGNED(ul_size, DSP_CACHE_LINE)) {
1283 pr_err("%s: not aligned: 0x%x (%d)\n", __func__,
1284 (u32)pmpu_addr, ul_size);
1290 /* Calculate the page-aligned PA, VA and size */
1291 va_align = PG_ALIGN_LOW((u32) req_addr, PG_SIZE4K);
1292 pa_align = PG_ALIGN_LOW((u32) pmpu_addr, PG_SIZE4K);
1293 size_align = PG_ALIGN_HIGH(ul_size + (u32) pmpu_addr - pa_align,
1296 if (!p_proc_object) {
1300 /* Critical section */
1301 mutex_lock(&proc_lock);
1302 dmm_get_handle(p_proc_object, &dmm_mgr);
1304 status = dmm_map_memory(dmm_mgr, va_align, size_align);
1308 /* Add mapping to the page tables. */
1311 /* Mapped address = MSB of VA | LSB of PA */
1312 tmp_addr = (va_align | ((u32) pmpu_addr & (PG_SIZE4K - 1)));
1313 /* mapped memory resource tracking */
1314 map_obj = add_mapping_info(pr_ctxt, pa_align, tmp_addr,
1319 status = (*p_proc_object->intf_fxns->brd_mem_map)
1320 (p_proc_object->bridge_context, pa_align, va_align,
1321 size_align, ul_map_attr, map_obj->pages);
1324 /* Mapped address = MSB of VA | LSB of PA */
1325 *pp_map_addr = (void *) tmp_addr;
1327 remove_mapping_information(pr_ctxt, tmp_addr, size_align);
1328 dmm_un_map_memory(dmm_mgr, va_align, &size_align);
1330 mutex_unlock(&proc_lock);
1336 dev_dbg(bridge, "%s: hprocessor %p, pmpu_addr %p, ul_size %x, "
1337 "req_addr %p, ul_map_attr %x, pp_map_addr %p, va_align %x, "
1338 "pa_align %x, size_align %x status 0x%x\n", __func__,
1339 hprocessor, pmpu_addr, ul_size, req_addr, ul_map_attr,
1340 pp_map_addr, va_align, pa_align, size_align, status);
1346 * ======== proc_register_notify ========
1348 * Register to be notified of specific processor events.
1350 int proc_register_notify(void *hprocessor, u32 event_mask,
1351 u32 notify_type, struct dsp_notification
1355 struct proc_object *p_proc_object = (struct proc_object *)hprocessor;
1356 struct deh_mgr *hdeh_mgr;
1358 /* Check processor handle */
1359 if (!p_proc_object) {
1363 /* Check if event mask is a valid processor related event */
1364 if (event_mask & ~(DSP_PROCESSORSTATECHANGE | DSP_PROCESSORATTACH |
1365 DSP_PROCESSORDETACH | DSP_PROCESSORRESTART |
1366 DSP_MMUFAULT | DSP_SYSERROR | DSP_PWRERROR |
1370 /* Check if notify type is valid */
1371 if (notify_type != DSP_SIGNALEVENT)
1375 /* If event mask is not DSP_SYSERROR, DSP_MMUFAULT,
1376 * or DSP_PWRERROR then register event immediately. */
1378 ~(DSP_SYSERROR | DSP_MMUFAULT | DSP_PWRERROR |
1380 status = ntfy_register(p_proc_object->ntfy_obj,
1381 hnotification, event_mask,
1383 /* Special case alert, special case alert!
1384 * If we're trying to *deregister* (i.e. event_mask
1385 * is 0), a DSP_SYSERROR or DSP_MMUFAULT notification,
1386 * we have to deregister with the DEH manager.
1387 * There's no way to know, based on event_mask which
1388 * manager the notification event was registered with,
1389 * so if we're trying to deregister and ntfy_register
1390 * failed, we'll give the deh manager a shot.
1392 if ((event_mask == 0) && status) {
1394 dev_get_deh_mgr(p_proc_object->dev_obj,
1397 bridge_deh_register_notify(hdeh_mgr,
1403 status = dev_get_deh_mgr(p_proc_object->dev_obj,
1406 bridge_deh_register_notify(hdeh_mgr,
1418 * ======== proc_reserve_memory ========
1420 * Reserve a virtually contiguous region of DSP address space.
1422 int proc_reserve_memory(void *hprocessor, u32 ul_size,
1424 struct process_context *pr_ctxt)
1426 struct dmm_object *dmm_mgr;
1428 struct proc_object *p_proc_object = (struct proc_object *)hprocessor;
1429 struct dmm_rsv_object *rsv_obj;
1431 if (!p_proc_object) {
1436 status = dmm_get_handle(p_proc_object, &dmm_mgr);
1442 status = dmm_reserve_memory(dmm_mgr, ul_size, (u32 *) pp_rsv_addr);
1447 * A successful reserve should be followed by insertion of rsv_obj
1448 * into dmm_rsv_list, so that reserved memory resource tracking
1451 rsv_obj = kmalloc(sizeof(struct dmm_rsv_object), GFP_KERNEL);
1453 rsv_obj->dsp_reserved_addr = (u32) *pp_rsv_addr;
1454 spin_lock(&pr_ctxt->dmm_rsv_lock);
1455 list_add(&rsv_obj->link, &pr_ctxt->dmm_rsv_list);
1456 spin_unlock(&pr_ctxt->dmm_rsv_lock);
1460 dev_dbg(bridge, "%s: hprocessor: 0x%p ul_size: 0x%x pp_rsv_addr: 0x%p "
1461 "status 0x%x\n", __func__, hprocessor,
1462 ul_size, pp_rsv_addr, status);
1467 * ======== proc_start ========
1469 * Start a processor running.
1471 int proc_start(void *hprocessor)
1474 struct proc_object *p_proc_object = (struct proc_object *)hprocessor;
1475 struct cod_manager *cod_mgr; /* Code manager handle */
1476 u32 dw_dsp_addr; /* Loaded code's entry point. */
1479 if (!p_proc_object) {
1483 /* Call the bridge_brd_start */
1484 if (p_proc_object->proc_state != PROC_LOADED) {
1488 status = dev_get_cod_mgr(p_proc_object->dev_obj, &cod_mgr);
1494 status = cod_get_entry(cod_mgr, &dw_dsp_addr);
1498 status = (*p_proc_object->intf_fxns->brd_start)
1499 (p_proc_object->bridge_context, dw_dsp_addr);
1503 /* Call dev_create2 */
1504 status = dev_create2(p_proc_object->dev_obj);
1506 p_proc_object->proc_state = PROC_RUNNING;
1507 /* Deep sleep switces off the peripheral clocks.
1508 * we just put the DSP CPU in idle in the idle loop.
1509 * so there is no need to send a command to DSP */
1511 if (p_proc_object->ntfy_obj) {
1512 proc_notify_clients(p_proc_object,
1513 DSP_PROCESSORSTATECHANGE);
1516 /* Failed to Create Node Manager and DISP Object
1517 * Stop the Processor from running. Put it in STOPPED State */
1518 (void)(*p_proc_object->intf_fxns->
1519 brd_stop) (p_proc_object->bridge_context);
1520 p_proc_object->proc_state = PROC_STOPPED;
1524 if (!((*p_proc_object->intf_fxns->brd_status)
1525 (p_proc_object->bridge_context, &brd_state))) {
1526 pr_info("%s: dsp in running state\n", __func__);
1529 pr_err("%s: Failed to start the dsp\n", __func__);
1530 proc_stop(p_proc_object);
1538 * ======== proc_stop ========
1540 * Stop a processor running.
1542 int proc_stop(void *hprocessor)
1545 struct proc_object *p_proc_object = (struct proc_object *)hprocessor;
1546 struct msg_mgr *hmsg_mgr;
1547 struct node_mgr *hnode_mgr;
1549 u32 node_tab_size = 1;
1551 u32 nodes_allocated = 0;
1553 if (!p_proc_object) {
1557 /* check if there are any running nodes */
1558 status = dev_get_node_manager(p_proc_object->dev_obj, &hnode_mgr);
1559 if (!status && hnode_mgr) {
1560 status = node_enum_nodes(hnode_mgr, &hnode, node_tab_size,
1561 &num_nodes, &nodes_allocated);
1562 if ((status == -EINVAL) || (nodes_allocated > 0)) {
1563 pr_err("%s: Can't stop device, active nodes = %d \n",
1564 __func__, nodes_allocated);
1568 /* Call the bridge_brd_stop */
1569 /* It is OK to stop a device that does n't have nodes OR not started */
1571 (*p_proc_object->intf_fxns->
1572 brd_stop) (p_proc_object->bridge_context);
1574 dev_dbg(bridge, "%s: processor in standby mode\n", __func__);
1575 p_proc_object->proc_state = PROC_STOPPED;
1576 /* Destroy the Node Manager, msg_ctrl Manager */
1577 if (!(dev_destroy2(p_proc_object->dev_obj))) {
1578 /* Destroy the msg_ctrl by calling msg_delete */
1579 dev_get_msg_mgr(p_proc_object->dev_obj, &hmsg_mgr);
1581 msg_delete(hmsg_mgr);
1582 dev_set_msg_mgr(p_proc_object->dev_obj, NULL);
1586 pr_err("%s: Failed to stop the processor\n", __func__);
1594 * ======== proc_un_map ========
1596 * Removes a MPU buffer mapping from the DSP address space.
1598 int proc_un_map(void *hprocessor, void *map_addr,
1599 struct process_context *pr_ctxt)
1602 struct proc_object *p_proc_object = (struct proc_object *)hprocessor;
1603 struct dmm_object *dmm_mgr;
1607 va_align = PG_ALIGN_LOW((u32) map_addr, PG_SIZE4K);
1608 if (!p_proc_object) {
1613 status = dmm_get_handle(hprocessor, &dmm_mgr);
1619 /* Critical section */
1620 mutex_lock(&proc_lock);
1622 * Update DMM structures. Get the size to unmap.
1623 * This function returns error if the VA is not mapped
1625 status = dmm_un_map_memory(dmm_mgr, (u32) va_align, &size_align);
1626 /* Remove mapping from the page tables. */
1628 status = (*p_proc_object->intf_fxns->brd_mem_un_map)
1629 (p_proc_object->bridge_context, va_align, size_align);
1636 * A successful unmap should be followed by removal of map_obj
1637 * from dmm_map_list, so that mapped memory resource tracking
1640 remove_mapping_information(pr_ctxt, (u32) map_addr, size_align);
1643 mutex_unlock(&proc_lock);
1646 dev_dbg(bridge, "%s: hprocessor: 0x%p map_addr: 0x%p status: 0x%x\n",
1647 __func__, hprocessor, map_addr, status);
1652 * ======== proc_un_reserve_memory ========
1654 * Frees a previously reserved region of DSP address space.
1656 int proc_un_reserve_memory(void *hprocessor, void *prsv_addr,
1657 struct process_context *pr_ctxt)
1659 struct dmm_object *dmm_mgr;
1661 struct proc_object *p_proc_object = (struct proc_object *)hprocessor;
1662 struct dmm_rsv_object *rsv_obj;
1664 if (!p_proc_object) {
1669 status = dmm_get_handle(p_proc_object, &dmm_mgr);
1675 status = dmm_un_reserve_memory(dmm_mgr, (u32) prsv_addr);
1680 * A successful unreserve should be followed by removal of rsv_obj
1681 * from dmm_rsv_list, so that reserved memory resource tracking
1684 spin_lock(&pr_ctxt->dmm_rsv_lock);
1685 list_for_each_entry(rsv_obj, &pr_ctxt->dmm_rsv_list, link) {
1686 if (rsv_obj->dsp_reserved_addr == (u32) prsv_addr) {
1687 list_del(&rsv_obj->link);
1692 spin_unlock(&pr_ctxt->dmm_rsv_lock);
1695 dev_dbg(bridge, "%s: hprocessor: 0x%p prsv_addr: 0x%p status: 0x%x\n",
1696 __func__, hprocessor, prsv_addr, status);
1701 * ======== = proc_monitor ======== ==
1703 * Place the Processor in Monitor State. This is an internal
1704 * function and a requirement before Processor is loaded.
1705 * This does a bridge_brd_stop, dev_destroy2 and bridge_brd_monitor.
1706 * In dev_destroy2 we delete the node manager.
1708 * p_proc_object: Pointer to Processor Object
1710 * 0: Processor placed in monitor mode.
1711 * !0: Failed to place processor in monitor mode.
1713 * Valid Processor Handle
1715 * Success: ProcObject state is PROC_IDLE
1717 static int proc_monitor(struct proc_object *proc_obj)
1719 int status = -EPERM;
1720 struct msg_mgr *hmsg_mgr;
1722 /* This is needed only when Device is loaded when it is
1723 * already 'ACTIVE' */
1724 /* Destroy the Node Manager, msg_ctrl Manager */
1725 if (!dev_destroy2(proc_obj->dev_obj)) {
1726 /* Destroy the msg_ctrl by calling msg_delete */
1727 dev_get_msg_mgr(proc_obj->dev_obj, &hmsg_mgr);
1729 msg_delete(hmsg_mgr);
1730 dev_set_msg_mgr(proc_obj->dev_obj, NULL);
1733 /* Place the Board in the Monitor State */
1734 if (!((*proc_obj->intf_fxns->brd_monitor)
1735 (proc_obj->bridge_context))) {
1743 * ======== get_envp_count ========
1745 * Return the number of elements in the envp array, including the
1746 * terminating NULL element.
1748 static s32 get_envp_count(char **envp)
1755 ret += 1; /* Include the terminating NULL in the count. */
1762 * ======== prepend_envp ========
1764 * Prepend an environment variable=value pair to the new envp array, and
1765 * copy in the existing var=value pairs in the old envp array.
1767 static char **prepend_envp(char **new_envp, char **envp, s32 envp_elems,
1768 s32 cnew_envp, char *sz_var)
1770 char **pp_envp = new_envp;
1772 /* Prepend new environ var=value string */
1773 *new_envp++ = sz_var;
1775 /* Copy user's environment into our own. */
1776 while (envp_elems--)
1777 *new_envp++ = *envp++;
1779 /* Ensure NULL terminates the new environment strings array. */
1780 if (envp_elems == 0)
1787 * ======== proc_notify_clients ========
1789 * Notify the processor the events.
1791 int proc_notify_clients(void *proc, u32 events)
1794 struct proc_object *p_proc_object = (struct proc_object *)proc;
1796 if (!p_proc_object) {
1801 ntfy_notify(p_proc_object->ntfy_obj, events);
1807 * ======== proc_notify_all_clients ========
1809 * Notify the processor the events. This includes notifying all clients
1810 * attached to a particulat DSP.
1812 int proc_notify_all_clients(void *proc, u32 events)
1815 struct proc_object *p_proc_object = (struct proc_object *)proc;
1817 if (!p_proc_object) {
1822 dev_notify_clients(p_proc_object->dev_obj, events);
1829 * ======== proc_get_processor_id ========
1831 * Retrieves the processor ID.
1833 int proc_get_processor_id(void *proc, u32 * proc_id)
1836 struct proc_object *p_proc_object = (struct proc_object *)proc;
1839 *proc_id = p_proc_object->processor_id;