Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/aditya-a-garwal/arduino-tft-lcd-3-5-canvas-paint
Program to create a freely paintable canvas on 3.5" TFT LCD Touchscreen Displays (using ILI9486 Driver) with the Arduino UNO R3/R4 and MCUFRIEND Library
https://github.com/aditya-a-garwal/arduino-tft-lcd-3-5-canvas-paint
arduino arduino-shield arduino-uno arduino-uno-r3 arduino-uno-r4 arduino-uno-r4-wifi canvas ili9486 lcd lcd-display paint-application touchscreen
Last synced: 5 days ago
JSON representation
Program to create a freely paintable canvas on 3.5" TFT LCD Touchscreen Displays (using ILI9486 Driver) with the Arduino UNO R3/R4 and MCUFRIEND Library
- Host: GitHub
- URL: https://github.com/aditya-a-garwal/arduino-tft-lcd-3-5-canvas-paint
- Owner: Aditya-A-garwal
- License: gpl-3.0
- Created: 2024-01-27T08:04:28.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2024-04-10T11:20:02.000Z (7 months ago)
- Last Synced: 2024-04-10T12:31:15.722Z (7 months ago)
- Topics: arduino, arduino-shield, arduino-uno, arduino-uno-r3, arduino-uno-r4, arduino-uno-r4-wifi, canvas, ili9486, lcd, lcd-display, paint-application, touchscreen
- Language: C++
- Homepage:
- Size: 527 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Freely Paintable Canvas On 3.5" TFT LCD Touchscreen With Arduino UNO R3/R4
## Overview
This repository contains a program to create a freely paintable canvas with an Arduino UNO R3/R4 and a 3.5" touch screen display shield, as shown below -
|||
|-|-|
Most 3.5" TFT LCD Touch displays use the ILI9486 Display Driver and include a resistive touchscreen. **The PCB Layout & silkscreen text may vary slightly between displays. This does not change their behaviour and functionality.** This repository depends on the following libraries -
- [Adafruit Touch Screen Library](https://github.com/adafruit/Adafruit_TouchScreen) to manage touch input
- [Adafruit GFX Library](https://github.com/adafruit/Adafruit-GFX-Library/tree/master) for graphics primitives
- [This fork of the MCUFriend KBV library](https://github.com/slviajero/MCUFRIEND_kbv) to drive the display (this makes it compatible with the UNO R4)
The program has been written using PlatformIO, and has been tested on the [Arduino UNO R3](https://docs.arduino.cc/hardware/uno-rev3/), [Arduino UNO R4 Minima](https://docs.arduino.cc/hardware/uno-r4-minima/) & [Arduino UNO R4 WiFi](https://docs.arduino.cc/hardware/uno-r4-wifi/).
> [!NOTE]
> A WiFi enabled version of this project can be found at https://github.com/Aditya-A-garwal/Arduino-WiFi-TFT-LCD-Canvas-App. The project allows saving/loading images from a server, dynamically connected to a WiFI network (using a touchscreen keyboard).
## Building/Uploading With PlatformIO
Since this project has been written using PlatformIO by default, simply run the following commands to fetch the libraries, build the project and upload the program -
```shell
pio pkg install
pio run
pio run --target upload
```
> [!TIP]
> A detailed tutorial on how to use this repository **with video demonstration** is available at https://dumblebots.com/2024/07/27/using-3-5-tft-lcd-display-ili9486-arduino-part-5-paint-app/. The tutorial includes a comprehensive explanation of the code.
## Building/Uploading With Arduino IDE
Create a new sketch and copy the contents of [```src/main.cpp```](/src/main.cpp) from this repository into the default ```.ino``` file. Create a new tab/file in the IDE named ```constants.h``` and copy the contents of [```src/constants.h```](/src/constants.h) from this repository into this file.
Install the Adafruit Touch Screen Library and Adafruit GFX Library from the Library Manager (under *Sketch>Include Library>Manage Libraries...*)
Download [this](https://github.com/slviajero/MCUFRIEND_kbv) repository as a ZIP file and install it by navigating to *Sketch>Include Library>Add .ZIP Library*, and selecting the downloaded file from the file explorer.
After this, you can Build and Upload the program as usual.
## Using the Example
As soon as the program is uploaded, the display should turn black and the following widgets should be displayed -
||
|:-:|
|Widgets on canvas app|
- *Color Selection Grid* with 9 colors to choose from (bottom-left of the screen)
- *Thickness Selection Grid* with 4 sizes to choose from (bottom-right of the screen)
- *Paintable Canvas* to paint in covering roughly the top two-thirds of the entire screen
To choose a color/pen-size, simply tap its icon. The icons in the thickness selection grid display the currently active color.
The colors being shown can be changed by changing the following values in [```src/constants.h```](/src/constants.h)
```cpp
const uint16_t PAINT_COORS[][3] = {
{0, 0, RED}, {35, 0, GREEN}, {70, 0, BLUE}, // colors in top-row
{0, 35, CYAN}, {35, 35, MAGENTA}, {70, 35, YELLOW}, // colors in middle-row
{0, 70, WHITE}, {35, 70, GRAY}, {70, 70, BLACK} // colors in bottom-row
};
```
The pen-sizes being shown can be changed by changing the following values in [```src/constants.h```](/src/constants.h)
```cpp
const uint16_t THICKNESS_OPTIONS[] = {3, 5, 7, 9};
```
**Note that the above two snippets contain comments for clarity which are not present in the source file.**
## Troubleshooting
Some common problems and their solutions -
|Problem|Solution|
|-|-|
|Display stays white after uploading program|Non-Standard Driver (not ILI9486)|
|Display not responding after touch|Try changing the order of the touch pins in [```src/constants.h```](/src/constants.h) file, i.e. swap the values of ```XP```, ```YP```, ```XM``` and ```YM```|
|Compilation issues related to SPI|Update the Arduino IDE version and/or install the SPI library|
|Display Flickering/Arduino is reset automatically|Faulty Power Supply/Cable|