simple-bridge.c 8.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314
  1. // SPDX-License-Identifier: GPL-2.0-or-later
  2. /*
  3. * Copyright (C) 2015-2016 Free Electrons
  4. * Copyright (C) 2015-2016 NextThing Co
  5. *
  6. * Maxime Ripard <[email protected]>
  7. */
  8. #include <linux/gpio/consumer.h>
  9. #include <linux/module.h>
  10. #include <linux/of_device.h>
  11. #include <linux/of_graph.h>
  12. #include <linux/regulator/consumer.h>
  13. #include <drm/drm_atomic_helper.h>
  14. #include <drm/drm_bridge.h>
  15. #include <drm/drm_crtc.h>
  16. #include <drm/drm_edid.h>
  17. #include <drm/drm_print.h>
  18. #include <drm/drm_probe_helper.h>
  19. struct simple_bridge_info {
  20. const struct drm_bridge_timings *timings;
  21. unsigned int connector_type;
  22. };
  23. struct simple_bridge {
  24. struct drm_bridge bridge;
  25. struct drm_connector connector;
  26. const struct simple_bridge_info *info;
  27. struct drm_bridge *next_bridge;
  28. struct regulator *vdd;
  29. struct gpio_desc *enable;
  30. };
  31. static inline struct simple_bridge *
  32. drm_bridge_to_simple_bridge(struct drm_bridge *bridge)
  33. {
  34. return container_of(bridge, struct simple_bridge, bridge);
  35. }
  36. static inline struct simple_bridge *
  37. drm_connector_to_simple_bridge(struct drm_connector *connector)
  38. {
  39. return container_of(connector, struct simple_bridge, connector);
  40. }
  41. static int simple_bridge_get_modes(struct drm_connector *connector)
  42. {
  43. struct simple_bridge *sbridge = drm_connector_to_simple_bridge(connector);
  44. struct edid *edid;
  45. int ret;
  46. if (sbridge->next_bridge->ops & DRM_BRIDGE_OP_EDID) {
  47. edid = drm_bridge_get_edid(sbridge->next_bridge, connector);
  48. if (!edid)
  49. DRM_INFO("EDID read failed. Fallback to standard modes\n");
  50. } else {
  51. edid = NULL;
  52. }
  53. if (!edid) {
  54. /*
  55. * In case we cannot retrieve the EDIDs (missing or broken DDC
  56. * bus from the next bridge), fallback on the XGA standards and
  57. * prefer a mode pretty much anyone can handle.
  58. */
  59. ret = drm_add_modes_noedid(connector, 1920, 1200);
  60. drm_set_preferred_mode(connector, 1024, 768);
  61. return ret;
  62. }
  63. drm_connector_update_edid_property(connector, edid);
  64. ret = drm_add_edid_modes(connector, edid);
  65. kfree(edid);
  66. return ret;
  67. }
  68. static const struct drm_connector_helper_funcs simple_bridge_con_helper_funcs = {
  69. .get_modes = simple_bridge_get_modes,
  70. };
  71. static enum drm_connector_status
  72. simple_bridge_connector_detect(struct drm_connector *connector, bool force)
  73. {
  74. struct simple_bridge *sbridge = drm_connector_to_simple_bridge(connector);
  75. return drm_bridge_detect(sbridge->next_bridge);
  76. }
  77. static const struct drm_connector_funcs simple_bridge_con_funcs = {
  78. .detect = simple_bridge_connector_detect,
  79. .fill_modes = drm_helper_probe_single_connector_modes,
  80. .destroy = drm_connector_cleanup,
  81. .reset = drm_atomic_helper_connector_reset,
  82. .atomic_duplicate_state = drm_atomic_helper_connector_duplicate_state,
  83. .atomic_destroy_state = drm_atomic_helper_connector_destroy_state,
  84. };
  85. static int simple_bridge_attach(struct drm_bridge *bridge,
  86. enum drm_bridge_attach_flags flags)
  87. {
  88. struct simple_bridge *sbridge = drm_bridge_to_simple_bridge(bridge);
  89. int ret;
  90. ret = drm_bridge_attach(bridge->encoder, sbridge->next_bridge, bridge,
  91. DRM_BRIDGE_ATTACH_NO_CONNECTOR);
  92. if (ret < 0)
  93. return ret;
  94. if (flags & DRM_BRIDGE_ATTACH_NO_CONNECTOR)
  95. return 0;
  96. if (!bridge->encoder) {
  97. DRM_ERROR("Missing encoder\n");
  98. return -ENODEV;
  99. }
  100. drm_connector_helper_add(&sbridge->connector,
  101. &simple_bridge_con_helper_funcs);
  102. ret = drm_connector_init_with_ddc(bridge->dev, &sbridge->connector,
  103. &simple_bridge_con_funcs,
  104. sbridge->info->connector_type,
  105. sbridge->next_bridge->ddc);
  106. if (ret) {
  107. DRM_ERROR("Failed to initialize connector\n");
  108. return ret;
  109. }
  110. drm_connector_attach_encoder(&sbridge->connector, bridge->encoder);
  111. return 0;
  112. }
  113. static void simple_bridge_enable(struct drm_bridge *bridge)
  114. {
  115. struct simple_bridge *sbridge = drm_bridge_to_simple_bridge(bridge);
  116. int ret;
  117. if (sbridge->vdd) {
  118. ret = regulator_enable(sbridge->vdd);
  119. if (ret)
  120. DRM_ERROR("Failed to enable vdd regulator: %d\n", ret);
  121. }
  122. gpiod_set_value_cansleep(sbridge->enable, 1);
  123. }
  124. static void simple_bridge_disable(struct drm_bridge *bridge)
  125. {
  126. struct simple_bridge *sbridge = drm_bridge_to_simple_bridge(bridge);
  127. gpiod_set_value_cansleep(sbridge->enable, 0);
  128. if (sbridge->vdd)
  129. regulator_disable(sbridge->vdd);
  130. }
  131. static const struct drm_bridge_funcs simple_bridge_bridge_funcs = {
  132. .attach = simple_bridge_attach,
  133. .enable = simple_bridge_enable,
  134. .disable = simple_bridge_disable,
  135. };
  136. static int simple_bridge_probe(struct platform_device *pdev)
  137. {
  138. struct simple_bridge *sbridge;
  139. struct device_node *remote;
  140. sbridge = devm_kzalloc(&pdev->dev, sizeof(*sbridge), GFP_KERNEL);
  141. if (!sbridge)
  142. return -ENOMEM;
  143. platform_set_drvdata(pdev, sbridge);
  144. sbridge->info = of_device_get_match_data(&pdev->dev);
  145. /* Get the next bridge in the pipeline. */
  146. remote = of_graph_get_remote_node(pdev->dev.of_node, 1, -1);
  147. if (!remote)
  148. return -EINVAL;
  149. sbridge->next_bridge = of_drm_find_bridge(remote);
  150. of_node_put(remote);
  151. if (!sbridge->next_bridge) {
  152. dev_dbg(&pdev->dev, "Next bridge not found, deferring probe\n");
  153. return -EPROBE_DEFER;
  154. }
  155. /* Get the regulator and GPIO resources. */
  156. sbridge->vdd = devm_regulator_get_optional(&pdev->dev, "vdd");
  157. if (IS_ERR(sbridge->vdd)) {
  158. int ret = PTR_ERR(sbridge->vdd);
  159. if (ret == -EPROBE_DEFER)
  160. return -EPROBE_DEFER;
  161. sbridge->vdd = NULL;
  162. dev_dbg(&pdev->dev, "No vdd regulator found: %d\n", ret);
  163. }
  164. sbridge->enable = devm_gpiod_get_optional(&pdev->dev, "enable",
  165. GPIOD_OUT_LOW);
  166. if (IS_ERR(sbridge->enable)) {
  167. if (PTR_ERR(sbridge->enable) != -EPROBE_DEFER)
  168. dev_err(&pdev->dev, "Unable to retrieve enable GPIO\n");
  169. return PTR_ERR(sbridge->enable);
  170. }
  171. /* Register the bridge. */
  172. sbridge->bridge.funcs = &simple_bridge_bridge_funcs;
  173. sbridge->bridge.of_node = pdev->dev.of_node;
  174. sbridge->bridge.timings = sbridge->info->timings;
  175. drm_bridge_add(&sbridge->bridge);
  176. return 0;
  177. }
  178. static int simple_bridge_remove(struct platform_device *pdev)
  179. {
  180. struct simple_bridge *sbridge = platform_get_drvdata(pdev);
  181. drm_bridge_remove(&sbridge->bridge);
  182. return 0;
  183. }
  184. /*
  185. * We assume the ADV7123 DAC is the "default" for historical reasons
  186. * Information taken from the ADV7123 datasheet, revision D.
  187. * NOTE: the ADV7123EP seems to have other timings and need a new timings
  188. * set if used.
  189. */
  190. static const struct drm_bridge_timings default_bridge_timings = {
  191. /* Timing specifications, datasheet page 7 */
  192. .input_bus_flags = DRM_BUS_FLAG_PIXDATA_SAMPLE_POSEDGE,
  193. .setup_time_ps = 500,
  194. .hold_time_ps = 1500,
  195. };
  196. /*
  197. * Information taken from the THS8134, THS8134A, THS8134B datasheet named
  198. * "SLVS205D", dated May 1990, revised March 2000.
  199. */
  200. static const struct drm_bridge_timings ti_ths8134_bridge_timings = {
  201. /* From timing diagram, datasheet page 9 */
  202. .input_bus_flags = DRM_BUS_FLAG_PIXDATA_SAMPLE_POSEDGE,
  203. /* From datasheet, page 12 */
  204. .setup_time_ps = 3000,
  205. /* I guess this means latched input */
  206. .hold_time_ps = 0,
  207. };
  208. /*
  209. * Information taken from the THS8135 datasheet named "SLAS343B", dated
  210. * May 2001, revised April 2013.
  211. */
  212. static const struct drm_bridge_timings ti_ths8135_bridge_timings = {
  213. /* From timing diagram, datasheet page 14 */
  214. .input_bus_flags = DRM_BUS_FLAG_PIXDATA_SAMPLE_POSEDGE,
  215. /* From datasheet, page 16 */
  216. .setup_time_ps = 2000,
  217. .hold_time_ps = 500,
  218. };
  219. static const struct of_device_id simple_bridge_match[] = {
  220. {
  221. .compatible = "dumb-vga-dac",
  222. .data = &(const struct simple_bridge_info) {
  223. .connector_type = DRM_MODE_CONNECTOR_VGA,
  224. },
  225. }, {
  226. .compatible = "adi,adv7123",
  227. .data = &(const struct simple_bridge_info) {
  228. .timings = &default_bridge_timings,
  229. .connector_type = DRM_MODE_CONNECTOR_VGA,
  230. },
  231. }, {
  232. .compatible = "ti,opa362",
  233. .data = &(const struct simple_bridge_info) {
  234. .connector_type = DRM_MODE_CONNECTOR_Composite,
  235. },
  236. }, {
  237. .compatible = "ti,ths8135",
  238. .data = &(const struct simple_bridge_info) {
  239. .timings = &ti_ths8135_bridge_timings,
  240. .connector_type = DRM_MODE_CONNECTOR_VGA,
  241. },
  242. }, {
  243. .compatible = "ti,ths8134",
  244. .data = &(const struct simple_bridge_info) {
  245. .timings = &ti_ths8134_bridge_timings,
  246. .connector_type = DRM_MODE_CONNECTOR_VGA,
  247. },
  248. },
  249. {},
  250. };
  251. MODULE_DEVICE_TABLE(of, simple_bridge_match);
  252. static struct platform_driver simple_bridge_driver = {
  253. .probe = simple_bridge_probe,
  254. .remove = simple_bridge_remove,
  255. .driver = {
  256. .name = "simple-bridge",
  257. .of_match_table = simple_bridge_match,
  258. },
  259. };
  260. module_platform_driver(simple_bridge_driver);
  261. MODULE_AUTHOR("Maxime Ripard <[email protected]>");
  262. MODULE_DESCRIPTION("Simple DRM bridge driver");
  263. MODULE_LICENSE("GPL");