Bureaucrats, dave_user, Administrators
8,139
edits
Changes
no edit summary
{{InfoBoxTop}}
{{Applies To Bora}}
{{Applies To BoraLite}}
{{AppliesToBORA Lite AN}}
{{Applies To BoraX}}
{{InfoBoxBottom}}
{{WarningMessage|text=This application note was validated against specific versions of the kit only. It may not work with other versions. Supported versions are listed in the ''History'' section.}}
{{ImportantMessage|text=It is assumed to use ZYNQ SOC with <b><i>speed grade -1</i></b> (even using command line script or GUI). In any case, there are no issues using <b><i>speed grade -3</i></b> SOC provided with BELK kit}}
==History==
!Version
!Date
!BELK /BXELK version
!Notes
|-
|1.0.0
|15:03, 4 September 2015 (CEST)
|[[Bora_Embedded_Linux_Kit_(BELK)#BELK_software_components|2.2.0]]
|First release
|-
|2.0.0
|November 2015
|[[Bora_Embedded_Linux_Kit_(BELK)#BELK_software_components|2.2.0, 3.0.0]]
|Added support for BoraX/BoraXEVB platform
|-
|{{oldid|8292|2.0.1}}
|March 2017
|[[Bora_Embedded_Linux_Kit_(BELK)#BELK_software_components|2.2.0, 3.0.0]]
|Added info for installing Qt on rfs using <code>smart</code>
|-
|3.0.0
|January 2020
|[[Bora_Embedded_Linux_Kit_(BELK)#BELK_software_components|4.1.0 / 2.1.0]]
|AN migration to BELK 4.1.0 / BXELK 2.1.0
|-
|}
==Introduction==
This application note describes the interfacing of [http://www.ampire.com.tw/en/index.asp Ampire AM-800480STMQW-TA1] display to [[BoraEVB|BoraEVB ]]and [[BoraXEVB|BoraXEVB]]. Main characteristics of this 7" TFT LCD panel are:
* 800x480 resolution
* color depth: 18 bpp
* electrical interface: LVDS (3 pairs).
==Physical interfacing==
===BoraEVB===
To interface the display a small adapter board is needed. It interfaces J22 connector on BoraEVB side and provides a 20-pin connector to directly attach display cable.
Ampire AM-800480STMQW-TA1 part integrates resistive touch too. This is directly connected to BoraEVB's J25 connector. Resistive touch is managed by Texas Instruments TSC2003 controller (U27).
Schematics of adapter board can be downloaded from this [httphttps://www.dave.eu/system/files/area-riservata/BORA_LCD_ADAPTOR_ADBL7000C1R_1.0.0_0.pdf link]. ===BoraXEVB===In case of BoraXEVB, no adapter board is needed. LCD panel is directly connected to J26 connector where PL bank 13's signals implementing LVDS interface are routed (see [[BoraXEVB#Schematics|page 14]] of the schematics). I/O voltage of bank 13 is set to 2.5V by configuring [[BoraXEVB#BANK13_VDDIO_selector_-_JP25|JP25 ]] as shown in the following table.{| class="wikitable" border="1"!Pins!Setting|-|1-2|closed|-|3-4|open|-|5-6|closed|-|7-8|open|-|9-10|open|-|11-12|open|-|}
==Block diagram and Vivado project==
The following picture shows pictures show simplified block diagram of the design.
[[File:An-belk-004-01.png|700pxthumb|center|600px|Simplified block diagram of the design (Bora + BoraEVB)]][[File:An-belk-004-borax-01.png|thumb|center|600px|Simplified block diagram of the design (BoraX + BoraXEVB)]][[File:an-belk-004-boralite-01.png|thumb|center|600px|Simplified block diagram of the design (BoraLite + Adapter + BoraXEVB)]]
LCD is driven by a controller implemented in PL that fetches pixel data from frame buffer and periodically refreshes physical screen.
To implement frame buffer, a portion of main SDRAM is used. This area is allocated at runtime by linux frame buffer driver. Even if LCD is 18 bpp, each pixel is represented by 32-bit word in memory. In fact each pixel is in RGB666 format, so for each colour only the six most significant bits of the frame buffer RGB888 are used to drive the display.
The Vivado project can also be build with the procedure explained [[Creating_and_building_example_Vivado_project_(BELK/BXELK)#Command_line_based_procedure|here]].
===Bora + BoraEVB===
Here is the pinout assignment to drive the LCD:
{| class="wikitable" |
|}
(*) This signal is used to control backlight. It is usually driven by a PWM signal whose duty cycle is proportional to backlight intensity. For the sake of simplicity, in this project this signal is driven by a GPIO, thus only two intensity levels are supported (0% and 100%). The Vivado project can also be downloaded from this build with the procedure explained [[httpCreating_and_building_example_Vivado_project_(BELK/BXELK)#Command_line_based_procedure|here]] with the following modifications:*<code>export BASE_NAME bora_LVDS<//www.dave.eu/system/files/areacode>*<code>export U-riservataBOOT_PS7_DIR bora</AN-BELK-004-xpr.zip link].code>
===BoraLite + Adapter + BoraXEVB===Here is the pinout assignment to drive the LCD:{| class="wikitable" | | align="center" style="background:#f0f0f0;"|'''LCD Signal'''| align="center" style="background:#f0f0f0;"|'''BORA SOM Signal'''|-| BackLight (*)||IO_L6N_T0_VREF_13 (**)|-| LVDS_CLK_P||IO_L13P_T2_MRCC_13 (**)|-| LVDS_CLK_N||IO_L13N_T2_MRCC_13 (**)|-| LVDS_D0_P||IO_L12P_T1_MRCC_13 (**)|-| LVDS_D0_N||IO_L12N_T1_MRCC_13 (**)|-| LVDS_D1_P||IO_L15P_T2_DQS_13 (**)|-| LVDS_D1_N||IO_L15N_T2_DQS_13 (**)|-| LVDS_D2_P||IO_L11P_T1_SRCC_13 (**)|-| LVDS_D2_N||IO_L11N_T1_SRCC_13 (**)|-|} (*) This signal is used to control backlight. It is usually driven by a PWM signal whose duty cycle is proportional to backlight intensity. For the sake of simplicity, in this project this signal is driven by a GPIO, thus only two intensity levels are supported (0% and 100%). This is a CMOS 2.5V level signal. Make sure that voltage levels of this signal are compatible with LCD backlight input.<br>(**) On the adapter this signal is routed (via configurable 0R) to multiple pins of the EVB connector to meet all the features of the EVB. Please make sure to configure the Adapter for the use of the LVDS connector. The Vivado project can also be build with the procedure explained [[Creating_and_building_example_Vivado_project_(BELK/BXELK)#Command_line_based_procedure|here]] with the following modifications:*<code>export BASE_NAME boralite_LVDS</code>*<code>export U-BOOT_PS7_DIR bora</code> ==== BoraLiteAdapter BLADP0000R0R ==== As the BoraLite SOM has fewer signals routed out as the other SOM, some signal are multiplexed via 0R resistors: the following table list these configurations:{| class="wikitable" | | align="center" style="background:#f0f0f0;"|'''Reference'''| align="center" style="background:#f0f0f0;"|'''PmodA conn.'''| align="center" style="background:#f0f0f0;"|'''LVDS conn.'''|-| R33 || 0R || DNP|-| R34 || 0R || DNP|-| R35 || 0R || DNP|-| R36 || 0R || DNP|-| R37 || 0R || DNP|-| R38 || 0R || DNP|-| R39 || 0R || DNP|-| R40 || x || DNP|-| R41 || 0R || DNP|-| R42 || x || 0R|-| R43 || DNP || 0R|-| R44 || DNP || 0R|-| R45 || DNP || 0R|-| R46 || DNP || 0R|-| R47 || DNP || 0R|-| R48 || DNP || 0R|-| R49 || DNP || 0R|-| R50 || DNP || 0R|-|} ===BoraX + BoraXEVB===Here is the pinout assignment to drive the LCD:{| class="wikitable" | | align="center" style="background:#f0f0f0;"|'''LCD Signal'''| align="center" style="background:#f0f0f0;"|'''BORA SOM Signal'''|-| BackLight (*)||IO_0_13|-| LVDS_CLK_P||IO_L13P_T2_MRCC_13|-| LVDS_CLK_N||IO_L13N_T2_MRCC_13|-| LVDS_D0_P||IO_L12P_T1_MRCC_13|-| LVDS_D0_N||IO_L12N_T1_MRCC_13|-| LVDS_D1_P||IO_L14P_T2_SRCC_13|-| LVDS_D1_N||IO_L14N_T2_SRCC_13|-| LVDS_D2_P||IO_L11P_T1_SRCC_13|-| LVDS_D2_N||IO_L11N_T1_SRCC_13|-|} (*) This signal is used to control backlight. It is usually driven by a PWM signal whose duty cycle is proportional to backlight intensity. For the sake of simplicity, in this project this signal is driven by a GPIO, thus only two intensity levels are supported (0% and 100%).This is a CMOS 2.5V level signal. Make sure that voltage levels of this signal are compatible with LCD backlight input. The Vivado project can also be build with the procedure explained [[Creating_and_building_example_Vivado_project_(BELK/BXELK)#Command_line_based_procedure|here]] with the following modifications:*<code>export BASE_NAME borax_LVDS</code>*<code>export U-BOOT_PS7_DIR borax</code>
==Enabling frame buffer driver in linux kernel==
Kernel and device tree can also be built with the following procedure:
* update Bora kernel repository (as described [[Bora_Embedded_Linux_Kit_(BELK)/BXELK_software_components#Updating_the_repositories_from_BELK_2.1.0_to_BELK_2.2.0Updating_git_repositories|here]])* checkout ''bora-feat-lcd-support'' branch the default KIT binary files of kernel (using ''git checkout bora-feat-lcd-support'' commanduImage)can be used.* build the updated kernel source as usual<code>bora-an004.dtb</code> devicetree
Put the binaries on the first (FAT32) partition of your BELK 2.2.0 SD card, overwriting the original one if needed. Please note that you need the following files:
* boot.bin
* bora.dtb
* uImage
* fpga.bin
* u-boot.img
* uEnv.txt
Install root file system on second (ext4) partition of your BELK SD card (firstly deleting all previous rfs files):* get rfs image [http://mirror.dave.eu/bora/belk-4.1.0/belk-4.1.0_dave-image-devel-bora.tar.bz2 here] Insert the SD card into BoraEVB Bora/BoraX EVB and turn on the board.
During kernel bootstrap, the following messages are printed out on console, indicating framebuffer driver has been loaded succesfully:
You will also see two [https://en.wikipedia.org/wiki/Tux Tuxes] on the top left corner of the LCD, indicating that this Linux system has two cores, as shown in the following picture:
{|style="margin: 0 auto;"| [[File:An-belk-004-03.jpg|thumb|center|400px|Bora/BoraEVB system with LCD panel]]| [[File:An-belk-004-05.jpg|thumb|center|400px|BoraX/BoraXEVB system with LCD panel]]|}
Once the kernel has completed boot, frame buffer can be accessed from user space applications via <code>/dev/fb0</code> device file (for more details please refer to https://www.kernel.org/doc/Documentation/fb/framebuffer.txt).
