panel_device.c 29 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154
  1. /*
  2. * Copyright (c) 2020 Actions Technology Co., Ltd
  3. *
  4. * SPDX-License-Identifier: Apache-2.0
  5. */
  6. #include <device.h>
  7. #include <tracing/tracing.h>
  8. #include "panel_device.h"
  9. #include <drivers/hrtimer.h>
  10. #include <logging/log.h>
  11. LOG_MODULE_REGISTER(lcd_panel, CONFIG_DISPLAY_LOG_LEVEL);
  12. /*********************
  13. * DEFINES
  14. *********************/
  15. /* time to wait between pixel transfer and next command */
  16. #ifdef CONFIG_PANEL_FULL_SCREEN_OPT_AREA
  17. # define CONFIG_PANEL_PIXEL_WR_DELAY_US (0)
  18. #else
  19. # define CONFIG_PANEL_PIXEL_WR_DELAY_US (0)
  20. #endif
  21. /**********************
  22. * TYPEDEFS
  23. **********************/
  24. /**********************
  25. * STATIC PROTOTYPES
  26. **********************/
  27. static int _lcd_panel_blanking_on(const struct device *dev);
  28. static int _lcd_panel_blanking_off(const struct device *dev);
  29. static int _lcd_panel_set_orientation(const struct device *dev,
  30. const enum display_orientation orientation);
  31. static int _panel_te_set_enable(const struct device *dev, bool enabled);
  32. static void _panel_submit_esd_check_work(struct lcd_panel_data *data);
  33. static void _panel_cancel_esd_check_work(struct lcd_panel_data *data);
  34. __unused static int _panel_pm_early_suspend(const struct device *dev, bool in_turnoff);
  35. static int _panel_pm_late_resume(const struct device *dev);
  36. static void _panel_pm_resume_handler(struct k_work *work);
  37. /**********************
  38. * STATIC VARIABLES
  39. **********************/
  40. #ifdef CONFIG_LCD_WORK_QUEUE
  41. K_THREAD_STACK_DEFINE(pm_workq_stack, CONFIG_LCD_WORK_Q_STACK_SIZE);
  42. #endif
  43. static const struct lcd_panel_config *const lcd_panel_configs[] = {
  44. #ifdef CONFIG_PANEL_ER76288A
  45. &lcd_panel_er76288a_config,
  46. #endif
  47. #ifdef CONFIG_PANEL_FT2308
  48. &lcd_panel_ft2308_config,
  49. #endif
  50. #ifdef CONFIG_PANEL_GC9C01
  51. &lcd_panel_gc9c01_config,
  52. #endif
  53. #ifdef CONFIG_PANEL_ICNA3310B
  54. &lcd_panel_icna3310b_config,
  55. #endif
  56. #ifdef CONFIG_PANEL_ICNA3311
  57. &lcd_panel_icna3311_config,
  58. #endif
  59. #ifdef CONFIG_PANEL_RM690B0
  60. &lcd_panel_rm690b0_config,
  61. #endif
  62. #ifdef CONFIG_PANEL_RM69090
  63. &lcd_panel_rm69090_config,
  64. #endif
  65. #ifdef CONFIG_PANEL_SH8601Z0
  66. &lcd_panel_sh8601z0_config,
  67. #endif
  68. #ifdef CONFIG_PANEL_ST77916
  69. &lcd_panel_st77916_config,
  70. #endif
  71. /* TR-panels */
  72. #ifdef CONFIG_PANEL_LPM015M135A
  73. &lcd_panel_lpm015m135a_config,
  74. #endif
  75. };
  76. static bool bDevEnterSuspend = false; // 0: not enter suspend, 1: enter suspend
  77. /**********************
  78. * MACROS
  79. **********************/
  80. /**********************
  81. * STATIC FUNCTIONS
  82. **********************/
  83. #if IS_TR_PANEL
  84. static inline void _panel_reset_pin_set(const struct device *dev, bool active)
  85. {
  86. #ifdef CONFIG_PANEL_RESET_GPIO
  87. struct lcd_panel_data *data = dev->data;
  88. const struct lcd_panel_pincfg *pincfg = dev->config;
  89. gpio_pin_set(data->reset_gpio, pincfg->reset_cfg.gpion, active ? 1 : 0);
  90. #endif
  91. }
  92. #endif /* IS_TR_PANEL */
  93. static void _panel_reset(const struct device *dev)
  94. {
  95. struct lcd_panel_data *data = dev->data;
  96. const struct lcd_panel_config *config = data->config;
  97. const struct lcd_panel_pincfg *pincfg = dev->config;
  98. display_controller_enable(data->lcdc_dev, &config->videoport);
  99. display_controller_set_mode(data->lcdc_dev, &config->videomode);
  100. LOG_DBG("Resetting display");
  101. #ifdef CONFIG_PANEL_RESET_GPIO
  102. gpio_pin_set(data->reset_gpio, pincfg->reset_cfg.gpion, 1);
  103. #endif
  104. #ifdef CONFIG_PANEL_POWER_GPIO
  105. gpio_pin_set(data->power_gpio, pincfg->power_cfg.gpion, 1);
  106. #endif
  107. #ifdef CONFIG_PANEL_POWER1_GPIO
  108. //gpio_pin_set(data->power1_gpio, pincfg->power1_cfg.gpion, 1);
  109. #endif
  110. #if IS_TR_PANEL == 0
  111. #ifdef CONFIG_PANEL_RESET_GPIO
  112. k_msleep(config->tw_reset);
  113. gpio_pin_set(data->reset_gpio, pincfg->reset_cfg.gpion, 0);
  114. k_msleep(config->ts_reset);
  115. #endif
  116. #endif /* IS_TR_PANEL == 0 */
  117. }
  118. static int _panel_detect(const struct device *dev)
  119. {
  120. struct lcd_panel_data *data = dev->data;
  121. if (0 == ARRAY_SIZE(lcd_panel_configs))
  122. return -ENODEV;
  123. if (1 == ARRAY_SIZE(lcd_panel_configs)) {
  124. data->config = lcd_panel_configs[0];
  125. return 0;
  126. }
  127. for (int i = 0; i < ARRAY_SIZE(lcd_panel_configs); i++) {
  128. data->config = lcd_panel_configs[i];
  129. if (data->config->ops->detect == NULL)
  130. return 0;
  131. _panel_reset(dev);
  132. if (!data->config->ops->detect(dev))
  133. return 0;
  134. }
  135. /* FIXME: fallback to the frist panel */
  136. data->config = lcd_panel_configs[0];
  137. return 0;
  138. }
  139. static void _panel_power_on(const struct device *dev)
  140. {
  141. struct lcd_panel_data *data = dev->data;
  142. const struct lcd_panel_config *config = data->config;
  143. _panel_reset(dev);
  144. if (config->ops->init)
  145. config->ops->init(dev);
  146. /* Display On */
  147. _lcd_panel_blanking_off(dev);
  148. }
  149. static void _panel_power_off(const struct device *dev, bool in_turnoff)
  150. {
  151. struct lcd_panel_data *data = dev->data;
  152. const struct lcd_panel_config *config = data->config;
  153. const struct lcd_panel_pincfg *pincfg = dev->config;
  154. _lcd_panel_blanking_on(dev);
  155. /* FIXME: place it in config->ops->blanking_on() ? */
  156. if (config->td_slpin > 0) {
  157. if (in_turnoff) {
  158. k_busy_wait(config->td_slpin * 1000u);
  159. } else {
  160. k_msleep(config->td_slpin);
  161. }
  162. }
  163. #ifdef CONFIG_PANEL_RESET_GPIO
  164. gpio_pin_set(data->reset_gpio, pincfg->reset_cfg.gpion, 1);
  165. #endif
  166. #ifdef CONFIG_PANEL_POWER_GPIO
  167. gpio_pin_set(data->power_gpio, pincfg->power_cfg.gpion, 0);
  168. #endif
  169. #ifdef CONFIG_PANEL_POWER1_GPIO
  170. gpio_pin_set(data->power1_gpio, pincfg->power1_cfg.gpion, 0);
  171. #endif
  172. }
  173. static void _panel_apply_brightness(const struct device *dev, uint8_t brightness)
  174. {
  175. struct lcd_panel_data *data = dev->data;
  176. const struct lcd_panel_config *config = data->config;
  177. bool ready;
  178. if (data->brightness == brightness)
  179. return;
  180. ready = (data->brightness_delay == 0) && (data->first_frame_cplt > 0);
  181. if (!ready) {
  182. data->brightness_delay -= data->first_frame_cplt;
  183. }
  184. if (ready || brightness == 0) {
  185. if (config->ops->set_brightness) {
  186. config->ops->set_brightness(dev, brightness);
  187. } else {
  188. #ifdef CONFIG_PANEL_BACKLIGHT_CTRL
  189. const struct lcd_panel_pincfg *pincfg = dev->config;
  190. #ifdef CONFIG_PANEL_BACKLIGHT_PWM
  191. pwm_pin_set_cycles(data->backlight_dev, pincfg->backlight_cfg.chan, pincfg->backlight_cfg.period,
  192. (uint32_t)brightness * pincfg->backlight_cfg.period / 255, pincfg->backlight_cfg.flag);
  193. #else
  194. gpio_pin_set(data->backlight_dev, pincfg->backlight_cfg.gpion, brightness ? 1 : 0);
  195. #endif
  196. #endif /* CONFIG_PANEL_BACKLIGHT_CTRL */
  197. }
  198. data->brightness = brightness;
  199. }
  200. }
  201. static void _panel_apply_post_change(const struct device *dev)
  202. {
  203. struct lcd_panel_data *data = dev->data;
  204. _panel_apply_brightness(dev, data->pending_brightness);
  205. }
  206. /**********************
  207. * DEVICE DECLARATION
  208. **********************/
  209. DEVICE_DECLARE(lcd_panel);
  210. /**********************
  211. * ESD CHECK
  212. **********************/
  213. #if CONFIG_PANEL_ESD_CHECK_PERIOD > 0
  214. static void _panel_esd_check_custom(const struct device *dev)
  215. {
  216. struct lcd_panel_data *data = dev->data;
  217. const struct lcd_panel_config *config = data->config;
  218. if (config->ops->check_esd) {
  219. data->esd_check_pended = data->transfering;
  220. if (!data->transfering) {
  221. int res = config->ops->check_esd(dev);
  222. data->esd_check_failed = res ? 1 : 0;
  223. }
  224. }
  225. }
  226. static void _panel_esd_check_handler(struct k_work *work)
  227. {
  228. const struct device *dev = DEVICE_GET(lcd_panel);
  229. struct lcd_panel_data *data = dev->data;
  230. const struct lcd_panel_config *config = data->config;
  231. if (config->ops->check_esd) {
  232. unsigned int key = irq_lock();
  233. _panel_esd_check_custom(dev);
  234. irq_unlock(key);
  235. }
  236. if (data->esd_check_failed) {
  237. LOG_ERR("ESD check fail, reboot panel");
  238. goto fail_exit;
  239. }
  240. if (!data->te_active) {
  241. LOG_ERR("TE no signal, reboot panel");
  242. goto fail_exit;
  243. }
  244. data->te_active = 0;
  245. _panel_submit_esd_check_work(data);
  246. return;
  247. fail_exit:
  248. lcd_panel_wake_lock();
  249. _panel_pm_early_suspend(dev, false);
  250. _panel_pm_late_resume(dev);
  251. lcd_panel_wake_unlock();
  252. }
  253. #endif /* CONFIG_TPKEY_ESD_CHECK_PERIOD > 0 */
  254. static void _panel_submit_esd_check_work(struct lcd_panel_data *data)
  255. {
  256. #if CONFIG_PANEL_ESD_CHECK_PERIOD > 0
  257. #ifdef CONFIG_LCD_WORK_QUEUE
  258. k_delayed_work_submit_to_queue(&data->pm_workq, &data->esd_check_work,
  259. K_MSEC(CONFIG_PANEL_ESD_CHECK_PERIOD));
  260. #else
  261. k_delayed_work_submit(&data->esd_check_work, K_MSEC(CONFIG_PANEL_ESD_CHECK_PERIOD));
  262. #endif
  263. #endif /* CONFIG_PANEL_ESD_CHECK_PERIOD > 0 */
  264. }
  265. static void _panel_cancel_esd_check_work(struct lcd_panel_data *data)
  266. {
  267. #if CONFIG_PANEL_ESD_CHECK_PERIOD > 0
  268. data->esd_check_pended = 0;
  269. data->esd_check_failed = 0;
  270. k_delayed_work_cancel(&data->esd_check_work);
  271. #endif /* CONFIG_PANEL_ESD_CHECK_PERIOD > 0 */
  272. }
  273. /**********************
  274. * TE CALLBACK
  275. **********************/
  276. static void _panel_te_handler(void)
  277. {
  278. const struct device *dev = DEVICE_GET(lcd_panel);
  279. struct lcd_panel_data *data = dev->data;
  280. uint32_t timestamp = k_cycle_get_32();
  281. sys_trace_void(SYS_TRACE_ID_VSYNC);
  282. data->te_active = 1;
  283. if (data->transfering) {
  284. sys_trace_void(SYS_TRACE_ID_LCD_POST_OVERTIME);
  285. } else {
  286. _panel_apply_post_change(dev);
  287. #if CONFIG_PANEL_ESD_CHECK_PERIOD > 0
  288. if (data->esd_check_pended)
  289. _panel_esd_check_custom(dev);
  290. #endif
  291. }
  292. if (data->callback && data->callback->vsync) {
  293. data->callback->vsync(data->callback, timestamp);
  294. }
  295. sys_trace_end_call(SYS_TRACE_ID_VSYNC);
  296. }
  297. #ifdef CONFIG_PANEL_TE_GPIO
  298. static void _panel_te_gpio_handler(const struct device *port,
  299. struct gpio_callback *cb, gpio_port_pins_t pins)
  300. {
  301. _panel_te_handler();
  302. }
  303. static int _panel_te_set_enable(const struct device *dev, bool enabled)
  304. {
  305. struct lcd_panel_data *data = dev->data;
  306. const struct lcd_panel_pincfg *pincfg = dev->config;
  307. if (gpio_pin_interrupt_configure(data->te_gpio, pincfg->te_cfg.gpion,
  308. enabled ? GPIO_INT_EDGE_TO_ACTIVE : GPIO_INT_DISABLE)) {
  309. LOG_ERR("Couldn't config te interrupt (en=%d)", enabled);
  310. return -ENODEV;
  311. }
  312. return 0;
  313. }
  314. #else /* CONFIG_PANEL_TE_GPIO */
  315. static void _panel_te_timer_handler(struct k_timer *timer)
  316. {
  317. _panel_te_handler();
  318. }
  319. static int _panel_te_set_enable(const struct device *dev, bool enabled)
  320. {
  321. struct lcd_panel_data *data = dev->data;
  322. if (enabled) {
  323. k_timer_start(&data->te_timer, K_MSEC(0), K_MSEC(CONFIG_PANEL_VSYNC_PERIOD_MS));
  324. } else {
  325. k_timer_stop(&data->te_timer);
  326. }
  327. return 0;
  328. }
  329. #endif /* CONFIG_PANEL_TE_GPIO */
  330. /**********************
  331. * DE/LCDC CALLBACK
  332. **********************/
  333. static void _panel_prepare_de_transfer(void *arg, const display_rect_t *area)
  334. {
  335. const struct device *dev = arg;
  336. struct lcd_panel_data *data = dev->data;
  337. const struct lcd_panel_config *config = data->config;
  338. uint8_t bytes_per_pixel;
  339. assert(data->disp_on == 1 && data->transfering == 0);
  340. sys_trace_u32x4(SYS_TRACE_ID_LCD_POST,
  341. area->x, area->y, area->x + area->w - 1, area->y + area->h - 1);
  342. if (data->pm_state == PM_DEVICE_STATE_LOW_POWER)
  343. board_lcd_resume(true, false);
  344. if (config->ops->write_prepare) {
  345. int res = config->ops->write_prepare(dev, area->x, area->y, area->w, area->h);
  346. if (res) {
  347. LOG_ERR("write area (%u, %u, %u, %u) failed", area->x, area->y, area->w, area->h);
  348. }
  349. }
  350. if (config->videomode.pixel_format == PIXEL_FORMAT_BGR_565) {
  351. bytes_per_pixel = 2;
  352. } else if (config->videomode.pixel_format == PIXEL_FORMAT_RGB_888) {
  353. bytes_per_pixel = 3;
  354. } else {
  355. bytes_per_pixel = 4;
  356. }
  357. data->refr_desc.pixel_format = config->videomode.pixel_format;
  358. data->refr_desc.width = area->w;
  359. data->refr_desc.height = area->h;
  360. data->refr_desc.pitch = area->w * bytes_per_pixel;
  361. data->transfering = 1;
  362. data->transfering_last = (area->y + area->h >= CONFIG_PANEL_VER_RES);
  363. /* source from DE */
  364. display_controller_set_source(data->lcdc_dev, DISPLAY_CONTROLLER_SOURCE_ENGINE, NULL);
  365. }
  366. static void _panel_start_de_transfer(void *arg)
  367. {
  368. const struct device *dev = arg;
  369. struct lcd_panel_data *data = dev->data;
  370. const struct lcd_panel_config *config = data->config;
  371. int res;
  372. #if IS_TR_PANEL
  373. _panel_reset_pin_set(dev, false);
  374. #endif
  375. res = display_controller_write_pixels(data->lcdc_dev, config->cmd_ramwr, DC_INVALID_CMD,
  376. &data->refr_desc, NULL);
  377. if (res) {
  378. LOG_ERR("write pixels failed");
  379. data->transfering = 0;
  380. }
  381. }
  382. static void _panel_complete_transfer(void *arg)
  383. {
  384. const struct device *dev = arg;
  385. struct lcd_panel_data *data = dev->data;
  386. #if IS_TR_PANEL
  387. _panel_reset_pin_set(dev, true);
  388. #endif
  389. if (data->pm_state == PM_DEVICE_STATE_LOW_POWER)
  390. board_lcd_suspend(true, false);
  391. sys_trace_end_call(SYS_TRACE_ID_LCD_POST);
  392. data->transfering = 0;
  393. if (data->transfering_last) {
  394. data->first_frame_cplt = 1;
  395. }
  396. #if CONFIG_PANEL_PIXEL_WR_DELAY_US > 0
  397. if (data->transfering_last == 0) {
  398. k_busy_wait(CONFIG_PANEL_PIXEL_WR_DELAY_US);
  399. }
  400. #endif
  401. if (data->callback && data->callback->complete) {
  402. data->callback->complete(data->callback);
  403. }
  404. }
  405. /**********************
  406. * DEVICE API
  407. **********************/
  408. static int _lcd_panel_blanking_on(const struct device *dev)
  409. {
  410. struct lcd_panel_data *data = dev->data;
  411. const struct lcd_panel_config *config = data->config;
  412. if (data->pm_state != PM_DEVICE_STATE_ACTIVE &&
  413. data->pm_state != PM_DEVICE_STATE_LOW_POWER)
  414. return -EPERM;
  415. if (data->disp_on == 0)
  416. return 0;
  417. LOG_INF("display blanking on");
  418. data->disp_on = 0;
  419. data->in_sleep = 1;
  420. data->first_frame_cplt = 0;
  421. data->brightness_delay = CONFIG_PANEL_BRIGHTNESS_DELAY_PERIODS;
  422. _panel_te_set_enable(dev, false);
  423. _panel_apply_brightness(dev, 0);
  424. if (config->ops->blanking_on)
  425. config->ops->blanking_on(dev);
  426. display_controller_disable(data->lcdc_dev);
  427. return 0;
  428. }
  429. static int _lcd_panel_blanking_off(const struct device *dev)
  430. {
  431. struct lcd_panel_data *data = dev->data;
  432. const struct lcd_panel_config *config = data->config;
  433. if (data->pm_state != PM_DEVICE_STATE_ACTIVE &&
  434. data->pm_state != PM_DEVICE_STATE_LOW_POWER)
  435. return -EPERM;
  436. if (data->disp_on == 1)
  437. return 0;
  438. LOG_INF("display blanking off");
  439. display_controller_enable(data->lcdc_dev, &config->videoport);
  440. display_controller_set_mode(data->lcdc_dev, &config->videomode);
  441. data->disp_on = 1;
  442. if (config->ops->blanking_off)
  443. config->ops->blanking_off(dev);
  444. _panel_te_set_enable(dev, true);
  445. return 0;
  446. }
  447. static int _lcd_panel_read(const struct device *dev,
  448. const uint16_t x,
  449. const uint16_t y,
  450. const struct display_buffer_descriptor *desc,
  451. void *buf)
  452. {
  453. return -ENOTSUP;
  454. }
  455. static int _lcd_panel_write(const struct device *dev,
  456. const uint16_t x,
  457. const uint16_t y,
  458. const struct display_buffer_descriptor *desc,
  459. const void *buf)
  460. {
  461. struct lcd_panel_data *data = dev->data;
  462. const struct lcd_panel_config *config = data->config;
  463. int res;
  464. #if IS_TR_PANEL
  465. if (desc->width != CONFIG_PANEL_HOR_RES || desc->height != CONFIG_PANEL_VER_RES) {
  466. LOG_ERR("TR panel requires full-screen write");
  467. return -EINVAL;
  468. }
  469. #endif
  470. if (data->disp_on == 0 || data->transfering != 0) {
  471. LOG_ERR("disp not ready");
  472. return -EBUSY;
  473. }
  474. sys_trace_u32x4(SYS_TRACE_ID_LCD_POST,
  475. x, y, x + desc->width - 1, y + desc->height - 1);
  476. if (data->pm_state == PM_DEVICE_STATE_LOW_POWER)
  477. board_lcd_resume(true, false);
  478. if (config->ops->write_prepare) {
  479. res = config->ops->write_prepare(dev, x, y, desc->width, desc->height);
  480. if (res) {
  481. LOG_ERR("write area (%u, %u, %u, %u) failed", x, y, desc->width, desc->height);
  482. return res;
  483. }
  484. }
  485. data->transfering = 1;
  486. data->transfering_last = (y + desc->height >= CONFIG_PANEL_VER_RES);
  487. #if IS_TR_PANEL
  488. _panel_reset_pin_set(dev, false);
  489. #endif
  490. /**
  491. * CARE:
  492. * For QSPI (Sync) series interface, RAMWR cmd will send automatically by LCDC.
  493. * For other interfaces, RAMWR cmd must send in write_prepare() ops manually.
  494. */
  495. #if 0
  496. _panel_transmit(dev, DDIC_CMD_RAMWR, NULL, 0);
  497. display_controller_set_source(data->lcdc_dev, DISPLAY_CONTROLLER_SOURCE_MCU, NULL);
  498. res = display_controller_write_pixels(data->lcdc_dev,
  499. config->cmd_ramwc, DC_INVALID_CMD, desc, buf);
  500. #else
  501. display_controller_set_source(data->lcdc_dev, DISPLAY_CONTROLLER_SOURCE_DMA, NULL);
  502. res = display_controller_write_pixels(data->lcdc_dev, config->cmd_ramwr,
  503. DC_INVALID_CMD, desc, buf);
  504. #endif
  505. if (res) {
  506. LOG_ERR("write pixels failed");
  507. data->transfering = 0;
  508. }
  509. return res;
  510. }
  511. static void *_lcd_panel_get_framebuffer(const struct device *dev)
  512. {
  513. return NULL;
  514. }
  515. static int _lcd_panel_set_brightness(const struct device *dev,
  516. const uint8_t brightness)
  517. {
  518. struct lcd_panel_data *data = dev->data;
  519. if (data->disp_on == 0)
  520. return -EPERM;
  521. if (brightness == data->pending_brightness)
  522. return 0;
  523. LOG_INF("display set_brightness %u", brightness);
  524. data->pending_brightness = brightness;
  525. /* delayed set in TE interrupt handler */
  526. return 0;
  527. }
  528. static int _lcd_panel_get_brightness(const struct device *dev)
  529. {
  530. struct lcd_panel_data *data = dev->data;
  531. return data->brightness;
  532. }
  533. static int _lcd_panel_set_contrast(const struct device *dev, const uint8_t contrast)
  534. {
  535. return -ENOTSUP;
  536. }
  537. static void _lcd_panel_get_capabilities(const struct device *dev,
  538. struct display_capabilities *capabilities)
  539. {
  540. struct lcd_panel_data *data = dev->data;
  541. const struct lcd_panel_config *config = data->config;
  542. memset(capabilities, 0, sizeof(struct display_capabilities));
  543. capabilities->x_resolution = CONFIG_PANEL_HOR_RES;
  544. capabilities->y_resolution = CONFIG_PANEL_VER_RES;
  545. capabilities->refresh_rate = config->videomode.refresh_rate;
  546. capabilities->supported_pixel_formats = SUPPORTED_PANEL_PIXEL_FORMATS;
  547. capabilities->current_pixel_format = config->videomode.pixel_format;
  548. capabilities->current_orientation = (enum display_orientation)(CONFIG_PANEL_ROTATION / 90);
  549. capabilities->screen_info = (CONFIG_PANEL_ROUND_SHAPE ? SCREEN_INFO_ROUND_SHAPE : 0);
  550. #if IS_TR_PANEL
  551. capabilities->screen_info |= (SCREEN_INFO_X_ALIGNMENT_WIDTH | SCREEN_INFO_Y_ALIGNMENT_HEIGHT);
  552. #endif
  553. }
  554. static int _lcd_panel_set_pixel_format(const struct device *dev,
  555. const enum display_pixel_format pixel_format)
  556. {
  557. struct lcd_panel_data *data = dev->data;
  558. const struct lcd_panel_config *config = data->config;
  559. if (pixel_format == config->videomode.pixel_format) {
  560. return 0;
  561. }
  562. LOG_ERR("Pixel format change not implemented");
  563. return -ENOTSUP;
  564. }
  565. static int _lcd_panel_set_orientation(const struct device *dev,
  566. const enum display_orientation orientation)
  567. {
  568. enum display_orientation current_orientation =
  569. (enum display_orientation)(CONFIG_PANEL_ROTATION / 90);
  570. return (orientation == current_orientation) ? 0 : -ENOTSUP;
  571. }
  572. static int _lcd_panel_register_callback(const struct device *dev,
  573. const struct display_callback *callback)
  574. {
  575. struct lcd_panel_data *data = dev->data;
  576. if (data->callback == NULL) {
  577. data->callback = callback;
  578. return 0;
  579. }
  580. return -EBUSY;
  581. }
  582. static int _lcd_panel_unregister_callback(const struct device *dev,
  583. const struct display_callback *callback)
  584. {
  585. struct lcd_panel_data *data = dev->data;
  586. if (data->callback == callback) {
  587. data->callback = NULL;
  588. return 0;
  589. }
  590. return -EINVAL;
  591. }
  592. static int _lcd_panel_init(const struct device *dev)
  593. {
  594. struct lcd_panel_data *data = dev->data;
  595. const struct lcd_panel_pincfg *pincfg = dev->config;
  596. const struct device *de_dev = NULL;
  597. #ifdef CONFIG_PANEL_BACKLIGHT_PWM
  598. data->backlight_dev = device_get_binding(pincfg->backlight_cfg.dev_name);
  599. if (data->backlight_dev == NULL) {
  600. LOG_ERR("Couldn't find pwm device\n");
  601. return -ENODEV;
  602. }
  603. pwm_pin_set_cycles(data->backlight_dev, pincfg->backlight_cfg.chan,
  604. pincfg->backlight_cfg.period, 0, pincfg->backlight_cfg.flag);
  605. #elif defined(CONFIG_PANEL_BACKLIGHT_GPIO)
  606. data->backlight_dev = device_get_binding(pincfg->backlight_cfg.gpio_dev_name);
  607. if (data->backlight_dev == NULL) {
  608. LOG_ERR("Couldn't find backlight pin");
  609. return -ENODEV;
  610. }
  611. if (gpio_pin_configure(data->backlight_dev, pincfg->backlight_cfg.gpion,
  612. GPIO_OUTPUT_INACTIVE | pincfg->backlight_cfg.flag)) {
  613. LOG_ERR("Couldn't configure backlight pin");
  614. return -ENODEV;
  615. }
  616. #endif /* CONFIG_PANEL_BACKLIGHT_PWM */
  617. #ifdef CONFIG_PANEL_RESET_GPIO
  618. data->reset_gpio = device_get_binding(pincfg->reset_cfg.gpio_dev_name);
  619. if (data->reset_gpio == NULL) {
  620. LOG_ERR("Couldn't find reset pin");
  621. return -ENODEV;
  622. }
  623. if (gpio_pin_configure(data->reset_gpio, pincfg->reset_cfg.gpion,
  624. GPIO_OUTPUT_ACTIVE | pincfg->reset_cfg.flag)) {
  625. LOG_ERR("Couldn't configure reset pin");
  626. return -ENODEV;
  627. }
  628. #endif /* CONFIG_PANEL_RESET_GPIO */
  629. #ifdef CONFIG_PANEL_POWER_GPIO
  630. data->power_gpio = device_get_binding(pincfg->power_cfg.gpio_dev_name);
  631. if (data->power_gpio == NULL) {
  632. LOG_ERR("Couldn't find power pin");
  633. return -ENODEV;
  634. }
  635. if (gpio_pin_configure(data->power_gpio, pincfg->power_cfg.gpion,
  636. GPIO_OUTPUT_INACTIVE | pincfg->power_cfg.flag)) {
  637. LOG_ERR("Couldn't configure power pin");
  638. return -ENODEV;
  639. }
  640. #endif /* CONFIG_PANEL_POWER_GPIO */
  641. #ifdef CONFIG_PANEL_POWER1_GPIO
  642. data->power1_gpio = device_get_binding(pincfg->power1_cfg.gpio_dev_name);
  643. if (data->power1_gpio == NULL) {
  644. LOG_ERR("Couldn't find power1 pin");
  645. return -ENODEV;
  646. }
  647. if (gpio_pin_configure(data->power1_gpio, pincfg->power1_cfg.gpion,
  648. GPIO_OUTPUT_INACTIVE | pincfg->power1_cfg.flag)) {
  649. LOG_ERR("Couldn't configure power1 pin");
  650. return -ENODEV;
  651. }
  652. #endif /* CONFIG_PANEL_POWER1_GPIO */
  653. #ifdef CONFIG_PANEL_TE_GPIO
  654. data->te_gpio = device_get_binding(pincfg->te_cfg.gpio_dev_name);
  655. if (data->te_gpio == NULL) {
  656. LOG_ERR("Couldn't find te pin");
  657. return -ENODEV;
  658. }
  659. if (gpio_pin_configure(data->te_gpio, pincfg->te_cfg.gpion,
  660. GPIO_INPUT | pincfg->te_cfg.flag)) {
  661. LOG_ERR("Couldn't configure te pin");
  662. return -ENODEV;
  663. }
  664. /* FIXME: make sure interrupt disabled */
  665. gpio_pin_interrupt_configure(data->te_gpio, pincfg->te_cfg.gpion, GPIO_INT_DISABLE);
  666. gpio_init_callback(&data->te_gpio_cb, _panel_te_gpio_handler, BIT(pincfg->te_cfg.gpion));
  667. gpio_add_callback(data->te_gpio, &data->te_gpio_cb);
  668. #else
  669. k_timer_init(&data->te_timer, _panel_te_timer_handler, NULL);
  670. #endif /* CONFIG_PANEL_TE_GPIO */
  671. data->lcdc_dev = device_get_binding(CONFIG_LCDC_DEV_NAME);
  672. if (data->lcdc_dev == NULL) {
  673. LOG_ERR("Could not get LCD controller device");
  674. return -EPERM;
  675. }
  676. display_controller_control(data->lcdc_dev,
  677. DISPLAY_CONTROLLER_CTRL_COMPLETE_CB, _panel_complete_transfer, (void *)dev);
  678. if (_panel_detect(dev)) {
  679. LOG_ERR("No panel connected");
  680. return -ENODEV;
  681. }
  682. de_dev = device_get_binding(CONFIG_DISPLAY_ENGINE_DEV_NAME);
  683. if (de_dev == NULL) {
  684. LOG_WRN("Could not get display engine device");
  685. } else {
  686. display_engine_control(de_dev,
  687. DISPLAY_ENGINE_CTRL_DISPLAY_PORT, (void *)&data->config->videoport, NULL);
  688. display_engine_control(de_dev,
  689. DISPLAY_ENGINE_CTRL_DISPLAY_MODE, (void *)&data->config->videomode, NULL);
  690. display_engine_control(de_dev,
  691. DISPLAY_ENGINE_CTRL_DISPLAY_PREPARE_CB, _panel_prepare_de_transfer, (void *)dev);
  692. display_engine_control(de_dev,
  693. DISPLAY_ENGINE_CTRL_DISPLAY_START_CB, _panel_start_de_transfer, (void *)dev);
  694. }
  695. data->disp_on = 0;
  696. data->in_sleep = 1;
  697. data->te_active = 0;
  698. data->pending_brightness = CONFIG_PANEL_BRIGHTNESS;
  699. data->brightness_delay = CONFIG_PANEL_BRIGHTNESS_DELAY_PERIODS;
  700. data->pm_state = PM_DEVICE_STATE_SUSPENDED;
  701. #if CONFIG_PANEL_ESD_CHECK_PERIOD > 0
  702. k_delayed_work_init(&data->esd_check_work, _panel_esd_check_handler);
  703. #endif
  704. k_work_init(&data->resume_work, _panel_pm_resume_handler);
  705. #ifdef CONFIG_LCD_WORK_QUEUE
  706. k_work_queue_start(&data->pm_workq, pm_workq_stack, K_THREAD_STACK_SIZEOF(pm_workq_stack), 6, NULL);
  707. #endif
  708. _panel_pm_late_resume(dev);
  709. bDevEnterSuspend = false;
  710. return 0;
  711. }
  712. /**********************
  713. * POWER MANAGEMENT
  714. **********************/
  715. static void _panel_pm_notify(struct lcd_panel_data *data, uint32_t pm_action)
  716. {
  717. if (data->callback && data->callback->pm_notify) {
  718. data->callback->pm_notify(data->callback, pm_action);
  719. }
  720. }
  721. static int _panel_pm_early_suspend(const struct device *dev, bool in_turnoff)
  722. {
  723. struct lcd_panel_data *data = dev->data;
  724. if (data->pm_state != PM_DEVICE_STATE_ACTIVE &&
  725. data->pm_state != PM_DEVICE_STATE_LOW_POWER) {
  726. return -EPERM;
  727. }
  728. LOG_INF("panel early-suspend");
  729. _panel_cancel_esd_check_work(data);
  730. _panel_pm_notify(data, PM_DEVICE_ACTION_EARLY_SUSPEND);
  731. _panel_power_off(dev, in_turnoff);
  732. data->pm_state = PM_DEVICE_STATE_SUSPENDED;
  733. bDevEnterSuspend = true;
  734. return 0;
  735. }
  736. static int _panel_pm_late_resume(const struct device *dev)
  737. {
  738. struct lcd_panel_data *data = dev->data;
  739. if (data->pm_state != PM_DEVICE_STATE_SUSPENDED) {
  740. return -EPERM;
  741. }
  742. LOG_INF("panel late-resume");
  743. data->pm_changing = 1;
  744. #ifdef CONFIG_LCD_WORK_QUEUE
  745. k_work_submit_to_queue(&data->pm_workq, &data->resume_work);
  746. #else
  747. k_work_submit(&data->resume_work);
  748. #endif
  749. return 0;
  750. }
  751. static struct hrtimer g_panel_backlight_ht_ctrl;
  752. static void htimer_fun(struct hrtimer *ttimer, void *expiry_fn_arg)
  753. {
  754. const struct device *dev = DEVICE_GET(lcd_panel);
  755. struct lcd_panel_data *data = dev->data;
  756. const struct lcd_panel_pincfg *pincfg = dev->config;
  757. #ifdef CONFIG_PANEL_POWER1_GPIO
  758. gpio_pin_set(data->power1_gpio, pincfg->power1_cfg.gpion, 1);
  759. #endif
  760. }
  761. static void htimer_panel_backlight(unsigned int ms)
  762. {
  763. hrtimer_init(&g_panel_backlight_ht_ctrl, htimer_fun, NULL);
  764. hrtimer_start(&g_panel_backlight_ht_ctrl, 1000*ms, 0);
  765. }
  766. static void _panel_pm_resume_handler(struct k_work *work)
  767. {
  768. const struct device *dev = DEVICE_GET(lcd_panel);
  769. struct lcd_panel_data *data = dev->data;
  770. LOG_INF("panel resuming");
  771. lcd_panel_wake_lock();
  772. data->pm_state = PM_DEVICE_STATE_ACTIVE;
  773. data->transfering = 0; /* reset flag in case fail again */
  774. data->pm_changing = 0;
  775. _panel_power_on(dev);
  776. _panel_pm_notify(data, PM_DEVICE_ACTION_LATE_RESUME);
  777. _panel_submit_esd_check_work(data);
  778. lcd_panel_wake_unlock();
  779. #ifdef CONFIG_PANEL_POWER1_GPIO
  780. if (bDevEnterSuspend)
  781. {
  782. bDevEnterSuspend = false;
  783. htimer_panel_backlight(40);
  784. }
  785. else
  786. {
  787. #if DMG_LCM
  788. htimer_panel_backlight(500);
  789. #else
  790. htimer_panel_backlight(800);
  791. #endif
  792. }
  793. #endif
  794. LOG_INF("panel active");
  795. }
  796. #ifdef CONFIG_PM_DEVICE
  797. static void _panel_pm_change_low_power(const struct device *dev, uint32_t pm_state)
  798. {
  799. struct lcd_panel_data *data = dev->data;
  800. const struct lcd_panel_config *config = data->config;
  801. unsigned int key;
  802. while (1) {
  803. key = irq_lock();
  804. if (!data->transfering)
  805. break;
  806. irq_unlock(key);
  807. k_msleep(1); /* wait transfer finish */
  808. }
  809. data->pm_state = pm_state;
  810. if (data->pm_state == PM_DEVICE_STATE_LOW_POWER) {
  811. if (config->ops->lowpower_enter)
  812. config->ops->lowpower_enter(dev);
  813. if (config->ops->set_aod_brightness) {
  814. config->ops->set_aod_brightness(dev, CONFIG_PANEL_AOD_BRIGHTNESS);
  815. } else {
  816. _panel_apply_brightness(dev, CONFIG_PANEL_AOD_BRIGHTNESS);
  817. }
  818. _panel_te_set_enable(dev, false);
  819. board_lcd_suspend(true, true);
  820. } else {
  821. board_lcd_resume(true, true);
  822. if (config->ops->lowpower_exit)
  823. config->ops->lowpower_exit(dev);
  824. _panel_te_set_enable(dev, true);
  825. }
  826. irq_unlock(key);
  827. }
  828. static int _panel_pm_enter_low_power(const struct device *dev)
  829. {
  830. struct lcd_panel_data *data = dev->data;
  831. if (data->pm_state != PM_DEVICE_STATE_ACTIVE) {
  832. return -EPERM;
  833. }
  834. _panel_cancel_esd_check_work(data);
  835. _panel_pm_notify(data, PM_DEVICE_ACTION_LOW_POWER);
  836. _panel_pm_change_low_power(dev, PM_DEVICE_STATE_LOW_POWER);
  837. LOG_INF("panel enter low-power");
  838. return 0;
  839. }
  840. static int _panel_pm_exit_low_power(const struct device *dev)
  841. {
  842. struct lcd_panel_data *data = dev->data;
  843. if (data->pm_state != PM_DEVICE_STATE_LOW_POWER) {
  844. return -EPERM;
  845. }
  846. _panel_pm_notify(data, PM_DEVICE_ACTION_LATE_RESUME);
  847. _panel_pm_change_low_power(dev, PM_DEVICE_STATE_ACTIVE);
  848. _panel_submit_esd_check_work(data);
  849. LOG_INF("panel exit low-power");
  850. return 0;
  851. }
  852. static int _lcd_panel_pm_control(const struct device *dev, enum pm_device_action action)
  853. {
  854. struct lcd_panel_data *data = dev->data;
  855. int ret = 0;
  856. if (data->pm_state == PM_DEVICE_STATE_OFF)
  857. return -EPERM;
  858. switch (action) {
  859. case PM_DEVICE_ACTION_EARLY_SUSPEND:
  860. if (soc_get_aod_mode()) {
  861. ret = _panel_pm_enter_low_power(dev);
  862. } else {
  863. ret = _panel_pm_early_suspend(dev, false);
  864. board_lcd_suspend(false, true);
  865. }
  866. break;
  867. case PM_DEVICE_ACTION_LATE_RESUME:
  868. if (data->pm_state == PM_DEVICE_STATE_LOW_POWER) {
  869. ret = _panel_pm_exit_low_power(dev);
  870. } else {
  871. board_lcd_resume(false, true);
  872. ret = _panel_pm_late_resume(dev);
  873. }
  874. break;
  875. case PM_DEVICE_ACTION_SUSPEND:
  876. if (data->pm_changing || data->pm_state == PM_DEVICE_STATE_ACTIVE) {
  877. ret = -EPERM;
  878. }
  879. break;
  880. case PM_DEVICE_ACTION_TURN_OFF:
  881. _panel_pm_early_suspend(dev, true);
  882. data->pm_state = PM_DEVICE_STATE_OFF;
  883. LOG_INF("panel turn-off");
  884. break;
  885. default:
  886. break;
  887. }
  888. return ret;
  889. }
  890. #endif /* CONFIG_PM_DEVICE */
  891. /**********************
  892. * DEVICE DEFINITION
  893. **********************/
  894. static const struct display_driver_api lcd_panel_driver_api = {
  895. .blanking_on = _lcd_panel_blanking_on,
  896. .blanking_off = _lcd_panel_blanking_off,
  897. .write = _lcd_panel_write,
  898. .read = _lcd_panel_read,
  899. .get_framebuffer = _lcd_panel_get_framebuffer,
  900. .set_brightness = _lcd_panel_set_brightness,
  901. .get_brightness = _lcd_panel_get_brightness,
  902. .set_contrast = _lcd_panel_set_contrast,
  903. .get_capabilities = _lcd_panel_get_capabilities,
  904. .set_pixel_format = _lcd_panel_set_pixel_format,
  905. .set_orientation = _lcd_panel_set_orientation,
  906. .register_callback = _lcd_panel_register_callback,
  907. .unregister_callback = _lcd_panel_unregister_callback,
  908. };
  909. static const struct lcd_panel_pincfg lcd_panel_pin_config = {
  910. #ifdef CONFIG_PANEL_POWER_GPIO
  911. .power_cfg = CONFIG_PANEL_POWER_GPIO,
  912. #endif
  913. #ifdef CONFIG_PANEL_POWER1_GPIO
  914. .power1_cfg = CONFIG_PANEL_POWER1_GPIO,
  915. #endif
  916. #ifdef CONFIG_PANEL_RESET_GPIO
  917. .reset_cfg = CONFIG_PANEL_RESET_GPIO,
  918. #endif
  919. #ifdef CONFIG_PANEL_TE_GPIO
  920. .te_cfg = CONFIG_PANEL_TE_GPIO,
  921. #endif
  922. #ifdef CONFIG_PANEL_BACKLIGHT_PWM
  923. .backlight_cfg = CONFIG_PANEL_BACKLIGHT_PWM,
  924. #elif defined(CONFIG_PANEL_BACKLIGHT_GPIO)
  925. .backlight_cfg = CONFIG_PANEL_BACKLIGHT_GPIO,
  926. #endif
  927. };
  928. static struct lcd_panel_data lcd_panel_data;
  929. #if IS_ENABLED(CONFIG_PANEL)
  930. DEVICE_DEFINE(lcd_panel, CONFIG_LCD_DISPLAY_DEV_NAME, _lcd_panel_init, _lcd_panel_pm_control,
  931. &lcd_panel_data, &lcd_panel_pin_config, POST_KERNEL, CONFIG_APPLICATION_INIT_PRIORITY,
  932. &lcd_panel_driver_api);
  933. #endif