xref: /linux/drivers/media/usb/pvrusb2/pvrusb2-std.c (revision 27988c96687667e74df1a9a3b8662519bc1c29c9)
1 // SPDX-License-Identifier: GPL-2.0-only
2 /*
3  *
4  *  Copyright (C) 2005 Mike Isely <isely@pobox.com>
5  */
6 
7 #include "pvrusb2-std.h"
8 #include "pvrusb2-debug.h"
9 #include <asm/string.h>
10 #include <linux/slab.h>
11 
12 struct std_name {
13 	const char *name;
14 	v4l2_std_id id;
15 };
16 
17 
18 #define CSTD_PAL \
19 	(V4L2_STD_PAL_B| \
20 	 V4L2_STD_PAL_B1| \
21 	 V4L2_STD_PAL_G| \
22 	 V4L2_STD_PAL_H| \
23 	 V4L2_STD_PAL_I| \
24 	 V4L2_STD_PAL_D| \
25 	 V4L2_STD_PAL_D1| \
26 	 V4L2_STD_PAL_K| \
27 	 V4L2_STD_PAL_M| \
28 	 V4L2_STD_PAL_N| \
29 	 V4L2_STD_PAL_Nc| \
30 	 V4L2_STD_PAL_60)
31 
32 #define CSTD_NTSC \
33 	(V4L2_STD_NTSC_M| \
34 	 V4L2_STD_NTSC_M_JP| \
35 	 V4L2_STD_NTSC_M_KR| \
36 	 V4L2_STD_NTSC_443)
37 
38 #define CSTD_ATSC \
39 	(V4L2_STD_ATSC_8_VSB| \
40 	 V4L2_STD_ATSC_16_VSB)
41 
42 #define CSTD_SECAM \
43 	(V4L2_STD_SECAM_B| \
44 	 V4L2_STD_SECAM_D| \
45 	 V4L2_STD_SECAM_G| \
46 	 V4L2_STD_SECAM_H| \
47 	 V4L2_STD_SECAM_K| \
48 	 V4L2_STD_SECAM_K1| \
49 	 V4L2_STD_SECAM_L| \
50 	 V4L2_STD_SECAM_LC)
51 
52 #define TSTD_B   (V4L2_STD_PAL_B|V4L2_STD_SECAM_B)
53 #define TSTD_B1  (V4L2_STD_PAL_B1)
54 #define TSTD_D   (V4L2_STD_PAL_D|V4L2_STD_SECAM_D)
55 #define TSTD_D1  (V4L2_STD_PAL_D1)
56 #define TSTD_G   (V4L2_STD_PAL_G|V4L2_STD_SECAM_G)
57 #define TSTD_H   (V4L2_STD_PAL_H|V4L2_STD_SECAM_H)
58 #define TSTD_I   (V4L2_STD_PAL_I)
59 #define TSTD_K   (V4L2_STD_PAL_K|V4L2_STD_SECAM_K)
60 #define TSTD_K1  (V4L2_STD_SECAM_K1)
61 #define TSTD_L   (V4L2_STD_SECAM_L)
62 #define TSTD_M   (V4L2_STD_PAL_M|V4L2_STD_NTSC_M)
63 #define TSTD_N   (V4L2_STD_PAL_N)
64 #define TSTD_Nc  (V4L2_STD_PAL_Nc)
65 #define TSTD_60  (V4L2_STD_PAL_60)
66 
67 #define CSTD_ALL (CSTD_PAL|CSTD_NTSC|CSTD_ATSC|CSTD_SECAM)
68 
69 /* Mapping of standard bits to color system */
70 static const struct std_name std_groups[] = {
71 	{"PAL",CSTD_PAL},
72 	{"NTSC",CSTD_NTSC},
73 	{"SECAM",CSTD_SECAM},
74 	{"ATSC",CSTD_ATSC},
75 };
76 
77 /* Mapping of standard bits to modulation system */
78 static const struct std_name std_items[] = {
79 	{"B",TSTD_B},
80 	{"B1",TSTD_B1},
81 	{"D",TSTD_D},
82 	{"D1",TSTD_D1},
83 	{"G",TSTD_G},
84 	{"H",TSTD_H},
85 	{"I",TSTD_I},
86 	{"K",TSTD_K},
87 	{"K1",TSTD_K1},
88 	{"L",TSTD_L},
89 	{"LC",V4L2_STD_SECAM_LC},
90 	{"M",TSTD_M},
91 	{"Mj",V4L2_STD_NTSC_M_JP},
92 	{"443",V4L2_STD_NTSC_443},
93 	{"Mk",V4L2_STD_NTSC_M_KR},
94 	{"N",TSTD_N},
95 	{"Nc",TSTD_Nc},
96 	{"60",TSTD_60},
97 	{"8VSB",V4L2_STD_ATSC_8_VSB},
98 	{"16VSB",V4L2_STD_ATSC_16_VSB},
99 };
100 
101 
102 // Search an array of std_name structures and return a pointer to the
103 // element with the matching name.
104 static const struct std_name *find_std_name(const struct std_name *arrPtr,
105 					    unsigned int arrSize,
106 					    const char *bufPtr,
107 					    unsigned int bufSize)
108 {
109 	unsigned int idx;
110 	const struct std_name *p;
111 	for (idx = 0; idx < arrSize; idx++) {
112 		p = arrPtr + idx;
113 		if (strlen(p->name) != bufSize) continue;
114 		if (!memcmp(bufPtr,p->name,bufSize)) return p;
115 	}
116 	return NULL;
117 }
118 
119 
120 int pvr2_std_str_to_id(v4l2_std_id *idPtr,const char *bufPtr,
121 		       unsigned int bufSize)
122 {
123 	v4l2_std_id id = 0;
124 	v4l2_std_id cmsk = 0;
125 	v4l2_std_id t;
126 	int mMode = 0;
127 	unsigned int cnt;
128 	char ch;
129 	const struct std_name *sp;
130 
131 	while (bufSize) {
132 		if (!mMode) {
133 			cnt = 0;
134 			while ((cnt < bufSize) && (bufPtr[cnt] != '-')) cnt++;
135 			if (cnt >= bufSize) return 0; // No more characters
136 			sp = find_std_name(std_groups, ARRAY_SIZE(std_groups),
137 					   bufPtr,cnt);
138 			if (!sp) return 0; // Illegal color system name
139 			cnt++;
140 			bufPtr += cnt;
141 			bufSize -= cnt;
142 			mMode = !0;
143 			cmsk = sp->id;
144 			continue;
145 		}
146 		cnt = 0;
147 		while (cnt < bufSize) {
148 			ch = bufPtr[cnt];
149 			if (ch == ';') {
150 				mMode = 0;
151 				break;
152 			}
153 			if (ch == '/') break;
154 			cnt++;
155 		}
156 		sp = find_std_name(std_items, ARRAY_SIZE(std_items),
157 				   bufPtr,cnt);
158 		if (!sp) return 0; // Illegal modulation system ID
159 		t = sp->id & cmsk;
160 		if (!t) return 0; // Specific color + modulation system illegal
161 		id |= t;
162 		if (cnt < bufSize) cnt++;
163 		bufPtr += cnt;
164 		bufSize -= cnt;
165 	}
166 
167 	if (idPtr) *idPtr = id;
168 	return !0;
169 }
170 
171 
172 unsigned int pvr2_std_id_to_str(char *bufPtr, unsigned int bufSize,
173 				v4l2_std_id id)
174 {
175 	unsigned int idx1,idx2;
176 	const struct std_name *ip,*gp;
177 	int gfl,cfl;
178 	unsigned int c1,c2;
179 	cfl = 0;
180 	c1 = 0;
181 	for (idx1 = 0; idx1 < ARRAY_SIZE(std_groups); idx1++) {
182 		gp = std_groups + idx1;
183 		gfl = 0;
184 		for (idx2 = 0; idx2 < ARRAY_SIZE(std_items); idx2++) {
185 			ip = std_items + idx2;
186 			if (!(gp->id & ip->id & id)) continue;
187 			if (!gfl) {
188 				if (cfl) {
189 					c2 = scnprintf(bufPtr,bufSize,";");
190 					c1 += c2;
191 					bufSize -= c2;
192 					bufPtr += c2;
193 				}
194 				cfl = !0;
195 				c2 = scnprintf(bufPtr,bufSize,
196 					       "%s-",gp->name);
197 				gfl = !0;
198 			} else {
199 				c2 = scnprintf(bufPtr,bufSize,"/");
200 			}
201 			c1 += c2;
202 			bufSize -= c2;
203 			bufPtr += c2;
204 			c2 = scnprintf(bufPtr,bufSize,
205 				       ip->name);
206 			c1 += c2;
207 			bufSize -= c2;
208 			bufPtr += c2;
209 		}
210 	}
211 	return c1;
212 }
213 
214 
215 // Template data for possible enumerated video standards.  Here we group
216 // standards which share common frame rates and resolution.
217 static struct v4l2_standard generic_standards[] = {
218 	{
219 		.id             = (TSTD_B|TSTD_B1|
220 				   TSTD_D|TSTD_D1|
221 				   TSTD_G|
222 				   TSTD_H|
223 				   TSTD_I|
224 				   TSTD_K|TSTD_K1|
225 				   TSTD_L|
226 				   V4L2_STD_SECAM_LC |
227 				   TSTD_N|TSTD_Nc),
228 		.frameperiod    =
229 		{
230 			.numerator  = 1,
231 			.denominator= 25
232 		},
233 		.framelines     = 625,
234 		.reserved       = {0,0,0,0}
235 	}, {
236 		.id             = (TSTD_M|
237 				   V4L2_STD_NTSC_M_JP|
238 				   V4L2_STD_NTSC_M_KR),
239 		.frameperiod    =
240 		{
241 			.numerator  = 1001,
242 			.denominator= 30000
243 		},
244 		.framelines     = 525,
245 		.reserved       = {0,0,0,0}
246 	}, { // This is a total wild guess
247 		.id             = (TSTD_60),
248 		.frameperiod    =
249 		{
250 			.numerator  = 1001,
251 			.denominator= 30000
252 		},
253 		.framelines     = 525,
254 		.reserved       = {0,0,0,0}
255 	}, { // This is total wild guess
256 		.id             = V4L2_STD_NTSC_443,
257 		.frameperiod    =
258 		{
259 			.numerator  = 1001,
260 			.denominator= 30000
261 		},
262 		.framelines     = 525,
263 		.reserved       = {0,0,0,0}
264 	}
265 };
266 
267 static struct v4l2_standard *match_std(v4l2_std_id id)
268 {
269 	unsigned int idx;
270 	for (idx = 0; idx < ARRAY_SIZE(generic_standards); idx++) {
271 		if (generic_standards[idx].id & id) {
272 			return generic_standards + idx;
273 		}
274 	}
275 	return NULL;
276 }
277 
278 static int pvr2_std_fill(struct v4l2_standard *std,v4l2_std_id id)
279 {
280 	struct v4l2_standard *template;
281 	int idx;
282 	unsigned int bcnt;
283 	template = match_std(id);
284 	if (!template) return 0;
285 	idx = std->index;
286 	memcpy(std,template,sizeof(*template));
287 	std->index = idx;
288 	std->id = id;
289 	bcnt = pvr2_std_id_to_str(std->name,sizeof(std->name)-1,id);
290 	std->name[bcnt] = 0;
291 	pvr2_trace(PVR2_TRACE_STD,"Set up standard idx=%u name=%s",
292 		   std->index,std->name);
293 	return !0;
294 }
295 
296 /* These are special cases of combined standards that we should enumerate
297    separately if the component pieces are present. */
298 static v4l2_std_id std_mixes[] = {
299 	V4L2_STD_PAL_B | V4L2_STD_PAL_G,
300 	V4L2_STD_PAL_D | V4L2_STD_PAL_K,
301 	V4L2_STD_SECAM_B | V4L2_STD_SECAM_G,
302 	V4L2_STD_SECAM_D | V4L2_STD_SECAM_K,
303 };
304 
305 struct v4l2_standard *pvr2_std_create_enum(unsigned int *countptr,
306 					   v4l2_std_id id)
307 {
308 	unsigned int std_cnt = 0;
309 	unsigned int idx,bcnt,idx2;
310 	v4l2_std_id idmsk,cmsk,fmsk;
311 	struct v4l2_standard *stddefs;
312 
313 	if (pvrusb2_debug & PVR2_TRACE_STD) {
314 		char buf[100];
315 		bcnt = pvr2_std_id_to_str(buf,sizeof(buf),id);
316 		pvr2_trace(
317 			PVR2_TRACE_STD,"Mapping standards mask=0x%x (%.*s)",
318 			(int)id,bcnt,buf);
319 	}
320 
321 	*countptr = 0;
322 	std_cnt = 0;
323 	fmsk = 0;
324 	for (idmsk = 1, cmsk = id; cmsk; idmsk <<= 1) {
325 		if (!(idmsk & cmsk)) continue;
326 		cmsk &= ~idmsk;
327 		if (match_std(idmsk)) {
328 			std_cnt++;
329 			continue;
330 		}
331 		fmsk |= idmsk;
332 	}
333 
334 	for (idx2 = 0; idx2 < ARRAY_SIZE(std_mixes); idx2++) {
335 		if ((id & std_mixes[idx2]) == std_mixes[idx2]) std_cnt++;
336 	}
337 
338 	/* Don't complain about ATSC standard values */
339 	fmsk &= ~CSTD_ATSC;
340 
341 	if (fmsk) {
342 		char buf[100];
343 		bcnt = pvr2_std_id_to_str(buf,sizeof(buf),fmsk);
344 		pvr2_trace(
345 			PVR2_TRACE_ERROR_LEGS,
346 			"***WARNING*** Failed to classify the following standard(s): %.*s",
347 			bcnt,buf);
348 	}
349 
350 	pvr2_trace(PVR2_TRACE_STD,"Setting up %u unique standard(s)",
351 		   std_cnt);
352 	if (!std_cnt) return NULL; // paranoia
353 
354 	stddefs = kcalloc(std_cnt, sizeof(struct v4l2_standard),
355 			  GFP_KERNEL);
356 	if (!stddefs)
357 		return NULL;
358 
359 	for (idx = 0; idx < std_cnt; idx++)
360 		stddefs[idx].index = idx;
361 
362 	idx = 0;
363 
364 	/* Enumerate potential special cases */
365 	for (idx2 = 0; (idx2 < ARRAY_SIZE(std_mixes)) && (idx < std_cnt);
366 	     idx2++) {
367 		if (!(id & std_mixes[idx2])) continue;
368 		if (pvr2_std_fill(stddefs+idx,std_mixes[idx2])) idx++;
369 	}
370 	/* Now enumerate individual pieces */
371 	for (idmsk = 1, cmsk = id; cmsk && (idx < std_cnt); idmsk <<= 1) {
372 		if (!(idmsk & cmsk)) continue;
373 		cmsk &= ~idmsk;
374 		if (!pvr2_std_fill(stddefs+idx,idmsk)) continue;
375 		idx++;
376 	}
377 
378 	*countptr = std_cnt;
379 	return stddefs;
380 }
381 
382 v4l2_std_id pvr2_std_get_usable(void)
383 {
384 	return CSTD_ALL;
385 }
386