4 * DSP-BIOS Bridge driver support functions for TI OMAP processors.
6 * This file contains the implementation of the DSP/BIOS Bridge
7 * Configuration Database (DCD).
10 * The fxn dcd_get_objects can apply a callback fxn to each DCD object
11 * that is located in a specified COFF file. At the moment,
12 * dcd_auto_register, dcd_auto_unregister, and NLDR module all use
15 * Copyright (C) 2005-2006 Texas Instruments, Inc.
17 * This package is free software; you can redistribute it and/or modify
18 * it under the terms of the GNU General Public License version 2 as
19 * published by the Free Software Foundation.
21 * THIS PACKAGE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
22 * IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
23 * WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
25 #include <linux/types.h>
27 /* ----------------------------------- Host OS */
28 #include <dspbridge/host_os.h>
30 /* ----------------------------------- DSP/BIOS Bridge */
31 #include <dspbridge/dbdefs.h>
32 /* ----------------------------------- Trace & Debug */
33 #include <dspbridge/dbc.h>
35 /* ----------------------------------- Platform Manager */
36 #include <dspbridge/cod.h>
38 /* ----------------------------------- Others */
39 #include <dspbridge/uuidutil.h>
41 /* ----------------------------------- This */
42 #include <dspbridge/dbdcd.h>
44 /* ----------------------------------- Global defines. */
45 #define MAX_INT2CHAR_LENGTH 16 /* Max int2char len of 32 bit int */
47 /* Name of section containing dependent libraries */
48 #define DEPLIBSECT ".dspbridge_deplibs"
50 /* DCD specific structures. */
52 struct cod_manager *cod_mgr; /* Handle to COD manager object. */
55 /* Pointer to the registry support key */
56 static struct list_head reg_key_list;
57 static DEFINE_SPINLOCK(dbdcd_lock);
59 /* Global reference variables. */
63 /* Helper function prototypes. */
64 static s32 atoi(char *psz_buf);
65 static int get_attrs_from_buf(char *psz_buf, u32 ul_buf_size,
66 enum dsp_dcdobjtype obj_type,
67 struct dcd_genericobj *gen_obj);
68 static void compress_buf(char *psz_buf, u32 ul_buf_size, s32 char_size);
69 static char dsp_char2_gpp_char(char *word, s32 dsp_char_size);
70 static int get_dep_lib_info(struct dcd_manager *hdcd_mgr,
71 struct dsp_uuid *uuid_obj,
74 struct dsp_uuid *dep_lib_uuids,
75 bool *prstnt_dep_libs,
76 enum nldr_phase phase);
79 * ======== dcd_auto_register ========
81 * Parses the supplied image and resigsters with DCD.
83 int dcd_auto_register(struct dcd_manager *hdcd_mgr,
88 DBC_REQUIRE(refs > 0);
91 status = dcd_get_objects(hdcd_mgr, sz_coff_path,
92 (dcd_registerfxn) dcd_register_object,
93 (void *)sz_coff_path);
101 * ======== dcd_auto_unregister ========
103 * Parses the supplied DSP image and unresiters from DCD.
105 int dcd_auto_unregister(struct dcd_manager *hdcd_mgr,
110 DBC_REQUIRE(refs > 0);
113 status = dcd_get_objects(hdcd_mgr, sz_coff_path,
114 (dcd_registerfxn) dcd_register_object,
123 * ======== dcd_create_manager ========
125 * Creates DCD manager.
127 int dcd_create_manager(char *sz_zl_dll_name,
128 struct dcd_manager **dcd_mgr)
130 struct cod_manager *cod_mgr; /* COD manager handle */
131 struct dcd_manager *dcd_mgr_obj = NULL; /* DCD Manager pointer */
134 DBC_REQUIRE(refs >= 0);
135 DBC_REQUIRE(dcd_mgr);
137 status = cod_create(&cod_mgr, sz_zl_dll_name, NULL);
141 /* Create a DCD object. */
142 dcd_mgr_obj = kzalloc(sizeof(struct dcd_manager), GFP_KERNEL);
143 if (dcd_mgr_obj != NULL) {
144 /* Fill out the object. */
145 dcd_mgr_obj->cod_mgr = cod_mgr;
147 /* Return handle to this DCD interface. */
148 *dcd_mgr = dcd_mgr_obj;
153 * If allocation of DcdManager object failed, delete the
159 DBC_ENSURE((!status) ||
160 ((dcd_mgr_obj == NULL) && (status == -ENOMEM)));
167 * ======== dcd_destroy_manager ========
169 * Frees DCD Manager object.
171 int dcd_destroy_manager(struct dcd_manager *hdcd_mgr)
173 struct dcd_manager *dcd_mgr_obj = hdcd_mgr;
174 int status = -EFAULT;
176 DBC_REQUIRE(refs >= 0);
179 /* Delete the COD manager. */
180 cod_delete(dcd_mgr_obj->cod_mgr);
182 /* Deallocate a DCD manager object. */
192 * ======== dcd_enumerate_object ========
194 * Enumerates objects in the DCD.
196 int dcd_enumerate_object(s32 index, enum dsp_dcdobjtype obj_type,
197 struct dsp_uuid *uuid_obj)
200 char sz_reg_key[DCD_MAXPATHLENGTH];
201 char sz_value[DCD_MAXPATHLENGTH];
202 struct dsp_uuid dsp_uuid_obj;
203 char sz_obj_type[MAX_INT2CHAR_LENGTH]; /* str. rep. of obj_type. */
205 struct dcd_key_elem *dcd_key;
208 DBC_REQUIRE(refs >= 0);
209 DBC_REQUIRE(index >= 0);
210 DBC_REQUIRE(uuid_obj != NULL);
212 if ((index != 0) && (enum_refs == 0)) {
214 * If an enumeration is being performed on an index greater
215 * than zero, then the current enum_refs must have been
216 * incremented to greater than zero.
221 * Pre-determine final key length. It's length of DCD_REGKEY +
222 * "_\0" + length of sz_obj_type string + terminating NULL.
224 dw_key_len = strlen(DCD_REGKEY) + 1 + sizeof(sz_obj_type) + 1;
225 DBC_ASSERT(dw_key_len < DCD_MAXPATHLENGTH);
227 /* Create proper REG key; concatenate DCD_REGKEY with
229 strncpy(sz_reg_key, DCD_REGKEY, strlen(DCD_REGKEY) + 1);
230 if ((strlen(sz_reg_key) + strlen("_\0")) <
232 strncat(sz_reg_key, "_\0", 2);
237 /* This snprintf is guaranteed not to exceed max size of an
239 status = snprintf(sz_obj_type, MAX_INT2CHAR_LENGTH, "%d",
246 if ((strlen(sz_reg_key) + strlen(sz_obj_type)) <
248 strncat(sz_reg_key, sz_obj_type,
249 strlen(sz_obj_type) + 1);
256 len = strlen(sz_reg_key);
257 spin_lock(&dbdcd_lock);
258 list_for_each_entry(dcd_key, ®_key_list, link) {
259 if (!strncmp(dcd_key->name, sz_reg_key, len)
261 strncpy(sz_value, &dcd_key->name[len],
262 strlen(&dcd_key->name[len]) + 1);
266 spin_unlock(&dbdcd_lock);
268 if (&dcd_key->link == ®_key_list)
273 /* Create UUID value using string retrieved from
275 uuid_uuid_from_string(sz_value, &dsp_uuid_obj);
277 *uuid_obj = dsp_uuid_obj;
279 /* Increment enum_refs to update reference count. */
283 } else if (status == -ENODATA) {
284 /* At the end of enumeration. Reset enum_refs. */
288 * TODO: Revisit, this is not an errror case but code
289 * expects non-zero value.
297 DBC_ENSURE(uuid_obj || (status == -EPERM));
303 * ======== dcd_exit ========
305 * Discontinue usage of the DCD module.
309 struct dcd_key_elem *rv, *rv_tmp;
310 DBC_REQUIRE(refs > 0);
315 list_for_each_entry_safe(rv, rv_tmp, ®_key_list, link) {
322 DBC_ENSURE(refs >= 0);
326 * ======== dcd_get_dep_libs ========
328 int dcd_get_dep_libs(struct dcd_manager *hdcd_mgr,
329 struct dsp_uuid *uuid_obj,
330 u16 num_libs, struct dsp_uuid *dep_lib_uuids,
331 bool *prstnt_dep_libs,
332 enum nldr_phase phase)
336 DBC_REQUIRE(refs > 0);
337 DBC_REQUIRE(hdcd_mgr);
338 DBC_REQUIRE(uuid_obj != NULL);
339 DBC_REQUIRE(dep_lib_uuids != NULL);
340 DBC_REQUIRE(prstnt_dep_libs != NULL);
343 get_dep_lib_info(hdcd_mgr, uuid_obj, &num_libs, NULL, dep_lib_uuids,
344 prstnt_dep_libs, phase);
350 * ======== dcd_get_num_dep_libs ========
352 int dcd_get_num_dep_libs(struct dcd_manager *hdcd_mgr,
353 struct dsp_uuid *uuid_obj,
354 u16 *num_libs, u16 *num_pers_libs,
355 enum nldr_phase phase)
359 DBC_REQUIRE(refs > 0);
360 DBC_REQUIRE(hdcd_mgr);
361 DBC_REQUIRE(num_libs != NULL);
362 DBC_REQUIRE(num_pers_libs != NULL);
363 DBC_REQUIRE(uuid_obj != NULL);
365 status = get_dep_lib_info(hdcd_mgr, uuid_obj, num_libs, num_pers_libs,
372 * ======== dcd_get_object_def ========
374 * Retrieves the properties of a node or processor based on the UUID and
377 int dcd_get_object_def(struct dcd_manager *hdcd_mgr,
378 struct dsp_uuid *obj_uuid,
379 enum dsp_dcdobjtype obj_type,
380 struct dcd_genericobj *obj_def)
382 struct dcd_manager *dcd_mgr_obj = hdcd_mgr; /* ptr to DCD mgr */
383 struct cod_libraryobj *lib = NULL;
385 u32 ul_addr = 0; /* Used by cod_get_section */
386 u32 ul_len = 0; /* Used by cod_get_section */
387 u32 dw_buf_size; /* Used by REG functions */
388 char sz_reg_key[DCD_MAXPATHLENGTH];
389 char *sz_uuid; /*[MAXUUIDLEN]; */
390 struct dcd_key_elem *dcd_key = NULL;
391 char sz_sect_name[MAXUUIDLEN + 2]; /* ".[UUID]\0" */
393 u32 dw_key_len; /* Len of REG key. */
394 char sz_obj_type[MAX_INT2CHAR_LENGTH]; /* str. rep. of obj_type. */
396 DBC_REQUIRE(refs > 0);
397 DBC_REQUIRE(obj_def != NULL);
398 DBC_REQUIRE(obj_uuid != NULL);
400 sz_uuid = kzalloc(MAXUUIDLEN, GFP_KERNEL);
411 /* Pre-determine final key length. It's length of DCD_REGKEY +
412 * "_\0" + length of sz_obj_type string + terminating NULL */
413 dw_key_len = strlen(DCD_REGKEY) + 1 + sizeof(sz_obj_type) + 1;
414 DBC_ASSERT(dw_key_len < DCD_MAXPATHLENGTH);
416 /* Create proper REG key; concatenate DCD_REGKEY with obj_type. */
417 strncpy(sz_reg_key, DCD_REGKEY, strlen(DCD_REGKEY) + 1);
419 if ((strlen(sz_reg_key) + strlen("_\0")) < DCD_MAXPATHLENGTH)
420 strncat(sz_reg_key, "_\0", 2);
424 status = snprintf(sz_obj_type, MAX_INT2CHAR_LENGTH, "%d", obj_type);
430 if ((strlen(sz_reg_key) + strlen(sz_obj_type)) <
432 strncat(sz_reg_key, sz_obj_type,
433 strlen(sz_obj_type) + 1);
438 /* Create UUID value to set in registry. */
439 uuid_uuid_to_string(obj_uuid, sz_uuid, MAXUUIDLEN);
441 if ((strlen(sz_reg_key) + MAXUUIDLEN) < DCD_MAXPATHLENGTH)
442 strncat(sz_reg_key, sz_uuid, MAXUUIDLEN);
446 /* Retrieve paths from the registry based on struct dsp_uuid */
447 dw_buf_size = DCD_MAXPATHLENGTH;
450 spin_lock(&dbdcd_lock);
451 list_for_each_entry(dcd_key, ®_key_list, link) {
452 if (!strncmp(dcd_key->name, sz_reg_key,
453 strlen(sz_reg_key) + 1))
456 spin_unlock(&dbdcd_lock);
457 if (&dcd_key->link == ®_key_list) {
464 /* Open COFF file. */
465 status = cod_open(dcd_mgr_obj->cod_mgr, dcd_key->path,
472 /* Ensure sz_uuid + 1 is not greater than sizeof sz_sect_name. */
473 DBC_ASSERT((strlen(sz_uuid) + 1) < sizeof(sz_sect_name));
475 /* Create section name based on node UUID. A period is
476 * pre-pended to the UUID string to form the section name.
477 * I.e. ".24BC8D90_BB45_11d4_B756_006008BDB66F" */
478 strncpy(sz_sect_name, ".", 2);
479 strncat(sz_sect_name, sz_uuid, strlen(sz_uuid));
481 /* Get section information. */
482 status = cod_get_section(lib, sz_sect_name, &ul_addr, &ul_len);
488 /* Allocate zeroed buffer. */
489 psz_coff_buf = kzalloc(ul_len + 4, GFP_KERNEL);
491 if (strstr(dcd_key->path, "iva") == NULL) {
492 /* Locate section by objectID and read its content. */
494 cod_read_section(lib, sz_sect_name, psz_coff_buf, ul_len);
497 cod_read_section(lib, sz_sect_name, psz_coff_buf, ul_len);
498 dev_dbg(bridge, "%s: Skipped Byte swap for IVA!!\n", __func__);
501 status = cod_read_section(lib, sz_sect_name, psz_coff_buf, ul_len);
504 /* Compres DSP buffer to conform to PC format. */
505 if (strstr(dcd_key->path, "iva") == NULL) {
506 compress_buf(psz_coff_buf, ul_len, DSPWORDSIZE);
508 compress_buf(psz_coff_buf, ul_len, 1);
509 dev_dbg(bridge, "%s: Compressing IVA COFF buffer by 1 "
510 "for IVA!!\n", __func__);
513 /* Parse the content of the COFF buffer. */
515 get_attrs_from_buf(psz_coff_buf, ul_len, obj_type, obj_def);
522 /* Free the previously allocated dynamic buffer. */
534 * ======== dcd_get_objects ========
536 int dcd_get_objects(struct dcd_manager *hdcd_mgr,
537 char *sz_coff_path, dcd_registerfxn register_fxn,
540 struct dcd_manager *dcd_mgr_obj = hdcd_mgr;
544 struct cod_libraryobj *lib = NULL;
545 u32 ul_addr = 0; /* Used by cod_get_section */
546 u32 ul_len = 0; /* Used by cod_get_section */
549 struct dsp_uuid dsp_uuid_obj;
552 DBC_REQUIRE(refs > 0);
558 /* Open DSP coff file, don't load symbols. */
559 status = cod_open(dcd_mgr_obj->cod_mgr, sz_coff_path, COD_NOLOAD, &lib);
565 /* Get DCD_RESIGER_SECTION section information. */
566 status = cod_get_section(lib, DCD_REGISTER_SECTION, &ul_addr, &ul_len);
567 if (status || !(ul_len > 0)) {
572 /* Allocate zeroed buffer. */
573 psz_coff_buf = kzalloc(ul_len + 4, GFP_KERNEL);
575 if (strstr(sz_coff_path, "iva") == NULL) {
576 /* Locate section by objectID and read its content. */
577 status = cod_read_section(lib, DCD_REGISTER_SECTION,
578 psz_coff_buf, ul_len);
580 dev_dbg(bridge, "%s: Skipped Byte swap for IVA!!\n", __func__);
581 status = cod_read_section(lib, DCD_REGISTER_SECTION,
582 psz_coff_buf, ul_len);
586 cod_read_section(lib, DCD_REGISTER_SECTION, psz_coff_buf, ul_len);
589 /* Compress DSP buffer to conform to PC format. */
590 if (strstr(sz_coff_path, "iva") == NULL) {
591 compress_buf(psz_coff_buf, ul_len, DSPWORDSIZE);
593 compress_buf(psz_coff_buf, ul_len, 1);
594 dev_dbg(bridge, "%s: Compress COFF buffer with 1 word "
595 "for IVA!!\n", __func__);
598 /* Read from buffer and register object in buffer. */
599 psz_cur = psz_coff_buf;
600 while ((token = strsep(&psz_cur, seps)) && *token != '\0') {
601 /* Retrieve UUID string. */
602 uuid_uuid_from_string(token, &dsp_uuid_obj);
604 /* Retrieve object type */
605 token = strsep(&psz_cur, seps);
607 /* Retrieve object type */
608 object_type = atoi(token);
611 * Apply register_fxn to the found DCD object.
612 * Possible actions include:
614 * 1) Register found DCD object.
615 * 2) Unregister found DCD object (when handle == NULL)
616 * 3) Add overlay node.
619 register_fxn(&dsp_uuid_obj, object_type, handle);
621 /* if error occurs, break from while loop. */
629 /* Free the previously allocated dynamic buffer. */
640 * ======== dcd_get_library_name ========
642 * Retrieves the library name for the given UUID.
645 int dcd_get_library_name(struct dcd_manager *hdcd_mgr,
646 struct dsp_uuid *uuid_obj,
649 enum nldr_phase phase, bool *phase_split)
651 char sz_reg_key[DCD_MAXPATHLENGTH];
652 char sz_uuid[MAXUUIDLEN];
653 u32 dw_key_len; /* Len of REG key. */
654 char sz_obj_type[MAX_INT2CHAR_LENGTH]; /* str. rep. of obj_type. */
656 struct dcd_key_elem *dcd_key = NULL;
658 DBC_REQUIRE(uuid_obj != NULL);
659 DBC_REQUIRE(str_lib_name != NULL);
660 DBC_REQUIRE(buff_size != NULL);
661 DBC_REQUIRE(hdcd_mgr);
663 dev_dbg(bridge, "%s: hdcd_mgr %p, uuid_obj %p, str_lib_name %p,"
664 " buff_size %p\n", __func__, hdcd_mgr, uuid_obj, str_lib_name,
668 * Pre-determine final key length. It's length of DCD_REGKEY +
669 * "_\0" + length of sz_obj_type string + terminating NULL.
671 dw_key_len = strlen(DCD_REGKEY) + 1 + sizeof(sz_obj_type) + 1;
672 DBC_ASSERT(dw_key_len < DCD_MAXPATHLENGTH);
674 /* Create proper REG key; concatenate DCD_REGKEY with obj_type. */
675 strncpy(sz_reg_key, DCD_REGKEY, strlen(DCD_REGKEY) + 1);
676 if ((strlen(sz_reg_key) + strlen("_\0")) < DCD_MAXPATHLENGTH)
677 strncat(sz_reg_key, "_\0", 2);
683 /* create phase type */
684 sprintf(sz_obj_type, "%d", DSP_DCDCREATELIBTYPE);
687 /* execute phase type */
688 sprintf(sz_obj_type, "%d", DSP_DCDEXECUTELIBTYPE);
691 /* delete phase type */
692 sprintf(sz_obj_type, "%d", DSP_DCDDELETELIBTYPE);
695 /* known to be a dependent library */
696 sprintf(sz_obj_type, "%d", DSP_DCDLIBRARYTYPE);
703 if ((strlen(sz_reg_key) + strlen(sz_obj_type)) <
705 strncat(sz_reg_key, sz_obj_type,
706 strlen(sz_obj_type) + 1);
710 /* Create UUID value to find match in registry. */
711 uuid_uuid_to_string(uuid_obj, sz_uuid, MAXUUIDLEN);
712 if ((strlen(sz_reg_key) + MAXUUIDLEN) < DCD_MAXPATHLENGTH)
713 strncat(sz_reg_key, sz_uuid, MAXUUIDLEN);
718 spin_lock(&dbdcd_lock);
719 list_for_each_entry(dcd_key, ®_key_list, link) {
720 /* See if the name matches. */
721 if (!strncmp(dcd_key->name, sz_reg_key,
722 strlen(sz_reg_key) + 1))
725 spin_unlock(&dbdcd_lock);
728 if (&dcd_key->link == ®_key_list)
731 /* If can't find, phases might be registered as generic LIBRARYTYPE */
732 if (status && phase != NLDR_NOPHASE) {
734 *phase_split = false;
736 strncpy(sz_reg_key, DCD_REGKEY, strlen(DCD_REGKEY) + 1);
737 if ((strlen(sz_reg_key) + strlen("_\0")) <
739 strncat(sz_reg_key, "_\0", 2);
743 sprintf(sz_obj_type, "%d", DSP_DCDLIBRARYTYPE);
744 if ((strlen(sz_reg_key) + strlen(sz_obj_type))
745 < DCD_MAXPATHLENGTH) {
746 strncat(sz_reg_key, sz_obj_type,
747 strlen(sz_obj_type) + 1);
751 uuid_uuid_to_string(uuid_obj, sz_uuid, MAXUUIDLEN);
752 if ((strlen(sz_reg_key) + MAXUUIDLEN) < DCD_MAXPATHLENGTH)
753 strncat(sz_reg_key, sz_uuid, MAXUUIDLEN);
757 spin_lock(&dbdcd_lock);
758 list_for_each_entry(dcd_key, ®_key_list, link) {
759 /* See if the name matches. */
760 if (!strncmp(dcd_key->name, sz_reg_key,
761 strlen(sz_reg_key) + 1))
764 spin_unlock(&dbdcd_lock);
766 status = (&dcd_key->link != ®_key_list) ?
771 memcpy(str_lib_name, dcd_key->path, strlen(dcd_key->path) + 1);
776 * ======== dcd_init ========
778 * Initialize the DCD module.
785 DBC_REQUIRE(refs >= 0);
788 /* Initialize required modules. */
789 init_cod = cod_init();
793 /* Exit initialized modules. */
798 INIT_LIST_HEAD(®_key_list);
804 DBC_ENSURE((ret && (refs > 0)) || (!ret && (refs == 0)));
810 * ======== dcd_register_object ========
812 * Registers a node or a processor with the DCD.
813 * If psz_path_name == NULL, unregister the specified DCD object.
815 int dcd_register_object(struct dsp_uuid *uuid_obj,
816 enum dsp_dcdobjtype obj_type,
820 char sz_reg_key[DCD_MAXPATHLENGTH];
821 char sz_uuid[MAXUUIDLEN + 1];
822 u32 dw_path_size = 0;
823 u32 dw_key_len; /* Len of REG key. */
824 char sz_obj_type[MAX_INT2CHAR_LENGTH]; /* str. rep. of obj_type. */
825 struct dcd_key_elem *dcd_key = NULL;
827 DBC_REQUIRE(refs > 0);
828 DBC_REQUIRE(uuid_obj != NULL);
829 DBC_REQUIRE((obj_type == DSP_DCDNODETYPE) ||
830 (obj_type == DSP_DCDPROCESSORTYPE) ||
831 (obj_type == DSP_DCDLIBRARYTYPE) ||
832 (obj_type == DSP_DCDCREATELIBTYPE) ||
833 (obj_type == DSP_DCDEXECUTELIBTYPE) ||
834 (obj_type == DSP_DCDDELETELIBTYPE));
836 dev_dbg(bridge, "%s: object UUID %p, obj_type %d, szPathName %s\n",
837 __func__, uuid_obj, obj_type, psz_path_name);
840 * Pre-determine final key length. It's length of DCD_REGKEY +
841 * "_\0" + length of sz_obj_type string + terminating NULL.
843 dw_key_len = strlen(DCD_REGKEY) + 1 + sizeof(sz_obj_type) + 1;
844 DBC_ASSERT(dw_key_len < DCD_MAXPATHLENGTH);
846 /* Create proper REG key; concatenate DCD_REGKEY with obj_type. */
847 strncpy(sz_reg_key, DCD_REGKEY, strlen(DCD_REGKEY) + 1);
848 if ((strlen(sz_reg_key) + strlen("_\0")) < DCD_MAXPATHLENGTH)
849 strncat(sz_reg_key, "_\0", 2);
855 status = snprintf(sz_obj_type, MAX_INT2CHAR_LENGTH, "%d", obj_type);
860 if ((strlen(sz_reg_key) + strlen(sz_obj_type)) <
862 strncat(sz_reg_key, sz_obj_type,
863 strlen(sz_obj_type) + 1);
867 /* Create UUID value to set in registry. */
868 uuid_uuid_to_string(uuid_obj, sz_uuid, MAXUUIDLEN);
869 if ((strlen(sz_reg_key) + MAXUUIDLEN) < DCD_MAXPATHLENGTH)
870 strncat(sz_reg_key, sz_uuid, MAXUUIDLEN);
879 * If psz_path_name != NULL, perform registration, otherwise,
880 * perform unregistration.
884 dw_path_size = strlen(psz_path_name) + 1;
885 spin_lock(&dbdcd_lock);
886 list_for_each_entry(dcd_key, ®_key_list, link) {
887 /* See if the name matches. */
888 if (!strncmp(dcd_key->name, sz_reg_key,
889 strlen(sz_reg_key) + 1))
892 spin_unlock(&dbdcd_lock);
893 if (&dcd_key->link == ®_key_list) {
895 * Add new reg value (UUID+obj_type)
896 * with COFF path info
899 dcd_key = kmalloc(sizeof(struct dcd_key_elem),
906 dcd_key->path = kmalloc(strlen(sz_reg_key) + 1,
909 if (!dcd_key->path) {
915 strncpy(dcd_key->name, sz_reg_key,
916 strlen(sz_reg_key) + 1);
917 strncpy(dcd_key->path, psz_path_name ,
919 spin_lock(&dbdcd_lock);
920 list_add_tail(&dcd_key->link, ®_key_list);
921 spin_unlock(&dbdcd_lock);
923 /* Make sure the new data is the same. */
924 if (strncmp(dcd_key->path, psz_path_name,
926 /* The caller needs a different data size! */
927 kfree(dcd_key->path);
928 dcd_key->path = kmalloc(dw_path_size,
930 if (dcd_key->path == NULL) {
936 /* We have a match! Copy out the data. */
937 memcpy(dcd_key->path, psz_path_name, dw_path_size);
939 dev_dbg(bridge, "%s: psz_path_name=%s, dw_path_size=%d\n",
940 __func__, psz_path_name, dw_path_size);
942 /* Deregister an existing object */
943 spin_lock(&dbdcd_lock);
944 list_for_each_entry(dcd_key, ®_key_list, link) {
945 if (!strncmp(dcd_key->name, sz_reg_key,
946 strlen(sz_reg_key) + 1)) {
947 list_del(&dcd_key->link);
948 kfree(dcd_key->path);
953 spin_unlock(&dbdcd_lock);
954 if (&dcd_key->link == ®_key_list)
960 * Because the node database has been updated through a
961 * successful object registration/de-registration operation,
962 * we need to reset the object enumeration counter to allow
963 * current enumerations to reflect this update in the node
973 * ======== dcd_unregister_object ========
974 * Call DCD_Register object with psz_path_name set to NULL to
975 * perform actual object de-registration.
977 int dcd_unregister_object(struct dsp_uuid *uuid_obj,
978 enum dsp_dcdobjtype obj_type)
982 DBC_REQUIRE(refs > 0);
983 DBC_REQUIRE(uuid_obj != NULL);
984 DBC_REQUIRE((obj_type == DSP_DCDNODETYPE) ||
985 (obj_type == DSP_DCDPROCESSORTYPE) ||
986 (obj_type == DSP_DCDLIBRARYTYPE) ||
987 (obj_type == DSP_DCDCREATELIBTYPE) ||
988 (obj_type == DSP_DCDEXECUTELIBTYPE) ||
989 (obj_type == DSP_DCDDELETELIBTYPE));
992 * When dcd_register_object is called with NULL as pathname,
993 * it indicates an unregister object operation.
995 status = dcd_register_object(uuid_obj, obj_type, NULL);
1001 **********************************************************************
1002 * DCD Helper Functions
1003 **********************************************************************
1007 * ======== atoi ========
1009 * This function converts strings in decimal or hex format to integers.
1011 static s32 atoi(char *psz_buf)
1013 char *pch = psz_buf;
1018 while (isspace(*pch))
1021 if (*pch == '-' || *pch == '+') {
1024 } else if (*pch && tolower(pch[strlen(pch) - 1]) == 'h') {
1028 ret_val = strict_strtoul(pch, base, &res);
1030 return ret_val ? : res;
1034 * ======== get_attrs_from_buf ========
1036 * Parse the content of a buffer filled with DSP-side data and
1037 * retrieve an object's attributes from it. IMPORTANT: Assume the
1038 * buffer has been converted from DSP format to GPP format.
1040 static int get_attrs_from_buf(char *psz_buf, u32 ul_buf_size,
1041 enum dsp_dcdobjtype obj_type,
1042 struct dcd_genericobj *gen_obj)
1054 DBC_REQUIRE(psz_buf != NULL);
1055 DBC_REQUIRE(ul_buf_size != 0);
1056 DBC_REQUIRE((obj_type == DSP_DCDNODETYPE)
1057 || (obj_type == DSP_DCDPROCESSORTYPE));
1058 DBC_REQUIRE(gen_obj != NULL);
1061 case DSP_DCDNODETYPE:
1063 * Parse COFF sect buffer to retrieve individual tokens used
1064 * to fill in object attrs.
1067 token = strsep(&psz_cur, seps);
1070 gen_obj->obj_data.node_obj.ndb_props.cb_struct =
1072 token = strsep(&psz_cur, seps);
1074 /* dsp_uuid ui_node_id */
1075 uuid_uuid_from_string(token,
1076 &gen_obj->obj_data.node_obj.ndb_props.
1078 token = strsep(&psz_cur, seps);
1082 token_len = strlen(token);
1083 if (token_len > DSP_MAXNAMELEN - 1)
1084 token_len = DSP_MAXNAMELEN - 1;
1086 strncpy(gen_obj->obj_data.node_obj.ndb_props.ac_name,
1088 gen_obj->obj_data.node_obj.ndb_props.ac_name[token_len] = '\0';
1089 token = strsep(&psz_cur, seps);
1091 gen_obj->obj_data.node_obj.ndb_props.ntype = atoi(token);
1092 token = strsep(&psz_cur, seps);
1093 /* u32 cache_on_gpp */
1094 gen_obj->obj_data.node_obj.ndb_props.cache_on_gpp = atoi(token);
1095 token = strsep(&psz_cur, seps);
1096 /* dsp_resourcereqmts dsp_resource_reqmts */
1097 gen_obj->obj_data.node_obj.ndb_props.dsp_resource_reqmts.
1098 cb_struct = (u32) atoi(token);
1099 token = strsep(&psz_cur, seps);
1101 gen_obj->obj_data.node_obj.ndb_props.
1102 dsp_resource_reqmts.static_data_size = atoi(token);
1103 token = strsep(&psz_cur, seps);
1104 gen_obj->obj_data.node_obj.ndb_props.
1105 dsp_resource_reqmts.global_data_size = atoi(token);
1106 token = strsep(&psz_cur, seps);
1107 gen_obj->obj_data.node_obj.ndb_props.
1108 dsp_resource_reqmts.program_mem_size = atoi(token);
1109 token = strsep(&psz_cur, seps);
1110 gen_obj->obj_data.node_obj.ndb_props.
1111 dsp_resource_reqmts.uwc_execution_time = atoi(token);
1112 token = strsep(&psz_cur, seps);
1113 gen_obj->obj_data.node_obj.ndb_props.
1114 dsp_resource_reqmts.uwc_period = atoi(token);
1115 token = strsep(&psz_cur, seps);
1117 gen_obj->obj_data.node_obj.ndb_props.
1118 dsp_resource_reqmts.uwc_deadline = atoi(token);
1119 token = strsep(&psz_cur, seps);
1121 gen_obj->obj_data.node_obj.ndb_props.
1122 dsp_resource_reqmts.avg_exection_time = atoi(token);
1123 token = strsep(&psz_cur, seps);
1125 gen_obj->obj_data.node_obj.ndb_props.
1126 dsp_resource_reqmts.minimum_period = atoi(token);
1127 token = strsep(&psz_cur, seps);
1130 gen_obj->obj_data.node_obj.ndb_props.prio = atoi(token);
1131 token = strsep(&psz_cur, seps);
1133 /* u32 stack_size */
1134 gen_obj->obj_data.node_obj.ndb_props.stack_size = atoi(token);
1135 token = strsep(&psz_cur, seps);
1137 /* u32 sys_stack_size */
1138 gen_obj->obj_data.node_obj.ndb_props.sys_stack_size =
1140 token = strsep(&psz_cur, seps);
1143 gen_obj->obj_data.node_obj.ndb_props.stack_seg = atoi(token);
1144 token = strsep(&psz_cur, seps);
1146 /* u32 message_depth */
1147 gen_obj->obj_data.node_obj.ndb_props.message_depth =
1149 token = strsep(&psz_cur, seps);
1151 /* u32 num_input_streams */
1152 gen_obj->obj_data.node_obj.ndb_props.num_input_streams =
1154 token = strsep(&psz_cur, seps);
1156 /* u32 num_output_streams */
1157 gen_obj->obj_data.node_obj.ndb_props.num_output_streams =
1159 token = strsep(&psz_cur, seps);
1162 gen_obj->obj_data.node_obj.ndb_props.utimeout = atoi(token);
1163 token = strsep(&psz_cur, seps);
1165 /* char *pstr_create_phase_fxn */
1167 token_len = strlen(token);
1168 gen_obj->obj_data.node_obj.pstr_create_phase_fxn =
1169 kzalloc(token_len + 1, GFP_KERNEL);
1170 strncpy(gen_obj->obj_data.node_obj.pstr_create_phase_fxn,
1172 gen_obj->obj_data.node_obj.pstr_create_phase_fxn[token_len] =
1174 token = strsep(&psz_cur, seps);
1176 /* char *pstr_execute_phase_fxn */
1178 token_len = strlen(token);
1179 gen_obj->obj_data.node_obj.pstr_execute_phase_fxn =
1180 kzalloc(token_len + 1, GFP_KERNEL);
1181 strncpy(gen_obj->obj_data.node_obj.pstr_execute_phase_fxn,
1183 gen_obj->obj_data.node_obj.pstr_execute_phase_fxn[token_len] =
1185 token = strsep(&psz_cur, seps);
1187 /* char *pstr_delete_phase_fxn */
1189 token_len = strlen(token);
1190 gen_obj->obj_data.node_obj.pstr_delete_phase_fxn =
1191 kzalloc(token_len + 1, GFP_KERNEL);
1192 strncpy(gen_obj->obj_data.node_obj.pstr_delete_phase_fxn,
1194 gen_obj->obj_data.node_obj.pstr_delete_phase_fxn[token_len] =
1196 token = strsep(&psz_cur, seps);
1198 /* Segment id for message buffers */
1199 gen_obj->obj_data.node_obj.msg_segid = atoi(token);
1200 token = strsep(&psz_cur, seps);
1202 /* Message notification type */
1203 gen_obj->obj_data.node_obj.msg_notify_type = atoi(token);
1204 token = strsep(&psz_cur, seps);
1206 /* char *pstr_i_alg_name */
1208 token_len = strlen(token);
1209 gen_obj->obj_data.node_obj.pstr_i_alg_name =
1210 kzalloc(token_len + 1, GFP_KERNEL);
1211 strncpy(gen_obj->obj_data.node_obj.pstr_i_alg_name,
1213 gen_obj->obj_data.node_obj.pstr_i_alg_name[token_len] =
1215 token = strsep(&psz_cur, seps);
1218 /* Load type (static, dynamic, or overlay) */
1220 gen_obj->obj_data.node_obj.us_load_type = atoi(token);
1221 token = strsep(&psz_cur, seps);
1224 /* Dynamic load data requirements */
1226 gen_obj->obj_data.node_obj.ul_data_mem_seg_mask =
1228 token = strsep(&psz_cur, seps);
1231 /* Dynamic load code requirements */
1233 gen_obj->obj_data.node_obj.ul_code_mem_seg_mask =
1235 token = strsep(&psz_cur, seps);
1238 /* Extract node profiles into node properties */
1241 gen_obj->obj_data.node_obj.ndb_props.count_profiles =
1245 gen_obj->obj_data.node_obj.
1246 ndb_props.count_profiles; i++) {
1247 token = strsep(&psz_cur, seps);
1249 /* Heap Size for the node */
1250 gen_obj->obj_data.node_obj.
1251 ndb_props.node_profiles[i].
1252 ul_heap_size = atoi(token);
1256 token = strsep(&psz_cur, seps);
1258 gen_obj->obj_data.node_obj.ndb_props.stack_seg_name =
1264 case DSP_DCDPROCESSORTYPE:
1266 * Parse COFF sect buffer to retrieve individual tokens used
1267 * to fill in object attrs.
1270 token = strsep(&psz_cur, seps);
1272 gen_obj->obj_data.proc_info.cb_struct = atoi(token);
1273 token = strsep(&psz_cur, seps);
1275 gen_obj->obj_data.proc_info.processor_family = atoi(token);
1276 token = strsep(&psz_cur, seps);
1278 gen_obj->obj_data.proc_info.processor_type = atoi(token);
1279 token = strsep(&psz_cur, seps);
1281 gen_obj->obj_data.proc_info.clock_rate = atoi(token);
1282 token = strsep(&psz_cur, seps);
1284 gen_obj->obj_data.proc_info.ul_internal_mem_size = atoi(token);
1285 token = strsep(&psz_cur, seps);
1287 gen_obj->obj_data.proc_info.ul_external_mem_size = atoi(token);
1288 token = strsep(&psz_cur, seps);
1290 gen_obj->obj_data.proc_info.processor_id = atoi(token);
1291 token = strsep(&psz_cur, seps);
1293 gen_obj->obj_data.proc_info.ty_running_rtos = atoi(token);
1294 token = strsep(&psz_cur, seps);
1296 gen_obj->obj_data.proc_info.node_min_priority = atoi(token);
1297 token = strsep(&psz_cur, seps);
1299 gen_obj->obj_data.proc_info.node_max_priority = atoi(token);
1302 /* Proc object may contain additional(extended) attributes. */
1303 /* attr must match proc.hxx */
1304 for (entry_id = 0; entry_id < 7; entry_id++) {
1305 token = strsep(&psz_cur, seps);
1306 gen_obj->obj_data.ext_proc_obj.ty_tlb[entry_id].
1307 ul_gpp_phys = atoi(token);
1309 token = strsep(&psz_cur, seps);
1310 gen_obj->obj_data.ext_proc_obj.ty_tlb[entry_id].
1311 ul_dsp_virt = atoi(token);
1326 * ======== CompressBuffer ========
1328 * Compress the DSP buffer, if necessary, to conform to PC format.
1330 static void compress_buf(char *psz_buf, u32 ul_buf_size, s32 char_size)
1340 for (q = psz_buf; q < (psz_buf + ul_buf_size);) {
1341 ch = dsp_char2_gpp_char(q, char_size);
1344 ch = dsp_char2_gpp_char(q, char_size);
1373 /* NULL out remainder of buffer. */
1379 * ======== dsp_char2_gpp_char ========
1381 * Convert DSP char to host GPP char in a portable manner
1383 static char dsp_char2_gpp_char(char *word, s32 dsp_char_size)
1389 for (ch_src = word, i = dsp_char_size; i > 0; i--)
1396 * ======== get_dep_lib_info ========
1398 static int get_dep_lib_info(struct dcd_manager *hdcd_mgr,
1399 struct dsp_uuid *uuid_obj,
1402 struct dsp_uuid *dep_lib_uuids,
1403 bool *prstnt_dep_libs,
1404 enum nldr_phase phase)
1406 struct dcd_manager *dcd_mgr_obj = hdcd_mgr;
1407 char *psz_coff_buf = NULL;
1409 char *psz_file_name = NULL;
1410 struct cod_libraryobj *lib = NULL;
1411 u32 ul_addr = 0; /* Used by cod_get_section */
1412 u32 ul_len = 0; /* Used by cod_get_section */
1413 u32 dw_data_size = COD_MAXPATHLENGTH;
1416 bool get_uuids = (dep_lib_uuids != NULL);
1420 DBC_REQUIRE(refs > 0);
1422 DBC_REQUIRE(hdcd_mgr);
1423 DBC_REQUIRE(num_libs != NULL);
1424 DBC_REQUIRE(uuid_obj != NULL);
1426 /* Initialize to 0 dependent libraries, if only counting number of
1427 * dependent libraries */
1433 /* Allocate a buffer for file name */
1434 psz_file_name = kzalloc(dw_data_size, GFP_KERNEL);
1435 if (psz_file_name == NULL) {
1438 /* Get the name of the library */
1439 status = dcd_get_library_name(hdcd_mgr, uuid_obj, psz_file_name,
1440 &dw_data_size, phase, NULL);
1443 /* Open the library */
1445 status = cod_open(dcd_mgr_obj->cod_mgr, psz_file_name,
1449 /* Get dependent library section information. */
1450 status = cod_get_section(lib, DEPLIBSECT, &ul_addr, &ul_len);
1453 /* Ok, no dependent libraries */
1459 if (status || !(ul_len > 0))
1462 /* Allocate zeroed buffer. */
1463 psz_coff_buf = kzalloc(ul_len + 4, GFP_KERNEL);
1464 if (psz_coff_buf == NULL)
1467 /* Read section contents. */
1468 status = cod_read_section(lib, DEPLIBSECT, psz_coff_buf, ul_len);
1472 /* Compress and format DSP buffer to conform to PC format. */
1473 compress_buf(psz_coff_buf, ul_len, DSPWORDSIZE);
1475 /* Read from buffer */
1476 psz_cur = psz_coff_buf;
1477 while ((token = strsep(&psz_cur, seps)) && *token != '\0') {
1479 if (dep_libs >= *num_libs) {
1480 /* Gone beyond the limit */
1483 /* Retrieve UUID string. */
1484 uuid_uuid_from_string(token,
1487 /* Is this library persistent? */
1488 token = strsep(&psz_cur, seps);
1489 prstnt_dep_libs[dep_libs] = atoi(token);
1493 /* Advanc to next token */
1494 token = strsep(&psz_cur, seps);
1498 /* Just counting number of dependent libraries */
1506 /* Free previously allocated dynamic buffers. */
1507 kfree(psz_file_name);
1509 kfree(psz_coff_buf);