1.. _st_b_lcd40_dsi1_mb1166: 2 3ST B-LCD40-DSI1 4############### 5 6Overview 7******** 8 9The B-LCD40-DSI1 shield provides a 4-inch WVGA TFT LCD with MIPI DSI interface 10and capacitive touch screen. 11 12.. note:: 13 The shield comes in different hardware revisions, the MB1166-A09 14 is utilizing a NT35510 panel controller and shall specifically 15 use ``st_b_lcd40_dsi1_mb1166_a09`` as SHIELD when building 16 Prior versions are utilizing an OTM8009a controller and shall 17 use shield name without postfix, that is: ``st_b_lcd40_dsi1_mb1166`` 18 19.. figure:: image.jpg 20 :alt: B-LCD40-DSI1 MB1166 Image 21 :align: center 22 23 B-LCD40-DSI1 MB1166 Image 24 25.. figure:: connectors.jpg 26 :alt: B-LCD40-DSI1 MB1166 Connector 27 :align: center 28 29 B-LCD40-DSI1 MB1166 Connector 30 31+------+--------------+------------+-------+--------------+-----------------+ 32| CN1 | Description | Interface | CN1 | Description | Interface | 33| odd | | | even | | | 34+======+==============+============+=======+==============+=================+ 35| 1 | GND | - | 2 | - | - | 36+------+--------------+------------+-------+--------------+-----------------+ 37| 3 | DSI_CK_P | DSI | 4 | TOUCH_INT | Interrupt out | 38+------+--------------+------------+-------+--------------+-----------------+ 39| 5 | DSI_CK_N | DSI | 6 | - | - | 40+------+--------------+------------+-------+--------------+-----------------+ 41| 7 | GND | - | 8 | - | - | 42+------+--------------+------------+-------+--------------+-----------------+ 43| 9 | DSI_D0_P | DSI | 10 | - | - | 44+------+--------------+------------+-------+--------------+-----------------+ 45| 11 | DSI_D0_N | DSI | 12 | - | - | 46+------+--------------+------------+-------+--------------+-----------------+ 47| 13 | GND | - | 14 | - | - | 48+------+--------------+------------+-------+--------------+-----------------+ 49| 15 | DSI_D1_P | DSI | 16 | - | - | 50+------+--------------+------------+-------+--------------+-----------------+ 51| 17 | DSI_D1_N | DSI | 18 | - | - | 52+------+--------------+------------+-------+--------------+-----------------+ 53| 19 | GND | - | 20 | - | - | 54+------+--------------+------------+-------+--------------+-----------------+ 55| 21 | BLVDD(+5V) | - | 22 | - | - | 56+------+--------------+------------+-------+--------------+-----------------+ 57| 23 | BLVDD(+5V) | - | 24 | - | - | 58+------+--------------+------------+-------+--------------+-----------------+ 59| 25 | - | - | 26 | - | - | 60+------+--------------+------------+-------+--------------+-----------------+ 61| 27 | BLGND | - | 28 | - | - | 62+------+--------------+------------+-------+--------------+-----------------+ 63| 29 | BLGND | - | 30 | - | - | 64+------+--------------+------------+-------+--------------+-----------------+ 65| 31 | - | - | 32 | - | - | 66+------+--------------+------------+-------+--------------+-----------------+ 67| 33 | - | - | 34 | - | - | 68+------+--------------+------------+-------+--------------+-----------------+ 69| 35 | - | - | 36 | VDD | - | 70| | | | | (2.8V-3.3V) | | 71+------+--------------+------------+-------+--------------+-----------------+ 72| 37 | - | - | 38 | - | - | 73+------+--------------+------------+-------+--------------+-----------------+ 74| 39 | - | - | 40 | I2C_SDA | I2C | 75+------+--------------+------------+-------+--------------+-----------------+ 76| 41 | - | - | 42 | - | - | 77+------+--------------+------------+-------+--------------+-----------------+ 78| 43 | - | - | 44 | I2C_SCL | I2C | 79+------+--------------+------------+-------+--------------+-----------------+ 80| 45 | - | - | 46 | - | - | 81+------+--------------+------------+-------+--------------+-----------------+ 82| 47 | - | - | 48 | - | - | 83+------+--------------+------------+-------+--------------+-----------------+ 84| 49 | DSI_TE | DSI | 50 | - | - | 85+------+--------------+------------+-------+--------------+-----------------+ 86| 51 | - | - | 52 | - | - | 87+------+--------------+------------+-------+--------------+-----------------+ 88| 53 | BL_CTRL | GPIO | 54 | - | - | 89+------+--------------+------------+-------+--------------+-----------------+ 90| 55 | - | - | 56 | - | - | 91+------+--------------+------------+-------+--------------+-----------------+ 92| 57 | RESET | GPIO | 58 | - | - | 93+------+--------------+------------+-------+--------------+-----------------+ 94| 59 | - | - | 60 | - | - | 95+------+--------------+------------+-------+--------------+-----------------+ 96 97 98Requirements 99************ 100 101Your board needs to have a ``mipi_dsi`` device tree label to work with this shield. 102 103Usage 104***** 105 106The shield can be used in any application by setting ``SHIELD`` to 107``st_b_lcd40_dsi1_mb1166`` or ``st_b_lcd40_dsi1_mb1166_a09`` and adding 108the necessary device tree properties. 109 110Set ``--shield "st_b_lcd40_dsi1_mb1166"`` when you invoke ``west build``. For example: 111 112.. zephyr-app-commands:: 113 :zephyr-app: samples/drivers/display 114 :board: stm32h747i_disco/stm32h747xx/m7 115 :shield: st_b_lcd40_dsi1_mb1166 116 :goals: build 117 118References 119********** 120 121- `Product page <https://www.st.com/en/evaluation-tools/b-lcd40-dsi1.html>`_ 122 123- `Databrief <https://www.st.com/resource/en/data_brief/b-lcd40-dsi1.pdf>`_ 124 125- `User manual <https://www.st.com/resource/en/user_manual/um2104--4inch-wvga-tft-lcd-board-with-mipi-dsi-interface-and-capacitive-touch-screen-stmicroelectronics.pdf>`_ 126
