2 * skl-sst-utils.c - SKL sst utils functions
4 * Copyright (C) 2016 Intel Corp
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as version 2, as
8 * published by the Free Software Foundation.
10 * This program is distributed in the hope that it will be useful, but
11 * WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 * General Public License for more details.
16 #include <linux/device.h>
17 #include <linux/slab.h>
18 #include <linux/uuid.h>
19 #include "skl-sst-dsp.h"
20 #include "../common/sst-dsp.h"
21 #include "../common/sst-dsp-priv.h"
22 #include "skl-sst-ipc.h"
25 #define UUID_STR_SIZE 37
26 #define DEFAULT_HASH_SHA256_LEN 32
28 /* FW Extended Manifest Header id = $AE1 */
29 #define SKL_EXT_MANIFEST_HEADER_MAGIC 0x31454124
52 union seg_flags flags
;
65 struct adsp_module_entry
{
69 struct module_type type
;
70 u8 hash1
[DEFAULT_HASH_SHA256_LEN
];
75 u16 instance_max_count
;
76 u16 instance_bss_size
;
77 struct segment_desc segments
[3];
84 u32 preload_page_count
;
97 struct skl_ext_manifest_hdr
{
105 static int skl_get_pvtid_map(struct uuid_module
*module
, int instance_id
)
109 for (pvt_id
= 0; pvt_id
< module
->max_instance
; pvt_id
++) {
110 if (module
->instance_id
[pvt_id
] == instance_id
)
116 int skl_get_pvt_instance_id_map(struct skl_sst
*ctx
,
117 int module_id
, int instance_id
)
119 struct uuid_module
*module
;
121 list_for_each_entry(module
, &ctx
->uuid_list
, list
) {
122 if (module
->id
== module_id
)
123 return skl_get_pvtid_map(module
, instance_id
);
128 EXPORT_SYMBOL_GPL(skl_get_pvt_instance_id_map
);
130 static inline int skl_getid_32(struct uuid_module
*module
, u64
*val
,
131 int word1_mask
, int word2_mask
)
133 int index
, max_inst
, pvt_id
;
136 max_inst
= module
->max_instance
;
137 mask_val
= (u32
)(*val
>> word1_mask
);
139 if (mask_val
!= 0xffffffff) {
140 index
= ffz(mask_val
);
141 pvt_id
= index
+ word1_mask
+ word2_mask
;
142 if (pvt_id
<= (max_inst
- 1)) {
143 *val
|= 1ULL << (index
+ word1_mask
);
151 static inline int skl_pvtid_128(struct uuid_module
*module
)
153 int j
, i
, word1_mask
, word2_mask
= 0, pvt_id
;
155 for (j
= 0; j
< MAX_INSTANCE_BUFF
; j
++) {
158 for (i
= 0; i
< 2; i
++) {
159 pvt_id
= skl_getid_32(module
, &module
->pvt_id
[j
],
160 word1_mask
, word2_mask
);
165 if ((word1_mask
+ word2_mask
) >= module
->max_instance
)
170 if (word2_mask
>= module
->max_instance
)
178 * skl_get_pvt_id: generate a private id for use as module id
180 * @ctx: driver context
181 * @mconfig: module configuration data
183 * This generates a 128 bit private unique id for a module TYPE so that
184 * module instance is unique
186 int skl_get_pvt_id(struct skl_sst
*ctx
, uuid_le
*uuid_mod
, int instance_id
)
188 struct uuid_module
*module
;
191 list_for_each_entry(module
, &ctx
->uuid_list
, list
) {
192 if (uuid_le_cmp(*uuid_mod
, module
->uuid
) == 0) {
194 pvt_id
= skl_pvtid_128(module
);
196 module
->instance_id
[pvt_id
] = instance_id
;
205 EXPORT_SYMBOL_GPL(skl_get_pvt_id
);
208 * skl_put_pvt_id: free up the private id allocated
210 * @ctx: driver context
211 * @mconfig: module configuration data
213 * This frees a 128 bit private unique id previously generated
215 int skl_put_pvt_id(struct skl_sst
*ctx
, uuid_le
*uuid_mod
, int *pvt_id
)
218 struct uuid_module
*module
;
220 list_for_each_entry(module
, &ctx
->uuid_list
, list
) {
221 if (uuid_le_cmp(*uuid_mod
, module
->uuid
) == 0) {
228 module
->pvt_id
[i
] &= ~(1 << (*pvt_id
));
236 EXPORT_SYMBOL_GPL(skl_put_pvt_id
);
239 * Parse the firmware binary to get the UUID, module id
242 int snd_skl_parse_uuids(struct sst_dsp
*ctx
, const struct firmware
*fw
,
243 unsigned int offset
, int index
)
245 struct adsp_fw_hdr
*adsp_hdr
;
246 struct adsp_module_entry
*mod_entry
;
247 int i
, num_entry
, size
;
250 struct skl_sst
*skl
= ctx
->thread_context
;
251 struct uuid_module
*module
;
252 struct firmware stripped_fw
;
253 unsigned int safe_file
;
255 /* Get the FW pointer to derive ADSP header */
256 stripped_fw
.data
= fw
->data
;
257 stripped_fw
.size
= fw
->size
;
259 skl_dsp_strip_extended_manifest(&stripped_fw
);
261 buf
= stripped_fw
.data
;
263 /* check if we have enough space in file to move to header */
264 safe_file
= sizeof(*adsp_hdr
) + offset
;
265 if (stripped_fw
.size
<= safe_file
) {
266 dev_err(ctx
->dev
, "Small fw file size, No space for hdr\n");
270 adsp_hdr
= (struct adsp_fw_hdr
*)(buf
+ offset
);
272 /* check 1st module entry is in file */
273 safe_file
+= adsp_hdr
->len
+ sizeof(*mod_entry
);
274 if (stripped_fw
.size
<= safe_file
) {
275 dev_err(ctx
->dev
, "Small fw file size, No module entry\n");
279 mod_entry
= (struct adsp_module_entry
*)
280 (buf
+ offset
+ adsp_hdr
->len
);
282 num_entry
= adsp_hdr
->num_modules
;
284 /* check all entries are in file */
285 safe_file
+= num_entry
* sizeof(*mod_entry
);
286 if (stripped_fw
.size
<= safe_file
) {
287 dev_err(ctx
->dev
, "Small fw file size, No modules\n");
293 * Read the UUID(GUID) from FW Manifest.
295 * The 16 byte UUID format is: XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXX
296 * Populate the UUID table to store module_id and loadable flags
300 for (i
= 0; i
< num_entry
; i
++, mod_entry
++) {
301 module
= kzalloc(sizeof(*module
), GFP_KERNEL
);
305 uuid_bin
= (uuid_le
*)mod_entry
->uuid
.id
;
306 memcpy(&module
->uuid
, uuid_bin
, sizeof(module
->uuid
));
308 module
->id
= (i
| (index
<< 12));
309 module
->is_loadable
= mod_entry
->type
.load_type
;
310 module
->max_instance
= mod_entry
->instance_max_count
;
311 size
= sizeof(int) * mod_entry
->instance_max_count
;
312 module
->instance_id
= devm_kzalloc(ctx
->dev
, size
, GFP_KERNEL
);
313 if (!module
->instance_id
) {
318 list_add_tail(&module
->list
, &skl
->uuid_list
);
321 "Adding uuid :%pUL mod id: %d Loadable: %d\n",
322 &module
->uuid
, module
->id
, module
->is_loadable
);
328 void skl_freeup_uuid_list(struct skl_sst
*ctx
)
330 struct uuid_module
*uuid
, *_uuid
;
332 list_for_each_entry_safe(uuid
, _uuid
, &ctx
->uuid_list
, list
) {
333 list_del(&uuid
->list
);
339 * some firmware binary contains some extended manifest. This needs
340 * to be stripped in that case before we load and use that image.
342 * Get the module id for the module by checking
343 * the table for the UUID for the module
345 int skl_dsp_strip_extended_manifest(struct firmware
*fw
)
347 struct skl_ext_manifest_hdr
*hdr
;
349 /* check if fw file is greater than header we are looking */
350 if (fw
->size
< sizeof(hdr
)) {
351 pr_err("%s: Firmware file small, no hdr\n", __func__
);
355 hdr
= (struct skl_ext_manifest_hdr
*)fw
->data
;
357 if (hdr
->id
== SKL_EXT_MANIFEST_HEADER_MAGIC
) {
358 fw
->size
-= hdr
->len
;
359 fw
->data
+= hdr
->len
;
365 int skl_sst_ctx_init(struct device
*dev
, int irq
, const char *fw_name
,
366 struct skl_dsp_loader_ops dsp_ops
, struct skl_sst
**dsp
,
367 struct sst_dsp_device
*skl_dev
)
373 skl
= devm_kzalloc(dev
, sizeof(*skl
), GFP_KERNEL
);
378 skl_dev
->thread_context
= skl
;
379 INIT_LIST_HEAD(&skl
->uuid_list
);
380 skl
->dsp
= skl_dsp_ctx_init(dev
, skl_dev
, irq
);
382 dev_err(skl
->dev
, "%s: no device\n", __func__
);
387 sst
->fw_name
= fw_name
;
388 sst
->dsp_ops
= dsp_ops
;
389 init_waitqueue_head(&skl
->mod_load_wait
);
390 INIT_LIST_HEAD(&sst
->module_list
);
391 ret
= skl_ipc_init(dev
, skl
);
395 skl
->is_first_boot
= true;
402 int skl_prepare_lib_load(struct skl_sst
*skl
, struct skl_lib_info
*linfo
,
403 struct firmware
*stripped_fw
,
404 unsigned int hdr_offset
, int index
)
407 struct sst_dsp
*dsp
= skl
->dsp
;
409 if (linfo
->fw
== NULL
) {
410 ret
= request_firmware(&linfo
->fw
, linfo
->name
,
413 dev_err(skl
->dev
, "Request lib %s failed:%d\n",
419 if (skl
->is_first_boot
) {
420 ret
= snd_skl_parse_uuids(dsp
, linfo
->fw
, hdr_offset
, index
);
425 stripped_fw
->data
= linfo
->fw
->data
;
426 stripped_fw
->size
= linfo
->fw
->size
;
427 skl_dsp_strip_extended_manifest(stripped_fw
);
432 void skl_release_library(struct skl_lib_info
*linfo
, int lib_count
)
436 /* library indices start from 1 to N. 0 represents base FW */
437 for (i
= 1; i
< lib_count
; i
++) {
439 release_firmware(linfo
[i
].fw
);