1 /* 2 * ths8200 - Texas Instruments THS8200 video encoder driver 3 * 4 * Copyright 2013 Cisco Systems, Inc. and/or its affiliates. 5 * 6 * This program is free software; you may redistribute it and/or modify 7 * it under the terms of the GNU General Public License as published by 8 * the Free Software Foundation; version 2 of the License. 9 * 10 * This program is free software; you can redistribute it and/or 11 * modify it under the terms of the GNU General Public License as 12 * published by the Free Software Foundation version 2. 13 * 14 * This program is distributed .as is. WITHOUT ANY WARRANTY of any 15 * kind, whether express or implied; without even the implied warranty 16 * of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 17 * GNU General Public License for more details. 18 */ 19 20 #include <linux/i2c.h> 21 #include <linux/module.h> 22 #include <linux/v4l2-dv-timings.h> 23 24 #include <media/v4l2-dv-timings.h> 25 #include <media/v4l2-async.h> 26 #include <media/v4l2-device.h> 27 28 #include "ths8200_regs.h" 29 30 static int debug; 31 module_param(debug, int, 0644); 32 MODULE_PARM_DESC(debug, "debug level (0-2)"); 33 34 MODULE_DESCRIPTION("Texas Instruments THS8200 video encoder driver"); 35 MODULE_AUTHOR("Mats Randgaard <mats.randgaard@cisco.com>"); 36 MODULE_AUTHOR("Martin Bugge <martin.bugge@cisco.com>"); 37 MODULE_LICENSE("GPL v2"); 38 39 struct ths8200_state { 40 struct v4l2_subdev sd; 41 uint8_t chip_version; 42 /* Is the ths8200 powered on? */ 43 bool power_on; 44 struct v4l2_dv_timings dv_timings; 45 }; 46 47 static const struct v4l2_dv_timings_cap ths8200_timings_cap = { 48 .type = V4L2_DV_BT_656_1120, 49 .bt = { 50 .max_width = 1920, 51 .max_height = 1080, 52 .min_pixelclock = 27000000, 53 .max_pixelclock = 148500000, 54 .standards = V4L2_DV_BT_STD_CEA861, 55 .capabilities = V4L2_DV_BT_CAP_PROGRESSIVE, 56 }, 57 }; 58 59 static inline struct ths8200_state *to_state(struct v4l2_subdev *sd) 60 { 61 return container_of(sd, struct ths8200_state, sd); 62 } 63 64 static inline unsigned hblanking(const struct v4l2_bt_timings *t) 65 { 66 return V4L2_DV_BT_BLANKING_WIDTH(t); 67 } 68 69 static inline unsigned htotal(const struct v4l2_bt_timings *t) 70 { 71 return V4L2_DV_BT_FRAME_WIDTH(t); 72 } 73 74 static inline unsigned vblanking(const struct v4l2_bt_timings *t) 75 { 76 return V4L2_DV_BT_BLANKING_HEIGHT(t); 77 } 78 79 static inline unsigned vtotal(const struct v4l2_bt_timings *t) 80 { 81 return V4L2_DV_BT_FRAME_HEIGHT(t); 82 } 83 84 static int ths8200_read(struct v4l2_subdev *sd, u8 reg) 85 { 86 struct i2c_client *client = v4l2_get_subdevdata(sd); 87 88 return i2c_smbus_read_byte_data(client, reg); 89 } 90 91 static int ths8200_write(struct v4l2_subdev *sd, u8 reg, u8 val) 92 { 93 struct i2c_client *client = v4l2_get_subdevdata(sd); 94 int ret; 95 int i; 96 97 for (i = 0; i < 3; i++) { 98 ret = i2c_smbus_write_byte_data(client, reg, val); 99 if (ret == 0) 100 return 0; 101 } 102 v4l2_err(sd, "I2C Write Problem\n"); 103 return ret; 104 } 105 106 /* To set specific bits in the register, a clear-mask is given (to be AND-ed), 107 * and then the value-mask (to be OR-ed). 108 */ 109 static inline void 110 ths8200_write_and_or(struct v4l2_subdev *sd, u8 reg, 111 uint8_t clr_mask, uint8_t val_mask) 112 { 113 ths8200_write(sd, reg, (ths8200_read(sd, reg) & clr_mask) | val_mask); 114 } 115 116 #ifdef CONFIG_VIDEO_ADV_DEBUG 117 118 static int ths8200_g_register(struct v4l2_subdev *sd, 119 struct v4l2_dbg_register *reg) 120 { 121 reg->val = ths8200_read(sd, reg->reg & 0xff); 122 reg->size = 1; 123 124 return 0; 125 } 126 127 static int ths8200_s_register(struct v4l2_subdev *sd, 128 const struct v4l2_dbg_register *reg) 129 { 130 ths8200_write(sd, reg->reg & 0xff, reg->val & 0xff); 131 132 return 0; 133 } 134 #endif 135 136 static void ths8200_print_timings(struct v4l2_subdev *sd, 137 struct v4l2_dv_timings *timings, 138 const char *txt, bool detailed) 139 { 140 struct v4l2_bt_timings *bt = &timings->bt; 141 u32 htot, vtot; 142 143 if (timings->type != V4L2_DV_BT_656_1120) 144 return; 145 146 htot = htotal(bt); 147 vtot = vtotal(bt); 148 149 v4l2_info(sd, "%s %dx%d%s%d (%dx%d)", 150 txt, bt->width, bt->height, bt->interlaced ? "i" : "p", 151 (htot * vtot) > 0 ? ((u32)bt->pixelclock / (htot * vtot)) : 0, 152 htot, vtot); 153 154 if (detailed) { 155 v4l2_info(sd, " horizontal: fp = %d, %ssync = %d, bp = %d\n", 156 bt->hfrontporch, 157 (bt->polarities & V4L2_DV_HSYNC_POS_POL) ? "+" : "-", 158 bt->hsync, bt->hbackporch); 159 v4l2_info(sd, " vertical: fp = %d, %ssync = %d, bp = %d\n", 160 bt->vfrontporch, 161 (bt->polarities & V4L2_DV_VSYNC_POS_POL) ? "+" : "-", 162 bt->vsync, bt->vbackporch); 163 v4l2_info(sd, 164 " pixelclock: %lld, flags: 0x%x, standards: 0x%x\n", 165 bt->pixelclock, bt->flags, bt->standards); 166 } 167 } 168 169 static int ths8200_log_status(struct v4l2_subdev *sd) 170 { 171 struct ths8200_state *state = to_state(sd); 172 uint8_t reg_03 = ths8200_read(sd, THS8200_CHIP_CTL); 173 174 v4l2_info(sd, "----- Chip status -----\n"); 175 v4l2_info(sd, "version: %u\n", state->chip_version); 176 v4l2_info(sd, "power: %s\n", (reg_03 & 0x0c) ? "off" : "on"); 177 v4l2_info(sd, "reset: %s\n", (reg_03 & 0x01) ? "off" : "on"); 178 v4l2_info(sd, "test pattern: %s\n", 179 (reg_03 & 0x20) ? "enabled" : "disabled"); 180 v4l2_info(sd, "format: %ux%u\n", 181 ths8200_read(sd, THS8200_DTG2_PIXEL_CNT_MSB) * 256 + 182 ths8200_read(sd, THS8200_DTG2_PIXEL_CNT_LSB), 183 (ths8200_read(sd, THS8200_DTG2_LINE_CNT_MSB) & 0x07) * 256 + 184 ths8200_read(sd, THS8200_DTG2_LINE_CNT_LSB)); 185 ths8200_print_timings(sd, &state->dv_timings, 186 "Configured format:", true); 187 188 return 0; 189 } 190 191 /* Power up/down ths8200 */ 192 static int ths8200_s_power(struct v4l2_subdev *sd, int on) 193 { 194 struct ths8200_state *state = to_state(sd); 195 196 v4l2_dbg(1, debug, sd, "%s: power %s\n", __func__, on ? "on" : "off"); 197 198 state->power_on = on; 199 200 /* Power up/down - leave in reset state until input video is present */ 201 ths8200_write_and_or(sd, THS8200_CHIP_CTL, 0xf2, (on ? 0x00 : 0x0c)); 202 203 return 0; 204 } 205 206 static const struct v4l2_subdev_core_ops ths8200_core_ops = { 207 .log_status = ths8200_log_status, 208 .s_power = ths8200_s_power, 209 #ifdef CONFIG_VIDEO_ADV_DEBUG 210 .g_register = ths8200_g_register, 211 .s_register = ths8200_s_register, 212 #endif 213 }; 214 215 /* ----------------------------------------------------------------------------- 216 * V4L2 subdev video operations 217 */ 218 219 static int ths8200_s_stream(struct v4l2_subdev *sd, int enable) 220 { 221 struct ths8200_state *state = to_state(sd); 222 223 if (enable && !state->power_on) 224 ths8200_s_power(sd, true); 225 226 ths8200_write_and_or(sd, THS8200_CHIP_CTL, 0xfe, 227 (enable ? 0x01 : 0x00)); 228 229 v4l2_dbg(1, debug, sd, "%s: %sable\n", 230 __func__, (enable ? "en" : "dis")); 231 232 return 0; 233 } 234 235 static void ths8200_core_init(struct v4l2_subdev *sd) 236 { 237 /* setup clocks */ 238 ths8200_write_and_or(sd, THS8200_CHIP_CTL, 0x3f, 0xc0); 239 240 /**** Data path control (DATA) ****/ 241 /* Set FSADJ 700 mV, 242 * bypass 422-444 interpolation, 243 * input format 30 bit RGB444 244 */ 245 ths8200_write(sd, THS8200_DATA_CNTL, 0x70); 246 247 /* DTG Mode (Video blocked during blanking 248 * VESA slave 249 */ 250 ths8200_write(sd, THS8200_DTG1_MODE, 0x87); 251 252 /**** Display Timing Generator Control, Part 1 (DTG1). ****/ 253 254 /* Disable embedded syncs on the output by setting 255 * the amplitude to zero for all channels. 256 */ 257 ths8200_write(sd, THS8200_DTG1_Y_SYNC_MSB, 0x2a); 258 ths8200_write(sd, THS8200_DTG1_CBCR_SYNC_MSB, 0x2a); 259 } 260 261 static void ths8200_setup(struct v4l2_subdev *sd, struct v4l2_bt_timings *bt) 262 { 263 uint8_t polarity = 0; 264 uint16_t line_start_active_video = (bt->vsync + bt->vbackporch); 265 uint16_t line_start_front_porch = (vtotal(bt) - bt->vfrontporch); 266 267 /*** System ****/ 268 /* Set chip in reset while it is configured */ 269 ths8200_s_stream(sd, false); 270 271 /* configure video output timings */ 272 ths8200_write(sd, THS8200_DTG1_SPEC_A, bt->hsync); 273 ths8200_write(sd, THS8200_DTG1_SPEC_B, bt->hfrontporch); 274 275 /* Zero for progressive scan formats.*/ 276 if (!bt->interlaced) 277 ths8200_write(sd, THS8200_DTG1_SPEC_C, 0x00); 278 279 /* Distance from leading edge of h sync to start of active video. 280 * MSB in 0x2b 281 */ 282 ths8200_write(sd, THS8200_DTG1_SPEC_D_LSB, 283 (bt->hbackporch + bt->hsync) & 0xff); 284 /* Zero for SDTV-mode. MSB in 0x2b */ 285 ths8200_write(sd, THS8200_DTG1_SPEC_E_LSB, 0x00); 286 /* 287 * MSB for dtg1_spec(d/e/h). See comment for 288 * corresponding LSB registers. 289 */ 290 ths8200_write(sd, THS8200_DTG1_SPEC_DEH_MSB, 291 ((bt->hbackporch + bt->hsync) & 0x100) >> 1); 292 293 /* h front porch */ 294 ths8200_write(sd, THS8200_DTG1_SPEC_K_LSB, (bt->hfrontporch) & 0xff); 295 ths8200_write(sd, THS8200_DTG1_SPEC_K_MSB, 296 ((bt->hfrontporch) & 0x700) >> 8); 297 298 /* Half the line length. Used to calculate SDTV line types. */ 299 ths8200_write(sd, THS8200_DTG1_SPEC_G_LSB, (htotal(bt)/2) & 0xff); 300 ths8200_write(sd, THS8200_DTG1_SPEC_G_MSB, 301 ((htotal(bt)/2) >> 8) & 0x0f); 302 303 /* Total pixels per line (ex. 720p: 1650) */ 304 ths8200_write(sd, THS8200_DTG1_TOT_PIXELS_MSB, htotal(bt) >> 8); 305 ths8200_write(sd, THS8200_DTG1_TOT_PIXELS_LSB, htotal(bt) & 0xff); 306 307 /* Frame height and field height */ 308 /* Field height should be programmed higher than frame_size for 309 * progressive scan formats 310 */ 311 ths8200_write(sd, THS8200_DTG1_FRAME_FIELD_SZ_MSB, 312 ((vtotal(bt) >> 4) & 0xf0) + 0x7); 313 ths8200_write(sd, THS8200_DTG1_FRAME_SZ_LSB, vtotal(bt) & 0xff); 314 315 /* Should be programmed higher than frame_size 316 * for progressive formats 317 */ 318 if (!bt->interlaced) 319 ths8200_write(sd, THS8200_DTG1_FIELD_SZ_LSB, 0xff); 320 321 /**** Display Timing Generator Control, Part 2 (DTG2). ****/ 322 /* Set breakpoint line numbers and types 323 * THS8200 generates line types with different properties. A line type 324 * that sets all the RGB-outputs to zero is used in the blanking areas, 325 * while a line type that enable the RGB-outputs is used in active video 326 * area. The line numbers for start of active video, start of front 327 * porch and after the last line in the frame must be set with the 328 * corresponding line types. 329 * 330 * Line types: 331 * 0x9 - Full normal sync pulse: Blocks data when dtg1_pass is off. 332 * Used in blanking area. 333 * 0x0 - Active video: Video data is always passed. Used in active 334 * video area. 335 */ 336 ths8200_write_and_or(sd, THS8200_DTG2_BP1_2_MSB, 0x88, 337 ((line_start_active_video >> 4) & 0x70) + 338 ((line_start_front_porch >> 8) & 0x07)); 339 ths8200_write(sd, THS8200_DTG2_BP3_4_MSB, ((vtotal(bt)) >> 4) & 0x70); 340 ths8200_write(sd, THS8200_DTG2_BP1_LSB, line_start_active_video & 0xff); 341 ths8200_write(sd, THS8200_DTG2_BP2_LSB, line_start_front_porch & 0xff); 342 ths8200_write(sd, THS8200_DTG2_BP3_LSB, (vtotal(bt)) & 0xff); 343 344 /* line types */ 345 ths8200_write(sd, THS8200_DTG2_LINETYPE1, 0x90); 346 ths8200_write(sd, THS8200_DTG2_LINETYPE2, 0x90); 347 348 /* h sync width transmitted */ 349 ths8200_write(sd, THS8200_DTG2_HLENGTH_LSB, bt->hsync & 0xff); 350 ths8200_write_and_or(sd, THS8200_DTG2_HLENGTH_LSB_HDLY_MSB, 0x3f, 351 (bt->hsync >> 2) & 0xc0); 352 353 /* The pixel value h sync is asserted on */ 354 ths8200_write_and_or(sd, THS8200_DTG2_HLENGTH_LSB_HDLY_MSB, 0xe0, 355 (htotal(bt) >> 8) & 0x1f); 356 ths8200_write(sd, THS8200_DTG2_HLENGTH_HDLY_LSB, htotal(bt)); 357 358 /* v sync width transmitted */ 359 ths8200_write(sd, THS8200_DTG2_VLENGTH1_LSB, (bt->vsync) & 0xff); 360 ths8200_write_and_or(sd, THS8200_DTG2_VLENGTH1_MSB_VDLY1_MSB, 0x3f, 361 ((bt->vsync) >> 2) & 0xc0); 362 363 /* The pixel value v sync is asserted on */ 364 ths8200_write_and_or(sd, THS8200_DTG2_VLENGTH1_MSB_VDLY1_MSB, 0xf8, 365 (vtotal(bt)>>8) & 0x7); 366 ths8200_write(sd, THS8200_DTG2_VDLY1_LSB, vtotal(bt)); 367 368 /* For progressive video vlength2 must be set to all 0 and vdly2 must 369 * be set to all 1. 370 */ 371 ths8200_write(sd, THS8200_DTG2_VLENGTH2_LSB, 0x00); 372 ths8200_write(sd, THS8200_DTG2_VLENGTH2_MSB_VDLY2_MSB, 0x07); 373 ths8200_write(sd, THS8200_DTG2_VDLY2_LSB, 0xff); 374 375 /* Internal delay factors to synchronize the sync pulses and the data */ 376 /* Experimental values delays (hor 4, ver 1) */ 377 ths8200_write(sd, THS8200_DTG2_HS_IN_DLY_MSB, (htotal(bt)>>8) & 0x1f); 378 ths8200_write(sd, THS8200_DTG2_HS_IN_DLY_LSB, (htotal(bt) - 4) & 0xff); 379 ths8200_write(sd, THS8200_DTG2_VS_IN_DLY_MSB, 0); 380 ths8200_write(sd, THS8200_DTG2_VS_IN_DLY_LSB, 1); 381 382 /* Polarity of received and transmitted sync signals */ 383 if (bt->polarities & V4L2_DV_HSYNC_POS_POL) { 384 polarity |= 0x01; /* HS_IN */ 385 polarity |= 0x08; /* HS_OUT */ 386 } 387 if (bt->polarities & V4L2_DV_VSYNC_POS_POL) { 388 polarity |= 0x02; /* VS_IN */ 389 polarity |= 0x10; /* VS_OUT */ 390 } 391 392 /* RGB mode, no embedded timings */ 393 /* Timing of video input bus is derived from HS, VS, and FID dedicated 394 * inputs 395 */ 396 ths8200_write(sd, THS8200_DTG2_CNTL, 0x47 | polarity); 397 398 /* leave reset */ 399 ths8200_s_stream(sd, true); 400 401 v4l2_dbg(1, debug, sd, "%s: frame %dx%d, polarity %d\n" 402 "horizontal: front porch %d, back porch %d, sync %d\n" 403 "vertical: sync %d\n", __func__, htotal(bt), vtotal(bt), 404 polarity, bt->hfrontporch, bt->hbackporch, 405 bt->hsync, bt->vsync); 406 } 407 408 static int ths8200_s_dv_timings(struct v4l2_subdev *sd, 409 struct v4l2_dv_timings *timings) 410 { 411 struct ths8200_state *state = to_state(sd); 412 413 v4l2_dbg(1, debug, sd, "%s:\n", __func__); 414 415 if (!v4l2_dv_valid_timings(timings, &ths8200_timings_cap)) 416 return -EINVAL; 417 418 if (!v4l2_find_dv_timings_cap(timings, &ths8200_timings_cap, 10)) { 419 v4l2_dbg(1, debug, sd, "Unsupported format\n"); 420 return -EINVAL; 421 } 422 423 timings->bt.flags &= ~V4L2_DV_FL_REDUCED_FPS; 424 425 /* save timings */ 426 state->dv_timings = *timings; 427 428 ths8200_setup(sd, &timings->bt); 429 430 return 0; 431 } 432 433 static int ths8200_g_dv_timings(struct v4l2_subdev *sd, 434 struct v4l2_dv_timings *timings) 435 { 436 struct ths8200_state *state = to_state(sd); 437 438 v4l2_dbg(1, debug, sd, "%s:\n", __func__); 439 440 *timings = state->dv_timings; 441 442 return 0; 443 } 444 445 static int ths8200_enum_dv_timings(struct v4l2_subdev *sd, 446 struct v4l2_enum_dv_timings *timings) 447 { 448 return v4l2_enum_dv_timings_cap(timings, &ths8200_timings_cap); 449 } 450 451 static int ths8200_dv_timings_cap(struct v4l2_subdev *sd, 452 struct v4l2_dv_timings_cap *cap) 453 { 454 *cap = ths8200_timings_cap; 455 return 0; 456 } 457 458 /* Specific video subsystem operation handlers */ 459 static const struct v4l2_subdev_video_ops ths8200_video_ops = { 460 .s_stream = ths8200_s_stream, 461 .s_dv_timings = ths8200_s_dv_timings, 462 .g_dv_timings = ths8200_g_dv_timings, 463 .enum_dv_timings = ths8200_enum_dv_timings, 464 .dv_timings_cap = ths8200_dv_timings_cap, 465 }; 466 467 /* V4L2 top level operation handlers */ 468 static const struct v4l2_subdev_ops ths8200_ops = { 469 .core = &ths8200_core_ops, 470 .video = &ths8200_video_ops, 471 }; 472 473 static int ths8200_probe(struct i2c_client *client, 474 const struct i2c_device_id *id) 475 { 476 struct ths8200_state *state; 477 struct v4l2_subdev *sd; 478 int error; 479 480 /* Check if the adapter supports the needed features */ 481 if (!i2c_check_functionality(client->adapter, I2C_FUNC_SMBUS_BYTE_DATA)) 482 return -EIO; 483 484 state = devm_kzalloc(&client->dev, sizeof(*state), GFP_KERNEL); 485 if (!state) 486 return -ENOMEM; 487 488 sd = &state->sd; 489 v4l2_i2c_subdev_init(sd, client, &ths8200_ops); 490 491 state->chip_version = ths8200_read(sd, THS8200_VERSION); 492 v4l2_dbg(1, debug, sd, "chip version 0x%x\n", state->chip_version); 493 494 ths8200_core_init(sd); 495 496 error = v4l2_async_register_subdev(&state->sd); 497 if (error) 498 return error; 499 500 v4l2_info(sd, "%s found @ 0x%x (%s)\n", client->name, 501 client->addr << 1, client->adapter->name); 502 503 return 0; 504 } 505 506 static int ths8200_remove(struct i2c_client *client) 507 { 508 struct v4l2_subdev *sd = i2c_get_clientdata(client); 509 struct ths8200_state *decoder = to_state(sd); 510 511 v4l2_dbg(1, debug, sd, "%s removed @ 0x%x (%s)\n", client->name, 512 client->addr << 1, client->adapter->name); 513 514 ths8200_s_power(sd, false); 515 v4l2_async_unregister_subdev(&decoder->sd); 516 v4l2_device_unregister_subdev(sd); 517 518 return 0; 519 } 520 521 static struct i2c_device_id ths8200_id[] = { 522 { "ths8200", 0 }, 523 {}, 524 }; 525 MODULE_DEVICE_TABLE(i2c, ths8200_id); 526 527 #if IS_ENABLED(CONFIG_OF) 528 static const struct of_device_id ths8200_of_match[] = { 529 { .compatible = "ti,ths8200", }, 530 { /* sentinel */ }, 531 }; 532 MODULE_DEVICE_TABLE(of, ths8200_of_match); 533 #endif 534 535 static struct i2c_driver ths8200_driver = { 536 .driver = { 537 .owner = THIS_MODULE, 538 .name = "ths8200", 539 .of_match_table = of_match_ptr(ths8200_of_match), 540 }, 541 .probe = ths8200_probe, 542 .remove = ths8200_remove, 543 .id_table = ths8200_id, 544 }; 545 546 module_i2c_driver(ths8200_driver); 547