xref: /linux/drivers/gpu/drm/nouveau/nvkm/core/firmware.c (revision 0be3ff0c)
1 /*
2  * Copyright (c) 2016, NVIDIA CORPORATION. All rights reserved.
3  *
4  * Permission is hereby granted, free of charge, to any person obtaining a
5  * copy of this software and associated documentation files (the "Software"),
6  * to deal in the Software without restriction, including without limitation
7  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
8  * and/or sell copies of the Software, and to permit persons to whom the
9  * Software is furnished to do so, subject to the following conditions:
10  *
11  * The above copyright notice and this permission notice shall be included in
12  * all copies or substantial portions of the Software.
13  *
14  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
15  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
17  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
18  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
19  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
20  * DEALINGS IN THE SOFTWARE.
21  */
22 #include <core/device.h>
23 #include <core/firmware.h>
24 
25 int
26 nvkm_firmware_load_name(const struct nvkm_subdev *subdev, const char *base,
27 			const char *name, int ver, const struct firmware **pfw)
28 {
29 	char path[64];
30 	int ret;
31 
32 	snprintf(path, sizeof(path), "%s%s", base, name);
33 	ret = nvkm_firmware_get(subdev, path, ver, pfw);
34 	if (ret < 0)
35 		return ret;
36 
37 	return 0;
38 }
39 
40 int
41 nvkm_firmware_load_blob(const struct nvkm_subdev *subdev, const char *base,
42 			const char *name, int ver, struct nvkm_blob *blob)
43 {
44 	const struct firmware *fw;
45 	int ret;
46 
47 	ret = nvkm_firmware_load_name(subdev, base, name, ver, &fw);
48 	if (ret == 0) {
49 		blob->data = kmemdup(fw->data, fw->size, GFP_KERNEL);
50 		blob->size = fw->size;
51 		nvkm_firmware_put(fw);
52 		if (!blob->data)
53 			return -ENOMEM;
54 	}
55 
56 	return ret;
57 }
58 
59 /**
60  * nvkm_firmware_get - load firmware from the official nvidia/chip/ directory
61  * @subdev:	subdevice that will use that firmware
62  * @fwname:	name of firmware file to load
63  * @ver:	firmware version to load
64  * @fw:		firmware structure to load to
65  *
66  * Use this function to load firmware files in the form nvidia/chip/fwname.bin.
67  * Firmware files released by NVIDIA will always follow this format.
68  */
69 int
70 nvkm_firmware_get(const struct nvkm_subdev *subdev, const char *fwname, int ver,
71 		  const struct firmware **fw)
72 {
73 	struct nvkm_device *device = subdev->device;
74 	char f[64];
75 	char cname[16];
76 	int i;
77 
78 	/* Convert device name to lowercase */
79 	strncpy(cname, device->chip->name, sizeof(cname));
80 	cname[sizeof(cname) - 1] = '\0';
81 	i = strlen(cname);
82 	while (i) {
83 		--i;
84 		cname[i] = tolower(cname[i]);
85 	}
86 
87 	if (ver != 0)
88 		snprintf(f, sizeof(f), "nvidia/%s/%s-%d.bin", cname, fwname, ver);
89 	else
90 		snprintf(f, sizeof(f), "nvidia/%s/%s.bin", cname, fwname);
91 
92 	if (!firmware_request_nowarn(fw, f, device->dev)) {
93 		nvkm_debug(subdev, "firmware \"%s\" loaded - %zu byte(s)\n",
94 			   f, (*fw)->size);
95 		return 0;
96 	}
97 
98 	nvkm_debug(subdev, "firmware \"%s\" unavailable\n", f);
99 	return -ENOENT;
100 }
101 
102 /*
103  * nvkm_firmware_put - release firmware loaded with nvkm_firmware_get
104  */
105 void
106 nvkm_firmware_put(const struct firmware *fw)
107 {
108 	release_firmware(fw);
109 }
110