====== EMB5: Using LCD Display =====
Alphanumerical LCD is one of the most popular output devices in the Embedded and IoT. Using LCD with predefined line organisation (here, 2 lines, 16 characters each) is as simple as sending a character's ASCII code to the device. This is so much simpler than in the case of the use of dot-matrix displays, where it is necessary to use fonts. The fixed organisation LCD has limits; here, only 32 characters can be presented to the user simultaneously. ASCII presents a limited set of characters, but many LCDs can redefine character maps (how each letter, digit or symbol looks). This way, it is possible to introduce graphics elements (i.e. frames), special symbols and letters.

In this scenario, you will learn how to handle easily LCD to present information and retrieve it visually with a webcam.

===== Prerequisites =====
Familiarise yourself with a hardware reference: this LCD is controlled with 6 GPIOs as presented in the "//Table 1: ESP32-S3 SUT Node Hardware Details//" on the hardware reference page.\\
You are going to use a library to handle the LCD. It means you need to add it to your ''platformio.ini'' file. Use the template provided in the hardware reference section and extend it with the library definition:
<code bash>
lib_deps = adafruit/Adafruit LiquidCrystal@^2.0.2
</code>

===== Suggested Readings and Knowledge Resources =====
  * [[en:iot-open:introductiontoembeddedprogramming2:cppfundamentals]]
  * [[en:iot-open:hardware2:esp32|]]
  * [[en:iot-open:hardware2:actuators_light|]]
  * [[en:iot-open:practical:hardware:sut:esp32|]]
===== Hands-on Lab Scenario =====

==== Task to be implemented ====
Draw "Hello World" in the upper line of the LCD and "Hello IoT" in the lower one.

==== Start ====
Check if you can see a full LCD in your video stream. Book a device and create a dummy Arduino file with ''void setup()...'' and ''void loop()...''.


==== Steps ====

=== Step 1 ===
Include the library in your source code:
<code c>
#include <Adafruit_LiquidCrystal.h>
</code>

=== Step 2 ===
Declare GPIOs controlling the LCD, according to the hardware reference:
<code c>
#define LCD_RS 2
#define LCD_ENABLE 1
#define LCD_D4 39
#define LCD_D5 40
#define LCD_D6 41
#define LCD_D7 42
</code>

=== Step 3 ===
Declare a static instance of the LCD controller class and preconfigure it with appropriate control GPIOs:
<code c>
static Adafruit_LiquidCrystal lcd(LCD_RS, LCD_ENABLE, LCD_D4, LCD_D5, LCD_D6, LCD_D7);
</code>

=== Step 4 ===
Initialise class with display area configuration (number of columns, here 16 and rows, here 2):
<code c>
lcd.begin(16,2); 
</code>

=== Step 5 ===
Implement your algorithm. The most common class methods that will help you are listed below:
  * ''.clear()'' - clears all content;
  * ''.setCursor(x,y)'' - set cursor, writing will start there;
  * ''.print(contents)'' - prints text in the cursor location; note there are many overloaded functions, accepting various arguments, including numerical.

==== Result validation ====
You should be able to see "Hello World" and "Hello IoT" on the LCD now.

<WRAP noprint>
===== Project information =====
{{:en:iot-open:logo_iot_200_px.png?200|}}\\
This Intellectual Output was implemented under the Erasmus+ KA2.\\
Project IOT-OPEN.EU Reloaded – Education-based strengthening of the European universities, companies and labour force in the global IoT market.\\
Project number: 2022-1-PL01-KA220-HED-000085090.

**__Erasmus+ Disclaimer__**\\
This project has been funded with support from the European Commission. \\
This publication reflects the views of only the author, and the Commission cannot be held responsible for any use that may be made of the information contained therein.

**__Copyright Notice__**\\
This content was created by the IOT-OPEN.EU Reloaded consortium, 2022,2024.\\
The content is Copyrighted and distributed under CC BY-NC [[https://en.wikipedia.org/wiki/Creative_Commons_license|Creative Commons Licence]], free for Non-Commercial use. 
<figure label>
{{:en:iot-open:ccbync.png?100|}}
</figure>

</WRAP>