1// SPDX-License-Identifier: GPL-2.0-or-later
2/*
3 * cx18 firmware functions
4 *
5 * Copyright (C) 2007 Hans Verkuil <hverkuil@xs4all.nl>
6 * Copyright (C) 2008 Andy Walls <awalls@md.metrocast.net>
7 */
8
9#include "cx18-driver.h"
10#include "cx18-io.h"
11#include "cx18-scb.h"
12#include "cx18-irq.h"
13#include "cx18-firmware.h"
14#include "cx18-cards.h"
15#include <linux/firmware.h>
16
17#define CX18_PROC_SOFT_RESET 0xc70010
18#define CX18_DDR_SOFT_RESET 0xc70014
19#define CX18_CLOCK_SELECT1 0xc71000
20#define CX18_CLOCK_SELECT2 0xc71004
21#define CX18_HALF_CLOCK_SELECT1 0xc71008
22#define CX18_HALF_CLOCK_SELECT2 0xc7100C
23#define CX18_CLOCK_POLARITY1 0xc71010
24#define CX18_CLOCK_POLARITY2 0xc71014
25#define CX18_ADD_DELAY_ENABLE1 0xc71018
26#define CX18_ADD_DELAY_ENABLE2 0xc7101C
27#define CX18_CLOCK_ENABLE1 0xc71020
28#define CX18_CLOCK_ENABLE2 0xc71024
29
30#define CX18_REG_BUS_TIMEOUT_EN 0xc72024
31
32#define CX18_FAST_CLOCK_PLL_INT 0xc78000
33#define CX18_FAST_CLOCK_PLL_FRAC 0xc78004
34#define CX18_FAST_CLOCK_PLL_POST 0xc78008
35#define CX18_FAST_CLOCK_PLL_PRESCALE 0xc7800C
36#define CX18_FAST_CLOCK_PLL_ADJUST_BANDWIDTH 0xc78010
37
38#define CX18_SLOW_CLOCK_PLL_INT 0xc78014
39#define CX18_SLOW_CLOCK_PLL_FRAC 0xc78018
40#define CX18_SLOW_CLOCK_PLL_POST 0xc7801C
41#define CX18_MPEG_CLOCK_PLL_INT 0xc78040
42#define CX18_MPEG_CLOCK_PLL_FRAC 0xc78044
43#define CX18_MPEG_CLOCK_PLL_POST 0xc78048
44#define CX18_PLL_POWER_DOWN 0xc78088
45#define CX18_SW1_INT_STATUS 0xc73104
46#define CX18_SW1_INT_ENABLE_PCI 0xc7311C
47#define CX18_SW2_INT_SET 0xc73140
48#define CX18_SW2_INT_STATUS 0xc73144
49#define CX18_ADEC_CONTROL 0xc78120
50
51#define CX18_DDR_REQUEST_ENABLE 0xc80000
52#define CX18_DDR_CHIP_CONFIG 0xc80004
53#define CX18_DDR_REFRESH 0xc80008
54#define CX18_DDR_TIMING1 0xc8000C
55#define CX18_DDR_TIMING2 0xc80010
56#define CX18_DDR_POWER_REG 0xc8001C
57
58#define CX18_DDR_TUNE_LANE 0xc80048
59#define CX18_DDR_INITIAL_EMRS 0xc80054
60#define CX18_DDR_MB_PER_ROW_7 0xc8009C
61#define CX18_DDR_BASE_63_ADDR 0xc804FC
62
63#define CX18_WMB_CLIENT02 0xc90108
64#define CX18_WMB_CLIENT05 0xc90114
65#define CX18_WMB_CLIENT06 0xc90118
66#define CX18_WMB_CLIENT07 0xc9011C
67#define CX18_WMB_CLIENT08 0xc90120
68#define CX18_WMB_CLIENT09 0xc90124
69#define CX18_WMB_CLIENT10 0xc90128
70#define CX18_WMB_CLIENT11 0xc9012C
71#define CX18_WMB_CLIENT12 0xc90130
72#define CX18_WMB_CLIENT13 0xc90134
73#define CX18_WMB_CLIENT14 0xc90138
74
75#define CX18_DSP0_INTERRUPT_MASK 0xd0004C
76
77#define APU_ROM_SYNC1 0x6D676553 /* "mgeS" */
78#define APU_ROM_SYNC2 0x72646548 /* "rdeH" */
79
80struct cx18_apu_rom_seghdr {
81 u32 sync1;
82 u32 sync2;
83 u32 addr;
84 u32 size;
85};
86
87static int load_cpu_fw_direct(const char *fn, u8 __iomem *mem, struct cx18 *cx)
88{
89 const struct firmware *fw = NULL;
90 int i, j;
91 unsigned size;
92 u32 __iomem *dst = (u32 __iomem *)mem;
93 const u32 *src;
94
95 if (request_firmware(fw: &fw, name: fn, device: &cx->pci_dev->dev)) {
96 CX18_ERR("Unable to open firmware %s\n", fn);
97 CX18_ERR("Did you put the firmware in the hotplug firmware directory?\n");
98 return -ENOMEM;
99 }
100
101 src = (const u32 *)fw->data;
102
103 for (i = 0; i < fw->size; i += 4096) {
104 cx18_setup_page(cx, addr: i);
105 for (j = i; j < fw->size && j < i + 4096; j += 4) {
106 /* no need for endianness conversion on the ppc */
107 cx18_raw_writel(cx, val: *src, addr: dst);
108 if (cx18_raw_readl(cx, addr: dst) != *src) {
109 CX18_ERR("Mismatch at offset %x\n", i);
110 release_firmware(fw);
111 cx18_setup_page(cx, addr: 0);
112 return -EIO;
113 }
114 dst++;
115 src++;
116 }
117 }
118 if (!test_bit(CX18_F_I_LOADED_FW, &cx->i_flags))
119 CX18_INFO("loaded %s firmware (%zu bytes)\n", fn, fw->size);
120 size = fw->size;
121 release_firmware(fw);
122 cx18_setup_page(cx, SCB_OFFSET);
123 return size;
124}
125
126static int load_apu_fw_direct(const char *fn, u8 __iomem *dst, struct cx18 *cx,
127 u32 *entry_addr)
128{
129 const struct firmware *fw = NULL;
130 int i, j;
131 unsigned size;
132 const u32 *src;
133 struct cx18_apu_rom_seghdr seghdr;
134 const u8 *vers;
135 u32 offset = 0;
136 u32 apu_version = 0;
137 int sz;
138
139 if (request_firmware(fw: &fw, name: fn, device: &cx->pci_dev->dev)) {
140 CX18_ERR("unable to open firmware %s\n", fn);
141 CX18_ERR("did you put the firmware in the hotplug firmware directory?\n");
142 cx18_setup_page(cx, addr: 0);
143 return -ENOMEM;
144 }
145
146 *entry_addr = 0;
147 src = (const u32 *)fw->data;
148 vers = fw->data + sizeof(seghdr);
149 sz = fw->size;
150
151 apu_version = (vers[0] << 24) | (vers[4] << 16) | vers[32];
152 while (offset + sizeof(seghdr) < fw->size) {
153 const __le32 *shptr = (__force __le32 *)src + offset / 4;
154
155 seghdr.sync1 = le32_to_cpu(shptr[0]);
156 seghdr.sync2 = le32_to_cpu(shptr[1]);
157 seghdr.addr = le32_to_cpu(shptr[2]);
158 seghdr.size = le32_to_cpu(shptr[3]);
159
160 offset += sizeof(seghdr);
161 if (seghdr.sync1 != APU_ROM_SYNC1 ||
162 seghdr.sync2 != APU_ROM_SYNC2) {
163 offset += seghdr.size;
164 continue;
165 }
166 CX18_DEBUG_INFO("load segment %x-%x\n", seghdr.addr,
167 seghdr.addr + seghdr.size - 1);
168 if (*entry_addr == 0)
169 *entry_addr = seghdr.addr;
170 if (offset + seghdr.size > sz)
171 break;
172 for (i = 0; i < seghdr.size; i += 4096) {
173 cx18_setup_page(cx, addr: seghdr.addr + i);
174 for (j = i; j < seghdr.size && j < i + 4096; j += 4) {
175 /* no need for endianness conversion on the ppc */
176 cx18_raw_writel(cx, val: src[(offset + j) / 4],
177 addr: dst + seghdr.addr + j);
178 if (cx18_raw_readl(cx, addr: dst + seghdr.addr + j)
179 != src[(offset + j) / 4]) {
180 CX18_ERR("Mismatch at offset %x\n",
181 offset + j);
182 release_firmware(fw);
183 cx18_setup_page(cx, addr: 0);
184 return -EIO;
185 }
186 }
187 }
188 offset += seghdr.size;
189 }
190 if (!test_bit(CX18_F_I_LOADED_FW, &cx->i_flags))
191 CX18_INFO("loaded %s firmware V%08x (%zu bytes)\n",
192 fn, apu_version, fw->size);
193 size = fw->size;
194 release_firmware(fw);
195 cx18_setup_page(cx, addr: 0);
196 return size;
197}
198
199void cx18_halt_firmware(struct cx18 *cx)
200{
201 CX18_DEBUG_INFO("Preparing for firmware halt.\n");
202 cx18_write_reg_expect(cx, val: 0x000F000F, CX18_PROC_SOFT_RESET,
203 eval: 0x0000000F, mask: 0x000F000F);
204 cx18_write_reg_expect(cx, val: 0x00020002, CX18_ADEC_CONTROL,
205 eval: 0x00000002, mask: 0x00020002);
206}
207
208void cx18_init_power(struct cx18 *cx, int lowpwr)
209{
210 /* power-down Spare and AOM PLLs */
211 /* power-up fast, slow and mpeg PLLs */
212 cx18_write_reg(cx, val: 0x00000008, CX18_PLL_POWER_DOWN);
213
214 /* ADEC out of sleep */
215 cx18_write_reg_expect(cx, val: 0x00020000, CX18_ADEC_CONTROL,
216 eval: 0x00000000, mask: 0x00020002);
217
218 /*
219 * The PLL parameters are based on the external crystal frequency that
220 * would ideally be:
221 *
222 * NTSC Color subcarrier freq * 8 =
223 * 4.5 MHz/286 * 455/2 * 8 = 28.63636363... MHz
224 *
225 * The accidents of history and rationale that explain from where this
226 * combination of magic numbers originate can be found in:
227 *
228 * [1] Abrahams, I. C., "Choice of Chrominance Subcarrier Frequency in
229 * the NTSC Standards", Proceedings of the I-R-E, January 1954, pp 79-80
230 *
231 * [2] Abrahams, I. C., "The 'Frequency Interleaving' Principle in the
232 * NTSC Standards", Proceedings of the I-R-E, January 1954, pp 81-83
233 *
234 * As Mike Bradley has rightly pointed out, it's not the exact crystal
235 * frequency that matters, only that all parts of the driver and
236 * firmware are using the same value (close to the ideal value).
237 *
238 * Since I have a strong suspicion that, if the firmware ever assumes a
239 * crystal value at all, it will assume 28.636360 MHz, the crystal
240 * freq used in calculations in this driver will be:
241 *
242 * xtal_freq = 28.636360 MHz
243 *
244 * an error of less than 0.13 ppm which is way, way better than any off
245 * the shelf crystal will have for accuracy anyway.
246 *
247 * Below I aim to run the PLLs' VCOs near 400 MHz to minimize errors.
248 *
249 * Many thanks to Jeff Campbell and Mike Bradley for their extensive
250 * investigation, experimentation, testing, and suggested solutions of
251 * audio/video sync problems with SVideo and CVBS captures.
252 */
253
254 /* the fast clock is at 200/245 MHz */
255 /* 1 * xtal_freq * 0x0d.f7df9b8 / 2 = 200 MHz: 400 MHz pre post-divide*/
256 /* 1 * xtal_freq * 0x11.1c71eb8 / 2 = 245 MHz: 490 MHz pre post-divide*/
257 cx18_write_reg(cx, val: lowpwr ? 0xD : 0x11, CX18_FAST_CLOCK_PLL_INT);
258 cx18_write_reg(cx, val: lowpwr ? 0x1EFBF37 : 0x038E3D7,
259 CX18_FAST_CLOCK_PLL_FRAC);
260
261 cx18_write_reg(cx, val: 2, CX18_FAST_CLOCK_PLL_POST);
262 cx18_write_reg(cx, val: 1, CX18_FAST_CLOCK_PLL_PRESCALE);
263 cx18_write_reg(cx, val: 4, CX18_FAST_CLOCK_PLL_ADJUST_BANDWIDTH);
264
265 /* set slow clock to 125/120 MHz */
266 /* xtal_freq * 0x0d.1861a20 / 3 = 125 MHz: 375 MHz before post-divide */
267 /* xtal_freq * 0x0c.92493f8 / 3 = 120 MHz: 360 MHz before post-divide */
268 cx18_write_reg(cx, val: lowpwr ? 0xD : 0xC, CX18_SLOW_CLOCK_PLL_INT);
269 cx18_write_reg(cx, val: lowpwr ? 0x30C344 : 0x124927F,
270 CX18_SLOW_CLOCK_PLL_FRAC);
271 cx18_write_reg(cx, val: 3, CX18_SLOW_CLOCK_PLL_POST);
272
273 /* mpeg clock pll 54MHz */
274 /* xtal_freq * 0xf.15f17f0 / 8 = 54 MHz: 432 MHz before post-divide */
275 cx18_write_reg(cx, val: 0xF, CX18_MPEG_CLOCK_PLL_INT);
276 cx18_write_reg(cx, val: 0x2BE2FE, CX18_MPEG_CLOCK_PLL_FRAC);
277 cx18_write_reg(cx, val: 8, CX18_MPEG_CLOCK_PLL_POST);
278
279 /* Defaults */
280 /* APU = SC or SC/2 = 125/62.5 */
281 /* EPU = SC = 125 */
282 /* DDR = FC = 180 */
283 /* ENC = SC = 125 */
284 /* AI1 = SC = 125 */
285 /* VIM2 = disabled */
286 /* PCI = FC/2 = 90 */
287 /* AI2 = disabled */
288 /* DEMUX = disabled */
289 /* AO = SC/2 = 62.5 */
290 /* SER = 54MHz */
291 /* VFC = disabled */
292 /* USB = disabled */
293
294 if (lowpwr) {
295 cx18_write_reg_expect(cx, val: 0xFFFF0020, CX18_CLOCK_SELECT1,
296 eval: 0x00000020, mask: 0xFFFFFFFF);
297 cx18_write_reg_expect(cx, val: 0xFFFF0004, CX18_CLOCK_SELECT2,
298 eval: 0x00000004, mask: 0xFFFFFFFF);
299 } else {
300 /* This doesn't explicitly set every clock select */
301 cx18_write_reg_expect(cx, val: 0x00060004, CX18_CLOCK_SELECT1,
302 eval: 0x00000004, mask: 0x00060006);
303 cx18_write_reg_expect(cx, val: 0x00060006, CX18_CLOCK_SELECT2,
304 eval: 0x00000006, mask: 0x00060006);
305 }
306
307 cx18_write_reg_expect(cx, val: 0xFFFF0002, CX18_HALF_CLOCK_SELECT1,
308 eval: 0x00000002, mask: 0xFFFFFFFF);
309 cx18_write_reg_expect(cx, val: 0xFFFF0104, CX18_HALF_CLOCK_SELECT2,
310 eval: 0x00000104, mask: 0xFFFFFFFF);
311 cx18_write_reg_expect(cx, val: 0xFFFF9026, CX18_CLOCK_ENABLE1,
312 eval: 0x00009026, mask: 0xFFFFFFFF);
313 cx18_write_reg_expect(cx, val: 0xFFFF3105, CX18_CLOCK_ENABLE2,
314 eval: 0x00003105, mask: 0xFFFFFFFF);
315}
316
317void cx18_init_memory(struct cx18 *cx)
318{
319 cx18_msleep_timeout(msecs: 10, intr: 0);
320 cx18_write_reg_expect(cx, val: 0x00010000, CX18_DDR_SOFT_RESET,
321 eval: 0x00000000, mask: 0x00010001);
322 cx18_msleep_timeout(msecs: 10, intr: 0);
323
324 cx18_write_reg(cx, val: cx->card->ddr.chip_config, CX18_DDR_CHIP_CONFIG);
325
326 cx18_msleep_timeout(msecs: 10, intr: 0);
327
328 cx18_write_reg(cx, val: cx->card->ddr.refresh, CX18_DDR_REFRESH);
329 cx18_write_reg(cx, val: cx->card->ddr.timing1, CX18_DDR_TIMING1);
330 cx18_write_reg(cx, val: cx->card->ddr.timing2, CX18_DDR_TIMING2);
331
332 cx18_msleep_timeout(msecs: 10, intr: 0);
333
334 /* Initialize DQS pad time */
335 cx18_write_reg(cx, val: cx->card->ddr.tune_lane, CX18_DDR_TUNE_LANE);
336 cx18_write_reg(cx, val: cx->card->ddr.initial_emrs, CX18_DDR_INITIAL_EMRS);
337
338 cx18_msleep_timeout(msecs: 10, intr: 0);
339
340 cx18_write_reg_expect(cx, val: 0x00020000, CX18_DDR_SOFT_RESET,
341 eval: 0x00000000, mask: 0x00020002);
342 cx18_msleep_timeout(msecs: 10, intr: 0);
343
344 /* use power-down mode when idle */
345 cx18_write_reg(cx, val: 0x00000010, CX18_DDR_POWER_REG);
346
347 cx18_write_reg_expect(cx, val: 0x00010001, CX18_REG_BUS_TIMEOUT_EN,
348 eval: 0x00000001, mask: 0x00010001);
349
350 cx18_write_reg(cx, val: 0x48, CX18_DDR_MB_PER_ROW_7);
351 cx18_write_reg(cx, val: 0xE0000, CX18_DDR_BASE_63_ADDR);
352
353 cx18_write_reg(cx, val: 0x00000101, CX18_WMB_CLIENT02); /* AO */
354 cx18_write_reg(cx, val: 0x00000101, CX18_WMB_CLIENT09); /* AI2 */
355 cx18_write_reg(cx, val: 0x00000101, CX18_WMB_CLIENT05); /* VIM1 */
356 cx18_write_reg(cx, val: 0x00000101, CX18_WMB_CLIENT06); /* AI1 */
357 cx18_write_reg(cx, val: 0x00000101, CX18_WMB_CLIENT07); /* 3D comb */
358 cx18_write_reg(cx, val: 0x00000101, CX18_WMB_CLIENT10); /* ME */
359 cx18_write_reg(cx, val: 0x00000101, CX18_WMB_CLIENT12); /* ENC */
360 cx18_write_reg(cx, val: 0x00000101, CX18_WMB_CLIENT13); /* PK */
361 cx18_write_reg(cx, val: 0x00000101, CX18_WMB_CLIENT11); /* RC */
362 cx18_write_reg(cx, val: 0x00000101, CX18_WMB_CLIENT14); /* AVO */
363}
364
365#define CX18_CPU_FIRMWARE "v4l-cx23418-cpu.fw"
366#define CX18_APU_FIRMWARE "v4l-cx23418-apu.fw"
367
368int cx18_firmware_init(struct cx18 *cx)
369{
370 u32 fw_entry_addr;
371 int sz, retries;
372 u32 api_args[MAX_MB_ARGUMENTS];
373
374 /* Allow chip to control CLKRUN */
375 cx18_write_reg(cx, val: 0x5, CX18_DSP0_INTERRUPT_MASK);
376
377 /* Stop the firmware */
378 cx18_write_reg_expect(cx, val: 0x000F000F, CX18_PROC_SOFT_RESET,
379 eval: 0x0000000F, mask: 0x000F000F);
380
381 cx18_msleep_timeout(msecs: 1, intr: 0);
382
383 /* If the CPU is still running */
384 if ((cx18_read_reg(cx, CX18_PROC_SOFT_RESET) & 8) == 0) {
385 CX18_ERR("%s: couldn't stop CPU to load firmware\n", __func__);
386 return -EIO;
387 }
388
389 cx18_sw1_irq_enable(cx, IRQ_CPU_TO_EPU | IRQ_APU_TO_EPU);
390 cx18_sw2_irq_enable(cx, IRQ_CPU_TO_EPU_ACK | IRQ_APU_TO_EPU_ACK);
391
392 sz = load_cpu_fw_direct(CX18_CPU_FIRMWARE, mem: cx->enc_mem, cx);
393 if (sz <= 0)
394 return sz;
395
396 /* The SCB & IPC area *must* be correct before starting the firmwares */
397 cx18_init_scb(cx);
398
399 fw_entry_addr = 0;
400 sz = load_apu_fw_direct(CX18_APU_FIRMWARE, dst: cx->enc_mem, cx,
401 entry_addr: &fw_entry_addr);
402 if (sz <= 0)
403 return sz;
404
405 /* Start the CPU. The CPU will take care of the APU for us. */
406 cx18_write_reg_expect(cx, val: 0x00080000, CX18_PROC_SOFT_RESET,
407 eval: 0x00000000, mask: 0x00080008);
408
409 /* Wait up to 500 ms for the APU to come out of reset */
410 for (retries = 0;
411 retries < 50 && (cx18_read_reg(cx, CX18_PROC_SOFT_RESET) & 1) == 1;
412 retries++)
413 cx18_msleep_timeout(msecs: 10, intr: 0);
414
415 cx18_msleep_timeout(msecs: 200, intr: 0);
416
417 if (retries == 50 &&
418 (cx18_read_reg(cx, CX18_PROC_SOFT_RESET) & 1) == 1) {
419 CX18_ERR("Could not start the CPU\n");
420 return -EIO;
421 }
422
423 /*
424 * The CPU had once before set up to receive an interrupt for it's
425 * outgoing IRQ_CPU_TO_EPU_ACK to us. If it ever does this, we get an
426 * interrupt when it sends us an ack, but by the time we process it,
427 * that flag in the SW2 status register has been cleared by the CPU
428 * firmware. We'll prevent that not so useful condition from happening
429 * by clearing the CPU's interrupt enables for Ack IRQ's we want to
430 * process.
431 */
432 cx18_sw2_irq_disable_cpu(cx, IRQ_CPU_TO_EPU_ACK | IRQ_APU_TO_EPU_ACK);
433
434 /* Try a benign command to see if the CPU is alive and well */
435 sz = cx18_vapi_result(cx, data: api_args, CX18_CPU_DEBUG_PEEK32, args: 1, 0);
436 if (sz < 0)
437 return sz;
438
439 /* initialize GPIO */
440 cx18_write_reg_expect(cx, val: 0x14001400, reg: 0xc78110, eval: 0x00001400, mask: 0x14001400);
441 return 0;
442}
443
444MODULE_FIRMWARE(CX18_CPU_FIRMWARE);
445MODULE_FIRMWARE(CX18_APU_FIRMWARE);
446

source code of linux/drivers/media/pci/cx18/cx18-firmware.c