1 // SPDX-License-Identifier: GPL-2.0-only
3 * Copyright (c) 2015, NVIDIA Corporation.
6 #include <linux/platform_device.h>
7 #include <linux/dma-mapping.h>
8 #include <linux/firmware.h>
9 #include <linux/pci_ids.h>
10 #include <linux/iopoll.h>
20 static void falcon_writel(struct falcon *falcon, u32 value, u32 offset)
22 writel(value, falcon->regs + offset);
25 int falcon_wait_idle(struct falcon *falcon)
29 return readl_poll_timeout(falcon->regs + FALCON_IDLESTATE, value,
30 (value == 0), 10, 100000);
33 static int falcon_dma_wait_idle(struct falcon *falcon)
37 return readl_poll_timeout(falcon->regs + FALCON_DMATRFCMD, value,
38 (value & FALCON_DMATRFCMD_IDLE), 10, 100000);
41 static int falcon_copy_chunk(struct falcon *falcon,
44 enum falcon_memory target)
46 u32 cmd = FALCON_DMATRFCMD_SIZE_256B;
48 if (target == FALCON_MEMORY_IMEM)
49 cmd |= FALCON_DMATRFCMD_IMEM;
51 falcon_writel(falcon, offset, FALCON_DMATRFMOFFS);
52 falcon_writel(falcon, base, FALCON_DMATRFFBOFFS);
53 falcon_writel(falcon, cmd, FALCON_DMATRFCMD);
55 return falcon_dma_wait_idle(falcon);
58 static void falcon_copy_firmware_image(struct falcon *falcon,
59 const struct firmware *firmware)
61 u32 *firmware_vaddr = falcon->firmware.vaddr;
66 /* copy the whole thing taking into account endianness */
67 for (i = 0; i < firmware->size / sizeof(u32); i++)
68 firmware_vaddr[i] = le32_to_cpu(((u32 *)firmware->data)[i]);
70 /* ensure that caches are flushed and falcon can see the firmware */
71 daddr = dma_map_single(falcon->dev, firmware_vaddr,
72 falcon->firmware.size, DMA_TO_DEVICE);
73 err = dma_mapping_error(falcon->dev, daddr);
75 dev_err(falcon->dev, "failed to map firmware: %d\n", err);
78 dma_sync_single_for_device(falcon->dev, daddr,
79 falcon->firmware.size, DMA_TO_DEVICE);
80 dma_unmap_single(falcon->dev, daddr, falcon->firmware.size,
84 static int falcon_parse_firmware_image(struct falcon *falcon)
86 struct falcon_fw_bin_header_v1 *bin = (void *)falcon->firmware.vaddr;
87 struct falcon_fw_os_header_v1 *os;
89 /* endian problems would show up right here */
90 if (bin->magic != PCI_VENDOR_ID_NVIDIA) {
91 dev_err(falcon->dev, "incorrect firmware magic\n");
95 /* currently only version 1 is supported */
96 if (bin->version != 1) {
97 dev_err(falcon->dev, "unsupported firmware version\n");
101 /* check that the firmware size is consistent */
102 if (bin->size > falcon->firmware.size) {
103 dev_err(falcon->dev, "firmware image size inconsistency\n");
107 os = falcon->firmware.vaddr + bin->os_header_offset;
109 falcon->firmware.bin_data.size = bin->os_size;
110 falcon->firmware.bin_data.offset = bin->os_data_offset;
111 falcon->firmware.code.offset = os->code_offset;
112 falcon->firmware.code.size = os->code_size;
113 falcon->firmware.data.offset = os->data_offset;
114 falcon->firmware.data.size = os->data_size;
119 int falcon_read_firmware(struct falcon *falcon, const char *name)
123 /* request_firmware prints error if it fails */
124 err = request_firmware(&falcon->firmware.firmware, name, falcon->dev);
131 int falcon_load_firmware(struct falcon *falcon)
133 const struct firmware *firmware = falcon->firmware.firmware;
136 falcon->firmware.size = firmware->size;
138 /* allocate iova space for the firmware */
139 falcon->firmware.vaddr = falcon->ops->alloc(falcon, firmware->size,
140 &falcon->firmware.paddr);
141 if (IS_ERR(falcon->firmware.vaddr)) {
142 dev_err(falcon->dev, "DMA memory mapping failed\n");
143 return PTR_ERR(falcon->firmware.vaddr);
146 /* copy firmware image into local area. this also ensures endianness */
147 falcon_copy_firmware_image(falcon, firmware);
149 /* parse the image data */
150 err = falcon_parse_firmware_image(falcon);
152 dev_err(falcon->dev, "failed to parse firmware image\n");
153 goto err_setup_firmware_image;
156 release_firmware(firmware);
157 falcon->firmware.firmware = NULL;
161 err_setup_firmware_image:
162 falcon->ops->free(falcon, falcon->firmware.size,
163 falcon->firmware.paddr, falcon->firmware.vaddr);
168 int falcon_init(struct falcon *falcon)
170 /* check mandatory ops */
171 if (!falcon->ops || !falcon->ops->alloc || !falcon->ops->free)
174 falcon->firmware.vaddr = NULL;
179 void falcon_exit(struct falcon *falcon)
181 if (falcon->firmware.firmware) {
182 release_firmware(falcon->firmware.firmware);
183 falcon->firmware.firmware = NULL;
186 if (falcon->firmware.vaddr) {
187 falcon->ops->free(falcon, falcon->firmware.size,
188 falcon->firmware.paddr,
189 falcon->firmware.vaddr);
190 falcon->firmware.vaddr = NULL;
194 int falcon_boot(struct falcon *falcon)
196 unsigned long offset;
200 if (!falcon->firmware.vaddr)
203 err = readl_poll_timeout(falcon->regs + FALCON_DMACTL, value,
204 (value & (FALCON_DMACTL_IMEM_SCRUBBING |
205 FALCON_DMACTL_DMEM_SCRUBBING)) == 0,
210 falcon_writel(falcon, 0, FALCON_DMACTL);
212 /* setup the address of the binary data so Falcon can access it later */
213 falcon_writel(falcon, (falcon->firmware.paddr +
214 falcon->firmware.bin_data.offset) >> 8,
217 /* copy the data segment into Falcon internal memory */
218 for (offset = 0; offset < falcon->firmware.data.size; offset += 256)
219 falcon_copy_chunk(falcon,
220 falcon->firmware.data.offset + offset,
221 offset, FALCON_MEMORY_DATA);
223 /* copy the first code segment into Falcon internal memory */
224 falcon_copy_chunk(falcon, falcon->firmware.code.offset,
225 0, FALCON_MEMORY_IMEM);
227 /* setup falcon interrupts */
228 falcon_writel(falcon, FALCON_IRQMSET_EXT(0xff) |
229 FALCON_IRQMSET_SWGEN1 |
230 FALCON_IRQMSET_SWGEN0 |
231 FALCON_IRQMSET_EXTERR |
232 FALCON_IRQMSET_HALT |
233 FALCON_IRQMSET_WDTMR,
235 falcon_writel(falcon, FALCON_IRQDEST_EXT(0xff) |
236 FALCON_IRQDEST_SWGEN1 |
237 FALCON_IRQDEST_SWGEN0 |
238 FALCON_IRQDEST_EXTERR |
242 /* enable interface */
243 falcon_writel(falcon, FALCON_ITFEN_MTHDEN |
248 falcon_writel(falcon, 0x00000000, FALCON_BOOTVEC);
249 falcon_writel(falcon, FALCON_CPUCTL_STARTCPU, FALCON_CPUCTL);
251 err = falcon_wait_idle(falcon);
253 dev_err(falcon->dev, "Falcon boot failed due to timeout\n");
260 void falcon_execute_method(struct falcon *falcon, u32 method, u32 data)
262 falcon_writel(falcon, method >> 2, FALCON_UCLASS_METHOD_OFFSET);
263 falcon_writel(falcon, data, FALCON_UCLASS_METHOD_DATA);